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

package/dist/internal/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/internal/contracts/tenant-rich-document.js

@@ -0,0 +1,17 @@
+/** 原生受治理正文引用真实资料类型；Reference/开放载体不被伪装为 Evidence。 */
+import { z } from 'zod';
+import { richDocumentSchema, publicationProfileSchema, validateRichDocumentContent } from './rich-document.js';
+import { materialTenantIdSchema } from './material-context.js';
+import { stableUriSchema } from './common.js';
+export const TENANT_RICH_DOCUMENT_MEDIA_TYPE = 'application/vnd.knowledge-v2.tenant-rich-document+json';
+export const tenantDocumentCitationSchema = z.object({ blockOrdinal: z.number().int().nonnegative(), sourceRefs: z.array(stableUriSchema).min(1).max(32) }).strict().superRefine((value, ctx) => { if (new Set(value.sourceRefs).size !== value.sourceRefs.length)
+    ctx.addIssue({ code: 'custom', path: ['sourceRefs'], message: 'Citation refs must be unique' }); });
+export const tenantCompositionDraftSchema = z.object({ ...richDocumentSchema.shape }).pick({ summary: true, byline: true, language: true, blocks: true }).extend({ summary: z.string().trim().min(1).max(4000), byline: richDocumentSchema.shape.byline.optional(), language: richDocumentSchema.shape.language.optional(), blocks: richDocumentSchema.shape.blocks.min(1), citations: z.array(tenantDocumentCitationSchema).min(1).max(10000) }).strict();
+const base = z.object({ ...richDocumentSchema.shape }).omit({ projectKey: true, projectRef: true, format: true, role: true, publicationProfile: true, sourceEvidenceRefs: true, primarySourceEvidenceRef: true, citations: true });
+export const tenantRichDocumentSchema = base.extend({ format: z.literal('TENANT_RICH_DOCUMENT_V1'), tenantId: materialTenantIdSchema, role: z.enum(['KNOWLEDGE', 'INSIGHT']), publicationProfile: publicationProfileSchema, sourceRefs: z.array(stableUriSchema).min(1).max(256), primarySourceRef: stableUriSchema, representationRefs: z.array(stableUriSchema).max(64).default([]), citations: z.array(tenantDocumentCitationSchema).max(10000).default([]) }).strict().superRefine((value, ctx) => {
+    // 只把字段适配到共同结构规则；身份、真实载体类型与权限由应用层逐 ref 验证。
+    validateRichDocumentContent({ sourceEvidenceRefs: value.sourceRefs, primarySourceEvidenceRef: value.primarySourceRef, mediaEvidenceRefs: value.mediaEvidenceRefs, blocks: value.blocks, citations: value.citations.map(citation => ({ blockOrdinal: citation.blockOrdinal, evidenceRefs: citation.sourceRefs })) }, ctx, { primary: 'primarySourceRef', citation: 'sourceRefs' });
+    if (new Set(value.sourceRefs).size !== value.sourceRefs.length)
+        ctx.addIssue({ code: 'custom', path: ['sourceRefs'], message: 'Sources must be unique' });
+});
+export const tenantPublicationReadinessSchema = z.object({ schemaVersion: z.literal(2), profile: publicationProfileSchema, ready: z.boolean(), reasons: z.array(z.enum(['ROLE_MISMATCH', 'TITLE_REQUIRED', 'SUMMARY_REQUIRED', 'TEXT_TOO_SHORT', 'STRUCTURE_TOO_THIN', 'SOURCE_REQUIRED', 'CITATION_COVERAGE_REQUIRED', 'SOURCE_MISMATCH', 'MEDIA_UNAVAILABLE'])).max(16), metrics: z.object({ textCharacters: z.number().int().nonnegative(), blockCount: z.number().int().nonnegative(), textBlockCount: z.number().int().nonnegative(), mediaBlockCount: z.number().int().nonnegative(), sourceCount: z.number().int().nonnegative(), mediaEvidenceCount: z.number().int().nonnegative(), citationCount: z.number().int().nonnegative(), citedBlockCount: z.number().int().nonnegative() }).strict() }).strict();

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

package/dist/internal/contracts/tenant-source-binding.js

