Skip to main content

Status machine

Canonical OLIP handoff status machine. Normative. A state may change only through a transition listed here, from an allowed source, carrying the listed evidence. Nothing may be inferred from another state.

Machine-readable file: status-machine.json.

Sources​

SourceMeaning
userThe consumer, proven by an out-of-band approval the calling agent cannot produce on its own.
clientThe authenticated calling agent platform acting for the user.
hostThe OLIP endpoint that stores the handoff.
transportA delivery channel (for example email or a webhook) that reports acceptance or failure.
recipient_systemThe recipient law firm's intake system, proven by a signature or an authenticated call.
recipient_humanA person at the recipient firm, recorded by the recipient system with an authenticated call.

States​

StateTerminalMeaning
draftnoPreview exists. Nothing approved, nothing transmitted.
approvednoThe user approved this exact recipient, fields, purpose and notice version. Nothing transmitted yet.
recordednoStored by the host and held (for example waiting for a policy gate). Not scheduled, not transmitted.
queuednoScheduled for transmission. One or more attempts may have failed. Not yet accepted by any channel.
sentnoA transport accepted the message. No proof it reached the recipient's system.
deliverednoThe recipient's intake system stored it and returned a verifiable receipt. No proof any person read it.
acknowledgednoA person at the recipient firm recorded that they viewed it. Automatic replies never count. Not acceptance of the matter.
respondednoA person at the recipient firm sent a substantive reply. Not acceptance of the matter.
declinedyesThe recipient said it will not take the matter.
consultation_requestednoA consultation was proposed. Not yet agreed.
consultation_confirmednoThe recipient confirmed a consultation time. Not an attorney-client relationship.
completedyesThe recipient recorded that the consultation took place. Says nothing about engagement or outcome.
cancelledyesThe user withdrew. If anything was already transmitted the recipient may keep a copy; see cancellation.effect.
failedyesTransmission could not be completed after the allowed attempts.
expiredyesThe approval or hold window ended before transmission.

States that mean something left the host: sent, delivered, acknowledged, responded, declined, consultation_requested, consultation_confirmed, completed.

Allowed transitions​

Anything not listed here MUST be refused with OLIP_INVALID_TRANSITION or OLIP_EVENT_SOURCE_FORBIDDEN.

FromToAllowed sourcesRequired evidence
draftapproveduseruser_approval
draftexpiredhostttl_elapsed
draftcancelledclient, usercancel_request
approvedexpiredhostttl_elapsed
approvedcancelledclient, usercancel_request
approvedrecordedhosthost_storage
approvedqueuedhosthost_storage
approveddeliveredrecipient_systemrecipient_receipt
recordedqueuedhosthold_released
recordedcancelledclient, usercancel_request
recordedexpiredhostttl_elapsed
queuedsenttransporttransport_acceptance
queueddeliveredrecipient_systemrecipient_receipt
queuedfailedhostdelivery_attempts_exhausted
queuedcancelledclient, usercancel_request
sentdeliveredrecipient_systemrecipient_receipt
sentfailedtransporttransport_failure
sentcancelledclient, usercancel_request
deliveredacknowledgedrecipient_humanrecipient_attestation
deliveredrespondedrecipient_humanrecipient_attestation
acknowledgedrespondedrecipient_humanrecipient_attestation
delivereddeclinedrecipient_humanrecipient_attestation
acknowledgeddeclinedrecipient_humanrecipient_attestation
respondeddeclinedrecipient_humanrecipient_attestation
deliveredconsultation_requestedrecipient_human, recipient_systemrecipient_attestation
acknowledgedconsultation_requestedrecipient_human, recipient_systemrecipient_attestation
respondedconsultation_requestedrecipient_human, recipient_systemrecipient_attestation
consultation_requestedconsultation_confirmedrecipient_human, recipient_systemrecipient_attestation
consultation_requesteddeclinedrecipient_humanrecipient_attestation
consultation_confirmedcompletedrecipient_humanrecipient_attestation
deliveredcancelledclient, usercancel_request
acknowledgedcancelledclient, usercancel_request
respondedcancelledclient, usercancel_request
consultation_requestedcancelledclient, user, recipient_humancancel_request
consultation_confirmedcancelledclient, user, recipient_humancancel_request

Recipient event types​

Events that only an authenticated recipient (its intake system or a person at the firm) may record: acknowledged, responded, declined, consultation_requested, consultation_confirmed, completed, cancelled. The calling agent can never record them.