Skip to content

Wire reference: datagram@3 and comline@2 (runtime#15) - #148

Merged
Kinflou merged 1 commit into
mainfrom
docs/comline2-datagram3-wire
Nov 3, 2026
Merged

Kinflou merged 1 commit into
mainfrom
docs/comline2-datagram3-wire

Conversation

@Kinflou

@Kinflou Kinflou commented Nov 3, 2026

Copy link
Copy Markdown
Member

Wire reference pages for phase 2 of comline@2 (runtime#15), to go with ComlineProject/runtime#80.

  • reference/wire/datagram.md: the byte layouts of datagram@2 and the new datagram@3. In datagram@3, a call carries its protocol and function wire numbers as varints (calls = by_id). The page also covers the envelope.
  • reference/wire/handshakes.md: comline@1's 31-byte frame, and comline@2 in full:
    • the facts it compares and what decides;
    • the four parameters (scope, newer_consumer, same_version_differs, exchange);
    • the offer and symmetric exchanges;
    • the Hello, Answer and Verdict layouts;
    • the stable reason-code table.
  • Notes: both new pages are marked available in the runtime but not yet the default. That switch is phase 3, in core.
  • Links: a short paragraph on the call-system page links to both pages, and both are added to the Reference nav.

…comline@2

Byte layouts for datagram@2 and the new datagram@3 (calls by wire number),
and for comline@1 and the new comline@2: its parameters, its exchanges,
its messages and its reason codes. Both new encodings are marked as
available in the runtime but not yet the default (runtime#15).
@Kinflou
Kinflou merged commit 821a86c into main Nov 3, 2026
3 checks passed
@Kinflou
Kinflou deleted the docs/comline2-datagram3-wire branch November 3, 2026 14:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

1 participant