@harrylabsj/kiwi 0.6.0

package/dist/commerce/fake-client.js

@@ -0,0 +1,549 @@
+/**
+ * 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.
+ */
+/**
+ * FakeCommerceClient — deterministic, in-memory implementation of the
+ * CommerceClient interface with LocalMarketplace semantics, for both roles.
+ *
+ * Exists so tests and local development never depend on a real model or a
+ * running shopping-cli service. It enforces a representative subset of the
+ * authoritative server-side policy gate: schema validation, next_actor
+ * routing, claim binding, SKU/quantity facts, merchant private price floor,
+ * policy-ref validity, private-threshold leakage scan, idempotent submit,
+ * and the no-order boundary. The buyer's private budget is NOT here — like
+ * the real gateway, the fake never sees it; it is enforced locally inside
+ * the Kiwi submit tool (runtime/buyer-policy.ts).
+ *
+ * Each client instance is bound to a token-derived identity (role + owner),
+ * mirroring the real API where the Bearer token determines the actor. Two
+ * clients can share one marketplace state (createFakeMarketplace) so buyer
+ * and merchant agents can alternate turns in-process.
+ */
+import { validateAgainst } from "../contracts/schemas.js";
+import { PROTOCOL_VERSION, } from "../negotiation/types.js";
+import { CommerceError, } from "./types.js";
+const RETRYABLE = new Set(["failed", "abandoned"]);
+function conversationIdOf(config) {
+    return `conv-${config.merchant_id}`;
+}
+function initialState(config) {
+    const state = {
+        conversationStatus: "waiting_merchant",
+        messageSeq: 0,
+        msgs: [],
+        claims: new Map(),
+        submissions: new Map(),
+        audit: [],
+        openIssues: [],
+        currentProposal: null,
+    };
+    const text = config.buyer_message_text ?? "买 2 件可以便宜一点吗？";
+    state.messageSeq += 1;
+    state.msgs.push({
+        id: state.messageSeq,
+        conversation_id: conversationIdOf(config),
+        sender_role: "buyer",
+        created_at: config.now ?? "2026-08-03T15:00:00+08:00",
+        action: "ask",
+        public_message: text,
+    });
+    return state;
+}
+/** One marketplace with both role clients bound to it (buyer + merchant). */
+export function createFakeMarketplace(config) {
+    const state = initialState(config);
+    return {
+        state,
+        merchant: new FakeCommerceClient(config, {
+            identity: { role: "merchant", owner_id: config.merchant_id },
+            state,
+        }),
+        buyer: new FakeCommerceClient(config, {
+            identity: { role: "buyer", owner_id: config.buyer_id },
+            state,
+        }),
+    };
+}
+export class FakeCommerceClient {
+    config;
+    identity;
+    now;
+    maxRetries;
+    stockTtlMs;
+    state;
+    constructor(config, options) {
+        this.config = config;
+        this.identity = options?.identity ?? { role: "merchant", owner_id: config.merchant_id };
+        this.state = options?.state ?? initialState(config);
+        this.now = config.now ?? "2026-08-03T15:00:00+08:00";
+        this.maxRetries = config.max_retries ?? 2;
+        this.stockTtlMs = config.stock_ttl_ms ?? 3_600_000;
+    }
+    get counterpart() {
+        return this.identity.role === "merchant" ? "buyer" : "merchant";
+    }
+    /** Server-style claim identity, e.g. shopping-cli-merchant-agent:merchant-001. */
+    get agentId() {
+        return `shopping-cli-${this.identity.role}-agent:${this.identity.owner_id}`;
+    }
+    /** Test helper: advance the fake clock deterministically (stale-claim tests). */
+    advanceTime(ms) {
+        this.now = new Date(Date.parse(this.now) + ms).toISOString();
+    }
+    get waitingStatus() {
+        return this.identity.role === "merchant" ? "waiting_merchant" : "waiting_buyer";
+    }
+    // ---- test inspection helpers -------------------------------------------
+    auditEvents() {
+        return this.state.audit;
+    }
+    messages() {
+        return this.state.msgs;
+    }
+    conversationState() {
+        return { status: this.state.conversationStatus, open_issues: [...this.state.openIssues] };
+    }
+    /** Test inspection: current process status of a claim, if any. */
+    claimStatus(messageId) {
+        return this.state.claims.get(messageId)?.status;
+    }
+    record(event, details) {
+        this.state.audit.push({
+            event,
+            conversation_id: this.conversationId,
+            actor: `${this.identity.role}:${this.identity.owner_id}`,
+            details: { schema_version: 1, event_type: event, ...details },
+            created_at: this.now,
+        });
+    }
+    get conversationId() {
+        return conversationIdOf(this.config);
+    }
+    appendMessage(sender, text, extra = {}) {
+        this.state.messageSeq += 1;
+        const msg = {
+            id: this.state.messageSeq,
+            conversation_id: this.conversationId,
+            sender_role: sender,
+            created_at: this.now,
+            public_message: text,
+        };
+        if (extra.action !== undefined)
+            msg.action = extra.action;
+        if (extra.proposal !== undefined)
+            msg.proposal = extra.proposal;
+        this.state.msgs.push(msg);
+        return msg;
+    }
+    // ---- CommerceClient -----------------------------------------------------
+    health() {
+        return Promise.resolve({
+            ok: true,
+            service: "kiwi-fake-marketplace",
+            version: "0.5.0",
+            details: { storage: "in-memory" },
+        });
+    }
+    getCapabilities() {
+        return Promise.resolve({
+            protocol_versions: [PROTOCOL_VERSION],
+            backend: "local_marketplace",
+            capabilities: {
+                catalog_read: true,
+                inventory_read: true,
+                consultation_read: true,
+                consultation_write: true,
+                price_negotiate: true,
+                webhook: false,
+                orders: false,
+            },
+        });
+    }
+    listPendingMessages() {
+        const expectedOwner = this.identity.role === "merchant" ? this.config.merchant_id : this.config.buyer_id;
+        if (this.identity.owner_id !== expectedOwner)
+            return Promise.resolve([]);
+        if (this.state.conversationStatus !== this.waitingStatus)
+            return Promise.resolve([]);
+        const last = this.state.msgs[this.state.msgs.length - 1];
+        if (!last || last.sender_role !== this.counterpart)
+            return Promise.resolve([]);
+        // A message under an active (processing) claim is not pending work:
+        // without this, two same-identity workers would both see it and both
+        // proceed. Settled claims (failed/abandoned/processed) stay listed —
+        // failed/abandoned are reclaimable, processed follows the real
+        // gateway's reply-based listing.
+        if (this.state.claims.get(last.id)?.status === "processing")
+            return Promise.resolve([]);
+        return Promise.resolve([
+            {
+                conversation_id: this.conversationId,
+                message_id: last.id,
+                conversation_status: this.state.conversationStatus,
+                sender_role: this.counterpart,
+                preview: last.public_message,
+                created_at: last.created_at,
+            },
+        ]);
+    }
+    claimMessage(input) {
+        if (input.conversation_id !== this.conversationId) {
+            return Promise.reject(new CommerceError("not_found", `Unknown conversation ${input.conversation_id}`, 404));
+        }
+        const msg = this.state.msgs.find((m) => m.id === input.message_id);
+        const last = this.state.msgs[this.state.msgs.length - 1];
+        if (!msg || msg.sender_role !== this.counterpart || last?.id !== msg.id) {
+            return Promise.reject(new CommerceError("validation", `Message ${input.message_id} is not a claimable ${this.counterpart} message`, 400));
+        }
+        const existing = this.state.claims.get(input.message_id);
+        if (existing) {
+            // Contract (commerce/types.ts): a non-retryable existing claim returns
+            // claimed=false. This holds even for a same-key replay while the claim
+            // is still processing — the key is deterministic
+            // (agent_id:message_id:protocol), so two same-identity workers produce
+            // the same key and must never both be told they hold the claim.
+            if (!RETRYABLE.has(existing.status)) {
+                return Promise.resolve({
+                    claimed: false,
+                    status: existing.status,
+                    attempts: existing.attempts,
+                    idempotency_key: existing.idempotency_key,
+                });
+            }
+            // failed/abandoned are reclaimable — including under the same
+            // deterministic key, which is exactly how a retrying worker reclaims.
+            existing.status = "processing";
+            existing.attempts += 1;
+            existing.idempotency_key = input.idempotency_key;
+            existing.agent_id = this.agentId;
+            existing.updated_at = this.now;
+            delete existing.last_error;
+            this.record("agent_message_claimed", {
+                message_id: input.message_id,
+                attempts: existing.attempts,
+            });
+            return Promise.resolve({
+                claimed: true,
+                status: "processing",
+                attempts: existing.attempts,
+                idempotency_key: existing.idempotency_key,
+            });
+        }
+        const row = {
+            message_id: input.message_id,
+            agent_id: this.agentId,
+            idempotency_key: input.idempotency_key,
+            status: "processing",
+            attempts: 1,
+            updated_at: this.now,
+        };
+        this.state.claims.set(input.message_id, row);
+        this.record("agent_message_claimed", { message_id: input.message_id, attempts: 1 });
+        return Promise.resolve({
+            claimed: true,
+            status: "processing",
+            attempts: 1,
+            idempotency_key: input.idempotency_key,
+        });
+    }
+    requireClaim(messageId) {
+        const claim = this.state.claims.get(messageId);
+        // Like the real gateway, another identity's claim is invisible (404).
+        if (!claim || claim.agent_id !== this.agentId) {
+            throw new CommerceError("not_found", `No claim for message ${messageId} by this agent`, 404);
+        }
+        if (claim.status !== "processing") {
+            throw new CommerceError("conflict", `Message ${messageId} is not under an active claim`, 409);
+        }
+        return claim;
+    }
+    async getNegotiationSnapshot(input) {
+        if (input.conversation_id !== this.conversationId) {
+            return Promise.reject(new CommerceError("not_found", `Unknown conversation ${input.conversation_id}`, 404));
+        }
+        this.requireClaim(input.message_id);
+        const p = this.config.product;
+        const nextActor = this.state.conversationStatus === "waiting_merchant"
+            ? "merchant"
+            : this.state.conversationStatus === "waiting_buyer"
+                ? "buyer"
+                : "none";
+        const snapshot = {
+            protocol_version: PROTOCOL_VERSION,
+            conversation: {
+                id: this.conversationId,
+                status: this.state.conversationStatus,
+                next_actor: nextActor,
+            },
+            role: this.identity.role,
+            in_reply_to_message_id: input.message_id,
+            product: {
+                sku: p.sku,
+                title: p.title,
+                currency: p.currency,
+                list_price: p.list_price,
+            },
+            stock: {
+                status: p.stock_quantity > 2 ? "available" : p.stock_quantity > 0 ? "low" : "out_of_stock",
+                quantity: p.stock_quantity,
+                observed_at: this.now,
+                reserved: false,
+                source: { backend: "local_marketplace", observed_at: this.now },
+            },
+            delivery: { ...p.delivery },
+            after_sales_policies: p.policies.map((pol) => ({ ...pol })),
+            messages: this.state.msgs.slice(-20).map((m) => {
+                const out = {
+                    id: m.id,
+                    sender_role: m.sender_role,
+                    created_at: m.created_at,
+                    public_message: m.public_message,
+                };
+                if (m.action !== undefined) {
+                    out.action = m.action;
+                }
+                if (m.proposal !== undefined) {
+                    out.proposal = m.proposal;
+                }
+                return out;
+            }),
+            current_proposal: this.state.currentProposal,
+            open_issues: [...this.state.openIssues],
+            policy_results: [],
+        };
+        return Promise.resolve(snapshot);
+    }
+    submitNegotiationDecision(input) {
+        const replay = this.state.submissions.get(input.idempotency_key);
+        if (replay)
+            return Promise.resolve(replay);
+        const result = this.evaluate(input.decision);
+        this.state.submissions.set(input.idempotency_key, result);
+        return Promise.resolve(result);
+    }
+    /** The fake policy gate. Order follows the design's fixed gate sequence. */
+    evaluate(decision) {
+        const denied = (codes, reason, retries) => {
+            this.record("negotiation_policy_denied", { reason_codes: codes });
+            return {
+                protocol_version: PROTOCOL_VERSION,
+                result: retries > 0 ? "rejected_retryable" : "human_required",
+                conversation_id: this.conversationId,
+                next_actor: this.identity.role,
+                reason_codes: codes,
+                public_reason: reason,
+                retries_remaining: retries,
+            };
+        };
+        // 4. Protocol version, types, enums, lengths, additional fields.
+        const schemaErrors = validateAgainst("decision", decision);
+        if (schemaErrors.length > 0) {
+            return denied(["invalid_schema"], `决策结构不合法: ${schemaErrors[0] ?? "schema error"}`, 0);
+        }
+        // 2. Conversation, current status and next_actor.
+        if (decision.conversation_id !== this.conversationId) {
+            return denied(["wrong_conversation"], "会话不匹配。", 0);
+        }
+        if (this.state.conversationStatus !== this.waitingStatus) {
+            return denied(["not_your_turn"], "当前不轮到本方行动。", 0);
+        }
+        // 3. Claim binding and in_reply_to matching.
+        const claim = this.state.claims.get(decision.in_reply_to_message_id);
+        if (!claim || claim.status !== "processing") {
+            return denied(["claim_required"], "该消息未被当前 Agent 有效 claim。", 0);
+        }
+        const retriesLeft = Math.max(0, this.maxRetries - (claim.attempts - 1));
+        // 5/6. Facts: SKU, quantity, stock observation, policy refs.
+        const p = this.config.product;
+        const needsProposal = decision.action === "propose" ||
+            decision.action === "counter" ||
+            decision.action === "accept_nonbinding";
+        if (needsProposal && !decision.proposal) {
+            return denied(["proposal_required"], `action=${decision.action} 必须携带 proposal。`, retriesLeft);
+        }
+        if (decision.proposal) {
+            const prop = decision.proposal;
+            if (prop.sku !== p.sku) {
+                return denied(["wrong_sku"], "报价 SKU 不属于本会话商品。", 0);
+            }
+            if (prop.quantity > p.stock_quantity) {
+                return denied(["insufficient_stock"], "数量超过当前可售库存。", retriesLeft);
+            }
+            const observedAt = Date.parse(prop.stock.observed_at);
+            if (Number.isNaN(observedAt) || Date.parse(this.now) - observedAt > this.stockTtlMs) {
+                return denied(["stale_inventory"], "库存观察时间已过期，请重新获取快照。", retriesLeft);
+            }
+            const knownRefs = new Set(p.policies.map((pol) => pol.ref));
+            const badRef = prop.after_sales_policy_refs.find((r) => !knownRefs.has(r));
+            if (badRef) {
+                return denied(["unknown_policy_ref"], `售后政策引用不存在: ${badRef}`, retriesLeft);
+            }
+            // 8. Merchant floor price (merchant role only; the buyer's private
+            // budget lives in the Kiwi profile and is never checked server-side).
+            if (this.identity.role === "merchant" &&
+                p.floor_price !== undefined &&
+                prop.unit_price < p.floor_price) {
+                this.record("negotiation_human_required", { reason_codes: ["below_floor"] });
+                this.state.conversationStatus = "human_required";
+                return {
+                    protocol_version: PROTOCOL_VERSION,
+                    result: "human_required",
+                    conversation_id: this.conversationId,
+                    next_actor: "none",
+                    reason_codes: ["below_floor"],
+                    public_reason: "该报价需要人工处理。",
+                    retries_remaining: 0,
+                };
+            }
+        }
+        // 9. Privacy scan (merchant floor leak; merchant role only).
+        if (this.identity.role === "merchant" &&
+            p.floor_price !== undefined &&
+            decision.public_message.includes(String(p.floor_price))) {
+            return denied(["policy_leak"], "公开文本可能泄露内部价格策略，请改写后重试。", retriesLeft);
+        }
+        // Escalation: escalate action or explicit human review request.
+        if (decision.action === "escalate" || decision.request_human_review) {
+            this.appendMessage(this.identity.role, decision.public_message, {
+                action: decision.action,
+            });
+            this.state.conversationStatus = "human_required";
+            this.record("negotiation_decision_submitted", { action: decision.action });
+            this.record("negotiation_human_required", { reason_codes: decision.reason_codes });
+            return {
+                protocol_version: PROTOCOL_VERSION,
+                result: "human_required",
+                conversation_id: this.conversationId,
+                next_actor: "none",
+                reason_codes: decision.reason_codes.length > 0 ? decision.reason_codes : ["escalated"],
+                public_reason: "已转人工处理。",
+                retries_remaining: 0,
+            };
+        }
+        // 10/11. Accept: normalize message, advance next_actor, audit. No order,
+        // no payment, no reservation — negotiation only.
+        const msg = this.appendMessage(this.identity.role, decision.public_message, {
+            action: decision.action,
+            proposal: (decision.proposal ?? null),
+        });
+        if (decision.proposal)
+            this.state.currentProposal = decision.proposal;
+        this.state.openIssues = [...decision.open_issues];
+        this.state.conversationStatus =
+            decision.action === "decline" ? "closed" : `waiting_${this.counterpart}`;
+        this.record("negotiation_decision_submitted", { action: decision.action });
+        this.record("negotiation_policy_accepted", { message_id: msg.id });
+        return {
+            protocol_version: PROTOCOL_VERSION,
+            result: "accepted",
+            conversation_id: this.conversationId,
+            message_id: msg.id,
+            next_actor: decision.action === "decline" ? "none" : this.counterpart,
+            reason_codes: decision.reason_codes,
+            public_reason: "决策已接受并写入会话。",
+            retries_remaining: retriesLeft,
+        };
+    }
+    async completeClaim(input) {
+        const claim = this.requireClaim(input.message_id);
+        claim.status = "processed";
+        claim.updated_at = this.now;
+        this.record("agent_message_processed", { message_id: input.message_id });
+        return Promise.resolve({ status: "processed", message_id: input.message_id });
+    }
+    async failClaim(input) {
+        const claim = this.requireClaim(input.message_id);
+        claim.status = "failed";
+        claim.last_error = input.error;
+        claim.updated_at = this.now;
+        this.record("agent_message_failed", { message_id: input.message_id, error: input.error });
+        return Promise.resolve({
+            status: "failed",
+            message_id: input.message_id,
+            last_error: input.error,
+        });
+    }
+    async abandonClaim(input) {
+        const claim = this.requireClaim(input.message_id);
+        claim.status = "abandoned";
+        claim.last_error = input.error;
+        claim.updated_at = this.now;
+        this.record("agent_message_abandoned", {
+            message_id: input.message_id,
+            error: input.error,
+        });
+        return Promise.resolve({
+            status: "abandoned",
+            message_id: input.message_id,
+            last_error: input.error,
+        });
+    }
+    heartbeat(input) {
+        let refreshed = 0;
+        if (input?.message_id !== undefined) {
+            const claim = this.state.claims.get(input.message_id);
+            if (!claim || claim.agent_id !== this.agentId) {
+                return Promise.reject(new CommerceError("not_found", `No claim for message ${input.message_id} by this agent`, 404));
+            }
+            if (claim.status === "processing") {
+                claim.updated_at = this.now;
+                refreshed = 1;
+            }
+        }
+        else {
+            for (const claim of this.state.claims.values()) {
+                if (claim.agent_id === this.agentId && claim.status === "processing") {
+                    claim.updated_at = this.now;
+                    refreshed += 1;
+                }
+            }
+        }
+        this.record("agent_message_heartbeat", {
+            refreshed,
+            ...(input?.message_id !== undefined ? { message_id: input.message_id } : {}),
+        });
+        return Promise.resolve({ status: "ok", refreshed, at: this.now });
+    }
+    abandonStaleClaims(input) {
+        const ttl = input?.ttl_seconds ?? 300;
+        if (!Number.isInteger(ttl) || ttl <= 0) {
+            return Promise.reject(new CommerceError("validation", "ttl_seconds must be a positive whole number", 400));
+        }
+        const cutoff = Date.parse(this.now) - ttl * 1000;
+        const abandoned = [];
+        for (const claim of this.state.claims.values()) {
+            if (claim.agent_id === this.agentId &&
+                claim.status === "processing" &&
+                Date.parse(claim.updated_at) < cutoff) {
+                claim.status = "abandoned";
+                claim.last_error = `stale processing claim abandoned after ${ttl} seconds`;
+                claim.updated_at = this.now;
+                abandoned.push(claim.message_id);
+                this.record("agent_message_abandoned", {
+                    message_id: claim.message_id,
+                    error: claim.last_error,
+                    reason: "stale_processing_claim",
+                });
+            }
+        }
+        return Promise.resolve({
+            abandoned: abandoned.length,
+            message_ids: abandoned,
+            ttl_seconds: ttl,
+            at: this.now,
+        });
+    }
+}
+//# sourceMappingURL=fake-client.js.map

