@atomicmemory/core 1.0.0

package/dist/schemas/document-response-schemas.d.ts

@@ -0,0 +1,610 @@
+/**
+ * @file Document-route response schemas.
+ *
+ * Extracted from `schemas/responses.ts` (which was at 435 non-comment
+ * LOC after Slice 3, over the workspace's 400 rule). The shapes are
+ * unchanged — this is a pure relocation. `responses.ts` re-exports
+ * each symbol so existing imports through `import * as R from
+ * './responses'` keep working.
+ *
+ * Field naming follows the wire contract (snake_case). Per-layer
+ * per-layer status enums + `last_error` envelope come from the
+ * shared `document-status-envelope` module so the same definitions
+ * back both `RawDocumentResponseSchema` (full row) and the
+ * passport-feed grouped-row schema.
+ */
+import { z } from './zod-setup.js';
+/**
+ * Wire shape for `raw_storage_metadata`. Strict allowlist:
+ *   - `codec`: `{ name, version }` only. AES-GCM internals
+ *     (`nonce`/`tag`/`key_id`/`encoded_*`) NEVER reach the wire.
+ *   - `filecoin`: public projection
+ *     `{ ipfs_cid?, piece_cid?, copy_count, provider_ids,
+ *     copy_statuses }` (Phase 4 renamed the legacy ambiguous
+ *     `cid` slot to `ipfs_cid`). The structured internal
+ *     `copies: [{provider_id, status}]` blob is flattened by
+ *     `projectFilecoinPublicMetadata` at the formatter; legacy
+ *     onramp fields (`onramp`, `gateway_url`, `deal_ids`,
+ *     `onramp_status`, `deal_status`, `retrieval_verified_at`,
+ *     `last_verified_at`) and the legacy `cid` slot are NOT
+ *     emitted — the strict schema rejects them at the wire.
+ *   - `upload_result` (internal upload sidecar) is NOT declared,
+ *     so any leak fails the response-shape validator.
+ *
+ * The formatter (`formatPublicRawStorageMetadata`) is the single
+ * source of redaction; this schema is the deny-by-default lock at
+ * the route boundary. Every nested object is `.strict()` so a
+ * formatter regression that lets ANY unknown key through fails the
+ * `validateResponse` middleware instead of silently shipping.
+ */
+export declare const PublicRawStorageMetadataSchema: z.ZodObject<{
+    codec: z.ZodOptional<z.ZodObject<{
+        name: z.ZodEnum<{
+            none: "none";
+            aes_gcm: "aes_gcm";
+        }>;
+        version: z.ZodNumber;
+    }, z.core.$strict>>;
+    filecoin: z.ZodOptional<z.ZodObject<{
+        ipfs_cid: z.ZodOptional<z.ZodString>;
+        piece_cid: z.ZodOptional<z.ZodString>;
+        copy_count: z.ZodOptional<z.ZodNumber>;
+        provider_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        copy_statuses: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+/** Wire enum for per-row delete semantics. */
+export declare const DeleteSemanticsEnumSchema: z.ZodNullable<z.ZodEnum<{
+    delete: "delete";
+    unpin: "unpin";
+    tombstone: "tombstone";
+}>>;
+/**
+ * Wire-format shape of a document record. Mirrors `RawDocumentRow`
+ * with snake_case keys. `storage_uri` and `storage_provider` are
+ * always null until managed-blob storage is configured.
+ */
+export declare const RawDocumentResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    user_id: z.ZodString;
+    raw_source_id: z.ZodString;
+    external_id: z.ZodString;
+    external_uri: z.ZodNullable<z.ZodString>;
+    display_name: z.ZodNullable<z.ZodString>;
+    mime_type: z.ZodNullable<z.ZodString>;
+    size_bytes: z.ZodNullable<z.ZodNumber>;
+    content_hash: z.ZodNullable<z.ZodString>;
+    provider_version: z.ZodNullable<z.ZodString>;
+    source_modified_at: z.ZodNullable<z.ZodString>;
+    storage_mode: z.ZodEnum<{
+        pointer_only: "pointer_only";
+        managed_blob: "managed_blob";
+        inline_small_text: "inline_small_text";
+    }>;
+    storage_uri: z.ZodNullable<z.ZodString>;
+    storage_provider: z.ZodNullable<z.ZodString>;
+    registration_status: z.ZodEnum<{
+        registered: "registered";
+        registration_failed: "registration_failed";
+    }>;
+    raw_storage_status: z.ZodEnum<{
+        blob_deleted: "blob_deleted";
+        blob_tombstoned: "blob_tombstoned";
+        blob_stored: "blob_stored";
+        blob_pending: "blob_pending";
+        blob_available: "blob_available";
+        pointer_recorded: "pointer_recorded";
+        inline_text_stored: "inline_text_stored";
+        raw_storage_failed: "raw_storage_failed";
+        blob_archival_failed: "blob_archival_failed";
+    }>;
+    raw_storage_metadata: z.ZodObject<{
+        codec: z.ZodOptional<z.ZodObject<{
+            name: z.ZodEnum<{
+                none: "none";
+                aes_gcm: "aes_gcm";
+            }>;
+            version: z.ZodNumber;
+        }, z.core.$strict>>;
+        filecoin: z.ZodOptional<z.ZodObject<{
+            ipfs_cid: z.ZodOptional<z.ZodString>;
+            piece_cid: z.ZodOptional<z.ZodString>;
+            copy_count: z.ZodOptional<z.ZodNumber>;
+            provider_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            copy_statuses: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    delete_semantics: z.ZodNullable<z.ZodEnum<{
+        delete: "delete";
+        unpin: "unpin";
+        tombstone: "tombstone";
+    }>>;
+    metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+    indexed_content_hash: z.ZodNullable<z.ZodString>;
+    indexed_at: z.ZodNullable<z.ZodString>;
+    extraction_status: z.ZodEnum<{
+        pending: "pending";
+        not_required: "not_required";
+        running: "running";
+        complete: "complete";
+        unsupported: "unsupported";
+        failed: "failed";
+    }>;
+    semantic_index_status: z.ZodEnum<{
+        pending: "pending";
+        not_required: "not_required";
+        running: "running";
+        complete: "complete";
+        failed: "failed";
+        stale: "stale";
+    }>;
+    last_error: z.ZodNullable<z.ZodObject<{
+        layer: z.ZodEnum<{
+            raw_storage: "raw_storage";
+            extraction: "extraction";
+            semantic_index: "semantic_index";
+        }>;
+        code: z.ZodString;
+        message: z.ZodString;
+        occurred_at: z.ZodString;
+    }, z.core.$strip>>;
+    storage_artifact_id: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const RegisterDocumentResponseSchema: z.ZodObject<{
+    document: z.ZodObject<{
+        id: z.ZodString;
+        user_id: z.ZodString;
+        raw_source_id: z.ZodString;
+        external_id: z.ZodString;
+        external_uri: z.ZodNullable<z.ZodString>;
+        display_name: z.ZodNullable<z.ZodString>;
+        mime_type: z.ZodNullable<z.ZodString>;
+        size_bytes: z.ZodNullable<z.ZodNumber>;
+        content_hash: z.ZodNullable<z.ZodString>;
+        provider_version: z.ZodNullable<z.ZodString>;
+        source_modified_at: z.ZodNullable<z.ZodString>;
+        storage_mode: z.ZodEnum<{
+            pointer_only: "pointer_only";
+            managed_blob: "managed_blob";
+            inline_small_text: "inline_small_text";
+        }>;
+        storage_uri: z.ZodNullable<z.ZodString>;
+        storage_provider: z.ZodNullable<z.ZodString>;
+        registration_status: z.ZodEnum<{
+            registered: "registered";
+            registration_failed: "registration_failed";
+        }>;
+        raw_storage_status: z.ZodEnum<{
+            blob_deleted: "blob_deleted";
+            blob_tombstoned: "blob_tombstoned";
+            blob_stored: "blob_stored";
+            blob_pending: "blob_pending";
+            blob_available: "blob_available";
+            pointer_recorded: "pointer_recorded";
+            inline_text_stored: "inline_text_stored";
+            raw_storage_failed: "raw_storage_failed";
+            blob_archival_failed: "blob_archival_failed";
+        }>;
+        raw_storage_metadata: z.ZodObject<{
+            codec: z.ZodOptional<z.ZodObject<{
+                name: z.ZodEnum<{
+                    none: "none";
+                    aes_gcm: "aes_gcm";
+                }>;
+                version: z.ZodNumber;
+            }, z.core.$strict>>;
+            filecoin: z.ZodOptional<z.ZodObject<{
+                ipfs_cid: z.ZodOptional<z.ZodString>;
+                piece_cid: z.ZodOptional<z.ZodString>;
+                copy_count: z.ZodOptional<z.ZodNumber>;
+                provider_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                copy_statuses: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        delete_semantics: z.ZodNullable<z.ZodEnum<{
+            delete: "delete";
+            unpin: "unpin";
+            tombstone: "tombstone";
+        }>>;
+        metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+        indexed_content_hash: z.ZodNullable<z.ZodString>;
+        indexed_at: z.ZodNullable<z.ZodString>;
+        extraction_status: z.ZodEnum<{
+            pending: "pending";
+            not_required: "not_required";
+            running: "running";
+            complete: "complete";
+            unsupported: "unsupported";
+            failed: "failed";
+        }>;
+        semantic_index_status: z.ZodEnum<{
+            pending: "pending";
+            not_required: "not_required";
+            running: "running";
+            complete: "complete";
+            failed: "failed";
+            stale: "stale";
+        }>;
+        last_error: z.ZodNullable<z.ZodObject<{
+            layer: z.ZodEnum<{
+                raw_storage: "raw_storage";
+                extraction: "extraction";
+                semantic_index: "semantic_index";
+            }>;
+            code: z.ZodString;
+            message: z.ZodString;
+            occurred_at: z.ZodString;
+        }, z.core.$strip>>;
+        storage_artifact_id: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    created: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const ListDocumentsResponseSchema: z.ZodObject<{
+    documents: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        user_id: z.ZodString;
+        raw_source_id: z.ZodString;
+        external_id: z.ZodString;
+        external_uri: z.ZodNullable<z.ZodString>;
+        display_name: z.ZodNullable<z.ZodString>;
+        mime_type: z.ZodNullable<z.ZodString>;
+        size_bytes: z.ZodNullable<z.ZodNumber>;
+        content_hash: z.ZodNullable<z.ZodString>;
+        provider_version: z.ZodNullable<z.ZodString>;
+        source_modified_at: z.ZodNullable<z.ZodString>;
+        storage_mode: z.ZodEnum<{
+            pointer_only: "pointer_only";
+            managed_blob: "managed_blob";
+            inline_small_text: "inline_small_text";
+        }>;
+        storage_uri: z.ZodNullable<z.ZodString>;
+        storage_provider: z.ZodNullable<z.ZodString>;
+        registration_status: z.ZodEnum<{
+            registered: "registered";
+            registration_failed: "registration_failed";
+        }>;
+        raw_storage_status: z.ZodEnum<{
+            blob_deleted: "blob_deleted";
+            blob_tombstoned: "blob_tombstoned";
+            blob_stored: "blob_stored";
+            blob_pending: "blob_pending";
+            blob_available: "blob_available";
+            pointer_recorded: "pointer_recorded";
+            inline_text_stored: "inline_text_stored";
+            raw_storage_failed: "raw_storage_failed";
+            blob_archival_failed: "blob_archival_failed";
+        }>;
+        raw_storage_metadata: z.ZodObject<{
+            codec: z.ZodOptional<z.ZodObject<{
+                name: z.ZodEnum<{
+                    none: "none";
+                    aes_gcm: "aes_gcm";
+                }>;
+                version: z.ZodNumber;
+            }, z.core.$strict>>;
+            filecoin: z.ZodOptional<z.ZodObject<{
+                ipfs_cid: z.ZodOptional<z.ZodString>;
+                piece_cid: z.ZodOptional<z.ZodString>;
+                copy_count: z.ZodOptional<z.ZodNumber>;
+                provider_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                copy_statuses: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        delete_semantics: z.ZodNullable<z.ZodEnum<{
+            delete: "delete";
+            unpin: "unpin";
+            tombstone: "tombstone";
+        }>>;
+        metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+        indexed_content_hash: z.ZodNullable<z.ZodString>;
+        indexed_at: z.ZodNullable<z.ZodString>;
+        extraction_status: z.ZodEnum<{
+            pending: "pending";
+            not_required: "not_required";
+            running: "running";
+            complete: "complete";
+            unsupported: "unsupported";
+            failed: "failed";
+        }>;
+        semantic_index_status: z.ZodEnum<{
+            pending: "pending";
+            not_required: "not_required";
+            running: "running";
+            complete: "complete";
+            failed: "failed";
+            stale: "stale";
+        }>;
+        last_error: z.ZodNullable<z.ZodObject<{
+            layer: z.ZodEnum<{
+                raw_storage: "raw_storage";
+                extraction: "extraction";
+                semantic_index: "semantic_index";
+            }>;
+            code: z.ZodString;
+            message: z.ZodString;
+            occurred_at: z.ZodString;
+        }, z.core.$strip>>;
+        storage_artifact_id: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    count: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Cursor-paginated user-scoped document list. Distinct from
+ * `ListDocumentsResponseSchema` (the legacy `/list` shape) because it
+ * carries an opaque cursor instead of `count`, matching the
+ * "fetch-next-page" UX the document-detail / recovery surfaces
+ * need. `next_cursor: null` means the stream is exhausted.
+ */
+export declare const DocumentListRootResponseSchema: z.ZodObject<{
+    documents: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        user_id: z.ZodString;
+        raw_source_id: z.ZodString;
+        external_id: z.ZodString;
+        external_uri: z.ZodNullable<z.ZodString>;
+        display_name: z.ZodNullable<z.ZodString>;
+        mime_type: z.ZodNullable<z.ZodString>;
+        size_bytes: z.ZodNullable<z.ZodNumber>;
+        content_hash: z.ZodNullable<z.ZodString>;
+        provider_version: z.ZodNullable<z.ZodString>;
+        source_modified_at: z.ZodNullable<z.ZodString>;
+        storage_mode: z.ZodEnum<{
+            pointer_only: "pointer_only";
+            managed_blob: "managed_blob";
+            inline_small_text: "inline_small_text";
+        }>;
+        storage_uri: z.ZodNullable<z.ZodString>;
+        storage_provider: z.ZodNullable<z.ZodString>;
+        registration_status: z.ZodEnum<{
+            registered: "registered";
+            registration_failed: "registration_failed";
+        }>;
+        raw_storage_status: z.ZodEnum<{
+            blob_deleted: "blob_deleted";
+            blob_tombstoned: "blob_tombstoned";
+            blob_stored: "blob_stored";
+            blob_pending: "blob_pending";
+            blob_available: "blob_available";
+            pointer_recorded: "pointer_recorded";
+            inline_text_stored: "inline_text_stored";
+            raw_storage_failed: "raw_storage_failed";
+            blob_archival_failed: "blob_archival_failed";
+        }>;
+        raw_storage_metadata: z.ZodObject<{
+            codec: z.ZodOptional<z.ZodObject<{
+                name: z.ZodEnum<{
+                    none: "none";
+                    aes_gcm: "aes_gcm";
+                }>;
+                version: z.ZodNumber;
+            }, z.core.$strict>>;
+            filecoin: z.ZodOptional<z.ZodObject<{
+                ipfs_cid: z.ZodOptional<z.ZodString>;
+                piece_cid: z.ZodOptional<z.ZodString>;
+                copy_count: z.ZodOptional<z.ZodNumber>;
+                provider_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                copy_statuses: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        delete_semantics: z.ZodNullable<z.ZodEnum<{
+            delete: "delete";
+            unpin: "unpin";
+            tombstone: "tombstone";
+        }>>;
+        metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+        indexed_content_hash: z.ZodNullable<z.ZodString>;
+        indexed_at: z.ZodNullable<z.ZodString>;
+        extraction_status: z.ZodEnum<{
+            pending: "pending";
+            not_required: "not_required";
+            running: "running";
+            complete: "complete";
+            unsupported: "unsupported";
+            failed: "failed";
+        }>;
+        semantic_index_status: z.ZodEnum<{
+            pending: "pending";
+            not_required: "not_required";
+            running: "running";
+            complete: "complete";
+            failed: "failed";
+            stale: "stale";
+        }>;
+        last_error: z.ZodNullable<z.ZodObject<{
+            layer: z.ZodEnum<{
+                raw_storage: "raw_storage";
+                extraction: "extraction";
+                semantic_index: "semantic_index";
+            }>;
+            code: z.ZodString;
+            message: z.ZodString;
+            occurred_at: z.ZodString;
+        }, z.core.$strip>>;
+        storage_artifact_id: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    next_cursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const DeleteDocumentResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    already_deleted: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const UploadRawDocumentResponseSchema: z.ZodObject<{
+    document_id: z.ZodString;
+    storage_provider: z.ZodString;
+    storage_uri: z.ZodString;
+    content_hash: z.ZodString;
+    size_bytes: z.ZodNumber;
+    raw_storage_status: z.ZodEnum<{
+        blob_stored: "blob_stored";
+        blob_pending: "blob_pending";
+        blob_available: "blob_available";
+    }>;
+    storage_mode: z.ZodLiteral<"managed_blob">;
+    raw_storage_metadata: z.ZodObject<{
+        codec: z.ZodOptional<z.ZodObject<{
+            name: z.ZodEnum<{
+                none: "none";
+                aes_gcm: "aes_gcm";
+            }>;
+            version: z.ZodNumber;
+        }, z.core.$strict>>;
+        filecoin: z.ZodOptional<z.ZodObject<{
+            ipfs_cid: z.ZodOptional<z.ZodString>;
+            piece_cid: z.ZodOptional<z.ZodString>;
+            copy_count: z.ZodOptional<z.ZodNumber>;
+            provider_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            copy_statuses: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    delete_semantics: z.ZodNullable<z.ZodEnum<{
+        delete: "delete";
+        unpin: "unpin";
+        tombstone: "tombstone";
+    }>>;
+    idempotent_skip: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const IndexDocumentResponseSchema: z.ZodObject<{
+    document_id: z.ZodString;
+    indexed_content_hash: z.ZodString;
+    chunks_created: z.ZodNumber;
+    memories_created: z.ZodNumber;
+    idempotent_skip: z.ZodBoolean;
+    chunker_version: z.ZodString;
+    parser_version: z.ZodString;
+}, z.core.$strip>;
+export declare const DocumentLimitsResponseSchema: z.ZodObject<{
+    raw_upload_max_bytes: z.ZodNumber;
+    index_max_text_bytes: z.ZodNumber;
+    raw_storage: z.ZodObject<{
+        enabled: z.ZodBoolean;
+        mode: z.ZodEnum<{
+            pointer_only: "pointer_only";
+            managed_blob: "managed_blob";
+        }>;
+        reason: z.ZodOptional<z.ZodString>;
+        provider: z.ZodOptional<z.ZodString>;
+        addressing: z.ZodOptional<z.ZodEnum<{
+            location: "location";
+            content: "content";
+        }>>;
+        retrieval_consistency: z.ZodOptional<z.ZodEnum<{
+            immediate: "immediate";
+            eventual: "eventual";
+        }>>;
+        delete_semantics: z.ZodOptional<z.ZodEnum<{
+            delete: "delete";
+            unpin: "unpin";
+            tombstone: "tombstone";
+        }>>;
+        supports_head: z.ZodOptional<z.ZodBoolean>;
+        supports_get: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * failure-transition - response shape for `POST /v1/documents/:id/extraction-failure`
+ * and `POST /v1/documents/:id/index-failure`. Both endpoints return the
+ * row in its post-transition state so the caller can read back the
+ * `extraction_status` / `semantic_index_status` / `last_error` they
+ * just persisted without a round-trip to `GET /:id`. `idempotent` is
+ * `true` when the call hit the already-failed-row idempotent retry
+ * branch (no state change beyond `last_error.occurred_at`/`message`).
+ */
+export declare const DocumentFailureMarkerResponseSchema: z.ZodObject<{
+    document: z.ZodObject<{
+        id: z.ZodString;
+        user_id: z.ZodString;
+        raw_source_id: z.ZodString;
+        external_id: z.ZodString;
+        external_uri: z.ZodNullable<z.ZodString>;
+        display_name: z.ZodNullable<z.ZodString>;
+        mime_type: z.ZodNullable<z.ZodString>;
+        size_bytes: z.ZodNullable<z.ZodNumber>;
+        content_hash: z.ZodNullable<z.ZodString>;
+        provider_version: z.ZodNullable<z.ZodString>;
+        source_modified_at: z.ZodNullable<z.ZodString>;
+        storage_mode: z.ZodEnum<{
+            pointer_only: "pointer_only";
+            managed_blob: "managed_blob";
+            inline_small_text: "inline_small_text";
+        }>;
+        storage_uri: z.ZodNullable<z.ZodString>;
+        storage_provider: z.ZodNullable<z.ZodString>;
+        registration_status: z.ZodEnum<{
+            registered: "registered";
+            registration_failed: "registration_failed";
+        }>;
+        raw_storage_status: z.ZodEnum<{
+            blob_deleted: "blob_deleted";
+            blob_tombstoned: "blob_tombstoned";
+            blob_stored: "blob_stored";
+            blob_pending: "blob_pending";
+            blob_available: "blob_available";
+            pointer_recorded: "pointer_recorded";
+            inline_text_stored: "inline_text_stored";
+            raw_storage_failed: "raw_storage_failed";
+            blob_archival_failed: "blob_archival_failed";
+        }>;
+        raw_storage_metadata: z.ZodObject<{
+            codec: z.ZodOptional<z.ZodObject<{
+                name: z.ZodEnum<{
+                    none: "none";
+                    aes_gcm: "aes_gcm";
+                }>;
+                version: z.ZodNumber;
+            }, z.core.$strict>>;
+            filecoin: z.ZodOptional<z.ZodObject<{
+                ipfs_cid: z.ZodOptional<z.ZodString>;
+                piece_cid: z.ZodOptional<z.ZodString>;
+                copy_count: z.ZodOptional<z.ZodNumber>;
+                provider_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                copy_statuses: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        delete_semantics: z.ZodNullable<z.ZodEnum<{
+            delete: "delete";
+            unpin: "unpin";
+            tombstone: "tombstone";
+        }>>;
+        metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+        indexed_content_hash: z.ZodNullable<z.ZodString>;
+        indexed_at: z.ZodNullable<z.ZodString>;
+        extraction_status: z.ZodEnum<{
+            pending: "pending";
+            not_required: "not_required";
+            running: "running";
+            complete: "complete";
+            unsupported: "unsupported";
+            failed: "failed";
+        }>;
+        semantic_index_status: z.ZodEnum<{
+            pending: "pending";
+            not_required: "not_required";
+            running: "running";
+            complete: "complete";
+            failed: "failed";
+            stale: "stale";
+        }>;
+        last_error: z.ZodNullable<z.ZodObject<{
+            layer: z.ZodEnum<{
+                raw_storage: "raw_storage";
+                extraction: "extraction";
+                semantic_index: "semantic_index";
+            }>;
+            code: z.ZodString;
+            message: z.ZodString;
+            occurred_at: z.ZodString;
+        }, z.core.$strip>>;
+        storage_artifact_id: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    idempotent: z.ZodBoolean;
+}, z.core.$strip>;