@j0hanz/filesystem-mcp 1.19.0 → 2.0.0

package/dist/tools/move.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"move.js","sourceRoot":"","sources":["../../src/tools/move.ts"],"names":[],"mappings":"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","sourcesContent":["import type { InputRequiredResult } from '@modelcontextprotocol/server';\nimport { isInputRequiredResult } from '@modelcontextprotocol/server';\n\nimport { basename, dirname, resolve, sep } from 'node:path';\n\nimport * as z from 'zod/v4';\n\nimport {\n  ErrorCode,\n  FsError,\n  isFsError,\n  isNodeError,\n  Problem,\n  rethrowIfAborted,\n} from '../core/errors.js';\nimport { joinRoster, pathLabel } from '../core/fmt.js';\nimport { destExists } from '../core/fs.js';\nimport type { GuardedFileSystem } from '../core/fs.js';\nimport { readAcceptedChoice } from '../core/input-required.js';\nimport { IS_CASE_INSENSITIVE_FS, isPathInsideDirectory, isSamePath } from '../core/path-utils.js';\nimport { defaultFalseBoolean, pairFailureSchema, RequiredPath } from '../core/schema.js';\nimport type { PairExecResult, PairPlanResult } from './batch.js';\nimport { pairFailure, runOverPairs } from './batch.js';\nimport type { ToolCtx } from './define.js';\nimport { defineTool } from './define.js';\n\nconst MoveItemSchema = z.strictObject({\n  source: RequiredPath.describe('Path of the file or directory to move or copy'),\n  destination: RequiredPath.describe('Destination path'),\n});\n\nconst MoveItemResultSchema = z.strictObject({\n  from: z.string().describe('Resolved absolute source path'),\n  to: z.string().describe('Resolved absolute destination path'),\n});\n\nconst MoveInputSchema = z.strictObject({\n  moves: z.array(MoveItemSchema).min(1).max(100).describe('Operations to perform (max 100)'),\n  copy: defaultFalseBoolean('Copy instead of move; sources are left in place'),\n  overwrite: defaultFalseBoolean(\n    'Copy mode only: overwrite existing destinations without confirmation',\n  ),\n});\n\nconst MoveFailureItemSchema = pairFailureSchema('moved', 'move');\n\ntype MoveFailureItem = z.infer<typeof MoveFailureItemSchema>;\n\nconst MoveOutputSchema = z.strictObject({\n  moves: z.array(MoveItemResultSchema).describe('Successfully completed operations'),\n  failures: z\n    .array(MoveFailureItemSchema)\n    .optional()\n    .describe('Operations that failed with per-item error details'),\n  skipped: z\n    .array(z.string())\n    .optional()\n    .describe('Destinations skipped because the user chose Skip'),\n});\n\ntype MoveItemResult = z.infer<typeof MoveItemResultSchema>;\n\n/** A move pre-checked up to the point a confirmation decision is needed. */\ninterface MovePlan {\n  pair: { source: string; destination: string };\n  renamePath: string;\n  validDest: string;\n  isCaseOnlyRename: boolean;\n  /** Whether the destination existed when planned (drives the TOCTOU guard). */\n  destExistedOriginally: boolean;\n  /** Destination exists and is not a self/case-only move → needs overwrite confirmation. */\n  pending: boolean;\n}\n\n/**\n * Phase 1 (no mutation): validate source and destination, reject self-moves and\n * moves into a subdirectory of the source, and stat the destination to decide\n * whether this move needs an overwrite confirmation. No `mkdir` happens here —\n * the old flow created the destination's parent before asking, which mutated\n * the filesystem before a confirmation; that now waits for phase 2 (R14).\n */\nasync function planMove(\n  move: { source: string; destination: string },\n  fs: ToolCtx['fs'],\n): Promise<PairPlanResult<MovePlan>> {\n  let renamePath: string;\n  let realPath: string;\n  try {\n    ({ renamePath, realPath } = await validateMoveSource(move.source, fs));\n  } catch (error) {\n    return { status: 'fail', failure: pairFailure(move, error) };\n  }\n\n  let validDest: string;\n  try {\n    validDest = await fs.pathGuard.validatePathForWrite(move.destination);\n  } catch (error) {\n    return { status: 'fail', failure: pairFailure(move, error) };\n  }\n\n  // Comparisons run on the resolved source; only the fs call below uses\n  // renamePath. validatePathForWrite resolves the destination through a\n  // symlink too, so both sides of every check must be resolved to match.\n  const resolvedSource = resolve(realPath);\n  const resolvedDest = resolve(validDest);\n\n  if (resolvedSource === resolvedDest) {\n    // Self-move — silently skip.\n    return { status: 'noop' };\n  }\n\n  const normalizedDest = IS_CASE_INSENSITIVE_FS ? resolvedDest.toLowerCase() : resolvedDest;\n  const normalizedSource = IS_CASE_INSENSITIVE_FS\n    ? (resolvedSource + sep).toLowerCase()\n    : resolvedSource + sep;\n\n  if (normalizedDest.startsWith(normalizedSource)) {\n    return {\n      status: 'fail',\n      failure: pairFailure(\n        move,\n        new FsError(\n          ErrorCode.INVALID_INPUT,\n          'Cannot move a directory into its own subdirectory',\n          move.source,\n        ),\n      ),\n    };\n  }\n\n  const isCaseOnlyRename = isSamePath(resolvedSource, resolvedDest);\n  const destExistedOriginally = !isCaseOnlyRename && (await destExists(fs, validDest, 'move'));\n\n  const pending = !isCaseOnlyRename && destExistedOriginally;\n  return {\n    status: 'plan',\n    plan: { pair: move, renamePath, validDest, isCaseOnlyRename, destExistedOriginally, pending },\n  };\n}\n\n/**\n * Phase 2 (mutation): confirm an overwrite if needed, create the destination's\n * parent, TOCTOU-check the destination, then rename (with cross-device fallback).\n * A declined/missing confirmation throws `CANCELLED`, collected as a per-move\n * failure by the caller. A destination that appeared between plan and rename\n * (created during the confirmation gap) also fails closed.\n */\nasync function executeMove(\n  plan: MovePlan,\n  ctx: Pick<ToolCtx, 'fs' | 'signal' | 'inputResponses' | 'log'>,\n  pendingSorted: readonly string[],\n): Promise<PairExecResult<MoveItemResult>> {\n  if (plan.pending) {\n    const key = `confirm_${pendingSorted.indexOf(plan.validDest)}`;\n    const choice = readAcceptedChoice(ctx.inputResponses, key);\n    if (choice === 'skip') {\n      return { skipped: plan.pair.destination };\n    }\n    if (choice !== 'overwrite') {\n      throw new FsError(\n        ErrorCode.CANCELLED,\n        `Move cancelled: overwrite of \"${plan.pair.destination}\" was declined or missing`,\n        plan.pair.destination,\n      );\n    }\n  }\n\n  // TOCTOU check before any mutation: a destination that did not exist when\n  // planned but exists now was created during the confirmation gap.\n  if (!plan.isCaseOnlyRename) {\n    const existsNow = await destExists(ctx.fs, plan.validDest, 'move');\n    if (existsNow && !plan.destExistedOriginally) {\n      throw new FsError(\n        ErrorCode.CANCELLED,\n        `Move cancelled: destination \"${plan.pair.destination}\" was created during confirmation.`,\n        plan.pair.destination,\n      );\n    }\n  }\n\n  await ctx.fs.mkdir(dirname(plan.validDest), { recursive: true });\n\n  await performRenameWithFallback(plan.renamePath, plan.validDest, ctx.fs, plan.pair.source);\n  ctx.log?.('info', `move: ${plan.pair.source} -> ${plan.pair.destination}`, 'move');\n  return { value: { from: plan.renamePath, to: plan.validDest } };\n}\n\n/** A copy pre-checked up to the point a confirmation decision is needed. */\ninterface CopyPlan {\n  pair: { source: string; destination: string };\n  realSource: string;\n  validDest: string;\n  destExistedOriginally: boolean;\n  pending: boolean;\n}\n\nasync function planCopy(\n  copy: { source: string; destination: string },\n  fs: ToolCtx['fs'],\n  overwrite: boolean,\n): Promise<PairPlanResult<CopyPlan>> {\n  let realSource: string;\n  try {\n    realSource = await fs.pathGuard.validateExistingPath(copy.source);\n  } catch (error) {\n    return { status: 'fail', failure: pairFailure(copy, error) };\n  }\n\n  let validDest: string;\n  try {\n    validDest = await fs.pathGuard.validatePathForWrite(copy.destination);\n  } catch (error) {\n    return { status: 'fail', failure: pairFailure(copy, error) };\n  }\n\n  if (isSamePath(realSource, validDest)) {\n    // Self-copy — noop\n    return { status: 'noop' };\n  }\n\n  if (isPathInsideDirectory(realSource, validDest)) {\n    return {\n      status: 'fail',\n      failure: pairFailure(\n        copy,\n        new FsError(\n          ErrorCode.INVALID_INPUT,\n          'Cannot copy a directory into its own subdirectory',\n          copy.source,\n        ),\n      ),\n    };\n  }\n\n  const destExistedOriginally = await destExists(fs, validDest, 'copy');\n\n  const pending = destExistedOriginally && !overwrite;\n  return {\n    status: 'plan',\n    plan: { pair: copy, realSource, validDest, destExistedOriginally, pending },\n  };\n}\n\nasync function executeCopy(\n  plan: CopyPlan,\n  ctx: Pick<ToolCtx, 'fs' | 'signal' | 'inputResponses'>,\n  pendingSorted: readonly string[],\n  overwrite: boolean,\n): Promise<PairExecResult<MoveItemResult>> {\n  if (plan.pending && !overwrite) {\n    const key = `confirm_${pendingSorted.indexOf(plan.validDest)}`;\n    const choice = readAcceptedChoice(ctx.inputResponses, key);\n    if (choice === 'skip') {\n      return { skipped: plan.pair.destination };\n    }\n    if (choice !== 'overwrite') {\n      throw new FsError(\n        ErrorCode.CANCELLED,\n        `Copy cancelled: overwrite of \"${plan.pair.destination}\" was declined or missing`,\n        plan.pair.destination,\n      );\n    }\n  }\n\n  // TOCTOU check before any mutation: a destination that did not exist when\n  // planned but exists now was created during the confirmation gap.\n  if ((await destExists(ctx.fs, plan.validDest, 'copy')) && !plan.destExistedOriginally) {\n    throw new FsError(\n      ErrorCode.CANCELLED,\n      `Copy cancelled: destination \"${plan.pair.destination}\" was created during confirmation.`,\n      plan.pair.destination,\n    );\n  }\n\n  await ctx.fs.mkdir(dirname(plan.validDest), { recursive: true });\n\n  await ctx.fs.cp(plan.realSource, plan.validDest, {\n    recursive: true,\n    verbatimSymlinks: true,\n    preserveTimestamps: true,\n    force: true,\n  });\n\n  return { value: { from: plan.realSource, to: plan.validDest } };\n}\n\n/**\n * Two-phase move: pre-check every move (no mutation) to build the overwrite\n * pending set; if any move is pending and the round carries no verified\n * `requestState`, return `input_required` moving nothing (R14). On retry, R9\n * checks the state binds this move set, then each pending move proceeds only on\n * an accepted overwrite. Non-pending moves proceed alongside them.\n */\nasync function handleMove(\n  args: z.infer<typeof MoveInputSchema>,\n  ctx: ToolCtx,\n): Promise<z.infer<typeof MoveOutputSchema> | InputRequiredResult> {\n  const outcome = args.copy\n    ? await runOverPairs(args.moves, ctx, {\n        op: 'copy',\n        plan: (pair) => planCopy(pair, ctx.fs, args.overwrite),\n        execute: (plan, pendingSorted) => executeCopy(plan, ctx, pendingSorted, args.overwrite),\n      })\n    : await runOverPairs(args.moves, ctx, {\n        op: 'move',\n        plan: (move) => planMove(move, ctx.fs),\n        execute: (plan, pendingSorted) => executeMove(plan, ctx, pendingSorted),\n      });\n  if (isInputRequiredResult(outcome)) return outcome;\n\n  const { results, skipped, failures } = outcome;\n\n  return {\n    moves: results,\n    ...(failures.length > 0 ? { failures } : {}),\n    ...(skipped.length > 0 ? { skipped } : {}),\n  };\n}\n\nfunction buildSummary(\n  verb: 'move' | 'copy',\n  results: readonly MoveItemResult[],\n  failures: readonly MoveFailureItem[],\n  skipped: readonly string[] = [],\n): string {\n  const successCount = results.length;\n  const failCount = failures.length;\n  if (failCount === 0 && skipped.length === 0 && successCount === 1) {\n    const result = results[0];\n    if (result) {\n      return `${verb}: ${pathLabel(result.from)} → ${pathLabel(result.to)}`;\n    }\n  }\n  // Name each pair. \"move: 2 items\" left the caller to open structuredContent\n  // to learn which two, and a partial failure was unreadable without it.\n  // Skipped destinations are an outcome the user chose, not a failure — name\n  // them, or an all-skipped call reads as \"copy: nothing\".\n  const tokens = [\n    ...results.map((r) => `${pathLabel(r.from)} → ${pathLabel(r.to)}`),\n    ...skipped.map((dest) => `${pathLabel(dest)} SKIPPED`),\n  ];\n  const parts = [`${verb}: ${joinRoster(tokens) || 'nothing'}`];\n  if (failCount > 0) parts.push(`${String(failCount)} failed`);\n  return parts.join(' · ');\n}\n\ninterface MoveSource {\n  /** Symlink preserved — the path actually handed to rename/cp/rm. */\n  renamePath: string;\n  /** Symlink resolved — the identity used for every same-target comparison. */\n  realPath: string;\n}\n\n/**\n * A move needs two views of its source. Renaming must operate on the link\n * itself, or moving a symlink would rename the file it points at and leave the\n * link dangling. Every collision check must instead compare the resolved\n * target, or a link moved onto itself (or onto its own target) reads as a real\n * move and renames the link over that target, destroying it.\n */\nasync function validateMoveSource(source: string, fs: ToolCtx['fs']): Promise<MoveSource> {\n  try {\n    const realPath = await fs.pathGuard.validateExistingPath(source);\n    const renamePath = await fs.pathGuard.validatePathForDelete(source);\n    return { renamePath, realPath };\n  } catch (error) {\n    if (isFsError(error)) throw error;\n    throw new FsError(ErrorCode.ACCESS_DENIED, `Move failed for ${source}`, source);\n  }\n}\n\nasync function performRenameWithFallback(\n  validSource: string,\n  validDest: string,\n  fsOps: Pick<GuardedFileSystem, 'rename' | 'cp' | 'rm'>,\n  originalSource: string,\n): Promise<void> {\n  try {\n    await fsOps.rename(validSource, validDest);\n  } catch (error: unknown) {\n    rethrowIfAborted(error);\n\n    if (!isNodeError(error) || error.code !== 'EXDEV') {\n      throw error;\n    }\n\n    // EXDEV: cross-device rename. Copy then remove, preserving symlinks and\n    // timestamps so link semantics survive the move.\n    let copied = false;\n    try {\n      await fsOps.cp(validSource, validDest, {\n        recursive: true,\n        verbatimSymlinks: true,\n        preserveTimestamps: true,\n      });\n      copied = true;\n      await fsOps.rm(validSource, { recursive: true, force: true });\n    } catch (copyOrRemoveError) {\n      rethrowIfAborted(copyOrRemoveError);\n      if (copied) {\n        // cp succeeded but rm failed: the destination already holds a complete\n        // copy and the source remains. Surface the rm error as the cause so the\n        // caller can recover (clean up the duplicate) instead of a silent generic\n        // failure that hides the partial completion.\n        const baseProblem = Problem.fromUnknown(\n          copyOrRemoveError,\n          ErrorCode.UNKNOWN,\n          originalSource,\n        );\n        throw new FsError(\n          baseProblem.code,\n          `Cross-device move of ${originalSource}: copy succeeded but source removal failed (destination holds a copy): ${baseProblem.message}`,\n          originalSource,\n          undefined,\n          copyOrRemoveError,\n        );\n      }\n      throw copyOrRemoveError;\n    }\n  }\n}\n\nexport const MOVE = defineTool({\n  name: 'move',\n  title: 'Move or Copy Files',\n  description:\n    'Move, rename, or copy files and directories to explicit destination paths (max 100 operations per call). ' +\n    'Pass moves: [{ source, destination }] — there is no single-pair form. ' +\n    'Parent directories are created automatically. Set copy=true to copy instead of move (sources are kept). ' +\n    'An existing destination prompts the user to confirm the overwrite, so the call returns without moving ' +\n    'anything until that confirmation comes back; copy=true with overwrite=true skips the prompt, move has no ' +\n    'such bypass. Self-moves are silently skipped.',\n  input: MoveInputSchema,\n  output: MoveOutputSchema,\n  annotations: {\n    readOnlyHint: false,\n    idempotentHint: false,\n    destructiveHint: true,\n    openWorldHint: false,\n  },\n  progress: (args) => {\n    const label = args.copy ? 'Copy' : 'Move';\n    if (args.moves.length === 1) {\n      const move = args.moves[0];\n      return {\n        label,\n        subject: `${basename(move?.source ?? '')} → ${basename(move?.destination ?? '')}`,\n      };\n    }\n    return { label, subject: `${String(args.moves.length)} files` };\n  },\n  defaultErrorCode: ErrorCode.UNKNOWN,\n  accessPaths: (args) => args.moves.flatMap((m) => [m.source, m.destination]),\n  run: async (args, ctx) => {\n    const output = await handleMove(args, ctx);\n    // input_required is a return value, not a completed call: surface it\n    // verbatim so the executor short-circuits before building a CallToolResult.\n    if (isInputRequiredResult(output)) return output;\n    return {\n      structured: output,\n      text: buildSummary(\n        args.copy ? 'copy' : 'move',\n        output.moves,\n        output.failures ?? [],\n        output.skipped ?? [],\n      ),\n    };\n  },\n});\n"]}

