@j0hanz/filesystem-context-mcp 1.1.0 → 1.2.0

package/dist/lib/file-operations/list-directory.js

@@ -0,0 +1,189 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { DEFAULT_MAX_DEPTH, DIR_TRAVERSAL_CONCURRENCY, PARALLEL_CONCURRENCY, } from '../constants.js';
+import { isHidden, processInParallel, runWorkQueue } from '../fs-helpers.js';
+import { validateExistingPath } from '../path-validation.js';
+import { sortByField } from './sorting.js';
+function initListState() {
+    return {
+        entries: [],
+        totalFiles: 0,
+        totalDirectories: 0,
+        maxDepthReached: 0,
+        truncated: false,
+        skippedInaccessible: 0,
+        symlinksNotFollowed: 0,
+    };
+}
+function buildEntryBase(item, fullPath, relativePath, type) {
+    return {
+        name: item.name,
+        path: fullPath,
+        relativePath,
+        type,
+    };
+}
+function resolveEntryType(item, stats) {
+    if (item.isDirectory())
+        return 'directory';
+    if (item.isFile())
+        return 'file';
+    return stats.isSymbolicLink() ? 'symlink' : 'other';
+}
+async function buildSymlinkResult(item, fullPath, relativePath, includeSymlinkTargets) {
+    const stats = await fs.lstat(fullPath);
+    let symlinkTarget;
+    if (includeSymlinkTargets) {
+        try {
+            symlinkTarget = await fs.readlink(fullPath);
+        }
+        catch {
+            symlinkTarget = undefined;
+        }
+    }
+    const entry = {
+        name: item.name,
+        path: fullPath,
+        relativePath,
+        type: 'symlink',
+        size: stats.size,
+        modified: stats.mtime,
+        symlinkTarget,
+    };
+    return { entry, symlinkNotFollowed: true };
+}
+async function buildEnqueueDir(fullPath, depth, maxDepth, recursive) {
+    if (!recursive || depth + 1 > maxDepth)
+        return undefined;
+    return {
+        currentPath: await validateExistingPath(fullPath),
+        depth: depth + 1,
+    };
+}
+async function buildRegularResult(item, fullPath, relativePath, options) {
+    const stats = await fs.stat(fullPath);
+    const type = resolveEntryType(item, stats);
+    const entry = {
+        ...buildEntryBase(item, fullPath, relativePath, type),
+        size: type === 'file' ? stats.size : undefined,
+        modified: stats.mtime,
+    };
+    const enqueueDir = await buildEnqueueDir(fullPath, options.depth, options.maxDepth, options.recursive);
+    return { entry, enqueueDir };
+}
+function buildFallbackEntry(item, fullPath, relativePath) {
+    const type = item.isDirectory()
+        ? 'directory'
+        : item.isFile()
+            ? 'file'
+            : 'other';
+    return {
+        entry: buildEntryBase(item, fullPath, relativePath, type),
+        skippedInaccessible: true,
+    };
+}
+async function buildDirectoryItemResult(item, currentPath, basePath, options) {
+    const fullPath = path.join(currentPath, item.name);
+    const relativePath = path.relative(basePath, fullPath) || item.name;
+    try {
+        if (item.isSymbolicLink()) {
+            return await buildSymlinkResult(item, fullPath, relativePath, options.includeSymlinkTargets);
+        }
+        return await buildRegularResult(item, fullPath, relativePath, {
+            ...options,
+            basePath,
+        });
+    }
+    catch {
+        return buildFallbackEntry(item, fullPath, relativePath);
+    }
+}
+function createStopChecker(maxEntries, state) {
+    return () => {
+        if (maxEntries !== undefined && state.entries.length >= maxEntries) {
+            state.truncated = true;
+            return true;
+        }
+        return false;
+    };
+}
+async function readVisibleItems(currentPath, includeHidden) {
+    try {
+        const items = await fs.readdir(currentPath, { withFileTypes: true });
+        return includeHidden ? items : items.filter((item) => !isHidden(item.name));
+    }
+    catch {
+        return null;
+    }
+}
+function applyDirectoryItemResult(result, state, enqueue) {
+    const { entry, enqueueDir, skippedInaccessible, symlinkNotFollowed } = result;
+    state.entries.push(entry);
+    if (entry.type === 'directory')
+        state.totalDirectories++;
+    if (entry.type === 'file')
+        state.totalFiles++;
+    if (enqueueDir)
+        enqueue(enqueueDir);
+    if (skippedInaccessible)
+        state.skippedInaccessible++;
+    if (symlinkNotFollowed)
+        state.symlinksNotFollowed++;
+}
+function processResults(results, state, enqueue, shouldStop) {
+    for (const result of results) {
+        if (shouldStop())
+            break;
+        applyDirectoryItemResult(result, state, enqueue);
+    }
+}
+async function handleDirectory(params, enqueue, config, state, shouldStop) {
+    if (params.depth > config.maxDepth)
+        return;
+    if (shouldStop())
+        return;
+    state.maxDepthReached = Math.max(state.maxDepthReached, params.depth);
+    const items = await readVisibleItems(params.currentPath, config.includeHidden);
+    if (!items) {
+        state.skippedInaccessible++;
+        return;
+    }
+    const { results, errors } = await processInParallel(items, async (item) => buildDirectoryItemResult(item, params.currentPath, config.basePath, {
+        includeSymlinkTargets: config.includeSymlinkTargets,
+        recursive: config.recursive,
+        depth: params.depth,
+        maxDepth: config.maxDepth,
+    }), PARALLEL_CONCURRENCY);
+    state.skippedInaccessible += errors.length;
+    processResults(results, state, enqueue, shouldStop);
+}
+export async function listDirectory(dirPath, options = {}) {
+    const { recursive = false, includeHidden = false, maxDepth = DEFAULT_MAX_DEPTH, maxEntries, sortBy = 'name', includeSymlinkTargets = false, } = options;
+    const basePath = await validateExistingPath(dirPath);
+    const state = initListState();
+    const shouldStop = createStopChecker(maxEntries, state);
+    const config = {
+        basePath,
+        recursive,
+        includeHidden,
+        maxDepth,
+        maxEntries,
+        includeSymlinkTargets,
+    };
+    await runWorkQueue([{ currentPath: basePath, depth: 0 }], async (params, enqueue) => handleDirectory(params, enqueue, config, state, shouldStop), DIR_TRAVERSAL_CONCURRENCY);
+    sortByField(state.entries, sortBy);
+    return {
+        path: basePath,
+        entries: state.entries,
+        summary: {
+            totalEntries: state.entries.length,
+            totalFiles: state.totalFiles,
+            totalDirectories: state.totalDirectories,
+            maxDepthReached: state.maxDepthReached,
+            truncated: state.truncated,
+            skippedInaccessible: state.skippedInaccessible,
+            symlinksNotFollowed: state.symlinksNotFollowed,
+        },
+    };
+}
+//# sourceMappingURL=list-directory.js.map

