@j0hanz/fs-context-mcp 2.1.0 → 2.1.2

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

@@ -1,21 +0,0 @@
-import { MAX_TEXT_FILE_SIZE } from '../../constants.js';
-export function normalizeOptions(options) {
-    const normalized = {
-        encoding: options.encoding ?? 'utf-8',
-        maxSize: Math.min(options.maxSize ?? MAX_TEXT_FILE_SIZE, MAX_TEXT_FILE_SIZE),
-        skipBinary: options.skipBinary ?? false,
-    };
-    if (options.head !== undefined) {
-        normalized.head = options.head;
-    }
-    if (options.signal) {
-        normalized.signal = options.signal;
-    }
-    return normalized;
-}
-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

@@ -1 +0,0 @@
-{"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,MAAM,UAAU,GAAsB;QACpC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,OAAO;QACrC,OAAO,EAAE,IAAI,CAAC,GAAG,CACf,OAAO,CAAC,OAAO,IAAI,kBAAkB,EACrC,kBAAkB,CACnB;QACD,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,KAAK;KACxC,CAAC;IACF,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/B,UAAU,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IACjC,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,UAAU,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACrC,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,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

@@ -1,7 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,61 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,3 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,94 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,3 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,33 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,4 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,4 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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/line-range.d.ts

@@ -1,22 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,54 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,2 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,8 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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-helpers.d.ts

@@ -1,3 +0,0 @@
-export declare function resolveDiagnosticsOk(result: unknown): boolean | undefined;
-export declare function resolveDiagnosticsErrorMessage(error?: unknown): string | undefined;
-//# sourceMappingURL=diagnostics-helpers.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"diagnostics-helpers.d.ts","sourceRoot":"","sources":["../../../src/lib/observability/diagnostics-helpers.ts"],"names":[],"mappings":"AAQA,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CASzE;AA0BD,wBAAgB,8BAA8B,CAC5C,KAAK,CAAC,EAAE,OAAO,GACd,MAAM,GAAG,SAAS,CAMpB"}

package/dist/lib/observability/diagnostics-helpers.js

@@ -1,50 +0,0 @@
-function isObject(value) {
-    return typeof value === 'object' && value !== null;
-}
-function hasBooleanOk(value) {
-    return isObject(value) && typeof value.ok === 'boolean';
-}
-export function resolveDiagnosticsOk(result) {
-    if (!isObject(result))
-        return undefined;
-    if (result.isError === true)
-        return false;
-    if (hasBooleanOk(result))
-        return result.ok;
-    const structured = result.structuredContent;
-    if (hasBooleanOk(structured))
-        return structured.ok;
-    return undefined;
-}
-function resolvePrimitiveDiagnosticsMessage(error) {
-    if (typeof error === 'string')
-        return error;
-    if (typeof error === 'number' || typeof error === 'boolean') {
-        return String(error);
-    }
-    if (typeof error === 'bigint')
-        return error.toString();
-    if (typeof error === 'symbol')
-        return error.description ?? 'symbol';
-    return undefined;
-}
-function resolveObjectDiagnosticsMessage(error) {
-    if (error instanceof Error)
-        return error.message;
-    if (isObject(error) && typeof error.message === 'string') {
-        return error.message;
-    }
-    try {
-        return JSON.stringify(error);
-    }
-    catch {
-        return undefined;
-    }
-}
-export function resolveDiagnosticsErrorMessage(error) {
-    if (error === undefined || error === null)
-        return undefined;
-    return (resolvePrimitiveDiagnosticsMessage(error) ??
-        resolveObjectDiagnosticsMessage(error));
-}
-//# sourceMappingURL=diagnostics-helpers.js.map

package/dist/lib/observability/diagnostics-helpers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"diagnostics-helpers.js","sourceRoot":"","sources":["../../../src/lib/observability/diagnostics-helpers.ts"],"names":[],"mappings":"AAAA,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAe;IAClD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IACxC,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,YAAY,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC,EAAE,CAAC;IAE3C,MAAM,UAAU,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAC5C,IAAI,YAAY,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC,EAAE,CAAC;IAEnD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,kCAAkC,CACzC,KAAc;IAEd,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,WAAW,IAAI,QAAQ,CAAC;IACpE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,+BAA+B,CAAC,KAAc;IACrD,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC;IACjD,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzD,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,KAAe;IAEf,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5D,OAAO,CACL,kCAAkC,CAAC,KAAK,CAAC;QACzC,+BAA+B,CAAC,KAAK,CAAC,CACvC,CAAC;AACJ,CAAC"}

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

@@ -1,15 +0,0 @@
-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

