@native-knowledge/knowledge-sdk 0.0.0-stage → 0.1.0-rc.1

package/dist/types/contracts/evidence.d.ts

@@ -0,0 +1,202 @@
+import { z } from 'zod';
+export declare const evidenceModalitySchema: z.ZodEnum<{
+    TEXT: "TEXT";
+    PDF: "PDF";
+    IMAGE: "IMAGE";
+    AUDIO: "AUDIO";
+    VIDEO: "VIDEO";
+    BINARY: "BINARY";
+}>;
+export declare const evidenceReviewModeSchema: z.ZodEnum<{
+    TEXT_NATIVE: "TEXT_NATIVE";
+    MULTIMODAL_NATIVE: "MULTIMODAL_NATIVE";
+    EXTERNAL_EXTRACTOR_REQUIRED: "EXTERNAL_EXTRACTOR_REQUIRED";
+}>;
+export declare const evidenceReviewInstructionSchema: z.ZodEnum<{
+    READ_ORIGINAL_TEXT: "READ_ORIGINAL_TEXT";
+    INSPECT_ORIGINAL_DOCUMENT: "INSPECT_ORIGINAL_DOCUMENT";
+    INSPECT_ORIGINAL_IMAGE: "INSPECT_ORIGINAL_IMAGE";
+    LISTEN_TO_ORIGINAL_AUDIO: "LISTEN_TO_ORIGINAL_AUDIO";
+    INSPECT_ORIGINAL_VIDEO: "INSPECT_ORIGINAL_VIDEO";
+    USE_APPROVED_EXTERNAL_EXTRACTOR: "USE_APPROVED_EXTERNAL_EXTRACTOR";
+}>;
+export declare const evidenceReviewHintsSchema: z.ZodObject<{
+    pageRanges: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        startPage: z.ZodNumber;
+        endPage: z.ZodNumber;
+    }, z.core.$strict>>>;
+    timeRanges: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        startMs: z.ZodNumber;
+        endMs: z.ZodNumber;
+    }, z.core.$strict>>>;
+    frameTimestampsMs: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+}, z.core.$strict>;
+export declare const evidenceReviewAttachmentSchema: z.ZodObject<{
+    evidenceRef: z.ZodString;
+    contentHash: z.ZodString;
+    mediaType: z.ZodString;
+    byteLength: z.ZodNullable<z.ZodNumber>;
+    modality: z.ZodEnum<{
+        TEXT: "TEXT";
+        PDF: "PDF";
+        IMAGE: "IMAGE";
+        AUDIO: "AUDIO";
+        VIDEO: "VIDEO";
+        BINARY: "BINARY";
+    }>;
+    reviewMode: z.ZodEnum<{
+        TEXT_NATIVE: "TEXT_NATIVE";
+        MULTIMODAL_NATIVE: "MULTIMODAL_NATIVE";
+        EXTERNAL_EXTRACTOR_REQUIRED: "EXTERNAL_EXTRACTOR_REQUIRED";
+    }>;
+    instruction: z.ZodEnum<{
+        READ_ORIGINAL_TEXT: "READ_ORIGINAL_TEXT";
+        INSPECT_ORIGINAL_DOCUMENT: "INSPECT_ORIGINAL_DOCUMENT";
+        INSPECT_ORIGINAL_IMAGE: "INSPECT_ORIGINAL_IMAGE";
+        LISTEN_TO_ORIGINAL_AUDIO: "LISTEN_TO_ORIGINAL_AUDIO";
+        INSPECT_ORIGINAL_VIDEO: "INSPECT_ORIGINAL_VIDEO";
+        USE_APPROVED_EXTERNAL_EXTRACTOR: "USE_APPROVED_EXTERNAL_EXTRACTOR";
+    }>;
+    rawBytesEmbedded: z.ZodLiteral<false>;
+    materializationRequired: z.ZodLiteral<true>;
+    reviewHints: z.ZodOptional<z.ZodObject<{
+        pageRanges: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            startPage: z.ZodNumber;
+            endPage: z.ZodNumber;
+        }, z.core.$strict>>>;
+        timeRanges: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            startMs: z.ZodNumber;
+            endMs: z.ZodNumber;
+        }, z.core.$strict>>>;
+        frameTimestampsMs: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const evidenceMaterializationReceiptSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    evidenceRef: z.ZodString;
+    contentHash: z.ZodString;
+    mediaType: z.ZodString;
+    byteLength: z.ZodNumber;
+    modality: z.ZodEnum<{
+        TEXT: "TEXT";
+        PDF: "PDF";
+        IMAGE: "IMAGE";
+        AUDIO: "AUDIO";
+        VIDEO: "VIDEO";
+        BINARY: "BINARY";
+    }>;
+    reviewMode: z.ZodEnum<{
+        TEXT_NATIVE: "TEXT_NATIVE";
+        MULTIMODAL_NATIVE: "MULTIMODAL_NATIVE";
+        EXTERNAL_EXTRACTOR_REQUIRED: "EXTERNAL_EXTRACTOR_REQUIRED";
+    }>;
+    instruction: z.ZodEnum<{
+        READ_ORIGINAL_TEXT: "READ_ORIGINAL_TEXT";
+        INSPECT_ORIGINAL_DOCUMENT: "INSPECT_ORIGINAL_DOCUMENT";
+        INSPECT_ORIGINAL_IMAGE: "INSPECT_ORIGINAL_IMAGE";
+        LISTEN_TO_ORIGINAL_AUDIO: "LISTEN_TO_ORIGINAL_AUDIO";
+        INSPECT_ORIGINAL_VIDEO: "INSPECT_ORIGINAL_VIDEO";
+        USE_APPROVED_EXTERNAL_EXTRACTOR: "USE_APPROVED_EXTERNAL_EXTRACTOR";
+    }>;
+    reviewHints: z.ZodOptional<z.ZodObject<{
+        pageRanges: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            startPage: z.ZodNumber;
+            endPage: z.ZodNumber;
+        }, z.core.$strict>>>;
+        timeRanges: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            startMs: z.ZodNumber;
+            endMs: z.ZodNumber;
+        }, z.core.$strict>>>;
+        frameTimestampsMs: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+    }, z.core.$strict>>;
+    access: z.ZodEnum<{
+        PUBLIC: "PUBLIC";
+        PUBLIC_METADATA: "PUBLIC_METADATA";
+        TENANT: "TENANT";
+        INTERNAL: "INTERNAL";
+        FDE_INTERNAL: "FDE_INTERNAL";
+        ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+        UNKNOWN: "UNKNOWN";
+    }>;
+    runtimeNodeId: z.ZodString;
+    materializedAt: z.ZodISODateTime;
+    runtimeLocalPath: z.ZodString;
+    reused: z.ZodBoolean;
+}, z.core.$strict>;
+export declare const collectorIdentitySchema: z.ZodObject<{
+    collectorId: z.ZodString;
+    version: z.ZodString;
+}, z.core.$strict>;
+/** 附属媒体沿用 Source 身份，但不能替代该 Source 的主文档。 */
+export declare const RICH_MEDIA_COLLECTOR_ID = "knowledge-v2.rich-document-media";
+export declare const evidenceRequestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    method: z.ZodLiteral<"POST">;
+    bodyContentHash: z.ZodString;
+    bodyMediaType: z.ZodLiteral<"application/x-www-form-urlencoded">;
+    bodyByteLength: z.ZodNumber;
+}, z.core.$strict>;
+export declare const evidenceRefSchema: z.ZodObject<{
+    recoveryProvenance: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodLiteral<"REUSED_PRIOR_EVIDENCE">;
+        originEvidenceRef: z.ZodString;
+        originProjectRef: z.ZodString;
+        originSourceRevisionRef: z.ZodString;
+        originRuntimeNodeId: z.ZodString;
+        handoffReceiptRef: z.ZodString;
+    }, z.core.$strict>>;
+    request: z.ZodOptional<z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        method: z.ZodLiteral<"POST">;
+        bodyContentHash: z.ZodString;
+        bodyMediaType: z.ZodLiteral<"application/x-www-form-urlencoded">;
+        bodyByteLength: z.ZodNumber;
+    }, z.core.$strict>>;
+    schemaVersion: z.ZodLiteral<1>;
+    evidenceId: z.ZodString;
+    sourceId: z.ZodString;
+    sourceIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    projectKey: z.ZodOptional<z.ZodString>;
+    projectRef: z.ZodOptional<z.ZodString>;
+    collector: z.ZodObject<{
+        collectorId: z.ZodString;
+        version: z.ZodString;
+    }, z.core.$strict>;
+    contentHash: z.ZodString;
+    observedAt: z.ZodISODateTime;
+    runtimeNodeId: z.ZodString;
+    access: z.ZodEnum<{
+        PUBLIC: "PUBLIC";
+        PUBLIC_METADATA: "PUBLIC_METADATA";
+        TENANT: "TENANT";
+        INTERNAL: "INTERNAL";
+        FDE_INTERNAL: "FDE_INTERNAL";
+        ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+        UNKNOWN: "UNKNOWN";
+    }>;
+    canonicalUri: z.ZodOptional<z.ZodString>;
+    mediaType: z.ZodOptional<z.ZodString>;
+    byteLength: z.ZodOptional<z.ZodNumber>;
+    sourceSetRef: z.ZodOptional<z.ZodString>;
+    sourceItemId: z.ZodOptional<z.ZodString>;
+    sourceRevisionRef: z.ZodOptional<z.ZodString>;
+    collectionBatchRef: z.ZodOptional<z.ZodString>;
+    collectionTaskId: z.ZodOptional<z.ZodString>;
+    reviewHints: z.ZodOptional<z.ZodObject<{
+        pageRanges: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            startPage: z.ZodNumber;
+            endPage: z.ZodNumber;
+        }, z.core.$strict>>>;
+        timeRanges: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            startMs: z.ZodNumber;
+            endMs: z.ZodNumber;
+        }, z.core.$strict>>>;
+        frameTimestampsMs: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type CollectorIdentity = z.infer<typeof collectorIdentitySchema>;
+export type EvidenceRef = z.infer<typeof evidenceRefSchema>;
+export type EvidenceModality = z.infer<typeof evidenceModalitySchema>;
+export type EvidenceReviewMode = z.infer<typeof evidenceReviewModeSchema>;
+export type EvidenceReviewAttachment = z.infer<typeof evidenceReviewAttachmentSchema>;
+export type EvidenceMaterializationReceipt = z.infer<typeof evidenceMaterializationReceiptSchema>;

