@j0hanz/filesystem-context-mcp 1.1.0 → 1.2.0

package/dist/lib/file-operations.js

@@ -1,774 +1,10 @@
-import * as fs from 'node:fs/promises';
-import * as path from 'node:path';
-import fg from 'fast-glob';
-import { Minimatch } from 'minimatch';
-import safeRegex from 'safe-regex2';
-import { DEFAULT_MAX_DEPTH, DEFAULT_MAX_RESULTS, DEFAULT_TOP_N, DIR_TRAVERSAL_CONCURRENCY, getMimeType, MAX_MEDIA_FILE_SIZE, MAX_SEARCHABLE_FILE_SIZE, MAX_TEXT_FILE_SIZE, PARALLEL_CONCURRENCY, } from './constants.js';
-import { ErrorCode, McpError } from './errors.js';
-import { getFileType, isHidden, isProbablyBinary, processInParallel, readFile, runWorkQueue, } from './fs-helpers.js';
-import { parseImageDimensions } from './image-parsing.js';
-import { validateExistingPath, validateExistingPathDetailed, } from './path-validation.js';
-import { isSimpleSafePattern, prepareSearchPattern, scanFileForContent, } from './search-helpers.js';
-function createExcludeMatcher(excludePatterns) {
-    if (excludePatterns.length === 0) {
-        return () => false;
-    }
-    const matchers = excludePatterns.map((pattern) => new Minimatch(pattern));
-    return (name, relativePath) => matchers.some((m) => m.match(name) || m.match(relativePath));
-}
-function classifyAccessError(error) {
-    if (error instanceof McpError &&
-        (error.code === ErrorCode.E_ACCESS_DENIED ||
-            error.code === ErrorCode.E_SYMLINK_NOT_ALLOWED)) {
-        return 'symlink';
-    }
-    return 'inaccessible';
-}
-function insertSorted(arr, item, compare, maxLen) {
-    if (maxLen <= 0)
-        return;
-    const idx = arr.findIndex((el) => compare(item, el) < 0);
-    if (idx === -1) {
-        if (arr.length < maxLen)
-            arr.push(item);
-    }
-    else {
-        arr.splice(idx, 0, item);
-        if (arr.length > maxLen)
-            arr.pop();
-    }
-}
-const SORT_COMPARATORS = {
-    size: (a, b) => (b.size ?? 0) - (a.size ?? 0),
-    modified: (a, b) => (b.modified?.getTime() ?? 0) - (a.modified?.getTime() ?? 0),
-    type: (a, b) => {
-        if (a.type !== b.type)
-            return a.type === 'directory' ? -1 : 1;
-        return (a.name ?? '').localeCompare(b.name ?? '');
-    },
-    path: (a, b) => (a.path ?? '').localeCompare(b.path ?? ''),
-    name: (a, b) => (a.name ?? '').localeCompare(b.name ?? ''),
-};
-function sortByField(items, sortBy) {
-    const comparator = SORT_COMPARATORS[sortBy];
-    items.sort(comparator);
-}
-function sortSearchResults(results, sortBy) {
-    if (sortBy === 'name') {
-        results.sort((a, b) => path.basename(a.path ?? '').localeCompare(path.basename(b.path ?? '')));
-    }
-    else {
-        sortByField(results, sortBy);
-    }
-}
-function getPermissions(mode) {
-    const PERM_STRINGS = [
-        '---',
-        '--x',
-        '-w-',
-        '-wx',
-        'r--',
-        'r-x',
-        'rw-',
-        'rwx',
-    ];
-    const ownerIndex = (mode >> 6) & 0b111;
-    const groupIndex = (mode >> 3) & 0b111;
-    const otherIndex = mode & 0b111;
-    const owner = PERM_STRINGS[ownerIndex] ?? '---';
-    const group = PERM_STRINGS[groupIndex] ?? '---';
-    const other = PERM_STRINGS[otherIndex] ?? '---';
-    return `${owner}${group}${other}`;
-}
-export async function getFileInfo(filePath) {
-    const { requestedPath, resolvedPath, isSymlink } = await validateExistingPathDetailed(filePath);
-    const name = path.basename(requestedPath);
-    const ext = path.extname(name).toLowerCase();
-    const mimeType = ext ? getMimeType(ext) : undefined;
-    let symlinkTarget;
-    if (isSymlink) {
-        try {
-            symlinkTarget = await fs.readlink(requestedPath);
-        }
-        catch {
-            // Symlink target unreadable
-        }
-    }
-    const stats = await fs.stat(resolvedPath);
-    return {
-        name,
-        path: requestedPath,
-        type: isSymlink ? 'symlink' : getFileType(stats),
-        size: stats.size,
-        created: stats.birthtime,
-        modified: stats.mtime,
-        accessed: stats.atime,
-        permissions: getPermissions(stats.mode),
-        isHidden: isHidden(name),
-        mimeType,
-        symlinkTarget,
-    };
-}
-export async function listDirectory(dirPath, options = {}) {
-    const { recursive = false, includeHidden = false, maxDepth = DEFAULT_MAX_DEPTH, maxEntries, sortBy = 'name', includeSymlinkTargets = false, } = options;
-    const validPath = await validateExistingPath(dirPath);
-    const entries = [];
-    let totalFiles = 0;
-    let totalDirectories = 0;
-    let maxDepthReached = 0;
-    let truncated = false;
-    let skippedInaccessible = 0;
-    let symlinksNotFollowed = 0;
-    const stopIfNeeded = () => {
-        if (maxEntries !== undefined && entries.length >= maxEntries) {
-            truncated = true;
-            return true;
-        }
-        return false;
-    };
-    await runWorkQueue([{ currentPath: validPath, depth: 0 }], async ({ currentPath, depth }, enqueue) => {
-        if (depth > maxDepth)
-            return;
-        if (stopIfNeeded())
-            return;
-        maxDepthReached = Math.max(maxDepthReached, depth);
-        let items;
-        try {
-            items = await fs.readdir(currentPath, { withFileTypes: true });
-        }
-        catch {
-            skippedInaccessible++;
-            return;
-        }
-        const visibleItems = includeHidden
-            ? items
-            : items.filter((item) => !isHidden(item.name));
-        const { results: processedEntries, errors: processingErrors } = await processInParallel(visibleItems, async (item) => {
-            const fullPath = path.join(currentPath, item.name);
-            const relativePath = path.relative(validPath, fullPath) || item.name;
-            try {
-                if (item.isSymbolicLink()) {
-                    symlinksNotFollowed++;
-                    const stats = await fs.lstat(fullPath);
-                    let symlinkTarget;
-                    if (includeSymlinkTargets) {
-                        try {
-                            symlinkTarget = await fs.readlink(fullPath);
-                        }
-                        catch {
-                            // Symlink target unreadable
-                        }
-                    }
-                    const entry = {
-                        name: item.name,
-                        path: fullPath,
-                        relativePath,
-                        type: 'symlink',
-                        size: stats.size,
-                        modified: stats.mtime,
-                        symlinkTarget,
-                    };
-                    return { entry };
-                }
-                const stats = await fs.stat(fullPath);
-                const isDir = item.isDirectory();
-                const type = isDir
-                    ? 'directory'
-                    : item.isFile()
-                        ? 'file'
-                        : getFileType(stats);
-                const entry = {
-                    name: item.name,
-                    path: fullPath,
-                    relativePath,
-                    type,
-                    size: type === 'file' ? stats.size : undefined,
-                    modified: stats.mtime,
-                };
-                const enqueueDir = recursive && isDir && depth + 1 <= maxDepth
-                    ? {
-                        currentPath: await validateExistingPath(fullPath),
-                        depth: depth + 1,
-                    }
-                    : undefined;
-                return { entry, enqueueDir };
-            }
-            catch {
-                skippedInaccessible++;
-                const entry = {
-                    name: item.name,
-                    path: fullPath,
-                    relativePath,
-                    type: item.isDirectory()
-                        ? 'directory'
-                        : item.isFile()
-                            ? 'file'
-                            : 'other',
-                };
-                return { entry };
-            }
-        });
-        skippedInaccessible += processingErrors.length;
-        for (const { entry, enqueueDir } of processedEntries) {
-            if (stopIfNeeded())
-                break;
-            entries.push(entry);
-            if (entry.type === 'directory')
-                totalDirectories++;
-            if (entry.type === 'file')
-                totalFiles++;
-            if (enqueueDir)
-                enqueue(enqueueDir);
-        }
-    }, DIR_TRAVERSAL_CONCURRENCY);
-    sortByField(entries, sortBy);
-    return {
-        path: validPath,
-        entries,
-        summary: {
-            totalEntries: entries.length,
-            totalFiles,
-            totalDirectories,
-            maxDepthReached,
-            truncated,
-            skippedInaccessible,
-            symlinksNotFollowed,
-        },
-    };
-}
-export async function searchFiles(basePath, pattern, excludePatterns = [], options = {}) {
-    const validPath = await validateExistingPath(basePath);
-    const { maxResults, sortBy = 'path', maxDepth } = options;
-    const results = [];
-    let skippedInaccessible = 0;
-    let truncated = false;
-    let filesScanned = 0;
-    const batch = [];
-    const flushBatch = async () => {
-        if (batch.length === 0)
-            return;
-        const toProcess = batch.splice(0, batch.length);
-        const settled = await Promise.allSettled(toProcess.map(async (match) => {
-            const stats = await fs.stat(match);
-            const { size, mtime: modified } = stats;
-            return {
-                path: match,
-                type: getFileType(stats),
-                size: stats.isFile() ? size : undefined,
-                modified,
-            };
-        }));
-        for (const r of settled) {
-            if (r.status === 'fulfilled') {
-                if (maxResults !== undefined && results.length >= maxResults) {
-                    truncated = true;
-                    break;
-                }
-                results.push(r.value);
-            }
-            else {
-                skippedInaccessible++;
-            }
-        }
-    };
-    const stream = fg.stream(pattern, {
-        cwd: validPath,
-        absolute: true,
-        onlyFiles: false,
-        dot: true,
-        ignore: excludePatterns,
-        suppressErrors: true,
-        followSymbolicLinks: false,
-        deep: maxDepth,
-    });
-    for await (const entry of stream) {
-        const matchPath = typeof entry === 'string' ? entry : String(entry);
-        filesScanned++;
-        if (maxResults !== undefined && results.length >= maxResults) {
-            truncated = true;
-            break;
-        }
-        batch.push(matchPath);
-        if (batch.length >= PARALLEL_CONCURRENCY) {
-            await flushBatch();
-            if (maxResults !== undefined && results.length >= maxResults) {
-                truncated = true;
-                break;
-            }
-        }
-    }
-    await flushBatch();
-    sortSearchResults(results, sortBy);
-    return {
-        basePath: validPath,
-        pattern,
-        results,
-        summary: {
-            matched: results.length,
-            truncated,
-            skippedInaccessible,
-            filesScanned,
-        },
-    };
-}
-export { readFile };
-export async function readMultipleFiles(filePaths, options = {}) {
-    const { encoding = 'utf-8', maxSize = MAX_TEXT_FILE_SIZE, maxTotalSize = 100 * 1024 * 1024, head, tail, } = options;
-    if (filePaths.length === 0)
-        return [];
-    const output = filePaths.map((filePath) => ({ path: filePath }));
-    let totalSize = 0;
-    const fileSizes = new Map();
-    for (const filePath of filePaths) {
-        try {
-            const validPath = await validateExistingPath(filePath);
-            const stats = await fs.stat(validPath);
-            fileSizes.set(filePath, stats.size);
-            totalSize += stats.size;
-        }
-        catch {
-            fileSizes.set(filePath, 0);
-        }
-    }
-    if (totalSize > maxTotalSize) {
-        throw new McpError(ErrorCode.E_TOO_LARGE, `Total size of all files (${totalSize} bytes) exceeds limit (${maxTotalSize} bytes)`, undefined, { totalSize, maxTotalSize, fileCount: filePaths.length });
-    }
-    const { results, errors } = await processInParallel(filePaths.map((filePath, index) => ({ filePath, index })), async ({ filePath, index }) => {
-        const result = await readFile(filePath, {
-            encoding,
-            maxSize,
-            head,
-            tail,
-        });
-        return {
-            index,
-            value: { path: result.path, content: result.content },
-        };
-    }, PARALLEL_CONCURRENCY);
-    for (const r of results) {
-        output[r.index] = r.value;
-    }
-    for (const e of errors) {
-        const filePath = filePaths[e.index] ?? '(unknown)';
-        output[e.index] = {
-            path: filePath,
-            error: e.error.message,
-        };
-    }
-    return output;
-}
-export async function searchContent(basePath, searchPattern, options = {}) {
-    const { filePattern = '**/*', excludePatterns = [], caseSensitive = false, maxResults = DEFAULT_MAX_RESULTS, maxFileSize = MAX_SEARCHABLE_FILE_SIZE, maxFilesScanned, timeoutMs, skipBinary = true, contextLines = 0, wholeWord = false, isLiteral = false, } = options;
-    const validPath = await validateExistingPath(basePath);
-    const deadlineMs = timeoutMs !== undefined ? Date.now() + timeoutMs : undefined;
-    // Prepare the search pattern with optional literal escaping and word boundaries
-    const finalPattern = prepareSearchPattern(searchPattern, {
-        isLiteral,
-        wholeWord,
-    });
-    const needsReDoSCheck = !isLiteral && !isSimpleSafePattern(finalPattern);
-    if (needsReDoSCheck && !safeRegex(finalPattern)) {
-        throw new McpError(ErrorCode.E_INVALID_PATTERN, `Potentially unsafe regular expression (ReDoS risk): ${searchPattern}. ` +
-            'Avoid patterns with nested quantifiers, overlapping alternations, or exponential backtracking.', basePath, { reason: 'ReDoS risk detected' });
-    }
-    let regex;
-    try {
-        regex = new RegExp(finalPattern, caseSensitive ? 'g' : 'gi');
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        throw new McpError(ErrorCode.E_INVALID_PATTERN, `Invalid regular expression: ${finalPattern} (${message})`, basePath, { searchPattern: finalPattern });
-    }
-    const matches = [];
-    let filesScanned = 0;
-    let filesMatched = 0;
-    let skippedTooLarge = 0;
-    let skippedBinary = 0;
-    let skippedInaccessible = 0;
-    let linesSkippedDueToRegexTimeout = 0;
-    let truncated = false;
-    let stoppedReason;
-    let firstPathValidated = false;
-    const stopNow = (reason) => {
-        truncated = true;
-        stoppedReason = reason;
-        return true;
-    };
-    const stream = fg.stream(filePattern, {
-        cwd: validPath,
-        absolute: true,
-        onlyFiles: true,
-        dot: false,
-        ignore: excludePatterns,
-        suppressErrors: true,
-        followSymbolicLinks: false,
-    });
-    try {
-        for await (const entry of stream) {
-            const file = typeof entry === 'string' ? entry : String(entry);
-            if (!firstPathValidated) {
-                try {
-                    await validateExistingPath(file);
-                    firstPathValidated = true;
-                }
-                catch {
-                    console.error('[SECURITY] fast-glob returned invalid path:', file);
-                    stopNow('maxFiles');
-                    break;
-                }
-            }
-            if (deadlineMs !== undefined && Date.now() > deadlineMs) {
-                stopNow('timeout');
-                break;
-            }
-            if (maxFilesScanned !== undefined && filesScanned >= maxFilesScanned) {
-                stopNow('maxFiles');
-                break;
-            }
-            if (matches.length >= maxResults) {
-                stopNow('maxResults');
-                break;
-            }
-            try {
-                const handle = await fs.open(file, 'r');
-                let shouldScan = true;
-                try {
-                    const stats = await handle.stat();
-                    filesScanned++;
-                    if (stats.size > maxFileSize) {
-                        skippedTooLarge++;
-                        shouldScan = false;
-                    }
-                    else if (skipBinary) {
-                        const binary = await isProbablyBinary(file, handle);
-                        if (binary) {
-                            skippedBinary++;
-                            shouldScan = false;
-                        }
-                    }
-                }
-                finally {
-                    await handle.close().catch(() => { });
-                }
-                if (!shouldScan)
-                    continue;
-                const scanResult = await scanFileForContent(file, regex, {
-                    maxResults,
-                    contextLines,
-                    deadlineMs,
-                    currentMatchCount: matches.length,
-                    isLiteral,
-                    searchString: isLiteral ? searchPattern : undefined,
-                    caseSensitive,
-                });
-                matches.push(...scanResult.matches);
-                linesSkippedDueToRegexTimeout +=
-                    scanResult.linesSkippedDueToRegexTimeout;
-                if (scanResult.fileHadMatches)
-                    filesMatched++;
-                if (deadlineMs !== undefined && Date.now() > deadlineMs) {
-                    stopNow('timeout');
-                    break;
-                }
-                if (matches.length >= maxResults) {
-                    stopNow('maxResults');
-                    break;
-                }
-                if (stoppedReason !== undefined)
-                    break;
-            }
-            catch {
-                skippedInaccessible++;
-            }
-        }
-    }
-    finally {
-        // Ensure the stream is closed
-    }
-    return {
-        basePath: validPath,
-        pattern: searchPattern,
-        filePattern,
-        matches,
-        summary: {
-            filesScanned,
-            filesMatched,
-            matches: matches.length,
-            truncated,
-            skippedTooLarge,
-            skippedBinary,
-            skippedInaccessible,
-            linesSkippedDueToRegexTimeout,
-            stoppedReason,
-        },
-    };
-}
-export async function analyzeDirectory(dirPath, options = {}) {
-    const { maxDepth = DEFAULT_MAX_DEPTH, topN = DEFAULT_TOP_N, excludePatterns = [], includeHidden = false, } = options;
-    const validPath = await validateExistingPath(dirPath);
-    let totalFiles = 0;
-    let totalDirectories = 0;
-    let totalSize = 0;
-    let currentMaxDepth = 0;
-    let skippedInaccessible = 0;
-    let symlinksNotFollowed = 0;
-    const fileTypes = {};
-    const largestFiles = [];
-    const recentlyModified = [];
-    const shouldExclude = createExcludeMatcher(excludePatterns);
-    await runWorkQueue([{ currentPath: validPath, depth: 0 }], async ({ currentPath, depth }, enqueue) => {
-        if (depth > maxDepth)
-            return;
-        currentMaxDepth = Math.max(currentMaxDepth, depth);
-        let items;
-        try {
-            items = await fs.readdir(currentPath, { withFileTypes: true });
-        }
-        catch {
-            skippedInaccessible++;
-            return;
-        }
-        for (const item of items) {
-            const fullPath = path.join(currentPath, item.name);
-            const relativePath = path.relative(validPath, fullPath);
-            if (!includeHidden && isHidden(item.name)) {
-                continue;
-            }
-            if (shouldExclude(item.name, relativePath)) {
-                continue;
-            }
-            try {
-                const validated = await validateExistingPathDetailed(fullPath);
-                if (validated.isSymlink || item.isSymbolicLink()) {
-                    symlinksNotFollowed++;
-                    continue;
-                }
-                const stats = await fs.stat(validated.resolvedPath);
-                if (stats.isDirectory()) {
-                    totalDirectories++;
-                    if (depth + 1 <= maxDepth) {
-                        enqueue({
-                            currentPath: validated.resolvedPath,
-                            depth: depth + 1,
-                        });
-                    }
-                }
-                else if (stats.isFile()) {
-                    totalFiles++;
-                    totalSize += stats.size;
-                    const ext = path.extname(item.name).toLowerCase() || '(no extension)';
-                    fileTypes[ext] = (fileTypes[ext] ?? 0) + 1;
-                    insertSorted(largestFiles, { path: validated.resolvedPath, size: stats.size }, (a, b) => b.size - a.size, topN);
-                    insertSorted(recentlyModified, { path: validated.resolvedPath, modified: stats.mtime }, (a, b) => b.modified.getTime() - a.modified.getTime(), topN);
-                }
-            }
-            catch (error) {
-                if (classifyAccessError(error) === 'symlink') {
-                    symlinksNotFollowed++;
-                }
-                else {
-                    skippedInaccessible++;
-                }
-            }
-        }
-    }, DIR_TRAVERSAL_CONCURRENCY);
-    const analysis = {
-        path: validPath,
-        totalFiles,
-        totalDirectories,
-        totalSize,
-        fileTypes,
-        largestFiles,
-        recentlyModified,
-        maxDepth: currentMaxDepth,
-    };
-    return {
-        analysis,
-        summary: {
-            truncated: false,
-            skippedInaccessible,
-            symlinksNotFollowed,
-        },
-    };
-}
-export async function getDirectoryTree(dirPath, options = {}) {
-    const { maxDepth = DEFAULT_MAX_DEPTH, excludePatterns = [], includeHidden = false, includeSize = false, maxFiles, } = options;
-    const validPath = await validateExistingPath(dirPath);
-    const rootStats = await fs.stat(validPath);
-    if (!rootStats.isDirectory()) {
-        throw new McpError(ErrorCode.E_NOT_DIRECTORY, `Not a directory: ${dirPath}`, dirPath);
-    }
-    let totalFiles = 0;
-    let totalDirectories = 0;
-    let maxDepthReached = 0;
-    let skippedInaccessible = 0;
-    let symlinksNotFollowed = 0;
-    let truncated = false;
-    const shouldExclude = createExcludeMatcher(excludePatterns);
-    const hitMaxFiles = () => {
-        return maxFiles !== undefined && totalFiles >= maxFiles;
-    };
-    const collectedEntries = [];
-    const directoriesFound = new Set([validPath]);
-    await runWorkQueue([{ currentPath: validPath, depth: 0 }], async ({ currentPath, depth }, enqueue) => {
-        if (hitMaxFiles()) {
-            truncated = true;
-            return;
-        }
-        if (depth > maxDepth) {
-            truncated = true;
-            return;
-        }
-        maxDepthReached = Math.max(maxDepthReached, depth);
-        let items;
-        try {
-            items = await fs.readdir(currentPath, { withFileTypes: true });
-        }
-        catch {
-            skippedInaccessible++;
-            return;
-        }
-        for (const item of items) {
-            if (hitMaxFiles()) {
-                truncated = true;
-                break;
-            }
-            const { name } = item;
-            if (!includeHidden && name.startsWith('.')) {
-                continue;
-            }
-            const fullPath = path.join(currentPath, name);
-            const relativePath = path.relative(validPath, fullPath);
-            if (shouldExclude(name, relativePath)) {
-                continue;
-            }
-            if (item.isSymbolicLink()) {
-                symlinksNotFollowed++;
-                continue;
-            }
-            try {
-                const { resolvedPath, isSymlink } = await validateExistingPathDetailed(fullPath);
-                if (isSymlink) {
-                    symlinksNotFollowed++;
-                    continue;
-                }
-                const stats = await fs.stat(resolvedPath);
-                if (stats.isFile()) {
-                    totalFiles++;
-                    collectedEntries.push({
-                        parentPath: currentPath,
-                        name,
-                        type: 'file',
-                        size: includeSize ? stats.size : undefined,
-                        depth,
-                    });
-                }
-                else if (stats.isDirectory()) {
-                    totalDirectories++;
-                    directoriesFound.add(resolvedPath);
-                    collectedEntries.push({
-                        parentPath: currentPath,
-                        name,
-                        type: 'directory',
-                        depth,
-                    });
-                    if (depth + 1 <= maxDepth) {
-                        enqueue({ currentPath: resolvedPath, depth: depth + 1 });
-                    }
-                    else {
-                        truncated = true;
-                    }
-                }
-            }
-            catch (error) {
-                if (classifyAccessError(error) === 'symlink') {
-                    symlinksNotFollowed++;
-                }
-                else {
-                    skippedInaccessible++;
-                }
-            }
-        }
-    }, DIR_TRAVERSAL_CONCURRENCY);
-    const childrenByParent = new Map();
-    for (const dirPath of directoriesFound) {
-        childrenByParent.set(dirPath, []);
-    }
-    for (const entry of collectedEntries) {
-        const treeEntry = {
-            name: entry.name,
-            type: entry.type,
-        };
-        if (entry.type === 'file' && entry.size !== undefined) {
-            treeEntry.size = entry.size;
-        }
-        if (entry.type === 'directory') {
-            const fullPath = path.join(entry.parentPath, entry.name);
-            treeEntry.children = childrenByParent.get(fullPath) ?? [];
-        }
-        const siblings = childrenByParent.get(entry.parentPath);
-        if (siblings) {
-            siblings.push(treeEntry);
-        }
-    }
-    const sortChildren = (entries) => {
-        entries.sort((a, b) => {
-            if (a.type !== b.type) {
-                return a.type === 'directory' ? -1 : 1;
-            }
-            return a.name.localeCompare(b.name);
-        });
-    };
-    for (const children of childrenByParent.values()) {
-        sortChildren(children);
-    }
-    const rootName = path.basename(validPath);
-    const tree = {
-        name: rootName || validPath,
-        type: 'directory',
-        children: childrenByParent.get(validPath) ?? [],
-    };
-    return {
-        tree,
-        summary: {
-            totalFiles,
-            totalDirectories,
-            maxDepthReached,
-            truncated,
-            skippedInaccessible,
-            symlinksNotFollowed,
-        },
-    };
-}
-export async function readMediaFile(filePath, { maxSize = MAX_MEDIA_FILE_SIZE } = {}) {
-    const validPath = await validateExistingPath(filePath);
-    const stats = await fs.stat(validPath);
-    const { size } = stats;
-    if (!stats.isFile()) {
-        throw new McpError(ErrorCode.E_NOT_FILE, `Not a file: ${filePath}`, filePath);
-    }
-    if (size > maxSize) {
-        throw new McpError(ErrorCode.E_TOO_LARGE, `File too large: ${size} bytes (max: ${maxSize} bytes)`, filePath, { size, maxSize });
-    }
-    const ext = path.extname(validPath).toLowerCase();
-    const mimeType = getMimeType(ext);
-    const buffer = await fs.readFile(validPath);
-    const data = buffer.toString('base64');
-    let width;
-    let height;
-    if (mimeType.startsWith('image/')) {
-        const dimensions = parseImageDimensions(buffer, ext);
-        if (dimensions) {
-            ({ width, height } = dimensions);
-        }
-    }
-    return {
-        path: validPath,
-        mimeType,
-        size,
-        data,
-        width,
-        height,
-    };
-}
+export { analyzeDirectory } from './file-operations/analyze-directory.js';
+export { getDirectoryTree } from './file-operations/directory-tree.js';
+export { getFileInfo } from './file-operations/file-info.js';
+export { listDirectory } from './file-operations/list-directory.js';
+export { readMediaFile } from './file-operations/read-media-file.js';
+export { readMultipleFiles } from './file-operations/read-multiple-files.js';
+export { searchContent } from './file-operations/search-content.js';
+export { searchFiles } from './file-operations/search-files.js';
+export { readFile } from './fs-helpers.js';
 //# sourceMappingURL=file-operations.js.map