@visorcraft/idlehands 1.4.6 → 2.0.0

package/dist/tools/file-discovery.js

@@ -0,0 +1,144 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { shellEscape } from '../utils.js';
+import { resolvePath, redactPath } from './path-safety.js';
+import { globishMatch, hasRg } from './search-utils.js';
+import { ToolError } from './tool-error.js';
+export async function listDirTool(ctx, args) {
+    const p = resolvePath(ctx, args?.path ?? '.');
+    const recursive = Boolean(args?.recursive);
+    const maxEntries = Math.min(args?.max_entries ? Number(args.max_entries) : 200, 500);
+    if (!p)
+        throw new Error('list_dir: missing path');
+    const absCwd = path.resolve(ctx.cwd);
+    const lines = [];
+    let count = 0;
+    async function walk(dir, depth) {
+        if (count >= maxEntries)
+            return;
+        const ents = await fs.readdir(dir, { withFileTypes: true }).catch((e) => {
+            throw new Error(`list_dir: cannot read ${dir}: ${e?.message ?? String(e)}`);
+        });
+        for (const ent of ents) {
+            if (count >= maxEntries)
+                return;
+            const full = path.join(dir, ent.name);
+            const st = await fs.lstat(full).catch(() => null);
+            const kind = ent.isDirectory() ? 'dir' : ent.isSymbolicLink() ? 'link' : 'file';
+            lines.push(`${kind}\t${st?.size ?? 0}\t${redactPath(full, absCwd)}`);
+            count++;
+            if (recursive && ent.isDirectory() && depth < 3) {
+                await walk(full, depth + 1);
+            }
+        }
+    }
+    await walk(p, 0);
+    if (count >= maxEntries)
+        lines.push(`[truncated after ${maxEntries} entries]`);
+    if (!lines.length)
+        return `[empty directory: ${redactPath(p, absCwd)}]`;
+    return lines.join('\n');
+}
+export async function searchFilesTool(ctx, args, execFn) {
+    const root = resolvePath(ctx, args?.path ?? '.');
+    const pattern = typeof args?.pattern === 'string' ? args.pattern : undefined;
+    const include = typeof args?.include === 'string' ? args.include : undefined;
+    const maxResults = Math.min(args?.max_results ? Number(args.max_results) : 50, 100);
+    if (!root)
+        throw new Error('search_files: missing path');
+    if (!pattern)
+        throw new Error('search_files: missing pattern');
+    const absCwd = path.resolve(ctx.cwd);
+    if (await hasRg()) {
+        const cmd = ['rg', '-n', '--no-heading', '--color', 'never', pattern, root];
+        if (include)
+            cmd.splice(1, 0, '-g', include);
+        try {
+            const rawJson = await execFn(ctx, { command: cmd.map(shellEscape).join(' '), timeout: 30 });
+            const parsed = JSON.parse(rawJson);
+            if (parsed.rc === 1 && !parsed.out?.trim()) {
+                return `No matches for pattern \"${pattern}\" in ${root}. STOP — do NOT read files individually to search. Try a broader regex pattern, different keywords, or use exec: grep -rn \"keyword\" ${root}`;
+            }
+            if (parsed.rc < 2) {
+                const rgOutput = parsed.out ?? '';
+                if (rgOutput) {
+                    const lines = rgOutput.split(/\r?\n/).filter(Boolean).slice(0, maxResults);
+                    if (lines.length >= maxResults)
+                        lines.push(`[truncated after ${maxResults} results]`);
+                    const redactedLines = lines.map((line) => {
+                        const colonIdx = line.indexOf(':');
+                        if (colonIdx === -1)
+                            return line;
+                        const filePath = line.substring(0, colonIdx);
+                        const rest = line.substring(colonIdx + 1);
+                        return redactPath(filePath, absCwd) + ':' + rest;
+                    });
+                    return redactedLines.join('\n');
+                }
+            }
+        }
+        catch {
+            // fall through
+        }
+    }
+    let re;
+    try {
+        re = new RegExp(pattern);
+    }
+    catch (e) {
+        throw new ToolError('invalid_args', `search_files: invalid regex pattern: ${e?.message ?? String(e)}`, false, 'Escape regex metacharacters (\\\\, [, ], (, ), +, *, ?). If you intended literal text, use an escaped/literal pattern.');
+    }
+    const out = [];
+    async function walk(dir, depth) {
+        if (out.length >= maxResults)
+            return;
+        const ents = await fs.readdir(dir, { withFileTypes: true }).catch(() => []);
+        for (const ent of ents) {
+            if (out.length >= maxResults)
+                return;
+            const full = path.join(dir, ent.name);
+            if (ent.isDirectory()) {
+                if (ent.name === 'node_modules' ||
+                    ent.name === '.git' ||
+                    ent.name === 'dist' ||
+                    ent.name === 'build')
+                    continue;
+                if (depth < 6)
+                    await walk(full, depth + 1);
+                continue;
+            }
+            if (!ent.isFile())
+                continue;
+            if (include && !globishMatch(ent.name, include))
+                continue;
+            const rawBuf = await fs.readFile(full).catch(() => null);
+            if (!rawBuf)
+                continue;
+            let isBinary = false;
+            for (let bi = 0; bi < Math.min(rawBuf.length, 512); bi++) {
+                if (rawBuf[bi] === 0) {
+                    isBinary = true;
+                    break;
+                }
+            }
+            if (isBinary)
+                continue;
+            const buf = rawBuf.toString('utf8');
+            const lines = buf.split(/\r?\n/);
+            for (let i = 0; i < lines.length; i++) {
+                if (re.test(lines[i])) {
+                    out.push(`${redactPath(full, absCwd)}:${i + 1}:${lines[i]}`);
+                    if (out.length >= maxResults)
+                        return;
+                }
+            }
+        }
+    }
+    await walk(root, 0);
+    if (out.length >= maxResults)
+        out.push(`[truncated after ${maxResults} results]`);
+    if (!out.length)
+        return `No matches for pattern \"${pattern}\" in ${redactPath(root, absCwd)}.`;
+    return out.join('\n');
+}
+//# sourceMappingURL=file-discovery.js.map

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

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

