@harrylabsj/kiwi 0.6.0

package/dist/agent/chat-tui.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 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 { Readable, Writable } from "node:stream";
+import type { AgentKernel } from "./kernel.js";
+/** A2A 节点状态（供 `/a2a` 显示）。 */
+export interface ChatA2aNodeStatus {
+    role: string;
+    url: string;
+    agentCardUrl: string;
+    catalogAgentId?: string;
+}
+/** A2A 节点生命周期管理（由 cli 层持有；`/profile` 换角色时 rebuild）。 */
+export interface ChatA2aNode {
+    status(): ChatA2aNodeStatus | null;
+    rebuild(profile: {
+        role: string;
+        agent_id: string;
+    }): Promise<void>;
+    stop(): Promise<void>;
+}
+export interface ChatTuiOptions {
+    kernel: AgentKernel;
+    input: Readable;
+    output: Writable;
+    /**
+     * `/profile <file>` 时调用：加载 profile 并构建新 kernel（调用方负责
+     * AgentKernel.open 与 close 语义）。失败时抛错，TUI 保留当前 kernel。
+     */
+    reload?: (profileFile: string) => Promise<AgentKernel>;
+    /** A2A 节点（自动启动，随 `/profile` 角色切换重建）。 */
+    a2aNode?: ChatA2aNode;
+    /** agent catalog base URL（`/discover`、`/negotiate` 用）。 */
+    catalog?: string;
+}
+/** Run the main chat loop. Resolves EXIT.OK on /quit or EOF. */
+export declare function runChatTui(options: ChatTuiOptions): Promise<number>;

package/dist/agent/chat-tui.js

