@harrylabsj/kiwi 0.7.9 → 0.7.11

package/dist/merchant/decision-backend.d.ts

@@ -0,0 +1,82 @@
+/**
+ * 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 NegotiationDecision } from "../negotiation/types.js";
+import type { MerchantPolicy } from "../config/profile.js";
+/** merchant role bounds：只产 propose / counter（决策 action 枚举的子集）。 */
+export type MerchantDecisionAction = "propose" | "counter";
+export interface MerchantDecisionSuggestionInput {
+    action: MerchantDecisionAction;
+    sku: string;
+    quantity: number;
+    /** list 价（resolveProduct 输出的 minor units）+ 真实商品事实（供 prompt）。 */
+    product: {
+        priceMinor: number;
+        currency: string;
+        stock?: number;
+        title?: string;
+    };
+    /** merchant policy（floor / max discount 等）。safe subset 进 prompt，floor 不进。 */
+    policy?: MerchantPolicy;
+    conversationId: string;
+    /** 决策 schema 要求整数 ≥1；KNP 用字符串消息 id，此处传合成值（harness 约定）。 */
+    inReplyToMessageId?: number;
+    snapshot?: Record<string, unknown>;
+}
+/** 受限推理后端：返回不可信、schema 合法候选；任何失败 → null。永不写。 */
+export interface MerchantDecisionBackend {
+    suggest(input: MerchantDecisionSuggestionInput): Promise<NegotiationDecision | null>;
+}
+/**
+ * 从模型输出提取 JSON 对象（容忍 ```json 围栏 / 前后缀文本）。复制自 harness。
+ */
+export declare function extractJson(text: string): unknown;
+/**
+ * 白名单消毒 + 冻结契约校验。未知键先剥（模型可能加 thinking/注释）；再
+ * validateAgainst("decision")（复用生产校验器，src/contracts/schemas.ts）。
+ * merchant role bound：action ∈ {propose, counter} 且 proposal 存在才接受。
+ */
+export declare function sanitizeDecision(raw: unknown): NegotiationDecision | null;
+export interface DeepSeekDecisionBackendOptions {
+    /** resolver 惰性读 env（resolveSecret），请求时才解析。 */
+    apiKey: string | (() => string);
+    model?: string;
+    baseUrl?: string;
+    timeoutMs?: number;
+    temperature?: number;
+    fetchImpl?: typeof fetch;
+}
+export declare class DeepSeekDecisionBackend implements MerchantDecisionBackend {
+    private readonly opts;
+    constructor(opts: DeepSeekDecisionBackendOptions);
+    suggest(input: MerchantDecisionSuggestionInput): Promise<NegotiationDecision | null>;
+}
+export declare class MockDecisionBackend implements MerchantDecisionBackend {
+    suggest(input: MerchantDecisionSuggestionInput): Promise<NegotiationDecision | null>;
+}
+/**
+ * 候选 → {minor 单价, 可选公开说明} | null。backend 不可信：任何失败/缺失/
+ * 有损转换 → null（调用方回落确定性基线）。**backed 从不写。**
+ */
+export declare function consultDecisionBackend(backend: MerchantDecisionBackend | undefined, input: MerchantDecisionSuggestionInput): Promise<{
+    unitPriceMinor: number;
+    note?: string;
+} | null>;
+/**
+ * 从外发公开消息中剔除私有 floor token（镜像 negotiation-chat.redactPrivateFloor
+ * 的纯函数语义；复制避免 a2a→agent 跨树 import）。floor 是私有值，绝不出现在
+ * 商家对外公开回复里。
+ */
+export declare function redactPublicMessage(text: string, floor: number | undefined): string;

package/dist/merchant/decision-backend.js

