snow-ai 0.2.25 → 0.2.27

package/dist/mcp/filesystem.d.ts

@@ -46,12 +46,18 @@ export declare class FilesystemMCPService {
      */
     private calculateSimilarity;
     /**
-     * Calculate Levenshtein distance between two strings
+     * Calculate Levenshtein distance between two strings with early termination
+     * @param str1 First string
+     * @param str2 Second string
+     * @param maxDistance Maximum distance to compute (early exit if exceeded)
+     * @returns Levenshtein distance, or maxDistance+1 if exceeded
      */
     private levenshteinDistance;
     /**
      * Find the closest matching candidates in the file content
      * Returns top N candidates sorted by similarity
+     * Optimized with safe pre-filtering and early exit
+     * ASYNC to prevent terminal freeze during search
      */
     private findClosestMatches;
     /**
@@ -71,17 +77,26 @@ export declare class FilesystemMCPService {
     private findSmartContextBoundaries;
     /**
      * Get the content of a file with optional line range
-     * @param filePath - Path to the file (relative to base path or absolute)
+     * @param filePath - Path to the file (relative to base path or absolute) or array of file paths
      * @param startLine - Starting line number (1-indexed, inclusive, optional - defaults to 1)
      * @param endLine - Ending line number (1-indexed, inclusive, optional - defaults to 500 or file end)
      * @returns Object containing the requested content with line numbers and metadata
      * @throws Error if file doesn't exist or cannot be read
      */
-    getFileContent(filePath: string, startLine?: number, endLine?: number): Promise<{
+    getFileContent(filePath: string | string[], 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;
     }>;
     /**
      * Create a new file with specified content
@@ -134,7 +149,7 @@ export declare class FilesystemMCPService {
      * @param replaceContent - New content to replace the search content with
      * @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
+     * @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, searchContent: string, replaceContent: string, occurrence?: number, contextLines?: number): Promise<{
@@ -162,7 +177,7 @@ export declare class FilesystemMCPService {
      * @param endLine - Ending line number (1-indexed, inclusive) - get from filesystem_read output
      * @param newContent - New content to replace the specified lines (WITHOUT line numbers)
      * @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
+     * @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, startLine: number, endLine: number, newContent: string, contextLines?: number): Promise<{
@@ -189,29 +204,6 @@ export declare class FilesystemMCPService {
     private validatePath;
 }
 export declare const filesystemService: FilesystemMCPService;
-/**
- * MCP Tool definitions for integration
- *
- * 🎯 **RECOMMENDED WORKFLOW FOR AI AGENTS**:
- *
- * 1️⃣ **SEARCH FIRST** (DON'T skip this!):
- *    - Use ace_text_search() to find code patterns/strings
- *    - Use ace_search_symbols() to find functions/classes by name
- *    - Use ace_file_outline() to understand file structure
- *
- * 2️⃣ **READ STRATEGICALLY** (Only after search):
- *    - Use filesystem_read() WITHOUT line numbers to read entire file
- *    - OR use filesystem_read(filePath, startLine, endLine) to read specific range
- *    - ⚠️ AVOID reading files line-by-line from top - wastes tokens!
- *
- * 3️⃣ **EDIT SAFELY**:
- *    - PREFER filesystem_edit_search() for modifying existing code (no line counting!)
- *    - Use filesystem_edit() only for adding new code or when search-replace doesn't fit
- *
- * 📊 **TOKEN EFFICIENCY**:
- *    - ❌ BAD: Read file top-to-bottom, repeat reading, blind scanning
- *    - ✅ GOOD: Search → Targeted read → Edit with context
- */
 export declare const mcpTools: ({
     name: string;
     description: string;
@@ -219,8 +211,19 @@ export declare const mcpTools: ({
         type: string;
         properties: {
             filePath: {
-                type: string;
+                oneOf: ({
+                    type: string;
+                    description: string;
+                    items?: undefined;
+                } | {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                })[];
                 description: string;
+                type?: undefined;
             };
             startLine: {
                 type: string;
@@ -251,6 +254,7 @@ export declare const mcpTools: ({
             filePath: {
                 type: string;
                 description: string;
+                oneOf?: undefined;
             };
             content: {
                 type: string;
@@ -282,6 +286,7 @@ export declare const mcpTools: ({
             filePath: {
                 type: string;
                 description: string;
+                oneOf?: undefined;
             };
             filePaths: {
                 oneOf: ({
@@ -344,6 +349,7 @@ export declare const mcpTools: ({
             filePath: {
                 type: string;
                 description: string;
+                oneOf?: undefined;
             };
             searchContent: {
                 type: string;
@@ -382,6 +388,7 @@ export declare const mcpTools: ({
             filePath: {
                 type: string;
                 description: string;
+                oneOf?: undefined;
             };
             startLine: {
                 type: string;