@j0hanz/fs-context-mcp 2.0.0

package/dist/server/roots.js

@@ -0,0 +1,126 @@
+import * as fs from 'node:fs/promises';
+import { InitializedNotificationSchema, RootsListChangedNotificationSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { assertNotAborted, createTimedAbortSignal, withAbort, } from '../lib/fs-helpers/abort.js';
+import { normalizePath } from '../lib/path-utils.js';
+import { getAllowedDirectories, isPathWithinDirectories, setAllowedDirectoriesResolved, } from '../lib/path-validation/allowed-directories.js';
+import { getValidRootDirectories } from '../lib/path-validation/roots.js';
+import { normalizeAllowedDirectories } from './cli.js';
+const ROOTS_TIMEOUT_MS = 5000;
+const ROOTS_DEBOUNCE_MS = 100;
+let rootsUpdateTimeout;
+let rootDirectories = [];
+let clientInitialized = false;
+let serverOptions = {};
+export function setServerOptions(options) {
+    serverOptions = options;
+}
+function logMissingDirectories(options) {
+    if (options.allowCwd) {
+        console.error('No directories specified. Using current working directory:');
+        return;
+    }
+    console.error('WARNING: No directories configured. Use --allow-cwd flag or specify directories via CLI/roots protocol.');
+    console.error('The server will not be able to access any files until directories are configured.');
+}
+export async function recomputeAllowedDirectories() {
+    const cliAllowedDirs = normalizeAllowedDirectories(serverOptions.cliAllowedDirs ?? []);
+    const allowCwd = serverOptions.allowCwd === true;
+    const allowCwdDirs = allowCwd ? [normalizePath(process.cwd())] : [];
+    const baseline = [...cliAllowedDirs, ...allowCwdDirs];
+    const { signal, cleanup } = createTimedAbortSignal(undefined, ROOTS_TIMEOUT_MS);
+    try {
+        const rootsToInclude = baseline.length > 0
+            ? await filterRootsWithinBaseline(rootDirectories, baseline, signal)
+            : rootDirectories;
+        const combined = [...baseline, ...rootsToInclude];
+        if (combined.length === 0 && rootDirectories.length === 0) {
+            console.error('No directories configured. Defaulting to current working directory.');
+            combined.push(normalizePath(process.cwd()));
+        }
+        await setAllowedDirectoriesResolved(combined, signal);
+    }
+    finally {
+        cleanup();
+    }
+}
+async function updateRootsFromClient(server) {
+    try {
+        const rootsResult = await server.server.listRoots(undefined, {
+            timeout: ROOTS_TIMEOUT_MS,
+        });
+        const rootsResultUnknown = rootsResult;
+        const rawRoots = typeof rootsResultUnknown === 'object' &&
+            rootsResultUnknown !== null &&
+            'roots' in rootsResultUnknown
+            ? rootsResultUnknown.roots
+            : undefined;
+        const roots = Array.isArray(rawRoots) ? rawRoots.filter(isRoot) : [];
+        const { signal, cleanup } = createTimedAbortSignal(undefined, ROOTS_TIMEOUT_MS);
+        try {
+            rootDirectories =
+                roots.length > 0 ? await getValidRootDirectories(roots, signal) : [];
+        }
+        finally {
+            cleanup();
+        }
+    }
+    catch (error) {
+        rootDirectories = [];
+        console.error('[DEBUG] MCP Roots protocol unavailable or failed:', error instanceof Error ? error.message : String(error));
+    }
+    finally {
+        await recomputeAllowedDirectories();
+    }
+}
+function isRoot(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        'uri' in value &&
+        typeof value.uri === 'string');
+}
+async function filterRootsWithinBaseline(roots, baseline, signal) {
+    const normalizedBaseline = normalizeAllowedDirectories(baseline);
+    const filtered = [];
+    for (const root of roots) {
+        const normalizedRoot = normalizePath(root);
+        const isValid = await isRootWithinBaseline(normalizedRoot, normalizedBaseline, signal);
+        if (isValid)
+            filtered.push(normalizedRoot);
+    }
+    return filtered;
+}
+async function isRootWithinBaseline(normalizedRoot, baseline, signal) {
+    if (!isPathWithinDirectories(normalizedRoot, baseline)) {
+        return false;
+    }
+    try {
+        assertNotAborted(signal);
+        const realPath = await withAbort(fs.realpath(normalizedRoot), signal);
+        const normalizedReal = normalizePath(realPath);
+        return isPathWithinDirectories(normalizedReal, baseline);
+    }
+    catch {
+        return false;
+    }
+}
+export function registerRootHandlers(server) {
+    server.server.setNotificationHandler(InitializedNotificationSchema, async () => {
+        clientInitialized = true;
+        await updateRootsFromClient(server);
+    });
+    server.server.setNotificationHandler(RootsListChangedNotificationSchema, () => {
+        if (!clientInitialized)
+            return;
+        if (rootsUpdateTimeout)
+            clearTimeout(rootsUpdateTimeout);
+        rootsUpdateTimeout = setTimeout(() => {
+            void updateRootsFromClient(server);
+        }, ROOTS_DEBOUNCE_MS);
+    });
+}
+export function logMissingDirectoriesIfNeeded() {
+    if (getAllowedDirectories().length === 0) {
+        logMissingDirectories(serverOptions);
+    }
+}
+//# sourceMappingURL=roots.js.map

