@qduc/term2 0.1.0

package/dist/tools/format-helpers.js

@@ -0,0 +1,131 @@
+/**
+ * Helper utilities for formatting tool execution results into command messages.
+ * These utilities are shared across tool formatters to maintain consistency.
+ */
+/**
+ * Coerces various value types into a text string representation.
+ */
+export const coerceToText = (value) => {
+    if (value === null || value === undefined) {
+        return '';
+    }
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value
+            .map(part => coerceToText(part))
+            .filter(Boolean)
+            .join('\n');
+    }
+    if (typeof value === 'object') {
+        if ('text' in value && typeof value.text === 'string') {
+            return value.text;
+        }
+        if ('output' in value && typeof value.output === 'string') {
+            return value.output;
+        }
+        try {
+            return JSON.stringify(value);
+        }
+        catch {
+            return '';
+        }
+    }
+    return String(value);
+};
+/**
+ * Extracts call ID from various item formats.
+ */
+export const getCallIdFromItem = (item) => {
+    const rawItem = item?.rawItem ?? item;
+    if (!rawItem) {
+        return null;
+    }
+    return (rawItem.callId ??
+        rawItem.call_id ??
+        rawItem.tool_call_id ??
+        rawItem.toolCallId ??
+        rawItem.id ??
+        item?.callId ??
+        item?.call_id ??
+        item?.tool_call_id ??
+        item?.toolCallId ??
+        item?.id ??
+        null);
+};
+/**
+ * Extracts output text from various item formats.
+ */
+export const getOutputText = (item) => {
+    const sources = [item, item?.rawItem];
+    for (const source of sources) {
+        if (!source) {
+            continue;
+        }
+        for (const candidate of [source.output, source.output?.text]) {
+            const text = coerceToText(candidate);
+            if (text) {
+                return text;
+            }
+        }
+    }
+    return '';
+};
+/**
+ * Safely parses JSON payload.
+ */
+export const safeJsonParse = (payload) => {
+    if (typeof payload !== 'string') {
+        return null;
+    }
+    const trimmed = payload.trim();
+    if (!trimmed) {
+        return null;
+    }
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return null;
+    }
+};
+/**
+ * Normalizes tool arguments from various formats.
+ */
+export const normalizeToolArguments = (value) => {
+    if (!value) {
+        return null;
+    }
+    if (typeof value === 'string') {
+        return safeJsonParse(value) ?? value;
+    }
+    return value;
+};
+/**
+ * Generates a stable ID for a command message.
+ */
+export const generateMessageId = (item, index, subIndex = 0) => {
+    const rawItem = item?.rawItem ?? item;
+    const baseId = rawItem?.id ??
+        rawItem?.callId ??
+        item?.id ??
+        item?.callId ??
+        `${Date.now()}-${index}`;
+    return `${baseId}-${subIndex}`;
+};
+/**
+ * Creates a base command message with common fields filled in.
+ */
+export const createBaseMessage = (item, index, subIndex, isApprovalRejection, partial) => {
+    const callId = getCallIdFromItem(item);
+    return {
+        id: generateMessageId(item, index, subIndex),
+        sender: 'command',
+        status: 'completed',
+        isApprovalRejection,
+        ...(callId ? { callId } : {}),
+        ...partial,
+    };
+};
+//# sourceMappingURL=format-helpers.js.map

package/dist/tools/format-helpers.js.map

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

