@compass-ai/nova 1.0.73 → 1.0.74

package/dist/tools/search-tools.js

@@ -0,0 +1,357 @@
+/**
+ * Search and code analysis tools
+ *
+ * Tools for searching code, analyzing dependencies, and finding files.
+ */
+import { ActionType } from '../services/action-logger.js';
+import { formatBytes } from './shared-utils.js';
+import { logger } from '../utils/logger.js';
+import { getFileService } from '../services/file-service.js';
+import { pathExists } from '../utils/file-system.js';
+import { loadIgnorePatterns } from '../utils/ignore-patterns.js';
+import path from 'path';
+export function registerSearchTools(registry) {
+    registry.registerTool('search_code', 'Searches for code patterns or text across the codebase using regex patterns. Case-INSENSITIVE by default — never make multiple searches with different casings of the same term; one search is enough. Use this to find specific functions, classes, or code patterns.', {
+        type: 'object',
+        properties: {
+            pattern: {
+                type: 'string',
+                description: 'Regex pattern to search for',
+            },
+            path: {
+                type: 'string',
+                description: 'File or directory path to search in (relative to project root). If a file, searches only that file. If a directory, searches files within it. If omitted, searches the entire project.',
+            },
+            filePattern: {
+                type: 'string',
+                description: 'Glob pattern to filter which files to search (e.g., "*.ts", "src/**/*.js")',
+            },
+            caseSensitive: {
+                type: 'boolean',
+                description: 'Whether the search should be case-sensitive. Defaults to false (case-insensitive)',
+                default: false,
+            },
+            maxFileSizeMB: {
+                type: 'number',
+                description: 'Maximum file size in MB to search (default: 5). Files larger than this are skipped to prevent memory issues.',
+                default: 5,
+            },
+        },
+        required: ['pattern'],
+    }, async (input, context) => {
+        const { glob } = await import('glob');
+        const fs = await import('fs/promises');
+        const filePattern = input.filePattern || '**/*.{js,ts,jsx,tsx,py,java,go,rb}';
+        // Validate regex pattern to prevent ReDoS attacks
+        let searchPattern;
+        try {
+            // Don't use 'g' flag with .test() - it's stateful and causes intermittent match failures
+            searchPattern = input.caseSensitive
+                ? new RegExp(input.pattern)
+                : new RegExp(input.pattern, 'i');
+        }
+        catch (error) {
+            throw new Error(`Invalid regex pattern: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+        // If a specific path is provided, resolve it and check if it's a file or directory
+        let files;
+        if (input.path) {
+            const resolvedPath = path.resolve(context.projectRoot, input.path);
+            const fs2 = await import('fs/promises');
+            const exists = await pathExists(resolvedPath);
+            if (!exists) {
+                throw new Error(`Path not found: ${input.path}. ` +
+                    `The file or directory may not exist or the path might be incorrect.`);
+            }
+            const stats = await fs2.stat(resolvedPath);
+            if (stats.isFile()) {
+                // Search only this single file
+                files = [resolvedPath];
+            }
+            else {
+                // Search within this directory
+                const ignorePatterns = await loadIgnorePatterns(context.projectRoot);
+                files = await glob(filePattern, {
+                    cwd: resolvedPath,
+                    absolute: true,
+                    dot: true,
+                    ignore: ignorePatterns,
+                });
+            }
+        }
+        else {
+            // Load ignore patterns from .gitignore files (including nested ones)
+            const ignorePatterns = await loadIgnorePatterns(context.projectRoot);
+            files = await glob(filePattern, {
+                cwd: context.projectRoot,
+                absolute: true,
+                dot: true,
+                ignore: ignorePatterns,
+            });
+        }
+        const matches = [];
+        // Configurable maximum file size (default 5MB) to prevent memory issues
+        const maxFileSizeMB = input.maxFileSizeMB ?? 5;
+        const MAX_FILE_SIZE = maxFileSizeMB * 1024 * 1024;
+        const skippedFiles = [];
+        for (const file of files) {
+            try {
+                // Check file size before reading to prevent memory issues
+                const stats = await fs.stat(file);
+                if (stats.size > MAX_FILE_SIZE) {
+                    const relativePath = path.relative(context.projectRoot, file);
+                    const sizeMB = Math.round((stats.size / (1024 * 1024)) * 100) / 100;
+                    skippedFiles.push({ file: relativePath, sizeMB });
+                    logger.debug(`Skipping large file (${sizeMB}MB): ${relativePath}`);
+                    continue;
+                }
+                const content = await fs.readFile(file, 'utf-8');
+                const lines = content.split('\n');
+                lines.forEach((line, index) => {
+                    if (searchPattern.test(line)) {
+                        matches.push({
+                            file: path.relative(context.projectRoot, file),
+                            line: index + 1,
+                            content: line.trim(),
+                        });
+                    }
+                });
+            }
+            catch (error) {
+                // Skip files that can't be read
+                logger.debug(`Failed to read file for search: ${file}`);
+            }
+        }
+        // Build response with warning if files were skipped
+        const response = {
+            pattern: input.pattern,
+            filePattern: input.filePattern,
+            matchCount: matches.length,
+            matches: matches.slice(0, 100), // Limit to first 100 matches
+            truncated: matches.length > 100,
+        };
+        // Include skipped files info if any were skipped
+        if (skippedFiles.length > 0) {
+            response.skippedLargeFiles = {
+                count: skippedFiles.length,
+                files: skippedFiles,
+                warning: `${skippedFiles.length} file(s) exceeded the ${maxFileSizeMB}MB size limit and were not searched. Use maxFileSizeMB parameter to increase the limit if needed.`,
+            };
+        }
+        return response;
+    }, {
+        actionType: ActionType.CODE_ANALYSIS,
+        requiresApproval: false,
+        category: 'code_analysis',
+        tags: ['search', 'grep', 'find'],
+        displayName: 'Search',
+    });
+    registry.registerTool('analyze_dependencies', 'Analyzes project dependencies by reading package.json, requirements.txt, or similar files.', {
+        type: 'object',
+        properties: {
+            type: {
+                type: 'string',
+                enum: ['npm', 'python', 'auto'],
+                description: 'Type of dependency file to analyze (auto-detects if not specified)',
+                default: 'auto',
+            },
+        },
+        required: [],
+    }, async (input, context) => {
+        const dependencyFiles = [
+            { type: 'npm', file: 'package.json' },
+            { type: 'python', file: 'requirements.txt' },
+            { type: 'python', file: 'Pipfile' },
+        ];
+        const results = [];
+        for (const { type, file } of dependencyFiles) {
+            if (input.type !== 'auto' && input.type !== type) {
+                continue;
+            }
+            const filePath = path.join(context.projectRoot, file);
+            const exists = await pathExists(filePath);
+            if (exists) {
+                try {
+                    const fileService = getFileService();
+                    if (file === 'package.json') {
+                        const content = await fileService.readJsonFile(filePath);
+                        results.push({
+                            type,
+                            file,
+                            dependencies: {
+                                ...(content?.dependencies || {}),
+                                ...(content?.devDependencies || {}),
+                            },
+                        });
+                    }
+                    else if (file.endsWith('.txt') || file === 'Pipfile') {
+                        const content = await fileService.readFile(filePath) || '';
+                        const deps = {};
+                        content.split('\n').forEach((line) => {
+                            const match = line.match(/^([a-zA-Z0-9_-]+)([=<>]=?)(.+)$/);
+                            if (match) {
+                                deps[match[1]] = match[3];
+                            }
+                        });
+                        results.push({ type, file, dependencies: deps });
+                    }
+                }
+                catch (error) {
+                    logger.debug(`Failed to analyze ${file}`, error);
+                }
+            }
+        }
+        return {
+            found: results.length > 0,
+            results,
+            totalDependencies: results.reduce((sum, r) => sum + Object.keys(r.dependencies).length, 0),
+        };
+    }, {
+        actionType: ActionType.CODE_ANALYSIS,
+        requiresApproval: false,
+        category: 'code_analysis',
+        tags: ['dependencies', 'packages', 'analyze'],
+        displayName: 'Dependencies',
+    });
+    registry.registerTool('find_files', 'Finds files by name pattern across the project. Use glob patterns like "*.ts" or "**/*test*.js".', {
+        type: 'object',
+        properties: {
+            pattern: {
+                type: 'string',
+                description: 'Glob pattern to match file names (e.g., "**/*.ts", "**/user*.js", "src/**/*.tsx")',
+            },
+            excludePatterns: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Glob patterns to exclude (e.g., ["**/test/**", "**/*.spec.ts"]). Defaults to node_modules, .git, dist, build.',
+            },
+            maxResults: {
+                type: 'number',
+                description: 'Maximum number of results to return (default: 50)',
+                default: 50,
+            },
+        },
+        required: ['pattern'],
+    }, async (input, context) => {
+        const { glob } = await import('glob');
+        // Load ignore patterns from .gitignore files (including nested ones) if no custom excludes provided
+        const defaultExcludes = await loadIgnorePatterns(context.projectRoot);
+        const excludePatterns = input.excludePatterns || defaultExcludes;
+        const files = await glob(input.pattern, {
+            cwd: context.projectRoot,
+            absolute: false,
+            dot: true,
+            ignore: excludePatterns,
+        });
+        const maxResults = input.maxResults || 50;
+        const truncated = files.length > maxResults;
+        return {
+            pattern: input.pattern,
+            excludePatterns,
+            files: files.slice(0, maxResults),
+            totalFound: files.length,
+            truncated,
+        };
+    }, {
+        actionType: ActionType.SEARCH,
+        requiresApproval: false,
+        category: 'file_operations',
+        tags: ['search', 'find', 'glob'],
+        displayName: 'Find',
+    });
+    registry.registerTool('get_file_info', 'Gets detailed metadata about a file or directory including size, timestamps, type, and permissions.', {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'Path to the file or directory',
+            },
+        },
+        required: ['path'],
+    }, async (input, context) => {
+        const fs = await import('fs/promises');
+        const filePath = path.resolve(context.projectRoot, input.path);
+        const exists = await pathExists(filePath);
+        if (!exists) {
+            throw new Error(`File not found: ${input.path}. ` +
+                `The file may not exist or the path might be incorrect. ` +
+                `Consider using find_files to search for the file first.`);
+        }
+        const stats = await fs.stat(filePath);
+        const ext = path.extname(filePath);
+        // Convert mode to permission string (e.g., "rwxr-xr-x")
+        const formatPermissions = (mode) => {
+            const perms = ['---', '--x', '-w-', '-wx', 'r--', 'r-x', 'rw-', 'rwx'];
+            const owner = perms[(mode >> 6) & 7];
+            const group = perms[(mode >> 3) & 7];
+            const others = perms[mode & 7];
+            return owner + group + others;
+        };
+        return {
+            path: input.path,
+            size: stats.size,
+            sizeHuman: formatBytes(stats.size),
+            isFile: stats.isFile(),
+            isDirectory: stats.isDirectory(),
+            isSymbolicLink: stats.isSymbolicLink(),
+            extension: ext || undefined,
+            type: stats.isFile() ? 'file' : stats.isDirectory() ? 'directory' : 'other',
+            permissions: formatPermissions(stats.mode),
+            mode: stats.mode.toString(8).slice(-3),
+            modified: stats.mtime.toISOString(),
+            created: stats.birthtime.toISOString(),
+            accessed: stats.atime.toISOString(),
+        };
+    }, {
+        actionType: ActionType.SEARCH,
+        requiresApproval: false,
+        category: 'file_operations',
+        tags: ['info', 'metadata', 'stat'],
+        displayName: 'File',
+    });
+    registry.registerTool('read_multiple_files', 'Reads multiple files at once. More efficient than calling read_file multiple times.', {
+        type: 'object',
+        properties: {
+            paths: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Array of file paths to read',
+            },
+        },
+        required: ['paths'],
+    }, async (input, context) => {
+        const fileService = getFileService();
+        const results = [];
+        for (const filePath of input.paths) {
+            const absolutePath = path.resolve(context.projectRoot, filePath);
+            const exists = await pathExists(absolutePath);
+            if (!exists) {
+                results.push({ path: filePath, content: null, error: 'File not found' });
+                continue;
+            }
+            try {
+                const content = await fileService.readFile(absolutePath);
+                results.push({ path: filePath, content: content || '' });
+            }
+            catch (error) {
+                results.push({
+                    path: filePath,
+                    content: null,
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                });
+            }
+        }
+        return {
+            files: results,
+            successCount: results.filter((r) => r.content !== null).length,
+            errorCount: results.filter((r) => r.content === null).length,
+        };
+    }, {
+        actionType: ActionType.FILE_READ,
+        requiresApproval: false,
+        category: 'file_operations',
+        tags: ['io', 'read', 'batch'],
+        displayName: 'Read Multiple',
+    });
+}
+//# sourceMappingURL=search-tools.js.map

package/dist/tools/search-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-tools.js","sourceRoot":"","sources":["../../src/tools/search-tools.ts"],"names":[],"mappings":"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"}

package/dist/tools/shared-utils.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Shared utilities for all built-in tools
+ *
+ * This module contains common helper functions, constants, and patterns used
+ * across multiple tool modules. Extracted from the original monolithic built-in-tools.ts
+ * for better maintainability and code sharing.
+ */
+/**
+ * Normalizes whitespace in text for more flexible matching.
+ * - Converts Windows CRLF to Unix LF
+ * - Removes trailing whitespace from each line
+ */
+export declare function normalizeWhitespace(text: string): string;
+/**
+ * Finds similar text in content when exact match fails.
+ * Returns up to 3 potential matches with their line numbers.
+ */
+export declare function findSimilarText(content: string, searchText: string, maxSuggestions?: number): Array<{
+    lineNumber: number;
+    preview: string;
+    similarity: number;
+}>;
+/**
+ * Attempts to find text with normalized whitespace matching.
+ * Returns the actual text from the content that matches (for proper replacement).
+ */
+export declare function findWithNormalizedWhitespace(content: string, searchText: string): {
+    found: boolean;
+    actualText?: string;
+    occurrences: number;
+};
+/**
+ * Checks if a file path matches any blocklist pattern.
+ * These are files that shouldn't be read by tools due to size or lack of usefulness.
+ *
+ * @param filePath - The file path to check (relative or absolute)
+ * @returns Object with blocked status and reason
+ */
+export declare function isBlocklistedFile(filePath: string): {
+    blocked: boolean;
+    reason?: string;
+};
+/**
+ * Truncates content and returns metadata about the truncation.
+ *
+ * @param content - The content to potentially truncate
+ * @param maxTokens - Maximum tokens allowed
+ * @param contentType - Type of content for the truncation message
+ * @returns Object with truncated content and metadata
+ */
+export declare function truncateToolResult(content: string, maxTokens: number, contentType: string): {
+    content: string;
+    wasTruncated: boolean;
+    originalTokens: number;
+    truncatedTokens: number;
+};
+/**
+ * Build command patterns to detect build-related commands
+ */
+export declare const BUILD_COMMAND_PATTERNS: RegExp[];
+/**
+ * Patterns that indicate errors or warnings in build output
+ */
+export declare const BUILD_ERROR_PATTERNS: RegExp[];
+/**
+ * Patterns that indicate verbose/noisy success output that can be discarded
+ */
+export declare const VERBOSE_SUCCESS_PATTERNS: RegExp[];
+/**
+ * Checks if a command is a build command
+ */
+export declare function isBuildCommand(command: string): boolean;
+/**
+ * Smart truncation for build output - prioritizes errors/warnings
+ * @param stdout - Standard output from build
+ * @param stderr - Standard error from build
+ * @param command - The command that was executed
+ * @param maxTotalTokens - Maximum total tokens for combined output
+ * @returns Optimized output with errors prioritized
+ */
+export declare function smartTruncateBuildOutput(stdout: string, stderr: string, command: string, maxTotalTokens: number): {
+    stdout: string;
+    stderr: string;
+    wasTruncated: boolean;
+    strategy: 'smart_build' | 'standard';
+};
+/**
+ * Formats bytes into human-readable format (B, KB, MB, GB)
+ */
+export declare function formatBytes(bytes: number): string;
+//# sourceMappingURL=shared-utils.d.ts.map

package/dist/tools/shared-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-utils.d.ts","sourceRoot":"","sources":["../../src/tools/shared-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOxD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,GAAE,MAAU,GAAG,KAAK,CAAC;IACtG,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CA0CD;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG;IACjF,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CA2CA;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CA4DzF;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAqB7F;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,UAoBlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,UAsBhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,UAYpC,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,GACrB;IACD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,aAAa,GAAG,UAAU,CAAC;CACtC,CA8HA;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMjD"}