@harrylabsj/kiwi 0.6.0

package/dist/protocol/legacy-shopping-negotiation/types.js

@@ -0,0 +1,34 @@
+/**
+ * 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.
+ */
+export function translated(value, notes) {
+    return { translated: value, notes };
+}
+export function failClosed(reason) {
+    return { fail_closed: true, reason };
+}
+export function requiresHuman(reason) {
+    return { requires_human: true, reason };
+}
+export function isTranslated(r) {
+    return "translated" in r;
+}
+/**
+ * KNP → legacy 方向无需额外上下文：legacy decision 的网关派生字段
+ * （retries_remaining、actor 等）不属于转译范围 —— KNP 侧的 actor 语义通过
+ * note 显式交给传输层断言（identity，绝不静默丢），其余 KNP-only 字段逐条
+ * 记录为 dropped note。
+ */
+//# sourceMappingURL=types.js.map

package/dist/protocol/legacy-shopping-negotiation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/protocol/legacy-shopping-negotiation/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAyCH,MAAM,UAAU,UAAU,CAAI,KAAQ,EAAE,KAAwB;IAC9D,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,YAAY,CAAI,CAAuB;IACrD,OAAO,YAAY,IAAI,CAAC,CAAC;AAC3B,CAAC;AAmCD;;;;;GAKG"}

package/dist/runtime/buyer-policy.d.ts

@@ -0,0 +1,58 @@
+/**
+ * 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.
+ */
+/**
+ * Buyer-side LOCAL private policy gate (design §7.2, §16.3).
+ *
+ * The buyer's private budget lives only in the Kiwi profile; the marketplace
+ * never sees it and never checks it (shopping-cli's buyer gate is structural
+ * only). This module enforces the private policy inside the submit tool,
+ * BEFORE anything reaches the gateway:
+ *
+ * - proposal total (unit_price * quantity + delivery fee) must not exceed
+ *   max_total_price_private;
+ * - proposal delivery eta_end must not be later than acceptable_eta_latest;
+ * - every required_after_sales_terms entry must be referenced by the
+ *   accepted/issued proposal;
+ * - public_message must not leak the private budget: explicit budget talk
+ *   ("我的预算" / "最高预算" / "内部预算" / "budget" …) is rejected locally.
+ *   A plain quote that happens to equal the budget is fine — the number
+ *   alone is not a leak; calling it a budget is.
+ *
+ * Privacy invariant: rejection reasons NEVER contain the private threshold
+ * value. The value is not logged, not sent to the gateway, and not echoed
+ * back to the model.
+ */
+import type { BuyerPolicy } from "../config/profile.js";
+import type { NegotiationDecision, PolicyResult } from "../negotiation/types.js";
+export interface BuyerPolicyViolation {
+    reason_codes: string[];
+    /** Safe to show the model and to log: never contains private numbers. */
+    public_reason: string;
+}
+/** Total price of a proposal: goods plus delivery fee. */
+export declare function proposalTotal(decision: NegotiationDecision): number | undefined;
+/**
+ * Check a decision against the local buyer policy. Returns undefined when
+ * the decision may go to the gateway, or a violation describing the first
+ * problem found (without any private values).
+ */
+export declare function checkBuyerLocalPolicy(decision: NegotiationDecision, policy: BuyerPolicy): BuyerPolicyViolation | undefined;
+/**
+ * Build the local policy_result for a violated decision. Shaped like the
+ * frozen PolicyResult so the agent loop can handle it uniformly; it is
+ * produced locally and never touches the gateway.
+ */
+export declare function localBuyerPolicyResult(conversationId: string, violation: BuyerPolicyViolation, retriesRemaining: number): PolicyResult;

package/dist/runtime/buyer-policy.js

