EconomicsSummary

The run's economics as the header carries them (D39): a projection of the replayed facts and the timeline, recomputable at any time.

Type object

Shape

Field	Type	Description
orchestrator_turnsrequired	integer (uint32, >= 0)	Turns the timeline recorded, by originator.
human_turnsrequired	integer (uint32, >= 0)
turns_with_usagerequired	integer (uint32, >= 0)	Turns with a usage fact, after replay.
inputrequired	TokenTotal	A token total that knows what it is missing. `known` sums every turn that reported; `unavailable_turns` counts every turn that did not, so a surface renders "at least 1,200 (2 turns unreported)" rather than "1,200" - or "unavailable" when nothing reported at all.
outputrequired	TokenTotal	A token total that knows what it is missing. `known` sums every turn that reported; `unavailable_turns` counts every turn that did not, so a surface renders "at least 1,200 (2 turns unreported)" rather than "1,200" - or "unavailable" when nothing reported at all.
cached_inputrequired	TokenTotal	A token total that knows what it is missing. `known` sums every turn that reported; `unavailable_turns` counts every turn that did not, so a surface renders "at least 1,200 (2 turns unreported)" rather than "1,200" - or "unavailable" when nothing reported at all.
tool_callsrequired	integer (uint32, >= 0)
interventionsrequired	integer (uint32, >= 0)	§17.2: control handovers plus human-originated turns.
elapsed_ms	integer (uint64, >= 0) or null	§17.2: wall-clock excluding time spent `Interrupted` or under human control. `None` until the run has started.
models	array of ModelRef	Every model any turn used, as references. Default `[]`
completerequired	boolean	Whether every usage fact was complete. A single incomplete fact makes the summary incomplete, because a price over it would be a guess.

Example

{
  "orchestrator_turns": 0,
  "human_turns": 0,
  "turns_with_usage": 0,
  "input": {
    "known": 0,
    "unavailable_turns": 0
  },
  "output": {
    "known": 0,
    "unavailable_turns": 0
  },
  "cached_input": {
    "known": 0,
    "unavailable_turns": 0
  },
  "tool_calls": 0,
  "interventions": 0,
  "elapsed_ms": 0,
  "models": [],
  "complete": false
}

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.