Private conversations
Who reads whose conversations, and how a private one is opened
On this page(8 sections)
The house rule, each person's default, making a conversation private or shared, asking its author to read it and their answer. The sandbox owner alone may open one without asking, with their passkey over a reason the author is shown; no agent can do any of it.
8 calls. Pick one to open it, or use the list on the right.
GET/sealWho reads whose conversations
The house rule for private conversations, whether an organisation fixed it, and whether a conversation you start now begins private.
What you send
Nothing. Call it as it is.
What comes back
| Field | Type |
|---|---|
modeThe house rule: who reads whose… | "everyone" | "chooses" | "private" |
lockedWhether the sandbox's organisation fixed the… | boolean |
twoPersonWhether opening a private conversation without… | boolean |
hostedWhether intentic runs this sandbox, so… | boolean |
sealedHow many conversations are private right… | integer |
startsPrivateWhether a conversation the caller starts… | boolean |
ownDefaultThe caller's own answer to whether… | boolean |
curl "$SANDBOX/seal" \
-H "x-intentic-control: $INTENTIC_TOKEN"import { sandbox } from "@intentic/sandbox-client";
const result = await sandbox.seal.house();POST/seal/houseSet who reads whose conversations
Sets the house rule. It applies to conversations started from now on: a conversation that is already private stays private whatever the rule becomes, until its author shares it.
What you send
| Field | Type | Where |
|---|---|---|
moderequired | "everyone" | "chooses" | "private" | body |
What comes back
| Field | Type |
|---|---|
modeThe house rule: who reads whose… | "everyone" | "chooses" | "private" |
lockedWhether the sandbox's organisation fixed the… | boolean |
twoPersonWhether opening a private conversation without… | boolean |
hostedWhether intentic runs this sandbox, so… | boolean |
sealedHow many conversations are private right… | integer |
startsPrivateWhether a conversation the caller starts… | boolean |
ownDefaultThe caller's own answer to whether… | boolean |
curl -X POST "$SANDBOX/seal/house" \
-H "x-intentic-control: $INTENTIC_TOKEN" \
-H "content-type: application/json" \
-d '{"mode":"everyone"}'import { sandbox } from "@intentic/sandbox-client";
const result = await sandbox.seal.setHouse({
"mode": "everyone"
});POST/seal/defaultStart my conversations private
Your own answer to whether the conversations you start begin private, where the house rule leaves it to each author.
What you send
| Field | Type | Where |
|---|---|---|
privaterequiredWhether the caller's new conversations start… | boolean | body |
What comes back
| Field | Type |
|---|---|
modeThe house rule: who reads whose… | "everyone" | "chooses" | "private" |
lockedWhether the sandbox's organisation fixed the… | boolean |
twoPersonWhether opening a private conversation without… | boolean |
hostedWhether intentic runs this sandbox, so… | boolean |
sealedHow many conversations are private right… | integer |
startsPrivateWhether a conversation the caller starts… | boolean |
ownDefaultThe caller's own answer to whether… | boolean |
curl -X POST "$SANDBOX/seal/default" \
-H "x-intentic-control: $INTENTIC_TOKEN" \
-H "content-type: application/json" \
-d '{"private":true}'import { sandbox } from "@intentic/sandbox-client";
const result = await sandbox.seal.setDefault({
"private": true
});POST/seal/{id}Make a conversation private or shared
Makes a conversation private to its author and the people they name, or shared again. Only its author may, or one of its readers when nobody answers for it. Its subagents and reviews follow it. What it already landed stays where it is.
What you send
| Field | Type | Where |
|---|---|---|
idrequiredThe conversation | string | address |
privaterequired | boolean | body |
readersWho besides its author may read… | string[] | body |
What comes back
| Field | Type |
|---|---|
idThe conversation id, which is how… | string |
sessionIdThe provider session behind the last… | string |
titleWhat to call it: the first… | string |
titleActionOne word for the kind of… | string |
statusWhat it is doing | "idle" | "running" | "awaiting" | "stopping" … (13) |
failureWhy the last turn failed, in… | string |
failureCodeWhich kind of failure it was,… | string |
failureOwnWhether `failure` is the sandbox's own… | boolean |
failureRepeatsHow many turns in a row… | integer |
limitResetsAtWhen the spent allowance reopens, in… | number |
limitHeldWhether the refused turn is held… | boolean |
limitScheduledSent only by sandboxes older than… | boolean |
limitMovingSent only by sandboxes older than… | string |
limitNextAtSent only by sandboxes older than… | number |
nextWhat carries it on next with… | object |
when kind is "rerun" | shape |
atWhen the held turn goes again,… | number |
ontoThe account the owner's answer to… | string |
when kind is "room" | shape |
when kind is "send" | shape |
atWhen the soonest booked message goes,… | number |
countHow many messages are booked to… | integer |
when kind is "land" | shape |
afterThe conversation whose landed work the… | string |
turnSet when that message waits for… | true |
countHow many messages are booked to… | integer |
pressThe daemon's one reading of what… | object |
when kind is "none" | shape |
when kind is "continue" | shape |
endingHow the last turn ended, which… | object |
reasonWhich ending left the work here:… | "limit" | "outage" | "stopped" | "flagged" |
resetsAtWhen the spent allowance reopens, in… | number |
heldPresent when the daemon still holds… | object |
scheduledWhether something other than the user… | boolean |
nextAtWhen the booked send actually fires,… | number |
retriesHow many automatic re-runs a stopped… | object |
providerWhich model provider it runs on | string |
harnessWhich agentic loop it runs on | "native" | "claude-code" | "codex" | "opencode" … (7) |
runnerThe runner this conversation runs on | string |
startInWhich folder it opened in, relative… | string |
actsAsWhich role its first turn acted… | string |
lastActsAsWhich role its last turn acted… | string |
modelWhat its last turn ran with | string |
effortHow hard that turn was told… | string |
thinkingWhether that turn showed its reasoning | boolean |
fastWhether that turn asked for higher… | boolean |
accountWhich connected account paid for it | string |
branchThe branch its private copy works… | string |
autoLandThis conversation's own answer to whether… | boolean |
limitPolicy | "wait" | "resend" | "move" |
outagePolicy | "wait" | "retry" |
stopPolicy | "wait" | "retry" |
memoryPolicy | "wait" | "resend" |
memoryKillPolicyThis conversation's own answer to a… | "wait" | "resume" |
proceedWithoutAskingThis conversation's own answer to whether… | boolean |
autoApproveWhether every permission this conversation asks… | "own" | "inherited" |
landRequestedA collaborator has asked a maintainer… | object |
emailWho asked | string |
nameTheir display name | string |
atWhen they asked, in milliseconds | number |
reactionsWhat people have marked this conversation… | object[] |
emojiThe mark itself, one emoji, carried… | string |
byEveryone wearing this mark, oldest first,… | object[] |
emailWho it was, as the sandbox… | string |
nameWhat to call them, when their… | string |
atWhen they marked it, in milliseconds | number |
originWhere the conversation came from when… | object |
automationId | string |
provider | string |
channelId | string |
threadId | string |
author | string |
startedByWho asked for the first turn,… | string |
areasWhich named areas of the workspace… | string[] |
ownerThe member answerable for this conversation:… | object |
emailWho answers for this conversation, as… | string |
nameWhat to call them, when the… | string |
sinceWhen they became its owner, in… | number |
participantsThe people who took part in… | object[] |
emailWho took part, lowercased, as the… | string |
nameWhat to call them, when their… | string |
sinceWhen they first took part, in… | number |
viaHow they first took part: they… | "prompt" | "answer" | "land" | "mention" |
notifyYour own answer to how much… | object[] |
emailWhose answer it is, lowercased | string |
levelWhat they asked to hear of… | "all" | "asks" | "none" |
atWhen they chose it, in milliseconds | number |
forkedFromThe conversation this one was cut… | object |
conversationId | string |
index | integer |
files | "then" | "now" |
freshSet on a conversation started on… | object |
ofThe conversation whose work it started… | string |
kindWhat it was opened for: a… | "review" | "test" | "ask" |
atWhen it started, in milliseconds | number |
byThe agent that opened it, when… | string |
branchesThe branches this conversation was started… | object[] |
repoWhich repository | string |
branchThe branch, by its short name:… | string |
sealSet on a private conversation: how… | object |
sealedThe caller cannot read this conversation:… | true |
viaHow the caller reads it | "reader" | "grant" | "open" |
untilUntil when the caller may read… | number |
readers | object[] |
email | string |
name | string |
grants | object[] |
email | string |
name | string |
untilUntil when they may read it,… | number |
byWho let them, by address | string |
asks | object[] |
email | string |
name | string |
at | number |
opens | object[] |
email | string |
name | string |
idThe opening's own id | string |
atWhen it was asked for, in… | number |
untilUntil when it may be read,… | number |
reasonWhy, in the opener's words, as… | string |
approvedBy | object |
email | string |
name | string |
at | number |
refusedBy | object |
email | string |
name | string |
at | number |
pending | true |
askedOn a sealed card: the caller… | true |
pendingAn opening without asking that waits… | object |
email | string |
name | string |
idThe opening's own id | string |
atWhen it was asked for, in… | number |
untilUntil when it may be read,… | number |
reasonWhy, in the opener's words, as… | string |
approvedBy | object |
email | string |
name | string |
at | number |
refusedBy | object |
email | string |
name | string |
at | number |
pending | true |
canOpenOn a sealed card: the caller… | true |
canApproveThe caller may agree to the… | true |
homeThis is its owner's home conversation… | true |
commitsA home conversation's latest lands as… | object[] |
landThe land's id, as its `landed`… | string |
atWhen it was committed, in milliseconds | number |
subjectThe commit's subject line | string |
commitsThe commit each repository the land… | object[] |
repoWhich repository: "root" for the workspace… | string |
shaThe commit, in full | string |
freshPendingA home conversation whose next message… | "asked" | "cleared" |
baseThe commit its private copy started… | string |
costUsdWhat it has cost so far,… | number |
inputTokensUncached input tokens, excluding cache reads… | number |
outputTokensTokens received | number |
contextTokensHow much of the window the… | number |
contextWindowHow large that window is | number |
promptCacheWhen this conversation's prompt cache was… | object |
atWhen its last request touched the… | number |
ttlMsHow long that entry lives from… | number |
rollsAtWhen the date written into the… | number |
keepableUntilPresent when this sandbox can keep… | number |
keepWarmWhether the sandbox is keeping this… | object |
sinceWhen keeping it warm started, in… | number |
untilWhen it stops by itself, in… | number |
refreshesRefreshes sent so far | integer |
readTokensHow much the last refresh read… | number |
endedWhy keeping it warm stopped before… | object |
atWhen it stopped, in milliseconds | number |
reasonWhy: `elapsed` the time asked for… | "elapsed" | "allowance" | "changed" | "cold" … (5) |
detailThe specifics, when there are any:… | string |
activityWhat it is doing at this… | object |
toolThe last tool it reached for | string |
targetWhat it reached for that tool… | string |
todoThe item on its own list… | string |
checklistHow far it is through its… | object |
doneItems it has completed | number |
totalItems on the list | number |
doingItems it has marked in progress… | number |
landedMessageDraftThe whole story of this merge's… | object |
startedAtWhen the drafting began, in milliseconds | number |
stepsEach model that was asked, in… | object[] |
providerWhich provider was asked | string |
modelWhich of its models | string |
statusHow this one went | "asking" | "answered" | "refused" | "skipped" |
atWhen it started being asked, in… | number |
msHow long it took | number |
reasonWhy it refused, in its own… | string |
outcomeHow it ended | "written" | "failed" |
reasonThe one-line account of a failure,… | string |
finishedAtWhen it ended, in milliseconds | number |
landedMessageWhat this conversation's merged work is… | object |
subjectOne line saying what the merged… | string |
noteThe same change said to somebody… | string |
breakingWhat this change takes away, for… | string |
testNoteWhy a test this change weakened… | string |
allowsExceptions the conversation declared for this… | string[] |
startedAtWhen the running turn started, in… | number |
runThe run under way right now:… | string |
queueMessages waiting for its next turn,… | object |
itemsWhat waits, in the order it… | object[] |
idThe message's id: what its sender… | string |
textThe words, as they will go… | string |
attachmentsFiles that go with it, as… | string[] |
voiceWho it is from: a person,… | "person" | "sandbox" | "agent" |
queuedAtWhen it joined the queue, in… | number |
revisionThe queue's revision when this message… | integer |
untilWhen this message goes out by… | number |
afterThe conversation whose finished work must… | string |
afterTurnSays `after` waits for that conversation's… | true |
reopenOfThe allowance this message's `until` waits… | object |
agentThe provider whose allowance it waits… | string |
accountWhich of its accounts | string |
trialRetrySays `until` is the sandbox sending… | object |
madeWhich automatic try this booking is,… | integer |
maxHow many automatic tries the sandbox… | integer |
servesWho serves the turn this message… | object |
agentThe provider | string |
harnessThe agentic loop | "native" | "claude-code" | "codex" | "opencode" … (7) |
modelThe model | string |
effortHow hard it thinks, where the… | string |
accountThe account that pays for it | string |
continuesA continuation, not words: when it… | true |
revisionMoves with every change to the… | integer |
pausedWhy the messages with no booking… | "stopped" | "refused" | "scheduled" |
untilThe soonest booked message's time, in… | number |
afterThe conversation the first booked message… | string |
updatedAtWhen it last did something, in… | number |
answeredAtWhen its model provider last answered… | number |
seenAtWhen somebody last opened it, in… | number |
unsentAtSince when somebody's composer has held… | number |
attentionWhich kinds of waiting-for-you it is… | object |
planIt has proposed a plan and… | boolean |
questionIt has asked you something | boolean |
permissionIt wants to use a tool… | boolean |
capabilityIt needs something connected that is… | boolean |
credentialIt is waiting for a named… | boolean |
conflictIts work cannot be merged without… | boolean |
needIt asked a person for something… | boolean |
permissionAskThe oldest permission its running turn… | object |
requestIdWhich request this is: the id… | string |
askWhat it asks to do, on… | string |
programThe program it is holding, as… | object |
textWhat would run | string |
languageWhich of the two backends it… | "bash" | "javascript" |
truncatedWhether this is an excerpt of… | boolean |
spansWhich fragments of the text the… | object[] |
start | integer |
end | integer |
landFailureThe last attempt to bring its… | object |
reasonWhy it failed, in the words… | string |
codeWhich kind of failure it was,… | string |
atWhen it failed, in milliseconds | number |
deliveryWhat became of its last land… | object |
state | "delivered" | "partial" | "waiting" | "failed" … (5) |
atWhen this state was reached, in… | number |
project | string |
folderThe folder on the owner's computer,… | string |
appliedFiles written, merged ones included | integer |
conflicts | object[] |
path | string |
reason | "edited" | "link" | "outside" | "missing-git" |
pointThe machine's restore point taken before… | string |
reasonWhy it failed or waits, in… | string |
conflictCausesWhy its work will not merge,… | "workspace" | "diverged" | "binary"[] |
unfinishedWhat its last turn left open:… | object |
atWhen the turn that left this… | number |
stepsThe agent's own checklist where that… | object |
openItems on it that were never… | number |
totalItems on the whole list | number |
nextThe one it would have done… | string |
checkThe end-of-turn check that was still… | string |
proofWhat its last turn showed of… | object |
atWhen the turn that left this… | number |
verificationVerified: a check it ran passed… | "verified" | "unproven" | "failing" | "no-code" |
checkThe command that spoke, when one… | string |
unviewedHow many rendered files it changed… | number |
reviewThe latest code review this conversation… | object |
atWhen the turn that reported it… | number |
sourceWhich harness's reviewer reported it | "claude" | "codex" |
findingsHow many findings it reported | integer |
openHow many of those no re-report… | integer |
reachWhere its last turn's work went… | object |
atWhen the turn that left this… | number |
liveFiles it changed in place where… | object[] |
pathWhat it wrote, as it named… | string |
extensionThe extension, by its manifest id,… | string |
liveMoreHow many more such files there… | number |
strandedRepositories it cloned inside its own… | object[] |
dirThe clone, as a folder relative… | string |
uncommittedFiles changed in it and never… | number |
unpushedCommits in it its upstream does… | number |
commitsCommits it holds at all, 0… | number |
parentThe workspace repository it sits inside,… | string |
strandedMoreHow many more such clones there… | number |
publishedPushes it made with git that… | object[] |
dirThe folder it pushed from, as… | string |
remoteThe remote it pushed to, as… | string |
branchThe branch it pushed to, as… | string |
commandThe push itself, trimmed to one… | string |
publishedMoreHow many more such pushes there… | number |
turnsTurns it has finished | number |
toolUsesTools it has used, over its… | number |
subagentsSubagents this one started, in-process and… | object |
runningSubagents working right now | number |
totalSubagents it has started over its… | number |
diffEverything it has written, measured from… | object |
filesFiles touched | number |
insertionsLines added | number |
deletionsLines removed | number |
modulesThe packages its changes fall in,… | string[] |
landedPresencePresent only when some of what… | object |
landedPaths this conversation merged in | number |
presentHow many of them are still… | number |
removedByWho took them out, when the… | object |
when kind is "agent" | shape |
idThe conversation that took them out | string |
titleWhat that conversation is called | string |
when kind is "person" | shape |
emailWho it was, as the sandbox… | string |
nameWhat to call them, when their… | string |
loopThe loop driving this conversation, if… | object |
stateHow the loop is going | "running" | "done" | "exhausted" | "stalled" … (8) |
iterationWhich round it is on | integer |
maxIterationsHow many rounds it will attempt… | integer |
goalWhat it is looping towards | string |
workflowThe workflow run this conversation is… | object |
runIdThe run this belongs to, which… | string |
nameThe workflow's name | string |
stepWhich step this conversation is on… | string |
indexThis step's place in the workflow,… | integer |
totalHow many steps the workflow has | integer |
awaitingWakeWhether this conversation runs again by… | boolean |
watchesOutside conditions this conversation is parked… | object[] |
idThe daemon's handle for this watch,… | string |
noteThe agent's own line on what… | string |
intervalSecondsHow often the check runs | integer |
deadlineAtWhen it gives up and wakes… | number |
needsWhat it is waiting on people… | object[] |
id | string |
kindWhat is being asked for: a… | "capability" | "secret" | "grant" | "release" … (8) |
title | string |
statusWhere it stands: open (waiting on… | "open" | "working" | "met" | "declined" … (5) |
jobsCommands this conversation left running in… | object[] |
idThe daemon's handle for this job,… | string |
labelWhat the job is, in the… | string |
sessionThe terminal session its pane runs… | string |
startedAtWhen it started, in milliseconds | number |
endedAtWhen the command exited, in milliseconds | number |
exitCodeThe code it exited with | integer |
watchThe watch its exit wakes this… | string |
handedLeft running for the person: the… | boolean |
portsThe ports it was listening on… | integer[] |
stoppedByWho stopped it: the sandbox, when… | "turn" | "person" | "agent" |
inputWaitPresent while it sits blocked reading… | object |
sinceWhen it went still, in milliseconds | number |
programThe process blocked reading the terminal,… | string |
scriptRunsWorkflow runs this conversation started that… | object[] |
idThe run's id, the one its… | string |
nameThe workflow's name, from its script's… | string |
callsHow many subagents it has started… | integer |
workingHow many of its subagents are… | integer |
failedHow many of its calls failed… | integer |
phaseThe phase its script last marked | string |
startedAtWhen it started, in milliseconds | number |
archivedAtWhen it was put away, in… | number |
curl -X POST "$SANDBOX/seal/a1b2c3d4" \
-H "x-intentic-control: $INTENTIC_TOKEN" \
-H "content-type: application/json" \
-d '{"private":true,"readers":["…","…"]}'import { sandbox } from "@intentic/sandbox-client";
const result = await sandbox.seal.set({
"id": "a1b2c3d4",
"private": true,
"readers": [
"…",
"…"
]
});POST/seal/{id}/askAsk to read a private conversation
Asks its author to show it to you. They can show it for a day, add you as a reader, or say no; nothing opens until they answer.
What you send
| Field | Type | Where |
|---|---|---|
idrequiredThe conversation | string | address |
What comes back
| Field | Type |
|---|---|
idThe conversation id, which is how… | string |
sessionIdThe provider session behind the last… | string |
titleWhat to call it: the first… | string |
titleActionOne word for the kind of… | string |
statusWhat it is doing | "idle" | "running" | "awaiting" | "stopping" … (13) |
failureWhy the last turn failed, in… | string |
failureCodeWhich kind of failure it was,… | string |
failureOwnWhether `failure` is the sandbox's own… | boolean |
failureRepeatsHow many turns in a row… | integer |
limitResetsAtWhen the spent allowance reopens, in… | number |
limitHeldWhether the refused turn is held… | boolean |
limitScheduledSent only by sandboxes older than… | boolean |
limitMovingSent only by sandboxes older than… | string |
limitNextAtSent only by sandboxes older than… | number |
nextWhat carries it on next with… | object |
when kind is "rerun" | shape |
atWhen the held turn goes again,… | number |
ontoThe account the owner's answer to… | string |
when kind is "room" | shape |
when kind is "send" | shape |
atWhen the soonest booked message goes,… | number |
countHow many messages are booked to… | integer |
when kind is "land" | shape |
afterThe conversation whose landed work the… | string |
turnSet when that message waits for… | true |
countHow many messages are booked to… | integer |
pressThe daemon's one reading of what… | object |
when kind is "none" | shape |
when kind is "continue" | shape |
endingHow the last turn ended, which… | object |
reasonWhich ending left the work here:… | "limit" | "outage" | "stopped" | "flagged" |
resetsAtWhen the spent allowance reopens, in… | number |
heldPresent when the daemon still holds… | object |
scheduledWhether something other than the user… | boolean |
nextAtWhen the booked send actually fires,… | number |
retriesHow many automatic re-runs a stopped… | object |
providerWhich model provider it runs on | string |
harnessWhich agentic loop it runs on | "native" | "claude-code" | "codex" | "opencode" … (7) |
runnerThe runner this conversation runs on | string |
startInWhich folder it opened in, relative… | string |
actsAsWhich role its first turn acted… | string |
lastActsAsWhich role its last turn acted… | string |
modelWhat its last turn ran with | string |
effortHow hard that turn was told… | string |
thinkingWhether that turn showed its reasoning | boolean |
fastWhether that turn asked for higher… | boolean |
accountWhich connected account paid for it | string |
branchThe branch its private copy works… | string |
autoLandThis conversation's own answer to whether… | boolean |
limitPolicy | "wait" | "resend" | "move" |
outagePolicy | "wait" | "retry" |
stopPolicy | "wait" | "retry" |
memoryPolicy | "wait" | "resend" |
memoryKillPolicyThis conversation's own answer to a… | "wait" | "resume" |
proceedWithoutAskingThis conversation's own answer to whether… | boolean |
autoApproveWhether every permission this conversation asks… | "own" | "inherited" |
landRequestedA collaborator has asked a maintainer… | object |
emailWho asked | string |
nameTheir display name | string |
atWhen they asked, in milliseconds | number |
reactionsWhat people have marked this conversation… | object[] |
emojiThe mark itself, one emoji, carried… | string |
byEveryone wearing this mark, oldest first,… | object[] |
emailWho it was, as the sandbox… | string |
nameWhat to call them, when their… | string |
atWhen they marked it, in milliseconds | number |
originWhere the conversation came from when… | object |
automationId | string |
provider | string |
channelId | string |
threadId | string |
author | string |
startedByWho asked for the first turn,… | string |
areasWhich named areas of the workspace… | string[] |
ownerThe member answerable for this conversation:… | object |
emailWho answers for this conversation, as… | string |
nameWhat to call them, when the… | string |
sinceWhen they became its owner, in… | number |
participantsThe people who took part in… | object[] |
emailWho took part, lowercased, as the… | string |
nameWhat to call them, when their… | string |
sinceWhen they first took part, in… | number |
viaHow they first took part: they… | "prompt" | "answer" | "land" | "mention" |
notifyYour own answer to how much… | object[] |
emailWhose answer it is, lowercased | string |
levelWhat they asked to hear of… | "all" | "asks" | "none" |
atWhen they chose it, in milliseconds | number |
forkedFromThe conversation this one was cut… | object |
conversationId | string |
index | integer |
files | "then" | "now" |
freshSet on a conversation started on… | object |
ofThe conversation whose work it started… | string |
kindWhat it was opened for: a… | "review" | "test" | "ask" |
atWhen it started, in milliseconds | number |
byThe agent that opened it, when… | string |
branchesThe branches this conversation was started… | object[] |
repoWhich repository | string |
branchThe branch, by its short name:… | string |
sealSet on a private conversation: how… | object |
sealedThe caller cannot read this conversation:… | true |
viaHow the caller reads it | "reader" | "grant" | "open" |
untilUntil when the caller may read… | number |
readers | object[] |
email | string |
name | string |
grants | object[] |
email | string |
name | string |
untilUntil when they may read it,… | number |
byWho let them, by address | string |
asks | object[] |
email | string |
name | string |
at | number |
opens | object[] |
email | string |
name | string |
idThe opening's own id | string |
atWhen it was asked for, in… | number |
untilUntil when it may be read,… | number |
reasonWhy, in the opener's words, as… | string |
approvedBy | object |
email | string |
name | string |
at | number |
refusedBy | object |
email | string |
name | string |
at | number |
pending | true |
askedOn a sealed card: the caller… | true |
pendingAn opening without asking that waits… | object |
email | string |
name | string |
idThe opening's own id | string |
atWhen it was asked for, in… | number |
untilUntil when it may be read,… | number |
reasonWhy, in the opener's words, as… | string |
approvedBy | object |
email | string |
name | string |
at | number |
refusedBy | object |
email | string |
name | string |
at | number |
pending | true |
canOpenOn a sealed card: the caller… | true |
canApproveThe caller may agree to the… | true |
homeThis is its owner's home conversation… | true |
commitsA home conversation's latest lands as… | object[] |
landThe land's id, as its `landed`… | string |
atWhen it was committed, in milliseconds | number |
subjectThe commit's subject line | string |
commitsThe commit each repository the land… | object[] |
repoWhich repository: "root" for the workspace… | string |
shaThe commit, in full | string |
freshPendingA home conversation whose next message… | "asked" | "cleared" |
baseThe commit its private copy started… | string |
costUsdWhat it has cost so far,… | number |
inputTokensUncached input tokens, excluding cache reads… | number |
outputTokensTokens received | number |
contextTokensHow much of the window the… | number |
contextWindowHow large that window is | number |
promptCacheWhen this conversation's prompt cache was… | object |
atWhen its last request touched the… | number |
ttlMsHow long that entry lives from… | number |
rollsAtWhen the date written into the… | number |
keepableUntilPresent when this sandbox can keep… | number |
keepWarmWhether the sandbox is keeping this… | object |
sinceWhen keeping it warm started, in… | number |
untilWhen it stops by itself, in… | number |
refreshesRefreshes sent so far | integer |
readTokensHow much the last refresh read… | number |
endedWhy keeping it warm stopped before… | object |
atWhen it stopped, in milliseconds | number |
reasonWhy: `elapsed` the time asked for… | "elapsed" | "allowance" | "changed" | "cold" … (5) |
detailThe specifics, when there are any:… | string |
activityWhat it is doing at this… | object |
toolThe last tool it reached for | string |
targetWhat it reached for that tool… | string |
todoThe item on its own list… | string |
checklistHow far it is through its… | object |
doneItems it has completed | number |
totalItems on the list | number |
doingItems it has marked in progress… | number |
landedMessageDraftThe whole story of this merge's… | object |
startedAtWhen the drafting began, in milliseconds | number |
stepsEach model that was asked, in… | object[] |
providerWhich provider was asked | string |
modelWhich of its models | string |
statusHow this one went | "asking" | "answered" | "refused" | "skipped" |
atWhen it started being asked, in… | number |
msHow long it took | number |
reasonWhy it refused, in its own… | string |
outcomeHow it ended | "written" | "failed" |
reasonThe one-line account of a failure,… | string |
finishedAtWhen it ended, in milliseconds | number |
landedMessageWhat this conversation's merged work is… | object |
subjectOne line saying what the merged… | string |
noteThe same change said to somebody… | string |
breakingWhat this change takes away, for… | string |
testNoteWhy a test this change weakened… | string |
allowsExceptions the conversation declared for this… | string[] |
startedAtWhen the running turn started, in… | number |
runThe run under way right now:… | string |
queueMessages waiting for its next turn,… | object |
itemsWhat waits, in the order it… | object[] |
idThe message's id: what its sender… | string |
textThe words, as they will go… | string |
attachmentsFiles that go with it, as… | string[] |
voiceWho it is from: a person,… | "person" | "sandbox" | "agent" |
queuedAtWhen it joined the queue, in… | number |
revisionThe queue's revision when this message… | integer |
untilWhen this message goes out by… | number |
afterThe conversation whose finished work must… | string |
afterTurnSays `after` waits for that conversation's… | true |
reopenOfThe allowance this message's `until` waits… | object |
agentThe provider whose allowance it waits… | string |
accountWhich of its accounts | string |
trialRetrySays `until` is the sandbox sending… | object |
madeWhich automatic try this booking is,… | integer |
maxHow many automatic tries the sandbox… | integer |
servesWho serves the turn this message… | object |
agentThe provider | string |
harnessThe agentic loop | "native" | "claude-code" | "codex" | "opencode" … (7) |
modelThe model | string |
effortHow hard it thinks, where the… | string |
accountThe account that pays for it | string |
continuesA continuation, not words: when it… | true |
revisionMoves with every change to the… | integer |
pausedWhy the messages with no booking… | "stopped" | "refused" | "scheduled" |
untilThe soonest booked message's time, in… | number |
afterThe conversation the first booked message… | string |
updatedAtWhen it last did something, in… | number |
answeredAtWhen its model provider last answered… | number |
seenAtWhen somebody last opened it, in… | number |
unsentAtSince when somebody's composer has held… | number |
attentionWhich kinds of waiting-for-you it is… | object |
planIt has proposed a plan and… | boolean |
questionIt has asked you something | boolean |
permissionIt wants to use a tool… | boolean |
capabilityIt needs something connected that is… | boolean |
credentialIt is waiting for a named… | boolean |
conflictIts work cannot be merged without… | boolean |
needIt asked a person for something… | boolean |
permissionAskThe oldest permission its running turn… | object |
requestIdWhich request this is: the id… | string |
askWhat it asks to do, on… | string |
programThe program it is holding, as… | object |
textWhat would run | string |
languageWhich of the two backends it… | "bash" | "javascript" |
truncatedWhether this is an excerpt of… | boolean |
spansWhich fragments of the text the… | object[] |
start | integer |
end | integer |
landFailureThe last attempt to bring its… | object |
reasonWhy it failed, in the words… | string |
codeWhich kind of failure it was,… | string |
atWhen it failed, in milliseconds | number |
deliveryWhat became of its last land… | object |
state | "delivered" | "partial" | "waiting" | "failed" … (5) |
atWhen this state was reached, in… | number |
project | string |
folderThe folder on the owner's computer,… | string |
appliedFiles written, merged ones included | integer |
conflicts | object[] |
path | string |
reason | "edited" | "link" | "outside" | "missing-git" |
pointThe machine's restore point taken before… | string |
reasonWhy it failed or waits, in… | string |
conflictCausesWhy its work will not merge,… | "workspace" | "diverged" | "binary"[] |
unfinishedWhat its last turn left open:… | object |
atWhen the turn that left this… | number |
stepsThe agent's own checklist where that… | object |
openItems on it that were never… | number |
totalItems on the whole list | number |
nextThe one it would have done… | string |
checkThe end-of-turn check that was still… | string |
proofWhat its last turn showed of… | object |
atWhen the turn that left this… | number |
verificationVerified: a check it ran passed… | "verified" | "unproven" | "failing" | "no-code" |
checkThe command that spoke, when one… | string |
unviewedHow many rendered files it changed… | number |
reviewThe latest code review this conversation… | object |
atWhen the turn that reported it… | number |
sourceWhich harness's reviewer reported it | "claude" | "codex" |
findingsHow many findings it reported | integer |
openHow many of those no re-report… | integer |
reachWhere its last turn's work went… | object |
atWhen the turn that left this… | number |
liveFiles it changed in place where… | object[] |
pathWhat it wrote, as it named… | string |
extensionThe extension, by its manifest id,… | string |
liveMoreHow many more such files there… | number |
strandedRepositories it cloned inside its own… | object[] |
dirThe clone, as a folder relative… | string |
uncommittedFiles changed in it and never… | number |
unpushedCommits in it its upstream does… | number |
commitsCommits it holds at all, 0… | number |
parentThe workspace repository it sits inside,… | string |
strandedMoreHow many more such clones there… | number |
publishedPushes it made with git that… | object[] |
dirThe folder it pushed from, as… | string |
remoteThe remote it pushed to, as… | string |
branchThe branch it pushed to, as… | string |
commandThe push itself, trimmed to one… | string |
publishedMoreHow many more such pushes there… | number |
turnsTurns it has finished | number |
toolUsesTools it has used, over its… | number |
subagentsSubagents this one started, in-process and… | object |
runningSubagents working right now | number |
totalSubagents it has started over its… | number |
diffEverything it has written, measured from… | object |
filesFiles touched | number |
insertionsLines added | number |
deletionsLines removed | number |
modulesThe packages its changes fall in,… | string[] |
landedPresencePresent only when some of what… | object |
landedPaths this conversation merged in | number |
presentHow many of them are still… | number |
removedByWho took them out, when the… | object |
when kind is "agent" | shape |
idThe conversation that took them out | string |
titleWhat that conversation is called | string |
when kind is "person" | shape |
emailWho it was, as the sandbox… | string |
nameWhat to call them, when their… | string |
loopThe loop driving this conversation, if… | object |
stateHow the loop is going | "running" | "done" | "exhausted" | "stalled" … (8) |
iterationWhich round it is on | integer |
maxIterationsHow many rounds it will attempt… | integer |
goalWhat it is looping towards | string |
workflowThe workflow run this conversation is… | object |
runIdThe run this belongs to, which… | string |
nameThe workflow's name | string |
stepWhich step this conversation is on… | string |
indexThis step's place in the workflow,… | integer |
totalHow many steps the workflow has | integer |
awaitingWakeWhether this conversation runs again by… | boolean |
watchesOutside conditions this conversation is parked… | object[] |
idThe daemon's handle for this watch,… | string |
noteThe agent's own line on what… | string |
intervalSecondsHow often the check runs | integer |
deadlineAtWhen it gives up and wakes… | number |
needsWhat it is waiting on people… | object[] |
id | string |
kindWhat is being asked for: a… | "capability" | "secret" | "grant" | "release" … (8) |
title | string |
statusWhere it stands: open (waiting on… | "open" | "working" | "met" | "declined" … (5) |
jobsCommands this conversation left running in… | object[] |
idThe daemon's handle for this job,… | string |
labelWhat the job is, in the… | string |
sessionThe terminal session its pane runs… | string |
startedAtWhen it started, in milliseconds | number |
endedAtWhen the command exited, in milliseconds | number |
exitCodeThe code it exited with | integer |
watchThe watch its exit wakes this… | string |
handedLeft running for the person: the… | boolean |
portsThe ports it was listening on… | integer[] |
stoppedByWho stopped it: the sandbox, when… | "turn" | "person" | "agent" |
inputWaitPresent while it sits blocked reading… | object |
sinceWhen it went still, in milliseconds | number |
programThe process blocked reading the terminal,… | string |
scriptRunsWorkflow runs this conversation started that… | object[] |
idThe run's id, the one its… | string |
nameThe workflow's name, from its script's… | string |
callsHow many subagents it has started… | integer |
workingHow many of its subagents are… | integer |
failedHow many of its calls failed… | integer |
phaseThe phase its script last marked | string |
startedAtWhen it started, in milliseconds | number |
archivedAtWhen it was put away, in… | number |
curl -X POST "$SANDBOX/seal/a1b2c3d4/ask" \
-H "x-intentic-control: $INTENTIC_TOKEN"import { sandbox } from "@intentic/sandbox-client";
const result = await sandbox.seal.ask({
"id": "a1b2c3d4"
});POST/seal/{id}/answerAnswer an ask to read
The author's answer to someone who asked to read their private conversation: for a day, for good, or no.
What you send
| Field | Type | Where |
|---|---|---|
idrequiredThe conversation | string | address |
emailrequiredWhose ask this answers | string | body |
answerrequiredShow it to them for a… | "day" | "always" | "decline" | body |
What comes back
| Field | Type |
|---|---|
idThe conversation id, which is how… | string |
sessionIdThe provider session behind the last… | string |
titleWhat to call it: the first… | string |
titleActionOne word for the kind of… | string |
statusWhat it is doing | "idle" | "running" | "awaiting" | "stopping" … (13) |
failureWhy the last turn failed, in… | string |
failureCodeWhich kind of failure it was,… | string |
failureOwnWhether `failure` is the sandbox's own… | boolean |
failureRepeatsHow many turns in a row… | integer |
limitResetsAtWhen the spent allowance reopens, in… | number |
limitHeldWhether the refused turn is held… | boolean |
limitScheduledSent only by sandboxes older than… | boolean |
limitMovingSent only by sandboxes older than… | string |
limitNextAtSent only by sandboxes older than… | number |
nextWhat carries it on next with… | object |
when kind is "rerun" | shape |
atWhen the held turn goes again,… | number |
ontoThe account the owner's answer to… | string |
when kind is "room" | shape |
when kind is "send" | shape |
atWhen the soonest booked message goes,… | number |
countHow many messages are booked to… | integer |
when kind is "land" | shape |
afterThe conversation whose landed work the… | string |
turnSet when that message waits for… | true |
countHow many messages are booked to… | integer |
pressThe daemon's one reading of what… | object |
when kind is "none" | shape |
when kind is "continue" | shape |
endingHow the last turn ended, which… | object |
reasonWhich ending left the work here:… | "limit" | "outage" | "stopped" | "flagged" |
resetsAtWhen the spent allowance reopens, in… | number |
heldPresent when the daemon still holds… | object |
scheduledWhether something other than the user… | boolean |
nextAtWhen the booked send actually fires,… | number |
retriesHow many automatic re-runs a stopped… | object |
providerWhich model provider it runs on | string |
harnessWhich agentic loop it runs on | "native" | "claude-code" | "codex" | "opencode" … (7) |
runnerThe runner this conversation runs on | string |
startInWhich folder it opened in, relative… | string |
actsAsWhich role its first turn acted… | string |
lastActsAsWhich role its last turn acted… | string |
modelWhat its last turn ran with | string |
effortHow hard that turn was told… | string |
thinkingWhether that turn showed its reasoning | boolean |
fastWhether that turn asked for higher… | boolean |
accountWhich connected account paid for it | string |
branchThe branch its private copy works… | string |
autoLandThis conversation's own answer to whether… | boolean |
limitPolicy | "wait" | "resend" | "move" |
outagePolicy | "wait" | "retry" |
stopPolicy | "wait" | "retry" |
memoryPolicy | "wait" | "resend" |
memoryKillPolicyThis conversation's own answer to a… | "wait" | "resume" |
proceedWithoutAskingThis conversation's own answer to whether… | boolean |
autoApproveWhether every permission this conversation asks… | "own" | "inherited" |
landRequestedA collaborator has asked a maintainer… | object |
emailWho asked | string |
nameTheir display name | string |
atWhen they asked, in milliseconds | number |
reactionsWhat people have marked this conversation… | object[] |
emojiThe mark itself, one emoji, carried… | string |
byEveryone wearing this mark, oldest first,… | object[] |
emailWho it was, as the sandbox… | string |
nameWhat to call them, when their… | string |
atWhen they marked it, in milliseconds | number |
originWhere the conversation came from when… | object |
automationId | string |
provider | string |
channelId | string |
threadId | string |
author | string |
startedByWho asked for the first turn,… | string |
areasWhich named areas of the workspace… | string[] |
ownerThe member answerable for this conversation:… | object |
emailWho answers for this conversation, as… | string |
nameWhat to call them, when the… | string |
sinceWhen they became its owner, in… | number |
participantsThe people who took part in… | object[] |
emailWho took part, lowercased, as the… | string |
nameWhat to call them, when their… | string |
sinceWhen they first took part, in… | number |
viaHow they first took part: they… | "prompt" | "answer" | "land" | "mention" |
notifyYour own answer to how much… | object[] |
emailWhose answer it is, lowercased | string |
levelWhat they asked to hear of… | "all" | "asks" | "none" |
atWhen they chose it, in milliseconds | number |
forkedFromThe conversation this one was cut… | object |
conversationId | string |
index | integer |
files | "then" | "now" |
freshSet on a conversation started on… | object |
ofThe conversation whose work it started… | string |
kindWhat it was opened for: a… | "review" | "test" | "ask" |
atWhen it started, in milliseconds | number |
byThe agent that opened it, when… | string |
branchesThe branches this conversation was started… | object[] |
repoWhich repository | string |
branchThe branch, by its short name:… | string |
sealSet on a private conversation: how… | object |
sealedThe caller cannot read this conversation:… | true |
viaHow the caller reads it | "reader" | "grant" | "open" |
untilUntil when the caller may read… | number |
readers | object[] |
email | string |
name | string |
grants | object[] |
email | string |
name | string |
untilUntil when they may read it,… | number |
byWho let them, by address | string |
asks | object[] |
email | string |
name | string |
at | number |
opens | object[] |
email | string |
name | string |
idThe opening's own id | string |
atWhen it was asked for, in… | number |
untilUntil when it may be read,… | number |
reasonWhy, in the opener's words, as… | string |
approvedBy | object |
email | string |
name | string |
at | number |
refusedBy | object |
email | string |
name | string |
at | number |
pending | true |
askedOn a sealed card: the caller… | true |
pendingAn opening without asking that waits… | object |
email | string |
name | string |
idThe opening's own id | string |
atWhen it was asked for, in… | number |
untilUntil when it may be read,… | number |
reasonWhy, in the opener's words, as… | string |
approvedBy | object |
email | string |
name | string |
at | number |
refusedBy | object |
email | string |
name | string |
at | number |
pending | true |
canOpenOn a sealed card: the caller… | true |
canApproveThe caller may agree to the… | true |
homeThis is its owner's home conversation… | true |
commitsA home conversation's latest lands as… | object[] |
landThe land's id, as its `landed`… | string |
atWhen it was committed, in milliseconds | number |
subjectThe commit's subject line | string |
commitsThe commit each repository the land… | object[] |
repoWhich repository: "root" for the workspace… | string |
shaThe commit, in full | string |
freshPendingA home conversation whose next message… | "asked" | "cleared" |
baseThe commit its private copy started… | string |
costUsdWhat it has cost so far,… | number |
inputTokensUncached input tokens, excluding cache reads… | number |
outputTokensTokens received | number |
contextTokensHow much of the window the… | number |
contextWindowHow large that window is | number |
promptCacheWhen this conversation's prompt cache was… | object |
atWhen its last request touched the… | number |
ttlMsHow long that entry lives from… | number |
rollsAtWhen the date written into the… | number |
keepableUntilPresent when this sandbox can keep… | number |
keepWarmWhether the sandbox is keeping this… | object |
sinceWhen keeping it warm started, in… | number |
untilWhen it stops by itself, in… | number |
refreshesRefreshes sent so far | integer |
readTokensHow much the last refresh read… | number |
endedWhy keeping it warm stopped before… | object |
atWhen it stopped, in milliseconds | number |
reasonWhy: `elapsed` the time asked for… | "elapsed" | "allowance" | "changed" | "cold" … (5) |
detailThe specifics, when there are any:… | string |
activityWhat it is doing at this… | object |
toolThe last tool it reached for | string |
targetWhat it reached for that tool… | string |
todoThe item on its own list… | string |
checklistHow far it is through its… | object |
doneItems it has completed | number |
totalItems on the list | number |
doingItems it has marked in progress… | number |
landedMessageDraftThe whole story of this merge's… | object |
startedAtWhen the drafting began, in milliseconds | number |
stepsEach model that was asked, in… | object[] |
providerWhich provider was asked | string |
modelWhich of its models | string |
statusHow this one went | "asking" | "answered" | "refused" | "skipped" |
atWhen it started being asked, in… | number |
msHow long it took | number |
reasonWhy it refused, in its own… | string |
outcomeHow it ended | "written" | "failed" |
reasonThe one-line account of a failure,… | string |
finishedAtWhen it ended, in milliseconds | number |
landedMessageWhat this conversation's merged work is… | object |
subjectOne line saying what the merged… | string |
noteThe same change said to somebody… | string |
breakingWhat this change takes away, for… | string |
testNoteWhy a test this change weakened… | string |
allowsExceptions the conversation declared for this… | string[] |
startedAtWhen the running turn started, in… | number |
runThe run under way right now:… | string |
queueMessages waiting for its next turn,… | object |
itemsWhat waits, in the order it… | object[] |
idThe message's id: what its sender… | string |
textThe words, as they will go… | string |
attachmentsFiles that go with it, as… | string[] |
voiceWho it is from: a person,… | "person" | "sandbox" | "agent" |
queuedAtWhen it joined the queue, in… | number |
revisionThe queue's revision when this message… | integer |
untilWhen this message goes out by… | number |
afterThe conversation whose finished work must… | string |
afterTurnSays `after` waits for that conversation's… | true |
reopenOfThe allowance this message's `until` waits… | object |
agentThe provider whose allowance it waits… | string |
accountWhich of its accounts | string |
trialRetrySays `until` is the sandbox sending… | object |
madeWhich automatic try this booking is,… | integer |
maxHow many automatic tries the sandbox… | integer |
servesWho serves the turn this message… | object |
agentThe provider | string |
harnessThe agentic loop | "native" | "claude-code" | "codex" | "opencode" … (7) |
modelThe model | string |
effortHow hard it thinks, where the… | string |
accountThe account that pays for it | string |
continuesA continuation, not words: when it… | true |
revisionMoves with every change to the… | integer |
pausedWhy the messages with no booking… | "stopped" | "refused" | "scheduled" |
untilThe soonest booked message's time, in… | number |
afterThe conversation the first booked message… | string |
updatedAtWhen it last did something, in… | number |
answeredAtWhen its model provider last answered… | number |
seenAtWhen somebody last opened it, in… | number |
unsentAtSince when somebody's composer has held… | number |
attentionWhich kinds of waiting-for-you it is… | object |
planIt has proposed a plan and… | boolean |
questionIt has asked you something | boolean |
permissionIt wants to use a tool… | boolean |
capabilityIt needs something connected that is… | boolean |
credentialIt is waiting for a named… | boolean |
conflictIts work cannot be merged without… | boolean |
needIt asked a person for something… | boolean |
permissionAskThe oldest permission its running turn… | object |
requestIdWhich request this is: the id… | string |
askWhat it asks to do, on… | string |
programThe program it is holding, as… | object |
textWhat would run | string |
languageWhich of the two backends it… | "bash" | "javascript" |
truncatedWhether this is an excerpt of… | boolean |
spansWhich fragments of the text the… | object[] |
start | integer |
end | integer |
landFailureThe last attempt to bring its… | object |
reasonWhy it failed, in the words… | string |
codeWhich kind of failure it was,… | string |
atWhen it failed, in milliseconds | number |
deliveryWhat became of its last land… | object |
state | "delivered" | "partial" | "waiting" | "failed" … (5) |
atWhen this state was reached, in… | number |
project | string |
folderThe folder on the owner's computer,… | string |
appliedFiles written, merged ones included | integer |
conflicts | object[] |
path | string |
reason | "edited" | "link" | "outside" | "missing-git" |
pointThe machine's restore point taken before… | string |
reasonWhy it failed or waits, in… | string |
conflictCausesWhy its work will not merge,… | "workspace" | "diverged" | "binary"[] |
unfinishedWhat its last turn left open:… | object |
atWhen the turn that left this… | number |
stepsThe agent's own checklist where that… | object |
openItems on it that were never… | number |
totalItems on the whole list | number |
nextThe one it would have done… | string |
checkThe end-of-turn check that was still… | string |
proofWhat its last turn showed of… | object |
atWhen the turn that left this… | number |
verificationVerified: a check it ran passed… | "verified" | "unproven" | "failing" | "no-code" |
checkThe command that spoke, when one… | string |
unviewedHow many rendered files it changed… | number |
reviewThe latest code review this conversation… | object |
atWhen the turn that reported it… | number |
sourceWhich harness's reviewer reported it | "claude" | "codex" |
findingsHow many findings it reported | integer |
openHow many of those no re-report… | integer |
reachWhere its last turn's work went… | object |
atWhen the turn that left this… | number |
liveFiles it changed in place where… | object[] |
pathWhat it wrote, as it named… | string |
extensionThe extension, by its manifest id,… | string |
liveMoreHow many more such files there… | number |
strandedRepositories it cloned inside its own… | object[] |
dirThe clone, as a folder relative… | string |
uncommittedFiles changed in it and never… | number |
unpushedCommits in it its upstream does… | number |
commitsCommits it holds at all, 0… | number |
parentThe workspace repository it sits inside,… | string |
strandedMoreHow many more such clones there… | number |
publishedPushes it made with git that… | object[] |
dirThe folder it pushed from, as… | string |
remoteThe remote it pushed to, as… | string |
branchThe branch it pushed to, as… | string |
commandThe push itself, trimmed to one… | string |
publishedMoreHow many more such pushes there… | number |
turnsTurns it has finished | number |
toolUsesTools it has used, over its… | number |
subagentsSubagents this one started, in-process and… | object |
runningSubagents working right now | number |
totalSubagents it has started over its… | number |
diffEverything it has written, measured from… | object |
filesFiles touched | number |
insertionsLines added | number |
deletionsLines removed | number |
modulesThe packages its changes fall in,… | string[] |
landedPresencePresent only when some of what… | object |
landedPaths this conversation merged in | number |
presentHow many of them are still… | number |
removedByWho took them out, when the… | object |
when kind is "agent" | shape |
idThe conversation that took them out | string |
titleWhat that conversation is called | string |
when kind is "person" | shape |
emailWho it was, as the sandbox… | string |
nameWhat to call them, when their… | string |
loopThe loop driving this conversation, if… | object |
stateHow the loop is going | "running" | "done" | "exhausted" | "stalled" … (8) |
iterationWhich round it is on | integer |
maxIterationsHow many rounds it will attempt… | integer |
goalWhat it is looping towards | string |
workflowThe workflow run this conversation is… | object |
runIdThe run this belongs to, which… | string |
nameThe workflow's name | string |
stepWhich step this conversation is on… | string |
indexThis step's place in the workflow,… | integer |
totalHow many steps the workflow has | integer |
awaitingWakeWhether this conversation runs again by… | boolean |
watchesOutside conditions this conversation is parked… | object[] |
idThe daemon's handle for this watch,… | string |
noteThe agent's own line on what… | string |
intervalSecondsHow often the check runs | integer |
deadlineAtWhen it gives up and wakes… | number |
needsWhat it is waiting on people… | object[] |
id | string |
kindWhat is being asked for: a… | "capability" | "secret" | "grant" | "release" … (8) |
title | string |
statusWhere it stands: open (waiting on… | "open" | "working" | "met" | "declined" … (5) |
jobsCommands this conversation left running in… | object[] |
idThe daemon's handle for this job,… | string |
labelWhat the job is, in the… | string |
sessionThe terminal session its pane runs… | string |
startedAtWhen it started, in milliseconds | number |
endedAtWhen the command exited, in milliseconds | number |
exitCodeThe code it exited with | integer |
watchThe watch its exit wakes this… | string |
handedLeft running for the person: the… | boolean |
portsThe ports it was listening on… | integer[] |
stoppedByWho stopped it: the sandbox, when… | "turn" | "person" | "agent" |
inputWaitPresent while it sits blocked reading… | object |
sinceWhen it went still, in milliseconds | number |
programThe process blocked reading the terminal,… | string |
scriptRunsWorkflow runs this conversation started that… | object[] |
idThe run's id, the one its… | string |
nameThe workflow's name, from its script's… | string |
callsHow many subagents it has started… | integer |
workingHow many of its subagents are… | integer |
failedHow many of its calls failed… | integer |
phaseThe phase its script last marked | string |
startedAtWhen it started, in milliseconds | number |
archivedAtWhen it was put away, in… | number |
curl -X POST "$SANDBOX/seal/a1b2c3d4/answer" \
-H "x-intentic-control: $INTENTIC_TOKEN" \
-H "content-type: application/json" \
-d '{"email":"ada@example.com","answer":"day"}'import { sandbox } from "@intentic/sandbox-client";
const result = await sandbox.seal.answer({
"id": "a1b2c3d4",
"email": "ada@example.com",
"answer": "day"
});POST/seal/{id}/openOpen a private conversation without asking
For the sandbox owner alone, with a written reason: lets them read a private conversation for a day without its author's yes. It is read-only, its author is told at once, and the reason stays on the conversation for good. Where an organisation asks for two people, it waits for a second person with Full access to agree.
What you send
| Field | Type | Where |
|---|---|---|
idrequiredThe conversation | string | address |
reasonrequired | string | body |
What comes back
| Field | Type |
|---|---|
idThe conversation id, which is how… | string |
sessionIdThe provider session behind the last… | string |
titleWhat to call it: the first… | string |
titleActionOne word for the kind of… | string |
statusWhat it is doing | "idle" | "running" | "awaiting" | "stopping" … (13) |
failureWhy the last turn failed, in… | string |
failureCodeWhich kind of failure it was,… | string |
failureOwnWhether `failure` is the sandbox's own… | boolean |
failureRepeatsHow many turns in a row… | integer |
limitResetsAtWhen the spent allowance reopens, in… | number |
limitHeldWhether the refused turn is held… | boolean |
limitScheduledSent only by sandboxes older than… | boolean |
limitMovingSent only by sandboxes older than… | string |
limitNextAtSent only by sandboxes older than… | number |
nextWhat carries it on next with… | object |
when kind is "rerun" | shape |
atWhen the held turn goes again,… | number |
ontoThe account the owner's answer to… | string |
when kind is "room" | shape |
when kind is "send" | shape |
atWhen the soonest booked message goes,… | number |
countHow many messages are booked to… | integer |
when kind is "land" | shape |
afterThe conversation whose landed work the… | string |
turnSet when that message waits for… | true |
countHow many messages are booked to… | integer |
pressThe daemon's one reading of what… | object |
when kind is "none" | shape |
when kind is "continue" | shape |
endingHow the last turn ended, which… | object |
reasonWhich ending left the work here:… | "limit" | "outage" | "stopped" | "flagged" |
resetsAtWhen the spent allowance reopens, in… | number |
heldPresent when the daemon still holds… | object |
scheduledWhether something other than the user… | boolean |
nextAtWhen the booked send actually fires,… | number |
retriesHow many automatic re-runs a stopped… | object |
providerWhich model provider it runs on | string |
harnessWhich agentic loop it runs on | "native" | "claude-code" | "codex" | "opencode" … (7) |
runnerThe runner this conversation runs on | string |
startInWhich folder it opened in, relative… | string |
actsAsWhich role its first turn acted… | string |
lastActsAsWhich role its last turn acted… | string |
modelWhat its last turn ran with | string |
effortHow hard that turn was told… | string |
thinkingWhether that turn showed its reasoning | boolean |
fastWhether that turn asked for higher… | boolean |
accountWhich connected account paid for it | string |
branchThe branch its private copy works… | string |
autoLandThis conversation's own answer to whether… | boolean |
limitPolicy | "wait" | "resend" | "move" |
outagePolicy | "wait" | "retry" |
stopPolicy | "wait" | "retry" |
memoryPolicy | "wait" | "resend" |
memoryKillPolicyThis conversation's own answer to a… | "wait" | "resume" |
proceedWithoutAskingThis conversation's own answer to whether… | boolean |
autoApproveWhether every permission this conversation asks… | "own" | "inherited" |
landRequestedA collaborator has asked a maintainer… | object |
emailWho asked | string |
nameTheir display name | string |
atWhen they asked, in milliseconds | number |
reactionsWhat people have marked this conversation… | object[] |
emojiThe mark itself, one emoji, carried… | string |
byEveryone wearing this mark, oldest first,… | object[] |
emailWho it was, as the sandbox… | string |
nameWhat to call them, when their… | string |
atWhen they marked it, in milliseconds | number |
originWhere the conversation came from when… | object |
automationId | string |
provider | string |
channelId | string |
threadId | string |
author | string |
startedByWho asked for the first turn,… | string |
areasWhich named areas of the workspace… | string[] |
ownerThe member answerable for this conversation:… | object |
emailWho answers for this conversation, as… | string |
nameWhat to call them, when the… | string |
sinceWhen they became its owner, in… | number |
participantsThe people who took part in… | object[] |
emailWho took part, lowercased, as the… | string |
nameWhat to call them, when their… | string |
sinceWhen they first took part, in… | number |
viaHow they first took part: they… | "prompt" | "answer" | "land" | "mention" |
notifyYour own answer to how much… | object[] |
emailWhose answer it is, lowercased | string |
levelWhat they asked to hear of… | "all" | "asks" | "none" |
atWhen they chose it, in milliseconds | number |
forkedFromThe conversation this one was cut… | object |
conversationId | string |
index | integer |
files | "then" | "now" |
freshSet on a conversation started on… | object |
ofThe conversation whose work it started… | string |
kindWhat it was opened for: a… | "review" | "test" | "ask" |
atWhen it started, in milliseconds | number |
byThe agent that opened it, when… | string |
branchesThe branches this conversation was started… | object[] |
repoWhich repository | string |
branchThe branch, by its short name:… | string |
sealSet on a private conversation: how… | object |
sealedThe caller cannot read this conversation:… | true |
viaHow the caller reads it | "reader" | "grant" | "open" |
untilUntil when the caller may read… | number |
readers | object[] |
email | string |
name | string |
grants | object[] |
email | string |
name | string |
untilUntil when they may read it,… | number |
byWho let them, by address | string |
asks | object[] |
email | string |
name | string |
at | number |
opens | object[] |
email | string |
name | string |
idThe opening's own id | string |
atWhen it was asked for, in… | number |
untilUntil when it may be read,… | number |
reasonWhy, in the opener's words, as… | string |
approvedBy | object |
email | string |
name | string |
at | number |
refusedBy | object |
email | string |
name | string |
at | number |
pending | true |
askedOn a sealed card: the caller… | true |
pendingAn opening without asking that waits… | object |
email | string |
name | string |
idThe opening's own id | string |
atWhen it was asked for, in… | number |
untilUntil when it may be read,… | number |
reasonWhy, in the opener's words, as… | string |
approvedBy | object |
email | string |
name | string |
at | number |
refusedBy | object |
email | string |
name | string |
at | number |
pending | true |
canOpenOn a sealed card: the caller… | true |
canApproveThe caller may agree to the… | true |
homeThis is its owner's home conversation… | true |
commitsA home conversation's latest lands as… | object[] |
landThe land's id, as its `landed`… | string |
atWhen it was committed, in milliseconds | number |
subjectThe commit's subject line | string |
commitsThe commit each repository the land… | object[] |
repoWhich repository: "root" for the workspace… | string |
shaThe commit, in full | string |
freshPendingA home conversation whose next message… | "asked" | "cleared" |
baseThe commit its private copy started… | string |
costUsdWhat it has cost so far,… | number |
inputTokensUncached input tokens, excluding cache reads… | number |
outputTokensTokens received | number |
contextTokensHow much of the window the… | number |
contextWindowHow large that window is | number |
promptCacheWhen this conversation's prompt cache was… | object |
atWhen its last request touched the… | number |
ttlMsHow long that entry lives from… | number |
rollsAtWhen the date written into the… | number |
keepableUntilPresent when this sandbox can keep… | number |
keepWarmWhether the sandbox is keeping this… | object |
sinceWhen keeping it warm started, in… | number |
untilWhen it stops by itself, in… | number |
refreshesRefreshes sent so far | integer |
readTokensHow much the last refresh read… | number |
endedWhy keeping it warm stopped before… | object |
atWhen it stopped, in milliseconds | number |
reasonWhy: `elapsed` the time asked for… | "elapsed" | "allowance" | "changed" | "cold" … (5) |
detailThe specifics, when there are any:… | string |
activityWhat it is doing at this… | object |
toolThe last tool it reached for | string |
targetWhat it reached for that tool… | string |
todoThe item on its own list… | string |
checklistHow far it is through its… | object |
doneItems it has completed | number |
totalItems on the list | number |
doingItems it has marked in progress… | number |
landedMessageDraftThe whole story of this merge's… | object |
startedAtWhen the drafting began, in milliseconds | number |
stepsEach model that was asked, in… | object[] |
providerWhich provider was asked | string |
modelWhich of its models | string |
statusHow this one went | "asking" | "answered" | "refused" | "skipped" |
atWhen it started being asked, in… | number |
msHow long it took | number |
reasonWhy it refused, in its own… | string |
outcomeHow it ended | "written" | "failed" |
reasonThe one-line account of a failure,… | string |
finishedAtWhen it ended, in milliseconds | number |
landedMessageWhat this conversation's merged work is… | object |
subjectOne line saying what the merged… | string |
noteThe same change said to somebody… | string |
breakingWhat this change takes away, for… | string |
testNoteWhy a test this change weakened… | string |
allowsExceptions the conversation declared for this… | string[] |
startedAtWhen the running turn started, in… | number |
runThe run under way right now:… | string |
queueMessages waiting for its next turn,… | object |
itemsWhat waits, in the order it… | object[] |
idThe message's id: what its sender… | string |
textThe words, as they will go… | string |
attachmentsFiles that go with it, as… | string[] |
voiceWho it is from: a person,… | "person" | "sandbox" | "agent" |
queuedAtWhen it joined the queue, in… | number |
revisionThe queue's revision when this message… | integer |
untilWhen this message goes out by… | number |
afterThe conversation whose finished work must… | string |
afterTurnSays `after` waits for that conversation's… | true |
reopenOfThe allowance this message's `until` waits… | object |
agentThe provider whose allowance it waits… | string |
accountWhich of its accounts | string |
trialRetrySays `until` is the sandbox sending… | object |
madeWhich automatic try this booking is,… | integer |
maxHow many automatic tries the sandbox… | integer |
servesWho serves the turn this message… | object |
agentThe provider | string |
harnessThe agentic loop | "native" | "claude-code" | "codex" | "opencode" … (7) |
modelThe model | string |
effortHow hard it thinks, where the… | string |
accountThe account that pays for it | string |
continuesA continuation, not words: when it… | true |
revisionMoves with every change to the… | integer |
pausedWhy the messages with no booking… | "stopped" | "refused" | "scheduled" |
untilThe soonest booked message's time, in… | number |
afterThe conversation the first booked message… | string |
updatedAtWhen it last did something, in… | number |
answeredAtWhen its model provider last answered… | number |
seenAtWhen somebody last opened it, in… | number |
unsentAtSince when somebody's composer has held… | number |
attentionWhich kinds of waiting-for-you it is… | object |
planIt has proposed a plan and… | boolean |
questionIt has asked you something | boolean |
permissionIt wants to use a tool… | boolean |
capabilityIt needs something connected that is… | boolean |
credentialIt is waiting for a named… | boolean |
conflictIts work cannot be merged without… | boolean |
needIt asked a person for something… | boolean |
permissionAskThe oldest permission its running turn… | object |
requestIdWhich request this is: the id… | string |
askWhat it asks to do, on… | string |
programThe program it is holding, as… | object |
textWhat would run | string |
languageWhich of the two backends it… | "bash" | "javascript" |
truncatedWhether this is an excerpt of… | boolean |
spansWhich fragments of the text the… | object[] |
start | integer |
end | integer |
landFailureThe last attempt to bring its… | object |
reasonWhy it failed, in the words… | string |
codeWhich kind of failure it was,… | string |
atWhen it failed, in milliseconds | number |
deliveryWhat became of its last land… | object |
state | "delivered" | "partial" | "waiting" | "failed" … (5) |
atWhen this state was reached, in… | number |
project | string |
folderThe folder on the owner's computer,… | string |
appliedFiles written, merged ones included | integer |
conflicts | object[] |
path | string |
reason | "edited" | "link" | "outside" | "missing-git" |
pointThe machine's restore point taken before… | string |
reasonWhy it failed or waits, in… | string |
conflictCausesWhy its work will not merge,… | "workspace" | "diverged" | "binary"[] |
unfinishedWhat its last turn left open:… | object |
atWhen the turn that left this… | number |
stepsThe agent's own checklist where that… | object |
openItems on it that were never… | number |
totalItems on the whole list | number |
nextThe one it would have done… | string |
checkThe end-of-turn check that was still… | string |
proofWhat its last turn showed of… | object |
atWhen the turn that left this… | number |
verificationVerified: a check it ran passed… | "verified" | "unproven" | "failing" | "no-code" |
checkThe command that spoke, when one… | string |
unviewedHow many rendered files it changed… | number |
reviewThe latest code review this conversation… | object |
atWhen the turn that reported it… | number |
sourceWhich harness's reviewer reported it | "claude" | "codex" |
findingsHow many findings it reported | integer |
openHow many of those no re-report… | integer |
reachWhere its last turn's work went… | object |
atWhen the turn that left this… | number |
liveFiles it changed in place where… | object[] |
pathWhat it wrote, as it named… | string |
extensionThe extension, by its manifest id,… | string |
liveMoreHow many more such files there… | number |
strandedRepositories it cloned inside its own… | object[] |
dirThe clone, as a folder relative… | string |
uncommittedFiles changed in it and never… | number |
unpushedCommits in it its upstream does… | number |
commitsCommits it holds at all, 0… | number |
parentThe workspace repository it sits inside,… | string |
strandedMoreHow many more such clones there… | number |
publishedPushes it made with git that… | object[] |
dirThe folder it pushed from, as… | string |
remoteThe remote it pushed to, as… | string |
branchThe branch it pushed to, as… | string |
commandThe push itself, trimmed to one… | string |
publishedMoreHow many more such pushes there… | number |
turnsTurns it has finished | number |
toolUsesTools it has used, over its… | number |
subagentsSubagents this one started, in-process and… | object |
runningSubagents working right now | number |
totalSubagents it has started over its… | number |
diffEverything it has written, measured from… | object |
filesFiles touched | number |
insertionsLines added | number |
deletionsLines removed | number |
modulesThe packages its changes fall in,… | string[] |
landedPresencePresent only when some of what… | object |
landedPaths this conversation merged in | number |
presentHow many of them are still… | number |
removedByWho took them out, when the… | object |
when kind is "agent" | shape |
idThe conversation that took them out | string |
titleWhat that conversation is called | string |
when kind is "person" | shape |
emailWho it was, as the sandbox… | string |
nameWhat to call them, when their… | string |
loopThe loop driving this conversation, if… | object |
stateHow the loop is going | "running" | "done" | "exhausted" | "stalled" … (8) |
iterationWhich round it is on | integer |
maxIterationsHow many rounds it will attempt… | integer |
goalWhat it is looping towards | string |
workflowThe workflow run this conversation is… | object |
runIdThe run this belongs to, which… | string |
nameThe workflow's name | string |
stepWhich step this conversation is on… | string |
indexThis step's place in the workflow,… | integer |
totalHow many steps the workflow has | integer |
awaitingWakeWhether this conversation runs again by… | boolean |
watchesOutside conditions this conversation is parked… | object[] |
idThe daemon's handle for this watch,… | string |
noteThe agent's own line on what… | string |
intervalSecondsHow often the check runs | integer |
deadlineAtWhen it gives up and wakes… | number |
needsWhat it is waiting on people… | object[] |
id | string |
kindWhat is being asked for: a… | "capability" | "secret" | "grant" | "release" … (8) |
title | string |
statusWhere it stands: open (waiting on… | "open" | "working" | "met" | "declined" … (5) |
jobsCommands this conversation left running in… | object[] |
idThe daemon's handle for this job,… | string |
labelWhat the job is, in the… | string |
sessionThe terminal session its pane runs… | string |
startedAtWhen it started, in milliseconds | number |
endedAtWhen the command exited, in milliseconds | number |
exitCodeThe code it exited with | integer |
watchThe watch its exit wakes this… | string |
handedLeft running for the person: the… | boolean |
portsThe ports it was listening on… | integer[] |
stoppedByWho stopped it: the sandbox, when… | "turn" | "person" | "agent" |
inputWaitPresent while it sits blocked reading… | object |
sinceWhen it went still, in milliseconds | number |
programThe process blocked reading the terminal,… | string |
scriptRunsWorkflow runs this conversation started that… | object[] |
idThe run's id, the one its… | string |
nameThe workflow's name, from its script's… | string |
callsHow many subagents it has started… | integer |
workingHow many of its subagents are… | integer |
failedHow many of its calls failed… | integer |
phaseThe phase its script last marked | string |
startedAtWhen it started, in milliseconds | number |
archivedAtWhen it was put away, in… | number |
curl -X POST "$SANDBOX/seal/a1b2c3d4/open" \
-H "x-intentic-control: $INTENTIC_TOKEN" \
-H "content-type: application/json" \
-d '{"reason":"Nothing had changed since the last run."}'import { sandbox } from "@intentic/sandbox-client";
const result = await sandbox.seal.open({
"id": "a1b2c3d4",
"reason": "Nothing had changed since the last run."
});POST/seal/{id}/open/approveAgree to an opening without asking
The second person an organisation's two-person rule asks for: agrees to the owner opening a private conversation without asking, or refuses it. The owner cannot be their own second person.
What you send
| Field | Type | Where |
|---|---|---|
idrequiredThe conversation | string | address |
openrequiredWhich opening | string | body |
agreerequired | boolean | body |
What comes back
| Field | Type |
|---|---|
idThe conversation id, which is how… | string |
sessionIdThe provider session behind the last… | string |
titleWhat to call it: the first… | string |
titleActionOne word for the kind of… | string |
statusWhat it is doing | "idle" | "running" | "awaiting" | "stopping" … (13) |
failureWhy the last turn failed, in… | string |
failureCodeWhich kind of failure it was,… | string |
failureOwnWhether `failure` is the sandbox's own… | boolean |
failureRepeatsHow many turns in a row… | integer |
limitResetsAtWhen the spent allowance reopens, in… | number |
limitHeldWhether the refused turn is held… | boolean |
limitScheduledSent only by sandboxes older than… | boolean |
limitMovingSent only by sandboxes older than… | string |
limitNextAtSent only by sandboxes older than… | number |
nextWhat carries it on next with… | object |
when kind is "rerun" | shape |
atWhen the held turn goes again,… | number |
ontoThe account the owner's answer to… | string |
when kind is "room" | shape |
when kind is "send" | shape |
atWhen the soonest booked message goes,… | number |
countHow many messages are booked to… | integer |
when kind is "land" | shape |
afterThe conversation whose landed work the… | string |
turnSet when that message waits for… | true |
countHow many messages are booked to… | integer |
pressThe daemon's one reading of what… | object |
when kind is "none" | shape |
when kind is "continue" | shape |
endingHow the last turn ended, which… | object |
reasonWhich ending left the work here:… | "limit" | "outage" | "stopped" | "flagged" |
resetsAtWhen the spent allowance reopens, in… | number |
heldPresent when the daemon still holds… | object |
scheduledWhether something other than the user… | boolean |
nextAtWhen the booked send actually fires,… | number |
retriesHow many automatic re-runs a stopped… | object |
providerWhich model provider it runs on | string |
harnessWhich agentic loop it runs on | "native" | "claude-code" | "codex" | "opencode" … (7) |
runnerThe runner this conversation runs on | string |
startInWhich folder it opened in, relative… | string |
actsAsWhich role its first turn acted… | string |
lastActsAsWhich role its last turn acted… | string |
modelWhat its last turn ran with | string |
effortHow hard that turn was told… | string |
thinkingWhether that turn showed its reasoning | boolean |
fastWhether that turn asked for higher… | boolean |
accountWhich connected account paid for it | string |
branchThe branch its private copy works… | string |
autoLandThis conversation's own answer to whether… | boolean |
limitPolicy | "wait" | "resend" | "move" |
outagePolicy | "wait" | "retry" |
stopPolicy | "wait" | "retry" |
memoryPolicy | "wait" | "resend" |
memoryKillPolicyThis conversation's own answer to a… | "wait" | "resume" |
proceedWithoutAskingThis conversation's own answer to whether… | boolean |
autoApproveWhether every permission this conversation asks… | "own" | "inherited" |
landRequestedA collaborator has asked a maintainer… | object |
emailWho asked | string |
nameTheir display name | string |
atWhen they asked, in milliseconds | number |
reactionsWhat people have marked this conversation… | object[] |
emojiThe mark itself, one emoji, carried… | string |
byEveryone wearing this mark, oldest first,… | object[] |
emailWho it was, as the sandbox… | string |
nameWhat to call them, when their… | string |
atWhen they marked it, in milliseconds | number |
originWhere the conversation came from when… | object |
automationId | string |
provider | string |
channelId | string |
threadId | string |
author | string |
startedByWho asked for the first turn,… | string |
areasWhich named areas of the workspace… | string[] |
ownerThe member answerable for this conversation:… | object |
emailWho answers for this conversation, as… | string |
nameWhat to call them, when the… | string |
sinceWhen they became its owner, in… | number |
participantsThe people who took part in… | object[] |
emailWho took part, lowercased, as the… | string |
nameWhat to call them, when their… | string |
sinceWhen they first took part, in… | number |
viaHow they first took part: they… | "prompt" | "answer" | "land" | "mention" |
notifyYour own answer to how much… | object[] |
emailWhose answer it is, lowercased | string |
levelWhat they asked to hear of… | "all" | "asks" | "none" |
atWhen they chose it, in milliseconds | number |
forkedFromThe conversation this one was cut… | object |
conversationId | string |
index | integer |
files | "then" | "now" |
freshSet on a conversation started on… | object |
ofThe conversation whose work it started… | string |
kindWhat it was opened for: a… | "review" | "test" | "ask" |
atWhen it started, in milliseconds | number |
byThe agent that opened it, when… | string |
branchesThe branches this conversation was started… | object[] |
repoWhich repository | string |
branchThe branch, by its short name:… | string |
sealSet on a private conversation: how… | object |
sealedThe caller cannot read this conversation:… | true |
viaHow the caller reads it | "reader" | "grant" | "open" |
untilUntil when the caller may read… | number |
readers | object[] |
email | string |
name | string |
grants | object[] |
email | string |
name | string |
untilUntil when they may read it,… | number |
byWho let them, by address | string |
asks | object[] |
email | string |
name | string |
at | number |
opens | object[] |
email | string |
name | string |
idThe opening's own id | string |
atWhen it was asked for, in… | number |
untilUntil when it may be read,… | number |
reasonWhy, in the opener's words, as… | string |
approvedBy | object |
email | string |
name | string |
at | number |
refusedBy | object |
email | string |
name | string |
at | number |
pending | true |
askedOn a sealed card: the caller… | true |
pendingAn opening without asking that waits… | object |
email | string |
name | string |
idThe opening's own id | string |
atWhen it was asked for, in… | number |
untilUntil when it may be read,… | number |
reasonWhy, in the opener's words, as… | string |
approvedBy | object |
email | string |
name | string |
at | number |
refusedBy | object |
email | string |
name | string |
at | number |
pending | true |
canOpenOn a sealed card: the caller… | true |
canApproveThe caller may agree to the… | true |
homeThis is its owner's home conversation… | true |
commitsA home conversation's latest lands as… | object[] |
landThe land's id, as its `landed`… | string |
atWhen it was committed, in milliseconds | number |
subjectThe commit's subject line | string |
commitsThe commit each repository the land… | object[] |
repoWhich repository: "root" for the workspace… | string |
shaThe commit, in full | string |
freshPendingA home conversation whose next message… | "asked" | "cleared" |
baseThe commit its private copy started… | string |
costUsdWhat it has cost so far,… | number |
inputTokensUncached input tokens, excluding cache reads… | number |
outputTokensTokens received | number |
contextTokensHow much of the window the… | number |
contextWindowHow large that window is | number |
promptCacheWhen this conversation's prompt cache was… | object |
atWhen its last request touched the… | number |
ttlMsHow long that entry lives from… | number |
rollsAtWhen the date written into the… | number |
keepableUntilPresent when this sandbox can keep… | number |
keepWarmWhether the sandbox is keeping this… | object |
sinceWhen keeping it warm started, in… | number |
untilWhen it stops by itself, in… | number |
refreshesRefreshes sent so far | integer |
readTokensHow much the last refresh read… | number |
endedWhy keeping it warm stopped before… | object |
atWhen it stopped, in milliseconds | number |
reasonWhy: `elapsed` the time asked for… | "elapsed" | "allowance" | "changed" | "cold" … (5) |
detailThe specifics, when there are any:… | string |
activityWhat it is doing at this… | object |
toolThe last tool it reached for | string |
targetWhat it reached for that tool… | string |
todoThe item on its own list… | string |
checklistHow far it is through its… | object |
doneItems it has completed | number |
totalItems on the list | number |
doingItems it has marked in progress… | number |
landedMessageDraftThe whole story of this merge's… | object |
startedAtWhen the drafting began, in milliseconds | number |
stepsEach model that was asked, in… | object[] |
providerWhich provider was asked | string |
modelWhich of its models | string |
statusHow this one went | "asking" | "answered" | "refused" | "skipped" |
atWhen it started being asked, in… | number |
msHow long it took | number |
reasonWhy it refused, in its own… | string |
outcomeHow it ended | "written" | "failed" |
reasonThe one-line account of a failure,… | string |
finishedAtWhen it ended, in milliseconds | number |
landedMessageWhat this conversation's merged work is… | object |
subjectOne line saying what the merged… | string |
noteThe same change said to somebody… | string |
breakingWhat this change takes away, for… | string |
testNoteWhy a test this change weakened… | string |
allowsExceptions the conversation declared for this… | string[] |
startedAtWhen the running turn started, in… | number |
runThe run under way right now:… | string |
queueMessages waiting for its next turn,… | object |
itemsWhat waits, in the order it… | object[] |
idThe message's id: what its sender… | string |
textThe words, as they will go… | string |
attachmentsFiles that go with it, as… | string[] |
voiceWho it is from: a person,… | "person" | "sandbox" | "agent" |
queuedAtWhen it joined the queue, in… | number |
revisionThe queue's revision when this message… | integer |
untilWhen this message goes out by… | number |
afterThe conversation whose finished work must… | string |
afterTurnSays `after` waits for that conversation's… | true |
reopenOfThe allowance this message's `until` waits… | object |
agentThe provider whose allowance it waits… | string |
accountWhich of its accounts | string |
trialRetrySays `until` is the sandbox sending… | object |
madeWhich automatic try this booking is,… | integer |
maxHow many automatic tries the sandbox… | integer |
servesWho serves the turn this message… | object |
agentThe provider | string |
harnessThe agentic loop | "native" | "claude-code" | "codex" | "opencode" … (7) |
modelThe model | string |
effortHow hard it thinks, where the… | string |
accountThe account that pays for it | string |
continuesA continuation, not words: when it… | true |
revisionMoves with every change to the… | integer |
pausedWhy the messages with no booking… | "stopped" | "refused" | "scheduled" |
untilThe soonest booked message's time, in… | number |
afterThe conversation the first booked message… | string |
updatedAtWhen it last did something, in… | number |
answeredAtWhen its model provider last answered… | number |
seenAtWhen somebody last opened it, in… | number |
unsentAtSince when somebody's composer has held… | number |
attentionWhich kinds of waiting-for-you it is… | object |
planIt has proposed a plan and… | boolean |
questionIt has asked you something | boolean |
permissionIt wants to use a tool… | boolean |
capabilityIt needs something connected that is… | boolean |
credentialIt is waiting for a named… | boolean |
conflictIts work cannot be merged without… | boolean |
needIt asked a person for something… | boolean |
permissionAskThe oldest permission its running turn… | object |
requestIdWhich request this is: the id… | string |
askWhat it asks to do, on… | string |
programThe program it is holding, as… | object |
textWhat would run | string |
languageWhich of the two backends it… | "bash" | "javascript" |
truncatedWhether this is an excerpt of… | boolean |
spansWhich fragments of the text the… | object[] |
start | integer |
end | integer |
landFailureThe last attempt to bring its… | object |
reasonWhy it failed, in the words… | string |
codeWhich kind of failure it was,… | string |
atWhen it failed, in milliseconds | number |
deliveryWhat became of its last land… | object |
state | "delivered" | "partial" | "waiting" | "failed" … (5) |
atWhen this state was reached, in… | number |
project | string |
folderThe folder on the owner's computer,… | string |
appliedFiles written, merged ones included | integer |
conflicts | object[] |
path | string |
reason | "edited" | "link" | "outside" | "missing-git" |
pointThe machine's restore point taken before… | string |
reasonWhy it failed or waits, in… | string |
conflictCausesWhy its work will not merge,… | "workspace" | "diverged" | "binary"[] |
unfinishedWhat its last turn left open:… | object |
atWhen the turn that left this… | number |
stepsThe agent's own checklist where that… | object |
openItems on it that were never… | number |
totalItems on the whole list | number |
nextThe one it would have done… | string |
checkThe end-of-turn check that was still… | string |
proofWhat its last turn showed of… | object |
atWhen the turn that left this… | number |
verificationVerified: a check it ran passed… | "verified" | "unproven" | "failing" | "no-code" |
checkThe command that spoke, when one… | string |
unviewedHow many rendered files it changed… | number |
reviewThe latest code review this conversation… | object |
atWhen the turn that reported it… | number |
sourceWhich harness's reviewer reported it | "claude" | "codex" |
findingsHow many findings it reported | integer |
openHow many of those no re-report… | integer |
reachWhere its last turn's work went… | object |
atWhen the turn that left this… | number |
liveFiles it changed in place where… | object[] |
pathWhat it wrote, as it named… | string |
extensionThe extension, by its manifest id,… | string |
liveMoreHow many more such files there… | number |
strandedRepositories it cloned inside its own… | object[] |
dirThe clone, as a folder relative… | string |
uncommittedFiles changed in it and never… | number |
unpushedCommits in it its upstream does… | number |
commitsCommits it holds at all, 0… | number |
parentThe workspace repository it sits inside,… | string |
strandedMoreHow many more such clones there… | number |
publishedPushes it made with git that… | object[] |
dirThe folder it pushed from, as… | string |
remoteThe remote it pushed to, as… | string |
branchThe branch it pushed to, as… | string |
commandThe push itself, trimmed to one… | string |
publishedMoreHow many more such pushes there… | number |
turnsTurns it has finished | number |
toolUsesTools it has used, over its… | number |
subagentsSubagents this one started, in-process and… | object |
runningSubagents working right now | number |
totalSubagents it has started over its… | number |
diffEverything it has written, measured from… | object |
filesFiles touched | number |
insertionsLines added | number |
deletionsLines removed | number |
modulesThe packages its changes fall in,… | string[] |
landedPresencePresent only when some of what… | object |
landedPaths this conversation merged in | number |
presentHow many of them are still… | number |
removedByWho took them out, when the… | object |
when kind is "agent" | shape |
idThe conversation that took them out | string |
titleWhat that conversation is called | string |
when kind is "person" | shape |
emailWho it was, as the sandbox… | string |
nameWhat to call them, when their… | string |
loopThe loop driving this conversation, if… | object |
stateHow the loop is going | "running" | "done" | "exhausted" | "stalled" … (8) |
iterationWhich round it is on | integer |
maxIterationsHow many rounds it will attempt… | integer |
goalWhat it is looping towards | string |
workflowThe workflow run this conversation is… | object |
runIdThe run this belongs to, which… | string |
nameThe workflow's name | string |
stepWhich step this conversation is on… | string |
indexThis step's place in the workflow,… | integer |
totalHow many steps the workflow has | integer |
awaitingWakeWhether this conversation runs again by… | boolean |
watchesOutside conditions this conversation is parked… | object[] |
idThe daemon's handle for this watch,… | string |
noteThe agent's own line on what… | string |
intervalSecondsHow often the check runs | integer |
deadlineAtWhen it gives up and wakes… | number |
needsWhat it is waiting on people… | object[] |
id | string |
kindWhat is being asked for: a… | "capability" | "secret" | "grant" | "release" … (8) |
title | string |
statusWhere it stands: open (waiting on… | "open" | "working" | "met" | "declined" … (5) |
jobsCommands this conversation left running in… | object[] |
idThe daemon's handle for this job,… | string |
labelWhat the job is, in the… | string |
sessionThe terminal session its pane runs… | string |
startedAtWhen it started, in milliseconds | number |
endedAtWhen the command exited, in milliseconds | number |
exitCodeThe code it exited with | integer |
watchThe watch its exit wakes this… | string |
handedLeft running for the person: the… | boolean |
portsThe ports it was listening on… | integer[] |
stoppedByWho stopped it: the sandbox, when… | "turn" | "person" | "agent" |
inputWaitPresent while it sits blocked reading… | object |
sinceWhen it went still, in milliseconds | number |
programThe process blocked reading the terminal,… | string |
scriptRunsWorkflow runs this conversation started that… | object[] |
idThe run's id, the one its… | string |
nameThe workflow's name, from its script's… | string |
callsHow many subagents it has started… | integer |
workingHow many of its subagents are… | integer |
failedHow many of its calls failed… | integer |
phaseThe phase its script last marked | string |
startedAtWhen it started, in milliseconds | number |
archivedAtWhen it was put away, in… | number |
curl -X POST "$SANDBOX/seal/a1b2c3d4/open/approve" \
-H "x-intentic-control: $INTENTIC_TOKEN" \
-H "content-type: application/json" \
-d '{"open":"…","agree":true}'import { sandbox } from "@intentic/sandbox-client";
const result = await sandbox.seal.approveOpen({
"id": "a1b2c3d4",
"open": "…",
"agree": true
});