@skillfm/local 2.7.2 → 2.7.4

package/dist/save-token/e2-cache.js

@@ -0,0 +1,128 @@
+// sdk/skillfm-local/src/save-token/e2-cache.ts
+//
+// E2 Prompt Caching 自动启用 (PRD §6.3) — Free 即得真省钱.
+//
+// Free: 扫 trajectory 找 system prompt 重复率高 / 长 prompt → surface "启 cache 估省 ¥X"
+//       给 cache_control 代码片段让用户手动加
+// Pro: gateway hook auto inject cache_control breakpoint (2.7.5+)
+//
+// 真证据 (PRD §6.3):
+//   OpenAI 50% off cached tokens (auto, 1024+ token)
+//   Anthropic 90% off cache reads ($0.30/M vs $3.00/M, 显式 ephemeral)
+//   真案例 1 个开发者 $720 → $72/月 = 90% off
+import { getModelPrice, USD_TO_CNY } from '../usage-local/model-pricing.js';
+import { timeWindow } from '../usage-local/store.js';
+/**
+ * 哪些 provider 真支持 prompt cache
+ */
+const CACHE_SUPPORTED_PROVIDERS = new Set(['anthropic', 'openai', 'deepseek']);
+/**
+ * 扫描 + 返建议
+ */
+export async function scanE2Cache(store, opts) {
+    const window = opts.start && opts.end
+        ? { start: opts.start, end: opts.end }
+        : timeWindow('week');
+    const records = store.query(window);
+    if (records.length === 0)
+        return [];
+    // 按 (provider, model) 聚合 cache 利用率
+    const byModel = new Map();
+    for (const r of records) {
+        const key = `${r.provider}/${r.model_id}`;
+        const cur = byModel.get(key) ?? {
+            count: 0, input_tokens: 0, cache_read_tokens: 0, cache_write_tokens: 0, cost_usd: 0,
+        };
+        cur.count += 1;
+        cur.input_tokens += r.input_tokens;
+        cur.cache_read_tokens += r.cache_read_tokens;
+        cur.cache_write_tokens += r.cache_write_tokens;
+        cur.cost_usd += r.estimated_cost_usd;
+        byModel.set(key, cur);
+    }
+    const suggestions = [];
+    for (const [key, agg] of byModel) {
+        const [provider] = key.split('/');
+        if (!CACHE_SUPPORTED_PROVIDERS.has(provider))
+            continue;
+        if (agg.cost_usd < 0.5)
+            continue;
+        if (agg.count < 5)
+            continue; // 5+ 次调用才有 cache 意义
+        const totalInput = agg.input_tokens + agg.cache_read_tokens;
+        if (totalInput < 5000)
+            continue; // 累计 input 太少不值得 cache
+        const cache_hit_rate = totalInput > 0 ? agg.cache_read_tokens / totalInput : 0;
+        // 如果 cache hit rate < 30% + 平均 input > 1024 tokens (cache 阈值) → 推荐启
+        const avg_input = agg.input_tokens / agg.count;
+        if (cache_hit_rate >= 0.3)
+            continue; // 已经在用 cache, skip
+        if (avg_input < 1024 && provider === 'openai')
+            continue; // OpenAI auto cache 阈值
+        if (avg_input < 200)
+            continue; // 太短不值得显式 cache
+        // 估算启 cache 后省多少
+        // 假设 cache hit rate 提到 70% (合理水平)
+        const targetCacheRate = 0.7;
+        const newCacheRead = totalInput * targetCacheRate;
+        const newRawInput = totalInput * (1 - targetCacheRate);
+        const price = getModelPrice(provider, key.split('/').slice(1).join('/'));
+        const oldCost = (agg.input_tokens / 1_000_000) * price.input_per_1m
+            + (agg.cache_read_tokens / 1_000_000) * price.cache_read_per_1m;
+        const newCost = (newRawInput / 1_000_000) * price.input_per_1m
+            + (newCacheRead / 1_000_000) * price.cache_read_per_1m
+            + (totalInput * 0.1 / 1_000_000) * price.cache_write_per_1m; // 估 cache write 是 input 10%
+        const savings_usd = oldCost - newCost;
+        if (savings_usd <= 0)
+            continue;
+        const savings_pct = (savings_usd / oldCost) * 100;
+        const monthly_savings_usd = savings_usd * (30 / 7);
+        const fix_method = opts.is_pro ? 'pro_auto' : 'free_manual';
+        suggestions.push({
+            engine: 'E2_cache',
+            headline: `${key} ${agg.count} 次调用 cache 命中率 ${(cache_hit_rate * 100).toFixed(0)}% — 启 cache 可省 ${Math.round(savings_pct)}% input cost`,
+            estimated_savings_pct: Math.round(savings_pct),
+            estimated_savings_tokens: Math.round(totalInput * (30 / 7) * targetCacheRate),
+            estimated_savings_cny: Math.round(monthly_savings_usd * USD_TO_CNY * 100) / 100,
+            fix_method,
+            fix_instructions: opts.is_pro ? undefined : buildCacheInstructions(provider),
+            pro_unlock_label: opts.is_pro
+                ? undefined
+                : `Pro 升级后 SkillFM gateway auto inject cache_control — 估月省 ¥${Math.round(monthly_savings_usd * USD_TO_CNY)}`,
+            details: {
+                model: key,
+                avg_input_tokens: Math.round(avg_input),
+                current_cache_hit_rate: cache_hit_rate,
+                target_cache_hit_rate: targetCacheRate,
+            },
+        });
+    }
+    return suggestions.sort((a, b) => b.estimated_savings_cny - a.estimated_savings_cny);
+}
+function buildCacheInstructions(provider) {
+    switch (provider) {
+        case 'anthropic':
+            return [
+                '在 system prompt 里加 cache_control breakpoint:',
+                '```',
+                '{role: "system", content: [{',
+                '  type: "text",',
+                '  text: "你的长 system prompt...",',
+                '  cache_control: {type: "ephemeral"}', // ephemeral 5 min cache
+                '}]}',
+                '```',
+                '价: cache write +25%, cache read 90% off (vs 普通 input)',
+            ].join('\n');
+        case 'openai':
+            return [
+                'OpenAI 自动 cache (1024+ token) — 无需 code 改, 但要保证 prompt 前缀稳定:',
+                '- 不要每次 inject 时间戳 / 随机 ID 在 prompt 顶',
+                '- 把 system + few-shot 例子放最前 (这样 prefix 稳定 → 自动 cache hit)',
+            ].join('\n');
+        case 'deepseek':
+            return 'DeepSeek 类似 OpenAI 自动 prefix cache, 保证 prompt 前缀稳定即可';
+        default:
+            return '该 provider 暂不支持 prompt cache';
+    }
+}
+//# sourceMappingURL=e2-cache.js.map

