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
| Source | Meaning |
|---|---|
user | The consumer, proven by an out-of-band approval the calling agent cannot produce on its own. |
client | The authenticated calling agent platform acting for the user. |
host | The OLIP endpoint that stores the handoff. |
transport | A delivery channel (for example email or a webhook) that reports acceptance or failure. |
recipient_system | The recipient law firm's intake system, proven by a signature or an authenticated call. |
recipient_human | A person at the recipient firm, recorded by the recipient system with an authenticated call. |
States
| State | Terminal | Meaning |
|---|---|---|
draft | no | Preview exists. Nothing approved, nothing transmitted. |
approved | no | The user approved this exact recipient, fields, purpose and notice version. Nothing transmitted yet. |
recorded | no | Stored by the host and held (for example waiting for a policy gate). Not scheduled, not transmitted. |
queued | no | Scheduled for transmission. One or more attempts may have failed. Not yet accepted by any channel. |
sent | no | A transport accepted the message. No proof it reached the recipient's system. |
delivered | no | The recipient's intake system stored it and returned a verifiable receipt. No proof any person read it. |
acknowledged | no | A person at the recipient firm recorded that they viewed it. Automatic replies never count. Not acceptance of the matter. |
responded | no | A person at the recipient firm sent a substantive reply. Not acceptance of the matter. |
declined | yes | The recipient said it will not take the matter. |
consultation_requested | no | A consultation was proposed. Not yet agreed. |
consultation_confirmed | no | The recipient confirmed a consultation time. Not an attorney-client relationship. |
completed | yes | The recipient recorded that the consultation took place. Says nothing about engagement or outcome. |
cancelled | yes | The user withdrew. If anything was already transmitted the recipient may keep a copy; see cancellation.effect. |
failed | yes | Transmission could not be completed after the allowed attempts. |
expired | yes | The 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.
| From | To | Allowed sources | Required evidence |
|---|---|---|---|
draft | approved | user | user_approval |
draft | expired | host | ttl_elapsed |
draft | cancelled | client, user | cancel_request |
approved | expired | host | ttl_elapsed |
approved | cancelled | client, user | cancel_request |
approved | recorded | host | host_storage |
approved | queued | host | host_storage |
approved | delivered | recipient_system | recipient_receipt |
recorded | queued | host | hold_released |
recorded | cancelled | client, user | cancel_request |
recorded | expired | host | ttl_elapsed |
queued | sent | transport | transport_acceptance |
queued | delivered | recipient_system | recipient_receipt |
queued | failed | host | delivery_attempts_exhausted |
queued | cancelled | client, user | cancel_request |
sent | delivered | recipient_system | recipient_receipt |
sent | failed | transport | transport_failure |
sent | cancelled | client, user | cancel_request |
delivered | acknowledged | recipient_human | recipient_attestation |
delivered | responded | recipient_human | recipient_attestation |
acknowledged | responded | recipient_human | recipient_attestation |
delivered | declined | recipient_human | recipient_attestation |
acknowledged | declined | recipient_human | recipient_attestation |
responded | declined | recipient_human | recipient_attestation |
delivered | consultation_requested | recipient_human, recipient_system | recipient_attestation |
acknowledged | consultation_requested | recipient_human, recipient_system | recipient_attestation |
responded | consultation_requested | recipient_human, recipient_system | recipient_attestation |
consultation_requested | consultation_confirmed | recipient_human, recipient_system | recipient_attestation |
consultation_requested | declined | recipient_human | recipient_attestation |
consultation_confirmed | completed | recipient_human | recipient_attestation |
delivered | cancelled | client, user | cancel_request |
acknowledged | cancelled | client, user | cancel_request |
responded | cancelled | client, user | cancel_request |
consultation_requested | cancelled | client, user, recipient_human | cancel_request |
consultation_confirmed | cancelled | client, user, recipient_human | cancel_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.