package/dist/commerce/fake-client.js.map

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

package/dist/commerce/http-client.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { CommerceCapabilities, NegotiationDecision, NegotiationSnapshot, PolicyResult } from "../negotiation/types.js";
+import { type ClaimResult, type CommerceClient, type CommerceHealth, type HeartbeatResult, type PendingMessage, type ProcessResult, type StaleRecoveryResult } from "./types.js";
+export interface HttpCommerceClientOptions {
+    baseUrl: string;
+    token: string;
+    /** Injectable fetch for tests. Defaults to globalThis.fetch. */
+    fetchImpl?: typeof fetch;
+    /** Per-request timeout in ms. Default 15000. */
+    timeoutMs?: number;
+}
+export declare class HttpCommerceClient implements CommerceClient {
+    private readonly baseUrl;
+    private readonly token;
+    private readonly fetchImpl;
+    private readonly timeoutMs;
+    constructor(options: HttpCommerceClientOptions);
+    private request;
+    /** Fail-closed shape check for envelope fields that carry typed data. */
+    private static badShape;
+    private static requireObject;
+    health(): Promise<CommerceHealth>;
+    getCapabilities(): Promise<CommerceCapabilities>;
+    listPendingMessages(): Promise<PendingMessage[]>;
+    claimMessage(input: {
+        conversation_id: string;
+        message_id: number;
+        idempotency_key: string;
+    }): Promise<ClaimResult>;
+    getNegotiationSnapshot(input: {
+        conversation_id: string;
+        message_id: number;
+    }): Promise<NegotiationSnapshot>;
+    submitNegotiationDecision(input: {
+        decision: NegotiationDecision;
+        idempotency_key: string;
+    }): Promise<PolicyResult>;
+    completeClaim(input: {
+        message_id: number;
+        idempotency_key: string;
+    }): Promise<ProcessResult>;
+    failClaim(input: {
+        message_id: number;
+        idempotency_key: string;
+        error: string;
+    }): Promise<ProcessResult>;
+    abandonClaim(input: {
+        message_id: number;
+        idempotency_key: string;
+        error: string;
+    }): Promise<ProcessResult>;
+    heartbeat(input?: {
+        message_id?: number;
+    }): Promise<HeartbeatResult>;
+    abandonStaleClaims(input?: {
+        ttl_seconds?: number;
+    }): Promise<StaleRecoveryResult>;
+    private processVerb;
+}