@qduc/term2 0.7.3 → 0.8.0

package/dist/tools/file/find-files.js

@@ -0,0 +1,176 @@
+import { z } from 'zod';
+import { exec } from 'child_process';
+import util from 'util';
+import path from 'path';
+import { resolveWorkspacePath, relaxedNumber } from '../utils.js';
+import { getOutputText, normalizeToolArguments, createBaseMessage, getCallIdFromItem } from '../format-helpers.js';
+const execPromise = util.promisify(exec);
+const findFilesParametersSchema = z.object({
+    pattern: z
+        .string()
+        .describe('Basename glob or filename to search for (e.g., "*.ts", "README.md"). Path segments are not allowed — use the `path` parameter to scope the directory.'),
+    path: z
+        .string()
+        .optional()
+        .describe('Directory to search in. Use "." for current directory. Defaults to current directory.'),
+    max_results: relaxedNumber
+        .int()
+        .positive()
+        .optional()
+        .describe('Maximum number of results to return. Defaults to 50.'),
+    no_ignore: z
+        .boolean()
+        .optional()
+        .describe('Set true to include files normally skipped by .gitignore/.ignore and hidden files (e.g., node_modules, .git, build output). Defaults to false. Only takes effect when fd is available.'),
+});
+import { executeShellCommand } from '../../utils/shell/execute-shell.js';
+let hasFd = null;
+let hasFdRemote = null;
+async function checkFdAvailability(executionContext) {
+    const isRemote = executionContext?.isRemote() ?? false;
+    if (isRemote) {
+        if (hasFdRemote !== null)
+            return hasFdRemote;
+        try {
+            const sshService = executionContext?.getSSHService();
+            if (!sshService)
+                return false;
+            await sshService.executeCommand('fd --version');
+            hasFdRemote = true;
+        }
+        catch {
+            hasFdRemote = false;
+        }
+        return hasFdRemote;
+    }
+    else {
+        if (hasFd !== null)
+            return hasFd;
+        try {
+            await execPromise('fd --version');
+            hasFd = true;
+        }
+        catch {
+            hasFd = false;
+        }
+        return hasFd;
+    }
+}
+export const formatFindFilesCommandMessage = (item, index, toolCallArgumentsById) => {
+    const callId = getCallIdFromItem(item);
+    const fallbackArgs = callId && toolCallArgumentsById.has(callId) ? toolCallArgumentsById.get(callId) : null;
+    const normalizedArgs = item?.rawItem?.arguments ?? item?.arguments;
+    const args = normalizeToolArguments(normalizedArgs) ?? normalizeToolArguments(fallbackArgs) ?? {};
+    const pattern = args?.pattern ?? '';
+    const searchPath = args?.path ?? '.';
+    const maxResults = args?.max_results;
+    const parts = [`find_files "${pattern}"`];
+    if (searchPath !== '.' && searchPath) {
+        parts.push(`"${searchPath}"`);
+    }
+    if (maxResults) {
+        parts.push(`--max ${maxResults}`);
+    }
+    const command = parts.join(' ');
+    const output = getOutputText(item) || 'No output';
+    const success = !output.startsWith('Error:') && !output.startsWith('No files found');
+    return [
+        createBaseMessage(item, index, 0, false, {
+            command,
+            output,
+            success,
+            toolName: 'find_files',
+            toolArgs: args,
+        }),
+    ];
+};
+const FIND_FILES_DESCRIPTION = 'Search for files by name in the workspace. Useful for finding files by pattern, exploring project structure, or locating specific files. ' +
+    'Use this when you know the file name or extension. ' +
+    'Do NOT use this to search file contents (use grep) or to find related code from a symbol (use code_context_search). ' +
+    'Returns up to max_results matching file paths, one per line, or a note if truncated.';
+const FIND_FILES_DESCRIPTION_OUTSIDE = 'Search for files by name on the filesystem. Useful for finding files by pattern, exploring directory structure, or locating specific files. ' +
+    'Use this when you know the file name or extension. ' +
+    'Do NOT use this to search file contents (use grep). ' +
+    'Returns up to max_results matching file paths, one per line, or a note if truncated.';
+export const createFindFilesToolDefinition = (deps = {}) => {
+    const { executionContext, allowOutsideWorkspace = false, forceFindFallback = false } = deps;
+    return {
+        name: 'find_files',
+        description: allowOutsideWorkspace ? FIND_FILES_DESCRIPTION_OUTSIDE : FIND_FILES_DESCRIPTION,
+        parameters: findFilesParametersSchema,
+        needsApproval: () => false, // Search is read-only and safe
+        execute: async (params) => {
+            const { pattern, path: searchPath, max_results, no_ignore } = params;
+            if (!pattern || pattern.trim() === '') {
+                return 'Error: Search pattern cannot be empty. Please provide a valid file name or glob pattern.';
+            }
+            if (patternHasPathSegments(pattern)) {
+                return 'Error: pattern must be basename-only (e.g., "*.ts", "README.md"). Use the `path` parameter to scope the directory. To search outside the workspace, use the shell tool.';
+            }
+            const limit = max_results ?? 50;
+            const targetPath = searchPath?.trim() || '.';
+            const cwd = executionContext?.getCwd() || process.cwd();
+            let absolutePath;
+            try {
+                // In Lite Mode we may allow searching outside the current workspace.
+                absolutePath = resolveWorkspacePath(targetPath, cwd, { allowOutsideWorkspace });
+            }
+            catch (error) {
+                if (error.message?.includes('outside workspace')) {
+                    return `Error: ${error.message}`;
+                }
+                throw error;
+            }
+            const useFd = forceFindFallback ? false : await checkFdAvailability(executionContext);
+            const escapedPattern = `'${pattern.replace(/'/g, "'\\''")}'`;
+            const escapedPath = `'${absolutePath.replace(/'/g, "'\\''")}'`;
+            let command;
+            if (useFd) {
+                const args = ['fd', '--color=never', '--type', 'f', '--glob'];
+                if (no_ignore)
+                    args.push('--no-ignore', '--hidden');
+                args.push(escapedPattern, escapedPath);
+                command = args.join(' ');
+            }
+            else {
+                // find pushes the glob down via -name so we don't enumerate the whole tree.
+                command = ['find', escapedPath, '-type', 'f', '-name', escapedPattern].join(' ');
+            }
+            const sshService = executionContext?.getSSHService();
+            const result = await executeShellCommand(command, {
+                maxBuffer: 10 * 1024 * 1024, // 10MB buffer
+                cwd,
+                sshService,
+            });
+            if (result.exitCode !== 0 && result.exitCode !== null) {
+                throw new Error(`File search failed: ${result.stderr.trim() || `exit code ${result.exitCode}`}`);
+            }
+            const trimmed = result.stdout.trim();
+            if (!trimmed) {
+                return `No files found matching pattern: ${pattern}`;
+            }
+            const cleanedLines = trimmed
+                .split('\n')
+                .filter(Boolean)
+                .map((line) => toRelative(line, absolutePath));
+            let resultText = cleanedLines.slice(0, limit).join('\n');
+            if (cleanedLines.length > limit) {
+                resultText += `\n\nNote: Results limited to ${limit} files. Found ${cleanedLines.length} total matches. Use max_results parameter to see more.`;
+            }
+            return resultText;
+        },
+        formatCommandMessage: formatFindFilesCommandMessage,
+    };
+};
+function patternHasPathSegments(pattern) {
+    return pattern.replace(/\\/g, '/').includes('/');
+}
+function toRelative(line, absolutePath) {
+    const normalized = line.replace(/\\/g, '/');
+    if (normalized.startsWith('./'))
+        return normalized.slice(2);
+    const root = absolutePath.replace(/\\/g, '/').replace(/\/+$/, '');
+    const rel = path.posix.relative(root, normalized);
+    return rel || normalized;
+}
+//# sourceMappingURL=find-files.js.map

