Agents

Past sessions

Conversations that have finished, and their transcripts

Two reads. The list of past conversations, and one conversation's full record by id.

GET/sessionsPast conversations in this workspace

Summaries for a history menu, filtered when you pass a search. Covers conversations that worked in their own private copies too, so nothing is hidden just because it happened on a branch.

What you send

Field	Type	Where
`query`	string	query
`caseSensitive`	string	query

What comes back

Field	Type
`sessions`Past conversations, newest first	object[]
`id`Its id	string
`title`What it is called	string
`updatedAt`When it last moved, in milliseconds	number
`snippet`Why a search matched: the line…	object
`text`The matching line, with a little…	string
`speaker`Who said it	"user" \| "agent"

Try itanswered in this tab

curl

curl "$SANDBOX/sessions" \
  -H "x-intentic-control: $INTENTIC_TOKEN"

TypeScript

import { sandbox } from "@intentic/sandbox-client";

const result = await sandbox.sessions.list();

GET/sessions/{id}Read one past conversation

The full record of a single conversation, restored for display.

What you send

Field	Type	Where
`id`requiredWhich past conversation	string	address

What comes back

Field	Type
`messages`The conversation, in order	object[]
`role`Who said it	"user" \| "assistant" \| "notice"
`text`The words	string
`run`The run that produced this row	string
`sentAt`When it was sent, in milliseconds	number
`messageId`The message's own id, on the…	string
`attachments`Files attached to this message, as…	string[]
`checkpointId`The saved point this message can…	string
`rewindIndex`This message's position in the conversation's…	integer
`thinking`What the agent was reasoning about	string
`tools`The tool calls this part of…	object[]
`id`The call's id	string
`name`Which tool	string
`category`What kind of thing it does:…	"read" \| "edit" \| "delete" \| "move" … (9)
`status`How it went	"pending" \| "in_progress" \| "completed" \| "failed"
`target`What it acted on, in one…	string
`locations`The files it touched	object[]
`path`The file, as a workspace path,…	string
`line`Which line, counting from one	number
`content`What it produced: text, a change…	object[]
`type`Plain output	"text"
`text`What the tool said	string
`children`Calls a delegated subagent made, nested…	object[]
`id`The call's id	string
`name`Which tool	string
`category`What kind of thing it does:…	"read" \| "edit" \| "delete" \| "move" … (9)
`status`How it went	"pending" \| "in_progress" \| "completed" \| "failed"
`target`What it acted on, in one…	string
`locations`The files it touched	object[]
`content`What it produced: text, a change…	object[]
`children`Calls a delegated subagent made, nested…	object[]
`nested`How many calls sit under this…	integer
`thinking`What the agent was reasoning about…	string
`subagent`The helper this call started, as…	object
`nested`How many calls sit under this…	integer
`thinking`What the agent was reasoning about…	string
`subagent`The helper this call started, as…	object
`id`Its own id, where that is…	string
`kind`	"subagent" \| "spawned"
`agentType`	string
`description`	string
`model`	string
`provider`	string
`background`	boolean
`status`	"pending" \| "running" \| "blocked" \| "completed" … (7)
`tokens`	number
`toolUses`	number
`lastTool`	string
`summary`	string
`error`	string
`verification`	object
`todos`The agent's task checklist, as of…	object[]
`content`The item, as the agent wrote…	string
`status`Where it is	"pending" \| "in_progress" \| "completed"
`activeForm`How to phrase it while it…	string
`usage`What the turn cost, on the…	object
`costUsd`	number
`inputTokens`	number
`outputTokens`	number
`durationMs`	number
`numTurns`	number
`notes`What the sandbox added to this…	object[]
`title`The one line a reader sees,…	string
`text`The note itself, which is also…	string
`speaker`Who sent this message, as the…	object
`when kind is "person"`	shape
`email`The signed-in member, as the sandbox…	string
`name`Their display name, where the sign-in…	string
`when kind is "program"`	shape
`token`The label of the control token…	string
`when kind is "agent"`	shape
`conversationId`The conversation whose agent is speaking:…	string
`when kind is "sandbox"`	shape
`source`What in the sandbox spoke: an…	string
`errand`What this message is for, when…	"land-conflict" \| "verify-nudge" \| "land-breakage" \| "land-fix" … (10)
`placed`A person wrote this in the…	boolean
`noticeAction`A one-press follow-up this notice offers,…	"landHold" \| "depsInstall" \| "watchStop" \| "sandboxMemory" … (6)
`sandboxHeld`The sandbox kept this refused turn…	boolean
`noticeWait`The wait this notice describes, by…	"credentialRenewal" \| "chatRoute" \| "watch"
`noticeWaitId`Which instance of the wait this…	string
`noticeCode`Which of the sandbox's own notices…	object
`code`Which of the sandbox's notices this…	string
`params`The facts the notice was worded…	object
`agentNotice`This notice was said by the…	object
`level`How loud it was said: a…	"info" \| "warning" \| "error"
`source`Who said it, when the runtime…	string
`plan`The plan this row asked approval…	object
`requestId`What to send back when you…	string
`text`The plan itself	string
`document`The write-up this plan refers to,…	object
`path`Where it lives, as a workspace…	string
`title`What it is called: its opening…	string
`markdown`The document itself	string
`truncated`It was clipped at the wire…	boolean
`plan`It is one of the CLI's…	boolean
`status`Where the decision stands	"pending" \| "approved" \| "rejected" \| "cancelled"
`question`The questions this row asked, and…	object
`requestId`What to send back when you…	string
`questions`What it wants to know	object[]
`question`What the agent is asking	string
`header`A short label for the question	string
`multiSelect`Whether more than one answer can…	boolean
`options`The choices offered	object[]
`document`The document this turn wrote and…	object
`path`Where it lives, as a workspace…	string
`title`What it is called: its opening…	string
`markdown`The document itself	string
`truncated`It was clipped at the wire…	boolean
`plan`It is one of the CLI's…	boolean
`status`Where the answer stands	"pending" \| "answered" \| "cancelled"
`answers`What was chosen, keyed by the…	object
`attachments`Files the user attached to their…	object
`permission`The tool this row asked permission…	object
`toolName`Which tool it wants to use	string
`title`The whole question, as a sentence,…	string
`displayName`A short phrase for the button,…	string
`description`More about what it is asking…	string
`reason`Why it is asking at all:…	string
`path`Which file it concerns, when it…	string
`alwaysLabel`The wording for an always-allow answer	string
`alwaysAsks`This request asks every time: an…	true
`program`The program this request is holding,…	object
`text`What would run	string
`language`Which of the two backends it…	"bash" \| "javascript"
`truncated`Whether this is an excerpt of…	boolean
`spans`Which fragments of the text the…	object[]
`child`The subagent this request would start…	object
`provider`Which provider serves it	string
`model`Which of that provider's models	string
`harness`Which agentic loop runs it	"native" \| "claude-code"
`account`Which of that provider's connected accounts…	string
`effort`How hard it thinks, where the…	string
`thinking`Whether it reasons before it answers,…	boolean
`fast`Whether it asks for the faster…	boolean
`move`What the parent asks to do:…	"spawn" \| "send" \| "answer"
`child`The child's id, for one that…	string
`task`What the child is for, in…	string
`message`What the parent would say to…	string
`on`Which machine it runs on, when…	string
`proposed`What the agent asked to start…	object
`explain`One plain sentence saying what the…	string
`requestId`What to send back when you…	string
`status`Where the decision stands	"pending" \| "allowed" \| "always" \| "everything" … (6)
`browserHelp`The browser hand-over this row asked…	object
`requestId`	string
`session`	string
`account`	string
`message`	string
`status`How the hand-over ended	"pending" \| "helped" \| "declined" \| "cancelled"
`terminalHelp`The terminal hand-over this row asked…	object
`requestId`	string
`session`	string
`message`	string
`status`How the hand-over ended	"pending" \| "helped" \| "declined" \| "cancelled"
`capabilityOffer`The capability setup this row asked…	object
`requestId`	string
`offer`	object
`entry`Which catalog entry is being asked…	string
`name`What it is called, as the…	string
`why`The agent's case for connecting it,…	string
`status`Where the decision stands	"pending" \| "connecting" \| "skipped" \| "cancelled"
`outcome`How an accepted ask's setup ended…	object
`outcome`	"connected" \| "unfinished"
`id`	string
`paymentOffer`The payment this row asked for,…	object
`requestId`	string
`offer`	object
`url`What is being paid for	string
`description`What the endpoint says it is	string
`payTo`Where the money goes, taken verbatim…	string
`network`On which network	string
`asset`In which token	string
`assetName`That token's name	string
`amountUsd`The exact price	string
`spentTodayUsd`What has already gone out today	string
`dailyCapUsd`What may go out in a…	string
`why`The agent's case for paying, and…	string
`status`Where the decision stands	"pending" \| "approved" \| "skipped" \| "cancelled"
`receipt`How the approved payment ended (the…	object
`outcome`	"paid" \| "failed"
`amountUsd`	string
`transaction`	string
`network`	string
`watchWake`The condition watch that woke this…	object
`outcome`How the watch ended: the condition…	"met" \| "timeout" \| "restart-expired" \| "broken"
`note`The agent's own line on what…	string
`elapsed`How long the watch stood, already…	string
`sent`The whole prompt the model was…	string
`need`Something the agent asked a person…	object
`id`The need's handle, the one `needs…	string
`conversationId`The conversation that asked, and the…	string
`subject`What exactly is asked for	object
`kind`	"capability"
`entry`The catalog entry, as the catalog…	string
`name`What the catalog calls it, never…	string
`mode`Connect something new, give a connected…	"connect" \| "reconnect" \| "change"
`instance`The connection a reconnect or a…	string
`target`The site, host or address the…	string
`prefill`Settings the agent could fill in…	object
`changes`For a change: each setting and…	object
`reason`The daemon's own sentence on why…	string
`reported`The agent reported the credential refused…	boolean
`title`The one line it leads with,…	string
`why`The agent's case for it, and…	string
`status`Where it stands: open (waiting on…	"open" \| "working" \| "met" \| "declined" … (5)
`createdAt`When it was raised, in milliseconds	number
`updatedAt`When it last moved, in milliseconds	number
`answeredBy`Who answered it, as the sandbox…	string
`outcome`How it ended, in the daemon's…	string
`told`How the agent heard the outcome,…	"call" \| "turn" \| "queued"
`unattended`Raised by a turn nobody was…	boolean
`needWake`The answered need that reached this…	object
`outcome`How the need ended: a person…	"met" \| "declined"
`title`The need, as its card leads…	string
`id`The need's handle, which its live…	string
`sent`The whole prompt the model received,…	string
`agentWords`Another agent's words that reached this…	object
`kind`Who sent it: another conversation in…	"peer" \| "child"
`from`The sending conversation's id	string
`title`The sender's title, when it had…	string
`failed`A child's report on a turn…	boolean
`sent`The whole prompt the model received,…	string
`backgroundJob`The background job this row marks…	object
`id`The daemon's handle for the job,…	string
`label`What the job is, in the…	string
`command`The command as the agent wrote…	string
`startedAt`When it started, in milliseconds	number
`credentialOffer`The gated credential this row asked…	object
`requestId`	string
`offer`	object
`subject`Which credential is being asked for	string
`kind`Whether this gate covers one stored…	"secret" \| "capability"
`lane`What the credential was about to…	"shell" \| "code" \| "browser" \| "session" … (5)
`detail`Where it would go: the start…	string
`why`The agent's case for using it,…	string
`approvers`Who may release it	string[]
`scope`How far one release goes: `use`…	"use" \| "conversation"
`status`Where the decision stands	"pending" \| "approved" \| "skipped" \| "cancelled"
`receipt`Who released it, or that somebody…	object
`outcome`	"released" \| "refused"
`approvedBy`	string

Try itanswered in this tab

curl

curl "$SANDBOX/sessions/a1b2c3d4" \
  -H "x-intentic-control: $INTENTIC_TOKEN"

TypeScript

import { sandbox } from "@intentic/sandbox-client";

const result = await sandbox.sessions.get({
  "id": "a1b2c3d4"
});