Foundation / checks (deploy) (push) Successful in 3m29s
Foundation / checks (ecs) (push) Successful in 2m0s
Foundation / checks (client) (push) Successful in 12m51s
Foundation / checks (network) (push) Successful in 13m0s
Foundation / checks (tsan) (push) Successful in 7m50s
Foundation / postgres-tools (push) Canceled after 0s
Foundation / server-image (push) Canceled after 0s
Foundation / image (push) Canceled after 0s
Foundation / checks (checks) (push) Canceled after 32m4s
Foundation / checks (postgres) (push) Canceled after 19m13s
ADR-0096. Session protocol v4 (v3 is deployed and frozen) adds HandoffOffer, SessionRedirect, close reasons handed_off and moved, and ghost marker records. Sessions use the durable probe record: logins open it where it was saved (redirected when it lives elsewhere), and session ends save it. A marker crossing into a neighbour's area is frozen, prepared, its control released and a signed ticket offered; uncommitted transfers are aborted after the ticket's lifetime. The destination shows arriving probes as ghosts (schema v13 incoming_probe_transfers) and opens the marker where it crossed. Refreshes the dev session window. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
38 lines
1.8 KiB
Markdown
38 lines
1.8 KiB
Markdown
# M10 session protocol, version 4
|
|
|
|
Version 4 is [version 3](session-v3.md) plus two server-to-client stream messages, two close
|
|
reasons and a ghost marker kind, for cross-region handoff (ADR-0096). Everything else is as
|
|
in v3. The header version is 4. Versions 1-3 were deployed to evolution-dev and are frozen;
|
|
all three are refused (`unsupported_version`). Once v4 is deployed it is frozen like them.
|
|
|
|
## Messages (in addition to v3 types 1-15)
|
|
|
|
| Type | Direction | Body | Bytes |
|
|
|---|---|---|---|
|
|
| 16 HandoffOffer | server -> client, stream | transfer id (16), destination address, ticket (160) | 312 |
|
|
| 17 SessionRedirect | server -> client, stream | owner address | 136 |
|
|
|
|
An address is: region u64 (nonzero), endpoint (64 bytes), server name (64 bytes). Each text
|
|
field is 1-64 printable ASCII characters without spaces (0x21-0x7E), padded with zero bytes.
|
|
A nonzero byte after the first zero is invalid, and the transfer id must be nonzero.
|
|
|
|
- **HandoffOffer**, while established: the session's probe crossed into the destination
|
|
region. The ticket ([handoff-ticket-v1](handoff-ticket-v1.md)) goes in `Hello`'s grant slot
|
|
there. The source then sends `Close(handed_off)`.
|
|
- **SessionRedirect**, before Welcome: the account's probe is owned by that region. A grant for
|
|
it is needed there. The region then sends `Close(moved)`.
|
|
|
|
## Close reasons (in addition to v3's 1-13)
|
|
|
|
- **14 handed_off:** the session ended because its probe crossed into another region.
|
|
- **15 moved:** the account's probe is owned by another region; a Redirect may precede it.
|
|
|
|
## Snapshot records
|
|
|
|
Marker upsert (kind 5): the `own` byte becomes a kind.
|
|
- **0:** another session's marker.
|
|
- **1:** the receiving session's own marker (sequence and area follow).
|
|
- **2:** a ghost, a probe being handed to this region, read-only, with no sequence or area.
|
|
|
|
Any other value is malformed.
|