Sessions
Sessions are the recorded agent runs behind your tasks. List them, download a session's transcript, read efficiency figures, and delete stale sessions. Project memory is here too: list memory units across projects and compare sessions with memory on and off.
Get memory comparison
Compares one project's sessions with project memory on against those with it off over the last `days` days: tasks, units injected, read and cited, calls to the first edit and repeated reads, plus the read rate per unit kind. An arm too small to compare carries a `notice` instead of figures, and a project whose organization's plan leaves project memory out answers `state` `off_by_plan` with empty arms. Requires permission to view sessions on the project.
List memory comparison projects
Lists the projects the caller may compare project memory on: those where it may view sessions, the ones whose plan includes project memory first.
List memory units across projects
Lists the memory units of every project you may view whose organization's plan includes project memory, newest first, each with its project and the same fields as a project's own list. Narrow it with `project_id`; pages with `limit` (up to 200) and `cursor`, sent back unchanged from `next_cursor`.
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.
Get session pane log
Returns the last lines a dead run's terminal showed, captured from its node when the session ended without a reason of its own, with escapes stripped and secrets redacted best-effort. Returns 404 when no pane log was captured. 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. Requires permission to edit sessions.