snow-ai 0.3.2 → 0.3.4

package/dist/agents/summaryAgent.d.ts

@@ -0,0 +1,31 @@
+export declare class SummaryAgent {
+    private modelName;
+    private requestMethod;
+    private initialized;
+    /**
+     * Initialize the summary agent with current configuration
+     * @returns true if initialized successfully, false otherwise
+     */
+    private initialize;
+    /**
+     * Check if summary agent is available
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Call the basic 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
+     */
+    private callBasicModel;
+    /**
+     * Generate a concise summary from the first user message
+     *
+     * @param userMessage - The first user message in the conversation
+     * @param abortSignal - Optional abort signal to cancel generation
+     * @returns A concise summary (10-20 words) suitable for session title
+     */
+    generateSummary(userMessage: string, abortSignal?: AbortSignal): Promise<string>;
+}
+export declare const summaryAgent: SummaryAgent;

package/dist/agents/summaryAgent.js

@@ -0,0 +1,256 @@
+import { getOpenAiConfig, getCustomSystemPrompt } 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';
+export class SummaryAgent {
+    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 summary 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 summary agent:', error);
+            return false;
+        }
+    }
+    /**
+     * Check if summary agent is available
+     */
+    async isAvailable() {
+        if (!this.initialized) {
+            return await this.initialize();
+        }
+        return true;
+    }
+    /**
+     * Call the basic 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
+     */
+    async callBasicModel(messages, abortSignal) {
+        const config = getOpenAiConfig();
+        if (!config.basicModel) {
+            throw new Error('Basic model not configured');
+        }
+        // Get custom system prompt if configured
+        const customSystemPrompt = getCustomSystemPrompt();
+        // If custom system prompt exists, prepend it to messages
+        // This ensures summary agent respects user's custom system configuration
+        let processedMessages = messages;
+        if (customSystemPrompt) {
+            processedMessages = [
+                {
+                    role: 'system',
+                    content: customSystemPrompt,
+                },
+                ...messages,
+            ];
+        }
+        // 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: processedMessages,
+                        max_tokens: 1024, // Summaries are short
+                    }, abortSignal);
+                    break;
+                case 'gemini':
+                    streamGenerator = createStreamingGeminiCompletion({
+                        model: this.modelName,
+                        messages: processedMessages,
+                    }, abortSignal);
+                    break;
+                case 'responses':
+                    streamGenerator = createStreamingResponse({
+                        model: this.modelName,
+                        messages: processedMessages,
+                        stream: true,
+                    }, abortSignal);
+                    break;
+                case 'chat':
+                default:
+                    streamGenerator = createStreamingChatCompletion({
+                        model: this.modelName,
+                        messages: processedMessages,
+                        stream: true,
+                    }, abortSignal);
+                    break;
+            }
+            // Intercept streaming response and assemble complete content
+            let completeContent = '';
+            let chunkCount = 0;
+            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;
+                        }
+                    }
+                    else {
+                        // Responses, Gemini, and Anthropic APIs all use: {type: 'content', content: string}
+                        if (chunk.type === 'content' && chunk.content) {
+                            completeContent += chunk.content;
+                        }
+                    }
+                }
+            }
+            catch (streamError) {
+                // Log streaming error with details
+                if (streamError instanceof Error) {
+                    logger.error('Summary agent: Streaming error:', {
+                        error: streamError.message,
+                        stack: streamError.stack,
+                        name: streamError.name,
+                        chunkCount,
+                        contentLength: completeContent.length,
+                    });
+                }
+                else {
+                    logger.error('Summary agent: Unknown streaming error:', {
+                        error: streamError,
+                        chunkCount,
+                        contentLength: completeContent.length,
+                    });
+                }
+                throw streamError;
+            }
+            return completeContent;
+        }
+        catch (error) {
+            // Log detailed error from API call setup or streaming
+            if (error instanceof Error) {
+                logger.error('Summary agent: API call failed:', {
+                    error: error.message,
+                    stack: error.stack,
+                    name: error.name,
+                    requestMethod: this.requestMethod,
+                    modelName: this.modelName,
+                });
+            }
+            else {
+                logger.error('Summary agent: Unknown API error:', {
+                    error,
+                    requestMethod: this.requestMethod,
+                    modelName: this.modelName,
+                });
+            }
+            throw error;
+        }
+        finally {
+            // Restore original config
+            config.advancedModel = originalAdvancedModel;
+        }
+    }
+    /**
+     * Generate a concise summary from the first user message
+     *
+     * @param userMessage - The first user message in the conversation
+     * @param abortSignal - Optional abort signal to cancel generation
+     * @returns A concise summary (10-20 words) suitable for session title
+     */
+    async generateSummary(userMessage, abortSignal) {
+        const available = await this.isAvailable();
+        if (!available) {
+            // If summary agent is not available, return a truncated version of the message
+            return userMessage.slice(0, 50) + (userMessage.length > 50 ? '...' : '');
+        }
+        try {
+            const summaryPrompt = `Generate a concise summary (10-20 words) for the following user message. The summary should capture the main topic or intent.
+
+User Message: ${userMessage}
+
+Instructions:
+1. Keep it under 20 words
+2. Focus on the main topic or question
+3. Use clear, simple language
+4. Do not include quotes or special formatting
+5. Make it suitable as a conversation title
+
+Summary:`;
+            const messages = [
+                {
+                    role: 'user',
+                    content: summaryPrompt,
+                },
+            ];
+            const summary = await this.callBasicModel(messages, abortSignal);
+            if (!summary || summary.trim().length === 0) {
+                logger.warn('Summary agent returned empty response, using truncated message');
+                return (userMessage.slice(0, 50) + (userMessage.length > 50 ? '...' : ''));
+            }
+            // Clean up the summary (remove quotes, trim whitespace)
+            const cleanedSummary = summary
+                .trim()
+                .replace(/^["']|["']$/g, '') // Remove leading/trailing quotes
+                .replace(/\n/g, ' ') // Replace newlines with spaces
+                .slice(0, 100); // Limit to 100 characters max
+            return cleanedSummary;
+        }
+        catch (error) {
+            // Log detailed error information
+            if (error instanceof Error) {
+                logger.warn('Summary agent generation failed, using truncated message:', {
+                    error: error.message,
+                    stack: error.stack,
+                    name: error.name,
+                });
+            }
+            else {
+                logger.warn('Summary agent generation failed with unknown error:', error);
+            }
+            // Fallback to truncated message
+            return userMessage.slice(0, 50) + (userMessage.length > 50 ? '...' : '');
+        }
+    }
+}
+// Export singleton instance
+export const summaryAgent = new SummaryAgent();

package/dist/api/systemPrompt.d.ts

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

package/dist/api/systemPrompt.js

@@ -43,8 +43,8 @@ export const SYSTEM_PROMPT = `You are Snow AI CLI, an intelligent command-line a
 **TODO Guidelines:**
 1. **Create Early**: Set up TODO list BEFORE starting implementation
 2. **Be Specific**: Each item should be a concrete action
-3. **Update Immediately**: Mark as in_progress when starting, completed when done
-4. **One Active Task**: Only one item should be in_progress at a time
+3. **Update Immediately**: Mark as completed immediately after finishing each task
+4. **Focus on Completion**: Move from pending to completed, no intermediate states
 
 **TODO = Action List, NOT Investigation Plan**
 - ✅ "Create AuthService with login/logout methods"
@@ -60,10 +60,10 @@ export const SYSTEM_PROMPT = `You are Snow AI CLI, an intelligent command-line a
 
 **Workflow Example:**
 1. User asks to add feature → Create TODO list immediately
-2. Mark first item as in_progress
-3. Complete the task → Mark as completed
-4. Move to next item → Mark as in_progress
-5. Repeat until all tasks completed
+2. Complete the first task → Mark as completed
+3. Move to next task → Complete and mark as completed
+4. Repeat until all tasks completed
+5. Focus on getting tasks done rather than tracking intermediate states
 
 ## 🛠️ Available Tools
 

package/dist/app.d.ts

@@ -2,6 +2,7 @@ import React from 'react';
 type Props = {
     version?: string;
     skipWelcome?: boolean;
+    headlessPrompt?: string;
 };
-export default function App({ version, skipWelcome }: Props): React.JSX.Element;
+export default function App({ version, skipWelcome, headlessPrompt }: Props): React.JSX.Element;
 export {};

package/dist/app.js

@@ -6,10 +6,15 @@ import MCPConfigScreen from './ui/pages/MCPConfigScreen.js';
 import SystemPromptConfigScreen from './ui/pages/SystemPromptConfigScreen.js';
 import CustomHeadersScreen from './ui/pages/CustomHeadersScreen.js';
 import ChatScreen from './ui/pages/ChatScreen.js';
+import HeadlessModeScreen from './ui/pages/HeadlessModeScreen.js';
 import { useGlobalExit, } from './hooks/useGlobalExit.js';
 import { onNavigate } from './hooks/useGlobalNavigation.js';
 import { useTerminalSize } from './hooks/useTerminalSize.js';
-export default function App({ version, skipWelcome }) {
+export default function App({ version, skipWelcome, headlessPrompt }) {
+    // If headless prompt is provided, use headless mode
+    if (headlessPrompt) {
+        return (React.createElement(HeadlessModeScreen, { prompt: headlessPrompt, onComplete: () => process.exit(0) }));
+    }
     const [currentView, setCurrentView] = useState(skipWelcome ? 'chat' : 'welcome');
     const [exitNotification, setExitNotification] = useState({
         show: false,

package/dist/cli.js

@@ -29,14 +29,16 @@ async function checkForUpdates(currentVersion) {
     }
 }
 const cli = meow(`
-	Usage
-	  $ snow
+Usage
+  $ snow
+  $ snow --ask "your prompt"
 
-	Options
+Options
 		--help     Show help
 		--version  Show version
 		--update   Update to latest version
 		-c         Skip welcome screen and resume last conversation
+		--ask      Quick question mode (headless mode with single prompt)
 `, {
     importMeta: import.meta,
     flags: {
@@ -48,6 +50,9 @@ const cli = meow(`
             type: 'boolean',
             default: false,
         },
+        ask: {
+            type: 'string',
+        },
     },
 });
 // Handle update flag
@@ -76,7 +81,7 @@ if (process.env['NODE_ENV'] === 'development' || process.env['DEBUG']) {
     }, 5 * 60 * 1000);
 }
 // Startup component that shows loading spinner during update check
-const Startup = ({ version, skipWelcome, }) => {
+const Startup = ({ version, skipWelcome, headlessPrompt, }) => {
     const [appReady, setAppReady] = React.useState(false);
     React.useEffect(() => {
         let mounted = true;
@@ -113,7 +118,7 @@ const Startup = ({ version, skipWelcome, }) => {
                     React.createElement(Spinner, { type: "dots" })),
                 React.createElement(Text, null, " Checking for updates..."))));
     }
-    return React.createElement(App, { version: version, skipWelcome: skipWelcome });
+    return (React.createElement(App, { version: version, skipWelcome: skipWelcome, headlessPrompt: headlessPrompt }));
 };
 // Disable bracketed paste mode on startup
 process.stdout.write('\x1b[?2004l');
@@ -134,7 +139,7 @@ process.on('SIGTERM', () => {
     cleanup();
     process.exit(0);
 });
-render(React.createElement(Startup, { version: cli.pkg.version, skipWelcome: cli.flags.c }), {
+render(React.createElement(Startup, { version: cli.pkg.version, skipWelcome: cli.flags.c, headlessPrompt: cli.flags.ask }), {
     exitOnCtrlC: false,
     patchConsole: true,
 });

package/dist/hooks/useSessionSave.js

@@ -2,9 +2,20 @@ import { useCallback, useRef } from 'react';
 import { sessionManager } from '../utils/sessionManager.js';
 export function useSessionSave() {
     const savedMessagesRef = useRef(new Set());
-    // Generate a unique ID for a message (based on role + content + timestamp window)
+    // Generate a unique ID for a message (based on role + content + timestamp window + tool identifiers)
     const generateMessageId = useCallback((message, timestamp) => {
-        return `${message.role}-${message.content.length}-${Math.floor(timestamp / 5000)}`;
+        // Base ID with role, content length, and time window
+        let id = `${message.role}-${message.content.length}-${Math.floor(timestamp / 5000)}`;
+        // For assistant messages with tool_calls, include tool call IDs to ensure uniqueness
+        if (message.role === 'assistant' && message.tool_calls && message.tool_calls.length > 0) {
+            const toolCallIds = message.tool_calls.map(tc => tc.id).sort().join(',');
+            id += `-tools:${toolCallIds}`;
+        }
+        // For tool result messages, include the tool_call_id to ensure uniqueness
+        if (message.role === 'tool' && message.tool_call_id) {
+            id += `-toolcall:${message.tool_call_id}`;
+        }
+        return id;
     }, []);
     // Save API message directly - 直接保存 API 格式的消息
     const saveMessage = useCallback(async (message) => {

package/dist/mcp/todo.d.ts

@@ -23,14 +23,17 @@ export declare class TodoService {
     constructor(baseDir: string, getCurrentSessionId: GetCurrentSessionId);
     initialize(): Promise<void>;
     private getTodoPath;
+    private formatDateForFolder;
+    private ensureTodoDir;
     /**
      * 创建或更新会话的 TODO List
      */
-    saveTodoList(sessionId: string, todos: TodoItem[]): Promise<TodoList>;
+    saveTodoList(sessionId: string, todos: TodoItem[], existingList?: TodoList | null): Promise<TodoList>;
     /**
      * 获取会话的 TODO List
      */
     getTodoList(sessionId: string): Promise<TodoList | null>;
+    private findTodoInDateFolders;
     /**
      * 更新单个 TODO 项
      */
@@ -43,6 +46,10 @@ export declare class TodoService {
      * 删除 TODO 项
      */
     deleteTodoItem(sessionId: string, todoId: string): Promise<TodoList | null>;
+    /**
+     * 删除整个会话的 TODO 列表
+     */
+    deleteTodoList(sessionId: string): Promise<boolean>;
     /**
      * 获取所有工具定义
      */