snow-ai 0.3.27 → 0.3.29

package/dist/api/systemPrompt.js

@@ -195,9 +195,10 @@ Guidance and recommendations:
 
 ## 📚 Project Context (SNOW.md)
 
-- Read ONLY when implementing large features or unfamiliar architecture
-- Skip for simple tasks where you understand the structure
-- Contains: project overview, architecture, tech stack
+- Contains: project overview, architecture, tech stack.
+- Generally located in the project root directory.
+- You can read this file at any time to understand the project and recommend reading.
+- This file may not exist. If you can't find it, please ignore it.
 
 Remember: **ACTION > ANALYSIS**. Write code first, investigate only when blocked.`;
 // Export SYSTEM_PROMPT as a getter function for real-time ROLE.md updates

package/dist/hooks/useCommandHandler.js

@@ -27,6 +27,7 @@ export async function executeContextCompression() {
             tool_calls: msg.tool_calls,
             images: msg.images,
             reasoning: msg.reasoning,
+            thinking: msg.thinking, // 保留 thinking 字段（Anthropic Extended Thinking）
             subAgentInternal: msg.subAgentInternal,
         }));
         // Compress the context (全量压缩，保留最后一轮完整对话)
@@ -38,10 +39,10 @@ export async function executeContextCompression() {
         }
         // 构建新的会话消息列表
         const newSessionMessages = [];
-        // 添加压缩摘要到会话
+        // 添加压缩摘要到会话（使用 user 角色，因为 Extended Thinking 模式下所有 assistant 消息都需要 thinking 块）
         newSessionMessages.push({
-            role: 'assistant',
-            content: compressionResult.summary,
+            role: 'user',
+            content: `[Context Summary from Previous Conversation]\n\n${compressionResult.summary}`,
             timestamp: Date.now(),
         });
         // 添加保留的最后一轮完整对话（保留完整的消息结构）
@@ -57,6 +58,7 @@ export async function executeContextCompression() {
                     ...(msg.tool_calls && { tool_calls: msg.tool_calls }),
                     ...(msg.images && { images: msg.images }),
                     ...(msg.reasoning && { reasoning: msg.reasoning }),
+                    ...(msg.thinking && { thinking: msg.thinking }), // 保留 thinking 字段（Anthropic Extended Thinking）
                     ...(msg.subAgentInternal !== undefined && {
                         subAgentInternal: msg.subAgentInternal,
                     }),

package/dist/hooks/useConversation.js

@@ -327,6 +327,10 @@ export async function handleConversationWithTools(options) {
                     ]);
                 }
                 // Display tool calls in UI - 只有耗时工具才显示进行中状态
+                // Generate parallel group ID when there are multiple tools
+                const parallelGroupId = receivedToolCalls.length > 1
+                    ? `parallel-${Date.now()}-${Math.random()}`
+                    : undefined;
                 for (const toolCall of receivedToolCalls) {
                     const toolDisplay = formatToolCallMessage(toolCall);
                     let toolArgs;
@@ -351,6 +355,8 @@ export async function handleConversationWithTools(options) {
                                 toolDisplay,
                                 toolCallId: toolCall.id, // Store tool call ID for later update
                                 toolPending: true, // Mark as pending execution
+                                // Mark parallel group for ALL tools (time-consuming or not)
+                                parallelGroup: parallelGroupId,
                             },
                         ]);
                     }
@@ -509,8 +515,10 @@ export async function handleConversationWithTools(options) {
                         if (subAgentMessage.message.type === 'tool_calls') {
                             const toolCalls = subAgentMessage.message.tool_calls;
                             if (toolCalls && toolCalls.length > 0) {
-                                // Add tool call messages for each tool
-                                const toolMessages = toolCalls.map((toolCall) => {
+                                // Add tool call messages for each tool (only for time-consuming tools)
+                                const toolMessages = toolCalls
+                                    .filter((toolCall) => isToolNeedTwoStepDisplay(toolCall.function.name))
+                                    .map((toolCall) => {
                                     const toolDisplay = formatToolCallMessage(toolCall);
                                     let toolArgs;
                                     try {
@@ -537,16 +545,21 @@ export async function handleConversationWithTools(options) {
                                         },
                                         subAgentInternal: true, // Mark as internal sub-agent message
                                     };
-                                    // Save to session as 'assistant' role for API compatibility
-                                    const sessionMsg = {
-                                        role: 'assistant',
-                                        content: `⚇⚡ ${toolDisplay.toolName}`,
-                                        subAgentInternal: true,
-                                        tool_calls: [toolCall],
-                                    };
-                                    saveMessage(sessionMsg).catch(err => console.error('Failed to save sub-agent tool call:', err));
                                     return uiMsg;
                                 });
+                                // Save all tool calls to session (regardless of display type)
+                                const sessionMsg = {
+                                    role: 'assistant',
+                                    content: toolCalls
+                                        .map((tc) => {
+                                        const display = formatToolCallMessage(tc);
+                                        return `⚇⚡ ${display.toolName}`;
+                                    })
+                                        .join(', '),
+                                    subAgentInternal: true,
+                                    tool_calls: toolCalls,
+                                };
+                                saveMessage(sessionMsg).catch(err => console.error('Failed to save sub-agent tool call:', err));
                                 return [...prev, ...toolMessages];
                             }
                         }
@@ -724,6 +737,8 @@ export async function handleConversationWithTools(options) {
                     m.toolResult !== undefined ||
                     m.subAgentInternal === true));
                 // Update existing tool call messages with results
+                // Collect all result messages first, then add them in batch
+                const resultMessages = [];
                 for (const result of toolResults) {
                     const toolCall = receivedToolCalls.find(tc => tc.id === result.tool_call_id);
                     if (toolCall) {
@@ -733,17 +748,13 @@ export async function handleConversationWithTools(options) {
                             const isError = result.content.startsWith('Error:');
                             const statusIcon = isError ? '✗' : '✓';
                             const statusText = isError ? `\n  └─ ${result.content}` : '';
-                            // Display subagent completion message in main flow
-                            setMessages(prev => [
-                                ...prev,
-                                {
-                                    role: 'assistant',
-                                    content: `${statusIcon} ${toolCall.function.name}${statusText}`,
-                                    streaming: false,
-                                    // Pass the full result.content for ToolResultPreview to parse
-                                    toolResult: !isError ? result.content : undefined,
-                                },
-                            ]);
+                            resultMessages.push({
+                                role: 'assistant',
+                                content: `${statusIcon} ${toolCall.function.name}${statusText}`,
+                                streaming: false,
+                                // Pass the full result.content for ToolResultPreview to parse
+                                toolResult: !isError ? result.content : undefined,
+                            });
                             // Save the tool result to conversation history
                             conversationMessages.push(result);
                             saveMessage(result).catch(error => {
@@ -790,27 +801,24 @@ export async function handleConversationWithTools(options) {
                         // - 普通工具(单步显示):完成消息需要包含参数和结果，使用 toolDisplay
                         // 获取工具参数的格式化信息
                         const toolDisplay = formatToolCallMessage(toolCall);
-                        setMessages(prev => [
-                            ...prev,
-                            // Add new completed message
-                            {
-                                role: 'assistant',
-                                content: `${statusIcon} ${toolCall.function.name}${statusText}`,
-                                streaming: false,
-                                toolCall: editDiffData
-                                    ? {
-                                        name: toolCall.function.name,
-                                        arguments: editDiffData,
-                                    }
-                                    : undefined,
-                                // 为普通工具添加参数显示（耗时工具在进行中状态已经显示过参数）
-                                toolDisplay: !isToolNeedTwoStepDisplay(toolCall.function.name)
-                                    ? toolDisplay
-                                    : undefined,
-                                // Store tool result for preview rendering
-                                toolResult: !isError ? result.content : undefined,
-                            },
-                        ]);
+                        const isNonTimeConsuming = !isToolNeedTwoStepDisplay(toolCall.function.name);
+                        resultMessages.push({
+                            role: 'assistant',
+                            content: `${statusIcon} ${toolCall.function.name}${statusText}`,
+                            streaming: false,
+                            toolCall: editDiffData
+                                ? {
+                                    name: toolCall.function.name,
+                                    arguments: editDiffData,
+                                }
+                                : undefined,
+                            // 为普通工具添加参数显示（耗时工具在进行中状态已经显示过参数）
+                            toolDisplay: isNonTimeConsuming ? toolDisplay : undefined,
+                            // Store tool result for preview rendering
+                            toolResult: !isError ? result.content : undefined,
+                            // Mark parallel group for ALL tools (time-consuming or not)
+                            parallelGroup: parallelGroupId,
+                        });
                     }
                     // Add tool result to conversation history and save (skip if already saved above)
                     if (toolCall && !toolCall.function.name.startsWith('subagent-')) {
@@ -820,6 +828,10 @@ export async function handleConversationWithTools(options) {
                         });
                     }
                 }
+                // Add all result messages in batch to avoid intermediate renders
+                if (resultMessages.length > 0) {
+                    setMessages(prev => [...prev, ...resultMessages]);
+                }
                 // Check if there are pending user messages to insert
                 if (options.getPendingMessages && options.clearPendingMessages) {
                     const pendingMessages = options.getPendingMessages();

package/dist/mcp/filesystem.d.ts

@@ -10,8 +10,19 @@ export declare class FilesystemMCPService {
      */
     private readonly prettierSupportedExtensions;
     constructor(basePath?: string);
+    /**
+     * Extract relevant symbol information for a specific line range
+     * This provides context that helps AI make more accurate modifications
+     * @param symbols - All symbols in the file
+     * @param startLine - Start line of the range
+     * @param endLine - End line of the range
+     * @param _totalLines - Total lines in the file (reserved for future use)
+     * @returns Formatted string with relevant symbol information
+     */
+    private extractRelevantSymbols;
     /**
      * Get the content of a file with optional line range
+     * Enhanced with symbol information for better AI context
      * @param filePath - Path to the file (relative to base path or absolute) or array of file paths or array of file config objects
      * @param startLine - Starting line number (1-indexed, inclusive, optional - defaults to 1). Used for single file or as default for array of strings
      * @param endLine - Ending line number (1-indexed, inclusive, optional - defaults to file end). Used for single file or as default for array of strings

package/dist/mcp/filesystem.js

@@ -11,6 +11,8 @@ 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';
+// ACE Code Search utilities for symbol parsing
+import { parseFileSymbols } from './utils/aceCodeSearch/symbol.utils.js';
 const { resolve, dirname, isAbsolute } = path;
 const execAsync = promisify(exec);
 /**
@@ -52,8 +54,76 @@ export class FilesystemMCPService {
         });
         this.basePath = resolve(basePath);
     }
+    /**
+     * Extract relevant symbol information for a specific line range
+     * This provides context that helps AI make more accurate modifications
+     * @param symbols - All symbols in the file
+     * @param startLine - Start line of the range
+     * @param endLine - End line of the range
+     * @param _totalLines - Total lines in the file (reserved for future use)
+     * @returns Formatted string with relevant symbol information
+     */
+    extractRelevantSymbols(symbols, startLine, endLine, _totalLines) {
+        if (symbols.length === 0) {
+            return '';
+        }
+        // Categorize symbols
+        const imports = symbols.filter(s => s.type === 'import');
+        const exports = symbols.filter(s => s.type === 'export');
+        // Symbols within the requested range
+        const symbolsInRange = symbols.filter(s => s.line >= startLine && s.line <= endLine);
+        // Symbols defined before the range that might be referenced
+        const symbolsBeforeRange = symbols.filter(s => s.line < startLine);
+        // Build context information
+        const parts = [];
+        // Always include imports (crucial for understanding dependencies)
+        if (imports.length > 0) {
+            const importList = imports
+                .slice(0, 10) // Limit to avoid excessive tokens
+                .map(s => `  • ${s.name} (line ${s.line})`)
+                .join('\n');
+            parts.push(`📦 Imports:\n${importList}`);
+        }
+        // Symbols defined in the current range
+        if (symbolsInRange.length > 0) {
+            const rangeSymbols = symbolsInRange
+                .slice(0, 15)
+                .map(s => `  • ${s.type}: ${s.name} (line ${s.line})${s.signature ? ` - ${s.signature.slice(0, 60)}` : ''}`)
+                .join('\n');
+            parts.push(`🎯 Symbols in this range:\n${rangeSymbols}`);
+        }
+        // Key definitions before this range (that might be referenced)
+        if (symbolsBeforeRange.length > 0 && startLine > 1) {
+            const relevantBefore = symbolsBeforeRange
+                .filter(s => s.type === 'function' || s.type === 'class')
+                .slice(-5) // Last 5 before the range
+                .map(s => `  • ${s.type}: ${s.name} (line ${s.line})`)
+                .join('\n');
+            if (relevantBefore) {
+                parts.push(`⬆️ Key definitions above:\n${relevantBefore}`);
+            }
+        }
+        // Exports (important for understanding module interface)
+        if (exports.length > 0) {
+            const exportList = exports
+                .slice(0, 10)
+                .map(s => `  • ${s.name} (line ${s.line})`)
+                .join('\n');
+            parts.push(`📤 Exports:\n${exportList}`);
+        }
+        if (parts.length === 0) {
+            return '';
+        }
+        return ('\n\n' +
+            '='.repeat(60) +
+            '\n📚 SYMBOL INDEX & DEFINITIONS:\n' +
+            '='.repeat(60) +
+            '\n' +
+            parts.join('\n\n'));
+    }
     /**
      * Get the content of a file with optional line range
+     * Enhanced with symbol information for better AI context
      * @param filePath - Path to the file (relative to base path or absolute) or array of file paths or array of file config objects
      * @param startLine - Starting line number (1-indexed, inclusive, optional - defaults to 1). Used for single file or as default for array of strings
      * @param endLine - Ending line number (1-indexed, inclusive, optional - defaults to file end). Used for single file or as default for array of strings
@@ -127,7 +197,18 @@ export class FilesystemMCPService {
                             const lineNum = start + index;
                             return `${lineNum}→${line}`;
                         });
-                        const fileContent = `📄 ${file} (lines ${start}-${end}/${totalLines})\n${numberedLines.join('\n')}`;
+                        let fileContent = `📄 ${file} (lines ${start}-${end}/${totalLines})\n${numberedLines.join('\n')}`;
+                        // Parse and append symbol information
+                        try {
+                            const symbols = await parseFileSymbols(fullPath, content, this.basePath);
+                            const symbolInfo = this.extractRelevantSymbols(symbols, start, end, totalLines);
+                            if (symbolInfo) {
+                                fileContent += symbolInfo;
+                            }
+                        }
+                        catch {
+                            // Silently fail symbol parsing
+                        }
                         allContents.push(fileContent);
                         filesData.push({
                             path: file,
@@ -197,7 +278,19 @@ export class FilesystemMCPService {
                 const lineNum = start + index;
                 return `${lineNum}→${line}`;
             });
-            const partialContent = numberedLines.join('\n');
+            let partialContent = numberedLines.join('\n');
+            // Parse and append symbol information to provide better context for AI
+            try {
+                const symbols = await parseFileSymbols(fullPath, content, this.basePath);
+                const symbolInfo = this.extractRelevantSymbols(symbols, start, end, totalLines);
+                if (symbolInfo) {
+                    partialContent += symbolInfo;
+                }
+            }
+            catch (error) {
+                // Silently fail symbol parsing - don't block file reading
+                // This is optional context enhancement, not critical
+            }
             return {
                 content: partialContent,
                 startLine: start,