@@ -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
1718These are T3 orchestration operations, not provider-native sub-agent APIs.
1819Delegated 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:
3435http://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
4041Before ` 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
287289remain 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
292305Creates 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+
318334Launches one ordinary top-level thread through the app's launch service. Use an
319335explicit ` workspaceStrategy ` to create a new worktree (` worktree ` with ` baseRef ` ),
320336attach 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