@skillfm/local 2.7.2 → 2.7.4

package/dist/usage-local/store.js

@@ -0,0 +1,201 @@
+// sdk/skillfm-local/src/usage-local/store.ts
+//
+// LocalUsageStore — 持久化 + 时序聚合 query.
+// 第一版用 in-memory + JSON 文件持久化 (~/.skillfm/usage-local.json),
+// 0 新依赖. 后续如果数据量大 (>10k records) 再换 sqlite (better-sqlite3).
+//
+// 文件格式: append-only JSONL (每行一个 LocalUsageRecord), 高效 + 可恢复.
+// dedup 靠 record.id (基于 sessionId+timestamp+runId 的稳定 hash).
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { homedir } from 'node:os';
+const DEFAULT_STORE_PATH = path.join(homedir(), '.skillfm', 'usage-local.jsonl');
+/**
+ * Local usage store
+ * - in-memory Map (id → record) for dedup + 快速 query
+ * - jsonl 持久化 (append-only, 每条 record 一行)
+ * - load() 从 jsonl 重建 in-memory state
+ */
+export class LocalUsageStore {
+    records = new Map();
+    filePath;
+    dirty = false;
+    constructor(opts = {}) {
+        this.filePath = opts.filePath ?? DEFAULT_STORE_PATH;
+    }
+    /** 启动时从文件 load */
+    async load() {
+        if (!fs.existsSync(this.filePath)) {
+            // 确保目录存在
+            const dir = path.dirname(this.filePath);
+            if (!fs.existsSync(dir)) {
+                await fs.promises.mkdir(dir, { recursive: true, mode: 0o700 });
+            }
+            return;
+        }
+        const text = await fs.promises.readFile(this.filePath, 'utf-8');
+        for (const line of text.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed || !trimmed.startsWith('{'))
+                continue;
+            try {
+                const r = JSON.parse(trimmed);
+                if (r.id)
+                    this.records.set(r.id, r);
+            }
+            catch {
+                // skip malformed
+            }
+        }
+    }
+    /** 批量 append (dedup by id), 写文件 */
+    async appendBatch(batch) {
+        if (batch.length === 0)
+            return 0;
+        const newRecords = [];
+        for (const r of batch) {
+            if (!this.records.has(r.id)) {
+                this.records.set(r.id, r);
+                newRecords.push(r);
+            }
+        }
+        if (newRecords.length === 0)
+            return 0;
+        // 确保目录存在 (defensive)
+        const dir = path.dirname(this.filePath);
+        if (!fs.existsSync(dir)) {
+            await fs.promises.mkdir(dir, { recursive: true, mode: 0o700 });
+        }
+        const lines = newRecords.map((r) => JSON.stringify(r)).join('\n') + '\n';
+        await fs.promises.appendFile(this.filePath, lines, { mode: 0o600 });
+        return newRecords.length;
+    }
+    /** 当前所有 records 数 */
+    size() {
+        return this.records.size;
+    }
+    /** Query records (基础筛选) */
+    query(q = {}) {
+        const startMs = q.start ? Date.parse(q.start) : 0;
+        const endMs = q.end ? Date.parse(q.end) : Number.MAX_SAFE_INTEGER;
+        const providerSet = q.providers ? new Set(q.providers.map((p) => p.toLowerCase())) : null;
+        const agentSet = q.agents ? new Set(q.agents) : null;
+        const out = [];
+        for (const r of this.records.values()) {
+            const ts = Date.parse(r.timestamp);
+            if (ts < startMs || ts >= endMs)
+                continue;
+            if (providerSet && !providerSet.has(r.provider.toLowerCase()))
+                continue;
+            if (agentSet && !agentSet.has(r.agent_harness))
+                continue;
+            out.push(r);
+        }
+        return out.sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+    }
+    /** 时间窗口聚合 (总数) */
+    aggregate(q = {}) {
+        const records = this.query(q);
+        return this.aggregateRecords(records, q.start ?? '', q.end ?? '');
+    }
+    /** 按 provider 聚合 */
+    aggregateByProvider(q = {}) {
+        const records = this.query(q);
+        const groups = new Map();
+        for (const r of records) {
+            const key = r.provider;
+            const list = groups.get(key) ?? [];
+            list.push(r);
+            groups.set(key, list);
+        }
+        return Array.from(groups.entries()).map(([provider, rs]) => ({
+            provider,
+            ...this.aggregateRecords(rs, q.start ?? '', q.end ?? ''),
+        }));
+    }
+    /** 按 agent harness 聚合 */
+    aggregateByAgent(q = {}) {
+        const records = this.query(q);
+        const groups = new Map();
+        for (const r of records) {
+            const list = groups.get(r.agent_harness) ?? [];
+            list.push(r);
+            groups.set(r.agent_harness, list);
+        }
+        return Array.from(groups.entries()).map(([agent_harness, rs]) => ({
+            agent_harness,
+            ...this.aggregateRecords(rs, q.start ?? '', q.end ?? ''),
+        }));
+    }
+    /** 按 (provider, model) 聚合 */
+    aggregateByModel(q = {}) {
+        const records = this.query(q);
+        const groups = new Map();
+        for (const r of records) {
+            const key = `${r.provider}/${r.model_id}`;
+            const list = groups.get(key) ?? [];
+            list.push(r);
+            groups.set(key, list);
+        }
+        return Array.from(groups.entries()).map(([key, rs]) => {
+            const [provider, ...rest] = key.split('/');
+            const model_id = rest.join('/');
+            return {
+                provider: provider,
+                model_id,
+                ...this.aggregateRecords(rs, q.start ?? '', q.end ?? ''),
+            };
+        });
+    }
+    /** Helper: 聚合 records 列表 */
+    aggregateRecords(records, start, end) {
+        let input = 0, output = 0, cacheRead = 0, cacheWrite = 0, costUsd = 0, costCny = 0;
+        for (const r of records) {
+            input += r.input_tokens;
+            output += r.output_tokens;
+            cacheRead += r.cache_read_tokens;
+            cacheWrite += r.cache_write_tokens;
+            costUsd += r.estimated_cost_usd;
+            costCny += r.estimated_cost_cny;
+        }
+        return {
+            window_start: start,
+            window_end: end,
+            input_tokens: input,
+            output_tokens: output,
+            cache_read_tokens: cacheRead,
+            cache_write_tokens: cacheWrite,
+            total_cost_usd: costUsd,
+            total_cost_cny: costCny,
+            call_count: records.length,
+        };
+    }
+    /** 清空 (测试用 / 用户主动清) */
+    async clear() {
+        this.records.clear();
+        if (fs.existsSync(this.filePath)) {
+            await fs.promises.unlink(this.filePath);
+        }
+    }
+}
+/**
+ * 时间窗口快捷:今日 / 本周 / 本月
+ */
+export function timeWindow(period) {
+    const now = new Date();
+    if (period === 'all')
+        return {};
+    if (period === 'today') {
+        const start = new Date(now.getFullYear(), now.getMonth(), now.getDate());
+        return { start: start.toISOString() };
+    }
+    if (period === 'week') {
+        const start = new Date(now);
+        start.setDate(now.getDate() - 7);
+        return { start: start.toISOString() };
+    }
+    // month
+    const start = new Date(now.getFullYear(), now.getMonth(), 1);
+    return { start: start.toISOString() };
+}
+//# sourceMappingURL=store.js.map

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

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

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

