@j0hanz/filesystem-mcp 2.2.0 → 2.4.0

package/dist/tools/create.js

@@ -1,11 +1,16 @@
 import { basename, dirname } from 'node:path';
 import * as z from 'zod/v4';
-import { ErrorCode } from '../core/errors.js';
-import { buildWrittenFileMeta } from '../core/file-uri.js';
-import { FileKind, IsoDateTime, NonNegInt, PathFailureSchema, RequiredPath, } from '../core/schema.js';
-import { getMaxTextFileSize } from '../core/util.js';
-import { isTotalFailure, runOverPaths } from './batch.js';
-import { defineTool } from './define.js';
+import { processInParallel } from "../core/concurrency.js";
+import { ErrorCode, formatUnknownErrorMessage, FsError, rethrowIfAborted } from "../core/errors.js";
+import { buildFileResourceLink, buildFileResourceUri, buildWrittenFileMeta, } from "../core/file-uri.js";
+import { countFileLines, destExists } from "../core/fs.js";
+import { confirmKey, describeRefusal, pendingRoundTrip, readAcceptedChoice, } from "../core/input-required.js";
+import { detectMimeFromContent, MIME_SAMPLE_SIZE } from "../core/mime.js";
+import { FileKind, IsoDateTime, NonNegInt, PathFailureSchema, RequiredPath, } from "../core/schema.js";
+import { getMaxTextFileSize, PARALLEL_CONCURRENCY } from "../core/util.js";
+import { isTotalFailure, runOverPaths } from "./batch.js";
+import { defineTool } from "./define.js";
+const EPOCH = new Date(0);
 const CreateFileItemSchema = z.strictObject({
     path: RequiredPath.describe('Absolute path where the file will be created'),
     content: z
@@ -14,6 +19,14 @@ const CreateFileItemSchema = z.strictObject({
         message: 'Content exceeds maximum allowed text file size',
     })
         .describe('Text content to write, verbatim.'),
+    append: z
+        .boolean()
+        .optional()
+        .describe('Append the content to the end of the file instead of overwriting; creates the file if it does not exist'),
+    overwrite: z
+        .boolean()
+        .optional()
+        .describe('Replace an existing file without asking the user; without it an existing file prompts for confirmation'),
 });
 const CreateFileResultSchema = z.strictObject({
     path: z.string().describe('Resolved absolute path of the created file'),
@@ -23,7 +36,8 @@ const CreateFileResultSchema = z.strictObject({
     kind: FileKind.describe('Broad file kind: text, binary, image, audio, or pdf'),
     resourceUri: z
         .string()
-        .describe('Resource URI pointing to the created file content in the resource store'),
+        .optional()
+        .describe('Resource URI pointing to the created file content in the resource store; omitted when the resulting file exceeds the text-size cap, which the store would reject'),
     created: IsoDateTime.describe('File creation timestamp (ISO 8601 UTC)'),
     modified: IsoDateTime.describe('File last-modification timestamp (ISO 8601 UTC)'),
 });
@@ -40,13 +54,19 @@ const CreateOutputSchema = z.strictObject({
         .array(PathFailureSchema)
         .optional()
         .describe('Files that failed to create with per-file error details'),
+    skipped: z
+        .array(z.string())
+        .optional()
+        .describe('Paths left untouched because the user chose Skip'),
 });
 export const CREATE = defineTool({
     name: 'create',
     title: 'Create Files',
-    description: 'Create one or more files (max 100), writing or overwriting content and creating parent directories as needed. ' +
+    description: 'Create one or more files (max 100), creating parent directories as needed. ' +
         'Pass files: [{ path, content }] — there is no single-path form. ' +
-        'Silently overwrites existing files — read first if you need to preserve existing content.',
+        'An existing file prompts the user to confirm the overwrite, so the call returns without writing ' +
+        'anything until that confirmation comes back; set overwrite: true on an entry to replace it without the prompt. ' +
+        'Set append: true on an entry to add to the end of an existing file (created if missing) instead of overwriting.',
     input: CreateInputSchema,
     output: CreateOutputSchema,
     annotations: {
@@ -57,15 +77,140 @@ export const CREATE = defineTool({
     },
     accessPaths: (args) => args.files.map((f) => f.path),
     run: async (args, ctx) => {
+        // Phase 1 (no mutation): which entries would replace a file that exists
+        // right now? Those need the user's word before anything is written (R14).
+        // append never destroys, and overwrite: true is that word given up front.
+        // A path that fails validation here is left for runOverPaths to report.
+        // A file that appears between rounds needs no re-stat before the write:
+        // the retry re-plans, and the grown pending set fails the R9 check.
+        const { results: planned } = await processInParallel(args.files, async (entry) => {
+            if (entry.append || entry.overwrite)
+                return undefined;
+            try {
+                const validPath = await ctx.fs.pathGuard.validatePathForWrite(entry.path);
+                return (await destExists(ctx.fs, validPath, 'create')) ? validPath : undefined;
+            }
+            catch (error) {
+                rethrowIfAborted(error);
+                return undefined;
+            }
+        }, PARALLEL_CONCURRENCY, ctx.signal);
+        const pendingByPath = new Map();
+        for (const { index, value } of planned) {
+            const requested = args.files[index]?.path;
+            if (value && requested)
+                pendingByPath.set(requested, value);
+        }
+        const pendingSorted = [...new Set(pendingByPath.values())].sort();
+        if (pendingSorted.length > 0) {
+            // Round 1 returns input_required; a retry whose verified state does not
+            // bind this overwrite set throws (R9) via `pendingRoundTrip`.
+            const round = await pendingRoundTrip({
+                op: 'create',
+                pending: pendingSorted,
+                requestState: ctx.requestState,
+                clientCapabilities: ctx.clientCapabilities,
+                serverCtx: ctx.serverCtx,
+                buildInputs: (paths) => paths.map((target, i) => ({
+                    key: confirmKey(i),
+                    message: `"${target}" already exists. Overwrite it?`,
+                    choices: ['overwrite', 'skip'],
+                })),
+            });
+            if (round !== undefined)
+                return round;
+        }
         const batch = await runOverPaths({ files: args.files }, ctx, async ({ path, override }) => {
             const content = override?.content ?? '';
+            const pendingPath = pendingByPath.get(path);
+            if (pendingPath !== undefined) {
+                const key = confirmKey(pendingSorted.indexOf(pendingPath));
+                const choice = readAcceptedChoice(ctx.inputResponses, key);
+                if (choice === 'skip')
+                    return { skipped: path };
+                if (choice !== 'overwrite') {
+                    throw new FsError(ErrorCode.CANCELLED, `create cancelled: overwrite of "${path}" was ${describeRefusal(ctx.inputResponses, key)}`, path);
+                }
+            }
             await ctx.fs.mkdir(dirname(path), { recursive: true });
-            const { validPath } = await ctx.fs.writeFile(path, content, {
-                encoding: 'utf-8',
-                signal: ctx.signal,
-            });
-            const { stats: fileStats } = await ctx.fs.stat(path, { signal: ctx.signal });
-            const meta = buildWrittenFileMeta(validPath, content, ctx.resourceStore);
+            // Overwrite: file content == `content`, so content-derived meta is
+            // exact and the atomic temp+rename write protects the existing mode.
+            // Append: the resulting file is everything that was there plus
+            // `content`, so size/created/modified come from a real post-append
+            // stat, MIME from the resulting file's leading bytes, and the line
+            // count streams the file — reading a multi-GB log back whole is the
+            // round-trip append exists to avoid.
+            let validPath;
+            let meta;
+            let created;
+            let modified;
+            if (override?.append) {
+                const appended = await ctx.fs.appendFile(path, content, {
+                    encoding: 'utf-8',
+                    signal: ctx.signal,
+                });
+                validPath = appended.validPath;
+                // The append is the commit point: the bytes are on disk, so
+                // everything below is best-effort RESULT METADATA, not part of the
+                // write. It runs unwired to ctx.signal, and a metadata failure
+                // degrades the result instead of failing it — either would report
+                // the append as failed and a client retry would append twice. The
+                // stat covers the committed validPath, never the input path: a
+                // symlink there could have been swapped between write and stat,
+                // and the result must describe the file the bytes landed in.
+                let stats;
+                let mimeType;
+                let kind;
+                let lineCount = 0;
+                try {
+                    stats = (await ctx.fs.stat(appended.validPath)).stats;
+                    // Sniff the resulting file's leading bytes, not the appended
+                    // chunk: text appended to a binary file is still a binary file.
+                    const sample = await ctx.fs.readLeadingSample(appended.validPath, MIME_SAMPLE_SIZE);
+                    const mimeInfo = detectMimeFromContent(appended.validPath, sample);
+                    mimeType = mimeInfo.mimeType;
+                    kind = mimeInfo.kind;
+                    lineCount = await countFileLines(appended.validPath);
+                }
+                catch (error) {
+                    ctx.log?.('warning', `create append: result metadata degraded for ${appended.validPath}: ${formatUnknownErrorMessage(error)}`, 'create');
+                    // A POSIX mode-0222 file appends fine but cannot be opened 'r';
+                    // fall back to the chunk for MIME (an approximation) and report
+                    // the line count as unknown-as-zero rather than fail the append.
+                    const mimeInfo = detectMimeFromContent(appended.validPath, content);
+                    mimeType = mimeInfo.mimeType;
+                    kind = mimeInfo.kind;
+                }
+                // The resource store serves this URI via readRaw, which rejects
+                // files over the text-size cap with TOO_LARGE — never advertise a
+                // link the store deterministically cannot serve. A failed stat
+                // leaves the size unknown, so nothing is advertised either.
+                const servable = stats !== undefined && stats.size <= getMaxTextFileSize();
+                const size = stats?.size ?? 0;
+                meta = {
+                    size,
+                    lineCount,
+                    mimeType,
+                    kind,
+                    resourceUri: servable ? buildFileResourceUri(appended.validPath) : undefined,
+                    resourceLink: servable && ctx.resourceStore
+                        ? buildFileResourceLink(appended.validPath, mimeType, size)
+                        : undefined,
+                };
+                created = (stats?.birthtime ?? EPOCH).toISOString();
+                modified = (stats?.mtime ?? EPOCH).toISOString();
+            }
+            else {
+                const written = await ctx.fs.writeFile(path, content, {
+                    encoding: 'utf-8',
+                    signal: ctx.signal,
+                });
+                validPath = written.validPath;
+                const fileStats = (await ctx.fs.stat(path, { signal: ctx.signal })).stats;
+                created = fileStats.birthtime.toISOString();
+                modified = fileStats.mtime.toISOString();
+                meta = buildWrittenFileMeta(written.validPath, content, ctx.resourceStore);
+            }
             const file = {
                 path: validPath,
                 size: meta.size,
@@ -73,19 +218,24 @@ export const CREATE = defineTool({
                 mimeType: meta.mimeType,
                 kind: meta.kind,
                 resourceUri: meta.resourceUri,
-                created: fileStats.birthtime.toISOString(),
-                modified: fileStats.mtime.toISOString(),
+                created,
+                modified,
             };
             return meta.resourceLink ? { file, resourceLink: meta.resourceLink } : { file };
         }, { defaultErrorCode: ErrorCode.UNKNOWN });
         const results = [];
         const failures = [];
+        const skipped = [];
         const links = [];
         for (const r of batch.results) {
             if ('error' in r) {
                 failures.push({ path: r.path, error: r.error });
                 continue;
             }
+            if ('skipped' in r.value) {
+                skipped.push(r.value.skipped);
+                continue;
+            }
             results.push(r.value.file);
             if (r.value.resourceLink)
                 links.push(r.value.resourceLink);
@@ -93,6 +243,7 @@ export const CREATE = defineTool({
         const structured = {
             files: results,
             ...(failures.length > 0 ? { failures } : {}),
+            ...(skipped.length > 0 ? { skipped } : {}),
         };
         // No `text` on purpose. The one-line roster this used to build named the
         // paths and dropped every per-file size, line count and error the caller

package/dist/tools/create.js.map

@@ -1 +1 @@
-{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/tools/create.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ContentBlock } from '@modelcontextprotocol/server';\n\nimport { basename, dirname } from 'node:path';\n\nimport * as z from 'zod/v4';\n\nimport { ErrorCode } from '../core/errors.js';\nimport { buildWrittenFileMeta } from '../core/file-uri.js';\nimport {\n  FileKind,\n  IsoDateTime,\n  NonNegInt,\n  PathFailureSchema,\n  RequiredPath,\n} from '../core/schema.js';\nimport { getMaxTextFileSize } from '../core/util.js';\nimport { isTotalFailure, runOverPaths } from './batch.js';\nimport { defineTool } from './define.js';\n\nconst CreateFileItemSchema = z.strictObject({\n  path: RequiredPath.describe('Absolute path where the file will be created'),\n  content: z\n    .string()\n    .refine((val) => val.length <= getMaxTextFileSize(), {\n      message: 'Content exceeds maximum allowed text file size',\n    })\n    .describe('Text content to write, verbatim.'),\n});\n\nconst CreateFileResultSchema = z.strictObject({\n  path: z.string().describe('Resolved absolute path of the created file'),\n  size: NonNegInt.describe('File size in bytes after writing'),\n  lineCount: NonNegInt.describe('Number of lines in the written file'),\n  mimeType: z.string().describe('Detected MIME type of the file'),\n  kind: FileKind.describe('Broad file kind: text, binary, image, audio, or pdf'),\n  resourceUri: z\n    .string()\n    .describe('Resource URI pointing to the created file content in the resource store'),\n  created: IsoDateTime.describe('File creation timestamp (ISO 8601 UTC)'),\n  modified: IsoDateTime.describe('File last-modification timestamp (ISO 8601 UTC)'),\n});\n\nconst CreateInputSchema = z.strictObject({\n  files: z\n    .array(CreateFileItemSchema)\n    .min(1)\n    .max(100)\n    .describe('List of files to create (max 100); each entry requires path and content'),\n});\n\ntype CreateFailureItem = z.infer<typeof PathFailureSchema>;\n\nconst CreateOutputSchema = z.strictObject({\n  files: z.array(CreateFileResultSchema).describe('Successfully created files'),\n  failures: z\n    .array(PathFailureSchema)\n    .optional()\n    .describe('Files that failed to create with per-file error details'),\n});\n\ntype CreateFileResult = z.infer<typeof CreateFileResultSchema>;\n\nexport const CREATE = defineTool({\n  name: 'create',\n  title: 'Create Files',\n  description:\n    'Create one or more files (max 100), writing or overwriting content and creating parent directories as needed. ' +\n    'Pass files: [{ path, content }] — there is no single-path form. ' +\n    'Silently overwrites existing files — read first if you need to preserve existing content.',\n  input: CreateInputSchema,\n  output: CreateOutputSchema,\n  annotations: {\n    readOnlyHint: false,\n    idempotentHint: false,\n    destructiveHint: true,\n    openWorldHint: false,\n  },\n  accessPaths: (args) => args.files.map((f) => f.path),\n  run: async (args, ctx) => {\n    const batch = await runOverPaths<\n      { content: string },\n      { file: CreateFileResult; resourceLink?: ContentBlock }\n    >(\n      { files: args.files },\n      ctx,\n      async ({ path, override }) => {\n        const content = override?.content ?? '';\n\n        await ctx.fs.mkdir(dirname(path), { recursive: true });\n\n        const { validPath } = await ctx.fs.writeFile(path, content, {\n          encoding: 'utf-8',\n          signal: ctx.signal,\n        });\n\n        const { stats: fileStats } = await ctx.fs.stat(path, { signal: ctx.signal });\n        const meta = buildWrittenFileMeta(validPath, content, ctx.resourceStore);\n\n        const file: CreateFileResult = {\n          path: validPath,\n          size: meta.size,\n          lineCount: meta.lineCount,\n          mimeType: meta.mimeType,\n          kind: meta.kind,\n          resourceUri: meta.resourceUri,\n          created: fileStats.birthtime.toISOString(),\n          modified: fileStats.mtime.toISOString(),\n        };\n\n        return meta.resourceLink ? { file, resourceLink: meta.resourceLink } : { file };\n      },\n      { defaultErrorCode: ErrorCode.UNKNOWN },\n    );\n\n    const results: CreateFileResult[] = [];\n    const failures: CreateFailureItem[] = [];\n    const links: ContentBlock[] = [];\n    for (const r of batch.results) {\n      if ('error' in r) {\n        failures.push({ path: r.path, error: r.error });\n        continue;\n      }\n      results.push(r.value.file);\n      if (r.value.resourceLink) links.push(r.value.resourceLink);\n    }\n\n    const structured = {\n      files: results,\n      ...(failures.length > 0 ? { failures } : {}),\n    };\n    // No `text` on purpose. The one-line roster this used to build named the\n    // paths and dropped every per-file size, line count and error the caller\n    // asked `create` for. Supplying no text makes this a data tool, so\n    // `define.ts` renders the JSON and keeps it in `structuredContent`.\n    if (links.length > 0) {\n      return { structured, resources: links, isError: isTotalFailure(batch.summary) };\n    }\n\n    return { structured, isError: isTotalFailure(batch.summary) };\n  },\n  progress: (args) => ({\n    label: 'Create',\n    subject:\n      args.files.length === 1\n        ? basename(args.files[0]?.path ?? '')\n        : `${String(args.files.length)} files`,\n  }),\n  defaultErrorCode: ErrorCode.UNKNOWN,\n});\n"]}
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/tools/create.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ContentBlock } from '@modelcontextprotocol/server';\n\nimport { basename, dirname } from 'node:path';\n\nimport * as z from 'zod/v4';\n\nimport { processInParallel } from '../core/concurrency.ts';\nimport { ErrorCode, formatUnknownErrorMessage, FsError, rethrowIfAborted } from '../core/errors.ts';\nimport {\n  buildFileResourceLink,\n  buildFileResourceUri,\n  buildWrittenFileMeta,\n  type WrittenFileMeta,\n} from '../core/file-uri.ts';\nimport { countFileLines, destExists, type Stats } from '../core/fs.ts';\nimport {\n  confirmKey,\n  describeRefusal,\n  pendingRoundTrip,\n  readAcceptedChoice,\n} from '../core/input-required.ts';\nimport { detectMimeFromContent, MIME_SAMPLE_SIZE } from '../core/mime.ts';\nimport {\n  FileKind,\n  IsoDateTime,\n  NonNegInt,\n  PathFailureSchema,\n  RequiredPath,\n} from '../core/schema.ts';\nimport { getMaxTextFileSize, PARALLEL_CONCURRENCY } from '../core/util.ts';\nimport { isTotalFailure, runOverPaths } from './batch.ts';\nimport { defineTool } from './define.ts';\n\nconst EPOCH = new Date(0);\n\nconst CreateFileItemSchema = z.strictObject({\n  path: RequiredPath.describe('Absolute path where the file will be created'),\n  content: z\n    .string()\n    .refine((val) => val.length <= getMaxTextFileSize(), {\n      message: 'Content exceeds maximum allowed text file size',\n    })\n    .describe('Text content to write, verbatim.'),\n  append: z\n    .boolean()\n    .optional()\n    .describe(\n      'Append the content to the end of the file instead of overwriting; creates the file if it does not exist',\n    ),\n  overwrite: z\n    .boolean()\n    .optional()\n    .describe(\n      'Replace an existing file without asking the user; without it an existing file prompts for confirmation',\n    ),\n});\n\nconst CreateFileResultSchema = z.strictObject({\n  path: z.string().describe('Resolved absolute path of the created file'),\n  size: NonNegInt.describe('File size in bytes after writing'),\n  lineCount: NonNegInt.describe('Number of lines in the written file'),\n  mimeType: z.string().describe('Detected MIME type of the file'),\n  kind: FileKind.describe('Broad file kind: text, binary, image, audio, or pdf'),\n  resourceUri: z\n    .string()\n    .optional()\n    .describe(\n      'Resource URI pointing to the created file content in the resource store; omitted when the resulting file exceeds the text-size cap, which the store would reject',\n    ),\n  created: IsoDateTime.describe('File creation timestamp (ISO 8601 UTC)'),\n  modified: IsoDateTime.describe('File last-modification timestamp (ISO 8601 UTC)'),\n});\n\nconst CreateInputSchema = z.strictObject({\n  files: z\n    .array(CreateFileItemSchema)\n    .min(1)\n    .max(100)\n    .describe('List of files to create (max 100); each entry requires path and content'),\n});\n\ntype CreateFailureItem = z.infer<typeof PathFailureSchema>;\n\nconst CreateOutputSchema = z.strictObject({\n  files: z.array(CreateFileResultSchema).describe('Successfully created files'),\n  failures: z\n    .array(PathFailureSchema)\n    .optional()\n    .describe('Files that failed to create with per-file error details'),\n  skipped: z\n    .array(z.string())\n    .optional()\n    .describe('Paths left untouched because the user chose Skip'),\n});\n\ntype CreateFileResult = z.infer<typeof CreateFileResultSchema>;\n\nexport const CREATE = defineTool({\n  name: 'create',\n  title: 'Create Files',\n  description:\n    'Create one or more files (max 100), creating parent directories as needed. ' +\n    'Pass files: [{ path, content }] — there is no single-path form. ' +\n    'An existing file prompts the user to confirm the overwrite, so the call returns without writing ' +\n    'anything until that confirmation comes back; set overwrite: true on an entry to replace it without the prompt. ' +\n    'Set append: true on an entry to add to the end of an existing file (created if missing) instead of overwriting.',\n  input: CreateInputSchema,\n  output: CreateOutputSchema,\n  annotations: {\n    readOnlyHint: false,\n    idempotentHint: false,\n    destructiveHint: true,\n    openWorldHint: false,\n  },\n  accessPaths: (args) => args.files.map((f) => f.path),\n  run: async (args, ctx) => {\n    // Phase 1 (no mutation): which entries would replace a file that exists\n    // right now? Those need the user's word before anything is written (R14).\n    // append never destroys, and overwrite: true is that word given up front.\n    // A path that fails validation here is left for runOverPaths to report.\n    // A file that appears between rounds needs no re-stat before the write:\n    // the retry re-plans, and the grown pending set fails the R9 check.\n    const { results: planned } = await processInParallel(\n      args.files,\n      async (entry) => {\n        if (entry.append || entry.overwrite) return undefined;\n        try {\n          const validPath = await ctx.fs.pathGuard.validatePathForWrite(entry.path);\n          return (await destExists(ctx.fs, validPath, 'create')) ? validPath : undefined;\n        } catch (error) {\n          rethrowIfAborted(error);\n          return undefined;\n        }\n      },\n      PARALLEL_CONCURRENCY,\n      ctx.signal,\n    );\n    const pendingByPath = new Map<string, string>();\n    for (const { index, value } of planned) {\n      const requested = args.files[index]?.path;\n      if (value && requested) pendingByPath.set(requested, value);\n    }\n    const pendingSorted = [...new Set(pendingByPath.values())].sort();\n    if (pendingSorted.length > 0) {\n      // Round 1 returns input_required; a retry whose verified state does not\n      // bind this overwrite set throws (R9) via `pendingRoundTrip`.\n      const round = await pendingRoundTrip({\n        op: 'create',\n        pending: pendingSorted,\n        requestState: ctx.requestState,\n        clientCapabilities: ctx.clientCapabilities,\n        serverCtx: ctx.serverCtx,\n        buildInputs: (paths) =>\n          paths.map((target, i) => ({\n            key: confirmKey(i),\n            message: `\"${target}\" already exists. Overwrite it?`,\n            choices: ['overwrite', 'skip'],\n          })),\n      });\n      if (round !== undefined) return round;\n    }\n\n    const batch = await runOverPaths<\n      { content: string; append?: boolean | undefined; overwrite?: boolean | undefined },\n      { file: CreateFileResult; resourceLink?: ContentBlock } | { skipped: string }\n    >(\n      { files: args.files },\n      ctx,\n      async ({ path, override }) => {\n        const content = override?.content ?? '';\n\n        const pendingPath = pendingByPath.get(path);\n        if (pendingPath !== undefined) {\n          const key = confirmKey(pendingSorted.indexOf(pendingPath));\n          const choice = readAcceptedChoice(ctx.inputResponses, key);\n          if (choice === 'skip') return { skipped: path };\n          if (choice !== 'overwrite') {\n            throw new FsError(\n              ErrorCode.CANCELLED,\n              `create cancelled: overwrite of \"${path}\" was ${describeRefusal(ctx.inputResponses, key)}`,\n              path,\n            );\n          }\n        }\n\n        await ctx.fs.mkdir(dirname(path), { recursive: true });\n\n        // Overwrite: file content == `content`, so content-derived meta is\n        // exact and the atomic temp+rename write protects the existing mode.\n        // Append: the resulting file is everything that was there plus\n        // `content`, so size/created/modified come from a real post-append\n        // stat, MIME from the resulting file's leading bytes, and the line\n        // count streams the file — reading a multi-GB log back whole is the\n        // round-trip append exists to avoid.\n        let validPath: string;\n        let meta: WrittenFileMeta;\n        let created: string;\n        let modified: string;\n        if (override?.append) {\n          const appended = await ctx.fs.appendFile(path, content, {\n            encoding: 'utf-8',\n            signal: ctx.signal,\n          });\n          validPath = appended.validPath;\n          // The append is the commit point: the bytes are on disk, so\n          // everything below is best-effort RESULT METADATA, not part of the\n          // write. It runs unwired to ctx.signal, and a metadata failure\n          // degrades the result instead of failing it — either would report\n          // the append as failed and a client retry would append twice. The\n          // stat covers the committed validPath, never the input path: a\n          // symlink there could have been swapped between write and stat,\n          // and the result must describe the file the bytes landed in.\n          let stats: Stats | undefined;\n          let mimeType: string;\n          let kind: FileKind;\n          let lineCount = 0;\n          try {\n            stats = (await ctx.fs.stat(appended.validPath)).stats;\n            // Sniff the resulting file's leading bytes, not the appended\n            // chunk: text appended to a binary file is still a binary file.\n            const sample = await ctx.fs.readLeadingSample(appended.validPath, MIME_SAMPLE_SIZE);\n            const mimeInfo = detectMimeFromContent(appended.validPath, sample);\n            mimeType = mimeInfo.mimeType;\n            kind = mimeInfo.kind;\n            lineCount = await countFileLines(appended.validPath);\n          } catch (error) {\n            ctx.log?.(\n              'warning',\n              `create append: result metadata degraded for ${appended.validPath}: ${formatUnknownErrorMessage(error)}`,\n              'create',\n            );\n            // A POSIX mode-0222 file appends fine but cannot be opened 'r';\n            // fall back to the chunk for MIME (an approximation) and report\n            // the line count as unknown-as-zero rather than fail the append.\n            const mimeInfo = detectMimeFromContent(appended.validPath, content);\n            mimeType = mimeInfo.mimeType;\n            kind = mimeInfo.kind;\n          }\n          // The resource store serves this URI via readRaw, which rejects\n          // files over the text-size cap with TOO_LARGE — never advertise a\n          // link the store deterministically cannot serve. A failed stat\n          // leaves the size unknown, so nothing is advertised either.\n          const servable = stats !== undefined && stats.size <= getMaxTextFileSize();\n          const size = stats?.size ?? 0;\n          meta = {\n            size,\n            lineCount,\n            mimeType,\n            kind,\n            resourceUri: servable ? buildFileResourceUri(appended.validPath) : undefined,\n            resourceLink:\n              servable && ctx.resourceStore\n                ? buildFileResourceLink(appended.validPath, mimeType, size)\n                : undefined,\n          };\n          created = (stats?.birthtime ?? EPOCH).toISOString();\n          modified = (stats?.mtime ?? EPOCH).toISOString();\n        } else {\n          const written = await ctx.fs.writeFile(path, content, {\n            encoding: 'utf-8',\n            signal: ctx.signal,\n          });\n          validPath = written.validPath;\n          const fileStats = (await ctx.fs.stat(path, { signal: ctx.signal })).stats;\n          created = fileStats.birthtime.toISOString();\n          modified = fileStats.mtime.toISOString();\n          meta = buildWrittenFileMeta(written.validPath, content, ctx.resourceStore);\n        }\n\n        const file: CreateFileResult = {\n          path: validPath,\n          size: meta.size,\n          lineCount: meta.lineCount,\n          mimeType: meta.mimeType,\n          kind: meta.kind,\n          resourceUri: meta.resourceUri,\n          created,\n          modified,\n        };\n\n        return meta.resourceLink ? { file, resourceLink: meta.resourceLink } : { file };\n      },\n      { defaultErrorCode: ErrorCode.UNKNOWN },\n    );\n\n    const results: CreateFileResult[] = [];\n    const failures: CreateFailureItem[] = [];\n    const skipped: string[] = [];\n    const links: ContentBlock[] = [];\n    for (const r of batch.results) {\n      if ('error' in r) {\n        failures.push({ path: r.path, error: r.error });\n        continue;\n      }\n      if ('skipped' in r.value) {\n        skipped.push(r.value.skipped);\n        continue;\n      }\n      results.push(r.value.file);\n      if (r.value.resourceLink) links.push(r.value.resourceLink);\n    }\n\n    const structured = {\n      files: results,\n      ...(failures.length > 0 ? { failures } : {}),\n      ...(skipped.length > 0 ? { skipped } : {}),\n    };\n    // No `text` on purpose. The one-line roster this used to build named the\n    // paths and dropped every per-file size, line count and error the caller\n    // asked `create` for. Supplying no text makes this a data tool, so\n    // `define.ts` renders the JSON and keeps it in `structuredContent`.\n    if (links.length > 0) {\n      return { structured, resources: links, isError: isTotalFailure(batch.summary) };\n    }\n\n    return { structured, isError: isTotalFailure(batch.summary) };\n  },\n  progress: (args) => ({\n    label: 'Create',\n    subject:\n      args.files.length === 1\n        ? basename(args.files[0]?.path ?? '')\n        : `${String(args.files.length)} files`,\n  }),\n  defaultErrorCode: ErrorCode.UNKNOWN,\n});\n"]}

package/dist/tools/define.d.ts

@@ -1,15 +1,18 @@
-import type { ClientCapabilities, ContentBlock, InputRequiredResult, McpServer, Notification, RegisteredTool, RequestMeta, RequestStateAccessor, ToolAnnotations } from '@modelcontextprotocol/server';
-import * as z from 'zod/v4';
-import { ErrorCode } from '../core/errors.js';
-import type { ProgressCtx } from '../core/fmt.js';
-import { GuardedFileSystem } from '../core/fs.js';
-import type { LoggingLevel } from '../core/observability.js';
-import type { PageSnapshotStore } from '../core/page-store.js';
-import type { PathGuard } from '../core/path.js';
-import type { ResourceStore } from '../core/store.js';
+import type { ClientCapabilities, ContentBlock, InputRequiredResult, McpServer, Notification, RegisteredTool, RequestId, RequestMeta, RequestStateAccessor, ServerContext, ToolAnnotations } from '@modelcontextprotocol/server';
+import type * as z from 'zod/v4';
+import { ErrorCode } from '../core/errors.ts';
+import type { ProgressCtx } from '../core/fmt.ts';
+import { GuardedFileSystem } from '../core/fs.ts';
+import type { LoggingLevel } from '../core/observability.ts';
+import type { PathGuard } from '../core/path.ts';
+import type { PageSnapshotStore, ResourceStore } from '../core/store.ts';
 export interface ToolCtx {
     readonly signal: AbortSignal;
     readonly _meta?: RequestMeta | undefined;
+    /** The JSON-RPC id of the `tools/call` this context serves; prefixes every log line. */
+    readonly requestId: RequestId;
+    /** W3C trace context the client put in `_meta`, when it did; rides the log prefix. */
+    readonly traceparent?: string | undefined;
     readonly fs: GuardedFileSystem;
     readonly pageStore: PageSnapshotStore;
     readonly resourceStore: ResourceStore | undefined;
@@ -47,12 +50,15 @@ export interface ToolCtx {
      * all. `undefined` means "cannot tell" — never "no capabilities".
      */
     readonly clientCapabilities?: ClientCapabilities | undefined;
+    /** The SDK request context this call runs under; `pendingRoundTrip` binds minted state to it. */
+    readonly serverCtx: ServerContext;
 }
 interface ToolDeps {
     readonly server: McpServer;
     readonly pathGuard: PathGuard;
     readonly pageStore: PageSnapshotStore;
     readonly resourceStore: ResourceStore | undefined;
+    readonly era?: 'legacy' | 'modern';
 }
 interface RunResult<T> {
     readonly structured: T;

package/dist/tools/define.d.ts.map

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

package/dist/tools/define.js

@@ -1,12 +1,11 @@
-import { CLIENT_CAPABILITIES_META_KEY, fromJsonSchema, isInputRequiredResult, } from '@modelcontextprotocol/server';
-import * as z from 'zod/v4';
-import { ErrorCode, formatUnknownErrorMessage, Problem } from '../core/errors.js';
-import { plainMessage } from '../core/fmt.js';
-import { GuardedFileSystem } from '../core/fs.js';
-import { confirmKey, multiSelectInput, pendingRoundTrip, readAcceptedConfirm, readAcceptedMultiChoice, } from '../core/input-required.js';
-import { Logger } from '../core/observability.js';
-import { isSamePath } from '../core/path-utils.js';
-import { McpProgressSink, ProgressSession } from './progress.js';
+import { CLIENT_CAPABILITIES_META_KEY, isInputRequiredResult, TRACEPARENT_META_KEY, } from '@modelcontextprotocol/server';
+import { ErrorCode, formatUnknownErrorMessage, Problem } from "../core/errors.js";
+import { plainMessage } from "../core/fmt.js";
+import { GuardedFileSystem } from "../core/fs.js";
+import { confirmKey, pendingRoundTrip, readAcceptedConfirm, readAcceptedMultiChoice, } from "../core/input-required.js";
+import { Logger, sanitizeLogField } from "../core/observability.js";
+import { isSamePath } from "../core/path-utils.js";
+import { ProgressSession } from "./progress.js";
 function toToolCtx(ctx, deps) {
     // Envelope first, accessor second — the two eras carry this differently.
     // A modern request states the capabilities in its own `_meta` envelope; a
@@ -23,16 +22,28 @@ function toToolCtx(ctx, deps) {
     const envelope = ctx.mcpReq.envelope;
     const clientCapabilities = envelope?.[CLIENT_CAPABILITIES_META_KEY] ??
         // eslint-disable-next-line @typescript-eslint/no-deprecated -- the only source of client capabilities on a legacy connection, where no envelope exists.
-        deps.server.server.getClientCapabilities();
+        deps.server.server.getClientCapabilities() ??
+        // A legacy instance that never saw `initialize` is the HTTP leg's
+        // per-request serving (`createMcpHandler` with `legacy: 'stateless'`):
+        // there is no return path for a server-to-client request, so read the
+        // client as having declared nothing. The `input_required` flows then
+        // answer with their named workaround instead of the SDK's generic refusal.
+        // sunset(SEP-2577): removal trigger in docs/adr/002-legacy-protocol-paths-sunset.md.
+        (deps.era === 'legacy' ? {} : undefined);
     return {
         signal: ctx.mcpReq.signal,
         ...(ctx.mcpReq._meta ? { _meta: ctx.mcpReq._meta } : {}),
+        requestId: ctx.mcpReq.id,
+        ...(typeof ctx.mcpReq._meta?.[TRACEPARENT_META_KEY] === 'string'
+            ? { traceparent: ctx.mcpReq._meta[TRACEPARENT_META_KEY] }
+            : {}),
         fs: new GuardedFileSystem(deps.pathGuard),
         pageStore: deps.pageStore,
         resourceStore: deps.resourceStore,
         sendNotification: async (notification) => ctx.mcpReq.notify(notification),
         inputResponses: ctx.mcpReq.inputResponses,
         requestState: ctx.mcpReq.requestState,
+        serverCtx: ctx,
         ...(clientCapabilities ? { clientCapabilities } : {}),
     };
 }
@@ -68,7 +79,6 @@ class ToolExecutor {
     parsedArgs;
     toolCtx;
     #progressCtx;
-    #mcpSink;
     #progressSession;
     constructor(toolName, ctx, def, parsedArgs) {
         this.def = def;
@@ -78,22 +88,27 @@ class ToolExecutor {
             : ctx.signal;
         this.#progressCtx = def.progress ? def.progress(parsedArgs) : { label: def.title };
         const token = ctx._meta?.progressToken;
-        if (token !== undefined && ctx.sendNotification !== undefined) {
-            this.#mcpSink = new McpProgressSink(toolName, token, ctx.sendNotification);
-        }
-        const isTest = process.env['NODE_ENV'] === 'test' || process.execArgv.includes('--test');
+        const notify = ctx.sendNotification;
         this.#progressSession = new ProgressSession({
             label: this.#progressCtx.label,
-            ...(this.#mcpSink ? { sink: this.#mcpSink } : {}),
-            ...(isTest ? { rateLimitMs: 0 } : {}),
+            ...(token !== undefined && notify !== undefined ? { sink: { toolName, token, notify } } : {}),
         });
         this.toolCtx = {
             ...ctx,
             signal: this.signal,
             log: (level, data, logger) => {
                 const msg = typeof data === 'string' ? data : String(data);
+                // `[req <id>]` first so one grep finds every line of one call; the
+                // traceparent rides along only when the client sent one. Both are
+                // client-supplied, so they pass through `sanitizeLogField`: a control
+                // character in a JSON-RPC id or a traceparent would forge log lines.
+                // The message is flattened too (uncapped): it can carry a resolved
+                // path or OS error text, and input schemas reject CR/LF but not the
+                // Unicode line separators.
+                const trace = ctx.traceparent ? ` ${sanitizeLogField(ctx.traceparent)}` : '';
                 const prefix = logger ? `[${logger}] ` : '';
-                Logger.emit(level, `${prefix}${msg}`);
+                const text = sanitizeLogField(msg, Infinity);
+                Logger.emit(level, `[req ${sanitizeLogField(String(ctx.requestId))}${trace}] ${prefix}${text}`);
             },
             onProgress: (p) => {
                 this.#tick(p);
@@ -108,22 +123,17 @@ class ToolExecutor {
         };
         this.#progressSession.set({ ...p, message: plainMessage('tick', tickCtx) });
     }
-    async #flushProgress() {
-        if (this.#mcpSink)
-            await this.#mcpSink.flush();
-    }
     async completeProgress(result) {
         const doneCtx = this.def.progressDone
             ? { ...this.#progressCtx, ...this.def.progressDone(this.parsedArgs, result) }
             : this.#progressCtx;
         this.#progressSession.complete(plainMessage('done', doneCtx));
-        await this.#flushProgress();
+        await this.#progressSession.flush();
     }
     async failProgress(error) {
         const errMsg = formatUnknownErrorMessage(error);
-        const message = plainMessage('fail', { ...this.#progressCtx, error: errMsg });
-        this.#progressSession.fail(error, message);
-        await this.#flushProgress();
+        this.#progressSession.fail(plainMessage('fail', { ...this.#progressCtx, error: errMsg }));
+        await this.#progressSession.flush();
         const { text: errorText } = Problem.toText(error, this.def.defaultErrorCode ?? ErrorCode.UNKNOWN);
         return {
             content: [{ type: 'text', text: errorText }],
@@ -160,9 +170,15 @@ class ToolExecutor {
             pending: grantDirs,
             requestState: this.toolCtx.requestState,
             clientCapabilities: this.toolCtx.clientCapabilities,
+            serverCtx: this.toolCtx.serverCtx,
             buildInputs: (dirs) => multi
                 ? [
-                    multiSelectInput('grant', 'Grant filesystem access to these directories? Select the ones to allow.', dirs.map((d) => ({ value: d, title: d }))),
+                    {
+                        key: 'grant',
+                        message: 'Grant filesystem access to these directories? Select the ones to allow.',
+                        choices: dirs,
+                        multi: true,
+                    },
                 ]
                 : dirs.map((dir, i) => ({
                     key: confirmKey(i),
@@ -221,76 +237,11 @@ class ToolExecutor {
             return await this.failProgress(error);
         }
         finally {
-            await this.#flushProgress();
+            await this.#progressSession.flush();
         }
     }
 }
-/**
- * Validate with Zod while publishing the precomputed JSON Schema: clients get
- * draft-2020-12, handlers get Zod's coercions, defaults and error messages.
- *
- * Each validator instance is built for exactly one schema and handed straight
- * to `fromJsonSchema(thatSchema, ...)`, which calls `getValidator` once with
- * the same schema — so the argument is redundant here and deliberately ignored.
- * Reusing one instance across schemas would silently validate against `schema`.
- */
-function zodJsonSchemaValidator(schema) {
-    return {
-        getValidator() {
-            return (input) => {
-                const result = schema.safeParse(input);
-                if (result.success) {
-                    return {
-                        valid: true,
-                        data: result.data,
-                        errorMessage: undefined,
-                    };
-                }
-                return {
-                    valid: false,
-                    data: undefined,
-                    errorMessage: z.prettifyError(result.error),
-                };
-            };
-        },
-    };
-}
-/**
- * Generate the wire copy of a schema for `tools/list`. The Zod schema keeps
- * every constraint for runtime validation; the `override` pass only trims what
- * the wire copy costs every client at session start:
- *
- * - `$schema` and `title` carry no information the host uses.
- * - `maximum: Number.MAX_SAFE_INTEGER` is zod's int() artifact, not a bound.
- * - `examples` is dropped in both directions: on output it describes a field the
- *   server itself fills in, and on input every description that carried one
- *   already spells the same example out inline, so the keyword paid twice.
- *
- * Output `description`s are NOT dropped. They were, and the result was a wire
- * contract the model had to guess at: `delete` returns `path` XOR `paths`,
- * `edit.diff` appears only under dryRun, `read.value` has no required field at
- * all. None of that is inferable from types alone.
- *
- * No shared subschema carries a `.meta({ id })`, so zod inlines every one of
- * them and the emitted document has no `$defs`/`$ref` to dereference.
- */
-function toDraft202012(schema, io) {
-    const generated = z.toJSONSchema(schema, {
-        target: 'draft-2020-12',
-        io,
-        override: ({ jsonSchema }) => {
-            const node = jsonSchema;
-            delete node['title'];
-            if (node['maximum'] === Number.MAX_SAFE_INTEGER)
-                delete node['maximum'];
-            delete node['examples'];
-        },
-    });
-    delete generated['$schema'];
-    return generated;
-}
 export function defineTool(def) {
-    const inputJsonSchema = toDraft202012(def.input, 'input');
     // Nothing here depends on `deps`, so it is built once per tool definition
     // rather than once per `register` — the HTTP leg registers every tool afresh
     // on each request.
@@ -309,7 +260,10 @@ export function defineTool(def) {
     const toolDefShape = {
         title: def.title,
         description: def.description,
-        inputSchema: fromJsonSchema(inputJsonSchema, zodJsonSchemaValidator(def.input)),
+        // The Zod schema goes in as-is: the SDK validates with it and publishes its
+        // own draft-2020-12 conversion in `tools/list`. The cast only names the
+        // in/out types a generic `ZodType` cannot surface through `~standard`.
+        inputSchema: def.input,
         // No `outputSchema`, ever. Publishing one obliges the result to carry
         // `structuredContent` (clients enforce it), and every tool that authors its
         // own text ships its metadata under `_meta` instead — see