@j0hanz/filesystem-mcp 1.19.0 → 2.0.0

package/dist/tools/edit.js

@@ -0,0 +1,442 @@
+import { basename } from 'node:path';
+import * as z from 'zod/v4';
+import { createTwoFilesPatch, diffLines } from 'diff';
+import { ErrorCode, FsError } from '../core/errors.js';
+import { buildFileResourceLink, buildFileResourceUri } from '../core/file-uri.js';
+import { detectMimeFromContent } from '../core/mime.js';
+import { escapeRegexLiteral } from '../core/primitives.js';
+import { countLines } from '../core/read.js';
+import { defaultFalseBoolean, FileKind, isBlank, IsoDateTime, NonNegInt, OperationSummarySchema, PerFileErrorSchema, PositiveInt, RequiredPath, singleOrBatchAccessPaths, } from '../core/schema.js';
+import { compileRegex, freeRegex } from '../core/search.js';
+import { runOverPaths } from './batch.js';
+import { defineTool } from './define.js';
+const EditSpecSchema = z
+    .strictObject({
+    oldText: z
+        .string()
+        .min(1, 'oldText required')
+        .refine((val) => !isBlank(val), {
+        message: 'oldText cannot be empty or whitespace-only',
+    })
+        .describe('Exact literal text to locate in the file. Must include 3-5 lines of context to ensure uniqueness and avoid matching the wrong block.')
+        .meta({ examples: ['const x = 1;', 'function oldName('] }),
+    newText: z
+        .string()
+        .describe('Replacement text. Use an empty string to delete the matched oldText.')
+        .meta({ examples: ['const x = 2;', 'function newName(', ''] }),
+})
+    // The one document in this server where a `$ref` pays: this subschema is used
+    // at both `edits` and `files[].edits`, so an `id` hoists it into `$defs` once
+    // instead of inlining ~1.3 kB twice. Shared schemas used once per document
+    // deliberately carry no `id` — there a `$ref` costs more than it saves.
+    .meta({ id: 'EditSpec' });
+const MAX_MULTI_FILES = 5;
+const MAX_EDITS_PER_FILE = 100;
+const EditFileInputSchema = z
+    .strictObject({
+    path: RequiredPath.optional().describe('Single file path; mutually exclusive with files'),
+    edits: z
+        .array(EditSpecSchema)
+        .min(1)
+        .max(MAX_EDITS_PER_FILE)
+        .optional()
+        .describe('Replacements applied to path; not allowed when using files'),
+    files: z
+        .array(z.strictObject({
+        path: RequiredPath,
+        edits: z
+            .array(EditSpecSchema)
+            .min(1)
+            .max(MAX_EDITS_PER_FILE)
+            .describe('Replacements to apply to this specific file'),
+    }))
+        .min(1)
+        .max(MAX_MULTI_FILES)
+        .optional()
+        .describe('Per-file entries (batch mode)'),
+    dryRun: defaultFalseBoolean('Preview diffs without writing to disk (default: false = apply edits)'),
+    ignoreWhitespace: defaultFalseBoolean('Ignore leading/trailing whitespace differences when matching oldText'),
+})
+    .superRefine((value, ctx) => {
+    const hasPath = value.path !== undefined;
+    const hasFiles = value.files !== undefined;
+    if (hasPath === hasFiles) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['path'],
+            message: "Provide exactly one of 'path' or 'files'",
+            input: value,
+        });
+    }
+    if (hasPath && value.edits === undefined) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['edits'],
+            message: "'edits' required when using 'path'",
+            input: value,
+        });
+    }
+    if (hasFiles && value.edits !== undefined) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['edits'],
+            message: "'edits' not allowed with 'files'; each file carries its own edits",
+            input: value,
+        });
+    }
+})
+    // Mirror the superRefine on the wire: exactly one input mode, and single-file
+    // mode carries its own `edits`. Without `edits` in the first branch, `{ path }`
+    // alone validated against the published schema and was then rejected at
+    // runtime — the model had no way to see that coming.
+    .meta({ oneOf: [{ required: ['path', 'edits'] }, { required: ['files'] }] });
+const PerFileResultSchema = z.strictObject({
+    path: z.string().describe('Resolved absolute path of the edited file'),
+    size: NonNegInt.describe('File size in bytes after edits'),
+    lineCount: NonNegInt.describe('Number of lines in the file after edits'),
+    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()
+        .optional()
+        .describe('Resource URI pointing to the updated file content; omitted when no edit matched (appliedEdits is 0) and the file was left untouched'),
+    modified: IsoDateTime.describe('Last modification timestamp after edits (ISO 8601 UTC)'),
+    appliedEdits: NonNegInt.describe('Number of edits successfully applied'),
+    linesAdded: NonNegInt.optional().describe('Net lines added by all applied edits'),
+    linesRemoved: NonNegInt.optional().describe('Net lines removed by all applied edits'),
+    diff: z.string().optional().describe('Unified diff of all changes (present only in dryRun mode)'),
+    unmatchedEdits: z
+        .array(z.string())
+        .optional()
+        .describe('oldText values that did not match any content in the file'),
+    lineRange: z
+        .tuple([PositiveInt, PositiveInt])
+        .optional()
+        .describe('Line range [firstLine, lastLine] covering all applied edits'),
+});
+const EditPerPathSchema = z.strictObject({
+    path: z.string().describe('Requested file path'),
+    value: PerFileResultSchema.optional().describe('Edit result; present on success'),
+    error: PerFileErrorSchema.optional().describe('Error details; present on failure'),
+});
+const EditFileOutputSchema = z.strictObject({
+    results: z
+        .array(EditPerPathSchema)
+        .describe('Per-path edit results ordered to match the input paths'),
+    summary: OperationSummarySchema,
+});
+async function computeDiffStats(original, modified) {
+    return new Promise((resolve) => {
+        // Yield to the event loop so we don't completely block
+        setImmediate(() => {
+            diffLines(original, modified, {
+                callback: (changes) => {
+                    let linesAdded = 0;
+                    let linesRemoved = 0;
+                    for (const part of changes) {
+                        if (part.added)
+                            linesAdded += part.count;
+                        else if (part.removed)
+                            linesRemoved += part.count;
+                    }
+                    resolve({ linesAdded, linesRemoved });
+                },
+            });
+        });
+    });
+}
+function findEditMatch(content, oldText, ignoreWhitespace, regexCache) {
+    if (ignoreWhitespace) {
+        // Make whitespace flexible (tolerate indentation/spacing differences)
+        // without letting it cross line boundaries: a whitespace run that contains
+        // a newline keeps at least one newline, so a single-line oldText cannot
+        // match across a newline and a multi-line oldText cannot collapse onto one
+        // line. Horizontal whitespace stays mandatory between word characters so
+        // adjacent identifiers are not merged.
+        const pattern = escapeRegexLiteral(oldText)
+            .replace(/[^\S\n]*\n\s*/g, '[^\\S\\n]*\\n+[^\\S\\n]*')
+            .replace(/(\w)[^\S\n]+(\w)/g, '$1[^\\S\\n]+$2')
+            .replace(/[^\S\n]+/g, '[^\\S\\n]*');
+        let regex = regexCache?.get(pattern);
+        if (!regex) {
+            regex = compileRegex(pattern, { caseSensitive: true });
+            regexCache?.set(pattern, regex);
+        }
+        // The compiled regex is global and may come from the cache, so lastIndex
+        // still points past the previous edit's match — reset before searching.
+        regex.lastIndex = 0;
+        const match = regex.exec(content);
+        if (match === null)
+            return undefined;
+        // RE2ExecArray types group 0 as optional. A successful match always has it;
+        // an empty one would name a zero-length span, which cannot be replaced.
+        const matched = match[0];
+        if (matched === undefined || matched.length === 0)
+            return undefined;
+        return {
+            startIndex: match.index,
+            length: matched.length,
+        };
+    }
+    const index = content.indexOf(oldText);
+    if (index === -1) {
+        return undefined;
+    }
+    return {
+        startIndex: index,
+        length: oldText.length,
+    };
+}
+function replaceEditMatch(content, match, newText) {
+    return (content.slice(0, match.startIndex) + newText + content.slice(match.startIndex + match.length));
+}
+/**
+ * Compute the 1-indexed line range of changed lines in `modified` relative to
+ * `original`, using a common-prefix/suffix line scan. This is a conservative
+ * bound (it widens to cover independent changes between matching bookends), but
+ * it is computed against the FINAL content so it is not skewed by earlier edits
+ * inserting or removing lines — which the per-edit merge could not account for.
+ */
+function computeChangedLineRange(original, modified) {
+    const origLines = original.split('\n');
+    const modLines = modified.split('\n');
+    const minLen = Math.min(origLines.length, modLines.length);
+    let firstChanged = -1;
+    for (let i = 0; i < minLen; i++) {
+        if (origLines[i] !== modLines[i]) {
+            firstChanged = i;
+            break;
+        }
+    }
+    if (firstChanged === -1 && origLines.length === modLines.length)
+        return undefined;
+    if (firstChanged === -1)
+        firstChanged = minLen; // pure append/trim at the tail
+    let lastChangedMod = modLines.length - 1;
+    let lastChangedOrig = origLines.length - 1;
+    while (lastChangedMod > firstChanged &&
+        lastChangedOrig >= 0 &&
+        modLines[lastChangedMod] === origLines[lastChangedOrig]) {
+        lastChangedMod--;
+        lastChangedOrig--;
+    }
+    // When the modified content is a strict prefix of the original (a tail trim on
+    // a file with no final newline), the loop above never runs and lastChangedMod
+    // lands one below firstChanged. Clamp so the range is never inverted.
+    return [firstChanged + 1, Math.max(firstChanged, lastChangedMod) + 1];
+}
+function buildEditFileValue(validPath, meta, modified, result) {
+    return {
+        path: validPath,
+        size: meta.bytesWritten,
+        lineCount: meta.lineCount,
+        mimeType: meta.mimeType,
+        kind: meta.kind,
+        ...(meta.resourceUri !== undefined ? { resourceUri: meta.resourceUri } : {}),
+        modified,
+        appliedEdits: result.appliedEdits,
+        ...(result.appliedEdits > 0
+            ? { linesAdded: result.linesAdded, linesRemoved: result.linesRemoved }
+            : {}),
+        ...(result.unmatchedEdits.length > 0 ? { unmatchedEdits: result.unmatchedEdits } : {}),
+        ...(result.diff ? { diff: result.diff } : {}),
+        ...(result.lineRange ? { lineRange: result.lineRange } : {}),
+    };
+}
+async function finalizeEditResult(originalContent, updatedContent, appliedEdits, unmatchedEdits, lineRange) {
+    const { linesAdded, linesRemoved } = appliedEdits > 0
+        ? await computeDiffStats(originalContent, updatedContent)
+        : { linesAdded: 0, linesRemoved: 0 };
+    return {
+        content: updatedContent,
+        appliedEdits,
+        unmatchedEdits,
+        linesAdded,
+        linesRemoved,
+        ...(lineRange ? { lineRange } : {}),
+    };
+}
+function buildEditFileMetadata(content, validPath, appliedEdits, resourceStore) {
+    const bytesWritten = Buffer.byteLength(content, 'utf-8');
+    const lineCount = countLines(content);
+    const mimeInfo = detectMimeFromContent(validPath, content);
+    // Omitted rather than empty-stringed when nothing matched: `""` satisfied the
+    // schema's `string` and then failed every resources/read a client tried it on.
+    const resourceUri = appliedEdits > 0 ? buildFileResourceUri(validPath) : undefined;
+    const resourceLink = appliedEdits > 0 && resourceStore
+        ? buildFileResourceLink(validPath, mimeInfo.mimeType, bytesWritten)
+        : undefined;
+    return {
+        bytesWritten,
+        lineCount,
+        mimeType: mimeInfo.mimeType,
+        kind: mimeInfo.kind,
+        resourceUri,
+        resourceLink,
+    };
+}
+async function applyEdits(content, edits, ignoreWhitespace) {
+    let newContent = content;
+    let appliedEdits = 0;
+    const unmatchedEdits = [];
+    const regexCache = ignoreWhitespace ? new Map() : undefined;
+    try {
+        for (const edit of edits) {
+            const match = findEditMatch(newContent, edit.oldText, ignoreWhitespace, regexCache);
+            if (!match) {
+                unmatchedEdits.push(edit.oldText);
+                continue;
+            }
+            newContent = replaceEditMatch(newContent, match, edit.newText);
+            appliedEdits += 1;
+        }
+    }
+    finally {
+        // Every cached pattern owns wasm memory re2-wasm never reclaims on its own,
+        // and the cache does not outlive this call.
+        for (const cached of regexCache?.values() ?? [])
+            freeRegex(cached);
+        regexCache?.clear();
+    }
+    // Compute the line range against the final content so earlier edits whose
+    // lines were shifted by later edits are still covered.
+    const lineRange = appliedEdits > 0 ? computeChangedLineRange(content, newContent) : undefined;
+    return finalizeEditResult(content, newContent, appliedEdits, unmatchedEdits, lineRange);
+}
+async function handleEditFile(filePath, edits, options, ctx) {
+    const { validPath, content } = await ctx.fs.readEditableText(filePath, {
+        signal: ctx.signal,
+    });
+    const editResult = await applyEdits(content, edits, options.ignoreWhitespace);
+    if (options.dryRun) {
+        if (editResult.appliedEdits > 0) {
+            const label = basename(validPath);
+            editResult.diff = await new Promise((resolve) => {
+                createTwoFilesPatch(label, label, content, editResult.content, 'Original', 'Modified', {
+                    callback: (res) => {
+                        resolve(res ?? '');
+                    },
+                });
+            });
+        }
+        // Nothing was written, so there is no updated content to point a
+        // resourceUri or a resource_link at — the file on disk is still the one the
+        // caller already has. Same rule the appliedEdits-is-0 case follows: no
+        // write, no link.
+        const meta = buildEditFileMetadata(editResult.content, validPath, 0, ctx.resourceStore);
+        return {
+            file: buildEditFileValue(validPath, meta, new Date().toISOString(), editResult),
+            ...(meta.resourceLink ? { resourceLink: meta.resourceLink } : {}),
+        };
+    }
+    if (editResult.unmatchedEdits.length > 0) {
+        throw new FsError(ErrorCode.INVALID_INPUT, `${editResult.unmatchedEdits.length} edit(s) failed to match. Verify oldText matches exact file content.`, filePath);
+    }
+    if (editResult.appliedEdits > 0) {
+        await ctx.fs.writeFile(filePath, editResult.content, {
+            encoding: 'utf-8',
+            signal: ctx.signal,
+        });
+        ctx.log?.('info', `edit: ${filePath} (${editResult.appliedEdits} edits, +${editResult.linesAdded}/-${editResult.linesRemoved})`, 'edit');
+    }
+    // `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 below come from
+    // this edit's atomic write. The file content itself is always consistent.
+    const { stats: fileStats } = await ctx.fs.stat(filePath, { signal: ctx.signal });
+    const meta = buildEditFileMetadata(editResult.content, validPath, editResult.appliedEdits, ctx.resourceStore);
+    return {
+        file: buildEditFileValue(validPath, meta, fileStats.mtime.toISOString(), editResult),
+        ...(meta.resourceLink ? { resourceLink: meta.resourceLink } : {}),
+    };
+}
+function formatEditSummary(results, dryRun) {
+    const tag = dryRun ? ' [dry run]' : '';
+    // Single-file failure: say why here rather than making the caller read
+    // structuredContent for the one message that can apply.
+    const [only] = results;
+    if (results.length === 1 && only?.error) {
+        return `edit: ${only.path} FAILED — ${only.error.message}${tag}`;
+    }
+    const tokens = results.map((r) => {
+        if (r.error)
+            return `${basename(r.path)} FAILED`;
+        const v = r.value;
+        if (!v)
+            return `${basename(r.path)} (no result)`;
+        if (v.unmatchedEdits && v.unmatchedEdits.length > 0)
+            return `${basename(v.path)} NO MATCH`;
+        const added = v.linesAdded ?? 0;
+        const removed = v.linesRemoved ?? 0;
+        if (added === 0 && removed === 0)
+            return `${basename(v.path)} (no change)`;
+        return `${basename(v.path)} +${String(added)} -${String(removed)}`;
+    });
+    const failed = results.filter((r) => r.error !== undefined).length;
+    const ok = results.length - failed;
+    const ratio = failed > 0 ? ` (${String(ok)}/${String(results.length)} ok)` : '';
+    return `edit: ${tokens.join(' · ')}${ratio}${tag}`;
+}
+export const EDIT = defineTool({
+    name: 'edit',
+    title: 'Edit Files',
+    description: 'Apply sequential literal string replacements to one or more files (max 5 files per call). ' +
+        'Modes: single-file { path, edits } or per-file { files: [{ path, edits }] }. ' +
+        'oldText must match file content exactly; include 3-5 lines of surrounding context to ensure uniqueness. ' +
+        'Set dryRun=true to preview diffs without writing. ' +
+        'For glob-based bulk regex replacement across many files, use replace_text instead.',
+    input: EditFileInputSchema,
+    output: EditFileOutputSchema,
+    // Same per-path union as read, plus diff, which is present only under dryRun.
+    publishOutputSchema: true,
+    annotations: {
+        readOnlyHint: false,
+        idempotentHint: false,
+        destructiveHint: true,
+        openWorldHint: false,
+    },
+    progress: (args) => {
+        const dryLabel = args.dryRun ? ' [dry run]' : '';
+        let subject;
+        if (args.path !== undefined) {
+            subject = basename(args.path);
+        }
+        else if (args.files !== undefined) {
+            subject = `${args.files.length} files`;
+        }
+        else {
+            subject = 'files';
+        }
+        return { label: `Edit${dryLabel}`, subject };
+    },
+    accessPaths: singleOrBatchAccessPaths,
+    run: async (args, ctx) => {
+        const sharedEdits = args.edits ?? [];
+        const batchInput = args.path !== undefined ? { path: args.path } : { files: args.files ?? [] };
+        const options = {
+            dryRun: args.dryRun,
+            ignoreWhitespace: args.ignoreWhitespace,
+        };
+        const batch = await runOverPaths(batchInput, ctx, ({ path, override }) => handleEditFile(path, override?.edits ?? sharedEdits, options, ctx), { defaultErrorCode: ErrorCode.UNKNOWN });
+        const perPathResults = [];
+        const resourceLinks = [];
+        for (const r of batch.results) {
+            if ('error' in r) {
+                perPathResults.push({ path: r.path, error: r.error });
+                continue;
+            }
+            perPathResults.push({ path: r.path, value: r.value.file });
+            if (r.value.resourceLink)
+                resourceLinks.push(r.value.resourceLink);
+        }
+        const summaryText = formatEditSummary(perPathResults, args.dryRun);
+        return {
+            structured: {
+                results: perPathResults,
+                summary: batch.summary,
+            },
+            text: summaryText,
+            ...(resourceLinks.length > 0 ? { resources: resourceLinks } : {}),
+        };
+    },
+});
+//# sourceMappingURL=edit.js.map

