@anthropic-field/core 0.1.0

package/dist/src/tools/read-many-files.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { MessageBus } from '../confirmation-bus/message-bus.js';
+import type { ToolInvocation, ToolResult } from './tools.js';
+import { BaseDeclarativeTool } from './tools.js';
+import { type Config } from '../config/config.js';
+/**
+ * Parameters for the ReadManyFilesTool.
+ */
+export interface ReadManyFilesParams {
+    /**
+     * Glob patterns for files to include.
+     * Example: ["*.ts", "src/** /*.md"]
+     */
+    include: string[];
+    /**
+     * Optional. Glob patterns for files/directories to exclude.
+     * Applied as ignore patterns.
+     * Example: ["*.log", "dist/**"]
+     */
+    exclude?: string[];
+    /**
+     * Optional. Search directories recursively.
+     * This is generally controlled by glob patterns (e.g., `**`).
+     * The glob implementation is recursive by default for `**`.
+     * For simplicity, we'll rely on `**` for recursion.
+     */
+    recursive?: boolean;
+    /**
+     * Optional. Apply default exclusion patterns. Defaults to true.
+     */
+    useDefaultExcludes?: boolean;
+    /**
+     * Whether to respect .gitignore and .geminiignore patterns (optional, defaults to true)
+     */
+    file_filtering_options?: {
+        respect_git_ignore?: boolean;
+        respect_gemini_ignore?: boolean;
+    };
+}
+/**
+ * Tool implementation for finding and reading multiple text files from the local filesystem
+ * within a specified target directory. The content is concatenated.
+ * It is intended to run in an environment with access to the local file system (e.g., a Node.js backend).
+ */
+export declare class ReadManyFilesTool extends BaseDeclarativeTool<ReadManyFilesParams, ToolResult> {
+    private config;
+    static readonly Name = "read_many_files";
+    constructor(config: Config, messageBus: MessageBus);
+    protected createInvocation(params: ReadManyFilesParams, messageBus: MessageBus, _toolName?: string, _toolDisplayName?: string): ToolInvocation<ReadManyFilesParams, ToolResult>;
+}

package/dist/src/tools/read-many-files.js

