snow-ai 0.4.5 → 0.4.6

package/dist/api/systemPrompt.js

@@ -78,88 +78,48 @@ const SYSTEM_PROMPT_TEMPLATE = `You are Snow AI CLI, an intelligent command-line
 
 ## Execution Strategy - BALANCE ACTION & ANALYSIS
 
-## Rigorous coding habits
-- In any programming language or business logic, which is usually accompanied by many-to-many references to files, you also need to think about the impact of the modification and whether it will conflict with the user's original business.
-- Using the optimal solution principle, you cannot choose risk scenarios such as hardcoding, logic simplification, etc., unless the user asks you to do so.
-- Avoid duplication, users may have encapsulated some reusable functions, and you should try to find them instead of creating a new function right away.
-- Compilable principle, you should not have low-level errors such as syntax errors, use tools to check for syntax errors, non-compilable code is meaningless.
+### Rigorous Coding Habits
+- **Boundary verification**: MUST use \`filesystem-read\` to identify complete code boundaries before ANY edit. Never guess line numbers or code structure
+- **Impact analysis**: Consider modification impact and conflicts with existing business logic
+- **Optimal solution**: Avoid hardcoding/shortcuts unless explicitly requested
+- **Avoid duplication**: Search for existing reusable functions before creating new ones
+- **Compilable code**: No syntax errors - always verify complete syntactic units
 
 ### Smart Action Mode
 **Principle: Understand enough to code correctly, but don't over-investigate**
 
-**Examples:**
-- "Fix timeout in parser.ts" → Read file + check imports if needed → Fix → Done
-- "Add validation to form" → Read form component + related validation utils → Add code → Done
-- "Refactor error handling" → Read error handler + callers → Refactor → Done
+**Examples:** "Fix timeout in parser.ts" → Read file + check imports → Fix → Done
 
 PLACEHOLDER_FOR_WORKFLOW_SECTION
 
-**Golden Rule: Read what you need to write correct code, nothing more.**
+### TODO Management - USE ACTIVELY
+
+**STRONGLY RECOMMENDED: Create TODO for ALL multi-step tasks (3+ steps)** - Prevents missing steps, ensures systematic execution
+
+**When to use:** Multi-file changes, features, refactoring, bug fixes touching 2+ files
+**Skip only:** Single-file trivial edits (1-2 lines)
+
+**CRITICAL - PARALLEL CALLS ONLY:** ALWAYS call TODO tools WITH action tools in same function call block
+- CORRECT: todo-create + filesystem-read | todo-update + filesystem-edit
+- FORBIDDEN: NEVER call TODO tools alone then wait for result
+
+**Lifecycle:** New task → todo-create + initial action | Major change → delete + recreate | Minor → todo-add/update
 
-### TODO Management - STRONGLY RECOMMENDED for Better Results
-
-**DEFAULT BEHAVIOR: Use TODO for ALL multi-step tasks (3+ steps)**
-
-**WHY TODO IS ESSENTIAL:**
-- **Track progress** - Never lose your place in complex work
-- **Ensure completeness** - Verify all steps are done
-- **Stay focused** - Clear roadmap prevents confusion
-- **Build confidence** - Users see structured progress
-- **Better quality** - Systematic approach reduces errors
-
-**WHEN TO USE TODO (Default for most tasks):**
-- **ANY multi-file modification** (always use)
-- **ANY feature implementation** (always use)
-- **ANY refactoring task** (always use)
-- **Bug fixes touching 2+ files** (recommended)
-- **User requests with multiple requirements** (always use)
-- **Unfamiliar codebase changes** (recommended)
-- **SKIP ONLY for**: Single-file trivial edits (1-2 lines)
-
-**USAGE RULES (Critical):**
-1. **PARALLEL CALLS ONLY**: ALWAYS call TODO tools with action tools in the SAME function call block
-2. **Immediate updates**: Mark completed while performing work (not after)
-3. **Right sizing**: 3-7 main tasks, add subtasks if needed
-4. **Lifecycle Management**:
-   - New task = Create TODO at start
-   - Major requirement change = Delete old + create new
-   - Minor adjustment = Use todo-add or todo-update
-   - **CRITICAL**: Keep using TODO throughout the entire conversation!
-
-**CORRECT PATTERNS (Do this):**
-- todo-create + filesystem-read → Plan while gathering info
-- todo-update(completed) + filesystem-edit → Update as you work
-- todo-get + filesystem-read → Check status while reading
-- todo-add + filesystem-edit → Add new task while working
-
-**FORBIDDEN PATTERNS (NEVER do this - WILL FAIL):**
-- todo-create alone, wait for result, then work → VIOLATION! Call together!
-- todo-update alone, wait, then continue → VIOLATION! Update while working!
-- todo-get alone just to check → VIOLATION! Call with other tools!
-- Skipping TODO for multi-file tasks → VIOLATION! Always use TODO!
-- **Abandoning TODO mid-conversation** → VIOLATION! Keep using throughout dialogue!
-
-**BEST PRACTICE: Start every non-trivial task with todo-create + initial action in parallel!**
+**Best practice:** Start every non-trivial task with todo-create in parallel with first action
 
 ## Available Tools
 
 **Filesystem (SUPPORTS BATCH OPERATIONS):**
-- Read first and then modify to avoid grammatical errors caused by boundary judgment errors**
 
-**BATCH EDITING WORKFLOW - HIGH EFFICIENCY:**
-When modifying multiple files (extremely common in real projects):
-1. Use filesystem-read with array of files to read them ALL at once
-2. Use filesystem-edit or filesystem-edit_search with array config to modify ALL at once
-3. This saves multiple round trips and dramatically improves efficiency
+**CRITICAL: BOUNDARY-FIRST EDITING**
 
-**BATCH EXAMPLES:**
-- Read multiple: \`filesystem-read(filePath=["a.ts", "b.ts", "c.ts"])\`
-- Edit multiple with same change: \`filesystem-edit_search(filePath=["a.ts", "b.ts"], searchContent="old", replaceContent="new")\`
-- Edit multiple with different changes: \`filesystem-edit_search(filePath=[{path:"a.ts", searchContent:"old1", replaceContent:"new1"}, {path:"b.ts", searchContent:"old2", replaceContent:"new2"}])\`
-- Per-file line ranges: \`filesystem-edit(filePath=[{path:"a.ts", startLine:10, endLine:20, newContent:"..."}, {path:"b.ts", startLine:50, endLine:60, newContent:"..."}])\`
+**MANDATORY WORKFLOW:**
+1. **LOCATE** - \`ace-semantic_search\` / \`ace-text_search\` / \`ace-find_definition\`
+2. **READ & VERIFY** - Use \`filesystem-read\` to identify COMPLETE units (functions: opening to closing brace, markup: full tags, check indentation)
+3. **COPY COMPLETE CODE** - Remove line numbers, preserve all content
+4. **EDIT** - \`filesystem-edit_search\` (fuzzy match, safer) or \`filesystem-edit\` (line-based, for add/delete)
 
-**CRITICAL EFFICIENCY RULE:**
-When you need to modify 2+ files, ALWAYS use batch operations instead of calling tools multiple times. This is faster, cleaner, and more reliable.
+**BATCH OPERATIONS:** Modify 2+ files? Use batch: \`filesystem-read(filePath=["a.ts","b.ts"])\` or \`filesystem-edit_search(filePath=[{path:"a.ts",...},{path:"b.ts",...}])\`
 
 **Code Search:**
 PLACEHOLDER_FOR_CODE_SEARCH_SECTION
@@ -333,7 +293,7 @@ What type of task?
 ## Quality Assurance
 
 Guidance and recommendations:
-1. Run build: \`npm run build\` or \`tsc\`
+1. Run build
 2. Fix any errors immediately
 3. Never leave broken code
 
@@ -365,20 +325,16 @@ function isCodebaseEnabled() {
 function getWorkflowSection(hasCodebase) {
     if (hasCodebase) {
         return `**Your workflow:**