package/dist/lib/file-operations/list-directory.js.map

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

package/dist/lib/file-operations/read-media-file.d.ts

@@ -0,0 +1,5 @@
+import type { MediaFileResult } from '../../config/types.js';
+export declare function readMediaFile(filePath: string, { maxSize }?: {
+    maxSize?: number;
+}): Promise<MediaFileResult>;
+//# sourceMappingURL=read-media-file.d.ts.map

package/dist/lib/file-operations/read-media-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-media-file.d.ts","sourceRoot":"","sources":["../../../src/lib/file-operations/read-media-file.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAwB7D,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,EAAE,OAA6B,EAAE,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAC3D,OAAO,CAAC,eAAe,CAAC,CAiB1B"}

package/dist/lib/file-operations/read-media-file.js

@@ -0,0 +1,31 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { getMimeType, MAX_MEDIA_FILE_SIZE } from '../constants.js';
+import { ErrorCode, McpError } from '../errors.js';
+import { validateExistingPath } from '../path-validation.js';
+function assertFile(stats, filePath) {
+    if (stats.isFile())
+        return;
+    throw new McpError(ErrorCode.E_NOT_FILE, `Not a file: ${filePath}`, filePath);
+}
+function assertSizeWithinLimit(size, maxSize, filePath) {
+    if (size <= maxSize)
+        return;
+    throw new McpError(ErrorCode.E_TOO_LARGE, `File too large: ${size} bytes (max: ${maxSize} bytes)`, filePath, { size, maxSize });
+}
+export async function readMediaFile(filePath, { maxSize = MAX_MEDIA_FILE_SIZE } = {}) {
+    const validPath = await validateExistingPath(filePath);
+    const stats = await fs.stat(validPath);
+    assertFile(stats, filePath);
+    assertSizeWithinLimit(stats.size, maxSize, filePath);
+    const ext = path.extname(validPath).toLowerCase();
+    const mimeType = getMimeType(ext);
+    const buffer = await fs.readFile(validPath);
+    return {
+        path: validPath,
+        mimeType,
+        size: stats.size,
+        data: buffer.toString('base64'),
+    };
+}
+//# sourceMappingURL=read-media-file.js.map

