@harrylabsj/kiwi 0.7.8 → 0.7.10

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"}

package/dist/buyer-core/merchant-index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 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 { MerchantRecord } from "./service.js";
+export interface KiwiCatalogMerchantIndexOptions {
+    baseUrl: string;
+    authToken?: string;
+    timeoutMs?: number;
+    fetchImpl?: typeof fetch;
+}
+export declare class KiwiCatalogMerchantIndex {
+    private readonly source;
+    constructor(options: KiwiCatalogMerchantIndexOptions);
+    search(query: string, opts?: {
+        category?: string;
+        region?: string;
+    }): Promise<MerchantRecord[]>;
+}
+export interface MarketplaceMerchantIndexOptions {
+    baseUrl: string;
+    timeoutMs?: number;
+    fetchImpl?: typeof fetch;
+}
+/**
+ * MarketplaceMerchantIndex —— 基于 marketplace 真实商品 FTS 的 MerchantIndex。
+ *
+ * 商品查询 → /search/products 找"能供应该商品的商家"（真实商品/库存事实），
+ * 去重返回可路由 MerchantRecord。这解决 kiwi_search 对"谁有货"的意图（§3.2：
+ * 需要真实商品信息时访问 Merchant 的权威 endpoint；本索引用 marketplace 的
+ * 真实商品数据做路由，不拥有/不编造商品 truth）。
+ */
+export declare class MarketplaceMerchantIndex {
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    private readonly fetchImpl;
+    constructor(options: MarketplaceMerchantIndexOptions);
+    search(query: string, _opts?: {
+        category?: string;
+        region?: string;
+    }): Promise<MerchantRecord[]>;
+}

package/dist/buyer-core/merchant-index.js

@@ -0,0 +1,138 @@
+/**
+ * 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.
+ */
+/**
+ * KiwiCatalogMerchantIndex —— kiwi-catalog 驱动的 MerchantIndex（战略 v2.5 §3.2）。
+ *
+ * kiwi-catalog 收缩为 Merchant Discovery & Routing Index：保存 Merchant
+ * Identity、Verification、Freshness、Category/Region、RFQ/KNP 支持、UCP Profile
+ * URL 与 A2A Agent Card。真实商品信息由 Buyer 访问 Merchant 的 UCP Catalog /
+ * 声明的权威 endpoint，kiwi-catalog 不是商品 truth source。
+ *
+ * 本实现包装现有 KiwiCatalogSource（/v1/agents）；search 失败（catalog 不可达）
+ * 时由上层 service 降级为可解释 note，不编造商家。
+ */
+import { KiwiCatalogSource } from "../discovery/catalog-source/kiwi-source.js";
+const VERIFIED_LEVELS = new Set(["domain_verified", "agent_verified", "commerce_verified"]);
+export class KiwiCatalogMerchantIndex {
+    source;
+    constructor(options) {
+        const deps = {
+            baseUrl: options.baseUrl,
+            ...(options.authToken !== undefined ? { authToken: options.authToken } : {}),
+            ...(options.timeoutMs !== undefined ? { timeoutMs: options.timeoutMs } : {}),
+            ...(options.fetchImpl !== undefined ? { fetchImpl: options.fetchImpl } : {}),
+        };
+        this.source = new KiwiCatalogSource(deps);
+    }
+    async search(query, opts) {
+        const records = await this.source.searchRecords({ q: query });
+        const merchants = records
+            .filter((r) => r.principal_type === "merchant")
+            .filter((r) => r.merchant_id !== undefined)
+            .filter((r) => {
+            if (opts?.category !== undefined && !r.display_name.toLowerCase().includes(opts.category.toLowerCase())) {
+                return false;
+            }
+            if (opts?.region !== undefined && !r.display_name.toLowerCase().includes(opts.region.toLowerCase())) {
+                return false;
+            }
+            return true;
+        })
+            .map((r) => mapRecord(r));
+        return merchants;
+    }
+}
+function mapRecord(record) {
+    return {
+        merchant_id: record.merchant_id ?? record.catalog_agent_id,
+        name: record.display_name,
+        verified: record.verification_level !== undefined
+            ? VERIFIED_LEVELS.has(record.verification_level)
+            : false,
+        category: record.capabilities?.some((c) => c.includes("catalog")) ? "catalog" : undefined,
+        region: undefined,
+        ucp_profile_url: record.ucp_profile_url,
+        agent_card_url: record.agent_card_url,
+        capabilities: record.capabilities ? [...record.capabilities] : [],
+    };
+}
+/**
+ * MarketplaceMerchantIndex —— 基于 marketplace 真实商品 FTS 的 MerchantIndex。
+ *
+ * 商品查询 → /search/products 找"能供应该商品的商家"（真实商品/库存事实），
+ * 去重返回可路由 MerchantRecord。这解决 kiwi_search 对"谁有货"的意图（§3.2：
+ * 需要真实商品信息时访问 Merchant 的权威 endpoint；本索引用 marketplace 的
+ * 真实商品数据做路由，不拥有/不编造商品 truth）。
+ */
+export class MarketplaceMerchantIndex {
+    baseUrl;
+    timeoutMs;
+    fetchImpl;
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/+$/, "");
+        this.timeoutMs = options.timeoutMs ?? 5000;
+        this.fetchImpl = options.fetchImpl ?? globalThis.fetch;
+    }
+    async search(query, _opts) {
+        const url = `${this.baseUrl}/search/products?query=${encodeURIComponent(query)}`;
+        const res = await this.fetchImpl(url, {
+            headers: { accept: "application/json" },
+            signal: AbortSignal.timeout(this.timeoutMs),
+        });
+        if (!res.ok)
+            throw new Error(`marketplace /search/products ${res.status}`);
+        const data = (await res.json());
+        const rows = data.results ?? [];
+        const terms = cjkTerms(query);
+        const seen = new Map();
+        for (const row of rows) {
+            const merchantId = row.merchant_id;
+            if (merchantId === undefined || merchantId === "")
+                continue;
+            const title = row.title ?? "";
+            // 相关度：标题命中的查询中文词数（≥2 字词）。FTS 对中文噪声大，
+            // 只保留标题含查询关键词的商品，避免把"长尾夹"当"扩展坞"的匹配。
+            const relevance = terms.reduce((n, term) => (title.includes(term) ? n + 1 : n), 0);
+            if (relevance === 0 || row.sku === undefined || row.sku === "")
+                continue;
+            const entry = seen.get(merchantId);
+            if (entry === undefined) {
+                seen.set(merchantId, {
+                    record: {
+                        merchant_id: merchantId,
+                        name: row.merchant_name ?? merchantId,
+                        verified: true,
+                        category: row.category,
+                        region: undefined,
+                        capabilities: ["com.harrylabsj.kiwi.shopping.negotiation"],
+                    },
+                    skus: new Map(),
+                });
+            }
+            seen.get(merchantId)?.skus.set(row.sku, Math.max(relevance, seen.get(merchantId)?.skus.get(row.sku) ?? 0));
+        }
+        return [...seen.values()].map(({ record, skus }) => ({
+            ...record,
+            matching_skus: skus.size > 0 ? [...skus.entries()].sort((a, b) => b[1] - a[1]).map(([sku]) => sku) : undefined,
+        }));
+    }
+}
+/** 提取查询里的中文词（连续 CJK 长度≥2），用于标题相关度过滤。 */
+function cjkTerms(query) {
+    const matches = query.match(/[一-鿿]{2,}/g);
+    return matches ?? [];
+}
+//# sourceMappingURL=merchant-index.js.map