-1. **START WITH SEMANTIC SEARCH** - Use \\\`codebase-search\\\` as your PRIMARY exploration tool
-   - ALWAYS try \\\`codebase-search\\\` FIRST for ANY code understanding task
-   - Examples: "authentication logic", "error handling", "user validation", "database queries"
-   - Dramatically faster than reading multiple files manually
-   - Returns relevant code snippets with context - read results to understand the codebase
-2. Read the primary file(s) mentioned (or files found by codebase search)
+1. **START WITH \`codebase-search\`** - Your PRIMARY tool for code exploration (use for 90% of understanding tasks)
+   - Query by intent: "authentication logic", "error handling", "validation patterns"
+   - Returns relevant code with full context - dramatically faster than manual file reading
+2. Read specific files found by codebase-search or mentioned by user
 3. Check dependencies/imports that directly impact the change
-4. For precise symbol lookup AFTER understanding context, use \\\`ace-search_symbols\\\`, \\\`ace-find_definition\\\`, or \\\`ace-find_references\\\`
-5. Read related files ONLY if they're critical to understanding the task
-6. Write/modify code with proper context
-7. Verify with build
-8. NO excessive exploration beyond what's needed
-9. NO reading entire modules "for reference"
-10. NO over-planning multi-step workflows for simple tasks`;
+4. Use ACE tools ONLY when needed: \`ace-find_definition\` (exact symbol), \`ace-find_references\` (usage tracking)
+5. Write/modify code with proper context
+6. Verify with build
+
+**Key principle:** codebase-search first, ACE tools for precision only`;
     }
     else {
         return `**Your workflow:**
@@ -406,28 +362,22 @@ When dealing with 2+ files, ALWAYS prefer batch operations:
  */
 function getCodeSearchSection(hasCodebase) {
     if (hasCodebase) {
-        // When codebase tool is available, prioritize it
+        // When codebase tool is available, prioritize it heavily
         return `**Code Search Strategy:**
 
-**Priority Order (use in this sequence):**
-
-1. **Semantic Search First** (\`codebase-search\`):
-   - **ALWAYS START HERE** for code understanding and exploration tasks
-   - Query by MEANING: "how is auth handled", "error patterns", "validation logic", "where is X implemented"
-   - Returns semantically relevant code with context
-   - **CRITICAL**: Primary tool for code understanding - do NOT skip this!
-   - Example: "find authentication logic" → use codebase-search first
-
-2. **Precise Lookup Second** (ACE tools - AFTER understanding context):
-   - \`ace-semantic_search\` - Symbol search with context (fuzzy matching + symbol type filtering)
-   - \`ace-find_definition\` - Go to single definition of a known symbol
-   - \`ace-find_references\` - Find all usages of a known symbol
-   - Use for: Known exact symbol names, reference tracking after exploration
-
-3. **Literal Text Search Last** (\`ace-text_search\`):
-   - ONLY for literal string matching (TODOs, log messages, error strings, constants)
-   - NOT for code understanding or exploration
-   - Use AFTER semantic search when you need exact string patterns`;
+**PRIMARY TOOL - \`codebase-search\` (Semantic Search):**
+- **USE THIS FIRST for 90% of code exploration tasks**
+- Query by MEANING and intent: "authentication logic", "error handling patterns", "validation flow"
+- Returns relevant code with full context across entire codebase
+- **Why it's superior**: Understands semantic relationships, not just exact matches
+- Examples: "how users are authenticated", "where database queries happen", "error handling approach"
+
+**Fallback tools (use ONLY when codebase-search insufficient):**
+- \`ace-find_definition\` - Jump to exact symbol definition (when you know the exact name)
+- \`ace-find_references\` - Find all usages of a known symbol (for impact analysis)
+- \`ace-text_search\` - Literal string search (TODOs, log messages, exact error strings)
+
+**Golden rule:** Try codebase-search first, use ACE tools only for precise symbol lookup`;
     }
     else {
         // When codebase tool is NOT available, only show ACE

package/dist/hooks/useAgentPicker.d.ts

@@ -6,5 +6,9 @@ export declare function useAgentPicker(buffer: TextBuffer, triggerUpdate: () =>
     agentSelectedIndex: number;
     setAgentSelectedIndex: import("react").Dispatch<import("react").SetStateAction<number>>;
     agents: SubAgent[];
+    agentQuery: string;
+    hashSymbolPosition: number;
+    updateAgentPickerState: (_text: string, cursorPos: number) => void;
+    getFilteredAgents: () => SubAgent[];
     handleAgentSelect: (agent: SubAgent) => void;
 };

package/dist/hooks/useAgentPicker.js

@@ -4,6 +4,8 @@ export function useAgentPicker(buffer, triggerUpdate) {
     const [showAgentPicker, setShowAgentPicker] = useState(false);
     const [agentSelectedIndex, setAgentSelectedIndex] = useState(0);
     const [agents, setAgents] = useState([]);
+    const [agentQuery, setAgentQuery] = useState('');
+    const [hashSymbolPosition, setHashSymbolPosition] = useState(-1);
     // Load agents when picker is shown
     useEffect(() => {
         if (showAgentPicker) {
@@ -12,21 +14,106 @@ export function useAgentPicker(buffer, triggerUpdate) {
             setAgentSelectedIndex(0);
         }
     }, [showAgentPicker]);
+    // Update agent picker state based on # symbol
+    const updateAgentPickerState = useCallback((_text, cursorPos) => {
+        // Use display text (with placeholders) instead of full text (expanded)
+        const displayText = buffer.text;
+        // Find the last '#' symbol before the cursor
+        const beforeCursor = displayText.slice(0, cursorPos);
+        let position = -1;
+        let query = '';
+        // Search backwards from cursor to find #
+        for (let i = beforeCursor.length - 1; i >= 0; i--) {
+            if (beforeCursor[i] === '#') {
+                position = i;
+                const afterHash = beforeCursor.slice(i + 1);
+                // Only activate if no space/newline after #
+                if (!afterHash.includes(' ') && !afterHash.includes('\n')) {
+                    query = afterHash;
+                    break;
+                }
+                else {
+                    // Has space after #, not valid
+                    position = -1;
+                    break;
+                }
+            }
+        }
+        if (position !== -1) {
+            // Found valid # context
+            if (!showAgentPicker ||
+                agentQuery !== query ||
+                hashSymbolPosition !== position) {
+                setShowAgentPicker(true);
+                setAgentQuery(query);
+                setHashSymbolPosition(position);
+                setAgentSelectedIndex(0);
+            }
+        }
+        else {
+            // Hide agent picker if no valid # context found and it was triggered by #
+            if (showAgentPicker && hashSymbolPosition !== -1) {
+                setShowAgentPicker(false);
+                setHashSymbolPosition(-1);
+                setAgentQuery('');
+            }
+        }
+    }, [buffer, showAgentPicker, agentQuery, hashSymbolPosition]);
+    // Get filtered agents based on query
+    const getFilteredAgents = useCallback(() => {
+        if (!agentQuery) {
+            return agents;
+        }
+        const query = agentQuery.toLowerCase();
+        return agents.filter(agent => agent.id.toLowerCase().includes(query) ||
+            agent.name.toLowerCase().includes(query) ||
+            agent.description.toLowerCase().includes(query));
+    }, [agents, agentQuery]);
     // Handle agent selection
     const handleAgentSelect = useCallback((agent) => {
-        // Clear buffer and insert agent reference
-        buffer.setText('');
-        buffer.insert(`#${agent.id} `);
+        if (hashSymbolPosition !== -1) {
+            // Triggered by # symbol - replace inline
+            const displayText = buffer.text;
+            const cursorPos = buffer.getCursorPosition();
+            // Replace query with selected agent ID
+            const beforeHash = displayText.slice(0, hashSymbolPosition);
+            const afterCursor = displayText.slice(cursorPos);
+            // Construct the replacement: #agent_id
+            const newText = beforeHash + '#' + agent.id + ' ' + afterCursor;
+            // Set the new text and position cursor after the inserted agent ID + space
+            buffer.setText(newText);
+            // Calculate cursor position after the inserted text
+            // # length (1) + agent ID length + space (1)
+            const insertedLength = 1 + agent.id.length + 1;
+            const targetPos = hashSymbolPosition + insertedLength;
+            // Reset cursor to beginning, then move to correct position
+            for (let i = 0; i < targetPos; i++) {
+                if (i < buffer.text.length) {
+                    buffer.moveRight();
+                }
+            }
+            setHashSymbolPosition(-1);
+            setAgentQuery('');
+        }
+        else {
+            // Triggered by command - clear buffer and insert
+            buffer.setText('');
+            buffer.insert(`#${agent.id} `);
+        }
         setShowAgentPicker(false);
         setAgentSelectedIndex(0);
         triggerUpdate();
-    }, [buffer, triggerUpdate]);
+    }, [hashSymbolPosition, buffer, triggerUpdate]);
     return {
         showAgentPicker,
         setShowAgentPicker,
         agentSelectedIndex,
         setAgentSelectedIndex,
         agents,
+        agentQuery,
+        hashSymbolPosition,
+        updateAgentPickerState,
+        getFilteredAgents,
         handleAgentSelect,
     };
 }

package/dist/hooks/useKeyboardInput.d.ts

@@ -57,7 +57,8 @@ type KeyboardInputOptions = {
     setShowAgentPicker: (show: boolean) => void;
     agentSelectedIndex: number;
     setAgentSelectedIndex: (index: number | ((prev: number) => number)) => void;
-    agents: SubAgent[];
+    updateAgentPickerState: (text: string, cursorPos: number) => void;
+    getFilteredAgents: () => SubAgent[];
     handleAgentSelect: (agent: SubAgent) => void;
     showTodoPicker: boolean;
     setShowTodoPicker: (show: boolean) => void;

package/dist/hooks/useKeyboardInput.js

@@ -2,7 +2,7 @@ import { useRef, useEffect } from 'react';
 import { useInput } from 'ink';
 import { executeCommand } from '../utils/commandExecutor.js';
 export function useKeyboardInput(options) {
-    const { buffer, disabled, triggerUpdate, forceUpdate, showCommands, setShowCommands, commandSelectedIndex, setCommandSelectedIndex, getFilteredCommands, updateCommandPanelState, onCommand, showFilePicker, setShowFilePicker, fileSelectedIndex, setFileSelectedIndex, setFileQuery, setAtSymbolPosition, filteredFileCount, updateFilePickerState, handleFileSelect, fileListRef, showHistoryMenu, setShowHistoryMenu, historySelectedIndex, setHistorySelectedIndex, escapeKeyCount, setEscapeKeyCount, escapeKeyTimer, getUserMessages, handleHistorySelect, currentHistoryIndex, navigateHistoryUp, navigateHistoryDown, resetHistoryNavigation, saveToHistory, pasteFromClipboard, onSubmit, ensureFocus, showAgentPicker, setShowAgentPicker, agentSelectedIndex, setAgentSelectedIndex, agents, handleAgentSelect, showTodoPicker, setShowTodoPicker, todoSelectedIndex, setTodoSelectedIndex, todos, selectedTodos, toggleTodoSelection, confirmTodoSelection, todoSearchQuery, setTodoSearchQuery, } = options;
+    const { buffer, disabled, triggerUpdate, forceUpdate, showCommands, setShowCommands, commandSelectedIndex, setCommandSelectedIndex, getFilteredCommands, updateCommandPanelState, onCommand, showFilePicker, setShowFilePicker, fileSelectedIndex, setFileSelectedIndex, setFileQuery, setAtSymbolPosition, filteredFileCount, updateFilePickerState, handleFileSelect, fileListRef, showHistoryMenu, setShowHistoryMenu, historySelectedIndex, setHistorySelectedIndex, escapeKeyCount, setEscapeKeyCount, escapeKeyTimer, getUserMessages, handleHistorySelect, currentHistoryIndex, navigateHistoryUp, navigateHistoryDown, resetHistoryNavigation, saveToHistory, pasteFromClipboard, onSubmit, ensureFocus, showAgentPicker, setShowAgentPicker, agentSelectedIndex, setAgentSelectedIndex, updateAgentPickerState, getFilteredAgents, handleAgentSelect, showTodoPicker, setShowTodoPicker, todoSelectedIndex, setTodoSelectedIndex, todos, selectedTodos, toggleTodoSelection, confirmTodoSelection, todoSearchQuery, setTodoSearchQuery, } = options;
     // Mark variables as used (they are used in useInput closure below)
     void todoSelectedIndex;
     void selectedTodos;
@@ -24,6 +24,7 @@ export function useKeyboardInput(options) {
         const text = buffer.getFullText();
         const cursorPos = buffer.getCursorPosition();
         updateFilePickerState(text, cursorPos);
+        updateAgentPickerState(text, cursorPos);
         updateCommandPanelState(text);
         forceUpdate({});
     };
@@ -165,6 +166,7 @@ export function useKeyboardInput(options) {
         }
         // Handle agent picker navigation
         if (showAgentPicker) {
+            const filteredAgents = getFilteredAgents();
             // Up arrow in agent picker
             if (key.upArrow) {
                 setAgentSelectedIndex(prev => Math.max(0, prev - 1));
@@ -172,14 +174,14 @@ export function useKeyboardInput(options) {
             }
             // Down arrow in agent picker
             if (key.downArrow) {
-                const maxIndex = Math.max(0, agents.length - 1);
+                const maxIndex = Math.max(0, filteredAgents.length - 1);
                 setAgentSelectedIndex(prev => Math.min(maxIndex, prev + 1));
                 return;
             }
             // Enter - select agent
             if (key.return) {
-                if (agents.length > 0 && agentSelectedIndex < agents.length) {
-                    const selectedAgent = agents[agentSelectedIndex];
+                if (filteredAgents.length > 0 && agentSelectedIndex < filteredAgents.length) {
+                    const selectedAgent = filteredAgents[agentSelectedIndex];
                     if (selectedAgent) {
                         handleAgentSelect(selectedAgent);
                         setShowAgentPicker(false);
@@ -188,8 +190,9 @@ export function useKeyboardInput(options) {
                 }
                 return;
             }
-            // For any other key in agent picker, just return to prevent interference
-            return;
+            // Allow typing to filter - don't block regular input
+            // The input will be processed below and updateAgentPickerState will be called
+            // which will update the filter automatically
         }
         // Handle history menu navigation
         if (showHistoryMenu) {
@@ -395,6 +398,7 @@ export function useKeyboardInput(options) {
             const text = buffer.getFullText();
             const cursorPos = buffer.getCursorPosition();
             updateFilePickerState(text, cursorPos);
+            updateAgentPickerState(text, cursorPos);
             triggerUpdate();
             return;
         }
@@ -419,6 +423,7 @@ export function useKeyboardInput(options) {
             const text = buffer.getFullText();
             const cursorPos = buffer.getCursorPosition();
             updateFilePickerState(text, cursorPos);
+            updateAgentPickerState(text, cursorPos);
             triggerUpdate();
             return;
         }
@@ -452,6 +457,7 @@ export function useKeyboardInput(options) {
                 const navigated = navigateHistoryUp();
                 if (navigated) {
                     updateFilePickerState(buffer.getFullText(), buffer.getCursorPosition());
+                    updateAgentPickerState(buffer.getFullText(), buffer.getCursorPosition());
                     triggerUpdate();
                     return;
                 }
@@ -459,6 +465,7 @@ export function useKeyboardInput(options) {
             // Normal cursor movement
             buffer.moveUp();
             updateFilePickerState(buffer.getFullText(), buffer.getCursorPosition());
+            updateAgentPickerState(buffer.getFullText(), buffer.getCursorPosition());
             triggerUpdate();
             return;
         }
@@ -492,6 +499,7 @@ export function useKeyboardInput(options) {
                 const navigated = navigateHistoryDown();
                 if (navigated) {
                     updateFilePickerState(buffer.getFullText(), buffer.getCursorPosition());
+                    updateAgentPickerState(buffer.getFullText(), buffer.getCursorPosition());
                     triggerUpdate();
                     return;
                 }
@@ -499,6 +507,7 @@ export function useKeyboardInput(options) {
             // Normal cursor movement
             buffer.moveDown();
             updateFilePickerState(buffer.getFullText(), buffer.getCursorPosition());
+            updateAgentPickerState(buffer.getFullText(), buffer.getCursorPosition());
             triggerUpdate();
             return;
         }
@@ -522,6 +531,7 @@ export function useKeyboardInput(options) {
                 const cursorPos = buffer.getCursorPosition();
                 updateCommandPanelState(text);
                 updateFilePickerState(text, cursorPos);
+                updateAgentPickerState(text, cursorPos);
                 triggerUpdate();
             }
             else {
@@ -551,6 +561,7 @@ export function useKeyboardInput(options) {
                     const cursorPos = buffer.getCursorPosition();
                     updateCommandPanelState(text);
                     updateFilePickerState(text, cursorPos);
+                    updateAgentPickerState(text, cursorPos);
                     triggerUpdate();
                 }
                 // Set timer to process accumulated input
@@ -587,6 +598,7 @@ export function useKeyboardInput(options) {
                         const cursorPos = buffer.getCursorPosition();
                         updateCommandPanelState(text);
                         updateFilePickerState(text, cursorPos);
+                        updateAgentPickerState(text, cursorPos);
                         triggerUpdate();
                     }
                 }, timeoutDelay); // Extended delay for large pastes to ensure complete accumulation

package/dist/i18n/lang/en.js

@@ -283,6 +283,7 @@ export const en = {
         quickAccessTitle: '🔍 Quick Access:',
         insertFiles: '@ - Insert files from project',
         searchContent: '@@ - Search file content',
+        selectAgent: '# - Select sub-agent for task execution',
         showCommands: '/ - Show available commands',
         navigationTitle: '📋 Navigation:',
         navigateHistory: '↑/↓ - Navigate command/message history',
@@ -329,7 +330,7 @@ export const en = {
         headerExplanations: 'Ask for code explanations and debugging help',
         headerInterrupt: 'Press ESC during response to interrupt',
         headerYolo: 'Press Shift+Tab: toggle YOLO',
-        headerShortcuts: "Shortcuts: Ctrl+L (delete to start) • Ctrl+R (delete to end) • {pasteKey} (paste images) • '@' (files) • '@@' (search content) • '/' (commands)",
+        headerShortcuts: "Shortcuts: Ctrl+L (delete to start) • Ctrl+R (delete to end) • {pasteKey} (paste images) • '@' (files) • '@@' (search content) • '#' (sub-agents) • '/' (commands)",
         headerWorkingDirectory: 'Working directory: {directory}',
         // Status messages
         statusThinking: 'Thinking...',

package/dist/i18n/lang/es.js

@@ -283,6 +283,7 @@ export const es = {
         quickAccessTitle: '🔍 Acceso Rápido:',
         insertFiles: '@ - Insertar archivos del proyecto',
         searchContent: '@@ - Buscar contenido de archivos',
+        selectAgent: '# - Seleccionar sub-agente para ejecutar tarea',
         showCommands: '/ - Mostrar comandos disponibles',
         navigationTitle: '📋 Navegación:',
         navigateHistory: '↑/↓ - Navegar por el historial de comandos/mensajes',
@@ -329,7 +330,7 @@ export const es = {
         headerExplanations: 'Solicita explicaciones de código y ayuda de depuración',
         headerInterrupt: 'Presiona ESC durante la respuesta para interrumpir',
         headerYolo: 'Presiona Shift+Tab: Alternar YOLO',
-        headerShortcuts: "Atajos: Ctrl+L (eliminar hasta inicio) • Ctrl+R (eliminar hasta final) • {pasteKey} (pegar imagen) • '@' (archivo) • '@@' (buscar contenido) • '/' (comando)",
+        headerShortcuts: "Atajos: Ctrl+L (eliminar hasta inicio) • Ctrl+R (eliminar hasta final) • {pasteKey} (pegar imagen) • '@' (archivo) • '@@' (buscar contenido) • '#' (sub-agentes) • '/' (comando)",
         headerWorkingDirectory: 'Directorio de Trabajo: {directory}',
         // Status messages
         statusThinking: 'Pensando...',

package/dist/i18n/lang/ja.js

@@ -283,6 +283,7 @@ export const ja = {
         quickAccessTitle: '🔍 クイックアクセス:',
         insertFiles: '@ - プロジェクトからファイルを挿入',
         searchContent: '@@ - ファイル内容を検索',
+        selectAgent: '# - サブエージェントを選択してタスクを実行',
         showCommands: '/ - 利用可能なコマンドを表示',
         navigationTitle: '📋 ナビゲーション:',
         navigateHistory: '↑/↓ - コマンド/メッセージ履歴を移動',
@@ -329,7 +330,7 @@ export const ja = {
         headerExplanations: 'コードの説明とデバッグヘルプを問い合わせ',
         headerInterrupt: '応答中にESCで中断',
         headerYolo: 'Shift+Tabを押す: YOLOを切替',
-        headerShortcuts: "ショートカット: Ctrl+L (先頭まで削除) • Ctrl+R (末尾まで削除) • {pasteKey} (画像貼付) • '@' (ファイル) • '@@' (内容検索) • '/' (コマンド)",
+        headerShortcuts: "ショートカット: Ctrl+L (先頭まで削除) • Ctrl+R (末尾まで削除) • {pasteKey} (画像貼付) • '@' (ファイル) • '@@' (内容検索) • '#' (サブエージェント) • '/' (コマンド)",
         headerWorkingDirectory: '作業ディレクトリ: {directory}',
         // Status messages
         statusThinking: '思考中...',

package/dist/i18n/lang/ko.js

@@ -283,6 +283,7 @@ export const ko = {
         quickAccessTitle: '🔍 빠른 접근:',
         insertFiles: '@ - 프로젝트에서 파일 삽입',
         searchContent: '@@ - 파일 내용 검색',
+        selectAgent: '# - 작업 실행을 위한 하위 에이전트 선택',
         showCommands: '/ - 사용 가능한 명령 표시',
         navigationTitle: '📋 탐색:',
         navigateHistory: '↑/↓ - 명령/메시지 기록 탐색',
@@ -329,7 +330,7 @@ export const ko = {
         headerExplanations: '코드 설명 및 디버그 도움 요청',
         headerInterrupt: '응답 중 ESC로 중단',
         headerYolo: 'Shift+Tab 누르기: YOLO 토글',
-        headerShortcuts: "단축키: Ctrl+L (시작까지 삭제) • Ctrl+R (끝까지 삭제) • {pasteKey} (이미지 붙여넣기) • '@' (파일) • '@@' (내용 검색) • '/' (명령)",
+        headerShortcuts: "단축키: Ctrl+L (시작까지 삭제) • Ctrl+R (끝까지 삭제) • {pasteKey} (이미지 붙여넣기) • '@' (파일) • '@@' (내용 검색) • '#' (하위 에이전트) • '/' (명령)",
         headerWorkingDirectory: '작업 디렉토리: {directory}',
         // Status messages
         statusThinking: '생각 중...',

package/dist/i18n/lang/zh-TW.js

@@ -283,6 +283,7 @@ export const zhTW = {
         quickAccessTitle: '🔍 快速存取:',
         insertFiles: '@ - 從專案插入檔案',
         searchContent: '@@ - 搜尋檔案內容',
+        selectAgent: '# - 選擇子代理執行任務',
         showCommands: '/ - 顯示可用命令',
         navigationTitle: '📋 導航:',
         navigateHistory: '↑/↓ - 導航命令/訊息歷史',
@@ -329,7 +330,7 @@ export const zhTW = {
         headerExplanations: '詢問程式碼說明和偵錯協助',
         headerInterrupt: '在回應期間按 ESC 中斷',
         headerYolo: '按 Shift+Tab: 切換 YOLO',
-        headerShortcuts: "快捷鍵: Ctrl+L (刪除至開頭) • Ctrl+R (刪除至末尾) • {pasteKey} (貼上圖片) • '@' (檔案) • '@@' (搜尋內容) • '/' (命令)",
+        headerShortcuts: "快捷鍵: Ctrl+L (刪除至開頭) • Ctrl+R (刪除至末尾) • {pasteKey} (貼上圖片) • '@' (檔案) • '@@' (搜尋內容) • '#' (子代理) • '/' (命令)",
         headerWorkingDirectory: '工作目錄: {directory}',
         // Status messages
         statusThinking: '思考中...',

package/dist/i18n/lang/zh.js

@@ -283,6 +283,7 @@ export const zh = {
         quickAccessTitle: '🔍 快速访问:',
         insertFiles: '@ - 从项目插入文件',
         searchContent: '@@ - 搜索文件内容',
+        selectAgent: '# - 选择子代理执行任务',
         showCommands: '/ - 显示可用命令',
         navigationTitle: '📋 导航:',
         navigateHistory: '↑/↓ - 导航命令/消息历史',
@@ -329,7 +330,7 @@ export const zh = {
         headerExplanations: '询问代码说明和调试帮助',
         headerInterrupt: '在响应期间按 ESC 中断',
         headerYolo: '按 Shift+Tab: 切换 YOLO',
-        headerShortcuts: "快捷键: Ctrl+L (删除至开头) • Ctrl+R (删除至末尾) • {pasteKey} (粘贴图片) • '@' (文件) • '@@' (搜索内容) • '/' (命令)",
+        headerShortcuts: "快捷键: Ctrl+L (删除至开头) • Ctrl+R (删除至末尾) • {pasteKey} (粘贴图片) • '@' (文件) • '@@' (搜索内容) • '#' (子代理) • '/' (命令)",
         headerWorkingDirectory: '工作目录: {directory}',
         // Status messages
         statusThinking: '思考中...',

package/dist/i18n/types.d.ts

@@ -280,6 +280,7 @@ export type TranslationKeys = {
         quickAccessTitle: string;
         insertFiles: string;
         searchContent: string;
+        selectAgent: string;
         showCommands: string;
         navigationTitle: string;
         navigateHistory: string;

package/dist/mcp/filesystem.js

@@ -10,6 +10,7 @@ import { calculateSimilarity, normalizeForDisplay, } from './utils/filesystem/si
 import { analyzeCodeStructure, findSmartContextBoundaries, } from './utils/filesystem/code-analysis.utils.js';
 import { findClosestMatches, generateDiffMessage, } from './utils/filesystem/match-finder.utils.js';
 import { parseEditBySearchParams, parseEditByLineParams, executeBatchOperation, } from './utils/filesystem/batch-operations.utils.js';
+import { tryFixPath } from './utils/filesystem/path-fixer.utils.js';
 // ACE Code Search utilities for symbol parsing
 import { parseFileSymbols } from './utils/aceCodeSearch/symbol.utils.js';
 // Notebook utilities for automatic note retrieval
@@ -217,10 +218,8 @@ export class FilesystemMCPService {
                         if (actualEndLine < actualStartLine) {
                             throw new Error(`End line must be greater than or equal to start line for ${file}`);
                         }
-                        if (actualStartLine > totalLines) {
-                            throw new Error(`Start line ${actualStartLine} exceeds file length ${totalLines} for ${file}`);
-                        }
-                        const start = actualStartLine;
+                        // Auto-adjust if startLine exceeds file length
+                        const start = Math.min(actualStartLine, totalLines);
                         const end = Math.min(totalLines, actualEndLine);
                         // Extract specified lines
                         const selectedLines = lines.slice(start - 1, end);
@@ -302,10 +301,8 @@ export class FilesystemMCPService {
             if (actualEndLine < actualStartLine) {
                 throw new Error('End line must be greater than or equal to start line');
             }
-            if (actualStartLine > totalLines) {
-                throw new Error(`Start line ${actualStartLine} exceeds file length ${totalLines}`);
-            }
-            const start = actualStartLine;
+            // Auto-adjust if startLine exceeds file length
+            const start = Math.min(actualStartLine, totalLines);
             const end = Math.min(totalLines, actualEndLine);
             // Extract specified lines (convert to 0-indexed) and add line numbers
             const selectedLines = lines.slice(start - 1, end);
@@ -340,6 +337,24 @@ export class FilesystemMCPService {
             };
         }
         catch (error) {
+            // Try to fix common path issues if it's a file not found error
+            if (error instanceof Error &&
+                error.message.includes('ENOENT') &&
+                typeof filePath === 'string') {
+                const fixedPath = await tryFixPath(filePath, this.basePath);
+                if (fixedPath && fixedPath !== filePath) {
+                    // Verify the fixed path actually exists before suggesting
+                    const fixedFullPath = this.resolvePath(fixedPath);
+                    try {
+                        await fs.access(fixedFullPath);
+                        // File exists, provide helpful suggestion to AI
+                        throw new Error(`Failed to read file ${filePath}: ${error instanceof Error ? error.message : 'Unknown error'}\n💡 Tip: File not found. Did you mean "${fixedPath}"? Please use the correct path.`);
+                    }
+                    catch {
+                        // Fixed path also doesn't work, just throw original error
+                    }
+                }
+            }
             throw new Error(`Failed to read file ${filePath}: ${error instanceof Error ? error.message : 'Unknown error'}`);
         }
     }
@@ -855,25 +870,23 @@ export class FilesystemMCPService {
             if (startLine > endLine) {
                 throw new Error('Start line must be less than or equal to end line');
             }
-            if (startLine > totalLines) {
-                throw new Error(`Start line ${startLine} exceeds file length ${totalLines}`);
-            }
-            // Adjust endLine if it exceeds file length
+            // Adjust startLine and endLine if they exceed file length
+            const adjustedStartLine = Math.min(startLine, totalLines);
             const adjustedEndLine = Math.min(endLine, totalLines);
-            const linesToModify = adjustedEndLine - startLine + 1;
+            const linesToModify = adjustedEndLine - adjustedStartLine + 1;
             // Backup file before editing
             await incrementalSnapshotManager.backupFile(fullPath);
             // Extract the lines that will be replaced (for comparison)
             // Compress whitespace for display readability
-            const replacedLines = lines.slice(startLine - 1, adjustedEndLine);
+            const replacedLines = lines.slice(adjustedStartLine - 1, adjustedEndLine);
             const replacedContent = replacedLines
                 .map((line, idx) => {
-                const lineNum = startLine + idx;
+                const lineNum = adjustedStartLine + idx;
                 return `${lineNum}→${normalizeForDisplay(line)}`;
             })
                 .join('\n');
             // Calculate context range using smart boundary detection
-            const smartBoundaries = findSmartContextBoundaries(lines, startLine, adjustedEndLine, contextLines);
+            const smartBoundaries = findSmartContextBoundaries(lines, adjustedStartLine, adjustedEndLine, contextLines);
             const contextStart = smartBoundaries.start;
             const contextEnd = smartBoundaries.end;
             // Extract old content for context (compress whitespace for readability)
@@ -886,12 +899,12 @@ export class FilesystemMCPService {
                 .join('\n');
             // Replace the specified lines
             const newContentLines = newContent.split('\n');
-            const beforeLines = lines.slice(0, startLine - 1);
+            const beforeLines = lines.slice(0, adjustedStartLine - 1);
             const afterLines = lines.slice(adjustedEndLine);
             const modifiedLines = [...beforeLines, ...newContentLines, ...afterLines];
             // Calculate new context range
             const newTotalLines = modifiedLines.length;
-            const lineDifference = newContentLines.length - (adjustedEndLine - startLine + 1);
+            const lineDifference = newContentLines.length - (adjustedEndLine - adjustedStartLine + 1);
             const newContextEnd = Math.min(newTotalLines, contextEnd + lineDifference);
             // Extract new content for context with line numbers (compress whitespace)
             const newContextLines = modifiedLines.slice(contextStart - 1, newContextEnd);
@@ -941,7 +954,7 @@ export class FilesystemMCPService {
                 }
             }
             // Analyze code structure of the edited content (using formatted content if available)
-            const editedContentLines = finalLines.slice(startLine - 1, startLine - 1 + newContentLines.length);
+            const editedContentLines = finalLines.slice(adjustedStartLine - 1, adjustedStartLine - 1 + newContentLines.length);
             const structureAnalysis = analyzeCodeStructure(finalLines.join('\n'), filePath, editedContentLines);
             // Try to get diagnostics from IDE (VSCode or JetBrains) after editing (non-blocking)
             let diagnostics = [];
@@ -958,7 +971,7 @@ export class FilesystemMCPService {
             }
             const result = {
                 message: `✅ File edited successfully,Please check the edit results and pay attention to code boundary issues to avoid syntax errors caused by missing closed parts: ${filePath}\n` +
-                    `   Replaced: lines ${startLine}-${adjustedEndLine} (${linesToModify} lines)\n` +
+                    `   Replaced: lines ${adjustedStartLine}-${adjustedEndLine} (${linesToModify} lines)\n` +
                     `   Result: ${newContentLines.length} new lines` +
                     (smartBoundaries.extended
                         ? `\n   📍 Context auto-extended to show complete code block (lines ${contextStart}-${finalContextEnd})`

package/dist/mcp/utils/filesystem/path-fixer.utils.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Attempt to fix common path issues when file is not found
+ * @param originalPath - The original path that failed
+ * @param basePath - Base path for resolving relative paths
+ * @returns Fixed path or null if cannot be fixed
+ */
+export declare function tryFixPath(originalPath: string, basePath: string): Promise<string | null>;

package/dist/mcp/utils/filesystem/path-fixer.utils.js

@@ -0,0 +1,60 @@
+import { promises as fs } from 'node:fs';
+import { resolve } from 'node:path';
+/**
+ * Attempt to fix common path issues when file is not found
+ * @param originalPath - The original path that failed
+ * @param basePath - Base path for resolving relative paths
+ * @returns Fixed path or null if cannot be fixed
+ */
+export async function tryFixPath(originalPath, basePath) {
+    try {
+        // Common pattern: "source/mcp/utils/filesystem.ts" should be "source/mcp/filesystem.ts"
+        // Remove unnecessary intermediate directories
+        const segments = originalPath.split('/');
+        // Try removing 'utils' directory if present
+        if (segments.includes('utils')) {
+            const withoutUtils = segments.filter(s => s !== 'utils').join('/');
+            const fixedPath = resolve(basePath, withoutUtils);
+            try {
+                await fs.access(fixedPath);
+                return withoutUtils;
+            }
+            catch {
+                // Continue to next attempt
+            }
+        }
+        // Try parent directories
+        for (let i = 0; i < segments.length - 1; i++) {
+            const reducedPath = [
+                ...segments.slice(0, i),
+                segments[segments.length - 1],
+            ].join('/');
+            const fixedPath = resolve(basePath, reducedPath);
+            try {
+                await fs.access(fixedPath);
+                return reducedPath;
+            }
+            catch {
+                // Continue to next attempt
+            }
+        }
+        // Try searching for the file by name in common directories
+        const fileName = segments[segments.length - 1];
+        const commonDirs = ['source', 'src', 'lib', 'dist'];
+        for (const dir of commonDirs) {
+            const searchPath = `${dir}/${fileName}`;
+            const fixedPath = resolve(basePath, searchPath);
+            try {
+                await fs.access(fixedPath);
+                return searchPath;
+            }
+            catch {
+                // Continue to next attempt
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/ui/components/AgentPickerPanel.d.ts

@@ -1,8 +1,10 @@
 import React from 'react';
+import type { SubAgent } from '../../utils/subAgentConfig.js';
 interface Props {
+    agents: SubAgent[];
     selectedIndex: number;
     visible: boolean;
     maxHeight?: number;
 }
-declare const AgentPickerPanel: React.MemoExoticComponent<({ selectedIndex, visible, maxHeight }: Props) => React.JSX.Element | null>;
+declare const AgentPickerPanel: React.MemoExoticComponent<({ agents, selectedIndex, visible, maxHeight }: Props) => React.JSX.Element | null>;
 export default AgentPickerPanel;

package/dist/ui/components/AgentPickerPanel.js

@@ -1,15 +1,12 @@
 import React, { memo, useMemo } from 'react';
 import { Box, Text } from 'ink';
 import { Alert } from '@inkjs/ui';
-import { getSubAgents } from '../../utils/subAgentConfig.js';
-const AgentPickerPanel = memo(({ selectedIndex, visible, maxHeight }) => {
+const AgentPickerPanel = memo(({ agents, selectedIndex, visible, maxHeight }) => {
     // Fixed maximum display items to prevent rendering issues
     const MAX_DISPLAY_ITEMS = 5;
     const effectiveMaxItems = maxHeight
         ? Math.min(maxHeight, MAX_DISPLAY_ITEMS)
         : MAX_DISPLAY_ITEMS;
-    // Load sub-agents
-    const agents = useMemo(() => getSubAgents(), []);
     // Limit displayed agents
     const displayedAgents = useMemo(() => {
         if (agents.length <= effectiveMaxItems) {
@@ -54,7 +51,8 @@ const AgentPickerPanel = memo(({ selectedIndex, visible, maxHeight }) => {
                         "Select Sub-Agent",
                         ' ',
                         agents.length > effectiveMaxItems &&
-                            `(${selectedIndex + 1}/${agents.length})`)),
+                            `(${selectedIndex + 1}/${agents.length})`),
+                    React.createElement(Text, { color: "gray", dimColor: true }, "(Press ESC to close)")),
                 displayedAgents.map((agent, index) => (React.createElement(Box, { key: agent.id, flexDirection: "column", width: "100%" },
                     React.createElement(Text, { color: index === displayedSelectedIndex ? 'green' : 'gray', bold: true },
                         index === displayedSelectedIndex ? '❯ ' : '  ',

package/dist/ui/components/ChatInput.js

@@ -57,7 +57,7 @@ export default function ChatInput({ onSubmit, onCommand, placeholder = 'Type you
     // Use history navigation hook
     const { showHistoryMenu, setShowHistoryMenu, historySelectedIndex, setHistorySelectedIndex, escapeKeyCount, setEscapeKeyCount, escapeKeyTimer, getUserMessages, handleHistorySelect, currentHistoryIndex, navigateHistoryUp, navigateHistoryDown, resetHistoryNavigation, saveToHistory, } = useHistoryNavigation(buffer, triggerUpdate, chatHistory, onHistorySelect);
     // Use agent picker hook
-    const { showAgentPicker, setShowAgentPicker, agentSelectedIndex, setAgentSelectedIndex, agents, handleAgentSelect, } = useAgentPicker(buffer, triggerUpdate);
+    const { showAgentPicker, setShowAgentPicker, agentSelectedIndex, setAgentSelectedIndex, updateAgentPickerState, getFilteredAgents, handleAgentSelect, } = useAgentPicker(buffer, triggerUpdate);
     // Use todo picker hook
     const { showTodoPicker, setShowTodoPicker, todoSelectedIndex, setTodoSelectedIndex, todos, selectedTodos, toggleTodoSelection, confirmTodoSelection, isLoading: todoIsLoading, searchQuery: todoSearchQuery, setSearchQuery: setTodoSearchQuery, totalTodoCount, } = useTodoPicker(buffer, triggerUpdate, process.cwd());
     // Use clipboard hook
@@ -108,7 +108,8 @@ export default function ChatInput({ onSubmit, onCommand, placeholder = 'Type you
         setShowAgentPicker,
         agentSelectedIndex,
         setAgentSelectedIndex,
-        agents,
+        updateAgentPickerState,
+        getFilteredAgents,
         handleAgentSelect,
         showTodoPicker,
         setShowTodoPicker,
@@ -309,7 +310,7 @@ export default function ChatInput({ onSubmit, onCommand, placeholder = 'Type you
             React.createElement(CommandPanel, { commands: getFilteredCommands(), selectedIndex: commandSelectedIndex, query: buffer.getFullText().slice(1), visible: showCommands, isProcessing: commandPanelIsProcessing }),
             React.createElement(Box, null,
                 React.createElement(FileList, { ref: fileListRef, query: fileQuery, selectedIndex: fileSelectedIndex, visible: showFilePicker, maxItems: 10, rootPath: process.cwd(), onFilteredCountChange: handleFilteredCountChange, searchMode: searchMode })),
-            React.createElement(AgentPickerPanel, { selectedIndex: agentSelectedIndex, visible: showAgentPicker, maxHeight: 5 }),
+            React.createElement(AgentPickerPanel, { agents: getFilteredAgents(), selectedIndex: agentSelectedIndex, visible: showAgentPicker, maxHeight: 5 }),
             React.createElement(TodoPickerPanel, { todos: todos, selectedIndex: todoSelectedIndex, selectedTodos: selectedTodos, visible: showTodoPicker, maxHeight: 5, isLoading: todoIsLoading, searchQuery: todoSearchQuery, totalCount: totalTodoCount }),
             yoloMode && (React.createElement(Box, { marginTop: 1 },
                 React.createElement(Text, { color: "yellow", dimColor: true }, t.chatScreen.yoloModeActive))),

package/dist/ui/components/HelpPanel.js

@@ -31,6 +31,9 @@ export default function HelpPanel() {
             React.createElement(Text, null,
                 " \u2022 ",
                 t.helpPanel.searchContent),
+            React.createElement(Text, null,
+                " \u2022 ",
+                t.helpPanel.selectAgent),
             React.createElement(Text, null,
                 " \u2022 ",
                 t.helpPanel.showCommands)),

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "snow-ai",
-	"version": "0.4.5",
+	"version": "0.4.6",
 	"description": "Intelligent Command Line Assistant powered by AI",
 	"license": "MIT",
 	"bin": {