StepKind

One of 24 shapes:

1. step: "run_created"

   The Run document was committed (§7.1 step 3).

   Field	Type	Description
   steprequired	"run_created"

2. step: "started"

   An attempt's provider is up.

   Field	Type	Description
   steprequired	"started"

3. step: "turn_started"

   Field	Type	Description
   originatorrequired	TurnOriginator	Who submitted a turn.
   steprequired	"turn_started"

4. step: "tools_completed"

   ToolCompleted events, coalesced (§7.5: bounded, never one row per call).

   `failures` is what makes the count actionable - which tools failed and how, in tokens, bounded by type. An entry written before this build carries none, and reads as the counts alone: the same sentence it has always drawn, with nothing invented under it.

   Field	Type	Description
   callsrequired	integer (uint32, >= 0)
   failedrequired	integer (uint32, >= 0)
   failures	StoredToolFailures	How the breakdown is written down: the listed pairs and the tail's count, both absent when there are none. A fixed array would store eight nulls in every entry; this stores nothing in the ordinary case.
   steprequired	"tools_completed"

5. step: "approval_required"

   Field	Type	Description
   steprequired	"approval_required"

6. step: "approval_resolved"

   Field	Type	Description
   outcomerequired	ApprovalOutcome	How an approval ended.
   steprequired	"approval_resolved"

7. step: "waiting_for_input"

   Field	Type	Description
   steprequired	"waiting_for_input"

8. step: "attachment_accepted"

   Field	Type	Description
   steprequired	"attachment_accepted"

9. step: "attachment_rejected"

   Rejection is news (§7.5).

   Field	Type	Description
   steprequired	"attachment_rejected"

10. step: "child_session_detected"

    A child session appeared and was terminated (§7.3).

    Field	Type	Description
    steprequired	"child_session_detected"

11. step: "turn_completed"

    Field	Type	Description
    originatorrequired	TurnOriginator	Who submitted a turn.
    artifacts_registeredrequired	integer (uint32, >= 0)
    steprequired	"turn_completed"

12. step: "turn_cancelled"

    Field	Type	Description
    originatorrequired	TurnOriginator	Who submitted a turn.
    reasonrequired	CancelReason	Why a turn was cancelled (D36). Only `Run` terminalizes.
    steprequired	"turn_cancelled"

13. step: "turn_failed"

    Field	Type	Description
    originatorrequired	TurnOriginator	Who submitted a turn.
    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.
    steprequired	"turn_failed"

14. step: "interrupted"

    A restart ended the attempt (§7.6).

    Field	Type	Description
    prior_attemptrequired	PriorAttempt	What recovery could prove about the attempt a restart interrupted (§7.6).
    steprequired	"interrupted"

15. step: "resumed"

    Field	Type	Description
    viarequired	ResumeSeam	Which seam a resume went through (P1.9: the timeline says which).
    steprequired	"resumed"

16. step: "control_taken"

    The human lease was granted. discovered marks a takeover recovery found already in place, timestamped at discovery (§7.4).

    Field	Type	Description
    discoveredrequired	boolean
    steprequired	"control_taken"

17. step: "control_returned"

    Field	Type	Description
    steprequired	"control_returned"

18. step: "artifact_registered"

    Field	Type	Description
    steprequired	"artifact_registered"

19. step: "completed"

    Field	Type	Description
    steprequired	"completed"

20. step: "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.
    reason	RunFailureReason or null
    steprequired	"failed"

21. step: "cancelled"

    Field	Type	Description
    reasonrequired	CancelReason	Why a turn was cancelled (D36). Only `Run` terminalizes.
    steprequired	"cancelled"

22. step: "rated"

    Field	Type	Description
    ratingrequired	Rating	One gesture on a finished run (D44): good or not good. An unrated run is a normal state, which is why the header holds an Option<RunRating> and this enum has no "unrated" arm.
    steprequired	"rated"

23. step: "gap"

    Facts Koru never received - a provider tail evicted during delegate downtime. events_lost when the eviction reported a count.

    Field	Type	Description
    events_lost	integer (uint32, >= 0) or null
    steprequired	"gap"

24. step: "scope_busy"

    A manual start proceeded onto a folder another run holds (D34, §7.8): the warning the person saw and overrode, as a step. holders counts the runs that held it; their attempts ride the refs.

    Field	Type	Description
    holdersrequired	integer (uint32, >= 0)
    steprequired	"scope_busy"