package/dist/buyer-core/merchant-index.js.map

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

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

@@ -0,0 +1,51 @@
+/**
+ * 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.
+ */
+/**
+ * MarketplaceNegotiator —— 真实磋商（CounterOffer）经 shopping-cli marketplace。
+ *
+ * 复用电报会话：买家 claim 商家最新回复 → 提交 counter 决策（结构化 proposal，
+ * 目标价来自 intent constraints 或当前报价折扣）→ complete claim → 轮询商家
+ * （kiwi merchant runtime）对还价的回复。所有回复为真实商家文本，不编造。
+ *
+ * 前置：报价阶段（MarketplaceQuoteFetcher）把 conversation 的 buyer_token 存入
+ * candidate provenance；本实现从 task candidates 读取磋商上下文。
+ */
+import type { NegotiationStep, Negotiator } from "./service.js";
+export interface MarketplaceNegotiatorOptions {
+    baseUrl: string;
+    pollIntervalMs?: number;
+    timeoutMs?: number;
+    fetchImpl?: typeof fetch;
+    /** 还价目标单价（minor/元）；缺省从意图 constraints.target_unit_price 或
+     *  商家当前报价折扣（10%）推导。 */
+    defaultDiscountRate?: number;
+}
+export declare class MarketplaceNegotiator implements Negotiator {
+    private readonly baseUrl;
+    private readonly pollIntervalMs;
+    private readonly timeoutMs;
+    private readonly defaultDiscountRate;
+    private readonly fetchImpl;
+    constructor(options: MarketplaceNegotiatorOptions);
+    negotiate(_taskId: string, intent: Record<string, unknown>, current: NegotiationStep, candidates: Array<Record<string, unknown>>): Promise<NegotiationStep>;
+    /** 目标单价：intent.constraints.target_unit_price → 当前报价×(1-discount)。 */
+    private targetPrice;
+    private claimMessage;
+    private submitCounter;
+    private completeClaim;
+    /** 轮询会话直到出现 merchant 对还价的新回复（晚于被还价消息）或超时。 */
+    private pollMerchantReply;
+}

