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

package/dist/internal/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>;

package/dist/internal/contracts/material-read.js

@@ -0,0 +1,12 @@
+/** Retrieval permissions and immutable descriptors, independent of business usage decisions. */
+import { z } from 'zod';
+import { accessClassificationSchema, idSchema, isoDateTimeSchema, projectKeySchema, schemaVersionSchema, sha256Schema, stableUriSchema } from './common.js';
+import { materialResourceTypeSchema } from './material-carrier.js';
+export const rawRetrievalProblemSchema = z.enum(['NOT_FOUND', 'CONTENT_ACCESS_DENIED', 'INTEGRITY_MISMATCH', 'UNAVAILABLE', 'UNSUPPORTED_RESOURCE']);
+export const rawRetrievalDecisionSchema = z.object({ schemaVersion: schemaVersionSchema, action: z.enum(['ALLOW', 'DENY']), reasonCodes: z.array(rawRetrievalProblemSchema).max(32), assessedAt: isoDateTimeSchema }).strict().superRefine((value, ctx) => { if ((value.action === 'ALLOW') !== (value.reasonCodes.length === 0))
+    ctx.addIssue({ code: 'custom', path: ['reasonCodes'], message: 'Retrieval decision and reasons must agree' }); });
+export const rawContentDescriptorSchema = z.object({ contentHash: sha256Schema, mediaType: z.string().trim().min(1).max(256), byteLength: z.number().int().nonnegative().safe() }).strict();
+export const rawArtifactSummarySchema = z.object({ ref: stableUriSchema, identityRef: stableUriSchema, projectKey: projectKeySchema, projectRef: stableUriSchema.nullable().default(null), artifactId: idSchema, kind: z.string().trim().min(1).max(128), version: z.number().int().positive(), status: z.string().trim().min(1).max(128), access: accessClassificationSchema, title: z.string().max(500).nullable(), createdAt: isoDateTimeSchema, observedAt: isoDateTimeSchema.nullable(), validUntil: isoDateTimeSchema.nullable(), content: rawContentDescriptorSchema }).strict();
+export const rawArtifactDetailSchema = rawArtifactSummarySchema.extend({ evidenceRefs: z.array(stableUriSchema).max(256), relatedRefs: z.array(stableUriSchema).max(256), supersedesRef: stableUriSchema.nullable() }).strict();
+export const rawEvidenceSummarySchema = z.object({ evidenceRef: stableUriSchema, projectKey: projectKeySchema, sourceId: idSchema, contentHash: sha256Schema, observedAt: isoDateTimeSchema, access: accessClassificationSchema, canonicalUri: stableUriSchema.nullable(), mediaType: z.string().max(256).nullable(), byteLength: z.number().int().nonnegative().safe().nullable(), projectRef: stableUriSchema.nullable().default(null), sourceSetRef: stableUriSchema.nullable(), sourceItemId: idSchema.nullable(), sourceRevisionRef: stableUriSchema.nullable().default(null), collectionBatchRef: stableUriSchema.nullable().default(null), collectionTaskId: idSchema.nullable().default(null) }).strict();
+export const rawMaterialDirectoryItemSchema = z.object({ ref: stableUriSchema, resourceType: materialResourceTypeSchema, sourceProjectKey: projectKeySchema, identityHash: sha256Schema, kind: z.string().min(1).max(128), classification: accessClassificationSchema, mediaType: z.string().min(1).max(256), decision: rawRetrievalDecisionSchema }).strict();

package/dist/internal/contracts/observation.d.ts

