@skillfm/local 2.7.3 → 2.7.5

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.3",
+  "version": "2.7.5",
   "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 (非阻塞，可手动触发)'"
   },