Skip to content

sandbox/orchestrator.startSubtaskExecution

Type: action Module: convex/sandbox/orchestrator.ts

{
taskId: Id<"tasks">,
repositoryId: Id<"sourceControlRepositories">,
taskPrompt: string /* optional */,
skillId: Id<"skills"> /* optional */,
subtaskIds: Id<"subtasks"> /* optional */[],
runtime: "cloud" /* optional */, "local",
localDeviceId: string /* optional */,
localDeviceName: string /* optional */,
editorType:
"monaco" /* optional */, "codemirror" | "none",
,
ttlMinutes: number /* optional */,
authProvider:
v.union(
"anthropic" /* optional */,
v.literal("bedrock",
"vertex",
"azure",
),
),
model: string /* optional */,
presetId: Id<"sandboxPresets"> /* optional */,
mcpServerOverrides: string /* optional */[],
queueReplayToken: string /* optional */,
queueReplayQueuedBy: Id<"users"> /* optional */,
suppressQueueFallback: boolean /* optional */,
}

Start subtask-mode execution: Provisions a sandbox and runs subtasks sequentially. Re-uses existing sandbox if already provisioned for the task.