package/dist/server/roots.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type ServerOptions } from './server/roots.js';
+export { parseArgs } from './server/cli.js';
+export declare function createServer(options?: ServerOptions): McpServer;
+export declare function startServer(server: McpServer): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,OAAO,EAIL,KAAK,aAAa,EAEnB,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAwD5C,wBAAgB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,SAAS,CAoBnE;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAUlE"}

package/dist/server.js

@@ -0,0 +1,75 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import packageJsonRaw from '../package.json' with { type: 'json' };
+import { ErrorCode, McpError } from './lib/errors.js';
+import { logMissingDirectoriesIfNeeded, recomputeAllowedDirectories, registerRootHandlers, setServerOptions, } from './server/roots.js';
+import { registerAllTools } from './tools/index.js';
+import { buildToolErrorResponse } from './tools/tool-response.js';
+export { parseArgs } from './server/cli.js';
+const PackageJsonSchema = z.object({ version: z.string() });
+const { version: SERVER_VERSION } = PackageJsonSchema.parse(packageJsonRaw);
+const currentDir = path.dirname(fileURLToPath(import.meta.url));
+let serverInstructions = `
+Filesystem Context MCP Server
+(Detailed instructions failed to load - check logs)
+`;
+try {
+    serverInstructions = await fs.readFile(path.join(currentDir, 'instructions.md'), 'utf-8');
+}
+catch (error) {
+    console.error('[WARNING] Failed to load instructions.md:', error instanceof Error ? error.message : String(error));
+}
+function resolveToolErrorCode(message) {
+    const lower = message.toLowerCase();
+    if (lower.includes('not found'))
+        return ErrorCode.E_NOT_FOUND;
+    if (lower.includes('invalid arguments') ||
+        lower.includes('input validation')) {
+        return ErrorCode.E_INVALID_INPUT;
+    }
+    if (lower.includes('disabled'))
+        return ErrorCode.E_INVALID_INPUT;
+    if (lower.includes('requires task augmentation')) {
+        return ErrorCode.E_INVALID_INPUT;
+    }
+    return ErrorCode.E_UNKNOWN;
+}
+function patchToolErrorHandling(server) {
+    const createToolError = (errorMessage) => {
+        const code = resolveToolErrorCode(errorMessage);
+        const error = new McpError(code, errorMessage);
+        return buildToolErrorResponse(error, code);
+    };
+    Object.defineProperty(server, 'createToolError', {
+        value: createToolError,
+        configurable: true,
+        writable: true,
+    });
+}
+export function createServer(options = {}) {
+    setServerOptions(options);
+    const server = new McpServer({
+        name: 'fs-context-mcp',
+        version: SERVER_VERSION,
+    }, {
+        instructions: serverInstructions || undefined,
+        capabilities: {
+            logging: {},
+        },
+    });
+    patchToolErrorHandling(server);
+    registerAllTools(server);
+    return server;
+}
+export async function startServer(server) {
+    const transport = new StdioServerTransport();
+    registerRootHandlers(server);
+    await recomputeAllowedDirectories();
+    await server.connect(transport);
+    logMissingDirectoriesIfNeeded();
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/analyze-directory.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerAnalyzeDirectoryTool(server: McpServer): void;
+//# sourceMappingURL=analyze-directory.d.ts.map

package/dist/tools/analyze-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-directory.d.ts","sourceRoot":"","sources":["../../src/tools/analyze-directory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsJzE,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiBpE"}

package/dist/tools/analyze-directory.js

@@ -0,0 +1,99 @@
+import * as pathModule from 'node:path';
+import { formatBytes, formatDate, formatOperationSummary, joinLines, } from '../config/formatting.js';
+import { ErrorCode } from '../lib/errors.js';
+import { analyzeDirectory } from '../lib/file-operations.js';
+import { AnalyzeDirectoryInputSchema, AnalyzeDirectoryOutputSchema, } from '../schemas/index.js';
+import { buildToolErrorResponse, buildToolResponse, } from './tool-response.js';
+function formatDirectoryAnalysis(analysis) {
+    const lines = [
+        `Path: ${analysis.path}`,
+        `Files: ${analysis.totalFiles} | Dirs: ${analysis.totalDirectories} | Size: ${formatBytes(analysis.totalSize)} | Depth: ${analysis.maxDepth}`,
+    ];
+    const fileTypes = Object.entries(analysis.fileTypes)
+        .sort((a, b) => b[1] - a[1])
+        .map(([ext, count]) => `${ext}: ${count}`);
+    if (fileTypes.length) {
+        lines.push(`File types: ${fileTypes.join(', ')}`);
+    }
+    const largest = analysis.largestFiles.map((file) => `${formatBytes(file.size)} ${pathModule.relative(analysis.path, file.path)}`);
+    if (largest.length) {
+        lines.push(`Largest: ${largest.join(', ')}`);
+    }
+    const recent = analysis.recentlyModified.map((file) => `${formatDate(file.modified)} ${pathModule.relative(analysis.path, file.path)}`);
+    if (recent.length) {
+        lines.push(`Recent: ${recent.join(', ')}`);
+    }
+    return joinLines(lines);
+}
+function buildStructuredResult(result) {
+    return {
+        ok: true,
+        path: result.analysis.path,
+        totalFiles: result.analysis.totalFiles,
+        totalDirectories: result.analysis.totalDirectories,
+        totalSize: result.analysis.totalSize,
+        fileTypes: result.analysis.fileTypes,
+        largestFiles: result.analysis.largestFiles.map((f) => ({
+            path: pathModule.relative(result.analysis.path, f.path),
+            size: f.size,
+        })),
+        recentlyModified: result.analysis.recentlyModified.map((f) => ({
+            path: pathModule.relative(result.analysis.path, f.path),
+            modified: f.modified.toISOString(),
+        })),
+        summary: {
+            truncated: result.summary.truncated,
+            skippedInaccessible: result.summary.skippedInaccessible,
+            symlinksNotFollowed: result.summary.symlinksNotFollowed,
+        },
+    };
+}
+function buildTextResult(result) {
+    let textOutput = formatDirectoryAnalysis(result.analysis);
+    textOutput += formatOperationSummary({
+        truncated: result.summary.truncated,
+        truncatedReason: result.summary.truncated ? 'results truncated' : undefined,
+        skippedInaccessible: result.summary.skippedInaccessible,
+        symlinksNotFollowed: result.summary.symlinksNotFollowed,
+    });
+    return textOutput;
+}
+async function handleAnalyzeDirectory({ path: dirPath, maxDepth, topN, maxEntries, excludePatterns, includeHidden, }, signal) {
+    const result = await analyzeDirectory(dirPath, {
+        maxDepth,
+        topN,
+        maxEntries,
+        excludePatterns,
+        includeHidden,
+        signal,
+    });
+    const structured = buildStructuredResult(result);
+    const textOutput = buildTextResult(result);
+    return buildToolResponse(textOutput, structured);
+}
+const ANALYZE_DIRECTORY_TOOL = {
+    title: 'Analyze Directory',
+    description: 'Gather statistics about a directory: total files/directories, total size, ' +
+        'file type distribution by extension, largest files (topN), and most recently modified files. ' +
+        'Useful for understanding project structure and identifying large files. ' +
+        'Use excludePatterns to skip directories like node_modules.',
+    inputSchema: AnalyzeDirectoryInputSchema,
+    outputSchema: AnalyzeDirectoryOutputSchema.shape,
+    annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+};
+export function registerAnalyzeDirectoryTool(server) {
+    const handler = async (args, extra) => {
+        try {
+            return await handleAnalyzeDirectory(args, extra.signal);
+        }
+        catch (error) {
+            return buildToolErrorResponse(error, ErrorCode.E_NOT_DIRECTORY, args.path);
+        }
+    };
+    server.registerTool('analyze_directory', ANALYZE_DIRECTORY_TOOL, handler);
+}
+//# sourceMappingURL=analyze-directory.js.map

package/dist/tools/analyze-directory.js.map

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

package/dist/tools/compute-checksums.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerComputeChecksumsTool(server: McpServer): void;
+//# sourceMappingURL=compute-checksums.d.ts.map

package/dist/tools/compute-checksums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-checksums.d.ts","sourceRoot":"","sources":["../../src/tools/compute-checksums.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgGzE,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAapE"}

package/dist/tools/compute-checksums.js

@@ -0,0 +1,69 @@
+import { formatBytes, joinLines } from '../config/formatting.js';
+import { ErrorCode } from '../lib/errors.js';
+import { computeChecksums } from '../lib/file-operations.js';
+import { ComputeChecksumsInputSchema, ComputeChecksumsOutputSchema, } from '../schemas/index.js';
+import { buildToolErrorResponse, buildToolResponse, } from './tool-response.js';
+function buildStructuredResult(result) {
+    return {
+        ok: true,
+        results: result.results.map((r) => ({
+            path: r.path,
+            checksum: r.checksum,
+            algorithm: r.algorithm,
+            size: r.size,
+            error: r.error,
+        })),
+        summary: result.summary,
+    };
+}
+function buildTextResult(result) {
+    const checksumLines = result.results.map(formatChecksumLine);
+    const summary = `${getSummaryAlgorithm(result)} | ${result.summary.succeeded}/${result.summary.total} ok`;
+    return joinLines([`Checksums (${summary}):`, ...checksumLines]);
+}
+function formatChecksumLine(item) {
+    if (!item.checksum) {
+        return `[Error: ${item.error ?? 'Unknown error'}]  ${item.path}`;
+    }
+    const size = item.size !== undefined ? ` (${formatBytes(item.size)})` : '';
+    return `${item.checksum}  ${item.path}${size}`;
+}
+function getSummaryAlgorithm(result) {
+    return result.results[0]?.algorithm ?? 'sha256';
+}
+async function handleComputeChecksums(args, signal) {
+    const result = await computeChecksums(args.paths, {
+        algorithm: args.algorithm,
+        encoding: args.encoding,
+        maxFileSize: args.maxFileSize,
+        signal,
+    });
+    return buildToolResponse(buildTextResult(result), buildStructuredResult(result));
+}
+const COMPUTE_CHECKSUMS_TOOL = {
+    title: 'Compute Checksums',
+    description: 'Compute cryptographic checksums (hashes) for one or more files. ' +
+        'Supports MD5, SHA-1, SHA-256, and SHA-512 algorithms. ' +
+        'Uses streaming for memory efficiency with large files. ' +
+        'Useful for verifying file integrity, detecting duplicates, or comparing file contents. ' +
+        'Individual file errors do not fail the entire operation.',
+    inputSchema: ComputeChecksumsInputSchema,
+    outputSchema: ComputeChecksumsOutputSchema.shape,
+    annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+};
+export function registerComputeChecksumsTool(server) {
+    const handler = async (args, extra) => {
+        try {
+            return await handleComputeChecksums(args, extra.signal);
+        }
+        catch (error) {
+            return buildToolErrorResponse(error, ErrorCode.E_UNKNOWN);
+        }
+    };
+    server.registerTool('compute_checksums', COMPUTE_CHECKSUMS_TOOL, handler);
+}
+//# sourceMappingURL=compute-checksums.js.map

package/dist/tools/compute-checksums.js.map

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

package/dist/tools/directory-tree.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerDirectoryTreeTool(server: McpServer): void;
+//# sourceMappingURL=directory-tree.d.ts.map

package/dist/tools/directory-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-tree.d.ts","sourceRoot":"","sources":["../../src/tools/directory-tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiIzE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiBjE"}

package/dist/tools/directory-tree.js

@@ -0,0 +1,82 @@
+import { formatBytes, formatOperationSummary, joinLines, } from '../config/formatting.js';
+import { ErrorCode } from '../lib/errors.js';
+import { getDirectoryTree } from '../lib/file-operations.js';
+import { DirectoryTreeInputSchema, DirectoryTreeOutputSchema, } from '../schemas/index.js';
+import { buildToolErrorResponse, buildToolResponse, } from './tool-response.js';
+function formatTreeEntry(entry, indent = '') {
+    return joinLines(formatTreeEntryLines(entry, indent));
+}
+function formatTreeEntryLines(entry, indent) {
+    const lines = [formatTreeEntryLine(entry, indent)];
+    for (const child of entry.children ?? []) {
+        lines.push(...formatTreeEntryLines(child, `${indent}  `));
+    }
+    return lines;
+}
+function formatTreeEntryLine(entry, indent) {
+    const icon = entry.type === 'directory' ? '[DIR]' : '[FILE]';
+    const size = entry.size !== undefined ? ` (${formatBytes(entry.size)})` : '';
+    return `${indent}${icon} ${entry.name}${size}`;
+}
+function buildStructuredResult(result) {
+    return {
+        ok: true,
+        tree: result.tree,
+        summary: result.summary,
+    };
+}
+function buildTextResult(result, includeSize) {
+    let textOutput = formatTreeEntry(result.tree);
+    if (includeSize === false) {
+        textOutput +=
+            '\n(Size omitted. Set includeSize=true to include file sizes in the tree.)';
+    }
+    textOutput += formatOperationSummary({
+        truncated: result.summary.truncated,
+        truncatedReason: 'tree was truncated',
+        tip: 'Increase maxDepth or maxFiles, or add excludePatterns to narrow scope.',
+        skippedInaccessible: result.summary.skippedInaccessible,
+        symlinksNotFollowed: result.summary.symlinksNotFollowed,
+    });
+    return textOutput;
+}
+async function handleDirectoryTree({ path, maxDepth, excludePatterns, includeHidden, includeSize, maxFiles, }, signal) {
+    const result = await getDirectoryTree(path, {
+        maxDepth,
+        excludePatterns,
+        includeHidden,
+        includeSize,
+        maxFiles,
+        signal,
+    });
+    const structured = buildStructuredResult(result);
+    const textOutput = buildTextResult(result, includeSize);
+    return buildToolResponse(textOutput, structured);
+}
+const DIRECTORY_TREE_TOOL = {
+    title: 'Directory Tree',
+    description: 'Generate a hierarchical JSON tree structure of a directory. ' +
+        'More efficient for AI parsing than flat file lists. ' +
+        'Ideal for understanding project layout and structure at a glance. ' +
+        'Use maxDepth to limit traversal depth and excludePatterns to skip folders like node_modules. ' +
+        'Optionally include file sizes with includeSize=true.',
+    inputSchema: DirectoryTreeInputSchema,
+    outputSchema: DirectoryTreeOutputSchema.shape,
+    annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+};
+export function registerDirectoryTreeTool(server) {
+    const handler = async (args, extra) => {
+        try {
+            return await handleDirectoryTree(args, extra.signal);
+        }
+        catch (error) {
+            return buildToolErrorResponse(error, ErrorCode.E_NOT_DIRECTORY, args.path);
+        }
+    };
+    server.registerTool('directory_tree', DIRECTORY_TREE_TOOL, handler);
+}
+//# sourceMappingURL=directory-tree.js.map

package/dist/tools/directory-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-tree.js","sourceRoot":"","sources":["../../src/tools/directory-tree.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,SAAS,GACV,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EACL,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAGlB,MAAM,oBAAoB,CAAC;AAK5B,SAAS,eAAe,CACtB,KAA2D,EAC3D,MAAM,GAAG,EAAE;IAEX,OAAO,SAAS,CAAC,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,oBAAoB,CAC3B,KAA2D,EAC3D,MAAc;IAEd,MAAM,KAAK,GAAG,CAAC,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,GAAG,oBAAoB,CAAC,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,mBAAmB,CAC1B,KAA2D,EAC3D,MAAc;IAEd,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC7D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7E,OAAO,GAAG,MAAM,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,GAAG,IAAI,EAAE,CAAC;AACjD,CAAC;AAED,SAAS,qBAAqB,CAC5B,MAAoD;IAEpD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,MAAoD,EACpD,WAAgC;IAEhC,IAAI,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,WAAW,KAAK,KAAK,EAAE,CAAC;QAC1B,UAAU;YACR,2EAA2E,CAAC;IAChF,CAAC;IACD,UAAU,IAAI,sBAAsB,CAAC;QACnC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS;QACnC,eAAe,EAAE,oBAAoB;QACrC,GAAG,EAAE,wEAAwE;QAC7E,mBAAmB,EAAE,MAAM,CAAC,OAAO,CAAC,mBAAmB;QACvD,mBAAmB,EAAE,MAAM,CAAC,OAAO,CAAC,mBAAmB;KACxD,CAAC,CAAC;IACH,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,KAAK,UAAU,mBAAmB,CAChC,EACE,IAAI,EACJ,QAAQ,EACR,eAAe,EACf,aAAa,EACb,WAAW,EACX,QAAQ,GAQT,EACD,MAAoB;IAEpB,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE;QAC1C,QAAQ;QACR,eAAe;QACf,aAAa;QACb,WAAW;QACX,QAAQ;QACR,MAAM;KACP,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACxD,OAAO,iBAAiB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,mBAAmB,GAAG;IAC1B,KAAK,EAAE,gBAAgB;IACvB,WAAW,EACT,8DAA8D;QAC9D,sDAAsD;QACtD,oEAAoE;QACpE,+FAA+F;QAC/F,sDAAsD;IACxD,WAAW,EAAE,wBAAwB;IACrC,YAAY,EAAE,yBAAyB,CAAC,KAAK;IAC7C,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB;CACO,CAAC;AAEX,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,OAAO,GAAG,KAAK,EACnB,IAAuB,EACvB,KAA8B,EACsB,EAAE;QACtD,IAAI,CAAC;YACH,OAAO,MAAM,mBAAmB,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,sBAAsB,CAC3B,KAAK,EACL,SAAS,CAAC,eAAe,EACzB,IAAI,CAAC,IAAI,CACV,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,CAAC,YAAY,CAAC,gBAAgB,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;AACtE,CAAC"}

package/dist/tools/get-file-info.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGetFileInfoTool(server: McpServer): void;
+//# sourceMappingURL=get-file-info.d.ts.map

package/dist/tools/get-file-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-file-info.d.ts","sourceRoot":"","sources":["../../src/tools/get-file-info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkEzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2B/D"}

package/dist/tools/get-file-info.js

@@ -0,0 +1,46 @@
+import { DEFAULT_SEARCH_TIMEOUT_MS } from '../lib/constants.js';
+import { ErrorCode } from '../lib/errors.js';
+import { getFileInfo } from '../lib/file-operations/file-info.js';
+import { createTimedAbortSignal } from '../lib/fs-helpers/abort.js';
+import { withToolDiagnostics } from '../lib/observability/diagnostics.js';
+import { GetFileInfoInputSchema, GetFileInfoOutputSchema, } from '../schemas/index.js';
+import { buildFileInfoPayload, formatFileInfoDetails, } from './shared/file-info.js';
+import { buildToolErrorResponse, buildToolResponse, withToolErrorHandling, } from './tool-response.js';
+function buildStructuredResult(info) {
+    return {
+        ok: true,
+        info: buildFileInfoPayload(info),
+    };
+}
+async function handleGetFileInfo({ path, }, signal) {
+    const info = await getFileInfo(path, { signal });
+    const structured = buildStructuredResult(info);
+    return buildToolResponse(formatFileInfoDetails(info), structured);
+}
+const GET_FILE_INFO_TOOL = {
+    title: 'Get File Info',
+    description: 'Retrieve detailed metadata about a file or directory without reading contents. ' +
+        'Returns: name, path, type, size, timestamps (created/modified/accessed), permissions, ' +
+        'MIME type (for files), hidden status, and symlink target (if applicable). ' +
+        'Use this to check file properties before reading large files.',
+    inputSchema: GetFileInfoInputSchema,
+    outputSchema: GetFileInfoOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+};
+export function registerGetFileInfoTool(server) {
+    const handler = (args, extra) => withToolDiagnostics('stat', () => withToolErrorHandling(async () => {
+        const { signal, cleanup } = createTimedAbortSignal(extra.signal, DEFAULT_SEARCH_TIMEOUT_MS);
+        try {
+            return await handleGetFileInfo(args, signal);
+        }
+        finally {
+            cleanup();
+        }
+    }, (error) => buildToolErrorResponse(error, ErrorCode.E_NOT_FOUND, args.path)), { path: args.path });
+    server.registerTool('stat', GET_FILE_INFO_TOOL, handler);
+}
+//# sourceMappingURL=get-file-info.js.map

package/dist/tools/get-file-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-file-info.js","sourceRoot":"","sources":["../../src/tools/get-file-info.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EACL,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EAGjB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAK5B,SAAS,qBAAqB,CAC5B,IAA6C;IAE7C,OAAO;QACL,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,oBAAoB,CAAC,IAAI,CAAC;KACjC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,EACE,IAAI,GAGL,EACD,MAAoB;IAEpB,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC/C,OAAO,iBAAiB,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,kBAAkB,GAAG;IACzB,KAAK,EAAE,eAAe;IACtB,WAAW,EACT,iFAAiF;QACjF,wFAAwF;QACxF,4EAA4E;QAC5E,+DAA+D;IACjE,WAAW,EAAE,sBAAsB;IACnC,YAAY,EAAE,uBAAuB;IACrC,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB;CACO,CAAC;AAEX,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,OAAO,GAAG,CACd,IAAqB,EACrB,KAA+B,EACmB,EAAE,CACpD,mBAAmB,CACjB,MAAM,EACN,GAAG,EAAE,CACH,qBAAqB,CACnB,KAAK,IAAI,EAAE;QACT,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,sBAAsB,CAChD,KAAK,CAAC,MAAM,EACZ,yBAAyB,CAC1B,CAAC;QACF,IAAI,CAAC;YACH,OAAO,MAAM,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC/C,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,EACD,CAAC,KAAK,EAAE,EAAE,CACR,sBAAsB,CAAC,KAAK,EAAE,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAClE,EACH,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CACpB,CAAC;IAEJ,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC"}

package/dist/tools/get-multiple-file-info.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGetMultipleFileInfoTool(server: McpServer): void;
+//# sourceMappingURL=get-multiple-file-info.d.ts.map

package/dist/tools/get-multiple-file-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-multiple-file-info.d.ts","sourceRoot":"","sources":["../../src/tools/get-multiple-file-info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmGzE,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuBvE"}