Skip to content

Commit c2480e3

Browse files
committed
docs(mcp): 说明外部客户端的输入等待选项
- 说明线程内调用和已连接环境的默认等待行为,以及外部客户端的启用参数。 - 保留超时后的结束提示,更新实测工具预算。 - 变更范围检查通过,覆盖 243 项测试和 37 个受影响包的类型检查。
1 parent e33ddfb commit c2480e3

3 files changed

Lines changed: 17 additions & 8 deletions

File tree

‎apps/server/src/mcp/toolkits/orchestrator/tools.ts‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -290,7 +290,7 @@ const ThreadSendTool = Tool.make("t3_thread_send", {
290290

291291
const ThreadWaitTool = Tool.make("t3_thread_wait", {
292292
description:
293-
"Wait for a run to end or need input (t3_pending_request; else user). Timeout+next: end turn.",
293+
"Wait. External input: returnOnInput=true. t3_pending_request or user. Timeout+next: end turn.",
294294
parameters: OrchestratorMcpThreadWaitInput,
295295
success: OrchestratorMcpThreadWaitResult,
296296
failure: OrchestratorMcpFailure,
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
22
"claudeSystemAppendBytes": 5597,
33
"codexAdditionalContextBytes": 7327,
4-
"mcpToolListJsonBytes": 48129
4+
"mcpToolListJsonBytes": 48130
55
}

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

Lines changed: 15 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -467,12 +467,21 @@ idempotent retries.
467467

468468
Waits for a selected run to become `completed`, `failed`, `cancelled`,
469469
`interrupted`, or `rolled_back`. Without `runId`, it pins the latest run at call
470-
time; an idle thread returns immediately. A pending live question or approval on
471-
the selected run, or an earlier unfinished run blocking it, also returns with
472-
`timedOut: false` and `hasPendingQuestion` or `pendingApproval`. The run's status
473-
does not change. Message-based asynchronous questions do not end the wait.
474-
Read the fresh request before responding; the result grants no approval authority.
475-
A timeout reports the latest durable status and does not cancel work.
470+
time. An idle thread returns immediately.
471+
472+
Thread-scoped and linked callers return on blocking input by default. Unlinked
473+
external MCP callers enable this behavior with `returnOnInput: true`. Setting
474+
`returnOnInput: false` keeps the wait terminal-only.
475+
476+
An input-aware wait returns `timedOut: false` and `hasPendingQuestion` or
477+
`pendingApproval` for live input on the selected run or an earlier unfinished run
478+
blocking it. The run keeps its current status. Asynchronous message-based
479+
questions leave the wait active. Read a fresh question with `t3_pending_request`.
480+
Secret cards appear in thread activity. Ask the user to answer secret cards and
481+
approvals in the thread. The result grants no approval authority.
482+
483+
A timeout reports the latest durable status and leaves the work running. A `next`
484+
hint on a timed-out wait tells the caller to end its turn.
476485

477486
### `t3_thread_interrupt`
478487

0 commit comments

Comments
 (0)