Relay window desk
This utility manages logical views into a capture store. It reserves view budget, supports nested slices, and previews bounded byte samples. The storage adapter is deterministic and sparse: it computes bytes by address instead of allocating the whole capture, so even a large capture uses the same fixed session memory.
Build with make; run ./window-reader < commands.txt. --help lists commands.
The public C interface is window.h; modules split range/storage operations,
session lifetime, input, and observation writing. No external libraries or network
are needed. examples/field.txt contains the handover capture-store session.
Commands accept unsigned 32-bit decimal or 0x operands. Each command produces one
O observation, or I for malformed syntax. Comments starting with # and blank lines
are ignored. A consumed stream exits 0; diagnostic logs may use stderr. Process argument/I/O
errors exit 2. Logical request failures are represented by O rc=-1. Their session
effects and the data adapter are specified in docs/window-protocol.md.
./window-reader --json emits the same observations as JSON objects, one per
command. JSON field names follow the protocol; invalid syntax has only sequence
and input_error=true. Both output forms represent the same session state.