@harrylabsj/kiwi 0.7.22 → 0.9.0

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

@@ -0,0 +1,38 @@
+/**
+ * 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.
+ */
+/** Public, server-enriched projection of an approval candidate. */
+export function publicCandidatePreview(candidate) {
+    if (candidate === undefined)
+        return undefined;
+    const args = candidate.arguments;
+    const before = candidate.preconditions;
+    const changes = [];
+    const patch = args.changes;
+    if (patch !== null && typeof patch === "object" && !Array.isArray(patch)) {
+        for (const [field, after] of Object.entries(patch)) {
+            if (/token|secret|credential|password|floor|cost|vault|private/i.test(field))
+                continue;
+            changes.push({ field, before: before[field], after });
+        }
+    }
+    if (typeof args.stock === "number")
+        changes.push({ field: "stock", before: before.stock, after: args.stock });
+    if (typeof args.paused === "boolean")
+        changes.push({ field: "paused", before: before.paused, after: args.paused });
+    if (changes.length === 0)
+        changes.push({ field: "operation", before: "not_applied", after: candidate.tool });
+    return {
+        candidate_id: candidate.candidate_id,
+        tool: candidate.tool,
+        status: candidate.status,
+        risk: candidate.risk,
+        expires_at: candidate.expires_at,
+        stale_sensitive: true,
+        changes,
+    };
+}
+//# sourceMappingURL=merchant-enrichment.js.map

package/dist/agent/merchant/merchant-enrichment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merchant-enrichment.js","sourceRoot":"","sources":["../../../src/agent/merchant/merchant-enrichment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,mEAAmE;AACnE,MAAM,UAAU,sBAAsB,CACpC,SAAyD;IAEzD,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC9C,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC;IACjC,MAAM,MAAM,GAAG,SAAS,CAAC,aAAa,CAAC;IACvC,MAAM,OAAO,GAA8D,EAAE,CAAC;IAC9E,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC;IAC3B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzE,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;YAC9E,IAAI,4DAA4D,CAAC,IAAI,CAAC,KAAK,CAAC;gBAAE,SAAS;YACvF,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IACD,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9G,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACnH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7G,OAAO;QACL,YAAY,EAAE,SAAS,CAAC,YAAY;QACpC,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,UAAU,EAAE,SAAS,CAAC,UAAU;QAChC,eAAe,EAAE,IAAI;QACrB,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/agent/merchant/merchant-grounding.d.ts

@@ -0,0 +1,5 @@
+import type { AgentProfile } from "../../config/profile.js";
+import type { GroundingContext, GroundingRule } from "../context/grounding.js";
+/** Rules are intentionally read-only; write tools can never be a grounding target. */
+export declare const MERCHANT_GROUNDING_RULES: readonly GroundingRule[];
+export declare function merchantGroundingContext(profile: AgentProfile, latestUserText: string): GroundingContext;

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

@@ -0,0 +1,76 @@
+function has(text, terms) {
+    const lowered = text.toLowerCase();
+    return terms.some((term) => lowered.includes(term));
+}
+function enabled(profile) {
+    return profile.merchant_experience?.enabled !== false &&
+        profile.merchant_experience?.grounding !== false;
+}
+/** Rules are intentionally read-only; write tools can never be a grounding target. */
+export const MERCHANT_GROUNDING_RULES = [
+    {
+        name: "pending-actions",
+        priority: 10,
+        match: ({ latestUserText, sessionState }) => {
+            const profile = sessionState.profile;
+            if (profile !== undefined && !enabled(profile))
+                return undefined;
+            if (!has(latestUserText, ["待审批", "等待批准", "pending", "approve", "批准", "执行"])) {
+                return undefined;
+            }
+            return { tool: "get_pending_actions", arguments: {}, reason: "approval state must be current" };
+        },
+    },
+    {
+        name: "negotiations",
+        priority: 20,
+        match: ({ latestUserText }) => {
+            if (!has(latestUserText, ["磋商", "询价", "报价", "还价", "buyer", "negotiation"])) {
+                return undefined;
+            }
+            return { tool: "get_negotiation_digest", arguments: { status: "active" }, reason: "read current A2A negotiations first" };
+        },
+    },
+    {
+        name: "human-review",
+        priority: 30,
+        match: ({ latestUserText }) => {
+            if (!has(latestUserText, ["人工", "审核", "转人工", "human review"]))
+                return undefined;
+            return { tool: "get_human_review_queue", arguments: {}, reason: "read the current review queue first" };
+        },
+    },
+    {
+        name: "inventory-health",
+        priority: 40,
+        match: ({ latestUserText }) => {
+            if (!has(latestUserText, ["库存", "缺货", "有货", "补货", "stock", "inventory"])) {
+                return undefined;
+            }
+            return { tool: "get_catalog_health", arguments: {}, reason: "inventory answers require current catalog facts" };
+        },
+    },
+    {
+        name: "catalog",
+        priority: 50,
+        match: ({ latestUserText }) => {
+            if (!has(latestUserText, ["商品", "目录", "sku", "listing", "catalog"]))
+                return undefined;
+            return { tool: "list_catalog_products", arguments: {}, reason: "catalog answers require current owned listings" };
+        },
+    },
+    {
+        name: "business-snapshot",
+        priority: 60,
+        match: ({ latestUserText }) => {
+            if (!has(latestUserText, ["经营", "生意", "销售", "业绩", "指标", "收入", "最近怎么样"])) {
+                return undefined;
+            }
+            return { tool: "get_business_snapshot", arguments: {}, reason: "business answers require current metrics" };
+        },
+    },
+];
+export function merchantGroundingContext(profile, latestUserText) {
+    return { latestUserText, sessionState: { profile } };
+}
+//# sourceMappingURL=merchant-grounding.js.map

