@j0hanz/fs-context-mcp 2.0.0

package/dist/lib/fs-helpers/readers/read-modes.d.ts

@@ -0,0 +1,5 @@
+import type { Stats } from 'node:fs';
+import type { FileHandle } from 'node:fs/promises';
+import { type NormalizedOptions, type ReadFileResult } from './read-options.js';
+export declare function readByMode(handle: FileHandle, validPath: string, filePath: string, stats: Stats, normalized: NormalizedOptions): Promise<ReadFileResult>;
+//# sourceMappingURL=read-modes.d.ts.map

package/dist/lib/fs-helpers/readers/read-modes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-modes.d.ts","sourceRoot":"","sources":["../../../../src/lib/fs-helpers/readers/read-modes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAInD,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EAEpB,MAAM,mBAAmB,CAAC;AA2G3B,wBAAsB,UAAU,CAC9B,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,iBAAiB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAMzB"}

package/dist/lib/fs-helpers/readers/read-modes.js

@@ -0,0 +1,59 @@
+import { ErrorCode, McpError } from '../../errors.js';
+import { readFullContent, readHeadContent } from './read-file-content.js';
+import { resolveReadMode, } from './read-options.js';
+function requireHead(normalized, filePath) {
+    if (normalized.head === undefined) {
+        throw new McpError(ErrorCode.E_INVALID_INPUT, 'Missing head option', filePath);
+    }
+    return normalized.head;
+}
+function buildHeadResult(validPath, content, truncated, head, linesRead, hasMoreLines) {
+    return {
+        path: validPath,
+        content,
+        truncated,
+        totalLines: undefined,
+        readMode: 'head',
+        head,
+        linesRead,
+        hasMoreLines,
+    };
+}
+function buildFullResult(validPath, content, totalLines) {
+    return {
+        path: validPath,
+        content,
+        truncated: false,
+        totalLines,
+        readMode: 'full',
+        linesRead: totalLines,
+        hasMoreLines: false,
+    };
+}
+function assertSizeWithinLimit(size, maxSize, filePath) {
+    if (size <= maxSize)
+        return;
+    throw new McpError(ErrorCode.E_TOO_LARGE, `File too large: ${size} bytes (max: ${maxSize} bytes). Use head parameter to preview the first N lines.`, filePath, { size, maxSize });
+}
+async function readHeadResult(handle, validPath, filePath, normalized) {
+    const head = requireHead(normalized, filePath);
+    const { content, truncated, linesRead, hasMoreLines } = await readHeadContent(handle, head, {
+        encoding: normalized.encoding,
+        maxSize: normalized.maxSize,
+        signal: normalized.signal,
+    });
+    return buildHeadResult(validPath, content, truncated, head, linesRead, hasMoreLines);
+}
+async function readFullResult(handle, validPath, filePath, stats, normalized) {
+    assertSizeWithinLimit(stats.size, normalized.maxSize, filePath);
+    const { content, totalLines } = await readFullContent(handle, normalized.encoding, normalized.maxSize, filePath, normalized.signal);
+    return buildFullResult(validPath, content, totalLines);
+}
+export async function readByMode(handle, validPath, filePath, stats, normalized) {
+    const mode = resolveReadMode(normalized);
+    if (mode === 'head') {
+        return await readHeadResult(handle, validPath, filePath, normalized);
+    }
+    return await readFullResult(handle, validPath, filePath, stats, normalized);
+}
+//# sourceMappingURL=read-modes.js.map

