@playcraft/common 0.1.52 → 0.1.53-beta

package/dist/cloud-workspace/runtime/batch-runs.d.ts

@@ -0,0 +1,713 @@
+import { z } from 'zod';
+import { batchRunSchema } from './execution-admission.js';
+export declare const batchSourceFreezeRequestSchema: z.ZodObject<{
+    batchId: z.ZodString;
+    workspaceId: z.ZodString;
+    sourceDirectoryName: z.ZodString;
+    initiatorDirectoryName: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"root">]>>;
+    initiatorOperationId: z.ZodOptional<z.ZodString>;
+    syncId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type BatchSourceFreezeRequest = z.infer<typeof batchSourceFreezeRequestSchema>;
+/**
+ * `frozen`: snapshot captured and durable.
+ * `pending`: source directory busy with another turn — freeze runs after that turn and before the next.
+ */
+export declare const batchSourceFreezeResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    status: z.ZodLiteral<"frozen">;
+    snapshot: z.ZodObject<{
+        batchId: z.ZodString;
+        commitHash: z.ZodString;
+        digest: z.ZodString;
+        sourceWorkspaceId: z.ZodString;
+        sourceDirectoryName: z.ZodString;
+        remoteRef: z.ZodOptional<z.ZodString>;
+        artifactKey: z.ZodOptional<z.ZodString>;
+        frozenAt: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    status: z.ZodLiteral<"pending">;
+    batchId: z.ZodString;
+    failure: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        stage: z.ZodEnum<{
+            verify: "verify";
+            capture: "capture";
+            publish: "publish";
+        }>;
+        retryable: z.ZodBoolean;
+        outcome: z.ZodEnum<{
+            unknown: "unknown";
+            not_published: "not_published";
+        }>;
+        diagnosticId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    status: z.ZodLiteral<"failed">;
+    batchId: z.ZodString;
+    error: z.ZodString;
+    failure: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        stage: z.ZodEnum<{
+            verify: "verify";
+            capture: "capture";
+            publish: "publish";
+        }>;
+        retryable: z.ZodBoolean;
+        outcome: z.ZodEnum<{
+            unknown: "unknown";
+            not_published: "not_published";
+        }>;
+        diagnosticId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>], "status">;
+export type BatchSourceFreezeResult = z.infer<typeof batchSourceFreezeResultSchema>;
+/** Sandbox `POST /runtime/batch-sources/freeze`. Synchronous; idempotent per batchId. */
+export declare const sandboxBatchSourceFreezeRequestSchema: z.ZodObject<{
+    batchId: z.ZodString;
+    workspaceId: z.ZodString;
+    sourceDirectoryName: z.ZodString;
+    persist: z.ZodEnum<{
+        remote_ref: "remote_ref";
+        artifact: "artifact";
+    }>;
+    resumeOnly: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type SandboxBatchSourceFreezeRequest = z.infer<typeof sandboxBatchSourceFreezeRequestSchema>;
+/** `POST /runtime/batch-members/prepare` — clone/restore from snapshot (or resume commit), install deps. */
+export declare const sandboxBatchMemberPrepareSchema: z.ZodObject<{
+    snapshot: z.ZodObject<{
+        batchId: z.ZodString;
+        commitHash: z.ZodString;
+        digest: z.ZodString;
+        sourceWorkspaceId: z.ZodString;
+        sourceDirectoryName: z.ZodString;
+        remoteRef: z.ZodOptional<z.ZodString>;
+        artifactKey: z.ZodOptional<z.ZodString>;
+        frozenAt: z.ZodString;
+    }, z.core.$strict>;
+    remixId: z.ZodNullable<z.ZodString>;
+    branchName: z.ZodString;
+    resumeFromCommit: z.ZodOptional<z.ZodString>;
+    runId: z.ZodString;
+    ownerFence: z.ZodNumber;
+    workspaceId: z.ZodString;
+    directoryName: z.ZodString;
+    occupancyId: z.ZodString;
+}, z.core.$strict>;
+export type SandboxBatchMemberPrepare = z.infer<typeof sandboxBatchMemberPrepareSchema>;
+/** `POST /runtime/batch-members/generate` — one unattended turn on the shared session base. */
+export declare const sandboxBatchMemberGenerateSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    model: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    runId: z.ZodString;
+    ownerFence: z.ZodNumber;
+    workspaceId: z.ZodString;
+    directoryName: z.ZodString;
+    occupancyId: z.ZodString;
+}, z.core.$strict>;
+export type SandboxBatchMemberGenerate = z.infer<typeof sandboxBatchMemberGenerateSchema>;
+/** `POST /runtime/batch-members/deliver` — save exact commit, push, build from it, verify, publish. */
+export declare const sandboxBatchMemberDeliverSchema: z.ZodObject<{
+    pushRemote: z.ZodBoolean;
+    fromCommit: z.ZodOptional<z.ZodString>;
+    runId: z.ZodString;
+    ownerFence: z.ZodNumber;
+    workspaceId: z.ZodString;
+    directoryName: z.ZodString;
+    occupancyId: z.ZodString;
+}, z.core.$strict>;
+export type SandboxBatchMemberDeliver = z.infer<typeof sandboxBatchMemberDeliverSchema>;
+/** `POST /runtime/batch-members/:runId/stop`. */
+export declare const sandboxBatchMemberStopSchema: z.ZodObject<{
+    runId: z.ZodString;
+    ownerFence: z.ZodNumber;
+}, z.core.$strict>;
+export declare const sandboxBatchMemberStateSchema: z.ZodEnum<{
+    unknown: "unknown";
+    failed: "failed";
+    completed: "completed";
+    running: "running";
+    idle: "idle";
+    stopped: "stopped";
+    stopping: "stopping";
+    needs_user: "needs_user";
+}>;
+export type SandboxBatchMemberState = z.infer<typeof sandboxBatchMemberStateSchema>;
+/** Response of every member command and of `GET /runtime/batch-members/:runId`. Read-only query. */
+export declare const sandboxBatchMemberStatusSchema: z.ZodObject<{
+    runId: z.ZodString;
+    ownerFence: z.ZodNumber;
+    phase: z.ZodEnum<{
+        prepare: "prepare";
+        generate: "generate";
+        deliver: "deliver";
+    }>;
+    state: z.ZodEnum<{
+        unknown: "unknown";
+        failed: "failed";
+        completed: "completed";
+        running: "running";
+        idle: "idle";
+        stopped: "stopped";
+        stopping: "stopping";
+        needs_user: "needs_user";
+    }>;
+    writersStopped: z.ZodBoolean;
+    sessionId: z.ZodOptional<z.ZodString>;
+    operationId: z.ZodOptional<z.ZodString>;
+    headCommit: z.ZodOptional<z.ZodString>;
+    evidence: z.ZodOptional<z.ZodObject<{
+        savedCommit: z.ZodOptional<z.ZodString>;
+        pushedCommit: z.ZodOptional<z.ZodString>;
+        buildDigest: z.ZodOptional<z.ZodString>;
+        verified: z.ZodOptional<z.ZodBoolean>;
+        previewRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    error: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodString;
+}, z.core.$strict>;
+export type SandboxBatchMemberStatus = z.infer<typeof sandboxBatchMemberStatusSchema>;
+export declare const batchRunMemberInputSchema: z.ZodObject<{
+    resultVersionId: z.ZodString;
+    workspaceId: z.ZodString;
+    directoryName: z.ZodString;
+    remixId: z.ZodNullable<z.ZodString>;
+    branchName: z.ZodString;
+    prompt: z.ZodString;
+    model: z.ZodOptional<z.ZodString>;
+    resumeFromCommit: z.ZodOptional<z.ZodString>;
+    syncOfResultVersionId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type BatchRunMemberInput = z.infer<typeof batchRunMemberInputSchema>;
+/** `POST /internal/batch-runs` — idempotent per resultVersionId. */
+export declare const submitBatchRunsRequestSchema: z.ZodObject<{
+    batchId: z.ZodString;
+    userId: z.ZodString;
+    snapshot: z.ZodObject<{
+        batchId: z.ZodString;
+        commitHash: z.ZodString;
+        digest: z.ZodString;
+        sourceWorkspaceId: z.ZodString;
+        sourceDirectoryName: z.ZodString;
+        remoteRef: z.ZodOptional<z.ZodString>;
+        artifactKey: z.ZodOptional<z.ZodString>;
+        frozenAt: z.ZodString;
+    }, z.core.$strict>;
+    members: z.ZodArray<z.ZodObject<{
+        resultVersionId: z.ZodString;
+        workspaceId: z.ZodString;
+        directoryName: z.ZodString;
+        remixId: z.ZodNullable<z.ZodString>;
+        branchName: z.ZodString;
+        prompt: z.ZodString;
+        model: z.ZodOptional<z.ZodString>;
+        resumeFromCommit: z.ZodOptional<z.ZodString>;
+        syncOfResultVersionId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type SubmitBatchRunsRequest = z.infer<typeof submitBatchRunsRequestSchema>;
+export declare const batchRunViewSchema: z.ZodObject<{
+    runId: z.ZodString;
+    batchId: z.ZodString;
+    resultVersionId: z.ZodString;
+    runtimeId: z.ZodString;
+    workspaceId: z.ZodString;
+    directoryName: z.ZodString;
+    occupancyId: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    operationId: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<{
+        failed: "failed";
+        running: "running";
+        queued: "queued";
+        cancelled: "cancelled";
+        reconciling: "reconciling";
+        stopping: "stopping";
+        succeeded: "succeeded";
+    }>;
+    phase: z.ZodEnum<{
+        prepare: "prepare";
+        generate: "generate";
+        deliver: "deliver";
+    }>;
+    resumeFromCommit: z.ZodOptional<z.ZodString>;
+    evidence: z.ZodOptional<z.ZodObject<{
+        savedCommit: z.ZodOptional<z.ZodString>;
+        pushedCommit: z.ZodOptional<z.ZodString>;
+        buildDigest: z.ZodOptional<z.ZodString>;
+        verified: z.ZodOptional<z.ZodBoolean>;
+        previewRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    previousRunId: z.ZodOptional<z.ZodString>;
+    autoRecoveryCount: z.ZodNumber;
+    cancelRequested: z.ZodBoolean;
+    ownerFence: z.ZodNumber;
+    revision: z.ZodNumber;
+    error: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    startedAt: z.ZodOptional<z.ZodString>;
+    finishedAt: z.ZodOptional<z.ZodString>;
+    queuePosition: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type BatchRunView = z.infer<typeof batchRunViewSchema>;
+/** `POST /internal/batch-runs/:runId/sync` — replace input of a not-yet-started Run. */
+export declare const replaceBatchRunSnapshotSchema: z.ZodObject<{
+    snapshot: z.ZodObject<{
+        batchId: z.ZodString;
+        commitHash: z.ZodString;
+        digest: z.ZodString;
+        sourceWorkspaceId: z.ZodString;
+        sourceDirectoryName: z.ZodString;
+        remoteRef: z.ZodOptional<z.ZodString>;
+        artifactKey: z.ZodOptional<z.ZodString>;
+        frozenAt: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+/**
+ * Running, stopping, or reconciling members cannot switch snapshot mid-execution.
+ * The caller stores `pending_sync` and applies it after the Run ends.
+ */
+export declare const replaceBatchRunSnapshotResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    status: z.ZodLiteral<"replaced">;
+    run: z.ZodObject<{
+        runId: z.ZodString;
+        batchId: z.ZodString;
+        resultVersionId: z.ZodString;
+        runtimeId: z.ZodString;
+        workspaceId: z.ZodString;
+        directoryName: z.ZodString;
+        occupancyId: z.ZodOptional<z.ZodString>;
+        sessionId: z.ZodOptional<z.ZodString>;
+        operationId: z.ZodOptional<z.ZodString>;
+        status: z.ZodEnum<{
+            failed: "failed";
+            running: "running";
+            queued: "queued";
+            cancelled: "cancelled";
+            reconciling: "reconciling";
+            stopping: "stopping";
+            succeeded: "succeeded";
+        }>;
+        phase: z.ZodEnum<{
+            prepare: "prepare";
+            generate: "generate";
+            deliver: "deliver";
+        }>;
+        resumeFromCommit: z.ZodOptional<z.ZodString>;
+        evidence: z.ZodOptional<z.ZodObject<{
+            savedCommit: z.ZodOptional<z.ZodString>;
+            pushedCommit: z.ZodOptional<z.ZodString>;
+            buildDigest: z.ZodOptional<z.ZodString>;
+            verified: z.ZodOptional<z.ZodBoolean>;
+            previewRef: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        previousRunId: z.ZodOptional<z.ZodString>;
+        autoRecoveryCount: z.ZodNumber;
+        cancelRequested: z.ZodBoolean;
+        ownerFence: z.ZodNumber;
+        revision: z.ZodNumber;
+        error: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        startedAt: z.ZodOptional<z.ZodString>;
+        finishedAt: z.ZodOptional<z.ZodString>;
+        queuePosition: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    status: z.ZodLiteral<"pending_sync">;
+    runId: z.ZodString;
+}, z.core.$strict>], "status">;
+export type ReplaceBatchRunSnapshotResult = z.infer<typeof replaceBatchRunSnapshotResultSchema>;
+/** Batch-level source fact. Present when the event is not about a member Run. */
+export declare const batchSourceEventSubjectSchema: z.ZodObject<{
+    batchId: z.ZodString;
+    workspaceId: z.ZodString;
+    status: z.ZodEnum<{
+        ready: "ready";
+        failed: "failed";
+        lost: "lost";
+    }>;
+    snapshot: z.ZodOptional<z.ZodObject<{
+        batchId: z.ZodString;
+        commitHash: z.ZodString;
+        digest: z.ZodString;
+        sourceWorkspaceId: z.ZodString;
+        sourceDirectoryName: z.ZodString;
+        remoteRef: z.ZodOptional<z.ZodString>;
+        artifactKey: z.ZodOptional<z.ZodString>;
+        frozenAt: z.ZodString;
+    }, z.core.$strict>>;
+    error: z.ZodOptional<z.ZodString>;
+    failure: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        stage: z.ZodEnum<{
+            verify: "verify";
+            capture: "capture";
+            publish: "publish";
+        }>;
+        retryable: z.ZodBoolean;
+        outcome: z.ZodEnum<{
+            unknown: "unknown";
+            not_published: "not_published";
+        }>;
+        diagnosticId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type BatchSourceEventSubject = z.infer<typeof batchSourceEventSubjectSchema>;
+export declare const batchRunEventReasonSchema: z.ZodEnum<{
+    source_lost: "source_lost";
+    status_changed: "status_changed";
+    phase_changed: "phase_changed";
+    queue_changed: "queue_changed";
+    recovered: "recovered";
+    source_ready: "source_ready";
+    source_failed: "source_failed";
+}>;
+/**
+ * Runtime → Business `POST /api/internal/cloud-batches/runs/events`; at-least-once, ordered by revision.
+ * A member event carries `run`. A source freeze event carries `source` and no run.
+ * `source_ready` / `source_failed` are additive reason values.
+ */
+export declare const batchRunEventSchema: z.ZodUnion<readonly [z.ZodObject<{
+    run: z.ZodObject<{
+        runId: z.ZodString;
+        batchId: z.ZodString;
+        resultVersionId: z.ZodString;
+        runtimeId: z.ZodString;
+        workspaceId: z.ZodString;
+        directoryName: z.ZodString;
+        occupancyId: z.ZodOptional<z.ZodString>;
+        sessionId: z.ZodOptional<z.ZodString>;
+        operationId: z.ZodOptional<z.ZodString>;
+        status: z.ZodEnum<{
+            failed: "failed";
+            running: "running";
+            queued: "queued";
+            cancelled: "cancelled";
+            reconciling: "reconciling";
+            stopping: "stopping";
+            succeeded: "succeeded";
+        }>;
+        phase: z.ZodEnum<{
+            prepare: "prepare";
+            generate: "generate";
+            deliver: "deliver";
+        }>;
+        resumeFromCommit: z.ZodOptional<z.ZodString>;
+        evidence: z.ZodOptional<z.ZodObject<{
+            savedCommit: z.ZodOptional<z.ZodString>;
+            pushedCommit: z.ZodOptional<z.ZodString>;
+            buildDigest: z.ZodOptional<z.ZodString>;
+            verified: z.ZodOptional<z.ZodBoolean>;
+            previewRef: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        previousRunId: z.ZodOptional<z.ZodString>;
+        autoRecoveryCount: z.ZodNumber;
+        cancelRequested: z.ZodBoolean;
+        ownerFence: z.ZodNumber;
+        revision: z.ZodNumber;
+        error: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        startedAt: z.ZodOptional<z.ZodString>;
+        finishedAt: z.ZodOptional<z.ZodString>;
+        queuePosition: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>;
+    reason: z.ZodEnum<{
+        source_lost: "source_lost";
+        status_changed: "status_changed";
+        phase_changed: "phase_changed";
+        queue_changed: "queue_changed";
+        recovered: "recovered";
+        source_ready: "source_ready";
+        source_failed: "source_failed";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    source: z.ZodObject<{
+        batchId: z.ZodString;
+        workspaceId: z.ZodString;
+        status: z.ZodEnum<{
+            ready: "ready";
+            failed: "failed";
+            lost: "lost";
+        }>;
+        snapshot: z.ZodOptional<z.ZodObject<{
+            batchId: z.ZodString;
+            commitHash: z.ZodString;
+            digest: z.ZodString;
+            sourceWorkspaceId: z.ZodString;
+            sourceDirectoryName: z.ZodString;
+            remoteRef: z.ZodOptional<z.ZodString>;
+            artifactKey: z.ZodOptional<z.ZodString>;
+            frozenAt: z.ZodString;
+        }, z.core.$strict>>;
+        error: z.ZodOptional<z.ZodString>;
+        failure: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            stage: z.ZodEnum<{
+                verify: "verify";
+                capture: "capture";
+                publish: "publish";
+            }>;
+            retryable: z.ZodBoolean;
+            outcome: z.ZodEnum<{
+                unknown: "unknown";
+                not_published: "not_published";
+            }>;
+            diagnosticId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    reason: z.ZodEnum<{
+        source_lost: "source_lost";
+        source_ready: "source_ready";
+        source_failed: "source_failed";
+    }>;
+}, z.core.$strict>]>;
+export type BatchRunEvent = z.infer<typeof batchRunEventSchema>;
+export declare const batchSourceStatusSchema: z.ZodEnum<{
+    ready: "ready";
+    failed: "failed";
+    freezing: "freezing";
+    waiting_source_idle: "waiting_source_idle";
+    lost: "lost";
+}>;
+export type BatchSourceStatus = z.infer<typeof batchSourceStatusSchema>;
+export declare const batchMemberDisplayStatusSchema: z.ZodEnum<{
+    failed: "failed";
+    queued: "queued";
+    cancelled: "cancelled";
+    generating: "generating";
+    preparing: "preparing";
+    reconciling: "reconciling";
+    stopping: "stopping";
+    succeeded: "succeeded";
+    pending_sync: "pending_sync";
+    source_failed: "source_failed";
+    waiting_source: "waiting_source";
+    delivering: "delivering";
+}>;
+export type BatchMemberDisplayStatus = z.infer<typeof batchMemberDisplayStatusSchema>;
+export declare const batchMemberViewSchema: z.ZodObject<{
+    resultVersionId: z.ZodString;
+    ordinal: z.ZodNumber;
+    prompt: z.ZodString;
+    status: z.ZodEnum<{
+        failed: "failed";
+        queued: "queued";
+        cancelled: "cancelled";
+        generating: "generating";
+        preparing: "preparing";
+        reconciling: "reconciling";
+        stopping: "stopping";
+        succeeded: "succeeded";
+        pending_sync: "pending_sync";
+        source_failed: "source_failed";
+        waiting_source: "waiting_source";
+        delivering: "delivering";
+    }>;
+    queuePosition: z.ZodOptional<z.ZodNumber>;
+    startedAt: z.ZodOptional<z.ZodString>;
+    finishedAt: z.ZodOptional<z.ZodString>;
+    directoryName: z.ZodOptional<z.ZodString>;
+    remixId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    runId: z.ZodOptional<z.ZodString>;
+    previewRef: z.ZodOptional<z.ZodString>;
+    previewStale: z.ZodOptional<z.ZodBoolean>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type BatchMemberView = z.infer<typeof batchMemberViewSchema>;
+export declare const batchViewSchema: z.ZodObject<{
+    batchId: z.ZodString;
+    workspaceId: z.ZodString;
+    sourceDirectoryName: z.ZodString;
+    sourceStatus: z.ZodEnum<{
+        ready: "ready";
+        failed: "failed";
+        freezing: "freezing";
+        waiting_source_idle: "waiting_source_idle";
+        lost: "lost";
+    }>;
+    sourceError: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        stage: z.ZodEnum<{
+            verify: "verify";
+            capture: "capture";
+            publish: "publish";
+        }>;
+        retryable: z.ZodBoolean;
+        outcome: z.ZodEnum<{
+            unknown: "unknown";
+            not_published: "not_published";
+        }>;
+        diagnosticId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    cancelRequested: z.ZodBoolean;
+    counts: z.ZodObject<{
+        queued: z.ZodNumber;
+        running: z.ZodNumber;
+        succeeded: z.ZodNumber;
+        failed: z.ZodNumber;
+        cancelled: z.ZodNumber;
+    }, z.core.$strict>;
+    members: z.ZodArray<z.ZodObject<{
+        resultVersionId: z.ZodString;
+        ordinal: z.ZodNumber;
+        prompt: z.ZodString;
+        status: z.ZodEnum<{
+            failed: "failed";
+            queued: "queued";
+            cancelled: "cancelled";
+            generating: "generating";
+            preparing: "preparing";
+            reconciling: "reconciling";
+            stopping: "stopping";
+            succeeded: "succeeded";
+            pending_sync: "pending_sync";
+            source_failed: "source_failed";
+            waiting_source: "waiting_source";
+            delivering: "delivering";
+        }>;
+        queuePosition: z.ZodOptional<z.ZodNumber>;
+        startedAt: z.ZodOptional<z.ZodString>;
+        finishedAt: z.ZodOptional<z.ZodString>;
+        directoryName: z.ZodOptional<z.ZodString>;
+        remixId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        sessionId: z.ZodOptional<z.ZodString>;
+        runId: z.ZodOptional<z.ZodString>;
+        previewRef: z.ZodOptional<z.ZodString>;
+        previewStale: z.ZodOptional<z.ZodBoolean>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    createdAt: z.ZodString;
+}, z.core.$strict>;
+export type BatchView = z.infer<typeof batchViewSchema>;
+export declare const batchCreateAcceptedSchema: z.ZodObject<{
+    flowVersion: z.ZodLiteral<"v2">;
+    accepted: z.ZodLiteral<true>;
+    batchId: z.ZodString;
+    sourceStatus: z.ZodEnum<{
+        ready: "ready";
+        failed: "failed";
+        freezing: "freezing";
+        waiting_source_idle: "waiting_source_idle";
+        lost: "lost";
+    }>;
+    view: z.ZodObject<{
+        batchId: z.ZodString;
+        workspaceId: z.ZodString;
+        sourceDirectoryName: z.ZodString;
+        sourceStatus: z.ZodEnum<{
+            ready: "ready";
+            failed: "failed";
+            freezing: "freezing";
+            waiting_source_idle: "waiting_source_idle";
+            lost: "lost";
+        }>;
+        sourceError: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            stage: z.ZodEnum<{
+                verify: "verify";
+                capture: "capture";
+                publish: "publish";
+            }>;
+            retryable: z.ZodBoolean;
+            outcome: z.ZodEnum<{
+                unknown: "unknown";
+                not_published: "not_published";
+            }>;
+            diagnosticId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        cancelRequested: z.ZodBoolean;
+        counts: z.ZodObject<{
+            queued: z.ZodNumber;
+            running: z.ZodNumber;
+            succeeded: z.ZodNumber;
+            failed: z.ZodNumber;
+            cancelled: z.ZodNumber;
+        }, z.core.$strict>;
+        members: z.ZodArray<z.ZodObject<{
+            resultVersionId: z.ZodString;
+            ordinal: z.ZodNumber;
+            prompt: z.ZodString;
+            status: z.ZodEnum<{
+                failed: "failed";
+                queued: "queued";
+                cancelled: "cancelled";
+                generating: "generating";
+                preparing: "preparing";
+                reconciling: "reconciling";
+                stopping: "stopping";
+                succeeded: "succeeded";
+                pending_sync: "pending_sync";
+                source_failed: "source_failed";
+                waiting_source: "waiting_source";
+                delivering: "delivering";
+            }>;
+            queuePosition: z.ZodOptional<z.ZodNumber>;
+            startedAt: z.ZodOptional<z.ZodString>;
+            finishedAt: z.ZodOptional<z.ZodString>;
+            directoryName: z.ZodOptional<z.ZodString>;
+            remixId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            sessionId: z.ZodOptional<z.ZodString>;
+            runId: z.ZodOptional<z.ZodString>;
+            previewRef: z.ZodOptional<z.ZodString>;
+            previewStale: z.ZodOptional<z.ZodBoolean>;
+            error: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        createdAt: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type BatchCreateAccepted = z.infer<typeof batchCreateAcceptedSchema>;
+export declare function batchMemberDisplayStatus(run: Pick<z.infer<typeof batchRunSchema>, 'status' | 'phase'> | undefined, source: BatchSourceStatus, pendingSync?: boolean): BatchMemberDisplayStatus;
+/** `GET /runtime/workspaces/:workspaceId/execution-queue` — open occupancies of the caller's sandbox. */
+export declare const executionQueueEntrySchema: z.ZodObject<{
+    occupancyId: z.ZodString;
+    workspaceId: z.ZodString;
+    directoryName: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"root">]>;
+    source: z.ZodEnum<{
+        session_turn: "session_turn";
+        preview_build: "preview_build";
+        batch_run: "batch_run";
+    }>;
+    status: z.ZodEnum<{
+        queued: "queued";
+        active: "active";
+        waiting_user: "waiting_user";
+        reconciling: "reconciling";
+    }>;
+    operationId: z.ZodOptional<z.ZodString>;
+    runId: z.ZodOptional<z.ZodString>;
+    queuePosition: z.ZodOptional<z.ZodNumber>;
+    sessionId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ExecutionQueueEntry = z.infer<typeof executionQueueEntrySchema>;
+export declare const executionQueueViewSchema: z.ZodObject<{
+    workspaceMax: z.ZodNumber;
+    sandboxMax: z.ZodNumber;
+    entries: z.ZodArray<z.ZodObject<{
+        occupancyId: z.ZodString;
+        workspaceId: z.ZodString;
+        directoryName: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"root">]>;
+        source: z.ZodEnum<{
+            session_turn: "session_turn";
+            preview_build: "preview_build";
+            batch_run: "batch_run";
+        }>;
+        status: z.ZodEnum<{
+            queued: "queued";
+            active: "active";
+            waiting_user: "waiting_user";
+            reconciling: "reconciling";
+        }>;
+        operationId: z.ZodOptional<z.ZodString>;
+        runId: z.ZodOptional<z.ZodString>;
+        queuePosition: z.ZodOptional<z.ZodNumber>;
+        sessionId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ExecutionQueueView = z.infer<typeof executionQueueViewSchema>;
+//# sourceMappingURL=batch-runs.d.ts.map