package/dist/save-token/e2-cache.js.map

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

package/dist/save-token/e3-batch.d.ts

@@ -0,0 +1,7 @@
+import type { LocalUsageStore } from '../usage-local/store.js';
+import type { SaveTokenSuggestion, SaveTokenScanOptions } from './types.js';
+/**
+ * 检测 batch 候选: 深夜调用 (00:00-06:00) 或 短时间内 5+ 调用 (批量类)
+ */
+export declare function scanE3Batch(store: LocalUsageStore, opts: SaveTokenScanOptions): Promise<SaveTokenSuggestion[]>;
+//# sourceMappingURL=e3-batch.d.ts.map

package/dist/save-token/e3-batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"e3-batch.d.ts","sourceRoot":"","sources":["../../src/save-token/e3-batch.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAI/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAO5E;;GAEG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA+DhC"}

package/dist/save-token/e3-batch.js

@@ -0,0 +1,80 @@
+// sdk/skillfm-local/src/save-token/e3-batch.ts
+//
+// E3 Batch API 推荐 (PRD §6.4) — 50% 即得 (异步任务).
+//
+// Free: 找 latency-tolerant task (深夜跑 / 批量同类 / 长完成时间) → 提示走 batch
+// Pro: gateway 自动 dispatch batch (2.7.5+)
+//
+// 真证据:
+//   OpenAI Batch API 50% off all models, 24h window
+//   Anthropic Message Batches 同 50%
+//   Stack: cache + batch = 75-95% off
+import { USD_TO_CNY } from '../usage-local/model-pricing.js';
+import { timeWindow } from '../usage-local/store.js';
+/**
+ * Batch API 真支持 provider
+ */
+const BATCH_SUPPORTED_PROVIDERS = new Set(['openai', 'anthropic']);
+/**
+ * 检测 batch 候选: 深夜调用 (00:00-06:00) 或 短时间内 5+ 调用 (批量类)
+ */
+export async function scanE3Batch(store, opts) {
+    const window = opts.start && opts.end
+        ? { start: opts.start, end: opts.end }
+        : timeWindow('week');
+    const records = store.query(window);
+    if (records.length === 0)
+        return [];
+    // 找深夜调用 (00:00-06:00 in Asia/Shanghai)
+    const nightRecords = records.filter((r) => {
+        if (!BATCH_SUPPORTED_PROVIDERS.has(r.provider.toLowerCase()))
+            return false;
+        const d = new Date(r.timestamp);
+        // 转 Asia/Shanghai 小时 (UTC+8)
+        const shanghaiHour = (d.getUTCHours() + 8) % 24;
+        return shanghaiHour < 6 || shanghaiHour >= 23;
+    });
+    if (nightRecords.length === 0)
+        return [];
+    // 算这些 record 总成本 + 估省 50%
+    let total_cost_usd = 0;
+    let total_tokens = 0;
+    const providerCount = new Map();
+    for (const r of nightRecords) {
+        total_cost_usd += r.estimated_cost_usd;
+        total_tokens += r.input_tokens + r.output_tokens;
+        providerCount.set(r.provider, (providerCount.get(r.provider) ?? 0) + 1);
+    }
+    if (total_cost_usd < 0.5)
+        return []; // 太少不值得
+    const savings_usd = total_cost_usd * 0.5;
+    const monthly_savings_usd = savings_usd * (30 / 7);
+    const monthly_savings_tokens = total_tokens * (30 / 7);
+    const providerList = Array.from(providerCount.entries())
+        .map(([p, c]) => `${p} ${c} 次`)
+        .join(', ');
+    const fix_method = opts.is_pro ? 'pro_auto' : 'free_manual';
+    return [{
+            engine: 'E3_batch',
+            headline: `深夜调用 ${nightRecords.length} 次 (${providerList}, ¥${(total_cost_usd * USD_TO_CNY).toFixed(2)}) — 走 batch API 50% off`,
+            estimated_savings_pct: 50,
+            estimated_savings_tokens: Math.round(monthly_savings_tokens),
+            estimated_savings_cny: Math.round(monthly_savings_usd * USD_TO_CNY * 100) / 100,
+            fix_method,
+            fix_instructions: opts.is_pro ? undefined : [
+                '深夜任务 (你不在等结果) 改走 Batch API 即 50% off:',
+                '- OpenAI: POST /v1/batches + 上传 JSONL, 24h 内返结果 (50% off)',
+                '- Anthropic: POST /v1/messages/batches 同上',
+                '在你的 agent / script 里, 把这类异步任务排队上传, 而非实时调用',
+            ].join('\n'),
+            pro_unlock_label: opts.is_pro
+                ? undefined
+                : `Pro 升级后 SkillFM gateway 自动 dispatch latency-tolerant task 到 Batch API — 估月省 ¥${Math.round(monthly_savings_usd * USD_TO_CNY)}`,
+            details: {
+                night_call_count: nightRecords.length,
+                provider_breakdown: Object.fromEntries(providerCount),
+                total_cost_usd_window: total_cost_usd,
+            },
+        }];
+}
+//# sourceMappingURL=e3-batch.js.map

