@vybestack/llxprt-code-core 0.1.12

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

@@ -0,0 +1,321 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseTool } from './tools.js';
+import { SchemaValidator } from '../utils/schemaValidator.js';
+import { getErrorMessage } from '../utils/errors.js';
+import * as path from 'path';
+import { glob } from 'glob';
+import { getCurrentLlxprtMdFilename } from './memoryTool.js';
+import { detectFileType, processSingleFileContent, DEFAULT_ENCODING, getSpecificMimeType, } from '../utils/fileUtils.js';
+import { Type } from '@google/genai';
+import { recordFileOperationMetric, FileOperation, } from '../telemetry/metrics.js';
+/**
+ * Default exclusion patterns for commonly ignored directories and binary file types.
+ * These are compatible with glob ignore patterns.
+ * TODO(adh): Consider making this configurable or extendable through a command line argument.
+ * TODO(adh): Look into sharing this list with the glob tool.
+ */
+const DEFAULT_EXCLUDES = [
+    '**/node_modules/**',
+    '**/.git/**',
+    '**/.vscode/**',
+    '**/.idea/**',
+    '**/dist/**',
+    '**/build/**',
+    '**/coverage/**',
+    '**/__pycache__/**',
+    '**/*.pyc',
+    '**/*.pyo',
+    '**/*.bin',
+    '**/*.exe',
+    '**/*.dll',
+    '**/*.so',
+    '**/*.dylib',
+    '**/*.class',
+    '**/*.jar',
+    '**/*.war',
+    '**/*.zip',
+    '**/*.tar',
+    '**/*.gz',
+    '**/*.bz2',
+    '**/*.rar',
+    '**/*.7z',
+    '**/*.doc',
+    '**/*.docx',
+    '**/*.xls',
+    '**/*.xlsx',
+    '**/*.ppt',
+    '**/*.pptx',
+    '**/*.odt',
+    '**/*.ods',
+    '**/*.odp',
+    '**/*.DS_Store',
+    '**/.env',
+    `**/${getCurrentLlxprtMdFilename()}`,
+];
+const DEFAULT_OUTPUT_SEPARATOR_FORMAT = '--- {filePath} ---';
+/**
+ * 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 BaseTool {
+    config;
+    static Name = 'read_many_files';
+    llxprtIgnorePatterns = [];
+    constructor(config) {
+        const parameterSchema = {
+            type: Type.OBJECT,
+            properties: {
+                paths: {
+                    type: Type.ARRAY,
+                    items: {
+                        type: 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: Type.ARRAY,
+                    items: {
+                        type: 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: Type.ARRAY,
+                    items: {
+                        type: 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: Type.BOOLEAN,
+                    description: 'Optional. Whether to search recursively (primarily controlled by `**` in glob patterns). Defaults to true.',
+                    default: true,
+                },
+                useDefaultExcludes: {
+                    type: 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,
+                },
+                respect_git_ignore: {
+                    type: Type.BOOLEAN,
+                    description: 'Optional. Whether to respect .gitignore patterns when discovering files. Only available in git repositories. Defaults to true.',
+                    default: true,
+                },
+            },
+            required: ['paths'],
+        };
+        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) 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. 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/PDF) are generally skipped. Default excludes apply to common non-text files (except for explicitly requested images/PDFs) and large dependency directories unless 'useDefaultExcludes' is false.`, parameterSchema);
+        this.config = config;
+        this.llxprtIgnorePatterns = config
+            .getFileService()
+            .getGeminiIgnorePatterns();
+    }
+    validateParams(params) {
+        const errors = SchemaValidator.validate(this.schema.parameters, params);
+        if (errors) {
+            return errors;
+        }
+        return null;
+    }
+    getDescription(params) {
+        const allPatterns = [...params.paths, ...(params.include || [])];
+        const pathDesc = `using patterns: \`${allPatterns.join('`, `')}\` (within target directory: \`${this.config.getTargetDir()}\`)`;
+        // Determine the final list of exclusion patterns exactly as in execute method
+        const paramExcludes = params.exclude || [];
+        const paramUseDefaultExcludes = params.useDefaultExcludes !== false;
+        const finalExclusionPatternsForDescription = paramUseDefaultExcludes
+            ? [...DEFAULT_EXCLUDES, ...paramExcludes, ...this.llxprtIgnorePatterns]
+            : [...paramExcludes, ...this.llxprtIgnorePatterns];
+        let excludeDesc = `Excluding: ${finalExclusionPatternsForDescription.length > 0 ? `patterns like \`${finalExclusionPatternsForDescription.slice(0, 2).join('`, `')}${finalExclusionPatternsForDescription.length > 2 ? '...`' : '`'}` : 'none specified'}`;
+        // Add a note if .llxprtignore patterns contributed to the final list of exclusions
+        if (this.llxprtIgnorePatterns.length > 0) {
+            const geminiPatternsInEffect = this.llxprtIgnorePatterns.filter((p) => finalExclusionPatternsForDescription.includes(p)).length;
+            if (geminiPatternsInEffect > 0) {
+                excludeDesc += ` (includes ${geminiPatternsInEffect} from .llxprtignore)`;
+            }
+        }
+        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(params, signal) {
+        const validationError = this.validateParams(params);
+        if (validationError) {
+            return {
+                llmContent: `Error: Invalid parameters for ${this.displayName}. Reason: ${validationError}`,
+                returnDisplay: `## Parameter Error\n\n${validationError}`,
+            };
+        }
+        const { paths: inputPatterns, include = [], exclude = [], useDefaultExcludes = true, respect_git_ignore = true, } = params;
+        const respectGitIgnore = respect_git_ignore ?? this.config.getFileFilteringRespectGitIgnore();
+        // Get centralized file discovery service
+        const fileDiscovery = this.config.getFileService();
+        const filesToConsider = new Set();
+        const skippedFiles = [];
+        const processedFilesRelativePaths = [];
+        const contentParts = [];
+        const effectiveExcludes = useDefaultExcludes
+            ? [...DEFAULT_EXCLUDES, ...exclude, ...this.llxprtIgnorePatterns]
+            : [...exclude, ...this.llxprtIgnorePatterns];
+        const searchPatterns = [...inputPatterns, ...include];
+        if (searchPatterns.length === 0) {
+            return {
+                llmContent: 'No search paths or include patterns provided.',
+                returnDisplay: `## Information\n\nNo search paths or include patterns were specified. Nothing to read or concatenate.`,
+            };
+        }
+        try {
+            const entries = await glob(searchPatterns, {
+                cwd: this.config.getTargetDir(),
+                ignore: effectiveExcludes,
+                nodir: true,
+                dot: true,
+                absolute: true,
+                nocase: true,
+                signal,
+            });
+            const filteredEntries = respectGitIgnore
+                ? fileDiscovery
+                    .filterFiles(entries.map((p) => path.relative(this.config.getTargetDir(), p)), {
+                    respectGitIgnore,
+                })
+                    .map((p) => path.resolve(this.config.getTargetDir(), p))
+                : entries;
+            let gitIgnoredCount = 0;
+            for (const absoluteFilePath of entries) {
+                // Security check: ensure the glob library didn't return something outside targetDir.
+                if (!absoluteFilePath.startsWith(this.config.getTargetDir())) {
+                    skippedFiles.push({
+                        path: absoluteFilePath,
+                        reason: `Security: Glob library returned path outside target directory. Base: ${this.config.getTargetDir()}, Path: ${absoluteFilePath}`,
+                    });
+                    continue;
+                }
+                // Check if this file was filtered out by git ignore
+                if (respectGitIgnore && !filteredEntries.includes(absoluteFilePath)) {
+                    gitIgnoredCount++;
+                    continue;
+                }
+                filesToConsider.add(absoluteFilePath);
+            }
+            // Add info about git-ignored files if any were filtered
+            if (gitIgnoredCount > 0) {
+                skippedFiles.push({
+                    path: `${gitIgnoredCount} file(s)`,
+                    reason: 'ignored',
+                });
+            }
+        }
+        catch (error) {
+            return {
+                llmContent: `Error during file search: ${getErrorMessage(error)}`,
+                returnDisplay: `## File Search Error\n\nAn error occurred while searching for files:\n\`\`\`\n${getErrorMessage(error)}\n\`\`\``,
+            };
+        }
+        const sortedFiles = Array.from(filesToConsider).sort();
+        for (const filePath of sortedFiles) {
+            const relativePathForDisplay = path
+                .relative(this.config.getTargetDir(), filePath)
+                .replace(/\\/g, '/');
+            const fileType = detectFileType(filePath);
+            if (fileType === 'image' || fileType === 'pdf') {
+                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) was not explicitly requested by name or extension',
+                    });
+                    continue;
+                }
+            }
+            // Use processSingleFileContent for all file types now
+            const fileReadResult = await processSingleFileContent(filePath, this.config.getTargetDir());
+            if (fileReadResult.error) {
+                skippedFiles.push({
+                    path: relativePathForDisplay,
+                    reason: `Read error: ${fileReadResult.error}`,
+                });
+            }
+            else {
+                if (typeof fileReadResult.llmContent === 'string') {
+                    const separator = DEFAULT_OUTPUT_SEPARATOR_FORMAT.replace('{filePath}', filePath);
+                    contentParts.push(`${separator}\n\n${fileReadResult.llmContent}\n\n`);
+                }
+                else {
+                    contentParts.push(fileReadResult.llmContent); // This is a Part for image/pdf
+                }
+                processedFilesRelativePaths.push(relativePathForDisplay);
+                const lines = typeof fileReadResult.llmContent === 'string'
+                    ? fileReadResult.llmContent.split('\n').length
+                    : undefined;
+                const mimetype = getSpecificMimeType(filePath);
+                recordFileOperationMetric(this.config, FileOperation.READ, lines, mimetype, path.extname(filePath));
+            }
+        }
+        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('No files matching the criteria were found or all were skipped.');
+        }
+        return {
+            llmContent: contentParts,
+            returnDisplay: displayMessage.trim(),
+        };
+    }
+}
+//# 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-many-files.test.d.ts

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

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

@@ -0,0 +1,312 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { vi, describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mockControl } from '../__mocks__/fs/promises.js';
+import { ReadManyFilesTool } from './read-many-files.js';
+import { FileDiscoveryService } from '../services/fileDiscoveryService.js';
+import path from 'path';
+import fs from 'fs'; // Actual fs for setup
+import os from 'os';
+vi.mock('mime-types', () => {
+    const lookup = (filename) => {
+        if (filename.endsWith('.ts') || filename.endsWith('.js')) {
+            return 'text/plain';
+        }
+        if (filename.endsWith('.png')) {
+            return 'image/png';
+        }
+        if (filename.endsWith('.pdf')) {
+            return 'application/pdf';
+        }
+        if (filename.endsWith('.mp3') || filename.endsWith('.wav')) {
+            return 'audio/mpeg';
+        }
+        if (filename.endsWith('.mp4') || filename.endsWith('.mov')) {
+            return 'video/mp4';
+        }
+        return false;
+    };
+    return {
+        default: {
+            lookup,
+        },
+        lookup,
+    };
+});
+describe('ReadManyFilesTool', () => {
+    let tool;
+    let tempRootDir;
+    let tempDirOutsideRoot;
+    let mockReadFileFn;
+    beforeEach(async () => {
+        tempRootDir = fs.mkdtempSync(path.join(os.tmpdir(), 'read-many-files-root-'));
+        tempDirOutsideRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'read-many-files-external-'));
+        fs.writeFileSync(path.join(tempRootDir, '.llxprtignore'), 'foo.*');
+        const fileService = new FileDiscoveryService(tempRootDir);
+        const mockConfig = {
+            getFileService: () => fileService,
+            getFileFilteringRespectGitIgnore: () => true,
+            getTargetDir: () => tempRootDir,
+        };
+        tool = new ReadManyFilesTool(mockConfig);
+        mockReadFileFn = mockControl.mockReadFile;
+        mockReadFileFn.mockReset();
+        mockReadFileFn.mockImplementation(async (filePath, options) => {
+            const fp = typeof filePath === 'string'
+                ? filePath
+                : filePath.toString();
+            if (fs.existsSync(fp)) {
+                const originalFs = await vi.importActual('fs');
+                return originalFs.promises.readFile(fp, options);
+            }
+            if (fp.endsWith('nonexistent-file.txt')) {
+                const err = new Error(`ENOENT: no such file or directory, open '${fp}'`);
+                err.code = 'ENOENT';
+                throw err;
+            }
+            if (fp.endsWith('unreadable.txt')) {
+                const err = new Error(`EACCES: permission denied, open '${fp}'`);
+                err.code = 'EACCES';
+                throw err;
+            }
+            if (fp.endsWith('.png'))
+                return Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]); // PNG header
+            if (fp.endsWith('.pdf'))
+                return Buffer.from('%PDF-1.4...'); // PDF start
+            if (fp.endsWith('binary.bin'))
+                return Buffer.from([0x00, 0x01, 0x02, 0x00, 0x03]);
+            const err = new Error(`ENOENT: no such file or directory, open '${fp}' (unmocked path)`);
+            err.code = 'ENOENT';
+            throw err;
+        });
+    });
+    afterEach(() => {
+        if (fs.existsSync(tempRootDir)) {
+            fs.rmSync(tempRootDir, { recursive: true, force: true });
+        }
+        if (fs.existsSync(tempDirOutsideRoot)) {
+            fs.rmSync(tempDirOutsideRoot, { recursive: true, force: true });
+        }
+    });
+    describe('validateParams', () => {
+        it('should return null for valid relative paths within root', () => {
+            const params = { paths: ['file1.txt', 'subdir/file2.txt'] };
+            expect(tool.validateParams(params)).toBeNull();
+        });
+        it('should return null for valid glob patterns within root', () => {
+            const params = { paths: ['*.txt', 'subdir/**/*.js'] };
+            expect(tool.validateParams(params)).toBeNull();
+        });
+        it('should return null for paths trying to escape the root (e.g., ../) as execute handles this', () => {
+            const params = { paths: ['../outside.txt'] };
+            expect(tool.validateParams(params)).toBeNull();
+        });
+        it('should return null for absolute paths as execute handles this', () => {
+            const params = { paths: [path.join(tempDirOutsideRoot, 'absolute.txt')] };
+            expect(tool.validateParams(params)).toBeNull();
+        });
+        it('should return error if paths array is empty', () => {
+            const params = { paths: [] };
+            expect(tool.validateParams(params)).toBe('params/paths must NOT have fewer than 1 items');
+        });
+        it('should return null for valid exclude and include patterns', () => {
+            const params = {
+                paths: ['src/**/*.ts'],
+                exclude: ['**/*.test.ts'],
+                include: ['src/utils/*.ts'],
+            };
+            expect(tool.validateParams(params)).toBeNull();
+        });
+        it('should return error if paths array contains an empty string', () => {
+            const params = { paths: ['file1.txt', ''] };
+            expect(tool.validateParams(params)).toBe('params/paths/1 must NOT have fewer than 1 characters');
+        });
+        it('should return error if include array contains non-string elements', () => {
+            const params = {
+                paths: ['file1.txt'],
+                include: ['*.ts', 123],
+            };
+            expect(tool.validateParams(params)).toBe('params/include/1 must be string');
+        });
+        it('should return error if exclude array contains non-string elements', () => {
+            const params = {
+                paths: ['file1.txt'],
+                exclude: ['*.log', {}],
+            };
+            expect(tool.validateParams(params)).toBe('params/exclude/1 must be string');
+        });
+    });
+    describe('execute', () => {
+        const createFile = (filePath, content = '') => {
+            const fullPath = path.join(tempRootDir, filePath);
+            fs.mkdirSync(path.dirname(fullPath), { recursive: true });
+            fs.writeFileSync(fullPath, content);
+        };
+        const createBinaryFile = (filePath, data) => {
+            const fullPath = path.join(tempRootDir, filePath);
+            fs.mkdirSync(path.dirname(fullPath), { recursive: true });
+            fs.writeFileSync(fullPath, data);
+        };
+        it('should read a single specified file', async () => {
+            createFile('file1.txt', 'Content of file1');
+            const params = { paths: ['file1.txt'] };
+            const result = await tool.execute(params, new AbortController().signal);
+            const expectedPath = path.join(tempRootDir, 'file1.txt');
+            expect(result.llmContent).toEqual([
+                `--- ${expectedPath} ---\n\nContent of file1\n\n`,
+            ]);
+            expect(result.returnDisplay).toContain('Successfully read and concatenated content from **1 file(s)**');
+        });
+        it('should read multiple specified files', async () => {
+            createFile('file1.txt', 'Content1');
+            createFile('subdir/file2.js', 'Content2');
+            const params = { paths: ['file1.txt', 'subdir/file2.js'] };
+            const result = await tool.execute(params, new AbortController().signal);
+            const content = result.llmContent;
+            const expectedPath1 = path.join(tempRootDir, 'file1.txt');
+            const expectedPath2 = path.join(tempRootDir, 'subdir/file2.js');
+            expect(content.some((c) => c.includes(`--- ${expectedPath1} ---\n\nContent1\n\n`))).toBe(true);
+            expect(content.some((c) => c.includes(`--- ${expectedPath2} ---\n\nContent2\n\n`))).toBe(true);
+            expect(result.returnDisplay).toContain('Successfully read and concatenated content from **2 file(s)**');
+        });
+        it('should handle glob patterns', async () => {
+            createFile('file.txt', 'Text file');
+            createFile('another.txt', 'Another text');
+            createFile('sub/data.json', '{}');
+            const params = { paths: ['*.txt'] };
+            const result = await tool.execute(params, new AbortController().signal);
+            const content = result.llmContent;
+            const expectedPath1 = path.join(tempRootDir, 'file.txt');
+            const expectedPath2 = path.join(tempRootDir, 'another.txt');
+            expect(content.some((c) => c.includes(`--- ${expectedPath1} ---\n\nText file\n\n`))).toBe(true);
+            expect(content.some((c) => c.includes(`--- ${expectedPath2} ---\n\nAnother text\n\n`))).toBe(true);
+            expect(content.find((c) => c.includes('sub/data.json'))).toBeUndefined();
+            expect(result.returnDisplay).toContain('Successfully read and concatenated content from **2 file(s)**');
+        });
+        it('should respect exclude patterns', async () => {
+            createFile('src/main.ts', 'Main content');
+            createFile('src/main.test.ts', 'Test content');
+            const params = { paths: ['src/**/*.ts'], exclude: ['**/*.test.ts'] };
+            const result = await tool.execute(params, new AbortController().signal);
+            const content = result.llmContent;
+            const expectedPath = path.join(tempRootDir, 'src/main.ts');
+            expect(content).toEqual([`--- ${expectedPath} ---\n\nMain content\n\n`]);
+            expect(content.find((c) => c.includes('src/main.test.ts'))).toBeUndefined();
+            expect(result.returnDisplay).toContain('Successfully read and concatenated content from **1 file(s)**');
+        });
+        it('should handle non-existent specific files gracefully', async () => {
+            const params = { paths: ['nonexistent-file.txt'] };
+            const result = await tool.execute(params, new AbortController().signal);
+            expect(result.llmContent).toEqual([
+                'No files matching the criteria were found or all were skipped.',
+            ]);
+            expect(result.returnDisplay).toContain('No files were read and concatenated based on the criteria.');
+        });
+        it('should use default excludes', async () => {
+            createFile('node_modules/some-lib/index.js', 'lib code');
+            createFile('src/app.js', 'app code');
+            const params = { paths: ['**/*.js'] };
+            const result = await tool.execute(params, new AbortController().signal);
+            const content = result.llmContent;
+            const expectedPath = path.join(tempRootDir, 'src/app.js');
+            expect(content).toEqual([`--- ${expectedPath} ---\n\napp code\n\n`]);
+            expect(content.find((c) => c.includes('node_modules/some-lib/index.js'))).toBeUndefined();
+            expect(result.returnDisplay).toContain('Successfully read and concatenated content from **1 file(s)**');
+        });
+        it('should NOT use default excludes if useDefaultExcludes is false', async () => {
+            createFile('node_modules/some-lib/index.js', 'lib code');
+            createFile('src/app.js', 'app code');
+            const params = { paths: ['**/*.js'], useDefaultExcludes: false };
+            const result = await tool.execute(params, new AbortController().signal);
+            const content = result.llmContent;
+            const expectedPath1 = path.join(tempRootDir, 'node_modules/some-lib/index.js');
+            const expectedPath2 = path.join(tempRootDir, 'src/app.js');
+            expect(content.some((c) => c.includes(`--- ${expectedPath1} ---\n\nlib code\n\n`))).toBe(true);
+            expect(content.some((c) => c.includes(`--- ${expectedPath2} ---\n\napp code\n\n`))).toBe(true);
+            expect(result.returnDisplay).toContain('Successfully read and concatenated content from **2 file(s)**');
+        });
+        it('should include images as inlineData parts if explicitly requested by extension', async () => {
+            createBinaryFile('image.png', Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]));
+            const params = { paths: ['*.png'] }; // Explicitly requesting .png
+            const result = await tool.execute(params, new AbortController().signal);
+            expect(result.llmContent).toEqual([
+                {
+                    inlineData: {
+                        data: Buffer.from([
+                            0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a,
+                        ]).toString('base64'),
+                        mimeType: 'image/png',
+                    },
+                },
+            ]);
+            expect(result.returnDisplay).toContain('Successfully read and concatenated content from **1 file(s)**');
+        });
+        it('should include images as inlineData parts if explicitly requested by name', async () => {
+            createBinaryFile('myExactImage.png', Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]));
+            const params = { paths: ['myExactImage.png'] }; // Explicitly requesting by full name
+            const result = await tool.execute(params, new AbortController().signal);
+            expect(result.llmContent).toEqual([
+                {
+                    inlineData: {
+                        data: Buffer.from([
+                            0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a,
+                        ]).toString('base64'),
+                        mimeType: 'image/png',
+                    },
+                },
+            ]);
+        });
+        it('should skip PDF files if not explicitly requested by extension or name', async () => {
+            createBinaryFile('document.pdf', Buffer.from('%PDF-1.4...'));
+            createFile('notes.txt', 'text notes');
+            const params = { paths: ['*'] }; // Generic glob, not specific to .pdf
+            const result = await tool.execute(params, new AbortController().signal);
+            const content = result.llmContent;
+            const expectedPath = path.join(tempRootDir, 'notes.txt');
+            expect(content.some((c) => typeof c === 'string' &&
+                c.includes(`--- ${expectedPath} ---\n\ntext notes\n\n`))).toBe(true);
+            expect(result.returnDisplay).toContain('**Skipped 1 item(s):**');
+            expect(result.returnDisplay).toContain('- `document.pdf` (Reason: asset file (image/pdf) was not explicitly requested by name or extension)');
+        });
+        it('should include PDF files as inlineData parts if explicitly requested by extension', async () => {
+            createBinaryFile('important.pdf', Buffer.from('%PDF-1.4...'));
+            const params = { paths: ['*.pdf'] }; // Explicitly requesting .pdf files
+            const result = await tool.execute(params, new AbortController().signal);
+            expect(result.llmContent).toEqual([
+                {
+                    inlineData: {
+                        data: Buffer.from('%PDF-1.4...').toString('base64'),
+                        mimeType: 'application/pdf',
+                    },
+                },
+            ]);
+        });
+        it('should include PDF files as inlineData parts if explicitly requested by name', async () => {
+            createBinaryFile('report-final.pdf', Buffer.from('%PDF-1.4...'));
+            const params = { paths: ['report-final.pdf'] };
+            const result = await tool.execute(params, new AbortController().signal);
+            expect(result.llmContent).toEqual([
+                {
+                    inlineData: {
+                        data: Buffer.from('%PDF-1.4...').toString('base64'),
+                        mimeType: 'application/pdf',
+                    },
+                },
+            ]);
+        });
+        it('should return error if path is ignored by a .llxprtignore pattern', async () => {
+            createFile('foo.bar', '');
+            createFile('bar.ts', '');
+            createFile('foo.quux', '');
+            const params = { paths: ['foo.bar', 'bar.ts', 'foo.quux'] };
+            const result = await tool.execute(params, new AbortController().signal);
+            expect(result.returnDisplay).not.toContain('foo.bar');
+            expect(result.returnDisplay).not.toContain('foo.quux');
+            expect(result.returnDisplay).toContain('bar.ts');
+        });
+    });
+});
+//# sourceMappingURL=read-many-files.test.js.map