What runtime sessions provide#
The hosted Agent Runtime tracks durable execution state for governed agents. Each session has a workflow with turns, continuations, and scheduled wakeups.
Session lifecycle#
| Status | Meaning |
|---|---|
| active | Currently executing turns |
| waiting_approval | Paused, awaiting approval decision |
| scheduled | Sleeping until next_wake_at |
| suspended | Paused, awaiting manual continuation |
| completed | Finished successfully |
| error | Terminated with error |
List sessions with GET /api/v1/runtime/sessions. Fetch detail
(workflow state, messages, continuations) with
GET /api/v1/runtime/sessions/{id}.
Operator actions#
Operators can intervene in sessions via
POST /api/v1/runtime/sessions/{id}/actions:
| Action | Effect |
|---|---|
| resume | Continue a suspended session with optional messages |
| retry | Retry a failed session from last checkpoint |
| abort | Terminate a session immediately |
Sensitive actions (abort, retry) require approval when configured.
Correlation with delivery#
Runtime sessions correlate to delivery work units via session_id.
The delivery dispatch board shows workflow status inline for claimed
work units, and provides "Inspect runtime" links to session detail.
Next step#
See the DORA Metrics guide for delivery performance measurement.