package/dist/tools/file-mutations.js

@@ -0,0 +1,326 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { checkPathSafety } from '../safety.js';
+import { checkCwdWarning, enforceMutationWithinCwd, redactPath, resolvePath, } from './path-safety.js';
+import { checkpointReplay } from './replay-utils.js';
+import { bigramSimilarity } from './search-utils.js';
+import { snapshotBeforeEdit } from './sys-notes.js';
+import { mutationReadback } from './text-utils.js';
+import { atomicWrite, backupFile } from './undo.js';
+export async function writeFileTool(ctx, args) {
+    const p = resolvePath(ctx, args?.path);
+    const absCwd = path.resolve(ctx.cwd);
+    const redactedPath = redactPath(p, absCwd);
+    const raw = args?.content;
+    const contentWasObject = raw != null && typeof raw === 'object';
+    const content = typeof raw === 'string' ? raw : contentWasObject ? JSON.stringify(raw, null, 2) : undefined;
+    if (contentWasObject) {
+        console.warn(`[write_file] Warning: content for "${args?.path}" arrived as ${typeof raw} — auto-serialized to JSON string. If this was intentional (e.g. package.json), the write succeeded.`);
+    }
+    if (!p)
+        throw new Error('write_file: missing path');
+    if (content == null)
+        throw new Error('write_file: missing content (got ' + typeof raw + ')');
+    const overwrite = Boolean(args?.overwrite ?? args?.force);
+    enforceMutationWithinCwd('write_file', p, ctx);
+    const cwdWarning = checkCwdWarning('write_file', p, ctx);
+    const pathVerdict = checkPathSafety(p);
+    if (pathVerdict.tier === 'forbidden')
+        throw new Error(`write_file: ${pathVerdict.reason}`);
+    if (pathVerdict.tier === 'cautious' && !ctx.noConfirm) {
+        if (ctx.confirm) {
+            const ok = await ctx.confirm(pathVerdict.prompt || `Write to ${redactedPath}?`, {
+                tool: 'write_file',
+                args: { path: p },
+            });
+            if (!ok)
+                throw new Error(`write_file: cancelled by user (${pathVerdict.reason})`);
+        }
+        else {
+            throw new Error(`write_file: blocked (${pathVerdict.reason}) without --no-confirm/--yolo`);
+        }
+    }
+    const existingStat = await fs.stat(p).catch(() => null);
+    if (existingStat?.isFile() && existingStat.size > 0 && !overwrite) {
+        throw new Error(`write_file: refusing to overwrite existing non-empty file ${redactedPath} without explicit overwrite=true (or force=true). ` +
+            `Use edit_range/apply_patch for surgical edits, or set overwrite=true for intentional full-file replacement.`);
+    }
+    if (ctx.dryRun) {
+        const mode = existingStat?.isFile()
+            ? existingStat.size > 0
+                ? 'overwrite'
+                : 'update-empty'
+            : 'create';
+        return `dry-run: would write ${p} (${Buffer.byteLength(content, 'utf8')} bytes, mode=${mode}${overwrite ? ', explicit-overwrite' : ''})${cwdWarning}`;
+    }
+    if (ctx.mode === 'sys' && ctx.vault)
+        await snapshotBeforeEdit(ctx.vault, p).catch(() => { });
+    const beforeBuf = await fs.readFile(p).catch(() => Buffer.from(''));
+    await backupFile(p, ctx);
+    await atomicWrite(p, content);
+    ctx.onMutation?.(p);
+    const replayNote = await checkpointReplay(ctx, {
+        op: 'write_file',
+        filePath: p,
+        before: beforeBuf,
+        after: Buffer.from(content, 'utf8'),
+    });
+    const contentLines = content.split(/\r?\n/);
+    const readback = contentLines.length <= 40
+        ? mutationReadback(content, 0, contentLines.length)
+        : mutationReadback(content, 0, 20) +
+            '\n...\n' +
+            mutationReadback(content, contentLines.length - 10, contentLines.length);
+    return `wrote ${redactedPath} (${Buffer.byteLength(content, 'utf8')} bytes)${replayNote}${cwdWarning}${readback}`;
+}
+export async function insertFileTool(ctx, args) {
+    const p = resolvePath(ctx, args?.path);
+    const absCwd = path.resolve(ctx.cwd);
+    const redactedPath = redactPath(p, absCwd);
+    const line = Number(args?.line);
+    const rawText = args?.text;
+    const text = typeof rawText === 'string'
+        ? rawText
+        : rawText != null && typeof rawText === 'object'
+            ? JSON.stringify(rawText, null, 2)
+            : undefined;
+    if (!p)
+        throw new Error('insert_file: missing path');
+    if (!Number.isFinite(line))
+        throw new Error('insert_file: missing/invalid line');
+    if (text == null)
+        throw new Error('insert_file: missing text (got ' + typeof rawText + ')');
+    enforceMutationWithinCwd('insert_file', p, ctx);
+    const pathVerdict = checkPathSafety(p);
+    if (pathVerdict.tier === 'forbidden')
+        throw new Error(`insert_file: ${pathVerdict.reason}`);
+    if (pathVerdict.tier === 'cautious' && !ctx.noConfirm) {
+        if (ctx.confirm) {
+            const ok = await ctx.confirm(pathVerdict.prompt || `Insert into ${redactedPath}?`, {
+                tool: 'insert_file',
+                args: { path: p },
+            });
+            if (!ok)
+                throw new Error(`insert_file: cancelled by user (${pathVerdict.reason})`);
+        }
+        else {
+            throw new Error(`insert_file: blocked (${pathVerdict.reason}) without --no-confirm/--yolo`);
+        }
+    }
+    if (ctx.dryRun)
+        return `dry-run: would insert into ${redactedPath} at line=${line} (${Buffer.byteLength(text, 'utf8')} bytes)`;
+    if (ctx.mode === 'sys' && ctx.vault)
+        await snapshotBeforeEdit(ctx.vault, p).catch(() => { });
+    const beforeText = await fs.readFile(p, 'utf8').catch(() => '');
+    const eol = beforeText.includes('\r\n') ? '\r\n' : '\n';
+    if (beforeText === '') {
+        const out = text;
+        await backupFile(p, ctx);
+        await atomicWrite(p, out);
+        ctx.onMutation?.(p);
+        const replayNote = await checkpointReplay(ctx, {
+            op: 'insert_file',
+            filePath: p,
+            before: Buffer.from(beforeText, 'utf8'),
+            after: Buffer.from(out, 'utf8'),
+        });
+        const cwdWarning = checkCwdWarning('insert_file', p, ctx);
+        const readback = mutationReadback(out, 0, out.split(/\r?\n/).length);
+        return `inserted into ${redactedPath} at 0${replayNote}${cwdWarning}${readback}`;
+    }
+    const lines = beforeText.split(/\r?\n/);
+    let idx;
+    if (line === -1)
+        idx = lines.length;
+    else
+        idx = Math.max(0, Math.min(lines.length, line));
+    if (line === -1 && lines.length > 0 && lines[lines.length - 1] === '')
+        idx = lines.length - 1;
+    const insertLines = text.split(/\r?\n/);
+    lines.splice(idx, 0, ...insertLines);
+    const out = lines.join(eol);
+    await backupFile(p, ctx);
+    await atomicWrite(p, out);
+    ctx.onMutation?.(p);
+    const replayNote = await checkpointReplay(ctx, {
+        op: 'insert_file',
+        filePath: p,
+        before: Buffer.from(beforeText, 'utf8'),
+        after: Buffer.from(out, 'utf8'),
+    });
+    const cwdWarning = checkCwdWarning('insert_file', p, ctx);
+    const insertEndLine = idx + insertLines.length;
+    const readback = mutationReadback(out, idx, insertEndLine);
+    return `inserted into ${redactedPath} at ${idx}${replayNote}${cwdWarning}${readback}`;
+}
+export async function editFileTool(ctx, args) {
+    const p = resolvePath(ctx, args?.path);
+    const absCwd = path.resolve(ctx.cwd);
+    const redactedPath = redactPath(p, absCwd);
+    const rawOld = args?.old_text;
+    const oldText = typeof rawOld === 'string'
+        ? rawOld
+        : rawOld != null && typeof rawOld === 'object'
+            ? JSON.stringify(rawOld, null, 2)
+            : undefined;
+    const rawNew = args?.new_text;
+    const newText = typeof rawNew === 'string'
+        ? rawNew
+        : rawNew != null && typeof rawNew === 'object'
+            ? JSON.stringify(rawNew, null, 2)
+            : undefined;
+    const replaceAll = Boolean(args?.replace_all);
+    if (!p)
+        throw new Error('edit_file: missing path');
+    if (oldText == null)
+        throw new Error('edit_file: missing old_text');
+    if (newText == null)
+        throw new Error('edit_file: missing new_text');
+    enforceMutationWithinCwd('edit_file', p, ctx);
+    const pathVerdict = checkPathSafety(p);
+    if (pathVerdict.tier === 'forbidden')
+        throw new Error(`edit_file: ${pathVerdict.reason}`);
+    if (pathVerdict.tier === 'cautious' && !ctx.noConfirm) {
+        if (ctx.confirm) {
+            const ok = await ctx.confirm(pathVerdict.prompt || `Edit ${redactedPath}?`, {
+                tool: 'edit_file',
+                args: { path: p, old_text: oldText, new_text: newText },
+            });
+            if (!ok)
+                throw new Error(`edit_file: cancelled by user (${pathVerdict.reason})`);
+        }
+        else {
+            throw new Error(`edit_file: blocked (${pathVerdict.reason}) without --no-confirm/--yolo`);
+        }
+    }
+    if (ctx.mode === 'sys' && ctx.vault)
+        await snapshotBeforeEdit(ctx.vault, p).catch(() => { });
+    const cur = await fs.readFile(p, 'utf8').catch((e) => {
+        throw new Error(`edit_file: cannot read ${redactedPath}: ${e?.message ?? String(e)}`);
+    });
+    const idx = cur.indexOf(oldText);
+    if (idx === -1) {
+        const normalize = (s) => s.replace(/\s+/g, ' ').trim().toLowerCase();
+        const needle = normalize(oldText);
+        const curLines = cur.split(/\r?\n/);
+        const needleLines = oldText.split(/\r?\n/).length;
+        let bestScore = 0;
+        let bestLine = -1;
+        let bestText = '';
+        for (let i = 0; i < curLines.length; i++) {
+            const windowEnd = Math.min(curLines.length, i + needleLines);
+            const window = curLines.slice(i, windowEnd).join('\n');
+            const score = bigramSimilarity(needle, normalize(window));
+            if (score > bestScore) {
+                bestScore = score;
+                bestLine = i + 1;
+                bestText = window;
+            }
+        }
+        let hint = '';
+        if (bestScore > 0.3 && bestLine > 0) {
+            const preview = bestText.length > 600 ? bestText.slice(0, 600) + '…' : bestText;
+            hint = `\nClosest match at line ${bestLine} (${Math.round(bestScore * 100)}% similarity):\n${preview}`;
+        }
+        else if (!cur.trim()) {
+            hint = `\nFile is empty.`;
+        }
+        else {
+            hint = `\nFile head (first 400 chars):\n${cur.slice(0, 400)}`;
+        }
+        throw new Error(`edit_file: old_text not found in ${redactedPath}. Re-read the file and retry with exact text.${hint}`);
+    }
+    const next = replaceAll
+        ? cur.split(oldText).join(newText)
+        : cur.slice(0, idx) + newText + cur.slice(idx + oldText.length);
+    if (ctx.dryRun)
+        return `dry-run: would edit ${redactedPath} (replace_all=${replaceAll})`;
+    await backupFile(p, ctx);
+    await atomicWrite(p, next);
+    ctx.onMutation?.(p);
+    const replayNote = await checkpointReplay(ctx, {
+        op: 'edit_file',
+        filePath: p,
+        before: Buffer.from(cur, 'utf8'),
+        after: Buffer.from(next, 'utf8'),
+    });
+    const cwdWarning = checkCwdWarning('edit_file', p, ctx);
+    const editStartLine = next.slice(0, idx).split(/\r?\n/).length - 1;
+    const editEndLine = editStartLine + newText.split(/\r?\n/).length;
+    const readback = mutationReadback(next, editStartLine, editEndLine);
+    return `edited ${redactedPath} (replace_all=${replaceAll})${replayNote}${cwdWarning}${readback}`;
+}
+export async function editRangeTool(ctx, args) {
+    const p = resolvePath(ctx, args?.path);
+    const startLine = Number(args?.start_line);
+    const endLine = Number(args?.end_line);
+    const rawReplacement = args?.replacement;
+    const replacement = typeof rawReplacement === 'string'
+        ? rawReplacement
+        : rawReplacement != null && typeof rawReplacement === 'object'
+            ? JSON.stringify(rawReplacement, null, 2)
+            : undefined;
+    if (!p)
+        throw new Error('edit_range: missing path');
+    if (!Number.isFinite(startLine) || startLine < 1)
+        throw new Error('edit_range: missing/invalid start_line');
+    if (!Number.isFinite(endLine) || endLine < startLine)
+        throw new Error('edit_range: missing/invalid end_line');
+    if (replacement == null)
+        throw new Error('edit_range: missing replacement (got ' + typeof rawReplacement + ')');
+    const hasLiteralEscapedNewlines = replacement.includes('\\n');
+    const hasRealNewlines = replacement.includes('\n') || replacement.includes('\r');
+    if (hasLiteralEscapedNewlines && !hasRealNewlines) {
+        throw new Error('edit_range: replacement appears double-escaped (contains literal "\\n" sequences). ' +
+            'Resend replacement with REAL newline characters (multi-line string), not escaped backslash-n text.');
+    }
+    enforceMutationWithinCwd('edit_range', p, ctx);
+    const pathVerdict = checkPathSafety(p);
+    if (pathVerdict.tier === 'forbidden')
+        throw new Error(`edit_range: ${pathVerdict.reason}`);
+    if (pathVerdict.tier === 'cautious' && !ctx.noConfirm) {
+        if (ctx.confirm) {
+            const ok = await ctx.confirm(pathVerdict.prompt || `Edit range in ${p}?`, {
+                tool: 'edit_range',
+                args: { path: p, start_line: startLine, end_line: endLine },
+            });
+            if (!ok)
+                throw new Error(`edit_range: cancelled by user (${pathVerdict.reason})`);
+        }
+        else {
+            throw new Error(`edit_range: blocked (${pathVerdict.reason}) without --no-confirm/--yolo`);
+        }
+    }
+    if (ctx.dryRun)
+        return `dry-run: would edit_range ${p} lines ${startLine}-${endLine} (${Buffer.byteLength(replacement, 'utf8')} bytes)`;
+    if (ctx.mode === 'sys' && ctx.vault)
+        await snapshotBeforeEdit(ctx.vault, p).catch(() => { });
+    const beforeText = await fs.readFile(p, 'utf8').catch((e) => {
+        throw new Error(`edit_range: cannot read ${p}: ${e?.message ?? String(e)}`);
+    });
+    const eol = beforeText.includes('\r\n') ? '\r\n' : '\n';
+    const lines = beforeText.split(/\r?\n/);
+    if (startLine > lines.length)
+        throw new Error(`edit_range: start_line ${startLine} out of range (file has ${lines.length} lines)`);
+    if (endLine > lines.length)
+        throw new Error(`edit_range: end_line ${endLine} out of range (file has ${lines.length} lines)`);
+    const startIdx = startLine - 1;
+    const deleteCount = endLine - startLine + 1;
+    const replacementLines = replacement === '' ? [] : replacement.split(/\r?\n/);
+    lines.splice(startIdx, deleteCount, ...replacementLines);
+    const out = lines.join(eol);
+    await backupFile(p, ctx);
+    await atomicWrite(p, out);
+    ctx.onMutation?.(p);
+    const replayNote = await checkpointReplay(ctx, {
+        op: 'edit_range',
+        filePath: p,
+        before: Buffer.from(beforeText, 'utf8'),
+        after: Buffer.from(out, 'utf8'),
+    });
+    const cwdWarning = checkCwdWarning('edit_range', p, ctx);
+    const rangeEndLine = startIdx + replacementLines.length;
+    const readback = mutationReadback(out, startIdx, rangeEndLine);
+    return `edited ${p} lines ${startLine}-${endLine}${replayNote}${cwdWarning}${readback}`;
+}
+//# sourceMappingURL=file-mutations.js.map

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

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