@@ -1 +0,0 @@
-{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../src/lib/observability/diagnostics.ts"],"names":[],"mappings":"AAkCA,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;AAgKD,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"}

package/dist/lib/observability/diagnostics.js

@@ -1,142 +0,0 @@
-import { createHash } from 'node:crypto';
-import { channel, tracingChannel } from 'node:diagnostics_channel';
-import { resolveDiagnosticsErrorMessage, resolveDiagnosticsOk, } from './diagnostics-helpers.js';
-import { captureEventLoopUtilization, diffEventLoopUtilization, } from './perf.js';
-const TOOL_CHANNEL = channel('fs-context:tool');
-const PERF_CHANNEL = channel('fs-context:perf');
-const OPS_TRACE = tracingChannel('fs-context:ops');
-function parseDiagnosticsEnabled() {
-    const normalized = process.env.FS_CONTEXT_DIAGNOSTICS?.trim().toLowerCase();
-    return normalized === '1' || normalized === 'true' || normalized === 'yes';
-}
-function parseDiagnosticsDetail() {
-    const normalized = process.env.FS_CONTEXT_DIAGNOSTICS_DETAIL?.trim();
-    if (normalized === '2')
-        return 2;
-    if (normalized === '1')
-        return 1;
-    return 0;
-}
-function hashPath(value) {
-    return createHash('sha256').update(value).digest('hex').slice(0, 16);
-}
-function normalizePathForDiagnostics(path) {
-    const detail = parseDiagnosticsDetail();
-    if (detail === 0)
-        return undefined;
-    if (detail === 2)
-        return path;
-    return hashPath(path);
-}
-function normalizeOpsTraceContext(context) {
-    if (!context.path)
-        return context;
-    const normalizedPath = normalizePathForDiagnostics(context.path);
-    if (!normalizedPath) {
-        const sanitized = { ...context };
-        delete sanitized.path;
-        return sanitized;
-    }
-    return { ...context, path: normalizedPath };
-}
-function publishStartEvent(tool, options) {
-    const event = { phase: 'start', tool };
-    const normalizedPath = options?.path
-        ? normalizePathForDiagnostics(options.path)
-        : undefined;
-    if (normalizedPath !== undefined) {
-        event.path = normalizedPath;
-    }
-    TOOL_CHANNEL.publish(event);
-}
-function publishEndEvent(tool, ok, durationMs, error) {
-    const event = {
-        phase: 'end',
-        tool,
-        ok,
-        durationMs,
-    };
-    const message = resolveDiagnosticsErrorMessage(error);
-    if (message !== undefined) {
-        event.error = message;
-    }
-    TOOL_CHANNEL.publish(event);
-}
-function publishPerfEndEvent(tool, durationMs, elu) {
-    PERF_CHANNEL.publish({
-        phase: 'end',
-        tool,
-        durationMs,
-        elu: {
-            idle: elu.idle,
-            active: elu.active,
-            utilization: elu.utilization,
-        },
-    });
-}
-function startToolDiagnostics(tool, options, shouldPublishTool, shouldPublishPerf) {
-    const startNs = process.hrtime.bigint();
-    const eluStart = shouldPublishPerf
-        ? captureEventLoopUtilization()
-        : undefined;
-    if (shouldPublishTool)
-        publishStartEvent(tool, options);
-    return { startNs, eluStart };
-}
-function finalizeToolDiagnostics(tool, startNs, options) {
-    const endNs = process.hrtime.bigint();
-    const durationMs = Number(endNs - startNs) / 1_000_000;
-    if (options.shouldPublishPerf && options.eluStart) {
-        publishPerfEndEvent(tool, durationMs, diffEventLoopUtilization(options.eluStart));
-    }
-    if (options.shouldPublishTool) {
-        publishEndEvent(tool, options.ok, durationMs, options.error);
-    }
-}
-async function runWithDiagnostics(tool, run, options, shouldPublishTool, shouldPublishPerf) {
-    const { startNs, eluStart } = startToolDiagnostics(tool, options, shouldPublishTool, shouldPublishPerf);
-    const finalizeOptions = { shouldPublishTool, shouldPublishPerf, eluStart };
-    try {
-        const result = await run();
-        finalizeToolDiagnostics(tool, startNs, {
-            ok: resolveDiagnosticsOk(result) ?? true,
-            ...finalizeOptions,
-        });
-        return result;
-    }
-    catch (error) {
-        finalizeToolDiagnostics(tool, startNs, {
-            ok: false,
-            error,
-            ...finalizeOptions,
-        });
-        throw error;
-    }
-}
-export function shouldPublishOpsTrace() {
-    return parseDiagnosticsEnabled() && OPS_TRACE.hasSubscribers;
-}
-export function publishOpsTraceStart(context) {
-    OPS_TRACE.start.publish(normalizeOpsTraceContext(context));
-}
-export function publishOpsTraceEnd(context) {
-    OPS_TRACE.end.publish(normalizeOpsTraceContext(context));
-}
-export function publishOpsTraceError(context, error) {
-    OPS_TRACE.error.publish({
-        ...normalizeOpsTraceContext(context),
-        error,
-    });
-}
-export async function withToolDiagnostics(tool, run, options) {
-    if (!parseDiagnosticsEnabled()) {
-        return await run();
-    }
-    const shouldPublishTool = TOOL_CHANNEL.hasSubscribers;
-    const shouldPublishPerf = PERF_CHANNEL.hasSubscribers;
-    if (!shouldPublishTool && !shouldPublishPerf) {
-        return await run();
-    }
-    return await runWithDiagnostics(tool, run, options, shouldPublishTool, shouldPublishPerf);
-}
-//# sourceMappingURL=diagnostics.js.map

package/dist/lib/observability/diagnostics.js.map

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