@harrylabsj/kiwi 0.7.20 → 0.7.21

package/dist/product-merchant.d.ts

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+/**
+ * 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 ContactTotals, type DailyBucket, type SkuStat } from "./merchant/stats-store.js";
+export interface MerchantStatsOptions {
+    /** merchant agent_id（报告标识，不参与查询）。 */
+    agentId: string;
+    /** 节点数据目录（resolveServeDataDir 解析后的 dataDir；统计库在 <dataDir>/a2a/）。 */
+    dataDir: string;
+    /** 回看天数（缺省 14，clamp 1..90；天数一律 UTC）。 */
+    days?: number;
+    /** 可注入时钟（RFC 3339）；缺省 new Date().toISOString()。 */
+    now?: () => string;
+}
+export interface MerchantStatsReport {
+    ok: true;
+    agent_id: string;
+    days: number;
+    identity_note: string;
+    totals: ContactTotals;
+    today: {
+        distinct_buyers: number;
+        contact_events: number;
+    };
+    /** 零填充的 N 天窗口（升序，含今天）。 */
+    daily: DailyBucket[];
+    top_skus: SkuStat[];
+}
+/** 读本地买家触达统计（merchant start 运行并收到买家消息后才有数据；缺省报错）。 */
+export declare function merchantStats(options: MerchantStatsOptions): MerchantStatsReport;

package/dist/product-merchant.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+/**
+ * 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.
+ */
+/**
+ * `kiwi merchant` 命令面（product-strategy rev1.1 §2.3/§19）。
+ *
+ * - stats：商家侧运营统计（本地 <dataDir>/a2a/stats.sqlite，由 merchant A2A
+ *   节点在收到买家 KNP 消息时自动收集；数据只在商家本机，永不上报）。
+ *   回答两个问题：多少个不同的买家联系过我、讨论了哪些商品（SKU）。
+ */
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { openMerchantStatsStore, } from "./merchant/stats-store.js";
+/** 身份语义说明：distinct_buyers 只在 signature 模式下是真实去重买家。 */
+const IDENTITY_NOTE = "买家身份依赖传输层认证：signature 模式下为真实去重买家；loopback/none/bearer 模式会聚合买家";
+const DEFAULT_DAYS = 14;
+const MAX_DAYS = 90;
+const TOP_SKU_LIMIT = 20;
+/** UTC 日串加减天数（`YYYY-MM-DD`）。 */
+function shiftDay(day, delta) {
+    return new Date(Date.parse(`${day}T00:00:00Z`) + delta * 86_400_000).toISOString().slice(0, 10);
+}
+/** 读本地买家触达统计（merchant start 运行并收到买家消息后才有数据；缺省报错）。 */
+export function merchantStats(options) {
+    const now = (options.now ?? (() => new Date().toISOString()))();
+    const today = now.slice(0, 10);
+    const requested = options.days ?? DEFAULT_DAYS;
+    const days = Math.max(1, Math.min(MAX_DAYS, Math.trunc(requested)));
+    const sinceDay = shiftDay(today, -(days - 1));
+    const dbPath = path.join(options.dataDir, "a2a", "stats.sqlite");
+    if (!existsSync(dbPath)) {
+        throw new Error(`尚无买家沟通数据（${dbPath} 不存在）——商家服务启动并收到买家消息后会自动收集（kiwi merchant start）`);
+    }
+    const store = openMerchantStatsStore({ dbPath });
+    try {
+        const totals = store.totalsSince(sinceDay);
+        const todayTotals = store.totalsSince(today);
+        const byDay = new Map(store.dailySince(sinceDay).map((d) => [d.day, d]));
+        const daily = [];
+        for (let i = 0; i < days; i++) {
+            const day = shiftDay(sinceDay, i);
+            daily.push(byDay.get(day) ?? { day, distinct_buyers: 0, contact_events: 0, negotiations: 0 });
+        }
+        return {
+            ok: true,
+            agent_id: options.agentId,
+            days,
+            identity_note: IDENTITY_NOTE,
+            totals,
+            today: {
+                distinct_buyers: todayTotals.distinct_buyers,
+                contact_events: todayTotals.contact_events,
+            },
+            daily,
+            top_skus: store.topSkus(sinceDay, TOP_SKU_LIMIT),
+        };
+    }
+    finally {
+        store.close();
+    }
+}
+//# sourceMappingURL=product-merchant.js.map

package/dist/product-merchant.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harrylabsj/kiwi",
-  "version": "0.7.20",
+  "version": "0.7.21",
   "description": "Kiwi: standalone A2A commerce negotiation agent runtime (Pi Agent Core + shopping-cli Commerce API)",
   "type": "module",
   "license": "Apache-2.0",