@harrylabsj/kiwi 0.6.0

package/dist/agent/connector/http-connector.js

@@ -0,0 +1,208 @@
+/**
+ * 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.
+ */
+/**
+ * shopping-cli HTTP Commerce Connector (design §15): read-side search
+ * endpoints only (GET /search/products, /search/merchants, /products/{sku}
+ * are public on the gateway — no token is sent for reads).
+ */
+import { createHash } from "node:crypto";
+import { ConnectorError, parseConnectorMerchant, parseConnectorProduct, } from "./types.js";
+import { isRedirectResponse, readJsonBody, SafeHttpError } from "../../net/safe-http.js";
+const REQUEST_TIMEOUT_MS = 10_000;
+export class ShoppingCliConnector {
+    connector_id = "shopping-cli";
+    platform = "shopping-cli";
+    baseUrl;
+    buyerBootstrapToken;
+    constructor(baseUrl, options = {}) {
+        this.baseUrl = baseUrl.replace(/\/+$/, "");
+        this.buyerBootstrapToken = options.buyerBootstrapToken;
+    }
+    async get(pathname, params) {
+        const url = `${this.baseUrl}${pathname}?${new URLSearchParams(params).toString()}`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+        let response;
+        try {
+            response = await fetch(url, {
+                method: "GET",
+                // 出站纪律（与 P0 七处客户端一致）：不跟随重定向 + 响应体读取在
+                // 超时覆盖内 + 大小上限。
+                redirect: "manual",
+                signal: controller.signal,
+                headers: { accept: "application/json" },
+            });
+        }
+        catch (err) {
+            throw new ConnectorError("transient", `connector request failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        if (isRedirectResponse(response)) {
+            throw new ConnectorError("transient", `connector must not follow redirects (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 ConnectorError(kind, `connector HTTP ${response.status} for ${pathname}`);
+        }
+        let payload;
+        try {
+            payload = await readJsonBody(response, { signal: controller.signal });
+        }
+        catch (err) {
+            if (controller.signal.aborted) {
+                throw new ConnectorError("transient", `connector request timed out after ${REQUEST_TIMEOUT_MS}ms`);
+            }
+            throw new ConnectorError("transient", err instanceof SafeHttpError && err.code === "response_too_large"
+                ? `connector response too large: ${err.message}`
+                : `connector returned non-JSON (HTTP ${response.status})`);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        return payload;
+    }
+    async searchProducts(query) {
+        const payload = (await this.get("/search/products", {
+            query: query.query ?? "",
+            city: query.city ?? "",
+            area: query.area ?? "",
+            ...(query.max_price !== undefined ? { max_price: String(query.max_price) } : {}),
+            include_out_of_stock: query.include_out_of_stock === true ? "true" : "",
+            ...(query.limit !== undefined ? { limit: String(query.limit) } : {}),
+            ...(query.offset !== undefined ? { offset: String(query.offset) } : {}),
+        }));
+        if (payload === null || typeof payload !== "object" || !Array.isArray(payload.results)) {
+            throw new ConnectorError("validation", "search/products response lacks a results array");
+        }
+        return payload.results.map((p) => parseConnectorProduct(p));
+    }
+    async getProduct(sku) {
+        const payload = (await this.get(`/products/${encodeURIComponent(sku)}`, {}));
+        if (payload === null || typeof payload !== "object" || payload.product === undefined) {
+            throw new ConnectorError("validation", "get product response lacks a product object");
+        }
+        return parseConnectorProduct(payload.product);
+    }
+    async searchMerchants(query) {
+        const payload = (await this.get("/search/merchants", {
+            query: query.query ?? "",
+            city: query.city ?? "",
+            ...(query.limit !== undefined ? { limit: String(query.limit) } : {}),
+            ...(query.offset !== undefined ? { offset: String(query.offset) } : {}),
+        }));
+        if (payload === null || typeof payload !== "object" || !Array.isArray(payload.results)) {
+            throw new ConnectorError("validation", "search/merchants response lacks a results array");
+        }
+        return payload.results.map((m) => parseConnectorMerchant(m));
+    }
+    /**
+     * Start a consultation via `POST /buyer/ask`. Requires the buyer bootstrap
+     * token in the Authorization header. The buyer task is only linked to the
+     * returned conversation — authoritative state stays in the marketplace.
+     */
+    async startConsultation(input) {
+        void input.merchant_id;
+        void input.sku;
+        if (this.buyerBootstrapToken === undefined) {
+            throw new ConnectorError("auth", "未配置 buyer bootstrap token（gateway 的 SHOPPING_BUYER_BOOTSTRAP_TOKEN）；无法发起咨询");
+        }
+        // Content-addressed idempotency key: a retried start after a lost response
+        // dedups on the gateway instead of creating a second conversation.
+        const idempotencyKey = createHash("sha256")
+            .update(`${input.buyer_id}:${input.sku}:${input.opening_message}`)
+            .digest("hex")
+            .slice(0, 16);
+        const payload = (await this.post("/buyer/ask", {
+            buyer_id: input.buyer_id,
+            text: input.opening_message,
+        }, {
+            authorization: `Bearer ${this.buyerBootstrapToken}`,
+            "idempotency-key": idempotencyKey,
+        }));
+        const conversationId = typeof payload.conversation_id === "string"
+            ? payload.conversation_id
+            : typeof payload.conversation?.id === "string"
+                ? (payload.conversation.id)
+                : undefined;
+        if (conversationId === undefined) {
+            throw new ConnectorError("validation", "buyer/ask response lacks a conversation id");
+        }
+        const status = typeof payload.status === "string"
+            ? payload.status
+            : typeof payload.conversation?.status === "string"
+                ? (payload.conversation.status)
+                : "waiting_merchant";
+        return { conversation_id: conversationId, status };
+    }
+    async post(pathname, body, headers) {
+        const url = `${this.baseUrl}${pathname}`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+        let response;
+        try {
+            response = await fetch(url, {
+                method: "POST",
+                // 出站纪律（同 get）：POST 携带 Bearer token——重定向会泄露给第三方。
+                redirect: "manual",
+                headers: {
+                    accept: "application/json",
+                    "content-type": "application/json",
+                    ...headers,
+                },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+        }
+        catch (err) {
+            throw new ConnectorError("transient", `connector request failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        if (isRedirectResponse(response)) {
+            throw new ConnectorError("transient", `connector must not follow redirects (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 ConnectorError(kind, `connector HTTP ${response.status} for ${pathname}`);
+        }
+        let payload;
+        try {
+            payload = await readJsonBody(response, { signal: controller.signal });
+        }
+        catch (err) {
+            if (controller.signal.aborted) {
+                throw new ConnectorError("transient", `connector request timed out after ${REQUEST_TIMEOUT_MS}ms`);
+            }
+            throw new ConnectorError("transient", err instanceof SafeHttpError && err.code === "response_too_large"
+                ? `connector response too large: ${err.message}`
+                : `connector returned non-JSON (HTTP ${response.status})`);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        return payload;
+    }
+}
+//# sourceMappingURL=http-connector.js.map

package/dist/agent/connector/http-connector.js.map

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

package/dist/agent/connector/types.d.ts

@@ -0,0 +1,103 @@
+/**
+ * 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.
+ */
+/**
+ * Commerce Connector boundary (design §2.1.7, §15): the read-side search
+ * surface used by Buyer tasks. shopping-cli is the first connector; future
+ * external platforms implement the same interface.
+ *
+ * Connector payloads are untrusted external data (§17): every response is
+ * strictly parsed into these DTOs — known fields type-checked, unknown
+ * fields isolated (never passed through to the model or the database).
+ */
+/** Public merchant delivery rule (shopping-cli shape). */
+export interface ConnectorDelivery {
+    service_area: string;
+    fee: number;
+    currency: string;
+    eta_minutes: number;
+    radius_km: number;
+    notes: string;
+}
+export interface ConnectorMerchant {
+    id: string;
+    name: string;
+    city: string;
+    service_area: string;
+    hours: string;
+    tags: string[];
+    delivery: ConnectorDelivery;
+    product_count: number;
+}
+export interface ConnectorProduct {
+    sku: string;
+    merchant_id: string;
+    title: string;
+    description: string;
+    category: string;
+    tags: string[];
+    price: number;
+    currency: string;
+    stock: number;
+    delivery_attributes: string[];
+    delivery: ConnectorDelivery;
+    merchant: ConnectorMerchant;
+    warnings: string[];
+}
+export interface SearchProductsQuery {
+    query?: string;
+    city?: string;
+    area?: string;
+    max_price?: number;
+    include_out_of_stock?: boolean;
+    limit?: number;
+    offset?: number;
+}
+export interface SearchMerchantsQuery {
+    query?: string;
+    city?: string;
+    limit?: number;
+    offset?: number;
+}
+export type ConnectorErrorKind = "transient" | "validation" | "not_found" | "auth";
+export declare class ConnectorError extends Error {
+    readonly kind: ConnectorErrorKind;
+    constructor(kind: ConnectorErrorKind, message: string);
+}
+export interface CommerceConnector {
+    readonly connector_id: string;
+    readonly platform: string;
+    searchProducts(query: SearchProductsQuery): Promise<ConnectorProduct[]>;
+    getProduct(sku: string): Promise<ConnectorProduct>;
+    searchMerchants(query: SearchMerchantsQuery): Promise<ConnectorMerchant[]>;
+    /**
+     * Start a consultation (design §11.8/§20-C): create an authoritative
+     * Marketplace Conversation about a product and return its id. The buyer task
+     * is only *linked* to this conversation — the conversation itself stays
+     * authoritative in the marketplace. Reuses the existing negotiation runtime;
+     * this never copies or duplicates authoritative state.
+     */
+    startConsultation(input: {
+        buyer_id: string;
+        sku: string;
+        merchant_id: string;
+        opening_message: string;
+    }): Promise<{
+        conversation_id: string;
+        status: string;
+    }>;
+}
+export declare function parseConnectorMerchant(value: unknown): ConnectorMerchant;
+export declare function parseConnectorProduct(value: unknown): ConnectorProduct;

package/dist/agent/connector/types.js

@@ -0,0 +1,97 @@
+/**
+ * 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 class ConnectorError extends Error {
+    kind;
+    constructor(kind, message) {
+        super(message);
+        this.name = "ConnectorError";
+        this.kind = kind;
+    }
+}
+// ---- strict parsing (isolate unknown fields) ------------------------------
+function fail(message) {
+    throw new ConnectorError("validation", `connector payload rejected: ${message}`);
+}
+function reqString(value, at) {
+    if (typeof value !== "string")
+        fail(`${at} must be a string`);
+    return value;
+}
+function reqNumber(value, at) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        fail(`${at} must be a finite number`);
+    return value;
+}
+function stringArray(value, at) {
+    if (!Array.isArray(value) || value.some((v) => typeof v !== "string")) {
+        fail(`${at} must be a string array`);
+    }
+    return value;
+}
+function parseDelivery(value, at) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        fail(`${at} must be an object`);
+    }
+    const v = value;
+    return {
+        service_area: typeof v.service_area === "string" ? v.service_area : "",
+        fee: reqNumber(v.fee ?? 0, `${at}.fee`),
+        currency: typeof v.currency === "string" ? v.currency : "CNY",
+        eta_minutes: reqNumber(v.eta_minutes ?? 0, `${at}.eta_minutes`),
+        radius_km: reqNumber(v.radius_km ?? 0, `${at}.radius_km`),
+        notes: typeof v.notes === "string" ? v.notes : "",
+    };
+}
+export function parseConnectorMerchant(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        fail("merchant must be an object");
+    }
+    const v = value;
+    return {
+        id: reqString(v.id, "merchant.id"),
+        name: typeof v.name === "string" ? v.name : "",
+        city: typeof v.city === "string" ? v.city : "",
+        service_area: typeof v.service_area === "string" ? v.service_area : "",
+        hours: typeof v.hours === "string" ? v.hours : "",
+        tags: Array.isArray(v.tags) ? stringArray(v.tags, "merchant.tags") : [],
+        delivery: parseDelivery(v.delivery ?? {}, "merchant.delivery"),
+        product_count: typeof v.product_count === "number" ? v.product_count : 0,
+    };
+}
+export function parseConnectorProduct(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        fail("product must be an object");
+    }
+    const v = value;
+    return {
+        sku: reqString(v.sku, "product.sku"),
+        merchant_id: reqString(v.merchant_id, "product.merchant_id"),
+        title: reqString(v.title, "product.title"),
+        description: typeof v.description === "string" ? v.description : "",
+        category: typeof v.category === "string" ? v.category : "",
+        tags: Array.isArray(v.tags) ? stringArray(v.tags, "product.tags") : [],
+        price: reqNumber(v.price, "product.price"),
+        currency: reqString(v.currency, "product.currency"),
+        stock: reqNumber(v.stock, "product.stock"),
+        delivery_attributes: Array.isArray(v.delivery_attributes)
+            ? stringArray(v.delivery_attributes, "product.delivery_attributes")
+            : [],
+        delivery: parseDelivery(v.delivery ?? {}, "product.delivery"),
+        merchant: parseConnectorMerchant(v.merchant ?? {}),
+        warnings: Array.isArray(v.warnings) ? stringArray(v.warnings, "product.warnings") : [],
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/agent/connector/types.js.map

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

package/dist/agent/fake-chat-model.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 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 { Model, MutableModels } from "@earendil-works/pi-ai";
+export declare const FAKE_CHAT_MODEL_ID = "fake-chat-model";
+/** A Models collection whose only model is the deterministic chat fake. */
+export declare function createFakeChatModels(): {
+    models: MutableModels;
+    model: Model<string>;
+};

package/dist/agent/fake-chat-model.js

@@ -0,0 +1,134 @@
+/**
+ * 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 chat model for `model.provider: fake` (offline smoke
+ * runs and tests — no network, no keys). Rule-based, NOT a real model:
+ *
+ * - "记住 X"          -> remember tool call (explicit statement), then confirms;
+ * - "忘掉/忘记 X"     -> forget_memory tool call when an id is mentioned;
+ * - anything else     -> a canned acknowledgment (real models answer freely).
+ *
+ * Returns a Models collection with the faux provider registered, ready for
+ * the AgentHarness.
+ */
+import { createModels, fauxAssistantMessage, fauxProvider, fauxToolCall } from "@earendil-works/pi-ai";
+import { TOOL_CORRECT_MEMORY, TOOL_FORGET_MEMORY, TOOL_REMEMBER, } from "./chat-tools.js";
+export const FAKE_CHAT_MODEL_ID = "fake-chat-model";
+function lastUserText(context) {
+    for (let i = context.messages.length - 1; i >= 0; i--) {
+        const m = context.messages[i];
+        if (m && m.role === "user") {
+            const content = m.content;
+            if (typeof content === "string")
+                return content;
+            if (Array.isArray(content)) {
+                const text = content
+                    .filter((b) => b.type === "text")
+                    .map((b) => b.text)
+                    .join(" ");
+                if (text !== "")
+                    return text;
+            }
+        }
+    }
+    return "";
+}
+function hasToolResult(context, toolName) {
+    return context.messages.some((m) => m && m.role === "toolResult" && m.toolName === toolName);
+}
+function toolResultText(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 "";
+}
+/** Precise personal data the offline demo must route to the Vault, not plaintext. */
+const SENSITIVE_KIND = [
+    { kind: "address", pattern: /(住址|地址|住在|家住|收货|寄到).{0,20}\d/ },
+    { kind: "contact", pattern: /(电话|手机|微信号|联系方式|邮箱|e-?mail).{0,10}\d{5,}/i },
+    { kind: "private_budget", pattern: /(预算|心理价).{0,6}\d/ },
+    { kind: "merchant_cost", pattern: /(成本|进价).{0,6}\d/ },
+    { kind: "merchant_floor", pattern: /(底价|最低价).{0,6}\d/ },
+    { kind: "other", pattern: /(身份证|银行卡|卡号|账号)/ },
+];
+function classifyNote(note) {
+    for (const { kind, pattern } of SENSITIVE_KIND) {
+        if (pattern.test(note))
+            return { kind };
+    }
+    return undefined;
+}
+/** One canned behavior step; repeats as a safety net for retries. */
+function respond(context) {
+    if (hasToolResult(context, TOOL_REMEMBER)) {
+        return fauxAssistantMessage(`好的，${toolResultText(context, TOOL_REMEMBER)}`);
+    }
+    if (hasToolResult(context, TOOL_FORGET_MEMORY)) {
+        return fauxAssistantMessage(`好的，${toolResultText(context, TOOL_FORGET_MEMORY)}`);
+    }
+    if (hasToolResult(context, TOOL_CORRECT_MEMORY)) {
+        return fauxAssistantMessage(`好的，${toolResultText(context, TOOL_CORRECT_MEMORY)}`);
+    }
+    const text = lastUserText(context);
+    const rememberMatch = /^记住[:：]?\s*(.+)$/.exec(text.trim());
+    if (rememberMatch !== null) {
+        const note = (rememberMatch[1] ?? "").trim();
+        const sensitive = classifyNote(note);
+        return fauxAssistantMessage([
+            fauxToolCall(TOOL_REMEMBER, {
+                namespace: "preference",
+                key: `chat.note.${note.slice(0, 24).replace(/\s+/g, "_")}`,
+                source_kind: "explicit",
+                explicit_user_statement: true,
+                reason_summary: `用户明确要求记住：${note.slice(0, 40)}`,
+                // Precise personal data (address/contact/budget/cost/floor) is a
+                // Restricted Vault write — never plaintext, and it needs a data key.
+                ...(sensitive !== undefined
+                    ? {
+                        restricted_kind: sensitive.kind,
+                        restricted_value: note,
+                        sensitivity: "restricted",
+                    }
+                    : { value: { note }, sensitivity: "normal" }),
+            }),
+        ]);
+    }
+    const forgetMatch = /^(?:忘掉|忘记)\s*(mem_[0-9a-z]+)/i.exec(text.trim());
+    if (forgetMatch !== null) {
+        return fauxAssistantMessage([
+            fauxToolCall(TOOL_FORGET_MEMORY, {
+                memory_id: (forgetMatch[1] ?? "").toLowerCase(),
+                reason: "用户要求遗忘",
+            }),
+        ]);
+    }
+    return fauxAssistantMessage(`（fake 模型）我听到了：「${text.slice(0, 80)}」。真实模型接入后我会自由回答；` +
+        "你可以说「记住 …」，或用 /memory、/forget、/correct、/why。");
+}
+/** A Models collection whose only model is the deterministic chat fake. */
+export function createFakeChatModels() {
+    const handle = fauxProvider({ models: [{ id: FAKE_CHAT_MODEL_ID, name: FAKE_CHAT_MODEL_ID }] });
+    handle.setResponses([respond, respond, respond, respond]);
+    const models = createModels();
+    models.setProvider(handle.provider);
+    return { models, model: handle.getModel() };
+}
+//# sourceMappingURL=fake-chat-model.js.map

package/dist/agent/fake-chat-model.js.map

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