@@ -0,0 +1,314 @@
+/**
+ * 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.
+ */
+/**
+ * Main-conversation TUI (design §4, §6.4): plain node:readline over
+ * injected streams — no TTY requirement, tests drive it in-memory.
+ * Free text goes to the model via the kernel; slash commands are the
+ * deterministic control shortcuts.
+ *
+ * `/profile <file>`（TUI 层拦截）：加载并切换到另一个 agent profile 的
+ * kernel（如 buyer/merchant），供裸 `kiwi` 启动后自由换身份。
+ */
+import readline from "node:readline";
+import { EXIT } from "../exit-codes.js";
+import { ShoppingCliCatalogSource } from "../discovery/catalog-source/index.js";
+import { negotiateWithAgent, summarizeNegotiation } from "../a2a/negotiate.js";
+import { createTheme } from "../tui/styles.js";
+import { PRODUCT_VERSION } from "../product-cli.js";
+function roleLabelOf(role) {
+    return role === "buyer" ? "Buyer" : "Merchant";
+}
+/** Run the main chat loop. Resolves EXIT.OK on /quit or EOF. */
+export async function runChatTui(options) {
+    const { input, output, reload, a2aNode, catalog } = options;
+    // Neural Awakening 主题（参照 hermes）：非 TTY 时所有样式直通原文——
+    // 既有内存流测试断言字节级不变。
+    const theme = createTheme(output);
+    const write = (text) => {
+        output.write(`${theme.decorate(text)}\n`);
+    };
+    // 可变 kernel 引用：`/profile` 切换时更新，定时器与循环自动跟随。
+    let current = { kernel: options.kernel };
+    // 欢迎界面（hermes build_welcome_banner 结构）：大号渐变 logo + 带版本
+    // 标题的信息面板；非 TTY 下 theme.welcome 返回现状单行（字节不变）。
+    const renderWelcome = () => {
+        const mode = current.kernel.getMode();
+        write(theme.welcome({
+            roleLabel: roleLabelOf(current.kernel.profile.role),
+            id: current.kernel.principal.principal_id,
+            tagline: "主对话（/help 查看命令，/quit 退出）",
+            versionLabel: `kiwi ${PRODUCT_VERSION}`,
+            commerceUrl: current.kernel.profile.commerce.base_url,
+            modelLabel: `${current.kernel.profile.model.provider}/${current.kernel.profile.model.model}`,
+            modeLabel: mode === "autopilot" ? "Autopilot" : mode === "manual" ? "Manual" : "Supervised",
+            a2aOn: a2aNode?.status() !== undefined && a2aNode?.status() !== null,
+            catalog,
+            commands: "/help /profile /handoff /discover /negotiate /a2a /quit",
+        }));
+    };
+    renderWelcome();
+    // Restart recovery: wakeups derive from the database, so an immediate tick
+    // rebuilds the queue; a slow unref'd timer keeps tracking tasks alive.
+    // 失败的 tick 必须可见：搜索/观察错误写进聊天（按内容去重，干净一轮后重置），
+    // 否则"任务在 tracking 但一直失败"会表现为无声卡住。
+    const surfacedErrors = new Set();
+    const tickAndNotify = async () => {
+        const result = await current.kernel.schedulerTick().catch(() => undefined);
+        if (result === undefined)
+            return;
+        for (const n of result.notifications) {
+            write(`[通知] ${n.summary}（任务 ${n.task_id}）`);
+        }
+        if (result.errors.length === 0) {
+            surfacedErrors.clear();
+            return;
+        }
+        for (const e of result.errors) {
+            if (surfacedErrors.has(e))
+                continue;
+            surfacedErrors.add(e);
+            write(`[任务] ${e}`);
+        }
+    };
+    await tickAndNotify();
+    const timer = setInterval(() => {
+        void tickAndNotify();
+    }, 60_000);
+    timer.unref();
+    // Autonomous negotiation (autopilot): poll for pending negotiation messages
+    // and drive one model turn per tick. No-op outside autopilot.
+    const negotiate = async () => {
+        const text = await current.kernel.negotiationAutoTick().catch(() => undefined);
+        if (text !== undefined && text !== "")
+            write(`[磋商] ${text}`);
+    };
+    await negotiate();
+    const negotiateTimer = setInterval(() => {
+        void negotiate();
+    }, 15_000);
+    negotiateTimer.unref();
+    try {
+        const rl = readline.createInterface({
+            input,
+            output,
+            terminal: input.isTTY === true,
+            // 彩色 prompt（青色；Node 22 readline 对 ANSI prompt 的宽度计算已验证）
+            prompt: theme.enabled ? theme.paint("kiwi> ", "accent") : "kiwi> ",
+        });
+        // EOF (Ctrl-D, or an injected stream that ends) closes the interface while
+        // the last line is still being handled; prompting a closed readline throws.
+        let rlClosed = false;
+        rl.once("close", () => {
+            rlClosed = true;
+        });
+        // 状态栏 + prompt 重绘（TTY-only）：状态栏写在输入行上方，readline 的
+        // 重绘只碰自己的行，正在输入的缓冲由 readline 完整重画不丢字。
+        // 非 TTY 下 statusBar 返回空串 → 等价旧 rl.prompt()（零额外字节）。
+        const refreshPrompt = () => {
+            if (rlClosed)
+                return;
+            if (theme.enabled) {
+                output.write("\r\u001b[K");
+                const mode = current.kernel.getMode();
+                const modeColor = mode === "autopilot" ? "accent" : mode === "supervised" ? "primary" : "warn";
+                const segments = [
+                    { text: `Kiwi ${roleLabelOf(current.kernel.profile.role)}`, color: "primary", bold: true },
+                    current.kernel.principal.principal_id,
+                    { text: mode === "autopilot" ? "Autopilot" : mode === "manual" ? "Manual" : "Supervised", color: modeColor },
+                    a2aNode?.status() !== undefined && a2aNode?.status() !== null
+                        ? { text: "A2A on", color: "ok" }
+                        : { text: "A2A off", color: "muted", dim: true },
+                    catalog !== undefined ? `catalog ${catalog}` : "catalog —",
+                ];
+                output.write(`${theme.statusBar(segments)}\n`);
+            }
+            rl.prompt();
+        };
+        refreshPrompt();
+        for await (const rawLine of rl) {
+            const line = String(rawLine).trim();
+            if (line !== "") {
+                if (line.startsWith("/profile")) {
+                    const file = line.slice("/profile".length).trim();
+                    if (file === "" || reload === undefined) {
+                        write("用法：/profile <profile.yaml>（无参数或未配置 reload 时不可用）");
+                    }
+                    else {
+                        try {
+                            const next = await reload(file);
+                            if (next !== current.kernel) {
+                                await current.kernel.close().catch(() => undefined);
+                                current = { kernel: next };
+                                // 换角色：同步重建 A2A 节点（merchant 自动重新注册 catalog）。
+                                if (a2aNode !== undefined) {
+                                    await a2aNode.rebuild(current.kernel.profile).catch((err) => {
+                                        write(`A2A 节点重建失败（对话继续）：${err instanceof Error ? err.message : String(err)}`);
+                                    });
+                                }
+                                renderWelcome();
+                            }
+                        }
+                        catch (err) {
+                            write(`加载 profile 失败，保留当前 agent：${err instanceof Error ? err.message : String(err)}`);
+                        }
+                    }
+                }
+                else if (line === "/a2a") {
+                    const status = a2aNode?.status();
+                    if (status === undefined || status === null) {
+                        write("A2A 节点未启动。");
+                    }
+                    else {
+                        write(`[a2a] ${status.role}@${status.url}${status.catalogAgentId !== undefined ? ` registered ${status.catalogAgentId}` : ""}（card: ${status.agentCardUrl}）`);
+                    }
+                }
+                else if (line.startsWith("/discover")) {
+                    if (catalog === undefined) {
+                        write("未配置 agent catalog（KIWI_CATALOG_URL 或 --catalog）。");
+                    }
+                    else {
+                        try {
+                            const source = new ShoppingCliCatalogSource({ baseUrl: catalog });
+                            const candidates = await source.searchCandidates();
+                            if (candidates.length === 0) {
+                                write("[discover] catalog 里没有可发现的 agent。");
+                            }
+                            else {
+                                // panel 化：行内容与现状逐字节一致，TTY 下 box 包裹
+                                const lines = candidates.map((c) => {
+                                    const card = c.discovery?.agent_card_url ?? c.merchant?.domain ?? "?";
+                                    return `[discover] ${c.catalog_agent_id}  status=${c.verification?.status ?? "?"}  ${card}`;
+                                });
+                                write(theme.panel(lines));
+                            }
+                        }
+                        catch (err) {
+                            write(`[discover] 失败：${err instanceof Error ? err.message : String(err)}`);
+                        }
+                    }
+                }
+                else if (line === "/handoff" || line.startsWith("/handoff ")) {
+                    // 惰性过期清扫（评审项 L1）：到期未执行的候选先落 expired 事件，
+                    // 列表不再显示"从未获批/从未执行"的过期候选。
+                    current.kernel.sweepHandoffCandidates();
+                    const summary = current.kernel.handoffSummary;
+                    if (summary.enabled === false) {
+                        write("[handoff] 当前 kernel 未启用 Handoff（buyer 角色）。");
+                    }
+                    else {
+                        // panel 化：TTY 下 box 包裹；非 TTY 下 join 输出与现状逐字节一致
+                        // （保留候选/交付行的前导空格）。
+                        const lines = [
+                            `[handoff] 候选 ${summary.candidates.length} 个 / 交付 ${summary.handoffs.length} 个`,
+                            ...summary.candidates.flatMap((c) => [
+                                `  candidate ${c.candidate_id}  ${c.lifecycle}  ${c.destination_type} ${c.destination_ref}`,
+                                `    ${c.display_summary.merchant} — ${c.display_summary.summary}（negotiation ${c.negotiation_id}）`,
+                            ]),
+                            ...summary.handoffs.map((h) => `  handoff ${h.handoff_id}  delivery=${h.delivery}`),
+                        ];
+                        write(theme.panel(lines));
+                    }
+                }
+                else if (line.startsWith("/handoff-open ")) {
+                    const rest = line.slice("/handoff-open ".length).trim();
+                    const parts = rest.split(/\s+/);
+                    const handoffId = parts[0] ?? "";
+                    const negotiationId = parts[1] ?? "";
+                    if (handoffId === "") {
+                        write("用法：/handoff-open <handoff_id> <negotiation_id>");
+                    }
+                    else if (negotiationId === "") {
+                        write("缺少 negotiation_id（handoff 事件按 negotiation 落链，需提供）。");
+                    }
+                    else {
+                        try {
+                            write(await current.kernel.confirmHandoffOpened(handoffId, negotiationId));
+                        }
+                        catch (err) {
+                            write(`[handoff-open] 失败：${err instanceof Error ? err.message : String(err)}`);
+                        }
+                    }
+                }
+                else if (line.startsWith("/handoff-launch ")) {
+                    const rest = line.slice("/handoff-launch ".length).trim();
+                    const parts = rest.split(/\s+/);
+                    const handoffId = parts[0] ?? "";
+                    const negotiationId = parts[1] ?? "";
+                    if (handoffId === "" || negotiationId === "") {
+                        write("用法：/handoff-launch <handoff_id> <negotiation_id>");
+                    }
+                    else {
+                        try {
+                            write(await current.kernel.launchHandoff(handoffId, negotiationId));
+                        }
+                        catch (err) {
+                            write(`[handoff-launch] 失败：${err instanceof Error ? err.message : String(err)}`);
+                        }
+                    }
+                }
+                else if (line.startsWith("/negotiate")) {
+                    if (catalog === undefined) {
+                        write("未配置 agent catalog（KIWI_CATALOG_URL 或 --catalog）。");
+                    }
+                    else {
+                        const targetId = line.slice("/negotiate".length).trim();
+                        write(`[negotiate] 与 ${targetId === "" ? "首个可发现 agent" : targetId} 磋商中…`);
+                        const result = await negotiateWithAgent({
+                            catalog,
+                            ...(targetId !== "" ? { catalogAgentId: targetId } : {}),
+                        });
+                        const summary = summarizeNegotiation(result);
+                        write(`[negotiate]\n${summary}`);
+                        // 磋商结果注入会话 + 写入记忆：下一轮提问时模型能看到（消除"两个脑"）。
+                        if (result.ok) {
+                            await current.kernel.injectContext(summary).catch(() => undefined);
+                            await current.kernel
+                                .recordNegotiation({
+                                negotiationId: result.negotiationId,
+                                catalogAgentId: result.catalogAgentId,
+                                sku: result.facts?.sku ?? "sku-001",
+                                quantity: result.facts?.quantity ?? 200,
+                                offerPriceMinor: result.facts?.offerPriceMinor,
+                                dealPriceMinor: result.facts?.dealPriceMinor,
+                                ...(result.agreement?.agreement_id !== undefined
+                                    ? { agreementId: String(result.agreement.agreement_id) }
+                                    : {}),
+                            })
+                                .catch(() => undefined);
+                        }
+                    }
+                }
+                else {
+                    const reply = await current.kernel.handleUserText(line);
+                    if (reply.text !== "")
+                        write(reply.text);
+                    if (reply.quit)
+                        break;
+                }
+            }
+            if (!rlClosed)
+                refreshPrompt();
+        }
+        rl.close();
+        return EXIT.OK;
+    }
+    finally {
+        clearInterval(timer);
+        clearInterval(negotiateTimer);
+        await a2aNode?.stop().catch(() => undefined);
+    }
+}
+//# sourceMappingURL=chat-tui.js.map

