@visorcraft/idlehands 1.4.6 → 2.0.1

package/dist/tools/exec-core.js

@@ -0,0 +1,252 @@
+import { spawn, spawnSync } from 'node:child_process';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { checkExecSafety, isProtectedDeleteTarget } from '../safety.js';
+import { BASH_PATH } from '../utils.js';
+import { execWithPty } from './exec-pty.js';
+import { hasBackgroundExecIntent, makeExecStreamer } from './exec-utils.js';
+import { isWithinDir, resolvePath } from './path-safety.js';
+import { autoNoteSysChange } from './sys-notes.js';
+import { stripAnsi, dedupeRepeats, collapseStackTraces, truncateBytes } from './text-utils.js';
+const DEFAULT_MAX_EXEC_BYTES = 16384;
+let ptyUnavailableWarned = false;
+async function loadNodePty() {
+    try {
+        const mod = await import('node-pty');
+        return mod;
+    }
+    catch {
+        if (!ptyUnavailableWarned) {
+            ptyUnavailableWarned = true;
+            console.error('[warn] node-pty not available; interactive sudo is disabled. Install build tools (python3, make, g++) and reinstall to enable it.');
+        }
+        return null;
+    }
+}
+export async function execTool(ctx, args) {
+    const command = typeof args?.command === 'string' ? args.command : undefined;
+    const cwd = args?.cwd ? resolvePath(ctx, args.cwd) : ctx.cwd;
+    const defaultTimeout = ctx.mode === 'sys' ? 60 : 30;
+    const timeout = Math.min(args?.timeout ? Number(args.timeout) : defaultTimeout, 120);
+    if (!command)
+        throw new Error('exec: missing command');
+    const absCwd = path.resolve(ctx.cwd);
+    const allowOutsideCwd = ctx.approvalMode === 'yolo' || ctx.approvalMode === 'auto-edit';
+    let execCwdWarning = '';
+    if (args?.cwd) {
+        const absExecCwd = path.resolve(cwd);
+        if (!isWithinDir(absExecCwd, absCwd)) {
+            if (!allowOutsideCwd) {
+                throw new Error(`exec: BLOCKED — cwd "${absExecCwd}" is outside the working directory "${absCwd}". Use relative paths and work within the project directory.`);
+            }
+            execCwdWarning = `\n[WARNING] cwd "${absExecCwd}" is outside the working directory "${absCwd}". Proceeding due to ${ctx.approvalMode} mode.`;
+        }
+    }
+    if (command) {
+        const cdPattern = /\bcd\s+(['"]?)(\/[^\s'";&|]+|[a-zA-Z]:[\\/][^\s'";&|]*)\1/g;
+        let cdMatch;
+        while ((cdMatch = cdPattern.exec(command)) !== null) {
+            const cdTarget = path.resolve(cdMatch[2]);
+            if (!isWithinDir(cdTarget, absCwd)) {
+                if (!allowOutsideCwd) {
+                    throw new Error(`exec: BLOCKED — command navigates to "${cdTarget}" which is outside the working directory "${absCwd}". Use relative paths and work within the project directory.`);
+                }
+                execCwdWarning = `\n[WARNING] Command navigates to "${cdTarget}" which is outside the working directory "${absCwd}". Proceeding due to ${ctx.approvalMode} mode.`;
+            }
+        }
+        const absPathPattern = /(?:mkdir|cat\s*>|tee|touch|cp|mv|rm|rmdir)\s+(?:-\S+\s+)*(['"]?)(\/[^\s'";&|]+|[a-zA-Z]:[\\/][^\s'";&|]*)\1/g;
+        let apMatch;
+        while ((apMatch = absPathPattern.exec(command)) !== null) {
+            const absTarget = path.resolve(apMatch[2]);
+            if (!isWithinDir(absTarget, absCwd)) {
+                if (!allowOutsideCwd) {
+                    throw new Error(`exec: BLOCKED — command targets "${absTarget}" which is outside the working directory "${absCwd}". Use relative paths to work within the project directory.`);
+                }
+                execCwdWarning = `\n[WARNING] Command targets "${absTarget}" which is outside the working directory "${absCwd}". Proceeding due to ${ctx.approvalMode} mode.`;
+            }
+        }
+    }
+    if (hasBackgroundExecIntent(command)) {
+        throw new Error('exec: blocked background command (contains `&`). Long-running/background jobs can stall one-shot sessions. Run foreground smoke checks only, or use a dedicated service manager outside this task.');
+    }
+    const verdict = checkExecSafety(command);
+    if (verdict.tier === 'forbidden')
+        throw new Error(`exec: ${verdict.reason} — command: ${command}`);
+    if (isProtectedDeleteTarget(command)) {
+        throw new Error(`exec: BLOCKED: rm targeting protected directory — command: ${command}`);
+    }
+    if (verdict.tier === 'cautious' && !ctx.noConfirm) {
+        if (ctx.confirm) {
+            const ok = await ctx.confirm(verdict.prompt || `About to run:\n\n${command}\n\nProceed? (y/N) `, {
+                tool: 'exec',
+                args: { command },
+            });
+            if (!ok)
+                throw new Error(`exec: cancelled by user (${verdict.reason}): ${command}`);
+        }
+        else if (verdict.reason === 'package install/remove') {
+            throw new Error(`exec: blocked (${verdict.reason}) without --no-confirm/--yolo: ${command}\nSTOP: this is a session-level approval restriction. Adding --yolo/--no-confirm inside the shell command does NOT override it. Re-run the parent session with --no-confirm or --yolo to allow package operations. Alternatively, the user can install packages manually and re-run this task. Do NOT use spawn_task to bypass this restriction.`);
+        }
+        else {
+            throw new Error(`exec: blocked (${verdict.reason}) without --no-confirm/--yolo: ${command}`);
+        }
+    }
+    if (ctx.dryRun)
+        return `dry-run: would exec in ${cwd}: ${command}`;
+    if (/^\s*sudo\s/.test(command) && !process.stdin.isTTY) {
+        try {
+            const probe = spawnSync('sudo', ['-n', 'true'], { timeout: 5000, stdio: 'ignore' });
+            if (probe.status !== 0) {
+                throw new Error('exec: sudo requires a TTY for password input, but stdin is not a TTY. Options: run idlehands interactively, configure NOPASSWD for this command, or pre-cache sudo credentials.');
+            }
+        }
+        catch (e) {
+            if (e.message?.includes('sudo requires a TTY'))
+                throw e;
+        }
+    }
+    const maxBytes = ctx.maxExecBytes ?? DEFAULT_MAX_EXEC_BYTES;
+    const captureLimit = ctx.maxExecCaptureBytes ?? Math.max(maxBytes * 64, 256 * 1024);
+    if (/^\s*sudo\s/.test(command) && process.stdin.isTTY) {
+        const pty = await loadNodePty();
+        if (!pty) {
+            throw new Error('exec: interactive sudo requires node-pty, but it is not installed. Install optional dependency `node-pty` (build tools: python3, make, g++) or use non-interactive sudo (NOPASSWD/cached credentials).');
+        }
+        return await execWithPty({
+            pty,
+            command,
+            cwd,
+            timeout,
+            maxBytes,
+            captureLimit,
+            signal: ctx.signal,
+            execCwdWarning,
+        });
+    }
+    try {
+        await fs.access(cwd);
+    }
+    catch {
+        throw new Error(`exec: working directory does not exist: ${cwd}`);
+    }
+    const child = spawn(command, [], {
+        cwd,
+        stdio: ['ignore', 'pipe', 'pipe'],
+        shell: BASH_PATH,
+        detached: true,
+    });
+    const outChunks = [];
+    const errChunks = [];
+    let outSeen = 0;
+    let errSeen = 0;
+    let outCaptured = 0;
+    let errCaptured = 0;
+    let killed = false;
+    const killProcessGroup = () => {
+        const pid = child.pid;
+        if (!pid)
+            return;
+        try {
+            process.kill(-pid, 'SIGKILL');
+        }
+        catch {
+            try {
+                child.kill('SIGKILL');
+            }
+            catch { }
+        }
+    };
+    const killTimer = setTimeout(() => {
+        killed = true;
+        killProcessGroup();
+    }, Math.max(1, timeout) * 1000);
+    const onAbort = () => {
+        killed = true;
+        killProcessGroup();
+    };
+    ctx.signal?.addEventListener('abort', onAbort, { once: true });
+    const pushCapped = (chunks, buf, kind) => {
+        const n = buf.length;
+        if (kind === 'out')
+            outSeen += n;
+        else
+            errSeen += n;
+        const captured = kind === 'out' ? outCaptured : errCaptured;
+        const remaining = captureLimit - captured;
+        if (remaining <= 0)
+            return;
+        const take = n <= remaining ? buf : buf.subarray(0, remaining);
+        chunks.push(Buffer.from(take));
+        if (kind === 'out')
+            outCaptured += take.length;
+        else
+            errCaptured += take.length;
+    };
+    const streamer = makeExecStreamer(ctx);
+    child.stdout.on('data', (d) => {
+        pushCapped(outChunks, d, 'out');
+        streamer?.push('stdout', stripAnsi(d.toString('utf8')));
+    });
+    child.stderr.on('data', (d) => {
+        pushCapped(errChunks, d, 'err');
+        streamer?.push('stderr', stripAnsi(d.toString('utf8')));
+    });
+    const rc = await new Promise((resolve, reject) => {
+        child.on('error', (err) => {
+            clearTimeout(killTimer);
+            ctx.signal?.removeEventListener('abort', onAbort);
+            reject(new Error(`exec: failed to spawn shell (cwd=${cwd}): ${err.message} (${err.code ?? 'unknown'})`));
+        });
+        child.on('close', (code) => resolve(code ?? 0));
+    });
+    clearTimeout(killTimer);
+    ctx.signal?.removeEventListener('abort', onAbort);
+    streamer?.done();
+    const outRaw = stripAnsi(Buffer.concat(outChunks).toString('utf8'));
+    const errRaw = stripAnsi(Buffer.concat(errChunks).toString('utf8'));
+    const outLines = collapseStackTraces(dedupeRepeats(outRaw.split(/\r?\n/)))
+        .join('\n')
+        .trimEnd();
+    const errLines = collapseStackTraces(dedupeRepeats(errRaw.split(/\r?\n/)))
+        .join('\n')
+        .trimEnd();
+    const outT = truncateBytes(outLines, maxBytes, outSeen);
+    const errT = truncateBytes(errLines, maxBytes, errSeen);
+    let outText = outT.text;
+    let errText = errT.text;
+    const capOut = outSeen > outCaptured;
+    const capErr = errSeen > errCaptured;
+    if (capOut && !outT.truncated) {
+        outText = truncateBytes(outText + `\n[capture truncated, ${outSeen} bytes total]`, maxBytes, outSeen).text;
+    }
+    if (capErr && !errT.truncated) {
+        errText = truncateBytes(errText + `\n[capture truncated, ${errSeen} bytes total]`, maxBytes, errSeen).text;
+    }
+    if (killed)
+        errText = (errText ? errText + '\n' : '') + `[killed after ${timeout}s timeout]`;
+    if (!outText && !errText && !killed) {
+        if (rc === 0) {
+            outText =
+                '[command completed successfully with no output. Do NOT retry — the command worked but produced no output. Move on to the next step.]';
+        }
+        else if (rc === 1) {
+            outText =
+                '[no matches found — the command returned zero results (exit code 1). Do NOT retry this command with the same arguments. The target simply has no matches. Move on or try different search terms/parameters.]';
+        }
+        else {
+            outText = `[command exited with code ${rc} and produced no output. Do NOT retry with identical arguments — diagnose the issue or try a different approach.]`;
+        }
+    }
+    const result = {
+        rc,
+        out: outText,
+        err: errText,
+        truncated: outT.truncated || errT.truncated || capOut || capErr,
+        ...(execCwdWarning && { warnings: [execCwdWarning.trim()] }),
+    };
+    if (ctx.mode === 'sys' && ctx.vault && rc === 0) {
+        autoNoteSysChange(ctx.vault, command, outText).catch(() => { });
+    }
+    return JSON.stringify(result);
+}
+//# sourceMappingURL=exec-core.js.map