@@ -0,0 +1,94 @@
+/**
+ * 一次 LLM 调用的真原子记录 (来自 agent trajectory)
+ * 跨 agent / 跨 provider 统一 schema
+ */
+export interface LocalUsageRecord {
+    /** 唯一 ID — 用于去重 (基于 agent+session+turn 哈希) */
+    id: string;
+    /** ISO 8601 时间戳 */
+    timestamp: string;
+    /** Agent harness 类型 — openclaw / claude-code / cursor / codex / aider / other */
+    agent_harness: AgentHarness;
+    /** Agent session ID (各 harness 自己的) */
+    session_id: string;
+    /** Provider — anthropic / openai / deepseek / doubao / qwen / kimi / minimax / ollama / other */
+    provider: string;
+    /** Model ID (各 provider 自己的, 如 'claude-sonnet-4-6' / 'gpt-4o' / 'MiniMax-M2.7') */
+    model_id: string;
+    /** 输入 token (uncached) */
+    input_tokens: number;
+    /** 输出 token */
+    output_tokens: number;
+    /** Cache 读 token (cache hit, 通常便宜 10x) */
+    cache_read_tokens: number;
+    /** Cache 写 token (创建 cache, Anthropic 收 1.25x 价) */
+    cache_write_tokens: number;
+    /** 总 token (= input + output, 不含 cache_read) — 兼容历史字段 */
+    total_tokens: number;
+    /** 估算成本 USD (基于 model-pricing.ts 真价目) */
+    estimated_cost_usd: number;
+    /** 估算成本 CNY (= USD × 7.3) */
+    estimated_cost_cny: number;
+    /** trajectory 文件路径 (用于 debug / dedup) */
+    source_file: string;
+}
+export type AgentHarness = 'openclaw' | 'claude-code' | 'cursor' | 'codex' | 'aider' | 'continue' | 'other';
+/**
+ * 时序聚合查询结果 (按 day / week / month 分组)
+ */
+export interface UsageAggregation {
+    /** 时间窗口 ISO 8601 起始 */
+    window_start: string;
+    /** 时间窗口 ISO 8601 结束 */
+    window_end: string;
+    /** 总 input token */
+    input_tokens: number;
+    /** 总 output token */
+    output_tokens: number;
+    /** 总 cache read */
+    cache_read_tokens: number;
+    /** 总 cache write */
+    cache_write_tokens: number;
+    /** 估算总成本 USD */
+    total_cost_usd: number;
+    /** 估算总成本 CNY */
+    total_cost_cny: number;
+    /** 调用次数 */
+    call_count: number;
+}
+/**
+ * 按 provider 分组的聚合
+ */
+export interface UsageByProvider extends UsageAggregation {
+    provider: string;
+}
+/**
+ * 按 agent harness 分组的聚合
+ */
+export interface UsageByAgent extends UsageAggregation {
+    agent_harness: AgentHarness;
+}
+/**
+ * 按 model 分组的聚合
+ */
+export interface UsageByModel extends UsageAggregation {
+    provider: string;
+    model_id: string;
+}
+/**
+ * Watcher 配置
+ */
+export interface WatcherConfig {
+    /** 监听的 trajectory 目录 (各 harness 路径) */
+    watch_paths: WatchPath[];
+    /** sqlite db 文件路径 (默认 ~/.skillfm/usage-local.db) */
+    db_path: string;
+    /** 是否启用 verbose 日志 */
+    verbose: boolean;
+}
+export interface WatchPath {
+    agent_harness: AgentHarness;
+    /** glob 路径 (例: `~/.openclaw/agents/<id>/sessions/<sess>.trajectory.jsonl`) */
+    glob: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/usage-local/types.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,aAAa,EAAE,YAAY,CAAC;IAC5B,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,iGAAiG;IACjG,QAAQ,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,6BAA6B;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,YAAY,GACpB,UAAU,GACV,aAAa,GACb,QAAQ,GACR,OAAO,GACP,OAAO,GACP,UAAU,GACV,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uBAAuB;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW;IACX,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,aAAa,EAAE,YAAY,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,YAAY,CAAC;IAC5B,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/usage-local/types.js

@@ -0,0 +1,6 @@
+// sdk/skillfm-local/src/usage-local/types.ts
+//
+// L0 layer types — 本地 agent trajectory 聚合的数据 schema.
+// 跨 agent (OpenClaw / Claude Code / Cursor) 统一表达每次 LLM 调用的真用量。
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/usage-local/types.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,EAAE;AACF,qDAAqD;AACrD,+DAA+D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillfm/local",
-  "version": "2.7.2",
+  "version": "2.7.4",
   "description": "SkillFM local — single npm package for the SkillFM platform on user nodes. Subcommand router exposes (1) Beacon MCP stdio server (cost-optimizer for any agent; merged in from @skillfm/beacon-mcp on 2026-05-01), (2) skill runtime (BYOK Playwright / brain reverse-tunnel), (3) sidecar HTTP proxy + OAuth 2.1 device-flow activation. Writes ~/.skillfm/local.json for service discovery.",
   "type": "module",
   "main": "./dist/index.js",
@@ -53,7 +53,7 @@
     "typecheck": "tsc --noEmit",
     "start": "node dist/index.js start",
     "prepublishOnly": "npm run build && bash scripts/verify-no-bare-workspace-imports.sh dist",
-    "test": "tsx --test src/harness/detector.test.ts src/harness/priming.test.ts src/harness/writers.test.ts src/guard/state.test.ts src/soul.test.ts src/soul-security.test.ts src/harness/kernels/registry.test.ts src/harness/kernels/deny-pipeline.test.ts src/mcp-output/builder.test.ts src/mcp-output/deny-review.test.ts src/mcp-output/integration.test.ts src/skill-md/template.test.ts src/skill-md/writer.test.ts src/mcp-stdio/smoke.test.ts src/mcp-stdio/render-flow.contract.test.ts src/mcp-stdio/render-aha.test.ts src/mcp-stdio/sse-progress-client.test.ts src/mcp-stdio/parse-tolerant-json.test.ts src/self-upgrade.test.ts src/skill-tunnel/local-bridge.test.ts src/skill-tunnel/client.test.ts src/skill-runner/discovery.test.ts src/skill-installer/index.test.ts src/_dist-no-external-contracts.test.ts src/mcp/server-boot.test.ts src/connectors/connectors.test.ts src/asset-connectors/asset-connectors.test.ts src/saas-connectors/saas-connectors.test.ts src/router/router.test.ts src/vault/vault.test.ts src/scheduler/scheduler.test.ts src/_signers/signers.test.ts src/memory/memory.test.ts src/mcp/tools/memory-tools.test.ts",
+    "test": "tsx --test src/harness/detector.test.ts src/harness/priming.test.ts src/harness/writers.test.ts src/guard/state.test.ts src/soul.test.ts src/soul-security.test.ts src/harness/kernels/registry.test.ts src/harness/kernels/deny-pipeline.test.ts src/mcp-output/builder.test.ts src/mcp-output/deny-review.test.ts src/mcp-output/integration.test.ts src/skill-md/template.test.ts src/skill-md/writer.test.ts src/mcp-stdio/smoke.test.ts src/mcp-stdio/render-flow.contract.test.ts src/mcp-stdio/render-aha.test.ts src/mcp-stdio/sse-progress-client.test.ts src/mcp-stdio/parse-tolerant-json.test.ts src/self-upgrade.test.ts src/skill-tunnel/local-bridge.test.ts src/skill-tunnel/client.test.ts src/skill-runner/discovery.test.ts src/skill-installer/index.test.ts src/_dist-no-external-contracts.test.ts src/mcp/server-boot.test.ts src/connectors/connectors.test.ts src/asset-connectors/asset-connectors.test.ts src/saas-connectors/saas-connectors.test.ts src/router/router.test.ts src/vault/vault.test.ts src/scheduler/scheduler.test.ts src/_signers/signers.test.ts src/memory/memory.test.ts src/mcp/tools/memory-tools.test.ts src/checkup/checkup.test.ts",
     "test:acceptance": "npm run build && bash scripts/acceptance-matrix.sh",
     "postpublish": "curl -sS -m 10 -X PUT 'https://registry.npmmirror.com/-/package/@skillfm/local/syncs?sync_upstream=true' > /dev/null && echo '✓ npmmirror sync triggered' || echo '⚠ npmmirror sync failed (非阻塞，可手动触发)'"
   },