@j0hanz/filesystem-mcp 1.19.0 → 2.0.0

package/dist/core/read.js

@@ -0,0 +1,562 @@
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+import { open as fsOpen } from 'node:fs/promises';
+import { StringDecoder } from 'node:string_decoder';
+import { withAbort } from './concurrency.js';
+import { ErrorCode, formatUnknownErrorMessage, FsError, isFsError } from './errors.js';
+import { isBinarySample, isKnownBinaryExtension, MIME_SAMPLE_SIZE } from './mime.js';
+import { Logger } from './observability.js';
+import { getMaxTextFileSize } from './util.js';
+export const STREAM_CHUNK_SIZE = 64 * 1024;
+const READ_ONLY_FILE_FLAG = 'r';
+function assertPositiveIntegerOption(name, value, message) {
+    if (value === undefined ||
+        (typeof value === 'number' && Number.isSafeInteger(value) && value >= 1))
+        return;
+    throw new FsError(ErrorCode.INVALID_INPUT, message ?? `${name} must be a positive integer`);
+}
+async function openReadableFileHandle(filePath, signal) {
+    const handlePromise = fsOpen(filePath, READ_ONLY_FILE_FLAG);
+    if (!signal)
+        return handlePromise;
+    try {
+        return await withAbort(handlePromise, signal);
+    }
+    catch (error) {
+        void handlePromise
+            .then((handle) => {
+            void handle.close().catch((closeErr) => {
+                Logger.warn(`Failed to close file handle for ${filePath} after abort: ${formatUnknownErrorMessage(closeErr)}`);
+            });
+        })
+            .catch(() => {
+            /* ignore open error */
+        });
+        throw error;
+    }
+}
+async function readProbe(handle, signal) {
+    const buffer = Buffer.allocUnsafe(MIME_SAMPLE_SIZE);
+    const { bytesRead } = await withAbort(handle.read(buffer, 0, MIME_SAMPLE_SIZE, 0), signal);
+    if (bytesRead === 0) {
+        return Buffer.alloc(0);
+    }
+    return buffer.subarray(0, bytesRead);
+}
+async function isProbablyBinary(filePath, existingHandle, signal) {
+    const env_1 = { stack: [], error: void 0, hasError: false };
+    try {
+        if (isKnownBinaryExtension(filePath)) {
+            return true;
+        }
+        if (existingHandle) {
+            const slice = await readProbe(existingHandle, signal);
+            return isBinarySample(slice);
+        }
+        const handle = __addDisposableResource(env_1, await openReadableFileHandle(filePath, signal), true);
+        const slice = await readProbe(handle, signal);
+        return isBinarySample(slice);
+    }
+    catch (e_1) {
+        env_1.error = e_1;
+        env_1.hasError = true;
+    }
+    finally {
+        const result_1 = __disposeResources(env_1);
+        if (result_1)
+            await result_1;
+    }
+}
+function buildBaseOptions(spec) {
+    if (spec.maxSize !== undefined) {
+        assertPositiveIntegerOption('maxSize', spec.maxSize, 'maxSize must be at least 1');
+    }
+    const maxTextFileSize = getMaxTextFileSize();
+    return {
+        encoding: spec.encoding ?? 'utf-8',
+        maxSize: Math.min(spec.maxSize ?? maxTextFileSize, maxTextFileSize),
+        skipBinary: spec.skipBinary ?? false,
+        ...(spec.signal ? { signal: spec.signal } : {}),
+    };
+}
+function normalizeHeadSpec(spec, base) {
+    assertPositiveIntegerOption('lines', spec.lines, 'lines must be at least 1');
+    return { ...base, kind: 'head', lines: spec.lines };
+}
+function normalizeTailSpec(spec, base) {
+    assertPositiveIntegerOption('lines', spec.lines, 'lines must be at least 1');
+    return { ...base, kind: 'tail', lines: spec.lines };
+}
+function normalizeRangeSpec(spec, base) {
+    assertPositiveIntegerOption('start', spec.start, 'start must be at least 1');
+    if (spec.end !== undefined) {
+        assertPositiveIntegerOption('end', spec.end, 'end must be at least 1');
+        if (spec.end < spec.start) {
+            throw new FsError(ErrorCode.INVALID_INPUT, 'end must be greater than or equal to start (default: 1)');
+        }
+    }
+    return {
+        ...base,
+        kind: 'range',
+        start: spec.start,
+        ...(spec.end !== undefined ? { end: spec.end } : {}),
+    };
+}
+export function normalizeSpec(spec) {
+    const base = buildBaseOptions(spec);
+    spec.signal?.throwIfAborted();
+    switch (spec.kind) {
+        case 'head':
+            return normalizeHeadSpec(spec, base);
+        case 'tail':
+            return normalizeTailSpec(spec, base);
+        case 'range':
+            return normalizeRangeSpec(spec, base);
+        case 'full':
+            return { ...base, kind: 'full' };
+        default: {
+            const _exhaustive = spec;
+            return _exhaustive;
+        }
+    }
+}
+function buildReadContentOptions(normalized) {
+    const result = {
+        encoding: normalized.encoding,
+        maxSize: normalized.maxSize,
+    };
+    if (normalized.signal)
+        result.signal = normalized.signal;
+    return result;
+}
+export function createTooLargeError(bytesRead, maxSize, requestedPath) {
+    return new FsError(ErrorCode.TOO_LARGE, `File exceeds size limit (${bytesRead} > ${maxSize} bytes)`, requestedPath, { size: bytesRead, maxSize });
+}
+export async function readFileBufferWithLimit(handle, maxSize, requestedPath, signal) {
+    const stream = handle.createReadStream({
+        start: 0,
+        highWaterMark: STREAM_CHUNK_SIZE,
+        autoClose: false,
+        emitClose: false,
+        signal,
+    });
+    const chunks = [];
+    let totalSize = 0;
+    try {
+        for await (const chunk of stream) {
+            const buffer = chunk;
+            totalSize += buffer.length;
+            if (totalSize > maxSize) {
+                stream.destroy();
+                throw createTooLargeError(totalSize, maxSize, requestedPath);
+            }
+            chunks.push(buffer);
+        }
+    }
+    finally {
+        if (!stream.destroyed) {
+            stream.on('error', (_err) => {
+                /* suppress post-destroy error event */
+            });
+            stream.destroy();
+        }
+    }
+    return Buffer.concat(chunks, totalSize);
+}
+export const countLines = (content) => {
+    if (content.length === 0)
+        return 0;
+    const trimmed = content.endsWith('\n') ? content.slice(0, -1) : content;
+    return trimmed.split('\n').length;
+};
+async function peekHasMore(iterator) {
+    try {
+        const { done } = await iterator.next();
+        return !done;
+    }
+    catch (error) {
+        // The peek only asks "is there another line", and the caller keeps nothing
+        // it returns. An over-long line past the requested range still answers yes
+        // — failing the whole read over a line outside it would reject e.g. lines
+        // 1-2 of a file whose line 3 is one 50 KB blob.
+        if (isFsError(error) && error.code === ErrorCode.TOO_LARGE)
+            return true;
+        throw error;
+    }
+}
+const LF = 0x0a;
+function stripCarriageReturn(line) {
+    return line.endsWith('\r') ? line.slice(0, -1) : line;
+}
+/**
+ * Line iterator bounded by bytes rather than by the decoded string, so a file
+ * that is one enormous line cannot be materialized before the size check runs.
+ * `handle.readLines` decodes the whole line first and can OOM on such a file.
+ *
+ * Yields lines from `startLine` onward, 1-indexed. Lines before `startLine` are
+ * counted and discarded without accumulating, so an over-long line the caller
+ * skipped past does not fail the read. Line endings match `readLines`: split on
+ * `\n`, with a preceding `\r` stripped, so CRLF input decodes identically.
+ */
+async function* readLinesBounded(handle, options, filePath, startLine) {
+    const stream = handle.createReadStream({
+        start: 0,
+        highWaterMark: STREAM_CHUNK_SIZE,
+        autoClose: false,
+        emitClose: false,
+        ...(options.signal ? { signal: options.signal } : {}),
+    });
+    const decoder = new StringDecoder(options.encoding);
+    let pending = '';
+    let pendingBytes = 0;
+    let lineNumber = 0;
+    const tooLong = (bytes) => new FsError(ErrorCode.TOO_LARGE, `File too large (single line ${bytes} > ${options.maxSize} bytes). Use a narrower range or head.`, filePath, { size: bytes, maxSize: options.maxSize });
+    try {
+        for await (const chunk of stream) {
+            const buffer = chunk;
+            let offset = 0;
+            // Search loop: each iteration finds the next LF and advances offset past
+            // it. Written as while-with-assignment so the re-search is visible, rather
+            // than buried in a for "increment" slot that re-runs indexOf.
+            let nl = buffer.indexOf(LF, offset);
+            while (nl !== -1) {
+                const segment = buffer.subarray(offset, nl);
+                const lineBytes = pendingBytes + segment.length;
+                lineNumber++;
+                // Decode even when skipping: the decoder carries multi-byte
+                // continuation state into the first line the caller keeps.
+                const decoded = decoder.write(segment);
+                if (lineNumber >= startLine) {
+                    if (lineBytes > options.maxSize)
+                        throw tooLong(lineBytes);
+                    yield stripCarriageReturn(pending + decoded);
+                }
+                pending = '';
+                pendingBytes = 0;
+                offset = nl + 1;
+                nl = buffer.indexOf(LF, offset);
+            }
+            const rest = buffer.subarray(offset);
+            pendingBytes += rest.length;
+            if (lineNumber + 1 < startLine) {
+                decoder.write(rest); // still skipping; drop the text, keep decoder state
+            }
+            else {
+                if (pendingBytes > options.maxSize)
+                    throw tooLong(pendingBytes);
+                pending += decoder.write(rest);
+            }
+        }
+        // Trailing line with no final newline. A file ending in `\n` leaves
+        // pendingBytes at 0 and emits nothing, matching readLines.
+        if (pendingBytes > 0) {
+            lineNumber++;
+            if (lineNumber >= startLine) {
+                if (pendingBytes > options.maxSize)
+                    throw tooLong(pendingBytes);
+                yield pending + decoder.end();
+            }
+        }
+    }
+    finally {
+        if (!stream.destroyed) {
+            stream.on('error', (_err) => {
+                /* suppress post-destroy error event */
+            });
+            stream.destroy();
+        }
+    }
+}
+async function readRangeContent(handle, startLine, endLine, options, filePath) {
+    options.signal?.throwIfAborted();
+    const lines = [];
+    let lineNumber = startLine - 1;
+    let estimatedBytes = 0;
+    const newlineBytes = Buffer.byteLength('\n', options.encoding);
+    const stopAt = endLine ?? Number.POSITIVE_INFINITY;
+    let hasMoreLines = false;
+    let stoppedByLimit = false;
+    // Byte-bounded: an over-long line throws TOO_LARGE while still a partial
+    // buffer, before it can be decoded into one huge string.
+    const iterator = readLinesBounded(handle, options, filePath, startLine)[Symbol.asyncIterator]();
+    try {
+        for (;;) {
+            const { value: line, done } = await iterator.next();
+            if (done) {
+                break;
+            }
+            lineNumber++;
+            if (lineNumber > stopAt) {
+                hasMoreLines = true;
+                break;
+            }
+            lines.push(line);
+            estimatedBytes += Buffer.byteLength(line, options.encoding) + newlineBytes;
+            if (estimatedBytes > options.maxSize) {
+                stoppedByLimit = true;
+                hasMoreLines = await peekHasMore(iterator);
+                break;
+            }
+            if (lineNumber === stopAt) {
+                hasMoreLines = await peekHasMore(iterator);
+                break;
+            }
+        }
+    }
+    finally {
+        await iterator.return();
+    }
+    return {
+        content: lines.join('\n'),
+        truncated: stoppedByLimit || hasMoreLines,
+        linesRead: lines.length,
+        hasMoreLines,
+    };
+}
+async function readTailContent(handle, tail, options, filePath) {
+    options.signal?.throwIfAborted();
+    const stats = await handle.stat();
+    const fileSize = stats.size;
+    if (fileSize === 0) {
+        return {
+            content: '',
+            truncated: false,
+            linesRead: 0,
+            hasMoreLines: false,
+        };
+    }
+    const encoding = options.encoding;
+    // Accumulate raw bytes from the end: decoding a chunk ending mid-codepoint
+    // corrupts the trailing UTF-8 sequence into U+FFFD. 0x0A is single-byte and
+    // never part of a multibyte sequence, so count newlines on the raw buffer and
+    // decode the whole bounded buffer once at the end.
+    let position = fileSize;
+    const chunks = [];
+    let totalLen = 0;
+    let newlines = 0;
+    let stoppedByLimit = false;
+    while (position > 0) {
+        options.signal?.throwIfAborted();
+        const chunkSize = Math.min(position, STREAM_CHUNK_SIZE);
+        const buffer = Buffer.allocUnsafe(chunkSize);
+        const { bytesRead } = await handle.read(buffer, 0, chunkSize, position - chunkSize);
+        if (bytesRead < chunkSize) {
+            // The file shrank under us. Bytes from `position` on are still a
+            // contiguous suffix, so keep those and stop — splicing this short chunk in
+            // would leave a hole (and, with an alloc'd buffer, NULs) mid-content.
+            // `position` stays put, so the result is reported as having more lines.
+            break;
+        }
+        position -= chunkSize;
+        for (const byte of buffer) {
+            if (byte === 0x0a)
+                newlines++;
+        }
+        chunks.unshift(buffer);
+        totalLen += chunkSize;
+        // One newline more than `tail`: the oldest segment in the buffer starts
+        // mid-line whenever we stop before the file start, and gets dropped below.
+        if (newlines > tail)
+            break;
+        if (totalLen > options.maxSize) {
+            stoppedByLimit = true;
+            break;
+        }
+    }
+    const allBytes = Buffer.concat(chunks, totalLen);
+    let lines = allBytes.toString(encoding).split('\n');
+    // A trailing newline produces a spurious empty final segment; drop it.
+    if (lines.length > 0 && lines[lines.length - 1] === '') {
+        lines = lines.slice(0, -1);
+    }
+    // Normalize CRLF.
+    lines = lines.map((l) => (l.endsWith('\r') ? l.slice(0, -1) : l));
+    // We stopped before the file start, so the first segment is the tail of a
+    // line whose beginning was never read. Drop it instead of reporting a
+    // fragment as a complete line.
+    if (position > 0 && lines.length > 0) {
+        lines = lines.slice(1);
+    }
+    if (stoppedByLimit && lines.length < tail) {
+        throw new FsError(ErrorCode.TOO_LARGE, `File too large (${totalLen} > ${options.maxSize} bytes, could not collect ${tail} lines). Use a narrower tail or head.`, filePath, { size: totalLen, maxSize: options.maxSize });
+    }
+    let hasMoreLines = stoppedByLimit || position > 0;
+    if (lines.length > tail) {
+        hasMoreLines = true;
+        lines = lines.slice(lines.length - tail);
+    }
+    const content = lines.join('\n');
+    return {
+        content,
+        truncated: hasMoreLines,
+        linesRead: lines.length,
+        hasMoreLines,
+    };
+}
+async function readFullContent(handle, encoding, maxSize, requestedPath, signal) {
+    const buffer = await readFileBufferWithLimit(handle, maxSize, requestedPath, signal);
+    const content = buffer.toString(encoding);
+    return { content, totalLines: countLines(content) };
+}
+async function assertNotBinary(validPath, filePath, handle, normalized) {
+    normalized.signal?.throwIfAborted();
+    const isBinary = await isProbablyBinary(validPath, handle, normalized.signal);
+    if (!isBinary)
+        return;
+    throw new FsError(ErrorCode.INVALID_INPUT, 'Binary file detected.', filePath);
+}
+function assertSizeWithinLimit(size, maxSize, filePath) {
+    if (size <= maxSize)
+        return;
+    throw new FsError(ErrorCode.TOO_LARGE, `File too large (${size} > ${maxSize} bytes). Use head to preview.`, filePath, { size, maxSize });
+}
+async function readHead(context, spec) {
+    const contentOptions = buildReadContentOptions(spec);
+    const { content, truncated, linesRead, hasMoreLines } = await readRangeContent(context.handle, 1, spec.lines, contentOptions, context.filePath);
+    return {
+        path: context.validPath,
+        content,
+        truncated,
+        readMode: 'head',
+        head: spec.lines,
+        linesRead,
+        hasMoreLines,
+    };
+}
+async function readRange(context, spec) {
+    const contentOptions = buildReadContentOptions(spec);
+    const { content, truncated, linesRead, hasMoreLines } = await readRangeContent(context.handle, spec.start, spec.end, contentOptions, context.filePath);
+    return {
+        path: context.validPath,
+        content,
+        truncated,
+        readMode: 'range',
+        startLine: spec.start,
+        ...(spec.end !== undefined ? { endLine: spec.end } : {}),
+        linesRead,
+        hasMoreLines,
+    };
+}
+async function readFull(context, spec) {
+    assertSizeWithinLimit(context.stats.size, spec.maxSize, context.filePath);
+    const { content, totalLines } = await readFullContent(context.handle, spec.encoding, spec.maxSize, context.filePath, spec.signal);
+    return {
+        path: context.validPath,
+        content,
+        truncated: false,
+        totalLines,
+        readMode: 'full',
+        linesRead: totalLines,
+        hasMoreLines: false,
+    };
+}
+async function readTail(context, spec) {
+    const contentOptions = buildReadContentOptions(spec);
+    const { content, truncated, linesRead, hasMoreLines } = await readTailContent(context.handle, spec.lines, contentOptions, context.validPath);
+    return {
+        path: context.validPath,
+        content,
+        truncated,
+        readMode: 'tail',
+        tail: spec.lines,
+        linesRead,
+        hasMoreLines,
+    };
+}
+async function readByMode(context) {
+    switch (context.spec.kind) {
+        case 'head':
+            return readHead(context, context.spec);
+        case 'range':
+            return readRange(context, context.spec);
+        case 'full':
+            return readFull(context, context.spec);
+        case 'tail':
+            return readTail(context, context.spec);
+        default: {
+            const _exhaustive = context.spec;
+            return _exhaustive;
+        }
+    }
+}
+export function assertFileStats(filePath, stats) {
+    if (!stats.isFile()) {
+        throw new FsError(ErrorCode.NOT_FILE, 'Not a regular file', filePath);
+    }
+}
+export async function readNormalized(filePath, validPath, stats, spec) {
+    const env_2 = { stack: [], error: void 0, hasError: false };
+    try {
+        spec.signal?.throwIfAborted();
+        assertFileStats(filePath, stats);
+        const handle = __addDisposableResource(env_2, await openReadableFileHandle(validPath, spec.signal), true);
+        if (spec.skipBinary) {
+            await assertNotBinary(validPath, filePath, handle, spec);
+        }
+        spec.signal?.throwIfAborted();
+        return await readByMode({ handle, validPath, filePath, stats, spec });
+    }
+    catch (e_2) {
+        env_2.error = e_2;
+        env_2.hasError = true;
+    }
+    finally {
+        const result_2 = __disposeResources(env_2);
+        if (result_2)
+            await result_2;
+    }
+}
+export async function readFileWithStats(filePath, validPath, stats, spec) {
+    return readNormalized(filePath, validPath, stats, normalizeSpec(spec ?? { kind: 'full' }));
+}
+//# sourceMappingURL=read.js.map