package/dist/agent/chat-tui.js.map

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

package/dist/agent/connector/fake-connector.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 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.
+ */
+/**
+ * Deterministic in-memory Commerce Connector for tests and offline smoke
+ * runs. Filter semantics mirror shopping-cli's /search/products: case-
+ * insensitive substring match over title/description/category/tags, plus
+ * city/area, max_price and stock filters.
+ */
+import { type CommerceConnector, type ConnectorMerchant, type ConnectorProduct, type SearchMerchantsQuery, type SearchProductsQuery } from "./types.js";
+export declare class FakeCommerceConnector implements CommerceConnector {
+    readonly connector_id = "shopping-cli";
+    readonly platform = "shopping-cli";
+    private readonly products;
+    constructor(seed?: ConnectorProduct[]);
+    /** Test helper: add or replace a product. */
+    put(product: ConnectorProduct): void;
+    searchProducts(query: SearchProductsQuery): Promise<ConnectorProduct[]>;
+    getProduct(sku: string): Promise<ConnectorProduct>;
+    searchMerchants(query: SearchMerchantsQuery): Promise<ConnectorMerchant[]>;
+    /**
+     * Deterministic fake consultation start. The fake marketplace binds each
+     * merchant to one conversation id (`conv-<merchant_id>`), so starting a
+     * consultation returns exactly that id — matching the FakeCommerceClient
+     * marketplace convention used by the buyer/merchant negotiation clients.
+     */
+    startConsultation(input: {
+        buyer_id: string;
+        sku: string;
+        merchant_id: string;
+        opening_message: string;
+    }): Promise<{
+        conversation_id: string;
+        status: string;
+    }>;
+}
+/** A catalog product fixture with shopping-cli field shapes. */
+export declare function fakeConnectorProduct(overrides?: Partial<ConnectorProduct>): ConnectorProduct;