package/dist/tools/grep.d.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+import { setTrimConfig, getTrimConfig, DEFAULT_TRIM_CONFIG, type OutputTrimConfig } from '../utils/output-trim.js';
+import type { ToolDefinition, CommandMessage } from './types.js';
+declare const searchParametersSchema: z.ZodObject<{
+    pattern: z.ZodString;
+    path: z.ZodString;
+    file_pattern: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type SearchToolParams = z.infer<typeof searchParametersSchema>;
+export { setTrimConfig, getTrimConfig, DEFAULT_TRIM_CONFIG, type OutputTrimConfig, };
+import { ExecutionContext } from '../services/execution-context.js';
+export declare const createGrepToolDefinition: (deps?: {
+    executionContext?: ExecutionContext;
+}) => ToolDefinition<SearchToolParams>;
+export declare const formatGrepCommandMessage: (item: any, index: number, toolCallArgumentsById: Map<string, unknown>) => CommandMessage[];
+//# sourceMappingURL=grep.d.ts.map

package/dist/tools/grep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grep.d.ts","sourceRoot":"","sources":["../../source/tools/grep.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAGtB,OAAO,EAEH,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,KAAK,gBAAgB,EACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAC,cAAc,EAAE,cAAc,EAAC,MAAM,YAAY,CAAC;AAW/D,QAAA,MAAM,sBAAsB;;;;iBAc1B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAGtE,OAAO,EACH,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,KAAK,gBAAgB,GACxB,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAgCpE,eAAO,MAAM,wBAAwB,GAAI,OAAM;IAAE,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;CAAO,KAAG,cAAc,CAAC,gBAAgB,CA2I5H,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACjC,MAAM,GAAG,EACT,OAAO,MAAM,EACb,uBAAuB,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5C,cAAc,EA+ChB,CAAC"}

package/dist/tools/grep.js

@@ -0,0 +1,211 @@
+import { z } from 'zod';
+import { exec } from 'child_process';
+import util from 'util';
+import { trimOutput, setTrimConfig, getTrimConfig, DEFAULT_TRIM_CONFIG, } from '../utils/output-trim.js';
+import { getOutputText, safeJsonParse, normalizeToolArguments, createBaseMessage, getCallIdFromItem, } from './format-helpers.js';
+const execPromise = util.promisify(exec);
+const searchParametersSchema = z.object({
+    pattern: z.string().describe('The text or regex pattern to search for'),
+    path: z
+        .string()
+        .describe('The directory or file to search in. Use "." for current directory.'),
+    file_pattern: z
+        .string()
+        .nullable()
+        .optional()
+        .describe('Glob pattern for files to include (e.g., "*.ts"). Pass null to include all files.'),
+});
+// Re-export trim utilities for backwards compatibility
+export { setTrimConfig, getTrimConfig, DEFAULT_TRIM_CONFIG, };
+import { executeShellCommand } from '../utils/execute-shell.js';
+let hasRg = null;
+let hasRgRemote = null;
+async function checkRgAvailability(executionContext) {
+    const isRemote = executionContext?.isRemote() ?? false;
+    if (isRemote) {
+        if (hasRgRemote !== null)
+            return hasRgRemote;
+        try {
+            const sshService = executionContext?.getSSHService();
+            if (!sshService)
+                return false;
+            await sshService.executeCommand('rg --version');
+            hasRgRemote = true;
+        }
+        catch {
+            hasRgRemote = false;
+        }
+        return hasRgRemote;
+    }
+    else {
+        if (hasRg !== null)
+            return hasRg;
+        try {
+            await execPromise('rg --version');
+            hasRg = true;
+        }
+        catch {
+            hasRg = false;
+        }
+        return hasRg;
+    }
+}
+export const createGrepToolDefinition = (deps = {}) => {
+    const { executionContext } = deps;
+    return {
+        name: 'grep',
+        description: 'Search for text in the codebase. Useful for exploring code, finding usages, etc.',
+        parameters: searchParametersSchema,
+        needsApproval: () => false, // Search is read-only and safe
+        execute: async (params) => {
+            const { pattern, path: searchPath, file_pattern } = params;
+            // Validate pattern is not empty
+            if (!pattern || pattern.trim() === '') {
+                throw new Error('Search pattern cannot be empty. Please provide a valid search term.');
+            }
+            // Default values for removed parameters
+            const case_sensitive = false; // Case-insensitive by default
+            const exclude_pattern = null; // No exclusions (ripgrep respects .gitignore)
+            const max_results = 50; // Lowered to reduce output size
+            const useRg = await checkRgAvailability(executionContext);
+            let command = '';
+            const limit = max_results;
+            if (useRg) {
+                const args = [
+                    'rg',
+                    '--line-number',
+                    '--no-heading',
+                    '--color=never',
+                ];
+                if (!case_sensitive)
+                    args.push('--ignore-case');
+                if (file_pattern)
+                    args.push('-g', `'${file_pattern}'`);
+                if (exclude_pattern)
+                    args.push('-g', `'!${exclude_pattern}'`);
+                // Escape pattern
+                args.push(`'${pattern.replace(/'/g, "'\\''")}'`);
+                args.push(searchPath);
+                command = args.join(' ');
+            }
+            else {
+                // Fallback to grep
+                const args = ['grep', '-r', '-n', '-I']; // -I to ignore binary
+                if (!case_sensitive)
+                    args.push('-i');
+                if (file_pattern)
+                    args.push(`--include='${file_pattern}'`);
+                if (exclude_pattern)
+                    args.push(`--exclude='${exclude_pattern}'`);
+                // Escape pattern
+                args.push(`'${pattern.replace(/'/g, "'\\''")}'`);
+                args.push(searchPath);
+                command = args.join(' ');
+            }
+            const cwd = executionContext?.getCwd() || process.cwd();
+            const sshService = executionContext?.getSSHService();
+            try {
+                const { stdout } = await executeShellCommand(command, {
+                    maxBuffer: 10 * 1024 * 1024, // 10MB buffer
+                    cwd,
+                    sshService,
+                });
+                const trimmed = stdout.trim();
+                const lineCount = trimmed.split('\n').length;
+                const result = trimOutput(trimmed, limit);
+                // Add hint if results were truncated
+                if (lineCount > limit) {
+                    return `${result}\n\nNote: Results exceeded ${limit} lines. Consider narrowing your search with a more specific pattern or file_pattern.`;
+                }
+                return result || 'No matches found.';
+            }
+            catch (error) {
+                // grep/rg returns exit code 1 if no matches found, which executeShellCommand might NOT treat as error if we handle it there?
+                // executeShellCommand catches errors.
+                // sshService.executeCommand catches error? no, creates promise.
+                // Wait, executeShellCommand wraps exec and returns object even on error.
+                // But if it THROWS, we catch it here.
+                // executeShellCommand returns object with exitCode. It does NOT throw for non-zero exit code usually?
+                // Let's check executeShellCommand implementation.
+                // "const exitCode = typeof error?.code === 'number' ? error.code : null;" in catch block.
+                // It catches exec exceptions and returns ShellExecutionResult.
+                // So result.exitCode check is needed.
+                // But wait, I am destructuring {stdout} and ignoring exitCode.
+                // If grep returns 1, stdout is likely empty.
+                // Let's refine the try/catch logic or result inspection.
+                // executeShellCommand returns {stdout, stderr, exitCode}.
+                // If grep fails (exit 1), exitCode is 1.
+                // However, previous code used `execPromise` which throws on exit code != 0.
+                // executeShellCommand handles parsing.
+                // I should capture result and check exitCode.
+                // But wait, executeShellCommand throws?
+                // No, look at implementation: it catches error and returns object.
+                // So my destructing was: const {stdout} = await executeShellCommand(...)
+                // If exitCode is 1 (no match), stdout is empty.
+                // If exitCode is 2 (error), stderr has content.
+                // So I should check stderr?
+            }
+            // Re-implementing try block with proper check
+            const result = await executeShellCommand(command, {
+                maxBuffer: 10 * 1024 * 1024,
+                cwd,
+                sshService,
+            });
+            if (result.exitCode === 1) {
+                return 'No matches found.';
+            }
+            if (result.exitCode !== 0 && result.exitCode !== null) {
+                throw new Error(`Search failed: ${result.stderr}`);
+            }
+            const trimmed = result.stdout.trim();
+            const lineCount = trimmed.split('\n').length;
+            const outputTrimmed = trimOutput(trimmed, limit);
+            if (lineCount > limit) {
+                return `${outputTrimmed}\n\nNote: Results exceeded ${limit} lines. Consider narrowing your search with a more specific pattern or file_pattern.`;
+            }
+            return outputTrimmed || 'No matches found.';
+        },
+        formatCommandMessage: formatGrepCommandMessage,
+    };
+};
+export const formatGrepCommandMessage = (item, index, toolCallArgumentsById) => {
+    const parsedOutput = safeJsonParse(getOutputText(item));
+    const rawItem = item?.rawItem ?? item;
+    const lookupCallId = rawItem?.callId ??
+        rawItem?.id ??
+        item?.callId ??
+        item?.id ??
+        getCallIdFromItem(item);
+    const fallbackArgs = lookupCallId && toolCallArgumentsById.has(lookupCallId)
+        ? toolCallArgumentsById.get(lookupCallId)
+        : null;
+    const normalizedArgs = item?.rawItem?.arguments ?? item?.arguments;
+    const args = normalizeToolArguments(normalizedArgs) ??
+        normalizeToolArguments(fallbackArgs) ??
+        parsedOutput?.arguments;
+    const pattern = args?.pattern ?? '';
+    const searchPath = args?.path ?? '.';
+    const parts = [`grep "${pattern}"`, `"${searchPath}"`];
+    if (args?.case_sensitive) {
+        parts.push('--case-sensitive');
+    }
+    if (args?.file_pattern) {
+        parts.push(`--include "${args.file_pattern}"`);
+    }
+    if (args?.exclude_pattern) {
+        parts.push(`--exclude "${args.exclude_pattern}"`);
+    }
+    const command = parts.join(' ');
+    const output = parsedOutput?.output ?? getOutputText(item) ?? 'No output';
+    // Success is determined by the grep tool - it returns "No matches found."
+    // for empty results and throws for actual errors
+    const success = true;
+    return [
+        createBaseMessage(item, index, 0, false, {
+            command,
+            output,
+            success,
+        }),
+    ];
+};
+//# sourceMappingURL=grep.js.map

package/dist/tools/grep.js.map

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

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

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import type { ToolDefinition, CommandMessage } 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: (item: any, index: number, toolCallArgumentsById: Map<string, unknown>) => CommandMessage[];
+import { ExecutionContext } from '../services/execution-context.js';
+export declare const createReadFileToolDefinition: (deps?: {
+    executionContext?: ExecutionContext;
+}) => ToolDefinition<ReadFileToolParams>;
+export {};
+//# sourceMappingURL=read-file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../../source/tools/read-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAItB,OAAO,KAAK,EAAC,cAAc,EAAE,cAAc,EAAC,MAAM,YAAY,CAAC;AAQ/D,QAAA,MAAM,wBAAwB;;;;iBAY5B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,4BAA4B,GACrC,MAAM,GAAG,EACT,OAAO,MAAM,EACb,uBAAuB,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5C,cAAc,EAmChB,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEpE,eAAO,MAAM,4BAA4B,GAAI,OAAM;IAAE,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;CAAO,KAAG,cAAc,CAAC,kBAAkB,CAsElI,CAAC"}

package/dist/tools/read-file.js

@@ -0,0 +1,114 @@
+import { z } from 'zod';
+import * as fs from 'fs/promises';
+import { resolveWorkspacePath, relaxedNumber } from './utils.js';
+import { trimOutput } from '../utils/output-trim.js';
+import { getOutputText, normalizeToolArguments, createBaseMessage, getCallIdFromItem, } from './format-helpers.js';
+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 } = deps;
+    return {
+        name: 'read_file',
+        description: 'Read file content from the workspace. Returns content with line numbers prefixed (like cat -n). Supports reading specific line ranges.',
+        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 {
+                // Validate path is within workspace
+                const absolutePath = resolveWorkspacePath(filePath, cwd);
+                // 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');
+                // 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);
+                }
+                // Add line numbers (1-indexed)
+                const startLineNum = start_line || 1;
+                const numberedLines = filteredLines.map((line, idx) => {
+                    const lineNum = startLineNum + idx;
+                    return `${lineNum}\t${line}`;
+                });
+                // Join and trim output
+                const result = numberedLines.join('\n');
+                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/read-file.js.map

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

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

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

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

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

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

@@ -0,0 +1,122 @@
+import test from 'ava';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as os from 'os';
+import { createReadFileToolDefinition } from './read-file.js';
+const readFileToolDefinition = createReadFileToolDefinition();
+// Helper to create a temp dir and change cwd to it
+async function withTempDir(run) {
+    const originalCwd = process.cwd;
+    const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'term2-test-'));
+    // Mock process.cwd
+    process.cwd = () => tempDir;
+    try {
+        await run(tempDir);
+    }
+    finally {
+        process.cwd = originalCwd;
+        await fs.rm(tempDir, { recursive: true, force: true });
+    }
+}
+test.serial('needsApproval: returns false for read-only operation', async (t) => {
+    await withTempDir(async () => {
+        const result = await readFileToolDefinition.needsApproval({
+            path: 'test.txt',
+        });
+        t.false(result);
+    });
+});
+test.serial('execute: successfully reads a file', async (t) => {
+    await withTempDir(async (dir) => {
+        const filePath = 'test.txt';
+        const content = 'Hello\nWorld\nFrom\nFile';
+        await fs.writeFile(path.join(dir, filePath), content);
+        const result = await readFileToolDefinition.execute({
+            path: filePath,
+        });
+        // Result should include line numbers
+        t.true(result.includes('1\tHello'));
+        t.true(result.includes('2\tWorld'));
+        t.true(result.includes('3\tFrom'));
+        t.true(result.includes('4\tFile'));
+    });
+});
+test.serial('execute: reads file with line range', async (t) => {
+    await withTempDir(async (dir) => {
+        const filePath = 'test.txt';
+        const content = 'Line 1\nLine 2\nLine 3\nLine 4\nLine 5';
+        await fs.writeFile(path.join(dir, filePath), content);
+        const result = await readFileToolDefinition.execute({
+            path: filePath,
+            start_line: 2,
+            end_line: 4,
+        });
+        // Should only include lines 2-4
+        t.false(result.includes('1\tLine 1'));
+        t.true(result.includes('2\tLine 2'));
+        t.true(result.includes('3\tLine 3'));
+        t.true(result.includes('4\tLine 4'));
+        t.false(result.includes('5\tLine 5'));
+    });
+});
+test.serial('execute: reads file from start_line to end', async (t) => {
+    await withTempDir(async (dir) => {
+        const filePath = 'test.txt';
+        const content = 'Line 1\nLine 2\nLine 3\nLine 4\nLine 5';
+        await fs.writeFile(path.join(dir, filePath), content);
+        const result = await readFileToolDefinition.execute({
+            path: filePath,
+            start_line: 3,
+        });
+        // Should include lines 3-5
+        t.false(result.includes('1\tLine 1'));
+        t.false(result.includes('2\tLine 2'));
+        t.true(result.includes('3\tLine 3'));
+        t.true(result.includes('4\tLine 4'));
+        t.true(result.includes('5\tLine 5'));
+    });
+});
+test.serial('execute: rejects path outside workspace', async (t) => {
+    await withTempDir(async () => {
+        const result = await readFileToolDefinition.execute({
+            path: '../outside.txt',
+        });
+        t.true(result.includes('Error'));
+        t.true(result.includes('outside workspace'));
+    });
+});
+test.serial('execute: handles file not found', async (t) => {
+    await withTempDir(async () => {
+        const result = await readFileToolDefinition.execute({
+            path: 'nonexistent.txt',
+        });
+        t.true(result.includes('Error'));
+        t.true(result.includes('ENOENT') || result.includes('not found'));
+    });
+});
+test.serial('execute: handles empty file', async (t) => {
+    await withTempDir(async (dir) => {
+        const filePath = 'empty.txt';
+        await fs.writeFile(path.join(dir, filePath), '');
+        const result = await readFileToolDefinition.execute({
+            path: filePath,
+        });
+        t.is(result.trim(), '');
+    });
+});
+test.serial('execute: handles line range beyond file length', async (t) => {
+    await withTempDir(async (dir) => {
+        const filePath = 'short.txt';
+        const content = 'Line 1\nLine 2';
+        await fs.writeFile(path.join(dir, filePath), content);
+        const result = await readFileToolDefinition.execute({
+            path: filePath,
+            start_line: 1,
+            end_line: 10,
+        });
+        // Should only include available lines
+        t.true(result.includes('1\tLine 1'));
+        t.true(result.includes('2\tLine 2'));
+    });
+});
+//# sourceMappingURL=read-file.test.js.map