@playcraft/common 0.1.54 → 0.1.56-beta

package/dist/cloud-workspace/runtime/operations.d.ts

@@ -0,0 +1,668 @@
+import { z } from 'zod';
+export declare const reasoningEffortSchema: z.ZodEnum<{
+    low: "low";
+    medium: "medium";
+    high: "high";
+    max: "max";
+}>;
+export type WorkspaceReasoningEffort = z.infer<typeof reasoningEffortSchema>;
+export declare const OPERATION_KINDS: readonly ["runtime.ensure", "runtime.destroy", "session.create", "session.turn", "session.review", "session.compact", "session.steer", "session.interrupt", "session.approval.respond", "file.write", "file.binary.write", "directory.create", "directory.rename", "directory.delete", "asset.library.import", "asset.bundle.save", "git.commit", "git.push", "git.pull", "git.merge.abort", "git.stage", "git.unstage", "git.discard", "workspace.save", "workspace.references.import", "terminal.create", "parameter.patch", "parameter.verify", "skills.update", "preview.publish", "delivery.build", "delivery.cancel", "checkpoint.create", "checkpoint.restore"];
+export type OperationKind = (typeof OPERATION_KINDS)[number];
+export declare const operationKindSchema: z.ZodEnum<{
+    "directory.rename": "directory.rename";
+    "directory.delete": "directory.delete";
+    "runtime.ensure": "runtime.ensure";
+    "runtime.destroy": "runtime.destroy";
+    "session.create": "session.create";
+    "session.turn": "session.turn";
+    "session.review": "session.review";
+    "session.compact": "session.compact";
+    "session.steer": "session.steer";
+    "session.interrupt": "session.interrupt";
+    "session.approval.respond": "session.approval.respond";
+    "file.write": "file.write";
+    "file.binary.write": "file.binary.write";
+    "directory.create": "directory.create";
+    "asset.library.import": "asset.library.import";
+    "asset.bundle.save": "asset.bundle.save";
+    "git.commit": "git.commit";
+    "git.push": "git.push";
+    "git.pull": "git.pull";
+    "git.merge.abort": "git.merge.abort";
+    "git.stage": "git.stage";
+    "git.unstage": "git.unstage";
+    "git.discard": "git.discard";
+    "workspace.save": "workspace.save";
+    "workspace.references.import": "workspace.references.import";
+    "terminal.create": "terminal.create";
+    "parameter.patch": "parameter.patch";
+    "parameter.verify": "parameter.verify";
+    "skills.update": "skills.update";
+    "preview.publish": "preview.publish";
+    "delivery.build": "delivery.build";
+    "delivery.cancel": "delivery.cancel";
+    "checkpoint.create": "checkpoint.create";
+    "checkpoint.restore": "checkpoint.restore";
+}>;
+/**
+ * What one operation kind is allowed to do to the workspace directory.
+ *
+ * This is a total map over `OperationKind` (`satisfies Record<…>`): adding a kind to
+ * `OPERATION_KINDS` without classifying it fails the build, so the answer to “does this
+ * touch the directory?” lives in exactly one place. An exception set would silently
+ * classify new kinds by omission — that is what let a new conversation be refused while
+ * another turn held the directory.
+ */
+export type OperationEffect = {
+    /** The operation can create, change or delete files inside the workspace directory. */
+    mutatesWorkspace: boolean;
+    /** The operation runs as an execution slot and is serialized per directory by the ledger. */
+    executionSlot: boolean;
+};
+export declare const OPERATION_EFFECTS: {
+    readonly 'runtime.ensure': {
+        readonly mutatesWorkspace: false;
+        readonly executionSlot: false;
+    };
+    readonly 'runtime.destroy': {
+        readonly mutatesWorkspace: false;
+        readonly executionSlot: false;
+    };
+    readonly 'session.create': {
+        readonly mutatesWorkspace: false;
+        readonly executionSlot: false;
+    };
+    readonly 'session.turn': {
+        readonly mutatesWorkspace: true;
+        readonly executionSlot: true;
+    };
+    readonly 'session.review': {
+        readonly mutatesWorkspace: false;
+        readonly executionSlot: true;
+    };
+    readonly 'session.compact': {
+        readonly mutatesWorkspace: false;
+        readonly executionSlot: true;
+    };
+    readonly 'session.steer': {
+        readonly mutatesWorkspace: false;
+        readonly executionSlot: false;
+    };
+    readonly 'session.interrupt': {
+        readonly mutatesWorkspace: false;
+        readonly executionSlot: false;
+    };
+    readonly 'session.approval.respond': {
+        readonly mutatesWorkspace: false;
+        readonly executionSlot: false;
+    };
+    readonly 'file.write': {
+        readonly mutatesWorkspace: true;
+        readonly executionSlot: false;
+    };
+    readonly 'file.binary.write': {
+        readonly mutatesWorkspace: true;
+        readonly executionSlot: false;
+    };
+    readonly 'directory.create': {
+        readonly mutatesWorkspace: true;
+        readonly executionSlot: false;
+    };
+    readonly 'directory.rename': {
+        readonly mutatesWorkspace: true;
+        readonly executionSlot: false;
+    };
+    readonly 'directory.delete': {
+        readonly mutatesWorkspace: true;
+        readonly executionSlot: false;
+    };
+    readonly 'asset.library.import': {
+        readonly mutatesWorkspace: true;
+        readonly executionSlot: false;
+    };
+    readonly 'asset.bundle.save': {
+        readonly mutatesWorkspace: true;
+        readonly executionSlot: false;
+    };
+    readonly 'git.commit': {
+        readonly mutatesWorkspace: true;
+        readonly executionSlot: false;
+    };
+    readonly 'git.push': {
+        readonly mutatesWorkspace: true;
+        readonly executionSlot: false;
+    };
+    readonly 'git.pull': {
+        readonly mutatesWorkspace: true;
+        readonly executionSlot: false;
+    };
+    readonly 'git.merge.abort': {
+        readonly mutatesWorkspace: true;
+        readonly executionSlot: false;
+    };
+    readonly 'git.stage': {
+        readonly mutatesWorkspace: true;
+        readonly executionSlot: false;
+    };
+    readonly 'git.unstage': {
+        readonly mutatesWorkspace: true;
+        readonly executionSlot: false;
+    };
+    readonly 'git.discard': {
+        readonly mutatesWorkspace: true;
+        readonly executionSlot: false;
+    };
+    readonly 'workspace.save': {
+        readonly mutatesWorkspace: true;
+        readonly executionSlot: false;
+    };
+    readonly 'workspace.references.import': {
+        readonly mutatesWorkspace: true;
+        readonly executionSlot: false;
+    };
+    readonly 'terminal.create': {
+        readonly mutatesWorkspace: true;
+        readonly executionSlot: false;
+    };
+    readonly 'parameter.patch': {
+        readonly mutatesWorkspace: true;
+        readonly executionSlot: false;
+    };
+    readonly 'parameter.verify': {
+        readonly mutatesWorkspace: true;
+        readonly executionSlot: false;
+    };
+    readonly 'skills.update': {
+        readonly mutatesWorkspace: true;
+        readonly executionSlot: false;
+    };
+    readonly 'preview.publish': {
+        readonly mutatesWorkspace: true;
+        readonly executionSlot: true;
+    };
+    readonly 'delivery.build': {
+        readonly mutatesWorkspace: true;
+        readonly executionSlot: false;
+    };
+    readonly 'delivery.cancel': {
+        readonly mutatesWorkspace: false;
+        readonly executionSlot: false;
+    };
+    readonly 'checkpoint.create': {
+        readonly mutatesWorkspace: true;
+        readonly executionSlot: false;
+    };
+    readonly 'checkpoint.restore': {
+        readonly mutatesWorkspace: true;
+        readonly executionSlot: false;
+    };
+};
+export declare function operationEffect(kind: string): OperationEffect;
+/** Kinds that steer a running turn; they touch neither workspace content nor the runtime itself. */
+export declare const TURN_CONTROL_OPERATION_KINDS: readonly ["session.interrupt", "session.approval.respond", "session.steer"];
+/** Kinds that steer the runtime or a running turn without changing workspace content. */
+export declare const CONTROL_OPERATION_KINDS: readonly OperationKind[];
+export declare function isTurnControl(kind: string): boolean;
+export declare function isWorkspaceMutation(kind: string): boolean;
+/** Takes the directory for the whole execution and is serialized per directory. */
+export declare function takesExecutionSlot(kind: string): boolean;
+/**
+ * Classifies an operation that changes files without queueing behind the ledger. Runtime does not
+ * refuse those while another execution holds the directory any more (concurrent writers are
+ * allowed), so this is a description of the operation, not an admission rule.
+ */
+export declare function needsExclusiveDirectory(kind: string): boolean;
+/** True when the operation needs the directory free of batch runs and other executions. */
+export declare function takesWorkspaceDirectory(kind: string): boolean;
+export declare const OPERATION_STATUSES: readonly ["queued", "dispatched", "accepted", "completed", "failed", "interrupted", "uncertain"];
+export type OperationStatus = (typeof OPERATION_STATUSES)[number];
+export declare const operationStatusSchema: z.ZodEnum<{
+    accepted: "accepted";
+    failed: "failed";
+    completed: "completed";
+    uncertain: "uncertain";
+    interrupted: "interrupted";
+    queued: "queued";
+    dispatched: "dispatched";
+}>;
+export declare const TERMINAL_OPERATION_STATUSES: readonly ["completed", "failed", "interrupted"];
+export type TerminalOperationStatus = (typeof TERMINAL_OPERATION_STATUSES)[number];
+export declare function canTransitionOperation(from: OperationStatus, to: OperationStatus): boolean;
+export declare function assertOperationTransition(from: OperationStatus, to: OperationStatus): void;
+export declare const logTailSchema: z.ZodObject<{
+    text: z.ZodString;
+    size: z.ZodNumber;
+    offset: z.ZodNumber;
+}, z.core.$strict>;
+export type LogTail = z.infer<typeof logTailSchema>;
+export declare const operationLogSchema: z.ZodObject<{
+    text: z.ZodString;
+    size: z.ZodNumber;
+    offset: z.ZodNumber;
+}, z.core.$strict>;
+export type OperationLog = LogTail;
+export declare const operationAcceptRequestSchema: z.ZodObject<{
+    clientRequestId: z.ZodString;
+    kind: z.ZodEnum<{
+        "directory.rename": "directory.rename";
+        "directory.delete": "directory.delete";
+        "runtime.ensure": "runtime.ensure";
+        "runtime.destroy": "runtime.destroy";
+        "session.create": "session.create";
+        "session.turn": "session.turn";
+        "session.review": "session.review";
+        "session.compact": "session.compact";
+        "session.steer": "session.steer";
+        "session.interrupt": "session.interrupt";
+        "session.approval.respond": "session.approval.respond";
+        "file.write": "file.write";
+        "file.binary.write": "file.binary.write";
+        "directory.create": "directory.create";
+        "asset.library.import": "asset.library.import";
+        "asset.bundle.save": "asset.bundle.save";
+        "git.commit": "git.commit";
+        "git.push": "git.push";
+        "git.pull": "git.pull";
+        "git.merge.abort": "git.merge.abort";
+        "git.stage": "git.stage";
+        "git.unstage": "git.unstage";
+        "git.discard": "git.discard";
+        "workspace.save": "workspace.save";
+        "workspace.references.import": "workspace.references.import";
+        "terminal.create": "terminal.create";
+        "parameter.patch": "parameter.patch";
+        "parameter.verify": "parameter.verify";
+        "skills.update": "skills.update";
+        "preview.publish": "preview.publish";
+        "delivery.build": "delivery.build";
+        "delivery.cancel": "delivery.cancel";
+        "checkpoint.create": "checkpoint.create";
+        "checkpoint.restore": "checkpoint.restore";
+    }>;
+    workspaceId: z.ZodOptional<z.ZodString>;
+    directoryName: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"root">]>>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    expectedRevision: z.ZodOptional<z.ZodNumber>;
+    payload: z.ZodUnknown;
+    remixReferenceSnapshot: z.ZodOptional<z.ZodObject<{
+        source: z.ZodObject<{
+            environment: z.ZodString;
+            projectUuid: z.ZodString;
+            branchName: z.ZodString;
+            commit: z.ZodString;
+            name: z.ZodString;
+            category: z.ZodEnum<{
+                recommended: "recommended";
+                community: "community";
+            }>;
+            projectType: z.ZodEnum<{
+                external: "external";
+                playcanvas: "playcanvas";
+            }>;
+            engine: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        files: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            content: z.ZodString;
+            sha256: z.ZodString;
+            size: z.ZodNumber;
+        }, z.core.$strict>>;
+        contentHash: z.ZodString;
+    }, z.core.$strict>>;
+    libraryAssetImports: z.ZodOptional<z.ZodObject<{
+        assets: z.ZodArray<z.ZodObject<{
+            assetId: z.ZodString;
+            name: z.ZodString;
+            libraryPath: z.ZodString;
+            visibility: z.ZodEnum<{
+                public: "public";
+                team: "team";
+            }>;
+            teamId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            kind: z.ZodEnum<{
+                file: "file";
+                bundle: "bundle";
+            }>;
+            files: z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                content: z.ZodString;
+                mimeType: z.ZodString;
+                sha256: z.ZodString;
+            }, z.core.$strict>>;
+            contentHash: z.ZodString;
+        }, z.core.$strict>>;
+        failures: z.ZodArray<z.ZodObject<{
+            assetId: z.ZodString;
+            error: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    sessionRecovery: z.ZodOptional<z.ZodObject<{
+        context: z.ZodString;
+        nativeThreadId: z.ZodOptional<z.ZodString>;
+        modelConfigId: z.ZodOptional<z.ZodString>;
+        reasoningEffort: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+            max: "max";
+        }>>;
+        permissionMode: z.ZodOptional<z.ZodEnum<{
+            auto: "auto";
+            confirm: "confirm";
+            "read-only": "read-only";
+        }>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type OperationAcceptRequest = z.infer<typeof operationAcceptRequestSchema>;
+export type SessionRecovery = NonNullable<OperationAcceptRequest['sessionRecovery']>;
+/**
+ * Why a turn failed because its session has no usable Codex thread. Each is decided before the
+ * message reaches Codex, so the same turn may be sent again with a `sessionRecovery`.
+ */
+export declare const LOST_THREAD_ERRORS: readonly ["native_not_recoverable", "unknown_session", "unknown_thread"];
+export declare function isLostThreadError(error: string | undefined): boolean;
+export declare const operationRecordSchema: z.ZodObject<{
+    operationId: z.ZodString;
+    environment: z.ZodString;
+    userId: z.ZodString;
+    clientRequestId: z.ZodString;
+    kind: z.ZodEnum<{
+        "directory.rename": "directory.rename";
+        "directory.delete": "directory.delete";
+        "runtime.ensure": "runtime.ensure";
+        "runtime.destroy": "runtime.destroy";
+        "session.create": "session.create";
+        "session.turn": "session.turn";
+        "session.review": "session.review";
+        "session.compact": "session.compact";
+        "session.steer": "session.steer";
+        "session.interrupt": "session.interrupt";
+        "session.approval.respond": "session.approval.respond";
+        "file.write": "file.write";
+        "file.binary.write": "file.binary.write";
+        "directory.create": "directory.create";
+        "asset.library.import": "asset.library.import";
+        "asset.bundle.save": "asset.bundle.save";
+        "git.commit": "git.commit";
+        "git.push": "git.push";
+        "git.pull": "git.pull";
+        "git.merge.abort": "git.merge.abort";
+        "git.stage": "git.stage";
+        "git.unstage": "git.unstage";
+        "git.discard": "git.discard";
+        "workspace.save": "workspace.save";
+        "workspace.references.import": "workspace.references.import";
+        "terminal.create": "terminal.create";
+        "parameter.patch": "parameter.patch";
+        "parameter.verify": "parameter.verify";
+        "skills.update": "skills.update";
+        "preview.publish": "preview.publish";
+        "delivery.build": "delivery.build";
+        "delivery.cancel": "delivery.cancel";
+        "checkpoint.create": "checkpoint.create";
+        "checkpoint.restore": "checkpoint.restore";
+    }>;
+    status: z.ZodEnum<{
+        accepted: "accepted";
+        failed: "failed";
+        completed: "completed";
+        uncertain: "uncertain";
+        interrupted: "interrupted";
+        queued: "queued";
+        dispatched: "dispatched";
+    }>;
+    payloadHash: z.ZodString;
+    workspaceId: z.ZodOptional<z.ZodString>;
+    directoryName: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"root">]>>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    expectedRevision: z.ZodOptional<z.ZodNumber>;
+    generation: z.ZodOptional<z.ZodNumber>;
+    runtimeEpoch: z.ZodOptional<z.ZodNumber>;
+    leaseFence: z.ZodOptional<z.ZodNumber>;
+    nativeRequestId: z.ZodOptional<z.ZodString>;
+    nativeThreadId: z.ZodOptional<z.ZodString>;
+    nativeTurnId: z.ZodOptional<z.ZodString>;
+    modelConfigId: z.ZodOptional<z.ZodString>;
+    reasoningEffort: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+        max: "max";
+    }>>;
+    permissionMode: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        confirm: "confirm";
+        "read-only": "read-only";
+    }>>;
+    workMode: z.ZodOptional<z.ZodEnum<{
+        execute: "execute";
+        plan: "plan";
+    }>>;
+    context: z.ZodOptional<z.ZodObject<{
+        files: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            directoryName: z.ZodString;
+            path: z.ZodString;
+            contentHash: z.ZodOptional<z.ZodString>;
+            range: z.ZodOptional<z.ZodObject<{
+                startLine: z.ZodNumber;
+                endLine: z.ZodNumber;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>>;
+        skills: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            entryKey: z.ZodString;
+            lockHash: z.ZodString;
+        }, z.core.$strict>>>;
+        remixReferences: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            referenceId: z.ZodString;
+            directoryName: z.ZodString;
+            snapshotHash: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    remixReference: z.ZodOptional<z.ZodObject<{
+        referenceId: z.ZodString;
+        directoryName: z.ZodString;
+        path: z.ZodString;
+        name: z.ZodString;
+        source: z.ZodObject<{
+            environment: z.ZodString;
+            projectUuid: z.ZodString;
+            branchName: z.ZodString;
+            commit: z.ZodString;
+            name: z.ZodString;
+            category: z.ZodEnum<{
+                recommended: "recommended";
+                community: "community";
+            }>;
+            projectType: z.ZodEnum<{
+                external: "external";
+                playcanvas: "playcanvas";
+            }>;
+            engine: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        contentHash: z.ZodString;
+        importedAt: z.ZodString;
+        files: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            sourcePath: z.ZodString;
+            sha256: z.ZodString;
+            size: z.ZodNumber;
+        }, z.core.$strict>>;
+        omittedFiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            sha256: z.ZodString;
+            size: z.ZodNumber;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    result: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        paths: z.ZodArray<z.ZodString>;
+        skippedPaths: z.ZodArray<z.ZodString>;
+        failures: z.ZodArray<z.ZodObject<{
+            assetId: z.ZodString;
+            error: z.ZodString;
+        }, z.core.$strict>>;
+        bundleReceipt: z.ZodOptional<z.ZodObject<{
+            transferId: z.ZodString;
+            manifestHash: z.ZodString;
+            files: z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                size: z.ZodNumber;
+                contentHash: z.ZodString;
+            }, z.core.$strict>>;
+            directories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+        directoryMutation: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"directory.rename">;
+            newPath: z.ZodString;
+            operationId: z.ZodString;
+            path: z.ZodString;
+            revision: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"directory.delete">;
+            recoveryPath: z.ZodOptional<z.ZodString>;
+            operationId: z.ZodString;
+            path: z.ZodString;
+            revision: z.ZodNumber;
+        }, z.core.$strict>], "kind">>;
+    }, z.core.$strict>, z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        taskId: z.ZodString;
+        action: z.ZodEnum<{
+            discover: "discover";
+            add: "add";
+            admit: "admit";
+        }>;
+        goal: z.ZodOptional<z.ZodString>;
+        workspaceId: z.ZodString;
+        directoryName: z.ZodString;
+        sessionId: z.ZodString;
+        generation: z.ZodNumber;
+        runtimeEpoch: z.ZodNumber;
+        status: z.ZodEnum<{
+            failed: "failed";
+            missing: "missing";
+            invalid: "invalid";
+            candidates: "candidates";
+            running: "running";
+            reported: "reported";
+            checking: "checking";
+            verified: "verified";
+            "needs-verification": "needs-verification";
+            stale: "stale";
+            uncertain: "uncertain";
+            interrupted: "interrupted";
+        }>;
+        reportPath: z.ZodString;
+        report: z.ZodOptional<z.ZodObject<{
+            version: z.ZodLiteral<1>;
+            taskId: z.ZodString;
+            sources: z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                sha256: z.ZodString;
+            }, z.core.$strict>>;
+            candidates: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                fieldPath: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                origins: z.ZodArray<z.ZodObject<{
+                    path: z.ZodString;
+                    line: z.ZodOptional<z.ZodNumber>;
+                    summary: z.ZodString;
+                }, z.core.$strict>>;
+                consumers: z.ZodArray<z.ZodObject<{
+                    path: z.ZodString;
+                    line: z.ZodOptional<z.ZodNumber>;
+                    summary: z.ZodString;
+                }, z.core.$strict>>;
+                status: z.ZodEnum<{
+                    candidate: "candidate";
+                    implemented: "implemented";
+                    blocked: "blocked";
+                }>;
+                missing: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        checks: z.ZodArray<z.ZodObject<{
+            script: z.ZodEnum<{
+                "test:parameters": "test:parameters";
+                build: "build";
+                typecheck: "typecheck";
+            }>;
+            code: z.ZodNullable<z.ZodNumber>;
+            timedOut: z.ZodBoolean;
+            canceled: z.ZodOptional<z.ZodBoolean>;
+            logDigest: z.ZodString;
+            startedAt: z.ZodString;
+            finishedAt: z.ZodString;
+        }, z.core.$strict>>;
+        sourceDigest: z.ZodOptional<z.ZodString>;
+        receiptId: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strict>]>>;
+    userText: z.ZodOptional<z.ZodString>;
+    reviewTarget: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"uncommittedChanges">;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"baseBranch">;
+        branch: z.ZodString;
+    }, z.core.$strict>], "type">>;
+    expectedTurnId: z.ZodOptional<z.ZodString>;
+    nativeApprovalId: z.ZodOptional<z.ZodString>;
+    sandboxOperationId: z.ZodOptional<z.ZodString>;
+    checkpointId: z.ZodOptional<z.ZodString>;
+    checkpointKind: z.ZodOptional<z.ZodEnum<{
+        file: "file";
+        coordinated: "coordinated";
+        best_effort: "best_effort";
+    }>>;
+    checkpointConsistent: z.ZodOptional<z.ZodBoolean>;
+    snapshotManifestKey: z.ZodOptional<z.ZodString>;
+    snapshotChecksum: z.ZodOptional<z.ZodString>;
+    snapshotStatus: z.ZodOptional<z.ZodEnum<{
+        complete: "complete";
+        incomplete: "incomplete";
+    }>>;
+    terminalId: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strict>;
+export type OperationRecord = z.infer<typeof operationRecordSchema>;
+export declare function operationScopeKey(input: {
+    environment: string;
+    userId: string;
+    kind: OperationKind;
+    clientRequestId: string;
+    workspaceId?: string;
+    directoryName?: string;
+    sessionId?: string;
+}): string;
+export declare function hashOperationPayload(payload: unknown): string;
+export type IdempotentAcceptResult = {
+    action: 'create';
+} | {
+    action: 'reuse';
+    operation: OperationRecord;
+} | {
+    action: 'conflict';
+    operation: OperationRecord;
+};
+export declare function resolveIdempotentAccept(existing: OperationRecord | undefined, payloadHash: string): IdempotentAcceptResult;
+export declare function transitionOperation(operation: OperationRecord, to: OperationStatus, patch?: Partial<Omit<OperationRecord, 'operationId' | 'status'>>): OperationRecord;
+export type NativeRecoveryEvidence = {
+    kind: 'running';
+    nativeThreadId: string;
+    nativeTurnId: string;
+} | {
+    kind: 'terminal';
+    nativeThreadId: string;
+    nativeTurnId: string;
+    status: TerminalOperationStatus;
+};
+export declare function recoverUncertainOperation(operation: OperationRecord, evidence: NativeRecoveryEvidence): OperationRecord;
+export declare function stableStringify(value: unknown): string;
+//# sourceMappingURL=operations.d.ts.map

package/dist/cloud-workspace/runtime/operations.d.ts.map

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