package/dist/lib/file-operations/read-media-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-media-file.js","sourceRoot":"","sources":["../../../src/lib/file-operations/read-media-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAIlC,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,SAAS,UAAU,CAAC,KAAY,EAAE,QAAgB;IAChD,IAAI,KAAK,CAAC,MAAM,EAAE;QAAE,OAAO;IAC3B,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,UAAU,EAAE,eAAe,QAAQ,EAAE,EAAE,QAAQ,CAAC,CAAC;AAChF,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,SAAS,EACvD,QAAQ,EACR,EAAE,IAAI,EAAE,OAAO,EAAE,CAClB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAgB,EAChB,EAAE,OAAO,GAAG,mBAAmB,KAA2B,EAAE;IAE5D,MAAM,SAAS,GAAG,MAAM,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEvC,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC5B,qBAAqB,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAErD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;IAClD,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAE5C,OAAO;QACL,IAAI,EAAE,SAAS;QACf,QAAQ;QACR,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;KAChC,CAAC;AACJ,CAAC"}

package/dist/lib/file-operations/read-multiple-files.d.ts

@@ -0,0 +1,16 @@
+interface ReadMultipleResult {
+    path: string;
+    content?: string;
+    truncated?: boolean;
+    totalLines?: number;
+    error?: string;
+}
+export declare function readMultipleFiles(filePaths: string[], options?: {
+    encoding?: BufferEncoding;
+    maxSize?: number;
+    maxTotalSize?: number;
+    head?: number;
+    tail?: number;
+}): Promise<ReadMultipleResult[]>;
+export {};
+//# sourceMappingURL=read-multiple-files.d.ts.map

package/dist/lib/file-operations/read-multiple-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-multiple-files.d.ts","sourceRoot":"","sources":["../../../src/lib/file-operations/read-multiple-files.ts"],"names":[],"mappings":"AAOA,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA8FD,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACV,GACL,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAwD/B"}

package/dist/lib/file-operations/read-multiple-files.js

