@harrylabsj/kiwi 0.7.9 → 0.7.11

package/dist/buyer-core/a2a-negotiator.js

@@ -0,0 +1,152 @@
+/**
+ * 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 { buildA2AClient, buildCounterEnvelope, envelopeToMessage, extractKnpEnvelope, } from "./a2a-knp.js";
+const DEFAULT_TIMEOUT_MS = 15_000;
+const DEFAULT_DISCOUNT_RATE = 0.1;
+function utcNow() {
+    return new Date().toISOString();
+}
+/** 从 offer envelope JSON（provenance.reply_text）解析商家单价（minor/元）。 */
+function parseOfferPriceMinor(replyText) {
+    if (replyText === undefined || replyText === "")
+        return undefined;
+    try {
+        const envelope = JSON.parse(replyText);
+        const minor = envelope.payload?.terms?.items?.[0]?.unit_price?.amount_minor;
+        return typeof minor === "number" && Number.isFinite(minor) ? minor : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function intentQuantity(intent) {
+    const items = Array.isArray(intent.items) ? intent.items : [];
+    const qty = items[0]?.quantity;
+    if (typeof qty === "object" && qty !== null) {
+        const value = qty.value;
+        if (typeof value === "number" && value > 0)
+            return value;
+    }
+    return 1;
+}
+function targetPriceMinor(intent, current, discountRate) {
+    const constraints = intent.constraints;
+    if (typeof constraints === "object" && constraints !== null) {
+        // 契约：target_unit_price 是 money 对象 {currency, amount_minor}（commerce-intent/1.0）。
+        const raw = constraints.target_unit_price;
+        let value;
+        if (typeof raw === "object" && raw !== null) {
+            const minor = raw.amount_minor;
+            if (typeof minor === "number" && Number.isFinite(minor) && minor > 0)
+                value = minor;
+        }
+        else if (typeof raw === "number" && Number.isFinite(raw) && raw > 0) {
+            value = raw; // 宽松兼容：裸数字按 minor 处理
+        }
+        else if (typeof raw === "string" && Number.isFinite(Number(raw)) && Number(raw) > 0) {
+            value = Number(raw);
+        }
+        if (value !== undefined)
+            return value;
+    }
+    if (current !== undefined)
+        return Math.round(current * (1 - discountRate) * 100) / 100;
+    return undefined;
+}
+export class A2ANegotiator {
+    allowPrivateRanges;
+    skipDnsCheck;
+    timeoutMs;
+    bearerToken;
+    defaultDiscountRate;
+    fetchImpl;
+    constructor(options = {}) {
+        this.allowPrivateRanges = options.allowPrivateRanges ?? false;
+        this.skipDnsCheck = options.skipDnsCheck ?? false;
+        this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.bearerToken = options.bearerToken;
+        this.defaultDiscountRate = options.defaultDiscountRate ?? DEFAULT_DISCOUNT_RATE;
+        this.fetchImpl = options.fetchImpl ?? globalThis.fetch;
+    }
+    async negotiate(_taskId, intent, current, candidates) {
+        const candidate = candidates.find((c) => c.provenance?.a2a_endpoint !== undefined);
+        if (candidate === undefined) {
+            return { ...current, summary: `${current.summary}（无 A2A 会话上下文，无法真实还价）` };
+        }
+        const { negotiation_id, offer_id, merchant_reply_id, reply_text, sku, a2a_endpoint } = candidate.provenance ?? {};
+        if (a2a_endpoint === undefined ||
+            negotiation_id === undefined ||
+            offer_id === undefined ||
+            merchant_reply_id === undefined) {
+            return { ...current, summary: `${current.summary}（A2A 会话上下文不完整，无法真实还价）` };
+        }
+        const endpoint = String(a2a_endpoint);
+        const negotiationId = String(negotiation_id);
+        const offerId = String(offer_id);
+        const inReplyTo = String(merchant_reply_id);
+        const itemSku = typeof sku === "string" && sku !== "" ? sku : "item-1";
+        try {
+            const currentPrice = parseOfferPriceMinor(reply_text);
+            const target = targetPriceMinor(intent, currentPrice, this.defaultDiscountRate);
+            if (target === undefined) {
+                return { ...current, summary: `${current.summary}（无目标价可还：意图无 target_unit_price 且商家回复无单价）` };
+            }
+            const envelope = buildCounterEnvelope({
+                negotiationId,
+                inReplyTo,
+                respondingToOfferId: offerId,
+                sku: itemSku,
+                quantity: intentQuantity(intent),
+                counterPriceMinor: target,
+                now: utcNow,
+            });
+            const client = buildA2AClient(endpoint, {
+                bearerToken: this.bearerToken,
+                allowPrivateRanges: this.allowPrivateRanges,
+                skipDnsCheck: this.skipDnsCheck,
+                timeoutMs: this.timeoutMs,
+                fetchImpl: this.fetchImpl,
+            });
+            const task = await client.sendMessage(envelopeToMessage(envelope));
+            const reply = await this.waitForMerchantReply(client, task, envelope.message_id);
+            if (reply === null) {
+                return { ...current, summary: `${current.summary}（商家处理中，未回还价）` };
+            }
+            return { ...current, reply: JSON.stringify(reply) };
+        }
+        catch (error) {
+            return {
+                ...current,
+                summary: `${current.summary}（还价失败：${error instanceof Error ? error.message : String(error)}）`,
+            };
+        }
+    }
+    /** 轮询直到 merchant 回复 envelope 出现（排除自家 outbound 回声）或超时。 */
+    async waitForMerchantReply(client, initial, outboundMessageId) {
+        const deadline = Date.now() + this.timeoutMs;
+        let task = initial;
+        for (;;) {
+            const envelope = extractKnpEnvelope(task);
+            if (envelope !== null && envelope.message_id !== outboundMessageId)
+                return envelope;
+            if (Date.now() >= deadline)
+                return null;
+            await new Promise((resolve) => setTimeout(resolve, 1000));
+            task = await client.getTask(task.id);
+        }
+    }
+}
+//# sourceMappingURL=a2a-negotiator.js.map

package/dist/buyer-core/a2a-negotiator.js.map

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

package/dist/buyer-core/a2a-quote-fetcher.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 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 { QuoteCandidateInput, QuoteFetcher, MerchantRecord } from "./service.js";
+export interface A2AQuoteFetcherOptions {
+    /** 允许打到私网/保留网段（SSRF 逃生门；本地试点直连时开）。 */
+    allowPrivateRanges?: boolean;
+    /** 跳过 DNS 保留网段复查（测试/本机直连）。 */
+    skipDnsCheck?: boolean;
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    /** 出站 bearer（A2A 认证；服务器为 signature 时匿名放行可省）。 */
+    bearerToken?: string;
+    fetchImpl?: typeof fetch;
+}
+export declare class A2AQuoteFetcher implements QuoteFetcher {
+    private readonly allowPrivateRanges;
+    private readonly skipDnsCheck;
+    private readonly timeoutMs;
+    private readonly pollIntervalMs;
+    private readonly bearerToken?;
+    private readonly fetchImpl;
+    private readonly endpointCache;
+    constructor(options?: A2AQuoteFetcherOptions);
+    /** 对每个 Merchant 独立发起真实 RFQ 并收集回复（部分失败语义）。 */
+    requestQuotes(intent: Record<string, unknown>, merchants: MerchantRecord[]): Promise<QuoteCandidateInput[]>;
+    private requestQuote;
+    /** 解析 agent card JSONRPC 端点（按 card URL 缓存；拒绝非 http(s)）。 */
+    private resolveEndpoint;
+    /** 发送 RFQ 后轮询直到 merchant 回复 envelope（非 rfq action）或超时。 */
+    private waitForMerchantReply;
+}

package/dist/buyer-core/a2a-quote-fetcher.js

@@ -0,0 +1,178 @@
+/**
+ * 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 { newNegotiationId } from "../negotiation/domain/identifiers.js";
+import { buildA2AClient, buildRfqEnvelope, envelopeToMessage, extractKnpEnvelope, resolveA2aEndpoint, } from "./a2a-knp.js";
+const DEFAULT_POLL_MS = 2000;
+const DEFAULT_TIMEOUT_MS = 20_000;
+function utcNow() {
+    return new Date().toISOString();
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function firstItem(intent) {
+    const items = Array.isArray(intent.items) ? intent.items : [];
+    return items[0] ?? {};
+}
+function firstSku(intent) {
+    const first = firstItem(intent);
+    if (typeof first.sku === "string" && first.sku !== "")
+        return first.sku;
+    if (typeof first.query === "string" && first.query !== "")
+        return first.query;
+    return "item-1";
+}
+function firstQuantity(intent) {
+    const qty = firstItem(intent).quantity;
+    if (typeof qty === "object" && qty !== null) {
+        const value = qty.value;
+        const unit = qty.unit;
+        if (typeof value === "number" && value > 0) {
+            return { value, ...(typeof unit === "string" && unit !== "" ? { unit } : {}) };
+        }
+    }
+    return { value: 1 };
+}
+function constraintsDeadline(intent) {
+    const constraints = intent.constraints;
+    if (typeof constraints === "object" && constraints !== null) {
+        const deadline = constraints.deadline;
+        if (typeof deadline === "string" && deadline !== "")
+            return deadline;
+    }
+    return undefined;
+}
+export class A2AQuoteFetcher {
+    allowPrivateRanges;
+    skipDnsCheck;
+    timeoutMs;
+    pollIntervalMs;
+    bearerToken;
+    fetchImpl;
+    endpointCache = new Map();
+    constructor(options = {}) {
+        this.allowPrivateRanges = options.allowPrivateRanges ?? false;
+        this.skipDnsCheck = options.skipDnsCheck ?? false;
+        this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_MS;
+        this.bearerToken = options.bearerToken;
+        this.fetchImpl = options.fetchImpl ?? globalThis.fetch;
+    }
+    /** 对每个 Merchant 独立发起真实 RFQ 并收集回复（部分失败语义）。 */
+    async requestQuotes(intent, merchants) {
+        return Promise.all(merchants.map((merchant) => this.requestQuote(intent, merchant)));
+    }
+    async requestQuote(intent, merchant) {
+        const { merchant_id: merchantId, agent_card_url: agentCardUrl } = merchant;
+        if (agentCardUrl === undefined || agentCardUrl === "") {
+            return {
+                merchant_id: merchantId,
+                status: "failed",
+                failure: {
+                    classification: "unreachable",
+                    retryable: true,
+                    detail: "merchant has no agent card URL",
+                },
+            };
+        }
+        try {
+            const endpoint = await this.resolveEndpoint(agentCardUrl);
+            const sku = merchant.matching_skus?.[0] ?? firstSku(intent);
+            const negotiationId = newNegotiationId();
+            const envelope = buildRfqEnvelope({
+                negotiationId,
+                sku,
+                quantity: firstQuantity(intent),
+                deliveryBefore: constraintsDeadline(intent),
+                now: utcNow,
+            });
+            const client = buildA2AClient(endpoint, {
+                bearerToken: this.bearerToken,
+                allowPrivateRanges: this.allowPrivateRanges,
+                skipDnsCheck: this.skipDnsCheck,
+                timeoutMs: this.timeoutMs,
+                fetchImpl: this.fetchImpl,
+            });
+            const task = await client.sendMessage(envelopeToMessage(envelope));
+            const reply = await this.waitForMerchantReply(client, task);
+            if (reply === null) {
+                return {
+                    merchant_id: merchantId,
+                    status: "failed",
+                    failure: {
+                        classification: "timeout",
+                        retryable: true,
+                        detail: `no merchant reply within ${this.timeoutMs}ms`,
+                    },
+                };
+            }
+            const offerId = typeof reply.payload === "object" && reply.payload !== null
+                ? reply.payload.offer_id
+                : undefined;
+            return {
+                merchant_id: merchantId,
+                status: "succeeded",
+                provenance: {
+                    ...(typeof offerId === "string" && offerId !== "" ? { offer_id: offerId } : {}),
+                    negotiation_id: negotiationId,
+                    merchant_reply_id: reply.message_id,
+                    source: "a2a",
+                    reply_text: JSON.stringify(reply),
+                    sku,
+                    a2a_endpoint: endpoint,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                merchant_id: merchantId,
+                status: "failed",
+                failure: {
+                    classification: "protocol_error",
+                    retryable: true,
+                    detail: error instanceof Error ? error.message : String(error),
+                },
+            };
+        }
+    }
+    /** 解析 agent card JSONRPC 端点（按 card URL 缓存；拒绝非 http(s)）。 */
+    async resolveEndpoint(agentCardUrl) {
+        const cached = this.endpointCache.get(agentCardUrl);
+        if (cached !== undefined)
+            return cached;
+        const endpoint = await resolveA2aEndpoint(this.fetchImpl, agentCardUrl, this.timeoutMs);
+        this.endpointCache.set(agentCardUrl, endpoint);
+        return endpoint;
+    }
+    /** 发送 RFQ 后轮询直到 merchant 回复 envelope（非 rfq action）或超时。 */
+    async waitForMerchantReply(client, initial) {
+        const direct = extractKnpEnvelope(initial);
+        if (direct !== null && direct.action !== "rfq")
+            return direct;
+        const deadline = Date.now() + this.timeoutMs;
+        let task = initial;
+        for (;;) {
+            await sleep(this.pollIntervalMs);
+            task = await client.getTask(task.id);
+            const envelope = extractKnpEnvelope(task);
+            if (envelope !== null && envelope.action !== "rfq")
+                return envelope;
+            if (Date.now() >= deadline)
+                return null;
+        }
+    }
+}
+//# sourceMappingURL=a2a-quote-fetcher.js.map

package/dist/buyer-core/a2a-quote-fetcher.js.map

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

package/dist/buyer-core/build-service.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 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 { KiwiBuyerService } from "./service.js";
+export interface BuyerServiceConfig {
+    dbPath: string;
+    principal: string;
+    buyerAgentId: string;
+    sessionId: string;
+    policy: Record<string, unknown>;
+    catalogUrl?: string;
+    marketplaceUrl?: string;
+    buyerBootstrapToken?: string;
+    /** A2A 出站 bearer（服务器为 signature 认证时匿名放行可省）。 */
+    a2aBearerToken?: string;
+    /** A2A 允许打到私网/保留网段（SSRF 逃生门；本地试点直连时开）。 */
+    a2aAllowPrivateRanges?: boolean;
+    /** A2A 跳过 DNS 保留网段复查（测试/本机直连）。 */
+    a2aSkipDnsCheck?: boolean;
+    /** A2A 单请求超时 ms。 */
+    a2aTimeoutMs?: number;
+}
+/**
+ * 构建 Buyer Core：store + merchant index + quote fetcher + negotiator。
+ *
+ * 执行 seam 接线（战略 v2.5 Phase 2）：
+ * - marketplaceUrl 优先（试点向后兼容）→ MarketplaceMerchantIndex +
+ *   MarketplaceQuoteFetcher + MarketplaceNegotiator（shopping-cli 直连）。
+ * - 否则 catalogUrl → KiwiCatalogMerchantIndex（listings 感知发现）+ A2AQuoteFetcher
+ *   + A2ANegotiator（catalog 发现 → A2A 直连 merchant 磋商）。
+ */
+export declare function buildBuyerService(config: BuyerServiceConfig): KiwiBuyerService;

package/dist/buyer-core/build-service.js

@@ -0,0 +1,76 @@
+/**
+ * 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.
+ */
+/**
+ * 共享 Buyer Core 构建器（战略 v2.5 §6.3 单核心多包装）。
+ *
+ * MCP / HTTP / CLI / SDK 等包装都调用同一个 buildBuyerService：注入 merchant
+ * index、quote fetcher、negotiator 与持久 store，返回 KiwiBuyerService。
+ * 包装层只负责 manifest/tool description/路由，业务判断全部回到 buyer-core。
+ */
+import { assertNorthboundContractValid } from "../contracts/northbound-schema.js";
+import { A2ANegotiator } from "./a2a-negotiator.js";
+import { A2AQuoteFetcher } from "./a2a-quote-fetcher.js";
+import { KiwiCatalogMerchantIndex, MarketplaceMerchantIndex } from "./merchant-index.js";
+import { MarketplaceNegotiator } from "./negotiator.js";
+import { MarketplaceQuoteFetcher } from "./quote-fetcher.js";
+import { KiwiBuyerService } from "./service.js";
+import { TaskApprovalStore } from "./store.js";
+/**
+ * 构建 Buyer Core：store + merchant index + quote fetcher + negotiator。
+ *
+ * 执行 seam 接线（战略 v2.5 Phase 2）：
+ * - marketplaceUrl 优先（试点向后兼容）→ MarketplaceMerchantIndex +
+ *   MarketplaceQuoteFetcher + MarketplaceNegotiator（shopping-cli 直连）。
+ * - 否则 catalogUrl → KiwiCatalogMerchantIndex（listings 感知发现）+ A2AQuoteFetcher
+ *   + A2ANegotiator（catalog 发现 → A2A 直连 merchant 磋商）。
+ */
+export function buildBuyerService(config) {
+    assertNorthboundContractValid("delegation-policy", config.policy, "delegation policy");
+    const store = new TaskApprovalStore({ dbPath: config.dbPath });
+    let merchantIndex;
+    let quoteFetcher;
+    let negotiator;
+    if (config.marketplaceUrl !== undefined) {
+        merchantIndex = new MarketplaceMerchantIndex({ baseUrl: config.marketplaceUrl });
+        quoteFetcher = new MarketplaceQuoteFetcher({
+            baseUrl: config.marketplaceUrl,
+            buyerBootstrapToken: config.buyerBootstrapToken ?? "",
+        });
+        negotiator = new MarketplaceNegotiator({ baseUrl: config.marketplaceUrl });
+    }
+    else if (config.catalogUrl !== undefined) {
+        merchantIndex = new KiwiCatalogMerchantIndex({ baseUrl: config.catalogUrl });
+        const a2a = {
+            bearerToken: config.a2aBearerToken,
+            allowPrivateRanges: config.a2aAllowPrivateRanges,
+            skipDnsCheck: config.a2aSkipDnsCheck,
+            timeoutMs: config.a2aTimeoutMs,
+        };
+        quoteFetcher = new A2AQuoteFetcher(a2a);
+        negotiator = new A2ANegotiator(a2a);
+    }
+    return new KiwiBuyerService({
+        store,
+        principal: config.principal,
+        buyerAgentId: config.buyerAgentId,
+        sessionId: config.sessionId,
+        delegationPolicy: config.policy,
+        ...(merchantIndex !== undefined ? { merchantIndex } : {}),
+        ...(quoteFetcher !== undefined ? { quoteFetcher } : {}),
+        ...(negotiator !== undefined ? { negotiator } : {}),
+    });
+}
+//# sourceMappingURL=build-service.js.map

package/dist/buyer-core/build-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-service.js","sourceRoot":"","sources":["../../src/buyer-core/build-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;GAMG;AAEH,OAAO,EAAE,6BAA6B,EAAE,MAAM,mCAAmC,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACzF,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAqB/C;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAA0B;IAC1D,6BAA6B,CAAC,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACvF,MAAM,KAAK,GAAG,IAAI,iBAAiB,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/D,IAAI,aAAa,CAAC;IAClB,IAAI,YAAY,CAAC;IACjB,IAAI,UAAU,CAAC;IACf,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACxC,aAAa,GAAG,IAAI,wBAAwB,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;QACjF,YAAY,GAAG,IAAI,uBAAuB,CAAC;YACzC,OAAO,EAAE,MAAM,CAAC,cAAc;YAC9B,mBAAmB,EAAE,MAAM,CAAC,mBAAmB,IAAI,EAAE;SACtD,CAAC,CAAC;QACH,UAAU,GAAG,IAAI,qBAAqB,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;IAC7E,CAAC;SAAM,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAC3C,aAAa,GAAG,IAAI,wBAAwB,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QAC7E,MAAM,GAAG,GAAG;YACV,WAAW,EAAE,MAAM,CAAC,cAAc;YAClC,kBAAkB,EAAE,MAAM,CAAC,qBAAqB;YAChD,YAAY,EAAE,MAAM,CAAC,eAAe;YACpC,SAAS,EAAE,MAAM,CAAC,YAAY;SAC/B,CAAC;QACF,YAAY,GAAG,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC;QACxC,UAAU,GAAG,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,IAAI,gBAAgB,CAAC;QAC1B,KAAK;QACL,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,gBAAgB,EAAE,MAAM,CAAC,MAAM;QAC/B,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpD,CAAC,CAAC;AACL,CAAC"}

package/dist/buyer-core/errors.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 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 类型化错误（fail-closed，同仓库 `*Error` + code 约定）。
+ * 错误码在跨宿主 Compatibility Matrix（§6.10）里作为语义不变量被验收。
+ */
+export type McpErrorCode = "invalid_request" | "invalid_params" | "method_not_found" | "not_initialized" | "tool_not_found" | "contract_violation" | "idempotency_conflict" | "delegation_denied" | "authorization_denied" | "approval_required" | "approval_denied" | "task_not_found" | "task_expired" | "agreement_not_found" | "store_corrupted" | "internal_error";
+export declare class McpError extends Error {
+    readonly code: McpErrorCode;
+    readonly detail?: unknown;
+    constructor(code: McpErrorCode, message: string, detail?: unknown);
+    /** 映射为 JSON-RPC 错误负载（§6.10 错误分类语义）。 */
+    toJsonRpc(): {
+        code: number;
+        message: string;
+        data: unknown;
+    };
+}

package/dist/buyer-core/errors.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.
+ */
+const CODE_TO_JSON_RPC = {
+    invalid_request: -32600,
+    invalid_params: -32602,
+    method_not_found: -32601,
+    not_initialized: -32002,
+    tool_not_found: -32002,
+    contract_violation: -32602,
+    idempotency_conflict: -32602,
+    delegation_denied: -32000,
+    authorization_denied: -32000,
+    approval_required: -32000,
+    approval_denied: -32000,
+    task_not_found: -32602,
+    task_expired: -32000,
+    agreement_not_found: -32602,
+    store_corrupted: -32603,
+    internal_error: -32603,
+};
+export class McpError extends Error {
+    code;
+    detail;
+    constructor(code, message, detail) {
+        super(message);
+        this.name = "McpError";
+        this.code = code;
+        this.detail = detail;
+    }
+    /** 映射为 JSON-RPC 错误负载（§6.10 错误分类语义）。 */
+    toJsonRpc() {
+        return {
+            code: CODE_TO_JSON_RPC[this.code],
+            message: `${this.code}: ${this.message}`,
+            data: this.detail,
+        };
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/buyer-core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/buyer-core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAyBH,MAAM,gBAAgB,GAAiC;IACrD,eAAe,EAAE,CAAC,KAAK;IACvB,cAAc,EAAE,CAAC,KAAK;IACtB,gBAAgB,EAAE,CAAC,KAAK;IACxB,eAAe,EAAE,CAAC,KAAK;IACvB,cAAc,EAAE,CAAC,KAAK;IACtB,kBAAkB,EAAE,CAAC,KAAK;IAC1B,oBAAoB,EAAE,CAAC,KAAK;IAC5B,iBAAiB,EAAE,CAAC,KAAK;IACzB,oBAAoB,EAAE,CAAC,KAAK;IAC5B,iBAAiB,EAAE,CAAC,KAAK;IACzB,eAAe,EAAE,CAAC,KAAK;IACvB,cAAc,EAAE,CAAC,KAAK;IACtB,YAAY,EAAE,CAAC,KAAK;IACpB,mBAAmB,EAAE,CAAC,KAAK;IAC3B,eAAe,EAAE,CAAC,KAAK;IACvB,cAAc,EAAE,CAAC,KAAK;CACvB,CAAC;AAEF,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAe;IACnB,MAAM,CAAW;IAE1B,YAAY,IAAkB,EAAE,OAAe,EAAE,MAAgB;QAC/D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,uCAAuC;IACvC,SAAS;QACP,OAAO;YACL,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;YACjC,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE;YACxC,IAAI,EAAE,IAAI,CAAC,MAAM;SAClB,CAAC;IACJ,CAAC;CACF"}