On ACP v2, each live state_update includes a background snapshot. It lists
known detached work independently of the session's foreground state. []
means no known background work. During resume, null means the snapshot is
being synchronized. The final resume snapshot follows current announcements
for the listed entities and, if requested, follows replay_complete.
The adapter reports standard child sessions after
their parent releases them. A later Codex wait on a child makes it foreground
for as long as the parent waits. Children use their own state_update and
the immediate parent's subagent_update; a nested child's work is not listed
again at the root.
A shell process that outlives its Codex turn is listed by the existing display
terminalId, not by a process handle or a duplicate tool call. Codex's process
inventory also contains processes still serving foreground calls, so the
adapter uses the turn boundary to confirm detachment. It rechecks the list
while it has live terminals. A missing process gets an exit with an unknown
status if Codex didn't report the exit. List errors don't turn running
processes into exits.
session/cancel leaves listed work and its pending approvals running.
session/close stops the session's work, including background terminals and
descendants. A listed child can also be stopped with session/cancel on the
child if the parent has reported capabilities.cancel for it.
The agent advertises capabilities.cancel: {} on the terminal_update for a
background process that Codex can terminate. To stop it, use the session that
reported the terminal, including the child's ACP session ID for a child
terminal:
{
"jsonrpc": "2.0",
"id": 12,
"method": "terminal/cancel",
"params": {"sessionId": "session-1", "terminalId": "command-1"}
}{}means the stop was accepted. Aterminal_updatewithexitStatusconfirms exit and clearscapabilities.cancel. The terminal stays in the transcript.-32602means the terminal is unknown, has exited, or is not independently cancellable.-32002withdata.sessionIdmeans the session is unknown or inactive. A runtime failure returns a request error, not a successful stop.- This request does not interrupt the turn or another terminal. The adapter
does not advertise
tool_call/cancel; Codex does not expose an independent stop operation for arbitrary model tool calls.
ACP v1 does not have these updates or this method. The AIR async task extension remains available independently.