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

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

@@ -0,0 +1,641 @@
+import { z } from 'zod';
+export declare const RICH_DOCUMENT_MEDIA_TYPE: "application/vnd.knowledge-v2.rich-document+json";
+export declare const richDocumentRoleSchema: z.ZodEnum<{
+    KNOWLEDGE: "KNOWLEDGE";
+    INSIGHT: "INSIGHT";
+    SOURCE_MIRROR: "SOURCE_MIRROR";
+}>;
+export declare const publicationProfileSchema: z.ZodEnum<{
+    HUMAN_ARTICLE_V1: "HUMAN_ARTICLE_V1";
+    KNOWLEDGE_CARD_V1: "KNOWLEDGE_CARD_V1";
+}>;
+export declare const publicationReadinessReasonSchema: 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";
+    SOURCE_EVIDENCE_REQUIRED: "SOURCE_EVIDENCE_REQUIRED";
+    CITATION_COVERAGE_REQUIRED: "CITATION_COVERAGE_REQUIRED";
+    EVIDENCE_MISMATCH: "EVIDENCE_MISMATCH";
+    MEDIA_UNAVAILABLE: "MEDIA_UNAVAILABLE";
+}>;
+export declare const richDocumentMediaAvailabilitySchema: z.ZodEnum<{
+    MIRRORED: "MIRRORED";
+    REMOTE_ONLY: "REMOTE_ONLY";
+    UNAVAILABLE: "UNAVAILABLE";
+}>;
+export declare const richHeadingBlockSchema: 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>;
+export declare const richParagraphBlockSchema: 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>;
+export declare const richListItemBlockSchema: 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>;
+export declare const richQuoteBlockSchema: 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>;
+export declare const richCodeBlockSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"CODE">;
+    text: z.ZodString;
+    language: z.ZodNullable<z.ZodString>;
+    ordinal: z.ZodNumber;
+}, z.core.$strict>;
+export declare const richDividerBlockSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"DIVIDER">;
+    ordinal: z.ZodNumber;
+}, z.core.$strict>;
+export declare const richTableBlockSchema: 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>;
+export declare const richImageBlockSchema: 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>;
+export declare const richVideoBlockSchema: 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>;
+export declare const richAudioBlockSchema: 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>;
+export declare const richEmbedBlockSchema: 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>;
+export declare const richDocumentBlockSchema: 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">;
+export declare const richDocumentCitationSchema: z.ZodObject<{
+    blockOrdinal: z.ZodNumber;
+    evidenceRefs: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export declare const richCompositionDraftSchema: 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;
+        evidenceRefs: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+/** 内容规则与来源/Scope 身份分开；新旧格式共用引用、媒体和块顺序校验。 */
+export type RichDocumentContent = {
+    sourceEvidenceRefs: string[];
+    primarySourceEvidenceRef: string;
+    mediaEvidenceRefs: string[];
+    blocks: z.infer<typeof richDocumentBlockSchema>[];
+    citations: z.infer<typeof richDocumentCitationSchema>[];
+};
+export declare function validateRichDocumentContent(value: RichDocumentContent, ctx: z.RefinementCtx, names?: {
+    primary: string;
+    citation: string;
+}): void;
+export declare const richDocumentSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    format: z.ZodLiteral<"RICH_DOCUMENT_V1">;
+    role: z.ZodEnum<{
+        KNOWLEDGE: "KNOWLEDGE";
+        INSIGHT: "INSIGHT";
+        SOURCE_MIRROR: "SOURCE_MIRROR";
+    }>;
+    publicationProfile: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+        HUMAN_ARTICLE_V1: "HUMAN_ARTICLE_V1";
+        KNOWLEDGE_CARD_V1: "KNOWLEDGE_CARD_V1";
+    }>>>;
+    projectKey: z.ZodString;
+    projectRef: z.ZodString;
+    sourceEvidenceRefs: z.ZodArray<z.ZodString>;
+    primarySourceEvidenceRef: z.ZodString;
+    sourceContentHash: z.ZodString;
+    sourceUri: z.ZodString;
+    sourceMediaType: z.ZodString;
+    sourceByteLength: z.ZodNumber;
+    title: z.ZodNullable<z.ZodString>;
+    byline: z.ZodNullable<z.ZodString>;
+    publishedAt: z.ZodNullable<z.ZodISODateTime>;
+    language: z.ZodNullable<z.ZodString>;
+    topics: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    summary: z.ZodNullable<z.ZodString>;
+    textContent: 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>;
+    citations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        blockOrdinal: z.ZodNumber;
+        evidenceRefs: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>>;
+    extractedAt: z.ZodISODateTime;
+    extractor: z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type RichDocument = z.infer<typeof richDocumentSchema>;
+export type RichDocumentBlock = z.infer<typeof richDocumentBlockSchema>;
+export type RichImageBlock = z.infer<typeof richImageBlockSchema>;
+export type RichVideoBlock = z.infer<typeof richVideoBlockSchema>;
+export type RichAudioBlock = z.infer<typeof richAudioBlockSchema>;
+export type RichDocumentCitation = z.infer<typeof richDocumentCitationSchema>;
+export type RichCompositionDraft = z.infer<typeof richCompositionDraftSchema>;
+export declare const richSourceDocumentManifestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectKey: z.ZodString;
+    documentRef: z.ZodString;
+    sourceEvidenceRef: z.ZodString;
+    sourceContentHash: z.ZodString;
+    documentContentHash: z.ZodString;
+    documentByteLength: z.ZodNumber;
+    extractedAt: z.ZodISODateTime;
+    extractor: z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const richSourceDocumentPointerSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectKey: z.ZodString;
+    sourceEvidenceRef: z.ZodString;
+    documentRef: z.ZodString;
+    documentContentHash: z.ZodString;
+    manifestRelativePath: z.ZodString;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export type RichSourceDocumentManifest = z.infer<typeof richSourceDocumentManifestSchema>;
+export type RichSourceDocumentPointer = z.infer<typeof richSourceDocumentPointerSchema>;
+export declare const publicationReadinessReportSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    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";
+        SOURCE_EVIDENCE_REQUIRED: "SOURCE_EVIDENCE_REQUIRED";
+        CITATION_COVERAGE_REQUIRED: "CITATION_COVERAGE_REQUIRED";
+        EVIDENCE_MISMATCH: "EVIDENCE_MISMATCH";
+        MEDIA_UNAVAILABLE: "MEDIA_UNAVAILABLE";
+    }>>;
+    metrics: z.ZodObject<{
+        textCharacters: z.ZodNumber;
+        blockCount: z.ZodNumber;
+        textBlockCount: z.ZodNumber;
+        mediaBlockCount: z.ZodNumber;
+        sourceEvidenceCount: z.ZodNumber;
+        citationCount: z.ZodNumber;
+        citedBlockCount: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type PublicationProfile = z.infer<typeof publicationProfileSchema>;
+export type PublicationReadinessReason = z.infer<typeof publicationReadinessReasonSchema>;
+export type PublicationReadinessReport = z.infer<typeof publicationReadinessReportSchema>;
+export declare const richMediaLinkSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectKey: z.ZodString;
+    mediaRef: z.ZodString;
+    sourceEvidenceRef: z.ZodString;
+    mediaEvidenceRef: z.ZodString;
+    contentHash: z.ZodString;
+    mediaType: z.ZodString;
+    byteLength: z.ZodNumber;
+    sourceUrl: z.ZodString;
+    canonicalUrl: z.ZodString;
+    linkedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export type RichMediaLink = z.infer<typeof richMediaLinkSchema>;

package/dist/types/contracts/runtime-compatibility.d.ts

@@ -0,0 +1,22 @@
+/** Release admission contract. Intermediate, unreleased wave snapshots are not rollback targets. */
+export declare const tenantCoreReadCapabilities: readonly ["TENANT_RESOURCE_V1", "TENANT_SOURCE_V1", "TENANT_SOURCE_DOCUMENT_V2", "TENANT_WORKFLOW_V1", "TENANT_ROUTES_V1", "TENANT_CURRENTNESS_V2", "TENANT_PUBLIC_REFERENCE_V1", "TENANT_PROJECT_CONTEXT_V1", "TENANT_OAUTH_MANAGEMENT_V1", "TENANT_RUNTIME_STATUS_V1"];
+export declare const tenantCoreWriteCapabilities: readonly ["TENANT_COLLECTION_V2", "TENANT_ADMISSION_STOP_V1", "TENANT_ADMISSION_V2"];
+export type RuntimeComponent = 'core' | 'admin-web';
+export interface RuntimeCompatibility {
+    schemaVersion: 1;
+    component: RuntimeComponent;
+    identityReadMinimum: number;
+    identityReadMaximum: number;
+    capabilities: readonly string[];
+    tenantProviders: readonly number[];
+    requiredCoreProviders: readonly number[];
+    budgetReadVersions: readonly number[];
+    budgetMigrationVersions: readonly number[];
+}
+export declare function runtimeCompatibility(component: RuntimeComponent): RuntimeCompatibility;
+export interface RuntimeFormatFacts {
+    identityVersion: number;
+    budgetVersion: number | null;
+}
+/** Conservative published compatibility floor: native Identity >=12 requires the complete current Tenant reader. */
+export declare function assertRuntimeFormatCompatibility(raw: unknown, facts: RuntimeFormatFacts, component: RuntimeComponent, mode: 'INSTALL' | 'START' | 'ROLLBACK' | 'RECOVERY'): void;