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

package/dist/types/serving-contracts/core.d.ts

@@ -0,0 +1,333 @@
+import { referenceSelectorsSchema, referenceCorpusSummarySchema, referenceCorpusRecordSchema } from '../contracts/index.js';
+export { referenceRecordTypeSchema, referenceSelectorKeySchema, referenceSelectorValueSchema, referenceSelectorsSchema, referenceCurrentnessStateSchema, referenceCurrentnessSchema, referenceCorpusSummarySchema, referenceCorpusRecordSchema } from '../contracts/index.js';
+import { z } from 'zod';
+export declare const servingActionSchema: z.ZodEnum<{
+    ALLOW: "ALLOW";
+    REVIEW_REQUIRED: "REVIEW_REQUIRED";
+    DENY: "DENY";
+}>;
+export declare const servingProblemCodeSchema: z.ZodEnum<{
+    NOT_FOUND: "NOT_FOUND";
+    ACCESS_DENIED: "ACCESS_DENIED";
+    CONTENT_ACCESS_DENIED: "CONTENT_ACCESS_DENIED";
+    ARTIFACT_NOT_APPROVED: "ARTIFACT_NOT_APPROVED";
+    ARTIFACT_SUPERSEDED: "ARTIFACT_SUPERSEDED";
+    SEMANTIC_REVIEW_REQUIRED: "SEMANTIC_REVIEW_REQUIRED";
+    SEMANTIC_DENIED: "SEMANTIC_DENIED";
+    SEMANTIC_ADMISSION_MISSING: "SEMANTIC_ADMISSION_MISSING";
+    CURRENTNESS_MISSING: "CURRENTNESS_MISSING";
+    CURRENTNESS_REVIEW_REQUIRED: "CURRENTNESS_REVIEW_REQUIRED";
+    CURRENTNESS_DENIED: "CURRENTNESS_DENIED";
+    STALE: "STALE";
+    VALIDITY_EXPIRED: "VALIDITY_EXPIRED";
+    CLAIM_REVIEW_REQUIRED: "CLAIM_REVIEW_REQUIRED";
+    CLAIM_DENIED: "CLAIM_DENIED";
+    CLAIM_NOT_EFFECTIVE: "CLAIM_NOT_EFFECTIVE";
+    REFERENCE_NOT_COVERED: "REFERENCE_NOT_COVERED";
+    REFERENCE_NOT_EFFECTIVE: "REFERENCE_NOT_EFFECTIVE";
+    REFERENCE_VALIDITY_EXPIRED: "REFERENCE_VALIDITY_EXPIRED";
+    REFERENCE_STALE: "REFERENCE_STALE";
+    REFERENCE_UNAVAILABLE: "REFERENCE_UNAVAILABLE";
+    REFERENCE_REVIEW_REQUIRED: "REFERENCE_REVIEW_REQUIRED";
+    REFERENCE_DENIED: "REFERENCE_DENIED";
+    UNSUPPORTED_RESOURCE: "UNSUPPORTED_RESOURCE";
+    GOVERNANCE_NOT_CONFIGURED: "GOVERNANCE_NOT_CONFIGURED";
+    UNAVAILABLE: "UNAVAILABLE";
+    INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+}>;
+export declare const servingDecisionSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    action: z.ZodEnum<{
+        ALLOW: "ALLOW";
+        REVIEW_REQUIRED: "REVIEW_REQUIRED";
+        DENY: "DENY";
+    }>;
+    reasonCodes: z.ZodArray<z.ZodEnum<{
+        NOT_FOUND: "NOT_FOUND";
+        ACCESS_DENIED: "ACCESS_DENIED";
+        CONTENT_ACCESS_DENIED: "CONTENT_ACCESS_DENIED";
+        ARTIFACT_NOT_APPROVED: "ARTIFACT_NOT_APPROVED";
+        ARTIFACT_SUPERSEDED: "ARTIFACT_SUPERSEDED";
+        SEMANTIC_REVIEW_REQUIRED: "SEMANTIC_REVIEW_REQUIRED";
+        SEMANTIC_DENIED: "SEMANTIC_DENIED";
+        SEMANTIC_ADMISSION_MISSING: "SEMANTIC_ADMISSION_MISSING";
+        CURRENTNESS_MISSING: "CURRENTNESS_MISSING";
+        CURRENTNESS_REVIEW_REQUIRED: "CURRENTNESS_REVIEW_REQUIRED";
+        CURRENTNESS_DENIED: "CURRENTNESS_DENIED";
+        STALE: "STALE";
+        VALIDITY_EXPIRED: "VALIDITY_EXPIRED";
+        CLAIM_REVIEW_REQUIRED: "CLAIM_REVIEW_REQUIRED";
+        CLAIM_DENIED: "CLAIM_DENIED";
+        CLAIM_NOT_EFFECTIVE: "CLAIM_NOT_EFFECTIVE";
+        REFERENCE_NOT_COVERED: "REFERENCE_NOT_COVERED";
+        REFERENCE_NOT_EFFECTIVE: "REFERENCE_NOT_EFFECTIVE";
+        REFERENCE_VALIDITY_EXPIRED: "REFERENCE_VALIDITY_EXPIRED";
+        REFERENCE_STALE: "REFERENCE_STALE";
+        REFERENCE_UNAVAILABLE: "REFERENCE_UNAVAILABLE";
+        REFERENCE_REVIEW_REQUIRED: "REFERENCE_REVIEW_REQUIRED";
+        REFERENCE_DENIED: "REFERENCE_DENIED";
+        UNSUPPORTED_RESOURCE: "UNSUPPORTED_RESOURCE";
+        GOVERNANCE_NOT_CONFIGURED: "GOVERNANCE_NOT_CONFIGURED";
+        UNAVAILABLE: "UNAVAILABLE";
+        INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+    }>>;
+    assessedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export declare const consumerProfileSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    consumerKey: z.ZodString;
+    acceptedArtifactKinds: 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";
+    }>>;
+    contentAccess: z.ZodArray<z.ZodEnum<{
+        PUBLIC: "PUBLIC";
+        PUBLIC_METADATA: "PUBLIC_METADATA";
+        TENANT: "TENANT";
+        INTERNAL: "INTERNAL";
+        FDE_INTERNAL: "FDE_INTERNAL";
+        ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+        UNKNOWN: "UNKNOWN";
+    }>>;
+    acceptedReferenceTypes: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export declare const servingContentDescriptorSchema: z.ZodObject<{
+    contentHash: z.ZodString;
+    mediaType: z.ZodString;
+    byteLength: z.ZodNumber;
+}, z.core.$strict>;
+export declare const servingArtifactSummarySchema: z.ZodObject<{
+    ref: z.ZodString;
+    identityRef: z.ZodString;
+    projectKey: z.ZodString;
+    projectRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    artifactId: z.ZodString;
+    kind: z.ZodEnum<{
+        SIGNAL_GENERATION: "SIGNAL_GENERATION";
+        RESEARCH: "RESEARCH";
+        REVIEW: "REVIEW";
+        KNOWLEDGE: "KNOWLEDGE";
+        INSIGHT: "INSIGHT";
+    }>;
+    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.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 servingArtifactDetailSchema: z.ZodObject<{
+    ref: z.ZodString;
+    identityRef: z.ZodString;
+    projectKey: z.ZodString;
+    projectRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    artifactId: z.ZodString;
+    kind: z.ZodEnum<{
+        SIGNAL_GENERATION: "SIGNAL_GENERATION";
+        RESEARCH: "RESEARCH";
+        REVIEW: "REVIEW";
+        KNOWLEDGE: "KNOWLEDGE";
+        INSIGHT: "INSIGHT";
+    }>;
+    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.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 servingEvidenceSummarySchema: 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 servingSourceSummarySchema: z.ZodObject<{
+    sourceId: z.ZodString;
+    familyId: z.ZodString;
+    authority: 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";
+    }>;
+    freshness: z.ZodString;
+    declaredState: z.ZodString;
+    coverageState: z.ZodNullable<z.ZodString>;
+    asOf: z.ZodISODateTime;
+}, z.core.$strict>;
+export declare const servingProjectIntentSummarySchema: z.ZodObject<{
+    projectKey: z.ZodString;
+    projectRef: z.ZodString;
+    tenantId: z.ZodString;
+    revisionRef: z.ZodString;
+    projectName: z.ZodString;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export declare const servingProjectSourceSummarySchema: z.ZodObject<{
+    projectKey: z.ZodString;
+    projectRef: z.ZodString;
+    projectIntentRef: z.ZodNullable<z.ZodString>;
+    sourceId: z.ZodString;
+    sourceRef: z.ZodString;
+    sourceRevisionRef: z.ZodString;
+    targetId: z.ZodString;
+    targetKind: z.ZodEnum<{
+        URL: "URL";
+        FILE: "FILE";
+        EXECUTOR: "EXECUTOR";
+    }>;
+    locator: z.ZodString;
+    executorId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    enabled: z.ZodBoolean;
+    access: z.ZodEnum<{
+        PUBLIC: "PUBLIC";
+        PUBLIC_METADATA: "PUBLIC_METADATA";
+        TENANT: "TENANT";
+        INTERNAL: "INTERNAL";
+        FDE_INTERNAL: "FDE_INTERNAL";
+        ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+        UNKNOWN: "UNKNOWN";
+    }>;
+    refreshMode: z.ZodEnum<{
+        MANUAL: "MANUAL";
+        INTERVAL: "INTERVAL";
+    }>;
+    intervalSeconds: z.ZodNullable<z.ZodNumber>;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export declare const servingGovernanceSourceSummarySchema: z.ZodObject<{
+    sourceId: z.ZodString;
+    familyId: z.ZodString;
+    authority: 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";
+    }>;
+    freshness: z.ZodString;
+    declaredState: z.ZodString;
+    coverageState: z.ZodNullable<z.ZodString>;
+    asOf: z.ZodISODateTime;
+}, z.core.$strict>;
+export declare const servingCurrentnessSchema: z.ZodObject<{
+    subjectRef: z.ZodString;
+    projectRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    sourceRevisionRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    state: z.ZodEnum<{
+        UNKNOWN: "UNKNOWN";
+        DUE: "DUE";
+        CURRENT: "CURRENT";
+        STALE: "STALE";
+        BLOCKED: "BLOCKED";
+    }>;
+    action: z.ZodEnum<{
+        ALLOW: "ALLOW";
+        REVIEW_REQUIRED: "REVIEW_REQUIRED";
+        DENY: "DENY";
+    }>;
+    assessedAt: z.ZodISODateTime;
+    dueAt: z.ZodNullable<z.ZodISODateTime>;
+    staleAt: z.ZodNullable<z.ZodISODateTime>;
+    reasonCode: z.ZodString;
+}, z.core.$strict>;
+export type ServingAction = z.infer<typeof servingActionSchema>;
+export type ServingProblemCode = z.infer<typeof servingProblemCodeSchema>;
+export type ServingDecision = z.infer<typeof servingDecisionSchema>;
+export type ConsumerProfile = z.infer<typeof consumerProfileSchema>;
+export type ServingArtifactSummary = z.infer<typeof servingArtifactSummarySchema>;
+export type ServingArtifactDetail = z.infer<typeof servingArtifactDetailSchema>;
+export type ServingEvidenceSummary = z.infer<typeof servingEvidenceSummarySchema>;
+export type ServingSourceSummary = z.infer<typeof servingSourceSummarySchema>;
+export type ServingProjectIntentSummary = z.infer<typeof servingProjectIntentSummarySchema>;
+export type ServingProjectSourceSummary = z.infer<typeof servingProjectSourceSummarySchema>;
+export type ServingCurrentness = z.infer<typeof servingCurrentnessSchema>;
+export type ReferenceSelectors = z.infer<typeof referenceSelectorsSchema>;
+export type ReferenceCorpusSummary = z.infer<typeof referenceCorpusSummarySchema>;
+export type ReferenceCorpusRecord = z.infer<typeof referenceCorpusRecordSchema>;