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

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

@@ -0,0 +1,120 @@
+import { z } from 'zod';
+export declare const artifactIdSchema: z.ZodString;
+export declare const artifactKindSchema: z.ZodEnum<{
+    SIGNAL_GENERATION: "SIGNAL_GENERATION";
+    RESEARCH: "RESEARCH";
+    REVIEW: "REVIEW";
+    KNOWLEDGE: "KNOWLEDGE";
+    INSIGHT: "INSIGHT";
+}>;
+export declare const artifactStatusSchema: z.ZodEnum<{
+    GENERATED: "GENERATED";
+    DRAFT: "DRAFT";
+    READY_FOR_REVIEW: "READY_FOR_REVIEW";
+    REWORK_REQUIRED: "REWORK_REQUIRED";
+    APPROVED: "APPROVED";
+    REJECTED: "REJECTED";
+    SUPERSEDED: "SUPERSEDED";
+}>;
+export declare const artifactManifestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    artifactId: z.ZodString;
+    kind: z.ZodEnum<{
+        SIGNAL_GENERATION: "SIGNAL_GENERATION";
+        RESEARCH: "RESEARCH";
+        REVIEW: "REVIEW";
+        KNOWLEDGE: "KNOWLEDGE";
+        INSIGHT: "INSIGHT";
+    }>;
+    projectKey: z.ZodString;
+    projectRef: z.ZodOptional<z.ZodString>;
+    version: z.ZodNumber;
+    ref: z.ZodString;
+    identityRef: z.ZodString;
+    status: z.ZodEnum<{
+        GENERATED: "GENERATED";
+        DRAFT: "DRAFT";
+        READY_FOR_REVIEW: "READY_FOR_REVIEW";
+        REWORK_REQUIRED: "REWORK_REQUIRED";
+        APPROVED: "APPROVED";
+        REJECTED: "REJECTED";
+        SUPERSEDED: "SUPERSEDED";
+    }>;
+    access: z.ZodDefault<z.ZodEnum<{
+        PUBLIC: "PUBLIC";
+        PUBLIC_METADATA: "PUBLIC_METADATA";
+        TENANT: "TENANT";
+        INTERNAL: "INTERNAL";
+        FDE_INTERNAL: "FDE_INTERNAL";
+        ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+        UNKNOWN: "UNKNOWN";
+    }>>;
+    title: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodISODateTime;
+    observedAt: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+    validUntil: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+    contentHash: z.ZodString;
+    mediaType: z.ZodString;
+    byteLength: z.ZodNumber;
+    evidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    relatedRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    supersedesRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type ArtifactId = z.infer<typeof artifactIdSchema>;
+export type ArtifactKind = z.infer<typeof artifactKindSchema>;
+export type ArtifactStatus = z.infer<typeof artifactStatusSchema>;
+export type ArtifactManifest = z.infer<typeof artifactManifestSchema>;
+export declare const artifactWriteMetadataSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    artifactId: z.ZodString;
+    kind: z.ZodEnum<{
+        SIGNAL_GENERATION: "SIGNAL_GENERATION";
+        RESEARCH: "RESEARCH";
+        REVIEW: "REVIEW";
+        KNOWLEDGE: "KNOWLEDGE";
+        INSIGHT: "INSIGHT";
+    }>;
+    projectKey: z.ZodString;
+    projectRef: z.ZodOptional<z.ZodString>;
+    version: z.ZodNumber;
+    status: z.ZodEnum<{
+        GENERATED: "GENERATED";
+        DRAFT: "DRAFT";
+        READY_FOR_REVIEW: "READY_FOR_REVIEW";
+        REWORK_REQUIRED: "REWORK_REQUIRED";
+        APPROVED: "APPROVED";
+        REJECTED: "REJECTED";
+        SUPERSEDED: "SUPERSEDED";
+    }>;
+    access: z.ZodDefault<z.ZodEnum<{
+        PUBLIC: "PUBLIC";
+        PUBLIC_METADATA: "PUBLIC_METADATA";
+        TENANT: "TENANT";
+        INTERNAL: "INTERNAL";
+        FDE_INTERNAL: "FDE_INTERNAL";
+        ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+        UNKNOWN: "UNKNOWN";
+    }>>;
+    title: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodISODateTime;
+    observedAt: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+    validUntil: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+    mediaType: z.ZodString;
+    evidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    relatedRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    supersedesRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export declare const reviewDecisionSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    targetRef: z.ZodString;
+    decision: z.ZodEnum<{
+        PASS: "PASS";
+        REWORK: "REWORK";
+        REJECT: "REJECT";
+    }>;
+    reviewedAt: z.ZodISODateTime;
+    summary: z.ZodString;
+    evidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export type ArtifactWriteMetadata = z.infer<typeof artifactWriteMetadataSchema>;
+export type ReviewDecision = z.infer<typeof reviewDecisionSchema>;

