@harrylabsj/kiwi 0.7.9 → 0.7.11

package/dist/mcp/server.js

@@ -0,0 +1,141 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * kiwi-buyer-mcp stdio server（战略 v2.5 §6.1）。
+ *
+ * 最小 JSON-RPC 2.0 MCP 实现：initialize 握手（version negotiation，fail-closed）、
+ * notifications/initialized、tools/list、tools/call；未实现方法一律
+ * METHOD_NOT_FOUND；初始化前调用 tools/* 返回 SERVER_NOT_INITIALIZED。
+ * 一行一行读 stdin（readline），每行一个 JSON-RPC 消息，响应写 stdout 换行分隔。
+ *
+ * 本 server 不持有任何商业状态——状态唯一权威在 KiwiBuyerService 的持久 store。
+ * 输入/输出均投影，不保存第二套状态机（§6.2）。
+ */
+import { createInterface } from "node:readline";
+import { MCP_ERROR } from "./types.js";
+import { MCP_PROTOCOL_VERSIONS } from "./types.js";
+import { McpError } from "../buyer-core/errors.js";
+export class McpServer {
+    tools;
+    serverInfo;
+    initialized = false;
+    initRequested = false;
+    constructor(options) {
+        this.tools = new Map(options.tools.map((t) => [t.name, t]));
+        this.serverInfo = options.serverInfo;
+    }
+    /** 处理单个 JSON-RPC 消息，返回响应（notification 返回 undefined）。 */
+    async handleMessage(raw) {
+        let request;
+        try {
+            request = JSON.parse(raw);
+        }
+        catch {
+            return this.error(null, MCP_ERROR.PARSE_ERROR, "parse error: not valid JSON");
+        }
+        if (request.jsonrpc !== "2.0" || typeof request.method !== "string") {
+            return this.error(request.id, MCP_ERROR.INVALID_REQUEST, "invalid request: expected jsonrpc 2.0 request");
+        }
+        try {
+            switch (request.method) {
+                case "initialize":
+                    return await this.handleInitialize(request);
+                case "notifications/initialized":
+                    if (this.initRequested)
+                        this.initialized = true;
+                    return undefined;
+                case "tools/list":
+                    return this.requireInit(request, () => this.handleListTools(request));
+                case "tools/call":
+                    return this.requireInit(request, () => this.handleCallTool(request));
+                default:
+                    return this.error(request.id, MCP_ERROR.METHOD_NOT_FOUND, `method not found: ${request.method}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof McpError) {
+                return this.error(request.id, error.toJsonRpc().code, error.message, error.detail);
+            }
+            return this.error(request.id, MCP_ERROR.INTERNAL_ERROR, `internal error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async requireInit(request, fn) {
+        if (!this.initialized) {
+            return this.error(request.id, MCP_ERROR.SERVER_NOT_INITIALIZED, "server not initialized: call initialize first");
+        }
+        return fn();
+    }
+    async handleInitialize(request) {
+        const params = (request.params ?? {});
+        const requested = params.protocolVersion;
+        if (typeof requested !== "string" || !MCP_PROTOCOL_VERSIONS.includes(requested)) {
+            // version negotiation fail-closed：未知版本拒绝（§6.10 兼容矩阵 fail closed）。
+            return this.error(request.id, MCP_ERROR.INVALID_PARAMS, `unsupported MCP protocol version: ${String(requested)}`);
+        }
+        // 规范：initialize 只协商版本；随后客户端发 notifications/initialized 后才允许
+        // tools/*。因此这里只标记 initRequested，不放行工具调用。
+        this.initRequested = true;
+        const result = {
+            protocolVersion: requested,
+            capabilities: { tools: { listChanged: false } },
+            serverInfo: this.serverInfo,
+        };
+        return this.result(request.id, result);
+    }
+    handleListTools(request) {
+        const result = {
+            tools: [...this.tools.values()].map((t) => ({
+                name: t.name,
+                description: t.description,
+                inputSchema: t.inputSchema,
+            })),
+        };
+        return this.result(request.id, result);
+    }
+    async handleCallTool(request) {
+        const params = (request.params ?? {});
+        if (typeof params.name !== "string") {
+            return this.error(request.id, MCP_ERROR.INVALID_PARAMS, "tools/call requires params.name");
+        }
+        const tool = this.tools.get(params.name);
+        if (tool === undefined) {
+            return this.error(request.id, MCP_ERROR.TOOL_NOT_FOUND, `tool not found: ${params.name}`);
+        }
+        const args = params.arguments !== undefined && typeof params.arguments === "object"
+            ? params.arguments
+            : {};
+        const toolResult = await tool.handle(args);
+        return this.result(request.id, toolResult);
+    }
+    result(id, result) {
+        return { jsonrpc: "2.0", id, result };
+    }
+    error(id, code, message, data) {
+        return { jsonrpc: "2.0", id, error: { code, message, data } };
+    }
+    /** 阻塞运行 stdio 循环（CLI 入口）。逐行读 stdin，逐行写 stdout。 */
+    async serve() {
+        const rl = createInterface({ input: process.stdin });
+        for await (const line of rl) {
+            if (line.trim() === "")
+                continue;
+            const response = await this.handleMessage(line);
+            if (response !== undefined)
+                process.stdout.write(`${JSON.stringify(response)}\n`);
+        }
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}

package/dist/mcp/tools.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * 7 个高层 Kiwi Sourcing Tools（战略 v2.5 §6.1，词表单一来源见 KIWI_SOURCING_TOOLS）。
+ *
+ * 原则：不暴露 KNP 每个底层消息、不复制 UCP 的 Catalog/Checkout tools；宿主 Agent
+ * 用少量跨 Merchant 高层工具完成『找供应商 → RFQ → 比较 → 磋商 → Agreement →
+ * UCP handoff』编排。每个写工具绑定 idempotency_key 并返回稳定 task_id /
+ * candidate_id / approval_id / agreement_id（§6.2）。业务错误经 isError 带内返回，
+ * 错误分类（McpError.code）作为跨宿主语义不变量（§6.10）。
+ */
+import type { KiwiToolDefinition } from "./types.js";
+import { KiwiBuyerService } from "../buyer-core/service.js";
+/** 构造 7 个高层工具。任意 handler 抛出的 McpError 都会被转成 isError 结果。 */
+export declare function buildKiwiTools(service: KiwiBuyerService): KiwiToolDefinition[];

package/dist/mcp/tools.js

@@ -0,0 +1,299 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { McpError } from "../buyer-core/errors.js";
+import { KiwiBuyerService } from "../buyer-core/service.js";
+function ok(text) {
+    return { content: [{ type: "text", text }] };
+}
+function err(error) {
+    if (error instanceof McpError) {
+        return {
+            content: [{ type: "text", text: `error ${error.code}: ${error.message}` }],
+            isError: true,
+        };
+    }
+    return {
+        content: [{ type: "text", text: `error internal_error: ${error instanceof Error ? error.message : String(error)}` }],
+        isError: true,
+    };
+}
+/**
+ * ASK 动作遇 approval_required 时的结构化返回：不抛 isError，而是返回
+ * `{ approval_required: { approval_id }, ...extra }`——宿主拿到持久 approval_id
+ * 呈现给用户确认后调 kiwi_approve，再携 id 重试。approval_id 是 first-class 值，
+ * 不从错误文本解析。
+ */
+function approvalRequiredOrErr(error, extra) {
+    if (error instanceof McpError && error.code === "approval_required") {
+        const approvalId = error.detail?.approval_id;
+        return ok(JSON.stringify({ approval_required: { approval_id: approvalId }, ...extra }));
+    }
+    return err(error);
+}
+/** 构造 7 个高层工具。任意 handler 抛出的 McpError 都会被转成 isError 结果。 */
+export function buildKiwiTools(service) {
+    const tools = [
+        {
+            name: "kiwi_search",
+            description: "发现候选供应商，并按需跨商家搜索商品。只读。内部语义：Merchant routing + UCP Catalog orchestration + trust/freshness。",
+            inputSchema: {
+                $schema: "https://json-schema.org/draft/2020-12/schema",
+                type: "object",
+                additionalProperties: false,
+                required: ["query"],
+                properties: {
+                    query: { type: "string", minLength: 1 },
+                    category: { type: "string" },
+                    region: { type: "string" },
+                },
+            },
+            async handle(args) {
+                try {
+                    const result = await service.search({
+                        query: String(args.query),
+                        category: args.category === undefined ? undefined : String(args.category),
+                        region: args.region === undefined ? undefined : String(args.region),
+                    });
+                    return ok(JSON.stringify({ merchants: result.merchants, note: result.note }));
+                }
+                catch (error) {
+                    return err(error);
+                }
+            },
+        },
+        {
+            name: "kiwi_request_quotes",
+            description: "向一个或多个商家发起询价。写操作；必须携带 idempotency_key（可选，缺省自动生成），返回稳定 task_id；KNP RFQ fan-out。CommerceIntent 必须满足冻结契约。",
+            inputSchema: {
+                $schema: "https://json-schema.org/draft/2020-12/schema",
+                type: "object",
+                additionalProperties: false,
+                required: ["intent"],
+                properties: {
+                    intent: {
+                        type: "object",
+                        additionalProperties: true,
+                        required: ["intent_id", "intent_type", "items"],
+                        properties: {
+                            intent_id: { type: "string", minLength: 1 },
+                            intent_type: { type: "string", enum: ["purchase", "procurement", "inquiry"] },
+                            items: { type: "array", minItems: 1 },
+                        },
+                    },
+                    idempotency_key: { type: "string", minLength: 1 },
+                    merchant_ids: { type: "array", items: { type: "string", minLength: 1 } },
+                },
+            },
+            async handle(args) {
+                try {
+                    const result = await service.requestQuotes({
+                        intent: (args.intent ?? {}),
+                        idempotency_key: args.idempotency_key === undefined ? undefined : String(args.idempotency_key),
+                        merchant_ids: args.merchant_ids === undefined
+                            ? undefined
+                            : args.merchant_ids.map(String),
+                    });
+                    return ok(JSON.stringify({ task_id: result.task.task_id, task: result.task, created: result.created }));
+                }
+                catch (error) {
+                    return err(error);
+                }
+            },
+        },
+        {
+            name: "kiwi_get_task",
+            description: "读取任务状态、报价、部分失败、待审批与过期信息。统一 status/resume 读取面；替代把 offer/pending 状态放在插件内存。",
+            inputSchema: {
+                $schema: "https://json-schema.org/draft/2020-12/schema",
+                type: "object",
+                additionalProperties: false,
+                required: ["task_id"],
+                properties: { task_id: { type: "string", minLength: 1 } },
+            },
+            async handle(args) {
+                try {
+                    return ok(JSON.stringify(service.getTask(String(args.task_id))));
+                }
+                catch (error) {
+                    return err(error);
+                }
+            },
+        },
+        {
+            name: "kiwi_negotiate",
+            description: "在委托边界内推进磋商。更新同一 task_id；CounterOffer / Clarification；可产生 candidate_id；受 DelegationPolicy max_rounds 等硬约束。",
+            inputSchema: {
+                $schema: "https://json-schema.org/draft/2020-12/schema",
+                type: "object",
+                additionalProperties: false,
+                required: ["task_id", "action", "summary"],
+                properties: {
+                    task_id: { type: "string", minLength: 1 },
+                    action: { type: "string", enum: ["counter_offer", "clarification"] },
+                    summary: { type: "string", minLength: 1 },
+                },
+            },
+            async handle(args) {
+                try {
+                    const result = await service.negotiate({
+                        task_id: String(args.task_id),
+                        action: args.action,
+                        summary: String(args.summary),
+                    });
+                    return ok(JSON.stringify(result));
+                }
+                catch (error) {
+                    return err(error);
+                }
+            },
+        },
+        {
+            name: "kiwi_accept_agreement",
+            description: "请求确认并接受非绑定协议。要求有效 approval_id + candidate_id；输出稳定 agreement_id。DelegationPolicy=ask 时若缺审批会返回 approval_required（含持久 approval_id），宿主完成人工审批后携 approval_id 重试。",
+            inputSchema: {
+                $schema: "https://json-schema.org/draft/2020-12/schema",
+                type: "object",
+                additionalProperties: false,
+                required: ["task_id", "candidate_id"],
+                properties: {
+                    task_id: { type: "string", minLength: 1 },
+                    candidate_id: { type: "string", minLength: 1 },
+                    approval_id: { type: "string", minLength: 1 },
+                },
+            },
+            async handle(args) {
+                try {
+                    const result = await service.acceptAgreement({
+                        task_id: String(args.task_id),
+                        candidate_id: String(args.candidate_id),
+                        approval_id: args.approval_id === undefined ? undefined : String(args.approval_id),
+                    });
+                    return ok(JSON.stringify(result));
+                }
+                catch (error) {
+                    return approvalRequiredOrErr(error, {
+                        task_id: String(args.task_id),
+                        candidate_id: String(args.candidate_id),
+                    });
+                }
+            },
+        },
+        {
+            name: "kiwi_get_agreement",
+            description: "读取最终协议、provenance 与审计摘要。只读；Agreement retrieval + digest + audit summary。",
+            inputSchema: {
+                $schema: "https://json-schema.org/draft/2020-12/schema",
+                type: "object",
+                additionalProperties: false,
+                required: ["agreement_id"],
+                properties: { agreement_id: { type: "string", minLength: 1 } },
+            },
+            async handle(args) {
+                try {
+                    return ok(JSON.stringify(service.getAgreement(String(args.agreement_id))));
+                }
+                catch (error) {
+                    return err(error);
+                }
+            },
+        },
+        {
+            name: "kiwi_handoff",
+            description: "生成交易/PO/联系路径。Agreement → UCP Checkout / merchant transaction endpoint。ASK 时缺审批返回结构化 approval_required（含 approval_id），宿主 kiwi_approve 后携 id 重试。",
+            inputSchema: {
+                $schema: "https://json-schema.org/draft/2020-12/schema",
+                type: "object",
+                additionalProperties: false,
+                required: ["agreement_id", "destination_type"],
+                properties: {
+                    agreement_id: { type: "string", minLength: 1 },
+                    approval_id: { type: "string", minLength: 1 },
+                    destination_type: { type: "string", minLength: 1 },
+                    url: { type: "string" },
+                },
+            },
+            async handle(args) {
+                try {
+                    const result = await service.handoff({
+                        agreement_id: String(args.agreement_id),
+                        approval_id: args.approval_id === undefined ? undefined : String(args.approval_id),
+                        destination_type: String(args.destination_type),
+                        url: args.url === undefined ? undefined : String(args.url),
+                    });
+                    return ok(JSON.stringify(result));
+                }
+                catch (error) {
+                    return approvalRequiredOrErr(error, {
+                        agreement_id: String(args.agreement_id),
+                        destination_type: String(args.destination_type),
+                    });
+                }
+            },
+        },
+        {
+            name: "kiwi_approve",
+            description: "批准一个持久审批（ASK 门）。宿主在向用户呈现非绑定协议/交接摘要并获得确认后调用；随后携 approval_id 重试 kiwi_accept_agreement / kiwi_handoff。写操作，受宿主审批系统二次拦截。",
+            inputSchema: {
+                $schema: "https://json-schema.org/draft/2020-12/schema",
+                type: "object",
+                additionalProperties: false,
+                required: ["approval_id"],
+                properties: {
+                    approval_id: { type: "string", minLength: 1 },
+                    note: { type: "string" },
+                },
+            },
+            async handle(args) {
+                try {
+                    return ok(JSON.stringify(service.approve({
+                        approval_id: String(args.approval_id),
+                        note: args.note === undefined ? undefined : String(args.note),
+                    })));
+                }
+                catch (error) {
+                    return err(error);
+                }
+            },
+        },
+        {
+            name: "kiwi_reject",
+            description: "拒绝一个持久审批（deny 优先路径）。拒绝后同一 approval_id 无法再批准或形成协议/交接。",
+            inputSchema: {
+                $schema: "https://json-schema.org/draft/2020-12/schema",
+                type: "object",
+                additionalProperties: false,
+                required: ["approval_id"],
+                properties: {
+                    approval_id: { type: "string", minLength: 1 },
+                    reason: { type: "string" },
+                },
+            },
+            async handle(args) {
+                try {
+                    return ok(JSON.stringify(service.reject({
+                        approval_id: String(args.approval_id),
+                        reason: args.reason === undefined ? undefined : String(args.reason),
+                    })));
+                }
+                catch (error) {
+                    return err(error);
+                }
+            },
+        },
+    ];
+    return tools.map(({ raw: _raw, ...t }) => t);
+}
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"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"}

package/dist/mcp/types.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * kiwi-buyer-mcp 薄 facade 的 MCP 协议类型（战略 v2.5 §6.1 / §6.2）。
+ *
+ * 手写 stdio JSON-RPC 2.0 最小 MCP 实现（零新运行时依赖）：只实现 initialize
+ * 握手、notifications/initialized、tools/list、tools/call 与 JSON-RPC 错误面。
+ * 其余 MCP 能力（resources/prompts/sampling/roots）不在 v0.1 范围内——严格
+ * fail-closed，遇到未实现方法返回 METHOD_NOT_FOUND。
+ *
+ * 对外只暴露 5—7 个高层 Sourcing Tools，不暴露 KNP 底层消息、不复制 UCP 的
+ * Catalog/Checkout primitives（§6.1）。每个写 tool 绑定 idempotency_key 并返回
+ * 稳定 task_id / candidate_id / approval_id / agreement_id（§6.2）。
+ */
+/** MCP 协议版本：本 server 接受并回显的标准版本（v0.1）。Hermes v0.20.1 协商 2025-11-25。 */
+export declare const MCP_PROTOCOL_VERSIONS: readonly ["2024-11-05", "2025-06-18", "2025-11-25"];
+/** MCP 错误码（JSON-RPC 标准 + MCP 扩展）。 */
+export declare const MCP_ERROR: {
+    readonly PARSE_ERROR: -32700;
+    readonly INVALID_REQUEST: -32600;
+    readonly METHOD_NOT_FOUND: -32601;
+    readonly INVALID_PARAMS: -32602;
+    readonly INTERNAL_ERROR: -32603;
+    readonly SERVER_NOT_INITIALIZED: -32002;
+    readonly TOOL_NOT_FOUND: -32002;
+};
+export type McpJsonRpcVersion = "2.0";
+export interface JsonRpcRequest {
+    jsonrpc: McpJsonRpcVersion;
+    id: number | string | null;
+    method: string;
+    params?: unknown;
+}
+export interface JsonRpcResponse {
+    jsonrpc: McpJsonRpcVersion;
+    id: number | string | null;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+/** MCP initialize 请求参数（§6.1 version negotiation）。 */
+export interface McpInitializeParams {
+    protocolVersion: string;
+    capabilities?: Record<string, unknown>;
+    clientInfo?: {
+        name: string;
+        version?: string;
+    };
+}
+export interface McpInitializeResult {
+    protocolVersion: string;
+    capabilities: {
+        tools: {
+            listChanged: boolean;
+        };
+    };
+    serverInfo: {
+        name: string;
+        version: string;
+    };
+}
+export interface McpListToolsResult {
+    tools: McpTool[];
+}
+export interface McpTool {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+export interface McpCallToolParams {
+    name: string;
+    arguments?: Record<string, unknown>;
+}
+export interface McpCallToolResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/** 一个高层 Kiwi Sourcing Tool 的声明（§6.1 词表）。 */
+export interface KiwiToolDefinition {
+    name: string;
+    description: string;
+    /** 输入 JSON Schema（2020-12，自包含）。 */
+    inputSchema: Record<string, unknown>;
+    handle(args: Record<string, unknown>): Promise<McpCallToolResult>;
+}
+/** 顶层 Kiwi Sourcing Tool 词表（单一来源，§6.1）。 */
+export declare const KIWI_SOURCING_TOOLS: readonly ["kiwi_search", "kiwi_request_quotes", "kiwi_get_task", "kiwi_negotiate", "kiwi_accept_agreement", "kiwi_get_agreement", "kiwi_handoff", "kiwi_approve", "kiwi_reject"];
+export type KiwiSourcingToolName = (typeof KIWI_SOURCING_TOOLS)[number];

package/dist/mcp/types.js

@@ -0,0 +1,52 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * kiwi-buyer-mcp 薄 facade 的 MCP 协议类型（战略 v2.5 §6.1 / §6.2）。
+ *
+ * 手写 stdio JSON-RPC 2.0 最小 MCP 实现（零新运行时依赖）：只实现 initialize
+ * 握手、notifications/initialized、tools/list、tools/call 与 JSON-RPC 错误面。
+ * 其余 MCP 能力（resources/prompts/sampling/roots）不在 v0.1 范围内——严格
+ * fail-closed，遇到未实现方法返回 METHOD_NOT_FOUND。
+ *
+ * 对外只暴露 5—7 个高层 Sourcing Tools，不暴露 KNP 底层消息、不复制 UCP 的
+ * Catalog/Checkout primitives（§6.1）。每个写 tool 绑定 idempotency_key 并返回
+ * 稳定 task_id / candidate_id / approval_id / agreement_id（§6.2）。
+ */
+/** MCP 协议版本：本 server 接受并回显的标准版本（v0.1）。Hermes v0.20.1 协商 2025-11-25。 */
+export const MCP_PROTOCOL_VERSIONS = ["2024-11-05", "2025-06-18", "2025-11-25"];
+/** MCP 错误码（JSON-RPC 标准 + MCP 扩展）。 */
+export const MCP_ERROR = {
+    PARSE_ERROR: -32700,
+    INVALID_REQUEST: -32600,
+    METHOD_NOT_FOUND: -32601,
+    INVALID_PARAMS: -32602,
+    INTERNAL_ERROR: -32603,
+    SERVER_NOT_INITIALIZED: -32002,
+    TOOL_NOT_FOUND: -32002,
+};
+/** 顶层 Kiwi Sourcing Tool 词表（单一来源，§6.1）。 */
+export const KIWI_SOURCING_TOOLS = [
+    "kiwi_search",
+    "kiwi_request_quotes",
+    "kiwi_get_task",
+    "kiwi_negotiate",
+    "kiwi_accept_agreement",
+    "kiwi_get_agreement",
+    "kiwi_handoff",
+    "kiwi_approve",
+    "kiwi_reject",
+];
+//# sourceMappingURL=types.js.map

package/dist/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;;;GAWG;AAEH,uEAAuE;AACvE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,CAAU,CAAC;AAEzF,qCAAqC;AACrC,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,WAAW,EAAE,CAAC,KAAK;IACnB,eAAe,EAAE,CAAC,KAAK;IACvB,gBAAgB,EAAE,CAAC,KAAK;IACxB,cAAc,EAAE,CAAC,KAAK;IACtB,cAAc,EAAE,CAAC,KAAK;IACtB,sBAAsB,EAAE,CAAC,KAAK;IAC9B,cAAc,EAAE,CAAC,KAAK;CACd,CAAC;AA4DX,2CAA2C;AAC3C,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,aAAa;IACb,qBAAqB;IACrB,eAAe;IACf,gBAAgB;IAChB,uBAAuB;IACvB,oBAAoB;IACpB,cAAc;IACd,cAAc;IACd,aAAa;CACL,CAAC"}