@@ -0,0 +1,275 @@
+/**
+ * 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.
+ */
+/**
+ * MerchantDecisionBackend —— merchant 运行时的受限推理后端（DeepSeek Harness 运行时
+ * 插件，战略 v2.5 §6.9 / §十一 Phase 2）。
+ *
+ * 设计边界（§3.3 / §6.9）：
+ * - backend 只产出 **不可信** DecisionCandidate（`NegotiationDecision`），**不持有
+ *   Commerce token、不拥有状态机、无任何最终写入权**（0 写 by construction——
+ *   DeepSeek 后端只 fetch 模型端点，从不接触 commerce 端点）。
+ * - 调用方（createMerchantHandler）负责验证（冻结 decision 契约）+ 硬边界约束
+ *   （floor / max auto discount / list 封顶）后应用；任何失败 → 回落确定性基线。
+ * - 独立运行：merchant 是独立进程，不依赖宿主（Standalone-first §7.4）。
+ *
+ * 与 integrations/harnesses/deepseek-harness/validate-contract-cases.mjs 共享同一
+ * schema 驱动 prompt 与 extractJson —— 两处 prompt 须保持同步（本文件是运行时消费
+ * 方，harness 是只读 contract-gate 验证面）。
+ */
+import { validateAgainst } from "../contracts/schemas.js";
+import { PROTOCOL_VERSION } from "../negotiation/types.js";
+import { toMinorUnits as losslessToMinorUnits } from "../protocol/legacy-shopping-negotiation/money.js";
+// ---------------------------------------------------------------------------
+// JSON 提取 + 白名单消毒（schema additionalProperties:false 需先剥未知键）
+// ---------------------------------------------------------------------------
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function pick(obj, keys) {
+    const out = {};
+    for (const key of keys) {
+        if (obj[key] !== undefined)
+            out[key] = obj[key];
+    }
+    return out;
+}
+const DECISION_KEYS = [
+    "protocol_version",
+    "conversation_id",
+    "in_reply_to_message_id",
+    "action",
+    "proposal",
+    "open_issues",
+    "public_message",
+    "confidence",
+    "reason_codes",
+    "request_human_review",
+];
+const PROPOSAL_KEYS = [
+    "sku",
+    "quantity",
+    "unit_price",
+    "currency",
+    "stock",
+    "delivery",
+    "after_sales_policy_refs",
+    "valid_until",
+];
+const STOCK_KEYS = ["status", "quantity", "observed_at", "reserved"];
+const DELIVERY_KEYS = ["eta_start", "eta_end", "fee"];
+/**
+ * 从模型输出提取 JSON 对象（容忍 ```json 围栏 / 前后缀文本）。复制自 harness。
+ */
+export function extractJson(text) {
+    const fenced = text.match(/```(?:json)?\s*([\s\S]*?)```/);
+    const candidate = fenced !== null && fenced[1] !== undefined ? fenced[1] : text;
+    try {
+        return JSON.parse(candidate);
+    }
+    catch {
+        const start = candidate.indexOf("{");
+        const end = candidate.lastIndexOf("}");
+        if (start >= 0 && end > start) {
+            try {
+                return JSON.parse(candidate.slice(start, end + 1));
+            }
+            catch {
+                return undefined;
+            }
+        }
+        return undefined;
+    }
+}
+/**
+ * 白名单消毒 + 冻结契约校验。未知键先剥（模型可能加 thinking/注释）；再
+ * validateAgainst("decision")（复用生产校验器，src/contracts/schemas.ts）。
+ * merchant role bound：action ∈ {propose, counter} 且 proposal 存在才接受。
+ */
+export function sanitizeDecision(raw) {
+    if (!isObject(raw))
+        return null;
+    const decision = pick(raw, DECISION_KEYS);
+    if (isObject(decision.proposal)) {
+        const proposal = pick(decision.proposal, PROPOSAL_KEYS);
+        if (isObject(proposal.stock))
+            proposal.stock = pick(proposal.stock, STOCK_KEYS);
+        if (isObject(proposal.delivery))
+            proposal.delivery = pick(proposal.delivery, DELIVERY_KEYS);
+        decision.proposal = proposal;
+    }
+    const errors = validateAgainst("decision", decision);
+    if (errors.length > 0)
+        return null;
+    const candidate = decision;
+    if ((candidate.action !== "propose" && candidate.action !== "counter") || candidate.proposal === undefined) {
+        return null;
+    }
+    return candidate;
+}
+const DEFAULT_MODEL = "deepseek-v4-flash";
+const DEFAULT_BASE_URL = "https://api.deepseek.com";
+const DEFAULT_TIMEOUT_MS = 10_000;
+const DEFAULT_TEMPERATURE = 0.2;
+/** 构建 schema 驱动 prompt 模板（镜像 harness realCandidate；不含 floor）。 */
+function decisionTemplate(input) {
+    const nowIso = new Date().toISOString();
+    const stock = input.product.stock ?? 180;
+    return {
+        protocol_version: PROTOCOL_VERSION,
+        conversation_id: input.conversationId,
+        in_reply_to_message_id: input.inReplyToMessageId ?? 1,
+        action: input.action,
+        open_issues: [],
+        public_message: "按报价提供。",
+        reason_codes: ["within_policy"],
+        request_human_review: false,
+        confidence: 0.8,
+        proposal: {
+            sku: input.sku,
+            quantity: input.quantity,
+            unit_price: input.product.priceMinor / 100, // major 元
+            currency: input.product.currency,
+            stock: { status: stock > 0 ? "available" : "out_of_stock", quantity: stock, observed_at: nowIso, reserved: false },
+            delivery: { eta_start: nowIso, eta_end: nowIso, fee: 8 },
+            after_sales_policy_refs: [],
+            valid_until: "2099-12-31T23:59:59Z",
+        },
+    };
+}
+export class DeepSeekDecisionBackend {
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async suggest(input) {
+        let apiKey;
+        try {
+            apiKey = typeof this.opts.apiKey === "function" ? this.opts.apiKey() : this.opts.apiKey;
+        }
+        catch {
+            return null; // resolveSecret 失败 → fail-safe 回落
+        }
+        if (apiKey === "")
+            return null;
+        const template = decisionTemplate(input);
+        const system = "你是商家磋商决策助手。只输出一个 JSON 对象，严格符合给定结构，不要任何额外文字、markdown 或注释。";
+        const user = `action=${input.action} sku=${input.sku} quantity=${input.quantity} 商品=${JSON.stringify(input.product)}。` +
+            `输出 action="${input.action}" 的 decision，结构如下（字段名与嵌套完全一致，不得增加字段）：\n` +
+            JSON.stringify(template, null, 2);
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.opts.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+        try {
+            const resp = await (this.opts.fetchImpl ?? globalThis.fetch)(`${this.opts.baseUrl ?? DEFAULT_BASE_URL}/v1/chat/completions`, {
+                method: "POST",
+                headers: { "content-type": "application/json", authorization: `Bearer ${apiKey}` },
+                body: JSON.stringify({
+                    model: this.opts.model ?? DEFAULT_MODEL,
+                    messages: [
+                        { role: "system", content: system },
+                        { role: "user", content: user },
+                    ],
+                    thinking: { type: "disabled" }, // harness C1 规则：非推理任务
+                    response_format: { type: "json_object" },
+                    temperature: this.opts.temperature ?? DEFAULT_TEMPERATURE,
+                }),
+                signal: controller.signal,
+            });
+            if (!resp.ok)
+                return null;
+            const data = (await resp.json());
+            return sanitizeDecision(extractJson(data.choices?.[0]?.message?.content ?? ""));
+        }
+        catch {
+            return null; // 网络/超时/解析失败 → fail-safe
+        }
+        finally {
+            clearTimeout(timer); // 测试无悬挂 timer
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Mock 后端（确定性，镜像 harness mockCandidate；测试 + 离线冒烟）
+// ---------------------------------------------------------------------------
+export class MockDecisionBackend {
+    async suggest(input) {
+        const qty = input.product.stock ?? 180;
+        const nowIso = new Date().toISOString();
+        return {
+            protocol_version: PROTOCOL_VERSION,
+            conversation_id: input.conversationId,
+            in_reply_to_message_id: input.inReplyToMessageId ?? 1,
+            action: input.action,
+            open_issues: [],
+            public_message: "按报价提供。",
+            reason_codes: ["within_policy"],
+            request_human_review: false,
+            confidence: 0.8,
+            proposal: {
+                sku: input.sku,
+                quantity: input.quantity,
+                unit_price: input.product.priceMinor / 100, // major 元
+                currency: input.product.currency,
+                stock: { status: qty > 0 ? "available" : "out_of_stock", quantity: qty, observed_at: nowIso, reserved: false },
+                delivery: { eta_start: nowIso, eta_end: nowIso, fee: 8 },
+                after_sales_policy_refs: [],
+                valid_until: "2099-12-31T23:59:59Z",
+            },
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// 桥接助手（handler 用）
+// ---------------------------------------------------------------------------
+/**
+ * 候选 → {minor 单价, 可选公开说明} | null。backend 不可信：任何失败/缺失/
+ * 有损转换 → null（调用方回落确定性基线）。**backed 从不写。**
+ */
+export async function consultDecisionBackend(backend, input) {
+    if (backend === undefined)
+        return null;
+    let decision = null;
+    try {
+        decision = await backend.suggest(input);
+    }
+    catch {
+        return null;
+    }
+    if (decision === null)
+        return null;
+    const proposal = decision.proposal;
+    if (proposal === undefined || typeof proposal.unit_price !== "number")
+        return null;
+    const converted = losslessToMinorUnits(proposal.unit_price, 2);
+    if (!converted.lossless)
+        return null; // money.ts：有损 → fail-closed
+    return {
+        unitPriceMinor: converted.amount_minor,
+        ...(decision.public_message !== undefined && decision.public_message !== ""
+            ? { note: decision.public_message }
+            : {}),
+    };
+}
+/**
+ * 从外发公开消息中剔除私有 floor token（镜像 negotiation-chat.redactPrivateFloor
+ * 的纯函数语义；复制避免 a2a→agent 跨树 import）。floor 是私有值，绝不出现在
+ * 商家对外公开回复里。
+ */
+export function redactPublicMessage(text, floor) {
+    if (floor === undefined || floor <= 0)
+        return text;
+    return text.split(String(floor)).join("[private-floor]");
+}
+//# sourceMappingURL=decision-backend.js.map

package/dist/merchant/decision-backend.js.map

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

package/dist/merchant/ops.d.ts

@@ -0,0 +1,80 @@
+/**
+ * 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 Ops API（战略 v2.5 §7.6 / §7.7）。
+ *
+ * Host/Hermes 作为 Operator Console 查看 RFQ 队列、处理 human_required、批准
+ * 异常报价、查看 Agreement/Analytics。Merchant Core 仍是状态权威；Ops 只投影
+ * 状态与接收审批输入（§7.5 Intelligence & Ops Plane）。
+ *
+ * 命名空间隔离（§7.7）：本服务用 **merchant token** 认证（`kiwi.merchant.*`）；
+ * 任何 Buyer token 不得访问 Merchant Ops，任何 Merchant Ops token 不得获得
+ * Buyer Principal Memory。与 `kiwi.buyer.*`（Buyer Kit）完全分离。
+ */
+export interface MerchantOpsServiceOptions {
+    baseUrl: string;
+    /** 商家 API token（merchant 作用域，非 buyer token）。 */
+    merchantToken: string;
+    timeoutMs?: number;
+    fetchImpl?: typeof fetch;
+}
+export interface RfqConversation {
+    id: string;
+    buyer_id: string;
+    sku: string;
+    status: string;
+    next_actor: string;
+    created_at: string;
+    updated_at: string;
+    last_sender: string;
+    message_count?: number;
+}
+export interface HumanReviewConversation {
+    id: string;
+    buyer_id: string;
+    status: string;
+    reason?: string;
+    created_at?: string;
+}
+export interface MerchantAnalytics {
+    merchant_id: string;
+    total_rfqs: number;
+    pending_rfqs: number;
+    completed_rfqs: number;
+    human_review_count: number;
+}
+export declare class MerchantOpsService {
+    private readonly baseUrl;
+    private readonly merchantToken;
+    private readonly timeoutMs;
+    private readonly fetchImpl;
+    constructor(options: MerchantOpsServiceOptions);
+    /** RFQ 队列：商家名下活跃会话（§7.6 查看 RFQ）。 */
+    listRfqQueue(merchantId: string): Promise<{
+        rfqs: RfqConversation[];
+    }>;
+    /** human_required 会话（§7.6 处理人工审核）。 */
+    listHumanReview(merchantId: string): Promise<{
+        conversations: HumanReviewConversation[];
+    }>;
+    /** 处理 human_required：resolve 会话（商家运营决定）。 */
+    resolveReview(merchantId: string, conversationId: string, decision: string): Promise<{
+        ok: boolean;
+    }>;
+    /** Analytics：RFQ 量、待办/完成、人工审核数（§7.6）。 */
+    analytics(merchantId: string): Promise<MerchantAnalytics>;
+    private getJson;
+}

package/dist/merchant/ops.js

@@ -0,0 +1,75 @@
+/**
+ * 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 MerchantOpsService {
+    baseUrl;
+    merchantToken;
+    timeoutMs;
+    fetchImpl;
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/+$/, "");
+        this.merchantToken = options.merchantToken;
+        this.timeoutMs = options.timeoutMs ?? 5000;
+        this.fetchImpl = options.fetchImpl ?? globalThis.fetch;
+    }
+    /** RFQ 队列：商家名下活跃会话（§7.6 查看 RFQ）。 */
+    async listRfqQueue(merchantId) {
+        const data = await this.getJson(`/merchants/${encodeURIComponent(merchantId)}/conversations`);
+        const rfqs = Array.isArray(data)
+            ? data
+            : ((data.conversations ?? data.results) ?? []);
+        return { rfqs };
+    }
+    /** human_required 会话（§7.6 处理人工审核）。 */
+    async listHumanReview(merchantId) {
+        const data = await this.getJson(`/merchants/${encodeURIComponent(merchantId)}/human-review`);
+        return { conversations: data.conversations ?? [] };
+    }
+    /** 处理 human_required：resolve 会话（商家运营决定）。 */
+    async resolveReview(merchantId, conversationId, decision) {
+        const res = await this.fetchImpl(`${this.baseUrl}/conversations/${encodeURIComponent(conversationId)}/human-review/resolve`, {
+            method: "POST",
+            headers: { authorization: `Bearer ${this.merchantToken}`, "content-type": "application/json" },
+            body: JSON.stringify({ decision, merchant_id: merchantId }),
+            signal: AbortSignal.timeout(this.timeoutMs),
+        });
+        if (!res.ok)
+            throw new Error(`resolve review ${res.status}`);
+        const data = (await res.json());
+        return { ok: data.ok === true };
+    }
+    /** Analytics：RFQ 量、待办/完成、人工审核数（§7.6）。 */
+    async analytics(merchantId) {
+        const { rfqs } = await this.listRfqQueue(merchantId);
+        const { conversations } = await this.listHumanReview(merchantId);
+        return {
+            merchant_id: merchantId,
+            total_rfqs: rfqs.length,
+            pending_rfqs: rfqs.filter((r) => r.status === "waiting_merchant").length,
+            completed_rfqs: rfqs.filter((r) => r.status === "closed").length,
+            human_review_count: conversations.length,
+        };
+    }
+    async getJson(path) {
+        const res = await this.fetchImpl(`${this.baseUrl}${path}`, {
+            headers: { authorization: `Bearer ${this.merchantToken}`, accept: "application/json" },
+            signal: AbortSignal.timeout(this.timeoutMs),
+        });
+        if (!res.ok)
+            throw new Error(`merchant ops ${path} ${res.status}`);
+        return (await res.json());
+    }
+}
+//# sourceMappingURL=ops.js.map

package/dist/merchant/ops.js.map

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

package/dist/merchant/ucp-profile.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 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 UCP Profile 生成（战略 v2.5 §7.1 Protocol Publishing / §7.8 UCP-ready）。
+ *
+ * 商家在 `/.well-known/ucp` 发布 UCP Profile：声明 Catalog service（指向真实
+ * 商品 endpoint）与 KNP 磋商 capability。Kiwi 的 Buyer 端（UcpProfileResolver）
+ * 通过该 profile 发现商家能力；商品 truth 仍在 merchant/marketplace，不落 Kiwi。
+ *
+ * UCP 命名不变量（基线 §8.3）：service 名 = {reverse-domain}.{service}，
+ * reverse-domain 反转即 namespace authority host；spec/schema URL origin MUST
+ * 与 namespace authority 一致。
+ */
+import type { UcpProfile } from "../discovery/ucp/types.js";
+export declare const UCP_VERSION = "2026-04-08";
+export interface MerchantUcpProfileOptions {
+    /** 商家规范域名（如 xihu-digital.example.com）——决定 namespace authority。 */
+    domain: string;
+    /** 商家 id（marketplace 商家 id，如 merchant-hz-xihu）。 */
+    merchantId: string;
+    /** 真实商品 catalog endpoint（marketplace search，如 http://127.0.0.1:8765/search/products）。 */
+    catalogEndpoint: string;
+}
+/** 由域名派生 reverse-domain（UCP §8.3：反转 authority host 的 label）。 */
+export declare function reverseDomain(domain: string): string;
+export declare function buildMerchantUcpProfile(options: MerchantUcpProfileOptions): UcpProfile;

package/dist/merchant/ucp-profile.js

@@ -0,0 +1,55 @@
+/**
+ * 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 const UCP_VERSION = "2026-04-08";
+/** 由域名派生 reverse-domain（UCP §8.3：反转 authority host 的 label）。 */
+export function reverseDomain(domain) {
+    return domain.split(".").reverse().join(".");
+}
+export function buildMerchantUcpProfile(options) {
+    const authority = options.domain;
+    const rd = reverseDomain(options.domain);
+    const catalogService = `${rd}.catalog`;
+    const negotiationCapability = "com.harrylabsj.kiwi.shopping.negotiation";
+    return {
+        ucp: {
+            version: UCP_VERSION,
+            services: {
+                [catalogService]: [
+                    {
+                        version: UCP_VERSION,
+                        spec: `https://${authority}/.well-known/ucp#catalog`,
+                        transport: "rest",
+                        endpoint: options.catalogEndpoint,
+                        schema: `https://${authority}/schemas/catalog.json`,
+                    },
+                ],
+            },
+            capabilities: {
+                [negotiationCapability]: [
+                    {
+                        version: "1.0",
+                        spec: "https://kiwi.harrylabsj.com/spec/negotiation/1.0",
+                        schema: "https://kiwi.harrylabsj.com/schemas/negotiation/1.0/schema.json",
+                    },
+                ],
+            },
+        },
+        signing_keys: [],
+        // 商家元信息（非 UCP 标准字段，forward-compat）。
+        merchant_id: options.merchantId,
+    };
+}
+//# sourceMappingURL=ucp-profile.js.map

package/dist/merchant/ucp-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ucp-profile.js","sourceRoot":"","sources":["../../src/merchant/ucp-profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAgBH,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAC;AAWxC,gEAAgE;AAChE,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAkC;IACxE,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IACjC,MAAM,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,cAAc,GAAG,GAAG,EAAE,UAAU,CAAC;IACvC,MAAM,qBAAqB,GAAG,0CAA0C,CAAC;IAEzE,OAAO;QACL,GAAG,EAAE;YACH,OAAO,EAAE,WAAW;YACpB,QAAQ,EAAE;gBACR,CAAC,cAAc,CAAC,EAAE;oBAChB;wBACE,OAAO,EAAE,WAAW;wBACpB,IAAI,EAAE,WAAW,SAAS,0BAA0B;wBACpD,SAAS,EAAE,MAAM;wBACjB,QAAQ,EAAE,OAAO,CAAC,eAAe;wBACjC,MAAM,EAAE,WAAW,SAAS,uBAAuB;qBACpD;iBACF;aACF;YACD,YAAY,EAAE;gBACZ,CAAC,qBAAqB,CAAC,EAAE;oBACvB;wBACE,OAAO,EAAE,KAAK;wBACd,IAAI,EAAE,kDAAkD;wBACxD,MAAM,EAAE,iEAAiE;qBAC1E;iBACF;aACF;SACF;QACD,YAAY,EAAE,EAAE;QAChB,oCAAoC;QACpC,WAAW,EAAE,OAAO,CAAC,UAAU;KAChC,CAAC;AACJ,CAAC"}

package/dist/product-cli.d.ts

@@ -42,7 +42,7 @@ export declare const DEFAULT_PROFILE_PATH: string;
  */
 export declare function writeDefaultProfile(yaml: string, profilePath?: string): void;
 /** 与 package.json / USAGE 同步的产品版本。 */
-export declare const PRODUCT_VERSION = "0.7.9";
+export declare const PRODUCT_VERSION = "0.7.11";
 /**
  * 缺省 kiwi-catalog 地址（单一来源，cli.ts 各处解析一致）。
  *

package/dist/product-cli.js

@@ -51,7 +51,7 @@ export function writeDefaultProfile(yaml, profilePath) {
     writeFileSync(target, yaml, { mode: 0o600 });
 }
 /** 与 package.json / USAGE 同步的产品版本。 */
-export const PRODUCT_VERSION = "0.7.9";
+export const PRODUCT_VERSION = "0.7.11";
 /**
  * 缺省 kiwi-catalog 地址（单一来源，cli.ts 各处解析一致）。
  *