Skip to content
Docs menu

Other schemas

Schemas no operation's parameters, body or response names — the contract refers to them only in prose (the payloads of its event streams).

Schemas (19)

LogEvent

object

Payload of one SSE log event on the run logs stream. ts is the arrival time of the chunk the line came in; stream is stdout for the runner's own output and stderr for a notice the hub wrote into the log (lease re-queue, cancel request).

LogEvent fields
FieldTypeDescription
tsrequiredstring (date-time)
streamrequiredstring

one of stdout · stderr

linerequiredstring

MetricEvent

object

Payload of one SSE metric event on the run logs stream (M7-RL): one line of the run's metrics.jsonl, in file order. index is the zero-based line number, so a client that reconnects can drop what it already has.

MetricEvent fields
FieldTypeDescription
indexrequiredinteger

≥ 0

metricsrequiredobject

AgentEventKind

string

one of message · tool_use · tool_result · terminal · approval_requested · approval_resolved · status · usage · sandbox · notice · error · plan · decision · round

AG1 adds plan (a plan proposed, edited, approved, or one of its rounds started or skipped), decision (a decision requested, resolved, expired or withdrawn) and round (the round card).

AgentPaneFocus

string

one of run · gates · sim · terminal

Which tab of the agent page's live pane an event concerns: run (a training run's metrics and log), gates (rollouts, the three views), sim (a robot or policy in MuJoCo), terminal (the sandbox shell).

AgentEventMessage

object

AgentEventMessage fields
FieldTypeDescription
rolerequiredstring

one of user · assistant

textrequiredstring
callinteger | null

The model call that produced it (assistant only).

checkpointAgentCheckpointNote | null

AG1 — set when the message is the agent's one-line report on a gate verdict (checkpoint_note).

AgentEventToolUse

object

AgentEventToolUse fields
FieldTypeDescription
tool_use_idrequiredstring
namerequiredstring
inputrequiredobject
args_summarystring

The arguments in one short line for the tool row (e.g. l40s · 1,500 it).

focusAgentPaneFocus | null

AgentEventToolResult

object

AgentEventToolResult fields
FieldTypeDescription
tool_use_idrequiredstring
namerequiredstring
statusrequiredstring

one of ok · error · rejected · denied

ok, error, rejected (the validators refused it; nothing ran) or denied (a person denied the spend).

args_summarystring
is_errorrequiredboolean
rejectedboolean

The hub's validators refused the arguments; nothing ran.

summaryrequiredstring

One line for the chat.

contentstring | null

What the model was given back (truncated for the stream).

spendAgentApproval | null

For a tool that cost money — the spend record (auto-approved, or decided by a person).

msnumber | null

How long the call took, milliseconds.

focusAgentPaneFocus | null
linksAgentLinks | null

AgentEventTerminal

object

Sandbox shell output, streamed while a command runs.

AgentEventTerminal fields
FieldTypeDescription
tool_use_idrequiredstring
streamrequiredstring

one of command · stdout · stderr · exit

textrequiredstring
exit_codeinteger | null

AgentEventApproval

object

AgentEventApproval fields
FieldTypeDescription
approvalrequiredAgentApproval

AgentEventStatus

object

AgentEventStatus fields
FieldTypeDescription
statusrequiredAgentSessionStatus
reasonstring | null
stop_codestring | null
waiting_onAgentWait | null

AgentEventUsage

object

One model call, metered — the cost the timeline shows beside it.

AgentEventUsage fields
FieldTypeDescription
callrequiredinteger
modelrequiredstring
backendstring | null
input_tokensrequiredinteger
output_tokensrequiredinteger
cache_read_tokensrequiredinteger
cache_write_tokensrequiredinteger
reserved_usdrequirednumber

What was reserved before the call (count_tokens + max_tokens at list price).

cost_usdrequirednumber

What the call cost, settled on the reported usage.

