snow-ai 0.3.6 → 0.3.7

package/dist/utils/mcpToolsManager.js

@@ -9,7 +9,7 @@ import { mcpTools as aceCodeSearchTools } from '../mcp/aceCodeSearch.js';
 import { mcpTools as websearchTools } from '../mcp/websearch.js';
 import { mcpTools as ideDiagnosticsTools } from '../mcp/ideDiagnostics.js';
 import { TodoService } from '../mcp/todo.js';
-import { getMCPTools as getSubAgentTools, subAgentService } from '../mcp/subagent.js';
+import { getMCPTools as getSubAgentTools, subAgentService, } from '../mcp/subagent.js';
 import { sessionManager } from './sessionManager.js';
 import { logger } from './logger.js';
 import { resourceMonitor } from './resourceMonitor.js';
@@ -69,7 +69,7 @@ async function refreshToolsCache() {
     const servicesInfo = [];
     // Add built-in filesystem tools (always available)
     const filesystemServiceTools = filesystemTools.map(tool => ({
-        name: tool.name.replace('filesystem_', ''),
+        name: tool.name.replace('filesystem-', ''),
         description: tool.description,
         inputSchema: tool.inputSchema,
     }));
@@ -83,7 +83,7 @@ async function refreshToolsCache() {
         allTools.push({
             type: 'function',
             function: {
-                name: `filesystem-${tool.name.replace('filesystem_', '')}`,
+                name: tool.name,
                 description: tool.description,
                 parameters: tool.inputSchema,
             },
@@ -91,7 +91,7 @@ async function refreshToolsCache() {
     }
     // Add built-in terminal tools (always available)
     const terminalServiceTools = terminalTools.map(tool => ({
-        name: tool.name.replace('terminal_', ''),
+        name: tool.name.replace('terminal-', ''),
         description: tool.description,
         inputSchema: tool.inputSchema,
     }));
@@ -105,7 +105,7 @@ async function refreshToolsCache() {
         allTools.push({
             type: 'function',
             function: {
-                name: `terminal-${tool.name.replace('terminal_', '')}`,
+                name: tool.name,
                 description: tool.description,
                 parameters: tool.inputSchema,
             },
@@ -137,7 +137,7 @@ async function refreshToolsCache() {
     }
     // Add built-in ACE Code Search tools (always available)
     const aceServiceTools = aceCodeSearchTools.map(tool => ({
-        name: tool.name.replace('ace_', ''),
+        name: tool.name.replace('ace-', ''),
         description: tool.description,
         inputSchema: tool.inputSchema,
     }));
@@ -151,7 +151,7 @@ async function refreshToolsCache() {
         allTools.push({
             type: 'function',
             function: {
-                name: `ace-${tool.name.replace('ace_', '')}`,
+                name: tool.name,
                 description: tool.description,
                 parameters: tool.inputSchema,
             },
@@ -159,7 +159,7 @@ async function refreshToolsCache() {
     }
     // Add built-in Web Search tools (always available)
     const websearchServiceTools = websearchTools.map(tool => ({
-        name: tool.name.replace('websearch_', ''),
+        name: tool.name.replace('websearch-', ''),
         description: tool.description,
         inputSchema: tool.inputSchema,
     }));
@@ -173,7 +173,7 @@ async function refreshToolsCache() {
         allTools.push({
             type: 'function',
             function: {
-                name: `websearch-${tool.name.replace('websearch_', '')}`,
+                name: tool.name,
                 description: tool.description,
                 parameters: tool.inputSchema,
             },
@@ -181,7 +181,7 @@ async function refreshToolsCache() {
     }
     // Add built-in IDE Diagnostics tools (always available)
     const ideDiagnosticsServiceTools = ideDiagnosticsTools.map(tool => ({
-        name: tool.name.replace('ide_', ''),
+        name: tool.name.replace('ide-', ''),
         description: tool.description,
         inputSchema: tool.inputSchema,
     }));
@@ -195,7 +195,7 @@ async function refreshToolsCache() {
         allTools.push({
             type: 'function',
             function: {
-                name: `ide-${tool.name.replace('ide_', '')}`,
+                name: tool.name,
                 description: tool.description,
                 parameters: tool.inputSchema,
             },
@@ -598,7 +598,7 @@ export async function executeMCPTool(toolName, args, abortSignal, onTokenUpdate)
     }
     if (serviceName === 'todo') {
         // Handle built-in TODO tools (no connection needed)
-        return await todoService.executeTool(toolName, args);
+        return await todoService.executeTool(actualToolName, args);
     }
     else if (serviceName === 'filesystem') {
         // Handle built-in filesystem tools (no connection needed)

package/dist/utils/proxyUtils.d.ts

@@ -0,0 +1,15 @@
+import type { Agent as HttpAgent } from 'http';
+import type { Agent as HttpsAgent } from 'https';
+/**
+ * 创建代理 Agent（如果启用了代理）
+ * @param targetUrl - 目标 URL，用于判断是否使用 HTTPS
+ * @returns HTTP/HTTPS Agent，如果未启用代理则返回 undefined
+ */
+export declare function createProxyAgent(targetUrl: string): HttpAgent | HttpsAgent | undefined;
+/**
+ * 为 fetch 请求添加代理支持
+ * @param url - 请求 URL
+ * @param options - fetch 选项
+ * @returns 添加了代理支持的 fetch 选项
+ */
+export declare function addProxyToFetchOptions(url: string, options?: RequestInit): RequestInit;

package/dist/utils/proxyUtils.js

@@ -0,0 +1,50 @@
+import { getProxyConfig } from './apiConfig.js';
+import { HttpsProxyAgent } from 'https-proxy-agent';
+import { HttpProxyAgent } from 'http-proxy-agent';
+/**
+ * 创建代理 Agent（如果启用了代理）
+ * @param targetUrl - 目标 URL，用于判断是否使用 HTTPS
+ * @returns HTTP/HTTPS Agent，如果未启用代理则返回 undefined
+ */
+export function createProxyAgent(targetUrl) {
+    const proxyConfig = getProxyConfig();
+    // 如果代理未启用，直接返回 undefined
+    if (!proxyConfig.enabled) {
+        return undefined;
+    }
+    // 构建代理 URL
+    const proxyUrl = `http://127.0.0.1:${proxyConfig.port}`;
+    // 根据目标 URL 协议选择合适的代理 Agent
+    try {
+        const url = new URL(targetUrl);
+        if (url.protocol === 'https:') {
+            return new HttpsProxyAgent(proxyUrl);
+        }
+        else {
+            return new HttpProxyAgent(proxyUrl);
+        }
+    }
+    catch (error) {
+        // URL 解析失败，默认使用 HTTPS
+        return new HttpsProxyAgent(proxyUrl);
+    }
+}
+/**
+ * 为 fetch 请求添加代理支持
+ * @param url - 请求 URL
+ * @param options - fetch 选项
+ * @returns 添加了代理支持的 fetch 选项
+ */
+export function addProxyToFetchOptions(url, options = {}) {
+    const agent = createProxyAgent(url);
+    if (!agent) {
+        return options;
+    }
+    // 添加 agent 到 fetch 选项
+    // 注意：Node.js 的 fetch 支持 dispatcher 选项
+    return {
+        ...options,
+        // @ts-ignore - Node.js fetch 支持 agent
+        agent,
+    };
+}

package/dist/utils/retryUtils.d.ts

@@ -20,3 +20,30 @@ export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOption
  * 注意：如果生成器已经开始产生数据，则不会重试
  */
 export declare function withRetryGenerator<T>(fn: () => AsyncGenerator<T, void, unknown>, options?: RetryOptions): AsyncGenerator<T, void, unknown>;
+/**
+ * JSON 解析结果
+ */
+export interface JsonParseResult<T = any> {
+    success: boolean;
+    data?: T;
+    error?: Error;
+    wasFixed?: boolean;
+    originalJson?: string;
+    fixedJson?: string;
+}
+/**
+ * 尝试解析 JSON，如果失败则尝试修复常见的 JSON 错误
+ * @param jsonString - 要解析的 JSON 字符串
+ * @param options - 配置选项
+ * @returns 解析结果
+ */
+export declare function parseJsonWithFix<T = any>(jsonString: string, options?: {
+    /** 是否在修复成功时记录警告 */
+    logWarning?: boolean;
+    /** 是否在修复失败时记录错误 */
+    logError?: boolean;
+    /** 工具名称（用于日志） */
+    toolName?: string;
+    /** 失败时的回退值 */
+    fallbackValue?: T;
+}): JsonParseResult<T>;

package/dist/utils/retryUtils.js

@@ -5,6 +5,7 @@
  * - 延时递增策略 (1s, 2s, 4s, 8s, 16s)
  * - 支持 AbortSignal 中断
  */
+import { logger } from './logger.js';
 /**
  * 延时函数，支持 AbortSignal 中断
  */
@@ -48,8 +49,11 @@ function isRetriableError(error) {
         errorMessage.includes('429')) {
         return true;
     }
-    // Server errors (5xx)
-    if (errorMessage.includes('500') ||
+    // Server errors
+    if (errorMessage.includes('400') ||
+        errorMessage.includes('403') ||
+        errorMessage.includes('405') ||
+        errorMessage.includes('500') ||
         errorMessage.includes('502') ||
         errorMessage.includes('503') ||
         errorMessage.includes('504') ||
@@ -189,3 +193,111 @@ export async function* withRetryGenerator(fn, options = {}) {
     // 不应该到达这里
     throw lastError || new Error('Retry failed');
 }
+/**
+ * 尝试解析 JSON，如果失败则尝试修复常见的 JSON 错误
+ * @param jsonString - 要解析的 JSON 字符串
+ * @param options - 配置选项
+ * @returns 解析结果
+ */
+export function parseJsonWithFix(jsonString, options = {}) {
+    const { logWarning = true, logError = true, toolName = 'unknown', fallbackValue, } = options;
+    // 首先尝试直接解析
+    try {
+        const data = JSON.parse(jsonString);
+        return { success: true, data };
+    }
+    catch (originalError) {
+        // 解析失败，尝试修复
+        let fixedJson = jsonString;
+        let wasFixed = false;
+        // Fix 1: 移除格式错误的模式，如 "endLine":685 ": ""
+        // 处理值后面有额外冒号和引号的情况
+        const malformedPattern = /(\"[\w]+\"\s*:\s*[^,}\]]+)\s*\":\s*\"[^\"]*\"/g;
+        if (malformedPattern.test(fixedJson)) {
+            fixedJson = fixedJson.replace(malformedPattern, '$1');
+            wasFixed = true;
+        }
+        // Fix 2: 移除闭合括号前的尾随逗号
+        if (/,(\s*[}\]])/.test(fixedJson)) {
+            fixedJson = fixedJson.replace(/,(\s*[}\]])/g, '$1');
+            wasFixed = true;
+        }
+        // Fix 3: 修复属性名缺少引号的问题
+        if (/{\s*\w+\s*:/.test(fixedJson)) {
+            fixedJson = fixedJson.replace(/{\s*(\w+)\s*:/g, '{"$1":');
+            fixedJson = fixedJson.replace(/,\s*(\w+)\s*:/g, ',"$1":');
+            wasFixed = true;
+        }
+        // Fix 4: 添加缺失的闭合括号
+        const openBraces = (fixedJson.match(/{/g) || []).length;
+        const closeBraces = (fixedJson.match(/}/g) || []).length;
+        const openBrackets = (fixedJson.match(/\[/g) || []).length;
+        const closeBrackets = (fixedJson.match(/\]/g) || []).length;
+        if (openBraces > closeBraces) {
+            fixedJson += '}'.repeat(openBraces - closeBraces);
+            wasFixed = true;
+        }
+        if (openBrackets > closeBrackets) {
+            fixedJson += ']'.repeat(openBrackets - closeBrackets);
+            wasFixed = true;
+        }
+        // Fix 5: 移除多余的闭合括号
+        if (closeBraces > openBraces) {
+            const extraBraces = closeBraces - openBraces;
+            for (let i = 0; i < extraBraces; i++) {
+                fixedJson = fixedJson.replace(/}([^}]*)$/, '$1');
+            }
+            wasFixed = true;
+        }
+        if (closeBrackets > openBrackets) {
+            const extraBrackets = closeBrackets - openBrackets;
+            for (let i = 0; i < extraBrackets; i++) {
+                fixedJson = fixedJson.replace(/\]([^\]]*)$/, '$1');
+            }
+            wasFixed = true;
+        }
+        // 尝试解析修复后的 JSON
+        try {
+            const data = JSON.parse(fixedJson);
+            if (wasFixed && logWarning) {
+                logger.warn(`Warning: Fixed malformed JSON for ${toolName}`);
+            }
+            return {
+                success: true,
+                data,
+                wasFixed,
+                originalJson: jsonString,
+                fixedJson,
+            };
+        }
+        catch (fixError) {
+            // 修复失败
+            if (logError) {
+                logger.error(`Error: Failed to parse JSON for ${toolName}`);
+                logger.error(`Original: ${jsonString}`);
+                if (wasFixed) {
+                    logger.error(`After fixes: ${fixedJson}`);
+                }
+                logger.error(`Parse error: ${fixError instanceof Error ? fixError.message : 'Unknown'}`);
+            }
+            // 如果提供了回退值，使用回退值
+            if (fallbackValue !== undefined) {
+                return {
+                    success: false,
+                    data: fallbackValue,
+                    error: fixError instanceof Error ? fixError : new Error(String(fixError)),
+                    wasFixed,
+                    originalJson: jsonString,
+                    fixedJson: wasFixed ? fixedJson : undefined,
+                };
+            }
+            return {
+                success: false,
+                error: fixError instanceof Error ? fixError : new Error(String(fixError)),
+                wasFixed,
+                originalJson: jsonString,
+                fixedJson: wasFixed ? fixedJson : undefined,
+            };
+        }
+    }
+}

package/dist/utils/sessionManager.d.ts

@@ -22,17 +22,14 @@ export interface SessionListItem {
 declare class SessionManager {
     private readonly sessionsDir;
     private currentSession;
-    private summaryAbortController;
-    private summaryTimeoutId;
     constructor();
     private ensureSessionsDir;
     private getSessionPath;
     private formatDateForFolder;
     /**
-     * Cancel any ongoing summary generation
-     * This prevents wasted resources and race conditions
+     * Clean title by removing newlines and extra spaces
      */
-    private cancelOngoingSummaryGeneration;
+    private cleanTitle;
     createNewSession(): Promise<Session>;
     saveSession(session: Session): Promise<void>;
     loadSession(sessionId: string): Promise<Session | null>;

package/dist/utils/sessionManager.js

@@ -2,8 +2,8 @@ import fs from 'fs/promises';
 import path from 'path';
 import os from 'os';
 import { randomUUID } from 'crypto';
-import { summaryAgent } from '../agents/summaryAgent.js';
 import { getTodoService } from './mcpToolsManager.js';
+import { logger } from './logger.js';
 class SessionManager {
     constructor() {
         Object.defineProperty(this, "sessionsDir", {
@@ -18,18 +18,6 @@ class SessionManager {
             writable: true,
             value: null
         });
-        Object.defineProperty(this, "summaryAbortController", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: null
-        });
-        Object.defineProperty(this, "summaryTimeoutId", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: null
-        });
         this.sessionsDir = path.join(os.homedir(), '.snow', 'sessions');
     }
     async ensureSessionsDir(date) {
@@ -58,18 +46,13 @@ class SessionManager {
         return `${year}-${month}-${day}`;
     }
     /**
-     * Cancel any ongoing summary generation
-     * This prevents wasted resources and race conditions
+     * Clean title by removing newlines and extra spaces
      */
-    cancelOngoingSummaryGeneration() {
-        if (this.summaryAbortController) {
-            this.summaryAbortController.abort();
-            this.summaryAbortController = null;
-        }
-        if (this.summaryTimeoutId) {
-            clearTimeout(this.summaryTimeoutId);
-            this.summaryTimeoutId = null;
-        }
+    cleanTitle(title) {
+        return title
+            .replace(/[\r\n]+/g, ' ') // Replace newlines with space
+            .replace(/\s+/g, ' ') // Replace multiple spaces with single space
+            .trim(); // Remove leading/trailing spaces
     }
     async createNewSession() {
         await this.ensureSessionsDir(new Date());
@@ -165,7 +148,7 @@ class SessionManager {
                         const session = JSON.parse(data);
                         sessions.push({
                             id: session.id,
-                            title: session.title,
+                            title: this.cleanTitle(session.title),
                             summary: session.summary,
                             createdAt: session.createdAt,
                             updatedAt: session.updatedAt,
@@ -196,7 +179,7 @@ class SessionManager {
                         const session = JSON.parse(data);
                         sessions.push({
                             id: session.id,
-                            title: session.title,
+                            title: this.cleanTitle(session.title),
                             summary: session.summary,
                             createdAt: session.createdAt,
                             updatedAt: session.updatedAt,
@@ -260,59 +243,13 @@ class SessionManager {
         this.currentSession.messages.push(message);
         this.currentSession.messageCount = this.currentSession.messages.length;
         this.currentSession.updatedAt = Date.now();
-        // Generate summary from first user message using summaryAgent (parallel, non-blocking)
+        // Generate simple title and summary from first user message
         if (this.currentSession.messageCount === 1 && message.role === 'user') {
-            // Set temporary title immediately (synchronous)
-            this.currentSession.title = message.content.slice(0, 50);
-            this.currentSession.summary = message.content.slice(0, 100);
-            // Cancel any previous summary generation (防呆机制)
-            this.cancelOngoingSummaryGeneration();
-            // Create new AbortController for this summary generation
-            this.summaryAbortController = new AbortController();
-            const currentSessionId = this.currentSession.id;
-            const abortSignal = this.summaryAbortController.signal;
-            // Set timeout to cancel summary generation after 30 seconds (防呆机制)
-            this.summaryTimeoutId = setTimeout(() => {
-                if (this.summaryAbortController) {
-                    console.warn('Summary generation timeout after 30s, aborting...');
-                    this.summaryAbortController.abort();
-                    this.summaryAbortController = null;
-                }
-            }, 30000);
-            // Generate better summary in parallel (non-blocking)
-            // This won't delay the main conversation flow
-            summaryAgent
-                .generateSummary(message.content, abortSignal)
-                .then(summary => {
-                // 防呆检查：确保会话没有被切换，且仍然是第一条消息
-                if (this.currentSession &&
-                    this.currentSession.id === currentSessionId &&
-                    this.currentSession.messageCount === 1) {
-                    // Only update if this is still the first message in the same session
-                    this.currentSession.title = summary;
-                    this.currentSession.summary = summary;
-                    this.saveSession(this.currentSession).catch(error => {
-                        console.error('Failed to save session with generated summary:', error);
-                    });
-                }
-                // Clean up
-                this.cancelOngoingSummaryGeneration();
-            })
-                .catch(error => {
-                // Clean up on error
-                this.cancelOngoingSummaryGeneration();
-                // Silently fail if aborted (expected behavior)
-                if (error.name === 'AbortError' || abortSignal.aborted) {
-                    console.log('Summary generation cancelled (expected)');
-                    return;
-                }
-                // Log other errors - we already have a fallback title/summary
-                console.warn('Summary generation failed, using fallback:', error);
-            });
-        }
-        else if (this.currentSession.messageCount > 1) {
-            // 防呆机制：如果不是第一条消息，取消任何正在进行的摘要生成
-            this.cancelOngoingSummaryGeneration();
+            // Use first 50 chars as title, first 100 chars as summary
+            const title = message.content.slice(0, 50) + (message.content.length > 50 ? '...' : '');
+            const summary = message.content.slice(0, 100) + (message.content.length > 100 ? '...' : '');
+            this.currentSession.title = this.cleanTitle(title);
+            this.currentSession.summary = this.cleanTitle(summary);
         }
         await this.saveSession(this.currentSession);
     }
@@ -320,13 +257,9 @@ class SessionManager {
         return this.currentSession;
     }
     setCurrentSession(session) {
-        // 防呆机制：切换会话时取消正在进行的摘要生成
-        this.cancelOngoingSummaryGeneration();
         this.currentSession = session;
     }
     clearCurrentSession() {
-        // 防呆机制：清除会话时取消正在进行的摘要生成
-        this.cancelOngoingSummaryGeneration();
         this.currentSession = null;
     }
     async deleteSession(sessionId) {
@@ -374,7 +307,7 @@ class SessionManager {
             }
             catch (error) {
                 // TODO删除失败不影响会话删除结果
-                console.warn(`Failed to delete TODO list for session ${sessionId}:`, error);
+                logger.warn(`Failed to delete TODO list for session ${sessionId}:`, error);
             }
         }
         return sessionDeleted;

package/dist/utils/terminal.js

@@ -6,7 +6,8 @@ export function resetTerminal(stream) {
     // RIS (Reset to Initial State) clears scrollback and resets terminal modes
     target.write('\x1bc');
     target.write('\x1B[3J\x1B[2J\x1B[H');
-    // DO NOT re-enable focus reporting here
-    // Let useTerminalFocus handle it when ChatScreen mounts
-    // This avoids the race condition where focus event arrives before listener is ready
+    // Re-enable focus reporting immediately after terminal reset
+    // The RIS command (\x1bc) disables focus reporting, so we must re-enable it
+    // This ensures focus state tracking continues to work after /clear command
+    target.write('\x1b[?1004h');
 }

package/dist/utils/usageLogger.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Save usage data to file system
+ * This is called directly from API layers to ensure all usage is tracked
+ */
+export declare function saveUsageToFile(model: string, usage: {
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    cache_creation_input_tokens?: number;
+    cache_read_input_tokens?: number;
+    cached_tokens?: number;
+}): void;

package/dist/utils/usageLogger.js

@@ -0,0 +1,99 @@
+import fs from 'fs/promises';
+import path from 'path';
+import os from 'os';
+const MAX_FILE_SIZE = 5 * 1024 * 1024; // 5MB
+// 队列来避免并发写入冲突
+let writeQueue = Promise.resolve();
+async function getActiveProfile() {
+    try {
+        const homeDir = os.homedir();
+        const profilePath = path.join(homeDir, '.snow', 'active-profile.txt');
+        const profileName = await fs.readFile(profilePath, 'utf-8');
+        return profileName.trim();
+    }
+    catch (error) {
+        return 'default';
+    }
+}
+async function getUsageDir() {
+    const homeDir = os.homedir();
+    const snowDir = path.join(homeDir, '.snow', 'usage');
+    const today = new Date().toISOString().split('T')[0] || ''; // YYYY-MM-DD
+    const dateDir = path.join(snowDir, today);
+    // 确保目录存在
+    try {
+        await fs.mkdir(dateDir, { recursive: true });
+    }
+    catch (error) {
+        // 目录可能已存在，忽略错误
+    }
+    return dateDir;
+}
+async function getCurrentLogFile(dateDir) {
+    try {
+        const files = (await fs.readdir(dateDir)).filter(f => f.startsWith('usage-') && f.endsWith('.jsonl'));
+        if (files.length === 0) {
+            return path.join(dateDir, 'usage-001.jsonl');
+        }
+        // 按文件名排序，获取最新的文件
+        files.sort();
+        const latestFileName = files[files.length - 1];
+        if (!latestFileName) {
+            return path.join(dateDir, 'usage-001.jsonl');
+        }
+        const latestFile = path.join(dateDir, latestFileName);
+        // 检查文件大小
+        const stats = await fs.stat(latestFile);
+        if (stats.size >= MAX_FILE_SIZE) {
+            // 创建新文件
+            const match = latestFileName.match(/usage-(\d+)\.jsonl/);
+            const nextNum = match && match[1] ? parseInt(match[1]) + 1 : 1;
+            return path.join(dateDir, `usage-${String(nextNum).padStart(3, '0')}.jsonl`);
+        }
+        return latestFile;
+    }
+    catch (error) {
+        // 如果目录不存在或读取失败，返回默认文件名
+        return path.join(dateDir, 'usage-001.jsonl');
+    }
+}
+/**
+ * Save usage data to file system
+ * This is called directly from API layers to ensure all usage is tracked
+ */
+export function saveUsageToFile(model, usage) {
+    // Add to write queue to avoid concurrent writes
+    writeQueue = writeQueue
+        .then(async () => {
+        try {
+            const profileName = await getActiveProfile();
+            const dateDir = await getUsageDir();
+            const logFile = await getCurrentLogFile(dateDir);
+            // Extract cache tokens (different API formats)
+            const cacheReadTokens = usage.cache_read_input_tokens ?? usage.cached_tokens;
+            // Only save non-sensitive data: model name, profile, and token counts
+            const record = {
+                model,
+                profileName,
+                inputTokens: usage.prompt_tokens || 0,
+                outputTokens: usage.completion_tokens || 0,
+                ...(usage.cache_creation_input_tokens !== undefined && {
+                    cacheCreationInputTokens: usage.cache_creation_input_tokens,
+                }),
+                ...(cacheReadTokens !== undefined && {
+                    cacheReadInputTokens: cacheReadTokens,
+                }),
+                timestamp: new Date().toISOString(),
+            };
+            // Append to file (JSONL format: one JSON object per line)
+            const line = JSON.stringify(record) + '\n';
+            await fs.appendFile(logFile, line, 'utf-8');
+        }
+        catch (error) {
+            console.error('Failed to save usage data:', error);
+        }
+    })
+        .catch(error => {
+        console.error('Usage persistence queue error:', error);
+    });
+}