ADR-412: One message is one signal, and no conduit splits it¶
Summary¶
- Decided:
attend sendandattend replywrite one signal per message, whatever its length. No conduit splits a message on delivery: the Stop-hook drain, the attend mod and attend-chat show it whole, and the Monitor line ofattend runcarries it whole on one line. Every delivery line names the message by its one~id. Signals an older attend wrote as numbered parts keep reading as the separate messages they are. This amends ADR-406 item 10, which moved splitting intoattend send, and ends the Monitor-line chunking ADR-122 introduced. - Trades away: Under the Monitor fallback a message longer than the line limit is cut. Claude Code shows the first 500 characters of a Monitor line and marks the rest
...(truncated), so a reader there sees the sender, the~idand about 420 characters of the body, and must runattend inboxfor the rest. Before, a message split at send reached a Monitor reader whole, as numbered lines of at most 260 characters each. - One-way? No. Splitting at send or at the Monitor line can be put back in one change, and no stored signal changes shape.
- Probes: Confident (whole): A long message from a peer arrives as one message with one handle, so answering it threads to the whole message. Not confident (monitor): A session that listens through Monitor instead of the mod sees only the first 500 characters or so of a long message and has to open
attend inboxfor the rest. You may want Monitor to show more. - Inversion: The two ends are a message split wherever any reader has a limit, and a message never split anywhere. This decision takes the second end. A delivery-time split on the Monitor route only would sit between them.
Context¶
ADR-122 chunked peer messages on the Monitor line because Monitor was believed to cut a stdout line at about 400 characters. ADR-406 item 10 then moved splitting into attend send itself, so a body over 400 characters went out as several signals led by (1/3), (2/3) and so on, each with its own id. The mod spike had split by hand, and the trial asked for the send verb to do it.
The mod and the Stop-hook drain have no line limit. On those routes, numbered parts only did harm. Cuts landed mid-sentence. Each part had its own ~id, so a reply threaded to one part. The parts arrived together in one turn anyway. The operator named the parts a holdover from the Monitor approach and asked that one message be sent.
The Monitor limit was measured directly for this decision. On Claude Code 2.1.296 a Monitor line is cut at 500 characters, and a notification at 3,000. Lines printed within 200 ms batch into one notification.
Decision¶
- Send.
attend sendandattend replywrite exactly one signal for one message, whatever its length.Sentreports its oneid. A write that no tray takes is thenot_writtenerror, and nothing went out. - Delivery. No conduit splits a message. The drain and the mod show it on one line ending in
~id. attend-chat shows it as it shows any message. The Monitor line ofattend runismessage from <sender> ~<id>: <body>. The body's whitespace collapses to single spaces, so one message is one line. The handle comes ahead of the body, so a line Monitor cuts still names the message.attend inboxholds the full text. - One delivery. A message is one signal file, so it is one entry in the seen-set and counts as one in
attend unreadand in the cold-start plan, whichever conduit carries it (ADR-172). - Legacy parts. Readers keep ordering signals that share an mtime by the send time in their ids. Parts that an older peer sent as numbered parts still read in order. Each part stays its own message with its own id; nothing rejoins them.
- A bounded size. One argv element is capped at 128 KiB on Linux (
MAX_ARG_STRLEN), and the CLI and the mod both pass the body as one, so a larger body never reached attend. Every writer refuses a body over 64 KiB with an error that names the limit, through one check inagent_identity::signalthatattend send,attend replyand attend-chat call; attend-chat shows it in the compose box and keeps the draft. The shared write also refuses a signal over the read limit, so no writer leaves a file that readers would skip. The limit is 64 KiB because half the argv ceiling leaves room for the header, and a drain injects at most about 16k tokens per message. Readers load a signal file only up to 256 KiB, above anything an attend wrote, and skip a larger one, marking it seen. The drain and the peers sensor note each skip once on stderr;attend unreadreads without marking and prints nothing. - Guidance. The messaging guidance says that a message goes out as one message, that there is no need to split it by hand, and that a reader under Monitor sees about the first 500 characters of its line.
Consequences¶
Positive¶
- A long message reads as written, with no cut mid-sentence and no counter.
- A reply to any delivery of a message threads to that message.
- The send path loses its splitter and its partial-send error, and the peers sensor loses its chunker.
Negative¶
- Under Monitor a message past the line limit is cut. The reader has the handle and the start of the message, and runs
attend inboxfor the rest. - During rollout a peer on an older attend still sends numbered parts. They read as before until that peer updates.
Neutral¶
- The short handle moves into
agent-identity, so the peers sensor and attend compute it from one implementation. The mod computes the same handle in TypeScript. - The Monitor limits measured here are Claude Code's, and an update can change them. The decision does not depend on their values.
Alternatives Considered¶
- Split only on the Monitor route, at delivery, on sentence boundaries, with every part carrying the message's one
~id. Rejected by the operator's direction to remove multipart messages altogether. Monitor is the fallback route since ADR-406, and a split there would keep a second message shape alive for that route alone. The measured batching would allow it: lines printed together arrive as one notification of up to 3,000 characters. - Keep splitting at send and give the parts a shared id. Rejected. It changes the wire format for a limit that only the fallback route has, and the mod and the drain would still show cut sentences.
- Raise the send-time limit to Monitor's measured 500 characters. Rejected. It still splits on routes that have no limit.