package/dist/tools/file/find-files.js.map

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

package/dist/tools/file/find-files.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=find-files.test.d.ts.map

package/dist/tools/file/find-files.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-files.test.d.ts","sourceRoot":"","sources":["../../../source/tools/file/find-files.test.ts"],"names":[],"mappings":""}

package/dist/tools/file/find-files.test.js

@@ -0,0 +1,193 @@
+import { it, expect } from 'vitest';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as os from 'os';
+import { createFindFilesToolDefinition } from './find-files.js';
+import { ExecutionContext } from '../../services/execution-context.js';
+const findFilesToolDefinition = createFindFilesToolDefinition();
+const findFilesToolDefinitionAllowOutside = createFindFilesToolDefinition({
+    allowOutsideWorkspace: true,
+});
+const findFilesToolDefinitionFindFallback = createFindFilesToolDefinition({
+    forceFindFallback: true,
+});
+// Helper to create a temp dir and change cwd to it
+async function withTempDir(run) {
+    const originalCwd = process.cwd;
+    const rootDir = await fs.mkdtemp(path.join(os.tmpdir(), 'term2-test-'));
+    const workspaceDir = path.join(rootDir, 'workspace');
+    await fs.mkdir(workspaceDir, { recursive: true });
+    // Mock process.cwd (treat workspaceDir as the "workspace")
+    process.cwd = () => workspaceDir;
+    try {
+        await run(workspaceDir);
+    }
+    finally {
+        process.cwd = originalCwd;
+        await fs.rm(rootDir, { recursive: true, force: true });
+    }
+}
+it.sequential('needsApproval: returns false for read-only operation', async () => {
+    await withTempDir(async () => {
+        const result = await findFilesToolDefinition.needsApproval({
+            pattern: '*.ts',
+        });
+        expect(result).toBe(false);
+    });
+});
+it.sequential('schema: optional params can be omitted and null is rejected', async () => {
+    await withTempDir(async () => {
+        expect(findFilesToolDefinition.parameters.safeParse({ pattern: '*.ts' }).success).toBe(true);
+        expect(findFilesToolDefinition.parameters.safeParse({ pattern: '*.ts', path: null }).success).toBe(false);
+        expect(findFilesToolDefinition.parameters.safeParse({ pattern: '*.ts', max_results: null }).success).toBe(false);
+    });
+});
+it.sequential('execute: finds files by exact name', async () => {
+    await withTempDir(async (dir) => {
+        // Create test files
+        await fs.writeFile(path.join(dir, 'test.ts'), '');
+        await fs.writeFile(path.join(dir, 'other.js'), '');
+        const result = await findFilesToolDefinition.execute({
+            pattern: 'test.ts',
+        });
+        expect(result.includes('test.ts')).toBe(true);
+        expect(result.includes('other.js')).toBe(false);
+    });
+});
+it.sequential('execute: finds files by glob pattern', async () => {
+    await withTempDir(async (dir) => {
+        // Create test files
+        await fs.writeFile(path.join(dir, 'file1.ts'), '');
+        await fs.writeFile(path.join(dir, 'file2.ts'), '');
+        await fs.writeFile(path.join(dir, 'file3.js'), '');
+        const result = await findFilesToolDefinition.execute({
+            pattern: '*.ts',
+        });
+        expect(result.includes('file1.ts')).toBe(true);
+        expect(result.includes('file2.ts')).toBe(true);
+        expect(result.includes('file3.js')).toBe(false);
+    });
+});
+it.sequential('execute: finds files in nested directories with glob pattern', async () => {
+    await withTempDir(async (dir) => {
+        // Create nested directory structure
+        await fs.mkdir(path.join(dir, 'src'));
+        await fs.mkdir(path.join(dir, 'src/utils'));
+        await fs.writeFile(path.join(dir, 'src/index.ts'), '');
+        await fs.writeFile(path.join(dir, 'src/utils/helper.ts'), '');
+        await fs.writeFile(path.join(dir, 'readme.md'), '');
+        const result = await findFilesToolDefinition.execute({
+            pattern: '*.ts',
+        });
+        expect(result.includes('src/index.ts') || result.includes('index.ts')).toBe(true);
+        expect(result.includes('src/utils/helper.ts') || result.includes('utils/helper.ts')).toBe(true);
+        expect(result.includes('readme.md')).toBe(false);
+    });
+});
+it.sequential('execute: rejects patterns with path segments', async () => {
+    await withTempDir(async (dir) => {
+        await fs.mkdir(path.join(dir, 'src'));
+        await fs.writeFile(path.join(dir, 'src/index.ts'), '');
+        const result = await findFilesToolDefinitionFindFallback.execute({
+            pattern: 'src/**/*',
+        });
+        expect(result.startsWith('Error')).toBe(true);
+        expect(result.includes('basename-only')).toBe(true);
+    });
+});
+it.sequential('execute: on SSH without fd, rejects patterns with path segments', async () => {
+    await withTempDir(async () => {
+        const sshService = {
+            connect: async () => { },
+            disconnect: async () => { },
+            isConnected: () => true,
+            executeCommand: async () => {
+                throw new Error('fd not found');
+            },
+            readFile: async () => '',
+            writeFile: async () => { },
+            mkdir: async () => { },
+        };
+        const executionContext = new ExecutionContext(sshService);
+        const tool = createFindFilesToolDefinition({ executionContext });
+        const result = await tool.execute({
+            pattern: 'src/**/*',
+        });
+        expect(result.includes('Error')).toBe(true);
+        expect(result.includes('path')).toBe(true);
+    });
+});
+it.sequential('execute: restricts search to specified path', async () => {
+    await withTempDir(async (dir) => {
+        // Create nested directory structure
+        await fs.mkdir(path.join(dir, 'src'));
+        await fs.mkdir(path.join(dir, 'tests'));
+        await fs.writeFile(path.join(dir, 'src/app.ts'), '');
+        await fs.writeFile(path.join(dir, 'tests/app.test.ts'), '');
+        const result = await findFilesToolDefinition.execute({
+            pattern: '*.ts',
+            path: 'src',
+        });
+        expect(result.includes('app.ts')).toBe(true);
+        expect(result.includes('app.test.ts')).toBe(false);
+    });
+});
+it.sequential('execute: respects max_results limit', async () => {
+    await withTempDir(async (dir) => {
+        // Create many files
+        for (let i = 1; i <= 10; i++) {
+            await fs.writeFile(path.join(dir, `file${i}.ts`), '');
+        }
+        const result = await findFilesToolDefinition.execute({
+            pattern: '*.ts',
+            max_results: 5,
+        });
+        const lines = result.trim().split('\n');
+        // Should have 5 file results + empty line + 1 note line = 7 lines max
+        expect(lines.length <= 8).toBe(true);
+        expect(result.includes('Results limited to')).toBe(true);
+    });
+});
+it.sequential('execute: handles no matches found', async () => {
+    await withTempDir(async (dir) => {
+        await fs.writeFile(path.join(dir, 'file.js'), '');
+        const result = await findFilesToolDefinition.execute({
+            pattern: '*.ts',
+        });
+        expect(result.includes('No files found')).toBe(true);
+    });
+});
+it.sequential('execute: rejects path outside workspace', async () => {
+    await withTempDir(async () => {
+        const result = await findFilesToolDefinition.execute({
+            pattern: '*.ts',
+            path: '/etc/outside',
+        });
+        expect(result.includes('Error')).toBe(true);
+        expect(result.includes('outside workspace')).toBe(true);
+    });
+});
+it.sequential('execute: in allowOutsideWorkspace mode, can search outside workspace', async () => {
+    await withTempDir(async (dir) => {
+        const outsideDir = path.join(dir, '..', 'outside');
+        await fs.mkdir(outsideDir, { recursive: true });
+        await fs.writeFile(path.join(outsideDir, 'outside.ts'), '');
+        await fs.writeFile(path.join(outsideDir, 'outside.js'), '');
+        const result = await findFilesToolDefinitionAllowOutside.execute({
+            pattern: '*.ts',
+            path: '../outside',
+        });
+        expect(result.includes('outside.ts')).toBe(true);
+        expect(result.includes('outside.js')).toBe(false);
+        expect(result.includes('outside workspace')).toBe(false);
+    });
+});
+it.sequential('execute: handles non-existent directory', async () => {
+    await withTempDir(async () => {
+        await expect(findFilesToolDefinition.execute({
+            pattern: '*.ts',
+            path: 'nonexistent',
+        })).rejects.toThrow(/File search failed/);
+    });
+});
+//# sourceMappingURL=find-files.test.js.map