@@ -0,0 +1,75 @@
+import { z } from 'zod';
+export declare const observationKindSchema: z.ZodEnum<{
+    SOURCE_FAILURE: "SOURCE_FAILURE";
+    OTHER: "OTHER";
+    SOURCE_CHANGE: "SOURCE_CHANGE";
+    WORLD_SIGNAL: "WORLD_SIGNAL";
+    BUSINESS_FEEDBACK: "BUSINESS_FEEDBACK";
+    AGENT_EVALUATION: "AGENT_EVALUATION";
+    CONTENT_FEEDBACK: "CONTENT_FEEDBACK";
+}>;
+export declare const observationSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    observationId: z.ZodString;
+    projectKey: z.ZodOptional<z.ZodString>;
+    projectRef: z.ZodOptional<z.ZodString>;
+    kind: z.ZodEnum<{
+        SOURCE_FAILURE: "SOURCE_FAILURE";
+        OTHER: "OTHER";
+        SOURCE_CHANGE: "SOURCE_CHANGE";
+        WORLD_SIGNAL: "WORLD_SIGNAL";
+        BUSINESS_FEEDBACK: "BUSINESS_FEEDBACK";
+        AGENT_EVALUATION: "AGENT_EVALUATION";
+        CONTENT_FEEDBACK: "CONTENT_FEEDBACK";
+    }>;
+    observedAt: z.ZodISODateTime;
+    expiresAt: z.ZodOptional<z.ZodISODateTime>;
+    evidenceRefs: z.ZodArray<z.ZodString>;
+    payloadHash: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const signalLaneSchema: z.ZodEnum<{
+    OTHER: "OTHER";
+    DEMAND: "DEMAND";
+    PAIN: "PAIN";
+    COMMERCIAL: "COMMERCIAL";
+}>;
+export declare const velocityStateSchema: z.ZodEnum<{
+    UNKNOWN: "UNKNOWN";
+    NEW: "NEW";
+    RISING: "RISING";
+    STABLE: "STABLE";
+    FALLING: "FALLING";
+    REAPPEARED: "REAPPEARED";
+}>;
+export declare const signalObservationSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    observationId: z.ZodString;
+    projectKey: z.ZodOptional<z.ZodString>;
+    projectRef: z.ZodOptional<z.ZodString>;
+    observedAt: z.ZodISODateTime;
+    evidenceRefs: z.ZodArray<z.ZodString>;
+    signalFamily: z.ZodString;
+    subject: z.ZodString;
+    lanes: z.ZodArray<z.ZodEnum<{
+        OTHER: "OTHER";
+        DEMAND: "DEMAND";
+        PAIN: "PAIN";
+        COMMERCIAL: "COMMERCIAL";
+    }>>;
+    velocity: z.ZodEnum<{
+        UNKNOWN: "UNKNOWN";
+        NEW: "NEW";
+        RISING: "RISING";
+        STABLE: "STABLE";
+        FALLING: "FALLING";
+        REAPPEARED: "REAPPEARED";
+    }>;
+    attentionScore: z.ZodOptional<z.ZodNumber>;
+    sourceCount: z.ZodNumber;
+}, z.core.$strict>;
+export type ObservationKind = z.infer<typeof observationKindSchema>;
+export type Observation = z.infer<typeof observationSchema>;
+export type SignalLane = z.infer<typeof signalLaneSchema>;
+export type VelocityState = z.infer<typeof velocityStateSchema>;
+export type SignalObservation = z.infer<typeof signalObservationSchema>;

package/dist/internal/contracts/observation.js

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+import { idSchema, isoDateTimeSchema, projectKeySchema, schemaVersionSchema, sha256Schema, stableUriSchema, } from './common.js';
+export const observationKindSchema = z.enum([
+    'SOURCE_CHANGE',
+    'WORLD_SIGNAL',
+    'SOURCE_FAILURE',
+    'BUSINESS_FEEDBACK',
+    'AGENT_EVALUATION',
+    'CONTENT_FEEDBACK',
+    'OTHER',
+]);
+export const observationSchema = z.object({
+    schemaVersion: schemaVersionSchema,
+    observationId: idSchema,
+    projectKey: projectKeySchema.optional(),
+    projectRef: stableUriSchema.optional(),
+    kind: observationKindSchema,
+    observedAt: isoDateTimeSchema,
+    expiresAt: isoDateTimeSchema.optional(),
+    evidenceRefs: z.array(stableUriSchema).min(1).max(256),
+    payloadHash: sha256Schema.optional(),
+    summary: z.string().trim().min(1).max(4000).optional(),
+}).strict();
+export const signalLaneSchema = z.enum(['DEMAND', 'PAIN', 'COMMERCIAL', 'OTHER']);
+export const velocityStateSchema = z.enum(['NEW', 'RISING', 'STABLE', 'FALLING', 'REAPPEARED', 'UNKNOWN']);
+export const signalObservationSchema = z.object({
+    schemaVersion: schemaVersionSchema,
+    observationId: idSchema,
+    projectKey: projectKeySchema.optional(),
+    projectRef: stableUriSchema.optional(),
+    observedAt: isoDateTimeSchema,
+    evidenceRefs: z.array(stableUriSchema).min(1).max(256),
+    signalFamily: z.string().trim().min(1).max(128),
+    subject: z.string().trim().min(1).max(1000),
+    lanes: z.array(signalLaneSchema).min(1).max(4),
+    velocity: velocityStateSchema,
+    attentionScore: z.number().finite().optional(),
+    sourceCount: z.number().int().nonnegative(),
+}).strict();

