sandbox/orchestrator.start

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

Arguments

{
    taskId: Id<"tasks">,
    repositoryId: Id<"sourceControlRepositories">,
    taskPrompt: string /* optional */,
    skillId: Id<"skills"> /* 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 */,
  }

Provision and start a cloud sandbox session for a task. Handles container provisioning, git clone, dependency install, and health check.