@blackbox_ai/blackbox-cli-core 0.0.4

package/dist/src/tools/ls.js

@@ -0,0 +1,227 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { BaseDeclarativeTool, BaseToolInvocation, Kind } from './tools.js';
+import { makeRelative, shortenPath } from '../utils/paths.js';
+import { DEFAULT_FILE_FILTERING_OPTIONS } from '../config/config.js';
+import { ToolErrorType } from './tool-error.js';
+class LSToolInvocation extends BaseToolInvocation {
+    config;
+    constructor(config, params) {
+        super(params);
+        this.config = config;
+    }
+    /**
+     * Checks if a filename matches any of the ignore patterns
+     * @param filename Filename to check
+     * @param patterns Array of glob patterns to check against
+     * @returns True if the filename should be ignored
+     */
+    shouldIgnore(filename, patterns) {
+        if (!patterns || patterns.length === 0) {
+            return false;
+        }
+        for (const pattern of patterns) {
+            // Convert glob pattern to RegExp
+            const regexPattern = pattern
+                .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+                .replace(/\*/g, '.*')
+                .replace(/\?/g, '.');
+            const regex = new RegExp(`^${regexPattern}$`);
+            if (regex.test(filename)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Gets a description of the file reading operation
+     * @returns A string describing the file being read
+     */
+    getDescription() {
+        const relativePath = makeRelative(this.params.path, this.config.getTargetDir());
+        return shortenPath(relativePath);
+    }
+    // Helper for consistent error formatting
+    errorResult(llmContent, returnDisplay, type) {
+        return {
+            llmContent,
+            // Keep returnDisplay simpler in core logic
+            returnDisplay: `Error: ${returnDisplay}`,
+            error: {
+                message: llmContent,
+                type,
+            },
+        };
+    }
+    /**
+     * Executes the LS operation with the given parameters
+     * @returns Result of the LS operation
+     */
+    async execute(_signal) {
+        try {
+            const stats = fs.statSync(this.params.path);
+            if (!stats) {
+                // fs.statSync throws on non-existence, so this check might be redundant
+                // but keeping for clarity. Error message adjusted.
+                return this.errorResult(`Error: Directory not found or inaccessible: ${this.params.path}`, `Directory not found or inaccessible.`, ToolErrorType.FILE_NOT_FOUND);
+            }
+            if (!stats.isDirectory()) {
+                return this.errorResult(`Error: Path is not a directory: ${this.params.path}`, `Path is not a directory.`, ToolErrorType.PATH_IS_NOT_A_DIRECTORY);
+            }
+            const files = fs.readdirSync(this.params.path);
+            const defaultFileIgnores = this.config.getFileFilteringOptions() ?? DEFAULT_FILE_FILTERING_OPTIONS;
+            const fileFilteringOptions = {
+                respectGitIgnore: this.params.file_filtering_options?.respect_git_ignore ??
+                    defaultFileIgnores.respectGitIgnore,
+                respectGeminiIgnore: this.params.file_filtering_options?.respect_gemini_ignore ??
+                    defaultFileIgnores.respectGeminiIgnore,
+            };
+            // Get centralized file discovery service
+            const fileDiscovery = this.config.getFileService();
+            const entries = [];
+            let gitIgnoredCount = 0;
+            let geminiIgnoredCount = 0;
+            if (files.length === 0) {
+                // Changed error message to be more neutral for LLM
+                return {
+                    llmContent: `Directory ${this.params.path} is empty.`,
+                    returnDisplay: `Directory is empty.`,
+                };
+            }
+            for (const file of files) {
+                if (this.shouldIgnore(file, this.params.ignore)) {
+                    continue;
+                }
+                const fullPath = path.join(this.params.path, file);
+                const relativePath = path.relative(this.config.getTargetDir(), fullPath);
+                // Check if this file should be ignored based on git or gemini ignore rules
+                if (fileFilteringOptions.respectGitIgnore &&
+                    fileDiscovery.shouldGitIgnoreFile(relativePath)) {
+                    gitIgnoredCount++;
+                    continue;
+                }
+                if (fileFilteringOptions.respectGeminiIgnore &&
+                    fileDiscovery.shouldGeminiIgnoreFile(relativePath)) {
+                    geminiIgnoredCount++;
+                    continue;
+                }
+                try {
+                    const stats = fs.statSync(fullPath);
+                    const isDir = stats.isDirectory();
+                    entries.push({
+                        name: file,
+                        path: fullPath,
+                        isDirectory: isDir,
+                        size: isDir ? 0 : stats.size,
+                        modifiedTime: stats.mtime,
+                    });
+                }
+                catch (error) {
+                    // Log error internally but don't fail the whole listing
+                    console.error(`Error accessing ${fullPath}: ${error}`);
+                }
+            }
+            // Sort entries (directories first, then alphabetically)
+            entries.sort((a, b) => {
+                if (a.isDirectory && !b.isDirectory)
+                    return -1;
+                if (!a.isDirectory && b.isDirectory)
+                    return 1;
+                return a.name.localeCompare(b.name);
+            });
+            // Create formatted content for LLM
+            const directoryContent = entries
+                .map((entry) => `${entry.isDirectory ? '[DIR] ' : ''}${entry.name}`)
+                .join('\n');
+            let resultMessage = `Directory listing for ${this.params.path}:\n${directoryContent}`;
+            const ignoredMessages = [];
+            if (gitIgnoredCount > 0) {
+                ignoredMessages.push(`${gitIgnoredCount} git-ignored`);
+            }
+            if (geminiIgnoredCount > 0) {
+                ignoredMessages.push(`${geminiIgnoredCount} gemini-ignored`);
+            }
+            if (ignoredMessages.length > 0) {
+                resultMessage += `\n\n(${ignoredMessages.join(', ')})`;
+            }
+            let displayMessage = `Listed ${entries.length} item(s).`;
+            if (ignoredMessages.length > 0) {
+                displayMessage += ` (${ignoredMessages.join(', ')})`;
+            }
+            return {
+                llmContent: resultMessage,
+                returnDisplay: displayMessage,
+            };
+        }
+        catch (error) {
+            const errorMsg = `Error listing directory: ${error instanceof Error ? error.message : String(error)}`;
+            return this.errorResult(errorMsg, 'Failed to list directory.', ToolErrorType.LS_EXECUTION_ERROR);
+        }
+    }
+}
+/**
+ * Implementation of the LS tool logic
+ */
+export class LSTool extends BaseDeclarativeTool {
+    config;
+    static Name = 'list_directory';
+    constructor(config) {
+        super(LSTool.Name, 'ReadFolder', 'Lists the names of files and subdirectories directly within a specified directory path. Can optionally ignore entries matching provided glob patterns.', Kind.Search, {
+            properties: {
+                path: {
+                    description: 'The absolute path to the directory to list (must be absolute, not relative)',
+                    type: 'string',
+                },
+                ignore: {
+                    description: 'List of glob patterns to ignore',
+                    items: {
+                        type: 'string',
+                    },
+                    type: 'array',
+                },
+                file_filtering_options: {
+                    description: 'Optional: Whether to respect ignore patterns from .gitignore or .blackboxignore',
+                    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 .blackboxignore patterns when listing files. Defaults to true.',
+                            type: 'boolean',
+                        },
+                    },
+                },
+            },
+            required: ['path'],
+            type: 'object',
+        });
+        this.config = config;
+    }
+    /**
+     * Validates the parameters for the tool
+     * @param params Parameters to validate
+     * @returns An error message string if invalid, null otherwise
+     */
+    validateToolParamValues(params) {
+        if (!path.isAbsolute(params.path)) {
+            return `Path must be absolute: ${params.path}`;
+        }
+        const workspaceContext = this.config.getWorkspaceContext();
+        if (!workspaceContext.isPathWithinWorkspace(params.path)) {
+            const directories = workspaceContext.getDirectories();
+            return `Path must be within one of the workspace directories: ${directories.join(', ')}`;
+        }
+        return null;
+    }
+    createInvocation(params) {
+        return new LSToolInvocation(this.config, params);
+    }
+}
+//# sourceMappingURL=ls.js.map

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

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

package/dist/src/tools/ls.test.d.ts

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

package/dist/src/tools/ls.test.js

@@ -0,0 +1,389 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import fs from 'node:fs';
+import path from 'node:path';
+vi.mock('fs', () => ({
+    default: {
+        statSync: vi.fn(),
+        readdirSync: vi.fn(),
+    },
+    statSync: vi.fn(),
+    readdirSync: vi.fn(),
+    mkdirSync: vi.fn(),
+}));
+import { LSTool } from './ls.js';
+import { ToolErrorType } from './tool-error.js';
+describe('LSTool', () => {
+    let lsTool;
+    let mockConfig;
+    let mockWorkspaceContext;
+    let mockFileService;
+    const mockPrimaryDir = '/home/user/project';
+    const mockSecondaryDir = '/home/user/other-project';
+    beforeEach(() => {
+        vi.resetAllMocks();
+        // Mock WorkspaceContext
+        mockWorkspaceContext = {
+            getDirectories: vi
+                .fn()
+                .mockReturnValue([mockPrimaryDir, mockSecondaryDir]),
+            isPathWithinWorkspace: vi
+                .fn()
+                .mockImplementation((path) => path.startsWith(mockPrimaryDir) ||
+                path.startsWith(mockSecondaryDir)),
+            addDirectory: vi.fn(),
+        };
+        // Mock FileService
+        mockFileService = {
+            shouldGitIgnoreFile: vi.fn().mockReturnValue(false),
+            shouldGeminiIgnoreFile: vi.fn().mockReturnValue(false),
+        };
+        // Mock Config
+        mockConfig = {
+            getTargetDir: vi.fn().mockReturnValue(mockPrimaryDir),
+            getWorkspaceContext: vi.fn().mockReturnValue(mockWorkspaceContext),
+            getFileService: vi.fn().mockReturnValue(mockFileService),
+            getFileFilteringOptions: vi.fn().mockReturnValue({
+                respectGitIgnore: true,
+                respectGeminiIgnore: true,
+            }),
+        };
+        lsTool = new LSTool(mockConfig);
+    });
+    describe('parameter validation', () => {
+        it('should accept valid absolute paths within workspace', () => {
+            const params = {
+                path: '/home/user/project/src',
+            };
+            vi.mocked(fs.statSync).mockReturnValue({
+                isDirectory: () => true,
+            });
+            const invocation = lsTool.build(params);
+            expect(invocation).toBeDefined();
+        });
+        it('should reject relative paths', () => {
+            const params = {
+                path: './src',
+            };
+            expect(() => lsTool.build(params)).toThrow('Path must be absolute: ./src');
+        });
+        it('should reject paths outside workspace with clear error message', () => {
+            const params = {
+                path: '/etc/passwd',
+            };
+            expect(() => lsTool.build(params)).toThrow('Path must be within one of the workspace directories: /home/user/project, /home/user/other-project');
+        });
+        it('should accept paths in secondary workspace directory', () => {
+            const params = {
+                path: '/home/user/other-project/lib',
+            };
+            vi.mocked(fs.statSync).mockReturnValue({
+                isDirectory: () => true,
+            });
+            const invocation = lsTool.build(params);
+            expect(invocation).toBeDefined();
+        });
+    });
+    describe('execute', () => {
+        it('should list files in a directory', async () => {
+            const testPath = '/home/user/project/src';
+            const mockFiles = ['file1.ts', 'file2.ts', 'subdir'];
+            const mockStats = {
+                isDirectory: vi.fn(),
+                mtime: new Date(),
+                size: 1024,
+            };
+            vi.mocked(fs.statSync).mockImplementation((path) => {
+                const pathStr = path.toString();
+                if (pathStr === testPath) {
+                    return { isDirectory: () => true };
+                }
+                // For individual files
+                if (pathStr.toString().endsWith('subdir')) {
+                    return { ...mockStats, isDirectory: () => true, size: 0 };
+                }
+                return { ...mockStats, isDirectory: () => false };
+            });
+            vi.mocked(fs.readdirSync).mockReturnValue(mockFiles);
+            const invocation = lsTool.build({ path: testPath });
+            const result = await invocation.execute(new AbortController().signal);
+            expect(result.llmContent).toContain('[DIR] subdir');
+            expect(result.llmContent).toContain('file1.ts');
+            expect(result.llmContent).toContain('file2.ts');
+            expect(result.returnDisplay).toBe('Listed 3 item(s).');
+        });
+        it('should list files from secondary workspace directory', async () => {
+            const testPath = '/home/user/other-project/lib';
+            const mockFiles = ['module1.js', 'module2.js'];
+            vi.mocked(fs.statSync).mockImplementation((path) => {
+                if (path.toString() === testPath) {
+                    return { isDirectory: () => true };
+                }
+                return {
+                    isDirectory: () => false,
+                    mtime: new Date(),
+                    size: 2048,
+                };
+            });
+            vi.mocked(fs.readdirSync).mockReturnValue(mockFiles);
+            const invocation = lsTool.build({ path: testPath });
+            const result = await invocation.execute(new AbortController().signal);
+            expect(result.llmContent).toContain('module1.js');
+            expect(result.llmContent).toContain('module2.js');
+            expect(result.returnDisplay).toBe('Listed 2 item(s).');
+        });
+        it('should handle empty directories', async () => {
+            const testPath = '/home/user/project/empty';
+            vi.mocked(fs.statSync).mockReturnValue({
+                isDirectory: () => true,
+            });
+            vi.mocked(fs.readdirSync).mockReturnValue([]);
+            const invocation = lsTool.build({ path: testPath });
+            const result = await invocation.execute(new AbortController().signal);
+            expect(result.llmContent).toBe('Directory /home/user/project/empty is empty.');
+            expect(result.returnDisplay).toBe('Directory is empty.');
+        });
+        it('should respect ignore patterns', async () => {
+            const testPath = '/home/user/project/src';
+            const mockFiles = ['test.js', 'test.spec.js', 'index.js'];
+            vi.mocked(fs.statSync).mockImplementation((path) => {
+                const pathStr = path.toString();
+                if (pathStr === testPath) {
+                    return { isDirectory: () => true };
+                }
+                return {
+                    isDirectory: () => false,
+                    mtime: new Date(),
+                    size: 1024,
+                };
+            });
+            vi.mocked(fs.readdirSync).mockReturnValue(mockFiles);
+            const invocation = lsTool.build({
+                path: testPath,
+                ignore: ['*.spec.js'],
+            });
+            const result = await invocation.execute(new AbortController().signal);
+            expect(result.llmContent).toContain('test.js');
+            expect(result.llmContent).toContain('index.js');
+            expect(result.llmContent).not.toContain('test.spec.js');
+            expect(result.returnDisplay).toBe('Listed 2 item(s).');
+        });
+        it('should respect gitignore patterns', async () => {
+            const testPath = '/home/user/project/src';
+            const mockFiles = ['file1.js', 'file2.js', 'ignored.js'];
+            vi.mocked(fs.statSync).mockImplementation((path) => {
+                const pathStr = path.toString();
+                if (pathStr === testPath) {
+                    return { isDirectory: () => true };
+                }
+                return {
+                    isDirectory: () => false,
+                    mtime: new Date(),
+                    size: 1024,
+                };
+            });
+            vi.mocked(fs.readdirSync).mockReturnValue(mockFiles);
+            mockFileService.shouldGitIgnoreFile.mockImplementation((path) => path.includes('ignored.js'));
+            const invocation = lsTool.build({ path: testPath });
+            const result = await invocation.execute(new AbortController().signal);
+            expect(result.llmContent).toContain('file1.js');
+            expect(result.llmContent).toContain('file2.js');
+            expect(result.llmContent).not.toContain('ignored.js');
+            expect(result.returnDisplay).toBe('Listed 2 item(s). (1 git-ignored)');
+        });
+        it('should respect geminiignore patterns', async () => {
+            const testPath = '/home/user/project/src';
+            const mockFiles = ['file1.js', 'file2.js', 'private.js'];
+            vi.mocked(fs.statSync).mockImplementation((path) => {
+                const pathStr = path.toString();
+                if (pathStr === testPath) {
+                    return { isDirectory: () => true };
+                }
+                return {
+                    isDirectory: () => false,
+                    mtime: new Date(),
+                    size: 1024,
+                };
+            });
+            vi.mocked(fs.readdirSync).mockReturnValue(mockFiles);
+            mockFileService.shouldGeminiIgnoreFile.mockImplementation((path) => path.includes('private.js'));
+            const invocation = lsTool.build({ path: testPath });
+            const result = await invocation.execute(new AbortController().signal);
+            expect(result.llmContent).toContain('file1.js');
+            expect(result.llmContent).toContain('file2.js');
+            expect(result.llmContent).not.toContain('private.js');
+            expect(result.returnDisplay).toBe('Listed 2 item(s). (1 gemini-ignored)');
+        });
+        it('should handle non-directory paths', async () => {
+            const testPath = '/home/user/project/file.txt';
+            vi.mocked(fs.statSync).mockReturnValue({
+                isDirectory: () => false,
+            });
+            const invocation = lsTool.build({ path: testPath });
+            const result = await invocation.execute(new AbortController().signal);
+            expect(result.llmContent).toContain('Path is not a directory');
+            expect(result.returnDisplay).toBe('Error: Path is not a directory.');
+            expect(result.error?.type).toBe(ToolErrorType.PATH_IS_NOT_A_DIRECTORY);
+        });
+        it('should handle non-existent paths', async () => {
+            const testPath = '/home/user/project/does-not-exist';
+            vi.mocked(fs.statSync).mockImplementation(() => {
+                throw new Error('ENOENT: no such file or directory');
+            });
+            const invocation = lsTool.build({ path: testPath });
+            const result = await invocation.execute(new AbortController().signal);
+            expect(result.llmContent).toContain('Error listing directory');
+            expect(result.returnDisplay).toBe('Error: Failed to list directory.');
+            expect(result.error?.type).toBe(ToolErrorType.LS_EXECUTION_ERROR);
+        });
+        it('should sort directories first, then files alphabetically', async () => {
+            const testPath = '/home/user/project/src';
+            const mockFiles = ['z-file.ts', 'a-dir', 'b-file.ts', 'c-dir'];
+            vi.mocked(fs.statSync).mockImplementation((path) => {
+                if (path.toString() === testPath) {
+                    return { isDirectory: () => true };
+                }
+                if (path.toString().endsWith('-dir')) {
+                    return {
+                        isDirectory: () => true,
+                        mtime: new Date(),
+                        size: 0,
+                    };
+                }
+                return {
+                    isDirectory: () => false,
+                    mtime: new Date(),
+                    size: 1024,
+                };
+            });
+            vi.mocked(fs.readdirSync).mockReturnValue(mockFiles);
+            const invocation = lsTool.build({ path: testPath });
+            const result = await invocation.execute(new AbortController().signal);
+            const lines = (typeof result.llmContent === 'string' ? result.llmContent : '').split('\n');
+            const entries = lines.slice(1).filter((line) => line.trim()); // Skip header
+            expect(entries[0]).toBe('[DIR] a-dir');
+            expect(entries[1]).toBe('[DIR] c-dir');
+            expect(entries[2]).toBe('b-file.ts');
+            expect(entries[3]).toBe('z-file.ts');
+        });
+        it('should handle permission errors gracefully', async () => {
+            const testPath = '/home/user/project/restricted';
+            vi.mocked(fs.statSync).mockReturnValue({
+                isDirectory: () => true,
+            });
+            vi.mocked(fs.readdirSync).mockImplementation(() => {
+                throw new Error('EACCES: permission denied');
+            });
+            const invocation = lsTool.build({ path: testPath });
+            const result = await invocation.execute(new AbortController().signal);
+            expect(result.llmContent).toContain('Error listing directory');
+            expect(result.llmContent).toContain('permission denied');
+            expect(result.returnDisplay).toBe('Error: Failed to list directory.');
+            expect(result.error?.type).toBe(ToolErrorType.LS_EXECUTION_ERROR);
+        });
+        it('should throw for invalid params at build time', async () => {
+            expect(() => lsTool.build({ path: '../outside' })).toThrow('Path must be absolute: ../outside');
+        });
+        it('should handle errors accessing individual files during listing', async () => {
+            const testPath = '/home/user/project/src';
+            const mockFiles = ['accessible.ts', 'inaccessible.ts'];
+            vi.mocked(fs.statSync).mockImplementation((path) => {
+                if (path.toString() === testPath) {
+                    return { isDirectory: () => true };
+                }
+                if (path.toString().endsWith('inaccessible.ts')) {
+                    throw new Error('EACCES: permission denied');
+                }
+                return {
+                    isDirectory: () => false,
+                    mtime: new Date(),
+                    size: 1024,
+                };
+            });
+            vi.mocked(fs.readdirSync).mockReturnValue(mockFiles);
+            // Spy on console.error to verify it's called
+            const consoleErrorSpy = vi
+                .spyOn(console, 'error')
+                .mockImplementation(() => { });
+            const invocation = lsTool.build({ path: testPath });
+            const result = await invocation.execute(new AbortController().signal);
+            // Should still list the accessible file
+            expect(result.llmContent).toContain('accessible.ts');
+            expect(result.llmContent).not.toContain('inaccessible.ts');
+            expect(result.returnDisplay).toBe('Listed 1 item(s).');
+            // Verify error was logged
+            expect(consoleErrorSpy).toHaveBeenCalledWith(expect.stringContaining('Error accessing'));
+            consoleErrorSpy.mockRestore();
+        });
+    });
+    describe('getDescription', () => {
+        it('should return shortened relative path', () => {
+            const params = {
+                path: `${mockPrimaryDir}/deeply/nested/directory`,
+            };
+            vi.mocked(fs.statSync).mockReturnValue({
+                isDirectory: () => true,
+            });
+            const invocation = lsTool.build(params);
+            const description = invocation.getDescription();
+            expect(description).toBe(path.join('deeply', 'nested', 'directory'));
+        });
+        it('should handle paths in secondary workspace', () => {
+            const params = {
+                path: `${mockSecondaryDir}/lib`,
+            };
+            vi.mocked(fs.statSync).mockReturnValue({
+                isDirectory: () => true,
+            });
+            const invocation = lsTool.build(params);
+            const description = invocation.getDescription();
+            expect(description).toBe(path.join('..', 'other-project', 'lib'));
+        });
+    });
+    describe('workspace boundary validation', () => {
+        it('should accept paths in primary workspace directory', () => {
+            const params = { path: `${mockPrimaryDir}/src` };
+            vi.mocked(fs.statSync).mockReturnValue({
+                isDirectory: () => true,
+            });
+            expect(lsTool.build(params)).toBeDefined();
+        });
+        it('should accept paths in secondary workspace directory', () => {
+            const params = { path: `${mockSecondaryDir}/lib` };
+            vi.mocked(fs.statSync).mockReturnValue({
+                isDirectory: () => true,
+            });
+            expect(lsTool.build(params)).toBeDefined();
+        });
+        it('should reject paths outside all workspace directories', () => {
+            const params = { path: '/etc/passwd' };
+            expect(() => lsTool.build(params)).toThrow('Path must be within one of the workspace directories');
+        });
+        it('should list files from secondary workspace directory', async () => {
+            const testPath = `${mockSecondaryDir}/tests`;
+            const mockFiles = ['test1.spec.ts', 'test2.spec.ts'];
+            vi.mocked(fs.statSync).mockImplementation((path) => {
+                if (path.toString() === testPath) {
+                    return { isDirectory: () => true };
+                }
+                return {
+                    isDirectory: () => false,
+                    mtime: new Date(),
+                    size: 512,
+                };
+            });
+            vi.mocked(fs.readdirSync).mockReturnValue(mockFiles);
+            const invocation = lsTool.build({ path: testPath });
+            const result = await invocation.execute(new AbortController().signal);
+            expect(result.llmContent).toContain('test1.spec.ts');
+            expect(result.llmContent).toContain('test2.spec.ts');
+            expect(result.returnDisplay).toBe('Listed 2 item(s).');
+        });
+    });
+});
+//# sourceMappingURL=ls.test.js.map