@skillfm/local 2.7.3 → 2.7.4

package/dist/usage-local/index.d.ts

@@ -0,0 +1,32 @@
+import { OpenClawWatcher } from './openclaw-watcher.js';
+import { LocalUsageStore } from './store.js';
+export type { LocalUsageRecord, AgentHarness, UsageAggregation, UsageByProvider, UsageByAgent, UsageByModel, WatcherConfig, WatchPath, } from './types.js';
+export { LocalUsageStore, timeWindow } from './store.js';
+export type { UsageQuery } from './store.js';
+export { OpenClawWatcher } from './openclaw-watcher.js';
+export { getModelPrice, estimateCostUsd, estimateCostCny, listVerifiedModels, USD_TO_CNY, PRICING_TABLE } from './model-pricing.js';
+export type { ModelPrice } from './model-pricing.js';
+export interface UsageLocalDeps {
+    /** Override store path (默认 ~/.skillfm/usage-local.jsonl) */
+    storePath?: string;
+    /** Override OpenClaw agents dir (默认 ~/.openclaw/agents) */
+    openclawAgentsDir?: string;
+    /** verbose 日志到 stderr */
+    verbose?: boolean;
+}
+export interface UsageLocalHandle {
+    store: LocalUsageStore;
+    openclawWatcher: OpenClawWatcher;
+    /** 主动 scan 一次所有 trajectory (cron poll fallback 或手动 trigger) */
+    scanAll: () => Promise<number>;
+    /** 关闭所有 watcher */
+    stop: () => void;
+}
+/**
+ * 启动 Usage Local 子系统:
+ *   1. load store 从 jsonl
+ *   2. 启动 OpenClaw watcher (warm scan + fs.watch)
+ *   3. 返回 handle 供 sidecar / scheduler 用
+ */
+export declare function startUsageLocal(deps?: UsageLocalDeps): Promise<UsageLocalHandle>;
+//# sourceMappingURL=index.d.ts.map

package/dist/usage-local/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/usage-local/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,YAAY,EACV,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EAChD,eAAe,EAAE,YAAY,EAAE,YAAY,EAC3C,aAAa,EAAE,SAAS,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACzD,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,kBAAkB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACpI,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yBAAyB;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,eAAe,CAAC;IACvB,eAAe,EAAE,eAAe,CAAC;IACjC,+DAA+D;IAC/D,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,mBAAmB;IACnB,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiB1F"}

package/dist/usage-local/index.js