package/dist/core/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/core/read.ts"],"names":[],"mappings":"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","sourcesContent":["// File reading pipeline split out of fs.ts. fs.ts imports from here; never the reverse.\nimport type { Stats } from 'node:fs';\nimport { open as fsOpen } from 'node:fs/promises';\nimport type { FileHandle } from 'node:fs/promises';\nimport { StringDecoder } from 'node:string_decoder';\n\nimport { withAbort } from './concurrency.js';\nimport { ErrorCode, formatUnknownErrorMessage, FsError, isFsError } from './errors.js';\nimport { isBinarySample, isKnownBinaryExtension, MIME_SAMPLE_SIZE } from './mime.js';\nimport { Logger } from './observability.js';\nimport { getMaxTextFileSize } from './util.js';\n\nexport const STREAM_CHUNK_SIZE = 64 * 1024;\n\nconst READ_ONLY_FILE_FLAG = 'r';\n\nfunction assertPositiveIntegerOption(name: string, value: unknown, message?: string): void {\n  if (\n    value === undefined ||\n    (typeof value === 'number' && Number.isSafeInteger(value) && value >= 1)\n  )\n    return;\n  throw new FsError(ErrorCode.INVALID_INPUT, message ?? `${name} must be a positive integer`);\n}\n\nasync function openReadableFileHandle(filePath: string, signal?: AbortSignal): Promise<FileHandle> {\n  const handlePromise = fsOpen(filePath, READ_ONLY_FILE_FLAG);\n  if (!signal) return handlePromise;\n  try {\n    return await withAbort(handlePromise, signal);\n  } catch (error) {\n    void handlePromise\n      .then((handle) => {\n        void handle.close().catch((closeErr: unknown) => {\n          Logger.warn(\n            `Failed to close file handle for ${filePath} after abort: ${formatUnknownErrorMessage(closeErr)}`,\n          );\n        });\n      })\n      .catch(() => {\n        /* ignore open error */\n      });\n    throw error;\n  }\n}\n\nasync function readProbe(handle: FileHandle, signal?: AbortSignal): Promise<Buffer> {\n  const buffer = Buffer.allocUnsafe(MIME_SAMPLE_SIZE);\n  const { bytesRead } = await withAbort(handle.read(buffer, 0, MIME_SAMPLE_SIZE, 0), signal);\n\n  if (bytesRead === 0) {\n    return Buffer.alloc(0);\n  }\n\n  return buffer.subarray(0, bytesRead);\n}\n\nasync function isProbablyBinary(\n  filePath: string,\n  existingHandle?: FileHandle,\n  signal?: AbortSignal,\n): Promise<boolean> {\n  if (isKnownBinaryExtension(filePath)) {\n    return true;\n  }\n\n  if (existingHandle) {\n    const slice = await readProbe(existingHandle, signal);\n    return isBinarySample(slice);\n  }\n\n  await using handle = await openReadableFileHandle(filePath, signal);\n  const slice = await readProbe(handle, signal);\n  return isBinarySample(slice);\n}\n\nexport type ReadSpec =\n  | {\n      kind: 'full';\n      encoding?: BufferEncoding;\n      maxSize?: number;\n      skipBinary?: boolean;\n      signal?: AbortSignal;\n    }\n  | {\n      kind: 'head';\n      lines: number;\n      encoding?: BufferEncoding;\n      maxSize?: number;\n      skipBinary?: boolean;\n      signal?: AbortSignal;\n    }\n  | {\n      kind: 'tail';\n      lines: number;\n      encoding?: BufferEncoding;\n      maxSize?: number;\n      skipBinary?: boolean;\n      signal?: AbortSignal;\n    }\n  | {\n      kind: 'range';\n      start: number;\n      end?: number;\n      encoding?: BufferEncoding;\n      maxSize?: number;\n      skipBinary?: boolean;\n      signal?: AbortSignal;\n    };\n\ninterface NormalizedBase {\n  encoding: BufferEncoding;\n  maxSize: number;\n  skipBinary: boolean;\n  signal?: AbortSignal;\n}\n\ntype NormalizedSpec =\n  | (NormalizedBase & { kind: 'full' })\n  | (NormalizedBase & { kind: 'head'; lines: number })\n  | (NormalizedBase & { kind: 'tail'; lines: number })\n  | (NormalizedBase & { kind: 'range'; start: number; end?: number });\n\ninterface ReadContentOptions {\n  encoding: BufferEncoding;\n  maxSize: number;\n  signal?: AbortSignal;\n}\n\ninterface PartialReadResult {\n  content: string;\n  truncated: boolean;\n  linesRead: number;\n  hasMoreLines: boolean;\n}\n\nexport interface ReadFileResult {\n  path: string;\n  content: string;\n  truncated: boolean;\n  totalLines?: number;\n  readMode: ReadSpec['kind'];\n  head?: number;\n  tail?: number;\n  startLine?: number;\n  endLine?: number;\n  linesRead?: number;\n  hasMoreLines?: boolean;\n}\n\nfunction buildBaseOptions(spec: ReadSpec): NormalizedBase {\n  if (spec.maxSize !== undefined) {\n    assertPositiveIntegerOption('maxSize', spec.maxSize, 'maxSize must be at least 1');\n  }\n  const maxTextFileSize = getMaxTextFileSize();\n  return {\n    encoding: spec.encoding ?? 'utf-8',\n    maxSize: Math.min(spec.maxSize ?? maxTextFileSize, maxTextFileSize),\n    skipBinary: spec.skipBinary ?? false,\n    ...(spec.signal ? { signal: spec.signal } : {}),\n  };\n}\n\nfunction normalizeHeadSpec(\n  spec: Extract<ReadSpec, { kind: 'head' }>,\n  base: NormalizedBase,\n): NormalizedSpec {\n  assertPositiveIntegerOption('lines', spec.lines, 'lines must be at least 1');\n  return { ...base, kind: 'head', lines: spec.lines };\n}\n\nfunction normalizeTailSpec(\n  spec: Extract<ReadSpec, { kind: 'tail' }>,\n  base: NormalizedBase,\n): NormalizedSpec {\n  assertPositiveIntegerOption('lines', spec.lines, 'lines must be at least 1');\n  return { ...base, kind: 'tail', lines: spec.lines };\n}\n\nfunction normalizeRangeSpec(\n  spec: Extract<ReadSpec, { kind: 'range' }>,\n  base: NormalizedBase,\n): NormalizedSpec {\n  assertPositiveIntegerOption('start', spec.start, 'start must be at least 1');\n  if (spec.end !== undefined) {\n    assertPositiveIntegerOption('end', spec.end, 'end must be at least 1');\n    if (spec.end < spec.start) {\n      throw new FsError(\n        ErrorCode.INVALID_INPUT,\n        'end must be greater than or equal to start (default: 1)',\n      );\n    }\n  }\n  return {\n    ...base,\n    kind: 'range',\n    start: spec.start,\n    ...(spec.end !== undefined ? { end: spec.end } : {}),\n  };\n}\n\nexport function normalizeSpec(spec: ReadSpec): NormalizedSpec {\n  const base = buildBaseOptions(spec);\n  spec.signal?.throwIfAborted();\n\n  switch (spec.kind) {\n    case 'head':\n      return normalizeHeadSpec(spec, base);\n    case 'tail':\n      return normalizeTailSpec(spec, base);\n    case 'range':\n      return normalizeRangeSpec(spec, base);\n    case 'full':\n      return { ...base, kind: 'full' };\n    default: {\n      const _exhaustive: never = spec;\n      return _exhaustive;\n    }\n  }\n}\n\nfunction buildReadContentOptions(normalized: NormalizedBase): ReadContentOptions {\n  const result: ReadContentOptions = {\n    encoding: normalized.encoding,\n    maxSize: normalized.maxSize,\n  };\n  if (normalized.signal) result.signal = normalized.signal;\n  return result;\n}\n\nexport function createTooLargeError(\n  bytesRead: number,\n  maxSize: number,\n  requestedPath: string,\n): FsError {\n  return new FsError(\n    ErrorCode.TOO_LARGE,\n    `File exceeds size limit (${bytesRead} > ${maxSize} bytes)`,\n    requestedPath,\n    { size: bytesRead, maxSize },\n  );\n}\n\nexport async function readFileBufferWithLimit(\n  handle: FileHandle,\n  maxSize: number,\n  requestedPath: string,\n  signal?: AbortSignal,\n): Promise<Buffer> {\n  const stream = handle.createReadStream({\n    start: 0,\n    highWaterMark: STREAM_CHUNK_SIZE,\n    autoClose: false,\n    emitClose: false,\n    signal,\n  });\n\n  const chunks: Buffer[] = [];\n  let totalSize = 0;\n\n  try {\n    for await (const chunk of stream) {\n      const buffer = chunk as Buffer;\n      totalSize += buffer.length;\n\n      if (totalSize > maxSize) {\n        stream.destroy();\n        throw createTooLargeError(totalSize, maxSize, requestedPath);\n      }\n\n      chunks.push(buffer);\n    }\n  } finally {\n    if (!stream.destroyed) {\n      stream.on('error', (_err: unknown) => {\n        /* suppress post-destroy error event */\n      });\n      stream.destroy();\n    }\n  }\n\n  return Buffer.concat(chunks, totalSize);\n}\n\nexport const countLines = (content: string): number => {\n  if (content.length === 0) return 0;\n  const trimmed = content.endsWith('\\n') ? content.slice(0, -1) : content;\n  return trimmed.split('\\n').length;\n};\n\nasync function peekHasMore(iterator: AsyncIterator<string>): Promise<boolean> {\n  try {\n    const { done } = await iterator.next();\n    return !done;\n  } catch (error) {\n    // The peek only asks \"is there another line\", and the caller keeps nothing\n    // it returns. An over-long line past the requested range still answers yes\n    // — failing the whole read over a line outside it would reject e.g. lines\n    // 1-2 of a file whose line 3 is one 50 KB blob.\n    if (isFsError(error) && error.code === ErrorCode.TOO_LARGE) return true;\n    throw error;\n  }\n}\n\nconst LF = 0x0a;\n\nfunction stripCarriageReturn(line: string): string {\n  return line.endsWith('\\r') ? line.slice(0, -1) : line;\n}\n\n/**\n * Line iterator bounded by bytes rather than by the decoded string, so a file\n * that is one enormous line cannot be materialized before the size check runs.\n * `handle.readLines` decodes the whole line first and can OOM on such a file.\n *\n * Yields lines from `startLine` onward, 1-indexed. Lines before `startLine` are\n * counted and discarded without accumulating, so an over-long line the caller\n * skipped past does not fail the read. Line endings match `readLines`: split on\n * `\\n`, with a preceding `\\r` stripped, so CRLF input decodes identically.\n */\nasync function* readLinesBounded(\n  handle: FileHandle,\n  options: ReadContentOptions,\n  filePath: string,\n  startLine: number,\n): AsyncGenerator<string, void, undefined> {\n  const stream = handle.createReadStream({\n    start: 0,\n    highWaterMark: STREAM_CHUNK_SIZE,\n    autoClose: false,\n    emitClose: false,\n    ...(options.signal ? { signal: options.signal } : {}),\n  });\n\n  const decoder = new StringDecoder(options.encoding);\n  let pending = '';\n  let pendingBytes = 0;\n  let lineNumber = 0;\n\n  const tooLong = (bytes: number): FsError =>\n    new FsError(\n      ErrorCode.TOO_LARGE,\n      `File too large (single line ${bytes} > ${options.maxSize} bytes). Use a narrower range or head.`,\n      filePath,\n      { size: bytes, maxSize: options.maxSize },\n    );\n\n  try {\n    for await (const chunk of stream) {\n      const buffer = chunk as Buffer;\n      let offset = 0;\n\n      // Search loop: each iteration finds the next LF and advances offset past\n      // it. Written as while-with-assignment so the re-search is visible, rather\n      // than buried in a for \"increment\" slot that re-runs indexOf.\n      let nl = buffer.indexOf(LF, offset);\n      while (nl !== -1) {\n        const segment = buffer.subarray(offset, nl);\n        const lineBytes = pendingBytes + segment.length;\n        lineNumber++;\n        // Decode even when skipping: the decoder carries multi-byte\n        // continuation state into the first line the caller keeps.\n        const decoded = decoder.write(segment);\n        if (lineNumber >= startLine) {\n          if (lineBytes > options.maxSize) throw tooLong(lineBytes);\n          yield stripCarriageReturn(pending + decoded);\n        }\n        pending = '';\n        pendingBytes = 0;\n        offset = nl + 1;\n        nl = buffer.indexOf(LF, offset);\n      }\n\n      const rest = buffer.subarray(offset);\n      pendingBytes += rest.length;\n      if (lineNumber + 1 < startLine) {\n        decoder.write(rest); // still skipping; drop the text, keep decoder state\n      } else {\n        if (pendingBytes > options.maxSize) throw tooLong(pendingBytes);\n        pending += decoder.write(rest);\n      }\n    }\n\n    // Trailing line with no final newline. A file ending in `\\n` leaves\n    // pendingBytes at 0 and emits nothing, matching readLines.\n    if (pendingBytes > 0) {\n      lineNumber++;\n      if (lineNumber >= startLine) {\n        if (pendingBytes > options.maxSize) throw tooLong(pendingBytes);\n        yield pending + decoder.end();\n      }\n    }\n  } finally {\n    if (!stream.destroyed) {\n      stream.on('error', (_err: unknown) => {\n        /* suppress post-destroy error event */\n      });\n      stream.destroy();\n    }\n  }\n}\n\nasync function readRangeContent(\n  handle: FileHandle,\n  startLine: number,\n  endLine: number | undefined,\n  options: ReadContentOptions,\n  filePath: string,\n): Promise<PartialReadResult> {\n  options.signal?.throwIfAborted();\n\n  const lines: string[] = [];\n  let lineNumber = startLine - 1;\n  let estimatedBytes = 0;\n  const newlineBytes = Buffer.byteLength('\\n', options.encoding);\n  const stopAt = endLine ?? Number.POSITIVE_INFINITY;\n\n  let hasMoreLines = false;\n  let stoppedByLimit = false;\n\n  // Byte-bounded: an over-long line throws TOO_LARGE while still a partial\n  // buffer, before it can be decoded into one huge string.\n  const iterator = readLinesBounded(handle, options, filePath, startLine)[Symbol.asyncIterator]();\n\n  try {\n    for (;;) {\n      const { value: line, done } = await iterator.next();\n      if (done) {\n        break;\n      }\n      lineNumber++;\n\n      if (lineNumber > stopAt) {\n        hasMoreLines = true;\n        break;\n      }\n\n      lines.push(line);\n\n      estimatedBytes += Buffer.byteLength(line, options.encoding) + newlineBytes;\n      if (estimatedBytes > options.maxSize) {\n        stoppedByLimit = true;\n        hasMoreLines = await peekHasMore(iterator);\n        break;\n      }\n\n      if (lineNumber === stopAt) {\n        hasMoreLines = await peekHasMore(iterator);\n        break;\n      }\n    }\n  } finally {\n    await iterator.return();\n  }\n\n  return {\n    content: lines.join('\\n'),\n    truncated: stoppedByLimit || hasMoreLines,\n    linesRead: lines.length,\n    hasMoreLines,\n  };\n}\n\nasync function readTailContent(\n  handle: FileHandle,\n  tail: number,\n  options: ReadContentOptions,\n  filePath: string,\n): Promise<PartialReadResult> {\n  options.signal?.throwIfAborted();\n\n  const stats = await handle.stat();\n  const fileSize = stats.size;\n  if (fileSize === 0) {\n    return {\n      content: '',\n      truncated: false,\n      linesRead: 0,\n      hasMoreLines: false,\n    };\n  }\n\n  const encoding = options.encoding;\n  // Accumulate raw bytes from the end: decoding a chunk ending mid-codepoint\n  // corrupts the trailing UTF-8 sequence into U+FFFD. 0x0A is single-byte and\n  // never part of a multibyte sequence, so count newlines on the raw buffer and\n  // decode the whole bounded buffer once at the end.\n  let position = fileSize;\n  const chunks: Buffer[] = [];\n  let totalLen = 0;\n  let newlines = 0;\n  let stoppedByLimit = false;\n\n  while (position > 0) {\n    options.signal?.throwIfAborted();\n    const chunkSize = Math.min(position, STREAM_CHUNK_SIZE);\n    const buffer = Buffer.allocUnsafe(chunkSize);\n    const { bytesRead } = await handle.read(buffer, 0, chunkSize, position - chunkSize);\n    if (bytesRead < chunkSize) {\n      // The file shrank under us. Bytes from `position` on are still a\n      // contiguous suffix, so keep those and stop — splicing this short chunk in\n      // would leave a hole (and, with an alloc'd buffer, NULs) mid-content.\n      // `position` stays put, so the result is reported as having more lines.\n      break;\n    }\n    position -= chunkSize;\n\n    for (const byte of buffer) {\n      if (byte === 0x0a) newlines++;\n    }\n\n    chunks.unshift(buffer);\n    totalLen += chunkSize;\n\n    // One newline more than `tail`: the oldest segment in the buffer starts\n    // mid-line whenever we stop before the file start, and gets dropped below.\n    if (newlines > tail) break;\n    if (totalLen > options.maxSize) {\n      stoppedByLimit = true;\n      break;\n    }\n  }\n\n  const allBytes = Buffer.concat(chunks, totalLen);\n  let lines = allBytes.toString(encoding).split('\\n');\n\n  // A trailing newline produces a spurious empty final segment; drop it.\n  if (lines.length > 0 && lines[lines.length - 1] === '') {\n    lines = lines.slice(0, -1);\n  }\n  // Normalize CRLF.\n  lines = lines.map((l) => (l.endsWith('\\r') ? l.slice(0, -1) : l));\n\n  // We stopped before the file start, so the first segment is the tail of a\n  // line whose beginning was never read. Drop it instead of reporting a\n  // fragment as a complete line.\n  if (position > 0 && lines.length > 0) {\n    lines = lines.slice(1);\n  }\n\n  if (stoppedByLimit && lines.length < tail) {\n    throw new FsError(\n      ErrorCode.TOO_LARGE,\n      `File too large (${totalLen} > ${options.maxSize} bytes, could not collect ${tail} lines). Use a narrower tail or head.`,\n      filePath,\n      { size: totalLen, maxSize: options.maxSize },\n    );\n  }\n\n  let hasMoreLines = stoppedByLimit || position > 0;\n  if (lines.length > tail) {\n    hasMoreLines = true;\n    lines = lines.slice(lines.length - tail);\n  }\n\n  const content = lines.join('\\n');\n  return {\n    content,\n    truncated: hasMoreLines,\n    linesRead: lines.length,\n    hasMoreLines,\n  };\n}\n\nasync function readFullContent(\n  handle: FileHandle,\n  encoding: BufferEncoding,\n  maxSize: number,\n  requestedPath: string,\n  signal?: AbortSignal,\n): Promise<{ content: string; totalLines: number }> {\n  const buffer = await readFileBufferWithLimit(handle, maxSize, requestedPath, signal);\n  const content = buffer.toString(encoding);\n  return { content, totalLines: countLines(content) };\n}\n\nasync function assertNotBinary(\n  validPath: string,\n  filePath: string,\n  handle: FileHandle,\n  normalized: NormalizedBase,\n): Promise<void> {\n  normalized.signal?.throwIfAborted();\n  const isBinary = await isProbablyBinary(validPath, handle, normalized.signal);\n  if (!isBinary) return;\n  throw new FsError(ErrorCode.INVALID_INPUT, 'Binary file detected.', filePath);\n}\n\nfunction assertSizeWithinLimit(size: number, maxSize: number, filePath: string): void {\n  if (size <= maxSize) return;\n  throw new FsError(\n    ErrorCode.TOO_LARGE,\n    `File too large (${size} > ${maxSize} bytes). Use head to preview.`,\n    filePath,\n    { size, maxSize },\n  );\n}\n\ninterface ReadModeContext {\n  handle: FileHandle;\n  validPath: string;\n  filePath: string;\n  stats: Stats;\n  spec: NormalizedSpec;\n}\n\nasync function readHead(\n  context: ReadModeContext,\n  spec: Extract<NormalizedSpec, { kind: 'head' }>,\n): Promise<ReadFileResult> {\n  const contentOptions = buildReadContentOptions(spec);\n  const { content, truncated, linesRead, hasMoreLines } = await readRangeContent(\n    context.handle,\n    1,\n    spec.lines,\n    contentOptions,\n    context.filePath,\n  );\n\n  return {\n    path: context.validPath,\n    content,\n    truncated,\n    readMode: 'head',\n    head: spec.lines,\n    linesRead,\n    hasMoreLines,\n  };\n}\n\nasync function readRange(\n  context: ReadModeContext,\n  spec: Extract<NormalizedSpec, { kind: 'range' }>,\n): Promise<ReadFileResult> {\n  const contentOptions = buildReadContentOptions(spec);\n  const { content, truncated, linesRead, hasMoreLines } = await readRangeContent(\n    context.handle,\n    spec.start,\n    spec.end,\n    contentOptions,\n    context.filePath,\n  );\n\n  return {\n    path: context.validPath,\n    content,\n    truncated,\n    readMode: 'range',\n    startLine: spec.start,\n    ...(spec.end !== undefined ? { endLine: spec.end } : {}),\n    linesRead,\n    hasMoreLines,\n  };\n}\n\nasync function readFull(\n  context: ReadModeContext,\n  spec: Extract<NormalizedSpec, { kind: 'full' }>,\n): Promise<ReadFileResult> {\n  assertSizeWithinLimit(context.stats.size, spec.maxSize, context.filePath);\n  const { content, totalLines } = await readFullContent(\n    context.handle,\n    spec.encoding,\n    spec.maxSize,\n    context.filePath,\n    spec.signal,\n  );\n\n  return {\n    path: context.validPath,\n    content,\n    truncated: false,\n    totalLines,\n    readMode: 'full',\n    linesRead: totalLines,\n    hasMoreLines: false,\n  };\n}\n\nasync function readTail(\n  context: ReadModeContext,\n  spec: Extract<NormalizedSpec, { kind: 'tail' }>,\n): Promise<ReadFileResult> {\n  const contentOptions = buildReadContentOptions(spec);\n  const { content, truncated, linesRead, hasMoreLines } = await readTailContent(\n    context.handle,\n    spec.lines,\n    contentOptions,\n    context.validPath,\n  );\n\n  return {\n    path: context.validPath,\n    content,\n    truncated,\n    readMode: 'tail',\n    tail: spec.lines,\n    linesRead,\n    hasMoreLines,\n  };\n}\n\nasync function readByMode(context: ReadModeContext): Promise<ReadFileResult> {\n  switch (context.spec.kind) {\n    case 'head':\n      return readHead(context, context.spec);\n    case 'range':\n      return readRange(context, context.spec);\n    case 'full':\n      return readFull(context, context.spec);\n    case 'tail':\n      return readTail(context, context.spec);\n    default: {\n      const _exhaustive: never = context.spec;\n      return _exhaustive;\n    }\n  }\n}\n\nexport function assertFileStats(filePath: string, stats: Stats): void {\n  if (!stats.isFile()) {\n    throw new FsError(ErrorCode.NOT_FILE, 'Not a regular file', filePath);\n  }\n}\n\nexport async function readNormalized(\n  filePath: string,\n  validPath: string,\n  stats: Stats,\n  spec: NormalizedSpec,\n): Promise<ReadFileResult> {\n  spec.signal?.throwIfAborted();\n\n  assertFileStats(filePath, stats);\n\n  await using handle = await openReadableFileHandle(validPath, spec.signal);\n\n  if (spec.skipBinary) {\n    await assertNotBinary(validPath, filePath, handle, spec);\n  }\n  spec.signal?.throwIfAborted();\n\n  return await readByMode({ handle, validPath, filePath, stats, spec });\n}\n\nexport async function readFileWithStats(\n  filePath: string,\n  validPath: string,\n  stats: Stats,\n  spec: ReadSpec | undefined,\n): Promise<ReadFileResult> {\n  return readNormalized(filePath, validPath, stats, normalizeSpec(spec ?? { kind: 'full' }));\n}\n"]}