← System handbook

Inbox & Signals

Implementedoperations

The append-only nervous system used to deliver work, blockers, decisions and escalation.

TL;DR

Every Control node can have an append-only inbox. Messages and read receipts are history, read state belongs to an execution, and unread items can block consequential actions. Typed Signals add severity, time-to-consequence, impact scope and required authority so important information can escalate without granting extra authority.

ELI5

Every team and worker gets a mailbox. Anyone can put a note in the right mailbox, but nobody can erase old mail. If something important is unread, the worker can be stopped from doing risky work until they read it. Emergency mail can be copied upward to the right manager without making the sender the manager.

Synthesis

The inbox is both a communications substrate and a safety primitive. It keeps delivery separate from chat UI, so Workspace can later show the same messages without becoming their canonical store. Typed signals make BLOCKED, RISK, HANDOFF, REVOKE and similar events machine-routable while preserving the normal parent chain.

Storage

Append-only by design

Each node has append-only items and append-only cursor/read receipts. Nothing needs to be rewritten to know what was sent or what an execution had read at a point in time.

One inbox
items.jsonlMessages / signals
execution readerReads unread sequence
cursors.jsonlRead-through receipt
consequential gateMay proceed only when inbox state permits
Protocol

Typed Signal vocabulary

Protocol signals require severity, time-to-consequence, scope-of-impact and authority-required metadata. This lets routing reason about urgency without pretending every message is equally important.

SignalUse
STATUSState/checkpoint report
ASKRequest for information or help
BLOCKEDWork cannot continue without intervention
RISKPotential harmful or consequential condition
DECISIONAccepted decision notification
HANDOFFTransfer of operational context or responsibility
SPAWN_REQUESTRequest to create delegated orchestration capacity
ESCALATERaise a signal through lineage
REVOKEWithdraw or fence authority/work
INCIDENTOperational incident requiring attention
RECEIPTEvidence that a transition/effect occurred
Escalation

Bypass notification does not bypass authority

Normal reporting chainA severe signal may be copied higher, but its sender does not inherit higher authority.
UnitLocal work
CellLocal coordination
SystemBounded system
GalaxiasSystem family
ClusterMajor domain/programme
UniversalWhole operating environment
PrincipalHuman/root authority
Operational consequence

Why unread inboxes can stop work

The Control inbox contract says a holder may not take consequential action while its held inbox has unread items. Installed hooks/gates enforce that for supported harnesses; other execution environments must use the same shared gate rather than inventing a second rule.

Important: The inbox is not just notifications. It is part of the control path for STOP, REVOKE, corrections and handoffs.
Keep reading

Related pages

Reference / evidence

Canonical sources

These pages are explanatory read models. Where wording conflicts with implementation or a Control decision, the linked implementation/decision is authoritative and this page should be corrected.