package/dist/buyer-core/negotiator.js

@@ -0,0 +1,181 @@
+/**
+ * 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 DEFAULT_POLL_MS = 1500;
+const DEFAULT_TIMEOUT_MS = 15_000;
+export class MarketplaceNegotiator {
+    baseUrl;
+    pollIntervalMs;
+    timeoutMs;
+    defaultDiscountRate;
+    fetchImpl;
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/+$/, "");
+        this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_MS;
+        this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.defaultDiscountRate = options.defaultDiscountRate ?? 0.1;
+        this.fetchImpl = options.fetchImpl ?? globalThis.fetch;
+    }
+    async negotiate(_taskId, intent, current, candidates) {
+        const candidate = candidates.find((c) => c.provenance?.negotiation_id !== undefined);
+        if (candidate === undefined) {
+            return { ...current, summary: `${current.summary}（无会话上下文，无法真实还价）` };
+        }
+        const { negotiation_id: convId, merchant_reply_id, buyer_token, sku } = candidate.provenance ?? {};
+        if (convId === undefined || buyer_token === undefined || merchant_reply_id === undefined) {
+            return { ...current, summary: `${current.summary}（会话上下文不完整，无法真实还价）` };
+        }
+        const messageId = Number(merchant_reply_id);
+        if (!Number.isInteger(messageId)) {
+            return { ...current, summary: `${current.summary}（商家回复引用无效）` };
+        }
+        try {
+            const targetPrice = this.targetPrice(intent, candidate.provenance?.reply_text);
+            const stockQty = parseStock(candidate.provenance?.reply_text);
+            const claim = await this.claimMessage(buyer_token, convId, messageId);
+            if (claim !== true) {
+                return { ...current, summary: `${current.summary}（商家消息 ${messageId} 不可 claim）` };
+            }
+            const decisionOk = await this.submitCounter(buyer_token, convId, messageId, targetPrice, current.summary, sku, stockQty);
+            if (decisionOk !== true) {
+                return { ...current, summary: `${current.summary}（还价决策被拒）` };
+            }
+            await this.completeClaim(buyer_token, messageId);
+            const reply = await this.pollMerchantReply(buyer_token, convId, messageId);
+            if (reply !== undefined) {
+                return { ...current, reply };
+            }
+            return { ...current, summary: `${current.summary}（商家处理中，未回还价）` };
+        }
+        catch (error) {
+            return {
+                ...current,
+                summary: `${current.summary}（还价失败：${error instanceof Error ? error.message : String(error)}）`,
+            };
+        }
+    }
+    /** 目标单价：intent.constraints.target_unit_price → 当前报价×(1-discount)。 */
+    targetPrice(intent, replyText) {
+        const constraints = (intent.constraints ?? {});
+        const explicit = constraints.target_unit_price;
+        if (typeof explicit === "number" && explicit > 0)
+            return explicit;
+        if (typeof explicit === "string" && Number(explicit) > 0)
+            return Number(explicit);
+        const current = parseCurrentPrice(replyText);
+        if (current !== undefined)
+            return Number((current * (1 - this.defaultDiscountRate)).toFixed(2));
+        return 0;
+    }
+    async claimMessage(buyerToken, convId, messageId) {
+        const res = await this.fetchImpl(`${this.baseUrl}/negotiation/claims`, {
+            method: "POST",
+            headers: { authorization: `Bearer ${buyerToken}`, "content-type": "application/json" },
+            body: JSON.stringify({ conversation_id: convId, message_id: messageId, idempotency_key: `nc-${messageId}-${Date.now()}` }),
+            signal: AbortSignal.timeout(8000),
+        });
+        if (!res.ok)
+            return false;
+        const data = (await res.json());
+        return data.claim?.claimed === true;
+    }
+    async submitCounter(buyerToken, convId, messageId, targetPrice, summary, sku, stockQty) {
+        const now = new Date().toISOString();
+        const proposal = {
+            sku: sku ?? "pilot-sku",
+            quantity: 10,
+            unit_price: targetPrice,
+            currency: "CNY",
+            // 库存快照须与服务端最新一致（stale_inventory 拒绝），从商家回复解析。
+            stock: { status: "available", quantity: stockQty, observed_at: now, reserved: false },
+            delivery: { eta_start: now, eta_end: now, fee: 0 },
+            after_sales_policy_refs: [],
+            valid_until: "2099-12-31T23:59:59Z",
+        };
+        const res = await this.fetchImpl(`${this.baseUrl}/negotiation/decisions`, {
+            method: "POST",
+            headers: { authorization: `Bearer ${buyerToken}`, "content-type": "application/json" },
+            body: JSON.stringify({
+                idempotency_key: `nd-${messageId}-${Date.now()}`,
+                decision: {
+                    protocol_version: "shopping.negotiation/0.1",
+                    conversation_id: convId,
+                    in_reply_to_message_id: messageId,
+                    action: "counter",
+                    open_issues: [],
+                    public_message: summary,
+                    reason_codes: ["price"],
+                    request_human_review: false,
+                    proposal,
+                },
+            }),
+            signal: AbortSignal.timeout(8000),
+        });
+        if (!res.ok)
+            return false;
+        const data = (await res.json());
+        return data.policy_result?.result === "accepted";
+    }
+    async completeClaim(buyerToken, messageId) {
+        await this.fetchImpl(`${this.baseUrl}/negotiation/claims/complete`, {
+            method: "POST",
+            headers: { authorization: `Bearer ${buyerToken}`, "content-type": "application/json" },
+            body: JSON.stringify({ message_id: messageId, idempotency_key: `nc-${messageId}-${Date.now()}` }),
+            signal: AbortSignal.timeout(8000),
+        });
+    }
+    /** 轮询会话直到出现 merchant 对还价的新回复（晚于被还价消息）或超时。 */
+    async pollMerchantReply(buyerToken, convId, counterMessageId) {
+        const deadline = Date.now() + this.timeoutMs;
+        for (;;) {
+            const res = await this.fetchImpl(`${this.baseUrl}/conversations/${convId}`, {
+                headers: { authorization: `Bearer ${buyerToken}` },
+                signal: AbortSignal.timeout(8000),
+            });
+            if (res.ok) {
+                const data = (await res.json());
+                const reply = [...(data.conversation?.messages ?? [])]
+                    .reverse()
+                    .find((m) => m.sender === "merchant_agent" && (m.id ?? 0) > counterMessageId);
+                if (reply !== undefined && reply.text !== undefined)
+                    return reply.text;
+            }
+            if (Date.now() >= deadline)
+                return undefined;
+            await new Promise((resolve) => setTimeout(resolve, this.pollIntervalMs));
+        }
+    }
+}
+/** 从回复文本解析当前单价（如 "current price 189.00 CNY" / "单价 189"）。 */
+function parseCurrentPrice(text) {
+    if (text === undefined)
+        return undefined;
+    const match = text.match(/current price ([\d.]+) CNY/i) ?? text.match(/单价 ([\d.]+)/);
+    if (match === null)
+        return undefined;
+    const value = Number(match[1]);
+    return Number.isFinite(value) ? value : undefined;
+}
+/** 从回复文本解析库存（如 "stock 180" / "库存 180"），供 proposal 快照对齐。 */
+function parseStock(text) {
+    if (text === undefined)
+        return 0;
+    const match = text.match(/\b(?:stock|库存)\s+(\d+)/i);
+    if (match === null)
+        return 0;
+    const value = Number(match[1]);
+    return Number.isFinite(value) ? value : 0;
+}
+//# sourceMappingURL=negotiator.js.map

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

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

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