package/dist/tools/patch.d.ts

@@ -0,0 +1,2 @@
+export declare const PATCH: import("./define.js").DefinedTool;
+//# sourceMappingURL=patch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../../src/tools/patch.ts"],"names":[],"mappings":"AA2LA,eAAO,MAAM,KAAK,mCAsBhB,CAAC"}

package/dist/tools/patch.js

@@ -0,0 +1,155 @@
+import { basename } from 'node:path';
+import * as z from 'zod/v4';
+import { applyPatch, parsePatch } from 'diff';
+import { ErrorCode, FsError } from '../core/errors.js';
+import { buildFileResourceLink, buildFileResourceUri } from '../core/file-uri.js';
+import { detectMimeFromContent } from '../core/mime.js';
+import { countLines } from '../core/read.js';
+import { defaultFalseBoolean, FileKind, IsoDateTime, NonNegInt, RequiredPath, } from '../core/schema.js';
+import { defineTool } from './define.js';
+const PatchInputSchema = z.strictObject({
+    path: RequiredPath.describe('File to apply the diff to'),
+    diff: z
+        .string()
+        .min(1)
+        .describe('Single-file unified diff to apply (as produced by the diff tool or edit dry-run)'),
+    dryRun: defaultFalseBoolean('Preview the result without writing (default: false)'),
+});
+const PatchOutputSchema = z.strictObject({
+    path: z.string().describe('Resolved absolute path of the patched file'),
+    size: NonNegInt.describe('File size in bytes after patching'),
+    lineCount: NonNegInt.describe('Number of lines in the file after patching'),
+    mimeType: z.string().describe('Detected MIME type of the file'),
+    kind: FileKind.describe('Broad file kind: text, binary, image, audio, or pdf'),
+    resourceUri: z.string().describe('Resource URI pointing to the patched file content'),
+    modified: IsoDateTime.describe('Last modification timestamp after patching (ISO 8601 UTC)'),
+    linesAdded: NonNegInt.describe('Number of lines added by the patch'),
+    linesRemoved: NonNegInt.describe('Number of lines removed by the patch'),
+    diff: z.string().optional().describe('Unified diff preview (present only in dryRun mode)'),
+});
+function buildPatchMeta(validPath, patched, resourceStore) {
+    const bytesWritten = Buffer.byteLength(patched, 'utf-8');
+    const mimeInfo = detectMimeFromContent(validPath, patched);
+    const resourceUri = buildFileResourceUri(validPath);
+    const link = resourceStore !== undefined
+        ? buildFileResourceLink(validPath, mimeInfo.mimeType, bytesWritten)
+        : undefined;
+    return {
+        size: bytesWritten,
+        lineCount: countLines(patched),
+        mimeType: mimeInfo.mimeType,
+        kind: mimeInfo.kind,
+        resourceUri,
+        link,
+    };
+}
+// Hunk lines are the raw unified lines with their +/-/ leading prefix (no
+// +++/--- file headers inside hunks), so the first char is a reliable marker.
+function countAddedRemoved(parsedPatch) {
+    let linesAdded = 0;
+    let linesRemoved = 0;
+    for (const hunk of parsedPatch.hunks) {
+        for (const line of hunk.lines) {
+            if (line.startsWith('+'))
+                linesAdded += 1;
+            else if (line.startsWith('-'))
+                linesRemoved += 1;
+        }
+    }
+    return { linesAdded, linesRemoved };
+}
+async function handlePatch(args, ctx) {
+    const { validPath, content, stats } = await ctx.fs.readEditableText(args.path, {
+        signal: ctx.signal,
+        tool: 'patch',
+    });
+    // patch is single-file only: a multi-file unified diff (parsePatch length > 1)
+    // is rejected. Multi-file application needs per-file PathGuard-resolved loaders
+    // and is deferred (out of scope).
+    const parsed = parsePatch(args.diff);
+    if (parsed.length !== 1) {
+        throw new FsError(ErrorCode.INVALID_INPUT, `patch accepts a single-file unified diff; received ${parsed.length} file(s)`, args.path);
+    }
+    const parsedPatch = parsed[0];
+    if (!parsedPatch || parsedPatch.hunks.length === 0) {
+        throw new FsError(ErrorCode.INVALID_INPUT, 'patch accepts a single-file unified diff with at least one hunk; received an empty patch', args.path);
+    }
+    // applyPatch returns false (strict) on hunk mismatch — not a falsy empty string,
+    // so `=== false` distinguishes a no-op patch ('') from a failed one.
+    const patched = applyPatch(content, parsedPatch);
+    if (patched === false) {
+        throw new FsError(ErrorCode.INVALID_INPUT, 'patch did not apply cleanly: hunk context does not match file content', args.path);
+    }
+    const { linesAdded, linesRemoved } = countAddedRemoved(parsedPatch);
+    // The patched file used to come back whole in the text block, so a one-line
+    // hunk against a 5000-line file returned 5000 lines. Every other write tool
+    // answers with a summary; the result is reachable via `resourceUri` or a
+    // follow-up `read` when the caller actually wants the bytes.
+    const summaryText = `patch: ${basename(args.path)} +${String(linesAdded)} -${String(linesRemoved)}`;
+    if (args.dryRun) {
+        const meta = buildPatchMeta(validPath, patched, ctx.resourceStore);
+        return {
+            structured: {
+                path: validPath,
+                size: meta.size,
+                lineCount: meta.lineCount,
+                mimeType: meta.mimeType,
+                kind: meta.kind,
+                resourceUri: meta.resourceUri,
+                modified: stats.mtime.toISOString(),
+                linesAdded,
+                linesRemoved,
+                diff: args.diff,
+            },
+            // A dry run exists to be previewed, so it keeps returning the patched
+            // text; only the write path summarizes, where the bytes are on disk.
+            text: patched,
+            ...(meta.link !== undefined ? { resources: [meta.link] } : {}),
+        };
+    }
+    await ctx.fs.writeFile(args.path, patched, { encoding: 'utf-8', signal: ctx.signal });
+    ctx.log?.('info', `patch: ${args.path} (+${linesAdded}/-${linesRemoved})`, 'patch');
+    // `modified` is read from a post-write stat and is advisory: under a concurrent
+    // writer it may reflect that writer's mtime while `size`/content come from this
+    // patch's atomic write. The file content itself is always consistent.
+    const { stats: fileStats } = await ctx.fs.stat(args.path, { signal: ctx.signal });
+    const meta = buildPatchMeta(validPath, patched, ctx.resourceStore);
+    return {
+        structured: {
+            path: validPath,
+            size: meta.size,
+            lineCount: meta.lineCount,
+            mimeType: meta.mimeType,
+            kind: meta.kind,
+            resourceUri: meta.resourceUri,
+            modified: fileStats.mtime.toISOString(),
+            linesAdded,
+            linesRemoved,
+        },
+        text: summaryText,
+        ...(meta.link !== undefined ? { resources: [meta.link] } : {}),
+    };
+}
+export const PATCH = defineTool({
+    name: 'patch',
+    title: 'Patch',
+    description: 'Apply a single-file unified diff to one file and write the result. Pass { path, diff }. ' +
+        'Use after inspecting a diff tool dry-run: pass the diff blob directly instead of re-expressing it as line edits. ' +
+        'Rejects multi-file diffs and diffs whose hunk context does not match the file. ' +
+        'Set dryRun=true to preview the result without writing.',
+    input: PatchInputSchema,
+    output: PatchOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        idempotentHint: false,
+        destructiveHint: true,
+        openWorldHint: false,
+    },
+    progress: (args) => ({
+        label: args.dryRun ? 'Patch [dry run]' : 'Patch',
+        subject: basename(args.path),
+    }),
+    accessPaths: (args) => [args.path],
+    run: (args, ctx) => handlePatch(args, ctx),
+});
+//# sourceMappingURL=patch.js.map

