@nexus-cortex/executors 4.26.0

package/dist/implementations/search/GlobTool.js

@@ -0,0 +1,213 @@
+/**
+ * Glob Tool Executor
+ *
+ * Finds files matching glob patterns with modification time sorting.
+ * Fast pattern-based file discovery for large codebases.
+ *
+ * Adapted and simplified from Gemini CLI patterns
+ * - Removed: FileDiscovery service, git-ignore filtering
+ * - Kept: Core glob matching, modification time sorting, security
+ */
+import fs from 'fs';
+import path from 'path';
+import { glob } from 'glob';
+import { BaseTool } from '../../base/index.js';
+import { SchemaValidator } from '../../utils/SchemaValidator.js';
+import { makeRelative, shortenPath, } from '../../utils/FileUtils.js';
+/**
+ * Glob Tool Executor
+ *
+ * Features:
+ * - Fast pattern matching (e.g., star-star-slash-star.ts, src-star-star-slash-star.js)
+ * - Sorts results by modification time (newest first)
+ * - Then alphabetically for older files
+ * - Excludes node_modules and .git by default
+ * - Path normalization and security
+ */
+export class GlobTool extends BaseTool {
+    config;
+    // Recency threshold: 24 hours
+    RECENCY_THRESHOLD_MS = 24 * 60 * 60 * 1000;
+    // Default max results to prevent context overflow
+    static DEFAULT_MAX_RESULTS = 100;
+    constructor(config) {
+        super('Glob', 'FindFiles', `Efficiently finds files matching specific glob patterns (e.g., \`src/**/*.ts\`, \`**/*.md\`), returning absolute paths sorted by modification time (newest first). Ideal for quickly locating files based on their name or path structure, especially in large codebases.`, {
+            type: 'object',
+            properties: {
+                pattern: {
+                    type: 'string',
+                    description: "The glob pattern to match against (e.g., '**/*.py', 'docs/*.md'). Supports wildcards: * (matches any chars), ** (matches directories recursively), ? (matches single char), [...] (character ranges).",
+                },
+                path: {
+                    type: 'string',
+                    description: 'Optional: The directory to search within. Can be absolute or relative to working directory. If omitted, searches the working directory.',
+                },
+                case_sensitive: {
+                    type: 'boolean',
+                    description: 'Optional: Whether the search should be case-sensitive. Defaults to false (case-insensitive).',
+                },
+            },
+            required: ['pattern'],
+        });
+        this.config = config;
+    }
+    validateToolParams(params) {
+        // Schema validation
+        const schemaError = SchemaValidator.validate(this.parameterSchema, params);
+        if (schemaError) {
+            return schemaError;
+        }
+        // Validate pattern
+        if (!params.pattern || typeof params.pattern !== 'string' || params.pattern.trim() === '') {
+            return "The 'pattern' parameter cannot be empty.";
+        }
+        // Resolve search directory
+        const searchDirAbsolute = path.resolve(this.config.workingDirectory, params.path || '.');
+        // Path validation: allow any absolute path (matching standard absolute-path behavior),
+        // but reject root "/" to prevent full-filesystem scans that hang tool execution.
+        if (!path.isAbsolute(searchDirAbsolute)) {
+            return `Search path must resolve to an absolute path: ${searchDirAbsolute}`;
+        }
+        if (searchDirAbsolute === '/') {
+            return `Searching from "/" would scan the entire filesystem. Use "." for the project directory or provide a specific path.`;
+        }
+        // Check directory exists
+        try {
+            if (!fs.existsSync(searchDirAbsolute)) {
+                return `Search path does not exist: ${searchDirAbsolute}`;
+            }
+            if (!fs.statSync(searchDirAbsolute).isDirectory()) {
+                return `Search path is not a directory: ${searchDirAbsolute}`;
+            }
+        }
+        catch (error) {
+            return `Error accessing search path: ${error.message}`;
+        }
+        return null;
+    }
+    getDescription(params) {
+        if (!params || !params.pattern) {
+            return 'Find files';
+        }
+        let description = `'${params.pattern}'`;
+        if (params.path) {
+            const searchDir = path.resolve(this.config.workingDirectory, params.path || '.');
+            const relativePath = makeRelative(searchDir, this.config.workingDirectory);
+            description += ` in ${shortenPath(relativePath)}`;
+        }
+        return description;
+    }
+    async execute(params, signal, updateOutput) {
+        const startTime = Date.now();
+        // Validate parameters
+        const validationError = this.validateToolParams(params);
+        if (validationError) {
+            return this.createErrorResult(validationError);
+        }
+        try {
+            const searchDirAbsolute = path.resolve(this.config.workingDirectory, params.path || '.');
+            // Execute glob search
+            const entries = (await glob(params.pattern, {
+                cwd: searchDirAbsolute,
+                withFileTypes: true,
+                nodir: true, // Only files, no directories
+                stat: true, // Include file stats (for mtime)
+                nocase: !(params.case_sensitive ?? true),
+                dot: true, // Include dotfiles
+                ignore: ['**/node_modules/**', '**/.git/**'], // Exclude common directories
+                follow: false, // Don't follow symlinks
+                signal,
+            }));
+            // Check if any files found
+            if (!entries || entries.length === 0) {
+                const message = `No files found matching pattern "${params.pattern}" within ${searchDirAbsolute}.`;
+                return this.createSuccessResult(message, {
+                    executionTime: Date.now() - startTime,
+                    fileCount: 0,
+                });
+            }
+            // Sort files by modification time
+            const sortedEntries = this.sortFilesByRecency(entries);
+            // Apply offset and limit for pagination
+            const offset = params.offset || 0;
+            const maxResults = params.limit === -1 ? Infinity : (params.limit || GlobTool.DEFAULT_MAX_RESULTS);
+            const totalCount = sortedEntries.length;
+            // Apply offset first, then limit
+            const afterOffset = sortedEntries.slice(offset);
+            const limitedEntries = afterOffset.slice(0, maxResults);
+            const hasMore = offset + limitedEntries.length < totalCount;
+            const remainingCount = totalCount - offset - limitedEntries.length;
+            // Get absolute paths
+            const sortedAbsolutePaths = limitedEntries.map((entry) => entry.fullpath());
+            const fileListDescription = sortedAbsolutePaths.join('\n');
+            const fileCount = sortedAbsolutePaths.length;
+            // Format result message with clear pagination guidance for the model
+            let resultMessage;
+            if (offset > 0 || hasMore) {
+                const rangeStart = offset + 1;
+                const rangeEnd = offset + fileCount;
+                resultMessage = `Found ${totalCount} file(s) matching "${params.pattern}" (showing ${rangeStart}-${rangeEnd}):\n${fileListDescription}`;
+                if (hasMore) {
+                    const nextOffset = offset + fileCount;
+                    resultMessage += `\n\n[TRUNCATED] ${remainingCount} more files available. To see next page, call Glob again with offset=${nextOffset}`;
+                }
+            }
+            else {
+                resultMessage = `Found ${fileCount} file(s) matching "${params.pattern}" within ${searchDirAbsolute}, sorted by modification time (newest first):\n${fileListDescription}`;
+            }
+            // Stream output if callback provided
+            if (updateOutput) {
+                updateOutput(`Found ${fileCount} matching file(s)`);
+            }
+            return this.createSuccessResult(resultMessage, {
+                executionTime: Date.now() - startTime,
+                fileCount,
+                totalCount,
+                offset,
+                hasMore,
+                nextOffset: hasMore ? offset + fileCount : undefined,
+                searchPath: searchDirAbsolute,
+                pattern: params.pattern,
+            });
+        }
+        catch (error) {
+            // Handle glob errors
+            if (error.name === 'AbortError') {
+                return this.createErrorResult('Glob search was aborted');
+            }
+            return this.createErrorResult(`Failed to perform glob search: ${error.message}`);
+        }
+    }
+    /**
+     * Sorts file entries based on recency and then alphabetically.
+     * Recent files (modified within 24 hours) are listed first, newest to oldest.
+     * Older files are listed after recent ones, sorted alphabetically by path.
+     * @private
+     */
+    sortFilesByRecency(entries) {
+        const nowTimestamp = Date.now();
+        const sortedEntries = [...entries];
+        sortedEntries.sort((a, b) => {
+            const mtimeA = a.mtimeMs ?? 0;
+            const mtimeB = b.mtimeMs ?? 0;
+            const aIsRecent = nowTimestamp - mtimeA < this.RECENCY_THRESHOLD_MS;
+            const bIsRecent = nowTimestamp - mtimeB < this.RECENCY_THRESHOLD_MS;
+            // Both are recent: sort by mtime (newest first)
+            if (aIsRecent && bIsRecent) {
+                return mtimeB - mtimeA;
+            }
+            // Only A is recent: A comes first
+            if (aIsRecent) {
+                return -1;
+            }
+            // Only B is recent: B comes first
+            if (bIsRecent) {
+                return 1;
+            }
+            // Both are old: sort alphabetically
+            return a.fullpath().localeCompare(b.fullpath());
+        });
+        return sortedEntries;
+    }
+}
+//# sourceMappingURL=GlobTool.js.map

