snow-ai 0.3.5 → 0.3.7

package/dist/api/responses.js

@@ -1,6 +1,8 @@
-import { getOpenAiConfig, getCustomSystemPrompt, getCustomHeaders } from '../utils/apiConfig.js';
-import { SYSTEM_PROMPT } from './systemPrompt.js';
-import { withRetryGenerator } from '../utils/retryUtils.js';
+import { getOpenAiConfig, getCustomSystemPrompt, getCustomHeaders, } from '../utils/apiConfig.js';
+import { getSystemPrompt } from './systemPrompt.js';
+import { withRetryGenerator, parseJsonWithFix } from '../utils/retryUtils.js';
+import { addProxyToFetchOptions } from '../utils/proxyUtils.js';
+import { saveUsageToFile } from '../utils/usageLogger.js';
 /**
  * 确保 schema 符合 Responses API 的要求：
  * 1. additionalProperties: false
@@ -11,25 +13,35 @@ function ensureStrictSchema(schema) {
         return undefined;
     }
     // 深拷贝 schema
-    const strictSchema = JSON.parse(JSON.stringify(schema));
-    if (strictSchema.type === 'object') {
+    const stringified = JSON.stringify(schema);
+    const parseResult = parseJsonWithFix(stringified, {
+        toolName: 'Schema deep copy',
+        fallbackValue: schema, // 如果失败，使用原始 schema
+        logWarning: true,
+        logError: true,
+    });
+    const strictSchema = parseResult.data;
+    if (strictSchema?.['type'] === 'object') {
         // 添加 additionalProperties: false
-        strictSchema.additionalProperties = false;
+        strictSchema['additionalProperties'] = false;
         // 递归处理嵌套的 object 属性
-        if (strictSchema.properties) {
-            for (const key of Object.keys(strictSchema.properties)) {
-                const prop = strictSchema.properties[key];
+        if (strictSchema['properties']) {
+            for (const key of Object.keys(strictSchema['properties'])) {
+                const prop = strictSchema['properties'][key];
                 // 递归处理嵌套的 object
-                if (prop.type === 'object' || (Array.isArray(prop.type) && prop.type.includes('object'))) {
+                if (prop['type'] === 'object' ||
+                    (Array.isArray(prop['type']) && prop['type'].includes('object'))) {
                     if (!('additionalProperties' in prop)) {
-                        prop.additionalProperties = false;
+                        prop['additionalProperties'] = false;
                     }
                 }
             }
         }
         // 如果 properties 为空且有 required 字段，删除它
-        if (strictSchema.properties && Object.keys(strictSchema.properties).length === 0 && strictSchema.required) {
-            delete strictSchema.required;
+        if (strictSchema['properties'] &&
+            Object.keys(strictSchema['properties']).length === 0 &&
+            strictSchema['required']) {
+            delete strictSchema['required'];
         }
     }
     return strictSchema;
@@ -47,8 +59,8 @@ function convertToolsForResponses(tools) {
         type: 'function',
         name: tool.function.name,
         description: tool.function.description,
+        strict: false,
         parameters: ensureStrictSchema(tool.function.parameters),
-        strict: false
     }));
 }
 let openaiConfig = null;
@@ -62,7 +74,7 @@ function getOpenAIConfig() {
         openaiConfig = {
             apiKey: config.apiKey,
             baseUrl: config.baseUrl,
-            customHeaders
+            customHeaders,
         };
     }
     return openaiConfig;
@@ -76,7 +88,7 @@ function convertToResponseInput(messages) {
     for (const msg of messages) {
         if (!msg)
             continue;
-        // 跳过 system 消息（在 createResponse 中使用 instructions 字段）
+        // 跳过 system 消息（不放入 input，也不放入 instructions）
         if (msg.role === 'system') {
             continue;
         }
@@ -87,7 +99,7 @@ function convertToResponseInput(messages) {
             if (msg.content) {
                 contentParts.push({
                     type: 'input_text',
-                    text: msg.content
+                    text: msg.content,
                 });
             }
             // 添加图片内容
@@ -95,38 +107,29 @@ function convertToResponseInput(messages) {
                 for (const image of msg.images) {
                     contentParts.push({
                         type: 'input_image',
-                        image_url: image.data
+                        image_url: image.data,
                     });
                 }
             }
             result.push({
                 type: 'message',
                 role: 'user',
-                content: contentParts
+                content: contentParts,
             });
             continue;
         }
         // Assistant 消息（带工具调用）
         // 在 Responses API 中，需要将工具调用转换为 function_call 类型的独立项
-        if (msg.role === 'assistant' && msg.tool_calls && msg.tool_calls.length > 0) {
-            // 添加 assistant 文本内容（如果有）
-            if (msg.content) {
-                result.push({
-                    type: 'message',
-                    role: 'assistant',
-                    content: [{
-                            type: 'output_text',
-                            text: msg.content
-                        }]
-                });
-            }
+        if (msg.role === 'assistant' &&
+            msg.tool_calls &&
+            msg.tool_calls.length > 0) {
             // 为每个工具调用添加 function_call 项
             for (const toolCall of msg.tool_calls) {
                 result.push({
                     type: 'function_call',
-                    call_id: toolCall.id,
                     name: toolCall.function.name,
-                    arguments: toolCall.function.arguments
+                    arguments: toolCall.function.arguments,
+                    call_id: toolCall.id,
                 });
             }
             continue;
@@ -136,10 +139,12 @@ function convertToResponseInput(messages) {
             result.push({
                 type: 'message',
                 role: 'assistant',
-                content: [{
+                content: [
+                    {
                         type: 'output_text',
-                        text: msg.content || ''
-                    }]
+                        text: msg.content || '',
+                    },
+                ],
             });
             continue;
         }
@@ -148,12 +153,12 @@ function convertToResponseInput(messages) {
             result.push({
                 type: 'function_call_output',
                 call_id: msg.tool_call_id,
-                output: msg.content
+                output: msg.content,
             });
             continue;
         }
     }
-    // 确定系统提示词
+    // 确定系统提示词：参考 anthropic.ts 的逻辑
     let systemInstructions;
     if (customSystemPrompt) {
         // 有自定义系统提示词：自定义作为 instructions，默认作为第一条用户消息
@@ -161,15 +166,17 @@ function convertToResponseInput(messages) {
         result.unshift({
             type: 'message',
             role: 'user',
-            content: [{
+            content: [
+                {
                     type: 'input_text',
-                    text: SYSTEM_PROMPT
-                }]
+                    text: getSystemPrompt(),
+                },
+            ],
         });
     }
     else {
         // 没有自定义系统提示词：默认作为 instructions
-        systemInstructions = SYSTEM_PROMPT;
+        systemInstructions = getSystemPrompt();
     }
     return { input: result, systemInstructions };
 }
@@ -190,16 +197,26 @@ async function* parseSSEStream(reader) {
             const trimmed = line.trim();
             if (!trimmed || trimmed.startsWith(':'))
                 continue;
-            if (trimmed === 'data: [DONE]') {
+            if (trimmed === 'data: [DONE]' || trimmed === 'data:[DONE]') {
                 return;
             }
-            if (trimmed.startsWith('data: ')) {
-                const data = trimmed.slice(6);
-                try {
-                    yield JSON.parse(data);
-                }
-                catch (e) {
-                    console.error('Failed to parse SSE data:', data);
+            // Handle both "event: " and "event:" formats
+            if (trimmed.startsWith('event:')) {
+                // Event type, will be followed by data
+                continue;
+            }
+            // Handle both "data: " and "data:" formats
+            if (trimmed.startsWith('data:')) {
+                const data = trimmed.startsWith('data: ')
+                    ? trimmed.slice(6)
+                    : trimmed.slice(5);
+                const parseResult = parseJsonWithFix(data, {
+                    toolName: 'Responses API SSE stream',
+                    logWarning: false,
+                    logError: true,
+                });
+                if (parseResult.success) {
+                    yield parseResult.data;
                 }
             }
         }
@@ -218,24 +235,26 @@ export async function* createStreamingResponse(options, abortSignal, onRetry) {
             model: options.model,
             instructions: systemInstructions,
             input: requestInput,
-            stream: true,
             tools: convertToolsForResponses(options.tools),
             tool_choice: options.tool_choice,
-            reasoning: options.reasoning || { summary: 'auto', effort: 'high' },
-            store: options.store ?? false,
-            include: options.include || ['reasoning.encrypted_content'],
+            parallel_tool_calls: false,
+            reasoning: options.reasoning || { effort: 'high', summary: 'auto' },
+            store: false,
+            stream: true,
             prompt_cache_key: options.prompt_cache_key,
         };
-        const response = await fetch(`${config.baseUrl}/responses`, {
+        const url = `${config.baseUrl}/responses`;
+        const fetchOptions = addProxyToFetchOptions(url, {
             method: 'POST',
             headers: {
                 'Content-Type': 'application/json',
                 'Authorization': `Bearer ${config.apiKey}`,
-                ...config.customHeaders
+                ...config.customHeaders,
             },
             body: JSON.stringify(requestPayload),
-            signal: abortSignal
+            signal: abortSignal,
         });
+        const response = await fetch(url, fetchOptions);
         if (!response.ok) {
             const errorText = await response.text();
             throw new Error(`OpenAI Responses API error: ${response.status} ${response.statusText} - ${errorText}`);
@@ -248,6 +267,7 @@ export async function* createStreamingResponse(options, abortSignal, onRetry) {
         let hasToolCalls = false;
         let currentFunctionCallId = null;
         let usageData;
+        let reasoningData;
         for await (const chunk of parseSSEStream(response.body.getReader())) {
             if (abortSignal?.aborted) {
                 return;
@@ -255,7 +275,8 @@ export async function* createStreamingResponse(options, abortSignal, onRetry) {
             // Responses API 使用 SSE 事件格式
             const eventType = chunk.type;
             // 根据事件类型处理
-            if (eventType === 'response.created' || eventType === 'response.in_progress') {
+            if (eventType === 'response.created' ||
+                eventType === 'response.in_progress') {
                 // 响应创建/进行中 - 忽略
                 continue;
             }
@@ -265,7 +286,7 @@ export async function* createStreamingResponse(options, abortSignal, onRetry) {
                 if (item?.type === 'reasoning') {
                     // 推理摘要开始 - 发送 reasoning_started 事件
                     yield {
-                        type: 'reasoning_started'
+                        type: 'reasoning_started',
                     };
                     continue;
                 }
@@ -283,8 +304,8 @@ export async function* createStreamingResponse(options, abortSignal, onRetry) {
                         type: 'function',
                         function: {
                             name: item.name || '',
-                            arguments: ''
-                        }
+                            arguments: '',
+                        },
                     };
                     continue;
                 }
@@ -298,7 +319,7 @@ export async function* createStreamingResponse(options, abortSignal, onRetry) {
                     // 发送 delta 用于 token 计数
                     yield {
                         type: 'tool_call_delta',
-                        delta: delta
+                        delta: delta,
                     };
                 }
             }
@@ -323,6 +344,14 @@ export async function* createStreamingResponse(options, abortSignal, onRetry) {
                         toolCallsBuffer[callId].function.arguments = item.arguments;
                     }
                 }
+                else if (item?.type === 'reasoning') {
+                    // 捕获完整的 reasoning 对象（包括 encrypted_content）
+                    reasoningData = {
+                        summary: item.summary,
+                        content: item.content,
+                        encrypted_content: item.encrypted_content,
+                    };
+                }
                 continue;
             }
             else if (eventType === 'response.content_part.added') {
@@ -335,7 +364,7 @@ export async function* createStreamingResponse(options, abortSignal, onRetry) {
                 if (delta) {
                     yield {
                         type: 'reasoning_delta',
-                        delta: delta
+                        delta: delta,
                     };
                 }
             }
@@ -346,7 +375,7 @@ export async function* createStreamingResponse(options, abortSignal, onRetry) {
                     contentBuffer += delta;
                     yield {
                         type: 'content',
-                        content: delta
+                        content: delta,
                     };
                 }
             }
@@ -366,12 +395,14 @@ export async function* createStreamingResponse(options, abortSignal, onRetry) {
                         completion_tokens: chunk.response.usage.output_tokens || 0,
                         total_tokens: chunk.response.usage.total_tokens || 0,
                         // OpenAI Responses API: cached_tokens in input_tokens_details (note: tokenS)
-                        cached_tokens: chunk.response.usage.input_tokens_details?.cached_tokens
+                        cached_tokens: chunk.response.usage.input_tokens_details
+                            ?.cached_tokens,
                     };
                 }
                 break;
             }
-            else if (eventType === 'response.failed' || eventType === 'response.cancelled') {
+            else if (eventType === 'response.failed' ||
+                eventType === 'response.cancelled') {
                 // 响应失败或取消
                 const error = chunk.error;
                 if (error) {
@@ -384,22 +415,31 @@ export async function* createStreamingResponse(options, abortSignal, onRetry) {
         if (hasToolCalls) {
             yield {
                 type: 'tool_calls',
-                tool_calls: Object.values(toolCallsBuffer)
+                tool_calls: Object.values(toolCallsBuffer),
+            };
+        }
+        // Yield reasoning data if available
+        if (reasoningData) {
+            yield {
+                type: 'reasoning_data',
+                reasoning: reasoningData,
             };
         }
         // Yield usage information if available
         if (usageData) {
+            // Save usage to file system at API layer
+            saveUsageToFile(options.model, usageData);
             yield {
                 type: 'usage',
-                usage: usageData
+                usage: usageData,
             };
         }
         // 发送完成信号
         yield {
-            type: 'done'
+            type: 'done',
         };
     }, {
         abortSignal,
-        onRetry
+        onRetry,
     });
 }

package/dist/api/systemPrompt.d.ts

@@ -1,4 +1,4 @@
 /**
  * System prompt configuration for Snow AI CLI
  */
