Skip to main content

Status lifecycle

Question: what actually happened, stated without overstatement?

What each state proves​

StateWhat it provesWhat it does NOT prove
draftA preview existsApproval or transmission
approvedThe user approved this exact contentAnything was transmitted
recordedThe host stored it and is holding itAnything left the host
queuedScheduled; attempts may have failedAny channel accepted it
sentA transport accepted itIt reached the firm's system
deliveredThe firm's intake system stored it and signed a receiptA person read it
acknowledgedA person at the firm recorded viewing it (automatic replies never count)The firm will take the matter
respondedA person sent a substantive replyAcceptance
consultation_requestedThe firm asked to scheduleA time is set
consultation_confirmedThe firm confirmed a timeAn attorney-client relationship
completedThe firm recorded that the consultation happenedEngagement or outcome
declinedThe firm said noAnything about the merits
cancelledThe user (or the recipient) withdrewThat the recipient deleted a copy
failedDelivery attempts were exhausted—
expiredTime ran out before the next step—

Technical delivery is never legal representation. engagement.status stays unknown unless the recipient reports otherwise in a signed extension.

A policy refusal before any preview is not a state: it is an error (OLIP_POLICY_BLOCKED) and no handoff exists.

Who may record what​

SourceMay record
userapproved; cancelled
client (the agent platform)cancelled, on the user's instruction
hostrecorded, queued, failed, expired
transportsent, failed
recipient_systemdelivered (with a signed receipt); consultation requested or confirmed
recipient_human (via the recipient's authenticated system)acknowledged, responded, declined, consultation requested or confirmed, completed, cancelled

The calling agent can never record recipient outcomes (OLIP_EVENT_SOURCE_FORBIDDEN). Anything not in the transition table is refused (OLIP_INVALID_TRANSITION), and recipient events need evidence (OLIP_EVIDENCE_REQUIRED). Every event records from_state, to_state, occurred_at, recorded_at, source, actor, evidence, and a signature when the source is the recipient.

The complete transition table with sources and evidence is on Status machine.

Adapters with fewer states​

Map each native state to the most conservative OLIP state that is proven, and expose unmapped native states only as extensions. Example: a system that says "submitted" when it has only stored a message maps to recorded, not sent.

Normative text: spec 5.6.