package/dist/tools/patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.js","sourceRoot":"","sources":["../../src/tools/patch.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ContentBlock } from '@modelcontextprotocol/server';\n\nimport { basename } from 'node:path';\n\nimport * as z from 'zod/v4';\nimport { applyPatch, parsePatch } from 'diff';\n\nimport { ErrorCode, FsError } from '../core/errors.js';\nimport { buildFileResourceLink, buildFileResourceUri } from '../core/file-uri.js';\nimport { detectMimeFromContent } from '../core/mime.js';\nimport { countLines } from '../core/read.js';\nimport {\n  defaultFalseBoolean,\n  FileKind,\n  IsoDateTime,\n  NonNegInt,\n  RequiredPath,\n} from '../core/schema.js';\nimport { defineTool, type ToolCtx } from './define.js';\n\nconst PatchInputSchema = z.strictObject({\n  path: RequiredPath.describe('File to apply the diff to'),\n  diff: z\n    .string()\n    .min(1)\n    .describe('Single-file unified diff to apply (as produced by the diff tool or edit dry-run)'),\n  dryRun: defaultFalseBoolean('Preview the result without writing (default: false)'),\n});\n\nconst PatchOutputSchema = z.strictObject({\n  path: z.string().describe('Resolved absolute path of the patched file'),\n  size: NonNegInt.describe('File size in bytes after patching'),\n  lineCount: NonNegInt.describe('Number of lines in the file after patching'),\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.string().describe('Resource URI pointing to the patched file content'),\n  modified: IsoDateTime.describe('Last modification timestamp after patching (ISO 8601 UTC)'),\n  linesAdded: NonNegInt.describe('Number of lines added by the patch'),\n  linesRemoved: NonNegInt.describe('Number of lines removed by the patch'),\n  diff: z.string().optional().describe('Unified diff preview (present only in dryRun mode)'),\n});\n\ninterface PatchMeta {\n  size: number;\n  lineCount: number;\n  mimeType: string;\n  kind: FileKind;\n  resourceUri: string;\n  link: ContentBlock | undefined;\n}\n\nfunction buildPatchMeta(\n  validPath: string,\n  patched: string,\n  resourceStore: ToolCtx['resourceStore'],\n): PatchMeta {\n  const bytesWritten = Buffer.byteLength(patched, 'utf-8');\n  const mimeInfo = detectMimeFromContent(validPath, patched);\n  const resourceUri = buildFileResourceUri(validPath);\n  const link =\n    resourceStore !== undefined\n      ? buildFileResourceLink(validPath, mimeInfo.mimeType, bytesWritten)\n      : undefined;\n  return {\n    size: bytesWritten,\n    lineCount: countLines(patched),\n    mimeType: mimeInfo.mimeType,\n    kind: mimeInfo.kind,\n    resourceUri,\n    link,\n  };\n}\n\n// Hunk lines are the raw unified lines with their +/-/ leading prefix (no\n// +++/--- file headers inside hunks), so the first char is a reliable marker.\nfunction countAddedRemoved(parsedPatch: ReturnType<typeof parsePatch>[number]): {\n  linesAdded: number;\n  linesRemoved: number;\n} {\n  let linesAdded = 0;\n  let linesRemoved = 0;\n  for (const hunk of parsedPatch.hunks) {\n    for (const line of hunk.lines) {\n      if (line.startsWith('+')) linesAdded += 1;\n      else if (line.startsWith('-')) linesRemoved += 1;\n    }\n  }\n  return { linesAdded, linesRemoved };\n}\n\nasync function handlePatch(\n  args: z.infer<typeof PatchInputSchema>,\n  ctx: ToolCtx,\n): Promise<{\n  structured: z.infer<typeof PatchOutputSchema>;\n  text: string;\n  resources?: ContentBlock[];\n}> {\n  const { validPath, content, stats } = await ctx.fs.readEditableText(args.path, {\n    signal: ctx.signal,\n    tool: 'patch',\n  });\n\n  // patch is single-file only: a multi-file unified diff (parsePatch length > 1)\n  // is rejected. Multi-file application needs per-file PathGuard-resolved loaders\n  // and is deferred (out of scope).\n  const parsed = parsePatch(args.diff);\n  if (parsed.length !== 1) {\n    throw new FsError(\n      ErrorCode.INVALID_INPUT,\n      `patch accepts a single-file unified diff; received ${parsed.length} file(s)`,\n      args.path,\n    );\n  }\n  const parsedPatch = parsed[0];\n  if (!parsedPatch || parsedPatch.hunks.length === 0) {\n    throw new FsError(\n      ErrorCode.INVALID_INPUT,\n      'patch accepts a single-file unified diff with at least one hunk; received an empty patch',\n      args.path,\n    );\n  }\n  // applyPatch returns false (strict) on hunk mismatch — not a falsy empty string,\n  // so `=== false` distinguishes a no-op patch ('') from a failed one.\n  const patched = applyPatch(content, parsedPatch);\n  if (patched === false) {\n    throw new FsError(\n      ErrorCode.INVALID_INPUT,\n      'patch did not apply cleanly: hunk context does not match file content',\n      args.path,\n    );\n  }\n\n  const { linesAdded, linesRemoved } = countAddedRemoved(parsedPatch);\n  // The patched file used to come back whole in the text block, so a one-line\n  // hunk against a 5000-line file returned 5000 lines. Every other write tool\n  // answers with a summary; the result is reachable via `resourceUri` or a\n  // follow-up `read` when the caller actually wants the bytes.\n  const summaryText = `patch: ${basename(args.path)} +${String(linesAdded)} -${String(linesRemoved)}`;\n\n  if (args.dryRun) {\n    const meta = buildPatchMeta(validPath, patched, ctx.resourceStore);\n    return {\n      structured: {\n        path: validPath,\n        size: meta.size,\n        lineCount: meta.lineCount,\n        mimeType: meta.mimeType,\n        kind: meta.kind,\n        resourceUri: meta.resourceUri,\n        modified: stats.mtime.toISOString(),\n        linesAdded,\n        linesRemoved,\n        diff: args.diff,\n      },\n      // A dry run exists to be previewed, so it keeps returning the patched\n      // text; only the write path summarizes, where the bytes are on disk.\n      text: patched,\n      ...(meta.link !== undefined ? { resources: [meta.link] } : {}),\n    };\n  }\n\n  await ctx.fs.writeFile(args.path, patched, { encoding: 'utf-8', signal: ctx.signal });\n  ctx.log?.('info', `patch: ${args.path} (+${linesAdded}/-${linesRemoved})`, 'patch');\n\n  // `modified` is read from a post-write stat and is advisory: under a concurrent\n  // writer it may reflect that writer's mtime while `size`/content come from this\n  // patch's atomic write. The file content itself is always consistent.\n  const { stats: fileStats } = await ctx.fs.stat(args.path, { signal: ctx.signal });\n  const meta = buildPatchMeta(validPath, patched, ctx.resourceStore);\n  return {\n    structured: {\n      path: validPath,\n      size: meta.size,\n      lineCount: meta.lineCount,\n      mimeType: meta.mimeType,\n      kind: meta.kind,\n      resourceUri: meta.resourceUri,\n      modified: fileStats.mtime.toISOString(),\n      linesAdded,\n      linesRemoved,\n    },\n    text: summaryText,\n    ...(meta.link !== undefined ? { resources: [meta.link] } : {}),\n  };\n}\n\nexport const PATCH = defineTool({\n  name: 'patch',\n  title: 'Patch',\n  description:\n    'Apply a single-file unified diff to one file and write the result. Pass { path, diff }. ' +\n    'Use after inspecting a diff tool dry-run: pass the diff blob directly instead of re-expressing it as line edits. ' +\n    'Rejects multi-file diffs and diffs whose hunk context does not match the file. ' +\n    'Set dryRun=true to preview the result without writing.',\n  input: PatchInputSchema,\n  output: PatchOutputSchema,\n  annotations: {\n    readOnlyHint: false,\n    idempotentHint: false,\n    destructiveHint: true,\n    openWorldHint: false,\n  },\n  progress: (args) => ({\n    label: args.dryRun ? 'Patch [dry run]' : 'Patch',\n    subject: basename(args.path),\n  }),\n  accessPaths: (args) => [args.path],\n  run: (args, ctx) => handlePatch(args, ctx),\n});\n"]}

