TimelineItem

One entry of the history as the wire carries it. Unrecognized is an entry this build could not decode, in its place.

One of 3 shapes:

entry: "step"

Field	Type	Description
idrequired	TimelineEntryId
kindrequired	StepKind	What a step is. A closed enum mirroring §7.5's rows plus control handover (§7.4), artifact registration, recovery and the honest gap (§7.1: replay never invents what it did not receive). Counts ride the variant that needs them, bounded by type.
refs	TimelineRefs	Default `[]`
at_msrequired	integer (int64)	Epoch milliseconds UTC, for display and for the §17.2 definitions. Order is the timeline's own - append order - never this clock.
entryrequired	"step"

entry: "usage"

Field	Type	Description
identityrequired	UsageFactId	Stable across retries and amendments alike.
attemptrequired	RunAttemptId
turnrequired	AgentTurnId
revisionrequired	AmendmentRevision	The monotonic amendment revision of a usage fact. A retry repeats it; a correction raises it.
input	integer (uint64, >= 0) or null	`None` is unavailable. It is never zero for missing.
output	integer (uint64, >= 0) or null
cached_input	integer (uint64, >= 0) or null
modelrequired	ModelRef
completenessrequired	Completeness
entryrequired	"usage"

Field	Type	Description
entryrequired	"unrecognized"

Example

{
  "id": "00000000-0000-4000-8000-000000000000",
  "kind": {
    "step": "run_created"
  },
  "refs": [],
  "at_ms": 0
}

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 November 12, 2026.