@@ -0,0 +1,46 @@
+/**
+ * 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 MarketplaceQuoteFetcherOptions {
+    /** shopping-cli marketplace 根 URL（如 http://127.0.0.1:8765）。 */
+    baseUrl: string;
+    /** buyer bootstrap token（SHOPPING_BUYER_BOOTSTRAP_TOKEN）。 */
+    buyerBootstrapToken: string;
+    pollIntervalMs?: number;
+    timeoutMs?: number;
+    fetchImpl?: typeof fetch;
+}
+export declare class MarketplaceQuoteFetcher implements QuoteFetcher {
+    private readonly baseUrl;
+    private readonly buyerBootstrapToken;
+    private readonly pollIntervalMs;
+    private readonly timeoutMs;
+    private readonly fetchImpl;
+    constructor(options: MarketplaceQuoteFetcherOptions);
+    /** 对每个 Merchant 独立发起真实 RFQ 并收集回复（部分失败语义）。 */
+    requestQuotes(intent: Record<string, unknown>, merchants: MerchantRecord[]): Promise<QuoteCandidateInput[]>;
+    private requestQuote;
+    /**
+     * 从 CommerceIntent 提取 sku 与 RFQ 文本（真实商品语义，不做虚构）。
+     * 商家有 matching_skus（marketplace 商品 FTS 路由）时优先用商家自有 SKU——
+     * 否则商家 agent 无法按文本匹配到自己的商品（SKU 是会话匹配键）。
+     */
+    private buildRfq;
+    private createConversation;
+    /** 轮询会话直到 merchant_agent 回复出现或超时。 */
+    private pollMerchantReply;
+    private readConversation;
+}