@harrylabsj/kiwi 0.7.22 → 0.9.0

package/dist/merchant-core/product-import.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 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.
+ */
+/**
+ * CSV 商品导入闭环（V2 阶段四 F04：src/merchant-core/product-import.ts）。
+ *
+ * CSV 解析预览（新增/更新/错误逐行回执）→ 确认（命令记录）→ 执行（逐行
+ * 回执，部分成功 partially_failed；相同幂等键返回同一 operation，不重复
+ * 导入/发布）。撤回走同一闭环（listing 销售状态语义，F08）。
+ *
+ * CSV 列：sku,title,price,stock[,currency][,category][,description]
+ * （首行表头；分隔符逗号；空行跳过）。解析失败行进入错误回执，不阻塞其他行。
+ */
+import type { MerchantClient, MerchantProductInput } from "../agent/merchant/types.js";
+import type { MerchantOperation, MerchantOperationStore } from "./operations.js";
+export interface CsvImportRowPlan {
+    line: number;
+    sku: string;
+    action: "create" | "update";
+    ok: boolean;
+    error?: string;
+}
+export interface CsvImportPreview {
+    total_lines: number;
+    valid: number;
+    creates: number;
+    updates: number;
+    row_errors: Array<{
+        line: number;
+        error: string;
+    }>;
+}
+/** 解析 CSV → 行计划（逐行错误回执，不阻塞其他行）。 */
+export declare function parseProductCsv(csv: string, existingSkus: ReadonlySet<string>): {
+    inputs: Array<{
+        line: number;
+        input: MerchantProductInput;
+    }>;
+    preview: CsvImportPreview;
+};
+export declare const PRODUCTS_IMPORT_OPERATION_KIND = "products_import";
+/**
+ * 执行 CSV 导入（命令执行器调用）：逐行 create/update + 逐项回执；
+ * 幂等键命中已完成 operation → 直接返回（不重复导入）。
+ */
+export declare function executeProductsImport(input: {
+    csv: string;
+    idempotencyKey: string;
+    merchantId: string;
+    merchantClient: MerchantClient;
+    operations: MerchantOperationStore;
+}): Promise<MerchantOperation | {
+    ok: false;
+    operation: MerchantOperation;
+}>;

package/dist/merchant-core/product-import.js