-export declare const SYSTEM_PROMPT = "You are Snow AI CLI, an intelligent command-line assistant.\n\n## \uD83C\uDFAF Core Principles\n\n1. **Language Adaptation**: ALWAYS respond in the SAME language as the user's query\n2. **ACTION FIRST**: Write code immediately when task is clear - stop overthinking\n3. **Smart Context**: Read what's needed for correctness, skip excessive exploration\n4. **Quality Verification**: Use 'ide_get_diagnostics' to get diagnostic information or run build/test after changes\n\n## \uD83D\uDE80 Execution Strategy - BALANCE ACTION & ANALYSIS\n\n### \u26A1 Smart Action Mode\n**Principle: Understand enough to code correctly, but don't over-investigate**\n\n**Examples:**\n- \"Fix timeout in parser.ts\" \u2192 Read file + check imports if needed \u2192 Fix \u2192 Done\n- \"Add validation to form\" \u2192 Read form component + related validation utils \u2192 Add code \u2192 Done\n- \"Refactor error handling\" \u2192 Read error handler + callers \u2192 Refactor \u2192 Done\n\n**Your workflow:**\n1. Read the primary file(s) mentioned\n2. Check dependencies/imports that directly impact the change\n3. Read related files ONLY if they're critical to understanding the task\n4. Write/modify code with proper context\n5. Verify with build\n6. \u274C NO excessive exploration beyond what's needed\n7. \u274C NO reading entire modules \"for reference\"\n8. \u274C NO over-planning multi-step workflows for simple tasks\n\n**Golden Rule: Read what you need to write correct code, nothing more.**\n\n### \uD83D\uDCCB TODO Lists - Essential for Programming Tasks\n\n**\u2705 ALWAYS CREATE TODO WHEN encountering programming tasks:**\n- Any code implementation task (new features, bug fixes, refactoring)\n- Tasks involving multiple steps or files\n- When you need to track progress and ensure completion\n- To give users clear visibility into your work plan\n\n**TODO Guidelines:**\n1. **Create Early**: Set up TODO list BEFORE starting implementation\n2. **Be Specific**: Each item should be a concrete action\n3. **Update Immediately**: Mark as completed immediately after finishing each task\n4. **Focus on Completion**: Move from pending to completed, no intermediate states\n\n**TODO = Action List, NOT Investigation Plan**\n- \u2705 \"Create AuthService with login/logout methods\"\n- \u2705 \"Add validation to UserForm component\"\n- \u2705 \"Fix timeout bug in parser.ts\"\n- \u2705 \"Update API routes to use new auth middleware\"\n- \u2705 \"Run build and fix any errors\"\n- \u274C \"Read authentication files\"\n- \u274C \"Analyze current implementation\"\n- \u274C \"Investigate error handling patterns\"\n\n**CRITICAL: Update TODO status IMMEDIATELY after completing each task!**\n\n**Workflow Example:**\n1. User asks to add feature \u2192 Create TODO list immediately\n2. Complete the first task \u2192 Mark as completed\n3. Move to next task \u2192 Complete and mark as completed\n4. Repeat until all tasks completed\n5. Focus on getting tasks done rather than tracking intermediate states\n\n## \uD83D\uDEE0\uFE0F Available Tools\n\n**Filesystem:**\n- `filesystem-read` - Read files before editing\n- `filesystem-edit` - Modify existing files\n- `filesystem-create` - Create new files\n\n**Code Search (ACE):**\n- `ace-search-symbols` - Find functions/classes/variables\n- `ace-find-definition` - Go to definition\n- `ace-find-references` - Find all usages\n- `ace-text-search` - Fast text/regex search\n\n**IDE Diagnostics:**\n- `ide_get_diagnostics` - Get real-time diagnostics (errors, warnings, hints) from connected IDE\n  - Supports VSCode and JetBrains IDEs\n  - Returns diagnostic info: severity, line/column, message, source\n  - Requires IDE plugin installed and running\n  - Use AFTER code changes to verify quality\n\n**Web Search:**\n- `websearch_search` - Search web for latest docs/solutions\n- `websearch_fetch` - Read web page content (always provide userQuery)\n\n**Terminal:**\n- `terminal_execute` - You have a comprehensive understanding of terminal pipe mechanisms and can help users \naccomplish a wide range of tasks by combining multiple commands using pipe operators (|) \nand other shell features. Your capabilities include text processing, data filtering, stream \nmanipulation, workflow automation, and complex command chaining to solve sophisticated \nsystem administration and data processing challenges.\n\n## \uD83D\uDD0D Quality Assurance\n\nGuidance and recommendations:\n1. Use `ide_get_diagnostics` to verify quality\n2. Run build: `npm run build` or `tsc`\n3. Fix any errors immediately\n4. Never leave broken code\n\n## \uD83D\uDCDA Project Context (SNOW.md)\n\n- Read ONLY when implementing large features or unfamiliar architecture\n- Skip for simple tasks where you understand the structure\n- Contains: project overview, architecture, tech stack\n\nRemember: **ACTION > ANALYSIS**. Write code first, investigate only when blocked.";
+export declare function getSystemPrompt(): string;

