@j0hanz/filesystem-mcp 1.7.2 → 1.7.3

package/dist/tools/list-directory.js

@@ -4,7 +4,7 @@ import { DEFAULT_EXCLUDE_PATTERNS } from '../lib/constants.js';
 import { ErrorCode } from '../lib/errors.js';
 import { listDirectory } from '../lib/file-operations/list-directory.js';
 import { ListDirectoryInputSchema, ListDirectoryOutputSchema, } from '../schemas.js';
-import { buildToolErrorResponse, buildToolResponse, executeToolWithDiagnostics, READ_ONLY_TOOL_ANNOTATIONS, resolvePathOrRoot, withDefaultIcons, withValidatedArgs, wrapToolHandler, } from './shared.js';
+import { buildToolErrorResponse, buildToolResponse, decodeOffsetCursor, encodeOffsetCursor, executeToolWithDiagnostics, READ_ONLY_TOOL_ANNOTATIONS, resolvePathOrRoot, withDefaultIcons, withValidatedArgs, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
 export const LIST_DIRECTORY_TOOL = {
     name: 'ls',
@@ -82,27 +82,9 @@ function buildStructuredListResult(result, nextCursor) {
         ...(nextCursor !== undefined ? { nextCursor } : {}),
     };
 }
-function encodeCursor(offset) {
-    return Buffer.from(JSON.stringify({ offset })).toString('base64url');
-}
-function decodeCursor(cursor) {
-    try {
-        const parsed = JSON.parse(Buffer.from(cursor, 'base64url').toString('utf-8'));
-        if (typeof parsed === 'object' &&
-            parsed !== null &&
-            typeof parsed.offset === 'number') {
-            const { offset } = parsed;
-            return Number.isInteger(offset) && offset >= 0 ? offset : 0;
-        }
-    }
-    catch {
-        // ignore malformed cursor
-    }
-    return 0;
-}
 async function handleListDirectory(args, signal) {
     const dirPath = resolvePathOrRoot(args.path);
-    const cursorOffset = args.cursor !== undefined ? decodeCursor(args.cursor) : 0;
+    const cursorOffset = args.cursor !== undefined ? decodeOffsetCursor(args.cursor) : 0;
     const pageSize = args.maxEntries;
     const options = {
         includeHidden: args.includeHidden,
@@ -117,7 +99,7 @@ async function handleListDirectory(args, signal) {
     const result = await listDirectory(dirPath, options);
     const displayEntries = cursorOffset > 0 ? result.entries.slice(cursorOffset) : result.entries;
     const nextCursor = result.summary.truncated && displayEntries.length > 0
-        ? encodeCursor(cursorOffset + displayEntries.length)
+        ? encodeOffsetCursor(cursorOffset + displayEntries.length)
         : undefined;
     const displayResult = { ...result, entries: displayEntries };
     return buildToolResponse(buildListTextResult(displayResult, nextCursor), buildStructuredListResult(displayResult, nextCursor));

package/dist/tools/read-multiple.js

@@ -3,7 +3,7 @@ import { DEFAULT_READ_MANY_MAX_TOTAL_SIZE, DEFAULT_SEARCH_TIMEOUT_MS, } from '..
 import { ErrorCode } from '../lib/errors.js';
 import { readMultipleFiles } from '../lib/file-operations/read-multiple-files.js';
 import { ReadMultipleFilesInputSchema, ReadMultipleFilesOutputSchema, } from '../schemas.js';
-import { buildResourceLink, buildToolErrorResponse, buildToolResponse, createToolProgressSession, executeToolWithDiagnostics, maybeExternalizeTextContent, READ_ONLY_TOOL_ANNOTATIONS, withDefaultIcons, withValidatedArgs, wrapToolHandler, } from './shared.js';
+import { buildBatchPathContext, buildResourceLink, buildToolErrorResponse, buildToolResponse, createToolProgressSession, executeToolWithDiagnostics, maybeExternalizeTextContent, READ_ONLY_TOOL_ANNOTATIONS, withDefaultIcons, withValidatedArgs, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
 export const READ_MULTIPLE_FILES_TOOL = {
     name: 'read_many',
@@ -20,6 +20,23 @@ export const READ_MULTIPLE_FILES_TOOL = {
         'Per-file `truncationReason` can be `head`, `range`, or `externalized`.',
     ],
 };
+function buildReadManyCompletionSuffix(summary) {
+    const total = summary?.total ?? 0;
+    const failed = summary?.failed ?? 0;
+    const succeeded = summary?.succeeded ?? 0;
+    if (failed) {
+        return `${succeeded}/${total} read, ${failed} failed`;
+    }
+    const label = total === 1 ? 'file' : 'files';
+    return `${total} ${label} read`;
+}
+function createReadManyProgressCallbacks(extra, context, totalPaths) {
+    const progress = createToolProgressSession(extra, `🕮 read_many: ${context}`);
+    const onReadComplete = () => {
+        progress.increment((current) => `🕮 read_many: ${context} [${current}/${totalPaths} read]`);
+    };
+    return { progress, onReadComplete };
+}
 function toStructuredReadManyResult(result) {
     const structured = {
         path: result.path,
@@ -134,28 +151,13 @@ export function registerReadMultipleFilesTool(server, options = {}) {
             timedSignal: { timeoutMs: DEFAULT_SEARCH_TIMEOUT_MS },
             context: { path: primaryPath },
             run: async (signal) => {
-                const first = path.basename(args.paths[0] ?? '');
-                const extraPaths = args.paths.length > 1
-                    ? `, ${path.basename(args.paths[1] ?? '')}${args.paths.length > 2 ? '…' : ''}`
-                    : '';
-                const context = `${args.paths.length} files [${first}${extraPaths}]`;
-                const progress = createToolProgressSession(extra, `🕮 read_many: ${context}`);
-                const onReadComplete = () => {
-                    progress.increment((current) => `🕮 read_many: ${context} [${current}/${args.paths.length} read]`);
-                };
+                const context = buildBatchPathContext(args.paths, 'files');
+                const { progress, onReadComplete } = createReadManyProgressCallbacks(extra, context, args.paths.length);
                 try {
                     const result = await handleReadMultipleFiles(args, signal, options.resourceStore, onReadComplete);
                     const sc = result.structuredContent;
+                    const suffix = buildReadManyCompletionSuffix(sc.summary);
                     const total = sc.summary?.total ?? 0;
-                    const failed = sc.summary?.failed ?? 0;
-                    const succeeded = sc.summary?.succeeded ?? 0;
-                    let suffix;
-                    if (failed) {
-                        suffix = `${succeeded}/${total} read, ${failed} failed`;
-                    }
-                    else {
-                        suffix = `${total} files read`;
-                    }
                     const finalCurrent = Math.max(total, progress.getCurrent() + 1);
                     progress.complete(`🕮 read_many: ${context} • ${suffix}`, finalCurrent);
                     return result;

package/dist/tools/search-files.js

@@ -4,26 +4,8 @@ import { DEFAULT_EXCLUDE_PATTERNS, DEFAULT_SEARCH_TIMEOUT_MS, } from '../lib/con
 import { ErrorCode } from '../lib/errors.js';
 import { searchFiles } from '../lib/file-operations/search-files.js';
 import { SearchFilesInputSchema, SearchFilesOutputSchema } from '../schemas.js';
-import { buildToolErrorResponse, buildToolResponse, createProgressReporter, executeToolWithDiagnostics, notifyProgress, READ_ONLY_TOOL_ANNOTATIONS, resolvePathOrRoot, withDefaultIcons, withValidatedArgs, wrapToolHandler, } from './shared.js';
+import { buildToolErrorResponse, buildToolResponse, createProgressReporter, decodeOffsetCursor, encodeOffsetCursor, executeToolWithDiagnostics, notifyProgress, READ_ONLY_TOOL_ANNOTATIONS, resolvePathOrRoot, withDefaultIcons, withValidatedArgs, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
-function encodeCursor(offset) {
-    return Buffer.from(JSON.stringify({ offset })).toString('base64url');
-}
-function decodeCursor(cursor) {
-    try {
-        const parsed = JSON.parse(Buffer.from(cursor, 'base64url').toString('utf-8'));
-        if (typeof parsed === 'object' &&
-            parsed !== null &&
-            typeof parsed.offset === 'number') {
-            const { offset } = parsed;
-            return Number.isInteger(offset) && offset >= 0 ? offset : 0;
-        }
-    }
-    catch {
-        // ignore malformed cursor
-    }
-    return 0;
-}
 export const SEARCH_FILES_TOOL = {
     name: 'find',
     title: 'Find Files',
@@ -43,7 +25,7 @@ export const SEARCH_FILES_TOOL = {
 async function handleSearchFiles(args, signal, onProgress) {
     const basePath = resolvePathOrRoot(args.path);
     const excludePatterns = args.includeIgnored ? [] : DEFAULT_EXCLUDE_PATTERNS;
-    const cursorOffset = args.cursor !== undefined ? decodeCursor(args.cursor) : 0;
+    const cursorOffset = args.cursor !== undefined ? decodeOffsetCursor(args.cursor) : 0;
     const pageSize = args.maxResults;
     const fetchMax = cursorOffset + pageSize;
     const searchOptions = {
@@ -59,7 +41,7 @@ async function handleSearchFiles(args, signal, onProgress) {
     const allResults = result.results;
     const displayResults = cursorOffset > 0 ? allResults.slice(cursorOffset) : allResults;
     const nextCursor = result.summary.truncated && displayResults.length > 0
-        ? encodeCursor(cursorOffset + displayResults.length)
+        ? encodeOffsetCursor(cursorOffset + displayResults.length)
         : undefined;
     const relativeResults = [];
     for (const entry of displayResults) {

package/dist/tools/shared.d.ts

@@ -139,3 +139,6 @@ export declare function wrapToolHandler<Args, Result>(handler: (args: Args, extr
  * See `src/server/roots-manager.ts` for the update lifecycle.
  */
 export declare function resolvePathOrRoot(pathValue: string | undefined): string;
+export declare function encodeOffsetCursor(offset: number): string;
+export declare function decodeOffsetCursor(cursor: string): number;
+export declare function buildBatchPathContext(paths: readonly string[], unitLabel?: string): string;

package/dist/tools/shared.js

@@ -1,3 +1,4 @@
+import * as path from 'node:path';
 import { channel } from 'node:diagnostics_channel';
 import { z } from 'zod';
 import { parseTrueEnvFlag } from '../lib/constants.js';
@@ -403,3 +404,29 @@ export function resolvePathOrRoot(pathValue) {
     }
     return root;
 }
+export function encodeOffsetCursor(offset) {
+    return Buffer.from(JSON.stringify({ offset })).toString('base64url');
+}
+export function decodeOffsetCursor(cursor) {
+    try {
+        const parsed = JSON.parse(Buffer.from(cursor, 'base64url').toString('utf-8'));
+        if (typeof parsed === 'object' &&
+            parsed !== null &&
+            typeof parsed.offset === 'number') {
+            const { offset } = parsed;
+            return Number.isInteger(offset) && offset >= 0 ? offset : 0;
+        }
+    }
+    catch {
+        // ignore malformed cursor
+    }
+    return 0;
+}
+export function buildBatchPathContext(paths, unitLabel = 'paths') {
+    const normalizedLabel = paths.length === 1 ? unitLabel.replace(/s$/i, '') : unitLabel;
+    const first = path.basename(paths[0] ?? '');
+    const extraPaths = paths.length > 1
+        ? `, ${path.basename(paths[1] ?? '')}${paths.length > 2 ? '…' : ''}`
+        : '';
+    return `${paths.length} ${normalizedLabel} [${first}${extraPaths}]`;
+}

package/dist/tools/stat-many.js

@@ -1,10 +1,9 @@
-import * as path from 'node:path';
 import { formatBytes, joinLines } from '../config.js';
 import { DEFAULT_SEARCH_TIMEOUT_MS } from '../lib/constants.js';
 import { ErrorCode } from '../lib/errors.js';
 import { getMultipleFileInfo } from '../lib/file-operations/file-info.js';
 import { GetMultipleFileInfoInputSchema, GetMultipleFileInfoOutputSchema, } from '../schemas.js';
-import { buildFileInfoPayload, buildToolErrorResponse, buildToolResponse, createToolProgressSession, executeToolWithDiagnostics, READ_ONLY_TOOL_ANNOTATIONS, withDefaultIcons, withValidatedArgs, wrapToolHandler, } from './shared.js';
+import { buildBatchPathContext, buildFileInfoPayload, buildToolErrorResponse, buildToolResponse, createToolProgressSession, executeToolWithDiagnostics, READ_ONLY_TOOL_ANNOTATIONS, withDefaultIcons, withValidatedArgs, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
 export const GET_MULTIPLE_FILE_INFO_TOOL = {
     name: 'stat_many',
@@ -16,6 +15,22 @@ export const GET_MULTIPLE_FILE_INFO_TOOL = {
     taskSupport: 'optional',
     nuances: ['Use before read/search when file size/type uncertainty exists.'],
 };
+function buildStatManyCompletionSuffix(summary) {
+    const total = summary?.total ?? 0;
+    const failed = summary?.failed ?? 0;
+    const succeeded = summary?.succeeded ?? 0;
+    if (failed) {
+        return `${succeeded}/${total} OK, ${failed} failed`;
+    }
+    return `${total} OK`;
+}
+function createStatManyProgressCallbacks(extra, context, totalPaths) {
+    const progress = createToolProgressSession(extra, `🕮 stat_many: ${context}`);
+    const onProgress = () => {
+        progress.increment((current) => `🕮 stat_many: ${context} [${current}/${totalPaths} scanned]`);
+    };
+    return { progress, onProgress };
+}
 function formatFileInfoDetail(info) {
     const lines = [
         `${info.name} (${info.type})`,
@@ -74,28 +89,13 @@ export function registerGetMultipleFileInfoTool(server, options = {}) {
             timedSignal: { timeoutMs: DEFAULT_SEARCH_TIMEOUT_MS },
             context: { path: primaryPath },
             run: async (signal) => {
-                const first = path.basename(args.paths[0] ?? '');
-                const extraPaths = args.paths.length > 1
-                    ? `, ${path.basename(args.paths[1] ?? '')}${args.paths.length > 2 ? '…' : ''}`
-                    : '';
-                const context = `${args.paths.length} paths [${first}${extraPaths}]`;
-                const progress = createToolProgressSession(extra, `🕮 stat_many: ${context}`);
-                const onProgress = () => {
-                    progress.increment((current) => `🕮 stat_many: ${context} [${current}/${args.paths.length} scanned]`);
-                };
+                const context = buildBatchPathContext(args.paths);
+                const { progress, onProgress } = createStatManyProgressCallbacks(extra, context, args.paths.length);
                 try {
                     const result = await handleGetMultipleFileInfo(args, signal, onProgress);
                     const sc = result.structuredContent;
+                    const suffix = buildStatManyCompletionSuffix(sc.summary);
                     const total = sc.summary?.total ?? 0;
-                    const failed = sc.summary?.failed ?? 0;
-                    const succeeded = sc.summary?.succeeded ?? 0;
-                    let suffix;
-                    if (failed) {
-                        suffix = `${succeeded}/${total} OK, ${failed} failed`;
-                    }
-                    else {
-                        suffix = `${total} OK`;
-                    }
                     const finalCurrent = Math.max(total, progress.getCurrent() + 1);
                     progress.complete(`🕮 stat_many: ${context} • ${suffix}`, finalCurrent);
                     return result;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@j0hanz/filesystem-mcp",
-  "version": "1.7.2",
+  "version": "1.7.3",
   "mcpName": "io.github.j0hanz/filesystem-mcp",
   "description": "MCP Server that enables LLMs to interact with the local filesystem.",
   "type": "module",