package/dist/agent/connector/fake-connector.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.
+ */
+/**
+ * Deterministic in-memory Commerce Connector for tests and offline smoke
+ * runs. Filter semantics mirror shopping-cli's /search/products: case-
+ * insensitive substring match over title/description/category/tags, plus
+ * city/area, max_price and stock filters.
+ */
+import { ConnectorError, } from "./types.js";
+export class FakeCommerceConnector {
+    connector_id = "shopping-cli";
+    platform = "shopping-cli";
+    products = new Map();
+    constructor(seed = []) {
+        for (const p of seed)
+            this.products.set(p.sku, p);
+    }
+    /** Test helper: add or replace a product. */
+    put(product) {
+        this.products.set(product.sku, product);
+    }
+    searchProducts(query) {
+        const needle = (query.query ?? "").toLowerCase();
+        let out = [...this.products.values()];
+        if (needle !== "") {
+            out = out.filter((p) => [p.title, p.description, p.category, ...p.tags]
+                .join(" ")
+                .toLowerCase()
+                .includes(needle));
+        }
+        if (query.city !== undefined && query.city !== "") {
+            out = out.filter((p) => p.merchant.city === query.city);
+        }
+        if (query.area !== undefined && query.area !== "") {
+            out = out.filter((p) => p.delivery.service_area.includes(query.area));
+        }
+        if (query.max_price !== undefined) {
+            out = out.filter((p) => p.price <= query.max_price);
+        }
+        if (query.include_out_of_stock !== true) {
+            out = out.filter((p) => p.stock > 0);
+        }
+        out.sort((a, b) => a.sku.localeCompare(b.sku));
+        const offset = query.offset ?? 0;
+        const limit = query.limit ?? 10;
+        return Promise.resolve(out.slice(offset, offset + limit));
+    }
+    getProduct(sku) {
+        const product = this.products.get(sku);
+        if (product === undefined) {
+            return Promise.reject(new ConnectorError("not_found", `no product ${sku}`));
+        }
+        return Promise.resolve(product);
+    }
+    searchMerchants(query) {
+        const byId = new Map();
+        for (const p of this.products.values())
+            byId.set(p.merchant.id, p.merchant);
+        let out = [...byId.values()];
+        const needle = (query.query ?? "").toLowerCase();
+        if (needle !== "") {
+            out = out.filter((m) => `${m.name} ${m.tags.join(" ")}`.toLowerCase().includes(needle));
+        }
+        if (query.city !== undefined && query.city !== "") {
+            out = out.filter((m) => m.city === query.city);
+        }
+        return Promise.resolve(out.slice(query.offset ?? 0, (query.offset ?? 0) + (query.limit ?? 10)));
+    }
+    /**
+     * Deterministic fake consultation start. The fake marketplace binds each
+     * merchant to one conversation id (`conv-<merchant_id>`), so starting a
+     * consultation returns exactly that id — matching the FakeCommerceClient
+     * marketplace convention used by the buyer/merchant negotiation clients.
+     */
+    startConsultation(input) {
+        void input;
+        return Promise.resolve({
+            conversation_id: `conv-${input.merchant_id}`,
+            status: "waiting_merchant",
+        });
+    }
+}
+/** A catalog product fixture with shopping-cli field shapes. */
+export function fakeConnectorProduct(overrides = {}) {
+    return {
+        sku: "sku-001",
+        merchant_id: "merchant-001",
+        title: "手写陶瓷杯",
+        description: "手工拉坯，350ml",
+        category: "kitchenware",
+        tags: ["手工", "陶瓷"],
+        price: 99,
+        currency: "CNY",
+        stock: 12,
+        delivery_attributes: [],
+        delivery: {
+            service_area: "北京市 海淀区",
+            fee: 5,
+            currency: "CNY",
+            eta_minutes: 1440,
+            radius_km: 10,
+            notes: "当日达",
+        },
+        merchant: {
+            id: "merchant-001",
+            name: "拾光手作",
+            city: "北京市",
+            service_area: "海淀区",
+            hours: "10:00-21:00",
+            tags: ["手作"],
+            delivery: {
+                service_area: "北京市 海淀区",
+                fee: 5,
+                currency: "CNY",
+                eta_minutes: 1440,
+                radius_km: 10,
+                notes: "当日达",
+            },
+            product_count: 3,
+        },
+        warnings: [],
+        ...overrides,
+    };
+}
+//# sourceMappingURL=fake-connector.js.map