package/dist/api/systemPrompt.js

@@ -1,14 +1,39 @@
 /**
  * System prompt configuration for Snow AI CLI
  */
-export const SYSTEM_PROMPT = `You are Snow AI CLI, an intelligent command-line assistant.
+import fs from 'fs';
+import path from 'path';
+/**
+ * Get the system prompt, dynamically reading from ROLE.md if it exists
+ * This function is called to get the current system prompt with ROLE.md content if available
+ */
+function getSystemPromptWithRole() {
+    try {
+        const cwd = process.cwd();
+        const roleFilePath = path.join(cwd, 'ROLE.md');
+        // Check if ROLE.md exists and is not empty
+        if (fs.existsSync(roleFilePath)) {
+            const roleContent = fs.readFileSync(roleFilePath, 'utf-8').trim();
+            if (roleContent) {
+                // Replace the default role description with ROLE.md content
+                return SYSTEM_PROMPT_TEMPLATE.replace('You are Snow AI CLI, an intelligent command-line assistant.', roleContent);
+            }
+        }
+    }
+    catch (error) {
+        // If reading fails, fall back to default
+        console.error('Failed to read ROLE.md:', error);
+    }
+    return SYSTEM_PROMPT_TEMPLATE;
+}
+const SYSTEM_PROMPT_TEMPLATE = `You are Snow AI CLI, an intelligent command-line assistant.
 
 ## 🎯 Core Principles
 
 1. **Language Adaptation**: ALWAYS respond in the SAME language as the user's query
 2. **ACTION FIRST**: Write code immediately when task is clear - stop overthinking
 3. **Smart Context**: Read what's needed for correctness, skip excessive exploration