package/dist/save-token/e3-batch.js.map

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

package/dist/save-token/gateway-setup.d.ts

@@ -0,0 +1,27 @@
+import type { GatewayDetection } from './types.js';
+export declare const SKILLFM_GATEWAY_BASE_URL: string;
+/**
+ * 检测各 IDE 的配置 + 当前 BASE_URL
+ */
+export declare function detectIDEs(): Promise<GatewayDetection[]>;
+/**
+ * 配置一个 IDE 的 gateway BASE_URL (写 config + 提供 revert 命令)
+ *
+ * 真改: 在每个 config 加 ANTHROPIC_BASE_URL / OPENAI_API_BASE 指向 SkillFM gateway
+ * 透明: 改之前 backup 原 config 到 ~/.skillfm/gateway-backup/<ts>/
+ */
+export interface SetupResult {
+    ide: string;
+    applied: boolean;
+    config_path?: string;
+    backup_path?: string;
+    revert_command?: string;
+    error?: string;
+}
+export declare function setupClaudeCodeGateway(): Promise<SetupResult>;
+export declare function setupShellEnvGateway(): Promise<SetupResult>;
+/**
+ * 一键配 — 所有检测到的 IDE
+ */
+export declare function setupAllDetectedGateways(): Promise<SetupResult[]>;
+//# sourceMappingURL=gateway-setup.d.ts.map

