Files
aevolution/schemas/network/session-v6-cellular-intention.md
dingo 747b063c65
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 1m56s
Foundation / checks (client) (push) Failing after 4m30s
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 (network) (push) Canceled after 3m1s
Foundation / checks (postgres) (push) Canceled after 34s
Foundation / checks (checks) (push) Canceled after 5m8s
Integrate opt-in cellular v6 sessions
2026-10-10 21:46:33 -04:00

2.5 KiB

Session protocol v6 cellular intention datagram

ADR-0105 defines this message. The region session server admits it only when RegionSessionsConfig::accept_cellular_intentions is enabled. This connects authenticated v6 datagrams to bounded intention admission and tick scheduling; it does not provide a cellular life owner, durable tick publication or client presentation. Until a cellular perception view exists, v6 sessions cannot set replication interest, receive default M10 snapshots or receive probe markers.

Each frame starts with the existing 8-byte EVSN header. The version is 6, the type is 22 (cellular_intention), and header flags are zero. Payload length is exactly 48 bytes; all integers are little-endian.

Payload offset Size Field
0 8 authenticated session id (nonzero; admission checks connection match)
8 8 control epoch (nonzero; admission checks current authority)
16 8 per-session intention sequence (nonzero and increasing)
24 8 intended simulation tick (admission checks the future window)
32 2 signed movement X component; server validates the norm and bounds
34 2 signed movement Y component; server validates the norm and bounds
36 1 intake target present: 0 or 1
37 3 reserved, all zero
40 4 target patch lower-left X in μm
44 4 target patch lower-left Y in μm

When the target flag is zero, both coordinates must be zero. When set, the coordinates identify a requested patch, not a position, speed or stock claim. The authoritative host validates patch alignment, perception at the applicable tick and footprint contact before intake. No target means no requested intake. Movement remains an intention only; the server derives position, costs and resource balances. Truncated frames, trailing bytes, nonzero reserved bytes, invalid flags, noncanonical absent-target coordinates and versions below 6 are refused by the codec.

After decode, admission applies the authenticated connection/session match, current control epoch, ready authority, one-intention-per-tick and increasing sequence rules, bounded future tick window, movement norm and per-window rate and unresolved-input caps from ADR-0089/0092. The biology owner further checks the patch address against its provisioned map and that session's authoritative perception before resolving contact. Scheduled inputs remain available for deterministic replay until the host marks their tick simulated; a cellular host must tie that watermark to its chosen durable publication boundary.