@harrylabsj/kiwi 0.6.0

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

@@ -0,0 +1,186 @@
+/**
+ * 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 { MerchantClientError, parseHumanReviewItem, parseIncomingConsultation, parseMerchantCatalogProduct, } from "./types.js";
+const REQUEST_TIMEOUT_MS = 10_000;
+export class HttpMerchantClient {
+    baseUrl;
+    broker;
+    constructor(baseUrl, broker) {
+        this.baseUrl = baseUrl.replace(/\/+$/, "");
+        this.broker = broker;
+    }
+    // ---- HTTP plumbing -------------------------------------------------------
+    async request(method, pathname, options = {}) {
+        const url = `${this.baseUrl}${pathname}${options.query ? `?${new URLSearchParams(options.query).toString()}` : ""}`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+        let response;
+        try {
+            response = await fetch(url, {
+                method,
+                headers: {
+                    accept: "application/json",
+                    ...(options.body !== undefined ? { "content-type": "application/json" } : {}),
+                    ...(options.token !== undefined ? { authorization: `Bearer ${options.token}` } : {}),
+                },
+                body: options.body !== undefined ? JSON.stringify(options.body) : undefined,
+                signal: controller.signal,
+            });
+        }
+        catch (err) {
+            throw new MerchantClientError("transient", `merchant request failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        let payload;
+        try {
+            payload = await response.json();
+        }
+        catch {
+            throw new MerchantClientError("transient", `merchant returned non-JSON (HTTP ${response.status})`);
+        }
+        if (!response.ok) {
+            const kind = response.status === 404
+                ? "not_found"
+                : response.status === 401 || response.status === 403
+                    ? "auth"
+                    : response.status >= 400 && response.status < 500
+                        ? "validation"
+                        : "transient";
+            throw new MerchantClientError(kind, `merchant HTTP ${response.status} for ${pathname}`);
+        }
+        return payload;
+    }
+    /** Catalog credential token; missing scope -> fail closed. */
+    catalogToken() {
+        const token = this.broker.resolve("catalog");
+        if (token === undefined) {
+            throw new MerchantClientError("auth", "没有 catalog 作用域凭据（commerce.credentials.catalog.token_env 未配置）");
+        }
+        return token;
+    }
+    // ---- catalog ---------------------------------------------------------------
+    async listProducts(merchantId) {
+        // Public search endpoint returns merchant_id per product; filter locally.
+        // Real gateway has no merchant-owned product listing route.
+        // include_out_of_stock=1：商家自查目录要看到全部在架商品（含缺货/暂停），
+        // 买家搜索默认排除缺货的行为不适用于商家自己的商品清单。
+        const payload = (await this.request("GET", "/search/products", {
+            query: { limit: "100", offset: "0", include_out_of_stock: "1" },
+        }));
+        if (payload === null || typeof payload !== "object" || !Array.isArray(payload.results)) {
+            throw new MerchantClientError("validation", "search/products response lacks a results array");
+        }
+        return payload.results
+            .map((p) => parseMerchantCatalogProduct(p))
+            .filter((p) => p.merchant_id === merchantId);
+    }
+    async getProduct(sku) {
+        const payload = (await this.request("GET", `/products/${encodeURIComponent(sku)}`));
+        if (payload === null || typeof payload !== "object" || payload.product === undefined) {
+            throw new MerchantClientError("validation", "get product response lacks a product object");
+        }
+        return parseMerchantCatalogProduct(payload.product);
+    }
+    async createProduct(input) {
+        const payload = (await this.request("POST", "/products", {
+            body: {
+                merchant_id: input.merchant_id,
+                sku: input.sku,
+                title: input.title,
+                price: input.price,
+                stock: input.stock,
+                ...(input.currency !== undefined ? { currency: input.currency } : {}),
+                ...(input.category !== undefined ? { category: input.category } : {}),
+                ...(input.tags !== undefined ? { tags: input.tags } : {}),
+                ...(input.description !== undefined ? { description: input.description } : {}),
+                ...(input.delivery_attributes !== undefined
+                    ? { delivery_attributes: input.delivery_attributes }
+                    : {}),
+            },
+            token: this.catalogToken(),
+        }));
+        if (payload === null || typeof payload !== "object" || payload.product === undefined) {
+            throw new MerchantClientError("validation", "create product response lacks a product object");
+        }
+        return parseMerchantCatalogProduct(payload.product);
+    }
+    async updateProduct(sku, patch) {
+        const payload = (await this.request("PATCH", `/products/${encodeURIComponent(sku)}`, {
+            body: {
+                ...(patch.title !== undefined ? { title: patch.title } : {}),
+                ...(patch.price !== undefined ? { price: patch.price } : {}),
+                ...(patch.stock !== undefined ? { stock: patch.stock } : {}),
+                ...(patch.currency !== undefined ? { currency: patch.currency } : {}),
+                ...(patch.category !== undefined ? { category: patch.category } : {}),
+                ...(patch.tags !== undefined ? { tags: patch.tags } : {}),
+                ...(patch.description !== undefined ? { description: patch.description } : {}),
+                ...(patch.delivery_attributes !== undefined
+                    ? { delivery_attributes: patch.delivery_attributes }
+                    : {}),
+            },
+            token: this.catalogToken(),
+        }));
+        if (payload === null || typeof payload !== "object" || payload.product === undefined) {
+            throw new MerchantClientError("validation", "update product response lacks a product object");
+        }
+        return parseMerchantCatalogProduct(payload.product);
+    }
+    // ---- inventory --------------------------------------------------------------
+    async getInventorySnapshot(sku) {
+        const product = await this.getProduct(sku);
+        return { sku: product.sku, stock: product.stock, observed_at: new Date().toISOString() };
+    }
+    /** Inventory-scope write: PATCH only the stock field with the inventory token. */
+    async updateInventory(sku, stock) {
+        const token = this.broker.resolve("inventory");
+        if (token === undefined) {
+            throw new MerchantClientError("auth", "没有 inventory 作用域凭据（commerce.credentials.inventory.token_env 未配置）");
+        }
+        const payload = (await this.request("PATCH", `/products/${encodeURIComponent(sku)}`, {
+            body: { stock },
+            token,
+        }));
+        if (payload === null || typeof payload !== "object" || payload.product === undefined) {
+            throw new MerchantClientError("validation", "update inventory response lacks a product object");
+        }
+        return parseMerchantCatalogProduct(payload.product);
+    }
+    // ---- consultations & human review -------------------------------------------
+    async listIncomingConsultations(merchantId) {
+        const payload = (await this.request("GET", `/merchants/${encodeURIComponent(merchantId)}/conversations`, { token: this.catalogToken() }));
+        if (payload === null || typeof payload !== "object" || !Array.isArray(payload.conversations)) {
+            throw new MerchantClientError("validation", "conversations response lacks a conversations array");
+        }
+        return payload.conversations.map((c) => parseIncomingConsultation(c));
+    }
+    async getHumanReviewQueue(merchantId) {
+        const payload = (await this.request("GET", `/merchants/${encodeURIComponent(merchantId)}/human-review`, { token: this.catalogToken() }));
+        // shopping-cli 2.x returns {conversations:[...]}; accept both shapes.
+        const reviews = payload.reviews ?? payload.conversations;
+        if (payload === null || typeof payload !== "object" || !Array.isArray(reviews)) {
+            throw new MerchantClientError("validation", "human-review response lacks a reviews/conversations array");
+        }
+        return reviews.map((r) => parseHumanReviewItem(r));
+    }
+    /** shopping-cli 2.x has no listing pause endpoint — fail closed. */
+    async pauseListing(_sku, _paused) {
+        throw new MerchantClientError("validation", "shopping-cli 2.x 不提供 listing pause/resume 端点（active 为目录内部字段）；" +
+            "该能力在真实 Connector 上 fail closed，只保留审批候选记录。");
+    }
+}
+//# sourceMappingURL=merchant-client.js.map

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

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

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