package/dist/save-token/gateway-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-setup.d.ts","sourceRoot":"","sources":["../../src/save-token/gateway-setup.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,YAAY,CAAC;AAEvE,eAAO,MAAM,wBAAwB,QAAuE,CAAC;AAE7G;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAsB9D;AAyFD;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,WAAW,CAAC,CAiCnE;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,WAAW,CAAC,CAoCjE;AAED;;GAEG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAcvE"}

package/dist/save-token/gateway-setup.js

@@ -0,0 +1,200 @@
+// sdk/skillfm-local/src/save-token/gateway-setup.ts
+//
+// LLM Gateway Onboarding 一键配置 (PRD V1.3 §3.4 + 决策 #8).
+// Eric 拍板: Day 0 一次问授权, Pro 升级 0 摩擦.
+//
+// 真核心:
+//   1. detectIDEs() — 看 PATH / 已知配置目录, 检测用户用啥 IDE
+//   2. setupGateway() — 改 IDE config 把 ANTHROPIC_BASE_URL / OPENAI_API_BASE 指向 SkillFM gateway
+//   3. revertGateway() — 1 行 unset 命令让用户随时回滚
+//
+// 透明性: 改任何文件前 surface 给用户 + 提供 revert 命令.
+// MVP: gateway 端 URL 用 placeholder (https://gateway.skillfm.ai), 真 gateway 服务 2.7.5 上线.
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { homedir } from 'node:os';
+export const SKILLFM_GATEWAY_BASE_URL = process.env.SKILLFM_GATEWAY_BASE_URL ?? 'https://gateway.skillfm.ai';
+/**
+ * 检测各 IDE 的配置 + 当前 BASE_URL
+ */
+export async function detectIDEs() {
+    const out = [];
+    // Claude Code: ~/.claude/settings.json
+    out.push(await detectClaudeCode());
+    // Cursor: ~/Library/Application Support/Cursor/User/settings.json (Mac)
+    out.push(await detectCursor());
+    // Codex: ~/.codex/config.json
+    out.push(await detectCodex());
+    // Aider: env CHECK
+    out.push(await detectAider());
+    // Continue: ~/.continue/config.json
+    out.push(await detectContinue());
+    // Shell env (zsh / bash)
+    out.push(await detectShellEnv());
+    return out;
+}
+async function detectClaudeCode() {
+    const settingsPath = path.join(homedir(), '.claude', 'settings.json');
+    const exists = fs.existsSync(settingsPath);
+    let current_base_url;
+    let setup_status = 'not_configured';
+    if (exists) {
+        try {
+            const content = await fs.promises.readFile(settingsPath, 'utf-8');
+            const settings = JSON.parse(content);
+            current_base_url = settings.env?.ANTHROPIC_BASE_URL;
+            setup_status = current_base_url?.includes('skillfm') ? 'configured' : 'not_configured';
+        }
+        catch {
+            setup_status = 'unknown';
+        }
+    }
+    return {
+        ide: 'claude-code',
+        detected: exists,
+        config_path: exists ? settingsPath : undefined,
+        current_base_url,
+        setup_status,
+    };
+}
+async function detectCursor() {
+    const cursorDir = path.join(homedir(), 'Library', 'Application Support', 'Cursor');
+    const detected = fs.existsSync(cursorDir);
+    return {
+        ide: 'cursor',
+        detected,
+        config_path: detected ? path.join(cursorDir, 'User', 'settings.json') : undefined,
+        setup_status: detected ? 'not_configured' : 'unknown',
+    };
+}
+async function detectCodex() {
+    const cfgPath = path.join(homedir(), '.codex', 'config.json');
+    const exists = fs.existsSync(cfgPath);
+    return {
+        ide: 'codex',
+        detected: exists,
+        config_path: exists ? cfgPath : undefined,
+        setup_status: exists ? 'not_configured' : 'unknown',
+    };
+}
+async function detectAider() {
+    // Aider 用 env 配, 没固定 config 文件
+    return {
+        ide: 'aider',
+        detected: false, // 简化: MVP 不主动检测 aider, 用户手动配
+        setup_status: 'unknown',
+    };
+}
+async function detectContinue() {
+    const cfgPath = path.join(homedir(), '.continue', 'config.json');
+    const exists = fs.existsSync(cfgPath);
+    return {
+        ide: 'continue',
+        detected: exists,
+        config_path: exists ? cfgPath : undefined,
+        setup_status: exists ? 'not_configured' : 'unknown',
+    };
+}
+async function detectShellEnv() {
+    const current_anthropic = process.env.ANTHROPIC_BASE_URL;
+    const current_openai = process.env.OPENAI_API_BASE;
+    const isConfigured = !!(current_anthropic?.includes('skillfm') || current_openai?.includes('skillfm'));
+    // 检测 shell rc
+    const zshrc = path.join(homedir(), '.zshrc');
+    const bashrc = path.join(homedir(), '.bashrc');
+    const cfgPath = fs.existsSync(zshrc) ? zshrc : fs.existsSync(bashrc) ? bashrc : undefined;
+    return {
+        ide: 'shell-env',
+        detected: !!cfgPath,
+        config_path: cfgPath,
+        current_base_url: current_anthropic ?? current_openai,
+        setup_status: isConfigured ? 'configured' : 'not_configured',
+    };
+}
+export async function setupClaudeCodeGateway() {
+    const settingsPath = path.join(homedir(), '.claude', 'settings.json');
+    const ide = 'claude-code';
+    if (!fs.existsSync(settingsPath)) {
+        // Claude Code 不存在 → skip
+        return { ide, applied: false, error: 'Claude Code not detected' };
+    }
+    // backup
+    const backupDir = path.join(homedir(), '.skillfm', 'gateway-backup', new Date().toISOString().replace(/[:.]/g, '-'));
+    await fs.promises.mkdir(backupDir, { recursive: true, mode: 0o700 });
+    const backupPath = path.join(backupDir, 'claude-settings.json');
+    await fs.promises.copyFile(settingsPath, backupPath);
+    // 改 config
+    try {
+        const content = await fs.promises.readFile(settingsPath, 'utf-8');
+        const settings = JSON.parse(content);
+        settings.env = settings.env ?? {};
+        settings.env.ANTHROPIC_BASE_URL = SKILLFM_GATEWAY_BASE_URL;
+        await fs.promises.writeFile(settingsPath, JSON.stringify(settings, null, 2), 'utf-8');
+        return {
+            ide,
+            applied: true,
+            config_path: settingsPath,
+            backup_path: backupPath,
+            revert_command: `cp "${backupPath}" "${settingsPath}"`,
+        };
+    }
+    catch (e) {
+        return { ide, applied: false, error: e.message };
+    }
+}
+export async function setupShellEnvGateway() {
+    const ide = 'shell-env';
+    const zshrc = path.join(homedir(), '.zshrc');
+    const bashrc = path.join(homedir(), '.bashrc');
+    const rcPath = fs.existsSync(zshrc) ? zshrc : fs.existsSync(bashrc) ? bashrc : null;
+    if (!rcPath) {
+        return { ide, applied: false, error: 'No shell rc found' };
+    }
+    const backupDir = path.join(homedir(), '.skillfm', 'gateway-backup', new Date().toISOString().replace(/[:.]/g, '-'));
+    await fs.promises.mkdir(backupDir, { recursive: true, mode: 0o700 });
+    const backupPath = path.join(backupDir, path.basename(rcPath));
+    await fs.promises.copyFile(rcPath, backupPath);
+    const block = [
+        '',
+        '# === SkillFM Gateway (added by skillfm_setup_gateway) ===',
+        `export ANTHROPIC_BASE_URL="${SKILLFM_GATEWAY_BASE_URL}/anthropic"`,
+        `export OPENAI_API_BASE="${SKILLFM_GATEWAY_BASE_URL}/openai"`,
+        '# === SkillFM Gateway end ===',
+        '',
+    ].join('\n');
+    try {
+        await fs.promises.appendFile(rcPath, block, 'utf-8');
+        return {
+            ide,
+            applied: true,
+            config_path: rcPath,
+            backup_path: backupPath,
+            revert_command: `cp "${backupPath}" "${rcPath}" && source "${rcPath}"`,
+        };
+    }
+    catch (e) {
+        return { ide, applied: false, error: e.message };
+    }
+}
+/**
+ * 一键配 — 所有检测到的 IDE
+ */
+export async function setupAllDetectedGateways() {
+    const detections = await detectIDEs();
+    const results = [];
+    for (const d of detections) {
+        if (!d.detected)
+            continue;
+        if (d.setup_status === 'configured') {
+            results.push({ ide: d.ide, applied: false, error: 'already configured' });
+            continue;
+        }
+        if (d.ide === 'claude-code')
+            results.push(await setupClaudeCodeGateway());
+        else if (d.ide === 'shell-env')
+            results.push(await setupShellEnvGateway());
+        // Cursor / Codex / Aider / Continue: MVP 仅 surface 提示用户手动配 (UI 复杂)
+    }
+    return results;
+}
+//# sourceMappingURL=gateway-setup.js.map