package/dist/agent/merchant/merchant-grounding.js.map

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

package/dist/agent/merchant/merchant-presentations.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 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.
+ */
+import { PresentationRegistry } from "../presentation/registry.js";
+export declare function createMerchantPresentationRegistry(): PresentationRegistry;

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

@@ -0,0 +1,207 @@
+/**
+ * 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.
+ */
+import { sanitizeModelText } from "../context/fencing.js";
+import { publicCandidatePreview } from "./merchant-enrichment.js";
+import { PresentationRegistry } from "../presentation/registry.js";
+const MAX_PERIOD = /^(?:[1-9]|[1-8][0-9]|90)d$/;
+function objectInput(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error("presentation input must be an object");
+    }
+    return value;
+}
+function optionalText(value, field, maxChars) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "string" || value.length > maxChars)
+        throw new Error(`${field} must be a string of at most ${maxChars} characters`);
+    return sanitizeModelText(value, { maxChars });
+}
+function requireText(value, field, maxChars) {
+    const text = optionalText(value, field, maxChars);
+    if (text === undefined || text === "")
+        throw new Error(`${field} must be a non-empty string`);
+    return text;
+}
+function intelligence(context) {
+    if (context.intelligence === undefined)
+        throw new Error("merchant intelligence is unavailable");
+    return context.intelligence;
+}
+function boundedLimit(value, defaultValue) {
+    if (value === undefined)
+        return defaultValue;
+    if (typeof value !== "number" || !Number.isInteger(value) || value < 1 || value > 50) {
+        throw new Error("limit must be an integer between 1 and 50");
+    }
+    return value;
+}
+function parseDigest(value) {
+    const v = objectInput(value);
+    const period = optionalText(v.period, "period", 20);
+    if (period !== undefined && !MAX_PERIOD.test(period))
+        throw new Error("period must use 1d–90d syntax");
+    return { ...(optionalText(v.title, "title", 80) ? { title: optionalText(v.title, "title", 80) } : {}), ...(period ? { period } : {}) };
+}
+function parseMetrics(value) {
+    const v = objectInput(value);
+    const metric = requireText(v.metric, "metric", 80);
+    const period = optionalText(v.period, "period", 20);
+    if (period !== undefined && !MAX_PERIOD.test(period))
+        throw new Error("period must use 1d–90d syntax");
+    const granularity = v.granularity === undefined ? "day" : v.granularity;
+    if (granularity !== "day" && granularity !== "week" && granularity !== "month")
+        throw new Error("invalid granularity");
+    return { metric, ...(period ? { period } : {}), granularity };
+}
+function parseCatalog(value) {
+    return { limit: boundedLimit(objectInput(value).limit, 20) };
+}
+function parseNegotiations(value) {
+    const v = objectInput(value);
+    const status = v.status === undefined ? "all" : v.status;
+    if (status !== "active" && status !== "agreement" && status !== "all")
+        throw new Error("invalid negotiation status");
+    return { status, limit: boundedLimit(v.limit, 20) };
+}
+function parseHumanReview(value) {
+    return { limit: boundedLimit(objectInput(value).limit, 20) };
+}
+function parseChangePreview(value) {
+    const v = objectInput(value);
+    return {
+        candidate_id: requireText(v.candidate_id, "candidate_id", 200),
+        ...(optionalText(v.headline, "headline", 120) ? { headline: optionalText(v.headline, "headline", 120) } : {}),
+        ...(optionalText(v.note, "note", 200) ? { note: optionalText(v.note, "note", 200) } : {}),
+    };
+}
+function parseSuggestions(value) {
+    const raw = objectInput(value).suggestions;
+    if (!Array.isArray(raw) || raw.length < 1 || raw.length > 4)
+        throw new Error("suggestions must contain 1 to 4 items");
+    return { suggestions: raw.map((item) => requireText(item, "suggestion", 80)) };
+}
+function component(input) {
+    return input;
+}
+export function createMerchantPresentationRegistry() {
+    const registry = new PresentationRegistry();
+    registry
+        .register(component({
+        toolName: "present_merchant_digest",
+        component: "merchant_digest",
+        label: "展示经营摘要",
+        description: "展示商家经营摘要、告警、A2A 磋商和待审批事项。真实数据由服务端读取和补全。",
+        inputSchema: { type: "object", properties: { title: { type: "string", maxLength: 80 }, period: { type: "string", pattern: "^(?:[1-9]|[1-8][0-9]|90)d$" } }, additionalProperties: false },
+        validate: parseDigest,
+        enrich: async (input, context) => {
+            const backend = intelligence(context);
+            const max = context.profile.merchant_experience?.max_presentation_items ?? 12;
+            const [snapshot, negotiations, pending] = await Promise.all([
+                backend.getBusinessSnapshot({ merchant_id: context.principalId, ...(input.period ? { period: input.period } : {}) }),
+                backend.getNegotiationDigest({ merchant_id: context.principalId, status: "active", limit: max }),
+                backend.getPendingActions(),
+            ]);
+            return { title: input.title ?? "经营摘要", snapshot, negotiations: negotiations.slice(0, max), pending_actions: pending.slice(0, max) };
+        },
+    }))
+        .register(component({
+        toolName: "present_metrics",
+        component: "metrics",
+        label: "展示经营指标",
+        description: "展示一项按日、周或月聚合的经营指标；数据和限制说明由服务端补全。",
+        inputSchema: { type: "object", properties: { metric: { type: "string", maxLength: 80 }, period: { type: "string", pattern: "^(?:[1-9]|[1-8][0-9]|90)d$" }, granularity: { type: "string", enum: ["day", "week", "month"] } }, required: ["metric"], additionalProperties: false },
+        validate: parseMetrics,
+        enrich: (input, context) => intelligence(context).queryMetric({ merchant_id: context.principalId, ...input }),
+    }))
+        .register(component({
+        toolName: "present_catalog",
+        component: "catalog",
+        label: "展示商品目录",
+        description: "展示商家商品目录及库存健康摘要；真实商品数据由服务端读取和补全。",
+        inputSchema: { type: "object", properties: { limit: { type: "integer", minimum: 1, maximum: 50 } }, additionalProperties: false },
+        validate: parseCatalog,
+        enrich: async (input, context) => {
+            const [products, health] = await Promise.all([
+                context.merchantClient.listProducts(context.principalId),
+                intelligence(context).getCatalogHealth({ merchant_id: context.principalId }),
+            ]);
+            // 白名单脱敏（V2 §8 防御层）：只取公开字段，不透传上游原始对象——
+            // 即使商品源返回了额外字段（底价/成本等）也不进展示负载。
+            return {
+                health,
+                products: products.slice(0, input.limit).map((p) => ({
+                    sku: p.sku,
+                    merchant_id: p.merchant_id,
+                    title: p.title,
+                    price: p.price,
+                    stock: p.stock,
+                    paused: p.paused,
+                })),
+            };
+        },
+    }))
+        .register(component({
+        toolName: "present_negotiations",
+        component: "negotiations",
+        label: "展示磋商列表",
+        description: "展示当前 A2A 磋商列表；状态、报价和时间由 Ledger 服务端补全。",
+        inputSchema: { type: "object", properties: { status: { type: "string", enum: ["active", "agreement", "all"] }, limit: { type: "integer", minimum: 1, maximum: 50 } }, additionalProperties: false },
+        validate: parseNegotiations,
+        enrich: (input, context) => intelligence(context).getNegotiationDigest({ merchant_id: context.principalId, ...input }),
+    }))
+        .register(component({
+        toolName: "present_human_review",
+        component: "human_review",
+        label: "展示人工审核",
+        description: "展示需要人工处理的事项；审核原因和实体由服务端读取和补全。",
+        inputSchema: { type: "object", properties: { limit: { type: "integer", minimum: 1, maximum: 50 } }, additionalProperties: false },
+        validate: parseHumanReview,
+        enrich: async (input, context) => ({
+            // 白名单脱敏：只取公开字段（同 catalog 的防御层口径）。
+            reviews: (await context.merchantClient.getHumanReviewQueue(context.principalId))
+                .slice(0, input.limit)
+                .map((r) => ({
+                review_id: r.review_id,
+                conversation_id: r.conversation_id,
+                sku: r.sku,
+                severity: r.severity,
+                reason: r.reason,
+            })),
+        }),
+    }))
+        .register(component({
+        toolName: "present_change_preview",
+        component: "change_preview",
+        label: "展示变更预览",
+        description: "展示一个 WriteApprovalCandidate 的前后差异。展示不会批准或执行变更。",
+        inputSchema: { type: "object", properties: { candidate_id: { type: "string" }, headline: { type: "string", maxLength: 120 }, note: { type: "string", maxLength: 200 } }, required: ["candidate_id"], additionalProperties: false },
+        validate: parseChangePreview,
+        enrich: async (input, context) => {
+            const preview = context.intelligence === undefined
+                ? publicCandidatePreview(context.approvals.get(input.candidate_id))
+                : await context.intelligence.getCandidatePreview({
+                    principal_id: context.principalId,
+                    candidate_id: input.candidate_id,
+                });
+            if (preview === undefined)
+                throw new Error("未找到当前 principal 的候选操作");
+            return { ...preview, headline: input.headline ?? "变更预览", note: input.note ?? "" };
+        },
+    }))
+        .register(component({
+        toolName: "present_suggestions",
+        component: "suggestions",
+        label: "展示下一步建议",
+        description: "展示 1–4 个下一步建议。建议只影响 UI，不改变权限或业务状态。",
+        inputSchema: { type: "object", properties: { suggestions: { type: "array", minItems: 1, maxItems: 4, items: { type: "string", maxLength: 80 } } }, required: ["suggestions"], additionalProperties: false },
+        validate: parseSuggestions,
+        enrich: async (input) => ({ suggestions: input.suggestions }),
+    }));
+    return registry;
+}
+//# sourceMappingURL=merchant-presentations.js.map