package/dist/tools/progress.d.ts

@@ -0,0 +1,52 @@
+import type { Notification } from '@modelcontextprotocol/server';
+export type ProgressEvent = {
+    kind: 'tick';
+    current: number;
+    total?: number;
+    message: string;
+} | {
+    kind: 'complete';
+    current: number;
+    total?: number;
+    message: string;
+} | {
+    kind: 'fail';
+    current: number;
+    total?: number;
+    message: string;
+    error: unknown;
+};
+export interface ProgressSink {
+    readonly name: string;
+    readonly emit: (event: ProgressEvent) => Promise<void> | void;
+}
+interface ProgressSessionOptions {
+    label: string;
+    total?: number;
+    sinks: ProgressSink[];
+    /** Override the rate limit window. Default: 50ms. */
+    rateLimitMs?: number;
+}
+export declare class ProgressSession {
+    #private;
+    constructor(opts: ProgressSessionOptions);
+    set(input: {
+        current: number;
+        total?: number;
+        message?: string;
+    }): void;
+    complete(message: string): void;
+    fail(error: unknown, message?: string): void;
+}
+export declare class McpProgressSink implements ProgressSink {
+    #private;
+    readonly name = "mcp";
+    private readonly toolName;
+    private readonly token;
+    private readonly notify;
+    constructor(toolName: string, token: string | number, notify: (n: Notification) => Promise<void>);
+    emit(event: ProgressEvent): void;
+    flush(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=progress.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/tools/progress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAA8B,MAAM,8BAA8B,CAAC;AAU7F,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtE;IACE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEN,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC/D;AAED,UAAU,sBAAsB;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAID,qBAAa,eAAe;;gBAWd,IAAI,EAAE,sBAAsB;IAmBxC,GAAG,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAgBvE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAW/B,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;CA2D7C;AAED,qBAAa,eAAgB,YAAW,YAAY;;IAClD,QAAQ,CAAC,IAAI,SAAS;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;gBAK1D,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,MAAM,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC;IAO5C,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAsC1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/dist/tools/progress.js

@@ -0,0 +1,172 @@
+import { formatUnknownErrorMessage } from '../core/errors.js';
+import { Logger } from '../core/observability.js';
+function reportDetachedError(toolName, context, error) {
+    const message = formatUnknownErrorMessage(error);
+    Logger.emit('warning', `${toolName}: ${context} failed: ${message}`);
+}
+const DEFAULT_RATE_LIMIT_MS = 50;
+export class ProgressSession {
+    #label;
+    #total;
+    #sinks;
+    #rateLimitMs;
+    #startTime;
+    #cursor = 0;
+    #lastSentMs = 0;
+    #done = false;
+    constructor(opts) {
+        this.#label = opts.label;
+        this.#total = opts.total;
+        this.#sinks = opts.sinks;
+        this.#rateLimitMs = opts.rateLimitMs ?? DEFAULT_RATE_LIMIT_MS;
+        const now = Date.now();
+        this.#startTime = now;
+        this.#lastSentMs = now - this.#rateLimitMs;
+        // Synthetic start tick — preserves today's "fire 0/total at session creation" wire behavior.
+        this.#dispatch({
+            kind: 'tick',
+            current: 0,
+            ...(this.#total !== undefined ? { total: this.#total } : {}),
+            message: this.#label,
+        });
+    }
+    set(input) {
+        if (this.#done)
+            return;
+        // The spec requires `progress` to increase on every notification, and the
+        // constructor already dispatched current: 0. A repeated or backward tick
+        // would put a duplicate value on the wire — drop it.
+        if (input.current <= this.#cursor)
+            return;
+        this.#cursor = input.current;
+        const total = input.total ?? this.#total;
+        this.#dispatch({
+            kind: 'tick',
+            current: this.#cursor,
+            ...(total !== undefined ? { total } : {}),
+            message: input.message ?? this.#label,
+        });
+    }
+    complete(message) {
+        if (this.#done)
+            return;
+        this.#done = true;
+        this.#dispatch({
+            kind: 'complete',
+            current: this.#cursor,
+            ...(this.#total !== undefined ? { total: this.#total } : {}),
+            message,
+        });
+    }
+    fail(error, message) {
+        if (this.#done)
+            return;
+        this.#done = true;
+        this.#dispatch({
+            kind: 'fail',
+            current: this.#cursor,
+            ...(this.#total !== undefined ? { total: this.#total } : {}),
+            message: message ?? this.#label,
+            error,
+        });
+    }
+    #dispatch(event) {
+        if (this.#shouldRateLimit(event)) {
+            return;
+        }
+        this.#lastSentMs = Date.now();
+        for (const sink of this.#sinks) {
+            this.#emitGuarded(sink, event);
+        }
+    }
+    #shouldRateLimit(event) {
+        if (event.kind !== 'tick') {
+            return false;
+        }
+        // Widen the window after 5s of execution; a rateLimitMs of 0 (tests) stays 0
+        // only inside the first 5s, which every test run fits in.
+        const now = Date.now();
+        const effectiveRateLimit = now - this.#startTime > 5000 ? Math.max(this.#rateLimitMs, 250) : this.#rateLimitMs;
+        const elapsed = now - this.#lastSentMs;
+        return elapsed < effectiveRateLimit;
+    }
+    #emitGuarded(sink, event) {
+        try {
+            const result = sink.emit(event);
+            if (result instanceof Promise) {
+                result.catch((err) => {
+                    Logger.warn('ProgressSink emit failed', {
+                        sink: sink.name,
+                        eventKind: event.kind,
+                        err,
+                    });
+                });
+            }
+        }
+        catch (err) {
+            Logger.warn('ProgressSink emit failed', {
+                sink: sink.name,
+                eventKind: event.kind,
+                err,
+            });
+        }
+    }
+}
+export class McpProgressSink {
+    name = 'mcp';
+    toolName;
+    token;
+    notify;
+    #pending = new Set();
+    #lastProgress = -1;
+    constructor(toolName, token, notify) {
+        this.toolName = toolName;
+        this.token = token;
+        this.notify = notify;
+    }
+    emit(event) {
+        let current = event.current;
+        let total = event.total;
+        if (event.kind === 'complete') {
+            current = total ?? current;
+            total = current;
+        }
+        if (event.kind !== 'tick') {
+            // A terminal frame carries the outcome message, so it must reach the
+            // wire. It repeats the cursor whenever the session has no `total` (there
+            // is nothing higher to report), and the spec requires progress to
+            // increase per token — so advance past the last value instead of dropping
+            // the frame.
+            current = Math.max(current, this.#lastProgress + 1);
+            if (total !== undefined && total < current)
+                total = current;
+        }
+        // Spec: progress must increase on every notification for the same token.
+        if (current <= this.#lastProgress)
+            return;
+        this.#lastProgress = current;
+        const notificationParams = {
+            progressToken: this.token,
+            progress: current,
+            ...(total !== undefined ? { total } : {}),
+            message: event.message,
+        };
+        const promise = this.notify({
+            method: 'notifications/progress',
+            params: notificationParams,
+        })
+            .catch((error) => {
+            reportDetachedError(this.toolName, 'progressNotification', error);
+        })
+            .finally(() => {
+            this.#pending.delete(promise);
+        });
+        this.#pending.add(promise);
+    }
+    async flush() {
+        if (this.#pending.size > 0) {
+            await Promise.allSettled([...this.#pending]);
+        }
+    }
+}
+//# sourceMappingURL=progress.js.map

package/dist/tools/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../src/tools/progress.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Notification, ProgressNotificationParams } from '@modelcontextprotocol/server';\n\nimport { formatUnknownErrorMessage } from '../core/errors.js';\nimport { Logger } from '../core/observability.js';\n\nfunction reportDetachedError(toolName: string, context: string, error: unknown): void {\n  const message = formatUnknownErrorMessage(error);\n  Logger.emit('warning', `${toolName}: ${context} failed: ${message}`);\n}\n\nexport type ProgressEvent =\n  | { kind: 'tick'; current: number; total?: number; message: string }\n  | { kind: 'complete'; current: number; total?: number; message: string }\n  | {\n      kind: 'fail';\n      current: number;\n      total?: number;\n      message: string;\n      error: unknown;\n    };\n\nexport interface ProgressSink {\n  readonly name: string;\n  readonly emit: (event: ProgressEvent) => Promise<void> | void;\n}\n\ninterface ProgressSessionOptions {\n  label: string;\n  total?: number;\n  sinks: ProgressSink[];\n  /** Override the rate limit window. Default: 50ms. */\n  rateLimitMs?: number;\n}\n\nconst DEFAULT_RATE_LIMIT_MS = 50;\n\nexport class ProgressSession {\n  readonly #label: string;\n  readonly #total: number | undefined;\n  readonly #sinks: ProgressSink[];\n  readonly #rateLimitMs: number;\n  readonly #startTime: number;\n\n  #cursor = 0;\n  #lastSentMs = 0;\n  #done = false;\n\n  constructor(opts: ProgressSessionOptions) {\n    this.#label = opts.label;\n    this.#total = opts.total;\n    this.#sinks = opts.sinks;\n    this.#rateLimitMs = opts.rateLimitMs ?? DEFAULT_RATE_LIMIT_MS;\n\n    const now = Date.now();\n    this.#startTime = now;\n    this.#lastSentMs = now - this.#rateLimitMs;\n\n    // Synthetic start tick — preserves today's \"fire 0/total at session creation\" wire behavior.\n    this.#dispatch({\n      kind: 'tick',\n      current: 0,\n      ...(this.#total !== undefined ? { total: this.#total } : {}),\n      message: this.#label,\n    });\n  }\n\n  set(input: { current: number; total?: number; message?: string }): void {\n    if (this.#done) return;\n    // The spec requires `progress` to increase on every notification, and the\n    // constructor already dispatched current: 0. A repeated or backward tick\n    // would put a duplicate value on the wire — drop it.\n    if (input.current <= this.#cursor) return;\n    this.#cursor = input.current;\n    const total = input.total ?? this.#total;\n    this.#dispatch({\n      kind: 'tick',\n      current: this.#cursor,\n      ...(total !== undefined ? { total } : {}),\n      message: input.message ?? this.#label,\n    });\n  }\n\n  complete(message: string): void {\n    if (this.#done) return;\n    this.#done = true;\n    this.#dispatch({\n      kind: 'complete',\n      current: this.#cursor,\n      ...(this.#total !== undefined ? { total: this.#total } : {}),\n      message,\n    });\n  }\n\n  fail(error: unknown, message?: string): void {\n    if (this.#done) return;\n    this.#done = true;\n    this.#dispatch({\n      kind: 'fail',\n      current: this.#cursor,\n      ...(this.#total !== undefined ? { total: this.#total } : {}),\n      message: message ?? this.#label,\n      error,\n    });\n  }\n\n  #dispatch(event: ProgressEvent): void {\n    if (this.#shouldRateLimit(event)) {\n      return;\n    }\n\n    this.#lastSentMs = Date.now();\n\n    for (const sink of this.#sinks) {\n      this.#emitGuarded(sink, event);\n    }\n  }\n\n  #shouldRateLimit(event: ProgressEvent): boolean {\n    if (event.kind !== 'tick') {\n      return false;\n    }\n\n    // Widen the window after 5s of execution; a rateLimitMs of 0 (tests) stays 0\n    // only inside the first 5s, which every test run fits in.\n    const now = Date.now();\n    const effectiveRateLimit =\n      now - this.#startTime > 5000 ? Math.max(this.#rateLimitMs, 250) : this.#rateLimitMs;\n\n    const elapsed = now - this.#lastSentMs;\n    return elapsed < effectiveRateLimit;\n  }\n\n  #emitGuarded(sink: ProgressSink, event: ProgressEvent): void {\n    try {\n      const result = sink.emit(event);\n      if (result instanceof Promise) {\n        result.catch((err: unknown) => {\n          Logger.warn('ProgressSink emit failed', {\n            sink: sink.name,\n            eventKind: event.kind,\n            err,\n          });\n        });\n      }\n    } catch (err) {\n      Logger.warn('ProgressSink emit failed', {\n        sink: sink.name,\n        eventKind: event.kind,\n        err,\n      });\n    }\n  }\n}\n\nexport class McpProgressSink implements ProgressSink {\n  readonly name = 'mcp';\n  private readonly toolName: string;\n  private readonly token: string | number;\n  private readonly notify: (n: Notification) => Promise<void>;\n  readonly #pending = new Set<Promise<void>>();\n  #lastProgress = -1;\n\n  constructor(\n    toolName: string,\n    token: string | number,\n    notify: (n: Notification) => Promise<void>,\n  ) {\n    this.toolName = toolName;\n    this.token = token;\n    this.notify = notify;\n  }\n\n  emit(event: ProgressEvent): void {\n    let current = event.current;\n    let total = event.total;\n    if (event.kind === 'complete') {\n      current = total ?? current;\n      total = current;\n    }\n    if (event.kind !== 'tick') {\n      // A terminal frame carries the outcome message, so it must reach the\n      // wire. It repeats the cursor whenever the session has no `total` (there\n      // is nothing higher to report), and the spec requires progress to\n      // increase per token — so advance past the last value instead of dropping\n      // the frame.\n      current = Math.max(current, this.#lastProgress + 1);\n      if (total !== undefined && total < current) total = current;\n    }\n    // Spec: progress must increase on every notification for the same token.\n    if (current <= this.#lastProgress) return;\n    this.#lastProgress = current;\n    const notificationParams: ProgressNotificationParams = {\n      progressToken: this.token,\n      progress: current,\n      ...(total !== undefined ? { total } : {}),\n      message: event.message,\n    };\n    const promise = this.notify({\n      method: 'notifications/progress',\n      params: notificationParams,\n    })\n      .catch((error: unknown) => {\n        reportDetachedError(this.toolName, 'progressNotification', error);\n      })\n      .finally(() => {\n        this.#pending.delete(promise);\n      });\n    this.#pending.add(promise);\n  }\n\n  async flush(): Promise<void> {\n    if (this.#pending.size > 0) {\n      await Promise.allSettled([...this.#pending]);\n    }\n  }\n}\n"]}

package/dist/tools/read.d.ts

@@ -1,4 +1,2 @@
-import type { McpServer } from '@modelcontextprotocol/server';
-import { type ToolContract, type ToolRegistrationOptions } from './shared.js';
-export declare const READ_FILE_TOOL: ToolContract;
-export declare function registerReadFileTool(server: McpServer, options?: ToolRegistrationOptions): void;
+export declare const READ_FILE: import("./define.js").DefinedTool;
+//# sourceMappingURL=read.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"AAgYA,eAAO,MAAM,SAAS,mCAkKpB,CAAC"}