package/dist/tools/edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.js","sourceRoot":"","sources":["../../src/tools/edit.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 { createTwoFilesPatch, diffLines } 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 { escapeRegexLiteral } from '../core/primitives.js';\nimport { countLines } from '../core/read.js';\nimport {\n  defaultFalseBoolean,\n  FileKind,\n  isBlank,\n  IsoDateTime,\n  NonNegInt,\n  OperationSummarySchema,\n  PerFileErrorSchema,\n  PositiveInt,\n  RequiredPath,\n  singleOrBatchAccessPaths,\n} from '../core/schema.js';\nimport type { Regex } from '../core/search.js';\nimport { compileRegex, freeRegex } from '../core/search.js';\nimport type { ResourceStore } from '../core/store.js';\nimport { runOverPaths } from './batch.js';\nimport { defineTool, type ToolCtx } from './define.js';\n\nconst EditSpecSchema = z\n  .strictObject({\n    oldText: z\n      .string()\n      .min(1, 'oldText required')\n      .refine((val) => !isBlank(val), {\n        message: 'oldText cannot be empty or whitespace-only',\n      })\n      .describe(\n        'Exact literal text to locate in the file. Must include 3-5 lines of context to ensure uniqueness and avoid matching the wrong block.',\n      )\n      .meta({ examples: ['const x = 1;', 'function oldName('] }),\n    newText: z\n      .string()\n      .describe('Replacement text. Use an empty string to delete the matched oldText.')\n      .meta({ examples: ['const x = 2;', 'function newName(', ''] }),\n  })\n  // The one document in this server where a `$ref` pays: this subschema is used\n  // at both `edits` and `files[].edits`, so an `id` hoists it into `$defs` once\n  // instead of inlining ~1.3 kB twice. Shared schemas used once per document\n  // deliberately carry no `id` — there a `$ref` costs more than it saves.\n  .meta({ id: 'EditSpec' });\n\nconst MAX_MULTI_FILES = 5;\nconst MAX_EDITS_PER_FILE = 100;\n\nconst EditFileInputSchema = z\n  .strictObject({\n    path: RequiredPath.optional().describe('Single file path; mutually exclusive with files'),\n    edits: z\n      .array(EditSpecSchema)\n      .min(1)\n      .max(MAX_EDITS_PER_FILE)\n      .optional()\n      .describe('Replacements applied to path; not allowed when using files'),\n    files: z\n      .array(\n        z.strictObject({\n          path: RequiredPath,\n          edits: z\n            .array(EditSpecSchema)\n            .min(1)\n            .max(MAX_EDITS_PER_FILE)\n            .describe('Replacements to apply to this specific file'),\n        }),\n      )\n      .min(1)\n      .max(MAX_MULTI_FILES)\n      .optional()\n      .describe('Per-file entries (batch mode)'),\n    dryRun: defaultFalseBoolean(\n      'Preview diffs without writing to disk (default: false = apply edits)',\n    ),\n    ignoreWhitespace: defaultFalseBoolean(\n      'Ignore leading/trailing whitespace differences when matching oldText',\n    ),\n  })\n  .superRefine((value, ctx) => {\n    const hasPath = value.path !== undefined;\n    const hasFiles = value.files !== undefined;\n    if (hasPath === hasFiles) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['path'],\n        message: \"Provide exactly one of 'path' or 'files'\",\n        input: value,\n      });\n    }\n    if (hasPath && value.edits === undefined) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['edits'],\n        message: \"'edits' required when using 'path'\",\n        input: value,\n      });\n    }\n    if (hasFiles && value.edits !== undefined) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['edits'],\n        message: \"'edits' not allowed with 'files'; each file carries its own edits\",\n        input: value,\n      });\n    }\n  })\n  // Mirror the superRefine on the wire: exactly one input mode, and single-file\n  // mode carries its own `edits`. Without `edits` in the first branch, `{ path }`\n  // alone validated against the published schema and was then rejected at\n  // runtime — the model had no way to see that coming.\n  .meta({ oneOf: [{ required: ['path', 'edits'] }, { required: ['files'] }] });\n\nconst PerFileResultSchema = z.strictObject({\n  path: z.string().describe('Resolved absolute path of the edited file'),\n  size: NonNegInt.describe('File size in bytes after edits'),\n  lineCount: NonNegInt.describe('Number of lines in the file after edits'),\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 updated file content; omitted when no edit matched (appliedEdits is 0) and the file was left untouched',\n    ),\n  modified: IsoDateTime.describe('Last modification timestamp after edits (ISO 8601 UTC)'),\n  appliedEdits: NonNegInt.describe('Number of edits successfully applied'),\n  linesAdded: NonNegInt.optional().describe('Net lines added by all applied edits'),\n  linesRemoved: NonNegInt.optional().describe('Net lines removed by all applied edits'),\n  diff: z.string().optional().describe('Unified diff of all changes (present only in dryRun mode)'),\n  unmatchedEdits: z\n    .array(z.string())\n    .optional()\n    .describe('oldText values that did not match any content in the file'),\n  lineRange: z\n    .tuple([PositiveInt, PositiveInt])\n    .optional()\n    .describe('Line range [firstLine, lastLine] covering all applied edits'),\n});\n\nconst EditPerPathSchema = z.strictObject({\n  path: z.string().describe('Requested file path'),\n  value: PerFileResultSchema.optional().describe('Edit result; present on success'),\n  error: PerFileErrorSchema.optional().describe('Error details; present on failure'),\n});\n\nconst EditFileOutputSchema = z.strictObject({\n  results: z\n    .array(EditPerPathSchema)\n    .describe('Per-path edit results ordered to match the input paths'),\n  summary: OperationSummarySchema,\n});\n\ntype EditFileValue = z.infer<typeof PerFileResultSchema>;\n\ninterface TextRange {\n  startIndex: number;\n  length: number;\n}\n\ninterface EditResult {\n  content: string;\n  appliedEdits: number;\n  unmatchedEdits: string[];\n  linesAdded: number;\n  linesRemoved: number;\n  diff?: string;\n  lineRange?: [number, number];\n}\n\nasync function computeDiffStats(\n  original: string,\n  modified: string,\n): Promise<{ linesAdded: number; linesRemoved: number }> {\n  return new Promise((resolve) => {\n    // Yield to the event loop so we don't completely block\n    setImmediate(() => {\n      diffLines(original, modified, {\n        callback: (changes) => {\n          let linesAdded = 0;\n          let linesRemoved = 0;\n          for (const part of changes) {\n            if (part.added) linesAdded += part.count;\n            else if (part.removed) linesRemoved += part.count;\n          }\n          resolve({ linesAdded, linesRemoved });\n        },\n      });\n    });\n  });\n}\n\nfunction findEditMatch(\n  content: string,\n  oldText: string,\n  ignoreWhitespace: boolean,\n  regexCache?: Map<string, Regex>,\n): TextRange | undefined {\n  if (ignoreWhitespace) {\n    // Make whitespace flexible (tolerate indentation/spacing differences)\n    // without letting it cross line boundaries: a whitespace run that contains\n    // a newline keeps at least one newline, so a single-line oldText cannot\n    // match across a newline and a multi-line oldText cannot collapse onto one\n    // line. Horizontal whitespace stays mandatory between word characters so\n    // adjacent identifiers are not merged.\n    const pattern = escapeRegexLiteral(oldText)\n      .replace(/[^\\S\\n]*\\n\\s*/g, '[^\\\\S\\\\n]*\\\\n+[^\\\\S\\\\n]*')\n      .replace(/(\\w)[^\\S\\n]+(\\w)/g, '$1[^\\\\S\\\\n]+$2')\n      .replace(/[^\\S\\n]+/g, '[^\\\\S\\\\n]*');\n    let regex = regexCache?.get(pattern);\n    if (!regex) {\n      regex = compileRegex(pattern, { caseSensitive: true });\n      regexCache?.set(pattern, regex);\n    }\n    // The compiled regex is global and may come from the cache, so lastIndex\n    // still points past the previous edit's match — reset before searching.\n    regex.lastIndex = 0;\n    const match = regex.exec(content);\n\n    if (match === null) return undefined;\n    // RE2ExecArray types group 0 as optional. A successful match always has it;\n    // an empty one would name a zero-length span, which cannot be replaced.\n    const matched = match[0];\n    if (matched === undefined || matched.length === 0) return undefined;\n\n    return {\n      startIndex: match.index,\n      length: matched.length,\n    };\n  }\n\n  const index = content.indexOf(oldText);\n  if (index === -1) {\n    return undefined;\n  }\n\n  return {\n    startIndex: index,\n    length: oldText.length,\n  };\n}\n\nfunction replaceEditMatch(content: string, match: TextRange, newText: string): string {\n  return (\n    content.slice(0, match.startIndex) + newText + content.slice(match.startIndex + match.length)\n  );\n}\n\n/**\n * Compute the 1-indexed line range of changed lines in `modified` relative to\n * `original`, using a common-prefix/suffix line scan. This is a conservative\n * bound (it widens to cover independent changes between matching bookends), but\n * it is computed against the FINAL content so it is not skewed by earlier edits\n * inserting or removing lines — which the per-edit merge could not account for.\n */\nfunction computeChangedLineRange(original: string, modified: string): [number, number] | undefined {\n  const origLines = original.split('\\n');\n  const modLines = modified.split('\\n');\n  const minLen = Math.min(origLines.length, modLines.length);\n\n  let firstChanged = -1;\n  for (let i = 0; i < minLen; i++) {\n    if (origLines[i] !== modLines[i]) {\n      firstChanged = i;\n      break;\n    }\n  }\n  if (firstChanged === -1 && origLines.length === modLines.length) return undefined;\n  if (firstChanged === -1) firstChanged = minLen; // pure append/trim at the tail\n\n  let lastChangedMod = modLines.length - 1;\n  let lastChangedOrig = origLines.length - 1;\n  while (\n    lastChangedMod > firstChanged &&\n    lastChangedOrig >= 0 &&\n    modLines[lastChangedMod] === origLines[lastChangedOrig]\n  ) {\n    lastChangedMod--;\n    lastChangedOrig--;\n  }\n\n  // When the modified content is a strict prefix of the original (a tail trim on\n  // a file with no final newline), the loop above never runs and lastChangedMod\n  // lands one below firstChanged. Clamp so the range is never inverted.\n  return [firstChanged + 1, Math.max(firstChanged, lastChangedMod) + 1];\n}\n\nfunction buildEditFileValue(\n  validPath: string,\n  meta: EditFileMetadata,\n  modified: string,\n  result: EditResult,\n): EditFileValue {\n  return {\n    path: validPath,\n    size: meta.bytesWritten,\n    lineCount: meta.lineCount,\n    mimeType: meta.mimeType,\n    kind: meta.kind,\n    ...(meta.resourceUri !== undefined ? { resourceUri: meta.resourceUri } : {}),\n    modified,\n    appliedEdits: result.appliedEdits,\n    ...(result.appliedEdits > 0\n      ? { linesAdded: result.linesAdded, linesRemoved: result.linesRemoved }\n      : {}),\n    ...(result.unmatchedEdits.length > 0 ? { unmatchedEdits: result.unmatchedEdits } : {}),\n    ...(result.diff ? { diff: result.diff } : {}),\n    ...(result.lineRange ? { lineRange: result.lineRange } : {}),\n  };\n}\n\nasync function finalizeEditResult(\n  originalContent: string,\n  updatedContent: string,\n  appliedEdits: number,\n  unmatchedEdits: string[],\n  lineRange: EditResult['lineRange'],\n): Promise<EditResult> {\n  const { linesAdded, linesRemoved } =\n    appliedEdits > 0\n      ? await computeDiffStats(originalContent, updatedContent)\n      : { linesAdded: 0, linesRemoved: 0 };\n\n  return {\n    content: updatedContent,\n    appliedEdits,\n    unmatchedEdits,\n    linesAdded,\n    linesRemoved,\n    ...(lineRange ? { lineRange } : {}),\n  };\n}\n\ninterface EditFileMetadata {\n  bytesWritten: number;\n  lineCount: number;\n  mimeType: string;\n  kind: FileKind;\n  /** Undefined when no edit matched: there is no updated content to point at. */\n  resourceUri: string | undefined;\n  resourceLink: ContentBlock | undefined;\n}\n\nfunction buildEditFileMetadata(\n  content: string,\n  validPath: string,\n  appliedEdits: number,\n  resourceStore: ResourceStore | undefined,\n): EditFileMetadata {\n  const bytesWritten = Buffer.byteLength(content, 'utf-8');\n  const lineCount = countLines(content);\n  const mimeInfo = detectMimeFromContent(validPath, content);\n  // Omitted rather than empty-stringed when nothing matched: `\"\"` satisfied the\n  // schema's `string` and then failed every resources/read a client tried it on.\n  const resourceUri = appliedEdits > 0 ? buildFileResourceUri(validPath) : undefined;\n  const resourceLink =\n    appliedEdits > 0 && resourceStore\n      ? buildFileResourceLink(validPath, mimeInfo.mimeType, bytesWritten)\n      : undefined;\n  return {\n    bytesWritten,\n    lineCount,\n    mimeType: mimeInfo.mimeType,\n    kind: mimeInfo.kind,\n    resourceUri,\n    resourceLink,\n  };\n}\n\nasync function applyEdits(\n  content: string,\n  edits: z.infer<typeof EditSpecSchema>[],\n  ignoreWhitespace: boolean,\n): Promise<EditResult> {\n  let newContent = content;\n  let appliedEdits = 0;\n  const unmatchedEdits: string[] = [];\n  const regexCache = ignoreWhitespace ? new Map<string, Regex>() : undefined;\n\n  try {\n    for (const edit of edits) {\n      const match = findEditMatch(newContent, edit.oldText, ignoreWhitespace, regexCache);\n\n      if (!match) {\n        unmatchedEdits.push(edit.oldText);\n        continue;\n      }\n\n      newContent = replaceEditMatch(newContent, match, edit.newText);\n      appliedEdits += 1;\n    }\n  } finally {\n    // Every cached pattern owns wasm memory re2-wasm never reclaims on its own,\n    // and the cache does not outlive this call.\n    for (const cached of regexCache?.values() ?? []) freeRegex(cached);\n    regexCache?.clear();\n  }\n\n  // Compute the line range against the final content so earlier edits whose\n  // lines were shifted by later edits are still covered.\n  const lineRange = appliedEdits > 0 ? computeChangedLineRange(content, newContent) : undefined;\n\n  return finalizeEditResult(content, newContent, appliedEdits, unmatchedEdits, lineRange);\n}\n\ninterface EditFileOptions {\n  dryRun: boolean;\n  ignoreWhitespace: boolean;\n}\n\nasync function handleEditFile(\n  filePath: string,\n  edits: z.infer<typeof EditSpecSchema>[],\n  options: EditFileOptions,\n  ctx: ToolCtx,\n): Promise<{ file: EditFileValue; resourceLink?: ContentBlock }> {\n  const { validPath, content } = await ctx.fs.readEditableText(filePath, {\n    signal: ctx.signal,\n  });\n  const editResult = await applyEdits(content, edits, options.ignoreWhitespace);\n\n  if (options.dryRun) {\n    if (editResult.appliedEdits > 0) {\n      const label = basename(validPath);\n      editResult.diff = await new Promise<string>((resolve) => {\n        createTwoFilesPatch(label, label, content, editResult.content, 'Original', 'Modified', {\n          callback: (res: string | undefined) => {\n            resolve(res ?? '');\n          },\n        });\n      });\n    }\n\n    // Nothing was written, so there is no updated content to point a\n    // resourceUri or a resource_link at — the file on disk is still the one the\n    // caller already has. Same rule the appliedEdits-is-0 case follows: no\n    // write, no link.\n    const meta = buildEditFileMetadata(editResult.content, validPath, 0, ctx.resourceStore);\n    return {\n      file: buildEditFileValue(validPath, meta, new Date().toISOString(), editResult),\n      ...(meta.resourceLink ? { resourceLink: meta.resourceLink } : {}),\n    };\n  }\n\n  if (editResult.unmatchedEdits.length > 0) {\n    throw new FsError(\n      ErrorCode.INVALID_INPUT,\n      `${editResult.unmatchedEdits.length} edit(s) failed to match. Verify oldText matches exact file content.`,\n      filePath,\n    );\n  }\n\n  if (editResult.appliedEdits > 0) {\n    await ctx.fs.writeFile(filePath, editResult.content, {\n      encoding: 'utf-8',\n      signal: ctx.signal,\n    });\n    ctx.log?.(\n      'info',\n      `edit: ${filePath} (${editResult.appliedEdits} edits, +${editResult.linesAdded}/-${editResult.linesRemoved})`,\n      'edit',\n    );\n  }\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 below come from\n  // this edit's atomic write. The file content itself is always consistent.\n  const { stats: fileStats } = await ctx.fs.stat(filePath, { signal: ctx.signal });\n  const meta = buildEditFileMetadata(\n    editResult.content,\n    validPath,\n    editResult.appliedEdits,\n    ctx.resourceStore,\n  );\n  return {\n    file: buildEditFileValue(validPath, meta, fileStats.mtime.toISOString(), editResult),\n    ...(meta.resourceLink ? { resourceLink: meta.resourceLink } : {}),\n  };\n}\n\nfunction formatEditSummary(\n  results: readonly z.infer<typeof EditPerPathSchema>[],\n  dryRun: boolean,\n): string {\n  const tag = dryRun ? ' [dry run]' : '';\n  // Single-file failure: say why here rather than making the caller read\n  // structuredContent for the one message that can apply.\n  const [only] = results;\n  if (results.length === 1 && only?.error) {\n    return `edit: ${only.path} FAILED — ${only.error.message}${tag}`;\n  }\n  const tokens = results.map((r) => {\n    if (r.error) return `${basename(r.path)} FAILED`;\n    const v = r.value;\n    if (!v) return `${basename(r.path)} (no result)`;\n    if (v.unmatchedEdits && v.unmatchedEdits.length > 0) return `${basename(v.path)} NO MATCH`;\n    const added = v.linesAdded ?? 0;\n    const removed = v.linesRemoved ?? 0;\n    if (added === 0 && removed === 0) return `${basename(v.path)} (no change)`;\n    return `${basename(v.path)} +${String(added)} -${String(removed)}`;\n  });\n\n  const failed = results.filter((r) => r.error !== undefined).length;\n  const ok = results.length - failed;\n  const ratio = failed > 0 ? ` (${String(ok)}/${String(results.length)} ok)` : '';\n  return `edit: ${tokens.join(' · ')}${ratio}${tag}`;\n}\n\nexport const EDIT = defineTool({\n  name: 'edit',\n  title: 'Edit Files',\n  description:\n    'Apply sequential literal string replacements to one or more files (max 5 files per call). ' +\n    'Modes: single-file { path, edits } or per-file { files: [{ path, edits }] }. ' +\n    'oldText must match file content exactly; include 3-5 lines of surrounding context to ensure uniqueness. ' +\n    'Set dryRun=true to preview diffs without writing. ' +\n    'For glob-based bulk regex replacement across many files, use replace_text instead.',\n  input: EditFileInputSchema,\n  output: EditFileOutputSchema,\n  // Same per-path union as read, plus diff, which is present only under dryRun.\n  publishOutputSchema: true,\n  annotations: {\n    readOnlyHint: false,\n    idempotentHint: false,\n    destructiveHint: true,\n    openWorldHint: false,\n  },\n  progress: (args) => {\n    const dryLabel = args.dryRun ? ' [dry run]' : '';\n    let subject: string;\n    if (args.path !== undefined) {\n      subject = basename(args.path);\n    } else if (args.files !== undefined) {\n      subject = `${args.files.length} files`;\n    } else {\n      subject = 'files';\n    }\n    return { label: `Edit${dryLabel}`, subject };\n  },\n  accessPaths: singleOrBatchAccessPaths,\n  run: async (args, ctx) => {\n    const sharedEdits = args.edits ?? [];\n    const batchInput = args.path !== undefined ? { path: args.path } : { files: args.files ?? [] };\n\n    const options: EditFileOptions = {\n      dryRun: args.dryRun,\n      ignoreWhitespace: args.ignoreWhitespace,\n    };\n\n    const batch = await runOverPaths<\n      { edits: z.infer<typeof EditSpecSchema>[] },\n      { file: EditFileValue; resourceLink?: ContentBlock }\n    >(\n      batchInput,\n      ctx,\n      ({ path, override }) => handleEditFile(path, override?.edits ?? sharedEdits, options, ctx),\n      { defaultErrorCode: ErrorCode.UNKNOWN },\n    );\n\n    const perPathResults: z.infer<typeof EditPerPathSchema>[] = [];\n    const resourceLinks: ContentBlock[] = [];\n    for (const r of batch.results) {\n      if ('error' in r) {\n        perPathResults.push({ path: r.path, error: r.error });\n        continue;\n      }\n      perPathResults.push({ path: r.path, value: r.value.file });\n      if (r.value.resourceLink) resourceLinks.push(r.value.resourceLink);\n    }\n\n    const summaryText = formatEditSummary(perPathResults, args.dryRun);\n\n    return {\n      structured: {\n        results: perPathResults,\n        summary: batch.summary,\n      },\n      text: summaryText,\n      ...(resourceLinks.length > 0 ? { resources: resourceLinks } : {}),\n    };\n  },\n});\n"]}