package/dist/types/contracts/collection-control.d.ts

@@ -0,0 +1,160 @@
+import { z } from 'zod';
+export declare const knowledgeControlScopeSchema: z.ZodEnum<{
+    "knowledge.read": "knowledge.read";
+    "knowledge.collect": "knowledge.collect";
+    "knowledge.source.manage": "knowledge.source.manage";
+    "knowledge.review": "knowledge.review";
+    "knowledge.publish": "knowledge.publish";
+}>;
+export declare const collectionControlRequestIdSchema: z.ZodString;
+export declare const collectionControlCreateRequestSchema: z.ZodPipe<z.ZodObject<{
+    projectKey: z.ZodString;
+    requestId: z.ZodString;
+    sourceIds: z.ZodArray<z.ZodString>;
+}, z.core.$strict>, z.ZodTransform<{
+    sourceIds: string[];
+    projectKey: string;
+    requestId: string;
+}, {
+    projectKey: string;
+    requestId: string;
+    sourceIds: string[];
+}>>;
+export declare const collectionControlAuditSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectKey: z.ZodString;
+    requestId: z.ZodString;
+    batchId: z.ZodString;
+    batchRef: z.ZodString;
+    tenantId: z.ZodString;
+    clientId: z.ZodString;
+    requestedAt: z.ZodISODateTime;
+    sourceIds: z.ZodArray<z.ZodString>;
+    sourceRevisionRefs: z.ZodArray<z.ZodString>;
+    admission: z.ZodLiteral<"ACCEPTED">;
+}, z.core.$strict>;
+export declare const collectionControlStatusSchema: z.ZodEnum<{
+    PENDING: "PENDING";
+    SUCCEEDED: "SUCCEEDED";
+    PARTIAL: "PARTIAL";
+    FAILED: "FAILED";
+}>;
+export declare const collectionControlRunSummarySchema: z.ZodObject<{
+    runId: z.ZodString;
+    runtimeNodeId: z.ZodString;
+    startedAt: z.ZodISODateTime;
+    finishedAt: z.ZodISODateTime;
+    status: z.ZodEnum<{
+        SUCCEEDED: "SUCCEEDED";
+        PARTIAL: "PARTIAL";
+        FAILED: "FAILED";
+    }>;
+}, z.core.$strict>;
+export declare const collectionControlRequestProjectionSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectKey: z.ZodString;
+    requestId: z.ZodString;
+    batchId: z.ZodString;
+    batchRef: z.ZodString;
+    trigger: z.ZodLiteral<"MANUAL">;
+    status: z.ZodEnum<{
+        PENDING: "PENDING";
+        SUCCEEDED: "SUCCEEDED";
+        PARTIAL: "PARTIAL";
+        FAILED: "FAILED";
+    }>;
+    requestedAt: z.ZodISODateTime;
+    requestedBy: z.ZodObject<{
+        tenantId: z.ZodString;
+        clientId: z.ZodString;
+    }, z.core.$strict>;
+    sourceIds: z.ZodArray<z.ZodString>;
+    sourceRevisionRefs: z.ZodArray<z.ZodString>;
+    run: z.ZodNullable<z.ZodObject<{
+        runId: z.ZodString;
+        runtimeNodeId: z.ZodString;
+        startedAt: z.ZodISODateTime;
+        finishedAt: z.ZodISODateTime;
+        status: z.ZodEnum<{
+            SUCCEEDED: "SUCCEEDED";
+            PARTIAL: "PARTIAL";
+            FAILED: "FAILED";
+        }>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const collectionControlCreateResponseSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    inserted: z.ZodBoolean;
+    request: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        projectKey: z.ZodString;
+        requestId: z.ZodString;
+        batchId: z.ZodString;
+        batchRef: z.ZodString;
+        trigger: z.ZodLiteral<"MANUAL">;
+        status: z.ZodEnum<{
+            PENDING: "PENDING";
+            SUCCEEDED: "SUCCEEDED";
+            PARTIAL: "PARTIAL";
+            FAILED: "FAILED";
+        }>;
+        requestedAt: z.ZodISODateTime;
+        requestedBy: z.ZodObject<{
+            tenantId: z.ZodString;
+            clientId: z.ZodString;
+        }, z.core.$strict>;
+        sourceIds: z.ZodArray<z.ZodString>;
+        sourceRevisionRefs: z.ZodArray<z.ZodString>;
+        run: z.ZodNullable<z.ZodObject<{
+            runId: z.ZodString;
+            runtimeNodeId: z.ZodString;
+            startedAt: z.ZodISODateTime;
+            finishedAt: z.ZodISODateTime;
+            status: z.ZodEnum<{
+                SUCCEEDED: "SUCCEEDED";
+                PARTIAL: "PARTIAL";
+                FAILED: "FAILED";
+            }>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const collectionControlGetResponseSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    request: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        projectKey: z.ZodString;
+        requestId: z.ZodString;
+        batchId: z.ZodString;
+        batchRef: z.ZodString;
+        trigger: z.ZodLiteral<"MANUAL">;
+        status: z.ZodEnum<{
+            PENDING: "PENDING";
+            SUCCEEDED: "SUCCEEDED";
+            PARTIAL: "PARTIAL";
+            FAILED: "FAILED";
+        }>;
+        requestedAt: z.ZodISODateTime;
+        requestedBy: z.ZodObject<{
+            tenantId: z.ZodString;
+            clientId: z.ZodString;
+        }, z.core.$strict>;
+        sourceIds: z.ZodArray<z.ZodString>;
+        sourceRevisionRefs: z.ZodArray<z.ZodString>;
+        run: z.ZodNullable<z.ZodObject<{
+            runId: z.ZodString;
+            runtimeNodeId: z.ZodString;
+            startedAt: z.ZodISODateTime;
+            finishedAt: z.ZodISODateTime;
+            status: z.ZodEnum<{
+                SUCCEEDED: "SUCCEEDED";
+                PARTIAL: "PARTIAL";
+                FAILED: "FAILED";
+            }>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type KnowledgeControlScope = z.infer<typeof knowledgeControlScopeSchema>;
+export type CollectionControlCreateRequest = z.infer<typeof collectionControlCreateRequestSchema>;
+export type CollectionControlAudit = z.infer<typeof collectionControlAuditSchema>;
+export type CollectionControlStatus = z.infer<typeof collectionControlStatusSchema>;
+export type CollectionControlRequestProjection = z.infer<typeof collectionControlRequestProjectionSchema>;

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

@@ -0,0 +1,263 @@
+import { z } from 'zod';
+export declare const collectionBatchSourceBindingSchema: z.ZodObject<{
+    sourceId: z.ZodString;
+    sourceRef: z.ZodString;
+    sourceRevisionRef: z.ZodString;
+    targetId: z.ZodString;
+}, z.core.$strict>;
+/** The collector-facing task deliberately contains no project/source-family semantics. */
+export declare const collectionTaskSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    targetId: z.ZodString;
+    target: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"URL">;
+        locator: z.ZodURL;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"FILE">;
+        rootBinding: z.ZodString;
+        relativePath: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"EXECUTOR">;
+        executorId: z.ZodString;
+        bindingRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>]>>>;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>;
+export declare const collectionBatchTriggerSchema: z.ZodEnum<{
+    MANUAL: "MANUAL";
+    DUE: "DUE";
+}>;
+export declare const collectionBatchSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectKey: z.ZodString;
+    projectRef: z.ZodString;
+    projectIntentRef: z.ZodString;
+    requestId: z.ZodString;
+    batchId: z.ZodString;
+    batchRef: z.ZodString;
+    trigger: z.ZodDefault<z.ZodEnum<{
+        MANUAL: "MANUAL";
+        DUE: "DUE";
+    }>>;
+    createdAt: z.ZodISODateTime;
+    sourceBindings: z.ZodArray<z.ZodObject<{
+        sourceId: z.ZodString;
+        sourceRef: z.ZodString;
+        sourceRevisionRef: z.ZodString;
+        targetId: z.ZodString;
+    }, z.core.$strict>>;
+    tasks: z.ZodArray<z.ZodObject<{
+        taskId: z.ZodString;
+        targetId: z.ZodString;
+        target: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"URL">;
+            locator: z.ZodURL;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"FILE">;
+            rootBinding: z.ZodString;
+            relativePath: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"EXECUTOR">;
+            executorId: z.ZodString;
+            bindingRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>]>>>;
+        }, z.core.$strict>], "kind">;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const collectorBatchViewSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    batchId: z.ZodString;
+    tasks: z.ZodArray<z.ZodObject<{
+        taskId: z.ZodString;
+        targetId: z.ZodString;
+        target: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"URL">;
+            locator: z.ZodURL;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"FILE">;
+            rootBinding: z.ZodString;
+            relativePath: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"EXECUTOR">;
+            executorId: z.ZodString;
+            bindingRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>]>>>;
+        }, z.core.$strict>], "kind">;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const sourceCollectionDueReasonSchema: z.ZodEnum<{
+    MANUAL: "MANUAL";
+    DISABLED: "DISABLED";
+    PENDING_BATCH: "PENDING_BATCH";
+    SPECIALIZED_EXECUTOR: "SPECIALIZED_EXECUTOR";
+    SPECIALIZED_COLLECTOR: "SPECIALIZED_COLLECTOR";
+    NEVER_ATTEMPTED: "NEVER_ATTEMPTED";
+    INTERVAL_WAIT: "INTERVAL_WAIT";
+    INTERVAL_ELAPSED: "INTERVAL_ELAPSED";
+}>;
+export declare const sourceCollectionDueEntrySchema: z.ZodObject<{
+    sourceId: z.ZodString;
+    sourceRef: z.ZodString;
+    sourceRevisionRef: z.ZodString;
+    enabled: z.ZodBoolean;
+    refresh: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        mode: z.ZodLiteral<"MANUAL">;
+    }, z.core.$strict>, z.ZodObject<{
+        mode: z.ZodLiteral<"INTERVAL">;
+        intervalSeconds: z.ZodNumber;
+    }, z.core.$strict>], "mode">;
+    lastAttemptAt: z.ZodNullable<z.ZodISODateTime>;
+    lastState: z.ZodNullable<z.ZodEnum<{
+        ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+        FAILED: "FAILED";
+        ACQUIRED: "ACQUIRED";
+        HTTP_TERMINAL: "HTTP_TERMINAL";
+    }>>;
+    lastBatchRef: z.ZodNullable<z.ZodString>;
+    lastRunId: z.ZodNullable<z.ZodString>;
+    pendingBatchRef: z.ZodNullable<z.ZodString>;
+    nextDueAt: z.ZodNullable<z.ZodISODateTime>;
+    due: z.ZodBoolean;
+    reason: z.ZodEnum<{
+        MANUAL: "MANUAL";
+        DISABLED: "DISABLED";
+        PENDING_BATCH: "PENDING_BATCH";
+        SPECIALIZED_EXECUTOR: "SPECIALIZED_EXECUTOR";
+        SPECIALIZED_COLLECTOR: "SPECIALIZED_COLLECTOR";
+        NEVER_ATTEMPTED: "NEVER_ATTEMPTED";
+        INTERVAL_WAIT: "INTERVAL_WAIT";
+        INTERVAL_ELAPSED: "INTERVAL_ELAPSED";
+    }>;
+}, z.core.$strict>;
+export declare const projectCollectionDuePlanSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectKey: z.ZodString;
+    projectRef: z.ZodString;
+    projectIntentRef: z.ZodString;
+    assessedAt: z.ZodISODateTime;
+    sourceCount: z.ZodNumber;
+    dueSourceCount: z.ZodNumber;
+    dueSourceIds: z.ZodArray<z.ZodString>;
+    sources: z.ZodArray<z.ZodObject<{
+        sourceId: z.ZodString;
+        sourceRef: z.ZodString;
+        sourceRevisionRef: z.ZodString;
+        enabled: z.ZodBoolean;
+        refresh: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            mode: z.ZodLiteral<"MANUAL">;
+        }, z.core.$strict>, z.ZodObject<{
+            mode: z.ZodLiteral<"INTERVAL">;
+            intervalSeconds: z.ZodNumber;
+        }, z.core.$strict>], "mode">;
+        lastAttemptAt: z.ZodNullable<z.ZodISODateTime>;
+        lastState: z.ZodNullable<z.ZodEnum<{
+            ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+            FAILED: "FAILED";
+            ACQUIRED: "ACQUIRED";
+            HTTP_TERMINAL: "HTTP_TERMINAL";
+        }>>;
+        lastBatchRef: z.ZodNullable<z.ZodString>;
+        lastRunId: z.ZodNullable<z.ZodString>;
+        pendingBatchRef: z.ZodNullable<z.ZodString>;
+        nextDueAt: z.ZodNullable<z.ZodISODateTime>;
+        due: z.ZodBoolean;
+        reason: z.ZodEnum<{
+            MANUAL: "MANUAL";
+            DISABLED: "DISABLED";
+            PENDING_BATCH: "PENDING_BATCH";
+            SPECIALIZED_EXECUTOR: "SPECIALIZED_EXECUTOR";
+            SPECIALIZED_COLLECTOR: "SPECIALIZED_COLLECTOR";
+            NEVER_ATTEMPTED: "NEVER_ATTEMPTED";
+            INTERVAL_WAIT: "INTERVAL_WAIT";
+            INTERVAL_ELAPSED: "INTERVAL_ELAPSED";
+        }>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const collectionTaskRunResultSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    targetId: z.ZodString;
+    sourceId: z.ZodString;
+    sourceRevisionRef: z.ZodString;
+    observedAt: z.ZodISODateTime;
+    state: z.ZodEnum<{
+        ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+        FAILED: "FAILED";
+        ACQUIRED: "ACQUIRED";
+        HTTP_TERMINAL: "HTTP_TERMINAL";
+    }>;
+    finalLocator: z.ZodNullable<z.ZodString>;
+    httpStatus: z.ZodNullable<z.ZodNumber>;
+    evidenceRef: z.ZodNullable<z.ZodString>;
+    contentHash: z.ZodNullable<z.ZodString>;
+    byteLength: z.ZodNullable<z.ZodNumber>;
+    mediaType: z.ZodNullable<z.ZodString>;
+    reusedEvidence: z.ZodBoolean;
+    relatedEvidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    richDocumentRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    projectionJobId: z.ZodOptional<z.ZodString>;
+    projectionState: z.ZodOptional<z.ZodEnum<{
+        PENDING: "PENDING";
+        SUCCEEDED: "SUCCEEDED";
+        PARTIAL: "PARTIAL";
+        FAILED: "FAILED";
+        NOT_REQUIRED: "NOT_REQUIRED";
+    }>>;
+    errorCode: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export declare const collectionRunReceiptSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectKey: z.ZodString;
+    projectRef: z.ZodString;
+    batchId: z.ZodString;
+    batchRef: z.ZodString;
+    runId: z.ZodString;
+    runtimeNodeId: z.ZodString;
+    startedAt: z.ZodISODateTime;
+    finishedAt: z.ZodISODateTime;
+    status: z.ZodEnum<{
+        SUCCEEDED: "SUCCEEDED";
+        PARTIAL: "PARTIAL";
+        FAILED: "FAILED";
+    }>;
+    results: z.ZodArray<z.ZodObject<{
+        taskId: z.ZodString;
+        targetId: z.ZodString;
+        sourceId: z.ZodString;
+        sourceRevisionRef: z.ZodString;
+        observedAt: z.ZodISODateTime;
+        state: z.ZodEnum<{
+            ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+            FAILED: "FAILED";
+            ACQUIRED: "ACQUIRED";
+            HTTP_TERMINAL: "HTTP_TERMINAL";
+        }>;
+        finalLocator: z.ZodNullable<z.ZodString>;
+        httpStatus: z.ZodNullable<z.ZodNumber>;
+        evidenceRef: z.ZodNullable<z.ZodString>;
+        contentHash: z.ZodNullable<z.ZodString>;
+        byteLength: z.ZodNullable<z.ZodNumber>;
+        mediaType: z.ZodNullable<z.ZodString>;
+        reusedEvidence: z.ZodBoolean;
+        relatedEvidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        richDocumentRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        projectionJobId: z.ZodOptional<z.ZodString>;
+        projectionState: z.ZodOptional<z.ZodEnum<{
+            PENDING: "PENDING";
+            SUCCEEDED: "SUCCEEDED";
+            PARTIAL: "PARTIAL";
+            FAILED: "FAILED";
+            NOT_REQUIRED: "NOT_REQUIRED";
+        }>>;
+        errorCode: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type SourceCollectionDueReason = z.infer<typeof sourceCollectionDueReasonSchema>;
+export type SourceCollectionDueEntry = z.infer<typeof sourceCollectionDueEntrySchema>;
+export type ProjectCollectionDuePlan = z.infer<typeof projectCollectionDuePlanSchema>;
+export type CollectionBatchTrigger = z.infer<typeof collectionBatchTriggerSchema>;
+export type CollectionBatchSourceBinding = z.infer<typeof collectionBatchSourceBindingSchema>;
+export type CollectionTask = z.infer<typeof collectionTaskSchema>;
+export type CollectionBatch = z.infer<typeof collectionBatchSchema>;
+export type CollectorBatchView = z.infer<typeof collectorBatchViewSchema>;
+export type CollectionTaskRunResult = z.infer<typeof collectionTaskRunResultSchema>;
+export type CollectionRunReceipt = z.infer<typeof collectionRunReceiptSchema>;

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

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+export declare const schemaVersionSchema: z.ZodLiteral<1>;
+export declare const idSchema: z.ZodString;
+export declare const projectKeySchema: z.ZodString;
+export declare const isoDateTimeSchema: z.ZodISODateTime;
+export declare const sha256Schema: z.ZodString;
+export declare const stableUriSchema: z.ZodString;
+export declare const accessClassificationSchema: z.ZodEnum<{
+    PUBLIC: "PUBLIC";
+    PUBLIC_METADATA: "PUBLIC_METADATA";
+    TENANT: "TENANT";
+    INTERNAL: "INTERNAL";
+    FDE_INTERNAL: "FDE_INTERNAL";
+    ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+    UNKNOWN: "UNKNOWN";
+}>;
+export type AccessClassification = z.infer<typeof accessClassificationSchema>;