@@ -0,0 +1,89 @@
+/**
+ * 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 { PROTOCOL_VERSION } from "../negotiation/types.js";
+/**
+ * Budget-threshold wording. A public message using these phrases is treated
+ * as leaking the private budget regardless of whether a number appears.
+ */
+const BUDGET_LEAK_PATTERN = /(我的|最高|最大|内部|私有|心里)?预算|预算上限|budget|price\s*ceiling|max(imum)?\s*budget/i;
+/** Total price of a proposal: goods plus delivery fee. */
+export function proposalTotal(decision) {
+    const p = decision.proposal;
+    if (!p)
+        return undefined;
+    return p.unit_price * p.quantity + p.delivery.fee;
+}
+/**
+ * Check a decision against the local buyer policy. Returns undefined when
+ * the decision may go to the gateway, or a violation describing the first
+ * problem found (without any private values).
+ */
+export function checkBuyerLocalPolicy(decision, policy) {
+    // 1. Private-budget leak scan applies to every action with public text.
+    if (BUDGET_LEAK_PATTERN.test(decision.public_message)) {
+        return {
+            reason_codes: ["local_budget_leak"],
+            public_reason: "公开文本出现预算类措辞，可能泄露私有预算约束。请删除任何关于预算/上限的表述后重试。",
+        };
+    }
+    const proposal = decision.proposal;
+    if (!proposal)
+        return undefined;
+    // 2. Private budget: total price must fit the private maximum.
+    const total = proposalTotal(decision);
+    if (total !== undefined && total > policy.max_total_price_private) {
+        return {
+            reason_codes: ["local_budget_exceeded"],
+            public_reason: "该报价总价超出你的私有预算约束。请还价、放弃（decline）或转人工（escalate），不要透露预算数值。",
+        };
+    }
+    // 3. Delivery ETA must be acceptable.
+    const etaEnd = Date.parse(proposal.delivery.eta_end);
+    const latest = Date.parse(policy.acceptable_eta_latest);
+    if (!Number.isNaN(etaEnd) && !Number.isNaN(latest) && etaEnd > latest) {
+        return {
+            reason_codes: ["local_eta_violation"],
+            public_reason: "该报价的配送预计送达时间晚于你可接受的最晚时间。请要求更快的配送、放弃或转人工。",
+        };
+    }
+    // 4. Required after-sales terms must all be referenced.
+    const refs = new Set(proposal.after_sales_policy_refs);
+    const missing = policy.required_after_sales_terms.filter((term) => !refs.has(term));
+    if (missing.length > 0) {
+        return {
+            reason_codes: ["local_missing_after_sales_terms"],
+            public_reason: `该报价缺少必需的售后条款: ${missing.join(", ")}。请要求对方加入这些条款、放弃或转人工。`,
+        };
+    }
+    return undefined;
+}
+/**
+ * Build the local policy_result for a violated decision. Shaped like the
+ * frozen PolicyResult so the agent loop can handle it uniformly; it is
+ * produced locally and never touches the gateway.
+ */
+export function localBuyerPolicyResult(conversationId, violation, retriesRemaining) {
+    return {
+        protocol_version: PROTOCOL_VERSION,
+        result: "rejected_retryable",
+        conversation_id: conversationId,
+        next_actor: "buyer",
+        reason_codes: violation.reason_codes,
+        public_reason: violation.public_reason,
+        retries_remaining: Math.max(0, retriesRemaining),
+    };
+}
+//# sourceMappingURL=buyer-policy.js.map

