Files
aevolution/schemas/network/session-v8-cellular-perception.md
T
dingo 5419a579e8
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (checks) (push) Failing after 39s
Foundation / checks (postgres) (push) Canceled after 0s
Foundation / checks (tsan) (push) Canceled after 0s
Foundation / postgres-tools (push) Canceled after 0s
Foundation / server-image (push) Canceled after 0s
Foundation / image (push) Canceled after 0s
Foundation / checks (ecs) (push) Canceled after 1m48s
Foundation / checks (network) (push) Canceled after 1m18s
Foundation / checks (client) (push) Canceled after 1m58s
Add owner-filtered cellular perception protocol
2026-10-11 01:06:05 -04:00

25 lines
1.3 KiB
Markdown

# Session protocol v8 cellular perception
V8 preserves the v7 reliable cellular action and final outcome contract. It adds
message type 24, `CellularPerception`, server to client on the reliable stream.
Types and layouts from v1-v7 remain unchanged. The new view follows ADR-0103 and
ADR-0115; it contains no account ID or patch provenance.
## Message 24
The 8-byte standard `EVSN` header uses version 8, type 24 and flags 0. The payload
begins with `tick u64`, `life_identity u64`, and `patch_count u16`, followed by
`patch_count` records. Tick is nonzero. An active view has a nonzero life identity;
identity zero is reserved for an empty view and requires zero patches.
Each 48-byte record contains `x_um u32`, `y_um u32`, `energy_pj u64`, then four
`matter_fg u64` values in carbon, nitrogen, phosphorus, other order. Records are
strictly ordered by `(x_um, y_um)` with no duplicate address. At most 256 records
are allowed. The total message is at most 12,314 bytes including the header.
The server sends the view only to the authenticated account's current v8 session,
using that account's currently bound living cell and the server's ADR-0103 sensor
query. An empty active list means the cell currently perceives no provisioned
patches; a zero identity clears the previous owner view. The client cannot submit
or enlarge this view. Versions below 8 reject type 24.