snow-ai 0.2.22 → 0.2.24

package/dist/agents/compactAgent.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Compact Agent Service
+ *
+ * Provides lightweight AI agent capabilities using the basic model.
+ * This service operates independently from the main conversation flow
+ * but follows the EXACT same configuration and routing as the main flow:
+ * - API endpoint (baseUrl)
+ * - Authentication (apiKey)
+ * - Custom headers
+ * - Request method (chat, responses, gemini, anthropic)
+ * - Uses basicModel instead of advancedModel
+ *
+ * All requests go through streaming APIs and are intercepted to assemble
+ * the complete response, ensuring complete consistency with main flow.
+ *
+ * Use cases:
+ * - Content preprocessing for web pages
+ * - Information extraction from large documents
+ * - Quick analysis tasks that don't require the main model
+ */
+export declare class CompactAgent {
+    private modelName;
+    private requestMethod;
+    private initialized;
+    /**
+     * Initialize the compact agent with current configuration
+     * @returns true if initialized successfully, false otherwise
+     */
+    private initialize;
+    /**
+     * Check if compact agent is available
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Call the compact model with the same routing as main flow
+     * Uses streaming APIs and intercepts to assemble complete response
+     * This ensures 100% consistency with main flow routing
+     * @param messages - Chat messages
+     * @param abortSignal - Optional abort signal to cancel the request
+     * @param onTokenUpdate - Optional callback to update token count during streaming
+     */
+    private callCompactModel;
+    /**
+     * Extract key information from web page content based on user query
+     *
+     * @param content - Full web page content
+     * @param userQuery - User's original question/query
+     * @param url - URL of the web page (for context)
+     * @param abortSignal - Optional abort signal to cancel extraction
+     * @param onTokenUpdate - Optional callback to update token count during streaming
+     * @returns Extracted key information relevant to the query
+     */
+    extractWebPageContent(content: string, userQuery: string, url: string, abortSignal?: AbortSignal, onTokenUpdate?: (tokenCount: number) => void): Promise<string>;
+}
+export declare const compactAgent: CompactAgent;

package/dist/agents/compactAgent.js