package/dist/tools/file-read.js

@@ -0,0 +1,133 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { resolvePath, redactPath } from './path-safety.js';
+import { guessMimeType, truncateBytes } from './text-utils.js';
+import { ToolError } from './tool-error.js';
+export async function readFileTool(ctx, args) {
+    const p = resolvePath(ctx, args?.path);
+    const absCwd = path.resolve(ctx.cwd);
+    const redactedPath = redactPath(p, absCwd);
+    const offset = args?.offset != null ? Number(args.offset) : undefined;
+    const rawLimit = args?.limit != null ? Number(args.limit) : undefined;
+    let limit = Number.isFinite(rawLimit) && rawLimit > 0
+        ? Math.max(1, Math.floor(rawLimit))
+        : 200;
+    if (ctx.maxReadLines != null && ctx.maxReadLines > 0) {
+        limit = Math.min(limit, ctx.maxReadLines);
+    }
+    const search = typeof args?.search === 'string' ? args.search : undefined;
+    const rawContext = args?.context != null ? Number(args.context) : undefined;
+    const context = Number.isFinite(rawContext) && rawContext >= 0
+        ? Math.max(0, Math.min(200, Math.floor(rawContext)))
+        : 10;
+    const formatRaw = typeof args?.format === 'string' ? args.format.trim().toLowerCase() : 'numbered';
+    const format = formatRaw === 'plain' || formatRaw === 'numbered' || formatRaw === 'sparse'
+        ? formatRaw
+        : 'numbered';
+    const rawMaxBytes = args?.max_bytes != null ? Number(args.max_bytes) : undefined;
+    const maxBytes = Number.isFinite(rawMaxBytes) && rawMaxBytes > 0
+        ? Math.min(256 * 1024, Math.max(256, Math.floor(rawMaxBytes)))
+        : 20 * 1024;
+    if (!p)
+        throw new Error('read_file: missing path');
+    try {
+        const stat = await fs.stat(p);
+        if (stat.isDirectory()) {
+            return `read_file: "${redactedPath}" is a directory, not a file. Use list_dir to see its contents, or search_files to find specific code.`;
+        }
+    }
+    catch {
+        // let readFile error path handle ENOENT/etc
+    }
+    const buf = await fs.readFile(p).catch((e) => {
+        throw new Error(`read_file: cannot read ${p}: ${e?.message ?? String(e)}`);
+    });
+    for (let i = 0; i < Math.min(buf.length, 512); i++) {
+        if (buf[i] === 0) {
+            const mimeGuess = guessMimeType(p, buf);
+            return `[binary file, ${buf.length} bytes, detected type: ${mimeGuess}]`;
+        }
+    }
+    const text = buf.toString('utf8');
+    if (!text)
+        return `# ${p}\n[file is empty (0 bytes)]`;
+    const lines = text.split(/\r?\n/);
+    let start = 1;
+    let end = Math.min(lines.length, limit);
+    let matchLines = [];
+    if (search) {
+        matchLines = [];
+        for (let i = 0; i < lines.length; i++) {
+            if (lines[i].includes(search))
+                matchLines.push(i + 1);
+        }
+        if (!matchLines.length) {
+            return truncateBytes(`# ${p}\n# search not found: ${JSON.stringify(search)}\n# file has ${lines.length} lines`, maxBytes).text;
+        }
+        const firstIdx = matchLines[0];
+        start = Math.max(1, firstIdx - context);
+        end = Math.min(lines.length, firstIdx + context);
+        if (end - start + 1 > limit) {
+            const half = Math.floor(limit / 2);
+            start = Math.max(1, firstIdx - half);
+            end = Math.min(lines.length, start + limit - 1);
+        }
+    }
+    else if (offset && offset >= 1) {
+        start = Math.max(1, Math.floor(offset));
+        end = Math.min(lines.length, start + limit - 1);
+    }
+    const matchSet = new Set(matchLines);
+    const out = [];
+    out.push(`# ${p} (lines ${start}-${end} of ${lines.length})`);
+    if (search) {
+        const shown = matchLines.slice(0, 20);
+        out.push(`# matches at lines: ${shown.join(', ')}${matchLines.length > shown.length ? ' …' : ''}`);
+    }
+    const renderNumbered = (ln, body) => `${ln}| ${body}`;
+    for (let ln = start; ln <= end; ln++) {
+        const body = lines[ln - 1] ?? '';
+        if (format === 'plain') {
+            out.push(body);
+            continue;
+        }
+        if (format === 'numbered') {
+            out.push(renderNumbered(ln, body));
+            continue;
+        }
+        const isAnchor = ln === start || ln === end || (ln - start) % 10 === 0;
+        if (isAnchor || matchSet.has(ln))
+            out.push(renderNumbered(ln, body));
+        else
+            out.push(body);
+    }
+    if (end < lines.length)
+        out.push(`# ... (${lines.length - end} more lines)`);
+    return truncateBytes(out.join('\n'), maxBytes).text;
+}
+export async function readFilesTool(ctx, args) {
+    const reqs = Array.isArray(args?.requests) ? args.requests : [];
+    if (!reqs.length) {
+        throw new ToolError('invalid_args', 'read_files: missing requests[]', false, 'Provide requests as an array of {path, limit,...} objects.');
+    }
+    const parts = [];
+    let failures = 0;
+    for (let i = 0; i < reqs.length; i++) {
+        const r = reqs[i];
+        const p = typeof r?.path === 'string' ? r.path : `request[${i}]`;
+        try {
+            parts.push(await readFileTool(ctx, r));
+        }
+        catch (e) {
+            failures++;
+            const te = ToolError.fromError(e, 'internal');
+            parts.push(`[file:${p}] ERROR: code=${te.code} msg=${te.message}`);
+        }
+        parts.push('');
+    }
+    if (failures > 0) {
+        parts.push(`# read_files completed with partial failures: ${failures}/${reqs.length}`);
+    }
+    return parts.join('\n');
+}
+//# sourceMappingURL=file-read.js.map