package/dist/lib/fs-helpers/readers/read-modes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-modes.js","sourceRoot":"","sources":["../../../../src/lib/fs-helpers/readers/read-modes.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAGL,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAE3B,SAAS,WAAW,CAAC,UAA6B,EAAE,QAAgB;IAClE,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,eAAe,EACzB,qBAAqB,EACrB,QAAQ,CACT,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,CAAC;AACzB,CAAC;AAED,SAAS,eAAe,CACtB,SAAiB,EACjB,OAAe,EACf,SAAkB,EAClB,IAAY,EACZ,SAAiB,EACjB,YAAqB;IAErB,OAAO;QACL,IAAI,EAAE,SAAS;QACf,OAAO;QACP,SAAS;QACT,UAAU,EAAE,SAAS;QACrB,QAAQ,EAAE,MAAM;QAChB,IAAI;QACJ,SAAS;QACT,YAAY;KACb,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,SAAiB,EACjB,OAAe,EACf,UAAkB;IAElB,OAAO;QACL,IAAI,EAAE,SAAS;QACf,OAAO;QACP,SAAS,EAAE,KAAK;QAChB,UAAU;QACV,QAAQ,EAAE,MAAM;QAChB,SAAS,EAAE,UAAU;QACrB,YAAY,EAAE,KAAK;KACpB,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAC5B,IAAY,EACZ,OAAe,EACf,QAAgB;IAEhB,IAAI,IAAI,IAAI,OAAO;QAAE,OAAO;IAC5B,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,WAAW,EACrB,mBAAmB,IAAI,gBAAgB,OAAO,2DAA2D,EACzG,QAAQ,EACR,EAAE,IAAI,EAAE,OAAO,EAAE,CAClB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,MAAkB,EAClB,SAAiB,EACjB,QAAgB,EAChB,UAA6B;IAE7B,MAAM,IAAI,GAAG,WAAW,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC/C,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,MAAM,eAAe,CAC3E,MAAM,EACN,IAAI,EACJ;QACE,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,MAAM,EAAE,UAAU,CAAC,MAAM;KAC1B,CACF,CAAC;IACF,OAAO,eAAe,CACpB,SAAS,EACT,OAAO,EACP,SAAS,EACT,IAAI,EACJ,SAAS,EACT,YAAY,CACb,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,MAAkB,EAClB,SAAiB,EACjB,QAAgB,EAChB,KAAY,EACZ,UAA6B;IAE7B,qBAAqB,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAChE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,eAAe,CACnD,MAAM,EACN,UAAU,CAAC,QAAQ,EACnB,UAAU,CAAC,OAAO,EAClB,QAAQ,EACR,UAAU,CAAC,MAAM,CAClB,CAAC;IACF,OAAO,eAAe,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAkB,EAClB,SAAiB,EACjB,QAAgB,EAChB,KAAY,EACZ,UAA6B;IAE7B,MAAM,IAAI,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IACzC,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,OAAO,MAAM,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,MAAM,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;AAC9E,CAAC"}

package/dist/lib/fs-helpers/readers/read-options.d.ts

@@ -0,0 +1,28 @@
+export type ReadMode = 'head' | 'full';
+export interface ReadFileOptions {
+    encoding?: BufferEncoding;
+    maxSize?: number;
+    head?: number;
+    skipBinary?: boolean;
+    signal?: AbortSignal;
+}
+export interface NormalizedOptions {
+    encoding: BufferEncoding;
+    maxSize: number;
+    head?: number;
+    skipBinary: boolean;
+    signal?: AbortSignal;
+}
+export interface ReadFileResult {
+    path: string;
+    content: string;
+    truncated: boolean;
+    totalLines?: number;
+    readMode: ReadMode;
+    head?: number;
+    linesRead?: number;
+    hasMoreLines?: boolean;
+}
+export declare function normalizeOptions(options: ReadFileOptions): NormalizedOptions;
+export declare function resolveReadMode(options: NormalizedOptions): ReadMode;
+//# sourceMappingURL=read-options.d.ts.map

package/dist/lib/fs-helpers/readers/read-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-options.d.ts","sourceRoot":"","sources":["../../../../src/lib/fs-helpers/readers/read-options.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,iBAAiB,CAW5E;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,QAAQ,CAGpE"}

package/dist/lib/fs-helpers/readers/read-options.js

@@ -0,0 +1,16 @@
+import { MAX_TEXT_FILE_SIZE } from '../../constants.js';
+export function normalizeOptions(options) {
+    return {
+        encoding: options.encoding ?? 'utf-8',
+        maxSize: Math.min(options.maxSize ?? MAX_TEXT_FILE_SIZE, MAX_TEXT_FILE_SIZE),
+        head: options.head,
+        skipBinary: options.skipBinary ?? false,
+        signal: options.signal,
+    };
+}
+export function resolveReadMode(options) {
+    if (options.head !== undefined)
+        return 'head';
+    return 'full';
+}
+//# sourceMappingURL=read-options.js.map