package/dist/tools/index.d.ts

@@ -0,0 +1,26 @@
+import type { McpServer } from '@modelcontextprotocol/server';
+import type { PageSnapshotStore } from '../core/page-store.js';
+import type { PathGuard } from '../core/path.js';
+import type { ResourceStore } from '../core/store.js';
+import type { DefinedTool } from './define.js';
+import { LIST } from './list.js';
+import { READ_FILE } from './read.js';
+import { LIST_ALLOWED_DIRECTORIES } from './roots.js';
+import { SEARCH_CONTENT } from './search-content.js';
+import { SEARCH_FILES } from './search-files.js';
+import { GET_FILE_INFO } from './stat.js';
+export declare const ALL_TOOLS: readonly [DefinedTool, DefinedTool, DefinedTool, DefinedTool, DefinedTool, DefinedTool, DefinedTool, DefinedTool, DefinedTool, DefinedTool, DefinedTool, DefinedTool, DefinedTool];
+export declare const MUTATING_TOOL_NAMES: Set<string>;
+export declare const ALL_REGISTERED_TOOL_NAMES: readonly string[];
+/** The tools a server registers at this setting — the one owner of the `--read-only` gate. */
+export declare function registeredTools(readOnly: boolean): readonly DefinedTool[];
+export { LIST, LIST_ALLOWED_DIRECTORIES, READ_FILE, SEARCH_CONTENT, SEARCH_FILES, GET_FILE_INFO };
+interface ToolRegistrarDeps {
+    readonly server: McpServer;
+    readonly pathGuard: PathGuard;
+    readonly pageStore: PageSnapshotStore;
+    readonly resourceStore: ResourceStore;
+    readonly readOnly?: boolean;
+}
+export declare function registerTools(deps: ToolRegistrarDeps): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,eAAO,MAAM,SAAS,oLAcZ,CAAC;AAEX,eAAO,MAAM,mBAAmB,aAE/B,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAAiC,CAAC;AAEzF,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,WAAW,EAAE,CAEzE;AAOD,OAAO,EAAE,IAAI,EAAE,wBAAwB,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC;AAElG,UAAU,iBAAiB;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAU3D"}