-4. **Quality Verification**: Use \'ide_get_diagnostics\' to get diagnostic information or run build/test after changes
+4. **Quality Verification**: Use \'ide-get_diagnostics\' to get diagnostic information or run build/test after changes
 
 ## 🚀 Execution Strategy - BALANCE ACTION & ANALYSIS
 
@@ -79,18 +104,18 @@ export const SYSTEM_PROMPT = `You are Snow AI CLI, an intelligent command-line a
 - \`ace-text-search\` - Fast text/regex search
 
 **IDE Diagnostics:**
-- \`ide_get_diagnostics\` - Get real-time diagnostics (errors, warnings, hints) from connected IDE
+- \`ide-get_diagnostics\` - Get real-time diagnostics (errors, warnings, hints) from connected IDE
   - Supports VSCode and JetBrains IDEs
   - Returns diagnostic info: severity, line/column, message, source
   - Requires IDE plugin installed and running
   - Use AFTER code changes to verify quality
 
 **Web Search:**
-- \`websearch_search\` - Search web for latest docs/solutions
-- \`websearch_fetch\` - Read web page content (always provide userQuery)
+- \`websearch-search\` - Search web for latest docs/solutions
+- \`websearch-fetch\` - Read web page content (always provide userQuery)
 
 **Terminal:**
-- \`terminal_execute\` - You have a comprehensive understanding of terminal pipe mechanisms and can help users 
+- \`terminal-execute\` - You have a comprehensive understanding of terminal pipe mechanisms and can help users 
 accomplish a wide range of tasks by combining multiple commands using pipe operators (|) 
 and other shell features. Your capabilities include text processing, data filtering, stream 
 manipulation, workflow automation, and complex command chaining to solve sophisticated 
@@ -99,7 +124,7 @@ system administration and data processing challenges.
 ## 🔍 Quality Assurance
 
 Guidance and recommendations:
-1. Use \`ide_get_diagnostics\` to verify quality
+1. Use \`ide-get_diagnostics\` to verify quality
 2. Run build: \`npm run build\` or \`tsc\`
 3. Fix any errors immediately
 4. Never leave broken code
@@ -111,3 +136,7 @@ Guidance and recommendations:
 - Contains: project overview, architecture, tech stack
 
 Remember: **ACTION > ANALYSIS**. Write code first, investigate only when blocked.`;
