Where a run is. One canonical authority - the Run document - holds it (§7.1); runs.db never carries a second one.
API reference sections
Schema
RunStatus
Type object or object or object or object or object or object or object or object or object
Shape
One of 9 shapes:
state: "created"
The Run document exists; nothing has been asked to start.
Field Type Description staterequired "created" state: "starting"
Admission, materialization and session creation are under way.
Field Type Description staterequired "starting" state: "running"
The provider is up.
attentionandcontrolare the markers §7.5 and §7.4 put on a running run instead of more states; both default so a header written before either existed still reads.Field Type Description attention AttentionSet Default
[]control ControlState Default
{"holder":"orchestrator"}staterequired "running" state: "interrupted"
A restart ended the attempt (D10). Never
Failed; offers Resume.Field Type Description prior_attemptrequired PriorAttempt What recovery could prove about the attempt a restart interrupted (§7.6).
staterequired "interrupted" state: "completed"
An orchestrator turn completed the objective with nothing pending.
Field Type Description staterequired "completed" state: "failed"
Field Type Description stagerequired FailureStage Why a start or a turn failed. A closed vocabulary - a stage, never a message - so a failure can be reported anywhere without carrying text.
staterequired "failed" state: "cancelled"
Field Type Description staterequired "cancelled" state: "awaiting_review"
Minted for M5 (UC14); no transition reaches it in M1.
Field Type Description staterequired "awaiting_review" state: "waiting_for_participant"
Minted for M5 (UC13); no transition reaches it in M1.
Field Type Description staterequired "waiting_for_participant"
{
"state": "created"
}The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.
Generated from contract version 1. Last updated .
