@lumenkey/cli 0.3.1 → 0.4.0-rc.1

package/dist/studio/output-save-journal.d.ts

@@ -0,0 +1,971 @@
+import { z } from 'zod';
+import { StudioError } from './errors.js';
+import type { StudioRoot } from './types.js';
+import { type SaveOperation, type SaveAcceptInput, type SaveUpdate, type SaveTransfer } from './output-save-contract.js';
+declare const observationValue: z.ZodEffects<z.ZodObject<{
+    file: z.ZodEnum<["NOT_CHECKED", "ABSENT", "PARTIAL", "VERIFIED", "MISSING", "MODIFIED", "UNSAFE", "UNKNOWN"]>;
+    checkedAt: z.ZodNullable<z.ZodString>;
+    integrityCheck: z.ZodEnum<["IDLE", "PENDING"]>;
+    signature: z.ZodOptional<z.ZodString>;
+    errorCode: z.ZodOptional<z.ZodEnum<["SAVE_FILE_MISSING", "SAVE_FILE_MODIFIED", "SAVE_FILE_UNSAFE", "SAVE_FILE_READ_FAILED"]>>;
+}, "strict", z.ZodTypeAny, {
+    file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+    checkedAt: string | null;
+    integrityCheck: "PENDING" | "IDLE";
+    signature?: string | undefined;
+    errorCode?: "SAVE_FILE_MISSING" | "SAVE_FILE_MODIFIED" | "SAVE_FILE_UNSAFE" | "SAVE_FILE_READ_FAILED" | undefined;
+}, {
+    file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+    checkedAt: string | null;
+    integrityCheck: "PENDING" | "IDLE";
+    signature?: string | undefined;
+    errorCode?: "SAVE_FILE_MISSING" | "SAVE_FILE_MODIFIED" | "SAVE_FILE_UNSAFE" | "SAVE_FILE_READ_FAILED" | undefined;
+}>, {
+    file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+    checkedAt: string | null;
+    integrityCheck: "PENDING" | "IDLE";
+    signature?: string | undefined;
+    errorCode?: "SAVE_FILE_MISSING" | "SAVE_FILE_MODIFIED" | "SAVE_FILE_UNSAFE" | "SAVE_FILE_READ_FAILED" | undefined;
+}, {
+    file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+    checkedAt: string | null;
+    integrityCheck: "PENDING" | "IDLE";
+    signature?: string | undefined;
+    errorCode?: "SAVE_FILE_MISSING" | "SAVE_FILE_MODIFIED" | "SAVE_FILE_UNSAFE" | "SAVE_FILE_READ_FAILED" | undefined;
+}>;
+declare const observation: z.ZodEffects<z.ZodObject<{
+    assetId: z.ZodString;
+    revision: z.ZodNumber;
+    value: z.ZodEffects<z.ZodObject<{
+        file: z.ZodEnum<["NOT_CHECKED", "ABSENT", "PARTIAL", "VERIFIED", "MISSING", "MODIFIED", "UNSAFE", "UNKNOWN"]>;
+        checkedAt: z.ZodNullable<z.ZodString>;
+        integrityCheck: z.ZodEnum<["IDLE", "PENDING"]>;
+        signature: z.ZodOptional<z.ZodString>;
+        errorCode: z.ZodOptional<z.ZodEnum<["SAVE_FILE_MISSING", "SAVE_FILE_MODIFIED", "SAVE_FILE_UNSAFE", "SAVE_FILE_READ_FAILED"]>>;
+    }, "strict", z.ZodTypeAny, {
+        file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+        checkedAt: string | null;
+        integrityCheck: "PENDING" | "IDLE";
+        signature?: string | undefined;
+        errorCode?: "SAVE_FILE_MISSING" | "SAVE_FILE_MODIFIED" | "SAVE_FILE_UNSAFE" | "SAVE_FILE_READ_FAILED" | undefined;
+    }, {
+        file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+        checkedAt: string | null;
+        integrityCheck: "PENDING" | "IDLE";
+        signature?: string | undefined;
+        errorCode?: "SAVE_FILE_MISSING" | "SAVE_FILE_MODIFIED" | "SAVE_FILE_UNSAFE" | "SAVE_FILE_READ_FAILED" | undefined;
+    }>, {
+        file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+        checkedAt: string | null;
+        integrityCheck: "PENDING" | "IDLE";
+        signature?: string | undefined;
+        errorCode?: "SAVE_FILE_MISSING" | "SAVE_FILE_MODIFIED" | "SAVE_FILE_UNSAFE" | "SAVE_FILE_READ_FAILED" | undefined;
+    }, {
+        file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+        checkedAt: string | null;
+        integrityCheck: "PENDING" | "IDLE";
+        signature?: string | undefined;
+        errorCode?: "SAVE_FILE_MISSING" | "SAVE_FILE_MODIFIED" | "SAVE_FILE_UNSAFE" | "SAVE_FILE_READ_FAILED" | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    value: {
+        file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+        checkedAt: string | null;
+        integrityCheck: "PENDING" | "IDLE";
+        signature?: string | undefined;
+        errorCode?: "SAVE_FILE_MISSING" | "SAVE_FILE_MODIFIED" | "SAVE_FILE_UNSAFE" | "SAVE_FILE_READ_FAILED" | undefined;
+    };
+    assetId: string;
+    revision: number;
+}, {
+    value: {
+        file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+        checkedAt: string | null;
+        integrityCheck: "PENDING" | "IDLE";
+        signature?: string | undefined;
+        errorCode?: "SAVE_FILE_MISSING" | "SAVE_FILE_MODIFIED" | "SAVE_FILE_UNSAFE" | "SAVE_FILE_READ_FAILED" | undefined;
+    };
+    assetId: string;
+    revision: number;
+}>, {
+    file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+    checkedAt: string | null;
+    integrityCheck: "PENDING" | "IDLE";
+    signature?: string | undefined;
+    errorCode?: "SAVE_FILE_MISSING" | "SAVE_FILE_MODIFIED" | "SAVE_FILE_UNSAFE" | "SAVE_FILE_READ_FAILED" | undefined;
+    assetId: string;
+    revision: number;
+}, {
+    value: {
+        file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+        checkedAt: string | null;
+        integrityCheck: "PENDING" | "IDLE";
+        signature?: string | undefined;
+        errorCode?: "SAVE_FILE_MISSING" | "SAVE_FILE_MODIFIED" | "SAVE_FILE_UNSAFE" | "SAVE_FILE_READ_FAILED" | undefined;
+    };
+    assetId: string;
+    revision: number;
+}>;
+export type IntegrityObservationValue = z.infer<typeof observationValue>;
+export type IntegrityObservation = z.infer<typeof observation>;
+declare const schema: z.ZodEffects<z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    revision: z.ZodNumber;
+    rootId: z.ZodString;
+    canonicalAssetsPath: z.ZodString;
+    connections: z.ZodArray<z.ZodObject<{
+        connectionId: z.ZodString;
+        bindingDigestRef: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        connectionId: string;
+        bindingDigestRef: string;
+    }, {
+        connectionId: string;
+        bindingDigestRef: string;
+    }>, "many">;
+    operations: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        connectionId: z.ZodString;
+        requestIds: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+        assetId: z.ZodString;
+        executionRevision: z.ZodDefault<z.ZodNumber>;
+        transfer: z.ZodOptional<z.ZodObject<{
+            temporaryName: z.ZodString;
+            owner: z.ZodOptional<z.ZodObject<{
+                dev: z.ZodString;
+                ino: z.ZodString;
+                birthtimeMs: z.ZodNumber;
+            }, "strict", z.ZodTypeAny, {
+                dev: string;
+                ino: string;
+                birthtimeMs: number;
+            }, {
+                dev: string;
+                ino: string;
+                birthtimeMs: number;
+            }>>;
+            completed: z.ZodOptional<z.ZodObject<{
+                mediaType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "video/mp4", "video/webm"]>;
+                byteLength: z.ZodNumber;
+                sha256: z.ZodString;
+                relativePath: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                sha256: string;
+                byteLength: number;
+                mediaType: "image/png" | "image/jpeg" | "image/webp" | "video/mp4" | "video/webm";
+                relativePath: string;
+            }, {
+                sha256: string;
+                byteLength: number;
+                mediaType: "image/png" | "image/jpeg" | "image/webp" | "video/mp4" | "video/webm";
+                relativePath: string;
+            }>>;
+        }, "strict", z.ZodTypeAny, {
+            temporaryName: string;
+            owner?: {
+                dev: string;
+                ino: string;
+                birthtimeMs: number;
+            } | undefined;
+            completed?: {
+                sha256: string;
+                byteLength: number;
+                mediaType: "image/png" | "image/jpeg" | "image/webp" | "video/mp4" | "video/webm";
+                relativePath: string;
+            } | undefined;
+        }, {
+            temporaryName: string;
+            owner?: {
+                dev: string;
+                ino: string;
+                birthtimeMs: number;
+            } | undefined;
+            completed?: {
+                sha256: string;
+                byteLength: number;
+                mediaType: "image/png" | "image/jpeg" | "image/webp" | "video/mp4" | "video/webm";
+                relativePath: string;
+            } | undefined;
+        }>>;
+        receipt: z.ZodObject<{
+            state: z.ZodEnum<["ACCEPTED", "SAVING", "SAVED", "FAILED", "RECOVERY_REQUIRED", "BLOCKED"]>;
+            stage: z.ZodEnum<["QUEUED", "DOWNLOADING", "FILE_READY", "REGISTERED", "LINKED", "RECONCILING"]>;
+            attempt: z.ZodNumber;
+            asset: z.ZodNullable<z.ZodObject<{
+                assetId: z.ZodString;
+                displayName: z.ZodString;
+                mediaType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "video/mp4", "video/webm"]>;
+                byteLength: z.ZodNumber;
+                sha256: z.ZodString;
+                relativePath: z.ZodString;
+                absolutePath: z.ZodString;
+                contentUrl: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                sha256: string;
+                byteLength: number;
+                assetId: string;
+                displayName: string;
+                mediaType: "image/png" | "image/jpeg" | "image/webp" | "video/mp4" | "video/webm";
+                relativePath: string;
+                absolutePath: string;
+                contentUrl: string;
+            }, {
+                sha256: string;
+                byteLength: number;
+                assetId: string;
+                displayName: string;
+                mediaType: "image/png" | "image/jpeg" | "image/webp" | "video/mp4" | "video/webm";
+                relativePath: string;
+                absolutePath: string;
+                contentUrl: string;
+            }>>;
+            error: z.ZodNullable<z.ZodObject<{
+                code: z.ZodString;
+                message: z.ZodString;
+                type: z.ZodString;
+                httpStatus: z.ZodOptional<z.ZodNumber>;
+                retryable: z.ZodBoolean;
+                mayAlreadyBeSaved: z.ZodNullable<z.ZodBoolean>;
+            }, "strict", z.ZodTypeAny, {
+                code: string;
+                message: string;
+                type: string;
+                retryable: boolean;
+                mayAlreadyBeSaved: boolean | null;
+                httpStatus?: number | undefined;
+            }, {
+                code: string;
+                message: string;
+                type: string;
+                retryable: boolean;
+                mayAlreadyBeSaved: boolean | null;
+                httpStatus?: number | undefined;
+            }>>;
+            retryable: z.ZodBoolean;
+            safeRetry: z.ZodBoolean;
+            mayAlreadyBeSaved: z.ZodNullable<z.ZodBoolean>;
+        } & {
+            facts: z.ZodObject<{
+                registration: z.ZodEnum<["ABSENT", "PRESENT", "UNKNOWN"]>;
+                relation: z.ZodEnum<["ABSENT", "PRESENT", "UNKNOWN"]>;
+            } & {
+                file: z.ZodEnum<["NOT_CHECKED", "ABSENT", "PARTIAL", "VERIFIED", "MISSING", "MODIFIED", "UNSAFE", "UNKNOWN"]>;
+            }, "strict", z.ZodTypeAny, {
+                file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+                registration: "ABSENT" | "UNKNOWN" | "PRESENT";
+                relation: "ABSENT" | "UNKNOWN" | "PRESENT";
+            }, {
+                file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+                registration: "ABSENT" | "UNKNOWN" | "PRESENT";
+                relation: "ABSENT" | "UNKNOWN" | "PRESENT";
+            }>;
+            checkedAt: z.ZodNullable<z.ZodString>;
+            integrityCheck: z.ZodDefault<z.ZodEnum<["IDLE", "PENDING"]>>;
+            operationId: z.ZodString;
+            revision: z.ZodNumber;
+            localOutputId: z.ZodString;
+            runId: z.ZodString;
+            jobId: z.ZodString;
+            gatewayAssetId: z.ZodString;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            error: {
+                code: string;
+                message: string;
+                type: string;
+                retryable: boolean;
+                mayAlreadyBeSaved: boolean | null;
+                httpStatus?: number | undefined;
+            } | null;
+            createdAt: string;
+            state: "ACCEPTED" | "SAVING" | "SAVED" | "FAILED" | "RECOVERY_REQUIRED" | "BLOCKED";
+            jobId: string;
+            updatedAt: string;
+            revision: number;
+            runId: string;
+            retryable: boolean;
+            mayAlreadyBeSaved: boolean | null;
+            stage: "QUEUED" | "DOWNLOADING" | "FILE_READY" | "REGISTERED" | "LINKED" | "RECONCILING";
+            attempt: number;
+            facts: {
+                file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+                registration: "ABSENT" | "UNKNOWN" | "PRESENT";
+                relation: "ABSENT" | "UNKNOWN" | "PRESENT";
+            };
+            asset: {
+                sha256: string;
+                byteLength: number;
+                assetId: string;
+                displayName: string;
+                mediaType: "image/png" | "image/jpeg" | "image/webp" | "video/mp4" | "video/webm";
+                relativePath: string;
+                absolutePath: string;
+                contentUrl: string;
+            } | null;
+            safeRetry: boolean;
+            checkedAt: string | null;
+            integrityCheck: "PENDING" | "IDLE";
+            operationId: string;
+            localOutputId: string;
+            gatewayAssetId: string;
+        }, {
+            error: {
+                code: string;
+                message: string;
+                type: string;
+                retryable: boolean;
+                mayAlreadyBeSaved: boolean | null;
+                httpStatus?: number | undefined;
+            } | null;
+            createdAt: string;
+            state: "ACCEPTED" | "SAVING" | "SAVED" | "FAILED" | "RECOVERY_REQUIRED" | "BLOCKED";
+            jobId: string;
+            updatedAt: string;
+            revision: number;
+            runId: string;
+            retryable: boolean;
+            mayAlreadyBeSaved: boolean | null;
+            stage: "QUEUED" | "DOWNLOADING" | "FILE_READY" | "REGISTERED" | "LINKED" | "RECONCILING";
+            attempt: number;
+            facts: {
+                file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+                registration: "ABSENT" | "UNKNOWN" | "PRESENT";
+                relation: "ABSENT" | "UNKNOWN" | "PRESENT";
+            };
+            asset: {
+                sha256: string;
+                byteLength: number;
+                assetId: string;
+                displayName: string;
+                mediaType: "image/png" | "image/jpeg" | "image/webp" | "video/mp4" | "video/webm";
+                relativePath: string;
+                absolutePath: string;
+                contentUrl: string;
+            } | null;
+            safeRetry: boolean;
+            checkedAt: string | null;
+            operationId: string;
+            localOutputId: string;
+            gatewayAssetId: string;
+            integrityCheck?: "PENDING" | "IDLE" | undefined;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        assetId: string;
+        connectionId: string;
+        requestIds: string[];
+        executionRevision: number;
+        receipt: {
+            error: {
+                code: string;
+                message: string;
+                type: string;
+                retryable: boolean;
+                mayAlreadyBeSaved: boolean | null;
+                httpStatus?: number | undefined;
+            } | null;
+            createdAt: string;
+            state: "ACCEPTED" | "SAVING" | "SAVED" | "FAILED" | "RECOVERY_REQUIRED" | "BLOCKED";
+            jobId: string;
+            updatedAt: string;
+            revision: number;
+            runId: string;
+            retryable: boolean;
+            mayAlreadyBeSaved: boolean | null;
+            stage: "QUEUED" | "DOWNLOADING" | "FILE_READY" | "REGISTERED" | "LINKED" | "RECONCILING";
+            attempt: number;
+            facts: {
+                file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+                registration: "ABSENT" | "UNKNOWN" | "PRESENT";
+                relation: "ABSENT" | "UNKNOWN" | "PRESENT";
+            };
+            asset: {
+                sha256: string;
+                byteLength: number;
+                assetId: string;
+                displayName: string;
+                mediaType: "image/png" | "image/jpeg" | "image/webp" | "video/mp4" | "video/webm";
+                relativePath: string;
+                absolutePath: string;
+                contentUrl: string;
+            } | null;
+            safeRetry: boolean;
+            checkedAt: string | null;
+            integrityCheck: "PENDING" | "IDLE";
+            operationId: string;
+            localOutputId: string;
+            gatewayAssetId: string;
+        };
+        transfer?: {
+            temporaryName: string;
+            owner?: {
+                dev: string;
+                ino: string;
+                birthtimeMs: number;
+            } | undefined;
+            completed?: {
+                sha256: string;
+                byteLength: number;
+                mediaType: "image/png" | "image/jpeg" | "image/webp" | "video/mp4" | "video/webm";
+                relativePath: string;
+            } | undefined;
+        } | undefined;
+    }, {
+        assetId: string;
+        connectionId: string;
+        requestIds: string[];
+        receipt: {
+            error: {
+                code: string;
+                message: string;
+                type: string;
+                retryable: boolean;
+                mayAlreadyBeSaved: boolean | null;
+                httpStatus?: number | undefined;
+            } | null;
+            createdAt: string;
+            state: "ACCEPTED" | "SAVING" | "SAVED" | "FAILED" | "RECOVERY_REQUIRED" | "BLOCKED";
+            jobId: string;
+            updatedAt: string;
+            revision: number;
+            runId: string;
+            retryable: boolean;
+            mayAlreadyBeSaved: boolean | null;
+            stage: "QUEUED" | "DOWNLOADING" | "FILE_READY" | "REGISTERED" | "LINKED" | "RECONCILING";
+            attempt: number;
+            facts: {
+                file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+                registration: "ABSENT" | "UNKNOWN" | "PRESENT";
+                relation: "ABSENT" | "UNKNOWN" | "PRESENT";
+            };
+            asset: {
+                sha256: string;
+                byteLength: number;
+                assetId: string;
+                displayName: string;
+                mediaType: "image/png" | "image/jpeg" | "image/webp" | "video/mp4" | "video/webm";
+                relativePath: string;
+                absolutePath: string;
+                contentUrl: string;
+            } | null;
+            safeRetry: boolean;
+            checkedAt: string | null;
+            operationId: string;
+            localOutputId: string;
+            gatewayAssetId: string;
+            integrityCheck?: "PENDING" | "IDLE" | undefined;
+        };
+        executionRevision?: number | undefined;
+        transfer?: {
+            temporaryName: string;
+            owner?: {
+                dev: string;
+                ino: string;
+                birthtimeMs: number;
+            } | undefined;
+            completed?: {
+                sha256: string;
+                byteLength: number;
+                mediaType: "image/png" | "image/jpeg" | "image/webp" | "video/mp4" | "video/webm";
+                relativePath: string;
+            } | undefined;
+        } | undefined;
+    }>, {
+        assetId: string;
+        connectionId: string;
+        requestIds: string[];
+        executionRevision: number;
+        receipt: {
+            error: {
+                code: string;
+                message: string;
+                type: string;
+                retryable: boolean;
+                mayAlreadyBeSaved: boolean | null;
+                httpStatus?: number | undefined;
+            } | null;
+            createdAt: string;
+            state: "ACCEPTED" | "SAVING" | "SAVED" | "FAILED" | "RECOVERY_REQUIRED" | "BLOCKED";
+            jobId: string;
+            updatedAt: string;
+            revision: number;
+            runId: string;
+            retryable: boolean;
+            mayAlreadyBeSaved: boolean | null;
+            stage: "QUEUED" | "DOWNLOADING" | "FILE_READY" | "REGISTERED" | "LINKED" | "RECONCILING";
+            attempt: number;
+            facts: {
+                file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+                registration: "ABSENT" | "UNKNOWN" | "PRESENT";
+                relation: "ABSENT" | "UNKNOWN" | "PRESENT";
+            };
+            asset: {
+                sha256: string;
+                byteLength: number;
+                assetId: string;
+                displayName: string;
+                mediaType: "image/png" | "image/jpeg" | "image/webp" | "video/mp4" | "video/webm";
+                relativePath: string;
+                absolutePath: string;
+                contentUrl: string;
+            } | null;
+            safeRetry: boolean;
+            checkedAt: string | null;
+            integrityCheck: "PENDING" | "IDLE";
+            operationId: string;
+            localOutputId: string;
+            gatewayAssetId: string;
+        };
+        transfer?: {
+            temporaryName: string;
+            owner?: {
+                dev: string;
+                ino: string;
+                birthtimeMs: number;
+            } | undefined;
+            completed?: {
+                sha256: string;
+                byteLength: number;
+                mediaType: "image/png" | "image/jpeg" | "image/webp" | "video/mp4" | "video/webm";
+                relativePath: string;
+            } | undefined;
+        } | undefined;
+    }, {
+        assetId: string;
+        connectionId: string;
+        requestIds: string[];
+        receipt: {
+            error: {
+                code: string;
+                message: string;
+                type: string;
+                retryable: boolean;
+                mayAlreadyBeSaved: boolean | null;
+                httpStatus?: number | undefined;
+            } | null;
+            createdAt: string;
+            state: "ACCEPTED" | "SAVING" | "SAVED" | "FAILED" | "RECOVERY_REQUIRED" | "BLOCKED";
+            jobId: string;
+            updatedAt: string;
+            revision: number;
+            runId: string;
+            retryable: boolean;
+            mayAlreadyBeSaved: boolean | null;
+            stage: "QUEUED" | "DOWNLOADING" | "FILE_READY" | "REGISTERED" | "LINKED" | "RECONCILING";
+            attempt: number;
+            facts: {
+                file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+                registration: "ABSENT" | "UNKNOWN" | "PRESENT";
+                relation: "ABSENT" | "UNKNOWN" | "PRESENT";
+            };
+            asset: {
+                sha256: string;
+                byteLength: number;
+                assetId: string;
+                displayName: string;
+                mediaType: "image/png" | "image/jpeg" | "image/webp" | "video/mp4" | "video/webm";
+                relativePath: string;
+                absolutePath: string;
+                contentUrl: string;
+            } | null;
+            safeRetry: boolean;
+            checkedAt: string | null;
+            operationId: string;
+            localOutputId: string;
+            gatewayAssetId: string;
+            integrityCheck?: "PENDING" | "IDLE" | undefined;
+        };
+        executionRevision?: number | undefined;
+        transfer?: {
+            temporaryName: string;
+            owner?: {
+                dev: string;
+                ino: string;
+                birthtimeMs: number;
+            } | undefined;
+            completed?: {
+                sha256: string;
+                byteLength: number;
+                mediaType: "image/png" | "image/jpeg" | "image/webp" | "video/mp4" | "video/webm";
+                relativePath: string;
+            } | undefined;
+        } | undefined;
+    }>, "many">;
+    integrityObservations: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        assetId: z.ZodString;
+        revision: z.ZodNumber;
+    } & {
+        file: z.ZodEnum<["NOT_CHECKED", "ABSENT", "PARTIAL", "VERIFIED", "MISSING", "MODIFIED", "UNSAFE", "UNKNOWN"]>;
+        checkedAt: z.ZodNullable<z.ZodString>;
+        integrityCheck: z.ZodEnum<["IDLE", "PENDING"]>;
+        signature: z.ZodOptional<z.ZodString>;
+        errorCode: z.ZodOptional<z.ZodEnum<["SAVE_FILE_MISSING", "SAVE_FILE_MODIFIED", "SAVE_FILE_UNSAFE", "SAVE_FILE_READ_FAILED"]>>;
+    }, "strict", z.ZodTypeAny, {
+        assetId: string;
+        revision: number;
+        file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+        checkedAt: string | null;
+        integrityCheck: "PENDING" | "IDLE";
+        signature?: string | undefined;
+        errorCode?: "SAVE_FILE_MISSING" | "SAVE_FILE_MODIFIED" | "SAVE_FILE_UNSAFE" | "SAVE_FILE_READ_FAILED" | undefined;
+    }, {
+        assetId: string;
+        revision: number;
+        file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+        checkedAt: string | null;
+        integrityCheck: "PENDING" | "IDLE";
+        signature?: string | undefined;
+        errorCode?: "SAVE_FILE_MISSING" | "SAVE_FILE_MODIFIED" | "SAVE_FILE_UNSAFE" | "SAVE_FILE_READ_FAILED" | undefined;
+    }>, {
+        assetId: string;
+        revision: number;
+        file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+        checkedAt: string | null;
+        integrityCheck: "PENDING" | "IDLE";
+        signature?: string | undefined;
+        errorCode?: "SAVE_FILE_MISSING" | "SAVE_FILE_MODIFIED" | "SAVE_FILE_UNSAFE" | "SAVE_FILE_READ_FAILED" | undefined;
+    }, {
+        assetId: string;
+        revision: number;
+        file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+        checkedAt: string | null;
+        integrityCheck: "PENDING" | "IDLE";
+        signature?: string | undefined;
+        errorCode?: "SAVE_FILE_MISSING" | "SAVE_FILE_MODIFIED" | "SAVE_FILE_UNSAFE" | "SAVE_FILE_READ_FAILED" | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    schemaVersion: 2;
+    revision: number;
+    rootId: string;
+    canonicalAssetsPath: string;
+    connections: {
+        connectionId: string;
+        bindingDigestRef: string;
+    }[];
+    operations: {
+        assetId: string;
+        connectionId: string;
+        requestIds: string[];
+        executionRevision: number;
+        receipt: {
+            error: {
+                code: string;
+                message: string;
+                type: string;
+                retryable: boolean;
+                mayAlreadyBeSaved: boolean | null;
+                httpStatus?: number | undefined;
+            } | null;
+            createdAt: string;
+            state: "ACCEPTED" | "SAVING" | "SAVED" | "FAILED" | "RECOVERY_REQUIRED" | "BLOCKED";
+            jobId: string;
+            updatedAt: string;
+            revision: number;
+            runId: string;
+            retryable: boolean;
+            mayAlreadyBeSaved: boolean | null;
+            stage: "QUEUED" | "DOWNLOADING" | "FILE_READY" | "REGISTERED" | "LINKED" | "RECONCILING";
+            attempt: number;
+            facts: {
+                file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+                registration: "ABSENT" | "UNKNOWN" | "PRESENT";
+                relation: "ABSENT" | "UNKNOWN" | "PRESENT";
+            };
+            asset: {
+                sha256: string;
+                byteLength: number;
+                assetId: string;
+                displayName: string;
+                mediaType: "image/png" | "image/jpeg" | "image/webp" | "video/mp4" | "video/webm";
+                relativePath: string;
+                absolutePath: string;
+                contentUrl: string;
+            } | null;
+            safeRetry: boolean;
+            checkedAt: string | null;
+            integrityCheck: "PENDING" | "IDLE";
+            operationId: string;
+            localOutputId: string;
+            gatewayAssetId: string;
+        };
+        transfer?: {
+            temporaryName: string;
+            owner?: {
+                dev: string;
+                ino: string;
+                birthtimeMs: number;
+            } | undefined;
+            completed?: {
+                sha256: string;
+                byteLength: number;
+                mediaType: "image/png" | "image/jpeg" | "image/webp" | "video/mp4" | "video/webm";
+                relativePath: string;
+            } | undefined;
+        } | undefined;
+    }[];
+    integrityObservations: {
+        assetId: string;
+        revision: number;
+        file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+        checkedAt: string | null;
+        integrityCheck: "PENDING" | "IDLE";
+        signature?: string | undefined;
+        errorCode?: "SAVE_FILE_MISSING" | "SAVE_FILE_MODIFIED" | "SAVE_FILE_UNSAFE" | "SAVE_FILE_READ_FAILED" | undefined;
+    }[];
+}, {
+    schemaVersion: 2;
+    revision: number;
+    rootId: string;
+    canonicalAssetsPath: string;
+    connections: {
+        connectionId: string;
+        bindingDigestRef: string;
+    }[];
+    operations: {
+        assetId: string;
+        connectionId: string;
+        requestIds: string[];
+        receipt: {
+            error: {
+                code: string;
+                message: string;
+                type: string;
+                retryable: boolean;
+                mayAlreadyBeSaved: boolean | null;
+                httpStatus?: number | undefined;
+            } | null;
+            createdAt: string;
+            state: "ACCEPTED" | "SAVING" | "SAVED" | "FAILED" | "RECOVERY_REQUIRED" | "BLOCKED";
+            jobId: string;
+            updatedAt: string;
+            revision: number;
+            runId: string;
+            retryable: boolean;
+            mayAlreadyBeSaved: boolean | null;
+            stage: "QUEUED" | "DOWNLOADING" | "FILE_READY" | "REGISTERED" | "LINKED" | "RECONCILING";
+            attempt: number;
+            facts: {
+                file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+                registration: "ABSENT" | "UNKNOWN" | "PRESENT";
+                relation: "ABSENT" | "UNKNOWN" | "PRESENT";
+            };
+            asset: {
+                sha256: string;
+                byteLength: number;
+                assetId: string;
+                displayName: string;
+                mediaType: "image/png" | "image/jpeg" | "image/webp" | "video/mp4" | "video/webm";
+                relativePath: string;
+                absolutePath: string;
+                contentUrl: string;
+            } | null;
+            safeRetry: boolean;
+            checkedAt: string | null;
+            operationId: string;
+            localOutputId: string;
+            gatewayAssetId: string;
+            integrityCheck?: "PENDING" | "IDLE" | undefined;
+        };
+        executionRevision?: number | undefined;
+        transfer?: {
+            temporaryName: string;
+            owner?: {
+                dev: string;
+                ino: string;
+                birthtimeMs: number;
+            } | undefined;
+            completed?: {
+                sha256: string;
+                byteLength: number;
+                mediaType: "image/png" | "image/jpeg" | "image/webp" | "video/mp4" | "video/webm";
+                relativePath: string;
+            } | undefined;
+        } | undefined;
+    }[];
+    integrityObservations: {
+        assetId: string;
+        revision: number;
+        file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+        checkedAt: string | null;
+        integrityCheck: "PENDING" | "IDLE";
+        signature?: string | undefined;
+        errorCode?: "SAVE_FILE_MISSING" | "SAVE_FILE_MODIFIED" | "SAVE_FILE_UNSAFE" | "SAVE_FILE_READ_FAILED" | undefined;
+    }[];
+}>, {
+    schemaVersion: 2;
+    revision: number;
+    rootId: string;
+    canonicalAssetsPath: string;
+    connections: {
+        connectionId: string;
+        bindingDigestRef: string;
+    }[];
+    operations: {
+        assetId: string;
+        connectionId: string;
+        requestIds: string[];
+        executionRevision: number;
+        receipt: {
+            error: {
+                code: string;
+                message: string;
+                type: string;
+                retryable: boolean;
+                mayAlreadyBeSaved: boolean | null;
+                httpStatus?: number | undefined;
+            } | null;
+            createdAt: string;
+            state: "ACCEPTED" | "SAVING" | "SAVED" | "FAILED" | "RECOVERY_REQUIRED" | "BLOCKED";
+            jobId: string;
+            updatedAt: string;
+            revision: number;
+            runId: string;
+            retryable: boolean;
+            mayAlreadyBeSaved: boolean | null;
+            stage: "QUEUED" | "DOWNLOADING" | "FILE_READY" | "REGISTERED" | "LINKED" | "RECONCILING";
+            attempt: number;
+            facts: {
+                file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+                registration: "ABSENT" | "UNKNOWN" | "PRESENT";
+                relation: "ABSENT" | "UNKNOWN" | "PRESENT";
+            };
+            asset: {
+                sha256: string;
+                byteLength: number;
+                assetId: string;
+                displayName: string;
+                mediaType: "image/png" | "image/jpeg" | "image/webp" | "video/mp4" | "video/webm";
+                relativePath: string;
+                absolutePath: string;
+                contentUrl: string;
+            } | null;
+            safeRetry: boolean;
+            checkedAt: string | null;
+            integrityCheck: "PENDING" | "IDLE";
+            operationId: string;
+            localOutputId: string;
+            gatewayAssetId: string;
+        };
+        transfer?: {
+            temporaryName: string;
+            owner?: {
+                dev: string;
+                ino: string;
+                birthtimeMs: number;
+            } | undefined;
+            completed?: {
+                sha256: string;
+                byteLength: number;
+                mediaType: "image/png" | "image/jpeg" | "image/webp" | "video/mp4" | "video/webm";
+                relativePath: string;
+            } | undefined;
+        } | undefined;
+    }[];
+    integrityObservations: {
+        assetId: string;
+        revision: number;
+        file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+        checkedAt: string | null;
+        integrityCheck: "PENDING" | "IDLE";
+        signature?: string | undefined;
+        errorCode?: "SAVE_FILE_MISSING" | "SAVE_FILE_MODIFIED" | "SAVE_FILE_UNSAFE" | "SAVE_FILE_READ_FAILED" | undefined;
+    }[];
+}, {
+    schemaVersion: 2;
+    revision: number;
+    rootId: string;
+    canonicalAssetsPath: string;
+    connections: {
+        connectionId: string;
+        bindingDigestRef: string;
+    }[];
+    operations: {
+        assetId: string;
+        connectionId: string;
+        requestIds: string[];
+        receipt: {
+            error: {
+                code: string;
+                message: string;
+                type: string;
+                retryable: boolean;
+                mayAlreadyBeSaved: boolean | null;
+                httpStatus?: number | undefined;
+            } | null;
+            createdAt: string;
+            state: "ACCEPTED" | "SAVING" | "SAVED" | "FAILED" | "RECOVERY_REQUIRED" | "BLOCKED";
+            jobId: string;
+            updatedAt: string;
+            revision: number;
+            runId: string;
+            retryable: boolean;
+            mayAlreadyBeSaved: boolean | null;
+            stage: "QUEUED" | "DOWNLOADING" | "FILE_READY" | "REGISTERED" | "LINKED" | "RECONCILING";
+            attempt: number;
+            facts: {
+                file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+                registration: "ABSENT" | "UNKNOWN" | "PRESENT";
+                relation: "ABSENT" | "UNKNOWN" | "PRESENT";
+            };
+            asset: {
+                sha256: string;
+                byteLength: number;
+                assetId: string;
+                displayName: string;
+                mediaType: "image/png" | "image/jpeg" | "image/webp" | "video/mp4" | "video/webm";
+                relativePath: string;
+                absolutePath: string;
+                contentUrl: string;
+            } | null;
+            safeRetry: boolean;
+            checkedAt: string | null;
+            operationId: string;
+            localOutputId: string;
+            gatewayAssetId: string;
+            integrityCheck?: "PENDING" | "IDLE" | undefined;
+        };
+        executionRevision?: number | undefined;
+        transfer?: {
+            temporaryName: string;
+            owner?: {
+                dev: string;
+                ino: string;
+                birthtimeMs: number;
+            } | undefined;
+            completed?: {
+                sha256: string;
+                byteLength: number;
+                mediaType: "image/png" | "image/jpeg" | "image/webp" | "video/mp4" | "video/webm";
+                relativePath: string;
+            } | undefined;
+        } | undefined;
+    }[];
+    integrityObservations: {
+        assetId: string;
+        revision: number;
+        file: "MISSING" | "NOT_CHECKED" | "ABSENT" | "PARTIAL" | "UNSAFE" | "UNKNOWN" | "VERIFIED" | "MODIFIED";
+        checkedAt: string | null;
+        integrityCheck: "PENDING" | "IDLE";
+        signature?: string | undefined;
+        errorCode?: "SAVE_FILE_MISSING" | "SAVE_FILE_MODIFIED" | "SAVE_FILE_UNSAFE" | "SAVE_FILE_READ_FAILED" | undefined;
+    }[];
+}>;
+export type SaveAuthoritySnapshot = z.infer<typeof schema>;
+export interface StudioSaveAuthority {
+    read(): Promise<SaveAuthoritySnapshot>;
+    readIntegrity(): Promise<SaveAuthoritySnapshot | undefined>;
+    observeIntegrity(assetId: string, expectedRevision: number, value: IntegrityObservationValue, proof?: unknown): Promise<IntegrityObservation>;
+    bind(bindingDigestRef: string): Promise<SaveAuthoritySnapshot>;
+    accept(input: SaveAcceptInput): Promise<SaveOperation>;
+    update(operationId: string, connectionId: string, expectedRevision: number, patch: SaveUpdate, transfer?: SaveTransfer): Promise<SaveOperation>;
+    advanceWorker(expected: SaveOperation, patch: SaveUpdate, transfer?: SaveTransfer): Promise<SaveOperation>;
+}
+/** Internal control flow, never a business failure or a new public error code. */
+export declare class SaveIntegrityPending extends StudioError {
+    constructor();
+}
+/** Private authority; the asset-store owns the sole writer and shared lifecycle queue. */
+export declare function createSaveAuthority(root: StudioRoot, serial: <T>(fn: () => Promise<T>) => Promise<T>, hooks?: {
+    beforeCommit?(): void | Promise<void>;
+}): StudioSaveAuthority;
+export {};
+//# sourceMappingURL=output-save-journal.d.ts.map