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
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).
| Field | Type | Description |
|---|---|---|
ts | string (date-time) | |
stream | string | |
line | string |
MetricEvent
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.
| Field | Type | Description |
|---|---|---|
index | integer | |
metrics | object |
AgentEventKind
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
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
| Field | Type | Description |
|---|---|---|
role | string | |
text | string | |
call | integer | null | The model call that produced it (assistant only). |
checkpoint | AgentCheckpointNote | null | AG1 — set when the message is the agent's one-line report on a gate verdict ( |
AgentEventToolUse
| Field | Type | Description |
|---|---|---|
tool_use_id | string | |
name | string | |
input | object | |
args_summary | string | The arguments in one short line for the tool row (e.g. |
focus | AgentPaneFocus | null |
AgentEventToolResult
| Field | Type | Description |
|---|---|---|
tool_use_id | string | |
name | string | |
status | string |
|
args_summary | string | |
is_error | boolean | |
rejected | boolean | The hub's validators refused the arguments; nothing ran. |
summary | string | One line for the chat. |
content | string | null | What the model was given back (truncated for the stream). |
spend | AgentApproval | null | For a tool that cost money — the spend record (auto-approved, or decided by a person). |
ms | number | null | How long the call took, milliseconds. |
focus | AgentPaneFocus | null | |
links | AgentLinks | null |
AgentEventTerminal
Sandbox shell output, streamed while a command runs.
| Field | Type | Description |
|---|---|---|
tool_use_id | string | |
stream | string | |
text | string | |
exit_code | integer | null |
AgentEventApproval
| Field | Type | Description |
|---|---|---|
approval | AgentApproval |
AgentEventStatus
| Field | Type | Description |
|---|---|---|
status | AgentSessionStatus | |
reason | string | null | |
stop_code | string | null | |
waiting_on | AgentWait | null |
AgentEventUsage
One model call, metered — the cost the timeline shows beside it.
| Field | Type | Description |
|---|---|---|
call | integer | |
model | string | |
backend | string | null | |
input_tokens | integer | |
output_tokens | integer | |
cache_read_tokens | integer | |
cache_write_tokens | integer | |
reserved_usd | number | What was reserved before the call ( |
cost_usd | number | What the call cost, settled on the reported usage. |
priced | boolean | |
latency_ms | number | null | |
session_total_usd | number | null | |
allowance_remaining_usd | number | null |
AgentEventSandbox
| Field | Type | Description |
|---|---|---|
state | string |
|
sandbox_id | string | null | |
cold_start_ms | number | null | |
seconds | number | null | The interval that just ended, billed. |
cost_usd | number | null | |
reason | string | null |
AgentEventNotice
| Field | Type | Description |
|---|---|---|
code | string |
|
message | string | |
cause | string | null | For |
resource | ActivityResourceRef | null | For |
data | object | null |
AgentEvent
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.
| Field | Type | Description |
|---|---|---|
id | Id | |
seq | integer | Position in the session's stream (1-based, gapless). |
session_id | Id | |
kind | AgentEventKind | |
created_at | string (date-time) | |
data | AgentEventMessage | AgentEventToolUse | AgentEventToolResult | AgentEventTerminal | AgentEventApproval | AgentEventStatus | AgentEventUsage | AgentEventSandbox | AgentEventNotice | AgentEventPlan | AgentEventDecision | AgentEventRound | The payload for |
AgentRoundCard
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.
| Field | Type | Description |
|---|---|---|
round | RunRound | |
round_id | string | null | |
run_id | string | null | |
verdict | RoundVerdictValue | |
chosen_step | integer | null | |
checkpoints | integer | null | How many checkpoints the round's run published. |
changed | string | |
result | string | |
next | string | |
ranges | array of object | The per-step verdicts compressed into runs, e.g. PASS 1200–2200, FAIL 2299. |
from_step | integer | |
to_step | integer | |
verdict | RoundVerdictValue |
AgentCheckpointNote
AG1 — marks an assistant message as the one-line report on a gate verdict (the page folds them into "N checkpoint reports").
| Field | Type | Description |
|---|---|---|
run_id | Id | |
step | integer | |
gates_passed | integer | null | Cells passing the band at that checkpoint, from the gate row. |
gates_total | integer | null | |
verdict | RoundVerdictValue | null | The round's locked gates at that step, when the run is a round's. |
AgentEventPlan
| Field | Type | Description |
|---|---|---|
change | string | What happened to the plan. |
plan | AgentPlan | |
round_key | string | null | |
message | string | null |
AgentEventDecision
| Field | Type | Description |
|---|---|---|
change | string | |
decision | AgentDecision |
AgentEventRound
| Field | Type | Description |
|---|---|---|
card | AgentRoundCard |