package/dist/internal/contracts/persistence.d.ts

@@ -0,0 +1,370 @@
+import { z } from 'zod';
+export declare const portableRelativePathSchema: z.ZodString;
+export declare const sourceSetRegistryHashSchema: z.ZodObject<{
+    acquisitionSourceId: z.ZodString;
+    relativePath: z.ZodString;
+    contentHash: z.ZodString;
+}, z.core.$strict>;
+export declare const sourceSetItemBindingSchema: z.ZodObject<{
+    acquisitionSourceId: z.ZodString;
+    concreteSourceId: z.ZodString;
+    authority: z.ZodNullable<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";
+    }>;
+    declaredGitSha: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export declare const sourceSetItemSchema: z.ZodObject<{
+    itemId: z.ZodString;
+    kind: z.ZodEnum<{
+        FILE: "FILE";
+        WEB: "WEB";
+    }>;
+    logicalSourceRef: z.ZodString;
+    sourceIds: z.ZodArray<z.ZodString>;
+    bindings: z.ZodArray<z.ZodObject<{
+        acquisitionSourceId: z.ZodString;
+        concreteSourceId: z.ZodString;
+        authority: z.ZodNullable<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";
+        }>;
+        declaredGitSha: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    contentPolicy: z.ZodEnum<{
+        "public-excerpt": "public-excerpt";
+        "metadata-only": "metadata-only";
+    }>;
+    cadenceMs: z.ZodNumber;
+    url: z.ZodNullable<z.ZodURL>;
+    rootBinding: z.ZodNullable<z.ZodString>;
+    relativePath: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export declare const sourceSetLogicalSourceSchema: z.ZodObject<{
+    logicalSourceId: z.ZodString;
+    familyId: z.ZodString;
+    declaredState: z.ZodEnum<{
+        ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+        CONFIGURED: "CONFIGURED";
+        PENDING_DISCOVERY: "PENDING_DISCOVERY";
+        KNOWN_MISSING: "KNOWN_MISSING";
+        NEED_AUTHORIZED_SOURCE: "NEED_AUTHORIZED_SOURCE";
+        DEFERRED: "DEFERRED";
+        RETIRED: "RETIRED";
+    }>;
+    locator: z.ZodNullable<z.ZodString>;
+    acquisitionSourceIds: z.ZodArray<z.ZodString>;
+    itemIds: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export declare const sourceSetSnapshotSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    sourceSetId: z.ZodString;
+    sourceSetRef: z.ZodString;
+    projectKey: z.ZodString;
+    programRevision: z.ZodString;
+    acquisitionConfigHash: z.ZodString;
+    sourceUniverseHash: z.ZodNullable<z.ZodString>;
+    registryHashes: z.ZodArray<z.ZodObject<{
+        acquisitionSourceId: z.ZodString;
+        relativePath: z.ZodString;
+        contentHash: z.ZodString;
+    }, z.core.$strict>>;
+    items: z.ZodArray<z.ZodObject<{
+        itemId: z.ZodString;
+        kind: z.ZodEnum<{
+            FILE: "FILE";
+            WEB: "WEB";
+        }>;
+        logicalSourceRef: z.ZodString;
+        sourceIds: z.ZodArray<z.ZodString>;
+        bindings: z.ZodArray<z.ZodObject<{
+            acquisitionSourceId: z.ZodString;
+            concreteSourceId: z.ZodString;
+            authority: z.ZodNullable<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";
+            }>;
+            declaredGitSha: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+        contentPolicy: z.ZodEnum<{
+            "public-excerpt": "public-excerpt";
+            "metadata-only": "metadata-only";
+        }>;
+        cadenceMs: z.ZodNumber;
+        url: z.ZodNullable<z.ZodURL>;
+        rootBinding: z.ZodNullable<z.ZodString>;
+        relativePath: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    logicalSources: z.ZodArray<z.ZodObject<{
+        logicalSourceId: z.ZodString;
+        familyId: z.ZodString;
+        declaredState: z.ZodEnum<{
+            ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+            CONFIGURED: "CONFIGURED";
+            PENDING_DISCOVERY: "PENDING_DISCOVERY";
+            KNOWN_MISSING: "KNOWN_MISSING";
+            NEED_AUTHORIZED_SOURCE: "NEED_AUTHORIZED_SOURCE";
+            DEFERRED: "DEFERRED";
+            RETIRED: "RETIRED";
+        }>;
+        locator: z.ZodNullable<z.ZodString>;
+        acquisitionSourceIds: z.ZodArray<z.ZodString>;
+        itemIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const sourceSetPointerSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectKey: z.ZodString;
+    sourceSetId: z.ZodString;
+    sourceSetRef: z.ZodString;
+    manifestRelativePath: z.ZodString;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export declare const libraryProjectionSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectionId: z.ZodString;
+    projectKey: z.ZodString;
+    subjectType: z.ZodEnum<{
+        EVIDENCE: "EVIDENCE";
+        ARTIFACT: "ARTIFACT";
+    }>;
+    subjectRef: z.ZodString;
+    contentHash: z.ZodString;
+    mediaType: z.ZodString;
+    byteLength: z.ZodNumber;
+    relativePath: z.ZodString;
+    manifestRelativePath: z.ZodString;
+}, z.core.$strict>;
+export declare const deliverySupportProofSchema: z.ZodObject<{
+    action: z.ZodLiteral<"ALLOW">;
+    supportState: z.ZodString;
+    semanticHash: z.ZodString;
+}, z.core.$strict>;
+export declare const deliveryConsumerRequestSchema: z.ZodObject<{
+    mediaType: z.ZodString;
+    contentHash: z.ZodString;
+    byteLength: z.ZodNumber;
+}, z.core.$strict>;
+export declare const knowledgeDeliveryEnvelopeSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    deliveryId: z.ZodString;
+    producerProjectKey: z.ZodString;
+    producerProjectRef: z.ZodOptional<z.ZodString>;
+    consumerKey: z.ZodString;
+    artifactRef: z.ZodString;
+    artifactKind: z.ZodEnum<{
+        SIGNAL_GENERATION: "SIGNAL_GENERATION";
+        RESEARCH: "RESEARCH";
+        REVIEW: "REVIEW";
+        KNOWLEDGE: "KNOWLEDGE";
+        INSIGHT: "INSIGHT";
+    }>;
+    artifactAccess: z.ZodEnum<{
+        PUBLIC: "PUBLIC";
+        PUBLIC_METADATA: "PUBLIC_METADATA";
+        TENANT: "TENANT";
+        INTERNAL: "INTERNAL";
+        FDE_INTERNAL: "FDE_INTERNAL";
+        ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+        UNKNOWN: "UNKNOWN";
+    }>;
+    contentHash: z.ZodString;
+    mediaType: z.ZodString;
+    byteLength: z.ZodNumber;
+    libraryPath: z.ZodString;
+    observedAt: z.ZodNullable<z.ZodISODateTime>;
+    validUntil: z.ZodNullable<z.ZodISODateTime>;
+    support: z.ZodNullable<z.ZodObject<{
+        action: z.ZodLiteral<"ALLOW">;
+        supportState: z.ZodString;
+        semanticHash: z.ZodString;
+    }, z.core.$strict>>;
+    consumerRequest: z.ZodNullable<z.ZodObject<{
+        mediaType: z.ZodString;
+        contentHash: z.ZodString;
+        byteLength: z.ZodNumber;
+    }, z.core.$strict>>;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export declare const knowledgeDeliveryClaimSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    deliveryId: z.ZodString;
+    producerProjectKey: z.ZodString;
+    producerProjectRef: z.ZodOptional<z.ZodString>;
+    consumerKey: z.ZodString;
+    claimId: z.ZodString;
+    workerId: z.ZodString;
+    claimedAt: z.ZodISODateTime;
+    expiresAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export declare const knowledgeDeliveryOutcomeSchema: z.ZodEnum<{
+    BLOCKED: "BLOCKED";
+    DELIVERED: "DELIVERED";
+    FAILED_RETRYABLE: "FAILED_RETRYABLE";
+    FAILED_TERMINAL: "FAILED_TERMINAL";
+}>;
+export declare const knowledgeDeliveryReceiptSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    deliveryId: z.ZodString;
+    producerProjectKey: z.ZodString;
+    producerProjectRef: z.ZodOptional<z.ZodString>;
+    consumerKey: z.ZodString;
+    artifactRef: z.ZodString;
+    contentHash: z.ZodString;
+    outcome: z.ZodEnum<{
+        BLOCKED: "BLOCKED";
+        DELIVERED: "DELIVERED";
+        FAILED_RETRYABLE: "FAILED_RETRYABLE";
+        FAILED_TERMINAL: "FAILED_TERMINAL";
+    }>;
+    attempts: z.ZodNumber;
+    deliveredAt: z.ZodISODateTime;
+    nextAttemptAt: z.ZodNullable<z.ZodISODateTime>;
+    externalRef: z.ZodNullable<z.ZodString>;
+    consumerResponseHash: z.ZodNullable<z.ZodString>;
+    message: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export declare const distributionConsumerSchema: z.ZodObject<{
+    consumerKey: z.ZodString;
+    enabled: z.ZodBoolean;
+    artifactKinds: z.ZodArray<z.ZodEnum<{
+        SIGNAL_GENERATION: "SIGNAL_GENERATION";
+        RESEARCH: "RESEARCH";
+        REVIEW: "REVIEW";
+        KNOWLEDGE: "KNOWLEDGE";
+        INSIGHT: "INSIGHT";
+    }>>;
+    acceptedAccess: z.ZodArray<z.ZodEnum<{
+        PUBLIC: "PUBLIC";
+        PUBLIC_METADATA: "PUBLIC_METADATA";
+        TENANT: "TENANT";
+        INTERNAL: "INTERNAL";
+        FDE_INTERNAL: "FDE_INTERNAL";
+        ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+        UNKNOWN: "UNKNOWN";
+    }>>;
+    supportPolicy: z.ZodEnum<{
+        NONE: "NONE";
+        REQUIRE_ALLOW: "REQUIRE_ALLOW";
+    }>;
+    adapter: z.ZodString;
+}, z.core.$strict>;
+export declare const distributionConfigSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectKey: z.ZodString;
+    consumers: z.ZodArray<z.ZodObject<{
+        consumerKey: z.ZodString;
+        enabled: z.ZodBoolean;
+        artifactKinds: z.ZodArray<z.ZodEnum<{
+            SIGNAL_GENERATION: "SIGNAL_GENERATION";
+            RESEARCH: "RESEARCH";
+            REVIEW: "REVIEW";
+            KNOWLEDGE: "KNOWLEDGE";
+            INSIGHT: "INSIGHT";
+        }>>;
+        acceptedAccess: z.ZodArray<z.ZodEnum<{
+            PUBLIC: "PUBLIC";
+            PUBLIC_METADATA: "PUBLIC_METADATA";
+            TENANT: "TENANT";
+            INTERNAL: "INTERNAL";
+            FDE_INTERNAL: "FDE_INTERNAL";
+            ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+            UNKNOWN: "UNKNOWN";
+        }>>;
+        supportPolicy: z.ZodEnum<{
+            NONE: "NONE";
+            REQUIRE_ALLOW: "REQUIRE_ALLOW";
+        }>;
+        adapter: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type SourceSetSnapshot = z.infer<typeof sourceSetSnapshotSchema>;
+export type SourceSetPointer = z.infer<typeof sourceSetPointerSchema>;
+export type LibraryProjection = z.infer<typeof libraryProjectionSchema>;
+export type KnowledgeDeliveryEnvelope = z.infer<typeof knowledgeDeliveryEnvelopeSchema>;
+export type KnowledgeDeliveryClaim = z.infer<typeof knowledgeDeliveryClaimSchema>;
+export type KnowledgeDeliveryReceipt = z.infer<typeof knowledgeDeliveryReceiptSchema>;
+export type KnowledgeDeliveryOutcome = z.infer<typeof knowledgeDeliveryOutcomeSchema>;
+export type DistributionConfig = z.infer<typeof distributionConfigSchema>;
+export declare const durableEvidenceManifestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectKey: z.ZodString;
+    evidenceRef: z.ZodString;
+    evidence: 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>;
+}, z.core.$strict>;
+export type DurableEvidenceManifest = z.infer<typeof durableEvidenceManifestSchema>;