@j0hanz/filesystem-mcp 1.5.0 → 1.5.1

package/dist/lib/constants.d.ts

@@ -11,8 +11,17 @@ export declare const DEFAULT_SEARCH_TIMEOUT_MS: number;
  */
 export declare const SEARCH_WORKERS: number;
 export declare const DEFAULT_MAX_DEPTH = 10;
-export declare const DEFAULT_LIST_MAX_ENTRIES = 10000;
+export declare const DEFAULT_LIST_MAX_ENTRIES = 20000;
 export declare const DEFAULT_SEARCH_MAX_FILES = 20000;
+export declare const MAX_TREE_DEPTH = 50;
+export declare const DEFAULT_TREE_DEPTH = 5;
+export declare const MAX_TREE_ENTRIES = 20000;
+export declare const DEFAULT_TREE_ENTRIES = 1000;
+export declare const MAX_LIST_ENTRIES = 20000;
+export declare const MAX_SEARCH_RESULTS = 10000;
+export declare const DEFAULT_SEARCH_RESULTS = 100;
+export declare const MAX_SEARCH_DEPTH = 100;
+export declare const DEFAULT_SEARCH_CONTENT_RESULTS = 500;
 export declare const MAX_LINE_CONTENT_LENGTH = 200;
 export declare const BINARY_CHECK_BUFFER_SIZE = 512;
 export declare const SENSITIVE_FILE_DENYLIST: string[];

package/dist/lib/constants.js

@@ -109,8 +109,18 @@ const ENV_ALLOWLIST = parseEnvList('FS_CONTEXT_ALLOWLIST');
 export const SEARCH_WORKERS = parseEnvInt('FS_CONTEXT_SEARCH_WORKERS', getDefaultSearchWorkers(), 1, 16);
 // Hardcoded defaults
 export const DEFAULT_MAX_DEPTH = 10;
-export const DEFAULT_LIST_MAX_ENTRIES = 10000;
+export const DEFAULT_LIST_MAX_ENTRIES = 20000;
 export const DEFAULT_SEARCH_MAX_FILES = 20000;
+// Schema limits and defaults
+export const MAX_TREE_DEPTH = 50;
+export const DEFAULT_TREE_DEPTH = 5;
+export const MAX_TREE_ENTRIES = 20000;
+export const DEFAULT_TREE_ENTRIES = 1000;
+export const MAX_LIST_ENTRIES = 20000;
+export const MAX_SEARCH_RESULTS = 10000;
+export const DEFAULT_SEARCH_RESULTS = 100;
+export const MAX_SEARCH_DEPTH = 100;
+export const DEFAULT_SEARCH_CONTENT_RESULTS = 500;
 // Non-configurable constants
 export const MAX_LINE_CONTENT_LENGTH = 200;
 export const BINARY_CHECK_BUFFER_SIZE = 512;

package/dist/resources/tool-info.js