package/dist/types/contracts/index.d.ts

@@ -0,0 +1,55 @@
+export * from './common.js';
+export * from './source.js';
+export * from './evidence.js';
+export * from './observation.js';
+export * from './runtime.js';
+export * from './event.js';
+export * from './signal.js';
+export * from './artifact.js';
+export * from './review-packet.js';
+export * from './scheduler.js';
+export * from './currentness.js';
+export * from './projection.js';
+export * from './source-governance.js';
+export * from './review-plane.js';
+export * from './persistence.js';
+export * from './remote-file.js';
+export * from './project-intent.js';
+export * from './collection.js';
+export * from './collection-control.js';
+export * from './rich-document.js';
+export * from './material-carrier.js';
+export * from './reference-record.js';
+export * from './material-read.js';
+export * from './material-context.js';
+export * from './tenant-material-api.js';
+export * from './material-capability.js';
+export * from './public-reference.js';
+export * from './resource-scope.js';
+export * from './tenant-resource.js';
+export * from './tenant-resource-api.js';
+export * from './tenant-source.js';
+export * from './tenant-collection.js';
+export * from './tenant-collection-request.js';
+export * from './tenant-source-document.js';
+export * from './tenant-source-bridge.js';
+export * from './tenant-source-binding.js';
+export * from './tenant-source-cutover.js';
+export * from './tenant-rich-document.js';
+export * from './tenant-management.js';
+export * from './tenant-currentness.js';
+export * from './tenant-public-reference.js';
+export * from './tenant-project-control.js';
+export * from './tenant-budget.js';
+export * from './runtime-compatibility.js';
+export * from './tenant-web-collection.js';
+export * from './tenant-web-results.js';
+export * from './tenant-web-crawl.js';
+export * from './tenant-source-lease.js';
+export * from './tenant-web-dynamic.js';
+export * from './tenant-pdf-text.js';
+export * from './tenant-web-content-plan.js';
+export * from './tenant-web-content-result.js';
+export * from './tenant-web-content.js';
+export * from './tenant-web-workflow.js';
+export * from './resource-transfer.js';

