@google/gemini-cli-core 0.1.0-development.1

package/dist/src/tools/glob.js

@@ -0,0 +1,215 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import fs from 'fs';
+import path from 'path';
+import { glob } from 'glob';
+import { SchemaValidator } from '../utils/schemaValidator.js';
+import { BaseTool } from './tools.js';
+import { shortenPath, makeRelative } from '../utils/paths.js';
+/**
+ * Sorts file entries based on recency and then alphabetically.
+ * Recent files (modified within recencyThresholdMs) are listed first, newest to oldest.
+ * Older files are listed after recent ones, sorted alphabetically by path.
+ */
+export function sortFileEntries(entries, nowTimestamp, recencyThresholdMs) {
+    const sortedEntries = [...entries];
+    sortedEntries.sort((a, b) => {
+        const mtimeA = a.mtimeMs ?? 0;
+        const mtimeB = b.mtimeMs ?? 0;
+        const aIsRecent = nowTimestamp - mtimeA < recencyThresholdMs;
+        const bIsRecent = nowTimestamp - mtimeB < recencyThresholdMs;
+        if (aIsRecent && bIsRecent) {
+            return mtimeB - mtimeA;
+        }
+        else if (aIsRecent) {
+            return -1;
+        }
+        else if (bIsRecent) {
+            return 1;
+        }
+        else {
+            return a.fullpath().localeCompare(b.fullpath());
+        }
+    });
+    return sortedEntries;
+}
+/**
+ * Implementation of the Glob tool logic
+ */
+export class GlobTool extends BaseTool {
+    rootDirectory;
+    config;
+    static Name = 'glob';
+    /**
+     * Creates a new instance of the GlobLogic
+     * @param rootDirectory Root directory to ground this tool in.
+     */
+    constructor(rootDirectory, config) {
+        super(GlobTool.Name, '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.', {
+            properties: {
+                pattern: {
+                    description: "The glob pattern to match against (e.g., '**/*.py', 'docs/*.md').",
+                    type: 'string',
+                },
+                path: {
+                    description: 'Optional: The absolute path to the directory to search within. If omitted, searches the root directory.',
+                    type: 'string',
+                },
+                case_sensitive: {
+                    description: 'Optional: Whether the search should be case-sensitive. Defaults to false.',
+                    type: 'boolean',
+                },
+                respect_git_ignore: {
+                    description: 'Optional: Whether to respect .gitignore patterns when finding files. Only available in git repositories. Defaults to true.',
+                    type: 'boolean',
+                },
+            },
+            required: ['pattern'],
+            type: 'object',
+        });
+        this.rootDirectory = rootDirectory;
+        this.config = config;
+        this.rootDirectory = path.resolve(rootDirectory);
+    }
+    /**
+     * Checks if a given path is within the root directory bounds.
+     * This security check prevents accessing files outside the designated root directory.
+     *
+     * @param pathToCheck The absolute path to validate
+     * @returns True if the path is within the root directory, false otherwise
+     */
+    isWithinRoot(pathToCheck) {
+        const absolutePathToCheck = path.resolve(pathToCheck);
+        const normalizedPath = path.normalize(absolutePathToCheck);
+        const normalizedRoot = path.normalize(this.rootDirectory);
+        const rootWithSep = normalizedRoot.endsWith(path.sep)
+            ? normalizedRoot
+            : normalizedRoot + path.sep;
+        return (normalizedPath === normalizedRoot ||
+            normalizedPath.startsWith(rootWithSep));
+    }
+    /**
+     * Validates the parameters for the tool.
+     */
+    validateToolParams(params) {
+        if (this.schema.parameters &&
+            !SchemaValidator.validate(this.schema.parameters, params)) {
+            return "Parameters failed schema validation. Ensure 'pattern' is a string, 'path' (if provided) is a string, and 'case_sensitive' (if provided) is a boolean.";
+        }
+        const searchDirAbsolute = path.resolve(this.rootDirectory, params.path || '.');
+        if (!this.isWithinRoot(searchDirAbsolute)) {
+            return `Search path ("${searchDirAbsolute}") resolves outside the tool's root directory ("${this.rootDirectory}").`;
+        }
+        const targetDir = searchDirAbsolute || this.rootDirectory;
+        try {
+            if (!fs.existsSync(targetDir)) {
+                return `Search path does not exist ${targetDir}`;
+            }
+            if (!fs.statSync(targetDir).isDirectory()) {
+                return `Search path is not a directory: ${targetDir}`;
+            }
+        }
+        catch (e) {
+            return `Error accessing search path: ${e}`;
+        }
+        if (!params.pattern ||
+            typeof params.pattern !== 'string' ||
+            params.pattern.trim() === '') {
+            return "The 'pattern' parameter cannot be empty.";
+        }
+        return null;
+    }
+    /**
+     * Gets a description of the glob operation.
+     */
+    getDescription(params) {
+        let description = `'${params.pattern}'`;
+        if (params.path) {
+            const searchDir = path.resolve(this.rootDirectory, params.path || '.');
+            const relativePath = makeRelative(searchDir, this.rootDirectory);
+            description += ` within ${shortenPath(relativePath)}`;
+        }
+        return description;
+    }
+    /**
+     * Executes the glob search with the given parameters
+     */
+    async execute(params, signal) {
+        const validationError = this.validateToolParams(params);
+        if (validationError) {
+            return {
+                llmContent: `Error: Invalid parameters provided. Reason: ${validationError}`,
+                returnDisplay: validationError,
+            };
+        }
+        try {
+            const searchDirAbsolute = path.resolve(this.rootDirectory, params.path || '.');
+            // Get centralized file discovery service
+            const respectGitIgnore = params.respect_git_ignore ??
+                this.config.getFileFilteringRespectGitIgnore();
+            const fileDiscovery = this.config.getFileService();
+            const entries = (await glob(params.pattern, {
+                cwd: searchDirAbsolute,
+                withFileTypes: true,
+                nodir: true,
+                stat: true,
+                nocase: !params.case_sensitive,
+                dot: true,
+                ignore: ['**/node_modules/**', '**/.git/**'],
+                follow: false,
+                signal,
+            }));
+            // Apply git-aware filtering if enabled and in git repository
+            let filteredEntries = entries;
+            let gitIgnoredCount = 0;
+            if (respectGitIgnore) {
+                const relativePaths = entries.map((p) => path.relative(this.rootDirectory, p.fullpath()));
+                const filteredRelativePaths = fileDiscovery.filterFiles(relativePaths, {
+                    respectGitIgnore,
+                });
+                const filteredAbsolutePaths = new Set(filteredRelativePaths.map((p) => path.resolve(this.rootDirectory, p)));
+                filteredEntries = entries.filter((entry) => filteredAbsolutePaths.has(entry.fullpath()));
+                gitIgnoredCount = entries.length - filteredEntries.length;
+            }
+            if (!filteredEntries || filteredEntries.length === 0) {
+                let message = `No files found matching pattern "${params.pattern}" within ${searchDirAbsolute}.`;
+                if (gitIgnoredCount > 0) {
+                    message += ` (${gitIgnoredCount} files were git-ignored)`;
+                }
+                return {
+                    llmContent: message,
+                    returnDisplay: `No files found`,
+                };
+            }
+            // Set filtering such that we first show the most recent files
+            const oneDayInMs = 24 * 60 * 60 * 1000;
+            const nowTimestamp = new Date().getTime();
+            // Sort the filtered entries using the new helper function
+            const sortedEntries = sortFileEntries(filteredEntries, nowTimestamp, oneDayInMs);
+            const sortedAbsolutePaths = sortedEntries.map((entry) => entry.fullpath());
+            const fileListDescription = sortedAbsolutePaths.join('\n');
+            const fileCount = sortedAbsolutePaths.length;
+            let resultMessage = `Found ${fileCount} file(s) matching "${params.pattern}" within ${searchDirAbsolute}`;
+            if (gitIgnoredCount > 0) {
+                resultMessage += ` (${gitIgnoredCount} additional files were git-ignored)`;
+            }
+            resultMessage += `, sorted by modification time (newest first):\n${fileListDescription}`;
+            return {
+                llmContent: resultMessage,
+                returnDisplay: `Found ${fileCount} matching file(s)`,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(`GlobLogic execute Error: ${errorMessage}`, error);
+            return {
+                llmContent: `Error during glob search operation: ${errorMessage}`,
+                returnDisplay: `Error: An unexpected error occurred.`,
+            };
+        }
+    }
+}
+//# sourceMappingURL=glob.js.map

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

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

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

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

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

@@ -0,0 +1,293 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { GlobTool, sortFileEntries } from './glob.js';
+import { partListUnionToString } from '../core/geminiRequest.js';
+import path from 'path';
+import fs from 'fs/promises';
+import os from 'os';
+import { describe, it, expect, beforeEach, afterEach } from 'vitest'; // Removed vi
+import { FileDiscoveryService } from '../services/fileDiscoveryService.js';
+describe('GlobTool', () => {
+    let tempRootDir; // This will be the rootDirectory for the GlobTool instance
+    let globTool;
+    const abortSignal = new AbortController().signal;
+    // Mock config for testing
+    const mockConfig = {
+        getFileService: () => new FileDiscoveryService(tempRootDir),
+        getFileFilteringRespectGitIgnore: () => true,
+    };
+    beforeEach(async () => {
+        // Create a unique root directory for each test run
+        tempRootDir = await fs.mkdtemp(path.join(os.tmpdir(), 'glob-tool-root-'));
+        globTool = new GlobTool(tempRootDir, mockConfig);
+        // Create some test files and directories within this root
+        // Top-level files
+        await fs.writeFile(path.join(tempRootDir, 'fileA.txt'), 'contentA');
+        await fs.writeFile(path.join(tempRootDir, 'FileB.TXT'), 'contentB'); // Different case for testing
+        // Subdirectory and files within it
+        await fs.mkdir(path.join(tempRootDir, 'sub'));
+        await fs.writeFile(path.join(tempRootDir, 'sub', 'fileC.md'), 'contentC');
+        await fs.writeFile(path.join(tempRootDir, 'sub', 'FileD.MD'), 'contentD'); // Different case
+        // Deeper subdirectory
+        await fs.mkdir(path.join(tempRootDir, 'sub', 'deep'));
+        await fs.writeFile(path.join(tempRootDir, 'sub', 'deep', 'fileE.log'), 'contentE');
+        // Files for mtime sorting test
+        await fs.writeFile(path.join(tempRootDir, 'older.sortme'), 'older_content');
+        // Ensure a noticeable difference in modification time
+        await new Promise((resolve) => setTimeout(resolve, 50));
+        await fs.writeFile(path.join(tempRootDir, 'newer.sortme'), 'newer_content');
+    });
+    afterEach(async () => {
+        // Clean up the temporary root directory
+        await fs.rm(tempRootDir, { recursive: true, force: true });
+    });
+    describe('execute', () => {
+        it('should find files matching a simple pattern in the root', async () => {
+            const params = { pattern: '*.txt' };
+            const result = await globTool.execute(params, abortSignal);
+            expect(result.llmContent).toContain('Found 2 file(s)');
+            expect(result.llmContent).toContain(path.join(tempRootDir, 'fileA.txt'));
+            expect(result.llmContent).toContain(path.join(tempRootDir, 'FileB.TXT'));
+            expect(result.returnDisplay).toBe('Found 2 matching file(s)');
+        });
+        it('should find files case-sensitively when case_sensitive is true', async () => {
+            const params = { pattern: '*.txt', case_sensitive: true };
+            const result = await globTool.execute(params, abortSignal);
+            expect(result.llmContent).toContain('Found 1 file(s)');
+            expect(result.llmContent).toContain(path.join(tempRootDir, 'fileA.txt'));
+            expect(result.llmContent).not.toContain(path.join(tempRootDir, 'FileB.TXT'));
+        });
+        it('should find files case-insensitively by default (pattern: *.TXT)', async () => {
+            const params = { pattern: '*.TXT' };
+            const result = await globTool.execute(params, abortSignal);
+            expect(result.llmContent).toContain('Found 2 file(s)');
+            expect(result.llmContent).toContain(path.join(tempRootDir, 'fileA.txt'));
+            expect(result.llmContent).toContain(path.join(tempRootDir, 'FileB.TXT'));
+        });
+        it('should find files case-insensitively when case_sensitive is false (pattern: *.TXT)', async () => {
+            const params = {
+                pattern: '*.TXT',
+                case_sensitive: false,
+            };
+            const result = await globTool.execute(params, abortSignal);
+            expect(result.llmContent).toContain('Found 2 file(s)');
+            expect(result.llmContent).toContain(path.join(tempRootDir, 'fileA.txt'));
+            expect(result.llmContent).toContain(path.join(tempRootDir, 'FileB.TXT'));
+        });
+        it('should find files using a pattern that includes a subdirectory', async () => {
+            const params = { pattern: 'sub/*.md' };
+            const result = await globTool.execute(params, abortSignal);
+            expect(result.llmContent).toContain('Found 2 file(s)');
+            expect(result.llmContent).toContain(path.join(tempRootDir, 'sub', 'fileC.md'));
+            expect(result.llmContent).toContain(path.join(tempRootDir, 'sub', 'FileD.MD'));
+        });
+        it('should find files in a specified relative path (relative to rootDir)', async () => {
+            const params = { pattern: '*.md', path: 'sub' };
+            const result = await globTool.execute(params, abortSignal);
+            expect(result.llmContent).toContain('Found 2 file(s)');
+            expect(result.llmContent).toContain(path.join(tempRootDir, 'sub', 'fileC.md'));
+            expect(result.llmContent).toContain(path.join(tempRootDir, 'sub', 'FileD.MD'));
+        });
+        it('should find files using a deep globstar pattern (e.g., **/*.log)', async () => {
+            const params = { pattern: '**/*.log' };
+            const result = await globTool.execute(params, abortSignal);
+            expect(result.llmContent).toContain('Found 1 file(s)');
+            expect(result.llmContent).toContain(path.join(tempRootDir, 'sub', 'deep', 'fileE.log'));
+        });
+        it('should return "No files found" message when pattern matches nothing', async () => {
+            const params = { pattern: '*.nonexistent' };
+            const result = await globTool.execute(params, abortSignal);
+            expect(result.llmContent).toContain('No files found matching pattern "*.nonexistent"');
+            expect(result.returnDisplay).toBe('No files found');
+        });
+        it('should correctly sort files by modification time (newest first)', async () => {
+            const params = { pattern: '*.sortme' };
+            const result = await globTool.execute(params, abortSignal);
+            const llmContent = partListUnionToString(result.llmContent);
+            expect(llmContent).toContain('Found 2 file(s)');
+            // Ensure llmContent is a string for TypeScript type checking
+            expect(typeof llmContent).toBe('string');
+            const filesListed = llmContent
+                .substring(llmContent.indexOf(':') + 1)
+                .trim()
+                .split('\n');
+            expect(filesListed[0]).toContain(path.join(tempRootDir, 'newer.sortme'));
+            expect(filesListed[1]).toContain(path.join(tempRootDir, 'older.sortme'));
+        });
+    });
+    describe('validateToolParams', () => {
+        it('should return null for valid parameters (pattern only)', () => {
+            const params = { pattern: '*.js' };
+            expect(globTool.validateToolParams(params)).toBeNull();
+        });
+        it('should return null for valid parameters (pattern and path)', () => {
+            const params = { pattern: '*.js', path: 'sub' };
+            expect(globTool.validateToolParams(params)).toBeNull();
+        });
+        it('should return null for valid parameters (pattern, path, and case_sensitive)', () => {
+            const params = {
+                pattern: '*.js',
+                path: 'sub',
+                case_sensitive: true,
+            };
+            expect(globTool.validateToolParams(params)).toBeNull();
+        });
+        it('should return error if pattern is missing (schema validation)', () => {
+            // Need to correctly define this as an object without pattern
+            const params = { path: '.' };
+            // @ts-expect-error - We're intentionally creating invalid params for testing
+            expect(globTool.validateToolParams(params)).toContain('Parameters failed schema validation');
+        });
+        it('should return error if pattern is an empty string', () => {
+            const params = { pattern: '' };
+            expect(globTool.validateToolParams(params)).toContain("The 'pattern' parameter cannot be empty.");
+        });
+        it('should return error if pattern is only whitespace', () => {
+            const params = { pattern: '   ' };
+            expect(globTool.validateToolParams(params)).toContain("The 'pattern' parameter cannot be empty.");
+        });
+        it('should return error if path is provided but is not a string (schema validation)', () => {
+            const params = {
+                pattern: '*.ts',
+                path: 123,
+            };
+            // @ts-expect-error - We're intentionally creating invalid params for testing
+            expect(globTool.validateToolParams(params)).toContain('Parameters failed schema validation');
+        });
+        it('should return error if case_sensitive is provided but is not a boolean (schema validation)', () => {
+            const params = {
+                pattern: '*.ts',
+                case_sensitive: 'true',
+            };
+            // @ts-expect-error - We're intentionally creating invalid params for testing
+            expect(globTool.validateToolParams(params)).toContain('Parameters failed schema validation');
+        });
+        it("should return error if search path resolves outside the tool's root directory", () => {
+            // Create a globTool instance specifically for this test, with a deeper root
+            const deeperRootDir = path.join(tempRootDir, 'sub');
+            const specificGlobTool = new GlobTool(deeperRootDir, mockConfig);
+            // const params: GlobToolParams = { pattern: '*.txt', path: '..' }; // This line is unused and will be removed.
+            // This should be fine as tempRootDir is still within the original tempRootDir (the parent of deeperRootDir)
+            // Let's try to go further up.
+            const paramsOutside = {
+                pattern: '*.txt',
+                path: '../../../../../../../../../../tmp',
+            }; // Definitely outside
+            expect(specificGlobTool.validateToolParams(paramsOutside)).toContain("resolves outside the tool's root directory");
+        });
+        it('should return error if specified search path does not exist', async () => {
+            const params = {
+                pattern: '*.txt',
+                path: 'nonexistent_subdir',
+            };
+            expect(globTool.validateToolParams(params)).toContain('Search path does not exist');
+        });
+        it('should return error if specified search path is a file, not a directory', async () => {
+            const params = { pattern: '*.txt', path: 'fileA.txt' };
+            expect(globTool.validateToolParams(params)).toContain('Search path is not a directory');
+        });
+    });
+});
+describe('sortFileEntries', () => {
+    const nowTimestamp = new Date('2024-01-15T12:00:00.000Z').getTime();
+    const oneDayInMs = 24 * 60 * 60 * 1000;
+    const createFileEntry = (fullpath, mtimeDate) => ({
+        fullpath: () => fullpath,
+        mtimeMs: mtimeDate.getTime(),
+    });
+    it('should sort a mix of recent and older files correctly', () => {
+        const recentTime1 = new Date(nowTimestamp - 1 * 60 * 60 * 1000); // 1 hour ago
+        const recentTime2 = new Date(nowTimestamp - 2 * 60 * 60 * 1000); // 2 hours ago
+        const olderTime1 = new Date(nowTimestamp - (oneDayInMs + 1 * 60 * 60 * 1000)); // 25 hours ago
+        const olderTime2 = new Date(nowTimestamp - (oneDayInMs + 2 * 60 * 60 * 1000)); // 26 hours ago
+        const entries = [
+            createFileEntry('older_zebra.txt', olderTime2),
+            createFileEntry('recent_alpha.txt', recentTime1),
+            createFileEntry('older_apple.txt', olderTime1),
+            createFileEntry('recent_beta.txt', recentTime2),
+            createFileEntry('older_banana.txt', olderTime1), // Same mtime as apple
+        ];
+        const sorted = sortFileEntries(entries, nowTimestamp, oneDayInMs);
+        const sortedPaths = sorted.map((e) => e.fullpath());
+        expect(sortedPaths).toEqual([
+            'recent_alpha.txt', // Recent, newest
+            'recent_beta.txt', // Recent, older
+            'older_apple.txt', // Older, alphabetical
+            'older_banana.txt', // Older, alphabetical
+            'older_zebra.txt', // Older, alphabetical
+        ]);
+    });
+    it('should sort only recent files by mtime descending', () => {
+        const recentTime1 = new Date(nowTimestamp - 1000); // Newest
+        const recentTime2 = new Date(nowTimestamp - 2000);
+        const recentTime3 = new Date(nowTimestamp - 3000); // Oldest recent
+        const entries = [
+            createFileEntry('c.txt', recentTime2),
+            createFileEntry('a.txt', recentTime3),
+            createFileEntry('b.txt', recentTime1),
+        ];
+        const sorted = sortFileEntries(entries, nowTimestamp, oneDayInMs);
+        expect(sorted.map((e) => e.fullpath())).toEqual([
+            'b.txt',
+            'c.txt',
+            'a.txt',
+        ]);
+    });
+    it('should sort only older files alphabetically by path', () => {
+        const olderTime = new Date(nowTimestamp - 2 * oneDayInMs); // All equally old
+        const entries = [
+            createFileEntry('zebra.txt', olderTime),
+            createFileEntry('apple.txt', olderTime),
+            createFileEntry('banana.txt', olderTime),
+        ];
+        const sorted = sortFileEntries(entries, nowTimestamp, oneDayInMs);
+        expect(sorted.map((e) => e.fullpath())).toEqual([
+            'apple.txt',
+            'banana.txt',
+            'zebra.txt',
+        ]);
+    });
+    it('should handle an empty array', () => {
+        const entries = [];
+        const sorted = sortFileEntries(entries, nowTimestamp, oneDayInMs);
+        expect(sorted).toEqual([]);
+    });
+    it('should correctly sort files when mtimes are identical for older files', () => {
+        const olderTime = new Date(nowTimestamp - 2 * oneDayInMs);
+        const entries = [
+            createFileEntry('b.txt', olderTime),
+            createFileEntry('a.txt', olderTime),
+        ];
+        const sorted = sortFileEntries(entries, nowTimestamp, oneDayInMs);
+        expect(sorted.map((e) => e.fullpath())).toEqual(['a.txt', 'b.txt']);
+    });
+    it('should correctly sort files when mtimes are identical for recent files (maintaining mtime sort)', () => {
+        const recentTime = new Date(nowTimestamp - 1000);
+        const entries = [
+            createFileEntry('b.txt', recentTime),
+            createFileEntry('a.txt', recentTime),
+        ];
+        const sorted = sortFileEntries(entries, nowTimestamp, oneDayInMs);
+        expect(sorted.map((e) => e.fullpath())).toContain('a.txt');
+        expect(sorted.map((e) => e.fullpath())).toContain('b.txt');
+        expect(sorted.length).toBe(2);
+    });
+    it('should use recencyThresholdMs parameter correctly', () => {
+        const justOverThreshold = new Date(nowTimestamp - (1000 + 1)); // Barely older
+        const justUnderThreshold = new Date(nowTimestamp - (1000 - 1)); // Barely recent
+        const customThresholdMs = 1000; // 1 second
+        const entries = [
+            createFileEntry('older_file.txt', justOverThreshold),
+            createFileEntry('recent_file.txt', justUnderThreshold),
+        ];
+        const sorted = sortFileEntries(entries, nowTimestamp, customThresholdMs);
+        expect(sorted.map((e) => e.fullpath())).toEqual([
+            'recent_file.txt',
+            'older_file.txt',
+        ]);
+    });
+});
+//# sourceMappingURL=glob.test.js.map

package/dist/src/tools/glob.test.js.map

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

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

@@ -0,0 +1,81 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseTool, ToolResult } from './tools.js';
+/**
+ * Parameters for the GrepTool
+ */
+export interface GrepToolParams {
+    /**
+     * The regular expression pattern to search for in file contents
+     */
+    pattern: string;
+    /**
+     * The directory to search in (optional, defaults to current directory relative to root)
+     */
+    path?: string;
+    /**
+     * File pattern to include in the search (e.g. "*.js", "*.{ts,tsx}")
+     */
+    include?: string;
+}
+/**
+ * Implementation of the Grep tool logic (moved from CLI)
+ */
+export declare class GrepTool extends BaseTool<GrepToolParams, ToolResult> {
+    private rootDirectory;
+    static readonly Name = "search_file_content";
+    /**
+     * Creates a new instance of the GrepLogic
+     * @param rootDirectory Root directory to ground this tool in. All operations will be restricted to this directory.
+     */
+    constructor(rootDirectory: string);
+    /**
+     * 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.
+     */
+    private resolveAndValidatePath;
+    /**
+     * Validates the parameters for the tool
+     * @param params Parameters to validate
+     * @returns An error message string if invalid, null otherwise
+     */
+    validateToolParams(params: GrepToolParams): string | null;
+    /**
+     * Executes the grep search with the given parameters
+     * @param params Parameters for the grep search
+     * @returns Result of the grep search
+     */
+    execute(params: GrepToolParams, signal: AbortSignal): Promise<ToolResult>;
+    /**
+     * 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.
+     */
+    private isCommandAvailable;
+    /**
+     * 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.
+     */
+    private parseGrepOutput;
+    /**
+     * Gets a description of the grep operation
+     * @param params Parameters for the grep operation
+     * @returns A string describing the grep
+     */
+    getDescription(params: GrepToolParams): string;
+    /**
+     * 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.
+     */
+    private performGrepSearch;
+}