snow-ai 0.4.5 → 0.4.7

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.d.ts

@@ -1,4 +1,4 @@
-import type { EditBySearchConfig, EditByLineConfig, EditBySearchResult, EditByLineResult } from './types/filesystem.types.js';
+import type { EditBySearchConfig, EditByLineConfig, EditBySearchResult, EditByLineResult, SingleFileReadResult, MultipleFilesReadResult } from './types/filesystem.types.js';
 /**
  * Filesystem MCP Service
  * Provides basic file operations: read, create, and delete files
@@ -10,6 +10,30 @@ export declare class FilesystemMCPService {
      */
     private readonly prettierSupportedExtensions;
     constructor(basePath?: string);
+    /**
+     * Check if a file is an image based on extension
+     * @param filePath - Path to the file
+     * @returns True if the file is an image
+     */
+    private isImageFile;
+    /**
+     * Check if a file is an Office document based on extension
+     * @param filePath - Path to the file
+     * @returns True if the file is an Office document
+     */
+    private isOfficeFile;
+    /**
+     * Get MIME type for an image file
+     * @param filePath - Path to the file
+     * @returns MIME type or undefined if not an image
+     */
+    private getImageMimeType;
+    /**
+     * Read image file and convert to base64
+     * @param fullPath - Full path to the image file
+     * @returns ImageContent object with base64 data
+     */
+    private readImageAsBase64;
     /**
      * Extract relevant symbol information for a specific line range
      * This provides context that helps AI make more accurate modifications
@@ -29,31 +53,18 @@ export declare class FilesystemMCPService {
     /**
      * Get the content of a file with optional line range
      * Enhanced with symbol information for better AI context
+     * Supports multimodal content (text + images)
      * @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
-     * @returns Object containing the requested content with line numbers and metadata
+     * @returns Object containing the requested content with line numbers and metadata (supports multimodal content)
      * @throws Error if file doesn't exist or cannot be read
      */
     getFileContent(filePath: string | string[] | Array<{
         path: string;
         startLine?: number;
         endLine?: number;
-    }>, startLine?: number, endLine?: number): Promise<{
-        content: string;
-        startLine: number;
-        endLine: number;
-        totalLines: number;
-    } | {
-        content: string;
-        files: Array<{
-            path: string;
-            startLine: number;
-            endLine: number;
-            totalLines: number;
-        }>;
-        totalFiles: number;
-    }>;
+    }>, startLine?: number, endLine?: number): Promise<SingleFileReadResult | MultipleFilesReadResult>;
     /**
      * Create a new file with specified content
      * @param filePath - Path where the file should be created

package/dist/mcp/filesystem.js

@@ -5,16 +5,19 @@ import * as prettier from 'prettier';
 import { vscodeConnection } from '../utils/vscodeConnection.js';
 import { incrementalSnapshotManager } from '../utils/incrementalSnapshot.js';
 import { tryUnescapeFix, trimPairIfPossible, isOverEscaped, } from '../utils/escapeHandler.js';
+import { IMAGE_MIME_TYPES, OFFICE_FILE_TYPES } from './types/filesystem.types.js';
 // Utility functions
 import { calculateSimilarity, normalizeForDisplay, } from './utils/filesystem/similarity.utils.js';
 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';
+import { readOfficeDocument } from './utils/filesystem/office-parser.utils.js';
 // ACE Code Search utilities for symbol parsing
 import { parseFileSymbols } from './utils/aceCodeSearch/symbol.utils.js';
 // Notebook utilities for automatic note retrieval
 import { queryNotebook } from '../utils/notebookManager.js';
-const { resolve, dirname, isAbsolute } = path;
+const { resolve, dirname, isAbsolute, extname } = path;
 /**
  * Filesystem MCP Service
  * Provides basic file operations: read, create, and delete files
@@ -54,6 +57,57 @@ export class FilesystemMCPService {
         });
         this.basePath = resolve(basePath);
     }
+    /**
+     * Check if a file is an image based on extension
+     * @param filePath - Path to the file
+     * @returns True if the file is an image
+     */
+    isImageFile(filePath) {
+        const ext = extname(filePath).toLowerCase();
+        return ext in IMAGE_MIME_TYPES;
+    }
+    /**
+     * Check if a file is an Office document based on extension
+     * @param filePath - Path to the file
+     * @returns True if the file is an Office document
+     */
+    isOfficeFile(filePath) {
+        const ext = extname(filePath).toLowerCase();
+        return ext in OFFICE_FILE_TYPES;
+    }
+    /**
+     * Get MIME type for an image file
+     * @param filePath - Path to the file
+     * @returns MIME type or undefined if not an image
+     */
+    getImageMimeType(filePath) {
+        const ext = extname(filePath).toLowerCase();
+        return IMAGE_MIME_TYPES[ext];
+    }
+    /**
+     * Read image file and convert to base64
+     * @param fullPath - Full path to the image file
+     * @returns ImageContent object with base64 data
+     */
+    async readImageAsBase64(fullPath) {
+        try {
+            const mimeType = this.getImageMimeType(fullPath);
+            if (!mimeType) {
+                return null;
+            }
+            const buffer = await fs.readFile(fullPath);
+            const base64Data = buffer.toString('base64');
+            return {
+                type: 'image',
+                data: base64Data,
+                mimeType,
+            };
+        }
+        catch (error) {
+            console.error(`Failed to read image ${fullPath}:`, error);
+            return null;
+        }
+    }
     /**
      * Extract relevant symbol information for a specific line range
      * This provides context that helps AI make more accurate modifications
@@ -155,10 +209,11 @@ export class FilesystemMCPService {
     /**
      * Get the content of a file with optional line range
      * Enhanced with symbol information for better AI context
+     * Supports multimodal content (text + images)
      * @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
-     * @returns Object containing the requested content with line numbers and metadata
+     * @returns Object containing the requested content with line numbers and metadata (supports multimodal content)
      * @throws Error if file doesn't exist or cannot be read
      */
     async getFileContent(filePath, startLine, endLine) {
@@ -166,7 +221,7 @@ export class FilesystemMCPService {
             // Handle array of files
             if (Array.isArray(filePath)) {
                 const filesData = [];
-                const allContents = [];
+                const multimodalContent = [];
                 for (const fileItem of filePath) {
                     try {
                         // Support both string format and object format
@@ -195,7 +250,10 @@ export class FilesystemMCPService {
                         if (stats.isDirectory()) {
                             const dirFiles = await this.listFiles(file);
                             const fileList = dirFiles.join('\n');
-                            allContents.push(`📁 Directory: ${file}\n${fileList}`);
+                            multimodalContent.push({
+                                type: 'text',
+                                text: `📁 Directory: ${file}\n${fileList}`,
+                            });
                             filesData.push({
                                 path: file,
                                 startLine: 1,
@@ -204,6 +262,44 @@ export class FilesystemMCPService {
                             });
                             continue;
                         }
+                        // Check if this is an image file
+                        if (this.isImageFile(fullPath)) {
+                            const imageContent = await this.readImageAsBase64(fullPath);
+                            if (imageContent) {
+                                // Add text description first
+                                multimodalContent.push({
+                                    type: 'text',
+                                    text: `🖼️  Image: ${file} (${imageContent.mimeType})`,
+                                });
+                                // Add image content
+                                multimodalContent.push(imageContent);
+                                filesData.push({
+                                    path: file,
+                                    isImage: true,
+                                    mimeType: imageContent.mimeType,
+                                });
+                                continue;
+                            }
+                        }
+                        // Check if this is an Office document file
+                        if (this.isOfficeFile(fullPath)) {
+                            const docContent = await readOfficeDocument(fullPath);
+                            if (docContent) {
+                                // Add text description first
+                                multimodalContent.push({
+                                    type: 'text',
+                                    text: `📄 ${docContent.fileType.toUpperCase()} Document: ${file}`,
+                                });
+                                // Add document content
+                                multimodalContent.push(docContent);
+                                filesData.push({
+                                    path: file,
+                                    isDocument: true,
+                                    fileType: docContent.fileType,
+                                });
+                                continue;
+                            }
+                        }
                         const content = await fs.readFile(fullPath, 'utf-8');
                         const lines = content.split('\n');
                         const totalLines = lines.length;
@@ -217,10 +313,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);
@@ -245,7 +339,10 @@ export class FilesystemMCPService {
                         if (notebookInfo) {
                             fileContent += notebookInfo;
                         }
-                        allContents.push(fileContent);
+                        multimodalContent.push({
+                            type: 'text',
+                            text: fileContent,
+                        });
                         filesData.push({
                             path: file,
                             startLine: start,
@@ -257,11 +354,14 @@ export class FilesystemMCPService {
                         const errorMsg = error instanceof Error ? error.message : 'Unknown error';
                         // Extract file path for error message
                         const filePath = typeof fileItem === 'string' ? fileItem : fileItem.path;
-                        allContents.push(`❌ ${filePath}: ${errorMsg}`);
+                        multimodalContent.push({
+                            type: 'text',
+                            text: `❌ ${filePath}: ${errorMsg}`,
+                        });
                     }
                 }
                 return {
-                    content: allContents.join('\n\n'),
+                    content: multimodalContent,
                     files: filesData,
                     totalFiles: filePath.length,
                 };
@@ -285,6 +385,41 @@ export class FilesystemMCPService {
                     totalLines: lines.length,
                 };
             }
+            // Check if this is an image file
+            if (this.isImageFile(fullPath)) {
+                const imageContent = await this.readImageAsBase64(fullPath);
+                if (imageContent) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `🖼️  Image: ${filePath} (${imageContent.mimeType})`,
+                            },
+                            imageContent,
+                        ],
+                        isImage: true,
+                        mimeType: imageContent.mimeType,
+                    };
+                }
+            }
+            // Check if this is an Office document file
+            if (this.isOfficeFile(fullPath)) {
+                const docContent = await readOfficeDocument(fullPath);
+                if (docContent) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `📄 ${docContent.fileType.toUpperCase()} Document: ${filePath}`,
+                            },
+                            docContent,
+                        ],
+                        isDocument: true,
+                        fileType: docContent.fileType,
+                    };
+                }
+            }
+            // Text file processing
             const content = await fs.readFile(fullPath, 'utf-8');
             // Parse lines
             const lines = content.split('\n');
