@harrylabsj/kiwi 0.7.9 → 0.7.11

package/dist/http/server.js

@@ -0,0 +1,297 @@
+/**
+ * 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-http —— Buyer Core 的 HTTP 包装（战略 v2.5 §6.3/§6.5/Appendix A）。
+ *
+ * 与 MCP 同一 buyer-core（KiwiBuyerService），不同包装：证明"单核心、多包装"——
+ * 未来新宿主出现时接入从"重写产品"降为"写一个薄适配器"（§6.3）。
+ *
+ * 暴露与 7 个 MCP 工具一一对应的 HTTP 端点（同一语义不变量：schema/授权门/
+ * 幂等/错误分类）。本 server 不持有任何商业状态——状态唯一权威在持久 store。
+ */
+import { createServer } from "node:http";
+import { KiwiBuyerService } from "../buyer-core/service.js";
+import { McpError } from "../buyer-core/errors.js";
+import { buildMerchantUcpProfile } from "../merchant/ucp-profile.js";
+export function createBuyerHttpServer(options) {
+    const { service, merchantUcp, merchantOps } = options;
+    const readJson = (req) => new Promise((resolve, reject) => {
+        let data = "";
+        req.on("data", (chunk) => {
+            data += chunk.toString();
+            if (data.length > 256 * 1024)
+                reject(new Error("request body too large"));
+        });
+        req.on("end", () => {
+            if (data.trim() === "")
+                return resolve({});
+            try {
+                resolve(JSON.parse(data));
+            }
+            catch {
+                reject(new Error("invalid JSON body"));
+            }
+        });
+        req.on("error", reject);
+    });
+    const send = (res, status, body) => {
+        res.writeHead(status, { "content-type": "application/json" });
+        res.end(JSON.stringify(body));
+    };
+    const sendError = (res, error) => {
+        if (error instanceof McpError) {
+            return send(res, 400, { ok: false, error: { code: error.code, message: error.message } });
+        }
+        return send(res, 500, {
+            ok: false,
+            error: { code: "internal_error", message: error instanceof Error ? error.message : String(error) },
+        });
+    };
+    const routes = [
+        { method: "GET", path: "/health", handler: async (_b, _p, res) => send(res, 200, { ok: true, service: "kiwi-buyer-http" }) },
+        {
+            method: "POST", path: "/search", handler: async (b, _p, res) => {
+                try {
+                    const result = await service.search({
+                        query: String(b.query ?? ""),
+                        category: b.category === undefined ? undefined : String(b.category),
+                        region: b.region === undefined ? undefined : String(b.region),
+                    });
+                    send(res, 200, { ok: true, result });
+                }
+                catch (e) {
+                    sendError(res, e);
+                }
+            },
+        },
+        {
+            method: "POST", path: "/tasks", handler: async (b, _p, res) => {
+                try {
+                    const result = await service.requestQuotes({
+                        intent: (b.intent ?? {}),
+                        idempotency_key: b.idempotency_key === undefined ? undefined : String(b.idempotency_key),
+                        merchant_ids: b.merchant_ids === undefined ? undefined : b.merchant_ids.map(String),
+                    });
+                    send(res, 201, { ok: true, result });
+                }
+                catch (e) {
+                    sendError(res, e);
+                }
+            },
+        },
+        {
+            method: "GET", path: "/tasks/:id", handler: async (_b, p, res) => {
+                try {
+                    send(res, 200, { ok: true, result: service.getTask(p.id ?? "") });
+                }
+                catch (e) {
+                    sendError(res, e);
+                }
+            },
+        },
+        {
+            method: "POST", path: "/tasks/:id/negotiate", handler: async (b, p, res) => {
+                try {
+                    const result = await service.negotiate({
+                        task_id: p.id ?? "",
+                        action: b.action === "clarification" ? "clarification" : "counter_offer",
+                        summary: String(b.summary ?? ""),
+                    });
+                    send(res, 200, { ok: true, result });
+                }
+                catch (e) {
+                    sendError(res, e);
+                }
+            },
+        },
+        {
+            method: "POST", path: "/tasks/:id/agreement", handler: async (b, p, res) => {
+                try {
+                    const result = await service.acceptAgreement({
+                        task_id: p.id ?? "",
+                        candidate_id: String(b.candidate_id ?? ""),
+                        approval_id: b.approval_id === undefined ? undefined : String(b.approval_id),
+                    });
+                    send(res, 201, {
+                        ok: true,
+                        result: { agreement: result.agreement, authorization: result.authorization },
+                    });
+                }
+                catch (e) {
+                    sendError(res, e);
+                }
+            },
+        },
+        {
+            method: "GET", path: "/agreements/:id", handler: async (_b, p, res) => {
+                try {
+                    send(res, 200, { ok: true, result: service.getAgreement(p.id ?? "") });
+                }
+                catch (e) {
+                    sendError(res, e);
+                }
+            },
+        },
+        {
+            method: "POST", path: "/agreements/:id/handoff", handler: async (b, p, res) => {
+                try {
+                    const result = await service.handoff({
+                        agreement_id: p.id ?? "",
+                        approval_id: String(b.approval_id ?? ""),
+                        destination_type: String(b.destination_type ?? ""),
+                        url: b.url === undefined ? undefined : String(b.url),
+                    });
+                    send(res, 200, { ok: true, result });
+                }
+                catch (e) {
+                    sendError(res, e);
+                }
+            },
+        },
+        {
+            method: "POST", path: "/approvals", handler: async (b, _p, res) => {
+                try {
+                    const result = service.requestApproval({
+                        task_id: String(b.task_id ?? ""),
+                        action: b.action,
+                        candidate_digest: b.candidate_digest === undefined ? undefined : String(b.candidate_digest),
+                    });
+                    send(res, 201, { ok: true, result });
+                }
+                catch (e) {
+                    sendError(res, e);
+                }
+            },
+        },
+        {
+            // Merchant Ops RFQ 队列（§7.6）：kiwi.merchant.rfqs。
+            method: "GET", path: "/merchant/:id/rfqs", handler: async (_b, p, res) => {
+                const ops = merchantOps?.[p.id ?? ""];
+                if (ops === undefined)
+                    return send(res, 404, { ok: false, error: { code: "merchant_not_found", message: `no ops for ${p.id}` } });
+                try {
+                    send(res, 200, { ok: true, result: await ops.listRfqQueue(p.id ?? "") });
+                }
+                catch (e) {
+                    sendError(res, e);
+                }
+            },
+        },
+        {
+            // Merchant Ops human_required（§7.6）：kiwi.merchant.reviews。
+            method: "GET", path: "/merchant/:id/human-review", handler: async (_b, p, res) => {
+                const ops = merchantOps?.[p.id ?? ""];
+                if (ops === undefined)
+                    return send(res, 404, { ok: false, error: { code: "merchant_not_found", message: `no ops for ${p.id}` } });
+                try {
+                    send(res, 200, { ok: true, result: await ops.listHumanReview(p.id ?? "") });
+                }
+                catch (e) {
+                    sendError(res, e);
+                }
+            },
+        },
+        {
+            // Merchant Ops analytics（§7.6）：kiwi.merchant.analytics。
+            method: "GET", path: "/merchant/:id/analytics", handler: async (_b, p, res) => {
+                const ops = merchantOps?.[p.id ?? ""];
+                if (ops === undefined)
+                    return send(res, 404, { ok: false, error: { code: "merchant_not_found", message: `no ops for ${p.id}` } });
+                try {
+                    send(res, 200, { ok: true, result: await ops.analytics(p.id ?? "") });
+                }
+                catch (e) {
+                    sendError(res, e);
+                }
+            },
+        },
+        {
+            // Merchant Ops 处理 human_required（§7.6）：kiwi.merchant.approve。
+            method: "POST", path: "/merchant/:id/resolve-review", handler: async (b, p, res) => {
+                const ops = merchantOps?.[p.id ?? ""];
+                if (ops === undefined)
+                    return send(res, 404, { ok: false, error: { code: "merchant_not_found", message: `no ops for ${p.id}` } });
+                try {
+                    const result = await ops.resolveReview(p.id ?? "", String(b.conversation_id ?? ""), String(b.decision ?? "approve"));
+                    send(res, 200, { ok: true, result });
+                }
+                catch (e) {
+                    sendError(res, e);
+                }
+            },
+        },
+        {
+            // Merchant UCP Profile 发布（§7.1 Protocol Publishing）：返回 `/.well-known/ucp`。
+            method: "GET", path: "/merchants/:id/ucp", handler: async (_b, p, res) => {
+                const mid = p.id ?? "";
+                const config = merchantUcp?.[mid];
+                if (config === undefined) {
+                    return send(res, 404, { ok: false, error: { code: "merchant_not_found", message: `no UCP config for ${mid}` } });
+                }
+                try {
+                    const profile = buildMerchantUcpProfile({ domain: config.domain, merchantId: mid, catalogEndpoint: config.catalogEndpoint });
+                    send(res, 200, { ok: true, ucp: profile });
+                }
+                catch (e) {
+                    sendError(res, e);
+                }
+            },
+        },
+        {
+            method: "POST", path: "/approvals/:id/approve", handler: async (b, p, res) => {
+                try {
+                    service.approveApproval({
+                        approval_id: p.id ?? "",
+                        authorization: (b.authorization ?? {}),
+                    });
+                    send(res, 200, { ok: true });
+                }
+                catch (e) {
+                    sendError(res, e);
+                }
+            },
+        },
+    ];
+    return createServer(async (req, res) => {
+        const url = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
+        const segments = url.pathname.split("/").filter(Boolean);
+        const method = req.method ?? "GET";
+        for (const route of routes) {
+            const routeSegments = route.path.split("/").filter(Boolean);
+            if (routeSegments.length !== segments.length || route.method !== method)
+                continue;
+            let match = true;
+            const params = {};
+            for (let i = 0; i < routeSegments.length; i += 1) {
+                const rs = routeSegments[i];
+                const ss = segments[i];
+                if (rs.startsWith(":"))
+                    params[rs.slice(1)] = ss;
+                else if (rs !== ss) {
+                    match = false;
+                    break;
+                }
+            }
+            if (!match)
+                continue;
+            const body = await readJson(req).catch(() => ({}));
+            await route.handler(body, params, res);
+            return;
+        }
+        send(res, 404, { ok: false, error: { code: "not_found", message: `${method} ${url.pathname}` } });
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/http/server.js.map

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

package/dist/mcp/cli.d.ts

@@ -0,0 +1,70 @@
+/**
+ * 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.
+ */
+export declare const KIWI_MCP_VERSION = "0.1.0";
+/**
+ * 默认 catalog 入口（kiwi-catalog 公网地址）。kiwi-buyer 默认经它发现商家；
+ * 用户无需配置，可用 --catalog-url <url> 覆盖。
+ */
+export declare const DEFAULT_CATALOG_URL = "https://catalog.kiwi.harrylabsj.com";
+/** 内置安全默认 DelegationPolicy（§5.3 默认映射）。 */
+export declare const DEFAULT_DELEGATION_POLICY: {
+    readonly policy_id: "dp-default";
+    readonly version: "1.0";
+    readonly principal: "principal:unset";
+    readonly expires_at: "2099-12-31T23:59:59Z";
+    readonly actions: {
+        readonly discover: {
+            readonly mode: "auto";
+        };
+        readonly inquiry_rfq: {
+            readonly mode: "auto";
+        };
+        readonly compare_offers: {
+            readonly mode: "auto";
+        };
+        readonly counter_offer: {
+            readonly mode: "auto";
+            readonly note: "受限 AUTO：受 limits 约束";
+        };
+        readonly accept_nonbinding: {
+            readonly mode: "ask";
+        };
+        readonly handoff: {
+            readonly mode: "ask";
+        };
+        readonly payment: {
+            readonly mode: "never";
+        };
+    };
+    readonly limits: {
+        readonly max_rounds: 3;
+    };
+};
+export interface McpServeOptions {
+    db?: string;
+    principal?: string;
+    buyerAgentId?: string;
+    sessionId?: string;
+    policy?: Record<string, unknown>;
+    catalogUrl?: string;
+    marketplaceUrl?: string;
+    buyerBootstrapToken?: string;
+    a2aBearerToken?: string;
+    a2aAllowPrivateRanges?: boolean;
+    a2aSkipDnsCheck?: boolean;
+    a2aTimeoutMs?: number;
+}
+export declare function runMcpServe(args: string[]): Promise<number>;

package/dist/mcp/cli.js

@@ -0,0 +1,147 @@
+/**
+ * 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 mcp serve` —— 启动 kiwi-buyer-mcp stdio server（战略 v2.5 §6.1/§6.5）。
+ *
+ * 配置来源：
+ *   --db <path>        持久 store 路径（默认 ./.kiwi/mcp/state.sqlite）
+ *   --principal <id>   Principal opaque 标识（默认 env KIWI_PRINCIPAL）
+ *   --agent <id>       buyer_agent_id（默认 env KIWI_BUYER_AGENT）
+ *   --session <id>     session_id（默认 env KIWI_SESSION）
+ *   --policy <file>    冻结 DelegationPolicy JSON（默认 env KIWI_DELEGATION_POLICY；
+ *                      未提供则用内置安全默认：读 AUTO、accept/handoff ASK、payment NEVER）
+ *   --catalog-url      真实 merchant 网络：catalog 发现 → A2A 直连 merchant（listings
+ *                      感知搜索 + A2AQuoteFetcher/A2ANegotiator）
+ *   --marketplace-url  试点兼容：shopping-cli 直连（MarketplaceQuoteFetcher/Negotiator）
+ *   --a2a-bearer-token / --a2a-allow-private-ranges / --a2a-skip-dns-check /
+ *   --a2a-timeout-ms    A2A 轨可选配置
+ *
+ * 执行 seam（MerchantIndex/QuoteFetcher/Negotiator）已接线：marketplaceUrl 优先，
+ * 否则 catalogUrl → A2A 直连 merchant 网络；本 server 负责契约面 + 持久任务/审批状态机。
+ */
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { assertNorthboundContractValid } from "../contracts/northbound-schema.js";
+import { buildBuyerService } from "../buyer-core/build-service.js";
+import { McpServer } from "./server.js";
+import { buildKiwiTools } from "./tools.js";
+export const KIWI_MCP_VERSION = "0.1.0";
+/**
+ * 默认 catalog 入口（kiwi-catalog 公网地址）。kiwi-buyer 默认经它发现商家；
+ * 用户无需配置，可用 --catalog-url <url> 覆盖。
+ */
+export const DEFAULT_CATALOG_URL = "https://catalog.kiwi.harrylabsj.com";
+/** 内置安全默认 DelegationPolicy（§5.3 默认映射）。 */
+export const DEFAULT_DELEGATION_POLICY = {
+    policy_id: "dp-default",
+    version: "1.0",
+    principal: "principal:unset",
+    expires_at: "2099-12-31T23:59:59Z",
+    actions: {
+        discover: { mode: "auto" },
+        inquiry_rfq: { mode: "auto" },
+        compare_offers: { mode: "auto" },
+        counter_offer: { mode: "auto", note: "受限 AUTO：受 limits 约束" },
+        accept_nonbinding: { mode: "ask" },
+        handoff: { mode: "ask" },
+        payment: { mode: "never" },
+    },
+    limits: { max_rounds: 3 },
+};
+function readPolicy(options, principal) {
+    const fromEnv = process.env.KIWI_DELEGATION_POLICY;
+    if (fromEnv !== undefined && fromEnv.trim() !== "") {
+        try {
+            return JSON.parse(fromEnv);
+        }
+        catch {
+            throw new Error("KIWI_DELEGATION_POLICY is not valid JSON");
+        }
+    }
+    const raw = options.policy !== undefined
+        ? options.policy
+        : { ...DEFAULT_DELEGATION_POLICY, principal };
+    assertNorthboundContractValid("delegation-policy", raw, "delegation policy");
+    return raw;
+}
+export async function runMcpServe(args) {
+    const opts = {};
+    for (let i = 0; i < args.length; i += 1) {
+        const flag = args[i];
+        const value = args[i + 1];
+        if (value === undefined)
+            continue;
+        if (flag === "--db")
+            opts.db = value;
+        else if (flag === "--principal")
+            opts.principal = value;
+        else if (flag === "--agent")
+            opts.buyerAgentId = value;
+        else if (flag === "--session")
+            opts.sessionId = value;
+        else if (flag === "--catalog-url")
+            opts.catalogUrl = value;
+        else if (flag === "--marketplace-url")
+            opts.marketplaceUrl = value;
+        else if (flag === "--buyer-bootstrap-token")
+            opts.buyerBootstrapToken = value;
+        else if (flag === "--a2a-bearer-token")
+            opts.a2aBearerToken = value;
+        else if (flag === "--a2a-allow-private-ranges")
+            opts.a2aAllowPrivateRanges = value === "true";
+        else if (flag === "--a2a-skip-dns-check")
+            opts.a2aSkipDnsCheck = value === "true";
+        else if (flag === "--a2a-timeout-ms")
+            opts.a2aTimeoutMs = Number(value);
+        else if (flag === "--policy") {
+            try {
+                opts.policy = JSON.parse(readFileSync(value, "utf-8"));
+            }
+            catch {
+                process.stderr.write(`cannot read --policy file ${value}\n`);
+                return 2;
+            }
+        }
+    }
+    const principal = opts.principal ?? process.env.KIWI_PRINCIPAL ?? "principal:local";
+    const buyerAgentId = opts.buyerAgentId ?? process.env.KIWI_BUYER_AGENT ?? "buyer-agent:kiwi-mcp";
+    const sessionId = opts.sessionId ?? process.env.KIWI_SESSION ?? `session-${process.pid}`;
+    const policy = readPolicy(opts, principal);
+    const dbPath = opts.db ?? path.join(".kiwi", "mcp", "state.sqlite");
+    // 单核心多包装：MCP 与 HTTP 共用同一 buildBuyerService（§6.3）。
+    const service = buildBuyerService({
+        dbPath,
+        principal,
+        buyerAgentId,
+        sessionId,
+        policy,
+        catalogUrl: opts.catalogUrl ?? DEFAULT_CATALOG_URL,
+        marketplaceUrl: opts.marketplaceUrl,
+        buyerBootstrapToken: opts.buyerBootstrapToken ?? process.env.SHOPPING_BUYER_BOOTSTRAP_TOKEN,
+        a2aBearerToken: opts.a2aBearerToken,
+        a2aAllowPrivateRanges: opts.a2aAllowPrivateRanges,
+        a2aSkipDnsCheck: opts.a2aSkipDnsCheck,
+        a2aTimeoutMs: opts.a2aTimeoutMs,
+    });
+    const tools = buildKiwiTools(service);
+    const server = new McpServer({
+        tools,
+        serverInfo: { name: "kiwi-buyer-mcp", version: KIWI_MCP_VERSION },
+    });
+    await server.serve();
+    return 0;
+}
+//# sourceMappingURL=cli.js.map

package/dist/mcp/cli.js.map

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

package/dist/mcp/server.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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 { type JsonRpcResponse } from "./types.js";
+import type { KiwiToolDefinition } from "./types.js";
+export interface McpServerOptions {
+    tools: KiwiToolDefinition[];
+    serverInfo: {
+        name: string;
+        version: string;
+    };
+}
+export declare class McpServer {
+    private readonly tools;
+    private readonly serverInfo;
+    private initialized;
+    private initRequested;
+    constructor(options: McpServerOptions);
+    /** 处理单个 JSON-RPC 消息，返回响应（notification 返回 undefined）。 */
+    handleMessage(raw: string): Promise<JsonRpcResponse | undefined>;
+    private requireInit;
+    private handleInitialize;
+    private handleListTools;
+    private handleCallTool;
+    private result;
+    private error;
+    /** 阻塞运行 stdio 循环（CLI 入口）。逐行读 stdin，逐行写 stdout。 */
+    serve(): Promise<void>;
+}