package/dist/runtime/buyer-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buyer-policy.js","sourceRoot":"","sources":["../../src/runtime/buyer-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA2BH,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAQ3D;;;GAGG;AACH,MAAM,mBAAmB,GACvB,yEAAyE,CAAC;AAE5E,0DAA0D;AAC1D,MAAM,UAAU,aAAa,CAAC,QAA6B;IACzD,MAAM,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAC5B,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,OAAO,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAA6B,EAC7B,MAAmB;IAEnB,wEAAwE;IACxE,IAAI,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QACtD,OAAO;YACL,YAAY,EAAE,CAAC,mBAAmB,CAAC;YACnC,aAAa,EACX,4CAA4C;SAC/C,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;IACnC,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEhC,+DAA+D;IAC/D,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,GAAG,MAAM,CAAC,uBAAuB,EAAE,CAAC;QAClE,OAAO;YACL,YAAY,EAAE,CAAC,uBAAuB,CAAC;YACvC,aAAa,EACX,yDAAyD;SAC5D,CAAC;IACJ,CAAC;IAED,sCAAsC;IACtC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,MAAM,EAAE,CAAC;QACtE,OAAO;YACL,YAAY,EAAE,CAAC,qBAAqB,CAAC;YACrC,aAAa,EACX,0CAA0C;SAC7C,CAAC;IACJ,CAAC;IAED,wDAAwD;IACxD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,MAAM,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACpF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,YAAY,EAAE,CAAC,iCAAiC,CAAC;YACjD,aAAa,EAAE,iBAAiB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB;SACzE,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,cAAsB,EACtB,SAA+B,EAC/B,gBAAwB;IAExB,OAAO;QACL,gBAAgB,EAAE,gBAAgB;QAClC,MAAM,EAAE,oBAAoB;QAC5B,eAAe,EAAE,cAAc;QAC/B,UAAU,EAAE,OAAO;QACnB,YAAY,EAAE,SAAS,CAAC,YAAY;QACpC,aAAa,EAAE,SAAS,CAAC,aAAa;QACtC,iBAAiB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,gBAAgB,CAAC;KACjD,CAAC;AACJ,CAAC"}

package/dist/runtime/fake-model.d.ts

@@ -0,0 +1,77 @@
+/**
+ * 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 fake models — no network, no keys, fully reproducible.
+ *
+ * Two flavors:
+ * - createScriptedFakeStreamFn: replays canned assistant messages (tests).
+ * - createDeterministicStreamFn: tiny rule-based buyer/merchant "models"
+ *   used by profiles with model.provider=fake. They read the snapshot from
+ *   the tool result and produce a deterministic decision, enabling offline
+ *   smoke runs of the full single-turn vertical slice for both roles.
+ */
+import { type FauxProviderHandle, type FauxResponseStep } from "@earendil-works/pi-ai";
+import type { StreamFn } from "@earendil-works/pi-agent-core";
+import type { AgentProfile } from "../config/profile.js";
+import { type NegotiationDecision, type NegotiationSnapshot } from "../negotiation/types.js";
+export interface ScriptedFake {
+    streamFn: StreamFn;
+    handle: FauxProviderHandle;
+}
+/** Replay canned responses in order. Used by tests. */
+export declare function createScriptedFakeStreamFn(responses: FauxResponseStep[]): ScriptedFake;
+/**
+ * Structured influence of applied operator strategy directives on candidate
+ * generation (docs/operator-tui-v0.2.md §7). Compiled by the operator runner
+ * from the session's directive list; never widens HardPolicy by itself — the
+ * authoritative policy gates still run on the profile at submit time.
+ */
+export interface DecisionHints {
+    /** Effective buyer budget ceiling (last budget directive, else profile). */
+    buyer_max_total_price?: number;
+    /** Per-unit buyer budget ("单价预算 94"); the decision derives the total. */
+    buyer_max_unit_price?: number;
+    /** Effective merchant floor (last floor directive, else profile). */
+    merchant_min_unit_price?: number;
+    /** Quantity cap ("最多买 N 件"). */
+    quantity_cap?: number;
+    /** Buyer target unit price: counter toward this before accepting ("砍到 100"). */
+    buyer_target_unit_price?: number;
+    /** Prefer free shipping: counter with fee 0 before accepting. */
+    prefer_free_shipping?: boolean;
+    /** This turn only asks; never accept or counter with a price. */
+    ask_only?: boolean;
+}
+/** Build the deterministic decision from a snapshot. Pure function. */
+export declare function deterministicMerchantDecision(snapshot: NegotiationSnapshot, quoteTtlSeconds: number, hints?: DecisionHints): NegotiationDecision;
+/**
+ * Rule-based fake merchant model for offline smoke runs. First call fetches
+ * the snapshot; second call submits a deterministic decision derived from it.
+ */
+export declare function createDeterministicMerchantStreamFn(profile: AgentProfile): StreamFn;
+/** Build the deterministic buyer decision from a snapshot. Pure function. */
+export declare function deterministicBuyerDecision(snapshot: NegotiationSnapshot, policy: {
+    max_total_price_private: number;
+    acceptable_eta_latest: string;
+    required_after_sales_terms: string[];
+}, hints?: DecisionHints): NegotiationDecision;
+/**
+ * Rule-based fake buyer model for offline smoke runs. Reads the snapshot,
+ * then deterministically accepts an acceptable offer or escalates.
+ */
+export declare function createDeterministicBuyerStreamFn(profile: AgentProfile): StreamFn;
+/** Role-dispatching deterministic fake: merchant or buyer, driven by the profile. */
+export declare function createDeterministicStreamFn(profile: AgentProfile): StreamFn;