package/dist/agent/merchant/merchant-presentations.js.map

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

package/dist/agent/merchant/merchant-tools.d.ts

@@ -30,6 +30,7 @@
  */
 import type { AgentHarnessTool } from "@earendil-works/pi-agent-core";
 import type { AgentProfile } from "../../config/profile.js";
+import type { AgentHostEventType } from "../host/events.js";
 import type { CommerceDataSource } from "../../commerce/data-source.js";
 import type { CommerceClient } from "../../commerce/types.js";
 import type { AgentMode } from "../mode.js";
@@ -37,6 +38,7 @@ import type { WriteApprovalCandidateStore } from "./action-candidate.js";
 import type { CredentialBroker } from "./credential-broker.js";
 import type { MerchantClient } from "./types.js";
 import type { WriteGateDeps, WriteGateResult } from "../write-gate.js";
+import type { MerchantIntelligenceBackend } from "./intelligence/backend.js";
 type Tool = AgentHarnessTool<undefined>;
 export interface MerchantToolDeps {
     profile: AgentProfile;
@@ -72,6 +74,12 @@ export interface MerchantToolDeps {
     /** 商家 A2A 节点 ledger 目录（`<dataDir>/a2a/ledger`）；提供时挂载
      *  `list_a2a_negotiations` 工具，让运营者查看真实发生的 A2A 磋商记录。 */
     a2aLedgerDir?: string;
+    /** Optional commerce-agents-style merchant application layer. */
+    intelligence?: MerchantIntelligenceBackend;
+    /** Optional host event projection; business state never depends on it. */
+    emitEvent?: (type: AgentHostEventType, data: unknown) => Promise<void>;
+    /** Process-bound principal id used by server enrichment. */
+    principalId?: string;
 }
 export declare function buildMerchantTools(deps: MerchantToolDeps): Tool[];
 export type { WriteGateResult };