package/dist/save-token/gateway-setup.js.map

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

package/dist/save-token/index.d.ts

@@ -0,0 +1,13 @@
+export type { EngineId, FixMethod, SaveTokenSuggestion, SaveTokenScanOptions, GatewaySetupStatus, GatewayDetection, } from './types.js';
+export { scanE1Router } from './e1-router.js';
+export { scanE2Cache } from './e2-cache.js';
+export { scanE3Batch } from './e3-batch.js';
+export { detectIDEs, setupClaudeCodeGateway, setupShellEnvGateway, setupAllDetectedGateways, SKILLFM_GATEWAY_BASE_URL, } from './gateway-setup.js';
+export type { SetupResult } from './gateway-setup.js';
+import type { LocalUsageStore } from '../usage-local/store.js';
+import type { SaveTokenSuggestion, SaveTokenScanOptions } from './types.js';
+/**
+ * 跑全 engine 扫描 (E1+E2+E3 并行) — 主入口用
+ */
+export declare function scanAllEngines(store: LocalUsageStore, opts: SaveTokenScanOptions): Promise<SaveTokenSuggestion[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/save-token/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/save-token/index.ts"],"names":[],"mappings":"AAKA,YAAY,EACV,QAAQ,EACR,SAAS,EACT,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EACL,UAAU,EACV,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAK5E;;GAEG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAOhC"}

package/dist/save-token/index.js

@@ -0,0 +1,23 @@
+// sdk/skillfm-local/src/save-token/index.ts
+//
+// Save Token Engine — public API.
+// 真"省 token" 5 大引擎 (PRD V1.3 §6).
+export { scanE1Router } from './e1-router.js';
+export { scanE2Cache } from './e2-cache.js';
+export { scanE3Batch } from './e3-batch.js';
+export { detectIDEs, setupClaudeCodeGateway, setupShellEnvGateway, setupAllDetectedGateways, SKILLFM_GATEWAY_BASE_URL, } from './gateway-setup.js';
+import { scanE1Router } from './e1-router.js';
+import { scanE2Cache } from './e2-cache.js';
+import { scanE3Batch } from './e3-batch.js';
+/**
+ * 跑全 engine 扫描 (E1+E2+E3 并行) — 主入口用
+ */
+export async function scanAllEngines(store, opts) {
+    const [e1, e2, e3] = await Promise.all([
+        scanE1Router(store, opts),
+        scanE2Cache(store, opts),
+        scanE3Batch(store, opts),
+    ]);
+    return [...e1, ...e2, ...e3].sort((a, b) => b.estimated_savings_cny - a.estimated_savings_cny);
+}
+//# sourceMappingURL=index.js.map

package/dist/save-token/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/save-token/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,EAAE;AACF,kCAAkC;AAClC,kCAAkC;AAUlC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EACL,UAAU,EACV,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAK5B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAsB,EACtB,IAA0B;IAE1B,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACrC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC;QACzB,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC;QACxB,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC;KACzB,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,qBAAqB,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC;AACjG,CAAC"}

package/dist/save-token/types.d.ts

@@ -0,0 +1,46 @@
+export type EngineId = 'E1_router' | 'E2_cache' | 'E3_batch' | 'E4_compress' | 'E5_rotate';
+export type FixMethod = 'free_manual' | 'pro_auto' | 'pro_locked';
+/**
+ * 一条省 token 建议 (来自任一 engine 的扫描)
+ */
+export interface SaveTokenSuggestion {
+    engine: EngineId;
+    /** 短文案 — surface 给 agent / 用户 (e.g. "5 次 Sonnet 可切 Haiku") */
+    headline: string;
+    /** 估算省 token 百分比 (0-100) */
+    estimated_savings_pct: number;
+    /** 估算月省 token (基于过去 7 天日均) */
+    estimated_savings_tokens: number;
+    /** 估算月省 CNY (基于价目表) */
+    estimated_savings_cny: number;
+    /** 修法 */
+    fix_method: FixMethod;
+    /** Free 用户手动操作步骤 */
+    fix_instructions?: string;
+    /** Pro 升级文案 */
+    pro_unlock_label?: string;
+    /** Engine 详情 — 比如哪个 model / 哪个 prompt 触发了建议 */
+    details?: Record<string, unknown>;
+}
+/**
+ * Save Token Engine 扫描请求
+ */
+export interface SaveTokenScanOptions {
+    /** 是否 Pro 用户 */
+    is_pro: boolean;
+    /** 时间窗口 (默认近 7 天) */
+    start?: string;
+    end?: string;
+}
+/**
+ * Gateway setup 状态 (per IDE)
+ */
+export type GatewaySetupStatus = 'not_configured' | 'configured' | 'partial' | 'unknown';
+export interface GatewayDetection {
+    ide: 'claude-code' | 'cursor' | 'codex' | 'aider' | 'continue' | 'shell-env';
+    detected: boolean;
+    config_path?: string;
+    current_base_url?: string;
+    setup_status: GatewaySetupStatus;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/save-token/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/save-token/types.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,QAAQ,GAChB,WAAW,GACX,UAAU,GACV,UAAU,GACV,aAAa,GACb,WAAW,CAAC;AAEhB,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,UAAU,GAAG,YAAY,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,QAAQ,CAAC;IACjB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,8BAA8B;IAC9B,wBAAwB,EAAE,MAAM,CAAC;IACjC,uBAAuB;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,SAAS;IACT,UAAU,EAAE,SAAS,CAAC;IACtB,oBAAoB;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gBAAgB;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,gBAAgB,GAChB,YAAY,GACZ,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC;IAC7E,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,kBAAkB,CAAC;CAClC"}

package/dist/save-token/types.js

@@ -0,0 +1,5 @@
+// sdk/skillfm-local/src/save-token/types.ts
+//
+// Save Token Engine 5 大引擎 types (PRD V1.3 §6).
+export {};
+//# sourceMappingURL=types.js.map

package/dist/save-token/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/save-token/types.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,EAAE;AACF,+CAA+C"}

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"}