@harrylabsj/kiwi 0.7.10 → 0.7.11

package/dist/merchant/decision-backend.js

@@ -0,0 +1,275 @@
+/**
+ * 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.
+ */
+/**
+ * MerchantDecisionBackend —— merchant 运行时的受限推理后端（DeepSeek Harness 运行时
+ * 插件，战略 v2.5 §6.9 / §十一 Phase 2）。
+ *
+ * 设计边界（§3.3 / §6.9）：
+ * - backend 只产出 **不可信** DecisionCandidate（`NegotiationDecision`），**不持有
+ *   Commerce token、不拥有状态机、无任何最终写入权**（0 写 by construction——
+ *   DeepSeek 后端只 fetch 模型端点，从不接触 commerce 端点）。
+ * - 调用方（createMerchantHandler）负责验证（冻结 decision 契约）+ 硬边界约束
+ *   （floor / max auto discount / list 封顶）后应用；任何失败 → 回落确定性基线。
+ * - 独立运行：merchant 是独立进程，不依赖宿主（Standalone-first §7.4）。
+ *
+ * 与 integrations/harnesses/deepseek-harness/validate-contract-cases.mjs 共享同一
+ * schema 驱动 prompt 与 extractJson —— 两处 prompt 须保持同步（本文件是运行时消费
+ * 方，harness 是只读 contract-gate 验证面）。
+ */
+import { validateAgainst } from "../contracts/schemas.js";
+import { PROTOCOL_VERSION } from "../negotiation/types.js";
+import { toMinorUnits as losslessToMinorUnits } from "../protocol/legacy-shopping-negotiation/money.js";
+// ---------------------------------------------------------------------------
+// JSON 提取 + 白名单消毒（schema additionalProperties:false 需先剥未知键）
+// ---------------------------------------------------------------------------
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function pick(obj, keys) {
+    const out = {};
+    for (const key of keys) {
+        if (obj[key] !== undefined)
+            out[key] = obj[key];
+    }
+    return out;
+}
+const DECISION_KEYS = [
+    "protocol_version",
+    "conversation_id",
+    "in_reply_to_message_id",
+    "action",
+    "proposal",
+    "open_issues",
+    "public_message",
+    "confidence",
+    "reason_codes",
+    "request_human_review",
+];
+const PROPOSAL_KEYS = [
+    "sku",
+    "quantity",
+    "unit_price",
+    "currency",
+    "stock",
+    "delivery",
+    "after_sales_policy_refs",
+    "valid_until",
+];
+const STOCK_KEYS = ["status", "quantity", "observed_at", "reserved"];
+const DELIVERY_KEYS = ["eta_start", "eta_end", "fee"];
+/**
+ * 从模型输出提取 JSON 对象（容忍 ```json 围栏 / 前后缀文本）。复制自 harness。
+ */
+export function extractJson(text) {
+    const fenced = text.match(/```(?:json)?\s*([\s\S]*?)```/);
+    const candidate = fenced !== null && fenced[1] !== undefined ? fenced[1] : text;
+    try {
+        return JSON.parse(candidate);
+    }
+    catch {
+        const start = candidate.indexOf("{");
+        const end = candidate.lastIndexOf("}");
+        if (start >= 0 && end > start) {
+            try {
+                return JSON.parse(candidate.slice(start, end + 1));
+            }
+            catch {
+                return undefined;
+            }
+        }
+        return undefined;
+    }
+}
+/**
+ * 白名单消毒 + 冻结契约校验。未知键先剥（模型可能加 thinking/注释）；再
+ * validateAgainst("decision")（复用生产校验器，src/contracts/schemas.ts）。
+ * merchant role bound：action ∈ {propose, counter} 且 proposal 存在才接受。
+ */
+export function sanitizeDecision(raw) {
+    if (!isObject(raw))
+        return null;
+    const decision = pick(raw, DECISION_KEYS);
+    if (isObject(decision.proposal)) {
+        const proposal = pick(decision.proposal, PROPOSAL_KEYS);
+        if (isObject(proposal.stock))
+            proposal.stock = pick(proposal.stock, STOCK_KEYS);
+        if (isObject(proposal.delivery))
+            proposal.delivery = pick(proposal.delivery, DELIVERY_KEYS);
+        decision.proposal = proposal;
+    }
+    const errors = validateAgainst("decision", decision);
+    if (errors.length > 0)
+        return null;
+    const candidate = decision;
+    if ((candidate.action !== "propose" && candidate.action !== "counter") || candidate.proposal === undefined) {
+        return null;
+    }
+    return candidate;
+}
+const DEFAULT_MODEL = "deepseek-v4-flash";
+const DEFAULT_BASE_URL = "https://api.deepseek.com";
+const DEFAULT_TIMEOUT_MS = 10_000;
+const DEFAULT_TEMPERATURE = 0.2;
+/** 构建 schema 驱动 prompt 模板（镜像 harness realCandidate；不含 floor）。 */
+function decisionTemplate(input) {
+    const nowIso = new Date().toISOString();
+    const stock = input.product.stock ?? 180;
+    return {
+        protocol_version: PROTOCOL_VERSION,
+        conversation_id: input.conversationId,
+        in_reply_to_message_id: input.inReplyToMessageId ?? 1,
+        action: input.action,
+        open_issues: [],
+        public_message: "按报价提供。",
+        reason_codes: ["within_policy"],
+        request_human_review: false,
+        confidence: 0.8,
+        proposal: {
+            sku: input.sku,
+            quantity: input.quantity,
+            unit_price: input.product.priceMinor / 100, // major 元
+            currency: input.product.currency,
+            stock: { status: stock > 0 ? "available" : "out_of_stock", quantity: stock, observed_at: nowIso, reserved: false },
+            delivery: { eta_start: nowIso, eta_end: nowIso, fee: 8 },
+            after_sales_policy_refs: [],
+            valid_until: "2099-12-31T23:59:59Z",
+        },
+    };
+}
+export class DeepSeekDecisionBackend {
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async suggest(input) {
+        let apiKey;
+        try {
+            apiKey = typeof this.opts.apiKey === "function" ? this.opts.apiKey() : this.opts.apiKey;
+        }
+        catch {
+            return null; // resolveSecret 失败 → fail-safe 回落
+        }
+        if (apiKey === "")
+            return null;
+        const template = decisionTemplate(input);
+        const system = "你是商家磋商决策助手。只输出一个 JSON 对象，严格符合给定结构，不要任何额外文字、markdown 或注释。";
+        const user = `action=${input.action} sku=${input.sku} quantity=${input.quantity} 商品=${JSON.stringify(input.product)}。` +
+            `输出 action="${input.action}" 的 decision，结构如下（字段名与嵌套完全一致，不得增加字段）：\n` +
+            JSON.stringify(template, null, 2);
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.opts.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+        try {
+            const resp = await (this.opts.fetchImpl ?? globalThis.fetch)(`${this.opts.baseUrl ?? DEFAULT_BASE_URL}/v1/chat/completions`, {
+                method: "POST",
+                headers: { "content-type": "application/json", authorization: `Bearer ${apiKey}` },
+                body: JSON.stringify({
+                    model: this.opts.model ?? DEFAULT_MODEL,
+                    messages: [
+                        { role: "system", content: system },
+                        { role: "user", content: user },
+                    ],
+                    thinking: { type: "disabled" }, // harness C1 规则：非推理任务
+                    response_format: { type: "json_object" },
+                    temperature: this.opts.temperature ?? DEFAULT_TEMPERATURE,
+                }),
+                signal: controller.signal,
+            });
+            if (!resp.ok)
+                return null;
+            const data = (await resp.json());
+            return sanitizeDecision(extractJson(data.choices?.[0]?.message?.content ?? ""));
+        }
+        catch {
+            return null; // 网络/超时/解析失败 → fail-safe
+        }
+        finally {
+            clearTimeout(timer); // 测试无悬挂 timer
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Mock 后端（确定性，镜像 harness mockCandidate；测试 + 离线冒烟）
+// ---------------------------------------------------------------------------
+export class MockDecisionBackend {
+    async suggest(input) {
+        const qty = input.product.stock ?? 180;
+        const nowIso = new Date().toISOString();
+        return {
+            protocol_version: PROTOCOL_VERSION,
+            conversation_id: input.conversationId,
+            in_reply_to_message_id: input.inReplyToMessageId ?? 1,
+            action: input.action,
+            open_issues: [],
+            public_message: "按报价提供。",
+            reason_codes: ["within_policy"],
+            request_human_review: false,
+            confidence: 0.8,
+            proposal: {
+                sku: input.sku,
+                quantity: input.quantity,
+                unit_price: input.product.priceMinor / 100, // major 元
+                currency: input.product.currency,
+                stock: { status: qty > 0 ? "available" : "out_of_stock", quantity: qty, observed_at: nowIso, reserved: false },
+                delivery: { eta_start: nowIso, eta_end: nowIso, fee: 8 },
+                after_sales_policy_refs: [],
+                valid_until: "2099-12-31T23:59:59Z",
+            },
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// 桥接助手（handler 用）
+// ---------------------------------------------------------------------------
+/**
+ * 候选 → {minor 单价, 可选公开说明} | null。backend 不可信：任何失败/缺失/
+ * 有损转换 → null（调用方回落确定性基线）。**backed 从不写。**
+ */
+export async function consultDecisionBackend(backend, input) {
+    if (backend === undefined)
+        return null;
+    let decision = null;
+    try {
+        decision = await backend.suggest(input);
+    }
+    catch {
+        return null;
+    }
+    if (decision === null)
+        return null;
+    const proposal = decision.proposal;
+    if (proposal === undefined || typeof proposal.unit_price !== "number")
+        return null;
+    const converted = losslessToMinorUnits(proposal.unit_price, 2);
+    if (!converted.lossless)
+        return null; // money.ts：有损 → fail-closed
+    return {
+        unitPriceMinor: converted.amount_minor,
+        ...(decision.public_message !== undefined && decision.public_message !== ""
+            ? { note: decision.public_message }
+            : {}),
+    };
+}
+/**
+ * 从外发公开消息中剔除私有 floor token（镜像 negotiation-chat.redactPrivateFloor
+ * 的纯函数语义；复制避免 a2a→agent 跨树 import）。floor 是私有值，绝不出现在
+ * 商家对外公开回复里。
+ */
+export function redactPublicMessage(text, floor) {
+    if (floor === undefined || floor <= 0)
+        return text;
+    return text.split(String(floor)).join("[private-floor]");
+}
+//# sourceMappingURL=decision-backend.js.map

package/dist/merchant/decision-backend.js.map

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

package/dist/product-cli.d.ts

@@ -42,7 +42,7 @@ export declare const DEFAULT_PROFILE_PATH: string;
  */
 export declare function writeDefaultProfile(yaml: string, profilePath?: string): void;
 /** 与 package.json / USAGE 同步的产品版本。 */
-export declare const PRODUCT_VERSION = "0.7.10";
+export declare const PRODUCT_VERSION = "0.7.11";
 /**
  * 缺省 kiwi-catalog 地址（单一来源，cli.ts 各处解析一致）。
  *

package/dist/product-cli.js

@@ -51,7 +51,7 @@ export function writeDefaultProfile(yaml, profilePath) {
     writeFileSync(target, yaml, { mode: 0o600 });
 }
 /** 与 package.json / USAGE 同步的产品版本。 */
-export const PRODUCT_VERSION = "0.7.10";
+export const PRODUCT_VERSION = "0.7.11";
 /**
  * 缺省 kiwi-catalog 地址（单一来源，cli.ts 各处解析一致）。
  *

package/examples/profiles/merchant.deepseek.yaml

@@ -15,6 +15,11 @@ model:
   provider: deepseek
   model: deepseek-v4-flash
   api_key_env: DEEPSEEK_API_KEY
+# DeepSeek Harness 运行时插件（§6.9）：DeepSeek 作为受限推理后端产出不可信
+# 决策候选，merchant handler 验证 + floor/discount 硬约束后应用；backend 从不写。
+decision:
+  backend: deepseek
+  enabled: true
 runtime:
   mode: once
   poll_interval_seconds: 5

package/examples/profiles/merchant.fake.yaml

@@ -14,6 +14,10 @@ commerce:
 model:
   provider: fake
   model: fake-merchant-model
+# 离线冒烟：确定性 mock 推理后端（不依赖模型/密钥）。
+decision:
+  backend: mock
+  enabled: true
 runtime:
   mode: once
   poll_interval_seconds: 5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harrylabsj/kiwi",
-  "version": "0.7.10",
+  "version": "0.7.11",
   "description": "Kiwi: standalone A2A commerce negotiation agent runtime (Pi Agent Core + shopping-cli Commerce API)",
   "type": "module",
   "license": "Apache-2.0",