@j0hanz/filesystem-context-mcp 1.1.0 → 1.2.1

package/dist/tools/directory-tree.js

@@ -1,59 +1,96 @@
 import { createErrorResponse, ErrorCode } from '../lib/errors.js';
 import { getDirectoryTree } from '../lib/file-operations.js';
-import { formatOperationSummary, formatTreeEntry } from '../lib/formatters.js';
 import { DirectoryTreeInputSchema, DirectoryTreeOutputSchema, } from '../schemas/index.js';
+import { buildToolResponse } from './tool-response.js';
+const BYTE_UNIT_LABELS = ['B', 'KB', 'MB', 'GB', 'TB'];
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const unitIndex = Math.floor(Math.log(bytes) / Math.log(1024));
+    const unit = BYTE_UNIT_LABELS[unitIndex] ?? 'B';
+    const value = bytes / Math.pow(1024, unitIndex);
+    return `${parseFloat(value.toFixed(2))} ${unit}`;
+}
+function formatTreeEntry(entry, indent = '') {
+    const lines = [];
+    const icon = entry.type === 'directory' ? '[DIR]' : '[FILE]';
+    const size = entry.size !== undefined ? ` (${formatBytes(entry.size)})` : '';
+    lines.push(`${indent}${icon} ${entry.name}${size}`);
+    for (const child of entry.children ?? []) {
+        lines.push(formatTreeEntry(child, `${indent}  `));
+    }
+    return lines.join('\n');
+}
+function formatOperationSummary(summary) {
+    const lines = [];
+    if (summary.truncated) {
+        lines.push(`\n\n!! PARTIAL RESULTS: ${summary.truncatedReason ?? 'results truncated'}`);
+        if (summary.tip)
+            lines.push(`Tip: ${summary.tip}`);
+    }
+    const note = (count, msg) => {
+        if (count && count > 0)
+            lines.push(`Note: ${count} ${msg}`);
+    };
+    note(summary.skippedTooLarge, 'file(s) skipped (too large).');
+    note(summary.skippedBinary, 'file(s) skipped (binary).');
+    note(summary.skippedInaccessible, 'item(s) were inaccessible and skipped.');
+    note(summary.symlinksNotFollowed, 'symlink(s) were not followed (security).');
+    note(summary.linesSkippedDueToRegexTimeout, 'line(s) skipped (regex timeout).');
+    return lines.join('\n');
+}
+function buildStructuredResult(result) {
+    return {
+        ok: true,
+        tree: result.tree,
+        summary: result.summary,
+    };
+}
+function buildTextResult(result) {
+    let textOutput = formatTreeEntry(result.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, }) {
+    const result = await getDirectoryTree(path, {
+        maxDepth,
+        excludePatterns,
+        includeHidden,
+        includeSize,
+        maxFiles,
+    });
+    const structured = buildStructuredResult(result);
+    const textOutput = buildTextResult(result);
+    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,
+    annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+};
 export function registerDirectoryTreeTool(server) {
-    server.registerTool('directory_tree', {
-        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,
-        annotations: {
-            readOnlyHint: true,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    }, async ({ path, maxDepth, excludePatterns, includeHidden, includeSize, maxFiles, }) => {
+    server.registerTool('directory_tree', DIRECTORY_TREE_TOOL, async (args) => {
         try {
-            const result = await getDirectoryTree(path, {
-                maxDepth,
-                excludePatterns,
-                includeHidden,
-                includeSize,
-                maxFiles,
-            });
-            let textOutput = formatTreeEntry(result.tree);
-            const structured = {
-                ok: true,
-                tree: result.tree,
-                summary: {
-                    totalFiles: result.summary.totalFiles,
-                    totalDirectories: result.summary.totalDirectories,
-                    maxDepthReached: result.summary.maxDepthReached,
-                    truncated: result.summary.truncated,
-                    skippedInaccessible: result.summary.skippedInaccessible,
-                    symlinksNotFollowed: result.summary.symlinksNotFollowed,
-                },
-            };
-            // Add truncation notice for better error recovery feedback
-            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 {
-                content: [{ type: 'text', text: textOutput }],
-                structuredContent: structured,
-            };
+            return await handleDirectoryTree(args);
         }
         catch (error) {
-            return createErrorResponse(error, ErrorCode.E_NOT_DIRECTORY, path);
+            return createErrorResponse(error, ErrorCode.E_NOT_DIRECTORY, args.path);
         }
     });
 }

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

@@ -1 +1 @@
-{"version":3,"file":"directory-tree.js","sourceRoot":"","sources":["../../src/tools/directory-tree.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EACL,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EACT,8DAA8D;YAC9D,sDAAsD;YACtD,oEAAoE;YACpE,+FAA+F;YAC/F,sDAAsD;QACxD,WAAW,EAAE,wBAAwB;QACrC,YAAY,EAAE,yBAAyB;QACvC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EACL,IAAI,EACJ,QAAQ,EACR,eAAe,EACf,aAAa,EACb,WAAW,EACX,QAAQ,GACT,EAAE,EAAE;QACH,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE;gBAC1C,QAAQ;gBACR,eAAe;gBACf,aAAa;gBACb,WAAW;gBACX,QAAQ;aACT,CAAC,CAAC;YAEH,IAAI,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAE9C,MAAM,UAAU,GAAG;gBACjB,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,OAAO,EAAE;oBACP,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU;oBACrC,gBAAgB,EAAE,MAAM,CAAC,OAAO,CAAC,gBAAgB;oBACjD,eAAe,EAAE,MAAM,CAAC,OAAO,CAAC,eAAe;oBAC/C,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS;oBACnC,mBAAmB,EAAE,MAAM,CAAC,OAAO,CAAC,mBAAmB;oBACvD,mBAAmB,EAAE,MAAM,CAAC,OAAO,CAAC,mBAAmB;iBACxD;aACF,CAAC;YAEF,2DAA2D;YAC3D,UAAU,IAAI,sBAAsB,CAAC;gBACnC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS;gBACnC,eAAe,EAAE,oBAAoB;gBACrC,GAAG,EAAE,wEAAwE;gBAC7E,mBAAmB,EAAE,MAAM,CAAC,OAAO,CAAC,mBAAmB;gBACvD,mBAAmB,EAAE,MAAM,CAAC,OAAO,CAAC,mBAAmB;aACxD,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;gBAC7C,iBAAiB,EAAE,UAAU;aAC9B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;QACrE,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"directory-tree.js","sourceRoot":"","sources":["../../src/tools/directory-tree.ts"],"names":[],"mappings":"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"}

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

@@ -1 +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;AAUzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8C/D"}
+{"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;AA8FzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAQ/D"}

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

@@ -1,47 +1,81 @@
 import { createErrorResponse, ErrorCode } from '../lib/errors.js';
 import { getFileInfo } from '../lib/file-operations.js';
-import { formatFileInfo } from '../lib/formatters.js';
 import { GetFileInfoInputSchema, GetFileInfoOutputSchema, } from '../schemas/index.js';
-export function registerGetFileInfoTool(server) {
-    server.registerTool('get_file_info', {
-        title: 'Get File Info',
-        description: 'Retrieve detailed metadata about a file or directory without reading its 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,
+import { buildToolResponse } from './tool-response.js';
+const BYTE_UNIT_LABELS = ['B', 'KB', 'MB', 'GB', 'TB'];
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const unitIndex = Math.floor(Math.log(bytes) / Math.log(1024));
+    const unit = BYTE_UNIT_LABELS[unitIndex] ?? 'B';
+    const value = bytes / Math.pow(1024, unitIndex);
+    return `${parseFloat(value.toFixed(2))} ${unit}`;
+}
+function formatDate(date) {
+    return date.toISOString();
+}
+function formatFileInfo(info) {
+    const lines = [
+        `Name: ${info.name}`,
+        `Path: ${info.path}`,
+        `Type: ${info.type}`,
+        `Size: ${formatBytes(info.size)}`,
+        `Created: ${formatDate(info.created)}`,
+        `Modified: ${formatDate(info.modified)}`,
+        `Accessed: ${formatDate(info.accessed)}`,
+        `Permissions: ${info.permissions}`,
+        `Hidden: ${info.isHidden ? 'Yes' : 'No'}`,
+    ];
+    if (info.mimeType)
+        lines.push(`MIME Type: ${info.mimeType}`);
+    if (info.symlinkTarget)
+        lines.push(`Symlink Target: ${info.symlinkTarget}`);
+    return lines.join('\n');
+}
+function buildStructuredResult(info) {
+    return {
+        ok: true,
+        info: {
+            name: info.name,
+            path: info.path,
+            type: info.type,
+            size: info.size,
+            created: info.created.toISOString(),
+            modified: info.modified.toISOString(),
+            accessed: info.accessed.toISOString(),
+            permissions: info.permissions,
+            isHidden: info.isHidden,
+            mimeType: info.mimeType,
+            symlinkTarget: info.symlinkTarget,
         },
-    }, async ({ path }) => {
+    };
+}
+async function handleGetFileInfo({ path, }) {
+    const info = await getFileInfo(path);
+    const structured = buildStructuredResult(info);
+    return buildToolResponse(formatFileInfo(info), structured);
+}
+const GET_FILE_INFO_TOOL = {
+    title: 'Get File Info',
+    description: 'Retrieve detailed metadata about a file or directory without reading its 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) {
+    server.registerTool('get_file_info', GET_FILE_INFO_TOOL, async (args) => {
         try {
-            const info = await getFileInfo(path);
-            const structured = {
-                ok: true,
-                info: {
-                    name: info.name,
-                    path: info.path,
-                    type: info.type,
-                    size: info.size,
-                    created: info.created.toISOString(),
-                    modified: info.modified.toISOString(),
-                    accessed: info.accessed.toISOString(),
-                    permissions: info.permissions,
-                    isHidden: info.isHidden,
-                    mimeType: info.mimeType,
-                    symlinkTarget: info.symlinkTarget,
-                },
-            };
-            return {
-                content: [{ type: 'text', text: formatFileInfo(info) }],
-                structuredContent: structured,
-            };
+            return await handleGetFileInfo(args);
         }
         catch (error) {
-            return createErrorResponse(error, ErrorCode.E_NOT_FOUND, path);
+            return createErrorResponse(error, ErrorCode.E_NOT_FOUND, args.path);
         }
     });
 }

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

@@ -1 +1 @@
-{"version":3,"file":"get-file-info.js","sourceRoot":"","sources":["../../src/tools/get-file-info.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACL,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,qFAAqF;YACrF,wFAAwF;YACxF,4EAA4E;YAC5E,+DAA+D;QACjE,WAAW,EAAE,sBAAsB;QACnC,YAAY,EAAE,uBAAuB;QACrC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;YACrC,MAAM,UAAU,GAAG;gBACjB,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE;oBACJ,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE;oBACnC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE;oBACrC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE;oBACrC,WAAW,EAAE,IAAI,CAAC,WAAW;oBAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,aAAa,EAAE,IAAI,CAAC,aAAa;iBAClC;aACF,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvD,iBAAiB,EAAE,UAAU;aAC9B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACjE,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"get-file-info.js","sourceRoot":"","sources":["../../src/tools/get-file-info.ts"],"names":[],"mappings":"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"}

package/dist/tools/list-allowed-dirs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-allowed-dirs.d.ts","sourceRoot":"","sources":["../../src/tools/list-allowed-dirs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqBzE,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2C1E"}
+{"version":3,"file":"list-allowed-dirs.d.ts","sourceRoot":"","sources":["../../src/tools/list-allowed-dirs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAyFzE,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAM1E"}

package/dist/tools/list-allowed-dirs.js

@@ -1,7 +1,17 @@
 import * as fs from 'node:fs/promises';
-import { formatAllowedDirectories } from '../lib/formatters.js';
 import { getAllowedDirectories } from '../lib/path-validation.js';
 import { ListAllowedDirectoriesOutputSchema } from '../schemas/index.js';
+import { buildToolResponse } from './tool-response.js';
+function formatAllowedDirectories(dirs) {
+    if (dirs.length === 0) {
+        return 'No directories are currently allowed.';
+    }
+    const lines = ['Allowed Directories:', ''];
+    for (const dir of dirs) {
+        lines.push(`  - ${dir}`);
+    }
+    return lines.join('\n');
+}
 async function checkDirectoryAccess(dirPath) {
     try {
         await fs.access(dirPath, fs.constants.R_OK);
@@ -17,40 +27,43 @@ async function checkDirectoryAccess(dirPath) {
         }
     }
 }
+function buildHint(count) {
+    if (count === 0) {
+        return 'No directories configured. Server cannot access any files.';
+    }
+    if (count === 1) {
+        return 'Single directory configured. All operations are sandboxed here.';
+    }
+    return `${count} directories configured. Operations work across all of them.`;
+}
+async function handleListAllowedDirectories() {
+    const dirs = getAllowedDirectories();
+    const count = dirs.length;
+    const hint = buildHint(count);
+    const accessStatus = await Promise.all(dirs.map(checkDirectoryAccess));
+    const structured = {
+        ok: true,
+        allowedDirectories: dirs,
+        count,
+        accessStatus,
+        hint,
+    };
+    return buildToolResponse(formatAllowedDirectories(dirs), structured);
+}
+const LIST_ALLOWED_DIRECTORIES_TOOL = {
+    title: 'List Allowed Directories',
+    description: 'Returns the list of directories this server is permitted to access. ' +
+        'Call this FIRST to understand the scope of available file operations. ' +
+        'All other tools will only work within these directories for security.',
+    inputSchema: {},
+    outputSchema: ListAllowedDirectoriesOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+};
 export function registerListAllowedDirectoriesTool(server) {
-    server.registerTool('list_allowed_directories', {
-        title: 'List Allowed Directories',
-        description: 'Returns the list of directories this server is permitted to access. ' +
-            'Call this FIRST to understand the scope of available file operations. ' +
-            'All other tools will only work within these directories for security.',
-        inputSchema: {},
-        outputSchema: ListAllowedDirectoriesOutputSchema,
-        annotations: {
-            readOnlyHint: true,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-    }, async () => {
-        const dirs = getAllowedDirectories();
-        const count = dirs.length;
-        const hint = count === 0
-            ? 'No directories configured. Server cannot access any files.'
-            : count === 1
-                ? 'Single directory configured. All operations are sandboxed here.'
-                : `${count} directories configured. Operations work across all of them.`;
-        // Check access status for each directory
-        const accessStatus = await Promise.all(dirs.map(checkDirectoryAccess));
-        const structured = {
-            ok: true,
-            allowedDirectories: dirs,
-            count,
-            accessStatus,
-            hint,
-        };
-        return {
-            content: [{ type: 'text', text: formatAllowedDirectories(dirs) }],
-            structuredContent: structured,
-        };
-    });
+    server.registerTool('list_allowed_directories', LIST_ALLOWED_DIRECTORIES_TOOL, async () => await handleListAllowedDirectories());
 }
 //# sourceMappingURL=list-allowed-dirs.js.map

package/dist/tools/list-allowed-dirs.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-allowed-dirs.js","sourceRoot":"","sources":["../../src/tools/list-allowed-dirs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAKvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,kCAAkC,EAAE,MAAM,qBAAqB,CAAC;AAEzE,KAAK,UAAU,oBAAoB,CAAC,OAAe;IACjD,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC5C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAC9D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAC/D,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,MAAiB;IAClE,MAAM,CAAC,YAAY,CACjB,0BAA0B,EAC1B;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EACT,sEAAsE;YACtE,wEAAwE;YACxE,uEAAuE;QACzE,WAAW,EAAE,EAAE;QACf,YAAY,EAAE,kCAAkC;QAChD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,IAAI,EAAE;QACT,MAAM,IAAI,GAAG,qBAAqB,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,MAAM,IAAI,GACR,KAAK,KAAK,CAAC;YACT,CAAC,CAAC,4DAA4D;YAC9D,CAAC,CAAC,KAAK,KAAK,CAAC;gBACX,CAAC,CAAC,iEAAiE;gBACnE,CAAC,CAAC,GAAG,KAAK,8DAA8D,CAAC;QAE/E,yCAAyC;QACzC,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC;QAEvE,MAAM,UAAU,GAAG;YACjB,EAAE,EAAE,IAAI;YACR,kBAAkB,EAAE,IAAI;YACxB,KAAK;YACL,YAAY;YACZ,IAAI;SACL,CAAC;QACF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,CAAC,IAAI,CAAC,EAAE,CAAC;YACjE,iBAAiB,EAAE,UAAU;SAC9B,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"list-allowed-dirs.js","sourceRoot":"","sources":["../../src/tools/list-allowed-dirs.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"list-directory.d.ts","sourceRoot":"","sources":["../../src/tools/list-directory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmBzE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6EjE"}
+{"version":3,"file":"list-directory.d.ts","sourceRoot":"","sources":["../../src/tools/list-directory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmMzE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAQjE"}

package/dist/tools/list-directory.js

@@ -1,75 +1,146 @@
 import * as pathModule from 'node:path';
 import { createErrorResponse, ErrorCode } from '../lib/errors.js';
 import { listDirectory } from '../lib/file-operations.js';
-import { formatDirectoryListing, formatOperationSummary, } from '../lib/formatters.js';
 import { ListDirectoryInputSchema, ListDirectoryOutputSchema, } from '../schemas/index.js';
+import { buildToolResponse } from './tool-response.js';
 function getExtension(name, isFile) {
     if (!isFile)
         return undefined;
     const ext = pathModule.extname(name);
     return ext ? ext.slice(1) : undefined;
 }
-export function registerListDirectoryTool(server) {
-    server.registerTool('list_directory', {
-        title: 'List Directory',
-        description: 'List files and subdirectories in a specified path with optional recursive traversal. ' +
-            'Returns names, types (file/directory/symlink), sizes, and modification dates. ' +
-            'Use recursive=true with maxDepth to explore nested structures. ' +
-            'For a visual tree structure, use directory_tree instead.',
-        inputSchema: ListDirectoryInputSchema,
-        outputSchema: ListDirectoryOutputSchema,
-        annotations: {
-            readOnlyHint: true,
-            idempotentHint: true,
-            openWorldHint: true,
+const BYTE_UNIT_LABELS = ['B', 'KB', 'MB', 'GB', 'TB'];
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const unitIndex = Math.floor(Math.log(bytes) / Math.log(1024));
+    const unit = BYTE_UNIT_LABELS[unitIndex] ?? 'B';
+    const value = bytes / Math.pow(1024, unitIndex);
+    return `${parseFloat(value.toFixed(2))} ${unit}`;
+}
+function formatDirectoryListing(entries, basePath) {
+    if (entries.length === 0)
+        return 'Directory is empty';
+    const dirs = entries.filter((e) => e.type === 'directory');
+    const files = entries.filter((e) => e.type !== 'directory');
+    const lines = [
+        `Contents of ${basePath}:`,
+        '',
+        ...(dirs.length
+            ? [
+                'Directories:',
+                ...dirs.map((dir) => {
+                    const symlink = dir.symlinkTarget ? ` -> ${dir.symlinkTarget}` : '';
+                    return `  [DIR]  ${dir.relativePath}${symlink}`;
+                }),
+                '',
+            ]
+            : []),
+        ...(files.length
+            ? [
+                'Files:',
+                ...files.map((file) => {
+                    const size = file.size !== undefined ? ` (${formatBytes(file.size)})` : '';
+                    const tag = file.type === 'symlink' ? '[LINK]' : '[FILE]';
+                    const symlink = file.symlinkTarget
+                        ? ` -> ${file.symlinkTarget}`
+                        : '';
+                    return `  ${tag} ${file.relativePath}${size}${symlink}`;
+                }),
+            ]
+            : []),
+        '',
+        `Total: ${dirs.length} directories, ${files.length} files`,
+    ];
+    return lines.join('\n');
+}
+function formatOperationSummary(summary) {
+    const lines = [];
+    if (summary.truncated) {
+        lines.push(`\n\n!! PARTIAL RESULTS: ${summary.truncatedReason ?? 'results truncated'}`);
+        if (summary.tip) {
+            lines.push(`Tip: ${summary.tip}`);
+        }
+    }
+    const note = (count, msg) => {
+        if (count && count > 0)
+            lines.push(`Note: ${count} ${msg}`);
+    };
+    note(summary.skippedTooLarge, 'file(s) skipped (too large).');
+    note(summary.skippedBinary, 'file(s) skipped (binary).');
+    note(summary.skippedInaccessible, 'item(s) were inaccessible and skipped.');
+    note(summary.symlinksNotFollowed, 'symlink(s) were not followed (security).');
+    note(summary.linesSkippedDueToRegexTimeout, 'line(s) skipped (regex timeout).');
+    return lines.join('\n');
+}
+const LIST_DIRECTORY_TOOL = {
+    title: 'List Directory',
+    description: 'List files and subdirectories in a specified path with optional recursive traversal. ' +
+        'Returns names, types (file/directory/symlink), sizes, and modification dates. ' +
+        'Use recursive=true with maxDepth to explore nested structures. ' +
+        'For a visual tree structure, use directory_tree instead.',
+    inputSchema: ListDirectoryInputSchema,
+    outputSchema: ListDirectoryOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+};
+function buildStructuredResult(result) {
+    return {
+        ok: true,
+        path: result.path,
+        entries: result.entries.map((e) => ({
+            name: e.relativePath,
+            type: e.type,
+            extension: getExtension(e.relativePath, e.type === 'file'),
+            size: e.size,
+            modified: e.modified?.toISOString(),
+            symlinkTarget: e.symlinkTarget,
+        })),
+        summary: {
+            totalEntries: result.summary.totalEntries,
+            totalFiles: result.summary.totalFiles,
+            totalDirectories: result.summary.totalDirectories,
+            maxDepthReached: result.summary.maxDepthReached,
+            truncated: result.summary.truncated,
+            skippedInaccessible: result.summary.skippedInaccessible,
+            symlinksNotFollowed: result.summary.symlinksNotFollowed,
         },
-    }, async ({ path: dirPath, recursive, includeHidden, maxDepth, maxEntries, sortBy, includeSymlinkTargets, }) => {
+    };
+}
+function buildTextResult(result) {
+    let textOutput = formatDirectoryListing(result.entries, result.path);
+    textOutput += formatOperationSummary({
+        truncated: result.summary.truncated,
+        truncatedReason: `reached max entries limit (${result.summary.totalEntries} returned)`,
+        tip: 'Increase maxEntries or reduce maxDepth to see more results.',
+        skippedInaccessible: result.summary.skippedInaccessible,
+        symlinksNotFollowed: result.summary.symlinksNotFollowed,
+    });
+    return textOutput;
+}
+async function handleListDirectory({ path: dirPath, recursive, includeHidden, maxDepth, maxEntries, sortBy, includeSymlinkTargets, }) {
+    const result = await listDirectory(dirPath, {
+        recursive,
+        includeHidden,
+        maxDepth,
+        maxEntries,
+        sortBy,
+        includeSymlinkTargets,
+    });
+    const structured = buildStructuredResult(result);
+    const textOutput = buildTextResult(result);
+    return buildToolResponse(textOutput, structured);
+}
+export function registerListDirectoryTool(server) {
+    server.registerTool('list_directory', LIST_DIRECTORY_TOOL, async (args) => {
         try {
-            const result = await listDirectory(dirPath, {
-                recursive,
-                includeHidden,
-                maxDepth,
-                maxEntries,
-                sortBy,
-                includeSymlinkTargets,
-            });
-            const structured = {
-                ok: true,
-                path: result.path,
-                entries: result.entries.map((e) => ({
-                    name: e.relativePath,
-                    type: e.type,
-                    extension: getExtension(e.relativePath, e.type === 'file'),
-                    size: e.size,
-                    modified: e.modified?.toISOString(),
-                    symlinkTarget: e.symlinkTarget,
-                })),
-                summary: {
-                    totalEntries: result.summary.totalEntries,
-                    totalFiles: result.summary.totalFiles,
-                    totalDirectories: result.summary.totalDirectories,
-                    maxDepthReached: result.summary.maxDepthReached,
-                    truncated: result.summary.truncated,
-                    skippedInaccessible: result.summary.skippedInaccessible,
-                    symlinksNotFollowed: result.summary.symlinksNotFollowed,
-                },
-            };
-            // Build text output with truncation notice for better error recovery feedback
-            let textOutput = formatDirectoryListing(result.entries, result.path);
-            textOutput += formatOperationSummary({
-                truncated: result.summary.truncated,
-                truncatedReason: `reached max entries limit (${result.summary.totalEntries} returned)`,
-                tip: 'Increase maxEntries or reduce maxDepth to see more results.',
-                skippedInaccessible: result.summary.skippedInaccessible,
-                symlinksNotFollowed: result.summary.symlinksNotFollowed,
-            });
-            return {
-                content: [{ type: 'text', text: textOutput }],
-                structuredContent: structured,
-            };
+            return await handleListDirectory(args);
         }
         catch (error) {
-            return createErrorResponse(error, ErrorCode.E_NOT_DIRECTORY, dirPath);
+            return createErrorResponse(error, ErrorCode.E_NOT_DIRECTORY, args.path);
         }
     });
 }