package/dist/tools/exec-core.js.map

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

package/dist/tools/exec-pty.js

@@ -0,0 +1,89 @@
+import { BASH_PATH } from '../utils.js';
+import { stripAnsi, dedupeRepeats, collapseStackTraces, truncateBytes } from './text-utils.js';
+export async function execWithPty(args) {
+    const { pty, command, cwd, timeout, maxBytes, captureLimit, signal, execCwdWarning } = args;
+    const proc = pty.spawn(BASH_PATH, ['-c', command], {
+        name: 'xterm-color',
+        cwd,
+        cols: 120,
+        rows: 30,
+        env: process.env,
+    });
+    const chunks = [];
+    let seen = 0;
+    let captured = 0;
+    let killed = false;
+    const onDataDisposable = proc.onData((data) => {
+        if (process.stdout.isTTY)
+            process.stdout.write(data);
+        const n = Buffer.byteLength(data, 'utf8');
+        seen += n;
+        const remaining = captureLimit - captured;
+        if (remaining <= 0)
+            return;
+        if (n <= remaining) {
+            chunks.push(data);
+            captured += n;
+        }
+        else {
+            const buf = Buffer.from(data, 'utf8');
+            const slice = buf.subarray(0, remaining).toString('utf8');
+            chunks.push(slice);
+            captured += Buffer.byteLength(slice, 'utf8');
+        }
+    });
+    const kill = () => {
+        killed = true;
+        try {
+            proc.kill();
+        }
+        catch {
+            // ignore
+        }
+    };
+    const killTimer = setTimeout(kill, Math.max(1, timeout) * 1000);
+    const onAbort = () => kill();
+    signal?.addEventListener('abort', onAbort, { once: true });
+    const rc = await new Promise((resolve) => {
+        proc.onExit((e) => resolve(Number(e?.exitCode ?? 0)));
+    });
+    clearTimeout(killTimer);
+    signal?.removeEventListener('abort', onAbort);
+    onDataDisposable?.dispose?.();
+    const raw = stripAnsi(chunks.join(''));
+    const lines = collapseStackTraces(dedupeRepeats(raw.split(/\r?\n/)))
+        .join('\n')
+        .trimEnd();
+    const outT = truncateBytes(lines, maxBytes, seen);
+    let outText = outT.text;
+    const cap = seen > captured;
+    if (cap && !outT.truncated) {
+        outText = truncateBytes(outText + `\n[capture truncated, ${seen} bytes total]`, maxBytes, seen).text;
+    }
+    let errText = '';
+    if (killed) {
+        errText = `[killed after ${timeout}s timeout]`;
+    }
+    if (!outText && !errText && !killed) {
+        if (rc === 0) {
+            outText =
+                '[command completed successfully with no output. Do NOT retry — the command worked but produced no output. Move on to the next step.]';
+        }
+        else if (rc === 1) {
+            outText =
+                '[no matches found — the command returned zero results (exit code 1). Do NOT retry this command with the same arguments. The target simply has no matches. Move on or try different search terms/parameters.]';
+        }
+        else {
+            outText = `[command exited with code ${rc} and produced no output. Do NOT retry with identical arguments — diagnose the issue or try a different approach.]`;
+        }
+    }
+    const result = {
+        rc,
+        out: outText,
+        err: errText,
+        truncated: outT.truncated || cap || killed,
+        ...(execCwdWarning && { warnings: [execCwdWarning.trim()] }),
+    };
+    return JSON.stringify(result);
+}
+//# sourceMappingURL=exec-pty.js.map