package/dist/lib/fs-helpers/readers/read-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-options.js","sourceRoot":"","sources":["../../../../src/lib/fs-helpers/readers/read-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AA+BxD,MAAM,UAAU,gBAAgB,CAAC,OAAwB;IACvD,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,OAAO;QACrC,OAAO,EAAE,IAAI,CAAC,GAAG,CACf,OAAO,CAAC,OAAO,IAAI,kBAAkB,EACrC,kBAAkB,CACnB;QACD,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,KAAK;QACvC,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAA0B;IACxD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAC9C,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/lib/fs-helpers/readers/stream-lines.d.ts

@@ -0,0 +1,7 @@
+export declare function readLinesIterator(filePath: string, options?: {
+    encoding?: BufferEncoding;
+}): AsyncGenerator<string, void, undefined>;
+export declare function headFileStreaming(filePath: string, count: number, encoding?: BufferEncoding): Promise<string[]>;
+export declare function tailFileStreaming(filePath: string, count: number, encoding?: BufferEncoding): Promise<string[]>;
+export declare function countLines(filePath: string): Promise<number>;
+//# sourceMappingURL=stream-lines.d.ts.map

package/dist/lib/fs-helpers/readers/stream-lines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-lines.d.ts","sourceRoot":"","sources":["../../../../src/lib/fs-helpers/readers/stream-lines.ts"],"names":[],"mappings":"AAKA,wBAAuB,iBAAiB,CACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,cAAc,CAAA;CAAE,GACtC,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAgBzC;AAED,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,cAAuB,GAChC,OAAO,CAAC,MAAM,EAAE,CAAC,CASnB;AAED,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,cAAuB,GAChC,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBnB;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOlE"}

package/dist/lib/fs-helpers/readers/stream-lines.js

@@ -0,0 +1,61 @@
+import { createReadStream } from 'node:fs';
+import { createInterface } from 'node:readline';
+import { validateExistingPath } from '../../path-validation.js';
+export async function* readLinesIterator(filePath, options) {
+    const validPath = await validateExistingPath(filePath);
+    const fileStream = createReadStream(validPath, options);
+    const rl = createInterface({
+        input: fileStream,
+        crlfDelay: Infinity,
+    });
+    try {
+        for await (const line of rl) {
+            yield line;
+        }
+    }
+    finally {
+        rl.close();
+        fileStream.destroy();
+    }
+}
+export async function headFileStreaming(filePath, count, encoding = 'utf8') {
+    if (count <= 0)
+        return [];
+    const lines = [];
+    for await (const line of readLinesIterator(filePath, { encoding })) {
+        lines.push(line);
+        if (lines.length >= count)
+            break;
+    }
+    return lines;
+}
+export async function tailFileStreaming(filePath, count, encoding = 'utf8') {
+    if (count <= 0)
+        return [];
+    const buffer = [];
+    let index = 0;
+    for await (const line of readLinesIterator(filePath, { encoding })) {
+        if (buffer.length < count) {
+            buffer.push(line);
+        }
+        else {
+            buffer[index % count] = line;
+            index++;
+        }
+    }
+    // Rotate buffer if we filled it and kept going
+    if (buffer.length === count && index > 0) {
+        const startIdx = index % count;
+        return [...buffer.slice(startIdx), ...buffer.slice(0, startIdx)];
+    }
+    return buffer;
+}
+export async function countLines(filePath) {
+    let count = 0;
+    for await (const line of readLinesIterator(filePath)) {
+        void line;
+        count++;
+    }
+    return count;
+}
+//# sourceMappingURL=stream-lines.js.map

package/dist/lib/fs-helpers/readers/stream-lines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-lines.js","sourceRoot":"","sources":["../../../../src/lib/fs-helpers/readers/stream-lines.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,iBAAiB,CACtC,QAAgB,EAChB,OAAuC;IAEvC,MAAM,SAAS,GAAG,MAAM,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACvD,MAAM,UAAU,GAAG,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACxD,MAAM,EAAE,GAAG,eAAe,CAAC;QACzB,KAAK,EAAE,UAAU;QACjB,SAAS,EAAE,QAAQ;KACpB,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,EAAE,EAAE,CAAC;YAC5B,MAAM,IAAI,CAAC;QACb,CAAC;IACH,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,UAAU,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAgB,EAChB,KAAa,EACb,WAA2B,MAAM;IAEjC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAE1B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,iBAAiB,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACnE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK;YAAE,MAAM;IACnC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAgB,EAChB,KAAa,EACb,WAA2B,MAAM;IAEjC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAE1B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,iBAAiB,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACnE,IAAI,MAAM,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC;YAC7B,KAAK,EAAE,CAAC;QACV,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,KAAK,GAAG,KAAK,CAAC;QAC/B,OAAO,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrD,KAAK,IAAI,CAAC;QACV,KAAK,EAAE,CAAC;IACV,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/lib/fs-helpers/readers/tail-file.d.ts

