911 B
911 B
protocol
Role
protocol defines the JSONL message boundary between Pod clients and Pod servers.
Boundaries
Owns:
- transport-neutral method/event/result types
- request/reply and broadcast event shapes
- protocol error categories shared by clients and servers
Does not own:
- Unix socket implementation details (
client,pod) - TUI rendering (
tui) - Worker history semantics (
llm-worker) - durable storage (
session-store,pod-store)
Design notes
The exact enum variants are code authority. The README should describe the boundary, not duplicate every message shape.
Protocol events can inform UI and orchestration, but durable state changes still need to flow through Pod/session/metadata records.