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

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

@@ -0,0 +1,23 @@
+export * from './core.js';
+export * from './http.js';
+export * from './consumer.js';
+export * from './mcp.js';
+export * from './management.js';
+export * from './material-capabilities.js';
+export * from './material-index-status.js';
+export * from './workflow.js';
+export * from './tenant-governance.js';
+export * from './tenant-management.js';
+export * from './tenant-workspace.js';
+export * from './tenant-project.js';
+export * from './tenant-runtime.js';
+export * from './tenant-web.js';
+export * from './tenant-web-crawl.js';
+export * from './tenant-web-dynamic.js';
+export * from './tenant-web-content.js';
+export * from './tenant-web-workflow.js';
+export * from './agent-entry.js';
+export * from './agent-catalog.js';
+export * from './body-search.js';
+export * from './agent-guidance-shapes.js';
+export * from './agent-input-hints.js';

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

@@ -0,0 +1,424 @@
+/** 管理 MCP 的参数只携带项目引用和治理输入；项目 Key、Tenant 和节点均由服务端绑定解析。 */
+import { z } from 'zod';
+export declare const managementComposeInputSchema: z.ZodObject<{
+    projectRef: z.ZodString;
+    sourceEvidenceRefs: z.ZodArray<z.ZodString>;
+    primarySourceEvidenceRef: z.ZodOptional<z.ZodString>;
+    artifactId: z.ZodString;
+    expectedVersion: z.ZodNumber;
+    composedAt: z.ZodISODateTime;
+    validUntil: z.ZodOptional<z.ZodISODateTime>;
+    outputKind: z.ZodEnum<{
+        KNOWLEDGE: "KNOWLEDGE";
+        INSIGHT: "INSIGHT";
+    }>;
+    publicationProfile: z.ZodOptional<z.ZodEnum<{
+        HUMAN_ARTICLE_V1: "HUMAN_ARTICLE_V1";
+        KNOWLEDGE_CARD_V1: "KNOWLEDGE_CARD_V1";
+    }>>;
+    title: z.ZodOptional<z.ZodString>;
+    composition: z.ZodOptional<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>>;
+}, z.core.$strict>;
+export declare const managementSubmitInputSchema: z.ZodObject<{
+    projectRef: z.ZodString;
+    ref: z.ZodString;
+    expectedVersion: z.ZodNumber;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export declare const managementReviewInputSchema: z.ZodObject<{
+    projectRef: z.ZodString;
+    targetRef: z.ZodString;
+    expectedVersion: z.ZodNumber;
+    decision: z.ZodEnum<{
+        PASS: "PASS";
+        REWORK: "REWORK";
+        REJECT: "REJECT";
+    }>;
+    reviewedAt: z.ZodISODateTime;
+    summary: z.ZodString;
+    evidenceRefs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export declare const managementFinalizeInputSchema: z.ZodObject<{
+    projectRef: z.ZodString;
+    ref: z.ZodString;
+    expectedVersion: z.ZodNumber;
+    nextStatus: z.ZodEnum<{
+        REWORK_REQUIRED: "REWORK_REQUIRED";
+        APPROVED: "APPROVED";
+        REJECTED: "REJECTED";
+    }>;
+    reviewRef: z.ZodString;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export declare const managementResultSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectRef: z.ZodString;
+    ref: z.ZodString;
+    kind: z.ZodEnum<{
+        REVIEW: "REVIEW";
+        KNOWLEDGE: "KNOWLEDGE";
+        INSIGHT: "INSIGHT";
+    }>;
+    version: z.ZodNumber;
+    status: z.ZodEnum<{
+        DRAFT: "DRAFT";
+        READY_FOR_REVIEW: "READY_FOR_REVIEW";
+        REWORK_REQUIRED: "REWORK_REQUIRED";
+        APPROVED: "APPROVED";
+        REJECTED: "REJECTED";
+    }>;
+    contentHash: z.ZodString;
+    inserted: z.ZodBoolean;
+}, z.core.$strict>;
+export declare const managementToolInputSchemas: {
+    readonly knowledge_compose: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
+        projectRef: z.ZodString;
+        sourceEvidenceRefs: z.ZodArray<z.ZodString>;
+        primarySourceEvidenceRef: z.ZodOptional<z.ZodString>;
+        artifactId: z.ZodString;
+        expectedVersion: z.ZodNumber;
+        composedAt: z.ZodISODateTime;
+        validUntil: z.ZodOptional<z.ZodISODateTime>;
+        outputKind: z.ZodEnum<{
+            KNOWLEDGE: "KNOWLEDGE";
+            INSIGHT: "INSIGHT";
+        }>;
+        publicationProfile: z.ZodOptional<z.ZodEnum<{
+            HUMAN_ARTICLE_V1: "HUMAN_ARTICLE_V1";
+            KNOWLEDGE_CARD_V1: "KNOWLEDGE_CARD_V1";
+        }>>;
+        title: z.ZodOptional<z.ZodString>;
+        composition: z.ZodOptional<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>>;
+    }, z.core.$strict>>;
+    readonly knowledge_submit_review: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
+        projectRef: z.ZodString;
+        ref: z.ZodString;
+        expectedVersion: z.ZodNumber;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+    readonly knowledge_review: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
+        projectRef: z.ZodString;
+        targetRef: z.ZodString;
+        expectedVersion: z.ZodNumber;
+        decision: z.ZodEnum<{
+            PASS: "PASS";
+            REWORK: "REWORK";
+            REJECT: "REJECT";
+        }>;
+        reviewedAt: z.ZodISODateTime;
+        summary: z.ZodString;
+        evidenceRefs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    readonly knowledge_finalize_review: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
+        projectRef: z.ZodString;
+        ref: z.ZodString;
+        expectedVersion: z.ZodNumber;
+        nextStatus: z.ZodEnum<{
+            REWORK_REQUIRED: "REWORK_REQUIRED";
+            APPROVED: "APPROVED";
+            REJECTED: "REJECTED";
+        }>;
+        reviewRef: z.ZodString;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+};
+export declare const managementToolErrorOutputSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly errorCode: {
+            readonly type: "string";
+        };
+        readonly completedPhase: {
+            readonly type: "string";
+            readonly enum: readonly ["VALIDATED", "PERSISTED", "CATALOG_PROJECTED"];
+        };
+        readonly ref: z.core.ZodStandardJSONSchemaPayload<z.ZodString>;
+    };
+    readonly required: readonly ["errorCode"];
+    readonly additionalProperties: false;
+};
+export declare const managementToolOutputSchema: {
+    readonly type: "object";
+    readonly oneOf: readonly [z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        projectRef: z.ZodString;
+        ref: z.ZodString;
+        kind: z.ZodEnum<{
+            REVIEW: "REVIEW";
+            KNOWLEDGE: "KNOWLEDGE";
+            INSIGHT: "INSIGHT";
+        }>;
+        version: z.ZodNumber;
+        status: z.ZodEnum<{
+            DRAFT: "DRAFT";
+            READY_FOR_REVIEW: "READY_FOR_REVIEW";
+            REWORK_REQUIRED: "REWORK_REQUIRED";
+            APPROVED: "APPROVED";
+            REJECTED: "REJECTED";
+        }>;
+        contentHash: z.ZodString;
+        inserted: z.ZodBoolean;
+    }, z.core.$strict>>, {
+        readonly type: "object";
+        readonly properties: {
+            readonly errorCode: {
+                readonly type: "string";
+            };
+            readonly completedPhase: {
+                readonly type: "string";
+                readonly enum: readonly ["VALIDATED", "PERSISTED", "CATALOG_PROJECTED"];
+            };
+            readonly ref: z.core.ZodStandardJSONSchemaPayload<z.ZodString>;
+        };
+        readonly required: readonly ["errorCode"];
+        readonly additionalProperties: false;
+    }];
+};