@@ -0,0 +1,3 @@
+import type * as fs from 'node:fs/promises';
+export declare function tailFile(handle: fs.FileHandle, fileSize: number, numLines: number, encoding?: BufferEncoding, maxBytesRead?: number, signal?: AbortSignal): Promise<string>;
+//# sourceMappingURL=tail-file.d.ts.map

package/dist/lib/fs-helpers/readers/tail-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tail-file.d.ts","sourceRoot":"","sources":["../../../../src/lib/fs-helpers/readers/tail-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AA4J5C,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,EAAE,CAAC,UAAU,EACrB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,cAAwB,EAClC,YAAY,CAAC,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAajB"}

package/dist/lib/fs-helpers/readers/tail-file.js

@@ -0,0 +1,94 @@
+import { assertNotAborted, withAbort } from '../abort.js';
+import { findUTF8Boundary } from './utf8.js';
+const CHUNK_SIZE = 256 * 1024;
+function initTailState(fileSize) {
+    return {
+        position: fileSize,
+        bytesReadTotal: 0,
+        remainingText: '',
+        linesFound: 0,
+        lines: [],
+    };
+}
+function clampWindow(position, maxBytesRead, bytesReadTotal) {
+    if (position <= 0)
+        return null;
+    let size = Math.min(CHUNK_SIZE, position);
+    let startPos = position - size;
+    if (maxBytesRead !== undefined) {
+        const remainingBytes = maxBytesRead - bytesReadTotal;
+        if (remainingBytes <= 0)
+            return null;
+        if (size > remainingBytes) {
+            size = remainingBytes;
+            startPos = position - size;
+        }
+    }
+    return { startPos, size };
+}
+async function readAlignedChunk(handle, aligned, encoding, signal) {
+    // Use allocUnsafe since we immediately overwrite with file data
+    const chunk = Buffer.allocUnsafe(aligned.size + 4);
+    const { bytesRead } = await withAbort(handle.read(chunk, 0, aligned.size, aligned.startPos), signal);
+    if (bytesRead === 0)
+        return null;
+    return {
+        data: chunk.subarray(0, bytesRead).toString(encoding),
+        bytesRead,
+    };
+}
+async function resolveAlignedWindow(handle, state, maxBytesRead, signal) {
+    const window = clampWindow(state.position, maxBytesRead, state.bytesReadTotal);
+    if (!window)
+        return null;
+    if (window.startPos <= 0)
+        return window;
+    const alignedPos = await findUTF8Boundary(handle, window.startPos, signal);
+    const alignedSize = state.position - alignedPos;
+    if (maxBytesRead === undefined ||
+        alignedSize <= maxBytesRead - state.bytesReadTotal) {
+        return { startPos: alignedPos, size: alignedSize };
+    }
+    return window;
+}
+function applyChunkLines(state, chunkText, numLines, hasMoreBefore) {
+    const chunkLines = chunkText.replace(/\r\n/g, '\n').split('\n');
+    state.remainingText = hasMoreBefore ? (chunkLines.shift() ?? '') : '';
+    for (let i = chunkLines.length - 1; i >= 0; i--) {
+        if (state.linesFound >= numLines)
+            break;
+        const line = chunkLines[i];
+        if (line !== undefined) {
+            state.lines.push(line);
+            state.linesFound++;
+        }
+    }
+}
+async function readTailLoop(handle, state, numLines, encoding, maxBytesRead, signal) {
+    while (state.position > 0 && state.linesFound < numLines) {
+        assertNotAborted(signal);
+        const aligned = await resolveAlignedWindow(handle, state, maxBytesRead, signal);
+        if (!aligned) {
+            state.position = 0;
+            break;
+        }
+        state.position = aligned.startPos;
+        const chunkResult = await readAlignedChunk(handle, aligned, encoding, signal);
+        if (!chunkResult) {
+            state.position = 0;
+            break;
+        }
+        state.bytesReadTotal += chunkResult.bytesRead;
+        applyChunkLines(state, chunkResult.data + state.remainingText, numLines, state.position > 0);
+    }
+    const reversed = [...state.lines].reverse();
+    return reversed.join('\n');
+}
+export async function tailFile(handle, fileSize, numLines, encoding = 'utf-8', maxBytesRead, signal) {
+    assertNotAborted(signal);
+    if (fileSize === 0)
+        return '';
+    const state = initTailState(fileSize);
+    return await readTailLoop(handle, state, numLines, encoding, maxBytesRead, signal);
+}
+//# sourceMappingURL=tail-file.js.map