@@ -0,0 +1,364 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, Kind } from './tools.js';
+import { getErrorMessage } from '../utils/errors.js';
+import * as fsPromises from 'node:fs/promises';
+import * as path from 'node:path';
+import { glob, escape } from 'glob';
+import { detectFileType, processSingleFileContent, DEFAULT_ENCODING, getSpecificMimeType, } from '../utils/fileUtils.js';
+import { DEFAULT_FILE_FILTERING_OPTIONS, } from '../config/config.js';
+import { FileOperation } from '../telemetry/metrics.js';
+import { getProgrammingLanguage } from '../telemetry/telemetry-utils.js';
+import { logFileOperation } from '../telemetry/loggers.js';
+import { FileOperationEvent } from '../telemetry/types.js';
+import { ToolErrorType } from './tool-error.js';
+import { READ_MANY_FILES_TOOL_NAME } from './tool-names.js';
+import { REFERENCE_CONTENT_END } from '../utils/constants.js';
+/**
+ * Creates the default exclusion patterns including dynamic patterns.
+ * This combines the shared patterns with dynamic patterns like GEMINI.md.
+ * TODO(adh): Consider making this configurable or extendable through a command line argument.
+ */
+function getDefaultExcludes(config) {
+    return config?.getFileExclusions().getReadManyFilesExcludes() ?? [];
+}
+const DEFAULT_OUTPUT_SEPARATOR_FORMAT = '--- {filePath} ---';
+const DEFAULT_OUTPUT_TERMINATOR = `\n${REFERENCE_CONTENT_END}`;
+class ReadManyFilesToolInvocation extends BaseToolInvocation {
+    config;
+    constructor(config, params, messageBus, _toolName, _toolDisplayName) {
+        super(params, messageBus, _toolName, _toolDisplayName);
+        this.config = config;
+    }
+    getDescription() {
+        const pathDesc = `using patterns: 
+${this.params.include.join('`, `')}
+ (within target directory: 
+${this.config.getTargetDir()}
+) `;
+        // Determine the final list of exclusion patterns exactly as in execute method
+        const paramExcludes = this.params.exclude || [];
+        const paramUseDefaultExcludes = this.params.useDefaultExcludes !== false;
+        const finalExclusionPatternsForDescription = paramUseDefaultExcludes
+            ? [...getDefaultExcludes(this.config), ...paramExcludes]
+            : [...paramExcludes];
+        const excludeDesc = `Excluding: ${finalExclusionPatternsForDescription.length > 0
+            ? `patterns like 
+${finalExclusionPatternsForDescription
+                .slice(0, 2)
+                .join('`, `')}${finalExclusionPatternsForDescription.length > 2 ? '...`' : '`'}`
+            : 'none specified'}`;
+        return `Will attempt to read and concatenate files ${pathDesc}. ${excludeDesc}. File encoding: ${DEFAULT_ENCODING}. Separator: "${DEFAULT_OUTPUT_SEPARATOR_FORMAT.replace('{filePath}', 'path/to/file.ext')}".`;
+    }
+    async execute(signal) {
+        const { include, exclude = [], useDefaultExcludes = true } = this.params;
+        const filesToConsider = new Set();
+        const skippedFiles = [];
+        const processedFilesRelativePaths = [];
+        const contentParts = [];
+        const effectiveExcludes = useDefaultExcludes
+            ? [...getDefaultExcludes(this.config), ...exclude]
+            : [...exclude];
+        try {
+            const allEntries = new Set();
+            const workspaceDirs = this.config.getWorkspaceContext().getDirectories();
+            for (const dir of workspaceDirs) {
+                const processedPatterns = [];
+                for (const p of include) {
+                    const normalizedP = p.replace(/\\/g, '/');
+                    const fullPath = path.join(dir, normalizedP);
+                    let exists = false;
+                    try {
+                        await fsPromises.access(fullPath);
+                        exists = true;
+                    }
+                    catch {
+                        exists = false;
+                    }
+                    if (exists) {
+                        processedPatterns.push(escape(normalizedP));
+                    }
+                    else {
+                        // The path does not exist or is not a file, so we treat it as a glob pattern.
+                        processedPatterns.push(normalizedP);
+                    }
+                }
+                const entriesInDir = await glob(processedPatterns, {
+                    cwd: dir,
+                    ignore: effectiveExcludes,
+                    nodir: true,
+                    dot: true,
+                    absolute: true,
+                    nocase: true,
+                    signal,
+                });
+                for (const entry of entriesInDir) {
+                    allEntries.add(entry);
+                }
+            }
+            const relativeEntries = Array.from(allEntries).map((p) => path.relative(this.config.getTargetDir(), p));
+            const fileDiscovery = this.config.getFileService();
+            const { filteredPaths, ignoredCount } = fileDiscovery.filterFilesWithReport(relativeEntries, {
+                respectGitIgnore: this.params.file_filtering_options?.respect_git_ignore ??
+                    this.config.getFileFilteringOptions().respectGitIgnore ??
+                    DEFAULT_FILE_FILTERING_OPTIONS.respectGitIgnore,
+                respectGeminiIgnore: this.params.file_filtering_options?.respect_gemini_ignore ??
+                    this.config.getFileFilteringOptions().respectGeminiIgnore ??
+                    DEFAULT_FILE_FILTERING_OPTIONS.respectGeminiIgnore,
+            });
+            for (const relativePath of filteredPaths) {
+                // Security check: ensure the glob library didn't return something outside the workspace.
+                const fullPath = path.resolve(this.config.getTargetDir(), relativePath);
+                const validationError = this.config.validatePathAccess(fullPath);
+                if (validationError) {
+                    skippedFiles.push({
+                        path: fullPath,
+                        reason: 'Security: Path not in workspace',
+                    });
+                    continue;
+                }
+                filesToConsider.add(fullPath);
+            }
+            // Add info about ignored files if any were filtered
+            if (ignoredCount > 0) {
+                skippedFiles.push({
+                    path: `${ignoredCount} file(s)`,
+                    reason: 'ignored by project ignore files',
+                });
+            }
+        }
+        catch (error) {
+            const errorMessage = `Error during file search: ${getErrorMessage(error)}`;
+            return {
+                llmContent: errorMessage,
+                returnDisplay: `## File Search Error\n\nAn error occurred while searching for files:\n\`\`\`\n${getErrorMessage(error)}\n\`\`\``,
+                error: {
+                    message: errorMessage,
+                    type: ToolErrorType.READ_MANY_FILES_SEARCH_ERROR,
+                },
+            };
+        }
+        const sortedFiles = Array.from(filesToConsider).sort();
+        const fileProcessingPromises = sortedFiles.map(async (filePath) => {
+            try {
+                const relativePathForDisplay = path
+                    .relative(this.config.getTargetDir(), filePath)
+                    .replace(/\\/g, '/');
+                const fileType = await detectFileType(filePath);
+                if (fileType === 'image' ||
+                    fileType === 'pdf' ||
+                    fileType === 'audio') {
+                    const fileExtension = path.extname(filePath).toLowerCase();
+                    const fileNameWithoutExtension = path.basename(filePath, fileExtension);
+                    const requestedExplicitly = include.some((pattern) => pattern.toLowerCase().includes(fileExtension) ||
+                        pattern.includes(fileNameWithoutExtension));
+                    if (!requestedExplicitly) {
+                        return {
+                            success: false,
+                            filePath,
+                            relativePathForDisplay,
+                            reason: 'asset file (image/pdf/audio) was not explicitly requested by name or extension',
+                        };
+                    }
+                }
+                // Use processSingleFileContent for all file types now
+                const fileReadResult = await processSingleFileContent(filePath, this.config.getTargetDir(), this.config.getFileSystemService());
+                if (fileReadResult.error) {
+                    return {
+                        success: false,
+                        filePath,
+                        relativePathForDisplay,
+                        reason: `Read error: ${fileReadResult.error}`,
+                    };
+                }
+                return {
+                    success: true,
+                    filePath,
+                    relativePathForDisplay,
+                    fileReadResult,
+                };
+            }
+            catch (error) {
+                const relativePathForDisplay = path
+                    .relative(this.config.getTargetDir(), filePath)
+                    .replace(/\\/g, '/');
+                return {
+                    success: false,
+                    filePath,
+                    relativePathForDisplay,
+                    reason: `Unexpected error: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        });
+        const results = await Promise.allSettled(fileProcessingPromises);
+        for (const result of results) {
+            if (result.status === 'fulfilled') {
+                const fileResult = result.value;
+                if (!fileResult.success) {
+                    // Handle skipped files (images/PDFs not requested or read errors)
+                    skippedFiles.push({
+                        path: fileResult.relativePathForDisplay,
+                        reason: fileResult.reason,
+                    });
+                }
+                else {
+                    // Handle successfully processed files
+                    const { filePath, relativePathForDisplay, fileReadResult } = fileResult;
+                    if (typeof fileReadResult.llmContent === 'string') {
+                        const separator = DEFAULT_OUTPUT_SEPARATOR_FORMAT.replace('{filePath}', filePath);
+                        let fileContentForLlm = '';
+                        if (fileReadResult.isTruncated) {
+                            fileContentForLlm += `[WARNING: This file was truncated. To view the full content, use the 'read_file' tool on this specific file.]\n\n`;
+                        }
+                        fileContentForLlm += fileReadResult.llmContent;
+                        contentParts.push(`${separator}\n\n${fileContentForLlm}\n\n`);
+                    }
+                    else {
+                        // This is a Part for image/pdf, which we don't add the separator to.
+                        contentParts.push(fileReadResult.llmContent);
+                    }
+                    processedFilesRelativePaths.push(relativePathForDisplay);
+                    const lines = typeof fileReadResult.llmContent === 'string'
+                        ? fileReadResult.llmContent.split('\n').length
+                        : undefined;
+                    const mimetype = getSpecificMimeType(filePath);
+                    const programming_language = getProgrammingLanguage({
+                        file_path: filePath,
+                    });
+                    logFileOperation(this.config, new FileOperationEvent(READ_MANY_FILES_TOOL_NAME, FileOperation.READ, lines, mimetype, path.extname(filePath), programming_language));
+                }
+            }
+            else {
+                // Handle Promise rejection (unexpected errors)
+                skippedFiles.push({
+                    path: 'unknown',
+                    reason: `Unexpected error: ${result.reason}`,
+                });
+            }
+        }
+        let displayMessage = `### ReadManyFiles Result (Target Dir: \`${this.config.getTargetDir()}\`)\n\n`;
+        if (processedFilesRelativePaths.length > 0) {
+            displayMessage += `Successfully read and concatenated content from **${processedFilesRelativePaths.length} file(s)**.\n`;
+            if (processedFilesRelativePaths.length <= 10) {
+                displayMessage += `\n**Processed Files:**\n`;
+                processedFilesRelativePaths.forEach((p) => (displayMessage += `- \`${p}\`\n`));
+            }
+            else {
+                displayMessage += `\n**Processed Files (first 10 shown):**\n`;
+                processedFilesRelativePaths
+                    .slice(0, 10)
+                    .forEach((p) => (displayMessage += `- \`${p}\`\n`));
+                displayMessage += `- ...and ${processedFilesRelativePaths.length - 10} more.\n`;
+            }
+        }
+        if (skippedFiles.length > 0) {
+            if (processedFilesRelativePaths.length === 0) {
+                displayMessage += `No files were read and concatenated based on the criteria.\n`;
+            }
+            if (skippedFiles.length <= 5) {
+                displayMessage += `\n**Skipped ${skippedFiles.length} item(s):**\n`;
+            }
+            else {
+                displayMessage += `\n**Skipped ${skippedFiles.length} item(s) (first 5 shown):**\n`;
+            }
+            skippedFiles
+                .slice(0, 5)
+                .forEach((f) => (displayMessage += `- \`${f.path}\` (Reason: ${f.reason})\n`));
+            if (skippedFiles.length > 5) {
+                displayMessage += `- ...and ${skippedFiles.length - 5} more.\n`;
+            }
+        }
+        else if (processedFilesRelativePaths.length === 0 &&
+            skippedFiles.length === 0) {
+            displayMessage += `No files were read and concatenated based on the criteria.\n`;
+        }
+        if (contentParts.length > 0) {
+            contentParts.push(DEFAULT_OUTPUT_TERMINATOR);
+        }
+        else {
+            contentParts.push('No files matching the criteria were found or all were skipped.');
+        }
+        return {
+            llmContent: contentParts,
+            returnDisplay: displayMessage.trim(),
+        };
+    }
+}
+/**
+ * Tool implementation for finding and reading multiple text files from the local filesystem
+ * within a specified target directory. The content is concatenated.
+ * It is intended to run in an environment with access to the local file system (e.g., a Node.js backend).
+ */
+export class ReadManyFilesTool extends BaseDeclarativeTool {
+    config;
+    static Name = READ_MANY_FILES_TOOL_NAME;
+    constructor(config, messageBus) {
+        const parameterSchema = {
+            type: 'object',
+            properties: {
+                include: {
+                    type: 'array',
+                    items: {
+                        type: 'string',
+                        minLength: 1,
+                    },
+                    minItems: 1,
+                    description: 'An array of glob patterns or paths. Examples: ["src/**/*.ts"], ["README.md", "docs/"]',
+                },
+                exclude: {
+                    type: 'array',
+                    items: {
+                        type: 'string',
+                        minLength: 1,
+                    },
+                    description: 'Optional. Glob patterns for files/directories to exclude. Added to default excludes if useDefaultExcludes is true. Example: "**/*.log", "temp/"',
+                    default: [],
+                },
+                recursive: {
+                    type: 'boolean',
+                    description: 'Optional. Whether to search recursively (primarily controlled by `**` in glob patterns). Defaults to true.',
+                    default: true,
+                },
+                useDefaultExcludes: {
+                    type: 'boolean',
+                    description: 'Optional. Whether to apply a list of default exclusion patterns (e.g., node_modules, .git, binary files). Defaults to true.',
+                    default: true,
+                },
+                file_filtering_options: {
+                    description: 'Whether to respect ignore patterns from .gitignore or .geminiignore',
+                    type: 'object',
+                    properties: {
+                        respect_git_ignore: {
+                            description: 'Optional: Whether to respect .gitignore patterns when listing files. Only available in git repositories. Defaults to true.',
+                            type: 'boolean',
+                        },
+                        respect_gemini_ignore: {
+                            description: 'Optional: Whether to respect .geminiignore patterns when listing files. Defaults to true.',
+                            type: 'boolean',
+                        },
+                    },
+                },
+            },
+            required: ['include'],
+        };
+        super(ReadManyFilesTool.Name, 'ReadManyFiles', `Reads content from multiple files specified by glob patterns within a configured target directory. For text files, it concatenates their content into a single string. It is primarily designed for text-based files. However, it can also process image (e.g., .png, .jpg), audio (e.g., .mp3, .wav), and PDF (.pdf) files if their file names or extensions are explicitly included in the 'include' argument. For these explicitly requested non-text files, their data is read and included in a format suitable for model consumption (e.g., base64 encoded).
+
+This tool is useful when you need to understand or analyze a collection of files, such as:
+- Getting an overview of a codebase or parts of it (e.g., all TypeScript files in the 'src' directory).
+- Finding where specific functionality is implemented if the user asks broad questions about code.
+- Reviewing documentation files (e.g., all Markdown files in the 'docs' directory).
+- Gathering context from multiple configuration files.
+- When the user asks to "read all files in X directory" or "show me the content of all Y files".
+
+Use this tool when the user's query implies needing the content of several files simultaneously for context, analysis, or summarization. For text files, it uses default UTF-8 encoding and a '--- {filePath} ---' separator between file contents. The tool inserts a '${REFERENCE_CONTENT_END}' after the last file. Ensure glob patterns are relative to the target directory. Glob patterns like 'src/**/*.js' are supported. Avoid using for single files if a more specific single-file reading tool is available, unless the user specifically requests to process a list containing just one file via this tool. Other binary files (not explicitly requested as image/audio/PDF) are generally skipped. Default excludes apply to common non-text files (except for explicitly requested images/audio/PDFs) and large dependency directories unless 'useDefaultExcludes' is false.`, Kind.Read, parameterSchema, messageBus, true, // isOutputMarkdown
+        false);
+        this.config = config;
+    }
+    createInvocation(params, messageBus, _toolName, _toolDisplayName) {
+        return new ReadManyFilesToolInvocation(this.config, params, messageBus, _toolName, _toolDisplayName);
+    }
+}
+//# sourceMappingURL=read-many-files.js.map

package/dist/src/tools/read-many-files.js.map

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

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

@@ -0,0 +1,74 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { MessageBus } from '../confirmation-bus/message-bus.js';
+import type { ToolInvocation, ToolResult } from './tools.js';
+import { BaseDeclarativeTool } from './tools.js';
+import type { Config } from '../config/config.js';
+/**
+ * Checks if `rg` exists, if not then attempt to download it.
+ */
+export declare function canUseRipgrep(): Promise<boolean>;
+/**
+ * Ensures `rg` is downloaded, or throws.
+ */
+export declare function ensureRgPath(): Promise<string>;
+/**
+ * Parameters for the GrepTool
+ */
+export interface RipGrepToolParams {
+    /**
+     * 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)
+     */
+    dir_path?: string;
+    /**
+     * File pattern to include in the search (e.g. "*.js", "*.{ts,tsx}")
+     */
+    include?: string;
+    /**
+     * If true, searches case-sensitively. Defaults to false.
+     */
+    case_sensitive?: boolean;
+    /**
+     * If true, treats pattern as a literal string. Defaults to false.
+     */
+    fixed_strings?: boolean;
+    /**
+     * Show num lines of context around each match.
+     */
+    context?: number;
+    /**
+     * Show num lines after each match.
+     */
+    after?: number;
+    /**
+     * Show num lines before each match.
+     */
+    before?: number;
+    /**
+     * If true, does not respect .gitignore or default ignores (like build/dist).
+     */
+    no_ignore?: boolean;
+}
+/**
+ * Implementation of the Grep tool logic (moved from CLI)
+ */
+export declare class RipGrepTool extends BaseDeclarativeTool<RipGrepToolParams, ToolResult> {
+    private readonly config;
+    static readonly Name = "search_file_content";
+    private readonly fileDiscoveryService;
+    constructor(config: Config, messageBus: MessageBus);
+    /**
+     * Validates the parameters for the tool
+     * @param params Parameters to validate
+     * @returns An error message string if invalid, null otherwise
+     */
+    protected validateToolParamValues(params: RipGrepToolParams): string | null;
+    protected createInvocation(params: RipGrepToolParams, messageBus: MessageBus, _toolName?: string, _toolDisplayName?: string): ToolInvocation<RipGrepToolParams, ToolResult>;
+}