@playcraft/common 0.1.42 → 0.1.44-beta

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

@@ -0,0 +1,622 @@
+import { z } from 'zod';
+import { batchRunSchema } from './execution-admission.js';
+/** Runtime: unified admission for every directory execution. Off = normal chat does not queue. */
+export declare const EXECUTION_ADMISSION_ENABLED_ENV = "CLOUD_EXECUTION_ADMISSION_ENABLED";
+/** Business + Runtime: new batch entry. Off = old production flow untouched. */
+export declare const BATCH_FLOW_V2_ENABLED_ENV = "CLOUD_BATCH_FLOW_V2_ENABLED";
+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;
+}, z.core.$strict>, z.ZodObject<{
+    status: z.ZodLiteral<"failed">;
+    batchId: z.ZodString;
+    error: z.ZodString;
+}, 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";
+    }>;
+}, 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";
+    completed: "completed";
+    running: "running";
+    failed: "failed";
+    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";
+        completed: "completed";
+        running: "running";
+        failed: "failed";
+        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.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<{
+        running: "running";
+        failed: "failed";
+        cancelled: "cancelled";
+        queued: "queued";
+        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.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;
+    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<{
+            running: "running";
+            failed: "failed";
+            cancelled: "cancelled";
+            queued: "queued";
+            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.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;
+        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<{
+        failed: "failed";
+        ready: "ready";
+        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>;
+}, z.core.$strict>;
+export type BatchSourceEventSubject = z.infer<typeof batchSourceEventSubjectSchema>;
+export declare const batchRunEventReasonSchema: z.ZodEnum<{
+    status_changed: "status_changed";
+    phase_changed: "phase_changed";
+    queue_changed: "queue_changed";
+    recovered: "recovered";
+    source_lost: "source_lost";
+    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<{
+            running: "running";
+            failed: "failed";
+            cancelled: "cancelled";
+            queued: "queued";
+            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.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;
+        queuePosition: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>;
+    reason: z.ZodEnum<{
+        status_changed: "status_changed";
+        phase_changed: "phase_changed";
+        queue_changed: "queue_changed";
+        recovered: "recovered";
+        source_lost: "source_lost";
+        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<{
+            failed: "failed";
+            ready: "ready";
+            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>;
+    }, 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<{
+    failed: "failed";
+    ready: "ready";
+    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";
+    cancelled: "cancelled";
+    queued: "queued";
+    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";
+        cancelled: "cancelled";
+        queued: "queued";
+        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>;
+    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<{
+        failed: "failed";
+        ready: "ready";
+        freezing: "freezing";
+        waiting_source_idle: "waiting_source_idle";
+        lost: "lost";
+    }>;
+    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";
+            cancelled: "cancelled";
+            queued: "queued";
+            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>;
+        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<{
+        failed: "failed";
+        ready: "ready";
+        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<{
+            failed: "failed";
+            ready: "ready";
+            freezing: "freezing";
+            waiting_source_idle: "waiting_source_idle";
+            lost: "lost";
+        }>;
+        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";
+                cancelled: "cancelled";
+                queued: "queued";
+                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>;
+            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 isBatchFlowV2Enabled(env?: NodeJS.ProcessEnv): boolean;
+/** When v2 is enabled, pause new batch intake during cutover (design §11 step 2). */
+export declare const BATCH_FLOW_V2_INTAKE_PAUSED_ENV = "CLOUD_BATCH_V2_INTAKE_PAUSED";
+export declare function isBatchFlowV2IntakePaused(env?: NodeJS.ProcessEnv): boolean;
+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>;
+}, 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>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ExecutionQueueView = z.infer<typeof executionQueueViewSchema>;
+//# sourceMappingURL=batch-runs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"batch-runs.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/batch-runs.ts"],"names":[],"mappings":"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"}