package/dist/tools/exec-pty.js.map

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

package/dist/tools/exec-utils.js

@@ -0,0 +1,94 @@
+/** Best-effort quote stripping for lightweight shell pattern checks. */
+export function stripSimpleQuotedSegments(s) {
+    return s
+        .replace(/"(?:[^"\\]|\\.)*"/g, '""')
+        .replace(/'(?:[^'\\]|\\.)*'/g, "''")
+        .replace(/`(?:[^`\\]|\\.)*`/g, '``');
+}
+/** Detect standalone '&' background token (not &&, >&2, <&, &>). */
+export function hasBackgroundExecIntent(command) {
+    const stripped = stripSimpleQuotedSegments(command);
+    return /(^|[;\s])&(?![&><\d])(?=($|[;\s]))/.test(stripped);
+}
+/** Fire-and-forget helper that safely swallows async/sync errors. */
+export function safeFireAndForget(fn) {
+    if (!fn)
+        return;
+    try {
+        const r = fn();
+        if (r && typeof r.catch === 'function')
+            r.catch(() => { });
+    }
+    catch {
+        // best effort only
+    }
+}
+/** Build throttled stdout/stderr streaming callbacks for exec tool output. */
+export function makeExecStreamer(ctx) {
+    const cb = ctx.onToolStream;
+    if (!cb)
+        return null;
+    const id = ctx.toolCallId ?? '';
+    const name = ctx.toolName ?? 'exec';
+    const intervalMs = Math.max(50, Math.floor(ctx.toolStreamIntervalMs ?? 750));
+    const maxChunkChars = Math.max(80, Math.floor(ctx.toolStreamMaxChunkChars ?? 900));
+    const maxBufferChars = Math.max(maxChunkChars, Math.floor(ctx.toolStreamMaxBufferChars ?? 12_000));
+    let outBuf = '';
+    let errBuf = '';
+    let lastEmit = 0;
+    let timer = null;
+    const emit = (stream, chunk) => {
+        const trimmed = chunk.length > maxChunkChars ? chunk.slice(-maxChunkChars) : chunk;
+        const ev = { id, name, stream, chunk: trimmed };
+        safeFireAndForget(() => cb(ev));
+    };
+    const schedule = () => {
+        if (timer)
+            return;
+        const delay = Math.max(0, intervalMs - (Date.now() - lastEmit));
+        timer = setTimeout(() => {
+            timer = null;
+            flush(false);
+        }, delay);
+    };
+    const flush = (force = false) => {
+        const now = Date.now();
+        if (!force && now - lastEmit < intervalMs) {
+            schedule();
+            return;
+        }
+        lastEmit = now;
+        if (outBuf) {
+            emit('stdout', outBuf);
+            outBuf = '';
+        }
+        if (errBuf) {
+            emit('stderr', errBuf);
+            errBuf = '';
+        }
+    };
+    const push = (stream, textRaw) => {
+        // Keep raw chunks here; caller can pre-process if needed.
+        const text = textRaw.replace(/\r/g, '\n');
+        if (!text)
+            return;
+        if (stream === 'stdout')
+            outBuf += text;
+        else
+            errBuf += text;
+        if (outBuf.length > maxBufferChars)
+            outBuf = outBuf.slice(-maxBufferChars);
+        if (errBuf.length > maxBufferChars)
+            errBuf = errBuf.slice(-maxBufferChars);
+        schedule();
+    };
+    const done = () => {
+        if (timer) {
+            clearTimeout(timer);
+            timer = null;
+        }
+        flush(true);
+    };
+    return { push, done };
+}
+//# sourceMappingURL=exec-utils.js.map

package/dist/tools/exec-utils.js.map

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

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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"}