package/dist/lib/fs-helpers/readers/tail-file.js.map

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

package/dist/lib/fs-helpers/readers/utf8.d.ts

@@ -0,0 +1,3 @@
+import type { FileHandle } from 'node:fs/promises';
+export declare function findUTF8Boundary(handle: FileHandle, position: number, signal?: AbortSignal): Promise<number>;
+//# sourceMappingURL=utf8.d.ts.map

package/dist/lib/fs-helpers/readers/utf8.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utf8.d.ts","sourceRoot":"","sources":["../../../../src/lib/fs-helpers/readers/utf8.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAInD,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAoBjB"}

package/dist/lib/fs-helpers/readers/utf8.js

@@ -0,0 +1,33 @@
+import { withAbort } from '../abort.js';
+export async function findUTF8Boundary(handle, position, signal) {
+    if (position <= 0)
+        return 0;
+    const backtrackSize = Math.min(4, position);
+    const startPos = position - backtrackSize;
+    const readResult = await readBacktrackBuffer(handle, backtrackSize, startPos, position, signal);
+    if (!readResult)
+        return position;
+    const boundary = scanForBoundary(readResult.buffer, readResult.bytesRead, startPos);
+    return boundary ?? position;
+}
+async function readBacktrackBuffer(handle, backtrackSize, startPos, position, signal) {
+    const buffer = Buffer.allocUnsafe(backtrackSize);
+    try {
+        const { bytesRead } = await withAbort(handle.read(buffer, 0, backtrackSize, startPos), signal);
+        return { buffer, bytesRead };
+    }
+    catch (error) {
+        console.error(`[findUTF8Boundary] Read error at position ${position}:`, error instanceof Error ? error.message : String(error));
+        return null;
+    }
+}
+function scanForBoundary(buffer, bytesRead, startPos) {
+    for (let i = bytesRead - 1; i >= 0; i--) {
+        const byte = buffer[i];
+        if (byte !== undefined && (byte & 0xc0) !== 0x80) {
+            return startPos + i;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=utf8.js.map

package/dist/lib/fs-helpers/readers/utf8.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utf8.js","sourceRoot":"","sources":["../../../../src/lib/fs-helpers/readers/utf8.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAkB,EAClB,QAAgB,EAChB,MAAoB;IAEpB,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAE5B,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;IAC1C,MAAM,UAAU,GAAG,MAAM,mBAAmB,CAC1C,MAAM,EACN,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,MAAM,CACP,CAAC;IACF,IAAI,CAAC,UAAU;QAAE,OAAO,QAAQ,CAAC;IAEjC,MAAM,QAAQ,GAAG,eAAe,CAC9B,UAAU,CAAC,MAAM,EACjB,UAAU,CAAC,SAAS,EACpB,QAAQ,CACT,CAAC;IACF,OAAO,QAAQ,IAAI,QAAQ,CAAC;AAC9B,CAAC;AAED,KAAK,UAAU,mBAAmB,CAChC,MAAkB,EAClB,aAAqB,EACrB,QAAgB,EAChB,QAAgB,EAChB,MAAoB;IAEpB,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IACjD,IAAI,CAAC;QACH,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,SAAS,CACnC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,aAAa,EAAE,QAAQ,CAAC,EAC/C,MAAM,CACP,CAAC;QACF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CACX,6CAA6C,QAAQ,GAAG,EACxD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CACtB,MAAc,EACd,SAAiB,EACjB,QAAgB;IAEhB,KAAK,IAAI,CAAC,GAAG,SAAS,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACjD,OAAO,QAAQ,GAAG,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lib/fs-helpers/readers.d.ts

@@ -0,0 +1,4 @@
+export { headFile } from './readers/head-file.js';
+export { readFile, readFileWithStats } from './readers/read-file.js';
+export { tailFile } from './readers/tail-file.js';
+//# sourceMappingURL=readers.d.ts.map

package/dist/lib/fs-helpers/readers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readers.d.ts","sourceRoot":"","sources":["../../../src/lib/fs-helpers/readers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/lib/fs-helpers/readers.js

@@ -0,0 +1,4 @@
+export { headFile } from './readers/head-file.js';
+export { readFile, readFileWithStats } from './readers/read-file.js';
+export { tailFile } from './readers/tail-file.js';
+//# sourceMappingURL=readers.js.map

package/dist/lib/fs-helpers/readers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readers.js","sourceRoot":"","sources":["../../../src/lib/fs-helpers/readers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/lib/fs-helpers.d.ts

@@ -0,0 +1,6 @@
+export { isProbablyBinary } from './fs-helpers/binary-detect.js';
+export { processInParallel } from './fs-helpers/concurrency.js';
+export { getFileType, isHidden } from './fs-helpers/fs-utils.js';
+export { readFile, readFileWithStats } from './fs-helpers/readers/read-file.js';
+export { createTimedAbortSignal } from './fs-helpers/abort.js';
+//# sourceMappingURL=fs-helpers.d.ts.map

package/dist/lib/fs-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-helpers.d.ts","sourceRoot":"","sources":["../../src/lib/fs-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/lib/fs-helpers.js

@@ -0,0 +1,6 @@
+export { isProbablyBinary } from './fs-helpers/binary-detect.js';
+export { processInParallel } from './fs-helpers/concurrency.js';
+export { getFileType, isHidden } from './fs-helpers/fs-utils.js';
+export { readFile, readFileWithStats } from './fs-helpers/readers/read-file.js';
+export { createTimedAbortSignal } from './fs-helpers/abort.js';
+//# sourceMappingURL=fs-helpers.js.map

package/dist/lib/fs-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-helpers.js","sourceRoot":"","sources":["../../src/lib/fs-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/lib/line-range.d.ts

@@ -0,0 +1,22 @@
+type LineRangeField = 'lineStart' | 'lineEnd';
+export interface LineRangeIssues {
+    missingPair?: {
+        missing: LineRangeField;
+        provided: LineRangeField;
+    };
+    invalidOrder?: {
+        start: number;
+        end: number;
+    };
+    multipleModes?: boolean;
+}
+export interface LineRangeOptions {
+    lineStart?: number;
+    lineEnd?: number;
+    head?: number;
+    tail?: number;
+}
+export declare function validateLineRange(options: LineRangeOptions): LineRangeIssues;
+export declare function assertLineRangeOptions(options: LineRangeOptions, pathLabel: string): void;
+export {};
+//# sourceMappingURL=line-range.d.ts.map

package/dist/lib/line-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-range.d.ts","sourceRoot":"","sources":["../../src/lib/line-range.ts"],"names":[],"mappings":"AAEA,KAAK,cAAc,GAAG,WAAW,GAAG,SAAS,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,cAAc,CAAA;KAAE,CAAC;IACpE,YAAY,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA+BD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CAyB5E;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,gBAAgB,EACzB,SAAS,EAAE,MAAM,GAChB,IAAI,CAyBN"}

package/dist/lib/line-range.js

@@ -0,0 +1,54 @@
+import { ErrorCode, McpError } from './errors.js';
+function getMissingPair(hasLineStart, hasLineEnd) {
+    if (hasLineStart === hasLineEnd)
+        return undefined;
+    return {
+        missing: hasLineStart ? 'lineEnd' : 'lineStart',
+        provided: hasLineStart ? 'lineStart' : 'lineEnd',
+    };
+}
+function getInvalidOrder(lineStart, lineEnd) {
+    if (lineStart === undefined || lineEnd === undefined)
+        return undefined;
+    if (lineEnd >= lineStart)
+        return undefined;
+    return { start: lineStart, end: lineEnd };
+}
+function hasMultipleModes(hasLineRange, hasHead, hasTail) {
+    const modes = Number(hasLineRange) + Number(hasHead) + Number(hasTail);
+    return modes > 1;
+}
+export function validateLineRange(options) {
+    const { lineStart, lineEnd, head, tail } = options;
+    const hasLineStart = lineStart !== undefined;
+    const hasLineEnd = lineEnd !== undefined;
+    const hasLineRange = hasLineStart || hasLineEnd;
+    const hasHead = head !== undefined;
+    const hasTail = tail !== undefined;
+    const issues = {};
+    const missingPair = getMissingPair(hasLineStart, hasLineEnd);
+    if (missingPair) {
+        issues.missingPair = missingPair;
+    }
+    const invalidOrder = getInvalidOrder(lineStart, lineEnd);
+    if (invalidOrder) {
+        issues.invalidOrder = invalidOrder;
+    }
+    if (hasMultipleModes(hasLineRange, hasHead, hasTail)) {
+        issues.multipleModes = true;
+    }
+    return issues;
+}
+export function assertLineRangeOptions(options, pathLabel) {
+    const issues = validateLineRange(options);
+    if (issues.missingPair) {
+        throw new McpError(ErrorCode.E_INVALID_INPUT, `Invalid lineRange: ${issues.missingPair.provided} requires ${issues.missingPair.missing} to also be specified`, pathLabel);
+    }
+    if (issues.invalidOrder) {
+        throw new McpError(ErrorCode.E_INVALID_INPUT, `Invalid lineRange: lineEnd (${issues.invalidOrder.end}) must be >= lineStart (${issues.invalidOrder.start})`, pathLabel);
+    }
+    if (issues.multipleModes) {
+        throw new McpError(ErrorCode.E_INVALID_INPUT, 'Cannot specify multiple of lineRange (lineStart + lineEnd), head, or tail simultaneously', pathLabel);
+    }
+}
+//# sourceMappingURL=line-range.js.map

package/dist/lib/line-range.js.map

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

package/dist/lib/merge-defined.d.ts

@@ -0,0 +1,2 @@
+export declare function mergeDefined<T extends object>(defaults: T, overrides: Partial<T>): T;
+//# sourceMappingURL=merge-defined.d.ts.map

package/dist/lib/merge-defined.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-defined.d.ts","sourceRoot":"","sources":["../../src/lib/merge-defined.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAC3C,QAAQ,EAAE,CAAC,EACX,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,GACpB,CAAC,CAQH"}

package/dist/lib/merge-defined.js

@@ -0,0 +1,8 @@
+export function mergeDefined(defaults, overrides) {
+    const entries = Object.entries(overrides).filter(([, value]) => value !== undefined);
+    return {
+        ...defaults,
+        ...Object.fromEntries(entries),
+    };
+}
+//# sourceMappingURL=merge-defined.js.map

package/dist/lib/merge-defined.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-defined.js","sourceRoot":"","sources":["../../src/lib/merge-defined.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAC1B,QAAW,EACX,SAAqB;IAErB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAC9C,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CACnC,CAAC;IACF,OAAO;QACL,GAAG,QAAQ;QACX,GAAI,MAAM,CAAC,WAAW,CAAC,OAAO,CAAgB;KAC/C,CAAC;AACJ,CAAC"}

package/dist/lib/observability/diagnostics.d.ts

@@ -0,0 +1,15 @@
+export interface OpsTraceContext {
+    op: string;
+    engine?: string;
+    tool?: string;
+    path?: string;
+    [key: string]: unknown;
+}
+export declare function shouldPublishOpsTrace(): boolean;
+export declare function publishOpsTraceStart(context: OpsTraceContext): void;
+export declare function publishOpsTraceEnd(context: OpsTraceContext): void;
+export declare function publishOpsTraceError(context: OpsTraceContext, error: unknown): void;
+export declare function withToolDiagnostics<T>(tool: string, run: () => Promise<T>, options?: {
+    path?: string;
+}): Promise<T>;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/lib/observability/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../src/lib/observability/diagnostics.ts"],"names":[],"mappings":"AA8BA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAuMD,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAEnE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAEjE;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,OAAO,GACb,IAAI,CAKN;AAED,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACrB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1B,OAAO,CAAC,CAAC,CAAC,CAkBZ"}