@@ -0,0 +1,160 @@
+/**
+ * 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.
+ */
+const REQUIRED_COLUMNS = ["sku", "title", "price", "stock"];
+/** 解析 CSV → 行计划（逐行错误回执，不阻塞其他行）。 */
+export function parseProductCsv(csv, existingSkus) {
+    const lines = csv.split(/\r?\n/).filter((l) => l.trim() !== "");
+    const rowErrors = [];
+    const inputs = [];
+    if (lines.length === 0) {
+        return {
+            inputs,
+            preview: { total_lines: 0, valid: 0, creates: 0, updates: 0, row_errors: [] },
+        };
+    }
+    const header = lines[0]?.split(",").map((c) => c.trim()) ?? [];
+    for (const col of REQUIRED_COLUMNS) {
+        if (!header.includes(col)) {
+            rowErrors.push({ line: 1, error: `表头缺列 ${col}` });
+            return {
+                inputs,
+                preview: {
+                    total_lines: lines.length,
+                    valid: 0,
+                    creates: 0,
+                    updates: 0,
+                    row_errors: rowErrors,
+                },
+            };
+        }
+    }
+    const idx = Object.fromEntries(header.map((c, i) => [c, i]));
+    for (let i = 1; i < lines.length; i += 1) {
+        const lineNo = i + 1;
+        const cells = (lines[i] ?? "").split(",").map((c) => c.trim());
+        const sku = cells[idx.sku ?? -1] ?? "";
+        const title = cells[idx.title ?? -1] ?? "";
+        const price = Number(cells[idx.price ?? -1]);
+        const stock = Number(cells[idx.stock ?? -1]);
+        if (sku === "" || title === "") {
+            rowErrors.push({ line: lineNo, error: "sku/title 为空" });
+            continue;
+        }
+        if (!Number.isFinite(price) || price < 0) {
+            rowErrors.push({ line: lineNo, error: `price 非法（${cells[idx.price ?? -1] ?? ""}）` });
+            continue;
+        }
+        if (!Number.isInteger(stock) || stock < 0) {
+            rowErrors.push({
+                line: lineNo,
+                error: `stock 必须是非负整数（${cells[idx.stock ?? -1] ?? ""}）`,
+            });
+            continue;
+        }
+        inputs.push({
+            line: lineNo,
+            input: {
+                sku,
+                merchant_id: "", // 由执行器补 owner
+                title,
+                price,
+                stock,
+                ...(typeof idx.currency === "number" &&
+                    cells[idx.currency] !== undefined &&
+                    cells[idx.currency] !== ""
+                    ? { currency: cells[idx.currency] }
+                    : {}),
+                ...(typeof idx.category === "number" &&
+                    cells[idx.category] !== undefined &&
+                    cells[idx.category] !== ""
+                    ? { category: cells[idx.category] }
+                    : {}),
+                ...(typeof idx.description === "number" && cells[idx.description] !== undefined
+                    ? { description: cells[idx.description] }
+                    : {}),
+            },
+        });
+    }
+    const creates = inputs.filter((r) => !existingSkus.has(r.input.sku)).length;
+    return {
+        inputs,
+        preview: {
+            total_lines: lines.length - 1,
+            valid: inputs.length,
+            creates,
+            updates: inputs.length - creates,
+            row_errors: rowErrors,
+        },
+    };
+}
+export const PRODUCTS_IMPORT_OPERATION_KIND = "products_import";
+/**
+ * 执行 CSV 导入（命令执行器调用）：逐行 create/update + 逐项回执；
+ * 幂等键命中已完成 operation → 直接返回（不重复导入）。
+ */
+export async function executeProductsImport(input) {
+    const existing = input.operations.createOrGet({
+        kind: PRODUCTS_IMPORT_OPERATION_KIND,
+        idempotencyKey: input.idempotencyKey,
+    });
+    if (!existing.created) {
+        // 幂等：相同幂等键返回同一 operation（已终态的不重复执行；queued/running
+        // 的先对账——本轮返回现状不盲目重发）。
+        return existing.operation;
+    }
+    const operation = input.operations.markRunning(existing.operation.operation_id);
+    try {
+        const current = await input.merchantClient.listProducts(input.merchantId);
+        const existingSkus = new Set(current.map((p) => p.sku));
+        const { inputs, preview } = parseProductCsv(input.csv, existingSkus);
+        const receipts = preview.row_errors.map((e) => ({
+            item: `line ${e.line}`,
+            ok: false,
+            detail: e.error,
+        }));
+        for (const { line, input: product } of inputs) {
+            try {
+                if (existingSkus.has(product.sku)) {
+                    await input.merchantClient.updateProduct(product.sku, {
+                        title: product.title,
+                        price: product.price,
+                        stock: product.stock,
+                    });
+                    receipts.push({ item: `line ${line}`, ok: true, detail: `update ${product.sku}` });
+                }
+                else {
+                    await input.merchantClient.createProduct({ ...product, merchant_id: input.merchantId });
+                    receipts.push({ item: `line ${line}`, ok: true, detail: `create ${product.sku}` });
+                }
+            }
+            catch (err) {
+                receipts.push({
+                    item: `line ${line}`,
+                    ok: false,
+                    detail: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        const finished = input.operations.finish(operation.operation_id, receipts);
+        // 全部行失败 → ok:false（审查 P1：否则候选仍被标 executed，审计谎报成功）
+        return finished.status === "failed" ? { ok: false, operation: finished } : finished;
+    }
+    catch (err) {
+        const failed = input.operations.finish(operation.operation_id, [], err instanceof Error ? err.message : String(err));
+        return { ok: false, operation: failed };
+    }
+}
+//# sourceMappingURL=product-import.js.map

package/dist/merchant-core/product-import.js.map

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

package/dist/merchant-core/service.d.ts

@@ -0,0 +1,203 @@
+/**
+ * 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 { A2aNegotiationRow } from "../merchant/workbench-service.js";
+import { MerchantWorkbenchService, type MerchantWorkbenchServiceDeps } from "../merchant/workbench-service.js";
+import type { MerchantOAuthStore } from "../auth/merchant-oauth.js";
+import { MerchantCommandLog } from "./commands.js";
+import type { ApplyPolicyResult } from "./policy-runtime.js";
+import type { MerchantPolicy } from "../config/profile.js";
+import type { MerchantOperation, MerchantOperationStore } from "./operations.js";
+import { type UnifiedNegotiationRow } from "./negotiation-adapters.js";
+export interface MerchantCoreServiceDeps extends MerchantWorkbenchServiceDeps {
+    /** 私密阈值读取（Vault；仅管理面接缝调用，读取写审计）。 */
+    privateValues?: () => Array<{
+        key: string;
+        value: string;
+    }>;
+    /** 私密读取审计目录（jsonl 追加；缺省则私密读取拒绝——fail-closed 不裸读）。 */
+    auditDir?: string;
+    /** 命令记录的授权主体（批准/拒绝主体一致性校验；= 审批 store 的 principal）。 */
+    commandPrincipalId?: string;
+    /** F08 能力探测结果：listing_pause=false 时 prepare_listing_change fail-closed「不可得」。 */
+    capabilities?: {
+        listing_pause?: boolean;
+    };
+    /** F14：shopping 轨人工处理接口（可选；缺省执行时「不可得」）。 */
+    resolveShoppingReview?: (input: {
+        conversation_id: string;
+        resolution: string;
+    }) => Promise<unknown>;
+    /** F17：策略热更新写入接缝（可选；缺省执行时「不可得」）。BUG-07：实现
+     *  须校验+原子写完整生效策略并返回版本/digest（见 MerchantPolicyRuntime）。 */
+    applyPolicyOverride?: ((patch: Record<string, unknown>) => Promise<ApplyPolicyResult>) | ((patch: Record<string, unknown>) => ApplyPolicyResult);
+    /** 运行中策略读取（BUG-07）：配置后执行器硬策略按当前生效策略执行。 */
+    currentPolicy?: () => MerchantPolicy | undefined;
+    /** 长任务 operation store（V2 阶段四；CSV 导入/撤回幂等与逐项回执）。 */
+    operations?: MerchantOperationStore;
+    /** merchantDataDir（F29 微信绑定状态读取等本地状态接缝）。 */
+    merchantDataDir?: string;
+    /** 一次性确认凭证存储（BUG-02；配置后 execute/reject 必须携带有效凭证）。 */
+    confirmations?: MerchantOAuthStore;
+}
+export declare class MerchantCoreService {
+    /** V1 facade（委托转发；facade 语义不变）。 */
+    readonly workbench: MerchantWorkbenchService;
+    private readonly intelligence?;
+    private readonly privateValues?;
+    private readonly auditDir?;
+    private readonly capabilities?;
+    private readonly resolveShoppingReview?;
+    private readonly applyPolicyOverride?;
+    private readonly currentPolicy?;
+    private readonly commandPrincipalId;
+    private readonly confirmationStore?;
+    private readonly operationsStore?;
+    private readonly merchantDataDir?;
+    private readonly now;
+    private readonly principalId;
+    private readonly approvalsRef;
+    private readonly profileRef;
+    private readonly modeRef;
+    constructor(deps: MerchantCoreServiceDeps);
+    listPublicProducts(): Promise<{
+        items: import("../merchant/workbench-service.js").PublicProductView[];
+        source: "data_source" | "merchant_client";
+    }>;
+    getPublicProduct(sku: string, merchantId?: string): Promise<import("../merchant/workbench-service.js").PublicProductView>;
+    getInventorySnapshot(sku: string): Promise<import("../agent/merchant/types.js").InventorySnapshot>;
+    listA2aNegotiations(limit?: unknown): Promise<{
+        total: number;
+        items: A2aNegotiationRow[];
+    }>;
+    listActiveConsultations(): Promise<A2aNegotiationRow[]>;
+    listHumanReviews(): Promise<import("../merchant/workbench-service.js").HumanReviewRow[]>;
+    getAnalytics(period?: string): Promise<import("../agent/merchant/intelligence/types.js").MerchantBusinessSnapshot>;
+    draftProductChange(input: Parameters<MerchantWorkbenchService["draftProductChange"]>[0]): Promise<import("../merchant/workbench-service.js").DraftProductChangeResult>;
+    recoverPendingDrafts(): number;
+    approveCandidate(candidateId: string): Promise<import("../agent/merchant/action-candidate.js").ApprovalExecutionResult>;
+    private commandLogInstance;
+    /** 持久命令记录（lazy；store 即 WriteApprovalCandidateStore，单 owner 写）。 */
+    get commands(): MerchantCommandLog;
+    /** prepare：商品创建（force_pending 候选，绝不直接执行）。入参白名单
+     *  校验 + merchant_id 钉死归属（审查 P1：否则批准后执行必然失败或可跨
+     *  商家写，白烧人工确认）。 */
+    prepareProductCreate(input: {
+        product: unknown;
+        reason?: string;
+    }): Promise<import("./commands.js").PreparedCommand>;
+    /** prepare：库存调整。 */
+    prepareInventoryUpdate(input: {
+        sku: string;
+        stock: number;
+        reason?: string;
+    }): Promise<import("./commands.js").PreparedCommand>;
+    /** prepare：listing 销售状态变更（F08 语义；上游不支持 → fail-closed「不可得」）。 */
+    prepareListingChange(input: {
+        sku: string;
+        paused: boolean;
+        reason?: string;
+    }): Promise<import("./commands.js").PreparedCommand>;
+    /** prepare：人工处理（F14 两轨；A2A 轨执行面 fail-closed「不可得」留后续）。 */
+    prepareReviewResolve(input: {
+        source_protocol: "a2a" | "shopping";
+        source_id: string;
+        resolution: string;
+        reason?: string;
+    }): Promise<import("./commands.js").PreparedCommand>;
+    /** prepare：策略变更（F17 热更新；执行器写入覆盖层即生效）。 */
+    preparePolicyChange(input: {
+        patch: Record<string, unknown>;
+        reason?: string;
+    }): Promise<import("./commands.js").PreparedCommand>;
+    /** 确认通道：批准并执行（确认凭证 + 重校验 + 幂等 + 回读）。单商家单主体
+     *  实例的便捷包装——主体恒为本实例 commandPrincipalId；跨主体校验在
+     *  commands.executeApproved（管理页传入会话主体时真实生效）。 */
+    executeApproved(commandId: string, confirmationToken?: string): Promise<import("../agent/merchant/action-candidate.js").ApprovalExecutionResult>;
+    /** 确认通道：拒绝候选（同上：单主体便捷包装）。 */
+    rejectCandidate(commandId: string, confirmationToken?: string): Promise<import("../agent/merchant/action-candidate.js").WriteApprovalCandidate>;
+    /**
+     * 重启恢复（阶段三推广版）：恢复全部已注册写工具的 pending 命令
+     * （覆盖 V1 recoverPendingDrafts 语义并推广）；未注册工具的死候选标 expired。
+     */
+    recoverPendingCommands(): {
+        recovered: number;
+        expiredUnknown: number;
+    };
+    listPendingCommands(): import("../agent/merchant/action-candidate.js").WriteApprovalCandidate[];
+    /** prepare：CSV 商品导入（预览逐行回执；幂等键缺省 = CSV 内容 hash）。 */
+    prepareProductsImport(input: {
+        csv: string;
+        idempotency_key?: string;
+        reason?: string;
+    }): Promise<import("./commands.js").PreparedCommand>;
+    /** prepare：批量撤回（listing 销售状态语义；幂等键缺省 = skus hash）。 */
+    prepareProductsWithdraw(input: {
+        skus: string[];
+        idempotency_key?: string;
+        reason?: string;
+    }): Promise<import("./commands.js").PreparedCommand>;
+    /** 长任务查询（read scope）。 */
+    getOperation(operationId: string): MerchantOperation;
+    /**
+     * 微信绑定状态与同步概况（只读）。脱敏：绝不返回 bot_token。
+     * 最近事件列表：当前微信通道无事件存储——明确「不可得」（不编造）。
+     */
+    getWeixinStatus(): {
+        bound: boolean;
+        account?: {
+            bot_id: string;
+            user_id: string;
+            saved_at: string;
+        };
+        sync?: {
+            buffered: boolean;
+            seen_count: number;
+        };
+        recent_events: string;
+        note?: string;
+    };
+    /**
+     * 统一磋商列表：A2A 轨（Ledger）+ shopping 会话轨（merchantClient），每条带
+     * source_protocol/source_id，状态名保留各协议口径。needs_human_review：
+     * 有 intelligence 时用其权威口径，否则 A2A 轨退化相位判断。
+     * 单轨不可用（如未配置 ledger）不拖垮另一轨：tracks 标注 unavailable，
+     * 明确「不可得」而非静默缺半（V2 §4：缺失数据明确显示）。
+     */
+    listUnifiedNegotiations(limit?: unknown): Promise<{
+        total: number;
+        items: UnifiedNegotiationRow[];
+        tracks: {
+            a2a: "ok" | "unavailable";
+            shopping: "ok" | "unavailable";
+        };
+    }>;
+    /** 人工处理目标列表（两轨；每条带路由标记，调用方必须按来源路由）。 */
+    listHumanReviewTargets(): Promise<UnifiedNegotiationRow[]>;
+    /**
+     * 人工处理路由守卫（V2 §5.2）：A2A 来源走 a2a 通道，shopping 来源走
+     * shopping 通道；跨轨调用 fail-closed 抛错。
+     */
+    assertReviewRoute(row: UnifiedNegotiationRow, channel: "a2a" | "shopping"): void;
+    /**
+     * 读取私密阈值（店主私密面板用；不挂 MCP 工具）。读取动作写审计记录
+     * （at/principal/keys 数量——绝不记值）。未配置审计目录时拒绝（fail-closed：
+     * 无审计不裸读私密值）。
+     */
+    readPrivateThresholds(): Array<{
+        key: string;
+        value: string;
+    }>;
+}