@j0hanz/filesystem-context-mcp 1.2.9 → 1.3.1

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

@@ -1 +1 @@
-{"version":3,"file":"search-definitions.js","sourceRoot":"","sources":["../../src/tools/search-definitions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"search-definitions.js","sourceRoot":"","sources":["../../src/tools/search-definitions.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;AAwJzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAY/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;AA0MzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAY/D"}

package/dist/tools/search-files.js

@@ -1,37 +1,38 @@
 import * as pathModule from 'node:path';
-import { ErrorCode, toRpcError } from '../lib/errors.js';
+import { formatBytes, formatOperationSummary, joinLines, } from '../config/formatting.js';
+import { DEFAULT_EXCLUDE_PATTERNS, DEFAULT_MAX_DEPTH, DEFAULT_MAX_RESULTS, DEFAULT_SEARCH_MAX_FILES, DEFAULT_SEARCH_TIMEOUT_MS, } from '../lib/constants.js';
+import { ErrorCode } from '../lib/errors.js';
 import { searchFiles } from '../lib/file-operations.js';
 import { SearchFilesInputSchema, SearchFilesOutputSchema, } from '../schemas/index.js';
-import { formatBytes, formatOperationSummary } from './shared/formatting.js';
-import { buildToolResponse } from './tool-response.js';
-function formatSearchResults(results) {
+import { buildToolErrorResponse, buildToolResponse, withToolErrorHandling, } from './tool-response.js';
+function formatSearchResults(results, basePath) {
     if (results.length === 0)
-        return 'No matches found';
-    const lines = [`Found ${results.length} matches:`, ''];
-    for (const result of results) {
+        return 'No matches';
+    const lines = results.map((result) => {
         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');
+        return `${tag} ${pathModule.relative(basePath, result.path)}${size}`;
+    });
+    return joinLines([`Found ${results.length}:`, ...lines]);
 }
 function buildStructuredResult(result) {
+    const { basePath, pattern, results, summary } = 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,
+        basePath,
+        pattern,
+        results: results.map((r) => ({
+            path: pathModule.relative(basePath, r.path),
+            type: r.type === 'directory' ? 'other' : 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,
+            matched: summary.matched,
+            truncated: summary.truncated,
+            skippedInaccessible: summary.skippedInaccessible,
+            filesScanned: summary.filesScanned,
+            stoppedReason: summary.stoppedReason,
         },
     };
 }
@@ -57,38 +58,63 @@ function buildTruncationInfo(result) {
     return {};
 }
 function buildTextResult(result) {
+    const { summary, results } = result;
     const { truncatedReason, tip } = buildTruncationInfo(result);
-    let textOutput = formatSearchResults(result.results);
+    const header = joinLines([
+        `Base path: ${result.basePath}`,
+        `Pattern: ${result.pattern}`,
+    ]);
+    const body = formatSearchResults(results, result.basePath);
+    let textOutput = joinLines([header, body]);
+    if (results.length === 0) {
+        textOutput +=
+            '\n(Try a broader pattern, remove excludePatterns, or set includeHidden=true if searching dotfiles.)';
+    }
     textOutput += formatOperationSummary({
-        truncated: result.summary.truncated,
+        truncated: summary.truncated,
         truncatedReason,
         tip: tip ??
-            (result.summary.truncated
+            (summary.truncated
                 ? 'Increase maxResults, use more specific pattern, or add excludePatterns to narrow scope.'
                 : undefined),
-        skippedInaccessible: result.summary.skippedInaccessible,
+        skippedInaccessible: summary.skippedInaccessible,
     });
     return textOutput;
 }
-async function handleSearchFiles({ path: searchBasePath, pattern, excludePatterns, maxResults, sortBy, maxDepth, maxFilesScanned, timeoutMs, baseNameMatch, skipSymlinks, includeHidden, }) {
-    const result = await searchFiles(searchBasePath, pattern, excludePatterns, {
-        maxResults,
-        sortBy,
-        maxDepth,
-        maxFilesScanned,
-        timeoutMs,
-        baseNameMatch,
-        skipSymlinks,
-        includeHidden,
+async function handleSearchFiles({ path: searchBasePath, pattern, excludePatterns, maxResults, sortBy, maxDepth, maxFilesScanned, timeoutMs, baseNameMatch, skipSymlinks, includeHidden, }, signal) {
+    const effectiveOptions = {
+        excludePatterns: excludePatterns ?? DEFAULT_EXCLUDE_PATTERNS,
+        maxResults: maxResults ?? DEFAULT_MAX_RESULTS,
+        sortBy: sortBy ?? 'path',
+        maxDepth: maxDepth ?? DEFAULT_MAX_DEPTH,
+        maxFilesScanned: maxFilesScanned ?? DEFAULT_SEARCH_MAX_FILES,
+        timeoutMs: timeoutMs ?? DEFAULT_SEARCH_TIMEOUT_MS,
+        baseNameMatch: baseNameMatch ?? false,
+        skipSymlinks: skipSymlinks ?? true,
+        includeHidden: includeHidden ?? false,
+    };
+    const result = await searchFiles(searchBasePath, pattern, effectiveOptions.excludePatterns, {
+        maxResults: effectiveOptions.maxResults,
+        sortBy: effectiveOptions.sortBy,
+        maxDepth: effectiveOptions.maxDepth,
+        maxFilesScanned: effectiveOptions.maxFilesScanned,
+        timeoutMs: effectiveOptions.timeoutMs,
+        baseNameMatch: effectiveOptions.baseNameMatch,
+        skipSymlinks: effectiveOptions.skipSymlinks,
+        includeHidden: effectiveOptions.includeHidden,
+        signal,
     });
-    return buildToolResponse(buildTextResult(result), buildStructuredResult(result));
+    const structured = buildStructuredResult(result);
+    structured.effectiveOptions = effectiveOptions;
+    return buildToolResponse(buildTextResult(result), structured);
 }
 const SEARCH_FILES_TOOL = {
     title: 'Search Files',
-    description: 'Find files matching a glob pattern within a directory tree. ' +
+    description: 'Find files (not directories) 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, and includeHidden=true to include dotfiles.',
+        'excludePatterns defaults to common dependency/build dirs (pass [] to disable). ' +
+        'Symlink traversal is disabled (skipSymlinks must remain true).',
     inputSchema: SearchFilesInputSchema,
     outputSchema: SearchFilesOutputSchema.shape,
     annotations: {
@@ -98,13 +124,7 @@ const SEARCH_FILES_TOOL = {
     },
 };
 export function registerSearchFilesTool(server) {
-    server.registerTool('search_files', SEARCH_FILES_TOOL, async (args) => {
-        try {
-            return await handleSearchFiles(args);
-        }
-        catch (error) {
-            throw toRpcError(error, ErrorCode.E_INVALID_PATTERN, args.path);
-        }
-    });
+    const handler = (args, extra) => withToolErrorHandling(() => handleSearchFiles(args, extra.signal), (error) => buildToolErrorResponse(error, ErrorCode.E_INVALID_PATTERN, args.path));
+    server.registerTool('search_files', SEARCH_FILES_TOOL, handler);
 }
 //# sourceMappingURL=search-files.js.map

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

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

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

@@ -0,0 +1,17 @@
+import type { FileInfo } from '../../config/types.js';
+export declare function buildFileInfoPayload(info: FileInfo): {
+    name: string;
+    path: string;
+    type: FileInfo['type'];
+    size: number;
+    created: string;
+    modified: string;
+    accessed: string;
+    permissions: string;
+    isHidden: boolean;
+    mimeType?: string;
+    symlinkTarget?: string;
+};
+export declare function formatFileInfoDetails(info: FileInfo): string;
+export declare function formatFileInfoSummary(path: string, info: FileInfo): string;
+//# sourceMappingURL=file-info.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-info.d.ts","sourceRoot":"","sources":["../../../src/tools/shared/file-info.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,GAAG;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAcA;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAmB5D;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAG1E"}

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

@@ -0,0 +1,40 @@
+import { formatBytes, formatDate, joinLines } from '../../config/formatting.js';
+export function buildFileInfoPayload(info) {
+    return {
+        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,
+    };
+}
+export function formatFileInfoDetails(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 joinLines(lines);
+}
+export function formatFileInfoSummary(path, info) {
+    const mime = info.mimeType ? ` | ${info.mimeType}` : '';
+    return `${path} | ${info.type} | ${formatBytes(info.size)}${mime}`;
+}
+//# sourceMappingURL=file-info.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-info.js","sourceRoot":"","sources":["../../../src/tools/shared/file-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAGhF,MAAM,UAAU,oBAAoB,CAAC,IAAc;IAajD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE;QACnC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE;QACrC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE;QACrC,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,aAAa,EAAE,IAAI,CAAC,aAAa;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAc;IAClD,MAAM,KAAK,GAAG;QACZ,SAAS,IAAI,CAAC,IAAI,EAAE;QACpB,SAAS,IAAI,CAAC,IAAI,EAAE;QACpB,SAAS,IAAI,CAAC,IAAI,EAAE;QACpB,SAAS,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACjC,YAAY,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;QACtC,aAAa,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;QACxC,aAAa,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;QACxC,gBAAgB,IAAI,CAAC,WAAW,EAAE;QAClC,WAAW,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;KAC1C,CAAC;IAEF,IAAI,IAAI,CAAC,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC7D,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,mBAAmB,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,IAAc;IAChE,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,OAAO,GAAG,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;AACrE,CAAC"}

package/dist/tools/shared/formatting.d.ts

@@ -1,5 +1,10 @@
 export declare function formatBytes(bytes: number): string;
 export declare function formatDate(date: Date): string;
+export declare function joinLines(lines: string[]): string;
+export declare function indent(text: string, spaces?: number): string;
+export declare function formatList(items: string[], indentLevel?: number): string;
+export declare function formatHeader(title: string, level?: number): string;
+export declare function formatSection(title: string, content: string): string;
 export declare function formatOperationSummary(summary: {
     truncated?: boolean;
     truncatedReason?: string;

package/dist/tools/shared/formatting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../../src/tools/shared/formatting.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE7C;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6BAA6B,CAAC,EAAE,MAAM,CAAC;CACxC,GAAG,MAAM,CAoBT"}
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../../src/tools/shared/formatting.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE7C;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAEjD;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU,GAAG,MAAM,CAG/D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,WAAW,GAAE,MAAU,GAAG,MAAM,CAG3E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,CAKrE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6BAA6B,CAAC,EAAE,MAAM,CAAC;CACxC,GAAG,MAAM,CAoBT"}

package/dist/tools/shared/formatting.js

@@ -10,6 +10,26 @@ export function formatBytes(bytes) {
 export function formatDate(date) {
     return date.toISOString();
 }
+export function joinLines(lines) {
+    return lines.join('\n');
+}
+export function indent(text, spaces = 2) {
+    const padding = ' '.repeat(spaces);
+    return text.split('\n').map((line) => `${padding}${line}`).join('\n');
+}
+export function formatList(items, indentLevel = 0) {
+    const padding = ' '.repeat(indentLevel * 2);
+    return items.map((item) => `${padding}- ${item}`).join('\n');
+}
+export function formatHeader(title, level = 1) {
+    if (level === 1) {
+        return `=== ${title} ===`;
+    }
+    return `--- ${title} ---`;
+}
+export function formatSection(title, content) {
+    return `${formatHeader(title)}\n${content}`;
+}
 export function formatOperationSummary(summary) {
     const lines = [];
     if (summary.truncated) {
@@ -26,6 +46,6 @@ export function formatOperationSummary(summary) {
     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');
+    return joinLines(lines);
 }
 //# sourceMappingURL=formatting.js.map

package/dist/tools/shared/formatting.js.map

@@ -1 +1 @@
-{"version":3,"file":"formatting.js","sourceRoot":"","sources":["../../../src/tools/shared/formatting.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAEhE,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,gBAAgB,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC;IAChD,MAAM,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAChD,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAU;IACnC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAStC;IACC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CACR,uBAAuB,OAAO,CAAC,eAAe,IAAI,mBAAmB,EAAE,CACxE,CAAC;QACF,IAAI,OAAO,CAAC,GAAG;YAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,KAAyB,EAAE,GAAW,EAAQ,EAAE;QAC5D,IAAI,KAAK,IAAI,KAAK,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC;IAC9D,CAAC,CAAC;IACF,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,8BAA8B,CAAC,CAAC;IAC9D,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,2BAA2B,CAAC,CAAC;IACzD,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,wCAAwC,CAAC,CAAC;IAC5E,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,0CAA0C,CAAC,CAAC;IAC9E,IAAI,CACF,OAAO,CAAC,6BAA6B,EACrC,kCAAkC,CACnC,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"formatting.js","sourceRoot":"","sources":["../../../src/tools/shared/formatting.ts"],"names":[],"mappings":"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"}

package/dist/tools/shared/read-range.d.ts

@@ -0,0 +1,7 @@
+export declare function assertNoMixedRangeOptions(hasHeadTail: boolean, hasLineRange: boolean, pathLabel: string): void;
+export declare function assertLineRangeComplete(lineStart: number | undefined, lineEnd: number | undefined, pathLabel: string): void;
+export declare function buildLineRange(lineStart: number | undefined, lineEnd: number | undefined, pathLabel: string): {
+    start: number;
+    end: number;
+} | undefined;
+//# sourceMappingURL=read-range.d.ts.map

package/dist/tools/shared/read-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-range.d.ts","sourceRoot":"","sources":["../../../src/tools/shared/read-range.ts"],"names":[],"mappings":"AAEA,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,OAAO,EACpB,YAAY,EAAE,OAAO,EACrB,SAAS,EAAE,MAAM,GAChB,IAAI,CAON;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,SAAS,EAAE,MAAM,GAChB,IAAI,CAWN;AAED,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,SAAS,EAAE,MAAM,GAChB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAI5C"}

package/dist/tools/shared/read-range.js

@@ -0,0 +1,22 @@
+import { ErrorCode, McpError } from '../../lib/errors.js';
+export function assertNoMixedRangeOptions(hasHeadTail, hasLineRange, pathLabel) {
+    if (!hasHeadTail || !hasLineRange)
+        return;
+    throw new McpError(ErrorCode.E_INVALID_INPUT, 'head/tail cannot be combined with lineStart/lineEnd', pathLabel);
+}
+export function assertLineRangeComplete(lineStart, lineEnd, pathLabel) {
+    const hasLineStart = lineStart !== undefined;
+    const hasLineEnd = lineEnd !== undefined;
+    if (hasLineStart === hasLineEnd)
+        return;
+    const missing = hasLineStart ? 'lineEnd' : 'lineStart';
+    const provided = hasLineStart ? 'lineStart' : 'lineEnd';
+    throw new McpError(ErrorCode.E_INVALID_INPUT, `Invalid lineRange: ${provided} requires ${missing} to also be specified`, pathLabel);
+}
+export function buildLineRange(lineStart, lineEnd, pathLabel) {
+    assertLineRangeComplete(lineStart, lineEnd, pathLabel);
+    if (lineStart === undefined || lineEnd === undefined)
+        return undefined;
+    return { start: lineStart, end: lineEnd };
+}
+//# sourceMappingURL=read-range.js.map

package/dist/tools/shared/read-range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-range.js","sourceRoot":"","sources":["../../../src/tools/shared/read-range.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,UAAU,yBAAyB,CACvC,WAAoB,EACpB,YAAqB,EACrB,SAAiB;IAEjB,IAAI,CAAC,WAAW,IAAI,CAAC,YAAY;QAAE,OAAO;IAC1C,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,eAAe,EACzB,qDAAqD,EACrD,SAAS,CACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,SAA6B,EAC7B,OAA2B,EAC3B,SAAiB;IAEjB,MAAM,YAAY,GAAG,SAAS,KAAK,SAAS,CAAC;IAC7C,MAAM,UAAU,GAAG,OAAO,KAAK,SAAS,CAAC;IACzC,IAAI,YAAY,KAAK,UAAU;QAAE,OAAO;IACxC,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC;IACvD,MAAM,QAAQ,GAAG,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IACxD,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,eAAe,EACzB,sBAAsB,QAAQ,aAAa,OAAO,uBAAuB,EACzE,SAAS,CACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,SAA6B,EAC7B,OAA2B,EAC3B,SAAiB;IAEjB,uBAAuB,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IACvD,IAAI,SAAS,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACvE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AAC5C,CAAC"}

package/dist/tools/shared/search-formatting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-formatting.d.ts","sourceRoot":"","sources":["../../../src/tools/shared/search-formatting.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAGxE,KAAK,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAmE/E,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,mBAAmB,GAC1B,6BAA6B,CA2B/B;AA0BD,wBAAgB,eAAe,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAkBnE"}
+{"version":3,"file":"search-formatting.d.ts","sourceRoot":"","sources":["../../../src/tools/shared/search-formatting.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAExE,KAAK,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAyF/E,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,mBAAmB,GAC1B,6BAA6B,CA6B/B;AA0BD,wBAAgB,eAAe,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAyBnE"}

package/dist/tools/shared/search-formatting.js

@@ -1,12 +1,28 @@
 import * as pathModule from 'node:path';
-import { formatOperationSummary } from './formatting.js';
+import { formatOperationSummary, joinLines } from '../../config/formatting.js';
 const LINE_NUMBER_PAD_WIDTH = 4;
+function normalizeMatches(result) {
+    const normalized = result.matches.map((match, index) => ({
+        ...match,
+        relativeFile: pathModule.relative(result.basePath, match.file),
+        index,
+    }));
+    normalized.sort((a, b) => {
+        const fileCompare = a.relativeFile.localeCompare(b.relativeFile);
+        if (fileCompare !== 0)
+            return fileCompare;
+        if (a.line !== b.line)
+            return a.line - b.line;
+        return a.index - b.index;
+    });
+    return normalized;
+}
 function groupMatchesByFile(matches) {
     const byFile = new Map();
     for (const match of matches) {
-        const list = byFile.get(match.file) ?? [];
+        const list = byFile.get(match.relativeFile) ?? [];
         list.push(match);
-        byFile.set(match.file, list);
+        byFile.set(match.relativeFile, list);
     }
     return byFile;
 }
@@ -26,7 +42,10 @@ function formatMatchBlock(match) {
     return lines;
 }
 function formatFileMatches(file, matches) {
-    const lines = [`${file}:`];
+    const matchCount = matches.reduce((sum, m) => sum + m.matchCount, 0);
+    const lines = [
+        `${file} (${matchCount} match${matchCount === 1 ? '' : 'es'}):`,
+    ];
     for (const match of matches) {
         lines.push(...formatMatchBlock(match));
     }
@@ -35,22 +54,24 @@ function formatFileMatches(file, matches) {
 }
 function formatContentMatches(matches) {
     if (matches.length === 0)
-        return 'No matches found';
+        return 'No matches';
     const byFile = groupMatchesByFile(matches);
-    const lines = [`Found ${matches.length} matches:`, ''];
+    const lines = [`Found ${matches.length}:`];
     for (const [file, fileMatches] of byFile) {
         lines.push(...formatFileMatches(file, fileMatches));
     }
-    return lines.join('\n');
+    return joinLines(lines);
 }
 export function buildStructuredResult(result) {
+    const { basePath, pattern, filePattern, summary } = result;
+    const normalizedMatches = normalizeMatches(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),
+        basePath,
+        pattern,
+        filePattern,
+        matches: normalizedMatches.map((m) => ({
+            file: m.relativeFile,
             line: m.line,
             content: m.content,
             contextBefore: m.contextBefore,
@@ -58,15 +79,15 @@ export function buildStructuredResult(result) {
             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,
+            filesScanned: summary.filesScanned,
+            filesMatched: summary.filesMatched,
+            totalMatches: summary.matches,
+            truncated: summary.truncated,
+            skippedTooLarge: summary.skippedTooLarge || undefined,
+            skippedBinary: summary.skippedBinary || undefined,
+            skippedInaccessible: summary.skippedInaccessible || undefined,
+            linesSkippedDueToRegexTimeout: summary.linesSkippedDueToRegexTimeout || undefined,
+            stoppedReason: summary.stoppedReason,
         },
     };
 }
@@ -92,19 +113,26 @@ function buildTruncationInfo(result) {
     return {};
 }
 export function buildTextResult(result) {
+    const { summary } = result;
     const { truncatedReason, tip } = buildTruncationInfo(result);
-    let textOutput = formatContentMatches(result.matches);
+    const header = joinLines([
+        `Base path: ${result.basePath}`,
+        `Pattern: ${result.pattern}`,
+        `File pattern: ${result.filePattern}`,
+    ]);
+    const normalizedMatches = normalizeMatches(result);
+    let textOutput = joinLines([header, formatContentMatches(normalizedMatches)]);
     textOutput += formatOperationSummary({
-        truncated: result.summary.truncated,
+        truncated: summary.truncated,
         truncatedReason,
         tip,
-        skippedTooLarge: result.summary.skippedTooLarge,
-        skippedBinary: result.summary.skippedBinary,
-        skippedInaccessible: result.summary.skippedInaccessible,
-        linesSkippedDueToRegexTimeout: result.summary.linesSkippedDueToRegexTimeout,
+        skippedTooLarge: summary.skippedTooLarge,
+        skippedBinary: summary.skippedBinary,
+        skippedInaccessible: summary.skippedInaccessible,
+        linesSkippedDueToRegexTimeout: summary.linesSkippedDueToRegexTimeout,
     });
-    if (result.summary.truncated && !tip) {
-        textOutput += `\nScanned ${result.summary.filesScanned} files, found ${result.summary.matches} matches in ${result.summary.filesMatched} files.`;
+    if (summary.truncated && !tip) {
+        textOutput += `\nScanned ${summary.filesScanned} files, found ${summary.matches} matches in ${summary.filesMatched} files.`;
     }
     return textOutput;
 }

package/dist/tools/shared/search-formatting.js.map

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

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

@@ -1,3 +1,4 @@
+import { ErrorCode } from '../lib/errors.js';
 export declare function buildToolResponse<T>(text: string, structuredContent: T): {
     content: {
         type: 'text';
@@ -6,4 +7,25 @@ export declare function buildToolResponse<T>(text: string, structuredContent: T)
     structuredContent: T;
 };
 export type ToolResponse<T> = ReturnType<typeof buildToolResponse<T>>;
+type ToolErrorResponse = ReturnType<typeof buildToolErrorResponse>;
+export type ToolResult<T> = ToolResponse<T> | ToolErrorResponse;
+export declare function withToolErrorHandling<T>(run: () => Promise<ToolResponse<T>>, onError: (error: unknown) => ToolResult<T>): Promise<ToolResult<T>>;
+interface ToolErrorStructuredContent extends Record<string, unknown> {
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+        path?: string;
+        suggestion?: string;
+    };
+}
+export declare function buildToolErrorResponse(error: unknown, defaultCode: ErrorCode, path?: string): {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    structuredContent: ToolErrorStructuredContent;
+    isError: true;
+};
+export {};
 //# sourceMappingURL=tool-response.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"tool-response.d.ts","sourceRoot":"","sources":["../../src/tools/tool-response.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,SAAS,EAGV,MAAM,kBAAkB,CAAC;AAE1B,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;AACtE,KAAK,iBAAiB,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACnE,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC;AAEhE,wBAAsB,qBAAqB,CAAC,CAAC,EAC3C,GAAG,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EACnC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,GACzC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAMxB;AAED,UAAU,0BAA2B,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAClE,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,SAAS,EACtB,IAAI,CAAC,EAAE,MAAM,GACZ;IACD,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,iBAAiB,EAAE,0BAA0B,CAAC;IAC9C,OAAO,EAAE,IAAI,CAAC;CACf,CAsBA"}