@j0hanz/filesystem-context-mcp 1.1.0 → 1.2.0

package/dist/tools/search-content.js

@@ -1,100 +1,157 @@
 import * as pathModule from 'node:path';
 import { createErrorResponse, ErrorCode } from '../lib/errors.js';
 import { searchContent } from '../lib/file-operations.js';
-import { formatContentMatches, formatOperationSummary, } from '../lib/formatters.js';
 import { SearchContentInputSchema, SearchContentOutputSchema, } from '../schemas/index.js';
-export function registerSearchContentTool(server) {
-    server.registerTool('search_content', {
-        title: 'Search Content',
-        description: 'Search for text patterns within file contents using regular expressions (grep-like). ' +
-            'Returns matching lines with optional context (contextLines parameter). ' +
-            'Use isLiteral=true for exact string matching, wholeWord=true to avoid partial matches. ' +
-            'Filter files with filePattern glob (e.g., "**/*.ts" for TypeScript only). ' +
-            'Automatically skips binary files unless skipBinary=false.',
-        inputSchema: SearchContentInputSchema,
-        outputSchema: SearchContentOutputSchema,
-        annotations: {
-            readOnlyHint: true,
-            idempotentHint: true,
-            openWorldHint: true,
+import { buildToolResponse } from './tool-response.js';
+const LINE_NUMBER_PAD_WIDTH = 4;
+function formatContentMatches(matches) {
+    if (matches.length === 0)
+        return 'No matches found';
+    const byFile = new Map();
+    for (const match of matches) {
+        const list = byFile.get(match.file) ?? [];
+        list.push(match);
+        byFile.set(match.file, list);
+    }
+    const formatContext = (context, startLine) => (context ?? []).map((line, idx) => `    ${String(startLine + idx).padStart(LINE_NUMBER_PAD_WIDTH)}: ${line}`);
+    const lines = [`Found ${matches.length} matches:`, ''];
+    for (const [file, fileMatches] of byFile) {
+        lines.push(`${file}:`);
+        for (const match of fileMatches) {
+            const before = formatContext(match.contextBefore, match.line - (match.contextBefore?.length ?? 0));
+            const after = formatContext(match.contextAfter, match.line + 1);
+            lines.push(...before);
+            lines.push(`  > ${String(match.line).padStart(LINE_NUMBER_PAD_WIDTH)}: ${match.content}`);
+            lines.push(...after);
+            if (before.length || after.length)
+                lines.push('    ---');
+        }
+        lines.push('');
+    }
+    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,
+        basePath: result.basePath,
+        pattern: result.pattern,
+        filePattern: result.filePattern,
+        matches: result.matches.map((m) => ({
+            file: pathModule.relative(result.basePath, m.file),
+            line: m.line,
+            content: m.content,
+            contextBefore: m.contextBefore,
+            contextAfter: m.contextAfter,
+            matchCount: m.matchCount,
+        })),
+        summary: {
+            filesScanned: result.summary.filesScanned,
+            filesMatched: result.summary.filesMatched,
+            totalMatches: result.summary.matches,
+            truncated: result.summary.truncated,
+            skippedTooLarge: result.summary.skippedTooLarge || undefined,
+            skippedBinary: result.summary.skippedBinary || undefined,
+            skippedInaccessible: result.summary.skippedInaccessible || undefined,
+            linesSkippedDueToRegexTimeout: result.summary.linesSkippedDueToRegexTimeout || undefined,
+            stoppedReason: result.summary.stoppedReason,
         },
-    }, async ({ path: searchBasePath, pattern, filePattern, excludePatterns, caseSensitive, maxResults, maxFileSize, maxFilesScanned, timeoutMs, skipBinary, contextLines, wholeWord, isLiteral, }) => {
+    };
+}
+function buildTruncationInfo(result) {
+    if (!result.summary.truncated)
+        return {};
+    if (result.summary.stoppedReason === 'timeout') {
+        return {
+            truncatedReason: 'search timed out',
+            tip: 'Increase timeoutMs, use more specific filePattern, or add excludePatterns to narrow scope.',
+        };
+    }
+    if (result.summary.stoppedReason === 'maxResults') {
+        return {
+            truncatedReason: `reached max results limit (${result.summary.matches})`,
+        };
+    }
+    if (result.summary.stoppedReason === 'maxFiles') {
+        return {
+            truncatedReason: `reached max files limit (${result.summary.filesScanned} scanned)`,
+        };
+    }
+    return {};
+}
+function buildTextResult(result) {
+    const { truncatedReason, tip } = buildTruncationInfo(result);
+    let textOutput = formatContentMatches(result.matches);
+    textOutput += formatOperationSummary({
+        truncated: result.summary.truncated,
+        truncatedReason,
+        tip,
+        skippedTooLarge: result.summary.skippedTooLarge,
+        skippedBinary: result.summary.skippedBinary,
+        skippedInaccessible: result.summary.skippedInaccessible,
+        linesSkippedDueToRegexTimeout: result.summary.linesSkippedDueToRegexTimeout,
+    });
+    if (result.summary.truncated && !tip) {
+        textOutput += `\nScanned ${result.summary.filesScanned} files, found ${result.summary.matches} matches in ${result.summary.filesMatched} files.`;
+    }
+    return textOutput;
+}
+async function handleSearchContent({ path: searchBasePath, pattern, filePattern, excludePatterns, caseSensitive, maxResults, maxFileSize, maxFilesScanned, timeoutMs, skipBinary, includeHidden, contextLines, wholeWord, isLiteral, }) {
+    const result = await searchContent(searchBasePath, pattern, {
+        filePattern,
+        excludePatterns,
+        caseSensitive,
+        maxResults,
+        maxFileSize,
+        maxFilesScanned,
+        timeoutMs,
+        skipBinary,
+        includeHidden,
+        contextLines,
+        wholeWord,
+        isLiteral,
+    });
+    return buildToolResponse(buildTextResult(result), buildStructuredResult(result));
+}
+const SEARCH_CONTENT_TOOL = {
+    title: 'Search Content',
+    description: 'Search for text patterns within file contents using regular expressions (grep-like). ' +
+        'Returns matching lines with optional context (contextLines parameter). ' +
+        'Use isLiteral=true for exact string matching, wholeWord=true to avoid partial matches. ' +
+        'Filter files with filePattern glob (e.g., "**/*.ts" for TypeScript only). ' +
+        'Automatically skips binary files unless skipBinary=false.',
+    inputSchema: SearchContentInputSchema,
+    outputSchema: SearchContentOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+};
+export function registerSearchContentTool(server) {
+    server.registerTool('search_content', SEARCH_CONTENT_TOOL, async (args) => {
         try {
-            const result = await searchContent(searchBasePath, pattern, {
-                filePattern,
-                excludePatterns,
-                caseSensitive,
-                maxResults,
-                maxFileSize,
-                maxFilesScanned,
-                timeoutMs,
-                skipBinary,
-                contextLines,
-                wholeWord,
-                isLiteral,
-            });
-            const structured = {
-                ok: true,
-                basePath: result.basePath,
-                pattern: result.pattern,
-                filePattern: result.filePattern,
-                matches: result.matches.map((m) => ({
-                    file: pathModule.relative(result.basePath, m.file),
-                    line: m.line,
-                    content: m.content,
-                    contextBefore: m.contextBefore,
-                    contextAfter: m.contextAfter,
-                    matchCount: m.matchCount,
-                })),
-                summary: {
-                    filesScanned: result.summary.filesScanned,
-                    filesMatched: result.summary.filesMatched,
-                    totalMatches: result.summary.matches,
-                    truncated: result.summary.truncated,
-                    skippedTooLarge: result.summary.skippedTooLarge || undefined,
-                    skippedBinary: result.summary.skippedBinary || undefined,
-                    skippedInaccessible: result.summary.skippedInaccessible || undefined,
-                    linesSkippedDueToRegexTimeout: result.summary.linesSkippedDueToRegexTimeout || undefined,
-                    stoppedReason: result.summary.stoppedReason,
-                },
-            };
-            // Build text output with truncation notice for better error recovery feedback
-            let textOutput = formatContentMatches(result.matches);
-            // Determine truncation reason and tip
-            let truncatedReason;
-            let tip;
-            if (result.summary.truncated) {
-                if (result.summary.stoppedReason === 'timeout') {
-                    truncatedReason = 'search timed out';
-                    tip =
-                        'Increase timeoutMs, use more specific filePattern, or add excludePatterns to narrow scope.';
-                }
-                else if (result.summary.stoppedReason === 'maxResults') {
-                    truncatedReason = `reached max results limit (${result.summary.matches})`;
-                }
-                else if (result.summary.stoppedReason === 'maxFiles') {
-                    truncatedReason = `reached max files limit (${result.summary.filesScanned} scanned)`;
-                }
-            }
-            textOutput += formatOperationSummary({
-                truncated: result.summary.truncated,
-                truncatedReason,
-                tip,
-                skippedTooLarge: result.summary.skippedTooLarge,
-                skippedBinary: result.summary.skippedBinary,
-                skippedInaccessible: result.summary.skippedInaccessible,
-                linesSkippedDueToRegexTimeout: result.summary.linesSkippedDueToRegexTimeout,
-            });
-            if (result.summary.truncated && !tip) {
-                textOutput += `\nScanned ${result.summary.filesScanned} files, found ${result.summary.matches} matches in ${result.summary.filesMatched} files.`;
-            }
-            return {
-                content: [{ type: 'text', text: textOutput }],
-                structuredContent: structured,
-            };
+            return await handleSearchContent(args);
         }
         catch (error) {
-            return createErrorResponse(error, ErrorCode.E_UNKNOWN, searchBasePath);
+            return createErrorResponse(error, ErrorCode.E_UNKNOWN, args.path);
         }
     });
 }

package/dist/tools/search-content.js.map

@@ -1 +1 @@
-{"version":3,"file":"search-content.js","sourceRoot":"","sources":["../../src/tools/search-content.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,WAAW,CAAC;AAIxC,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,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,uFAAuF;YACvF,yEAAyE;YACzE,yFAAyF;YACzF,4EAA4E;YAC5E,2DAA2D;QAC7D,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,EAAE,cAAc,EACpB,OAAO,EACP,WAAW,EACX,eAAe,EACf,aAAa,EACb,UAAU,EACV,WAAW,EACX,eAAe,EACf,SAAS,EACT,UAAU,EACV,YAAY,EACZ,SAAS,EACT,SAAS,GACV,EAAE,EAAE;QACH,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,cAAc,EAAE,OAAO,EAAE;gBAC1D,WAAW;gBACX,eAAe;gBACf,aAAa;gBACb,UAAU;gBACV,WAAW;gBACX,eAAe;gBACf,SAAS;gBACT,UAAU;gBACV,YAAY;gBACZ,SAAS;gBACT,SAAS;aACV,CAAC,CAAC;YACH,MAAM,UAAU,GAAG;gBACjB,EAAE,EAAE,IAAI;gBACR,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAClC,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC;oBAClD,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,aAAa,EAAE,CAAC,CAAC,aAAa;oBAC9B,YAAY,EAAE,CAAC,CAAC,YAAY;oBAC5B,UAAU,EAAE,CAAC,CAAC,UAAU;iBACzB,CAAC,CAAC;gBACH,OAAO,EAAE;oBACP,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,YAAY;oBACzC,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,YAAY;oBACzC,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO;oBACpC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS;oBACnC,eAAe,EAAE,MAAM,CAAC,OAAO,CAAC,eAAe,IAAI,SAAS;oBAC5D,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,aAAa,IAAI,SAAS;oBACxD,mBAAmB,EACjB,MAAM,CAAC,OAAO,CAAC,mBAAmB,IAAI,SAAS;oBACjD,6BAA6B,EAC3B,MAAM,CAAC,OAAO,CAAC,6BAA6B,IAAI,SAAS;oBAC3D,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,aAAa;iBAC5C;aACF,CAAC;YAEF,8EAA8E;YAC9E,IAAI,UAAU,GAAG,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAEtD,sCAAsC;YACtC,IAAI,eAAmC,CAAC;YACxC,IAAI,GAAuB,CAAC;YAE5B,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;gBAC7B,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;oBAC/C,eAAe,GAAG,kBAAkB,CAAC;oBACrC,GAAG;wBACD,4FAA4F,CAAC;gBACjG,CAAC;qBAAM,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,KAAK,YAAY,EAAE,CAAC;oBACzD,eAAe,GAAG,8BAA8B,MAAM,CAAC,OAAO,CAAC,OAAO,GAAG,CAAC;gBAC5E,CAAC;qBAAM,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;oBACvD,eAAe,GAAG,4BAA4B,MAAM,CAAC,OAAO,CAAC,YAAY,WAAW,CAAC;gBACvF,CAAC;YACH,CAAC;YAED,UAAU,IAAI,sBAAsB,CAAC;gBACnC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS;gBACnC,eAAe;gBACf,GAAG;gBACH,eAAe,EAAE,MAAM,CAAC,OAAO,CAAC,eAAe;gBAC/C,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,aAAa;gBAC3C,mBAAmB,EAAE,MAAM,CAAC,OAAO,CAAC,mBAAmB;gBACvD,6BAA6B,EAC3B,MAAM,CAAC,OAAO,CAAC,6BAA6B;aAC/C,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,GAAG,EAAE,CAAC;gBACrC,UAAU,IAAI,aAAa,MAAM,CAAC,OAAO,CAAC,YAAY,iBAAiB,MAAM,CAAC,OAAO,CAAC,OAAO,eAAe,MAAM,CAAC,OAAO,CAAC,YAAY,SAAS,CAAC;YACnJ,CAAC;YAED,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,SAAS,EAAE,cAAc,CAAC,CAAC;QACzE,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"search-content.js","sourceRoot":"","sources":["../../src/tools/search-content.ts"],"names":[],"mappings":"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"}

package/dist/tools/search-files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-files.d.ts","sourceRoot":"","sources":["../../src/tools/search-files.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAazE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6E/D"}
+{"version":3,"file":"search-files.d.ts","sourceRoot":"","sources":["../../src/tools/search-files.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsLzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAQ/D"}

package/dist/tools/search-files.js

@@ -1,61 +1,132 @@
 import * as pathModule from 'node:path';
 import { createErrorResponse, ErrorCode } from '../lib/errors.js';
 import { searchFiles } from '../lib/file-operations.js';
-import { formatOperationSummary, formatSearchResults, } from '../lib/formatters.js';
 import { SearchFilesInputSchema, SearchFilesOutputSchema, } from '../schemas/index.js';
-export function registerSearchFilesTool(server) {
-    server.registerTool('search_files', {
-        title: 'Search Files',
-        description: 'Find files matching a glob pattern within a directory tree. ' +
-            'Pattern examples: "**/*.ts" (all TypeScript files), "src/**/*.{js,jsx}" (JS/JSX in src), ' +
-            '"**/test/**" (all test directories). Returns paths, types, sizes, and modification dates. ' +
-            'Use excludePatterns to skip directories like node_modules.',
-        inputSchema: SearchFilesInputSchema,
-        outputSchema: SearchFilesOutputSchema,
-        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 formatSearchResults(results) {
+    if (results.length === 0)
+        return 'No matches found';
+    const lines = [`Found ${results.length} matches:`, ''];
+    for (const result of results) {
+        const tag = result.type === 'directory' ? '[DIR]' : '[FILE]';
+        const size = result.size !== undefined ? ` (${formatBytes(result.size)})` : '';
+        lines.push(`${tag} ${result.path}${size}`);
+    }
+    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,
+        basePath: result.basePath,
+        pattern: result.pattern,
+        results: result.results.map((r) => ({
+            path: pathModule.relative(result.basePath, r.path),
+            type: r.type,
+            size: r.size,
+            modified: r.modified?.toISOString(),
+        })),
+        summary: {
+            matched: result.summary.matched,
+            truncated: result.summary.truncated,
+            skippedInaccessible: result.summary.skippedInaccessible,
+            filesScanned: result.summary.filesScanned,
+            stoppedReason: result.summary.stoppedReason,
         },
-    }, async ({ path: searchBasePath, pattern, excludePatterns, maxResults, sortBy, maxDepth, }) => {
+    };
+}
+function buildTruncationInfo(result) {
+    if (!result.summary.truncated)
+        return {};
+    if (result.summary.stoppedReason === 'timeout') {
+        return {
+            truncatedReason: 'search timed out',
+            tip: 'Increase timeoutMs, use a more specific pattern, or add excludePatterns to narrow scope.',
+        };
+    }
+    if (result.summary.stoppedReason === 'maxResults') {
+        return {
+            truncatedReason: `reached max results limit (${result.summary.matched} returned)`,
+        };
+    }
+    if (result.summary.stoppedReason === 'maxFiles') {
+        return {
+            truncatedReason: `reached max files limit (${result.summary.filesScanned} scanned)`,
+        };
+    }
+    return {};
+}
+function buildTextResult(result) {
+    const { truncatedReason, tip } = buildTruncationInfo(result);
+    let textOutput = formatSearchResults(result.results);
+    textOutput += formatOperationSummary({
+        truncated: result.summary.truncated,
+        truncatedReason,
+        tip: tip ??
+            (result.summary.truncated
+                ? 'Increase maxResults, use more specific pattern, or add excludePatterns to narrow scope.'
+                : undefined),
+        skippedInaccessible: result.summary.skippedInaccessible,
+    });
+    return textOutput;
+}
+async function handleSearchFiles({ path: searchBasePath, pattern, excludePatterns, maxResults, sortBy, maxDepth, maxFilesScanned, timeoutMs, }) {
+    const result = await searchFiles(searchBasePath, pattern, excludePatterns, {
+        maxResults,
+        sortBy,
+        maxDepth,
+        maxFilesScanned,
+        timeoutMs,
+    });
+    return buildToolResponse(buildTextResult(result), buildStructuredResult(result));
+}
+const SEARCH_FILES_TOOL = {
+    title: 'Search Files',
+    description: 'Find files matching a glob pattern within a directory tree. ' +
+        'Pattern examples: "**/*.ts" (all TypeScript files), "src/**/*.{js,jsx}" (JS/JSX in src), ' +
+        '"**/test/**" (all test directories). Returns paths, types, sizes, and modification dates. ' +
+        'Use excludePatterns to skip directories like node_modules.',
+    inputSchema: SearchFilesInputSchema,
+    outputSchema: SearchFilesOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+};
+export function registerSearchFilesTool(server) {
+    server.registerTool('search_files', SEARCH_FILES_TOOL, async (args) => {
         try {
-            const result = await searchFiles(searchBasePath, pattern, excludePatterns, {
-                maxResults,
-                sortBy,
-                maxDepth,
-            });
-            const structured = {
-                ok: true,
-                basePath: result.basePath,
-                pattern: result.pattern,
-                results: result.results.map((r) => ({
-                    path: pathModule.relative(result.basePath, r.path),
-                    type: r.type,
-                    size: r.size,
-                    modified: r.modified?.toISOString(),
-                })),
-                summary: {
-                    matched: result.summary.matched,
-                    truncated: result.summary.truncated,
-                    skippedInaccessible: result.summary.skippedInaccessible,
-                    filesScanned: result.summary.filesScanned,
-                },
-            };
-            // Build text output with truncation notice for better error recovery feedback
-            let textOutput = formatSearchResults(result.results);
-            textOutput += formatOperationSummary({
-                truncated: result.summary.truncated,
-                truncatedReason: `reached max results limit (${result.summary.matched} returned)`,
-                tip: 'Increase maxResults, use more specific pattern, or add excludePatterns to narrow scope.',
-                skippedInaccessible: result.summary.skippedInaccessible,
-            });
-            return {
-                content: [{ type: 'text', text: textOutput }],
-                structuredContent: structured,
-            };
+            return await handleSearchFiles(args);
         }
         catch (error) {
-            return createErrorResponse(error, ErrorCode.E_INVALID_PATTERN, searchBasePath);
+            return createErrorResponse(error, ErrorCode.E_INVALID_PATTERN, args.path);
         }
     });
 }

package/dist/tools/search-files.js.map

@@ -1 +1 @@
-{"version":3,"file":"search-files.js","sourceRoot":"","sources":["../../src/tools/search-files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,WAAW,CAAC;AAIxC,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EACL,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EACT,8DAA8D;YAC9D,2FAA2F;YAC3F,4FAA4F;YAC5F,4DAA4D;QAC9D,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,EACL,IAAI,EAAE,cAAc,EACpB,OAAO,EACP,eAAe,EACf,UAAU,EACV,MAAM,EACN,QAAQ,GACT,EAAE,EAAE;QACH,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B,cAAc,EACd,OAAO,EACP,eAAe,EACf;gBACE,UAAU;gBACV,MAAM;gBACN,QAAQ;aACT,CACF,CAAC;YACF,MAAM,UAAU,GAAG;gBACjB,EAAE,EAAE,IAAI;gBACR,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAClC,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC;oBAClD,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE;iBACpC,CAAC,CAAC;gBACH,OAAO,EAAE;oBACP,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO;oBAC/B,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS;oBACnC,mBAAmB,EAAE,MAAM,CAAC,OAAO,CAAC,mBAAmB;oBACvD,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,YAAY;iBAC1C;aACF,CAAC;YAEF,8EAA8E;YAC9E,IAAI,UAAU,GAAG,mBAAmB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACrD,UAAU,IAAI,sBAAsB,CAAC;gBACnC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS;gBACnC,eAAe,EAAE,8BAA8B,MAAM,CAAC,OAAO,CAAC,OAAO,YAAY;gBACjF,GAAG,EAAE,yFAAyF;gBAC9F,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,CACxB,KAAK,EACL,SAAS,CAAC,iBAAiB,EAC3B,cAAc,CACf,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"search-files.js","sourceRoot":"","sources":["../../src/tools/search-files.ts"],"names":[],"mappings":"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"}

package/dist/tools/tool-response.d.ts

@@ -0,0 +1,9 @@
+export declare function buildToolResponse<T>(text: string, structuredContent: T): {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    structuredContent: T;
+};
+export type ToolResponse<T> = ReturnType<typeof buildToolResponse<T>>;
+//# sourceMappingURL=tool-response.d.ts.map

package/dist/tools/tool-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-response.d.ts","sourceRoot":"","sources":["../../src/tools/tool-response.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,IAAI,EAAE,MAAM,EACZ,iBAAiB,EAAE,CAAC,GACnB;IACD,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,iBAAiB,EAAE,CAAC,CAAC;CACtB,CAKA;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/tools/tool-response.js

@@ -0,0 +1,7 @@
+export function buildToolResponse(text, structuredContent) {
+    return {
+        content: [{ type: 'text', text }],
+        structuredContent,
+    };
+}
+//# sourceMappingURL=tool-response.js.map

package/dist/tools/tool-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-response.js","sourceRoot":"","sources":["../../src/tools/tool-response.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,iBAAoB;IAKpB,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACjC,iBAAiB;KAClB,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@j0hanz/filesystem-context-mcp",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "mcpName": "io.github.j0hanz/filesystem-context",
   "description": "🔍 Read-only MCP server for secure filesystem exploration, searching, and analysis",
   "type": "module",
@@ -29,6 +29,7 @@
     "lint": "eslint .",
     "format": "prettier --write .",
     "type-check": "tsc --noEmit",
+    "bench": "tsx scripts/benchmarks.ts",
     "inspector": "npx @modelcontextprotocol/inspector",
     "prepublishOnly": "npm run lint && npm run type-check && npm run build"
   },

package/dist/__tests__/errors.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=errors.test.d.ts.map

package/dist/__tests__/errors.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/errors.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/errors.test.js

@@ -1,88 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { classifyError, createDetailedError, ErrorCode, formatDetailedError, getSuggestion, } from '../lib/errors.js';
-describe('Error Utilities', () => {
-    describe('classifyError', () => {
-        it('should classify access denied errors', () => {
-            const error = new Error('Path not within allowed directories');
-            expect(classifyError(error)).toBe(ErrorCode.E_ACCESS_DENIED);
-        });
-        it('should classify not found errors', () => {
-            const error = new Error('ENOENT: no such file or directory');
-            expect(classifyError(error)).toBe(ErrorCode.E_NOT_FOUND);
-        });
-        it('should classify not a file errors', () => {
-            const error = new Error('Not a file: /some/path');
-            expect(classifyError(error)).toBe(ErrorCode.E_NOT_FILE);
-        });
-        it('should classify file too large errors', () => {
-            const error = new Error('File too large: 100MB');
-            expect(classifyError(error)).toBe(ErrorCode.E_TOO_LARGE);
-        });
-        it('should classify permission errors', () => {
-            const error = new Error('EACCES: permission denied');
-            expect(classifyError(error)).toBe(ErrorCode.E_PERMISSION_DENIED);
-        });
-        it('should classify timeout errors', () => {
-            const error = new Error('Operation timeout');
-            expect(classifyError(error)).toBe(ErrorCode.E_TIMEOUT);
-        });
-        it('should return unknown for unrecognized errors', () => {
-            const error = new Error('Some random error');
-            expect(classifyError(error)).toBe(ErrorCode.E_UNKNOWN);
-        });
-        it('should handle non-Error objects', () => {
-            expect(classifyError('ENOENT error')).toBe(ErrorCode.E_NOT_FOUND);
-            expect(classifyError({ message: 'permission denied' })).toBe(ErrorCode.E_UNKNOWN);
-        });
-    });
-    describe('createDetailedError', () => {
-        it('should create detailed error object', () => {
-            const error = new Error('File not found');
-            const detailed = createDetailedError(error, '/some/path');
-            expect(detailed.code).toBe(ErrorCode.E_NOT_FOUND);
-            expect(detailed.message).toBe('File not found');
-            expect(detailed.path).toBe('/some/path');
-            expect(detailed.suggestion).toBeTruthy();
-        });
-        it('should include additional details', () => {
-            const error = new Error('Error');
-            const detailed = createDetailedError(error, '/path', { extra: 'info' });
-            expect(detailed.details).toEqual({ extra: 'info' });
-        });
-    });
-    describe('formatDetailedError', () => {
-        it('should format error for display', () => {
-            const detailed = {
-                code: ErrorCode.E_NOT_FOUND,
-                message: 'File not found',
-                path: '/some/path',
-                suggestion: 'Check the path exists',
-            };
-            const formatted = formatDetailedError(detailed);
-            expect(formatted).toContain('E_NOT_FOUND');
-            expect(formatted).toContain('File not found');
-            expect(formatted).toContain('/some/path');
-            expect(formatted).toContain('Check the path exists');
-        });
-        it('should handle missing optional fields', () => {
-            const detailed = {
-                code: ErrorCode.E_UNKNOWN,
-                message: 'Unknown error',
-            };
-            const formatted = formatDetailedError(detailed);
-            expect(formatted).toContain('E_UNKNOWN');
-            expect(formatted).toContain('Unknown error');
-        });
-    });
-    describe('getSuggestion', () => {
-        it('should return suggestions for all error codes', () => {
-            const errorCodes = Object.values(ErrorCode);
-            for (const code of errorCodes) {
-                const suggestion = getSuggestion(code);
-                expect(suggestion).toBeTruthy();
-                expect(typeof suggestion).toBe('string');
-            }
-        });
-    });
-});
-//# sourceMappingURL=errors.test.js.map

package/dist/__tests__/errors.test.js.map

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

package/dist/__tests__/file-operations.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=file-operations.test.d.ts.map