@@ -302,10 +437,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 +473,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 +1006,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 +1035,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 +1090,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 +1107,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})`
@@ -1077,7 +1226,7 @@ export const filesystemService = new FilesystemMCPService();
 export const mcpTools = [
     {
         name: 'filesystem-read',
-        description: 'Read file content with line numbers. **Read only when the actual file or folder path is found or provided by the user, do not make random guesses,Search for specific documents or line numbers before reading more accurately** **SUPPORTS MULTIPLE FILES WITH FLEXIBLE LINE RANGES**: Pass either (1) a single file path (string), (2) array of file paths (strings) with unified startLine/endLine, or (3) array of file config objects with per-file line ranges. **INTEGRATED DIRECTORY LISTING**: When filePath is a directory, automatically lists its contents instead of throwing error. ⚠️ **IMPORTANT WORKFLOW**: (1) ALWAYS use ACE search tools FIRST (ace-text_search/ace-search_symbols/ace-file_outline) to locate the relevant code, (2) ONLY use filesystem-read when you know the approximate location and need precise line numbers for editing. **ANTI-PATTERN**: Reading files line-by-line from the top wastes tokens - use search instead! **USAGE**: Call without parameters to read entire file(s), or specify startLine/endLine for partial reads. Returns content with line numbers (format: "123→code") for precise editing. **EXAMPLES**: (A) Unified: filePath=["a.ts", "b.ts"], startLine=1, endLine=500 reads lines 1-500 from both. (B) Per-file: filePath=[{path:"a.ts", startLine:1, endLine:300}, {path:"b.ts", startLine:100, endLine:550}] reads different ranges from each file. (C) Directory: filePath="./src" returns list of files in src/.',
+        description: 'Read file content with line numbers and multimodal support (text + images + Office documents). **MULTIMODAL SUPPORT**: Automatically detects and processes: (1) Image files (.png, .jpg, .jpeg, .gif, .webp, .bmp, .svg) - returns base64-encoded image data, (2) Office documents (.pdf, .docx, .doc, .xlsx, .xls, .pptx, .ppt) - extracts and returns readable text content. All returned in MCP content format for AI analysis. **Read only when the actual file or folder path is found or provided by the user, do not make random guesses,Search for specific documents or line numbers before reading more accurately** **SUPPORTS MULTIPLE FILES WITH FLEXIBLE LINE RANGES**: Pass either (1) a single file path (string), (2) array of file paths (strings) with unified startLine/endLine, or (3) array of file config objects with per-file line ranges. **INTEGRATED DIRECTORY LISTING**: When filePath is a directory, automatically lists its contents instead of throwing error. ⚠️ **IMPORTANT WORKFLOW**: (1) ALWAYS use ACE search tools FIRST (ace-text_search/ace-search_symbols/ace-file_outline) to locate the relevant code, (2) ONLY use filesystem-read when you know the approximate location and need precise line numbers for editing. **ANTI-PATTERN**: Reading files line-by-line from the top wastes tokens - use search instead! **USAGE**: Call without parameters to read entire file(s), or specify startLine/endLine for partial reads. Returns content with line numbers (format: "123→code") for text files or multimodal content array for images/documents. **EXAMPLES**: (A) Unified: filePath=["a.ts", "b.ts"], startLine=1, endLine=500 reads lines 1-500 from both. (B) Per-file: filePath=[{path:"a.ts", startLine:1, endLine:300}, {path:"b.ts", startLine:100, endLine:550}] reads different ranges from each file. (C) Directory: filePath="./src" returns list of files in src/. (D) Image: filePath="screenshot.png" returns multimodal content with base64 image data. (E) Office: filePath="report.pdf" or "data.xlsx" extracts and returns document text.',
         inputSchema: {
             type: 'object',
             properties: {

package/dist/mcp/types/filesystem.types.d.ts

@@ -2,6 +2,51 @@
  * Type definitions for Filesystem MCP Service
  */
 import type { Diagnostic } from '../../utils/vscodeConnection.js';
+/**
+ * MCP Content Types - supports multimodal content
+ */
+export type MCPContentType = 'text' | 'image' | 'document';
+/**
+ * Text content block
+ */
+export interface TextContent {
+    type: 'text';
+    text: string;
+}
+/**
+ * Image content block (base64 encoded)
+ */
+export interface ImageContent {
+    type: 'image';
+    data: string;
+    mimeType: string;
+}
+/**
+ * Document content block (for Office files like PDF, Word, Excel, PPT)
+ */
+export interface DocumentContent {
+    type: 'document';
+    text: string;
+    fileType: 'pdf' | 'word' | 'excel' | 'powerpoint';
+    metadata?: {
+        pages?: number;
+        sheets?: string[];
+        slides?: number;
+        [key: string]: unknown;
+    };
+}
+/**
+ * Multimodal content - array of text, image, and document blocks
+ */
+export type MultimodalContent = Array<TextContent | ImageContent | DocumentContent>;
+/**
+ * Supported image MIME types
+ */
+export declare const IMAGE_MIME_TYPES: Record<string, string>;
+/**
+ * Supported Office document types
+ */
+export declare const OFFICE_FILE_TYPES: Record<string, 'pdf' | 'word' | 'excel' | 'powerpoint'>;
 /**
  * Structure analysis result for code validation
  */
@@ -51,6 +96,36 @@ export interface FileReadConfig {
     startLine?: number;
     endLine?: number;
 }
+/**
+ * Single file read result
+ */
+export interface SingleFileReadResult {
+    content: string | MultimodalContent;
+    startLine?: number;
+    endLine?: number;
+    totalLines?: number;
+    isImage?: boolean;
+    isDocument?: boolean;
+    fileType?: 'pdf' | 'word' | 'excel' | 'powerpoint';
+    mimeType?: string;
+}
+/**
+ * Multiple files read result
+ */
+export interface MultipleFilesReadResult {
+    content: string | MultimodalContent;
+    files: Array<{
+        path: string;
+        startLine?: number;
+        endLine?: number;
+        totalLines?: number;
+        isImage?: boolean;
+        isDocument?: boolean;
+        fileType?: 'pdf' | 'word' | 'excel' | 'powerpoint';
+        mimeType?: string;
+    }>;
+    totalFiles: number;
+}
 /**
  * Edit by search configuration
  */