From 42754ee28b503ffdf9d725b986f81a63516091b4 Mon Sep 17 00:00:00 2001 From: ChenCJ-io <99855454+ChenCJ-io@users.noreply.github.com> Date: Thu, 19 Nov 2026 10:20:45 +0800 Subject: [PATCH 1/2] docs(mcp): document thread launch retries --- docs/orchestration-v2/orchestrator-mcp-server.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/orchestration-v2/orchestrator-mcp-server.md b/docs/orchestration-v2/orchestrator-mcp-server.md index fa2770bb10cf7..498a502c4a35b 100644 --- a/docs/orchestration-v2/orchestrator-mcp-server.md +++ b/docs/orchestration-v2/orchestrator-mcp-server.md @@ -352,8 +352,13 @@ its own under the environment's Scratch project. A new worktree with `startFromO `startFromOrigin: false`. The new thread may not run with broader runtime or interaction modes than the caller. As for `delegate_task`, a runtime mode the provider does not offer is refused, and an inherited or default one steps down -to the broadest mode it offers. Launch has no retry key, so inspect existing threads after a failed or lost response before -launching again. `create_threads` remains the batch option for a shared checkout. +to the broadest mode it offers. `create_threads` remains the batch option for a +shared checkout. + +Set `clientRequestId` on the initial launch to make it retryable. After an error +or a lost reply, resend the same request with the same key in the same MCP +session. This reuses any thread already created by that request. If the initial +request had no key, check for the thread before launching again. ### `t3_thread_list` From b765f4e651830779b682d94257e144f99f63c77b Mon Sep 17 00:00:00 2001 From: Julius Marminge Date: Thu, 19 Nov 2026 18:51:41 +0000 Subject: [PATCH 2/2] docs(mcp): scope launch retry keys to the provider session Co-Authored-By: Claude Opus 5.5 --- docs/orchestration-v2/orchestrator-mcp-server.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/orchestration-v2/orchestrator-mcp-server.md b/docs/orchestration-v2/orchestrator-mcp-server.md index 498a502c4a35b..6c1150fbfc023 100644 --- a/docs/orchestration-v2/orchestrator-mcp-server.md +++ b/docs/orchestration-v2/orchestrator-mcp-server.md @@ -356,9 +356,9 @@ to the broadest mode it offers. `create_threads` remains the batch option for a shared checkout. Set `clientRequestId` on the initial launch to make it retryable. After an error -or a lost reply, resend the same request with the same key in the same MCP -session. This reuses any thread already created by that request. If the initial -request had no key, check for the thread before launching again. +or a lost reply, resend the same request with the same key from the same +provider session. This reuses any thread already created by that request. If the +initial request had no key, check for the thread before launching again. ### `t3_thread_list`