pricedrequiredboolean
latency_msnumber | null
session_total_usdnumber | null
allowance_remaining_usdnumber | null

AgentEventSandbox

object

AgentEventSandbox fields
FieldTypeDescription
staterequiredstring

starting, running, restoring, snapshotted, terminated, or failed.

sandbox_idstring | null
cold_start_msnumber | null
secondsnumber | null

The interval that just ended, billed.

cost_usdnumber | null
reasonstring | null

AgentEventNotice

object

AgentEventNotice fields
FieldTypeDescription
coderequiredstring

woke, compacted, turn_limit, message_queued, wait_interrupted, and since AG1 slept, reopened, plan_required, … — informational.

messagerequiredstring
causestring | null

For woke: what woke the agent — run_finish, tripwire, gate_verdict, rollout_finish, approval (a person decided a device request), plan_finish, endpoint_claim, timeout, or user_message.

resourceActivityResourceRef | null

For woke, the resource that moved.

dataobject | null

AgentEvent

object

One row of a session's append-only event table, as streamAgentEvents sends it (data: of each SSE frame). data's shape follows kind: message → AgentEventMessage; tool_use → AgentEventToolUse; tool_result → AgentEventToolResult; terminal → AgentEventTerminal; approval_requested / approval_resolved → AgentEventApproval; status → AgentEventStatus; usage → AgentEventUsage; sandbox → AgentEventSandbox; notice / error → AgentEventNotice; AG1: plan → AgentEventPlan; decision → AgentEventDecision; round → AgentEventRound.

AgentEvent fields
FieldTypeDescription
idrequiredId
seqrequiredinteger

Position in the session's stream (1-based, gapless).

session_idrequiredId
kindrequiredAgentEventKind
created_atrequiredstring (date-time)
datarequiredAgentEventMessage | AgentEventToolUse | AgentEventToolResult | AgentEventTerminal | AgentEventApproval | AgentEventStatus | AgentEventUsage | AgentEventSandbox | AgentEventNotice | AgentEventPlan | AgentEventDecision | AgentEventRound

The payload for kind (anyOf, not oneOf — the shapes share no discriminator field).

AgentRoundCard

object

AG1 — the round card, three rows: Changed and Result are generated by the hub from the round (its declared change and variables; its locked gates at every checkpoint, the predictions, the tripwire), Next is the agent's proposal, quoted as written.

AgentRoundCard fields
FieldTypeDescription
roundrequiredRunRound
round_idstring | null
run_idstring | null
verdictrequiredRoundVerdictValue
chosen_stepinteger | null
checkpointsinteger | null

How many checkpoints the round's run published.

changedrequiredstring
resultrequiredstring
nextrequiredstring
rangesarray of object

The per-step verdicts compressed into runs, e.g. PASS 1200–2200, FAIL 2299.

from_steprequiredinteger
to_steprequiredinteger
verdictrequiredRoundVerdictValue

AgentCheckpointNote

object

AG1 — marks an assistant message as the one-line report on a gate verdict (the page folds them into "N checkpoint reports").

AgentCheckpointNote fields
FieldTypeDescription
run_idrequiredId
steprequiredinteger
gates_passedinteger | null

Cells passing the band at that checkpoint, from the gate row.

gates_totalinteger | null
verdictRoundVerdictValue | null

The round's locked gates at that step, when the run is a round's.

AgentEventPlan

object

AgentEventPlan fields
FieldTypeDescription
changerequiredstring

one of proposed · approved · edited · withdrawn · round_started · round_skipped · approval_failed

What happened to the plan.

planrequiredAgentPlan
round_keystring | null
messagestring | null

AgentEventDecision

object

AgentEventDecision fields
FieldTypeDescription
changerequiredstring

one of requested · resolved · expired · withdrawn · updated

decisionrequiredAgentDecision

AgentEventRound

object

AgentEventRound fields
FieldTypeDescription
cardrequiredAgentRoundCard