Skip to content

Commit 65ea216

Browse files
committed
fix(docs): document recurring orchestration tasks
1 parent 4ee6bfd commit 65ea216

1 file changed

Lines changed: 23 additions & 6 deletions

File tree

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

Lines changed: 23 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -7,12 +7,13 @@ agent can use this endpoint to:
77

88
- create an app-owned sub-agent on any supported provider instance;
99
- wait for or poll the sub-agent's durable result;
10-
- cancel an active delegated task; and
10+
- cancel an active delegated task;
1111
- create one or more ordinary top-level T3 threads;
1212
- list and incrementally read project threads;
1313
- rename threads, regenerate titles, and link or unlink pull requests;
14-
- send or steer follow-up messages; and
15-
- wait for or interrupt ordinary thread runs.
14+
- send or steer follow-up messages;
15+
- wait for or interrupt ordinary thread runs; and
16+
- create and manage recurring scheduled tasks.
1617

1718
These are T3 orchestration operations, not provider-native sub-agent APIs.
1819
Delegated tasks always create a T3 child thread and run. The child receives
@@ -34,8 +35,8 @@ The orchestration tools share the existing authenticated HTTP MCP endpoint:
3435
http://127.0.0.1:<server-port>/mcp
3536
```
3637

37-
The provider-visible server key is `t3-code`. The endpoint registers both the
38-
preview toolkit and the orchestration toolkit.
38+
The provider-visible server key is `t3-code`. The endpoint registers the
39+
orchestration toolkit alongside preview, project, and other app toolkits.
3940

4041
Before `ProviderSessionManager` opens a new V2 provider session, it asks
4142
`McpSessionRegistry` for a credential scoped to:
@@ -183,7 +184,8 @@ provider selection model-visible without allowing a request that cannot run.
183184

184185
## Tool Surface
185186

186-
The server exposes eleven orchestration tools.
187+
See [OrchestratorToolkit](../../apps/server/src/mcp/toolkits/orchestrator/tools.ts)
188+
for the current registered orchestration tools and their contracts.
187189

188190
### `orchestrator_capabilities`
189191

@@ -287,6 +289,17 @@ even when `task_status` reports `hasPendingChildRuns: true`. Published task resu
287289
remain available. It accepts an optional cancellation reason. Use
288290
`t3_thread_interrupt` to stop a later active run.
289291

292+
### Recurring scheduled tasks
293+
294+
`schedule_task` creates persistent recurring work that can run without an active
295+
provider turn. Runs post to the calling thread by default; set
296+
`bindToCurrentThread: false` to create a fresh top-level thread per run. Provider,
297+
model, and runtime settings inherit from the calling thread.
298+
299+
`list_scheduled_tasks` lists tasks in the calling thread's project. Use a returned
300+
`scheduledTaskId` with `update_scheduled_task` to change the task or pause and
301+
resume it through `enabled`, or with `delete_scheduled_task` to remove it.
302+
290303
### `create_threads`
291304

292305
Creates between one and twenty ordinary top-level T3 threads:
@@ -315,6 +328,9 @@ without a prompt remain idle.
315328

316329
### `t3_thread_launch`
317330

331+
This tool belongs to [ProjectToolkit](../../apps/server/src/mcp/toolkits/project/tools.ts),
332+
which shares the `/mcp` endpoint.
333+
318334
Launches one ordinary top-level thread through the app's launch service. Use an
319335
explicit `workspaceStrategy` to create a new worktree (`worktree` with `baseRef`),
320336
attach an existing checkout (`existing_worktree` with `worktreePath`), or use the
@@ -496,6 +512,7 @@ Coverage includes:
496512
- spawn and result context transfers;
497513
- async status polling;
498514
- cancellation;
515+
- recurring-task creation, project-scoped listing, pausing, and deletion;
499516
- batch ordinary-thread creation;
500517
- project-scoped thread listing and timeline reads;
501518
- ordinary-thread send, wait, steering, and interruption;

0 commit comments

Comments
 (0)