2.3 KiB
Session protocol v9 cellular owner diagnostics
ADR-0117 defines v9 as an additive extension of the owner-filtered type 24 view from v8. Versions 1–8 keep their exact wire layouts. V9 retains the v8 reliable cellular action and patch-perception behavior, and adds the owning life's current reserve and latest committed tick effects. The new fields are diagnostic only and do not affect simulation state.
Type 24
The 8-byte EVSN header uses version 9, type 24 and flags 0. The payload starts
with the v8 tick u64, life_identity u64, and patch_count u16, then a fixed
64-byte diagnostics block, then the v8 48-byte patch records. Tick is nonzero.
An active life has a nonzero identity and diagnostics. A cleared zero-life view
has no patches and an all-zero diagnostics block.
| Payload offset | Size | Field |
|---|---|---|
| 0 | 8 | server tick |
| 8 | 8 | life identity; zero clears view |
| 16 | 2 | patch count, at most 256 |
| 18 | 8 | current energy reserve, pJ |
| 26 | 32 | current reserve C, N, P, other, each fg |
| 58 | 8 | latest committed maintenance cost, pJ |
| 66 | 8 | latest committed movement cost, pJ |
| 74 | 1 | movement result: 0 unavailable, 1 no movement requested, 2 moved, 3 blocked, 4 insufficient energy |
| 75 | 1 | intake result: 0 unavailable, 1 not requested, 2 acquired, 3 patch missing, 4 out of contact |
| 76 | 1 | latest tick effects present: 0 or 1 |
| 77 | 5 | reserved, all zero |
| 82 | 48 × count | exact visible patch addresses and inventory, unchanged from v8 |
When the result-present flag is zero, both costs are zero and the movement/intake results are 0. When present, neither result may be 0. A zero life may not carry nonzero reserve, cost, status, or result-present fields. The decoder rejects unknown enum values, invalid result combinations, reserved bits, wrong lengths, unsorted or duplicate patch addresses, and over-limit patch counts before publishing a view. The maximum message size is 12,378 bytes including the header.
The server sends the message only to the authenticated account's current v9 session, and only for its currently bound live cell. V8 sessions continue to receive the byte-identical v8 view without these diagnostics. Tick effects are transient: after recovery reserve is reported immediately, while effects remain unavailable until a committed tick has run.