@@ -1,3 +1,4 @@
+import { DEFAULT_SEARCH_CONTENT_RESULTS, MAX_SEARCH_RESULTS, MAX_TEXT_FILE_SIZE, } from '../lib/constants.js';
 import { ALL_TOOLS } from '../tools.js';
 function toEntry(contract) {
     const annotations = [];
@@ -38,7 +39,7 @@ export function getSharedConstraints() {
     return [
         'Allowed roots only (negotiated via CLI).',
         'Sensitive files denylisted by default.',
-        'Max file size & search results enforced.',
+        `Max file size (${Math.floor(MAX_TEXT_FILE_SIZE / 1024 / 1024)}MB) & search results (${MAX_SEARCH_RESULTS} files, ${DEFAULT_SEARCH_CONTENT_RESULTS} lines) enforced.`,
         'Externalized results are ephemeral (in-memory).',
     ];
 }

package/dist/schemas.d.ts

@@ -38,7 +38,7 @@ export declare const ListDirectoryInputSchema: z.ZodObject<{
     includeHidden: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     includeIgnored: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     maxDepth: z.ZodOptional<z.ZodNumber>;
-    maxEntries: z.ZodOptional<z.ZodNumber>;
+    maxEntries: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     sortBy: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
         name: "name";
         size: "size";

package/dist/schemas.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { DEFAULT_LIST_MAX_ENTRIES, DEFAULT_SEARCH_CONTENT_RESULTS, DEFAULT_SEARCH_RESULTS, DEFAULT_TREE_DEPTH, DEFAULT_TREE_ENTRIES, MAX_LIST_ENTRIES, MAX_SEARCH_DEPTH, MAX_SEARCH_RESULTS, MAX_TREE_DEPTH, MAX_TREE_ENTRIES, } from './lib/constants.js';
 import { ErrorCode } from './lib/errors.js';
 function isSafeGlobPattern(value) {
     if (value.length === 0)
@@ -111,16 +112,17 @@ export const ListDirectoryInputSchema = z.strictObject({
         .number()
         .int({ error: 'Must be integer' })
         .min(1, 'Min: 1')
-        .max(50, 'Max: 50')
+        .max(MAX_TREE_DEPTH, `Max: ${MAX_TREE_DEPTH}`)
         .optional()
         .describe('Max recursion depth when pattern is provided'),
     maxEntries: z
         .number()
         .int({ error: 'Must be integer' })
         .min(1, 'Min: 1')
-        .max(20000, 'Max: 20,000')
+        .max(MAX_LIST_ENTRIES, `Max: ${MAX_LIST_ENTRIES}`)
         .optional()
-        .describe('Maximum entries to return before truncation'),
+        .default(DEFAULT_LIST_MAX_ENTRIES)
+        .describe(`Maximum entries to return before truncation. Default: ${DEFAULT_LIST_MAX_ENTRIES}`),
     sortBy: ListDirectorySortSchema.optional()
         .default('name')
         .describe('Sort field (name, size, modified, type)'),
@@ -157,10 +159,10 @@ export const SearchFilesInputSchema = z.strictObject({
         .number()
         .int({ error: 'Must be integer' })
         .min(1, 'Min: 1')
-        .max(10000, 'Max: 10,000')
+        .max(MAX_SEARCH_RESULTS, `Max: ${MAX_SEARCH_RESULTS}`)
         .optional()
-        .default(100)
-        .describe('Max results (1-10000)'),
+        .default(DEFAULT_SEARCH_RESULTS)
+        .describe(`Max results (1-${MAX_SEARCH_RESULTS}). Default: ${DEFAULT_SEARCH_RESULTS}`),
     includeIgnored: z
         .boolean()
         .optional()
@@ -178,7 +180,7 @@ export const SearchFilesInputSchema = z.strictObject({
         .number()
         .int({ error: 'Must be integer' })
         .min(0, 'Min: 0')
-        .max(100, 'Max: 100')
+        .max(MAX_SEARCH_DEPTH, `Max: ${MAX_SEARCH_DEPTH}`)
         .optional()
         .describe('Maximum directory depth to scan'),
     cursor: z
@@ -192,18 +194,18 @@ export const TreeInputSchema = z.strictObject({
         .number()
         .int({ error: 'Must be integer' })
         .min(0, 'Min: 0')
-        .max(50, 'Max: 50')
+        .max(MAX_TREE_DEPTH, `Max: ${MAX_TREE_DEPTH}`)
         .optional()
-        .default(5)
-        .describe('Depth (0=root node only, no children). Default: 5'),
+        .default(DEFAULT_TREE_DEPTH)
+        .describe(`Depth (0=root node only, no children). Default: ${DEFAULT_TREE_DEPTH}`),
     maxEntries: z
         .number()
         .int({ error: 'Must be integer' })
         .min(1, 'Min: 1')
-        .max(20000, 'Max: 20,000')
+        .max(MAX_TREE_ENTRIES, `Max: ${MAX_TREE_ENTRIES}`)
         .optional()
-        .default(1000)
-        .describe('Max entries (Default: 1000)'),
+        .default(DEFAULT_TREE_ENTRIES)
+        .describe(`Max entries. Default: ${DEFAULT_TREE_ENTRIES}`),
     includeHidden: z
         .boolean()
         .optional()
@@ -249,10 +251,10 @@ export const SearchContentInputSchema = z.strictObject({
         .number()
         .int({ error: 'Must be integer' })
         .min(0, 'Min: 0')
-        .max(10000, 'Max: 10,000')
+        .max(MAX_SEARCH_RESULTS, `Max: ${MAX_SEARCH_RESULTS}`)
         .optional()
-        .default(500)
-        .describe('Maximum match rows to return'),
+        .default(DEFAULT_SEARCH_CONTENT_RESULTS)
+        .describe(`Maximum match rows to return. Default: ${DEFAULT_SEARCH_CONTENT_RESULTS}`),
     filePattern: z
         .string()
         .min(1, 'Pattern required')

package/dist/tools/calculate-hash.js

@@ -171,7 +171,7 @@ export function registerCalculateHashTool(server, options = {}) {
                 baseReporter({
                     current,
                     ...(total !== undefined ? { total } : {}),
-                    message: `🕮 calculate_hash: ${baseName} — ${current} ${fileWord} hashed`,
+                    message: `🕮 calculate_hash: ${baseName} [${current} ${fileWord} hashed]`,
                 });
             };
             try {

package/dist/tools/create-directory.js

@@ -34,11 +34,11 @@ export function registerCreateDirectoryTool(server, options = {}) {
     const wrappedHandler = wrapToolHandler(handler, {
         guard: options.isInitialized,
         progressMessage: (args) => {
-            const name = path.basename(args.path) || args.path;
+            const name = path.basename(args.path) || '.';
             return `🛠 mkdir: ${name}`;
         },
         completionMessage: (args, result) => {
-            const name = path.basename(args.path) || args.path;
+            const name = path.basename(args.path) || '.';
             if (result.isError)
                 return `🛠 mkdir: ${name} • failed`;
             return `🛠 mkdir: ${name} • created`;

package/dist/tools/edit-file.js

@@ -96,7 +96,8 @@ export function registerEditFileTool(server, options = {}) {
         guard: options.isInitialized,
         progressMessage: (args) => {
             const name = path.basename(args.path);
-            return `🛠 edit: ${name} [${args.edits.length} edits]`;
+            const dryTag = args.dryRun ? ' [dry run]' : '';
+            return `🛠 edit: ${name} [${args.edits.length} edits]${dryTag}`;
         },
         completionMessage: (args, result) => {
             const name = path.basename(args.path);
@@ -105,10 +106,16 @@ export function registerEditFileTool(server, options = {}) {
             const sc = result.structuredContent;
             if (!sc.ok)
                 return `🛠 edit: ${name} • failed`;
+            const applied = sc.appliedEdits ?? 0;
+            const unmatched = sc.unmatchedEdits?.length ?? 0;
+            const dryPrefix = args.dryRun ? 'dry run — ' : '';
+            if (unmatched > 0) {
+                return `🛠 edit: ${name} • ${dryPrefix}${applied} applied, ${unmatched} unmatched`;
+            }
             if (sc.lineRange) {
-                return `🛠 edit: ${name} • [${sc.lineRange[0]}-${sc.lineRange[1]}]`;
+                return `🛠 edit: ${name} • ${dryPrefix}lines ${sc.lineRange[0]}–${sc.lineRange[1]}`;
             }
-            return `🛠 edit: ${name} • [${sc.appliedEdits ?? 0} edits]`;
+            return `🛠 edit: ${name} • ${dryPrefix}${applied} applied`;
         },
     });
     const validatedHandler = withValidatedArgs(EditFileInputSchema, wrappedHandler);

package/dist/tools/list-directory.js

@@ -98,7 +98,7 @@ function decodeCursor(cursor) {
 async function handleListDirectory(args, signal) {
     const dirPath = resolvePathOrRoot(args.path);
     const cursorOffset = args.cursor !== undefined ? decodeCursor(args.cursor) : 0;
-    const pageSize = args.maxEntries ?? 20_000;
+    const pageSize = args.maxEntries;
     const options = {
         includeHidden: args.includeHidden,
         excludePatterns: args.includeIgnored ? [] : DEFAULT_EXCLUDE_PATTERNS,

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

@@ -265,7 +265,7 @@ export function registerSearchAndReplaceTool(server, options = {}) {
                 baseReporter({
                     current,
                     ...(total !== undefined ? { total } : {}),
-                    message: `🛠 search_and_replace: "${args.searchPattern}" — ${current} files processed`,
+                    message: `🛠 search_and_replace: ${args.searchPattern} [${current} files processed]`,
                 });
             };
             try {

package/dist/tools/search-content.js

@@ -220,7 +220,7 @@ export function registerSearchContentTool(server, options = {}) {
                 baseReporter({
                     current,
                     ...(total !== undefined ? { total } : {}),
-                    message: `🔎︎ grep: ${pattern} — ${current} ${fileWord} scanned`,
+                    message: `🔎︎ grep: ${pattern} [${current} ${fileWord} scanned]`,
                 });
             };
             try {

package/dist/tools/shared.d.ts

@@ -8,6 +8,7 @@ export { type ToolContract } from './contract.js';
 export declare const READ_ONLY_TOOL_ANNOTATIONS: {
     readonly readOnlyHint: true;
     readonly idempotentHint: true;
+    readonly destructiveHint: false;
     readonly openWorldHint: false;
 };
 export declare const DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS: {
@@ -18,6 +19,7 @@ export declare const DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS: {
 export declare const IDEMPOTENT_WRITE_TOOL_ANNOTATIONS: {
     readonly readOnlyHint: false;
     readonly idempotentHint: true;
+    readonly destructiveHint: false;
     readonly openWorldHint: false;
 };
 export declare function shouldStripStructuredOutput(): boolean;

package/dist/tools/shared.js

@@ -18,6 +18,7 @@ function publishContextDiagnostics(event) {
 export const READ_ONLY_TOOL_ANNOTATIONS = {
     readOnlyHint: true,
     idempotentHint: true,
+    destructiveHint: false,
     openWorldHint: false,
 };
 export const DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS = {
@@ -28,6 +29,7 @@ export const DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS = {
 export const IDEMPOTENT_WRITE_TOOL_ANNOTATIONS = {
     readOnlyHint: false,
     idempotentHint: true,
+    destructiveHint: false,
     openWorldHint: false,
 };
 export function shouldStripStructuredOutput() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@j0hanz/filesystem-mcp",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "mcpName": "io.github.j0hanz/filesystem-mcp",
   "description": "MCP Server that enables LLMs to interact with the local filesystem.",
   "type": "module",
@@ -73,7 +73,7 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "eslint": "^10.0.0",
+    "eslint": "^10.0.1",
     "@trivago/prettier-plugin-sort-imports": "^6.0.2",
     "@types/node": "^24",
     "eslint-config-prettier": "^10.1.8",
@@ -81,7 +81,7 @@
     "eslint-plugin-depend": "^1.4.0",
     "eslint-plugin-unused-imports": "^4.4.1",
     "jscpd": "^4.0.8",
-    "knip": "^5.84.1",
+    "knip": "^5.85.0",
     "prettier": "^3.8.1",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",