Monitor HTTP API

Generated from the monitor’s OpenAPI document (src/contraagent/_internal/monitor/openapi.json).

Contract version 3.5.0. All endpoints are GET.

Endpoint	Answers	What
`/api/info`	`Info`	The title, the panel tabs to offer, and the version of this contract.
`/api/runs`	`RunSummary[]`	Every run directory, newest activity first.
`/api/hosts`	`Hosts`	The hosts that drive the runs, and each account's utilization over every run.
`/api/trends?from&to&tz&run_group&stub`	`Trends`	What the runs of a period add up to, day by day.
`/api/trends/panels/{name}?from&to&tz&run_group`	`TilesBody \| TableBody \| ColumnsBody \| LinesBody \| HeatmapBody \| HBarsBody \| StatusGridBody \| NoteBody \| CodeBody \| TreeBody \| BlocksBody \| object`	One trend panel's body: its `fn(runs, period)` over the runs of the period, made on a panel thread, and kept for the same period over the same runs (`Monitor.trends_panel`).
`/api/runs/{run}/journal?since`	`JournalPage`	Journal rows after line offset `since`; `total` is the next offset.
`/api/runs/{run}/plan`	`Plan`	Every queued task with its dependencies and state, and the groups the UI draws as columns.
`/api/runs/{run}/outputs`	`Outputs`	Every declared output/input contract: its file, the model it must satisfy, its status.
`/api/runs/{run}/definitions`	`TaskDefinition[]`	What defined each kind of task in this run.
`/api/runs/{run}/cursor`	`CursorView`	The resume cursor; `{}` when the run keeps none.
`/api/runs/{run}/procs`	`Procs`	The run's live agent launches, process tree and Python tasks.
`/api/runs/{run}/task/{key}`	`TaskDetail`	One task, by its key: journal rows, live launches, definition, input/output, transcript name.
`/api/runs/{run}/stream/{key}?since`	`StreamPage`	A page of task `key`'s normalized transcript from line `since`; `since=0` is the tail page.
`/api/runs/{run}/panels/{name}`	`TilesBody \| TableBody \| ColumnsBody \| LinesBody \| HeatmapBody \| HBarsBody \| StatusGridBody \| NoteBody \| CodeBody \| TreeBody \| BlocksBody \| object`	One run panel's body: a typed body (tiles, a table, charts), or any JSON object; made on a panel thread.
`/events?run`	`SSE: RunEvent`	The run, live: journal rows as they land, then each other view when it changes.
`/events/stream?run&key`	`SSE: StreamMessage`	Task `key`'s transcript, live: the tail page, then the events after it as they are written.

Messages of `/events?run=`

Event	Model	Sent
`journal`	`JournalMessage`	One journal row, sent once per row: the whole journal on connect, then each new row.
`procs`	`ProcsMessage`	The live processes, sent when a launch starts or ends (not on every age tick).
`plan`	`PlanMessage`
`outputs`	`OutputsMessage`
`cursor`	`CursorMessage`	The resume cursor, or null for a run that keeps none.
`panel:<name>`	`PanelMessage`	A domain panel's body (`PanelBody`), sent when it changed. `{"error": ...}` when the panel raised.
`ready`	`ReadyMessage`	Sent once per connection, after the first round of messages: the journal replayed so far and the current value of every other view. A row that arrives after it is new, not part of the replay.

Messages of `/events/stream?run=&key=`

Event	Model	Sent
`stream`	`StreamMessage`	`/events/stream`: the first message is the transcript's tail page, then each message carries only the events after the previous one.