diff --git a/docs/orchestration-v2/orchestrator-mcp-server.md b/docs/orchestration-v2/orchestrator-mcp-server.md index a28070cf1fc9..f3ef6ff6ddaf 100644 --- a/docs/orchestration-v2/orchestrator-mcp-server.md +++ b/docs/orchestration-v2/orchestrator-mcp-server.md @@ -328,13 +328,18 @@ the published task result. ### `task_cancel` Stops every task the child delegated, then the child thread with the internal -`thread.stop` command, and disposes automatic parent delivery. Like a user Stop, -`thread.stop` interrupts the running turn, holds queued turns, and ends pull request -watches. A nonterminal task with no interruptible run is rejected unless its finished -turn still waits on background work or delegated tasks. Once a cancelled task's turn ends, -a completed result settles as `interrupted` and a failed one stays `failed`. A terminal task -returns its existing status, and its child thread still stops, including later -runs and watch wakes. Published task results remain available. It accepts an +`thread.stop` command, cancels the task's own queued turn, and disposes automatic +parent delivery. Like a user Stop, `thread.stop` interrupts the running turn, holds +queued turns, and ends pull request watches. The task's own queued turn is cancelled +even if Stop already held it, so a task that is only queued can be cancelled; other +queued turns in the child stay held for Resume. A nonterminal task is rejected when +it has no interruptible run, no queued turn of its own, and its finished turn no +longer waits on background work or delegated tasks. Once a cancelled task's turn +ends, a completed result settles as `interrupted` and a failed one stays `failed`. A +terminal task returns its existing status, and its child thread still stops, +including later runs and watch wakes. In both cases, a follow-up that lost its child +run but still shows as running on the parent is cancelled there and reported as +`cancelled`. Published task results remain available. It accepts an optional cancellation reason. ### `create_threads`