@j0hanz/filesystem-mcp 1.2.0 → 1.2.1

package/dist/config.d.ts

@@ -102,6 +102,7 @@ export declare const ErrorCode: {
     readonly E_NOT_DIRECTORY: "E_NOT_DIRECTORY";
     readonly E_TOO_LARGE: "E_TOO_LARGE";
     readonly E_TIMEOUT: "E_TIMEOUT";
+    readonly E_CANCELLED: "E_CANCELLED";
     readonly E_INVALID_PATTERN: "E_INVALID_PATTERN";
     readonly E_INVALID_INPUT: "E_INVALID_INPUT";
     readonly E_PERMISSION_DENIED: "E_PERMISSION_DENIED";

package/dist/config.js

@@ -5,6 +5,7 @@ export const ErrorCode = {
     E_NOT_DIRECTORY: 'E_NOT_DIRECTORY',
     E_TOO_LARGE: 'E_TOO_LARGE',
     E_TIMEOUT: 'E_TIMEOUT',
+    E_CANCELLED: 'E_CANCELLED',
     E_INVALID_PATTERN: 'E_INVALID_PATTERN',
     E_INVALID_INPUT: 'E_INVALID_INPUT',
     E_PERMISSION_DENIED: 'E_PERMISSION_DENIED',

package/dist/lib/errors.js

@@ -146,8 +146,6 @@ function isTimeoutErrorSingle(error) {
         return false;
     if (error.name === 'TimeoutError')
         return true;
-    if (isAbortErrorSingle(error))
-        return true;
     const code = getNodeErrorCodeLabel(error);
     if (code === 'ETIMEDOUT')
         return true;
@@ -184,6 +182,7 @@ const ERROR_SUGGESTIONS = {
     [ErrorCode.E_NOT_DIRECTORY]: 'The path points to a file, not a directory. Use read to read file contents.',
     [ErrorCode.E_TOO_LARGE]: 'The file exceeds the size limit. Use head to read a partial preview, or narrow the scope of what you read.',
     [ErrorCode.E_TIMEOUT]: 'The operation timed out. Try a smaller scope (narrower path), fewer results (maxResults), or search fewer files.',
+    [ErrorCode.E_CANCELLED]: 'The operation was cancelled. This is not an error — no retry is needed unless you want to re-run the operation.',
     [ErrorCode.E_INVALID_PATTERN]: 'The glob or regex pattern is invalid. Check syntax and escape special characters.',
     [ErrorCode.E_INVALID_INPUT]: 'One or more input parameters are invalid. Check the tool documentation for correct usage.',
     [ErrorCode.E_PERMISSION_DENIED]: 'Permission denied by the operating system. Check file permissions.',
@@ -220,6 +219,9 @@ function classifyMessageError(error) {
     return undefined;
 }
 function classifyError(error) {
+    if (isAbortError(error)) {
+        return ErrorCode.E_CANCELLED;
+    }
     if (isTimeoutLikeError(error)) {
         return ErrorCode.E_TIMEOUT;
     }

package/dist/schemas.d.ts

@@ -21,6 +21,7 @@ export declare const ToolErrorResponseSchema: z.ZodObject<{
             readonly E_NOT_DIRECTORY: "E_NOT_DIRECTORY";
             readonly E_TOO_LARGE: "E_TOO_LARGE";
             readonly E_TIMEOUT: "E_TIMEOUT";
+            readonly E_CANCELLED: "E_CANCELLED";
             readonly E_INVALID_PATTERN: "E_INVALID_PATTERN";
             readonly E_INVALID_INPUT: "E_INVALID_INPUT";
             readonly E_PERMISSION_DENIED: "E_PERMISSION_DENIED";
@@ -112,6 +113,7 @@ export declare const ListAllowedDirectoriesOutputSchema: z.ZodObject<{
             readonly E_NOT_DIRECTORY: "E_NOT_DIRECTORY";
             readonly E_TOO_LARGE: "E_TOO_LARGE";
             readonly E_TIMEOUT: "E_TIMEOUT";
+            readonly E_CANCELLED: "E_CANCELLED";
             readonly E_INVALID_PATTERN: "E_INVALID_PATTERN";
             readonly E_INVALID_INPUT: "E_INVALID_INPUT";
             readonly E_PERMISSION_DENIED: "E_PERMISSION_DENIED";
@@ -159,6 +161,7 @@ export declare const ListDirectoryOutputSchema: z.ZodObject<{
             readonly E_NOT_DIRECTORY: "E_NOT_DIRECTORY";
             readonly E_TOO_LARGE: "E_TOO_LARGE";
             readonly E_TIMEOUT: "E_TIMEOUT";
+            readonly E_CANCELLED: "E_CANCELLED";
             readonly E_INVALID_PATTERN: "E_INVALID_PATTERN";
             readonly E_INVALID_INPUT: "E_INVALID_INPUT";
             readonly E_PERMISSION_DENIED: "E_PERMISSION_DENIED";
@@ -182,6 +185,7 @@ export declare const SearchFilesOutputSchema: z.ZodObject<{
             readonly E_NOT_DIRECTORY: "E_NOT_DIRECTORY";
             readonly E_TOO_LARGE: "E_TOO_LARGE";
             readonly E_TIMEOUT: "E_TIMEOUT";
+            readonly E_CANCELLED: "E_CANCELLED";
             readonly E_INVALID_PATTERN: "E_INVALID_PATTERN";
             readonly E_INVALID_INPUT: "E_INVALID_INPUT";
             readonly E_PERMISSION_DENIED: "E_PERMISSION_DENIED";
@@ -220,6 +224,7 @@ export declare const SearchContentOutputSchema: z.ZodObject<{
             readonly E_NOT_DIRECTORY: "E_NOT_DIRECTORY";
             readonly E_TOO_LARGE: "E_TOO_LARGE";
             readonly E_TIMEOUT: "E_TIMEOUT";
+            readonly E_CANCELLED: "E_CANCELLED";
             readonly E_INVALID_PATTERN: "E_INVALID_PATTERN";
             readonly E_INVALID_INPUT: "E_INVALID_INPUT";
             readonly E_PERMISSION_DENIED: "E_PERMISSION_DENIED";
@@ -271,6 +276,7 @@ export declare const TreeOutputSchema: z.ZodObject<{
             readonly E_NOT_DIRECTORY: "E_NOT_DIRECTORY";
             readonly E_TOO_LARGE: "E_TOO_LARGE";
             readonly E_TIMEOUT: "E_TIMEOUT";
+            readonly E_CANCELLED: "E_CANCELLED";
             readonly E_INVALID_PATTERN: "E_INVALID_PATTERN";
             readonly E_INVALID_INPUT: "E_INVALID_INPUT";
             readonly E_PERMISSION_DENIED: "E_PERMISSION_DENIED";
@@ -307,6 +313,7 @@ export declare const ReadFileOutputSchema: z.ZodObject<{
             readonly E_NOT_DIRECTORY: "E_NOT_DIRECTORY";
             readonly E_TOO_LARGE: "E_TOO_LARGE";
             readonly E_TIMEOUT: "E_TIMEOUT";
+            readonly E_CANCELLED: "E_CANCELLED";
             readonly E_INVALID_PATTERN: "E_INVALID_PATTERN";
             readonly E_INVALID_INPUT: "E_INVALID_INPUT";
             readonly E_PERMISSION_DENIED: "E_PERMISSION_DENIED";
@@ -357,6 +364,7 @@ export declare const ReadMultipleFilesOutputSchema: z.ZodObject<{
             readonly E_NOT_DIRECTORY: "E_NOT_DIRECTORY";
             readonly E_TOO_LARGE: "E_TOO_LARGE";
             readonly E_TIMEOUT: "E_TIMEOUT";
+            readonly E_CANCELLED: "E_CANCELLED";
             readonly E_INVALID_PATTERN: "E_INVALID_PATTERN";
             readonly E_INVALID_INPUT: "E_INVALID_INPUT";
             readonly E_PERMISSION_DENIED: "E_PERMISSION_DENIED";
@@ -397,6 +405,7 @@ export declare const GetFileInfoOutputSchema: z.ZodObject<{
             readonly E_NOT_DIRECTORY: "E_NOT_DIRECTORY";
             readonly E_TOO_LARGE: "E_TOO_LARGE";
             readonly E_TIMEOUT: "E_TIMEOUT";
+            readonly E_CANCELLED: "E_CANCELLED";
             readonly E_INVALID_PATTERN: "E_INVALID_PATTERN";
             readonly E_INVALID_INPUT: "E_INVALID_INPUT";
             readonly E_PERMISSION_DENIED: "E_PERMISSION_DENIED";
@@ -446,6 +455,7 @@ export declare const GetMultipleFileInfoOutputSchema: z.ZodObject<{
             readonly E_NOT_DIRECTORY: "E_NOT_DIRECTORY";
             readonly E_TOO_LARGE: "E_TOO_LARGE";
             readonly E_TIMEOUT: "E_TIMEOUT";
+            readonly E_CANCELLED: "E_CANCELLED";
             readonly E_INVALID_PATTERN: "E_INVALID_PATTERN";
             readonly E_INVALID_INPUT: "E_INVALID_INPUT";
             readonly E_PERMISSION_DENIED: "E_PERMISSION_DENIED";
@@ -471,6 +481,7 @@ export declare const CreateDirectoryOutputSchema: z.ZodObject<{
             readonly E_NOT_DIRECTORY: "E_NOT_DIRECTORY";
             readonly E_TOO_LARGE: "E_TOO_LARGE";
             readonly E_TIMEOUT: "E_TIMEOUT";
+            readonly E_CANCELLED: "E_CANCELLED";
             readonly E_INVALID_PATTERN: "E_INVALID_PATTERN";
             readonly E_INVALID_INPUT: "E_INVALID_INPUT";
             readonly E_PERMISSION_DENIED: "E_PERMISSION_DENIED";
@@ -498,6 +509,7 @@ export declare const WriteFileOutputSchema: z.ZodObject<{
             readonly E_NOT_DIRECTORY: "E_NOT_DIRECTORY";
             readonly E_TOO_LARGE: "E_TOO_LARGE";
             readonly E_TIMEOUT: "E_TIMEOUT";
+            readonly E_CANCELLED: "E_CANCELLED";
             readonly E_INVALID_PATTERN: "E_INVALID_PATTERN";
             readonly E_INVALID_INPUT: "E_INVALID_INPUT";
             readonly E_PERMISSION_DENIED: "E_PERMISSION_DENIED";
@@ -531,6 +543,7 @@ export declare const EditFileOutputSchema: z.ZodObject<{
             readonly E_NOT_DIRECTORY: "E_NOT_DIRECTORY";
             readonly E_TOO_LARGE: "E_TOO_LARGE";
             readonly E_TIMEOUT: "E_TIMEOUT";
+            readonly E_CANCELLED: "E_CANCELLED";
             readonly E_INVALID_PATTERN: "E_INVALID_PATTERN";
             readonly E_INVALID_INPUT: "E_INVALID_INPUT";
             readonly E_PERMISSION_DENIED: "E_PERMISSION_DENIED";
@@ -558,6 +571,7 @@ export declare const MoveFileOutputSchema: z.ZodObject<{
             readonly E_NOT_DIRECTORY: "E_NOT_DIRECTORY";
             readonly E_TOO_LARGE: "E_TOO_LARGE";
             readonly E_TIMEOUT: "E_TIMEOUT";
+            readonly E_CANCELLED: "E_CANCELLED";
             readonly E_INVALID_PATTERN: "E_INVALID_PATTERN";
             readonly E_INVALID_INPUT: "E_INVALID_INPUT";
             readonly E_PERMISSION_DENIED: "E_PERMISSION_DENIED";
@@ -585,6 +599,7 @@ export declare const DeleteFileOutputSchema: z.ZodObject<{
             readonly E_NOT_DIRECTORY: "E_NOT_DIRECTORY";
             readonly E_TOO_LARGE: "E_TOO_LARGE";
             readonly E_TIMEOUT: "E_TIMEOUT";
+            readonly E_CANCELLED: "E_CANCELLED";
             readonly E_INVALID_PATTERN: "E_INVALID_PATTERN";
             readonly E_INVALID_INPUT: "E_INVALID_INPUT";
             readonly E_PERMISSION_DENIED: "E_PERMISSION_DENIED";
@@ -613,6 +628,7 @@ export declare const CalculateHashOutputSchema: z.ZodObject<{
             readonly E_NOT_DIRECTORY: "E_NOT_DIRECTORY";
             readonly E_TOO_LARGE: "E_TOO_LARGE";
             readonly E_TIMEOUT: "E_TIMEOUT";
+            readonly E_CANCELLED: "E_CANCELLED";
             readonly E_INVALID_PATTERN: "E_INVALID_PATTERN";
             readonly E_INVALID_INPUT: "E_INVALID_INPUT";
             readonly E_PERMISSION_DENIED: "E_PERMISSION_DENIED";
@@ -645,6 +661,7 @@ export declare const DiffFilesOutputSchema: z.ZodObject<{
             readonly E_NOT_DIRECTORY: "E_NOT_DIRECTORY";
             readonly E_TOO_LARGE: "E_TOO_LARGE";
             readonly E_TIMEOUT: "E_TIMEOUT";
+            readonly E_CANCELLED: "E_CANCELLED";
             readonly E_INVALID_PATTERN: "E_INVALID_PATTERN";
             readonly E_INVALID_INPUT: "E_INVALID_INPUT";
             readonly E_PERMISSION_DENIED: "E_PERMISSION_DENIED";
@@ -675,6 +692,7 @@ export declare const ApplyPatchOutputSchema: z.ZodObject<{
             readonly E_NOT_DIRECTORY: "E_NOT_DIRECTORY";
             readonly E_TOO_LARGE: "E_TOO_LARGE";
             readonly E_TIMEOUT: "E_TIMEOUT";
+            readonly E_CANCELLED: "E_CANCELLED";
             readonly E_INVALID_PATTERN: "E_INVALID_PATTERN";
             readonly E_INVALID_INPUT: "E_INVALID_INPUT";
             readonly E_PERMISSION_DENIED: "E_PERMISSION_DENIED";
@@ -718,6 +736,7 @@ export declare const SearchAndReplaceOutputSchema: z.ZodObject<{
             readonly E_NOT_DIRECTORY: "E_NOT_DIRECTORY";
             readonly E_TOO_LARGE: "E_TOO_LARGE";
             readonly E_TIMEOUT: "E_TIMEOUT";
+            readonly E_CANCELLED: "E_CANCELLED";
             readonly E_INVALID_PATTERN: "E_INVALID_PATTERN";
             readonly E_INVALID_INPUT: "E_INVALID_INPUT";
             readonly E_PERMISSION_DENIED: "E_PERMISSION_DENIED";

package/dist/server.js

@@ -301,22 +301,33 @@ export async function createServer(options = {}) {
     registerResultResources(server, resourceStore, localIcon);
     registerCompletions(server);
     {
-        const typedServer = server;
-        const origReg = typedServer.registerTool.bind(server);
-        typedServer.registerTool = (...regArgs) => {
-            const handlerIdx = regArgs.length - 1;
-            const origHandler = regArgs[handlerIdx];
-            if (typeof origHandler !== 'function')
+        const stripStructured = process.env['FS_CONTEXT_STRIP_STRUCTURED'] !== '0';
+        if (stripStructured) {
+            const typedServer = server;
+            const origReg = typedServer.registerTool.bind(server);
+            typedServer.registerTool = (...regArgs) => {
+                // Strip outputSchema so SDK won't require structuredContent
+                if (regArgs.length >= 2 &&
+                    regArgs[1] &&
+                    typeof regArgs[1] === 'object') {
+                    const config = { ...regArgs[1] };
+                    delete config['outputSchema'];
+                    regArgs[1] = config;
+                }
+                const handlerIdx = regArgs.length - 1;
+                const origHandler = regArgs[handlerIdx];
+                if (typeof origHandler !== 'function')
+                    return origReg(...regArgs);
+                regArgs[handlerIdx] = async (...hArgs) => {
+                    const r = await origHandler(...hArgs);
+                    if (!r || typeof r !== 'object')
+                        return r;
+                    const record = r;
+                    return Object.fromEntries(Object.entries(record).filter(([key]) => key !== 'structuredContent'));
+                };
                 return origReg(...regArgs);
-            regArgs[handlerIdx] = async (...hArgs) => {
-                const r = await origHandler(...hArgs);
-                if (!r || typeof r !== 'object')
-                    return r;
-                const record = r;
-                return Object.fromEntries(Object.entries(record).filter(([key]) => key !== 'structuredContent'));
             };
-            return origReg(...regArgs);
-        };
+        }
     }
     registerAllTools(server, {
         resourceStore,

package/dist/tools/apply-patch.js

@@ -5,7 +5,7 @@ import { MAX_TEXT_FILE_SIZE } from '../lib/constants.js';
 import { ErrorCode, McpError } from '../lib/errors.js';
 import { atomicWriteFile, withAbort } from '../lib/fs-helpers.js';
 import { validateExistingPath } from '../lib/path-validation.js';
-import { ApplyPatchInputSchema, } from '../schemas.js';
+import { ApplyPatchInputSchema, ApplyPatchOutputSchema } from '../schemas.js';
 import { buildToolErrorResponse, buildToolResponse, DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS, executeToolWithDiagnostics, withDefaultIcons, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
 const APPLY_PATCH_TOOL = {
@@ -14,6 +14,7 @@ const APPLY_PATCH_TOOL = {
         'Generate the patch with `diff_files`, then validate with `dryRun: true` before writing. ' +
         'On failure, regenerate a fresh patch via `diff_files` against the current file content and retry.',
     inputSchema: ApplyPatchInputSchema,
+    outputSchema: ApplyPatchOutputSchema,
     annotations: DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS,
 };
 function assertPatchTargetSizeWithinLimit(filePath, size, maxFileSize) {

package/dist/tools/calculate-hash.js

@@ -8,7 +8,7 @@ import { isIgnoredByGitignore, loadRootGitignore, } from '../lib/file-operations
 import { globEntries } from '../lib/file-operations/glob-engine.js';
 import { assertNotAborted, withAbort } from '../lib/fs-helpers.js';
 import { validateExistingPath } from '../lib/path-validation.js';
-import { CalculateHashInputSchema, } from '../schemas.js';
+import { CalculateHashInputSchema, CalculateHashOutputSchema, } from '../schemas.js';
 import { buildToolErrorResponse, buildToolResponse, createProgressReporter, executeToolWithDiagnostics, notifyProgress, READ_ONLY_TOOL_ANNOTATIONS, withDefaultIcons, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
 const WINDOWS_PATH_SEPARATOR = /\\/gu;
@@ -16,6 +16,7 @@ const CALCULATE_HASH_TOOL = {
     title: 'Calculate Hash',
     description: 'Calculate SHA-256 hash of a file or directory.',
     inputSchema: CalculateHashInputSchema,
+    outputSchema: CalculateHashOutputSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,
 };
 async function hashFile(filePath, encoding, signal) {

package/dist/tools/create-directory.js

@@ -3,13 +3,14 @@ import * as path from 'node:path';
 import { ErrorCode } from '../lib/errors.js';
 import { withAbort } from '../lib/fs-helpers.js';
 import { validatePathForWrite } from '../lib/path-validation.js';
-import { CreateDirectoryInputSchema, } from '../schemas.js';
+import { CreateDirectoryInputSchema, CreateDirectoryOutputSchema, } from '../schemas.js';
 import { buildToolErrorResponse, buildToolResponse, executeToolWithDiagnostics, IDEMPOTENT_WRITE_TOOL_ANNOTATIONS, withDefaultIcons, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
 const CREATE_DIRECTORY_TOOL = {
     title: 'Create Directory',
     description: 'Create a new directory at the specified path (recursive)',
     inputSchema: CreateDirectoryInputSchema,
+    outputSchema: CreateDirectoryOutputSchema,
     annotations: IDEMPOTENT_WRITE_TOOL_ANNOTATIONS,
 };
 async function handleCreateDirectory(args, signal) {

package/dist/tools/delete-file.js

@@ -3,13 +3,14 @@ import * as path from 'node:path';
 import { ErrorCode, isNodeError } from '../lib/errors.js';
 import { withAbort } from '../lib/fs-helpers.js';
 import { validatePathForWrite } from '../lib/path-validation.js';
-import { DeleteFileInputSchema, } from '../schemas.js';
+import { DeleteFileInputSchema, DeleteFileOutputSchema } from '../schemas.js';
 import { buildToolErrorResponse, buildToolResponse, DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS, executeToolWithDiagnostics, withDefaultIcons, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
 const DELETE_FILE_TOOL = {
     title: 'Delete File',
     description: 'Delete a file or directory.',
     inputSchema: DeleteFileInputSchema,
+    outputSchema: DeleteFileOutputSchema,
     annotations: DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS,
 };
 async function handleDeleteFile(args, signal) {

package/dist/tools/diff-files.js

@@ -5,7 +5,7 @@ import { MAX_TEXT_FILE_SIZE } from '../lib/constants.js';
 import { ErrorCode, McpError } from '../lib/errors.js';
 import { withAbort } from '../lib/fs-helpers.js';
 import { validateExistingPath } from '../lib/path-validation.js';
-import { DiffFilesInputSchema, } from '../schemas.js';
+import { DiffFilesInputSchema, DiffFilesOutputSchema } from '../schemas.js';
 import { buildResourceLink, buildToolErrorResponse, buildToolResponse, executeToolWithDiagnostics, maybeExternalizeTextContent, READ_ONLY_TOOL_ANNOTATIONS, withDefaultIcons, wrapToolHandler, } from './shared.js';
 const DIFF_FILES_TOOL = {
     title: 'Diff Files',
@@ -13,6 +13,7 @@ const DIFF_FILES_TOOL = {
         'Output feeds directly into `apply_patch`. ' +
         'Check `isIdentical` in the response — if true, the files are already in sync and no patch is needed.',
     inputSchema: DiffFilesInputSchema,
+    outputSchema: DiffFilesOutputSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,
 };
 function assertDiffFileSizeWithinLimit(filePath, size, maxFileSize) {

package/dist/tools/edit-file.js

@@ -3,7 +3,7 @@ import * as path from 'node:path';
 import { ErrorCode } from '../lib/errors.js';
 import { atomicWriteFile } from '../lib/fs-helpers.js';
 import { validateExistingPath } from '../lib/path-validation.js';
-import { EditFileInputSchema } from '../schemas.js';
+import { EditFileInputSchema, EditFileOutputSchema } from '../schemas.js';
 import { buildToolErrorResponse, buildToolResponse, DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS, executeToolWithDiagnostics, withDefaultIcons, wrapToolHandler, } from './shared.js';
 const EDIT_FILE_TOOL = {
     title: 'Edit File',
@@ -12,6 +12,7 @@ const EDIT_FILE_TOOL = {
         '`oldText` must match exactly — include 3–5 lines of surrounding context to uniquely target the location. ' +
         'Use `dryRun: true` to validate edits before writing.',
     inputSchema: EditFileInputSchema,
+    outputSchema: EditFileOutputSchema,
     annotations: DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS,
 };
 function applyEdits(content, edits) {

package/dist/tools/list-directory.js

@@ -3,7 +3,7 @@ import { formatOperationSummary, joinLines } from '../config.js';
 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, } from '../schemas.js';
+import { ListDirectoryInputSchema, ListDirectoryOutputSchema, } from '../schemas.js';
 import { buildToolErrorResponse, buildToolResponse, executeToolWithDiagnostics, READ_ONLY_TOOL_ANNOTATIONS, resolvePathOrRoot, withDefaultIcons, wrapToolHandler, } from './shared.js';
 const LIST_DIRECTORY_TOOL = {
     title: 'List Directory',
@@ -13,6 +13,7 @@ const LIST_DIRECTORY_TOOL = {
         'Use includeIgnored=true to include ignored directories like node_modules. ' +
         'For recursive searches, use find instead.',
     inputSchema: ListDirectoryInputSchema,
+    outputSchema: ListDirectoryOutputSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,
 };
 function buildListTextResult(result) {

package/dist/tools/move-file.js

@@ -3,13 +3,14 @@ import * as path from 'node:path';
 import { ErrorCode, isNodeError } from '../lib/errors.js';
 import { withAbort } from '../lib/fs-helpers.js';
 import { validateExistingPath, validatePathForWrite, } from '../lib/path-validation.js';
-import { MoveFileInputSchema } from '../schemas.js';
+import { MoveFileInputSchema, MoveFileOutputSchema } from '../schemas.js';
 import { buildToolErrorResponse, buildToolResponse, DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS, executeToolWithDiagnostics, withDefaultIcons, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
 const MOVE_FILE_TOOL = {
     title: 'Move File',
     description: 'Move or rename a file or directory.',
     inputSchema: MoveFileInputSchema,
+    outputSchema: MoveFileOutputSchema,
     annotations: DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS,
 };
 async function handleMoveFile(args, signal) {

package/dist/tools/read-multiple.js

@@ -2,7 +2,7 @@ import * as path from 'node:path';
 import { DEFAULT_READ_MANY_MAX_TOTAL_SIZE, DEFAULT_SEARCH_TIMEOUT_MS, } from '../lib/constants.js';
 import { ErrorCode } from '../lib/errors.js';
 import { readMultipleFiles } from '../lib/file-operations/read-multiple-files.js';
-import { ReadMultipleFilesInputSchema, } from '../schemas.js';
+import { ReadMultipleFilesInputSchema, ReadMultipleFilesOutputSchema, } from '../schemas.js';
 import { buildResourceLink, buildToolErrorResponse, buildToolResponse, executeToolWithDiagnostics, maybeExternalizeTextContent, READ_ONLY_TOOL_ANNOTATIONS, withDefaultIcons, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
 const READ_MULTIPLE_FILES_TOOL = {
@@ -11,6 +11,7 @@ const READ_MULTIPLE_FILES_TOOL = {
         'Returns contents and metadata for each file. ' +
         'For single file, use read for simpler output.',
     inputSchema: ReadMultipleFilesInputSchema,
+    outputSchema: ReadMultipleFilesOutputSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,
 };
 async function handleReadMultipleFiles(args, signal, resourceStore) {

package/dist/tools/read.js

@@ -2,7 +2,7 @@ import * as path from 'node:path';
 import { DEFAULT_SEARCH_TIMEOUT_MS, MAX_TEXT_FILE_SIZE, } from '../lib/constants.js';
 import { ErrorCode } from '../lib/errors.js';
 import { readFile } from '../lib/fs-helpers.js';
-import { ReadFileInputSchema } from '../schemas.js';
+import { ReadFileInputSchema, ReadFileOutputSchema } from '../schemas.js';
 import { buildResourceLink, buildToolErrorResponse, buildToolResponse, executeToolWithDiagnostics, maybeExternalizeTextContent, READ_ONLY_TOOL_ANNOTATIONS, withDefaultIcons, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
 const READ_FILE_TOOL = {
@@ -11,6 +11,7 @@ const READ_FILE_TOOL = {
         'Use head parameter to preview the first N lines of large files. ' +
         'For multiple files, use read_many for efficiency.',
     inputSchema: ReadFileInputSchema,
+    outputSchema: ReadFileOutputSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,
 };
 async function handleReadFile(args, signal, resourceStore) {

package/dist/tools/replace-in-files.js

@@ -7,7 +7,7 @@ import { ErrorCode, formatUnknownErrorMessage, McpError, } from '../lib/errors.j
 import { globEntries } from '../lib/file-operations/glob-engine.js';
 import { atomicWriteFile, withAbort } from '../lib/fs-helpers.js';
 import { validateExistingPath, validatePathForWrite, } from '../lib/path-validation.js';
-import { SearchAndReplaceInputSchema, } from '../schemas.js';
+import { SearchAndReplaceInputSchema, SearchAndReplaceOutputSchema, } from '../schemas.js';
 import { buildToolErrorResponse, buildToolResponse, createProgressReporter, DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS, executeToolWithDiagnostics, notifyProgress, resolvePathOrRoot, withDefaultIcons, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
 const SEARCH_AND_REPLACE_TOOL = {
@@ -18,6 +18,7 @@ const SEARCH_AND_REPLACE_TOOL = {
         'Always run with `dryRun: true` first to verify matches before writing. ' +
         'Literal mode (default) matches exact text; `isRegex: true` enables RE2 regex with capture groups ($1, $2).',
     inputSchema: SearchAndReplaceInputSchema,
+    outputSchema: SearchAndReplaceOutputSchema,
     annotations: DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS,
 };
 const MAX_FAILURES = 20;

package/dist/tools/roots.js

@@ -1,7 +1,7 @@
 import { joinLines } from '../config.js';
 import { ErrorCode } from '../lib/errors.js';
 import { getAllowedDirectories } from '../lib/path-validation.js';
-import { ListAllowedDirectoriesInputSchema, } from '../schemas.js';
+import { ListAllowedDirectoriesInputSchema, ListAllowedDirectoriesOutputSchema, } from '../schemas.js';
 import { buildToolErrorResponse, buildToolResponse, executeToolWithDiagnostics, READ_ONLY_TOOL_ANNOTATIONS, withDefaultIcons, wrapToolHandler, } from './shared.js';
 const LIST_ALLOWED_DIRECTORIES_TOOL = {
     title: 'Workspace Roots',
@@ -9,6 +9,7 @@ const LIST_ALLOWED_DIRECTORIES_TOOL = {
         'Call this first to see available directories. ' +
         'All other tools only work within these directories.',
     inputSchema: ListAllowedDirectoriesInputSchema,
+    outputSchema: ListAllowedDirectoriesOutputSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,
 };
 function buildTextRoots(dirs) {

package/dist/tools/search-content.js

@@ -4,7 +4,7 @@ import { formatOperationSummary, joinLines } from '../config.js';
 import { DEFAULT_EXCLUDE_PATTERNS } from '../lib/constants.js';
 import { ErrorCode, formatUnknownErrorMessage, McpError, } from '../lib/errors.js';
 import { searchContent } from '../lib/file-operations/search-content.js';
-import { SearchContentInputSchema, } from '../schemas.js';
+import { SearchContentInputSchema, SearchContentOutputSchema, } from '../schemas.js';
 import { buildResourceLink, buildToolErrorResponse, buildToolResponse, createProgressReporter, executeToolWithDiagnostics, notifyProgress, READ_ONLY_TOOL_ANNOTATIONS, resolvePathOrRoot, withDefaultIcons, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
 const MAX_INLINE_MATCHES = 50;
@@ -16,6 +16,7 @@ const SEARCH_CONTENT_TOOL = {
         'Use `filePattern` to scope by file type (e.g. `**/*.ts`) and avoid noisy results. ' +
         'Use includeHidden=true to include hidden files and directories.',
     inputSchema: SearchContentInputSchema,
+    outputSchema: SearchContentOutputSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,
 };
 function assertValidRegexPattern(pattern) {

package/dist/tools/search-files.js

@@ -3,7 +3,7 @@ import { formatOperationSummary, joinLines } from '../config.js';
 import { DEFAULT_EXCLUDE_PATTERNS, DEFAULT_SEARCH_TIMEOUT_MS, } from '../lib/constants.js';
 import { ErrorCode } from '../lib/errors.js';
 import { searchFiles } from '../lib/file-operations/search-files.js';
-import { SearchFilesInputSchema, } from '../schemas.js';
+import { SearchFilesInputSchema, SearchFilesOutputSchema } from '../schemas.js';
 import { buildToolErrorResponse, buildToolResponse, createProgressReporter, executeToolWithDiagnostics, notifyProgress, READ_ONLY_TOOL_ANNOTATIONS, resolvePathOrRoot, withDefaultIcons, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
 const SEARCH_FILES_TOOL = {
@@ -13,6 +13,7 @@ const SEARCH_FILES_TOOL = {
         'For text search inside files, use grep. ' +
         'To bulk-edit the matched files, pass the same glob pattern to search_and_replace.',
     inputSchema: SearchFilesInputSchema,
+    outputSchema: SearchFilesOutputSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,
 };
 async function handleSearchFiles(args, signal, onProgress) {

package/dist/tools/stat-many.js

@@ -2,13 +2,14 @@ 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, } from '../schemas.js';
+import { GetMultipleFileInfoInputSchema, GetMultipleFileInfoOutputSchema, } from '../schemas.js';
 import { buildFileInfoPayload, buildToolErrorResponse, buildToolResponse, executeToolWithDiagnostics, READ_ONLY_TOOL_ANNOTATIONS, withDefaultIcons, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
 const GET_MULTIPLE_FILE_INFO_TOOL = {
     title: 'Get Multiple File Info',
     description: 'Get metadata for multiple files or directories in one request.',
     inputSchema: GetMultipleFileInfoInputSchema,
+    outputSchema: GetMultipleFileInfoOutputSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,
 };
 function formatFileInfoDetail(info) {

package/dist/tools/stat.js

@@ -3,12 +3,13 @@ import { formatBytes, joinLines } from '../config.js';
 import { DEFAULT_SEARCH_TIMEOUT_MS } from '../lib/constants.js';
 import { ErrorCode } from '../lib/errors.js';
 import { getFileInfo } from '../lib/file-operations/file-info.js';
-import { GetFileInfoInputSchema, } from '../schemas.js';
+import { GetFileInfoInputSchema, GetFileInfoOutputSchema } from '../schemas.js';
 import { buildFileInfoPayload, buildToolErrorResponse, buildToolResponse, executeToolWithDiagnostics, READ_ONLY_TOOL_ANNOTATIONS, withDefaultIcons, wrapToolHandler, } from './shared.js';
 const GET_FILE_INFO_TOOL = {
     title: 'Get File Info',
     description: 'Get metadata (size, modified time, permissions, mime type) for a file or directory.',
     inputSchema: GetFileInfoInputSchema,
+    outputSchema: GetFileInfoOutputSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,
 };
 function formatFileInfoDetails(info) {

package/dist/tools/tree.js

@@ -2,7 +2,7 @@ import * as path from 'node:path';
 import { DEFAULT_SEARCH_TIMEOUT_MS } from '../lib/constants.js';
 import { ErrorCode } from '../lib/errors.js';
 import { formatTreeAscii, treeDirectory } from '../lib/file-operations/tree.js';
-import { TreeInputSchema } from '../schemas.js';
+import { TreeInputSchema, TreeOutputSchema } from '../schemas.js';
 import { buildToolErrorResponse, buildToolResponse, executeToolWithDiagnostics, READ_ONLY_TOOL_ANNOTATIONS, resolvePathOrRoot, withDefaultIcons, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
 const TREE_TOOL = {
@@ -11,6 +11,7 @@ const TREE_TOOL = {
         'Returns an ASCII tree for quick scanning and a structured JSON tree for programmatic use. ' +
         'Note: maxDepth=0 returns only the root node with empty children array.',
     inputSchema: TreeInputSchema,
+    outputSchema: TreeOutputSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,
 };
 async function handleTree(args, signal) {

package/dist/tools/write-file.js

@@ -3,13 +3,14 @@ import * as path from 'node:path';
 import { ErrorCode } from '../lib/errors.js';
 import { atomicWriteFile, withAbort } from '../lib/fs-helpers.js';
 import { validatePathForWrite } from '../lib/path-validation.js';
-import { WriteFileInputSchema, } from '../schemas.js';
+import { WriteFileInputSchema, WriteFileOutputSchema } from '../schemas.js';
 import { buildToolErrorResponse, buildToolResponse, DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS, executeToolWithDiagnostics, withDefaultIcons, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
 const WRITE_FILE_TOOL = {
     title: 'Write File',
     description: 'Write content to a file. Creates the file if it does not exist.',
     inputSchema: WriteFileInputSchema,
+    outputSchema: WriteFileOutputSchema,
     annotations: DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS,
 };
 async function handleWriteFile(args, signal) {

package/package.json

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