package/dist/agent/connector/fake-connector.js.map

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

package/dist/agent/connector/http-connector.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 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 CommerceConnector, type ConnectorMerchant, type ConnectorProduct, type SearchMerchantsQuery, type SearchProductsQuery } from "./types.js";
+export interface ShoppingCliConnectorOptions {
+    /**
+     * Buyer bootstrap token (gateway env SHOPPING_BUYER_BOOTSTRAP_TOKEN), used
+     * to start consultations via POST /buyer/ask. Read endpoints are public.
+     */
+    buyerBootstrapToken?: string;
+}
+export declare class ShoppingCliConnector implements CommerceConnector {
+    readonly connector_id = "shopping-cli";
+    readonly platform = "shopping-cli";
+    private readonly baseUrl;
+    private readonly buyerBootstrapToken;
+    constructor(baseUrl: string, options?: ShoppingCliConnectorOptions);
+    private get;
+    searchProducts(query: SearchProductsQuery): Promise<ConnectorProduct[]>;
+    getProduct(sku: string): Promise<ConnectorProduct>;
+    searchMerchants(query: SearchMerchantsQuery): Promise<ConnectorMerchant[]>;
+    /**
+     * Start a consultation via `POST /buyer/ask`. Requires the buyer bootstrap
+     * token in the Authorization header. The buyer task is only linked to the
+     * returned conversation — authoritative state stays in the marketplace.
+     */
+    startConsultation(input: {
+        buyer_id: string;
+        sku: string;
+        merchant_id: string;
+        opening_message: string;
+    }): Promise<{
+        conversation_id: string;
+        status: string;
+    }>;
+    private post;
+}