package/dist/runtime/fake-model.js

@@ -0,0 +1,307 @@
+/**
+ * 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 fake models — no network, no keys, fully reproducible.
+ *
+ * Two flavors:
+ * - createScriptedFakeStreamFn: replays canned assistant messages (tests).
+ * - createDeterministicStreamFn: tiny rule-based buyer/merchant "models"
+ *   used by profiles with model.provider=fake. They read the snapshot from
+ *   the tool result and produce a deterministic decision, enabling offline
+ *   smoke runs of the full single-turn vertical slice for both roles.
+ */
+import { fauxAssistantMessage, fauxProvider, fauxToolCall, } from "@earendil-works/pi-ai";
+import { PROTOCOL_VERSION, } from "../negotiation/types.js";
+import { TOOL_GET_SNAPSHOT, TOOL_SUBMIT_DECISION } from "./tools.js";
+/** Replay canned responses in order. Used by tests. */
+export function createScriptedFakeStreamFn(responses) {
+    const handle = fauxProvider({ models: [{ id: "fake-model", name: "fake-model" }] });
+    handle.setResponses(responses);
+    const streamFn = (model, context, options) => handle.provider.streamSimple(model, context, options);
+    return { streamFn, handle };
+}
+/** Extract the latest tool result text for a tool from the LLM context. */
+function latestToolResultText(context, toolName) {
+    for (let i = context.messages.length - 1; i >= 0; i--) {
+        const m = context.messages[i];
+        if (m && m.role === "toolResult" && m.toolName === toolName) {
+            const first = m.content[0];
+            if (first && first.type === "text")
+                return first.text;
+        }
+    }
+    return undefined;
+}
+/** Build the deterministic decision from a snapshot. Pure function. */
+export function deterministicMerchantDecision(snapshot, quoteTtlSeconds, hints = {}) {
+    const p = snapshot.product;
+    const buyerText = snapshot.messages
+        .filter((m) => m.sender_role === "buyer")
+        .map((m) => m.public_message)
+        .join("\n");
+    const qtyMatch = /(\d+)\s*(?:件|个|只|x\b)/i.exec(buyerText);
+    const quantity = Math.min(Math.max(Number(qtyMatch?.[1] ?? 1), 1), snapshot.stock.quantity || 1, hints.quantity_cap ?? Number.POSITIVE_INFINITY);
+    const validUntil = new Date(Date.parse(snapshot.stock.observed_at) + quoteTtlSeconds * 1000).toISOString();
+    // A floor directive above the list price raises the quote; at or below it
+    // the list price already satisfies the floor, so the quote is unchanged.
+    const unitPrice = hints.merchant_min_unit_price !== undefined && hints.merchant_min_unit_price > p.list_price
+        ? hints.merchant_min_unit_price
+        : p.list_price;
+    if (snapshot.stock.status === "out_of_stock") {
+        return {
+            protocol_version: PROTOCOL_VERSION,
+            conversation_id: snapshot.conversation.id,
+            in_reply_to_message_id: snapshot.in_reply_to_message_id,
+            action: "decline",
+            open_issues: ["out_of_stock"],
+            public_message: "抱歉，该商品当前缺货，无法报价。",
+            confidence: 0.99,
+            reason_codes: ["out_of_stock"],
+            request_human_review: false,
+        };
+    }
+    // Convergence: accept the buyer's latest counter when it meets the merchant
+    // floor — otherwise the merchant would re-quote the list price forever and
+    // the autonomous negotiation never closes.
+    const floor = hints.merchant_min_unit_price;
+    const buyerProposal = snapshot.current_proposal;
+    if (floor !== undefined && buyerProposal !== null && buyerProposal !== undefined && buyerProposal.unit_price >= floor) {
+        return {
+            protocol_version: PROTOCOL_VERSION,
+            conversation_id: snapshot.conversation.id,
+            in_reply_to_message_id: snapshot.in_reply_to_message_id,
+            action: "accept_nonbinding",
+            proposal: buyerProposal,
+            open_issues: [...snapshot.open_issues],
+            public_message: "接受该报价，双方达成非约束性共识。",
+            confidence: 0.9,
+            reason_codes: ["within_policy", "consensus"],
+            request_human_review: false,
+        };
+    }
+    return {
+        protocol_version: PROTOCOL_VERSION,
+        conversation_id: snapshot.conversation.id,
+        in_reply_to_message_id: snapshot.in_reply_to_message_id,
+        action: "counter",
+        proposal: {
+            sku: p.sku,
+            quantity,
+            unit_price: unitPrice,
+            currency: p.currency,
+            stock: {
+                status: snapshot.stock.status,
+                quantity: snapshot.stock.quantity,
+                observed_at: snapshot.stock.observed_at,
+                reserved: false,
+            },
+            delivery: {
+                eta_start: snapshot.delivery.eta_start,
+                eta_end: snapshot.delivery.eta_end,
+                fee: snapshot.delivery.fee,
+            },
+            after_sales_policy_refs: snapshot.after_sales_policies.map((pol) => pol.ref),
+            valid_until: validUntil,
+        },
+        open_issues: [...snapshot.open_issues],
+        public_message: `可以按单价 ${unitPrice} ${p.currency} 提供 ${quantity} 件，报价 ${quoteTtlSeconds} 秒内有效。`,
+        confidence: 0.9,
+        reason_codes: ["within_policy", "inventory_observed"],
+        request_human_review: false,
+    };
+}
+/**
+ * Rule-based fake merchant model for offline smoke runs. First call fetches
+ * the snapshot; second call submits a deterministic decision derived from it.
+ */
+export function createDeterministicMerchantStreamFn(profile) {
+    const handle = fauxProvider({
+        models: [{ id: "fake-merchant-model", name: "fake-merchant-model" }],
+    });
+    const quoteTtl = profile.merchant_policy?.quote_ttl_seconds ?? 300;
+    handle.setResponses([
+        (context) => {
+            const snapshotText = latestToolResultText(context, TOOL_GET_SNAPSHOT);
+            if (snapshotText === undefined) {
+                return fauxAssistantMessage([fauxToolCall(TOOL_GET_SNAPSHOT, {})]);
+            }
+            const snapshot = JSON.parse(snapshotText);
+            const decision = deterministicMerchantDecision(snapshot, quoteTtl);
+            return fauxAssistantMessage([fauxToolCall(TOOL_SUBMIT_DECISION, { ...decision })]);
+        },
+        // Safety net if the first response was consumed by a retry.
+        (context) => {
+            const snapshotText = latestToolResultText(context, TOOL_GET_SNAPSHOT);
+            if (snapshotText === undefined) {
+                return fauxAssistantMessage([fauxToolCall(TOOL_GET_SNAPSHOT, {})]);
+            }
+            const snapshot = JSON.parse(snapshotText);
+            const decision = deterministicMerchantDecision(snapshot, quoteTtl);
+            return fauxAssistantMessage([fauxToolCall(TOOL_SUBMIT_DECISION, { ...decision })]);
+        },
+    ]);
+    return (model, context, options) => handle.provider.streamSimple(model, context, options);
+}
+/** Build the deterministic buyer decision from a snapshot. Pure function. */
+export function deterministicBuyerDecision(snapshot, policy, hints = {}) {
+    const base = {
+        protocol_version: PROTOCOL_VERSION,
+        conversation_id: snapshot.conversation.id,
+        in_reply_to_message_id: snapshot.in_reply_to_message_id,
+    };
+    const proposal = snapshot.current_proposal;
+    if (!proposal) {
+        return {
+            ...base,
+            action: "ask",
+            open_issues: ["no_proposal"],
+            public_message: "请提供包含价格、配送与售后条款的完整报价。",
+            confidence: 0.8,
+            reason_codes: ["no_proposal"],
+            request_human_review: false,
+        };
+    }
+    // Turn-scoped ask-only directive: this turn asks, never accepts or counters
+    // with a price (design §7.3 example: "这一轮只问交期，不接受报价").
+    if (hints.ask_only) {
+        return {
+            ...base,
+            action: "ask",
+            open_issues: ["turn_ask_only"],
+            public_message: "请先确认交付时间与售后条款。",
+            confidence: 0.8,
+            reason_codes: ["turn_ask_only"],
+            request_human_review: false,
+        };
+    }
+    // A quantity cap ("最多买 N 件") re-scopes the check to the capped size.
+    const capped = hints.quantity_cap !== undefined && proposal.quantity > hints.quantity_cap
+        ? { ...proposal, quantity: hints.quantity_cap }
+        : proposal;
+    // Total budget: explicit total, else per-unit × quantity, else profile.
+    const maxTotal = hints.buyer_max_total_price ??
+        (hints.buyer_max_unit_price !== undefined
+            ? hints.buyer_max_unit_price * capped.quantity
+            : policy.max_total_price_private);
+    const fee = capped.delivery.fee;
+    const etaOk = Date.parse(proposal.delivery.eta_end) <= Date.parse(policy.acceptable_eta_latest);
+    const refs = new Set(proposal.after_sales_policy_refs);
+    const termsOk = policy.required_after_sales_terms.every((t) => refs.has(t));
+    // Counter toward the target / affordable unit price FIRST — a buyer who
+    // sees an over-budget offer should push the price down, not give up. Bounded
+    // by the per-unit budget and the total budget.
+    const targetPrice = hints.buyer_target_unit_price;
+    const perUnitBudget = hints.buyer_max_unit_price ?? maxTotal / capped.quantity;
+    const desiredUnit = targetPrice !== undefined ? Math.min(targetPrice, perUnitBudget) : undefined;
+    if (desiredUnit !== undefined &&
+        desiredUnit < capped.unit_price &&
+        desiredUnit * capped.quantity + fee <= maxTotal) {
+        return {
+            ...base,
+            action: "counter",
+            proposal: { ...capped, unit_price: desiredUnit },
+            open_issues: [...snapshot.open_issues],
+            public_message: `单价 ${desiredUnit} ${proposal.currency}（${capped.quantity} 件）我可以接受，请确认。`,
+            confidence: 0.9,
+            reason_codes: ["within_policy", "target_price"],
+            request_human_review: false,
+        };
+    }
+    // Hard constraints: if the offer still doesn't fit, escalate — never reveal
+    // why in numeric terms (the private budget must not leak).
+    const total = capped.unit_price * capped.quantity + fee;
+    if (total > maxTotal || !etaOk || !termsOk) {
+        return {
+            ...base,
+            action: "escalate",
+            open_issues: ["offer_outside_constraints"],
+            public_message: "该报价需要人工确认后才能继续。",
+            confidence: 0.7,
+            reason_codes: ["human_review"],
+            request_human_review: true,
+        };
+    }
+    // Soft preference: fight for free shipping before accepting a fee-bearing
+    // offer ("先争取包邮").
+    if (hints.prefer_free_shipping && proposal.delivery.fee > 0) {
+        return {
+            ...base,
+            action: "counter",
+            proposal: { ...proposal, delivery: { ...proposal.delivery, fee: 0 } },
+            open_issues: [...snapshot.open_issues],
+            public_message: "如果免运费（包邮），我可以接受当前报价。",
+            confidence: 0.8,
+            reason_codes: ["within_policy", "shipping_discussed"],
+            request_human_review: false,
+        };
+    }
+    // Quantity cap: accept at most the capped quantity.
+    if (capped !== proposal) {
+        return {
+            ...base,
+            action: "counter",
+            proposal: capped,
+            open_issues: [...snapshot.open_issues],
+            public_message: `按 ${hints.quantity_cap} 件以内我可以接受，请确认。`,
+            confidence: 0.8,
+            reason_codes: ["within_policy", "quantity_capped"],
+            request_human_review: false,
+        };
+    }
+    return {
+        ...base,
+        action: "accept_nonbinding",
+        proposal,
+        open_issues: [],
+        public_message: "接受该报价，双方达成非约束性共识。",
+        confidence: 0.9,
+        reason_codes: ["within_policy"],
+        request_human_review: false,
+    };
+}
+/**
+ * Rule-based fake buyer model for offline smoke runs. Reads the snapshot,
+ * then deterministically accepts an acceptable offer or escalates.
+ */
+export function createDeterministicBuyerStreamFn(profile) {
+    const handle = fauxProvider({
+        models: [{ id: "fake-buyer-model", name: "fake-buyer-model" }],
+    });
+    const policy = profile.buyer_policy ?? {
+        max_total_price_private: Number.POSITIVE_INFINITY,
+        acceptable_eta_latest: "9999-12-31T23:59:59Z",
+        required_after_sales_terms: [],
+    };
+    const respond = (context) => {
+        const snapshotText = latestToolResultText(context, TOOL_GET_SNAPSHOT);
+        if (snapshotText === undefined) {
+            return fauxAssistantMessage([fauxToolCall(TOOL_GET_SNAPSHOT, {})]);
+        }
+        const snapshot = JSON.parse(snapshotText);
+        const decision = deterministicBuyerDecision(snapshot, policy);
+        return fauxAssistantMessage([fauxToolCall(TOOL_SUBMIT_DECISION, { ...decision })]);
+    };
+    // Second entry is a safety net if the first response was consumed by a retry.
+    handle.setResponses([respond, respond]);
+    return (model, context, options) => handle.provider.streamSimple(model, context, options);
+}
+/** Role-dispatching deterministic fake: merchant or buyer, driven by the profile. */
+export function createDeterministicStreamFn(profile) {
+    return profile.role === "buyer"
+        ? createDeterministicBuyerStreamFn(profile)
+        : createDeterministicMerchantStreamFn(profile);
+}
+//# sourceMappingURL=fake-model.js.map

