The protocol schema declares only the events something writes and the methods some client sends; acl_*, session_read_only, session_archived, session_erased and fleet.get go, and so do four telemetry events nothing attached to¶
Decision 1029 · accepted · 2026-11-17 · issue #1020
Issue #1020. Five event types were declared and written by nothing, and the clients read
two of them; fleet.get was served and sent by no client; four :telemetry events had no
handler anywhere. Each was removed rather than wired, for its own reason:
acl_granted/acl_revoked. An invitation and its withdrawal are already in the log assession_invitedandsession_uninvited, and the pod's mirror of the ACL is fed by the plane alone, which pushesacl.changedat each grant, invitation and invitation taken back. A grant bysession.grantwrites no line, as it wrote none before.session_read_only. The plane parks a session read-only in its own table, and a parked session has no tree running to write to its log.stateon the session's row is where a client reads it, as it readsdormant.session_archived/session_erased. Archiving is a mark beside the log (Decision 1023) and the answer tosession.archivesays so; an erased session has no log left to carry an event. Both also leave the gateway's list of lifecycle types.fleet.getanswered the rowssession.listwith no filter answers, archived ones left out as there. The conformance client lists the fleet withsession.listnow. Afleetsubscription stays: something subscribes to it.[:troupe, :llm, :start],[:troupe, :llm, :stop],[:troupe, :tool, :stop],[:troupe, :agent, :transition]. The operator's guide said nothing attaches to them, and nothing did.[:troupe, :llm, :retry](the live bench counts it) and[:troupe, :llm, :unpriced]stay. Decisions 769 and 788 mention[:troupe, :llm, :stop]firing for a summariser's and a stopped call; that part of each no longer holds.
The TUI read version from config_upgraded and worker or pod from
session_resumed, none of which the schema has; it reads from, to and moved now.
Not chosen¶
- Writing the events from where the schema implied. Each would have been a second record of something already recorded once, and no client needed it.
- Keeping
fleet.getas an alias. One way to ask for the list.
If undone¶
An event declared again needs its writer in the same change and a test that it is written; a method, a client that sends it.
Governs: apps/troupe_protocol/lib/troupe/protocol/schema.ex, apps/troupe_worker/lib/troupe/worker/auth.ex, apps/troupe_gateway/lib/troupe/gateway/dispatch.ex, apps/troupe_gateway/lib/troupe/gateway/session.ex, apps/troupe_core/lib/troupe/agent/server.ex, clients/tui/lib/troupe/remote/translate.ex, clients/gui/packages/client/src/transcript.ts