@harrylabsj/kiwi 0.7.9 → 0.7.10

package/dist/buyer-core/service.js

@@ -0,0 +1,510 @@
+/**
+ * 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.
+ */
+/**
+ * KiwiBuyerService —— kiwi-buyer-mcp 薄 Buyer Core（战略 v2.5 §5.1/§5.5/§6.2）。
+ *
+ * 设计原则（§5.1）：Host Agent owns conversation；UCP owns standard commerce
+ * primitives；Kiwi owns cross-merchant sourcing and commercial negotiation。
+ * 本服务 LLM-independent：宿主 Agent 负责自然语言理解，Kiwi 确定性完成
+ * discovery routing、RFQ fan-out、offer normalization、policy evaluation、
+ * counteroffer、ledger、recovery 与 agreement。
+ *
+ * 唯一权威：TaskApprovalStore 持久存储；EffectiveAuthorization 五层交集
+ * deny 优先；写操作幂等；AcceptNonbinding/handoff 绑定持久 approval_id。
+ *
+ * 执行 seam（Phase 2 接线真实 merchant 网络）：MerchantIndex / QuoteFetcher /
+ * Negotiator 为可注入接口。v0.1 默认使用 Static 实现或由宿主注入。
+ */
+import { contentDigest } from "../negotiation/jcs.js";
+import { uuidv7 } from "@earendil-works/pi-ai";
+import { assertNorthboundContractValid, validateCommerceIntent, validateEffectiveAuthorization, } from "../contracts/northbound-schema.js";
+import { McpError } from "./errors.js";
+import { TaskApprovalStore } from "./store.js";
+function utcNow() {
+    return new Date().toISOString();
+}
+function policyActionMode(policy, action) {
+    return policy.actions[action]?.mode ?? "never";
+}
+export class KiwiBuyerService {
+    store;
+    principal;
+    buyerAgentId;
+    sessionId;
+    policy;
+    merchantIndex;
+    quoteFetcher;
+    negotiator;
+    now;
+    constructor(options) {
+        this.store = options.store;
+        this.principal = options.principal;
+        this.buyerAgentId = options.buyerAgentId;
+        this.sessionId = options.sessionId;
+        const clock = options.now ?? utcNow;
+        this.now = () => new Date(Date.parse(clock())).toISOString();
+        this.policy = options.delegationPolicy;
+        this.merchantIndex = options.merchantIndex;
+        this.quoteFetcher = options.quoteFetcher;
+        this.negotiator = options.negotiator;
+    }
+    // ---- Northbound：kiwi_search ----------------------------------------------
+    async search(input) {
+        if (this.merchantIndex === undefined) {
+            return { merchants: [], note: "merchant index not wired; discovery pending" };
+        }
+        try {
+            const merchants = await this.merchantIndex.search(input.query, {
+                category: input.category,
+                region: input.region,
+            });
+            return { merchants };
+        }
+        catch (error) {
+            // catalog 不可达：降级为可解释 note，不编造商家（§3.2 Discovery & Routing）。
+            return {
+                merchants: [],
+                note: `merchant index unreachable: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+    // ---- Northbound：kiwi_request_quotes --------------------------------------
+    async requestQuotes(input) {
+        // 契约校验（§5.2）：CommerceIntent 必须合法；无效即拒绝，不落库。
+        const intentErrors = validateCommerceIntent(input.intent);
+        if (intentErrors.length > 0) {
+            throw new McpError("contract_violation", `CommerceIntent 违反冻结契约：${intentErrors.join("; ")}`);
+        }
+        const policyId = this.policy.policy_id;
+        const expiresAt = this.policy.expires_at;
+        const idempotencyKey = input.idempotency_key ?? `req-${uuidv7()}`;
+        const taskId = `task-${uuidv7()}`;
+        const created = this.now();
+        // 无 fetcher 时记录确定性 fan-out 槽位（§6.2 部分失败可解释）；有 fetcher 时
+        // 只写真实结果，不预建槽位，避免候选重复。
+        const preCandidates = this.quoteFetcher === undefined
+            ? (input.merchant_ids ?? []).map((merchantId) => ({
+                candidate_id: `cand-${uuidv7()}`,
+                merchant_id: merchantId,
+                status: "pending",
+                retryable: true,
+            }))
+            : [];
+        const task = {
+            task_id: taskId,
+            task_kind: "request_quotes",
+            status: "in_progress",
+            idempotency_key: idempotencyKey,
+            intent_id: String(input.intent.intent_id),
+            delegation_policy_id: policyId,
+            created_at: created,
+            updated_at: created,
+            expires_at: expiresAt,
+            resumable: true,
+            payload: JSON.stringify({
+                task_id: taskId,
+                task_kind: "request_quotes",
+                status: "in_progress",
+                idempotency_key: idempotencyKey,
+                intent_id: input.intent.intent_id,
+                delegation_policy_id: policyId,
+                created_at: created,
+                updated_at: created,
+                expires_at: expiresAt,
+                resumable: true,
+                candidates: preCandidates,
+                intent: input.intent,
+            }),
+        };
+        const { task: persisted, created: isCreated } = this.store.createTask(task);
+        if (!isCreated) {
+            // 幂等命中：相同 idempotency_key 的重复提交返回原任务，不产生重复写入（§6.2）。
+            return { task: this.decodeTask(persisted), created: false };
+        }
+        for (const candidate of preCandidates) {
+            this.store.addCandidate(taskId, candidate);
+        }
+        // 真实 fan-out 交给注入的 QuoteFetcher（Phase 2 接线 A2A/UCP）。v0.1 无 fetcher
+        // 时任务保持 in_progress + resumable，可恢复；有 fetcher 时按部分失败语义回写。
+        let status = "in_progress";
+        if (this.quoteFetcher !== undefined) {
+            const merchants = input.merchant_ids ?? [];
+            const index = this.merchantIndex;
+            // 用意图的商品查询解析商家（拿到各自 matching_skus，供 RFQ 用商家自有 SKU）。
+            const resolved = index !== undefined ? await index.search(this.firstQuery(input.intent)) : [];
+            const merchantRecords = merchants.map((m) => resolved.find((r) => r.merchant_id === m) ?? {
+                merchant_id: m,
+                name: m,
+                verified: false,
+                capabilities: [],
+            });
+            const results = await this.quoteFetcher.requestQuotes(input.intent, merchantRecords);
+            const successes = results.filter((r) => r.status === "succeeded").length;
+            if (results.length > 0) {
+                for (const r of results) {
+                    this.store.addCandidate(taskId, {
+                        candidate_id: `cand-${uuidv7()}`,
+                        merchant_id: r.merchant_id,
+                        status: r.status,
+                        provenance: r.provenance,
+                        failure: r.failure,
+                        retryable: r.status === "failed" ? (r.failure?.retryable ?? false) : false,
+                    });
+                }
+                status = successes === results.length ? "succeeded" : "partial_success";
+            }
+        }
+        const updated = this.store.updateTask(taskId, {
+            status,
+            resumable: true,
+            payload: JSON.stringify({
+                ...this.decodeTask(task),
+                status,
+                updated_at: this.now(),
+                candidates: this.store.listCandidates(taskId),
+            }),
+        });
+        const decoded = this.decodeTask(updated);
+        // 冻结契约强制：持久任务记录必须满足 persistent-task/1.0 schema（§6.2）。
+        assertNorthboundContractValid("persistent-task", decoded, "requestQuotes result");
+        return { task: decoded, created: true };
+    }
+    // ---- Northbound：kiwi_get_task --------------------------------------------
+    getTask(taskId) {
+        const task = this.store.getTask(taskId);
+        if (task === undefined)
+            throw new McpError("task_not_found", `task ${taskId} not found`);
+        if (task.expires_at !== undefined && Date.parse(task.expires_at) < Date.parse(this.now())) {
+            throw new McpError("task_expired", `task ${taskId} expired at ${task.expires_at}`);
+        }
+        return { task: this.decodeTask(task) };
+    }
+    // ---- Northbound：kiwi_negotiate -------------------------------------------
+    async negotiate(input) {
+        const task = this.store.getTask(input.task_id);
+        if (task === undefined)
+            throw new McpError("task_not_found", `task ${input.task_id} not found`);
+        if (task.expires_at !== undefined && Date.parse(task.expires_at) < Date.parse(this.now())) {
+            throw new McpError("task_expired", `task ${input.task_id} expired`);
+        }
+        const mode = policyActionMode(this.policy, "counter_offer");
+        if (mode === "never") {
+            throw new McpError("delegation_denied", "counter_offer 未获委托（never）");
+        }
+        const rounds = this.currentRounds(task);
+        const maxRounds = this.policy.limits?.max_rounds ?? 3;
+        if (rounds >= maxRounds) {
+            throw new McpError("delegation_denied", `counter_offer 超出委托轮次上限（max_rounds=${maxRounds}）`);
+        }
+        let step = {
+            round: rounds + 1,
+            action: input.action,
+            summary: input.summary,
+        };
+        if (this.negotiator !== undefined) {
+            step = await this.negotiator.negotiate(input.task_id, {}, step, this.store.listCandidates(input.task_id));
+        }
+        const decoded = this.decodeTask(task);
+        const prior = Array.isArray(decoded.steps)
+            ? decoded.steps
+            : [];
+        const steps = [...prior, step];
+        const currentStatus = typeof decoded.status === "string" ? decoded.status : "in_progress";
+        const updated = this.store.updateTask(input.task_id, {
+            status: currentStatus === "pending" ? "in_progress" : currentStatus,
+            payload: JSON.stringify({ ...decoded, steps, updated_at: this.now() }),
+        });
+        return { task: this.decodeTask(updated), step };
+    }
+    // ---- Northbound：kiwi_accept_agreement ------------------------------------
+    async acceptAgreement(input) {
+        const task = this.store.getTask(input.task_id);
+        if (task === undefined)
+            throw new McpError("task_not_found", `task ${input.task_id} not found`);
+        if (task.expires_at !== undefined && Date.parse(task.expires_at) < Date.parse(this.now())) {
+            throw new McpError("task_expired", `task ${input.task_id} expired`);
+        }
+        const candidate = this.store
+            .listCandidates(input.task_id)
+            .find((c) => c.candidate_id === input.candidate_id);
+        if (candidate === undefined) {
+            throw new McpError("invalid_params", `candidate ${input.candidate_id} not found on task`);
+        }
+        const termsDigest = contentDigest(candidate);
+        const authorization = await this.evaluateAuthorization("accept_nonbinding", {
+            taskId: input.task_id,
+            candidateId: input.candidate_id,
+            candidateDigest: termsDigest,
+            approvalId: input.approval_id,
+        });
+        if (authorization.effective_decision !== "granted") {
+            throw new McpError("authorization_denied", "AcceptNonbinding 未获五层授权", {
+                authorization,
+            });
+        }
+        const agreementId = `agreement-${uuidv7()}`;
+        const now = this.now();
+        const agreement = {
+            agreement_id: agreementId,
+            task_id: input.task_id,
+            negotiation_id: candidate.provenance
+                ?.negotiation_id,
+            terms_digest: termsDigest,
+            created_at: now,
+            binding_effect: "nonbinding",
+            creates_order: false,
+            reserves_inventory: false,
+            authorizes_payment: false,
+            accepted_candidate_id: input.candidate_id,
+            authorization_id: authorization.authorization_id,
+        };
+        this.store.createAgreement({
+            agreement_id: agreementId,
+            task_id: input.task_id,
+            negotiation_id: agreement.negotiation_id,
+            terms_digest: termsDigest,
+            created_at: now,
+            expires_at: undefined,
+            payload: JSON.stringify(agreement),
+        });
+        const updated = this.store.updateTask(input.task_id, {
+            status: "succeeded",
+            payload: JSON.stringify({
+                ...this.decodeTask(task),
+                agreement_id: agreementId,
+                status: "succeeded",
+                updated_at: now,
+            }),
+        });
+        return { task: this.decodeTask(updated), agreement, authorization };
+    }
+    // ---- Northbound：kiwi_get_agreement ---------------------------------------
+    getAgreement(agreementId) {
+        const stored = this.store.getAgreement(agreementId);
+        if (stored === undefined) {
+            throw new McpError("agreement_not_found", `agreement ${agreementId} not found`);
+        }
+        return { agreement: this.parsePayload(stored.payload) };
+    }
+    // ---- Northbound：kiwi_handoff ---------------------------------------------
+    async handoff(input) {
+        const stored = this.store.getAgreement(input.agreement_id);
+        if (stored === undefined) {
+            throw new McpError("agreement_not_found", `agreement ${input.agreement_id} not found`);
+        }
+        const authorization = await this.evaluateAuthorization("handoff", {
+            taskId: stored.task_id,
+            approvalId: input.approval_id,
+        });
+        if (authorization.effective_decision !== "granted") {
+            throw new McpError("authorization_denied", "Handoff 未获五层授权", { authorization });
+        }
+        const handoffRef = {
+            handoff_id: `handoff-${uuidv7()}`,
+            destination_type: input.destination_type,
+            ...(input.url !== undefined ? { url: input.url } : {}),
+        };
+        return { handoff_ref: handoffRef, authorization };
+    }
+    // ---- 持久审批（宿主适配面，非 7 个 MCP 工具）-------------------------------
+    /** 创建 pending 审批记录（ASK 动作触发）。返回持久 approval_id。 */
+    requestApproval(input) {
+        const task = this.store.getTask(input.task_id);
+        if (task === undefined)
+            throw new McpError("task_not_found", `task ${input.task_id} not found`);
+        const approvalId = `approval-${uuidv7()}`;
+        const approval = {
+            approval_id: approvalId,
+            task_id: input.task_id,
+            action: input.action,
+            status: "pending",
+            candidate_digest: input.candidate_digest,
+            expires_at: task.expires_at,
+        };
+        this.store.setApproval(input.task_id, approval);
+        return { approval_id: approvalId };
+    }
+    /** 批准一个 pending 审批（绑定授权记录）。 */
+    approveApproval(input) {
+        const stored = this.store.getApproval(input.approval_id);
+        if (stored === undefined)
+            throw new McpError("invalid_params", `approval ${input.approval_id} not found`);
+        if (stored.expires_at !== undefined && Date.parse(stored.expires_at) < Date.parse(this.now())) {
+            throw new McpError("approval_denied", `approval ${input.approval_id} 已过期`);
+        }
+        this.store.setApproval(stored.task_id, {
+            ...stored,
+            status: "approved",
+            decided_at: this.now(),
+            authorization_json: JSON.stringify(input.authorization),
+        });
+    }
+    /** 拒绝一个 pending 审批（deny 路径；deny 优先，§5.5）。 */
+    rejectApproval(input) {
+        const stored = this.store.getApproval(input.approval_id);
+        if (stored === undefined)
+            throw new McpError("invalid_params", `approval ${input.approval_id} not found`);
+        this.store.setApproval(stored.task_id, {
+            ...stored,
+            status: "denied",
+            decided_at: this.now(),
+            authorization_json: JSON.stringify({
+                reason: input.reason ?? "rejected by operator",
+                decided_at: this.now(),
+            }),
+        });
+    }
+    // ---- 五层授权（§5.5 deny 优先）---------------------------------------------
+    async evaluateAuthorization(action, opts) {
+        const layers = {
+            package_trust: { status: "allowed", reason: "signed kiwi-buyer-mcp package, version pinned" },
+            host_tool_policy: { status: "allowed", reason: "host invoked the tool within its policy" },
+            runtime_approval: { status: "allowed", reason: "no approval gate for this action" },
+            kiwi_delegation_policy: { status: "allowed" },
+            merchant_hard_policy: { status: "allowed", reason: "within merchant hard policy" },
+        };
+        // 第 4 层：DelegationPolicy
+        const mode = policyActionMode(this.policy, action);
+        if (mode === "never") {
+            layers.kiwi_delegation_policy = { status: "denied", reason: `action=${action} 委托=never` };
+        }
+        else if (mode === "ask") {
+            // ASK：必须有已批准的持久审批；approval 动作必须与请求动作一致。
+            const expectedAction = action === "accept_nonbinding" ? "accept_nonbinding" : "handoff";
+            const approval = opts.approvalId !== undefined ? this.store.getApproval(opts.approvalId) : undefined;
+            if (opts.approvalId !== undefined && approval === undefined) {
+                throw new McpError("approval_required", `approval ${opts.approvalId} 不存在`, {
+                    approval_id: opts.approvalId,
+                });
+            }
+            if (approval === undefined) {
+                const created = this.requestApproval({
+                    task_id: opts.taskId,
+                    action: expectedAction,
+                    candidate_digest: opts.candidateDigest,
+                });
+                throw new McpError("approval_required", `action=${action} 需要持久审批`, {
+                    approval_id: created.approval_id,
+                });
+            }
+            if (approval.action !== expectedAction) {
+                layers.runtime_approval = {
+                    status: "denied",
+                    reason: `approval ${approval.approval_id} 动作=${approval.action} 与请求 ${action} 不一致`,
+                };
+            }
+            else if (approval.status === "pending") {
+                throw new McpError("approval_required", `approval ${approval.approval_id} 待审批`, {
+                    approval_id: approval.approval_id,
+                });
+            }
+            else if (approval.status === "denied" || approval.status === "expired") {
+                layers.runtime_approval = {
+                    status: "denied",
+                    reason: `approval ${approval.approval_id} 状态=${approval.status}`,
+                };
+            }
+            else {
+                layers.runtime_approval = {
+                    status: "allowed",
+                    reason: `persistent approval ${approval.approval_id} approved`,
+                };
+            }
+            // ASK 动作的 delegation 层只有在审批存在且有效时才允许。
+            if (layers.runtime_approval.status === "allowed") {
+                layers.kiwi_delegation_policy = { status: "allowed", reason: `action=${action} ask，审批已批` };
+            }
+        }
+        // AUTO：delegation 层默认 allowed。
+        // 硬约束（limits）：只对已解析的约束做 deny。
+        const denyReason = this.limitViolation(action, opts);
+        if (denyReason !== undefined) {
+            layers.merchant_hard_policy = { status: "denied", reason: denyReason };
+        }
+        const denied = Object.values(layers).some((l) => l.status === "denied");
+        const authorization = {
+            authorization_id: `authz-${uuidv7()}`,
+            action,
+            subject: {
+                buyer_agent_id: this.buyerAgentId,
+                session_id: this.sessionId,
+                delegation_id: this.policy.policy_id,
+                expires_at: this.policy.expires_at,
+            },
+            layers,
+            effective_decision: denied ? "denied" : "granted",
+            ...(opts.approvalId !== undefined ? { approval_id: opts.approvalId } : {}),
+            expires_at: this.policy.expires_at,
+            decided_at: this.now(),
+        };
+        // 冻结 schema 强制 deny-wins 不变量；非法即内部错误。
+        const errors = validateEffectiveAuthorization(authorization);
+        if (errors.length > 0) {
+            throw new McpError("internal_error", `EffectiveAuthorization 违反冻结契约：${errors.join("; ")}`, { authorization, errors });
+        }
+        return authorization;
+    }
+    limitViolation(action, _opts) {
+        const limits = this.policy.limits;
+        if (limits === undefined)
+            return undefined;
+        if (limits.deadline !== undefined &&
+            Date.parse(limits.deadline) < Date.parse(this.now())) {
+            return `delegation deadline ${limits.deadline} 已过期`;
+        }
+        if (action === "payment")
+            return "payment 恒为 never";
+        return undefined;
+    }
+    firstQuery(intent) {
+        const items = Array.isArray(intent.items) ? intent.items : [];
+        const first = items[0] ?? {};
+        if (typeof first.query === "string" && first.query !== "")
+            return first.query;
+        if (typeof first.sku === "string" && first.sku !== "")
+            return first.sku;
+        return "";
+    }
+    currentRounds(task) {
+        const decoded = this.decodeTask(task);
+        return Array.isArray(decoded.steps) ? decoded.steps.length : 0;
+    }
+    decodeTask(task) {
+        const parsed = this.parsePayload(task.payload);
+        return {
+            ...parsed,
+            task_id: task.task_id,
+            task_kind: task.task_kind,
+            status: task.status,
+            idempotency_key: task.idempotency_key,
+            created_at: task.created_at,
+            updated_at: task.updated_at,
+            expires_at: task.expires_at,
+            resumable: task.resumable,
+            candidates: this.store.listCandidates(task.task_id),
+            approval: this.store.listApprovalsByTask(task.task_id)[0],
+        };
+    }
+    parsePayload(json) {
+        try {
+            return JSON.parse(json);
+        }
+        catch {
+            throw new McpError("store_corrupted", "stored payload is not parseable");
+        }
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/buyer-core/service.js.map

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

package/dist/buyer-core/store.d.ts

@@ -0,0 +1,84 @@
+/**
+ * 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 interface TaskApprovalStoreOptions {
+    /** SQLite 文件路径；`:memory:` 用于测试。目录不存在时创建（0700）。 */
+    dbPath: string;
+    now?: () => string;
+}
+export interface StoredTask {
+    task_id: string;
+    task_kind: string;
+    status: string;
+    idempotency_key: string;
+    intent_id?: string;
+    delegation_policy_id?: string;
+    created_at: string;
+    updated_at: string;
+    expires_at?: string;
+    resumable: boolean;
+    /** 完整 task 记录（持久 Task 契约的权威 JSON）。 */
+    payload: string;
+}
+export interface StoredApproval {
+    approval_id: string;
+    task_id: string;
+    action: string;
+    status: string;
+    candidate_digest?: string;
+    expires_at?: string;
+    decided_at?: string;
+    authorization_json?: string;
+}
+export interface StoredAgreement {
+    agreement_id: string;
+    task_id: string;
+    negotiation_id?: string;
+    terms_digest?: string;
+    created_at: string;
+    expires_at?: string;
+    payload: string;
+}
+export declare class TaskApprovalStore {
+    private readonly db;
+    private readonly now;
+    constructor(options: TaskApprovalStoreOptions);
+    private migrate;
+    /** 幂等创建任务：相同 idempotency_key 返回已有任务（不抛错、不重复写入）。 */
+    createTask(task: StoredTask): {
+        task: StoredTask;
+        created: boolean;
+    };
+    getTask(taskId: string): StoredTask | undefined;
+    /** 按 task_id 更新任务（乐观并发：payload 整体覆盖）。 */
+    updateTask(taskId: string, patch: Partial<StoredTask>): StoredTask;
+    addCandidate(taskId: string, candidate: {
+        candidate_id: string;
+        merchant_id: string;
+        status: string;
+        provenance?: Record<string, unknown>;
+        failure?: Record<string, unknown>;
+        expires_at?: string;
+        retryable: boolean;
+    }): void;
+    listCandidates(taskId: string): Array<Record<string, unknown>>;
+    setApproval(taskId: string, approval: StoredApproval): void;
+    getApproval(approvalId: string): StoredApproval | undefined;
+    listApprovalsByTask(taskId: string): StoredApproval[];
+    createAgreement(agreement: StoredAgreement): void;
+    getAgreement(agreementId: string): StoredAgreement | undefined;
+    close(): void;
+    private parse;
+}