@vybestack/llxprt-code-core 0.1.12

package/dist/src/tools/grep.js

@@ -0,0 +1,422 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import fs from 'fs';
+import fsPromises from 'fs/promises';
+import path from 'path';
+import { EOL } from 'os';
+import { spawn } from 'child_process';
+import { globStream } from 'glob';
+import { BaseTool } from './tools.js';
+import { Type } from '@google/genai';
+import { SchemaValidator } from '../utils/schemaValidator.js';
+import { makeRelative, shortenPath } from '../utils/paths.js';
+import { getErrorMessage, isNodeError } from '../utils/errors.js';
+import { isGitRepository } from '../utils/gitUtils.js';
+// --- GrepLogic Class ---
+/**
+ * Implementation of the Grep tool logic (moved from CLI)
+ */
+export class GrepTool extends BaseTool {
+    config;
+    static Name = 'search_file_content'; // Keep static name
+    constructor(config) {
+        super(GrepTool.Name, 'SearchFileContent', 'Searches for a regular expression pattern within the content of files in a specified directory (or current working directory). Can filter files by a glob pattern. Returns the lines containing matches, along with their file paths and line numbers. IMPORTANT: This tool expects regular expression patterns, not literal strings.', {
+            properties: {
+                pattern: {
+                    description: "The regular expression (regex) pattern to search for within file contents. Special characters like ( ) [ ] { } . * + ? ^ $ \\ | must be escaped with a backslash. Examples: 'openModelDialog\\(' to find 'openModelDialog(', 'function\\s+myFunction' to find function declarations, '\\.test\\.' to find '.test.' in filenames.",
+                    type: Type.STRING,
+                },
+                path: {
+                    description: 'Optional: The absolute path to the directory to search within. If omitted, searches the current working directory.',
+                    type: Type.STRING,
+                },
+                include: {
+                    description: "Optional: A glob pattern to filter which files are searched (e.g., '*.js', '*.{ts,tsx}', 'src/**'). If omitted, searches all files (respecting potential global ignores).",
+                    type: Type.STRING,
+                },
+            },
+            required: ['pattern'],
+            type: Type.OBJECT,
+        });
+        this.config = config;
+    }
+    // --- Validation Methods ---
+    /**
+     * Checks if a path is within the root directory and resolves it.
+     * @param relativePath Path relative to the root directory (or undefined for root).
+     * @returns The absolute path if valid and exists.
+     * @throws {Error} If path is outside root, doesn't exist, or isn't a directory.
+     */
+    resolveAndValidatePath(relativePath) {
+        const targetPath = path.resolve(this.config.getTargetDir(), relativePath || '.');
+        // Security Check: Ensure the resolved path is still within the root directory.
+        if (!targetPath.startsWith(this.config.getTargetDir()) &&
+            targetPath !== this.config.getTargetDir()) {
+            throw new Error(`Path validation failed: Attempted path "${relativePath || '.'}" resolves outside the allowed root directory "${this.config.getTargetDir()}".`);
+        }
+        // Check existence and type after resolving
+        try {
+            const stats = fs.statSync(targetPath);
+            if (!stats.isDirectory()) {
+                throw new Error(`Path is not a directory: ${targetPath}`);
+            }
+        }
+        catch (error) {
+            if (isNodeError(error) && error.code !== 'ENOENT') {
+                throw new Error(`Path does not exist: ${targetPath}`);
+            }
+            throw new Error(`Failed to access path stats for ${targetPath}: ${error}`);
+        }
+        return targetPath;
+    }
+    /**
+     * Validates the parameters for the tool
+     * @param params Parameters to validate
+     * @returns An error message string if invalid, null otherwise
+     */
+    validateToolParams(params) {
+        const errors = SchemaValidator.validate(this.schema.parameters, params);
+        if (errors) {
+            return errors;
+        }
+        try {
+            new RegExp(params.pattern);
+        }
+        catch (error) {
+            return `Invalid regular expression pattern provided: ${params.pattern}. Error: ${getErrorMessage(error)}`;
+        }
+        try {
+            this.resolveAndValidatePath(params.path);
+        }
+        catch (error) {
+            return getErrorMessage(error);
+        }
+        return null; // Parameters are valid
+    }
+    // --- Core Execution ---
+    /**
+     * Executes the grep search with the given parameters
+     * @param params Parameters for the grep search
+     * @returns Result of the grep search
+     */
+    async execute(params, signal) {
+        const validationError = this.validateToolParams(params);
+        if (validationError) {
+            return {
+                llmContent: `Error: Invalid parameters provided. Reason: ${validationError}`,
+                returnDisplay: `Model provided invalid parameters. Error: ${validationError}`,
+            };
+        }
+        let searchDirAbs;
+        try {
+            searchDirAbs = this.resolveAndValidatePath(params.path);
+            const searchDirDisplay = params.path || '.';
+            const matches = await this.performGrepSearch({
+                pattern: params.pattern,
+                path: searchDirAbs,
+                include: params.include,
+                signal,
+            });
+            if (matches.length === 0) {
+                const noMatchMsg = `No matches found for pattern "${params.pattern}" in path "${searchDirDisplay}"${params.include ? ` (filter: "${params.include}")` : ''}.`;
+                return { llmContent: noMatchMsg, returnDisplay: `No matches found` };
+            }
+            const matchesByFile = matches.reduce((acc, match) => {
+                const relativeFilePath = path.relative(searchDirAbs, path.resolve(searchDirAbs, match.filePath)) || path.basename(match.filePath);
+                if (!acc[relativeFilePath]) {
+                    acc[relativeFilePath] = [];
+                }
+                acc[relativeFilePath].push(match);
+                acc[relativeFilePath].sort((a, b) => a.lineNumber - b.lineNumber);
+                return acc;
+            }, {});
+            const matchCount = matches.length;
+            const matchTerm = matchCount === 1 ? 'match' : 'matches';
+            let llmContent = `Found ${matchCount} ${matchTerm} for pattern "${params.pattern}" in path "${searchDirDisplay}"${params.include ? ` (filter: "${params.include}")` : ''}:\n---\n`;
+            for (const filePath in matchesByFile) {
+                llmContent += `File: ${filePath}\n`;
+                matchesByFile[filePath].forEach((match) => {
+                    const trimmedLine = match.line.trim();
+                    llmContent += `L${match.lineNumber}: ${trimmedLine}\n`;
+                });
+                llmContent += '---\n';
+            }
+            return {
+                llmContent: llmContent.trim(),
+                returnDisplay: `Found ${matchCount} ${matchTerm}`,
+            };
+        }
+        catch (error) {
+            console.error(`Error during GrepLogic execution: ${error}`);
+            const errorMessage = getErrorMessage(error);
+            return {
+                llmContent: `Error during grep search operation: ${errorMessage}`,
+                returnDisplay: `Error: ${errorMessage}`,
+            };
+        }
+    }
+    // --- Grep Implementation Logic ---
+    /**
+     * Checks if a command is available in the system's PATH.
+     * @param {string} command The command name (e.g., 'git', 'grep').
+     * @returns {Promise<boolean>} True if the command is available, false otherwise.
+     */
+    isCommandAvailable(command) {
+        return new Promise((resolve) => {
+            const checkCommand = process.platform === 'win32' ? 'where' : 'command';
+            const checkArgs = process.platform === 'win32' ? [command] : ['-v', command];
+            try {
+                const child = spawn(checkCommand, checkArgs, {
+                    stdio: 'ignore',
+                    shell: process.platform === 'win32',
+                });
+                child.on('close', (code) => resolve(code === 0));
+                child.on('error', () => resolve(false));
+            }
+            catch {
+                resolve(false);
+            }
+        });
+    }
+    /**
+     * Parses the standard output of grep-like commands (git grep, system grep).
+     * Expects format: filePath:lineNumber:lineContent
+     * Handles colons within file paths and line content correctly.
+     * @param {string} output The raw stdout string.
+     * @param {string} basePath The absolute directory the search was run from, for relative paths.
+     * @returns {GrepMatch[]} Array of match objects.
+     */
+    parseGrepOutput(output, basePath) {
+        const results = [];
+        if (!output)
+            return results;
+        const lines = output.split(EOL); // Use OS-specific end-of-line
+        for (const line of lines) {
+            if (!line.trim())
+                continue;
+            // Find the index of the first colon.
+            const firstColonIndex = line.indexOf(':');
+            if (firstColonIndex === -1)
+                continue; // Malformed
+            // Find the index of the second colon, searching *after* the first one.
+            const secondColonIndex = line.indexOf(':', firstColonIndex + 1);
+            if (secondColonIndex === -1)
+                continue; // Malformed
+            // Extract parts based on the found colon indices
+            const filePathRaw = line.substring(0, firstColonIndex);
+            const lineNumberStr = line.substring(firstColonIndex + 1, secondColonIndex);
+            const lineContent = line.substring(secondColonIndex + 1);
+            const lineNumber = parseInt(lineNumberStr, 10);
+            if (!isNaN(lineNumber)) {
+                const absoluteFilePath = path.resolve(basePath, filePathRaw);
+                const relativeFilePath = path.relative(basePath, absoluteFilePath);
+                results.push({
+                    filePath: relativeFilePath || path.basename(absoluteFilePath),
+                    lineNumber,
+                    line: lineContent,
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * Gets a description of the grep operation
+     * @param params Parameters for the grep operation
+     * @returns A string describing the grep
+     */
+    getDescription(params) {
+        let description = `'${params.pattern}'`;
+        if (params.include) {
+            description += ` in ${params.include}`;
+        }
+        if (params.path) {
+            const resolvedPath = path.resolve(this.config.getTargetDir(), params.path);
+            if (resolvedPath === this.config.getTargetDir() || params.path === '.') {
+                description += ` within ./`;
+            }
+            else {
+                const relativePath = makeRelative(resolvedPath, this.config.getTargetDir());
+                description += ` within ${shortenPath(relativePath)}`;
+            }
+        }
+        return description;
+    }
+    /**
+     * Performs the actual search using the prioritized strategies.
+     * @param options Search options including pattern, absolute path, and include glob.
+     * @returns A promise resolving to an array of match objects.
+     */
+    async performGrepSearch(options) {
+        const { pattern, path: absolutePath, include } = options;
+        let strategyUsed = 'none';
+        try {
+            // --- Strategy 1: git grep ---
+            const isGit = isGitRepository(absolutePath);
+            const gitAvailable = isGit && (await this.isCommandAvailable('git'));
+            if (gitAvailable) {
+                strategyUsed = 'git grep';
+                const gitArgs = [
+                    'grep',
+                    '--untracked',
+                    '-n',
+                    '-E',
+                    '--ignore-case',
+                    pattern,
+                ];
+                if (include) {
+                    gitArgs.push('--', include);
+                }
+                try {
+                    const output = await new Promise((resolve, reject) => {
+                        const child = spawn('git', gitArgs, {
+                            cwd: absolutePath,
+                            windowsHide: true,
+                        });
+                        const stdoutChunks = [];
+                        const stderrChunks = [];
+                        child.stdout.on('data', (chunk) => stdoutChunks.push(chunk));
+                        child.stderr.on('data', (chunk) => stderrChunks.push(chunk));
+                        child.on('error', (err) => reject(new Error(`Failed to start git grep: ${err.message}`)));
+                        child.on('close', (code) => {
+                            const stdoutData = Buffer.concat(stdoutChunks).toString('utf8');
+                            const stderrData = Buffer.concat(stderrChunks).toString('utf8');
+                            if (code === 0)
+                                resolve(stdoutData);
+                            else if (code === 1)
+                                resolve(''); // No matches
+                            else
+                                reject(new Error(`git grep exited with code ${code}: ${stderrData}`));
+                        });
+                    });
+                    return this.parseGrepOutput(output, absolutePath);
+                }
+                catch (gitError) {
+                    console.debug(`GrepLogic: git grep failed: ${getErrorMessage(gitError)}. Falling back...`);
+                }
+            }
+            // --- Strategy 2: System grep ---
+            const grepAvailable = await this.isCommandAvailable('grep');
+            if (grepAvailable) {
+                strategyUsed = 'system grep';
+                const grepArgs = ['-r', '-n', '-H', '-E'];
+                const commonExcludes = ['.git', 'node_modules', 'bower_components'];
+                commonExcludes.forEach((dir) => grepArgs.push(`--exclude-dir=${dir}`));
+                if (include) {
+                    grepArgs.push(`--include=${include}`);
+                }
+                grepArgs.push(pattern);
+                grepArgs.push('.');
+                try {
+                    const output = await new Promise((resolve, reject) => {
+                        const child = spawn('grep', grepArgs, {
+                            cwd: absolutePath,
+                            windowsHide: true,
+                        });
+                        const stdoutChunks = [];
+                        const stderrChunks = [];
+                        const onData = (chunk) => stdoutChunks.push(chunk);
+                        const onStderr = (chunk) => {
+                            const stderrStr = chunk.toString();
+                            // Suppress common harmless stderr messages
+                            if (!stderrStr.includes('Permission denied') &&
+                                !/grep:.*: Is a directory/i.test(stderrStr)) {
+                                stderrChunks.push(chunk);
+                            }
+                        };
+                        const onError = (err) => {
+                            cleanup();
+                            reject(new Error(`Failed to start system grep: ${err.message}`));
+                        };
+                        const onClose = (code) => {
+                            const stdoutData = Buffer.concat(stdoutChunks).toString('utf8');
+                            const stderrData = Buffer.concat(stderrChunks)
+                                .toString('utf8')
+                                .trim();
+                            cleanup();
+                            if (code === 0)
+                                resolve(stdoutData);
+                            else if (code === 1)
+                                resolve(''); // No matches
+                            else {
+                                if (stderrData)
+                                    reject(new Error(`System grep exited with code ${code}: ${stderrData}`));
+                                else
+                                    resolve(''); // Exit code > 1 but no stderr, likely just suppressed errors
+                            }
+                        };
+                        const cleanup = () => {
+                            child.stdout.removeListener('data', onData);
+                            child.stderr.removeListener('data', onStderr);
+                            child.removeListener('error', onError);
+                            child.removeListener('close', onClose);
+                            if (child.connected) {
+                                child.disconnect();
+                            }
+                        };
+                        child.stdout.on('data', onData);
+                        child.stderr.on('data', onStderr);
+                        child.on('error', onError);
+                        child.on('close', onClose);
+                    });
+                    return this.parseGrepOutput(output, absolutePath);
+                }
+                catch (grepError) {
+                    console.debug(`GrepLogic: System grep failed: ${getErrorMessage(grepError)}. Falling back...`);
+                }
+            }
+            // --- Strategy 3: Pure JavaScript Fallback ---
+            console.debug('GrepLogic: Falling back to JavaScript grep implementation.');
+            strategyUsed = 'javascript fallback';
+            const globPattern = include ? include : '**/*';
+            const ignorePatterns = [
+                '.git/**',
+                'node_modules/**',
+                'bower_components/**',
+                '.svn/**',
+                '.hg/**',
+            ]; // Use glob patterns for ignores here
+            const filesStream = globStream(globPattern, {
+                cwd: absolutePath,
+                dot: true,
+                ignore: ignorePatterns,
+                absolute: true,
+                nodir: true,
+                signal: options.signal,
+            });
+            const regex = new RegExp(pattern, 'i');
+            const allMatches = [];
+            for await (const filePath of filesStream) {
+                const fileAbsolutePath = filePath;
+                try {
+                    const content = await fsPromises.readFile(fileAbsolutePath, 'utf8');
+                    const lines = content.split(/\r?\n/);
+                    lines.forEach((line, index) => {
+                        if (regex.test(line)) {
+                            allMatches.push({
+                                filePath: path.relative(absolutePath, fileAbsolutePath) ||
+                                    path.basename(fileAbsolutePath),
+                                lineNumber: index + 1,
+                                line,
+                            });
+                        }
+                    });
+                }
+                catch (readError) {
+                    // Ignore errors like permission denied or file gone during read
+                    if (!isNodeError(readError) || readError.code !== 'ENOENT') {
+                        console.debug(`GrepLogic: Could not read/process ${fileAbsolutePath}: ${getErrorMessage(readError)}`);
+                    }
+                }
+            }
+            return allMatches;
+        }
+        catch (error) {
+            console.error(`GrepLogic: Error in performGrepSearch (Strategy: ${strategyUsed}): ${getErrorMessage(error)}`);
+            throw error; // Re-throw
+        }
+    }
+}
+//# sourceMappingURL=grep.js.map

package/dist/src/tools/grep.js.map

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

package/dist/src/tools/grep.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/tools/grep.test.js

@@ -0,0 +1,188 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { GrepTool } from './grep.js';
+import path from 'path';
+import fs from 'fs/promises';
+import os from 'os';
+// Mock the child_process module to control grep/git grep behavior
+vi.mock('child_process', () => ({
+    spawn: vi.fn(() => ({
+        on: (event, cb) => {
+            if (event === 'error' || event === 'close') {
+                // Simulate command not found or error for git grep and system grep
+                // to force fallback to JS implementation.
+                setTimeout(() => cb(1), 0); // cb(1) for error/close
+            }
+        },
+        stdout: { on: vi.fn() },
+        stderr: { on: vi.fn() },
+    })),
+}));
+describe('GrepTool', () => {
+    let tempRootDir;
+    let grepTool;
+    const abortSignal = new AbortController().signal;
+    const mockConfig = {
+        getTargetDir: () => tempRootDir,
+    };
+    beforeEach(async () => {
+        tempRootDir = await fs.mkdtemp(path.join(os.tmpdir(), 'grep-tool-root-'));
+        grepTool = new GrepTool(mockConfig);
+        // Create some test files and directories
+        await fs.writeFile(path.join(tempRootDir, 'fileA.txt'), 'hello world\nsecond line with world');
+        await fs.writeFile(path.join(tempRootDir, 'fileB.js'), 'const foo = "bar";\nfunction baz() { return "hello"; }');
+        await fs.mkdir(path.join(tempRootDir, 'sub'));
+        await fs.writeFile(path.join(tempRootDir, 'sub', 'fileC.txt'), 'another world in sub dir');
+        await fs.writeFile(path.join(tempRootDir, 'sub', 'fileD.md'), '# Markdown file\nThis is a test.');
+    });
+    afterEach(async () => {
+        await fs.rm(tempRootDir, { recursive: true, force: true });
+    });
+    describe('validateToolParams', () => {
+        it('should return null for valid params (pattern only)', () => {
+            const params = { pattern: 'hello' };
+            expect(grepTool.validateToolParams(params)).toBeNull();
+        });
+        it('should return null for valid params (pattern and path)', () => {
+            const params = { pattern: 'hello', path: '.' };
+            expect(grepTool.validateToolParams(params)).toBeNull();
+        });
+        it('should return null for valid params (pattern, path, and include)', () => {
+            const params = {
+                pattern: 'hello',
+                path: '.',
+                include: '*.txt',
+            };
+            expect(grepTool.validateToolParams(params)).toBeNull();
+        });
+        it('should return error if pattern is missing', () => {
+            const params = { path: '.' };
+            expect(grepTool.validateToolParams(params)).toBe(`params must have required property 'pattern'`);
+        });
+        it('should return error for invalid regex pattern', () => {
+            const params = { pattern: '[[' };
+            expect(grepTool.validateToolParams(params)).toContain('Invalid regular expression pattern');
+        });
+        it('should return error if path does not exist', () => {
+            const params = { pattern: 'hello', path: 'nonexistent' };
+            // Check for the core error message, as the full path might vary
+            expect(grepTool.validateToolParams(params)).toContain('Failed to access path stats for');
+            expect(grepTool.validateToolParams(params)).toContain('nonexistent');
+        });
+        it('should return error if path is a file, not a directory', async () => {
+            const filePath = path.join(tempRootDir, 'fileA.txt');
+            const params = { pattern: 'hello', path: filePath };
+            expect(grepTool.validateToolParams(params)).toContain(`Path is not a directory: ${filePath}`);
+        });
+    });
+    describe('execute', () => {
+        it('should find matches for a simple pattern in all files', async () => {
+            const params = { pattern: 'world' };
+            const result = await grepTool.execute(params, abortSignal);
+            expect(result.llmContent).toContain('Found 3 matches for pattern "world" in path "."');
+            expect(result.llmContent).toContain('File: fileA.txt');
+            expect(result.llmContent).toContain('L1: hello world');
+            expect(result.llmContent).toContain('L2: second line with world');
+            expect(result.llmContent).toContain('File: sub/fileC.txt');
+            expect(result.llmContent).toContain('L1: another world in sub dir');
+            expect(result.returnDisplay).toBe('Found 3 matches');
+        });
+        it('should find matches in a specific path', async () => {
+            const params = { pattern: 'world', path: 'sub' };
+            const result = await grepTool.execute(params, abortSignal);
+            expect(result.llmContent).toContain('Found 1 match for pattern "world" in path "sub"');
+            expect(result.llmContent).toContain('File: fileC.txt'); // Path relative to 'sub'
+            expect(result.llmContent).toContain('L1: another world in sub dir');
+            expect(result.returnDisplay).toBe('Found 1 match');
+        });
+        it('should find matches with an include glob', async () => {
+            const params = { pattern: 'hello', include: '*.js' };
+            const result = await grepTool.execute(params, abortSignal);
+            expect(result.llmContent).toContain('Found 1 match for pattern "hello" in path "." (filter: "*.js")');
+            expect(result.llmContent).toContain('File: fileB.js');
+            expect(result.llmContent).toContain('L2: function baz() { return "hello"; }');
+            expect(result.returnDisplay).toBe('Found 1 match');
+        });
+        it('should find matches with an include glob and path', async () => {
+            await fs.writeFile(path.join(tempRootDir, 'sub', 'another.js'), 'const greeting = "hello";');
+            const params = {
+                pattern: 'hello',
+                path: 'sub',
+                include: '*.js',
+            };
+            const result = await grepTool.execute(params, abortSignal);
+            expect(result.llmContent).toContain('Found 1 match for pattern "hello" in path "sub" (filter: "*.js")');
+            expect(result.llmContent).toContain('File: another.js');
+            expect(result.llmContent).toContain('L1: const greeting = "hello";');
+            expect(result.returnDisplay).toBe('Found 1 match');
+        });
+        it('should return "No matches found" when pattern does not exist', async () => {
+            const params = { pattern: 'nonexistentpattern' };
+            const result = await grepTool.execute(params, abortSignal);
+            expect(result.llmContent).toContain('No matches found for pattern "nonexistentpattern" in path "."');
+            expect(result.returnDisplay).toBe('No matches found');
+        });
+        it('should handle regex special characters correctly', async () => {
+            const params = { pattern: 'foo.*bar' }; // Matches 'const foo = "bar";'
+            const result = await grepTool.execute(params, abortSignal);
+            expect(result.llmContent).toContain('Found 1 match for pattern "foo.*bar" in path "."');
+            expect(result.llmContent).toContain('File: fileB.js');
+            expect(result.llmContent).toContain('L1: const foo = "bar";');
+        });
+        it('should be case-insensitive by default (JS fallback)', async () => {
+            const params = { pattern: 'HELLO' };
+            const result = await grepTool.execute(params, abortSignal);
+            expect(result.llmContent).toContain('Found 2 matches for pattern "HELLO" in path "."');
+            expect(result.llmContent).toContain('File: fileA.txt');
+            expect(result.llmContent).toContain('L1: hello world');
+            expect(result.llmContent).toContain('File: fileB.js');
+            expect(result.llmContent).toContain('L2: function baz() { return "hello"; }');
+        });
+        it('should return an error if params are invalid', async () => {
+            const params = { path: '.' }; // Invalid: pattern missing
+            const result = await grepTool.execute(params, abortSignal);
+            expect(result.llmContent).toBe("Error: Invalid parameters provided. Reason: params must have required property 'pattern'");
+            expect(result.returnDisplay).toBe("Model provided invalid parameters. Error: params must have required property 'pattern'");
+        });
+    });
+    describe('getDescription', () => {
+        it('should generate correct description with pattern only', () => {
+            const params = { pattern: 'testPattern' };
+            expect(grepTool.getDescription(params)).toBe("'testPattern'");
+        });
+        it('should generate correct description with pattern and include', () => {
+            const params = {
+                pattern: 'testPattern',
+                include: '*.ts',
+            };
+            expect(grepTool.getDescription(params)).toBe("'testPattern' in *.ts");
+        });
+        it('should generate correct description with pattern and path', () => {
+            const params = {
+                pattern: 'testPattern',
+                path: 'src/app',
+            };
+            // The path will be relative to the tempRootDir, so we check for containment.
+            expect(grepTool.getDescription(params)).toContain("'testPattern' within");
+            expect(grepTool.getDescription(params)).toContain(path.join('src', 'app'));
+        });
+        it('should generate correct description with pattern, include, and path', () => {
+            const params = {
+                pattern: 'testPattern',
+                include: '*.ts',
+                path: 'src/app',
+            };
+            expect(grepTool.getDescription(params)).toContain("'testPattern' in *.ts within");
+            expect(grepTool.getDescription(params)).toContain('src/app');
+        });
+        it('should use ./ for root path in description', () => {
+            const params = { pattern: 'testPattern', path: '.' };
+            expect(grepTool.getDescription(params)).toBe("'testPattern' within ./");
+        });
+    });
+});
+//# sourceMappingURL=grep.test.js.map