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

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

@@ -0,0 +1,300 @@
+/**
+ * @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, '.geminiignore'), 'foo.*');
+        const fileService = new FileDiscoveryService(tempRootDir);
+        const mockConfig = {
+            getFileService: () => fileService,
+            getFileFilteringRespectGitIgnore: () => true,
+        };
+        tool = new ReadManyFilesTool(tempRootDir, 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('The "paths" parameter is required and must be a non-empty array of strings/glob patterns.');
+        });
+        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('Each item in "paths" must be a non-empty string/glob pattern.');
+        });
+        it('should return error if include array contains non-string elements', () => {
+            const params = {
+                paths: ['file1.txt'],
+                include: ['*.ts', 123],
+            };
+            expect(tool.validateParams(params)).toBe('If provided, "include" must be an array of strings/glob patterns.');
+        });
+        it('should return error if exclude array contains non-string elements', () => {
+            const params = {
+                paths: ['file1.txt'],
+                exclude: ['*.log', {}],
+            };
+            expect(tool.validateParams(params)).toBe('If provided, "exclude" must be an array of strings/glob patterns.');
+        });
+    });
+    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);
+            expect(result.llmContent).toEqual([
+                '--- file1.txt ---\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;
+            expect(content.some((c) => c.includes('--- file1.txt ---\n\nContent1\n\n'))).toBe(true);
+            expect(content.some((c) => c.includes('--- subdir/file2.js ---\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;
+            expect(content.some((c) => c.includes('--- file.txt ---\n\nText file\n\n'))).toBe(true);
+            expect(content.some((c) => c.includes('--- another.txt ---\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;
+            expect(content).toEqual(['--- src/main.ts ---\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;
+            expect(content).toEqual(['--- src/app.js ---\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;
+            expect(content.some((c) => c.includes('--- node_modules/some-lib/index.js ---\n\nlib code\n\n'))).toBe(true);
+            expect(content.some((c) => c.includes('--- src/app.js ---\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;
+            expect(content.some((c) => typeof c === 'string' && c.includes('--- notes.txt ---'))).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 .geminiignore 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

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

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

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

@@ -0,0 +1,43 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Config } from '../config/config.js';
+import { BaseTool, ToolResult, ToolCallConfirmationDetails } from './tools.js';
+export interface ShellToolParams {
+    command: string;
+    description?: string;
+    directory?: string;
+}
+export declare class ShellTool extends BaseTool<ShellToolParams, ToolResult> {
+    private readonly config;
+    static Name: string;
+    private whitelist;
+    constructor(config: Config);
+    getDescription(params: ShellToolParams): string;
+    /**
+     * Extracts the root command from a given shell command string.
+     * This is used to identify the base command for permission checks.
+     *
+     * @param command The shell command string to parse
+     * @returns The root command name, or undefined if it cannot be determined
+     * @example getCommandRoot("ls -la /tmp") returns "ls"
+     * @example getCommandRoot("git status && npm test") returns "git"
+     */
+    getCommandRoot(command: string): string | undefined;
+    /**
+     * Determines whether a given shell command is allowed to execute based on
+     * the tool's configuration including allowlists and blocklists.
+     *
+     * @param command The shell command string to validate
+     * @returns An object with 'allowed' boolean and optional 'reason' string if not allowed
+     */
+    isCommandAllowed(command: string): {
+        allowed: boolean;
+        reason?: string;
+    };
+    validateToolParams(params: ShellToolParams): string | null;
+    shouldConfirmExecute(params: ShellToolParams, _abortSignal: AbortSignal): Promise<ToolCallConfirmationDetails | false>;
+    execute(params: ShellToolParams, abortSignal: AbortSignal, updateOutput?: (chunk: string) => void): Promise<ToolResult>;
+}