Sessions

Sessions are the recorded agent runs behind your tasks. List them, download a session's transcript, read efficiency figures and run telemetry, and delete stale sessions.

📄️List sessions

Lists one page of agent sessions on the nodes the caller can see, running ones first, with totals and transcript availability. Filter by time `window`, `status`, `transcript_status`, `node`, `task`, text `q` or `stale`; sort with `sort` and `dir`. Requires permission to view sessions.

📄️Get session efficiency

Returns where runner time went across the caller's visible sessions for a date range (`since`, `until`), including files read repeatedly across sessions; a range too wide returns 422. When figures cannot be computed, `status` is `unavailable` with a reason. Requires permission to view sessions.

📄️Delete stale sessions

Deletes the stale sessions the caller can see: ones still marked running past the age limit that never uploaded a transcript and have no live runner. Each call deletes a capped number; `remaining` and `truncated` say whether to call again. Requires permission to edit sessions.

📄️Delete session

Deletes one stale session, still marked running past the age limit with no transcript and no live runner. Returns 204 with no body, 409 when the session is not stale, or 404 when the caller cannot see it. Requires permission to edit sessions.

📄️Download session transcript

Downloads a session's transcript as a gzip-compressed tar archive with a manifest. Returns 409 when no transcript was uploaded and 429 with `Retry-After` when too many downloads are being prepared. Requires permission to edit sessions.

📄️List runs

Lists recent run telemetry records, newest first, for nodes the caller can see, each with its task, repository, node and raw payload; `limit` is at most 1000. Requires permission to view system settings.