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

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

package/dist/types/contracts/project-intent.d.ts

@@ -0,0 +1,218 @@
+import { z } from 'zod';
+/**
+ * Attribution for an Agent-native Knowledge write. This is provenance, not an
+ * authorization decision. agentId is deliberately nullable because humans,
+ * schedulers and migrations may write without an Agent identity.
+ */
+export declare const knowledgeActorContextSchema: z.ZodObject<{
+    tenantId: z.ZodString;
+    userId: z.ZodString;
+    agentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export declare const projectIntentScopeSchema: z.ZodObject<{
+    scopeId: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    sourceRequirements: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    sourceFamilies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    notes: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export declare const projectIdentitySchema: z.ZodObject<{
+    name: z.ZodString;
+    summary: z.ZodString;
+    domains: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    notes: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export declare const projectIntentBasisSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectKey: z.ZodString;
+    actor: z.ZodObject<{
+        tenantId: z.ZodString;
+        userId: z.ZodString;
+        agentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>;
+    projectIdentity: z.ZodObject<{
+        name: z.ZodString;
+        summary: z.ZodString;
+        domains: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        notes: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>;
+    scopes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        scopeId: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        sourceRequirements: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        sourceFamilies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        notes: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export declare const projectIntentSnapshotSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectKey: z.ZodString;
+    actor: z.ZodObject<{
+        tenantId: z.ZodString;
+        userId: z.ZodString;
+        agentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>;
+    projectIdentity: z.ZodObject<{
+        name: z.ZodString;
+        summary: z.ZodString;
+        domains: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        notes: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>;
+    scopes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        scopeId: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        sourceRequirements: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        sourceFamilies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        notes: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>>;
+    projectRef: z.ZodString;
+    revisionId: z.ZodString;
+    revisionRef: z.ZodString;
+}, z.core.$strict>;
+export declare const projectIntentPointerSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectKey: z.ZodString;
+    tenantId: z.ZodString;
+    projectRef: z.ZodString;
+    revisionId: z.ZodString;
+    revisionRef: z.ZodString;
+    manifestRelativePath: z.ZodString;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export declare const collectionRefreshSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    mode: z.ZodLiteral<"MANUAL">;
+}, z.core.$strict>, z.ZodObject<{
+    mode: z.ZodLiteral<"INTERVAL">;
+    intervalSeconds: z.ZodNumber;
+}, z.core.$strict>], "mode">;
+export declare const acquisitionTargetSchema: 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">;
+export declare const projectSourceBasisSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectKey: z.ZodString;
+    actor: z.ZodObject<{
+        tenantId: z.ZodString;
+        userId: z.ZodString;
+        agentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>;
+    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">;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    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";
+    }>>;
+    scopeIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    sourceFamilies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    purpose: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    refresh: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        mode: z.ZodLiteral<"MANUAL">;
+    }, z.core.$strict>, z.ZodObject<{
+        mode: z.ZodLiteral<"INTERVAL">;
+        intervalSeconds: z.ZodNumber;
+    }, z.core.$strict>], "mode">>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+}, z.core.$strict>;
+export declare const projectSourceSnapshotSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectKey: z.ZodString;
+    actor: z.ZodObject<{
+        tenantId: z.ZodString;
+        userId: z.ZodString;
+        agentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>;
+    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">;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    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";
+    }>>;
+    scopeIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    sourceFamilies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    purpose: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    refresh: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        mode: z.ZodLiteral<"MANUAL">;
+    }, z.core.$strict>, z.ZodObject<{
+        mode: z.ZodLiteral<"INTERVAL">;
+        intervalSeconds: z.ZodNumber;
+    }, z.core.$strict>], "mode">>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+    projectRef: z.ZodString;
+    projectIntentRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    targetId: z.ZodString;
+    sourceId: z.ZodString;
+    revisionId: z.ZodString;
+    sourceRef: z.ZodString;
+    revisionRef: z.ZodString;
+}, z.core.$strict>;
+export declare const projectSourcePointerSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectKey: z.ZodString;
+    projectRef: z.ZodString;
+    projectIntentRef: z.ZodNullable<z.ZodString>;
+    sourceId: z.ZodString;
+    targetId: z.ZodString;
+    sourceRef: z.ZodString;
+    revisionId: z.ZodString;
+    revisionRef: z.ZodString;
+    manifestRelativePath: z.ZodString;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export type KnowledgeActorContext = z.infer<typeof knowledgeActorContextSchema>;
+export type ProjectIntentScope = z.infer<typeof projectIntentScopeSchema>;
+export type ProjectIdentity = z.infer<typeof projectIdentitySchema>;
+export type ProjectIntentBasis = z.infer<typeof projectIntentBasisSchema>;
+export type ProjectIntentSnapshot = z.infer<typeof projectIntentSnapshotSchema>;
+export type ProjectIntentPointer = z.infer<typeof projectIntentPointerSchema>;
+export type CollectionRefresh = z.infer<typeof collectionRefreshSchema>;
+export type AcquisitionTarget = z.infer<typeof acquisitionTargetSchema>;
+export type ProjectSourceBasis = z.infer<typeof projectSourceBasisSchema>;
+export type ProjectSourceSnapshot = z.infer<typeof projectSourceSnapshotSchema>;
+export type ProjectSourcePointer = z.infer<typeof projectSourcePointerSchema>;