package/dist/implementations/search/GlobTool.js.map

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

package/dist/implementations/search/GrepTool.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Enhanced Grep Tool Executor with Native Command Support
+ *
+ * Implements a 4-tier fallback strategy for optimal performance:
+ * 1. ripgrep (rg)       -  Fastest (0.5-1s)
+ * 2. git grep           - ⚡ Fast (1-2s, git repos only)
+ * 3. system grep        -  Good (2-5s)
+ * 4. JavaScript fallback -  Portable (5-10s)
+ *
+ * Gracefully falls back if native commands are not available.
+ */
+import { BaseTool, type ToolResult } from '../../base/index.js';
+import type { ExecutorConfig } from '../../base/ToolRegistry.js';
+/**
+ * Parameters for the Grep tool
+ * Matches the tool definition in toolDefinitions.ts
+ */
+export interface GrepToolParams {
+    pattern: string;
+    path?: string;
+    glob?: string;
+    output_mode?: 'content' | 'files_with_matches' | 'count';
+    '-A'?: number;
+    '-B'?: number;
+    '-C'?: number;
+    '-n'?: boolean;
+    '-i'?: boolean;
+    type?: string;
+    head_limit?: number;
+    offset?: number;
+    multiline?: boolean;
+    include?: string;
+    case_sensitive?: boolean;
+}
+/**
+ * Enhanced Grep Tool with Native Command Support
+ */
+export declare class GrepTool extends BaseTool<GrepToolParams, ToolResult> {
+    private config;
+    private static readonly DEFAULT_MAX_RESULTS;
+    private static readonly HARD_MAX_RESULTS;
+    private static readonly MAX_CONTENT_LENGTH;
+    private static readonly MAX_SEARCHABLE_FILE_BYTES;
+    constructor(config: ExecutorConfig);
+    validateToolParams(params: GrepToolParams): string | null;
+    getDescription(params: GrepToolParams): string;
+    execute(params: GrepToolParams, signal: AbortSignal, updateOutput?: (output: string) => void): Promise<ToolResult>;
+    /**
+     * Performs grep search using best available strategy
+     *
+     * @param pattern - Regex pattern to search for
+     * @param absolutePath - Directory to search in
+     * @param include - Glob pattern for file filtering
+     * @param caseSensitive - Whether search is case-sensitive
+     * @param signal - Abort signal for cancellation
+     * @param targetFile - Optional: specific filename to search (single-file mode)
+     * @param fileType - Optional: file type filter (rg --type)
+     * @param multiline - Optional: enable multiline matching
+     * @param contextAfter - Optional: lines after match (-A)
+     * @param contextBefore - Optional: lines before match (-B)
+     * @param contextBoth - Optional: lines of context (-C)
+     * @param maxResults - Optional: maximum results (enables -m flag for ripgrep)
+     */
+    private performGrepSearch;
+    /**
+     * Strategy 1: Search with ripgrep (rg)
+     */
+    private searchWithRipgrep;
+    /**
+     * Strategy 2: Search with git grep
+     */
+    private searchWithGitGrep;
+    /**
+     * Strategy 3: Search with system grep
+     */
+    private searchWithSystemGrep;
+    /**
+     * Strategy 4: Pure JavaScript fallback
+     */
+    private searchWithJavaScript;
+    /**
+     * Executes a command and returns stdout
+     * Supports abort signal for ESC key cancellation and timeout for runaway processes
+     */
+    private executeCommand;
+    /**
+     * Checks if a command is available
+     */
+    private isCommandAvailable;
+    /**
+     * Parses grep-style output including context lines from -A/-B/-C flags.
+     * Match lines use colons: file:line:content
+     * Context lines use dashes: file-line-content
+     * Group separators: --
+     */
+    private parseGrepOutput;
+    /**
+     * Groups matches by file and sorts by line number
+     */
+    private groupMatchesByFile;
+}
+//# sourceMappingURL=GrepTool.d.ts.map

package/dist/implementations/search/GrepTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GrepTool.d.ts","sourceRoot":"","sources":["../../../src/implementations/search/GrepTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAOhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,SAAS,GAAG,oBAAoB,GAAG,OAAO,CAAC;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAWD;;GAEG;AACH,qBAAa,QAAS,SAAQ,QAAQ,CAAC,cAAc,EAAE,UAAU,CAAC;IAUpD,OAAO,CAAC,MAAM;IAT1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAO;IAClD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAO;IAC/C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAKnD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAoB;gBAEjD,MAAM,EAAE,cAAc;IAiC1C,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI;IA4CzD,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM;IAexC,OAAO,CACX,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,WAAW,EACnB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GACtC,OAAO,CAAC,UAAU,CAAC;IAsPtB;;;;;;;;;;;;;;;OAeG;YACW,iBAAiB;IAgG/B;;OAEG;YACW,iBAAiB;IAwC/B;;OAEG;YACW,iBAAiB;IA+B/B;;OAEG;YACW,oBAAoB;IAsDlC;;OAEG;YACW,oBAAoB;IAmGlC;;;OAGG;IACH,OAAO,CAAC,cAAc;IA8FtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkB1B;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAqDvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CA0B3B"}