package/dist/tools/file/find-files.test.js.map

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

package/dist/tools/file/read-file.d.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import type { ToolDefinition, FormatCommandMessage } from '../types.js';
+declare const readFileParametersSchema: z.ZodObject<{
+    path: z.ZodString;
+    start_line: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    end_line: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export type ReadFileToolParams = z.infer<typeof readFileParametersSchema>;
+export declare const formatReadFileCommandMessage: FormatCommandMessage;
+import { ExecutionContext } from '../../services/execution-context.js';
+export declare const createReadFileToolDefinition: (deps?: {
+    executionContext?: ExecutionContext;
+    allowOutsideWorkspace?: boolean;
+    orchestratorMode?: boolean;
+}) => ToolDefinition<ReadFileToolParams>;
+export {};
+//# sourceMappingURL=read-file.d.ts.map

package/dist/tools/file/read-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../../../source/tools/file/read-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAoBxE,QAAA,MAAM,wBAAwB;;;;iBAY5B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,4BAA4B,EAAE,oBA6B1C,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAEvE,eAAO,MAAM,4BAA4B,GACvC,OAAM;IACJ,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACvB,KACL,cAAc,CAAC,kBAAkB,CA6EnC,CAAC"}

package/dist/tools/file/read-file.js

@@ -0,0 +1,130 @@
+import { z } from 'zod';
+import * as fs from 'fs/promises';
+import { resolveWorkspacePath, relaxedNumber } from '../utils.js';
+import { trimOutput } from '../../utils/output/output-trim.js';
+import { getOutputText, normalizeToolArguments, createBaseMessage, getCallIdFromItem } from '../format-helpers.js';
+const READ_FILE_DESCRIPTION = 'Read file content from the workspace (like cat command). Supports reading specific line ranges. ' +
+    'Use this to inspect a known file or verify a specific claim about a location. ' +
+    'Avoid reading tiny repeated chunks (e.g. 50 lines at a time); read the full file if it is under 1000 lines or use a larger window. ' +
+    'Do NOT use this to search for text across files (use grep) or to explore unfamiliar code (use run_subagent with an explorer). ' +
+    'Returns the file path, total line count, and the requested lines.';
+const READ_FILE_DESCRIPTION_OUTSIDE = 'Read file content from the filesystem (like cat command). Supports reading specific line ranges. ' +
+    'Use this to inspect a known file or verify a specific claim about a location. ' +
+    'Avoid reading tiny repeated chunks (e.g. 50 lines at a time); read the full file if it is under 1000 lines or use a larger window. ' +
+    'Returns the file path, total line count, and the requested lines.';
+const READ_FILE_DESCRIPTION_ORCHESTRATOR = "Read file content to verify a specific claim about a known location (e.g., confirm a subagent's edit landed, check a referenced symbol). " +
+    'For exploring unfamiliar code or understanding files you have not seen, prefer delegating to an `explorer` subagent via `run_subagent`. ' +
+    'Supports line ranges — read the smallest relevant range. ' +
+    'Returns the file path, total line count, and the requested lines.';
+const readFileParametersSchema = z.object({
+    path: z.string().describe('File path relative to workspace root'),
+    start_line: relaxedNumber
+        .int()
+        .positive()
+        .optional()
+        .describe('Starting line number (1-indexed). If not provided, reads from the beginning.'),
+    end_line: relaxedNumber
+        .int()
+        .positive()
+        .optional()
+        .describe('Ending line number (1-indexed, inclusive). If not provided, reads to the end.'),
+});
+export const formatReadFileCommandMessage = (item, index, toolCallArgumentsById) => {
+    const callId = getCallIdFromItem(item);
+    const fallbackArgs = callId && toolCallArgumentsById.has(callId) ? toolCallArgumentsById.get(callId) : null;
+    const normalizedArgs = item?.rawItem?.arguments ?? item?.arguments;
+    const args = normalizeToolArguments(normalizedArgs) ?? normalizeToolArguments(fallbackArgs) ?? {};
+    const filePath = args?.path ?? 'unknown';
+    const startLine = args?.start_line;
+    const endLine = args?.end_line;
+    let command = `read_file "${filePath}"`;
+    if (startLine !== undefined || endLine !== undefined) {
+        const start = startLine ?? 1;
+        const end = endLine ?? 'end';
+        command += ` --lines ${start}-${end}`;
+    }
+    const output = getOutputText(item) || 'No output';
+    const success = !output.startsWith('Error:');
+    return [
+        createBaseMessage(item, index, 0, false, {
+            command,
+            output,
+            success,
+            toolName: 'read_file',
+            toolArgs: args,
+        }),
+    ];
+};
+export const createReadFileToolDefinition = (deps = {}) => {
+    const { executionContext, allowOutsideWorkspace = false, orchestratorMode = false } = deps;
+    return {
+        name: 'read_file',
+        description: orchestratorMode
+            ? READ_FILE_DESCRIPTION_ORCHESTRATOR
+            : allowOutsideWorkspace
+                ? READ_FILE_DESCRIPTION_OUTSIDE
+                : READ_FILE_DESCRIPTION,
+        parameters: readFileParametersSchema,
+        needsApproval: () => false, // Read-only operation, safe
+        execute: async (params) => {
+            const { path: filePath, start_line, end_line } = params;
+            const cwd = executionContext?.getCwd() || process.cwd();
+            try {
+                // In Lite Mode we may allow reading outside the current workspace.
+                const absolutePath = resolveWorkspacePath(filePath, cwd, {
+                    allowOutsideWorkspace,
+                });
+                // Read file content
+                let content;
+                const sshService = executionContext?.getSSHService();
+                if (executionContext?.isRemote() && sshService) {
+                    content = await sshService.readFile(absolutePath);
+                }
+                else {
+                    content = await fs.readFile(absolutePath, 'utf8');
+                }
+                // Handle empty file
+                if (content === '') {
+                    return '';
+                }
+                // Split into lines
+                const lines = content.split('\n');
+                const totalLines = lines.length;
+                // Parse line range (auto-fill if omitted)
+                const fromLine = start_line || 1;
+                const toLine = end_line || totalLines;
+                // Filter lines based on start_line and end_line
+                let filteredLines = lines;
+                if (start_line !== undefined || end_line !== undefined) {
+                    const startIdx = start_line ? start_line - 1 : 0;
+                    const endIdx = end_line ? end_line : lines.length;
+                    filteredLines = lines.slice(startIdx, endIdx);
+                }
+                // Create header with file path, line count, and line range
+                const header = `File: ${filePath} (${totalLines} lines) [lines ${fromLine}-${toLine}]\n${'='.repeat(3)}\n`;
+                // Join and trim output
+                const fileContent = filteredLines.join('\n');
+                const result = header + fileContent;
+                return trimOutput(result);
+            }
+            catch (error) {
+                // Handle errors gracefully
+                if (error.message?.includes('outside workspace')) {
+                    return `Error: ${error.message}`;
+                }
+                if (error.code === 'ENOENT') {
+                    return `Error: File not found: ${filePath}`;
+                }
+                if (error.code === 'EACCES') {
+                    return `Error: Permission denied: ${filePath}`;
+                }
+                if (error.code === 'EISDIR') {
+                    return `Error: Path is a directory: ${filePath}`;
+                }
+                return `Error: ${error.message || String(error)}`;
+            }
+        },
+        formatCommandMessage: formatReadFileCommandMessage,
+    };
+};
+//# sourceMappingURL=read-file.js.map

package/dist/tools/file/read-file.js.map

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

package/dist/tools/file/read-file.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=read-file.test.d.ts.map

package/dist/tools/file/read-file.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.test.d.ts","sourceRoot":"","sources":["../../../source/tools/file/read-file.test.ts"],"names":[],"mappings":""}