package/dist/runtime/fake-model.js.map

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

package/dist/runtime/foreground.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 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.
+ */
+/**
+ * Foreground polling loop (design §12.2).
+ *
+ * Serially runs negotiation turns for one profile — the same profile never
+ * runs two turns concurrently. no_work waits poll_interval_seconds;
+ * transient errors back off exponentially with a bounded cap and the loop
+ * continues. SIGINT/SIGTERM (an AbortSignal) aborts the in-flight turn —
+ * the turn itself settles its claim (abandon, never complete) — and the
+ * loop then exits cleanly.
+ *
+ * The loop never logs secrets or private policy values: turn reports carry
+ * only public policy reasons and usage counters.
+ */
+import type { StreamFn } from "@earendil-works/pi-agent-core";
+import type { AgentProfile } from "../config/profile.js";
+import { type CommerceClient } from "../commerce/types.js";
+import { type TurnReport } from "./negotiation-turn.js";
+/** Upper bound for the transient-error backoff (ms). */
+export declare const MAX_BACKOFF_MS = 60000;
+export type Sleeper = (ms: number, signal?: AbortSignal) => Promise<void>;
+/** Default sleeper: resolves early (without throwing) when aborted. */
+export declare const defaultSleeper: Sleeper;
+export interface ForegroundOptions {
+    profile: AgentProfile;
+    client: CommerceClient;
+    streamFn: StreamFn;
+    getApiKey?: () => string | undefined;
+    /** External shutdown signal (SIGINT/SIGTERM). */
+    signal?: AbortSignal;
+    /** Injectable sleeper for tests; defaults to real timers. */
+    sleep?: Sleeper;
+    /** Called with each finished turn report (CLI writes JSONL here). */
+    onReport?: (report: TurnReport) => void;
+    /** Optional bound on turns, for tests and smoke runs. */
+    maxTurns?: number;
+}
+export interface ForegroundResult {
+    turns: number;
+    stopped_by: "signal" | "max_turns";
+}
+export declare function runForeground(options: ForegroundOptions): Promise<ForegroundResult>;