@@ -0,0 +1,74 @@
+/**
+ * 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.
+ */
+/**
+ * Merchant capability pack (design §14–§15.4).
+ *
+ * Read-only tools surface the merchant's own catalog, inventory, incoming
+ * consultations and human-review queue. Write tools (product/inventory/listing
+ * changes) always produce a content-hashed WriteApprovalCandidate and route by mode
+ * through the shared write gate (§16). The model only sees tools — catalog and
+ * inventory tokens live in the CredentialBroker and are attached per-request.
+ *
+ * Private merchant values (floor price, cost, margin) live in the profile and
+ * Vault; they never enter tool arguments, preconditions, the merchant client
+ * or model-visible output. Autopilot only auto-executes within the profile's
+ * HardPolicy envelope (floor / max discount); anything outside escalates to
+ * approval.
+ */
+import type { AgentHarnessTool } from "@earendil-works/pi-agent-core";
+import type { AgentProfile } from "../../config/profile.js";
+import type { CommerceDataSource } from "../../commerce/data-source.js";
+import type { CommerceClient } from "../../commerce/types.js";
+import type { AgentMode } from "../mode.js";
+import type { WriteApprovalCandidateStore } from "./action-candidate.js";
+import type { CredentialBroker } from "./credential-broker.js";
+import type { MerchantClient } from "./types.js";
+import type { WriteGateDeps, WriteGateResult } from "../write-gate.js";
+type Tool = AgentHarnessTool<undefined>;
+export interface MerchantToolDeps {
+    profile: AgentProfile;
+    merchantClient: MerchantClient;
+    /**
+     * Negotiation CommerceClient（v0.3.0-C）。目录/库存/咨询等只读工具与
+     * 审批式写工具都不依赖它；仅磋商工具（claim/snapshot/submit）需要。
+     * 缺失时磋商工具不挂载（fail closed），其余能力包照常可用——只读目录
+     * 查询走公开搜索端点，无需谈判 token。
+     */
+    commerceClient?: CommerceClient;
+    /**
+     * Merchant 经营事实数据源（v0.7.0 CommerceDataSource）。提供时只读目录
+     * 工具改从数据源读取（本地商品库 / ERP 适配器）；缺省走公开搜索端点。
+     * 数据侧边界：不负责发现远端 Agent（架构 rev1.4.1 §33）。
+     */
+    dataSource?: CommerceDataSource;
+    broker: CredentialBroker;
+    approvals: WriteApprovalCandidateStore;
+    mode: () => AgentMode;
+    now: () => string;
+    /** Register /approve execution hooks for pending candidates. */
+    registerPending?: WriteGateDeps["registerPending"];
+    /**
+     * Read the merchant's own Restricted memory values (Vault). Owner-only:
+     * results must never be written into public messages, offers, tool
+     * arguments, proposals or logs.
+     */
+    privateValues?: () => Array<{
+        key: string;
+        value: string;
+    }>;
+}
+export declare function buildMerchantTools(deps: MerchantToolDeps): Tool[];
+export type { WriteGateResult };