@anthropic-field/core 0.1.0

package/dist/src/tools/ripGrep.js

@@ -0,0 +1,422 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import fs from 'node:fs';
+import fsPromises from 'node:fs/promises';
+import path from 'node:path';
+import { downloadRipGrep } from '@joshua.litt/get-ripgrep';
+import { BaseDeclarativeTool, BaseToolInvocation, Kind } from './tools.js';
+import { ToolErrorType } from './tool-error.js';
+import { makeRelative, shortenPath } from '../utils/paths.js';
+import { getErrorMessage, isNodeError } from '../utils/errors.js';
+import { fileExists } from '../utils/fileUtils.js';
+import { Storage } from '../config/storage.js';
+import { GREP_TOOL_NAME } from './tool-names.js';
+import { debugLogger } from '../utils/debugLogger.js';
+import { FileExclusions, COMMON_DIRECTORY_EXCLUDES, } from '../utils/ignorePatterns.js';
+import { FileDiscoveryService } from '../services/fileDiscoveryService.js';
+import { execStreaming } from '../utils/shell-utils.js';
+import { DEFAULT_TOTAL_MAX_MATCHES, DEFAULT_SEARCH_TIMEOUT_MS, } from './constants.js';
+function getRgCandidateFilenames() {
+    return process.platform === 'win32' ? ['rg.exe', 'rg'] : ['rg'];
+}
+async function resolveExistingRgPath() {
+    const binDir = Storage.getGlobalBinDir();
+    for (const fileName of getRgCandidateFilenames()) {
+        const candidatePath = path.join(binDir, fileName);
+        if (await fileExists(candidatePath)) {
+            return candidatePath;
+        }
+    }
+    return null;
+}
+let ripgrepAcquisitionPromise = null;
+async function ensureRipgrepAvailable() {
+    const existingPath = await resolveExistingRgPath();
+    if (existingPath) {
+        return existingPath;
+    }
+    if (!ripgrepAcquisitionPromise) {
+        ripgrepAcquisitionPromise = (async () => {
+            try {
+                await downloadRipGrep(Storage.getGlobalBinDir());
+                return await resolveExistingRgPath();
+            }
+            finally {
+                ripgrepAcquisitionPromise = null;
+            }
+        })();
+    }
+    return ripgrepAcquisitionPromise;
+}
+/**
+ * Checks if `rg` exists, if not then attempt to download it.
+ */
+export async function canUseRipgrep() {
+    return (await ensureRipgrepAvailable()) !== null;
+}
+/**
+ * Ensures `rg` is downloaded, or throws.
+ */
+export async function ensureRgPath() {
+    const downloadedPath = await ensureRipgrepAvailable();
+    if (downloadedPath) {
+        return downloadedPath;
+    }
+    throw new Error('Cannot use ripgrep.');
+}
+class GrepToolInvocation extends BaseToolInvocation {
+    config;
+    fileDiscoveryService;
+    constructor(config, fileDiscoveryService, params, messageBus, _toolName, _toolDisplayName) {
+        super(params, messageBus, _toolName, _toolDisplayName);
+        this.config = config;
+        this.fileDiscoveryService = fileDiscoveryService;
+    }
+    async execute(signal) {
+        try {
+            // Default to '.' if path is explicitly undefined/null.
+            // This forces CWD search instead of 'all workspaces' search by default.
+            const pathParam = this.params.dir_path || '.';
+            const searchDirAbs = path.resolve(this.config.getTargetDir(), pathParam);
+            const validationError = this.config.validatePathAccess(searchDirAbs);
+            if (validationError) {
+                return {
+                    llmContent: validationError,
+                    returnDisplay: 'Error: Path not in workspace.',
+                    error: {
+                        message: validationError,
+                        type: ToolErrorType.PATH_NOT_IN_WORKSPACE,
+                    },
+                };
+            }
+            // Check existence and type asynchronously
+            try {
+                const stats = await fsPromises.stat(searchDirAbs);
+                if (!stats.isDirectory() && !stats.isFile()) {
+                    return {
+                        llmContent: `Path is not a valid directory or file: ${searchDirAbs}`,
+                        returnDisplay: 'Error: Path is not a valid directory or file.',
+                    };
+                }
+            }
+            catch (error) {
+                if (isNodeError(error) && error.code === 'ENOENT') {
+                    return {
+                        llmContent: `Path does not exist: ${searchDirAbs}`,
+                        returnDisplay: 'Error: Path does not exist.',
+                        error: {
+                            message: `Path does not exist: ${searchDirAbs}`,
+                            type: ToolErrorType.FILE_NOT_FOUND,
+                        },
+                    };
+                }
+                return {
+                    llmContent: `Failed to access path stats for ${searchDirAbs}: ${getErrorMessage(error)}`,
+                    returnDisplay: 'Error: Failed to access path.',
+                };
+            }
+            const searchDirDisplay = pathParam;
+            const totalMaxMatches = DEFAULT_TOTAL_MAX_MATCHES;
+            if (this.config.getDebugMode()) {
+                debugLogger.log(`[GrepTool] Total result limit: ${totalMaxMatches}`);
+            }
+            // Create a timeout controller to prevent indefinitely hanging searches
+            const timeoutController = new AbortController();
+            const timeoutId = setTimeout(() => {
+                timeoutController.abort();
+            }, DEFAULT_SEARCH_TIMEOUT_MS);
+            // Link the passed signal to our timeout controller
+            const onAbort = () => timeoutController.abort();
+            if (signal.aborted) {
+                onAbort();
+            }
+            else {
+                signal.addEventListener('abort', onAbort, { once: true });
+            }
+            let allMatches;
+            try {
+                allMatches = await this.performRipgrepSearch({
+                    pattern: this.params.pattern,
+                    path: searchDirAbs,
+                    include: this.params.include,
+                    case_sensitive: this.params.case_sensitive,
+                    fixed_strings: this.params.fixed_strings,
+                    context: this.params.context,
+                    after: this.params.after,
+                    before: this.params.before,
+                    no_ignore: this.params.no_ignore,
+                    maxMatches: totalMaxMatches,
+                    signal: timeoutController.signal,
+                });
+            }
+            finally {
+                clearTimeout(timeoutId);
+                signal.removeEventListener('abort', onAbort);
+            }
+            if (!this.params.no_ignore) {
+                const uniqueFiles = Array.from(new Set(allMatches.map((m) => m.filePath)));
+                const absoluteFilePaths = uniqueFiles.map((f) => path.resolve(searchDirAbs, f));
+                const allowedFiles = this.fileDiscoveryService.filterFiles(absoluteFilePaths);
+                const allowedSet = new Set(allowedFiles);
+                allMatches = allMatches.filter((m) => allowedSet.has(path.resolve(searchDirAbs, m.filePath)));
+            }
+            const searchLocationDescription = `in path "${searchDirDisplay}"`;
+            if (allMatches.length === 0) {
+                const noMatchMsg = `No matches found for pattern "${this.params.pattern}" ${searchLocationDescription}${this.params.include ? ` (filter: "${this.params.include}")` : ''}.`;
+                return { llmContent: noMatchMsg, returnDisplay: `No matches found` };
+            }
+            const wasTruncated = allMatches.length >= totalMaxMatches;
+            const matchesByFile = allMatches.reduce((acc, match) => {
+                const fileKey = match.filePath;
+                if (!acc[fileKey]) {
+                    acc[fileKey] = [];
+                }
+                acc[fileKey].push(match);
+                acc[fileKey].sort((a, b) => a.lineNumber - b.lineNumber);
+                return acc;
+            }, {});
+            const matchCount = allMatches.length;
+            const matchTerm = matchCount === 1 ? 'match' : 'matches';
+            let llmContent = `Found ${matchCount} ${matchTerm} for pattern "${this.params.pattern}" ${searchLocationDescription}${this.params.include ? ` (filter: "${this.params.include}")` : ''}${wasTruncated ? ` (results limited to ${totalMaxMatches} matches for performance)` : ''}:\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}${wasTruncated ? ' (limited)' : ''}`,
+            };
+        }
+        catch (error) {
+            debugLogger.warn(`Error during GrepLogic execution: ${error}`);
+            const errorMessage = getErrorMessage(error);
+            return {
+                llmContent: `Error during grep search operation: ${errorMessage}`,
+                returnDisplay: `Error: ${errorMessage}`,
+            };
+        }
+    }
+    async performRipgrepSearch(options) {
+        const { pattern, path: absolutePath, include, case_sensitive, fixed_strings, context, after, before, no_ignore, maxMatches, } = options;
+        const rgArgs = ['--json'];
+        if (!case_sensitive) {
+            rgArgs.push('--ignore-case');
+        }
+        if (fixed_strings) {
+            rgArgs.push('--fixed-strings');
+            rgArgs.push(pattern);
+        }
+        else {
+            rgArgs.push('--regexp', pattern);
+        }
+        if (context) {
+            rgArgs.push('--context', context.toString());
+        }
+        if (after) {
+            rgArgs.push('--after-context', after.toString());
+        }
+        if (before) {
+            rgArgs.push('--before-context', before.toString());
+        }
+        if (no_ignore) {
+            rgArgs.push('--no-ignore');
+        }
+        if (include) {
+            rgArgs.push('--glob', include);
+        }
+        if (!no_ignore) {
+            const fileExclusions = new FileExclusions(this.config);
+            const excludes = fileExclusions.getGlobExcludes([
+                ...COMMON_DIRECTORY_EXCLUDES,
+                '*.log',
+                '*.tmp',
+            ]);
+            excludes.forEach((exclude) => {
+                rgArgs.push('--glob', `!${exclude}`);
+            });
+            // Add .geminiignore and custom ignore files support (if provided/mandated)
+            // (ripgrep natively handles .gitignore)
+            const geminiIgnorePaths = this.fileDiscoveryService.getIgnoreFilePaths();
+            for (const ignorePath of geminiIgnorePaths) {
+                rgArgs.push('--ignore-file', ignorePath);
+            }
+        }
+        rgArgs.push('--threads', '4');
+        rgArgs.push(absolutePath);
+        const results = [];
+        try {
+            const rgPath = await ensureRgPath();
+            const generator = execStreaming(rgPath, rgArgs, {
+                signal: options.signal,
+                allowedExitCodes: [0, 1],
+            });
+            for await (const line of generator) {
+                const match = this.parseRipgrepJsonLine(line, absolutePath);
+                if (match) {
+                    results.push(match);
+                    if (results.length >= maxMatches) {
+                        break;
+                    }
+                }
+            }
+            return results;
+        }
+        catch (error) {
+            debugLogger.debug(`GrepLogic: ripgrep failed: ${getErrorMessage(error)}`);
+            throw error;
+        }
+    }
+    parseRipgrepJsonLine(line, basePath) {
+        try {
+            const json = JSON.parse(line);
+            if (json.type === 'match') {
+                const match = json.data;
+                // Defensive check: ensure text properties exist (skips binary/invalid encoding)
+                if (match.path?.text && match.lines?.text) {
+                    const absoluteFilePath = path.resolve(basePath, match.path.text);
+                    const relativeCheck = path.relative(basePath, absoluteFilePath);
+                    if (relativeCheck === '..' ||
+                        relativeCheck.startsWith(`..${path.sep}`) ||
+                        path.isAbsolute(relativeCheck)) {
+                        return null;
+                    }
+                    const relativeFilePath = path.relative(basePath, absoluteFilePath);
+                    return {
+                        filePath: relativeFilePath || path.basename(absoluteFilePath),
+                        lineNumber: match.line_number,
+                        line: match.lines.text.trimEnd(),
+                    };
+                }
+            }
+        }
+        catch (error) {
+            // Only log if it's not a simple empty line or widely invalid
+            if (line.trim().length > 0) {
+                debugLogger.warn(`Failed to parse ripgrep JSON line: ${line.substring(0, 100)}...`, error);
+            }
+        }
+        return null;
+    }
+    /**
+     * Gets a description of the grep operation
+     * @param params Parameters for the grep operation
+     * @returns A string describing the grep
+     */
+    getDescription() {
+        let description = `'${this.params.pattern}'`;
+        if (this.params.include) {
+            description += ` in ${this.params.include}`;
+        }
+        const pathParam = this.params.dir_path || '.';
+        const resolvedPath = path.resolve(this.config.getTargetDir(), pathParam);
+        if (resolvedPath === this.config.getTargetDir() || pathParam === '.') {
+            description += ` within ./`;
+        }
+        else {
+            const relativePath = makeRelative(resolvedPath, this.config.getTargetDir());
+            description += ` within ${shortenPath(relativePath)}`;
+        }
+        return description;
+    }
+}
+/**
+ * Implementation of the Grep tool logic (moved from CLI)
+ */
+export class RipGrepTool extends BaseDeclarativeTool {
+    config;
+    static Name = GREP_TOOL_NAME;
+    fileDiscoveryService;
+    constructor(config, messageBus) {
+        super(RipGrepTool.Name, 'SearchText', 'FAST, optimized search powered by `ripgrep`. PREFERRED over standard `run_shell_command("grep ...")` due to better performance and automatic output limiting (max 20k matches).', Kind.Search, {
+            properties: {
+                pattern: {
+                    description: "The pattern to search for. By default, treated as a Rust-flavored regular expression. Use '\\b' for precise symbol matching (e.g., '\\bMatchMe\\b').",
+                    type: 'string',
+                },
+                dir_path: {
+                    description: "Directory or file to search. Directories are searched recursively. Relative paths are resolved against current working directory. Defaults to current working directory ('.') if omitted.",
+                    type: 'string',
+                },
+                include: {
+                    description: "Glob pattern to filter files (e.g., '*.ts', 'src/**'). Recommended for large repositories to reduce noise. Defaults to all files if omitted.",
+                    type: 'string',
+                },
+                case_sensitive: {
+                    description: 'If true, search is case-sensitive. Defaults to false (ignore case) if omitted.',
+                    type: 'boolean',
+                },
+                fixed_strings: {
+                    description: 'If true, treats the `pattern` as a literal string instead of a regular expression. Defaults to false (basic regex) if omitted.',
+                    type: 'boolean',
+                },
+                context: {
+                    description: 'Show this many lines of context around each match (equivalent to grep -C). Defaults to 0 if omitted.',
+                    type: 'integer',
+                },
+                after: {
+                    description: 'Show this many lines after each match (equivalent to grep -A). Defaults to 0 if omitted.',
+                    type: 'integer',
+                },
+                before: {
+                    description: 'Show this many lines before each match (equivalent to grep -B). Defaults to 0 if omitted.',
+                    type: 'integer',
+                },
+                no_ignore: {
+                    description: 'If true, searches all files including those usually ignored (like in .gitignore, build/, dist/, etc). Defaults to false if omitted.',
+                    type: 'boolean',
+                },
+            },
+            required: ['pattern'],
+            type: 'object',
+        }, messageBus, true, // isOutputMarkdown
+        false);
+        this.config = config;
+        this.fileDiscoveryService = new FileDiscoveryService(config.getTargetDir(), config.getFileFilteringOptions());
+    }
+    /**
+     * Validates the parameters for the tool
+     * @param params Parameters to validate
+     * @returns An error message string if invalid, null otherwise
+     */
+    validateToolParamValues(params) {
+        try {
+            new RegExp(params.pattern);
+        }
+        catch (error) {
+            return `Invalid regular expression pattern provided: ${params.pattern}. Error: ${getErrorMessage(error)}`;
+        }
+        // Only validate path if one is provided
+        if (params.dir_path) {
+            const resolvedPath = path.resolve(this.config.getTargetDir(), params.dir_path);
+            const validationError = this.config.validatePathAccess(resolvedPath);
+            if (validationError) {
+                return validationError;
+            }
+            // Check existence and type
+            try {
+                const stats = fs.statSync(resolvedPath);
+                if (!stats.isDirectory() && !stats.isFile()) {
+                    return `Path is not a valid directory or file: ${resolvedPath}`;
+                }
+            }
+            catch (error) {
+                if (isNodeError(error) && error.code === 'ENOENT') {
+                    return `Path does not exist: ${resolvedPath}`;
+                }
+                return `Failed to access path stats for ${resolvedPath}: ${getErrorMessage(error)}`;
+            }
+        }
+        return null; // Parameters are valid
+    }
+    createInvocation(params, messageBus, _toolName, _toolDisplayName) {
+        return new GrepToolInvocation(this.config, this.fileDiscoveryService, params, messageBus ?? this.messageBus, _toolName, _toolDisplayName);
+    }
+}
+//# sourceMappingURL=ripGrep.js.map

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

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

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

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../config/config.js';
+import type { ToolInvocation, ToolResult, ToolCallConfirmationDetails } from './tools.js';
+import { BaseDeclarativeTool, BaseToolInvocation, ToolConfirmationOutcome, type PolicyUpdateOptions } from './tools.js';
+import type { ShellExecutionConfig } from '../services/shellExecutionService.js';
+import type { AnsiOutput } from '../utils/terminalSerializer.js';
+import type { MessageBus } from '../confirmation-bus/message-bus.js';
+export declare const OUTPUT_UPDATE_INTERVAL_MS = 1000;
+export interface ShellToolParams {
+    command: string;
+    description?: string;
+    dir_path?: string;
+    is_background?: boolean;
+}
+export declare class ShellToolInvocation extends BaseToolInvocation<ShellToolParams, ToolResult> {
+    private readonly config;
+    constructor(config: Config, params: ShellToolParams, messageBus: MessageBus, _toolName?: string, _toolDisplayName?: string);
+    getDescription(): string;
+    protected getPolicyUpdateOptions(outcome: ToolConfirmationOutcome): PolicyUpdateOptions | undefined;
+    protected getConfirmationDetails(_abortSignal: AbortSignal): Promise<ToolCallConfirmationDetails | false>;
+    execute(signal: AbortSignal, updateOutput?: (output: string | AnsiOutput) => void, shellExecutionConfig?: ShellExecutionConfig, setPidCallback?: (pid: number) => void): Promise<ToolResult>;
+}
+export declare class ShellTool extends BaseDeclarativeTool<ShellToolParams, ToolResult> {
+    private readonly config;
+    static readonly Name = "run_shell_command";
+    constructor(config: Config, messageBus: MessageBus);
+    protected validateToolParamValues(params: ShellToolParams): string | null;
+    protected createInvocation(params: ShellToolParams, messageBus: MessageBus, _toolName?: string, _toolDisplayName?: string): ToolInvocation<ShellToolParams, ToolResult>;
+}