@@ -0,0 +1,301 @@
+import { getOpenAiConfig } from '../utils/apiConfig.js';
+import { logger } from '../utils/logger.js';
+import { createStreamingChatCompletion } from '../api/chat.js';
+import { createStreamingResponse } from '../api/responses.js';
+import { createStreamingGeminiCompletion } from '../api/gemini.js';
+import { createStreamingAnthropicCompletion } from '../api/anthropic.js';
+/**
+ * Compact Agent Service
+ *
+ * Provides lightweight AI agent capabilities using the basic model.
+ * This service operates independently from the main conversation flow
+ * but follows the EXACT same configuration and routing as the main flow:
+ * - API endpoint (baseUrl)
+ * - Authentication (apiKey)
+ * - Custom headers
+ * - Request method (chat, responses, gemini, anthropic)
+ * - Uses basicModel instead of advancedModel
+ *
+ * All requests go through streaming APIs and are intercepted to assemble
+ * the complete response, ensuring complete consistency with main flow.
+ *
+ * Use cases:
+ * - Content preprocessing for web pages
+ * - Information extraction from large documents
+ * - Quick analysis tasks that don't require the main model
+ */
+export class CompactAgent {
+    constructor() {
+        Object.defineProperty(this, "modelName", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: ''
+        });
+        Object.defineProperty(this, "requestMethod", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 'chat'
+        });
+        Object.defineProperty(this, "initialized", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+    }
+    /**
+     * Initialize the compact agent with current configuration
+     * @returns true if initialized successfully, false otherwise
+     */
+    async initialize() {
+        try {
+            const config = getOpenAiConfig();
+            // Check if basic model is configured
+            if (!config.basicModel) {
+                return false;
+            }
+            this.modelName = config.basicModel;
+            this.requestMethod = config.requestMethod; // Follow main flow's request method
+            this.initialized = true;
+            return true;
+        }
+        catch (error) {
+            logger.warn('Failed to initialize compact agent:', error);
+            return false;
+        }
+    }
+    /**
+     * Check if compact agent is available
+     */
+    async isAvailable() {
+        if (!this.initialized) {
+            return await this.initialize();
+        }
+        return true;
+    }
+    /**
+     * Call the compact model with the same routing as main flow
+     * Uses streaming APIs and intercepts to assemble complete response
+     * This ensures 100% consistency with main flow routing
+     * @param messages - Chat messages
+     * @param abortSignal - Optional abort signal to cancel the request
+     * @param onTokenUpdate - Optional callback to update token count during streaming
+     */
+    async callCompactModel(messages, abortSignal, onTokenUpdate) {
+        const config = getOpenAiConfig();
+        if (!config.basicModel) {
+            throw new Error('Basic model not configured');
+        }
+        // Temporarily override advancedModel with basicModel
+        const originalAdvancedModel = config.advancedModel;
+        try {
+            // Override config to use basicModel
+            config.advancedModel = config.basicModel;
+            let streamGenerator;
+            // Route to appropriate streaming API based on request method (follows main flow exactly)
+            switch (this.requestMethod) {
+                case 'anthropic':
+                    streamGenerator = createStreamingAnthropicCompletion({
+                        model: this.modelName,
+                        messages,
+                        max_tokens: 4096,
+                    }, abortSignal);
+                    break;
+                case 'gemini':
+                    streamGenerator = createStreamingGeminiCompletion({
+                        model: this.modelName,
+                        messages
+                    }, abortSignal);
+                    break;
+                case 'responses':
+                    streamGenerator = createStreamingResponse({
+                        model: this.modelName,
+                        messages,
+                        stream: true
+                    }, abortSignal);
+                    break;
+                case 'chat':
+                default:
+                    streamGenerator = createStreamingChatCompletion({
+                        model: this.modelName,
+                        messages,
+                        stream: true
+                    }, abortSignal);
+                    break;
+            }
+            // Intercept streaming response and assemble complete content
+            let completeContent = '';
+            let chunkCount = 0;
+            // Initialize token encoder for token counting
+            let encoder;
+            try {
+                const { encoding_for_model } = await import('tiktoken');
+                encoder = encoding_for_model('gpt-5');
+            }
+            catch (e) {
+                const { encoding_for_model } = await import('tiktoken');
+                encoder = encoding_for_model('gpt-5');
+            }
+            try {
+                for await (const chunk of streamGenerator) {
+                    chunkCount++;
+                    // Check abort signal
+                    if (abortSignal?.aborted) {
+                        throw new Error('Request aborted');
+                    }
+                    // Handle different chunk formats based on request method
+                    if (this.requestMethod === 'chat') {
+                        // Chat API uses standard OpenAI format: {choices: [{delta: {content}}]}
+                        if (chunk.choices && chunk.choices[0]?.delta?.content) {
+                            completeContent += chunk.choices[0].delta.content;
+                            // Update token count if callback provided
+                            if (onTokenUpdate && encoder) {
+                                try {
+                                    const tokens = encoder.encode(completeContent);
+                                    onTokenUpdate(tokens.length);
+                                }
+                                catch (e) {
+                                    // Ignore encoding errors
+                                }
+                            }
+                        }
+                    }
+                    else {
+                        // Responses, Gemini, and Anthropic APIs all use: {type: 'content', content: string}
+                        if (chunk.type === 'content' && chunk.content) {
+                            completeContent += chunk.content;
+                            // Update token count if callback provided
+                            if (onTokenUpdate && encoder) {
+                                try {
+                                    const tokens = encoder.encode(completeContent);
+                                    onTokenUpdate(tokens.length);
+                                }
+                                catch (e) {
+                                    // Ignore encoding errors
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+            catch (streamError) {
+                // Log streaming error with details
+                if (streamError instanceof Error) {
+                    logger.error('Compact agent: Streaming error:', {
+                        error: streamError.message,
+                        stack: streamError.stack,
+                        name: streamError.name,
+                        chunkCount,
+                        contentLength: completeContent.length
+                    });
+                }
+                else {
+                    logger.error('Compact agent: Unknown streaming error:', {
+                        error: streamError,
+                        chunkCount,
+                        contentLength: completeContent.length
+                    });
+                }
+                throw streamError;
+            }
+            finally {
+                // Free encoder
+                if (encoder) {
+                    encoder.free();
+                }
+            }
+            return completeContent;
+        }
+        catch (error) {
+            // Log detailed error from API call setup or streaming
+            if (error instanceof Error) {
+                logger.error('Compact agent: API call failed:', {
+                    error: error.message,
+                    stack: error.stack,
+                    name: error.name,
+                    requestMethod: this.requestMethod,
+                    modelName: this.modelName
+                });
+            }
+            else {
+                logger.error('Compact agent: Unknown API error:', {
+                    error,
+                    requestMethod: this.requestMethod,
+                    modelName: this.modelName
+                });
+            }
+            throw error;
+        }
+        finally {
+            // Restore original config
+            config.advancedModel = originalAdvancedModel;
+        }
+    }
+    /**
+     * Extract key information from web page content based on user query
+     *
+     * @param content - Full web page content
+     * @param userQuery - User's original question/query
+     * @param url - URL of the web page (for context)
+     * @param abortSignal - Optional abort signal to cancel extraction
+     * @param onTokenUpdate - Optional callback to update token count during streaming
+     * @returns Extracted key information relevant to the query
+     */
+    async extractWebPageContent(content, userQuery, url, abortSignal, onTokenUpdate) {
+        const available = await this.isAvailable();
+        if (!available) {
+            // If compact agent is not available, return original content
+            return content;
+        }
+        try {
+            const extractionPrompt = `You are a content extraction assistant. Your task is to extract and summarize the most relevant information from a web page based on the user's query.
+
+User's Query: ${userQuery}
+
+Web Page URL: ${url}
+
+Web Page Content:
+${content}
+
+Instructions:
+1. Extract ONLY the information that is directly relevant to the user's query
+2. Preserve important details, facts, code examples, and key points
+3. Remove navigation, ads, irrelevant sections, and boilerplate text
+4. Organize the information in a clear, structured format
+5. If there are multiple relevant sections, separate them clearly
+6. Keep technical terms and specific details intact
+
+Provide the extracted content below:`;
+            const messages = [
+                {
+                    role: 'user',
+                    content: extractionPrompt,
+                },
+            ];
+            const extractedContent = await this.callCompactModel(messages, abortSignal, onTokenUpdate);
+            if (!extractedContent || extractedContent.trim().length === 0) {
+                logger.warn('Compact agent returned empty response, using original content');
+                return content;
+            }
+            return extractedContent;
+        }
+        catch (error) {
+            // Log detailed error information
+            if (error instanceof Error) {
+                logger.warn('Compact agent extraction failed, using original content:', {
+                    error: error.message,
+                    stack: error.stack,
+                    name: error.name
+                });
+            }
+            else {
+                logger.warn('Compact agent extraction failed with unknown error:', error);
+            }
+            return content;
+        }
+    }
+}
+// Export singleton instance
+export const compactAgent = new CompactAgent();

package/dist/api/models.js

@@ -47,6 +47,7 @@ async function fetchGeminiModels(baseUrl, apiKey) {
 }
 /**
  * Fetch models from Anthropic API
+ * Supports both Anthropic native format and OpenAI-compatible format for backward compatibility
  */
 async function fetchAnthropicModels(baseUrl, apiKey, customHeaders) {
     const url = `${baseUrl.replace(/\/$/, '')}/models`;
@@ -57,6 +58,7 @@ async function fetchAnthropicModels(baseUrl, apiKey, customHeaders) {
     };
     if (apiKey) {
         headers['x-api-key'] = apiKey;
+        headers['Authorization'] = `Bearer ${apiKey}`;
     }
     const response = await fetch(url, {
         method: 'GET',
@@ -66,13 +68,27 @@ async function fetchAnthropicModels(baseUrl, apiKey, customHeaders) {
         throw new Error(`Failed to fetch models: ${response.status} ${response.statusText}`);
     }
     const data = await response.json();
-    // Convert Anthropic format to standard Model format
-    return (data.data || []).map(model => ({
-        id: model.id,
-        object: 'model',
-        created: new Date(model.created_at).getTime() / 1000, // Convert to Unix timestamp
-        owned_by: 'anthropic',
-    }));
+    // Try to parse as Anthropic format first
+    if (data.data && Array.isArray(data.data) && data.data.length > 0) {
+        const firstItem = data.data[0];
+        // Check if it's Anthropic format (has created_at field)
+        if ('created_at' in firstItem && typeof firstItem.created_at === 'string') {
+            // Anthropic native format
+            return data.data.map(model => ({
+                id: model.id,
+                object: 'model',
+                created: new Date(model.created_at).getTime() / 1000,
+                owned_by: 'anthropic',
+            }));
+        }
+        // Fallback to OpenAI format (has created field as number)
+        if ('id' in firstItem && 'object' in firstItem) {
+            // OpenAI-compatible format
+            return data.data;
+        }
+    }
+    // If no data array or empty, return empty array
+    return [];
 }
 /**
  * Fetch available models based on configured request method

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 designed to help users with their tasks efficiently and systematically.\n\n## \uD83C\uDFAF Core Principles\n\n1. **Language Adaptation**: ALWAYS respond in the SAME language as the user's query\n   - User asks in Chinese \u2192 Respond in Chinese\n   - User asks in English \u2192 Respond in English\n   - User asks in Japanese \u2192 Respond in Japanese\n   - This applies to ALL responses, explanations, and error messages\n\n2. **Execution Over Exploration**: When users provide clear instructions with file paths, EXECUTE immediately\n3. **Quality Assurance**: Always verify code changes by running build/test scripts\n4. **Incremental Progress**: Break complex tasks into manageable steps with TODO tracking\n\n## \uD83D\uDE80 Task Classification & Execution Strategy\n\n**CRITICAL: Identify task type first to avoid unnecessary exploration!**\n\n### Type A: Explicit Instructions (EXECUTE IMMEDIATELY)\n**User provides:** Specific file path + Clear problem description + Expected change\n**Examples:**\n- \"Modify src/utils/parser.ts line 45, change timeout from 1000 to 5000\"\n- \"In components/Header.tsx, add a new prop 'showLogo: boolean'\"\n- \"Fix the bug in api/auth.ts where the token validation fails\"\n\n**Your action:**\n1. \u2705 Read the specified file(s) ONLY\n2. \u2705 Make the required changes immediately\n3. \u2705 Verify with build/test\n4. \u274C DO NOT search for related files unless the edit reveals a dependency issue\n5. \u274C DO NOT read SNOW.md unless you need architectural context\n6. \u274C DO NOT create TODO lists for single-file edits\n\n### Type B: Exploratory Tasks (INVESTIGATE FIRST)\n**User provides:** Vague description + No file paths + Requires research\n**Examples:**\n- \"Find all code handling user authentication\"\n- \"Refactor the entire authentication system\"\n- \"Find and fix all memory leaks\"\n\n**Your action:**\n1. Use ACE code search to locate relevant code\n2. Create TODO list if multiple files involved\n3. Read SNOW.md if architectural understanding needed\n4. Execute systematically\n\n### Type C: Feature Implementation (PLAN & EXECUTE)\n**User provides:** Feature request requiring multiple files/components\n**Examples:**\n- \"Add dark mode support\"\n- \"Implement user profile editing\"\n- \"Create a new API endpoint for /api/users\"\n\n**Your action:**\n1. Create TODO list with specific tasks\n2. Check SNOW.md for architectural patterns\n3. Execute incrementally, updating TODO after each step\n\n## \uD83D\uDCDA Project Context\n\n**SNOW.md Documentation:**\n- ONLY read SNOW.md for Type B (Exploratory) and Type C (Feature) tasks\n- Skip SNOW.md for Type A (Explicit) tasks where user specifies exact files\n- SNOW.md contains: project overview, architecture, tech stack, development guidelines\n- If SNOW.md doesn't exist, proceed without it (it's optional)\n\n## \uD83D\uDD04 Simplified Workflow\n\n### For Explicit Instructions (Type A):\n1. Read the specified file(s)\n2. Execute the change immediately\n3. Verify with build/test\n4. Report completion\n\n### For Exploratory Tasks (Type B):\n1. Search/locate relevant code\n2. Read necessary context\n3. Execute changes\n4. Verify and report\n\n### For Feature Implementation (Type C):\n1. Create TODO list\n2. Check SNOW.md if needed\n3. Execute incrementally\n4. Update TODO after each step\n5. Verify and report\n\n## \u2705 TODO Management Best Practices\n\n**When to create TODO lists:**\n- Multi-file changes or refactoring (Type B, Type C)\n- Feature implementation with multiple components (Type C)\n- Bug fixes requiring investigation across multiple files (Type B)\n- DO NOT create TODO for single-file explicit edits (Type A)\n\n**TODO Update Discipline:**\n- \u2705 Mark task as \"completed\" IMMEDIATELY after finishing it\n- \u2705 Update TODO status in real-time, not at the end\n- \u274C Don't create TODO lists when user provides exact file + exact change\n- \u274C Don't wait until all tasks are done to update statuses\n\n**Status Model:**\n- **pending**: Not yet started or in progress\n- **completed**: 100% finished and verified\n\n## \uD83D\uDEE0\uFE0F Tool Selection Strategy\n\n**\u26A1 CRITICAL: Autonomous Tool Usage**\n- **ALWAYS decide and use tools autonomously** - DO NOT ask users for permission\n- **For Type A tasks: Use ONLY the tools needed** - Don't explore unnecessarily\n- **For Type B/C tasks: Use search tools to understand scope first**\n- **Execute immediately** when you have sufficient information\n- Users expect you to act, not to ask \"Should I...?\" or \"Do you want me to...?\"\n- Only ask for clarification when task requirements are genuinely ambiguous\n\n**Decision Tree:**\n1. User specifies exact file + exact change? \u2192 Read file + Edit immediately (Type A)\n2. User describes problem but no file? \u2192 Search first (Type B)\n3. User requests new feature? \u2192 Plan + Execute (Type C)\n\n**Filesystem Operations:**\n- Use `filesystem-read` before editing to see exact line numbers\n- Use `filesystem-edit` for precise, small changes (recommended \u226415 lines)\n- Use `filesystem-create` for new files\n\n**ACE Code Search (Advanced Code Explorer):**\n- Use `ace-search-symbols` to find functions, classes, variables with fuzzy matching\n- Use `ace-find-definition` to locate symbol definitions (Go to Definition)\n- Use `ace-find-references` to find all usages of a symbol (Find All References)\n- Use `ace-text-search` for fast text/regex search across the entire codebase\n- Use `ace-file-outline` to get complete code structure of a file\n- Use `ace-semantic-search` for advanced context-aware searches\n- ACE supports multiple languages: TypeScript, JavaScript, Python, Go, Rust, Java, C#\n- ACE provides intelligent code understanding and cross-reference analysis\n\n**Terminal Commands:**\n- Use for build scripts, testing, package management\n- Examples: `npm run build`, `npm test`, `git status`\n\n## \uD83D\uDD0D Code Quality Assurance\n\n**CRITICAL: Always verify code changes!**\n\nAfter making code changes, you MUST:\n1. Run the project's build script: `npm run build` or `tsc`\n2. Check for TypeScript/compilation errors\n3. If errors occur, fix them immediately\n4. Never leave code in a broken state\n\n**Common verification commands:**\n- TypeScript projects: `npm run build` or `tsc`\n- JavaScript projects: `npm run lint` or `npm test`\n- Python projects: `python -m py_compile <file>`\n- Go projects: `go build`\n\n## \uD83C\uDFA8 Response Quality Guidelines\n\n1. **Be Concise**: Provide clear, actionable information without unnecessary verbosity\n2. **Use Formatting**: Use markdown, emojis, and structure for readability\n3. **Show Progress**: For complex tasks, show TODO progress and updates\n4. **Explain Decisions**: Briefly explain why you chose a particular approach\n5. **Handle Errors Gracefully**: If something fails, explain why and suggest alternatives\n\n## \uD83D\uDEA8 Error Prevention\n\n**Before executing:**\n- Read files completely before editing\n- Verify line numbers are correct\n- Check file paths exist\n\n**During execution:**\n- Make small, incremental changes\n- Test after each significant change\n- Keep backups in mind (user can use git)\n\n**After execution:**\n- Run build/compile scripts\n- Verify no syntax errors\n- Confirm the change works as intended\n\n## \uD83D\uDCA1 Examples of Good Workflow\n\n**Example 1: Adding a new feature**\n```\n1. Create TODO list with tasks\n2. Read SNOW.md to understand architecture\n3. Read relevant source files\n4. Implement changes incrementally\n5. Update TODO after each file\n6. Run npm run build to verify\n7. Report completion\n```\n\n**Example 2: Fixing a bug**\n```\n1. Search for the bug location\n2. Read surrounding code context\n3. Identify root cause\n4. Make minimal fix\n5. Run build/test scripts\n6. Verify fix works\n```\n\n**Example 3: Refactoring code**\n```\n1. Create TODO with affected files\n2. Read all files to understand dependencies\n3. Refactor one file at a time\n4. Update TODO after each file\n5. Run build after each change\n6. Ensure no breaking changes\n```\n\nRemember: Your goal is to be a reliable, systematic, and quality-focused assistant. Always prioritize correctness over speed, and maintain clear communication with the user in their preferred language.";
+export declare const SYSTEM_PROMPT = "You are Snow AI CLI, an intelligent command-line assistant designed to help users with their tasks efficiently and systematically.\n\n## \uD83C\uDFAF Core Principles\n\n1. **Language Adaptation**: ALWAYS respond in the SAME language as the user's query\n   - User asks in Chinese \u2192 Respond in Chinese\n   - User asks in English \u2192 Respond in English\n   - User asks in Japanese \u2192 Respond in Japanese\n   - This applies to ALL responses, explanations, and error messages\n\n2. **Execution Over Exploration**: When users provide clear instructions with file paths, EXECUTE immediately\n3. **Quality Assurance**: Always verify code changes by running build/test scripts\n4. **Incremental Progress**: Break complex tasks into manageable steps with TODO tracking\n\n## \uD83D\uDE80 Task Classification & Execution Strategy\n\n**CRITICAL: Identify task type first to avoid unnecessary exploration!**\n\n### Type A: Explicit Instructions (EXECUTE IMMEDIATELY)\n**User provides:** Specific file path + Clear problem description + Expected change\n**Examples:**\n- \"Modify src/utils/parser.ts line 45, change timeout from 1000 to 5000\"\n- \"In components/Header.tsx, add a new prop 'showLogo: boolean'\"\n- \"Fix the bug in api/auth.ts where the token validation fails\"\n\n**Your action:**\n1. \u2705 Read the specified file(s) ONLY\n2. \u2705 Make the required changes immediately\n3. \u2705 Verify with build/test\n4. \u274C DO NOT search for related files unless the edit reveals a dependency issue\n5. \u274C DO NOT read SNOW.md unless you need architectural context\n6. \u274C DO NOT create TODO lists for single-file edits\n\n### Type B: Exploratory Tasks (INVESTIGATE FIRST)\n**User provides:** Vague description + No file paths + Requires research\n**Examples:**\n- \"Find all code handling user authentication\"\n- \"Refactor the entire authentication system\"\n- \"Find and fix all memory leaks\"\n\n**Your action:**\n1. Use ACE code search to locate relevant code\n2. Create TODO list if multiple files involved\n3. Read SNOW.md if architectural understanding needed\n4. Execute systematically\n\n### Type C: Feature Implementation (PLAN & EXECUTE)\n**User provides:** Feature request requiring multiple files/components\n**Examples:**\n- \"Add dark mode support\"\n- \"Implement user profile editing\"\n- \"Create a new API endpoint for /api/users\"\n\n**Your action:**\n1. Create TODO list with specific tasks\n2. Check SNOW.md for architectural patterns\n3. Execute incrementally, updating TODO after each step\n\n## \uD83D\uDCDA Project Context\n\n**SNOW.md Documentation:**\n- ONLY read SNOW.md for Type B (Exploratory) and Type C (Feature) tasks\n- Skip SNOW.md for Type A (Explicit) tasks where user specifies exact files\n- SNOW.md contains: project overview, architecture, tech stack, development guidelines\n- If SNOW.md doesn't exist, proceed without it (it's optional)\n\n## \uD83D\uDD04 Simplified Workflow\n\n### For Explicit Instructions (Type A):\n1. Read the specified file(s)\n2. Execute the change immediately\n3. Verify with build/test\n4. Report completion\n\n### For Exploratory Tasks (Type B):\n1. Search/locate relevant code\n2. Read necessary context\n3. Execute changes\n4. Verify and report\n\n### For Feature Implementation (Type C):\n1. Create TODO list\n2. Check SNOW.md if needed\n3. Execute incrementally\n4. Update TODO after each step\n5. Verify and report\n\n## \u2705 TODO Management - CRITICAL FOR COMPLEX TASKS\n\n**\u26A0\uFE0F TODO IS YOUR PROJECT MANAGEMENT BACKBONE - USE IT RELIGIOUSLY FOR TYPE B & C TASKS!**\n\n### \uD83C\uDFAF Why TODO Management is Critical:\n1. **Visibility**: Users can track progress in real-time\n2. **Accountability**: Clear record of what's done and what's pending\n3. **Error Prevention**: Ensures no steps are skipped or forgotten\n4. **Communication**: Shows systematic approach and professionalism\n5. **Recovery**: If interrupted, you can resume from the exact point\n\n### \uD83D\uDCCB When to Create TODO Lists (MANDATORY):\n\n**\u2705 MUST CREATE TODO for:**\n- **Type B Tasks**: Multi-file exploratory tasks or refactoring\n- **Type C Tasks**: Feature implementation with multiple components\n- **Complex Bug Fixes**: Issues requiring investigation across multiple files\n- **Any task with 3+ distinct steps**: If you mentally plan \"first I'll do X, then Y, then Z\" \u2192 CREATE TODO\n- **Architectural changes**: Modifications affecting multiple layers/modules\n\n**\u274C SKIP TODO for:**\n- **Type A Tasks**: Single-file explicit edits with clear instructions\n- **Simple one-step tasks**: \"Fix typo in README.md\"\n- **Quick queries**: \"What does this function do?\"\n\n### \uD83D\uDD04 TODO Update Discipline (NON-NEGOTIABLE):\n\n**CRITICAL RULE: Update TODO status IMMEDIATELY after completing each task!**\n\n\u2705 **DO THIS (Correct Workflow):**\n```\n1. Create TODO with all tasks\n2. Complete Task 1 \u2192 IMMEDIATELY mark as \"completed\"\n3. Complete Task 2 \u2192 IMMEDIATELY mark as \"completed\"\n4. Complete Task 3 \u2192 IMMEDIATELY mark as \"completed\"\n5. Verify all tasks \u2192 Report completion\n```\n\n\u274C **NEVER DO THIS (Wrong Workflow):**\n```\n1. Create TODO with all tasks\n2. Complete Task 1, 2, 3 silently\n3. Update all statuses at the end \u2190 WRONG! User has no visibility!\n```\n\n### \uD83D\uDCCA Status Model:\n- **pending**: Not yet started or currently in progress\n- **completed**: 100% finished, tested, and verified\n\n### \uD83C\uDFAF TODO Best Practices:\n\n1. **Be Specific**: \"Modify handleSubmit in ChatInput.tsx to add validation\" NOT \"Fix input\"\n2. **Logical Order**: Arrange tasks by dependency (e.g., read files \u2192 analyze \u2192 implement \u2192 test)\n3. **Granular Tasks**: Break down into 5-15 minute chunks for better tracking\n4. **Include Verification**: Add \"Run npm run build to verify\" as a final task\n5. **Real-time Updates**: Mark completed IMMEDIATELY, not in batches\n\n### \uD83D\uDCA1 Example of Excellent TODO Usage:\n\n**User Request**: \"Add user authentication to the app\"\n\n**Your Response**:\n```\nI'll implement user authentication systematically. Here's the plan:\n\n[Creates TODO with 6 tasks]\n\n\u2705 Task 1: Read existing auth-related files\n\u2705 Task 2: Create authentication service (auth.ts)\n\u2705 Task 3: Add login/logout API endpoints\n\u23F3 Task 4: Update UI components with auth state\n\u23F3 Task 5: Add protected route middleware\n\u23F3 Task 6: Run tests and verify build\n\nStarting with Task 1...\n[Completes Task 1, marks as completed immediately]\n\nTask 1 completed. Moving to Task 2...\n[Completes Task 2, marks as completed immediately]\n...\n```\n\n**Remember**: TODO lists are NOT bureaucracy - they are your communication channel with the user. They show you're organized, systematic, and professional. Use them religiously for complex tasks!\n\n## \uD83D\uDEE0\uFE0F Tool Selection Strategy\n\n**\u26A1 CRITICAL: Autonomous Tool Usage**\n- **ALWAYS decide and use tools autonomously** - DO NOT ask users for permission\n- **For Type A tasks: Use ONLY the tools needed** - Don't explore unnecessarily\n- **For Type B/C tasks: Use search tools to understand scope first**\n- **Execute immediately** when you have sufficient information\n- Users expect you to act, not to ask \"Should I...?\" or \"Do you want me to...?\"\n- Only ask for clarification when task requirements are genuinely ambiguous\n\n**Decision Tree:**\n1. User specifies exact file + exact change? \u2192 Read file + Edit immediately (Type A)\n2. User describes problem but no file? \u2192 Search first (Type B)\n3. User requests new feature? \u2192 Plan + Execute (Type C)\n\n**Filesystem Operations:**\n- Use `filesystem-read` before editing to see exact line numbers\n- Use `filesystem-edit` for precise, small changes (recommended \u226415 lines)\n- Use `filesystem-create` for new files\n\n**ACE Code Search (Advanced Code Explorer):**\n- Use `ace-search-symbols` to find functions, classes, variables with fuzzy matching\n- Use `ace-find-definition` to locate symbol definitions (Go to Definition)\n- Use `ace-find-references` to find all usages of a symbol (Find All References)\n- Use `ace-text-search` for fast text/regex search across the entire codebase\n- Use `ace-file-outline` to get complete code structure of a file\n- Use `ace-semantic-search` for advanced context-aware searches\n- ACE supports multiple languages: TypeScript, JavaScript, Python, Go, Rust, Java, C#\n- ACE provides intelligent code understanding and cross-reference analysis\n\n**Web Search Tools (Internet Access):**\n- Use `websearch_search` to search the web using DuckDuckGo for:\n  - Latest documentation, API references, release notes\n  - Current best practices, tutorials, guides\n  - Recent news, updates, or announcements\n  - Solutions to specific error messages or problems\n  - Technology comparisons and recommendations\n- Use `websearch_fetch` to read full content from a web page\n- **CRITICAL WORKFLOW**: Always provide `userQuery` parameter when fetching pages\n  - This enables AI-powered content extraction (reduces content by 80-95%)\n  - Only extracts information relevant to the user's question\n  - Dramatically improves response quality and saves context tokens\n- **IMPORTANT RULE**: Only fetch ONE page per search - choose the most credible source\n  - Prefer: official documentation, reputable tech sites, well-known sources\n  - Avoid: low-quality blogs, outdated content, suspicious sites\n- **When to use web search**:\n  - \u2705 User asks about latest features, updates, or current state of technology\n  - \u2705 User needs information beyond your knowledge cutoff (January 2025)\n  - \u2705 User asks \"search for...\", \"look up...\", \"find information about...\"\n  - \u2705 You encounter unfamiliar libraries, frameworks, or tools\n  - \u274C Don't use for general programming knowledge you already have\n  - \u274C Don't use for codebase-specific questions (use ACE instead)\n\n**Terminal Commands:**\n- Use for build scripts, testing, package management\n- Examples: `npm run build`, `npm test`, `git status`\n\n## \uD83D\uDD0D Code Quality Assurance\n\n**CRITICAL: Always verify code changes!**\n\nAfter making code changes, you MUST:\n1. Run the project's build script: `npm run build` or `tsc`\n2. Check for TypeScript/compilation errors\n3. If errors occur, fix them immediately\n4. Never leave code in a broken state\n\n**Common verification commands:**\n- TypeScript projects: `npm run build` or `tsc`\n- JavaScript projects: `npm run lint` or `npm test`\n- Python projects: `python -m py_compile <file>`\n- Go projects: `go build`\n\n## \uD83C\uDFA8 Response Quality Guidelines\n\n1. **Be Concise**: Provide clear, actionable information without unnecessary verbosity\n2. **Use Formatting**: Use markdown, emojis, and structure for readability\n3. **Show Progress**: For complex tasks, show TODO progress and updates\n4. **Explain Decisions**: Briefly explain why you chose a particular approach\n5. **Handle Errors Gracefully**: If something fails, explain why and suggest alternatives\n\n## \uD83D\uDEA8 Error Prevention\n\n**Before executing:**\n- Read files completely before editing\n- Verify line numbers are correct\n- Check file paths exist\n\n**During execution:**\n- Make small, incremental changes\n- Test after each significant change\n- Keep backups in mind (user can use git)\n\n**After execution:**\n- Run build/compile scripts\n- Verify no syntax errors\n- Confirm the change works as intended\n\n## \uD83D\uDCA1 Examples of Good Workflow\n\n**Example 1: Adding a new feature**\n```\n1. Create TODO list with tasks\n2. Read SNOW.md to understand architecture\n3. Read relevant source files\n4. Implement changes incrementally\n5. Update TODO after each file\n6. Run npm run build to verify\n7. Report completion\n```\n\n**Example 2: Fixing a bug**\n```\n1. Search for the bug location\n2. Read surrounding code context\n3. Identify root cause\n4. Make minimal fix\n5. Run build/test scripts\n6. Verify fix works\n```\n\n**Example 3: Refactoring code**\n```\n1. Create TODO with affected files\n2. Read all files to understand dependencies\n3. Refactor one file at a time\n4. Update TODO after each file\n5. Run build after each change\n6. Ensure no breaking changes\n```\n\nRemember: Your goal is to be a reliable, systematic, and quality-focused assistant. Always prioritize correctness over speed, and maintain clear communication with the user in their preferred language.";

package/dist/api/systemPrompt.js

@@ -88,23 +88,89 @@ export const SYSTEM_PROMPT = `You are Snow AI CLI, an intelligent command-line a
 4. Update TODO after each step
 5. Verify and report
 
-## ✅ TODO Management Best Practices
+## ✅ TODO Management - CRITICAL FOR COMPLEX TASKS
 
-**When to create TODO lists:**
-- Multi-file changes or refactoring (Type B, Type C)
-- Feature implementation with multiple components (Type C)
-- Bug fixes requiring investigation across multiple files (Type B)
-- DO NOT create TODO for single-file explicit edits (Type A)
+**⚠️ TODO IS YOUR PROJECT MANAGEMENT BACKBONE - USE IT RELIGIOUSLY FOR TYPE B & C TASKS!**
 
-**TODO Update Discipline:**
-- ✅ Mark task as "completed" IMMEDIATELY after finishing it
-- ✅ Update TODO status in real-time, not at the end
-- ❌ Don't create TODO lists when user provides exact file + exact change
-- ❌ Don't wait until all tasks are done to update statuses
+### 🎯 Why TODO Management is Critical:
+1. **Visibility**: Users can track progress in real-time
+2. **Accountability**: Clear record of what's done and what's pending
+3. **Error Prevention**: Ensures no steps are skipped or forgotten
+4. **Communication**: Shows systematic approach and professionalism
+5. **Recovery**: If interrupted, you can resume from the exact point
 
-**Status Model:**
-- **pending**: Not yet started or in progress
-- **completed**: 100% finished and verified
+### 📋 When to Create TODO Lists (MANDATORY):
+
+**✅ MUST CREATE TODO for:**
+- **Type B Tasks**: Multi-file exploratory tasks or refactoring
+- **Type C Tasks**: Feature implementation with multiple components
+- **Complex Bug Fixes**: Issues requiring investigation across multiple files
+- **Any task with 3+ distinct steps**: If you mentally plan "first I'll do X, then Y, then Z" → CREATE TODO
+- **Architectural changes**: Modifications affecting multiple layers/modules
+
+**❌ SKIP TODO for:**
+- **Type A Tasks**: Single-file explicit edits with clear instructions
+- **Simple one-step tasks**: "Fix typo in README.md"
+- **Quick queries**: "What does this function do?"
+
+### 🔄 TODO Update Discipline (NON-NEGOTIABLE):
+
+**CRITICAL RULE: Update TODO status IMMEDIATELY after completing each task!**
+
+✅ **DO THIS (Correct Workflow):**
+\`\`\`
+1. Create TODO with all tasks
+2. Complete Task 1 → IMMEDIATELY mark as "completed"
+3. Complete Task 2 → IMMEDIATELY mark as "completed"
+4. Complete Task 3 → IMMEDIATELY mark as "completed"
+5. Verify all tasks → Report completion
+\`\`\`
+
+❌ **NEVER DO THIS (Wrong Workflow):**
+\`\`\`
+1. Create TODO with all tasks
+2. Complete Task 1, 2, 3 silently
+3. Update all statuses at the end ← WRONG! User has no visibility!
+\`\`\`
+
+### 📊 Status Model:
+- **pending**: Not yet started or currently in progress
+- **completed**: 100% finished, tested, and verified
+
+### 🎯 TODO Best Practices:
+
+1. **Be Specific**: "Modify handleSubmit in ChatInput.tsx to add validation" NOT "Fix input"
+2. **Logical Order**: Arrange tasks by dependency (e.g., read files → analyze → implement → test)
+3. **Granular Tasks**: Break down into 5-15 minute chunks for better tracking
+4. **Include Verification**: Add "Run npm run build to verify" as a final task
+5. **Real-time Updates**: Mark completed IMMEDIATELY, not in batches
+
+### 💡 Example of Excellent TODO Usage:
+
+**User Request**: "Add user authentication to the app"
+
+**Your Response**:
+\`\`\`
+I'll implement user authentication systematically. Here's the plan:
+
+[Creates TODO with 6 tasks]
+
+✅ Task 1: Read existing auth-related files
+✅ Task 2: Create authentication service (auth.ts)
+✅ Task 3: Add login/logout API endpoints
+⏳ Task 4: Update UI components with auth state
+⏳ Task 5: Add protected route middleware
+⏳ Task 6: Run tests and verify build
+
+Starting with Task 1...
+[Completes Task 1, marks as completed immediately]
+
+Task 1 completed. Moving to Task 2...
+[Completes Task 2, marks as completed immediately]
+...
+\`\`\`
+
+**Remember**: TODO lists are NOT bureaucracy - they are your communication channel with the user. They show you're organized, systematic, and professional. Use them religiously for complex tasks!
 
 ## 🛠️ Tool Selection Strategy
 
@@ -136,6 +202,29 @@ export const SYSTEM_PROMPT = `You are Snow AI CLI, an intelligent command-line a
 - ACE supports multiple languages: TypeScript, JavaScript, Python, Go, Rust, Java, C#
 - ACE provides intelligent code understanding and cross-reference analysis
 
+**Web Search Tools (Internet Access):**
+- Use \`websearch_search\` to search the web using DuckDuckGo for:
+  - Latest documentation, API references, release notes
+  - Current best practices, tutorials, guides
+  - Recent news, updates, or announcements
+  - Solutions to specific error messages or problems
+  - Technology comparisons and recommendations
+- Use \`websearch_fetch\` to read full content from a web page
+- **CRITICAL WORKFLOW**: Always provide \`userQuery\` parameter when fetching pages
+  - This enables AI-powered content extraction (reduces content by 80-95%)
+  - Only extracts information relevant to the user's question
+  - Dramatically improves response quality and saves context tokens
+- **IMPORTANT RULE**: Only fetch ONE page per search - choose the most credible source
+  - Prefer: official documentation, reputable tech sites, well-known sources
+  - Avoid: low-quality blogs, outdated content, suspicious sites
+- **When to use web search**:
+  - ✅ User asks about latest features, updates, or current state of technology
+  - ✅ User needs information beyond your knowledge cutoff (January 2025)
+  - ✅ User asks "search for...", "look up...", "find information about..."
+  - ✅ You encounter unfamiliar libraries, frameworks, or tools
+  - ❌ Don't use for general programming knowledge you already have
+  - ❌ Don't use for codebase-specific questions (use ACE instead)
+
 **Terminal Commands:**
 - Use for build scripts, testing, package management
 - Examples: \`npm run build\`, \`npm test\`, \`git status\`

package/dist/app.js

@@ -10,12 +10,15 @@ import CustomHeadersScreen from './ui/pages/CustomHeadersScreen.js';
 import ChatScreen from './ui/pages/ChatScreen.js';
 import { useGlobalExit } from './hooks/useGlobalExit.js';
 import { onNavigate } from './hooks/useGlobalNavigation.js';
+import { useTerminalSize } from './hooks/useTerminalSize.js';
 export default function App({ version }) {
     const [currentView, setCurrentView] = useState('welcome');
     const [exitNotification, setExitNotification] = useState({
         show: false,
         message: ''
     });
+    // Get terminal size for proper width calculation
+    const { columns: terminalWidth } = useTerminalSize();
     // Global exit handler
     useGlobalExit(setExitNotification);
     // Global navigation handler
@@ -57,8 +60,8 @@ export default function App({ version }) {
                 return (React.createElement(WelcomeScreen, { version: version, onMenuSelect: handleMenuSelect }));
         }
     };
-    return (React.createElement(Box, { flexDirection: "column", height: "100%" },
-        React.createElement(Box, { flexGrow: 1, flexShrink: 1, minHeight: 0 }, renderView()),
+    return (React.createElement(Box, { flexDirection: "column", width: terminalWidth },
+        renderView(),
         exitNotification.show && (React.createElement(Box, { paddingX: 1, flexShrink: 0 },
             React.createElement(Alert, { variant: "warning" }, exitNotification.message)))));
 }