@mcp-monorepo/file-browser 1.0.0

package/dist/lib/walker/ignore-file-service.js

@@ -0,0 +1,128 @@
+import { readFile } from 'node:fs/promises';
+import { platform } from 'node:os';
+import { dirname, relative } from 'node:path';
+const isWindows = platform() === 'win32';
+const toPosixPath = (p) => p.replace(/\\/g, '/');
+// This function converts a simple glob pattern to a regex.
+function globToRegex(pattern) {
+    const flags = isWindows ? 'i' : '';
+    const regexString = pattern
+        .replace(/[.+?^${}()|[\]\\]/g, '\\$&') // Escape special characters
+        .replace(/\*/g, '.*'); // `*` becomes `.*` for this simplified purpose
+    return new RegExp(`^${regexString}$`, flags);
+}
+export class IgnoreFileService {
+    rulesByDirectory = {};
+    async add(filePath) {
+        const directoryPath = dirname(filePath);
+        const fileContent = await readFile(filePath, 'utf-8');
+        this.addByContent(directoryPath, fileContent);
+    }
+    addByContent(directoryPath, fileContent) {
+        const posixDir = toPosixPath(directoryPath);
+        if (!this.rulesByDirectory[posixDir]) {
+            this.rulesByDirectory[posixDir] = [];
+        }
+        const newRules = fileContent
+            .split('\n')
+            .map((line) => line.trim())
+            .filter((line) => line && !line.startsWith('#'))
+            .map((line) => {
+            const isAllowRule = line.startsWith('!');
+            const pattern = isAllowRule ? line.slice(1) : line;
+            return {
+                originalPattern: pattern,
+                regex: globToRegex(pattern),
+                isAllowRule,
+            };
+        });
+        this.rulesByDirectory[posixDir] = this.rulesByDirectory[posixDir].concat(newRules);
+    }
+    isPathIgnored(absolutePath) {
+        const posixPath = toPosixPath(absolutePath);
+        let isIgnored = false;
+        const applicableDirs = Object.keys(this.rulesByDirectory)
+            .filter((dir) => posixPath.startsWith(dir))
+            .sort((a, b) => a.length - b.length);
+        for (const dir of applicableDirs) {
+            const relativePath = toPosixPath(relative(dir, posixPath));
+            const rules = this.rulesByDirectory[dir];
+            for (const rule of rules) {
+                let match = false;
+                // Patterns with a slash are matched relative to the .gitignore file.
+                if (rule.originalPattern.includes('/')) {
+                    const patternToCheck = rule.originalPattern.endsWith('/')
+                        ? rule.originalPattern.slice(0, -1)
+                        : rule.originalPattern;
+                    // Check if the relative path starts with or matches the pattern
+                    if (relativePath === patternToCheck || relativePath.startsWith(patternToCheck + '/')) {
+                        match = true;
+                    }
+                    else {
+                        // For patterns with wildcards, use regex matching
+                        const patternRegex = globToRegex(patternToCheck);
+                        const pathSegments = relativePath.split('/');
+                        // Check against full path and each potential subpath
+                        for (let i = 0; i < pathSegments.length; i++) {
+                            const testPath = pathSegments.slice(0, i + 1).join('/');
+                            if (patternRegex.test(testPath)) {
+                                match = true;
+                                break;
+                            }
+                        }
+                    }
+                }
+                // Patterns without a slash are matched against any path segment.
+                else {
+                    const pathSegments = relativePath.split('/');
+                    if (pathSegments.some((segment) => rule.regex.test(segment))) {
+                        match = true;
+                    }
+                }
+                if (match) {
+                    isIgnored = !rule.isAllowRule;
+                }
+            }
+        }
+        return isIgnored;
+    }
+    couldDirectoryContainAllowedFiles(absolutePath) {
+        // If the directory itself is not ignored, we must enter it.
+        if (!this.isPathIgnored(absolutePath)) {
+            return true;
+        }
+        // If it IS ignored, we only need to enter if an "allow" rule could apply to a child.
+        const posixPath = toPosixPath(absolutePath);
+        const applicableDirs = Object.keys(this.rulesByDirectory)
+            .filter((dir) => posixPath.startsWith(dir))
+            .sort((a, b) => a.length - b.length); // Process from root to nested
+        for (const dir of applicableDirs) {
+            const relativePath = toPosixPath(relative(dir, posixPath));
+            const rules = this.rulesByDirectory[dir];
+            for (const rule of rules) {
+                if (!rule.isAllowRule)
+                    continue;
+                // Check if this allow rule could apply to files within this directory
+                const pattern = rule.originalPattern;
+                // Remove leading slash if present for comparison
+                const normalizedPattern = pattern.startsWith('/') ? pattern.slice(1) : pattern;
+                const normalizedRelPath = relativePath;
+                // Check if the pattern could match something inside this directory
+                if (pattern.includes('/')) {
+                    // Pattern with slash: check if it starts with or is within our path
+                    if (normalizedPattern.startsWith(normalizedRelPath + '/') ||
+                        normalizedPattern.startsWith(normalizedRelPath) ||
+                        normalizedRelPath.startsWith(normalizedPattern.split('/')[0])) {
+                        return true;
+                    }
+                }
+                else {
+                    // Pattern without slash: could match any file in any subdirectory
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=ignore-file-service.js.map

package/dist/lib/walker/ignore-file-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore-file-service.js","sourceRoot":"","sources":["../../../src/lib/walker/ignore-file-service.ts"],"names":[],"mappings":"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"}

package/dist/tools/find-or-replace.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const registerFindOrReplaceTool: (server: McpServer) => void;
+//# sourceMappingURL=find-or-replace.d.ts.map

package/dist/tools/find-or-replace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-or-replace.d.ts","sourceRoot":"","sources":["../../src/tools/find-or-replace.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAUxE,eAAO,MAAM,yBAAyB,GAAI,QAAQ,SAAS,SAyGvD,CAAA"}

package/dist/tools/find-or-replace.js

@@ -0,0 +1,102 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { posix, resolve } from 'node:path';
+import { registerTool } from '@mcp-monorepo/shared';
+import { z } from 'zod';
+import { getWorkingDir } from '../lib/env.js';
+import { getFormattedSubstring } from '../lib/finder.js';
+import { validateWithinBasePath } from '../lib/validators.js';
+import { traverseDirectoryBFS } from '../lib/walker/better-walker.js';
+export const registerFindOrReplaceTool = (server) => registerTool(server, {
+    name: 'find-or-replace',
+    title: 'Find or Replace Text in Files',
+    description: 'Search for text patterns in files with optional replacement. Supports multi-line matches and provides context.',
+    inputSchema: {
+        dirpath: z
+            .string()
+            .optional()
+            .describe('Relative path to search directory. Defaults to current working directory.'),
+        fileRegexp: z.string().optional().describe('Regexp to filter file paths (e.g. ".*\\.ts$" for TypeScript files).'),
+        searchRegexp: z
+            .string()
+            .describe('Regexp pattern to search for in file contents. Can span multiple lines. The flags "gms" will be used.'),
+        replaceString: z
+            .string()
+            .optional()
+            .describe('Replacement string. Use $1, $2, etc. for capture groups. If provided, performs replacement instead of showing matches.'),
+    },
+    outputSchema: {
+        matches: z
+            .array(z.object({
+            filePath: z.string(),
+            matches: z.array(z.object({
+                lineNumber: z.number(),
+                string: z.string(),
+            })),
+        }))
+            .optional(),
+        message: z.string(),
+        totalMatches: z.number(),
+        filesProcessed: z.number(),
+    },
+    isReadOnly: false,
+    async fetcher({ dirpath, fileRegexp, searchRegexp, replaceString }) {
+        const workingDir = getWorkingDir();
+        const basePath = resolve(workingDir, dirpath ? posix.normalize(dirpath) : './');
+        validateWithinBasePath(workingDir, basePath);
+        const fileRegex = fileRegexp ? new RegExp(fileRegexp, 'i') : undefined;
+        const searchRegex = new RegExp(searchRegexp, 'gms'); // global, multiline, dotall
+        const matchResults = [];
+        const LIMIT = replaceString !== undefined ? Infinity : 200;
+        let isLimited = false;
+        for await (const { relPath, type } of traverseDirectoryBFS({
+            absoluteFolderPath: basePath,
+        })) {
+            const totalMatches = matchResults.map((m) => m.matches.length).reduce((a, b) => a + b, 0);
+            if (totalMatches > LIMIT) {
+                isLimited = true;
+                break;
+            }
+            if (type === 'file') {
+                if (!fileRegex || fileRegex.test(relPath)) {
+                    const fullPath = resolve(basePath, relPath);
+                    const content = await readFile(fullPath, 'utf-8');
+                    const matches = [...content.matchAll(searchRegex)];
+                    if (matches.length > 0) {
+                        matchResults.push({
+                            filePath: relPath,
+                            matches: matches.map((m) => ({
+                                lineNumber: m.index,
+                                string: m[0],
+                                context: getFormattedSubstring(content, m.index, m.index + m[0].length),
+                            })),
+                        });
+                        if (replaceString !== undefined) {
+                            const newContent = content.replace(searchRegex, replaceString);
+                            if (newContent !== content) {
+                                await writeFile(fullPath, newContent, 'utf-8');
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        return {
+            matches: matchResults,
+            isLimited,
+            isReplaceMode: replaceString !== undefined,
+            limit: LIMIT,
+        };
+    },
+    async formatter({ matches, isLimited, isReplaceMode, limit }) {
+        const totalMatches = matches.map((m) => m.matches.length).reduce((a, b) => a + b, 0);
+        const filesProcessed = matches.length;
+        const action = isReplaceMode ? 'Found and replaced' : 'Found';
+        return {
+            message: `${action} ${totalMatches} occurrence${totalMatches !== 1 ? 's' : ''} in ${filesProcessed} file${filesProcessed !== 1 ? 's' : ''}.${isLimited ? ` Results exceeded ${limit} matches. Try a more narrow scope with another dirpath or regex filter to find more matched.` : ''}`,
+            totalMatches,
+            filesProcessed,
+            matches: isReplaceMode ? undefined : matches,
+        };
+    },
+});
+//# sourceMappingURL=find-or-replace.js.map

package/dist/tools/find-or-replace.js.map

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

package/dist/tools/list-directory.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const registerListDirectoryTool: (server: McpServer) => void;
+//# sourceMappingURL=list-directory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-directory.d.ts","sourceRoot":"","sources":["../../src/tools/list-directory.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,eAAO,MAAM,yBAAyB,GAAI,QAAQ,SAAS,SAuEvD,CAAA"}

package/dist/tools/list-directory.js

@@ -0,0 +1,75 @@
+import { stat } from 'node:fs/promises';
+import os from 'node:os';
+import { basename, normalize, resolve } from 'node:path';
+import { registerTool } from '@mcp-monorepo/shared';
+import { z } from 'zod';
+import { getWorkingDir } from '../lib/env.js';
+import { validateIsDir, validateWithinBasePath } from '../lib/validators.js';
+import { traverseDirectoryBFS } from '../lib/walker/better-walker.js';
+export const registerListDirectoryTool = (server) => registerTool(server, {
+    name: 'list-directory',
+    title: 'List Directory Contents',
+    description: 'Lists the contents of a directory with details.',
+    inputSchema: {
+        dirpath: z.string().optional().describe('Relative path to the directory. Defaults to current working directory.'),
+    },
+    outputSchema: {
+        content: z.array(z.object({
+            name: z.string(),
+            type: z.enum([
+                'file',
+                'folder',
+                'block device',
+                'character device',
+                'FIFO',
+                'socket',
+                'symbolic link',
+                'unknown',
+            ]),
+            size: z.number(),
+            permissions: z.string().optional(),
+        })),
+        total: z.number(),
+        message: z.string().optional(),
+    },
+    isReadOnly: true,
+    async fetcher({ dirpath }) {
+        const workingDir = getWorkingDir();
+        const basePath = resolve(workingDir, normalize(dirpath ?? './'));
+        validateWithinBasePath(workingDir, basePath);
+        await validateIsDir(basePath);
+        const files = [];
+        let isLimited = false;
+        for await (const filePath of traverseDirectoryBFS({
+            absoluteFolderPath: basePath,
+            maxDepth: 1,
+        })) {
+            files.push(filePath);
+            if (files.length > 200) {
+                isLimited = true;
+                break;
+            }
+        }
+        return { files, basePath, isLimited };
+    },
+    async formatter({ files, basePath, isLimited }) {
+        const content = await Promise.all(files.map(async ({ relPath, type }) => {
+            const stats = await stat(resolve(basePath, normalize(relPath)));
+            const isUnix = os.platform() !== 'win32';
+            return {
+                name: basename(relPath),
+                type,
+                size: stats.size,
+                permissions: isUnix ? `0${(stats.mode & 0o777).toString(8)}` : undefined,
+            };
+        }));
+        return {
+            content,
+            total: files.length,
+            message: isLimited
+                ? 'Number of items exceedeed 200. Results limited in depth. Try a more narrow scope with another dirpath or regex filter.'
+                : undefined,
+        };
+    },
+});
+//# sourceMappingURL=list-directory.js.map

package/dist/tools/list-directory.js.map

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

package/dist/tools/mk-dir.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const registerMkDirTool: (server: McpServer) => void;
+//# sourceMappingURL=mk-dir.d.ts.map

package/dist/tools/mk-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mk-dir.d.ts","sourceRoot":"","sources":["../../src/tools/mk-dir.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,eAAO,MAAM,iBAAiB,GAAI,QAAQ,SAAS,SA0C/C,CAAA"}

package/dist/tools/mk-dir.js

@@ -0,0 +1,45 @@
+import { mkdir, stat } from 'node:fs/promises';
+import { normalize, resolve } from 'node:path';
+import { registerTool } from '@mcp-monorepo/shared';
+import { z } from 'zod';
+import { getWorkingDir } from '../lib/env.js';
+import { validateWithinBasePath } from '../lib/validators.js';
+export const registerMkDirTool = (server) => registerTool(server, {
+    name: 'mk-dir',
+    title: 'Make Directory',
+    description: 'Creates a directory and all necessary parent directories recursively.',
+    inputSchema: {
+        dirpath: z.string().nonempty('Directory path must be provided'),
+    },
+    outputSchema: {
+        created: z.string(),
+        existed: z.boolean(),
+    },
+    isReadOnly: false,
+    isIdempotent: true,
+    async fetcher({ dirpath }) {
+        const workingDir = getWorkingDir();
+        const path = resolve(workingDir, normalize(dirpath));
+        validateWithinBasePath(workingDir, path);
+        // Check if directory already exists
+        const existed = await stat(path)
+            .then((stat) => (stat.isDirectory() ? true : 'existed, but not a directory'))
+            .catch(() => false);
+        if (typeof existed === 'string')
+            throw new Error(`Cannot create directory ${dirpath} because it already exists and is not a directory.`);
+        if (!existed) {
+            await mkdir(path, { recursive: true });
+        }
+        return {
+            created: dirpath,
+            existed,
+        };
+    },
+    formatter({ created, existed }) {
+        return {
+            created,
+            existed,
+        };
+    },
+});
+//# sourceMappingURL=mk-dir.js.map

package/dist/tools/mk-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mk-dir.js","sourceRoot":"","sources":["../../src/tools/mk-dir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAI7D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAiB,EAAE,EAAE,CACrD,YAAY,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,gBAAgB;IACvB,WAAW,EAAE,uEAAuE;IACpF,WAAW,EAAE;QACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;KAChE;IACD,YAAY,EAAE;QACZ,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;KACrB;IACD,UAAU,EAAE,KAAK;IACjB,YAAY,EAAE,IAAI;IAClB,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE;QACvB,MAAM,UAAU,GAAG,aAAa,EAAE,CAAA;QAClC,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA;QACpD,sBAAsB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;QAExC,oCAAoC;QAEpC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC;aAC7B,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,8BAAwC,CAAC,CAAC;aACvF,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAA;QAErB,IAAI,OAAO,OAAO,KAAK,QAAQ;YAC7B,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,oDAAoD,CAAC,CAAA;QACzG,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACxC,CAAC;QAED,OAAO;YACL,OAAO,EAAE,OAAO;YAChB,OAAO;SACR,CAAA;IACH,CAAC;IACD,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE;QAC5B,OAAO;YACL,OAAO;YACP,OAAO;SACR,CAAA;IACH,CAAC;CACF,CAAC,CAAA"}

package/dist/tools/move-path.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const registerMovePathTool: (server: McpServer) => void;
+//# sourceMappingURL=move-path.d.ts.map

package/dist/tools/move-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"move-path.d.ts","sourceRoot":"","sources":["../../src/tools/move-path.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,eAAO,MAAM,oBAAoB,GAAI,QAAQ,SAAS,SAiClD,CAAA"}

package/dist/tools/move-path.js

@@ -0,0 +1,35 @@
+import { rename } from 'node:fs/promises';
+import { resolve, normalize } from 'node:path';
+import { registerTool } from '@mcp-monorepo/shared';
+import { z } from 'zod';
+import { getWorkingDir } from '../lib/env.js';
+import { validateDoesNotExists, validateExists, validateWithinBasePath } from '../lib/validators.js';
+export const registerMovePathTool = (server) => registerTool(server, {
+    name: 'move-path',
+    title: 'Move Path',
+    description: 'Moves files or directories to new locations. Each source must exist, and each target must not.',
+    inputSchema: {
+        paths: z.array(z.object({
+            sourcePath: z.string().nonempty('Source path must be provided'),
+            targetPath: z.string().nonempty('Target path must be provided'),
+        })),
+    },
+    outputSchema: {},
+    isReadOnly: false,
+    async fetcher({ paths }) {
+        const workingDir = getWorkingDir();
+        for (const { sourcePath, targetPath } of paths) {
+            const source = resolve(workingDir, normalize(sourcePath));
+            const target = resolve(workingDir, normalize(targetPath));
+            validateWithinBasePath(workingDir, source);
+            validateWithinBasePath(workingDir, target);
+            await validateExists(source);
+            await validateDoesNotExists(target);
+            await rename(source, target);
+        }
+    },
+    formatter() {
+        return {};
+    },
+});
+//# sourceMappingURL=move-path.js.map

package/dist/tools/move-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"move-path.js","sourceRoot":"","sources":["../../src/tools/move-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAIpG,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAiB,EAAE,EAAE,CACxD,YAAY,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,WAAW;IAClB,WAAW,EAAE,gGAAgG;IAC7G,WAAW,EAAE;QACX,KAAK,EAAE,CAAC,CAAC,KAAK,CACZ,CAAC,CAAC,MAAM,CAAC;YACP,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;YAC/D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;SAChE,CAAC,CACH;KACF;IACD,YAAY,EAAE,EAAE;IAChB,UAAU,EAAE,KAAK;IACjB,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE;QACrB,MAAM,UAAU,GAAG,aAAa,EAAE,CAAA;QAElC,KAAK,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,KAAK,EAAE,CAAC;YAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC,CAAA;YACzD,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC,CAAA;YAEzD,sBAAsB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;YAC1C,sBAAsB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;YAC1C,MAAM,cAAc,CAAC,MAAM,CAAC,CAAA;YAC5B,MAAM,qBAAqB,CAAC,MAAM,CAAC,CAAA;YAEnC,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC9B,CAAC;IACH,CAAC;IACD,SAAS;QACP,OAAO,EAAE,CAAA;IACX,CAAC;CACF,CAAC,CAAA"}

package/dist/tools/open-file.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const registerOpenFileTool: (server: McpServer) => void;
+//# sourceMappingURL=open-file.d.ts.map

package/dist/tools/open-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-file.d.ts","sourceRoot":"","sources":["../../src/tools/open-file.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,eAAO,MAAM,oBAAoB,GAAI,QAAQ,SAAS,SAyBlD,CAAA"}

package/dist/tools/open-file.js

@@ -0,0 +1,31 @@
+import { readFile } from 'node:fs/promises';
+import { normalize, resolve } from 'node:path';
+import { registerTool } from '@mcp-monorepo/shared';
+import { z } from 'zod';
+import { getWorkingDir } from '../lib/env.js';
+import { validateIsFile, validateWithinBasePath } from '../lib/validators.js';
+export const registerOpenFileTool = (server) => registerTool(server, {
+    name: 'open-file',
+    title: 'Open File',
+    description: 'Opens a file by its relative filepath and returns its content.',
+    inputSchema: {
+        filepath: z.string().nonempty('Filepath must be provided'),
+    },
+    outputSchema: {
+        content: z.string(),
+    },
+    isReadOnly: true,
+    async fetcher({ filepath }) {
+        const workingDir = getWorkingDir();
+        const path = resolve(workingDir, normalize(filepath));
+        validateWithinBasePath(workingDir, path);
+        await validateIsFile(path);
+        return await readFile(path, 'utf-8');
+    },
+    formatter(content) {
+        return {
+            content,
+        };
+    },
+});
+//# sourceMappingURL=open-file.js.map

package/dist/tools/open-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-file.js","sourceRoot":"","sources":["../../src/tools/open-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAI7E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAiB,EAAE,EAAE,CACxD,YAAY,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,WAAW;IAClB,WAAW,EAAE,gEAAgE;IAC7E,WAAW,EAAE;QACX,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;KAC3D;IACD,YAAY,EAAE;QACZ,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;KACpB;IACD,UAAU,EAAE,IAAI;IAChB,KAAK,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE;QACxB,MAAM,UAAU,GAAG,aAAa,EAAE,CAAA;QAClC,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAA;QACrD,sBAAsB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;QACxC,MAAM,cAAc,CAAC,IAAI,CAAC,CAAA;QAE1B,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IACtC,CAAC;IACD,SAAS,CAAC,OAAO;QACf,OAAO;YACL,OAAO;SACR,CAAA;IACH,CAAC;CACF,CAAC,CAAA"}

package/dist/tools/patch-file.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const registerPatchFileTool: (server: McpServer) => void;
+//# sourceMappingURL=patch-file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"patch-file.d.ts","sourceRoot":"","sources":["../../src/tools/patch-file.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,eAAO,MAAM,qBAAqB,GAAI,QAAQ,SAAS,SAuFnD,CAAA"}

package/dist/tools/patch-file.js

@@ -0,0 +1,80 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { normalize, resolve } from 'node:path';
+import { registerTool } from '@mcp-monorepo/shared';
+import { z } from 'zod';
+import { getWorkingDir } from '../lib/env.js';
+import { findPatchPositions } from '../lib/find-best-patch-match.js';
+import { validateWithinBasePath } from '../lib/validators.js';
+export const registerPatchFileTool = (server) => registerTool(server, {
+    name: 'patch-file',
+    title: 'Patch File',
+    description: 'Apply a patch to a file by replacing content between approximate start and end line numbers with context matching. Provide at least one line of unmodified content before and after the change.',
+    inputSchema: {
+        path: z.string().nonempty('File path must be provided'),
+        patch: z.string().nonempty('Patch content must be provided'),
+        approxStartLine: z.number().int().min(1).describe('Approximate start line number of the patch'),
+        approxEndLine: z
+            .number()
+            .int()
+            .min(1)
+            .describe('Approximate end line number of the patch. Must be equal or greater than start line.'),
+    },
+    outputSchema: {
+        actualStartPos: z.number(),
+        actualEndPos: z.number(),
+        startContextLength: z.number(),
+        endContextLength: z.number(),
+        bytesWritten: z.number(),
+    },
+    isReadOnly: false,
+    async fetcher({ path, patch, approxStartLine, approxEndLine }) {
+        const workingDir = getWorkingDir();
+        const fullPath = resolve(workingDir, normalize(path));
+        validateWithinBasePath(workingDir, fullPath);
+        // Read the current file content
+        const fileContent = await readFile(fullPath, 'utf-8');
+        // Find the patch positions using the provided function
+        const { patchStartPos, patchEndPos } = findPatchPositions(fileContent, patch, approxStartLine, approxEndLine);
+        if (!patchStartPos || !patchEndPos) {
+            throw new Error(`Could not find suitable patch positions. Start found: ${!!patchStartPos}, End found: ${!!patchEndPos}`);
+        }
+        const actualStartPos = patchStartPos.bestMatchPos;
+        const actualEndPos = patchEndPos.bestMatchPos;
+        const startContextLength = patchStartPos.maxOverlap;
+        const endContextLength = patchEndPos.maxOverlap;
+        // Validate minimum distance requirement
+        if (actualEndPos - actualStartPos < 5) {
+            throw new Error(`Derived actual start (${actualStartPos}) and end (${actualEndPos}) positions are less than 5 characters apart`);
+        }
+        // Validate minimum context length requirements
+        if (startContextLength < 5) {
+            throw new Error(`Start context length (${startContextLength}) is less than 5 characters`);
+        }
+        if (endContextLength < 5) {
+            throw new Error(`End context length (${endContextLength}) is less than 5 characters`);
+        }
+        // Apply the patch by replacing content between the found positions
+        const beforePatch = fileContent.slice(0, actualStartPos);
+        const afterPatch = fileContent.slice(actualEndPos);
+        const newContent = beforePatch + patch + afterPatch;
+        // Write the patched content back to the file
+        await writeFile(fullPath, newContent, 'utf-8');
+        return {
+            actualStartPos,
+            actualEndPos,
+            startContextLength,
+            endContextLength,
+            bytesWritten: Buffer.byteLength(newContent, 'utf-8'),
+        };
+    },
+    formatter({ actualStartPos, actualEndPos, startContextLength, endContextLength, bytesWritten }) {
+        return {
+            actualStartPos,
+            actualEndPos,
+            startContextLength,
+            endContextLength,
+            bytesWritten,
+        };
+    },
+});
+//# sourceMappingURL=patch-file.js.map

package/dist/tools/patch-file.js.map

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

package/dist/tools/remove-file.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const registerRemoveFileTool: (server: McpServer) => void;
+//# sourceMappingURL=remove-file.d.ts.map

package/dist/tools/remove-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-file.d.ts","sourceRoot":"","sources":["../../src/tools/remove-file.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,eAAO,MAAM,sBAAsB,GAAI,QAAQ,SAAS,SA+CpD,CAAA"}