package/dist/types/contracts/material-capability.d.ts

@@ -0,0 +1,88 @@
+import { z } from 'zod';
+export declare const materialReadStateSchema: z.ZodEnum<{
+    MISSING: "MISSING";
+    INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+    READY: "READY";
+    UNSUPPORTED: "UNSUPPORTED";
+    DENIED: "DENIED";
+}>;
+export declare const materialCapabilitySchema: z.ZodObject<{
+    item: z.ZodObject<{
+        ref: z.ZodString;
+        resourceType: z.ZodString;
+        sourceProjectKey: z.ZodString;
+        identityHash: z.ZodString;
+        kind: z.ZodString;
+        classification: z.ZodEnum<{
+            PUBLIC: "PUBLIC";
+            PUBLIC_METADATA: "PUBLIC_METADATA";
+            TENANT: "TENANT";
+            INTERNAL: "INTERNAL";
+            FDE_INTERNAL: "FDE_INTERNAL";
+            ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+            UNKNOWN: "UNKNOWN";
+        }>;
+        mediaType: z.ZodString;
+        decision: z.ZodObject<{
+            schemaVersion: z.ZodLiteral<1>;
+            action: z.ZodEnum<{
+                ALLOW: "ALLOW";
+                DENY: "DENY";
+            }>;
+            reasonCodes: z.ZodArray<z.ZodEnum<{
+                UNAVAILABLE: "UNAVAILABLE";
+                NOT_FOUND: "NOT_FOUND";
+                CONTENT_ACCESS_DENIED: "CONTENT_ACCESS_DENIED";
+                INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+                UNSUPPORTED_RESOURCE: "UNSUPPORTED_RESOURCE";
+            }>>;
+            assessedAt: z.ZodISODateTime;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    materialAccess: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        action: z.ZodEnum<{
+            ALLOW: "ALLOW";
+            DENY: "DENY";
+        }>;
+        reasonCodes: z.ZodArray<z.ZodEnum<{
+            UNAVAILABLE: "UNAVAILABLE";
+            NOT_FOUND: "NOT_FOUND";
+            CONTENT_ACCESS_DENIED: "CONTENT_ACCESS_DENIED";
+            INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+            UNSUPPORTED_RESOURCE: "UNSUPPORTED_RESOURCE";
+        }>>;
+        assessedAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+    representation: z.ZodObject<{
+        state: z.ZodEnum<{
+            MISSING: "MISSING";
+            INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+            READY: "READY";
+            UNSUPPORTED: "UNSUPPORTED";
+            DENIED: "DENIED";
+        }>;
+        format: z.ZodEnum<{
+            BYTES: "BYTES";
+            JSON: "JSON";
+        }>;
+        transfer: z.ZodEnum<{
+            UNSUPPORTED: "UNSUPPORTED";
+            VERIFIED_STREAM: "VERIFIED_STREAM";
+            BUFFERED_JSON: "BUFFERED_JSON";
+        }>;
+        contentHash: z.ZodNullable<z.ZodString>;
+        mediaType: z.ZodString;
+        byteLength: z.ZodNullable<z.ZodNumber>;
+        methods: z.ZodArray<z.ZodEnum<{
+            GET: "GET";
+            HEAD: "HEAD";
+        }>>;
+        range: z.ZodEnum<{
+            NONE: "NONE";
+            SINGLE: "SINGLE";
+        }>;
+        verification: z.ZodLiteral<"ON_READ">;
+        verificationChunkBytes: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>;
+}, z.core.$strict>;

package/dist/types/contracts/material-carrier.d.ts

@@ -0,0 +1,104 @@
+import { z } from 'zod';
+export declare const materialResourceTypeSchema: z.ZodString;
+/** Provenance-bearing immutable metadata; original bytes live only in the shared CAS. */
+export declare const materialCarrierManifestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    ref: z.ZodString;
+    projectKey: z.ZodString;
+    resourceType: z.ZodString;
+    kind: z.ZodString;
+    access: z.ZodEnum<{
+        PUBLIC: "PUBLIC";
+        PUBLIC_METADATA: "PUBLIC_METADATA";
+        TENANT: "TENANT";
+        INTERNAL: "INTERNAL";
+        FDE_INTERNAL: "FDE_INTERNAL";
+        ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+        UNKNOWN: "UNKNOWN";
+    }>;
+    title: z.ZodString;
+    summary: z.ZodString;
+    observedAt: z.ZodISODateTime;
+    sourceRefs: z.ZodArray<z.ZodString>;
+    sourceUri: z.ZodNullable<z.ZodString>;
+    sourceSetRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    storage: z.ZodLiteral<"CAS">;
+    contentHash: z.ZodString;
+    mediaType: z.ZodString;
+    byteLength: z.ZodNumber;
+}, z.core.$strict>;
+export type MaterialCarrierManifest = z.infer<typeof materialCarrierManifestSchema>;
+export declare const materialRegistrationMetadataSchema: z.ZodObject<{
+    kind: z.ZodString;
+    projectKey: z.ZodString;
+    ref: z.ZodString;
+    access: z.ZodEnum<{
+        PUBLIC: "PUBLIC";
+        PUBLIC_METADATA: "PUBLIC_METADATA";
+        TENANT: "TENANT";
+        INTERNAL: "INTERNAL";
+        FDE_INTERNAL: "FDE_INTERNAL";
+        ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+        UNKNOWN: "UNKNOWN";
+    }>;
+    title: z.ZodString;
+    observedAt: z.ZodISODateTime;
+    mediaType: z.ZodString;
+    summary: z.ZodString;
+    sourceSetRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    sourceUri: z.ZodNullable<z.ZodString>;
+    resourceType: z.ZodString;
+    sourceRefs: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const materialRegistrationRequestSchema: z.ZodObject<{
+    projectRef: z.ZodString;
+    metadata: z.ZodObject<{
+        kind: z.ZodString;
+        projectKey: z.ZodString;
+        ref: z.ZodString;
+        access: z.ZodEnum<{
+            PUBLIC: "PUBLIC";
+            PUBLIC_METADATA: "PUBLIC_METADATA";
+            TENANT: "TENANT";
+            INTERNAL: "INTERNAL";
+            FDE_INTERNAL: "FDE_INTERNAL";
+            ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+            UNKNOWN: "UNKNOWN";
+        }>;
+        title: z.ZodString;
+        observedAt: z.ZodISODateTime;
+        mediaType: z.ZodString;
+        summary: z.ZodString;
+        sourceSetRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        sourceUri: z.ZodNullable<z.ZodString>;
+        resourceType: z.ZodString;
+        sourceRefs: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    contentBase64: z.ZodString;
+}, z.core.$strict>;
+export declare const materialRegistrationInputJsonSchema: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
+    projectRef: z.ZodString;
+    metadata: z.ZodObject<{
+        kind: z.ZodString;
+        projectKey: z.ZodString;
+        ref: z.ZodString;
+        access: z.ZodEnum<{
+            PUBLIC: "PUBLIC";
+            PUBLIC_METADATA: "PUBLIC_METADATA";
+            TENANT: "TENANT";
+            INTERNAL: "INTERNAL";
+            FDE_INTERNAL: "FDE_INTERNAL";
+            ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+            UNKNOWN: "UNKNOWN";
+        }>;
+        title: z.ZodString;
+        observedAt: z.ZodISODateTime;
+        mediaType: z.ZodString;
+        summary: z.ZodString;
+        sourceSetRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        sourceUri: z.ZodNullable<z.ZodString>;
+        resourceType: z.ZodString;
+        sourceRefs: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    contentBase64: z.ZodString;
+}, z.core.$strict>>;

package/dist/types/contracts/material-context.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+export declare const materialTenantIdSchema: z.ZodString;
+export declare const materialContextSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"TENANT">;
+    tenantId: z.ZodString;
+    tenantRef: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"PROJECT">;
+    tenantId: z.ZodString;
+    projectKey: z.ZodString;
+    projectRef: z.ZodString;
+}, z.core.$strict>], "type">;
+export type MaterialContext = z.infer<typeof materialContextSchema>;
+export declare const materialProjectScopeInputSchema: z.ZodObject<{
+    mode: z.ZodOptional<z.ZodEnum<{
+        TENANT: "TENANT";
+        EXPLICIT: "EXPLICIT";
+    }>>;
+    selectors: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            SOURCE_PROJECT: "SOURCE_PROJECT";
+            REF: "REF";
+        }>;
+        value: z.ZodString;
+        enabled: z.ZodBoolean;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type MaterialProjectScopeInput = z.infer<typeof materialProjectScopeInputSchema>;

package/dist/types/contracts/material-read.d.ts

@@ -0,0 +1,152 @@
+/** Retrieval permissions and immutable descriptors, independent of business usage decisions. */
+import { z } from 'zod';
+export declare const rawRetrievalProblemSchema: z.ZodEnum<{
+    UNAVAILABLE: "UNAVAILABLE";
+    NOT_FOUND: "NOT_FOUND";
+    CONTENT_ACCESS_DENIED: "CONTENT_ACCESS_DENIED";
+    INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+    UNSUPPORTED_RESOURCE: "UNSUPPORTED_RESOURCE";
+}>;
+export declare const rawRetrievalDecisionSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    action: z.ZodEnum<{
+        ALLOW: "ALLOW";
+        DENY: "DENY";
+    }>;
+    reasonCodes: z.ZodArray<z.ZodEnum<{
+        UNAVAILABLE: "UNAVAILABLE";
+        NOT_FOUND: "NOT_FOUND";
+        CONTENT_ACCESS_DENIED: "CONTENT_ACCESS_DENIED";
+        INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+        UNSUPPORTED_RESOURCE: "UNSUPPORTED_RESOURCE";
+    }>>;
+    assessedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export declare const rawContentDescriptorSchema: z.ZodObject<{
+    contentHash: z.ZodString;
+    mediaType: z.ZodString;
+    byteLength: z.ZodNumber;
+}, z.core.$strict>;
+export declare const rawArtifactSummarySchema: z.ZodObject<{
+    ref: z.ZodString;
+    identityRef: z.ZodString;
+    projectKey: z.ZodString;
+    projectRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    artifactId: z.ZodString;
+    kind: z.ZodString;
+    version: z.ZodNumber;
+    status: z.ZodString;
+    access: z.ZodEnum<{
+        PUBLIC: "PUBLIC";
+        PUBLIC_METADATA: "PUBLIC_METADATA";
+        TENANT: "TENANT";
+        INTERNAL: "INTERNAL";
+        FDE_INTERNAL: "FDE_INTERNAL";
+        ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+        UNKNOWN: "UNKNOWN";
+    }>;
+    title: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodISODateTime;
+    observedAt: z.ZodNullable<z.ZodISODateTime>;
+    validUntil: z.ZodNullable<z.ZodISODateTime>;
+    content: z.ZodObject<{
+        contentHash: z.ZodString;
+        mediaType: z.ZodString;
+        byteLength: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const rawArtifactDetailSchema: z.ZodObject<{
+    ref: z.ZodString;
+    identityRef: z.ZodString;
+    projectKey: z.ZodString;
+    projectRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    artifactId: z.ZodString;
+    kind: z.ZodString;
+    version: z.ZodNumber;
+    status: z.ZodString;
+    access: z.ZodEnum<{
+        PUBLIC: "PUBLIC";
+        PUBLIC_METADATA: "PUBLIC_METADATA";
+        TENANT: "TENANT";
+        INTERNAL: "INTERNAL";
+        FDE_INTERNAL: "FDE_INTERNAL";
+        ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+        UNKNOWN: "UNKNOWN";
+    }>;
+    title: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodISODateTime;
+    observedAt: z.ZodNullable<z.ZodISODateTime>;
+    validUntil: z.ZodNullable<z.ZodISODateTime>;
+    content: z.ZodObject<{
+        contentHash: z.ZodString;
+        mediaType: z.ZodString;
+        byteLength: z.ZodNumber;
+    }, z.core.$strict>;
+    evidenceRefs: z.ZodArray<z.ZodString>;
+    relatedRefs: z.ZodArray<z.ZodString>;
+    supersedesRef: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export declare const rawEvidenceSummarySchema: z.ZodObject<{
+    evidenceRef: z.ZodString;
+    projectKey: z.ZodString;
+    sourceId: z.ZodString;
+    contentHash: z.ZodString;
+    observedAt: z.ZodISODateTime;
+    access: z.ZodEnum<{
+        PUBLIC: "PUBLIC";
+        PUBLIC_METADATA: "PUBLIC_METADATA";
+        TENANT: "TENANT";
+        INTERNAL: "INTERNAL";
+        FDE_INTERNAL: "FDE_INTERNAL";
+        ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+        UNKNOWN: "UNKNOWN";
+    }>;
+    canonicalUri: z.ZodNullable<z.ZodString>;
+    mediaType: z.ZodNullable<z.ZodString>;
+    byteLength: z.ZodNullable<z.ZodNumber>;
+    projectRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    sourceSetRef: z.ZodNullable<z.ZodString>;
+    sourceItemId: z.ZodNullable<z.ZodString>;
+    sourceRevisionRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    collectionBatchRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    collectionTaskId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export declare const rawMaterialDirectoryItemSchema: z.ZodObject<{
+    ref: z.ZodString;
+    resourceType: z.ZodString;
+    sourceProjectKey: z.ZodString;
+    identityHash: z.ZodString;
+    kind: z.ZodString;
+    classification: z.ZodEnum<{
+        PUBLIC: "PUBLIC";
+        PUBLIC_METADATA: "PUBLIC_METADATA";
+        TENANT: "TENANT";
+        INTERNAL: "INTERNAL";
+        FDE_INTERNAL: "FDE_INTERNAL";
+        ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+        UNKNOWN: "UNKNOWN";
+    }>;
+    mediaType: z.ZodString;
+    decision: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        action: z.ZodEnum<{
+            ALLOW: "ALLOW";
+            DENY: "DENY";
+        }>;
+        reasonCodes: z.ZodArray<z.ZodEnum<{
+            UNAVAILABLE: "UNAVAILABLE";
+            NOT_FOUND: "NOT_FOUND";
+            CONTENT_ACCESS_DENIED: "CONTENT_ACCESS_DENIED";
+            INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+            UNSUPPORTED_RESOURCE: "UNSUPPORTED_RESOURCE";
+        }>>;
+        assessedAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type RawRetrievalProblem = z.infer<typeof rawRetrievalProblemSchema>;
+export type RawRetrievalDecision = z.infer<typeof rawRetrievalDecisionSchema>;
+export type RawContentDescriptor = z.infer<typeof rawContentDescriptorSchema>;
+export type RawArtifactSummary = z.infer<typeof rawArtifactSummarySchema>;
+export type RawArtifactDetail = z.infer<typeof rawArtifactDetailSchema>;
+export type RawEvidenceSummary = z.infer<typeof rawEvidenceSummarySchema>;
+export type RawMaterialDirectoryItem = z.infer<typeof rawMaterialDirectoryItemSchema>;