Skip to content

Commit fdcf272

Browse files
docs(orchestration-v2): task_cancel describes queued-only tasks and when it rejects (#34517)
1 parent 074b452 commit fdcf272

1 file changed

Lines changed: 12 additions & 7 deletions

File tree

‎docs/orchestration-v2/orchestrator-mcp-server.md‎

Lines changed: 12 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -328,13 +328,18 @@ the published task result.
328328
### `task_cancel`
329329

330330
Stops every task the child delegated, then the child thread with the internal
331-
`thread.stop` command, and disposes automatic parent delivery. Like a user Stop,
332-
`thread.stop` interrupts the running turn, holds queued turns, and ends pull request
333-
watches. A nonterminal task with no interruptible run is rejected unless its finished
334-
turn still waits on background work or delegated tasks. Once a cancelled task's turn ends,
335-
a completed result settles as `interrupted` and a failed one stays `failed`. A terminal task
336-
returns its existing status, and its child thread still stops, including later
337-
runs and watch wakes. Published task results remain available. It accepts an
331+
`thread.stop` command, cancels the task's own queued turn, and disposes automatic
332+
parent delivery. Like a user Stop, `thread.stop` interrupts the running turn, holds
333+
queued turns, and ends pull request watches. The task's own queued turn is cancelled
334+
even if Stop already held it, so a task that is only queued can be cancelled; other
335+
queued turns in the child stay held for Resume. A nonterminal task is rejected when
336+
it has no interruptible run, no queued turn of its own, and its finished turn no
337+
longer waits on background work or delegated tasks. Once a cancelled task's turn
338+
ends, a completed result settles as `interrupted` and a failed one stays `failed`. A
339+
terminal task returns its existing status, and its child thread still stops,
340+
including later runs and watch wakes. In both cases, a follow-up that lost its child
341+
run but still shows as running on the parent is cancelled there and reported as
342+
`cancelled`. Published task results remain available. It accepts an
338343
optional cancellation reason.
339344

340345
### `create_threads`

0 commit comments

Comments
 (0)