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

package/dist/types/contracts/tenant-resource.d.ts

@@ -0,0 +1,298 @@
+/** 租户原生不可变信封保留类型事实；不以项目占位或审核状态判断原文读取。 */
+import { z } from 'zod';
+export declare const tenantResourceFactsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"ARTIFACT">;
+    metadata: z.ZodObject<{
+        artifactId: z.ZodString;
+        kind: z.ZodEnum<{
+            SIGNAL_GENERATION: "SIGNAL_GENERATION";
+            RESEARCH: "RESEARCH";
+            REVIEW: "REVIEW";
+            KNOWLEDGE: "KNOWLEDGE";
+            INSIGHT: "INSIGHT";
+        }>;
+        status: z.ZodEnum<{
+            GENERATED: "GENERATED";
+            DRAFT: "DRAFT";
+            READY_FOR_REVIEW: "READY_FOR_REVIEW";
+            REWORK_REQUIRED: "REWORK_REQUIRED";
+            APPROVED: "APPROVED";
+            REJECTED: "REJECTED";
+            SUPERSEDED: "SUPERSEDED";
+        }>;
+        version: z.ZodNumber;
+        title: z.ZodOptional<z.ZodString>;
+        observedAt: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+        validUntil: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+        evidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        relatedRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        supersedesRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        sourceMaterialRefs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"EVIDENCE">;
+    metadata: z.ZodObject<{
+        observedAt: z.ZodISODateTime;
+        sourceIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        runtimeNodeId: z.ZodString;
+        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>>;
+        sourceId: z.ZodString;
+        sourceRevisionRef: z.ZodOptional<z.ZodString>;
+        collectionBatchRef: 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>>;
+        evidenceId: z.ZodString;
+        collector: z.ZodObject<{
+            collectorId: z.ZodString;
+            version: z.ZodString;
+        }, z.core.$strict>;
+        canonicalUri: z.ZodOptional<z.ZodString>;
+        sourceSetRef: z.ZodOptional<z.ZodString>;
+        sourceItemId: z.ZodOptional<z.ZodString>;
+        collectionTaskId: z.ZodOptional<z.ZodString>;
+        parentEvidenceRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"REFERENCE">;
+    metadata: z.ZodObject<{
+        version: z.ZodNumber;
+        supersedesRef: z.ZodNullable<z.ZodString>;
+        effectiveFrom: z.ZodNullable<z.ZodISODateTime>;
+        effectiveUntil: z.ZodNullable<z.ZodISODateTime>;
+        authority: z.ZodString;
+        currentness: z.ZodObject<{
+            state: z.ZodEnum<{
+                DUE: "DUE";
+                CURRENT: "CURRENT";
+                STALE: "STALE";
+                UNAVAILABLE: "UNAVAILABLE";
+                NOT_COVERED: "NOT_COVERED";
+            }>;
+            action: z.ZodEnum<{
+                ALLOW: "ALLOW";
+                REVIEW_REQUIRED: "REVIEW_REQUIRED";
+                DENY: "DENY";
+            }>;
+            assessedAt: z.ZodISODateTime;
+            validUntil: z.ZodNullable<z.ZodISODateTime>;
+        }, z.core.$strict>;
+        jurisdiction: z.ZodNullable<z.ZodString>;
+        sourceRefs: z.ZodArray<z.ZodString>;
+        corpusKey: z.ZodString;
+        recordKey: z.ZodString;
+        recordType: z.ZodString;
+        digest: z.ZodString;
+        selectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"CARRIER">;
+    metadata: z.ZodObject<{
+        kind: z.ZodString;
+        title: z.ZodString;
+        summary: z.ZodString;
+        sourceRefs: z.ZodArray<z.ZodString>;
+        observedAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+}, z.core.$strict>], "type">;
+export declare const tenantResourceOriginSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"TENANT_AUTHOR">;
+    actor: z.ZodObject<{
+        tenantId: z.ZodString;
+        userId: z.ZodString;
+        agentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>;
+    submittedAt: z.ZodISODateTime;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"TENANT_SOURCE">;
+    sourceId: z.ZodString;
+    sourceRef: z.ZodString;
+    sourceRevisionRef: z.ZodString;
+    collector: z.ZodObject<{
+        collectorId: z.ZodString;
+        version: z.ZodString;
+    }, z.core.$strict>;
+    runtimeNodeId: z.ZodString;
+    observedAt: z.ZodISODateTime;
+}, z.core.$strict>], "type">;
+export declare const tenantResourceManifestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    ownerTenantId: z.ZodString;
+    resourceId: z.ZodString;
+    resourceType: z.ZodString;
+    version: z.ZodNumber;
+    ref: z.ZodString;
+    identityRef: z.ZodString;
+    contentHash: z.ZodString;
+    byteLength: z.ZodNumber;
+    mediaType: 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";
+    }>;
+    createdAt: z.ZodISODateTime;
+    origin: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"TENANT_AUTHOR">;
+        actor: z.ZodObject<{
+            tenantId: z.ZodString;
+            userId: z.ZodString;
+            agentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>;
+        submittedAt: z.ZodISODateTime;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"TENANT_SOURCE">;
+        sourceId: z.ZodString;
+        sourceRef: z.ZodString;
+        sourceRevisionRef: z.ZodString;
+        collector: z.ZodObject<{
+            collectorId: z.ZodString;
+            version: z.ZodString;
+        }, z.core.$strict>;
+        runtimeNodeId: z.ZodString;
+        observedAt: z.ZodISODateTime;
+    }, z.core.$strict>], "type">;
+    facts: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"ARTIFACT">;
+        metadata: z.ZodObject<{
+            artifactId: z.ZodString;
+            kind: z.ZodEnum<{
+                SIGNAL_GENERATION: "SIGNAL_GENERATION";
+                RESEARCH: "RESEARCH";
+                REVIEW: "REVIEW";
+                KNOWLEDGE: "KNOWLEDGE";
+                INSIGHT: "INSIGHT";
+            }>;
+            status: z.ZodEnum<{
+                GENERATED: "GENERATED";
+                DRAFT: "DRAFT";
+                READY_FOR_REVIEW: "READY_FOR_REVIEW";
+                REWORK_REQUIRED: "REWORK_REQUIRED";
+                APPROVED: "APPROVED";
+                REJECTED: "REJECTED";
+                SUPERSEDED: "SUPERSEDED";
+            }>;
+            version: z.ZodNumber;
+            title: z.ZodOptional<z.ZodString>;
+            observedAt: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+            validUntil: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+            evidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            relatedRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            supersedesRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            sourceMaterialRefs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"EVIDENCE">;
+        metadata: z.ZodObject<{
+            observedAt: z.ZodISODateTime;
+            sourceIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            runtimeNodeId: z.ZodString;
+            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>>;
+            sourceId: z.ZodString;
+            sourceRevisionRef: z.ZodOptional<z.ZodString>;
+            collectionBatchRef: 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>>;
+            evidenceId: z.ZodString;
+            collector: z.ZodObject<{
+                collectorId: z.ZodString;
+                version: z.ZodString;
+            }, z.core.$strict>;
+            canonicalUri: z.ZodOptional<z.ZodString>;
+            sourceSetRef: z.ZodOptional<z.ZodString>;
+            sourceItemId: z.ZodOptional<z.ZodString>;
+            collectionTaskId: z.ZodOptional<z.ZodString>;
+            parentEvidenceRef: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"REFERENCE">;
+        metadata: z.ZodObject<{
+            version: z.ZodNumber;
+            supersedesRef: z.ZodNullable<z.ZodString>;
+            effectiveFrom: z.ZodNullable<z.ZodISODateTime>;
+            effectiveUntil: z.ZodNullable<z.ZodISODateTime>;
+            authority: z.ZodString;
+            currentness: z.ZodObject<{
+                state: z.ZodEnum<{
+                    DUE: "DUE";
+                    CURRENT: "CURRENT";
+                    STALE: "STALE";
+                    UNAVAILABLE: "UNAVAILABLE";
+                    NOT_COVERED: "NOT_COVERED";
+                }>;
+                action: z.ZodEnum<{
+                    ALLOW: "ALLOW";
+                    REVIEW_REQUIRED: "REVIEW_REQUIRED";
+                    DENY: "DENY";
+                }>;
+                assessedAt: z.ZodISODateTime;
+                validUntil: z.ZodNullable<z.ZodISODateTime>;
+            }, z.core.$strict>;
+            jurisdiction: z.ZodNullable<z.ZodString>;
+            sourceRefs: z.ZodArray<z.ZodString>;
+            corpusKey: z.ZodString;
+            recordKey: z.ZodString;
+            recordType: z.ZodString;
+            digest: z.ZodString;
+            selectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"CARRIER">;
+        metadata: z.ZodObject<{
+            kind: z.ZodString;
+            title: z.ZodString;
+            summary: z.ZodString;
+            sourceRefs: z.ZodArray<z.ZodString>;
+            observedAt: z.ZodISODateTime;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "type">;
+}, z.core.$strict>;
+export type TenantResourceManifest = z.infer<typeof tenantResourceManifestSchema>;
+export type TenantResourceFacts = z.infer<typeof tenantResourceFactsSchema>;
+export type TenantResourceOrigin = z.infer<typeof tenantResourceOriginSchema>;
+export declare const tenantProjectionIntentSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    ref: z.ZodString;
+    manifestRevision: z.ZodString;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export type TenantProjectionIntent = z.infer<typeof tenantProjectionIntentSchema>;
+/** 存储、Catalog 与 Identity 共用同一 manifest 身份；undefined 等价于 JSON 省略。 */
+export declare function tenantResourceManifestRevision(raw: TenantResourceManifest): string;
+/** Reference 语义摘要与 CAS 字节摘要分开；只正规化集合字段，不改原始 payload 字节。 */
+export declare function tenantReferenceRecordDigest(tenantId: string, access: unknown, metadata: Extract<TenantResourceFacts, {
+    type: 'REFERENCE';
+}>['metadata'], payload: unknown): string;

package/dist/types/contracts/tenant-rich-document.d.ts

@@ -0,0 +1,317 @@
+/** 原生受治理正文引用真实资料类型；Reference/开放载体不被伪装为 Evidence。 */
+import { z } from 'zod';
+export declare const TENANT_RICH_DOCUMENT_MEDIA_TYPE = "application/vnd.knowledge-v2.tenant-rich-document+json";
+export declare const tenantDocumentCitationSchema: z.ZodObject<{
+    blockOrdinal: z.ZodNumber;
+    sourceRefs: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export declare const tenantCompositionDraftSchema: z.ZodObject<{
+    summary: z.ZodString;
+    byline: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    language: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    blocks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"HEADING">;
+        level: z.ZodNumber;
+        text: z.ZodString;
+        inlines: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            href: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>>;
+        ordinal: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"PARAGRAPH">;
+        text: z.ZodString;
+        inlines: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            href: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>>;
+        ordinal: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"LIST_ITEM">;
+        text: z.ZodString;
+        ordered: z.ZodBoolean;
+        level: z.ZodNumber;
+        index: z.ZodNullable<z.ZodNumber>;
+        inlines: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            href: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>>;
+        ordinal: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"QUOTE">;
+        text: z.ZodString;
+        inlines: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            href: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>>;
+        ordinal: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"CODE">;
+        text: z.ZodString;
+        language: z.ZodNullable<z.ZodString>;
+        ordinal: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"IMAGE">;
+        alt: z.ZodNullable<z.ZodString>;
+        width: z.ZodNullable<z.ZodNumber>;
+        height: z.ZodNullable<z.ZodNumber>;
+        ordinal: z.ZodNumber;
+        sourceUrl: z.ZodString;
+        canonicalUrl: z.ZodNullable<z.ZodString>;
+        availability: z.ZodEnum<{
+            MIRRORED: "MIRRORED";
+            REMOTE_ONLY: "REMOTE_ONLY";
+            UNAVAILABLE: "UNAVAILABLE";
+        }>;
+        mediaRef: z.ZodNullable<z.ZodString>;
+        evidenceRef: z.ZodNullable<z.ZodString>;
+        contentHash: z.ZodNullable<z.ZodString>;
+        mediaType: z.ZodNullable<z.ZodString>;
+        byteLength: z.ZodNullable<z.ZodNumber>;
+        caption: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"VIDEO">;
+        title: z.ZodNullable<z.ZodString>;
+        posterUrl: z.ZodNullable<z.ZodString>;
+        posterEvidenceRef: z.ZodNullable<z.ZodString>;
+        ordinal: z.ZodNumber;
+        sourceUrl: z.ZodString;
+        canonicalUrl: z.ZodNullable<z.ZodString>;
+        availability: z.ZodEnum<{
+            MIRRORED: "MIRRORED";
+            REMOTE_ONLY: "REMOTE_ONLY";
+            UNAVAILABLE: "UNAVAILABLE";
+        }>;
+        mediaRef: z.ZodNullable<z.ZodString>;
+        evidenceRef: z.ZodNullable<z.ZodString>;
+        contentHash: z.ZodNullable<z.ZodString>;
+        mediaType: z.ZodNullable<z.ZodString>;
+        byteLength: z.ZodNullable<z.ZodNumber>;
+        caption: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"AUDIO">;
+        title: z.ZodNullable<z.ZodString>;
+        ordinal: z.ZodNumber;
+        sourceUrl: z.ZodString;
+        canonicalUrl: z.ZodNullable<z.ZodString>;
+        availability: z.ZodEnum<{
+            MIRRORED: "MIRRORED";
+            REMOTE_ONLY: "REMOTE_ONLY";
+            UNAVAILABLE: "UNAVAILABLE";
+        }>;
+        mediaRef: z.ZodNullable<z.ZodString>;
+        evidenceRef: z.ZodNullable<z.ZodString>;
+        contentHash: z.ZodNullable<z.ZodString>;
+        mediaType: z.ZodNullable<z.ZodString>;
+        byteLength: z.ZodNullable<z.ZodNumber>;
+        caption: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"EMBED">;
+        sourceUrl: z.ZodString;
+        provider: z.ZodNullable<z.ZodString>;
+        title: z.ZodNullable<z.ZodString>;
+        caption: z.ZodNullable<z.ZodString>;
+        ordinal: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"DIVIDER">;
+        ordinal: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"TABLE">;
+        rows: z.ZodArray<z.ZodObject<{
+            cells: z.ZodArray<z.ZodObject<{
+                text: z.ZodString;
+                header: z.ZodBoolean;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        ordinal: z.ZodNumber;
+    }, z.core.$strict>], "kind">>;
+    citations: z.ZodArray<z.ZodObject<{
+        blockOrdinal: z.ZodNumber;
+        sourceRefs: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const tenantRichDocumentSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    title: z.ZodNullable<z.ZodString>;
+    summary: z.ZodNullable<z.ZodString>;
+    sourceContentHash: z.ZodString;
+    language: z.ZodNullable<z.ZodString>;
+    byline: z.ZodNullable<z.ZodString>;
+    blocks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"HEADING">;
+        level: z.ZodNumber;
+        text: z.ZodString;
+        inlines: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            href: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>>;
+        ordinal: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"PARAGRAPH">;
+        text: z.ZodString;
+        inlines: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            href: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>>;
+        ordinal: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"LIST_ITEM">;
+        text: z.ZodString;
+        ordered: z.ZodBoolean;
+        level: z.ZodNumber;
+        index: z.ZodNullable<z.ZodNumber>;
+        inlines: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            href: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>>;
+        ordinal: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"QUOTE">;
+        text: z.ZodString;
+        inlines: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            href: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>>;
+        ordinal: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"CODE">;
+        text: z.ZodString;
+        language: z.ZodNullable<z.ZodString>;
+        ordinal: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"IMAGE">;
+        alt: z.ZodNullable<z.ZodString>;
+        width: z.ZodNullable<z.ZodNumber>;
+        height: z.ZodNullable<z.ZodNumber>;
+        ordinal: z.ZodNumber;
+        sourceUrl: z.ZodString;
+        canonicalUrl: z.ZodNullable<z.ZodString>;
+        availability: z.ZodEnum<{
+            MIRRORED: "MIRRORED";
+            REMOTE_ONLY: "REMOTE_ONLY";
+            UNAVAILABLE: "UNAVAILABLE";
+        }>;
+        mediaRef: z.ZodNullable<z.ZodString>;
+        evidenceRef: z.ZodNullable<z.ZodString>;
+        contentHash: z.ZodNullable<z.ZodString>;
+        mediaType: z.ZodNullable<z.ZodString>;
+        byteLength: z.ZodNullable<z.ZodNumber>;
+        caption: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"VIDEO">;
+        title: z.ZodNullable<z.ZodString>;
+        posterUrl: z.ZodNullable<z.ZodString>;
+        posterEvidenceRef: z.ZodNullable<z.ZodString>;
+        ordinal: z.ZodNumber;
+        sourceUrl: z.ZodString;
+        canonicalUrl: z.ZodNullable<z.ZodString>;
+        availability: z.ZodEnum<{
+            MIRRORED: "MIRRORED";
+            REMOTE_ONLY: "REMOTE_ONLY";
+            UNAVAILABLE: "UNAVAILABLE";
+        }>;
+        mediaRef: z.ZodNullable<z.ZodString>;
+        evidenceRef: z.ZodNullable<z.ZodString>;
+        contentHash: z.ZodNullable<z.ZodString>;
+        mediaType: z.ZodNullable<z.ZodString>;
+        byteLength: z.ZodNullable<z.ZodNumber>;
+        caption: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"AUDIO">;
+        title: z.ZodNullable<z.ZodString>;
+        ordinal: z.ZodNumber;
+        sourceUrl: z.ZodString;
+        canonicalUrl: z.ZodNullable<z.ZodString>;
+        availability: z.ZodEnum<{
+            MIRRORED: "MIRRORED";
+            REMOTE_ONLY: "REMOTE_ONLY";
+            UNAVAILABLE: "UNAVAILABLE";
+        }>;
+        mediaRef: z.ZodNullable<z.ZodString>;
+        evidenceRef: z.ZodNullable<z.ZodString>;
+        contentHash: z.ZodNullable<z.ZodString>;
+        mediaType: z.ZodNullable<z.ZodString>;
+        byteLength: z.ZodNullable<z.ZodNumber>;
+        caption: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"EMBED">;
+        sourceUrl: z.ZodString;
+        provider: z.ZodNullable<z.ZodString>;
+        title: z.ZodNullable<z.ZodString>;
+        caption: z.ZodNullable<z.ZodString>;
+        ordinal: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"DIVIDER">;
+        ordinal: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"TABLE">;
+        rows: z.ZodArray<z.ZodObject<{
+            cells: z.ZodArray<z.ZodObject<{
+                text: z.ZodString;
+                header: z.ZodBoolean;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        ordinal: z.ZodNumber;
+    }, z.core.$strict>], "kind">>;
+    mediaEvidenceRefs: z.ZodArray<z.ZodString>;
+    sourceUri: z.ZodString;
+    extractedAt: z.ZodISODateTime;
+    sourceMediaType: z.ZodString;
+    sourceByteLength: z.ZodNumber;
+    publishedAt: z.ZodNullable<z.ZodISODateTime>;
+    topics: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    textContent: z.ZodString;
+    extractor: z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodString;
+    }, z.core.$strict>;
+    format: z.ZodLiteral<"TENANT_RICH_DOCUMENT_V1">;
+    tenantId: z.ZodString;
+    role: z.ZodEnum<{
+        KNOWLEDGE: "KNOWLEDGE";
+        INSIGHT: "INSIGHT";
+    }>;
+    publicationProfile: z.ZodEnum<{
+        HUMAN_ARTICLE_V1: "HUMAN_ARTICLE_V1";
+        KNOWLEDGE_CARD_V1: "KNOWLEDGE_CARD_V1";
+    }>;
+    sourceRefs: z.ZodArray<z.ZodString>;
+    primarySourceRef: z.ZodString;
+    representationRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    citations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        blockOrdinal: z.ZodNumber;
+        sourceRefs: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type TenantRichDocument = z.infer<typeof tenantRichDocumentSchema>;
+export type TenantCompositionDraft = z.infer<typeof tenantCompositionDraftSchema>;
+export declare const tenantPublicationReadinessSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    profile: z.ZodEnum<{
+        HUMAN_ARTICLE_V1: "HUMAN_ARTICLE_V1";
+        KNOWLEDGE_CARD_V1: "KNOWLEDGE_CARD_V1";
+    }>;
+    ready: z.ZodBoolean;
+    reasons: z.ZodArray<z.ZodEnum<{
+        ROLE_MISMATCH: "ROLE_MISMATCH";
+        TITLE_REQUIRED: "TITLE_REQUIRED";
+        SUMMARY_REQUIRED: "SUMMARY_REQUIRED";
+        TEXT_TOO_SHORT: "TEXT_TOO_SHORT";
+        STRUCTURE_TOO_THIN: "STRUCTURE_TOO_THIN";
+        CITATION_COVERAGE_REQUIRED: "CITATION_COVERAGE_REQUIRED";
+        MEDIA_UNAVAILABLE: "MEDIA_UNAVAILABLE";
+        SOURCE_REQUIRED: "SOURCE_REQUIRED";
+        SOURCE_MISMATCH: "SOURCE_MISMATCH";
+    }>>;
+    metrics: z.ZodObject<{
+        textCharacters: z.ZodNumber;
+        blockCount: z.ZodNumber;
+        textBlockCount: z.ZodNumber;
+        mediaBlockCount: z.ZodNumber;
+        sourceCount: z.ZodNumber;
+        mediaEvidenceCount: z.ZodNumber;
+        citationCount: z.ZodNumber;
+        citedBlockCount: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type TenantPublicationReadiness = z.infer<typeof tenantPublicationReadinessSchema>;

package/dist/types/contracts/tenant-source-binding.d.ts

@@ -0,0 +1,44 @@
+/** 项目用途上下文不参与来源获取等价，不是授权 grant 或可执行过滤 DSL。 */
+import { z } from 'zod';
+export declare const tenantSourceBindingContextSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectIntentRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    scopeIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    sourceFamilies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    attentionNotes: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type TenantSourceBindingContext = z.infer<typeof tenantSourceBindingContextSchema>;
+export declare const tenantSourceBindingRevisionSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    tenantId: z.ZodString;
+    projectKey: z.ZodString;
+    sourceId: z.ZodString;
+    revisionRef: z.ZodString;
+    generation: z.ZodNumber;
+    purpose: z.ZodString;
+    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">;
+    enabled: z.ZodBoolean;
+    demandContext: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        projectIntentRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        scopeIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        sourceFamilies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        attentionNotes: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>;
+    origin: z.ZodEnum<{
+        MIGRATED_V13: "MIGRATED_V13";
+        EXPLICIT_V14: "EXPLICIT_V14";
+    }>;
+    actor: z.ZodNullable<z.ZodObject<{
+        tenantId: z.ZodString;
+        userId: z.ZodString;
+        agentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>;
+    changedAt: z.ZodNullable<z.ZodISODateTime>;
+}, z.core.$strict>;
+export type TenantSourceBindingRevision = z.infer<typeof tenantSourceBindingRevisionSchema>;