@claudexor/schema 5.0.2 → 6.0.0

package/dist/thread-export.d.ts

@@ -0,0 +1,847 @@
+/**
+ * Exact thread export and conditional retirement. One schema-defined producer
+ * (the engine) and the in-repo `claudexor thread export|retire` consumer; a
+ * host that keeps the bundle speaks the same contract. Catalog presence of
+ * `POST /v2/threads/:id/retire` is the feature marker (INV-138).
+ */
+import { z } from "zod/v3";
+export declare const THREAD_EXPORT_SCHEMA_VERSION = 1;
+/** Every reason a closure is held back. Any gap makes the export partial and
+ * forbids retirement; an unknown state never becomes an empty success. */
+export declare const ThreadExportGapCode: z.ZodEnum<["closure_not_quiescent", "closure_awaiting_decision", "closure_partition_unavailable", "command_record_not_retained", "run_directory_missing", "run_files_expired", "run_tree_unreadable", "run_observations_unreadable", "attachment_unavailable", "native_session_unattributed", "native_session_unsupported", "native_format_unqualified", "native_session_missing", "native_session_unreadable", "native_projection_failed", "lane_unreadable", "lane_credentials_undeclared", "isolated_worktree_present"]>;
+export type ThreadExportGapCode = z.infer<typeof ThreadExportGapCode>;
+export declare const ThreadExportGap: z.ZodObject<{
+    code: z.ZodEnum<["closure_not_quiescent", "closure_awaiting_decision", "closure_partition_unavailable", "command_record_not_retained", "run_directory_missing", "run_files_expired", "run_tree_unreadable", "run_observations_unreadable", "attachment_unavailable", "native_session_unattributed", "native_session_unsupported", "native_format_unqualified", "native_session_missing", "native_session_unreadable", "native_projection_failed", "lane_unreadable", "lane_credentials_undeclared", "isolated_worktree_present"]>;
+    subject: z.ZodString;
+    message: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    code: "attachment_unavailable" | "closure_awaiting_decision" | "closure_not_quiescent" | "closure_partition_unavailable" | "command_record_not_retained" | "isolated_worktree_present" | "lane_credentials_undeclared" | "lane_unreadable" | "native_format_unqualified" | "native_projection_failed" | "native_session_missing" | "native_session_unattributed" | "native_session_unreadable" | "native_session_unsupported" | "run_directory_missing" | "run_files_expired" | "run_observations_unreadable" | "run_tree_unreadable";
+    subject: string;
+    message: string;
+}, {
+    code: "attachment_unavailable" | "closure_awaiting_decision" | "closure_not_quiescent" | "closure_partition_unavailable" | "command_record_not_retained" | "isolated_worktree_present" | "lane_credentials_undeclared" | "lane_unreadable" | "native_format_unqualified" | "native_projection_failed" | "native_session_missing" | "native_session_unattributed" | "native_session_unreadable" | "native_session_unsupported" | "run_directory_missing" | "run_files_expired" | "run_observations_unreadable" | "run_tree_unreadable";
+    subject: string;
+    message: string;
+}>;
+export type ThreadExportGap = z.infer<typeof ThreadExportGap>;
+export declare const ThreadExportItemPlane: z.ZodEnum<["sql", "run", "native", "lane", "resource", "projection"]>;
+export type ThreadExportItemPlane = z.infer<typeof ThreadExportItemPlane>;
+export declare const ThreadExportItemKind: z.ZodEnum<["file", "symlink", "special", "credential_store"]>;
+export type ThreadExportItemKind = z.infer<typeof ThreadExportItemKind>;
+export declare const ThreadExportItem: z.ZodObject<{
+    itemId: z.ZodString;
+    plane: z.ZodEnum<["sql", "run", "native", "lane", "resource", "projection"]>;
+    path: z.ZodString;
+    kind: z.ZodEnum<["file", "symlink", "special", "credential_store"]>;
+    sizeBytes: z.ZodNullable<z.ZodNumber>;
+    mtimeMs: z.ZodNullable<z.ZodNumber>;
+    sha256: z.ZodNullable<z.ZodString>;
+    projectionOf: z.ZodNullable<z.ZodString>;
+    linkTarget: z.ZodNullable<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    itemId: string;
+    plane: "lane" | "native" | "projection" | "resource" | "run" | "sql";
+    path: string;
+    kind: "credential_store" | "file" | "special" | "symlink";
+    sizeBytes: number | null;
+    mtimeMs: number | null;
+    sha256: string | null;
+    projectionOf: string | null;
+    linkTarget: string | null;
+}, {
+    itemId: string;
+    plane: "lane" | "native" | "projection" | "resource" | "run" | "sql";
+    path: string;
+    kind: "credential_store" | "file" | "special" | "symlink";
+    sizeBytes: number | null;
+    mtimeMs: number | null;
+    sha256: string | null;
+    projectionOf: string | null;
+    linkTarget: string | null;
+}>;
+export type ThreadExportItem = z.infer<typeof ThreadExportItem>;
+export declare const ThreadExportSessionSource: z.ZodEnum<["attempt_event", "run_event", "reviewer_stream", "session_capsule", "run_resumable", "thread_session"]>;
+export declare const ThreadExportSession: z.ZodObject<{
+    harness: z.ZodString;
+    nativeSessionId: z.ZodString;
+    status: z.ZodEnum<["exported", "missing", "unsupported", "unqualified", "unreadable"]>;
+    provenance: z.ZodArray<z.ZodObject<{
+        source: z.ZodEnum<["attempt_event", "run_event", "reviewer_stream", "session_capsule", "run_resumable", "thread_session"]>;
+        runId: z.ZodNullable<z.ZodString>;
+        attemptId: z.ZodNullable<z.ZodString>;
+        profileId: z.ZodNullable<z.ZodString>;
+        cwd: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        source: "attempt_event" | "reviewer_stream" | "run_event" | "run_resumable" | "session_capsule" | "thread_session";
+        runId: string | null;
+        attemptId: string | null;
+        profileId: string | null;
+        cwd: string | null;
+    }, {
+        source: "attempt_event" | "reviewer_stream" | "run_event" | "run_resumable" | "session_capsule" | "thread_session";
+        runId: string | null;
+        attemptId: string | null;
+        profileId: string | null;
+        cwd: string | null;
+    }>, "many">;
+    copies: z.ZodArray<z.ZodObject<{
+        storeKey: z.ZodString;
+        profileId: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        storeKey: string;
+        profileId: string | null;
+    }, {
+        storeKey: string;
+        profileId: string | null;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    harness: string;
+    nativeSessionId: string;
+    status: "exported" | "missing" | "unqualified" | "unreadable" | "unsupported";
+    provenance: {
+        source: "attempt_event" | "reviewer_stream" | "run_event" | "run_resumable" | "session_capsule" | "thread_session";
+        runId: string | null;
+        attemptId: string | null;
+        profileId: string | null;
+        cwd: string | null;
+    }[];
+    copies: {
+        storeKey: string;
+        profileId: string | null;
+    }[];
+}, {
+    harness: string;
+    nativeSessionId: string;
+    status: "exported" | "missing" | "unqualified" | "unreadable" | "unsupported";
+    provenance: {
+        source: "attempt_event" | "reviewer_stream" | "run_event" | "run_resumable" | "session_capsule" | "thread_session";
+        runId: string | null;
+        attemptId: string | null;
+        profileId: string | null;
+        cwd: string | null;
+    }[];
+    copies: {
+        storeKey: string;
+        profileId: string | null;
+    }[];
+}>;
+export type ThreadExportSession = z.infer<typeof ThreadExportSession>;
+export declare const ThreadExportManifest: z.ZodEffects<z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    storeId: z.ZodString;
+    threadId: z.ZodString;
+    exportId: z.ZodString;
+    closureDigest: z.ZodString;
+    threadState: z.ZodEnum<["active", "closed", "trashed", "purged"]>;
+    headRevision: z.ZodNumber;
+    workspaceMode: z.ZodEnum<["in_place", "isolated", "delegated"]>;
+    coverage: z.ZodEnum<["complete", "partial"]>;
+    retirable: z.ZodBoolean;
+    gaps: z.ZodArray<z.ZodObject<{
+        code: z.ZodEnum<["closure_not_quiescent", "closure_awaiting_decision", "closure_partition_unavailable", "command_record_not_retained", "run_directory_missing", "run_files_expired", "run_tree_unreadable", "run_observations_unreadable", "attachment_unavailable", "native_session_unattributed", "native_session_unsupported", "native_format_unqualified", "native_session_missing", "native_session_unreadable", "native_projection_failed", "lane_unreadable", "lane_credentials_undeclared", "isolated_worktree_present"]>;
+        subject: z.ZodString;
+        message: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        code: "attachment_unavailable" | "closure_awaiting_decision" | "closure_not_quiescent" | "closure_partition_unavailable" | "command_record_not_retained" | "isolated_worktree_present" | "lane_credentials_undeclared" | "lane_unreadable" | "native_format_unqualified" | "native_projection_failed" | "native_session_missing" | "native_session_unattributed" | "native_session_unreadable" | "native_session_unsupported" | "run_directory_missing" | "run_files_expired" | "run_observations_unreadable" | "run_tree_unreadable";
+        subject: string;
+        message: string;
+    }, {
+        code: "attachment_unavailable" | "closure_awaiting_decision" | "closure_not_quiescent" | "closure_partition_unavailable" | "command_record_not_retained" | "isolated_worktree_present" | "lane_credentials_undeclared" | "lane_unreadable" | "native_format_unqualified" | "native_projection_failed" | "native_session_missing" | "native_session_unattributed" | "native_session_unreadable" | "native_session_unsupported" | "run_directory_missing" | "run_files_expired" | "run_observations_unreadable" | "run_tree_unreadable";
+        subject: string;
+        message: string;
+    }>, "many">;
+    disclosures: z.ZodArray<z.ZodObject<{
+        harness: z.ZodString;
+        source: z.ZodString;
+        reason: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        harness: string;
+        source: string;
+        reason: string;
+    }, {
+        harness: string;
+        source: string;
+        reason: string;
+    }>, "many">;
+    closure: z.ZodObject<{
+        turns: z.ZodArray<z.ZodObject<{
+            turnId: z.ZodString;
+            ordinal: z.ZodNumber;
+            runId: z.ZodNullable<z.ZodString>;
+            promptSha256: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            turnId: string;
+            ordinal: number;
+            runId: string | null;
+            promptSha256: string;
+        }, {
+            turnId: string;
+            ordinal: number;
+            runId: string | null;
+            promptSha256: string;
+        }>, "many">;
+        runs: z.ZodArray<z.ZodObject<{
+            jobId: z.ZodString;
+            runId: z.ZodNullable<z.ZodString>;
+            state: z.ZodString;
+            kind: z.ZodString;
+            threadId: z.ZodNullable<z.ZodString>;
+            turnId: z.ZodNullable<z.ZodString>;
+            continueFrom: z.ZodNullable<z.ZodString>;
+            delegatedFrom: z.ZodNullable<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            jobId: string;
+            runId: string | null;
+            state: string;
+            kind: string;
+            threadId: string | null;
+            turnId: string | null;
+            continueFrom: string | null;
+            delegatedFrom: string | null;
+        }, {
+            jobId: string;
+            runId: string | null;
+            state: string;
+            kind: string;
+            threadId: string | null;
+            turnId: string | null;
+            continueFrom: string | null;
+            delegatedFrom: string | null;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        turns: {
+            turnId: string;
+            ordinal: number;
+            runId: string | null;
+            promptSha256: string;
+        }[];
+        runs: {
+            jobId: string;
+            runId: string | null;
+            state: string;
+            kind: string;
+            threadId: string | null;
+            turnId: string | null;
+            continueFrom: string | null;
+            delegatedFrom: string | null;
+        }[];
+    }, {
+        turns: {
+            turnId: string;
+            ordinal: number;
+            runId: string | null;
+            promptSha256: string;
+        }[];
+        runs: {
+            jobId: string;
+            runId: string | null;
+            state: string;
+            kind: string;
+            threadId: string | null;
+            turnId: string | null;
+            continueFrom: string | null;
+            delegatedFrom: string | null;
+        }[];
+    }>;
+    sessions: z.ZodArray<z.ZodObject<{
+        harness: z.ZodString;
+        nativeSessionId: z.ZodString;
+        status: z.ZodEnum<["exported", "missing", "unsupported", "unqualified", "unreadable"]>;
+        provenance: z.ZodArray<z.ZodObject<{
+            source: z.ZodEnum<["attempt_event", "run_event", "reviewer_stream", "session_capsule", "run_resumable", "thread_session"]>;
+            runId: z.ZodNullable<z.ZodString>;
+            attemptId: z.ZodNullable<z.ZodString>;
+            profileId: z.ZodNullable<z.ZodString>;
+            cwd: z.ZodNullable<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            source: "attempt_event" | "reviewer_stream" | "run_event" | "run_resumable" | "session_capsule" | "thread_session";
+            runId: string | null;
+            attemptId: string | null;
+            profileId: string | null;
+            cwd: string | null;
+        }, {
+            source: "attempt_event" | "reviewer_stream" | "run_event" | "run_resumable" | "session_capsule" | "thread_session";
+            runId: string | null;
+            attemptId: string | null;
+            profileId: string | null;
+            cwd: string | null;
+        }>, "many">;
+        copies: z.ZodArray<z.ZodObject<{
+            storeKey: z.ZodString;
+            profileId: z.ZodNullable<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            storeKey: string;
+            profileId: string | null;
+        }, {
+            storeKey: string;
+            profileId: string | null;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        harness: string;
+        nativeSessionId: string;
+        status: "exported" | "missing" | "unqualified" | "unreadable" | "unsupported";
+        provenance: {
+            source: "attempt_event" | "reviewer_stream" | "run_event" | "run_resumable" | "session_capsule" | "thread_session";
+            runId: string | null;
+            attemptId: string | null;
+            profileId: string | null;
+            cwd: string | null;
+        }[];
+        copies: {
+            storeKey: string;
+            profileId: string | null;
+        }[];
+    }, {
+        harness: string;
+        nativeSessionId: string;
+        status: "exported" | "missing" | "unqualified" | "unreadable" | "unsupported";
+        provenance: {
+            source: "attempt_event" | "reviewer_stream" | "run_event" | "run_resumable" | "session_capsule" | "thread_session";
+            runId: string | null;
+            attemptId: string | null;
+            profileId: string | null;
+            cwd: string | null;
+        }[];
+        copies: {
+            storeKey: string;
+            profileId: string | null;
+        }[];
+    }>, "many">;
+    items: z.ZodArray<z.ZodObject<{
+        itemId: z.ZodString;
+        plane: z.ZodEnum<["sql", "run", "native", "lane", "resource", "projection"]>;
+        path: z.ZodString;
+        kind: z.ZodEnum<["file", "symlink", "special", "credential_store"]>;
+        sizeBytes: z.ZodNullable<z.ZodNumber>;
+        mtimeMs: z.ZodNullable<z.ZodNumber>;
+        sha256: z.ZodNullable<z.ZodString>;
+        projectionOf: z.ZodNullable<z.ZodString>;
+        linkTarget: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        itemId: string;
+        plane: "lane" | "native" | "projection" | "resource" | "run" | "sql";
+        path: string;
+        kind: "credential_store" | "file" | "special" | "symlink";
+        sizeBytes: number | null;
+        mtimeMs: number | null;
+        sha256: string | null;
+        projectionOf: string | null;
+        linkTarget: string | null;
+    }, {
+        itemId: string;
+        plane: "lane" | "native" | "projection" | "resource" | "run" | "sql";
+        path: string;
+        kind: "credential_store" | "file" | "special" | "symlink";
+        sizeBytes: number | null;
+        mtimeMs: number | null;
+        sha256: string | null;
+        projectionOf: string | null;
+        linkTarget: string | null;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    schemaVersion: 1;
+    storeId: string;
+    threadId: string;
+    exportId: string;
+    closureDigest: string;
+    threadState: "active" | "closed" | "purged" | "trashed";
+    headRevision: number;
+    workspaceMode: "delegated" | "in_place" | "isolated";
+    coverage: "complete" | "partial";
+    retirable: boolean;
+    gaps: {
+        code: "attachment_unavailable" | "closure_awaiting_decision" | "closure_not_quiescent" | "closure_partition_unavailable" | "command_record_not_retained" | "isolated_worktree_present" | "lane_credentials_undeclared" | "lane_unreadable" | "native_format_unqualified" | "native_projection_failed" | "native_session_missing" | "native_session_unattributed" | "native_session_unreadable" | "native_session_unsupported" | "run_directory_missing" | "run_files_expired" | "run_observations_unreadable" | "run_tree_unreadable";
+        subject: string;
+        message: string;
+    }[];
+    disclosures: {
+        harness: string;
+        source: string;
+        reason: string;
+    }[];
+    closure: {
+        turns: {
+            turnId: string;
+            ordinal: number;
+            runId: string | null;
+            promptSha256: string;
+        }[];
+        runs: {
+            jobId: string;
+            runId: string | null;
+            state: string;
+            kind: string;
+            threadId: string | null;
+            turnId: string | null;
+            continueFrom: string | null;
+            delegatedFrom: string | null;
+        }[];
+    };
+    sessions: {
+        harness: string;
+        nativeSessionId: string;
+        status: "exported" | "missing" | "unqualified" | "unreadable" | "unsupported";
+        provenance: {
+            source: "attempt_event" | "reviewer_stream" | "run_event" | "run_resumable" | "session_capsule" | "thread_session";
+            runId: string | null;
+            attemptId: string | null;
+            profileId: string | null;
+            cwd: string | null;
+        }[];
+        copies: {
+            storeKey: string;
+            profileId: string | null;
+        }[];
+    }[];
+    items: {
+        itemId: string;
+        plane: "lane" | "native" | "projection" | "resource" | "run" | "sql";
+        path: string;
+        kind: "credential_store" | "file" | "special" | "symlink";
+        sizeBytes: number | null;
+        mtimeMs: number | null;
+        sha256: string | null;
+        projectionOf: string | null;
+        linkTarget: string | null;
+    }[];
+}, {
+    schemaVersion: 1;
+    storeId: string;
+    threadId: string;
+    exportId: string;
+    closureDigest: string;
+    threadState: "active" | "closed" | "purged" | "trashed";
+    headRevision: number;
+    workspaceMode: "delegated" | "in_place" | "isolated";
+    coverage: "complete" | "partial";
+    retirable: boolean;
+    gaps: {
+        code: "attachment_unavailable" | "closure_awaiting_decision" | "closure_not_quiescent" | "closure_partition_unavailable" | "command_record_not_retained" | "isolated_worktree_present" | "lane_credentials_undeclared" | "lane_unreadable" | "native_format_unqualified" | "native_projection_failed" | "native_session_missing" | "native_session_unattributed" | "native_session_unreadable" | "native_session_unsupported" | "run_directory_missing" | "run_files_expired" | "run_observations_unreadable" | "run_tree_unreadable";
+        subject: string;
+        message: string;
+    }[];
+    disclosures: {
+        harness: string;
+        source: string;
+        reason: string;
+    }[];
+    closure: {
+        turns: {
+            turnId: string;
+            ordinal: number;
+            runId: string | null;
+            promptSha256: string;
+        }[];
+        runs: {
+            jobId: string;
+            runId: string | null;
+            state: string;
+            kind: string;
+            threadId: string | null;
+            turnId: string | null;
+            continueFrom: string | null;
+            delegatedFrom: string | null;
+        }[];
+    };
+    sessions: {
+        harness: string;
+        nativeSessionId: string;
+        status: "exported" | "missing" | "unqualified" | "unreadable" | "unsupported";
+        provenance: {
+            source: "attempt_event" | "reviewer_stream" | "run_event" | "run_resumable" | "session_capsule" | "thread_session";
+            runId: string | null;
+            attemptId: string | null;
+            profileId: string | null;
+            cwd: string | null;
+        }[];
+        copies: {
+            storeKey: string;
+            profileId: string | null;
+        }[];
+    }[];
+    items: {
+        itemId: string;
+        plane: "lane" | "native" | "projection" | "resource" | "run" | "sql";
+        path: string;
+        kind: "credential_store" | "file" | "special" | "symlink";
+        sizeBytes: number | null;
+        mtimeMs: number | null;
+        sha256: string | null;
+        projectionOf: string | null;
+        linkTarget: string | null;
+    }[];
+}>, {
+    schemaVersion: 1;
+    storeId: string;
+    threadId: string;
+    exportId: string;
+    closureDigest: string;
+    threadState: "active" | "closed" | "purged" | "trashed";
+    headRevision: number;
+    workspaceMode: "delegated" | "in_place" | "isolated";
+    coverage: "complete" | "partial";
+    retirable: boolean;
+    gaps: {
+        code: "attachment_unavailable" | "closure_awaiting_decision" | "closure_not_quiescent" | "closure_partition_unavailable" | "command_record_not_retained" | "isolated_worktree_present" | "lane_credentials_undeclared" | "lane_unreadable" | "native_format_unqualified" | "native_projection_failed" | "native_session_missing" | "native_session_unattributed" | "native_session_unreadable" | "native_session_unsupported" | "run_directory_missing" | "run_files_expired" | "run_observations_unreadable" | "run_tree_unreadable";
+        subject: string;
+        message: string;
+    }[];
+    disclosures: {
+        harness: string;
+        source: string;
+        reason: string;
+    }[];
+    closure: {
+        turns: {
+            turnId: string;
+            ordinal: number;
+            runId: string | null;
+            promptSha256: string;
+        }[];
+        runs: {
+            jobId: string;
+            runId: string | null;
+            state: string;
+            kind: string;
+            threadId: string | null;
+            turnId: string | null;
+            continueFrom: string | null;
+            delegatedFrom: string | null;
+        }[];
+    };
+    sessions: {
+        harness: string;
+        nativeSessionId: string;
+        status: "exported" | "missing" | "unqualified" | "unreadable" | "unsupported";
+        provenance: {
+            source: "attempt_event" | "reviewer_stream" | "run_event" | "run_resumable" | "session_capsule" | "thread_session";
+            runId: string | null;
+            attemptId: string | null;
+            profileId: string | null;
+            cwd: string | null;
+        }[];
+        copies: {
+            storeKey: string;
+            profileId: string | null;
+        }[];
+    }[];
+    items: {
+        itemId: string;
+        plane: "lane" | "native" | "projection" | "resource" | "run" | "sql";
+        path: string;
+        kind: "credential_store" | "file" | "special" | "symlink";
+        sizeBytes: number | null;
+        mtimeMs: number | null;
+        sha256: string | null;
+        projectionOf: string | null;
+        linkTarget: string | null;
+    }[];
+}, {
+    schemaVersion: 1;
+    storeId: string;
+    threadId: string;
+    exportId: string;
+    closureDigest: string;
+    threadState: "active" | "closed" | "purged" | "trashed";
+    headRevision: number;
+    workspaceMode: "delegated" | "in_place" | "isolated";
+    coverage: "complete" | "partial";
+    retirable: boolean;
+    gaps: {
+        code: "attachment_unavailable" | "closure_awaiting_decision" | "closure_not_quiescent" | "closure_partition_unavailable" | "command_record_not_retained" | "isolated_worktree_present" | "lane_credentials_undeclared" | "lane_unreadable" | "native_format_unqualified" | "native_projection_failed" | "native_session_missing" | "native_session_unattributed" | "native_session_unreadable" | "native_session_unsupported" | "run_directory_missing" | "run_files_expired" | "run_observations_unreadable" | "run_tree_unreadable";
+        subject: string;
+        message: string;
+    }[];
+    disclosures: {
+        harness: string;
+        source: string;
+        reason: string;
+    }[];
+    closure: {
+        turns: {
+            turnId: string;
+            ordinal: number;
+            runId: string | null;
+            promptSha256: string;
+        }[];
+        runs: {
+            jobId: string;
+            runId: string | null;
+            state: string;
+            kind: string;
+            threadId: string | null;
+            turnId: string | null;
+            continueFrom: string | null;
+            delegatedFrom: string | null;
+        }[];
+    };
+    sessions: {
+        harness: string;
+        nativeSessionId: string;
+        status: "exported" | "missing" | "unqualified" | "unreadable" | "unsupported";
+        provenance: {
+            source: "attempt_event" | "reviewer_stream" | "run_event" | "run_resumable" | "session_capsule" | "thread_session";
+            runId: string | null;
+            attemptId: string | null;
+            profileId: string | null;
+            cwd: string | null;
+        }[];
+        copies: {
+            storeKey: string;
+            profileId: string | null;
+        }[];
+    }[];
+    items: {
+        itemId: string;
+        plane: "lane" | "native" | "projection" | "resource" | "run" | "sql";
+        path: string;
+        kind: "credential_store" | "file" | "special" | "symlink";
+        sizeBytes: number | null;
+        mtimeMs: number | null;
+        sha256: string | null;
+        projectionOf: string | null;
+        linkTarget: string | null;
+    }[];
+}>;
+export type ThreadExportManifest = z.infer<typeof ThreadExportManifest>;
+/** Written last by the consumer: what it received and verified, item by item. */
+export declare const ThreadExportReceipt: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    storeId: z.ZodString;
+    threadId: z.ZodString;
+    exportId: z.ZodString;
+    closureDigest: z.ZodString;
+    contentDigest: z.ZodString;
+    laneDigest: z.ZodString;
+    coverage: z.ZodEnum<["complete", "partial"]>;
+    retirable: z.ZodBoolean;
+    transferred: z.ZodArray<z.ZodObject<{
+        itemId: z.ZodString;
+        path: z.ZodString;
+        placedAt: z.ZodOptional<z.ZodString>;
+        sizeBytes: z.ZodNumber;
+        sha256: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        itemId: string;
+        path: string;
+        placedAt?: string | undefined;
+        sizeBytes: number;
+        sha256: string;
+    }, {
+        itemId: string;
+        path: string;
+        placedAt?: string | undefined;
+        sizeBytes: number;
+        sha256: string;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    schemaVersion: 1;
+    storeId: string;
+    threadId: string;
+    exportId: string;
+    closureDigest: string;
+    contentDigest: string;
+    laneDigest: string;
+    coverage: "complete" | "partial";
+    retirable: boolean;
+    transferred: {
+        itemId: string;
+        path: string;
+        placedAt?: string | undefined;
+        sizeBytes: number;
+        sha256: string;
+    }[];
+}, {
+    schemaVersion: 1;
+    storeId: string;
+    threadId: string;
+    exportId: string;
+    closureDigest: string;
+    contentDigest: string;
+    laneDigest: string;
+    coverage: "complete" | "partial";
+    retirable: boolean;
+    transferred: {
+        itemId: string;
+        path: string;
+        placedAt?: string | undefined;
+        sizeBytes: number;
+        sha256: string;
+    }[];
+}>;
+export type ThreadExportReceipt = z.infer<typeof ThreadExportReceipt>;
+export declare const ThreadRetireRequest: z.ZodObject<{
+    operationId: z.ZodString;
+    exportId: z.ZodString;
+    closureDigest: z.ZodString;
+    contentDigest: z.ZodString;
+    laneDigest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    operationId: string;
+    exportId: string;
+    closureDigest: string;
+    contentDigest: string;
+    laneDigest: string;
+}, {
+    operationId: string;
+    exportId: string;
+    closureDigest: string;
+    contentDigest: string;
+    laneDigest: string;
+}>;
+export type ThreadRetireRequest = z.infer<typeof ThreadRetireRequest>;
+export declare const ThreadRetireAbandonRequest: z.ZodObject<{
+    operationId: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    operationId: string;
+}, {
+    operationId: string;
+}>;
+export type ThreadRetireAbandonRequest = z.infer<typeof ThreadRetireAbandonRequest>;
+export declare const ThreadRetirementOperation: z.ZodObject<{
+    operationId: z.ZodString;
+    outcome: z.ZodEnum<["accepted", "refused", "abandoned"]>;
+    code: z.ZodNullable<z.ZodString>;
+    message: z.ZodNullable<z.ZodString>;
+    settledAt: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    operationId: string;
+    outcome: "abandoned" | "accepted" | "refused";
+    code: string | null;
+    message: string | null;
+    settledAt: string;
+}, {
+    operationId: string;
+    outcome: "abandoned" | "accepted" | "refused";
+    code: string | null;
+    message: string | null;
+    settledAt: string;
+}>;
+export type ThreadRetirementOperation = z.infer<typeof ThreadRetirementOperation>;
+export declare const ThreadRetirement: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    storeId: z.ZodString;
+    threadId: z.ZodString;
+    threadState: z.ZodEnum<["active", "closed", "trashed", "purged"]>;
+    status: z.ZodEnum<["not_accepted", "accepted_pending_removal", "removed"]>;
+    acceptance: z.ZodNullable<z.ZodObject<{
+        operationId: z.ZodString;
+        exportId: z.ZodString;
+        closureDigest: z.ZodString;
+        contentDigest: z.ZodString;
+        laneDigest: z.ZodString;
+        acceptedAt: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        operationId: string;
+        exportId: string;
+        closureDigest: string;
+        contentDigest: string;
+        laneDigest: string;
+        acceptedAt: string;
+    }, {
+        operationId: string;
+        exportId: string;
+        closureDigest: string;
+        contentDigest: string;
+        laneDigest: string;
+        acceptedAt: string;
+    }>>;
+    cleanup: z.ZodNullable<z.ZodObject<{
+        reason: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        reason: string | null;
+    }, {
+        reason: string | null;
+    }>>;
+    operation: z.ZodNullable<z.ZodObject<{
+        operationId: z.ZodString;
+        outcome: z.ZodEnum<["accepted", "refused", "abandoned"]>;
+        code: z.ZodNullable<z.ZodString>;
+        message: z.ZodNullable<z.ZodString>;
+        settledAt: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        operationId: string;
+        outcome: "abandoned" | "accepted" | "refused";
+        code: string | null;
+        message: string | null;
+        settledAt: string;
+    }, {
+        operationId: string;
+        outcome: "abandoned" | "accepted" | "refused";
+        code: string | null;
+        message: string | null;
+        settledAt: string;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    schemaVersion: 1;
+    storeId: string;
+    threadId: string;
+    threadState: "active" | "closed" | "purged" | "trashed";
+    status: "accepted_pending_removal" | "not_accepted" | "removed";
+    acceptance: {
+        operationId: string;
+        exportId: string;
+        closureDigest: string;
+        contentDigest: string;
+        laneDigest: string;
+        acceptedAt: string;
+    } | null;
+    cleanup: {
+        reason: string | null;
+    } | null;
+    operation: {
+        operationId: string;
+        outcome: "abandoned" | "accepted" | "refused";
+        code: string | null;
+        message: string | null;
+        settledAt: string;
+    } | null;
+}, {
+    schemaVersion: 1;
+    storeId: string;
+    threadId: string;
+    threadState: "active" | "closed" | "purged" | "trashed";
+    status: "accepted_pending_removal" | "not_accepted" | "removed";
+    acceptance: {
+        operationId: string;
+        exportId: string;
+        closureDigest: string;
+        contentDigest: string;
+        laneDigest: string;
+        acceptedAt: string;
+    } | null;
+    cleanup: {
+        reason: string | null;
+    } | null;
+    operation: {
+        operationId: string;
+        outcome: "abandoned" | "accepted" | "refused";
+        code: string | null;
+        message: string | null;
+        settledAt: string;
+    } | null;
+}>;
+export type ThreadRetirement = z.infer<typeof ThreadRetirement>;
+/** One item's exact identity in a digest: what a consumer received, or what the
+ * engine read from disk. Acceptance keeps the lane's entries so its cleanup can
+ * delete only bytes the export holds. */
+export interface ThreadExportDigestEntry {
+    itemId: string;
+    sha256: string;
+    sizeBytes: number;
+}
+/** Stable across reads of the same inventory, so a resumed transfer keeps its work. */
+export declare function threadExportItemId(plane: ThreadExportItemPlane, path: string): string;
+/**
+ * The one digest formula: `<itemId> <sha256 hex> <size>\n` per file or symlink,
+ * ordered by itemId bytes, hashed as UTF-8. A consumer computes it from what it
+ * received; the engine from what is on disk at acceptance. They agree only when
+ * those bytes are the same.
+ */
+export declare function threadExportDigest(entries: readonly ThreadExportDigestEntry[]): string;
+/** A symlink's digest identity: its own text, since its target is never read. */
+export declare function threadExportLinkIdentity(target: string): {
+    sha256: string;
+    sizeBytes: number;
+};
+//# sourceMappingURL=thread-export.d.ts.map