@j0hanz/filesystem-context-mcp 1.2.9 → 1.3.1

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

@@ -1 +1 @@
-{"version":3,"file":"list-directory.js","sourceRoot":"","sources":["../../src/tools/list-directory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"list-directory.js","sourceRoot":"","sources":["../../src/tools/list-directory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,WAAW,CAAC;AAMxC,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,SAAS,GACV,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EACL,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EAGjB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAE5B,SAAS,YAAY,CAAC,IAAY,EAAE,MAAe;IACjD,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACxC,CAAC;AAKD,SAAS,sBAAsB,CAC7B,OAA6D,EAC7D,QAAgB,EAChB,OAA6D;IAE7D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,cAAc,GAAG,CAAC,EAAE,CAAC;YACzD,IAAI,OAAO,CAAC,cAAc,KAAK,CAAC,EAAE,CAAC;gBACjC,OAAO,iEAAiE,CAAC;YAC3E,CAAC;YACD,OAAO,0CAA0C,CAAC;QACpD,CAAC;QACD,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;IAClE,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAEpC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACvC,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,OAAO,SAAS,KAAK,CAAC,YAAY,GAAG,OAAO,EAAE,CAAC;QACjD,CAAC;QACD,MAAM,IAAI,GACR,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC3D,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,OAAO,GAAG,GAAG,IAAI,KAAK,CAAC,YAAY,GAAG,IAAI,GAAG,OAAO,EAAE,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,CAAC,GAAG,QAAQ,KAAK,IAAI,UAAU,KAAK,UAAU,EAAE,GAAG,UAAU,CAAC,CAAC;IAE7E,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,mBAAmB,GAAG;IAC1B,KAAK,EAAE,gBAAgB;IACvB,WAAW,EACT,uDAAuD;QACvD,kGAAkG;QAClG,+DAA+D;QAC/D,yEAAyE;QACzE,oEAAoE;IACtE,WAAW,EAAE,wBAAwB;IACrC,YAAY,EAAE,yBAAyB,CAAC,KAAK;IAC7C,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB;CACO,CAAC;AAEX,SAAS,qBAAqB,CAC5B,MAAiD;IAEjD,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IAC1C,OAAO;QACL,EAAE,EAAE,IAAI;QACR,IAAI;QACJ,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,YAAY,EAAE,CAAC,CAAC,YAAY;YAC5B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;YAClD,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE;YACnC,aAAa,EAAE,CAAC,CAAC,aAAa;SAC/B,CAAC,CAAC;QACH,OAAO,EAAE;YACP,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;YAC1C,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;YAChD,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;YAChD,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,cAAc,EAAE,OAAO,CAAC,cAAc;SACvC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,MAAiD;IAEjD,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IAC1C,IAAI,UAAU,GAAG,sBAAsB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAChE,MAAM,eAAe,GACnB,OAAO,CAAC,aAAa,KAAK,SAAS;QACjC,CAAC,CAAC,mBAAmB;QACrB,CAAC,CAAC,OAAO,CAAC,aAAa,KAAK,YAAY;YACtC,CAAC,CAAC,8BAA8B,OAAO,CAAC,YAAY,YAAY;YAChE,CAAC,CAAC,SAAS,CAAC;IAClB,UAAU,IAAI,sBAAsB,CAAC;QACnC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,eAAe;QACf,GAAG,EACD,OAAO,CAAC,aAAa,KAAK,YAAY;YACpC,CAAC,CAAC,6DAA6D;YAC/D,CAAC,CAAC,SAAS;QACf,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;QAChD,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;KACjD,CAAC,CAAC;IACH,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,KAAK,UAAU,mBAAmB,CAChC,EACE,IAAI,EAAE,OAAO,EACb,SAAS,EACT,aAAa,EACb,eAAe,EACf,QAAQ,EACR,UAAU,EACV,MAAM,EACN,qBAAqB,EACrB,OAAO,GAWR,EACD,MAAoB;IAEpB,MAAM,gBAAgB,GAAG;QACvB,SAAS,EAAE,SAAS,IAAI,KAAK;QAC7B,aAAa,EAAE,aAAa,IAAI,KAAK;QACrC,eAAe,EAAE,eAAe,IAAI,EAAE;QACtC,QAAQ,EAAE,QAAQ,IAAI,iBAAiB;QACvC,UAAU,EAAE,UAAU,IAAI,wBAAwB;QAClD,MAAM,EAAE,MAAM,IAAI,MAAM;QACxB,qBAAqB,EAAE,qBAAqB,IAAI,KAAK;QACrD,OAAO;KACR,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE;QAC1C,SAAS,EAAE,gBAAgB,CAAC,SAAS;QACrC,aAAa,EAAE,gBAAgB,CAAC,aAAa;QAC7C,eAAe,EAAE,gBAAgB,CAAC,eAAe;QACjD,QAAQ,EAAE,gBAAgB,CAAC,QAAQ;QACnC,UAAU,EAAE,gBAAgB,CAAC,UAAU;QACvC,MAAM,EAAE,gBAAgB,CAAC,MAAM;QAC/B,qBAAqB,EAAE,gBAAgB,CAAC,qBAAqB;QAC7D,OAAO,EAAE,gBAAgB,CAAC,OAAO;QACjC,MAAM;KACP,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACjD,UAAU,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC/C,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC3C,OAAO,iBAAiB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,OAAO,GAAG,CACd,IAAuB,EACvB,KAA8B,EACsB,EAAE,CACtD,qBAAqB,CACnB,GAAG,EAAE,CAAC,mBAAmB,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EAC7C,CAAC,KAAK,EAAE,EAAE,CACR,sBAAsB,CAAC,KAAK,EAAE,SAAS,CAAC,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,CACtE,CAAC;IAEJ,MAAM,CAAC,YAAY,CAAC,gBAAgB,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;AACtE,CAAC"}

package/dist/tools/read-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA8HzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAY5D"}
+{"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgKzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAU5D"}

package/dist/tools/read-file.js

@@ -1,33 +1,23 @@
-import { ErrorCode, McpError, toRpcError } from '../lib/errors.js';
+import { joinLines } from '../config/formatting.js';
+import { MAX_TEXT_FILE_SIZE } from '../lib/constants.js';
+import { ErrorCode } from '../lib/errors.js';
 import { readFile } from '../lib/file-operations.js';
 import { ReadFileInputSchema, ReadFileOutputSchema } from '../schemas/index.js';
-import { buildToolResponse } from './tool-response.js';
-function buildLineRange(lineStart, lineEnd, filePath) {
-    const hasLineStart = lineStart !== undefined;
-    const hasLineEnd = lineEnd !== undefined;
-    assertLineRangeComplete(hasLineStart, hasLineEnd, filePath);
-    if (hasLineStart && hasLineEnd)
-        return { start: lineStart, end: lineEnd };
-    return undefined;
-}
-function assertLineRangeComplete(hasLineStart, hasLineEnd, filePath) {
-    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`, filePath);
-}
+import { assertNoMixedRangeOptions, buildLineRange, } from './shared/read-range.js';
+import { buildToolErrorResponse, buildToolResponse, withToolErrorHandling, } from './tool-response.js';
 function buildTextResult(result, head, tail) {
     const note = buildReadFileNote(result, head, tail);
-    return note ? `${result.content}\n${note}` : result.content;
+    return note ? joinLines([result.content, note]) : result.content;
 }
 function buildReadFileNote(result, head, tail) {
-    if (result.truncated) {
-        return buildTruncatedNote(result, head, tail);
-    }
-    return result.totalLines !== undefined
+    const rangeNote = buildRangeNote(result);
+    const linesNote = result.totalLines !== undefined
         ? `Total lines: ${result.totalLines}`
         : undefined;
+    if (result.truncated) {
+        return joinLines([buildTruncatedNote(result, head, tail), rangeNote, linesNote].filter((value) => Boolean(value)));
+    }
+    return joinLines([rangeNote, linesNote].filter((value) => Boolean(value)));
 }
 function buildTruncatedNote(result, head, tail) {
     if (result.totalLines !== undefined) {
@@ -41,14 +31,34 @@ function buildTruncatedNote(result, head, tail) {
     }
     return undefined;
 }
+function buildRangeNote(result) {
+    if (result.readMode === 'lineRange') {
+        if (result.lineStart !== undefined && result.lineEnd !== undefined) {
+            return `Showing lines ${result.lineStart}-${result.lineEnd}`;
+        }
+    }
+    return undefined;
+}
 async function handleReadFile(args) {
+    const hasHeadTail = args.head !== undefined || args.tail !== undefined;
+    const hasLineRange = args.lineStart !== undefined || args.lineEnd !== undefined;
+    assertNoMixedRangeOptions(hasHeadTail, hasLineRange, args.path);
     const lineRange = buildLineRange(args.lineStart, args.lineEnd, args.path);
-    const result = await readFile(args.path, {
-        encoding: args.encoding,
-        maxSize: args.maxSize,
+    const effectiveOptions = {
+        encoding: args.encoding ?? 'utf-8',
+        maxSize: Math.min(args.maxSize ?? MAX_TEXT_FILE_SIZE, MAX_TEXT_FILE_SIZE),
+        skipBinary: args.skipBinary ?? true,
         lineRange,
         head: args.head,
         tail: args.tail,
+    };
+    const result = await readFile(args.path, {
+        encoding: effectiveOptions.encoding,
+        maxSize: effectiveOptions.maxSize,
+        lineRange: effectiveOptions.lineRange,
+        head: effectiveOptions.head,
+        tail: effectiveOptions.tail,
+        skipBinary: effectiveOptions.skipBinary,
     });
     const structured = {
         ok: true,
@@ -56,6 +66,22 @@ async function handleReadFile(args) {
         content: result.content,
         truncated: result.truncated,
         totalLines: result.totalLines,
+        readMode: result.readMode,
+        lineStart: result.lineStart,
+        lineEnd: result.lineEnd,
+        head: result.head,
+        tail: result.tail,
+        linesRead: result.linesRead,
+        hasMoreLines: result.hasMoreLines,
+        effectiveOptions: {
+            encoding: effectiveOptions.encoding,
+            maxSize: effectiveOptions.maxSize,
+            skipBinary: effectiveOptions.skipBinary,
+            lineStart: args.lineStart,
+            lineEnd: args.lineEnd,
+            head: args.head,
+            tail: args.tail,
+        },
     };
     const text = buildTextResult(result, args.head, args.tail);
     return buildToolResponse(text, structured);
@@ -63,10 +89,10 @@ async function handleReadFile(args) {
 const READ_FILE_TOOL = {
     title: 'Read File',
     description: 'Read the text contents of a single file. ' +
-        'Supports different encodings and partial reads via head (first N lines), tail (last N lines), ' +
-        'or lineStart/lineEnd (specific line range). ' +
-        'For multiple files, use read_multiple_files for efficiency. ' +
-        'For binary/media files, use read_media_file instead.',
+        'Supports encodings and partial reads via head (first N lines), tail (last N lines), ' +
+        'or lineStart/lineEnd (specific line range; mutually exclusive with head/tail). ' +
+        'Use skipBinary=true to reject binary files. ' +
+        'For multiple files, use read_multiple_files for efficiency.',
     inputSchema: ReadFileInputSchema,
     outputSchema: ReadFileOutputSchema.shape,
     annotations: {
@@ -76,13 +102,7 @@ const READ_FILE_TOOL = {
     },
 };
 export function registerReadFileTool(server) {
-    server.registerTool('read_file', READ_FILE_TOOL, async (args) => {
-        try {
-            return await handleReadFile(args);
-        }
-        catch (error) {
-            throw toRpcError(error, ErrorCode.E_NOT_FILE, args.path);
-        }
-    });
+    const handler = (args) => withToolErrorHandling(() => handleReadFile(args), (error) => buildToolErrorResponse(error, ErrorCode.E_NOT_FILE, args.path));
+    server.registerTool('read_file', READ_FILE_TOOL, handler);
 }
 //# sourceMappingURL=read-file.js.map

package/dist/tools/read-file.js.map

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

package/dist/tools/read-media-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read-media-file.d.ts","sourceRoot":"","sources":["../../src/tools/read-media-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoEzE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAYjE"}
+{"version":3,"file":"read-media-file.d.ts","sourceRoot":"","sources":["../../src/tools/read-media-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA0EzE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAYjE"}

package/dist/tools/read-media-file.js

@@ -1,7 +1,8 @@
-import { ErrorCode, toRpcError } from '../lib/errors.js';
+import { joinLines } from '../config/formatting.js';
+import { ErrorCode } from '../lib/errors.js';
 import { readMediaFile } from '../lib/file-operations.js';
 import { ReadMediaFileInputSchema, ReadMediaFileOutputSchema, } from '../schemas/index.js';
-import { buildToolResponse } from './tool-response.js';
+import { buildToolErrorResponse, buildToolResponse, } from './tool-response.js';
 function buildStructuredResult(result) {
     return {
         ok: true,
@@ -18,7 +19,7 @@ function buildTextResult(result) {
         `Size: ${result.size} bytes`,
         `Data: [base64 encoded, ${result.data.length} characters]`,
     ];
-    return textLines.join('\n');
+    return joinLines(textLines);
 }
 async function handleReadMediaFile({ path, maxSize, }) {
     const result = await readMediaFile(path, { maxSize });
@@ -38,13 +39,14 @@ const READ_MEDIA_FILE_TOOL = {
     },
 };
 export function registerReadMediaFileTool(server) {
-    server.registerTool('read_media_file', READ_MEDIA_FILE_TOOL, async (args) => {
+    const handler = async (args) => {
         try {
             return await handleReadMediaFile(args);
         }
         catch (error) {
-            throw toRpcError(error, ErrorCode.E_NOT_FILE, args.path);
+            return buildToolErrorResponse(error, ErrorCode.E_NOT_FILE, args.path);
         }
-    });
+    };
+    server.registerTool('read_media_file', READ_MEDIA_FILE_TOOL, handler);
 }
 //# sourceMappingURL=read-media-file.js.map

package/dist/tools/read-media-file.js.map

@@ -1 +1 @@
-{"version":3,"file":"read-media-file.js","sourceRoot":"","sources":["../../src/tools/read-media-file.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EACL,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAqB,MAAM,oBAAoB,CAAC;AAK1E,SAAS,qBAAqB,CAC5B,MAAiD;IAEjD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,MAAiD;IAEjD,MAAM,SAAS,GAAG;QAChB,SAAS,MAAM,CAAC,IAAI,EAAE;QACtB,cAAc,MAAM,CAAC,QAAQ,EAAE;QAC/B,SAAS,MAAM,CAAC,IAAI,QAAQ;QAC5B,0BAA0B,MAAM,CAAC,IAAI,CAAC,MAAM,cAAc;KAC3D,CAAC;IACF,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,EACjC,IAAI,EACJ,OAAO,GAIR;IACC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACtD,OAAO,iBAAiB,CACtB,eAAe,CAAC,MAAM,CAAC,EACvB,qBAAqB,CAAC,MAAM,CAAC,CAC9B,CAAC;AACJ,CAAC;AAED,MAAM,oBAAoB,GAAG;IAC3B,KAAK,EAAE,iBAAiB;IACxB,WAAW,EACT,yGAAyG;QACzG,oDAAoD;QACpD,+EAA+E;IACjF,WAAW,EAAE,wBAAwB;IACrC,YAAY,EAAE,yBAAyB,CAAC,KAAK;IAC7C,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB;CACO,CAAC;AAEX,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,EAAE,IAAmB,EAAE,EAAE;QAC5B,IAAI,CAAC;YACH,OAAO,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"read-media-file.js","sourceRoot":"","sources":["../../src/tools/read-media-file.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EACL,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAGlB,MAAM,oBAAoB,CAAC;AAK5B,SAAS,qBAAqB,CAC5B,MAAiD;IAEjD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,MAAiD;IAEjD,MAAM,SAAS,GAAG;QAChB,SAAS,MAAM,CAAC,IAAI,EAAE;QACtB,cAAc,MAAM,CAAC,QAAQ,EAAE;QAC/B,SAAS,MAAM,CAAC,IAAI,QAAQ;QAC5B,0BAA0B,MAAM,CAAC,IAAI,CAAC,MAAM,cAAc;KAC3D,CAAC;IACF,OAAO,SAAS,CAAC,SAAS,CAAC,CAAC;AAC9B,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,EACjC,IAAI,EACJ,OAAO,GAIR;IACC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACtD,OAAO,iBAAiB,CACtB,eAAe,CAAC,MAAM,CAAC,EACvB,qBAAqB,CAAC,MAAM,CAAC,CAC9B,CAAC;AACJ,CAAC;AAED,MAAM,oBAAoB,GAAG;IAC3B,KAAK,EAAE,iBAAiB;IACxB,WAAW,EACT,yGAAyG;QACzG,oDAAoD;QACpD,+EAA+E;IACjF,WAAW,EAAE,wBAAwB;IACrC,YAAY,EAAE,yBAAyB,CAAC,KAAK;IAC7C,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB;CACO,CAAC;AAEX,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,OAAO,GAAG,KAAK,EACnB,IAAmB,EAC6B,EAAE;QAClD,IAAI,CAAC;YACH,OAAO,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,sBAAsB,CAAC,KAAK,EAAE,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACxE,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,CAAC,YAAY,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC"}

package/dist/tools/read-multiple-files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read-multiple-files.d.ts","sourceRoot":"","sources":["../../src/tools/read-multiple-files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwGzE,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAYrE"}
+{"version":3,"file":"read-multiple-files.d.ts","sourceRoot":"","sources":["../../src/tools/read-multiple-files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4KzE,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAWrE"}

package/dist/tools/read-multiple-files.js

@@ -1,8 +1,11 @@
-import { ErrorCode, toRpcError } from '../lib/errors.js';
+import { joinLines } from '../config/formatting.js';
+import { MAX_TEXT_FILE_SIZE } from '../lib/constants.js';
+import { ErrorCode } from '../lib/errors.js';
 import { readMultipleFiles } from '../lib/file-operations.js';
 import { ReadMultipleFilesInputSchema, ReadMultipleFilesOutputSchema, } from '../schemas/index.js';
-import { buildToolResponse } from './tool-response.js';
-function buildStructuredResult(results) {
+import { assertLineRangeComplete, assertNoMixedRangeOptions, } from './shared/read-range.js';
+import { buildToolErrorResponse, buildToolResponse, withToolErrorHandling, } from './tool-response.js';
+function buildStructuredResult(results, effectiveOptions) {
     const succeeded = results.filter((r) => r.content !== undefined).length;
     const failed = results.filter((r) => r.error !== undefined).length;
     return {
@@ -13,43 +16,81 @@ function buildStructuredResult(results) {
             succeeded,
             failed,
         },
+        effectiveOptions,
     };
 }
 function buildTextResult(results) {
-    return results.map(formatReadMultipleResult).join('\n');
+    return joinLines(results.map(formatReadMultipleResult));
 }
 function formatReadMultipleResult(result) {
     if (result.content !== undefined) {
         const note = buildReadMultipleNote(result);
-        return `=== ${result.path} ===\n${result.content}${note}`;
+        const rangeNote = buildReadMultipleRangeNote(result);
+        const footer = [rangeNote, note].filter((value) => Boolean(value));
+        const contentBlock = footer.length
+            ? joinLines([result.content, ...footer])
+            : result.content;
+        return joinLines([`=== ${result.path} ===`, contentBlock]);
     }
-    return `=== ${result.path} ===\n[Error: ${result.error ?? 'Unknown error'}]`;
+    return joinLines([
+        `=== ${result.path} ===`,
+        `[Error: ${result.error ?? 'Unknown error'}]`,
+    ]);
 }
 function buildReadMultipleNote(result) {
     if (result.truncated !== true)
         return '';
     if (result.totalLines !== undefined) {
-        return `\n[Truncated. Total lines: ${result.totalLines}]`;
+        return `[Truncated. Total lines: ${result.totalLines}]`;
     }
-    return '\n[Truncated]';
+    return '[Truncated]';
 }
-async function handleReadMultipleFiles(args) {
-    const results = await readMultipleFiles(args.paths, {
-        encoding: args.encoding,
-        maxSize: args.maxSize,
-        maxTotalSize: args.maxTotalSize,
+function buildReadMultipleRangeNote(result) {
+    if (result.readMode === 'lineRange') {
+        if (result.lineStart !== undefined && result.lineEnd !== undefined) {
+            return `Showing lines ${result.lineStart}-${result.lineEnd}`;
+        }
+    }
+    if (result.readMode === 'head' && result.head !== undefined) {
+        return `Showing first ${String(result.head)} lines`;
+    }
+    if (result.readMode === 'tail' && result.tail !== undefined) {
+        return `Showing last ${String(result.tail)} lines`;
+    }
+    return undefined;
+}
+async function handleReadMultipleFiles(args, signal) {
+    const pathLabel = args.paths[0] ?? '<paths>';
+    const hasHeadTail = args.head !== undefined || args.tail !== undefined;
+    const hasLineRange = args.lineStart !== undefined || args.lineEnd !== undefined;
+    assertLineRangeComplete(args.lineStart, args.lineEnd, pathLabel);
+    assertNoMixedRangeOptions(hasHeadTail, hasLineRange, pathLabel);
+    const effectiveOptions = {
+        encoding: args.encoding ?? 'utf-8',
+        maxSize: Math.min(args.maxSize ?? MAX_TEXT_FILE_SIZE, MAX_TEXT_FILE_SIZE),
+        maxTotalSize: args.maxTotalSize ?? 100 * 1024 * 1024,
         head: args.head,
         tail: args.tail,
         lineStart: args.lineStart,
         lineEnd: args.lineEnd,
+    };
+    const results = await readMultipleFiles(args.paths, {
+        encoding: effectiveOptions.encoding,
+        maxSize: effectiveOptions.maxSize,
+        maxTotalSize: effectiveOptions.maxTotalSize,
+        head: effectiveOptions.head,
+        tail: effectiveOptions.tail,
+        lineStart: effectiveOptions.lineStart,
+        lineEnd: effectiveOptions.lineEnd,
+        signal,
     });
-    return buildToolResponse(buildTextResult(results), buildStructuredResult(results));
+    return buildToolResponse(buildTextResult(results), buildStructuredResult(results, effectiveOptions));
 }
 const READ_MULTIPLE_FILES_TOOL = {
     title: 'Read Multiple Files',
     description: 'Read contents of multiple files in a single operation (parallel processing). ' +
         'More efficient than calling read_file repeatedly. ' +
-        'Individual file errors do not fail the entire operation-each file reports success or error independently. ' +
+        'Individual file errors do not fail the entire operation; each file reports success or error independently. ' +
         'Supports head/tail or lineStart/lineEnd for reading partial content from all files (mutually exclusive).',
     inputSchema: ReadMultipleFilesInputSchema,
     outputSchema: ReadMultipleFilesOutputSchema.shape,
@@ -60,13 +101,7 @@ const READ_MULTIPLE_FILES_TOOL = {
     },
 };
 export function registerReadMultipleFilesTool(server) {
-    server.registerTool('read_multiple_files', READ_MULTIPLE_FILES_TOOL, async (args) => {
-        try {
-            return await handleReadMultipleFiles(args);
-        }
-        catch (error) {
-            throw toRpcError(error, ErrorCode.E_UNKNOWN);
-        }
-    });
+    const handler = (args, extra) => withToolErrorHandling(() => handleReadMultipleFiles(args, extra.signal), (error) => buildToolErrorResponse(error, ErrorCode.E_UNKNOWN));
+    server.registerTool('read_multiple_files', READ_MULTIPLE_FILES_TOOL, handler);
 }
 //# sourceMappingURL=read-multiple-files.js.map

package/dist/tools/read-multiple-files.js.map

@@ -1 +1 @@
-{"version":3,"file":"read-multiple-files.js","sourceRoot":"","sources":["../../src/tools/read-multiple-files.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EACL,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAqB,MAAM,oBAAoB,CAAC;AAS1E,SAAS,qBAAqB,CAC5B,OAAsD;IAEtD,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IACxE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IAEnE,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO;QACP,OAAO,EAAE;YACP,KAAK,EAAE,OAAO,CAAC,MAAM;YACrB,SAAS;YACT,MAAM;SACP;KACF,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,OAAsD;IAEtD,OAAO,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,wBAAwB,CAC/B,MAA6D;IAE7D,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC3C,OAAO,OAAO,MAAM,CAAC,IAAI,SAAS,MAAM,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;IAC5D,CAAC;IACD,OAAO,OAAO,MAAM,CAAC,IAAI,iBAAiB,MAAM,CAAC,KAAK,IAAI,eAAe,GAAG,CAAC;AAC/E,CAAC;AAED,SAAS,qBAAqB,CAC5B,MAA6D;IAE7D,IAAI,MAAM,CAAC,SAAS,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACzC,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,8BAA8B,MAAM,CAAC,UAAU,GAAG,CAAC;IAC5D,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,KAAK,UAAU,uBAAuB,CAAC,IAStC;IACC,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,KAAK,EAAE;QAClD,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC,CAAC;IAEH,OAAO,iBAAiB,CACtB,eAAe,CAAC,OAAO,CAAC,EACxB,qBAAqB,CAAC,OAAO,CAAC,CAC/B,CAAC;AACJ,CAAC;AAED,MAAM,wBAAwB,GAAG;IAC/B,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EACT,+EAA+E;QAC/E,oDAAoD;QACpD,4GAA4G;QAC5G,0GAA0G;IAC5G,WAAW,EAAE,4BAA4B;IACzC,YAAY,EAAE,6BAA6B,CAAC,KAAK;IACjD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB;CACO,CAAC;AAEX,MAAM,UAAU,6BAA6B,CAAC,MAAiB;IAC7D,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB,wBAAwB,EACxB,KAAK,EAAE,IAAsB,EAAE,EAAE;QAC/B,IAAI,CAAC;YACH,OAAO,MAAM,uBAAuB,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"read-multiple-files.js","sourceRoot":"","sources":["../../src/tools/read-multiple-files.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"search-content.d.ts","sourceRoot":"","sources":["../../src/tools/search-content.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA0EzE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAYjE"}
+{"version":3,"file":"search-content.d.ts","sourceRoot":"","sources":["../../src/tools/search-content.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA2EzE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAWjE"}

package/dist/tools/search-content.js

@@ -1,10 +1,10 @@
-import { ErrorCode, toRpcError } from '../lib/errors.js';
+import { ErrorCode } from '../lib/errors.js';
 import { searchContent } from '../lib/file-operations.js';
 import { SearchContentInputSchema, SearchContentOutputSchema, } from '../schemas/index.js';
 import { buildStructuredResult, buildTextResult, } from './shared/search-formatting.js';
-import { buildToolResponse } from './tool-response.js';
-function buildSearchContentOptions(args) {
-    return {
+import { buildToolErrorResponse, buildToolResponse, withToolErrorHandling, } from './tool-response.js';
+async function handleSearchContent(args, signal) {
+    const effectiveOptions = {
         filePattern: args.filePattern,
         excludePatterns: args.excludePatterns,
         caseSensitive: args.caseSensitive,
@@ -20,10 +20,13 @@ function buildSearchContentOptions(args) {
         baseNameMatch: args.baseNameMatch,
         caseSensitiveFileMatch: args.caseSensitiveFileMatch,
     };
-}
-async function handleSearchContent(args) {
-    const result = await searchContent(args.path, args.pattern, buildSearchContentOptions(args));
-    return buildToolResponse(buildTextResult(result), buildStructuredResult(result));
+    const result = await searchContent(args.path, args.pattern, {
+        ...effectiveOptions,
+        signal,
+    });
+    const structured = buildStructuredResult(result);
+    structured.effectiveOptions = effectiveOptions;
+    return buildToolResponse(buildTextResult(result), structured);
 }
 const SEARCH_CONTENT_TOOL = {
     title: 'Search Content',
@@ -31,6 +34,7 @@ const SEARCH_CONTENT_TOOL = {
         '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). ' +
+        'excludePatterns defaults to common dependency/build dirs (pass [] to disable). ' +
         'Automatically skips binary files unless skipBinary=false.',
     inputSchema: SearchContentInputSchema,
     outputSchema: SearchContentOutputSchema.shape,
@@ -41,13 +45,7 @@ const SEARCH_CONTENT_TOOL = {
     },
 };
 export function registerSearchContentTool(server) {
-    server.registerTool('search_content', SEARCH_CONTENT_TOOL, async (args) => {
-        try {
-            return await handleSearchContent(args);
-        }
-        catch (error) {
-            throw toRpcError(error, ErrorCode.E_UNKNOWN, args.path);
-        }
-    });
+    const handler = (args, extra) => withToolErrorHandling(() => handleSearchContent(args, extra.signal), (error) => buildToolErrorResponse(error, ErrorCode.E_UNKNOWN, args.path));
+    server.registerTool('search_content', SEARCH_CONTENT_TOOL, handler);
 }
 //# sourceMappingURL=search-content.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"search-content.js","sourceRoot":"","sources":["../../src/tools/search-content.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EACL,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,qBAAqB,EACrB,eAAe,GAChB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAqB,MAAM,oBAAoB,CAAC;AAO1E,SAAS,yBAAyB,CAChC,IAAuB;IAEvB,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;KACpD,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,mBAAmB,CAChC,IAAuB;IAEvB,MAAM,MAAM,GAAG,MAAM,aAAa,CAChC,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,OAAO,EACZ,yBAAyB,CAAC,IAAI,CAAC,CAChC,CAAC;IAEF,OAAO,iBAAiB,CACtB,eAAe,CAAC,MAAM,CAAC,EACvB,qBAAqB,CAAC,MAAM,CAAC,CAC9B,CAAC;AACJ,CAAC;AAED,MAAM,mBAAmB,GAAG;IAC1B,KAAK,EAAE,gBAAgB;IACvB,WAAW,EACT,uFAAuF;QACvF,yEAAyE;QACzE,yFAAyF;QACzF,4EAA4E;QAC5E,2DAA2D;IAC7D,WAAW,EAAE,wBAAwB;IACrC,YAAY,EAAE,yBAAyB,CAAC,KAAK;IAC7C,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB;CACO,CAAC;AAEX,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,EAAE,IAAuB,EAAE,EAAE;QAChC,IAAI,CAAC;YACH,OAAO,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"search-content.js","sourceRoot":"","sources":["../../src/tools/search-content.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EACL,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,qBAAqB,EACrB,eAAe,GAChB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EAGjB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAK5B,KAAK,UAAU,mBAAmB,CAChC,IAAuB,EACvB,MAAoB;IAEpB,MAAM,gBAAgB,GAAG;QACvB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;KACpD,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE;QAC1D,GAAG,gBAAgB;QACnB,MAAM;KACP,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACjD,UAAU,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAE/C,OAAO,iBAAiB,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,mBAAmB,GAAG;IAC1B,KAAK,EAAE,gBAAgB;IACvB,WAAW,EACT,uFAAuF;QACvF,yEAAyE;QACzE,yFAAyF;QACzF,4EAA4E;QAC5E,iFAAiF;QACjF,2DAA2D;IAC7D,WAAW,EAAE,wBAAwB;IACrC,YAAY,EAAE,yBAAyB,CAAC,KAAK;IAC7C,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB;CACO,CAAC;AAEX,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,OAAO,GAAG,CACd,IAAuB,EACvB,KAA8B,EACsB,EAAE,CACtD,qBAAqB,CACnB,GAAG,EAAE,CAAC,mBAAmB,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EAC7C,CAAC,KAAK,EAAE,EAAE,CAAC,sBAAsB,CAAC,KAAK,EAAE,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CACzE,CAAC;IAEJ,MAAM,CAAC,YAAY,CAAC,gBAAgB,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;AACtE,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"search-definitions.d.ts","sourceRoot":"","sources":["../../src/tools/search-definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoJzE,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAYrE"}
+{"version":3,"file":"search-definitions.d.ts","sourceRoot":"","sources":["../../src/tools/search-definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiLzE,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAarE"}

package/dist/tools/search-definitions.js

@@ -1,53 +1,68 @@
-import { ErrorCode, toRpcError } from '../lib/errors.js';
+import { joinLines } from '../config/formatting.js';
+import { ErrorCode } from '../lib/errors.js';
 import { searchDefinitions } from '../lib/file-operations.js';
 import { SearchDefinitionsInputSchema, SearchDefinitionsOutputSchema, } from '../schemas/index.js';
-import { buildToolResponse } from './tool-response.js';
+import { buildToolErrorResponse, buildToolResponse, } from './tool-response.js';
+function buildCriteriaText(searchName, searchType) {
+    const parts = [
+        searchName ? `name "${searchName}"` : null,
+        searchType ? `type "${searchType}"` : null,
+    ].filter(Boolean);
+    return parts.join(' and ');
+}
+function buildSearchLabel(searchName, searchType) {
+    const parts = [
+        searchName ? `"${searchName}"` : null,
+        searchType ? `(${searchType})` : null,
+    ].filter(Boolean);
+    return parts.join(' ');
+}
+function formatContextLines(lines) {
+    return (lines ?? []).map((line) => `    ${line}`);
+}
+function formatDefinitionBlock(def) {
+    const exportMarker = def.exported ? ' | exported' : '';
+    const lines = [
+        `[${def.definitionType}] ${def.file}:${def.line}${exportMarker}`,
+    ];
+    lines.push(...formatContextLines(def.contextBefore));
+    lines.push(`  > ${def.content}`);
+    lines.push(...formatContextLines(def.contextAfter));
+    lines.push('');
+    return lines;
+}
+function formatNoResultsText(result) {
+    const { summary, searchName, searchType } = result;
+    const criteria = buildCriteriaText(searchName, searchType);
+    const scopeNote = `Scanned ${summary.filesScanned} file(s), matched ${summary.filesMatched}.`;
+    const hint = !searchName && !searchType
+        ? 'Provide name or type to narrow the search.'
+        : 'Try adjusting name/type or excludePatterns to refine results.';
+    return `No definitions found matching ${criteria || 'current criteria'}\n${scopeNote}\n${hint}`;
+}
+function buildHeaderLines(result) {
+    const { summary, searchName, searchType } = result;
+    const searchLabel = buildSearchLabel(searchName, searchType);
+    const header = `Found ${summary.totalDefinitions} definition(s)${searchLabel ? ` for ${searchLabel}` : ''}:`;
+    return [header, ''];
+}
 /**
  * Format text output for search definitions results
  */
 function formatTextResult(result) {
-    const { definitions, summary, searchName, searchType } = result;
+    const { definitions, summary } = result;
     if (definitions.length === 0) {
-        const criteria = [
-            searchName ? `name "${searchName}"` : null,
-            searchType ? `type "${searchType}"` : null,
-        ]
-            .filter(Boolean)
-            .join(' and ');
-        return `No definitions found matching ${criteria}`;
+        return formatNoResultsText(result);
     }
-    const lines = [];
-    const searchCriteria = [
-        searchName ? `"${searchName}"` : null,
-        searchType ? `(${searchType})` : null,
-    ]
-        .filter(Boolean)
-        .join(' ');
-    lines.push(`Found ${summary.totalDefinitions} definition(s)${searchCriteria ? ` for ${searchCriteria}` : ''}:`);
-    lines.push('');
+    const lines = [...buildHeaderLines(result)];
     for (const def of definitions) {
-        const exportMarker = def.exported ? ' | exported' : '';
-        lines.push(`[${def.definitionType}] ${def.file}:${def.line}${exportMarker}`);
-        // Show context before
-        if (def.contextBefore && def.contextBefore.length > 0) {
-            for (const line of def.contextBefore) {
-                lines.push(`    ${line}`);
-            }
-        }
-        // Show the matching line
-        lines.push(`  > ${def.content}`);
-        // Show context after
-        if (def.contextAfter && def.contextAfter.length > 0) {
-            for (const line of def.contextAfter) {
-                lines.push(`    ${line}`);
-            }
-        }
-        lines.push('');
+        lines.push(...formatDefinitionBlock(def));
     }
     if (summary.truncated) {
         lines.push(`(Results truncated - scanned ${summary.filesScanned} files)`);
     }
-    return lines.join('\n');
+    lines.push(`Scanned ${summary.filesScanned} file(s), matched ${summary.filesMatched}.`);
+    return joinLines(lines);
 }
 /**
  * Build structured result for search definitions
@@ -76,7 +91,7 @@ function buildStructuredResult(result) {
         },
     };
 }
-async function handleSearchDefinitions(args) {
+async function handleSearchDefinitions(args, signal) {
     const result = await searchDefinitions({
         path: args.path,
         name: args.name,
@@ -86,6 +101,7 @@ async function handleSearchDefinitions(args) {
         excludePatterns: args.excludePatterns,
         includeHidden: args.includeHidden,
         contextLines: args.contextLines,
+        signal,
     });
     return buildToolResponse(formatTextResult(result), buildStructuredResult(result));
 }
@@ -104,13 +120,14 @@ const SEARCH_DEFINITIONS_TOOL = {
     },
 };
 export function registerSearchDefinitionsTool(server) {
-    server.registerTool('search_definitions', SEARCH_DEFINITIONS_TOOL, async (args) => {
+    const handler = async (args, extra) => {
         try {
-            return await handleSearchDefinitions(args);
+            return await handleSearchDefinitions(args, extra.signal);
         }
         catch (error) {
-            throw toRpcError(error, ErrorCode.E_UNKNOWN, args.path);
+            return buildToolErrorResponse(error, ErrorCode.E_UNKNOWN, args.path);
         }
-    });
+    };
+    server.registerTool('search_definitions', SEARCH_DEFINITIONS_TOOL, handler);
 }
 //# sourceMappingURL=search-definitions.js.map