@harrylabsj/kiwi 0.7.22 → 0.9.0

package/dist/agent/merchant/merchant-tools.js

@@ -13,16 +13,27 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { LedgerStore } from "../../negotiation/ledger/index.js";
-import { TERMINAL_PHASES } from "../../negotiation/state/phase.js";
+import { fenceModelPayload } from "../context/fencing.js";
+import { MerchantWorkbenchError, MerchantWorkbenchService, parseProductPatch, publicProductView, } from "../../merchant/workbench-service.js";
 import { buildNegotiationChatTools, writeGateText } from "../negotiation-chat.js";
 import { requireScopeCredential } from "./credential-broker.js";
 import { MerchantClientError } from "./types.js";
 import { routeWriteCandidate } from "../write-gate.js";
+import { createMerchantPresentationRegistry } from "./merchant-presentations.js";
+import { runPresentation } from "../presentation/runner.js";
 function textResult(text, details) {
     return { content: [{ type: "text", text }], details };
 }
 function errorText(err) {
+    if (err instanceof MerchantWorkbenchError) {
+        const kindLabel = {
+            auth: "凭据被拒或缺失",
+            not_found: "未找到",
+            validation: "参数或服务校验失败",
+            unavailable: "暂时性错误",
+        };
+        return `商家操作失败（${kindLabel[err.kind] ?? err.kind}）：${err.message}`;
+    }
     if (err instanceof MerchantClientError) {
         const kindLabel = {
             auth: "凭据被拒或缺失",
@@ -37,6 +48,13 @@ function errorText(err) {
 function optString(value) {
     return typeof value === "string" && value !== "" ? value : undefined;
 }
+function experienceEnabled(profile, capability) {
+    const config = profile.merchant_experience;
+    return config?.enabled === true && config[capability] !== false;
+}
+function experienceMaxChars(profile) {
+    return profile.merchant_experience?.max_external_context_chars ?? 12_000;
+}
 function parseProductInput(value) {
     if (value === null || typeof value !== "object" || Array.isArray(value)) {
         throw new MerchantClientError("validation", "product 必须是对象");
@@ -65,43 +83,6 @@ function parseProductInput(value) {
             : {}),
     };
 }
-function parseChanges(value) {
-    if (value === null || typeof value !== "object" || Array.isArray(value)) {
-        throw new MerchantClientError("validation", "changes 必须是对象");
-    }
-    const v = value;
-    const patch = {};
-    if (typeof v.title === "string")
-        patch.title = v.title;
-    if (typeof v.price === "number" && Number.isFinite(v.price))
-        patch.price = v.price;
-    if (typeof v.stock === "number" && Number.isInteger(v.stock))
-        patch.stock = v.stock;
-    if (typeof v.currency === "string")
-        patch.currency = v.currency;
-    if (typeof v.category === "string")
-        patch.category = v.category;
-    if (Array.isArray(v.tags))
-        patch.tags = v.tags.map(String);
-    if (typeof v.description === "string")
-        patch.description = v.description;
-    if (Array.isArray(v.delivery_attributes))
-        patch.delivery_attributes = v.delivery_attributes.map(String);
-    if (typeof v.paused === "boolean")
-        patch.paused = v.paused;
-    return patch;
-}
-/** Public precondition snapshot of a product (no private values). */
-function productPreconditions(product) {
-    return {
-        sku: product.sku,
-        merchant_id: product.merchant_id,
-        title: product.title,
-        price: product.price,
-        stock: product.stock,
-        paused: product.paused,
-    };
-}
 /**
  * Autopilot escalation for catalog/inventory writes: anything outside the
  * profile HardPolicy (private floor, max auto discount) needs a human. The
@@ -130,6 +111,19 @@ export function buildMerchantTools(deps) {
     const { profile, merchantClient, broker, approvals, mode, now } = deps;
     const ownerId = profile.owner_id;
     const writeGateDeps = { mode, approvals, profile, now, registerPending: deps.registerPending };
+    // Merchant Workbench Facade（WorkBuddy 计划阶段一）：只读工具与草稿写工具的
+    // 业务逻辑下沉到不依赖 Pi Agent Core 的服务层；工具层只负责 fencing、文案与 details。
+    const workbench = new MerchantWorkbenchService({
+        profile,
+        merchantClient,
+        approvals,
+        mode,
+        now,
+        ...(deps.dataSource !== undefined ? { dataSource: deps.dataSource } : {}),
+        ...(deps.registerPending !== undefined ? { registerPending: deps.registerPending } : {}),
+        ...(deps.a2aLedgerDir !== undefined ? { a2aLedgerDir: deps.a2aLedgerDir } : {}),
+        ...(deps.intelligence !== undefined ? { intelligence: deps.intelligence } : {}),
+    });
     // ---- read-only tools -------------------------------------------------------
     const listProducts = {
         name: "list_catalog_products",
@@ -143,29 +137,22 @@ export function buildMerchantTools(deps) {
         execute: async (_id, _params) => {
             try {
                 // Always the merchant's own catalog — never an arbitrary merchant_id.
-                if (deps.dataSource !== undefined) {
-                    const facts = await deps.dataSource.getProducts({ limit: 100 });
-                    const rows = facts.map((p) => ({
-                        sku: p.sku,
-                        title: p.title ?? "",
-                        price: p.price_minor ?? 0,
-                        stock: p.stock ?? null,
-                        paused: false,
-                    }));
-                    return textResult(rows.length === 0 ? "目录为空。" : JSON.stringify(rows), {
-                        count: rows.length,
-                        source: "data-source",
-                    });
-                }
-                const products = await merchantClient.listProducts(ownerId);
-                const rows = products.map((p) => ({
+                const { items, source } = await workbench.listPublicProducts();
+                const rows = items.map((p) => ({
                     sku: p.sku,
                     title: p.title,
                     price: p.price,
                     stock: p.stock,
                     paused: p.paused,
                 }));
-                return textResult(rows.length === 0 ? "目录为空。" : JSON.stringify(rows), { count: rows.length });
+                return textResult(rows.length === 0
+                    ? "目录为空。"
+                    : fenceModelPayload("merchant_api", rows, { maxChars: experienceMaxChars(profile) }), source === "data_source"
+                    ? {
+                        count: rows.length,
+                        source: "data-source",
+                    }
+                    : { count: rows.length });
             }
             catch (err) {
                 return textResult(errorText(err));
@@ -185,8 +172,8 @@ export function buildMerchantTools(deps) {
         execute: async (_id, params) => {
             try {
                 const { sku } = params;
-                const product = await merchantClient.getProduct(sku);
-                return textResult(JSON.stringify(productPreconditions(product)));
+                const product = await workbench.getPublicProduct(sku);
+                return textResult(fenceModelPayload("merchant_api", product, { maxChars: experienceMaxChars(profile) }));
             }
             catch (err) {
                 return textResult(errorText(err));
@@ -206,8 +193,8 @@ export function buildMerchantTools(deps) {
         execute: async (_id, params) => {
             try {
                 const { sku } = params;
-                const snapshot = await merchantClient.getInventorySnapshot(sku);
-                return textResult(JSON.stringify(snapshot));
+                const snapshot = await workbench.getInventorySnapshot(sku);
+                return textResult(fenceModelPayload("merchant_api", snapshot, { maxChars: experienceMaxChars(profile) }));
             }
             catch (err) {
                 return textResult(errorText(err));
@@ -226,49 +213,27 @@ export function buildMerchantTools(deps) {
             additionalProperties: false,
         },
         execute: async (_id, _params) => {
-            const ledgerDir = deps.a2aLedgerDir;
-            if (ledgerDir === undefined) {
+            if (deps.a2aLedgerDir === undefined) {
                 return textResult("未配置 A2A ledger 目录，无法读取磋商记录。");
             }
-            const ledger = new LedgerStore({ dir: ledgerDir, now: deps.now });
-            const rows = [];
-            for (const negotiationId of ledger.listNegotiations()) {
-                let phase = "OPEN";
-                let at = "";
-                let sku = "";
-                let qty;
-                let priceMinor;
-                for (const e of ledger.events(negotiationId)) {
-                    if (e.recorded_at > at)
-                        at = e.recorded_at;
-                    if (e.state_transition?.to_phase !== undefined)
-                        phase = e.state_transition.to_phase;
-                    if (e.event_kind === "message_sent") {
-                        const wp = e.wire_payload;
-                        const item = wp?.payload?.terms?.items?.[0];
-                        if (item?.sku !== undefined && item.sku !== "")
-                            sku = item.sku;
-                        if (item?.quantity?.value !== undefined)
-                            qty = item.quantity.value;
-                        if (item?.unit_price?.amount_minor !== undefined)
-                            priceMinor = item.unit_price.amount_minor;
-                    }
-                }
-                // 已到终态（AGREEMENT_REACHED/DECLINED/WITHDRAWN/CANCELLED/EXPIRED）不算进行中
-                if (TERMINAL_PHASES.includes(phase))
-                    continue;
-                const price = priceMinor !== undefined ? `，价 ${(priceMinor / 100).toFixed(2)} 元/件` : "";
-                rows.push({
-                    at,
-                    line: `· ${negotiationId}（${phase}）SKU=${sku || "-"} 数量=${qty ?? "-"}${price} ${at}`,
+            try {
+                const rows = await workbench.listActiveConsultations();
+                const lines = rows.map((r) => {
+                    const price = r.price_minor !== undefined ? `，价 ${(r.price_minor / 100).toFixed(2)} 元/件` : "";
+                    return `· ${r.negotiation_id}（${r.phase}）SKU=${r.sku || "-"} 数量=${r.quantity ?? "-"}${price} ${r.recorded_at}`;
+                });
+                if (lines.length === 0)
+                    return textResult("当前没有进行中的磋商。", { count: 0 });
+                return textResult(fenceModelPayload("a2a_message", {
+                    total: lines.length,
+                    items: lines,
+                }, { maxChars: experienceMaxChars(profile) }), {
+                    count: lines.length,
                 });
             }
-            rows.sort((a, b) => (a.at > b.at ? -1 : a.at < b.at ? 1 : 0));
-            if (rows.length === 0)
-                return textResult("当前没有进行中的磋商。", { count: 0 });
-            return textResult(`共 ${rows.length} 笔进行中磋商：\n${rows.map((r) => r.line).join("\n")}`, {
-                count: rows.length,
-            });
+            catch (err) {
+                return textResult(errorText(err));
+            }
         },
     };
     const humanReviewQueue = {
@@ -282,12 +247,10 @@ export function buildMerchantTools(deps) {
         },
         execute: async (_id, _params) => {
             try {
-                const reviews = await merchantClient.getHumanReviewQueue(ownerId);
+                const reviews = await workbench.listHumanReviews();
                 if (reviews.length === 0)
                     return textResult("人工处理队列为空。");
-                return textResult(reviews
-                    .map((r) => `· #${String(r.review_id)} ${r.sku} [${r.severity}] ${r.reason}（${r.conversation_id}）`)
-                    .join("\n"), { count: reviews.length });
+                return textResult(fenceModelPayload("human_review", reviews, { maxChars: experienceMaxChars(profile) }), { count: reviews.length });
             }
             catch (err) {
                 return textResult(errorText(err));
@@ -373,7 +336,7 @@ export function buildMerchantTools(deps) {
                 return textResult(credential.reason);
             try {
                 const p = params;
-                const patch = parseChanges(p.changes);
+                const patch = parseProductPatch(p.changes);
                 if (Object.keys(patch).length === 0) {
                     return textResult("changes 没有任何可修改字段。");
                 }
@@ -385,7 +348,7 @@ export function buildMerchantTools(deps) {
                     return textResult(`商品 ${p.sku} 不存在。`);
                 }
                 const args = { sku: p.sku, changes: { ...patch } };
-                const preconditions = productPreconditions(current);
+                const preconditions = publicProductView(current);
                 const escalation = catalogEscalation(profile, args, current);
                 const outcome = await routeWriteCandidate(writeGateDeps, {
                     tool: "update_product",
@@ -398,7 +361,7 @@ export function buildMerchantTools(deps) {
                     },
                     readPreconditions: async () => {
                         const fresh = await merchantClient.getProduct(p.sku);
-                        return productPreconditions(fresh);
+                        return publicProductView(fresh);
                     },
                     autopilotEscalation: () => escalation,
                 });
@@ -440,7 +403,7 @@ export function buildMerchantTools(deps) {
                     return textResult(`商品 ${p.sku} 不存在。`);
                 }
                 const args = { sku: p.sku, stock: p.stock };
-                const preconditions = productPreconditions(current);
+                const preconditions = publicProductView(current);
                 const outcome = await routeWriteCandidate(writeGateDeps, {
                     tool: "update_inventory",
                     arguments: args,
@@ -452,7 +415,7 @@ export function buildMerchantTools(deps) {
                     },
                     readPreconditions: async () => {
                         const fresh = await merchantClient.getProduct(p.sku);
-                        return productPreconditions(fresh);
+                        return publicProductView(fresh);
                     },
                 });
                 return writeGateText(outcome);
@@ -491,7 +454,7 @@ export function buildMerchantTools(deps) {
                     return textResult(`商品 ${p.sku} 不存在。`);
                 }
                 const args = { sku: p.sku, paused: p.paused };
-                const preconditions = productPreconditions(current);
+                const preconditions = publicProductView(current);
                 const outcome = await routeWriteCandidate(writeGateDeps, {
                     tool: "pause_or_resume_listing",
                     arguments: args,
@@ -503,7 +466,7 @@ export function buildMerchantTools(deps) {
                     },
                     readPreconditions: async () => {
                         const fresh = await merchantClient.getProduct(p.sku);
-                        return productPreconditions(fresh);
+                        return publicProductView(fresh);
                     },
                 });
                 return writeGateText(outcome);
@@ -521,7 +484,10 @@ export function buildMerchantTools(deps) {
             type: "object",
             properties: {
                 sku: { type: "string" },
-                changes: { type: "object", description: "计划修改的字段（title/price/stock/description 等）" },
+                changes: {
+                    type: "object",
+                    description: "计划修改的字段（title/price/stock/description 等）",
+                },
                 reason: { type: "string" },
             },
             required: ["sku", "changes"],
@@ -533,45 +499,214 @@ export function buildMerchantTools(deps) {
                 return textResult(credential.reason);
             try {
                 const p = params;
-                const patch = parseChanges(p.changes);
+                // 保持工具层既有文案：空 patch / 商品不存在的提示在调用 Facade 前拦截。
+                const patch = parseProductPatch(p.changes);
                 if (Object.keys(patch).length === 0) {
                     return textResult("changes 没有任何可修改字段。");
                 }
-                let current;
                 try {
-                    current = await merchantClient.getProduct(p.sku);
+                    await merchantClient.getProduct(p.sku);
                 }
                 catch {
                     return textResult(`商品 ${p.sku} 不存在。`);
                 }
-                const args = { sku: p.sku, changes: { ...patch }, reason: optString(p.reason) ?? "" };
-                const outcome = await routeWriteCandidate(writeGateDeps, {
-                    tool: "draft_product_change",
-                    arguments: args,
-                    preconditions: productPreconditions(current),
-                    risk: "write_catalog",
-                    // Drafts are ALWAYS pending (never auto-execute), even in autopilot.
-                    force_pending: true,
-                    execute: (approvedArgs) => {
-                        const a = approvedArgs;
-                        return merchantClient.updateProduct(a.sku, a.changes);
-                    },
-                    readPreconditions: async () => {
-                        const fresh = await merchantClient.getProduct(p.sku);
-                        return productPreconditions(fresh);
-                    },
+                const result = await workbench.draftProductChange({
+                    sku: p.sku,
+                    changes: patch,
+                    reason: optString(p.reason) ?? "",
                 });
-                if (outcome.kind === "pending_approval") {
-                    return textResult(`已生成变更草稿候选 ${outcome.candidate.candidate_id}（等待批准后才执行）。当前商品：` +
-                        JSON.stringify(productPreconditions(current)), { candidate_id: outcome.candidate.candidate_id, status: "pending_approval" });
+                if (result.outcome.kind === "pending_approval") {
+                    return textResult(`已生成变更草稿候选 ${result.outcome.candidate.candidate_id}（等待批准后才执行）。当前商品：` +
+                        JSON.stringify(result.product), { candidate_id: result.outcome.candidate.candidate_id, status: "pending_approval" });
                 }
-                return writeGateText(outcome);
+                return writeGateText(result.outcome);
             }
             catch (err) {
                 return textResult(errorText(err));
             }
         },
     };
+    const experienceTools = [];
+    if (experienceEnabled(profile, "intelligence") && deps.intelligence !== undefined) {
+        const intelligence = deps.intelligence;
+        const getBusinessSnapshot = {
+            name: "get_business_snapshot",
+            label: "读取经营摘要",
+            description: "读取当前商家经营摘要、咨询/磋商和待处理事项。只读；指标由服务端计算并注明数据限制。",
+            parameters: {
+                type: "object",
+                properties: {
+                    period: {
+                        type: "string",
+                        pattern: "^(?:[1-9]|[1-8][0-9]|90)d$",
+                        description: "UTC 统计窗口，1d 到 90d，例如 7d、14d、30d",
+                    },
+                },
+                additionalProperties: false,
+            },
+            execute: async (_id, params) => {
+                try {
+                    const period = optString(params.period);
+                    const snapshot = await intelligence.getBusinessSnapshot({
+                        merchant_id: ownerId,
+                        ...(period === undefined ? {} : { period }),
+                    });
+                    return textResult(fenceModelPayload("metric", snapshot, { maxChars: experienceMaxChars(profile) }), {
+                        status: "ok",
+                        metric: "business_snapshot",
+                    });
+                }
+                catch (err) {
+                    return textResult(errorText(err));
+                }
+            },
+        };
+        const queryMetric = {
+            name: "query_merchant_metric",
+            label: "读取经营指标",
+            description: "读取一项按日/周/月聚合的商家指标。不可得的指标返回明确说明，不用零值代替。",
+            parameters: {
+                type: "object",
+                properties: {
+                    metric: { type: "string", description: "指标名，例如 contact_events、negotiations" },
+                    period: {
+                        type: "string",
+                        pattern: "^(?:[1-9]|[1-8][0-9]|90)d$",
+                        description: "UTC 统计窗口，1d 到 90d，例如 7d、14d、30d",
+                    },
+                    granularity: { type: "string", enum: ["day", "week", "month"] },
+                },
+                required: ["metric"],
+                additionalProperties: false,
+            },
+            execute: async (_id, params) => {
+                try {
+                    const p = params;
+                    const metric = optString(p.metric);
+                    if (metric === undefined)
+                        return textResult("metric 必须是非空字符串。");
+                    const granularity = p.granularity === "week" || p.granularity === "month" ? p.granularity : "day";
+                    const series = await intelligence.queryMetric({
+                        merchant_id: ownerId,
+                        metric,
+                        granularity,
+                        ...(optString(p.period) === undefined ? {} : { period: optString(p.period) }),
+                    });
+                    return textResult(fenceModelPayload("metric", series, { maxChars: experienceMaxChars(profile) }), {
+                        status: "ok",
+                        metric,
+                    });
+                }
+                catch (err) {
+                    return textResult(errorText(err));
+                }
+            },
+        };
+        const getNegotiationDigest = {
+            name: "get_negotiation_digest",
+            label: "读取磋商摘要",
+            description: "读取商家 A2A 磋商摘要。返回当前 phase、公开报价和是否需要人工；只读。",
+            parameters: {
+                type: "object",
+                properties: {
+                    status: { type: "string", enum: ["active", "agreement", "all"] },
+                    limit: { type: "integer", minimum: 1, maximum: 100 },
+                },
+                additionalProperties: false,
+            },
+            execute: async (_id, params) => {
+                try {
+                    const p = params;
+                    const status = p.status === "active" || p.status === "agreement" ? p.status : "all";
+                    const rawLimit = typeof p.limit === "number" && Number.isFinite(p.limit) ? Math.trunc(p.limit) : 20;
+                    const rows = await intelligence.getNegotiationDigest({
+                        merchant_id: ownerId,
+                        status,
+                        limit: Math.max(1, Math.min(100, rawLimit)),
+                    });
+                    return textResult(fenceModelPayload("a2a_message", rows, { maxChars: experienceMaxChars(profile) }), {
+                        status: "ok",
+                        count: rows.length,
+                    });
+                }
+                catch (err) {
+                    return textResult(errorText(err));
+                }
+            },
+        };
+        const getCatalogHealth = {
+            name: "get_catalog_health",
+            label: "读取目录健康度",
+            description: "读取商品总量、上下架状态和缺货数量；精确库存不可得时返回 null 及限制说明。",
+            parameters: { type: "object", properties: {}, additionalProperties: false },
+            execute: async () => {
+                try {
+                    const health = await intelligence.getCatalogHealth({ merchant_id: ownerId });
+                    return textResult(fenceModelPayload("merchant_api", health, { maxChars: experienceMaxChars(profile) }), {
+                        status: "ok",
+                    });
+                }
+                catch (err) {
+                    return textResult(errorText(err));
+                }
+            },
+        };
+        const getPendingActions = {
+            name: "get_pending_actions",
+            label: "读取待审批操作",
+            description: "读取当前 principal 的待审批写操作。返回候选元数据，不返回私有阈值或凭据。",
+            parameters: { type: "object", properties: {}, additionalProperties: false },
+            execute: async () => {
+                try {
+                    const rows = await intelligence.getPendingActions();
+                    return textResult(fenceModelPayload("merchant_api", rows, { maxChars: experienceMaxChars(profile) }), {
+                        status: "ok",
+                        count: rows.length,
+                    });
+                }
+                catch (err) {
+                    return textResult(errorText(err));
+                }
+            },
+        };
+        experienceTools.push(getBusinessSnapshot, queryMetric, getCatalogHealth, getNegotiationDigest, getPendingActions);
+    }
+    if (experienceEnabled(profile, "presentation") && deps.emitEvent !== undefined) {
+        const registry = createMerchantPresentationRegistry();
+        const emitUi = async (component, payload) => {
+            await deps.emitEvent?.("ui", { component, payload });
+        };
+        const presentationContext = {
+            profile,
+            // 口径修复（V2 阶段二遗留核查）：enrich 以 principalId 作为商家读取键
+            // （intelligence.assertOwned / listProducts 都按 merchant_id 口径）——
+            // 必须用 owner_id；传 agent_id 会导致 digest/catalog 展示校验失败或读空。
+            principalId: ownerId,
+            merchantClient,
+            approvals,
+            ...(deps.intelligence !== undefined ? { intelligence: deps.intelligence } : {}),
+        };
+        for (const component of registry.list()) {
+            const presentationTool = {
+                name: component.toolName,
+                label: component.label,
+                description: component.description,
+                parameters: component.inputSchema,
+                execute: async (_id, params) => {
+                    try {
+                        const result = await runPresentation(registry, component.toolName, params, presentationContext, emitUi);
+                        return textResult(component.toolName === "present_change_preview"
+                            ? "已展示变更预览；尚未批准或执行。"
+                            : `已展示${component.label.replace(/^展示/, "")}。`, { component: result.component });
+                    }
+                    catch (err) {
+                        return textResult(errorText(err));
+                    }
+                },
+            };
+            experienceTools.push(presentationTool);
+        }
+    }
     const negotiationTools = deps.commerceClient !== undefined
         ? buildNegotiationChatTools({
             profile,
@@ -596,7 +731,9 @@ export function buildMerchantTools(deps) {
             const values = deps.privateValues();
             if (values.length === 0)
                 return textResult("暂无私密阈值记忆。");
-            return textResult(values.map((v) => `· ${v.key} = ${v.value}`).join("\n"), { count: values.length });
+            return textResult(values.map((v) => `· ${v.key} = ${v.value}`).join("\n"), {
+                count: values.length,
+            });
         },
     };
     // ── A2A 磋商记录（真实经 A2A 节点的磋商，读 merchant 节点 ledger）───────
@@ -614,53 +751,28 @@ export function buildMerchantTools(deps) {
             additionalProperties: false,
         },
         execute: async (_id, params) => {
-            const ledgerDir = deps.a2aLedgerDir;
-            if (ledgerDir === undefined) {
+            if (deps.a2aLedgerDir === undefined) {
                 return textResult("未配置 A2A ledger 目录，无法读取磋商记录。");
             }
-            const ledger = new LedgerStore({ dir: ledgerDir, now: deps.now });
-            const limit = Math.min(Math.max(Number(params.limit ?? 20) || 20, 1), 100);
-            const rows = [];
-            for (const negotiationId of ledger.listNegotiations()) {
-                const events = ledger.events(negotiationId);
-                let at = "";
-                let lastAction = "";
-                let sku = "";
-                let qty;
-                let priceMinor;
-                let agreement = false;
-                for (const e of events) {
-                    if (e.recorded_at > at)
-                        at = e.recorded_at;
-                    if (e.event_kind === "message_sent") {
-                        const wp = e.wire_payload;
-                        if (wp?.action !== undefined)
-                            lastAction = wp.action;
-                        const item = wp?.payload?.terms?.items?.[0];
-                        if (item?.sku !== undefined && item.sku !== "")
-                            sku = item.sku;
-                        if (item?.quantity?.value !== undefined)
-                            qty = item.quantity.value;
-                        if (item?.unit_price?.amount_minor !== undefined)
-                            priceMinor = item.unit_price.amount_minor;
-                    }
-                    if (e.state_transition?.to_phase === "AGREEMENT_REACHED")
-                        agreement = true;
-                }
-                const price = priceMinor !== undefined ? `，价 ${(priceMinor / 100).toFixed(2)} 元/件` : "";
-                rows.push({
-                    at,
-                    line: `· ${negotiationId}${agreement ? " ✅ 已达成协议" : `（${lastAction || "?"}）`} ` +
-                        `SKU=${sku || "-"} 数量=${qty ?? "-"}${price} ${at}`,
+            try {
+                const { total, items } = await workbench.listA2aNegotiations(params.limit);
+                const lines = items.map((r) => {
+                    const price = r.price_minor !== undefined ? `，价 ${(r.price_minor / 100).toFixed(2)} 元/件` : "";
+                    return (`· ${r.negotiation_id}${r.agreement ? " ✅ 已达成协议" : `（${r.last_action || "?"}）`} ` +
+                        `SKU=${r.sku || "-"} 数量=${r.quantity ?? "-"}${price} ${r.recorded_at}`);
+                });
+                if (lines.length === 0)
+                    return textResult("暂无 A2A 磋商记录。", { count: 0 });
+                return textResult(fenceModelPayload("a2a_message", {
+                    total,
+                    items: lines,
+                }, { maxChars: experienceMaxChars(profile) }), {
+                    count: lines.length,
                 });
             }
-            rows.sort((a, b) => (a.at > b.at ? -1 : a.at < b.at ? 1 : 0));
-            const recent = rows.slice(0, limit);
-            if (recent.length === 0)
-                return textResult("暂无 A2A 磋商记录。", { count: 0 });
-            return textResult(`共 ${rows.length} 笔 A2A 磋商（最近 ${recent.length} 笔）：\n${recent.map((r) => r.line).join("\n")}`, {
-                count: recent.length,
-            });
+            catch (err) {
+                return textResult(errorText(err));
+            }
         },
     };
     return [
@@ -670,6 +782,7 @@ export function buildMerchantTools(deps) {
         listConsultations,
         humanReviewQueue,
         viewPrivateThresholds,
+        ...experienceTools,
         ...negotiationTools,
         createProduct,
         updateProduct,