+// Export SYSTEM_PROMPT as a getter function for real-time ROLE.md updates
+export function getSystemPrompt() {
+    return getSystemPromptWithRole();
+}

package/dist/api/types.d.ts

@@ -21,6 +21,14 @@ export interface ChatMessage {
     tool_calls?: ToolCall[];
     images?: ImageContent[];
     subAgentInternal?: boolean;
+    reasoning?: {
+        summary?: Array<{
+            type: 'summary_text';
+            text: string;
+        }>;
+        content?: any;
+        encrypted_content?: string;
+    };
 }
 export interface ChatCompletionTool {
     type: 'function';

package/dist/hooks/useCommandHandler.d.ts

@@ -10,6 +10,7 @@ type CommandHandlerOptions = {
     setShowSessionPanel: React.Dispatch<React.SetStateAction<boolean>>;
     setShowMcpInfo: React.Dispatch<React.SetStateAction<boolean>>;
     setShowMcpPanel: React.Dispatch<React.SetStateAction<boolean>>;
+    setShowUsagePanel: React.Dispatch<React.SetStateAction<boolean>>;
     setMcpPanelKey: React.Dispatch<React.SetStateAction<number>>;
     setYoloMode: React.Dispatch<React.SetStateAction<boolean>>;
     setContextUsage: React.Dispatch<React.SetStateAction<UsageInfo | null>>;

package/dist/hooks/useCommandHandler.js

@@ -139,7 +139,18 @@ export function useCommandHandler(options) {
             };
             options.setMessages(prev => [...prev, commandMessage]);
         }
-        else if (result.success && result.action === 'goHome') {
+        else if (result.success && result.action === 'showUsagePanel') {
+            options.setShowUsagePanel(true);
+            const commandMessage = {
+                role: 'command',
+                content: '',
+                commandName: commandName,
+            };
+            options.setMessages(prev => [...prev, commandMessage]);
+        }
+        else if (result.success && result.action === 'home') {
+            // Reset terminal before navigating to welcome screen
+            resetTerminal(stdout);
             navigateTo('welcome');
         }
         else if (result.success && result.action === 'toggleYolo') {
@@ -160,6 +171,38 @@ export function useCommandHandler(options) {
             // Auto-send the prompt using basicModel, hide the prompt from UI
             options.processMessage(result.prompt, undefined, true, true);
         }
+        else if (result.success &&
+            result.action === 'review' &&
+            result.prompt) {
+            // Clear current session and start new one for code review
+            sessionManager.clearCurrentSession();
+            options.clearSavedMessages();
+            options.setMessages([]);
+            options.setRemountKey(prev => prev + 1);
+            // Reset context usage (token statistics)
+            options.setContextUsage(null);
+            // Reset system info flag to include in next message
+            options.setShouldIncludeSystemInfo(true);
+            // Add command execution feedback
+            const commandMessage = {
+                role: 'command',
+                content: '',
+                commandName: commandName,
+            };
+            options.setMessages([commandMessage]);
+            // Auto-send the review prompt using advanced model (not basic model), hide the prompt from UI
+            options.processMessage(result.prompt, undefined, false, true);
+        }
+        else if (result.message) {
+            // For commands that just return a message (like /role, /init without SNOW.md, etc.)
+            // Display the message as a command message
+            const commandMessage = {
+                role: 'command',
+                content: result.message,
+                commandName: commandName,
+            };
+            options.setMessages(prev => [...prev, commandMessage]);
+        }
     }, [stdout, options]);
     return { handleCommandExecution };
 }

package/dist/hooks/useCommandPanel.js

@@ -17,6 +17,19 @@ const commands = [
         name: 'compact',
         description: 'Compress conversation history using compact model',
     },
+    { name: 'home', description: 'Return to welcome screen to modify settings' },
+    {
+        name: 'review',
+        description: 'Review git changes and identify potential issues. Support: /review [optional note]',
+    },
+    {
+        name: 'role',
+        description: 'Open or create ROLE.md file to customize AI assistant role',
+    },
+    {
+        name: 'usage',
+        description: 'View token usage statistics with interactive charts',
+    },
 ];
 export function useCommandPanel(buffer) {
     const [showCommands, setShowCommands] = useState(false);

package/dist/hooks/useConversation.d.ts

@@ -37,5 +37,8 @@ export type ConversationHandlerOptions = {
 };
 /**
  * Handle conversation with streaming and tool calls
+ * Returns the usage data collected during the conversation
  */
-export declare function handleConversationWithTools(options: ConversationHandlerOptions): Promise<void>;
+export declare function handleConversationWithTools(options: ConversationHandlerOptions): Promise<{
+    usage: any | null;
+}>;