@@ -0,0 +1,33 @@
+/** 项目用途上下文不参与来源获取等价，不是授权 grant 或可执行过滤 DSL。 */
+import { z } from 'zod';
+import { idSchema, stableUriSchema } from './common.js';
+export const tenantSourceBindingContextSchema = z.object({
+    schemaVersion: z.literal(1), projectIntentRef: stableUriSchema.nullable().default(null),
+    scopeIds: z.array(idSchema).max(256).default([]), sourceFamilies: z.array(idSchema).max(256).default([]), attentionNotes: z.string().max(4000).nullable().default(null),
+}).strict().superRefine((value, ctx) => {
+    for (const key of ['scopeIds', 'sourceFamilies'])
+        if (new Set(value[key]).size !== value[key].length)
+            ctx.addIssue({ code: 'custom', path: [key], message: 'Project demand selectors must be unique' });
+    if ((value.scopeIds.length || value.sourceFamilies.length) && !value.projectIntentRef)
+        ctx.addIssue({ code: 'custom', path: ['projectIntentRef'], message: 'Scoped demand must retain an exact Project Intent revision' });
+    if (value.projectIntentRef && !/^project-intent:\/\/[A-Za-z0-9][A-Za-z0-9._-]{0,127}\/[a-f0-9]{64}$/.test(value.projectIntentRef))
+        ctx.addIssue({ code: 'custom', path: ['projectIntentRef'], message: 'Exact Project Intent revision required' });
+});
+import { projectKeySchema, isoDateTimeSchema } from './common.js';
+import { knowledgeActorContextSchema, collectionRefreshSchema } from './project-intent.js';
+import { materialTenantIdSchema } from './material-context.js';
+import { tenantSourceIdSchema } from './tenant-source.js';
+import { tenantStorageKey } from './resource-scope.js';
+export const tenantSourceBindingRevisionSchema = z.object({
+    schemaVersion: z.literal(1), tenantId: materialTenantIdSchema, projectKey: projectKeySchema, sourceId: tenantSourceIdSchema, revisionRef: stableUriSchema,
+    generation: z.number().int().positive().safe(), purpose: z.string().max(4000), refresh: collectionRefreshSchema, enabled: z.boolean(), demandContext: tenantSourceBindingContextSchema,
+    origin: z.enum(['MIGRATED_V13', 'EXPLICIT_V14']), actor: knowledgeActorContextSchema.nullable(), changedAt: isoDateTimeSchema.nullable(),
+}).strict().superRefine((v, ctx) => {
+    const prefix = `tenant-source://${tenantStorageKey(v.tenantId)}/${v.sourceId}/v/`;
+    if (!v.revisionRef.startsWith(prefix) || !/^[a-f0-9]{64}$/.test(v.revisionRef.slice(prefix.length)))
+        ctx.addIssue({ code: 'custom', path: ['revisionRef'], message: 'Binding must retain exact Tenant Source identity' });
+    if (v.demandContext.projectIntentRef && !v.demandContext.projectIntentRef.startsWith(`project-intent://${v.projectKey}/`))
+        ctx.addIssue({ code: 'custom', path: ['demandContext'], message: 'Demand context Project mismatch' });
+    if (v.origin === 'MIGRATED_V13' ? (v.actor !== null || v.changedAt !== null) : (!v.actor || v.actor.tenantId !== v.tenantId || !v.changedAt))
+        ctx.addIssue({ code: 'custom', path: ['origin'], message: 'Migration cannot invent actor/time; explicit changes require attribution' });
+});

package/dist/internal/contracts/tenant-source-bridge.d.ts

@@ -0,0 +1,70 @@
+/** 显式桥接预检确认获取语义；该请求不授予启停或修改工作归属的权限。 */
+import { z } from 'zod';
+export declare const tenantSourceBridgePreviewInputSchema: z.ZodObject<{
+    projectKey: z.ZodString;
+    legacySourceId: z.ZodString;
+    expectedLegacyRevisionRef: z.ZodString;
+    nativeSourceId: z.ZodString;
+    expectedNativeRevisionRef: z.ZodString;
+    confirmAcquisitionSemantics: z.ZodObject<{
+        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">;
+        credential: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"PUBLIC">;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"BOUND">;
+            bindingRef: z.ZodString;
+            revision: z.ZodString;
+        }, z.core.$strict>], "type">;
+        executionBinding: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+            bindingRef: z.ZodString;
+            revision: z.ZodString;
+        }, z.core.$strict>>>;
+        access: z.ZodEnum<{
+            PUBLIC: "PUBLIC";
+            PUBLIC_METADATA: "PUBLIC_METADATA";
+            TENANT: "TENANT";
+            INTERNAL: "INTERNAL";
+            FDE_INTERNAL: "FDE_INTERNAL";
+            ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+            UNKNOWN: "UNKNOWN";
+        }>;
+        sourcePolicy: z.ZodObject<{
+            ref: z.ZodString;
+            revision: z.ZodString;
+            acquisition: z.ZodEnum<{
+                ALLOW: "ALLOW";
+                DENY: "DENY";
+            }>;
+            propagation: z.ZodEnum<{
+                TENANT_ONLY: "TENANT_ONLY";
+                SHARE_ALLOWED: "SHARE_ALLOWED";
+                PUBLIC_ALLOWED: "PUBLIC_ALLOWED";
+            }>;
+        }, z.core.$strict>;
+        region: z.ZodNullable<z.ZodString>;
+        representation: z.ZodObject<{
+            format: z.ZodEnum<{
+                RICH_DOCUMENT_V1: "RICH_DOCUMENT_V1";
+                RAW: "RAW";
+            }>;
+            extractor: z.ZodNullable<z.ZodObject<{
+                id: z.ZodString;
+                version: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    maxResourceBytes: z.ZodNumber;
+}, z.core.$strict>;
+export type TenantSourceBridgePreviewInput = z.infer<typeof tenantSourceBridgePreviewInputSchema>;

package/dist/internal/contracts/tenant-source-bridge.js

@@ -0,0 +1,9 @@
+/** 显式桥接预检确认获取语义；该请求不授予启停或修改工作归属的权限。 */
+import { z } from 'zod';
+import { projectKeySchema, stableUriSchema } from './common.js';
+import { tenantSourceIdSchema, tenantSourceSemanticsSchema } from './tenant-source.js';
+export const tenantSourceBridgePreviewInputSchema = z.object({
+    projectKey: projectKeySchema, legacySourceId: tenantSourceIdSchema, expectedLegacyRevisionRef: stableUriSchema,
+    nativeSourceId: tenantSourceIdSchema, expectedNativeRevisionRef: stableUriSchema,
+    confirmAcquisitionSemantics: tenantSourceSemanticsSchema, maxResourceBytes: z.number().int().min(1024).max(64 * 1024 * 1024),
+}).strict();