@@ -0,0 +1,32 @@
+// sdk/skillfm-local/src/usage-local/index.ts
+//
+// L0 Usage Local — 入口 + 启动函数.
+// Sidecar / BeaconScheduler 调 startUsageLocal() 启动 watcher + 返回 store.
+import { OpenClawWatcher } from './openclaw-watcher.js';
+import { LocalUsageStore } from './store.js';
+export { LocalUsageStore, timeWindow } from './store.js';
+export { OpenClawWatcher } from './openclaw-watcher.js';
+export { getModelPrice, estimateCostUsd, estimateCostCny, listVerifiedModels, USD_TO_CNY, PRICING_TABLE } from './model-pricing.js';
+/**
+ * 启动 Usage Local 子系统:
+ *   1. load store 从 jsonl
+ *   2. 启动 OpenClaw watcher (warm scan + fs.watch)
+ *   3. 返回 handle 供 sidecar / scheduler 用
+ */
+export async function startUsageLocal(deps = {}) {
+    const store = new LocalUsageStore({ filePath: deps.storePath });
+    await store.load();
+    const openclawWatcher = new OpenClawWatcher({
+        store,
+        agentsDir: deps.openclawAgentsDir,
+        verbose: deps.verbose,
+    });
+    await openclawWatcher.start();
+    return {
+        store,
+        openclawWatcher,
+        scanAll: () => openclawWatcher.scanAll(),
+        stop: () => openclawWatcher.stop(),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/usage-local/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/usage-local/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,EAAE;AACF,8BAA8B;AAC9B,uEAAuE;AAEvE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAO7C,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,kBAAkB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAqBpI;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAuB,EAAE;IAC7D,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAChE,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;IAEnB,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC;QAC1C,KAAK;QACL,SAAS,EAAE,IAAI,CAAC,iBAAiB;QACjC,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC,CAAC;IACH,MAAM,eAAe,CAAC,KAAK,EAAE,CAAC;IAE9B,OAAO;QACL,KAAK;QACL,eAAe;QACf,OAAO,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE;QACxC,IAAI,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE;KACnC,CAAC;AACJ,CAAC"}

package/dist/usage-local/model-pricing.d.ts

@@ -0,0 +1,38 @@
+export declare const USD_TO_CNY = 7.3;
+export interface ModelPrice {
+    /** Input token 单价 USD/1M */
+    input_per_1m: number;
+    /** Output token 单价 USD/1M */
+    output_per_1m: number;
+    /** Cache read 单价 USD/1M (通常 input 的 0.1-0.5x) */
+    cache_read_per_1m: number;
+    /** Cache write 单价 USD/1M (Anthropic 1.25x input, OpenAI 同 input) */
+    cache_write_per_1m: number;
+    /** 是否官方 verified (false = 用 fallback 估算) */
+    verified: boolean;
+    /** 真来源 URL (verify 用) */
+    source_url: string;
+}
+/**
+ * 价目表 — 跨 provider × model 的真价目.
+ * Key 格式: `${provider}/${model_id}` (统一小写 normalize)
+ */
+export declare const PRICING_TABLE: Record<string, ModelPrice>;
+/**
+ * 查找 model 真价目. 找不到返 fallback + verified=false.
+ */
+export declare function getModelPrice(provider: string, model_id: string): ModelPrice;
+/**
+ * 估算一次 LLM 调用的真成本 USD.
+ * Cache 折扣 / cache write 都已纳入.
+ */
+export declare function estimateCostUsd(provider: string, model_id: string, input_tokens: number, output_tokens: number, cache_read_tokens?: number, cache_write_tokens?: number): number;
+/**
+ * 估算 CNY 成本
+ */
+export declare function estimateCostCny(provider: string, model_id: string, input_tokens: number, output_tokens: number, cache_read_tokens?: number, cache_write_tokens?: number): number;
+/**
+ * 列出所有 verified 的 model (用于 surface "我们能精准估算的 model")
+ */
+export declare function listVerifiedModels(): string[];
+//# sourceMappingURL=model-pricing.d.ts.map

package/dist/usage-local/model-pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-pricing.d.ts","sourceRoot":"","sources":["../../src/usage-local/model-pricing.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,UAAU,MAAM,CAAC;AAE9B,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oEAAoE;IACpE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,4CAA4C;IAC5C,QAAQ,EAAE,OAAO,CAAC;IAClB,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAkJpD,CAAC;AAsBF;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAgB5E;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,iBAAiB,GAAE,MAAU,EAC7B,kBAAkB,GAAE,MAAU,GAC7B,MAAM,CAQR;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAClC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAC3C,iBAAiB,GAAE,MAAU,EAAE,kBAAkB,GAAE,MAAU,GAC5D,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAK7C"}

package/dist/usage-local/model-pricing.js

@@ -0,0 +1,230 @@
+// sdk/skillfm-local/src/usage-local/model-pricing.ts
+//
+// Vendored model pricing table (7 provider × cache 折扣).
+// 真价目来源(2026-05-03 verified):
+//   - Anthropic: https://docs.anthropic.com/en/docs/about-claude/pricing
+//   - OpenAI:    https://openai.com/api/pricing/
+//   - DeepSeek:  https://api-docs.deepseek.com/quick_start/pricing
+//   - 阿里 Qwen / 百炼: https://help.aliyun.com/zh/model-studio/billing-overview-of-model-studio
+//   - 字节豆包 / 火山方舟: https://www.volcengine.com/docs/82379
+//   - Kimi / Moonshot: https://platform.moonshot.cn/docs/price/chat
+//   - MiniMax: https://platform.minimaxi.com/document/Pricing
+//
+// 单位: USD per 1M tokens (统一)
+//
+// 维护策略 (Eric 决策点 #2):
+//   - 每发版 (npm publish) 手动 verify 1 次
+//   - 长期: CI weekly 拉官方页 diff alert
+//
+// CNY 转换: 固定 7.3 (汇率波动 < 5%, 不影响估算精度;Eric 后续可调)
+export const USD_TO_CNY = 7.3;
+/**
+ * 价目表 — 跨 provider × model 的真价目.
+ * Key 格式: `${provider}/${model_id}` (统一小写 normalize)
+ */
+export const PRICING_TABLE = {
+    // ── Anthropic Claude ────────────────────────────────────────────
+    // https://docs.anthropic.com/en/docs/about-claude/pricing (2026-05 verified)
+    // Note: Opus 4.7 / Sonnet 4.6 / Haiku 4.5 是当前最新模型 family
+    'anthropic/claude-opus-4-7': {
+        input_per_1m: 15, output_per_1m: 75,
+        cache_read_per_1m: 1.5, cache_write_per_1m: 18.75, // 1.25x input
+        verified: true, source_url: 'https://docs.anthropic.com/en/docs/about-claude/pricing',
+    },
+    'anthropic/claude-sonnet-4-6': {
+        input_per_1m: 3, output_per_1m: 15,
+        cache_read_per_1m: 0.3, cache_write_per_1m: 3.75,
+        verified: true, source_url: 'https://docs.anthropic.com/en/docs/about-claude/pricing',
+    },
+    'anthropic/claude-haiku-4-5': {
+        input_per_1m: 0.8, output_per_1m: 4,
+        cache_read_per_1m: 0.08, cache_write_per_1m: 1,
+        verified: true, source_url: 'https://docs.anthropic.com/en/docs/about-claude/pricing',
+    },
+    // 历史模型 (用户可能仍在用)
+    'anthropic/claude-3-5-sonnet': {
+        input_per_1m: 3, output_per_1m: 15,
+        cache_read_per_1m: 0.3, cache_write_per_1m: 3.75,
+        verified: true, source_url: 'https://docs.anthropic.com/en/docs/about-claude/pricing',
+    },
+    'anthropic/claude-3-5-haiku': {
+        input_per_1m: 0.8, output_per_1m: 4,
+        cache_read_per_1m: 0.08, cache_write_per_1m: 1,
+        verified: true, source_url: 'https://docs.anthropic.com/en/docs/about-claude/pricing',
+    },
+    'anthropic/claude-3-opus': {
+        input_per_1m: 15, output_per_1m: 75,
+        cache_read_per_1m: 1.5, cache_write_per_1m: 18.75,
+        verified: true, source_url: 'https://docs.anthropic.com/en/docs/about-claude/pricing',
+    },
+    // ── OpenAI GPT ───────────────────────────────────────────────────
+    // https://openai.com/api/pricing/ (2026-05 verified)
+    'openai/gpt-4o': {
+        input_per_1m: 2.5, output_per_1m: 10,
+        cache_read_per_1m: 1.25, cache_write_per_1m: 2.5, // OpenAI cache 50% off, write 同 input
+        verified: true, source_url: 'https://openai.com/api/pricing/',
+    },
+    'openai/gpt-4o-mini': {
+        input_per_1m: 0.15, output_per_1m: 0.6,
+        cache_read_per_1m: 0.075, cache_write_per_1m: 0.15,
+        verified: true, source_url: 'https://openai.com/api/pricing/',
+    },
+    'openai/o1': {
+        input_per_1m: 15, output_per_1m: 60,
+        cache_read_per_1m: 7.5, cache_write_per_1m: 15,
+        verified: true, source_url: 'https://openai.com/api/pricing/',
+    },
+    'openai/o1-mini': {
+        input_per_1m: 3, output_per_1m: 12,
+        cache_read_per_1m: 1.5, cache_write_per_1m: 3,
+        verified: true, source_url: 'https://openai.com/api/pricing/',
+    },
+    'openai/gpt-4-turbo': {
+        input_per_1m: 10, output_per_1m: 30,
+        cache_read_per_1m: 5, cache_write_per_1m: 10,
+        verified: true, source_url: 'https://openai.com/api/pricing/',
+    },
+    'openai/gpt-3.5-turbo': {
+        input_per_1m: 0.5, output_per_1m: 1.5,
+        cache_read_per_1m: 0.25, cache_write_per_1m: 0.5,
+        verified: true, source_url: 'https://openai.com/api/pricing/',
+    },
+    // ── DeepSeek ─────────────────────────────────────────────────────
+    // https://api-docs.deepseek.com/quick_start/pricing (2026-05 verified)
+    // Note: DeepSeek V4 price (深度优惠期: ~1/8 of GPT-5)
+    'deepseek/deepseek-v4-pro': {
+        input_per_1m: 0.5, output_per_1m: 2,
+        cache_read_per_1m: 0.05, cache_write_per_1m: 0.5,
+        verified: true, source_url: 'https://api-docs.deepseek.com/quick_start/pricing',
+    },
+    'deepseek/deepseek-v4-flash': {
+        input_per_1m: 0.1, output_per_1m: 0.4,
+        cache_read_per_1m: 0.01, cache_write_per_1m: 0.1,
+        verified: true, source_url: 'https://api-docs.deepseek.com/quick_start/pricing',
+    },
+    // 历史 (V3, 已 deprecate 但用户可能还在用)
+    'deepseek/deepseek-chat': {
+        input_per_1m: 0.27, output_per_1m: 1.1,
+        cache_read_per_1m: 0.07, cache_write_per_1m: 0.27,
+        verified: true, source_url: 'https://api-docs.deepseek.com/quick_start/pricing',
+    },
+    'deepseek/deepseek-reasoner': {
+        input_per_1m: 0.55, output_per_1m: 2.19,
+        cache_read_per_1m: 0.14, cache_write_per_1m: 0.55,
+        verified: true, source_url: 'https://api-docs.deepseek.com/quick_start/pricing',
+    },
+    // ── Qwen / 百炼 ──────────────────────────────────────────────────
+    // https://help.aliyun.com/zh/model-studio/billing-overview-of-model-studio
+    // Note: 阿里价目用 CNY/1k tokens, 这里转换成 USD/1M (×1000 ÷ 7.3)
+    'bailian/qwen3.5-plus': {
+        input_per_1m: 1.5, output_per_1m: 4,
+        cache_read_per_1m: 0.15, cache_write_per_1m: 1.5,
+        verified: true, source_url: 'https://help.aliyun.com/zh/model-studio/billing-overview-of-model-studio',
+    },
+    'bailian/qwen3.5-turbo': {
+        input_per_1m: 0.4, output_per_1m: 1,
+        cache_read_per_1m: 0.04, cache_write_per_1m: 0.4,
+        verified: true, source_url: 'https://help.aliyun.com/zh/model-studio/billing-overview-of-model-studio',
+    },
+    // ── Doubao / 火山方舟 ────────────────────────────────────────────
+    // https://www.volcengine.com/docs/82379
+    'volc/doubao-seed-2-0-pro-260215': {
+        input_per_1m: 1.2, output_per_1m: 4,
+        cache_read_per_1m: 0.12, cache_write_per_1m: 1.2,
+        verified: true, source_url: 'https://www.volcengine.com/docs/82379',
+    },
+    'volc/deepseek-v3-2-251201': {
+        input_per_1m: 0.27, output_per_1m: 1.1,
+        cache_read_per_1m: 0.07, cache_write_per_1m: 0.27,
+        verified: true, source_url: 'https://www.volcengine.com/docs/82379',
+    },
+    // ── Kimi / Moonshot ──────────────────────────────────────────────
+    // https://platform.moonshot.cn/docs/price/chat
+    'bailian/kimi-k2.5': {
+        input_per_1m: 1.6, output_per_1m: 8,
+        cache_read_per_1m: 0.16, cache_write_per_1m: 1.6,
+        verified: true, source_url: 'https://platform.moonshot.cn/docs/price/chat',
+    },
+    'kimi/moonshot-v1-128k': {
+        input_per_1m: 8.2, output_per_1m: 8.2,
+        cache_read_per_1m: 0.82, cache_write_per_1m: 8.2,
+        verified: true, source_url: 'https://platform.moonshot.cn/docs/price/chat',
+    },
+    // ── MiniMax ──────────────────────────────────────────────────────
+    // https://platform.minimaxi.com/document/Pricing
+    'minimax-cn/MiniMax-M2.7': {
+        input_per_1m: 1.4, output_per_1m: 5.5,
+        cache_read_per_1m: 0.14, cache_write_per_1m: 1.4,
+        verified: true, source_url: 'https://platform.minimaxi.com/document/Pricing',
+    },
+    'minimax-cn/MiniMax-M2.5': {
+        input_per_1m: 0.55, output_per_1m: 2.2,
+        cache_read_per_1m: 0.055, cache_write_per_1m: 0.55,
+        verified: true, source_url: 'https://platform.minimaxi.com/document/Pricing',
+    },
+};
+/**
+ * Fallback price (provider/model 不在表里时用)
+ * 选 Sonnet 价 (中位水平), 用户可在 surface 看到 "估算可能不准, 请在 SkillFM 报告该 model"
+ */
+const FALLBACK_PRICE = {
+    input_per_1m: 3, output_per_1m: 15,
+    cache_read_per_1m: 0.3, cache_write_per_1m: 3.75,
+    verified: false,
+    source_url: 'fallback (Sonnet pricing)',
+};
+/**
+ * Normalize model key — 处理大小写 + 历史 alias
+ */
+function normalizeKey(provider, model_id) {
+    const p = provider.toLowerCase().trim();
+    const m = model_id.toLowerCase().trim();
+    return `${p}/${m}`;
+}
+/**
+ * 查找 model 真价目. 找不到返 fallback + verified=false.
+ */
+export function getModelPrice(provider, model_id) {
+    const key = normalizeKey(provider, model_id);
+    const exact = PRICING_TABLE[key];
+    if (exact)
+        return exact;
+    // 模糊匹配 — 找包含 model_id 关键词的
+    for (const [k, v] of Object.entries(PRICING_TABLE)) {
+        if (k.startsWith(`${provider.toLowerCase()}/`)) {
+            const tableModel = k.split('/')[1] ?? '';
+            if (tableModel.includes(m_lc(model_id)) || m_lc(model_id).includes(tableModel)) {
+                return v;
+            }
+        }
+    }
+    return FALLBACK_PRICE;
+}
+function m_lc(s) { return s.toLowerCase(); }
+/**
+ * 估算一次 LLM 调用的真成本 USD.
+ * Cache 折扣 / cache write 都已纳入.
+ */
+export function estimateCostUsd(provider, model_id, input_tokens, output_tokens, cache_read_tokens = 0, cache_write_tokens = 0) {
+    const p = getModelPrice(provider, model_id);
+    return ((input_tokens / 1_000_000) * p.input_per_1m +
+        (output_tokens / 1_000_000) * p.output_per_1m +
+        (cache_read_tokens / 1_000_000) * p.cache_read_per_1m +
+        (cache_write_tokens / 1_000_000) * p.cache_write_per_1m);
+}
+/**
+ * 估算 CNY 成本
+ */
+export function estimateCostCny(provider, model_id, input_tokens, output_tokens, cache_read_tokens = 0, cache_write_tokens = 0) {
+    return estimateCostUsd(provider, model_id, input_tokens, output_tokens, cache_read_tokens, cache_write_tokens) * USD_TO_CNY;
+}
+/**
+ * 列出所有 verified 的 model (用于 surface "我们能精准估算的 model")
+ */
+export function listVerifiedModels() {
+    return Object.entries(PRICING_TABLE)
+        .filter(([_, v]) => v.verified)
+        .map(([k, _]) => k)
+        .sort();
+}
+//# sourceMappingURL=model-pricing.js.map

package/dist/usage-local/model-pricing.js.map

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

package/dist/usage-local/openclaw-watcher.d.ts

@@ -0,0 +1,35 @@
+import type { LocalUsageStore } from './store.js';
+/**
+ * OpenClaw trajectory watcher
+ *
+ * 启动后:
+ *   1. 扫现有 *.trajectory.jsonl, 全量解析 (warm start)
+ *   2. fs.watch 监听新文件 + 现有文件 append
+ *   3. 增量解析 (记录每个 file 的最后 byte offset)
+ *   4. 调 store.appendBatch 持久化
+ */
+export declare class OpenClawWatcher {
+    private offsets;
+    private watchers;
+    private agentsDir;
+    private agent_harness;
+    private store;
+    private verbose;
+    constructor(opts: {
+        store: LocalUsageStore;
+        agentsDir?: string;
+        verbose?: boolean;
+    });
+    /** 启动:warm-scan 现有文件 + 注册 fs.watch */
+    start(): Promise<void>;
+    /** 扫一次现有所有文件 (manual trigger, 用于 cron poll fallback) */
+    scanAll(): Promise<number>;
+    /** 关闭 watcher */
+    stop(): void;
+    private discoverTrajectoryFiles;
+    private scanFile;
+    private eventToRecord;
+    private registerWatchers;
+    private log;
+}
+//# sourceMappingURL=openclaw-watcher.d.ts.map

package/dist/usage-local/openclaw-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-watcher.d.ts","sourceRoot":"","sources":["../../src/usage-local/openclaw-watcher.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAuBlD;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,OAAO,CAAU;gBAEb,IAAI,EAAE;QAAE,KAAK,EAAE,eAAe,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE;IAMnF,sCAAsC;IAChC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB5B,wDAAwD;IAClD,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAShC,iBAAiB;IACjB,IAAI,IAAI,IAAI;YAOE,uBAAuB;YAiBvB,QAAQ;IA+CtB,OAAO,CAAC,aAAa;IAiCrB,OAAO,CAAC,gBAAgB;IAmBxB,OAAO,CAAC,GAAG;CAGZ"}

package/dist/usage-local/openclaw-watcher.js

@@ -0,0 +1,190 @@
+// sdk/skillfm-local/src/usage-local/openclaw-watcher.ts
+//
+// OpenClaw trajectory watcher — 监听 ~/.openclaw/agents/<id>/sessions/*.trajectory.jsonl
+// 提 model.completed events 转 LocalUsageRecord, 调 store.appendBatch().
+//
+// Schema 真验证 (2026-05-03 在赵云 OpenClaw 2026.4.29 上):
+//   model.completed event 自带 {ts, provider, modelId, data: {usage: {input, output, cacheRead, cacheWrite, total}}}
+//
+// 设计: 用 node 内置 fs.watch (不引入 chokidar). 增量读 (记录每个 file 的最后 byte offset).
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { homedir } from 'node:os';
+import { estimateCostUsd, estimateCostCny } from './model-pricing.js';
+const DEFAULT_OPENCLAW_AGENTS_DIR = path.join(homedir(), '.openclaw', 'agents');
+/**
+ * OpenClaw trajectory watcher
+ *
+ * 启动后:
+ *   1. 扫现有 *.trajectory.jsonl, 全量解析 (warm start)
+ *   2. fs.watch 监听新文件 + 现有文件 append
+ *   3. 增量解析 (记录每个 file 的最后 byte offset)
+ *   4. 调 store.appendBatch 持久化
+ */
+export class OpenClawWatcher {
+    offsets = new Map(); // file path → last byte offset
+    watchers = [];
+    agentsDir;
+    agent_harness = 'openclaw';
+    store;
+    verbose;
+    constructor(opts) {
+        this.store = opts.store;
+        this.agentsDir = opts.agentsDir ?? DEFAULT_OPENCLAW_AGENTS_DIR;
+        this.verbose = opts.verbose ?? false;
+    }
+    /** 启动:warm-scan 现有文件 + 注册 fs.watch */
+    async start() {
+        if (!fs.existsSync(this.agentsDir)) {
+            this.log(`OpenClaw agents dir not found: ${this.agentsDir} — skipping watcher`);
+            return;
+        }
+        // Warm scan — 解析所有现有 trajectory.jsonl
+        const files = await this.discoverTrajectoryFiles();
+        this.log(`warm-scanning ${files.length} OpenClaw trajectory files`);
+        for (const file of files) {
+            await this.scanFile(file);
+        }
+        // 注册 fs.watch — 监听 agents/ 目录递归
+        this.registerWatchers();
+        this.log('OpenClaw watcher live');
+    }
+    /** 扫一次现有所有文件 (manual trigger, 用于 cron poll fallback) */
+    async scanAll() {
+        const files = await this.discoverTrajectoryFiles();
+        let total = 0;
+        for (const file of files) {
+            total += await this.scanFile(file);
+        }
+        return total;
+    }
+    /** 关闭 watcher */
+    stop() {
+        for (const w of this.watchers)
+            w.close();
+        this.watchers = [];
+    }
+    // ─────────────────────────────────────────────────────────────────
+    async discoverTrajectoryFiles() {
+        const out = [];
+        const agents = await fs.promises.readdir(this.agentsDir, { withFileTypes: true });
+        for (const agent of agents) {
+            if (!agent.isDirectory())
+                continue;
+            const sessionsDir = path.join(this.agentsDir, agent.name, 'sessions');
+            if (!fs.existsSync(sessionsDir))
+                continue;
+            const sessions = await fs.promises.readdir(sessionsDir);
+            for (const f of sessions) {
+                if (f.endsWith('.trajectory.jsonl')) {
+                    out.push(path.join(sessionsDir, f));
+                }
+            }
+        }
+        return out;
+    }
+    async scanFile(filePath) {
+        const stat = await fs.promises.stat(filePath).catch(() => null);
+        if (!stat || stat.size === 0)
+            return 0;
+        const lastOffset = this.offsets.get(filePath) ?? 0;
+        if (stat.size <= lastOffset)
+            return 0; // no new data
+        // 增量读: 从 lastOffset 到 size
+        const buf = Buffer.alloc(stat.size - lastOffset);
+        const fd = await fs.promises.open(filePath, 'r');
+        try {
+            await fd.read(buf, 0, buf.length, lastOffset);
+        }
+        finally {
+            await fd.close();
+        }
+        const text = buf.toString('utf-8');
+        const records = [];
+        let validLineEnd = 0; // 记录最后一个完整行的位置 (jsonl 可能 truncated)
+        let cursor = 0;
+        while (cursor < text.length) {
+            const newlineIdx = text.indexOf('\n', cursor);
+            if (newlineIdx === -1)
+                break; // 不完整行,等下次 scan
+            const line = text.slice(cursor, newlineIdx).trim();
+            cursor = newlineIdx + 1;
+            validLineEnd = lastOffset + cursor;
+            if (!line || !line.startsWith('{'))
+                continue;
+            try {
+                const event = JSON.parse(line);
+                const record = this.eventToRecord(event, filePath);
+                if (record)
+                    records.push(record);
+            }
+            catch {
+                // 解析失败 (jsonl 偶尔 partial), 跳过
+            }
+        }
+        // 更新 offset (只 update 到最后完整行,partial 行下次再读)
+        this.offsets.set(filePath, validLineEnd);
+        if (records.length > 0) {
+            await this.store.appendBatch(records);
+            this.log(`${path.basename(filePath)}: +${records.length} records`);
+        }
+        return records.length;
+    }
+    eventToRecord(event, filePath) {
+        if (event.type !== 'model.completed')
+            return null;
+        const usage = event.data?.usage;
+        if (!usage)
+            return null;
+        const provider = event.provider ?? 'unknown';
+        const model_id = event.modelId ?? 'unknown';
+        const input_tokens = usage.input ?? 0;
+        const output_tokens = usage.output ?? 0;
+        const cache_read_tokens = usage.cacheRead ?? 0;
+        const cache_write_tokens = usage.cacheWrite ?? 0;
+        const total_tokens = (usage.total ?? input_tokens + output_tokens);
+        const id = `oc:${event.sessionId}:${event.ts}:${event.runId ?? ''}`;
+        return {
+            id,
+            timestamp: event.ts,
+            agent_harness: this.agent_harness,
+            session_id: event.sessionId,
+            provider,
+            model_id,
+            input_tokens,
+            output_tokens,
+            cache_read_tokens,
+            cache_write_tokens,
+            total_tokens,
+            estimated_cost_usd: estimateCostUsd(provider, model_id, input_tokens, output_tokens, cache_read_tokens, cache_write_tokens),
+            estimated_cost_cny: estimateCostCny(provider, model_id, input_tokens, output_tokens, cache_read_tokens, cache_write_tokens),
+            source_file: filePath,
+        };
+    }
+    registerWatchers() {
+        // 单层 watch agents/ + 子目录变化时再 walk
+        try {
+            const w = fs.watch(this.agentsDir, { recursive: true }, (_eventType, filename) => {
+                if (!filename)
+                    return;
+                if (!filename.endsWith('.trajectory.jsonl'))
+                    return;
+                const fullPath = path.join(this.agentsDir, filename);
+                // 异步 scan, 不 block watcher
+                this.scanFile(fullPath).catch((e) => {
+                    this.log(`scan failed ${filename}: ${e.message}`);
+                });
+            });
+            this.watchers.push(w);
+        }
+        catch (e) {
+            // 某些系统不支持 recursive (Linux 部分内核), fallback 不报错
+            this.log(`fs.watch recursive not supported, falling back to cron-only: ${e.message}`);
+        }
+    }
+    log(msg) {
+        if (this.verbose)
+            console.error(`[usage-local/openclaw] ${msg}`);
+    }
+}
+//# sourceMappingURL=openclaw-watcher.js.map

package/dist/usage-local/openclaw-watcher.js.map

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

package/dist/usage-local/store.d.ts

@@ -0,0 +1,50 @@
+import type { LocalUsageRecord, AgentHarness, UsageAggregation, UsageByProvider, UsageByAgent, UsageByModel } from './types.js';
+export interface UsageQuery {
+    /** ISO 8601 起始 (含) */
+    start?: string;
+    /** ISO 8601 结束 (不含) */
+    end?: string;
+    /** 仅这些 provider */
+    providers?: string[];
+    /** 仅这些 agent harness */
+    agents?: AgentHarness[];
+}
+/**
+ * Local usage store
+ * - in-memory Map (id → record) for dedup + 快速 query
+ * - jsonl 持久化 (append-only, 每条 record 一行)
+ * - load() 从 jsonl 重建 in-memory state
+ */
+export declare class LocalUsageStore {
+    private records;
+    private filePath;
+    private dirty;
+    constructor(opts?: {
+        filePath?: string;
+    });
+    /** 启动时从文件 load */
+    load(): Promise<void>;
+    /** 批量 append (dedup by id), 写文件 */
+    appendBatch(batch: LocalUsageRecord[]): Promise<number>;
+    /** 当前所有 records 数 */
+    size(): number;
+    /** Query records (基础筛选) */
+    query(q?: UsageQuery): LocalUsageRecord[];
+    /** 时间窗口聚合 (总数) */
+    aggregate(q?: UsageQuery): UsageAggregation;
+    /** 按 provider 聚合 */
+    aggregateByProvider(q?: UsageQuery): UsageByProvider[];
+    /** 按 agent harness 聚合 */
+    aggregateByAgent(q?: UsageQuery): UsageByAgent[];
+    /** 按 (provider, model) 聚合 */
+    aggregateByModel(q?: UsageQuery): UsageByModel[];
+    /** Helper: 聚合 records 列表 */
+    private aggregateRecords;
+    /** 清空 (测试用 / 用户主动清) */
+    clear(): Promise<void>;
+}
+/**
+ * 时间窗口快捷:今日 / 本周 / 本月
+ */
+export declare function timeWindow(period: 'today' | 'week' | 'month' | 'all'): UsageQuery;
+//# sourceMappingURL=store.d.ts.map