snow-ai 0.4.15 → 0.4.17

package/dist/mcp/filesystem.d.ts

@@ -1,392 +0,0 @@
-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
- */
-export declare class FilesystemMCPService {
-    private basePath;
-    /**
-     * File extensions supported by Prettier for automatic formatting
-     */
-    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
-     * @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 notebook entries for a file
-     * @param filePath - Path to the file
-     * @returns Formatted notebook entries string, or empty if none found
-     */
-    private getNotebookEntries;
-    /**
-     * 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 (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<SingleFileReadResult | MultipleFilesReadResult>;
-    /**
-     * Create a new file with specified content
-     * @param filePath - Path where the file should be created
-     * @param content - Content to write to the file
-     * @param createDirectories - Whether to create parent directories if they don't exist
-     * @returns Success message
-     * @throws Error if file creation fails
-     */
-    createFile(filePath: string, content: string, createDirectories?: boolean): Promise<string>;
-    /**
-     * List files in a directory (internal use for read tool)
-     * @param dirPath - Directory path relative to base path or absolute path
-     * @returns Array of file names
-     * @throws Error if directory cannot be read
-     * @private
-     */
-    private listFiles;
-    /**
-     * Check if a file or directory exists
-     * @param filePath - Path to check
-     * @returns Boolean indicating existence
-     */
-    exists(filePath: string): Promise<boolean>;
-    /**
-     * Get file information (stats)
-     * @param filePath - Path to the file
-     * @returns File stats object
-     * @throws Error if file doesn't exist
-     */
-    getFileInfo(filePath: string): Promise<{
-        size: number;
-        isFile: boolean;
-        isDirectory: boolean;
-        modified: Date;
-        created: Date;
-    }>;
-    /**
-     * Edit file(s) by searching for exact content and replacing it
-     * This method uses SMART MATCHING to handle whitespace differences automatically.
-     *
-     * @param filePath - Path to the file to edit, or array of file paths, or array of edit config objects
-     * @param searchContent - Content to search for (for single file or unified mode)
-     * @param replaceContent - New content to replace (for single file or unified mode)
-     * @param occurrence - Which occurrence to replace (1-indexed, default: 1, use -1 for all)
-     * @param contextLines - Number of context lines to return before and after the edit (default: 8)
-     * @returns Object containing success message, before/after comparison, and diagnostics from IDE (VSCode or JetBrains)
-     * @throws Error if search content is not found or multiple matches exist
-     */
-    editFileBySearch(filePath: string | string[] | EditBySearchConfig[], searchContent?: string, replaceContent?: string, occurrence?: number, contextLines?: number): Promise<EditBySearchResult>;
-    /**
-     * Internal method: Edit a single file by search-replace
-     * @private
-     */
-    private editFileBySearchSingle;
-    /**
-     * Edit file(s) by replacing lines within a specified range
-     * BEST PRACTICE: Keep edits small and focused (≤15 lines recommended) for better accuracy.
-     * For larger changes, make multiple parallel edits to non-overlapping sections instead of one large edit.
-     *
-     * @param filePath - Path to the file to edit, or array of file paths, or array of edit config objects
-     * @param startLine - Starting line number (for single file or unified mode)
-     * @param endLine - Ending line number (for single file or unified mode)
-     * @param newContent - New content to replace (for single file or unified mode)
-     * @param contextLines - Number of context lines to return before and after the edit (default: 8)
-     * @returns Object containing success message, precise before/after comparison, and diagnostics from IDE (VSCode or JetBrains)
-     * @throws Error if file editing fails
-     */
-    editFile(filePath: string | string[] | EditByLineConfig[], startLine?: number, endLine?: number, newContent?: string, contextLines?: number): Promise<EditByLineResult>;
-    /**
-     * Internal method: Edit a single file by line range
-     * @private
-     */
-    private editFileSingle;
-    /**
-     * Resolve path relative to base path and normalize it
-     * @private
-     */
-    private resolvePath;
-    /**
-     * Validate that the path is within the allowed base directory
-     * @private
-     */
-    private validatePath;
-}
-export declare const filesystemService: FilesystemMCPService;
-export declare const mcpTools: ({
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            filePath: {
-                oneOf: ({
-                    type: string;
-                    description: string;
-                    items?: undefined;
-                } | {
-                    type: string;
-                    items: {
-                        type: string;
-                        properties?: undefined;
-                        required?: undefined;
-                    };
-                    description: string;
-                } | {
-                    type: string;
-                    items: {
-                        type: string;
-                        properties: {
-                            path: {
-                                type: string;
-                                description: string;
-                            };
-                            startLine: {
-                                type: string;
-                                description: string;
-                            };
-                            endLine: {
-                                type: string;
-                                description: string;
-                            };
-                        };
-                        required: string[];
-                    };
-                    description: string;
-                })[];
-                description: string;
-                type?: undefined;
-            };
-            startLine: {
-                type: string;
-                description: string;
-            };
-            endLine: {
-                type: string;
-                description: string;
-            };
-            content?: undefined;
-            createDirectories?: undefined;
-            searchContent?: undefined;
-            replaceContent?: undefined;
-            occurrence?: undefined;
-            contextLines?: undefined;
-            newContent?: undefined;
-        };
-        required: string[];
-    };
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            filePath: {
-                type: string;
-                description: string;
-                oneOf?: undefined;
-            };
-            content: {
-                type: string;
-                description: string;
-            };
-            createDirectories: {
-                type: string;
-                description: string;
-                default: boolean;
-            };
-            startLine?: undefined;
-            endLine?: undefined;
-            searchContent?: undefined;
-            replaceContent?: undefined;
-            occurrence?: undefined;
-            contextLines?: undefined;
-            newContent?: undefined;
-        };
-        required: string[];
-    };
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            filePath: {
-                oneOf: ({
-                    type: string;
-                    description: string;
-                    items?: undefined;
-                } | {
-                    type: string;
-                    items: {
-                        type: string;
-                        properties?: undefined;
-                        required?: undefined;
-                    };
-                    description: string;
-                } | {
-                    type: string;
-                    items: {
-                        type: string;
-                        properties: {
-                            path: {
-                                type: string;
-                                description: string;
-                            };
-                            searchContent: {
-                                type: string;
-                                description: string;
-                            };
-                            replaceContent: {
-                                type: string;
-                                description: string;
-                            };
-                            occurrence: {
-                                type: string;
-                                description: string;
-                            };
-                        };
-                        required: string[];
-                    };
-                    description: string;
-                })[];
-                description: string;
-                type?: undefined;
-            };
-            searchContent: {
-                type: string;
-                description: string;
-            };
-            replaceContent: {
-                type: string;
-                description: string;
-            };
-            occurrence: {
-                type: string;
-                description: string;
-                default: number;
-            };
-            contextLines: {
-                type: string;
-                description: string;
-                default: number;
-            };
-            startLine?: undefined;
-            endLine?: undefined;
-            content?: undefined;
-            createDirectories?: undefined;
-            newContent?: undefined;
-        };
-        required: string[];
-    };
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            filePath: {
-                oneOf: ({
-                    type: string;
-                    description: string;
-                    items?: undefined;
-                } | {
-                    type: string;
-                    items: {
-                        type: string;
-                        properties?: undefined;
-                        required?: undefined;
-                    };
-                    description: string;
-                } | {
-                    type: string;
-                    items: {
-                        type: string;
-                        properties: {
-                            path: {
-                                type: string;
-                                description: string;
-                            };
-                            startLine: {
-                                type: string;
-                                description: string;
-                            };
-                            endLine: {
-                                type: string;
-                                description: string;
-                            };
-                            newContent: {
-                                type: string;
-                                description: string;
-                            };
-                        };
-                        required: string[];
-                    };
-                    description: string;
-                })[];
-                description: string;
-                type?: undefined;
-            };
-            startLine: {
-                type: string;
-                description: string;
-            };
-            endLine: {
-                type: string;
-                description: string;
-            };
-            newContent: {
-                type: string;
-                description: string;
-            };
-            contextLines: {
-                type: string;
-                description: string;
-                default: number;
-            };
-            content?: undefined;
-            createDirectories?: undefined;
-            searchContent?: undefined;
-            replaceContent?: undefined;
-            occurrence?: undefined;
-        };
-        required: string[];
-    };
-})[];