package/dist/tools/index.js

@@ -0,0 +1,52 @@
+import { CREATE } from './create.js';
+import { DELETE_FILE } from './delete-file.js';
+import { DIFF } from './diff.js';
+import { EDIT } from './edit.js';
+import { LIST } from './list.js';
+import { MOVE } from './move.js';
+import { PATCH } from './patch.js';
+import { READ_FILE } from './read.js';
+import { SEARCH_AND_REPLACE } from './replace-in-files.js';
+import { LIST_ALLOWED_DIRECTORIES } from './roots.js';
+import { SEARCH_CONTENT } from './search-content.js';
+import { SEARCH_FILES } from './search-files.js';
+import { GET_FILE_INFO } from './stat.js';
+export const ALL_TOOLS = [
+    CREATE,
+    DELETE_FILE,
+    DIFF,
+    EDIT,
+    LIST,
+    MOVE,
+    PATCH,
+    READ_FILE,
+    SEARCH_AND_REPLACE,
+    LIST_ALLOWED_DIRECTORIES,
+    SEARCH_CONTENT,
+    SEARCH_FILES,
+    GET_FILE_INFO,
+];
+export const MUTATING_TOOL_NAMES = new Set(ALL_TOOLS.filter((t) => !t.annotations.readOnlyHint).map((t) => t.name));
+export const ALL_REGISTERED_TOOL_NAMES = ALL_TOOLS.map((t) => t.name);
+/** The tools a server registers at this setting — the one owner of the `--read-only` gate. */
+export function registeredTools(readOnly) {
+    return readOnly ? ALL_TOOLS.filter((t) => !MUTATING_TOOL_NAMES.has(t.name)) : ALL_TOOLS;
+}
+// Re-exported so documentation surfaces quote `.name` off the definition rather
+// than repeating the string. This module is the only owner of the inventory.
+// Only the read-only tools are named individually: the mutating six are no
+// longer listed by hand anywhere, so their names reach callers through
+// MUTATING_TOOL_NAMES and ALL_TOOLS instead.
+export { LIST, LIST_ALLOWED_DIRECTORIES, READ_FILE, SEARCH_CONTENT, SEARCH_FILES, GET_FILE_INFO };
+export function registerTools(deps) {
+    const toolDeps = {
+        server: deps.server,
+        pathGuard: deps.pathGuard,
+        pageStore: deps.pageStore,
+        resourceStore: deps.resourceStore,
+    };
+    for (const tool of registeredTools(deps.readOnly ?? false)) {
+        tool.register(toolDeps);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,MAAM;IACN,WAAW;IACX,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,SAAS;IACT,kBAAkB;IAClB,wBAAwB;IACxB,cAAc;IACd,YAAY;IACZ,aAAa;CACL,CAAC;AAEX,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,GAAG,CACxC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CACxE,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAsB,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAEzF,8FAA8F;AAC9F,MAAM,UAAU,eAAe,CAAC,QAAiB;IAC/C,OAAO,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1F,CAAC;AAED,gFAAgF;AAChF,6EAA6E;AAC7E,2EAA2E;AAC3E,uEAAuE;AACvE,6CAA6C;AAC7C,OAAO,EAAE,IAAI,EAAE,wBAAwB,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC;AAUlG,MAAM,UAAU,aAAa,CAAC,IAAuB;IACnD,MAAM,QAAQ,GAAG;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,aAAa,EAAE,IAAI,CAAC,aAAa;KAClC,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,eAAe,CAAC,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,EAAE,CAAC;QAC3D,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC","sourcesContent":["import type { McpServer } from '@modelcontextprotocol/server';\n\nimport type { PageSnapshotStore } from '../core/page-store.js';\nimport type { PathGuard } from '../core/path.js';\nimport type { ResourceStore } from '../core/store.js';\nimport { CREATE } from './create.js';\nimport type { DefinedTool } from './define.js';\nimport { DELETE_FILE } from './delete-file.js';\nimport { DIFF } from './diff.js';\nimport { EDIT } from './edit.js';\nimport { LIST } from './list.js';\nimport { MOVE } from './move.js';\nimport { PATCH } from './patch.js';\nimport { READ_FILE } from './read.js';\nimport { SEARCH_AND_REPLACE } from './replace-in-files.js';\nimport { LIST_ALLOWED_DIRECTORIES } from './roots.js';\nimport { SEARCH_CONTENT } from './search-content.js';\nimport { SEARCH_FILES } from './search-files.js';\nimport { GET_FILE_INFO } from './stat.js';\n\nexport const ALL_TOOLS = [\n  CREATE,\n  DELETE_FILE,\n  DIFF,\n  EDIT,\n  LIST,\n  MOVE,\n  PATCH,\n  READ_FILE,\n  SEARCH_AND_REPLACE,\n  LIST_ALLOWED_DIRECTORIES,\n  SEARCH_CONTENT,\n  SEARCH_FILES,\n  GET_FILE_INFO,\n] as const;\n\nexport const MUTATING_TOOL_NAMES = new Set(\n  ALL_TOOLS.filter((t) => !t.annotations.readOnlyHint).map((t) => t.name),\n);\n\nexport const ALL_REGISTERED_TOOL_NAMES: readonly string[] = ALL_TOOLS.map((t) => t.name);\n\n/** The tools a server registers at this setting — the one owner of the `--read-only` gate. */\nexport function registeredTools(readOnly: boolean): readonly DefinedTool[] {\n  return readOnly ? ALL_TOOLS.filter((t) => !MUTATING_TOOL_NAMES.has(t.name)) : ALL_TOOLS;\n}\n\n// Re-exported so documentation surfaces quote `.name` off the definition rather\n// than repeating the string. This module is the only owner of the inventory.\n// Only the read-only tools are named individually: the mutating six are no\n// longer listed by hand anywhere, so their names reach callers through\n// MUTATING_TOOL_NAMES and ALL_TOOLS instead.\nexport { LIST, LIST_ALLOWED_DIRECTORIES, READ_FILE, SEARCH_CONTENT, SEARCH_FILES, GET_FILE_INFO };\n\ninterface ToolRegistrarDeps {\n  readonly server: McpServer;\n  readonly pathGuard: PathGuard;\n  readonly pageStore: PageSnapshotStore;\n  readonly resourceStore: ResourceStore;\n  readonly readOnly?: boolean;\n}\n\nexport function registerTools(deps: ToolRegistrarDeps): void {\n  const toolDeps = {\n    server: deps.server,\n    pathGuard: deps.pathGuard,\n    pageStore: deps.pageStore,\n    resourceStore: deps.resourceStore,\n  };\n  for (const tool of registeredTools(deps.readOnly ?? false)) {\n    tool.register(toolDeps);\n  }\n}\n"]}

package/dist/tools/list.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/tools/list.ts"],"names":[],"mappings":"AAuWA,eAAO,MAAM,IAAI,mCAiCf,CAAC"}