@@ -0,0 +1,98 @@
+import * as fs from 'node:fs/promises';
+import { MAX_TEXT_FILE_SIZE, PARALLEL_CONCURRENCY } from '../constants.js';
+import { ErrorCode, McpError } from '../errors.js';
+import { processInParallel, readFile } from '../fs-helpers.js';
+import { validateExistingPath } from '../path-validation.js';
+function assertHeadTailOptions(head, tail) {
+    if (head === undefined || tail === undefined)
+        return;
+    throw new McpError(ErrorCode.E_INVALID_INPUT, 'Cannot specify both head and tail simultaneously', undefined);
+}
+function createOutputSkeleton(filePaths) {
+    return filePaths.map((filePath) => ({ path: filePath }));
+}
+async function collectFileBudget(filePaths, isPartialRead, maxTotalSize, maxSize) {
+    const skippedBudget = new Set();
+    let totalSize = 0;
+    for (const filePath of filePaths) {
+        try {
+            const validPath = await validateExistingPath(filePath);
+            const stats = await fs.stat(validPath);
+            const estimatedSize = isPartialRead
+                ? Math.min(stats.size, maxSize)
+                : stats.size;
+            if (totalSize + estimatedSize > maxTotalSize) {
+                skippedBudget.add(filePath);
+                continue;
+            }
+            totalSize += estimatedSize;
+        }
+        catch {
+            // Ignore per-file size errors; handled during read.
+        }
+    }
+    return { skippedBudget };
+}
+function buildProcessTargets(filePaths, skippedBudget) {
+    return filePaths
+        .map((filePath, index) => ({ filePath, index }))
+        .filter(({ filePath }) => !skippedBudget.has(filePath));
+}
+function applyParallelResults(output, results, errors, filePaths) {
+    for (const result of results) {
+        output[result.index] = result.value;
+    }
+    for (const failure of errors) {
+        const filePath = filePaths[failure.index] ?? '(unknown)';
+        output[failure.index] = {
+            path: filePath,
+            error: failure.error.message,
+        };
+    }
+}
+function applySkippedBudgetErrors(output, skippedBudget, filePaths, maxTotalSize) {
+    for (const filePath of skippedBudget) {
+        const index = filePaths.indexOf(filePath);
+        if (index === -1)
+            continue;
+        output[index] = {
+            path: filePath,
+            error: `Skipped: combined estimated read would exceed maxTotalSize (${maxTotalSize} bytes)`,
+        };
+    }
+}
+export async function readMultipleFiles(filePaths, options = {}) {
+    if (filePaths.length === 0)
+        return [];
+    const { encoding = 'utf-8', maxSize = MAX_TEXT_FILE_SIZE, maxTotalSize = 100 * 1024 * 1024, head, tail, } = options;
+    assertHeadTailOptions(head, tail);
+    const output = createOutputSkeleton(filePaths);
+    const isPartialRead = head !== undefined || tail !== undefined;
+    const { skippedBudget } = await collectFileBudget(filePaths, isPartialRead, maxTotalSize, maxSize);
+    const filesToProcess = buildProcessTargets(filePaths, skippedBudget);
+    const { results, errors } = await processInParallel(filesToProcess, async ({ filePath, index }) => {
+        const result = await readFile(filePath, {
+            encoding,
+            maxSize,
+            head,
+            tail,
+        });
+        return {
+            index,
+            value: {
+                path: result.path,
+                content: result.content,
+                truncated: result.truncated,
+                totalLines: result.totalLines,
+            },
+        };
+    }, PARALLEL_CONCURRENCY);
+    const mappedErrors = errors.map((failure) => ({
+        index: filesToProcess[failure.index]?.index ?? failure.index,
+        error: failure.error,
+    }));
+    applyParallelResults(output, results, mappedErrors, filePaths);
+    applySkippedBudgetErrors(output, skippedBudget, filePaths, maxTotalSize);
+    return output;
+}
+//# sourceMappingURL=read-multiple-files.js.map

package/dist/lib/file-operations/read-multiple-files.js.map

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

package/dist/lib/file-operations/search-content.d.ts

@@ -0,0 +1,16 @@
+import type { SearchContentResult } from '../../config/types.js';
+export declare function searchContent(basePath: string, searchPattern: string, options?: {
+    filePattern?: string;
+    excludePatterns?: string[];
+    caseSensitive?: boolean;
+    maxResults?: number;
+    maxFileSize?: number;
+    maxFilesScanned?: number;
+    timeoutMs?: number;
+    skipBinary?: boolean;
+    contextLines?: number;
+    wholeWord?: boolean;
+    isLiteral?: boolean;
+    includeHidden?: boolean;
+}): Promise<SearchContentResult>;
+//# sourceMappingURL=search-content.d.ts.map

package/dist/lib/file-operations/search-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-content.d.ts","sourceRoot":"","sources":["../../../src/lib/file-operations/search-content.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAgB,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAqnB/E,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;CACpB,GACL,OAAO,CAAC,mBAAmB,CAAC,CAyE9B"}