@vybestack/llxprt-code-tools 0.10.0-nightly.260613.1adad3b34

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

@@ -0,0 +1,529 @@
+/**
+ * @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 fs from 'fs';
+import * as path from 'path';
+import { glob, escape as globEscape } from 'glob';
+import { detectFileType, processSingleFileContent, DEFAULT_ENCODING, getSpecificMimeType, DEFAULT_MAX_LINES_TEXT_FILE, } from '../utils/fileUtils.js';
+import { stat } from 'fs/promises';
+import { ToolErrorType } from '../types/tool-error.js';
+import { validatePathWithinWorkspace } from '../utils/pathValidation.js';
+// Simple token estimation - roughly 4 characters per token
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Creates the default exclusion patterns including dynamic patterns.
+ * This combines the shared patterns with dynamic patterns like LLXPRT.md.
+ * Task(adh): Consider making this configurable or extendable through a command line argument.
+ */
+function getDefaultExcludes(host) {
+    return host?.getReadManyFilesExclusions() ?? [];
+}
+const DEFAULT_OUTPUT_SEPARATOR_FORMAT = '--- {filePath} ---';
+const DEFAULT_OUTPUT_TERMINATOR = '\n--- End of content ---';
+// Default limits for ReadManyFiles
+const DEFAULT_MAX_FILE_COUNT = 50;
+const DEFAULT_MAX_TOKENS = 50000;
+const DEFAULT_TRUNCATE_MODE = 'warn';
+const DEFAULT_FILE_SIZE_LIMIT = 524288; // 512KB
+class ReadManyFilesToolInvocation extends BaseToolInvocation {
+    host;
+    llxprtIgnorePatterns = [];
+    constructor(host, params, messageBus) {
+        super(params, messageBus);
+        this.host = host;
+        this.llxprtIgnorePatterns = host.getLlxprtIgnorePatterns();
+    }
+    getDescription() {
+        const allPatterns = [...this.params.paths, ...(this.params.include ?? [])];
+        const pathDesc = `using patterns: 
+${allPatterns.join('`, `')}
+ (within target directory: 
+${this.host.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.host), ...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 { paths: inputPatterns, include = [], exclude = [], useDefaultExcludes = true, } = this.params;
+        const { fileFilteringOptions, fileDiscovery, effectiveExcludes } = this.resolveFileParams(useDefaultExcludes, exclude);
+        const filesToConsider = new Set();
+        const skippedFiles = [];
+        const processedFilesRelativePaths = [];
+        const contentParts = [];
+        const searchResult = await this.discoverFiles(inputPatterns, include, effectiveExcludes, fileFilteringOptions, fileDiscovery, filesToConsider, skippedFiles, signal);
+        if (searchResult) {
+            return searchResult;
+        }
+        const sortedFiles = Array.from(filesToConsider).sort();
+        const limits = this.resolveLimits();
+        const fileCountResult = this.applyFileCountLimit(sortedFiles, skippedFiles, limits);
+        if (fileCountResult) {
+            return fileCountResult;
+        }
+        return this.processAndFormat(sortedFiles, inputPatterns, skippedFiles, processedFilesRelativePaths, contentParts, limits);
+    }
+    resolveFileParams(useDefaultExcludes, exclude) {
+        const defaultFileIgnores = this.host.getFileFilteringOptions();
+        const fileFilteringOptions = {
+            respectGitIgnore: this.params.file_filtering_options?.respect_git_ignore ??
+                defaultFileIgnores.respectGitIgnore,
+            respectLlxprtIgnore: this.params.file_filtering_options?.respect_llxprt_ignore ??
+                defaultFileIgnores.respectLlxprtIgnore,
+        };
+        const fileDiscovery = this.host.getFileService();
+        const effectiveExcludes = useDefaultExcludes
+            ? [
+                ...getDefaultExcludes(this.host),
+                ...exclude,
+                ...this.llxprtIgnorePatterns,
+            ]
+            : [...exclude, ...this.llxprtIgnorePatterns];
+        return { fileFilteringOptions, fileDiscovery, effectiveExcludes };
+    }
+    async processAndFormat(sortedFiles, inputPatterns, skippedFiles, processedFilesRelativePaths, contentParts, limits) {
+        const totalTokens = await this.processFiles(sortedFiles, inputPatterns, skippedFiles, processedFilesRelativePaths, contentParts, limits);
+        const displayMessage = this.buildDisplayMessage(processedFilesRelativePaths, skippedFiles, totalTokens);
+        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(),
+        };
+    }
+    async discoverFiles(inputPatterns, include, effectiveExcludes, fileFilteringOptions, fileDiscovery, filesToConsider, skippedFiles, signal) {
+        const searchPatterns = [...inputPatterns, ...include];
+        try {
+            const allEntries = new Set();
+            const workspaceDirs = this.host.getWorkspaceRoots();
+            for (const dir of workspaceDirs) {
+                const processedPatterns = this.processSearchPatterns(dir, searchPatterns);
+                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);
+                }
+            }
+            this.filterEntries(Array.from(allEntries), fileFilteringOptions, fileDiscovery, filesToConsider, skippedFiles);
+        }
+        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,
+                },
+            };
+        }
+        return undefined;
+    }
+    processSearchPatterns(dir, searchPatterns) {
+        const processedPatterns = [];
+        for (const p of searchPatterns) {
+            const normalizedP = p.replace(/\\/g, '/');
+            const fullPath = path.join(dir, normalizedP);
+            if (fs.existsSync(fullPath)) {
+                processedPatterns.push(globEscape(normalizedP));
+            }
+            else {
+                processedPatterns.push(normalizedP);
+            }
+        }
+        return processedPatterns;
+    }
+    filterEntries(entries, fileFilteringOptions, fileDiscovery, filesToConsider, skippedFiles) {
+        let gitIgnoredCount = 0;
+        let llxprtIgnoredCount = 0;
+        // eslint-disable-next-line sonarjs/too-many-break-or-continue-in-loop -- Existing structure is intentionally preserved; refactoring this boundary is outside the lint slice.
+        for (const absoluteFilePath of entries) {
+            const pathError = validatePathWithinWorkspace(this.host.getWorkspaceRoots(), absoluteFilePath);
+            if (pathError) {
+                skippedFiles.push({
+                    path: absoluteFilePath,
+                    reason: 'Security: ' + pathError,
+                });
+                continue;
+            }
+            const normalizedPath = path.normalize(absoluteFilePath);
+            if (fileFilteringOptions.respectGitIgnore &&
+                fileDiscovery.shouldGitIgnoreFile(absoluteFilePath)) {
+                gitIgnoredCount++;
+                continue;
+            }
+            if (fileFilteringOptions.respectLlxprtIgnore &&
+                fileDiscovery.shouldLlxprtIgnoreFile(absoluteFilePath)) {
+                llxprtIgnoredCount++;
+                continue;
+            }
+            filesToConsider.add(normalizedPath);
+        }
+        if (gitIgnoredCount > 0) {
+            skippedFiles.push({
+                path: `${gitIgnoredCount} file(s)`,
+                reason: 'git ignored',
+            });
+        }
+        if (llxprtIgnoredCount > 0) {
+            skippedFiles.push({
+                path: `${llxprtIgnoredCount} file(s)`,
+                reason: 'llxprt ignored',
+            });
+        }
+    }
+    resolveLimits() {
+        const ephemeralSettings = this.host.getEphemeralSettings();
+        return {
+            maxFileCount: ephemeralSettings['tool-output-max-items'] ??
+                DEFAULT_MAX_FILE_COUNT,
+            maxTokens: ephemeralSettings['tool-output-max-tokens'] ??
+                DEFAULT_MAX_TOKENS,
+            truncateMode: ephemeralSettings['tool-output-truncate-mode'] ?? DEFAULT_TRUNCATE_MODE,
+            fileSizeLimit: ephemeralSettings['tool-output-item-size-limit'] ?? DEFAULT_FILE_SIZE_LIMIT,
+        };
+    }
+    applyFileCountLimit(sortedFiles, skippedFiles, limits) {
+        if (sortedFiles.length <= limits.maxFileCount) {
+            return undefined;
+        }
+        if (limits.truncateMode === 'warn') {
+            const warnMessage = `Found ${sortedFiles.length} files matching your pattern, but limiting to ${limits.maxFileCount} files. Please use more specific patterns to narrow your search.`;
+            return {
+                llmContent: warnMessage,
+                returnDisplay: `## File Count Limit Exceeded\n\n${warnMessage}\n\n**Matched files:** ${sortedFiles.length}\n**Limit:** ${limits.maxFileCount}\n\n**Suggestion:** Use more specific glob patterns or paths to reduce the number of matched files.`,
+            };
+        }
+        else if (limits.truncateMode === 'sample') {
+            const step = Math.ceil(sortedFiles.length / limits.maxFileCount);
+            const sampledFiles = [];
+            for (let i = 0; i < sortedFiles.length; i += step) {
+                if (sampledFiles.length < limits.maxFileCount) {
+                    sampledFiles.push(sortedFiles[i]);
+                }
+            }
+            const originalCount = sortedFiles.length;
+            sortedFiles.length = 0;
+            sortedFiles.push(...sampledFiles);
+            skippedFiles.push({
+                path: `${originalCount - sampledFiles.length} file(s)`,
+                reason: `sampling to stay within ${limits.maxFileCount} file limit`,
+            });
+        }
+        else {
+            const truncatedCount = sortedFiles.length - limits.maxFileCount;
+            sortedFiles.length = limits.maxFileCount;
+            skippedFiles.push({
+                path: `${truncatedCount} file(s)`,
+                reason: `truncated to stay within ${limits.maxFileCount} file limit`,
+            });
+        }
+        return undefined;
+    }
+    async processFiles(sortedFiles, inputPatterns, skippedFiles, processedFilesRelativePaths, contentParts, limits) {
+        let totalTokens = 0;
+        // eslint-disable-next-line sonarjs/too-many-break-or-continue-in-loop -- Existing structure is intentionally preserved; refactoring this boundary is outside the lint slice.
+        for (const filePath of sortedFiles) {
+            const relativePathForDisplay = path
+                .relative(this.host.getTargetDir(), filePath)
+                .replace(/\\/g, '/');
+            const sizeCheck = await this.checkFileSize(filePath, relativePathForDisplay, skippedFiles, limits.fileSizeLimit);
+            if (sizeCheck === 'skip')
+                continue;
+            const assetCheck = await this.checkAssetFile(filePath, relativePathForDisplay, inputPatterns, skippedFiles);
+            if (assetCheck === 'skip')
+                continue;
+            const fileReadResult = await this.readFileContent(filePath);
+            if (fileReadResult.error) {
+                skippedFiles.push({
+                    path: relativePathForDisplay,
+                    reason: `Read error: ${fileReadResult.error}`,
+                });
+                continue;
+            }
+            const addResult = this.addFileContent(fileReadResult, filePath, relativePathForDisplay, skippedFiles, processedFilesRelativePaths, contentParts, limits, totalTokens, sortedFiles);
+            if (addResult.action === 'stop') {
+                return addResult.totalTokens;
+            }
+            totalTokens = addResult.totalTokens;
+            processedFilesRelativePaths.push(relativePathForDisplay);
+            this.recordReadMetric(filePath, fileReadResult.llmContent);
+            if (addResult.action === 'stopAfterRecord') {
+                return totalTokens;
+            }
+        }
+        return totalTokens;
+    }
+    async checkFileSize(filePath, relativePathForDisplay, skippedFiles, fileSizeLimit) {
+        try {
+            const stats = await stat(filePath);
+            if (stats.size > fileSizeLimit) {
+                skippedFiles.push({
+                    path: relativePathForDisplay,
+                    reason: `file size (${Math.round(stats.size / 1024)}KB) exceeds limit (${Math.round(fileSizeLimit / 1024)}KB)`,
+                });
+                return 'skip';
+            }
+        }
+        catch (error) {
+            skippedFiles.push({
+                path: relativePathForDisplay,
+                reason: `stat error: ${getErrorMessage(error)}`,
+            });
+            return 'skip';
+        }
+        return 'continue';
+    }
+    async checkAssetFile(filePath, relativePathForDisplay, inputPatterns, skippedFiles) {
+        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 = inputPatterns.some((pattern) => pattern.toLowerCase().includes(fileExtension) ||
+                pattern.includes(fileNameWithoutExtension));
+            if (!requestedExplicitly) {
+                skippedFiles.push({
+                    path: relativePathForDisplay,
+                    reason: 'asset file (image/pdf/audio) was not explicitly requested by name or extension',
+                });
+                return 'skip';
+            }
+        }
+        return 'continue';
+    }
+    async readFileContent(filePath) {
+        const maxLinesPerFile = this.host.getEphemeralSettings()['file-read-max-lines'] ?? DEFAULT_MAX_LINES_TEXT_FILE;
+        return processSingleFileContent(filePath, this.host.getTargetDir(), undefined, maxLinesPerFile);
+    }
+    addFileContent(fileReadResult, filePath, relativePathForDisplay, skippedFiles, _processedFilesRelativePaths, contentParts, limits, totalTokens, sortedFiles) {
+        if (typeof fileReadResult.llmContent === 'string') {
+            return this.addTextFileContent(fileReadResult, filePath, relativePathForDisplay, skippedFiles, contentParts, limits, totalTokens, sortedFiles, _processedFilesRelativePaths);
+        }
+        // Non-text content (images/PDFs)
+        const estimatedTokens = 85;
+        if (totalTokens + estimatedTokens > limits.maxTokens) {
+            skippedFiles.push({
+                path: relativePathForDisplay,
+                reason: 'would exceed token limit (non-text content)',
+            });
+            return { totalTokens, action: 'continue' };
+        }
+        totalTokens += estimatedTokens;
+        contentParts.push(fileReadResult.llmContent);
+        return { totalTokens, action: 'continue' };
+    }
+    addTextFileContent(fileReadResult, filePath, relativePathForDisplay, skippedFiles, contentParts, limits, totalTokens, sortedFiles, processedFilesRelativePaths) {
+        const separator = DEFAULT_OUTPUT_SEPARATOR_FORMAT.replace('{filePath}', filePath);
+        let fileContentForLlm = '';
+        if (fileReadResult.isTruncated === true) {
+            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;
+        const contentToAdd = `${separator}\n\n${fileContentForLlm}\n\n`;
+        const contentTokens = estimateTokens(contentToAdd);
+        if (totalTokens + contentTokens > limits.maxTokens) {
+            return this.handleTokenOverflow(limits, relativePathForDisplay, sortedFiles, processedFilesRelativePaths, contentParts, contentToAdd, totalTokens, skippedFiles);
+        }
+        totalTokens += contentTokens;
+        contentParts.push(contentToAdd);
+        return { totalTokens, action: 'continue' };
+    }
+    handleTokenOverflow(limits, relativePathForDisplay, sortedFiles, processedFilesRelativePaths, contentParts, contentToAdd, totalTokens, skippedFiles) {
+        if (limits.truncateMode === 'warn') {
+            skippedFiles.push({
+                path: `${sortedFiles.length - processedFilesRelativePaths.length} remaining file(s)`,
+                reason: `would exceed token limit of ${limits.maxTokens}`,
+            });
+            return { totalTokens, action: 'stop' };
+        }
+        else if (limits.truncateMode === 'truncate') {
+            const remainingTokens = limits.maxTokens - totalTokens;
+            if (remainingTokens > 100) {
+                const truncatedContent = contentToAdd.substring(0, remainingTokens * 4);
+                const finalContent = truncatedContent + '\n\n[CONTENT TRUNCATED DUE TO TOKEN LIMIT]';
+                contentParts.push(finalContent);
+                const updatedTokens = totalTokens + estimateTokens(finalContent);
+                skippedFiles.push({
+                    path: relativePathForDisplay,
+                    reason: 'content truncated to fit token limit',
+                });
+                return { totalTokens: updatedTokens, action: 'stopAfterRecord' };
+            }
+            return { totalTokens, action: 'stop' };
+        }
+        skippedFiles.push({
+            path: relativePathForDisplay,
+            reason: 'skipped to stay within token limit',
+        });
+        return { totalTokens, action: 'continue' };
+    }
+    recordReadMetric(filePath, llmContent) {
+        const lines = typeof llmContent === 'string'
+            ? llmContent.split('\n').length
+            : undefined;
+        const mimetype = getSpecificMimeType(filePath);
+        this.host.recordFileRead(filePath, lines, mimetype);
+    }
+    buildDisplayMessage(processedFilesRelativePaths, skippedFiles, totalTokens) {
+        let displayMessage = `### ReadManyFiles Result (Target Dir: \`${this.host.getTargetDir()}\`)\n\n`;
+        if (processedFilesRelativePaths.length > 0) {
+            displayMessage += `Successfully read and concatenated content from **${processedFilesRelativePaths.length} file(s)**`;
+            if (totalTokens > 0) {
+                displayMessage += ` (approximately ${totalTokens.toLocaleString()} tokens)`;
+            }
+            displayMessage += `.\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`;
+        }
+        return displayMessage;
+    }
+}
+/**
+ * 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 {
+    host;
+    static Name = 'read_many_files';
+    constructor(host) {
+        super(ReadManyFilesTool.Name, 'ReadManyFiles', `Reads content from multiple files specified by paths or 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 'paths' 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 '--- End of content ---' after the last file. Ensure paths 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.
+
+IMPORTANT LIMITS:
+- Maximum files: 50 (default, configurable via 'tool-output-max-items' setting)
+- Maximum tokens: 50,000 (default, configurable via 'tool-output-max-tokens' setting)  
+- Maximum file size: 512KB per file (configurable via 'tool-output-item-size-limit' setting)
+- If limits are exceeded, the tool will warn and suggest more specific patterns (configurable behavior via 'tool-output-truncate-mode')`, Kind.Read, buildParameterSchema());
+        this.host = host;
+    }
+    createInvocation(params, messageBus) {
+        return new ReadManyFilesToolInvocation(this.host, params, messageBus);
+    }
+    async execute(params, signal = new AbortController().signal) {
+        return this.build(params).execute(signal);
+    }
+}
+function buildParameterSchema() {
+    return {
+        type: 'object',
+        properties: {
+            paths: {
+                type: 'array',
+                items: {
+                    type: 'string',
+                    minLength: 1,
+                },
+                minItems: 1,
+                description: "Required. An array of glob patterns or paths relative to the tool's target directory. Examples: ['src/**/*.ts'], ['README.md', 'docs/']",
+            },
+            include: {
+                type: 'array',
+                items: {
+                    type: 'string',
+                    minLength: 1,
+                },
+                description: 'Optional. Additional glob patterns to include. These are merged with `paths`. Example: "*.test.ts" to specifically add test files if they were broadly excluded.',
+                default: [],
+            },
+            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 .llxprtignore',
+                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_llxprt_ignore: {
+                        description: 'Optional: Whether to respect .llxprtignore patterns when listing files. Defaults to true.',
+                        type: 'boolean',
+                    },
+                },
+            },
+        },
+        required: ['paths'],
+    };
+}
+//# 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/read_line_range.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseDeclarativeTool, type ToolInvocation, type ToolResult } from './tools.js';
+import type { IToolHost, IToolMessageBus } from '../interfaces/index.js';
+/**
+ * Parameters for the ReadLineRange tool
+ */
+export interface ReadLineRangeToolParams {
+    /**
+     * The absolute path to the file to read
+     */
+    absolute_path: string;
+    /**
+     * The 1-based line number to start reading from (inclusive)
+     */
+    start_line: number;
+    /**
+     * The 1-based line number to end reading at (inclusive)
+     */
+    end_line: number;
+    /**
+     * Alternative parameter name for absolute_path (for compatibility)
+     */
+    file_path?: string;
+    /**
+     * When true, prefixes each returned line with a virtual line number.
+     */
+    showLineNumbers?: boolean;
+    /**
+     * When true, prefixes each returned text line with a git-change marker column.
+     */
+    showGitChanges?: boolean;
+}
+/**
+ * Implementation of the ReadLineRange tool logic
+ */
+export declare class ReadLineRangeTool extends BaseDeclarativeTool<ReadLineRangeToolParams, ToolResult> {
+    private host;
+    static readonly Name: string;
+    constructor(host: IToolHost);
+    protected validateToolParamValues(params: ReadLineRangeToolParams): string | null;
+    protected createInvocation(params: ReadLineRangeToolParams, messageBus: IToolMessageBus): ToolInvocation<ReadLineRangeToolParams, ToolResult>;
+    execute(params: ReadLineRangeToolParams, signal?: AbortSignal): Promise<ToolResult>;
+}