staff-mcp 1.0.0

package/dist/src/tools/file-tools.js

@@ -0,0 +1,230 @@
+import * as fs from "fs/promises";
+import * as path from "path";
+import { z } from "zod";
+import { CHARACTER_LIMIT } from "../constants.js";
+import { getPathDiagnostics } from "./lsp-tools.js";
+/**
+ * Registers file-related tools using the latest registerTool API.
+ */
+export function registerFileTools(server, security) {
+    // read_file
+    server.registerTool("read_file", {
+        description: "Read the content of a file from the allowed workspace.",
+        inputSchema: z.object({
+            path: z.string().describe("Relative path from the workspace to the file to read."),
+            startLine: z.number().optional().describe("1-based line number to start reading from."),
+            endLine: z.number().optional().describe("1-based line number to end reading at (inclusive)."),
+        }).strict(),
+    }, async ({ path: filePath, startLine, endLine }) => {
+        try {
+            const validatedPath = security.resolveAndValidatePath(filePath);
+            const fullContent = await fs.readFile(validatedPath, "utf-8");
+            const lines = fullContent.split(/\r?\n/);
+            let contentLines = lines;
+            let prefix = "";
+            if (startLine !== undefined || endLine !== undefined) {
+                const start = startLine ? Math.max(0, startLine - 1) : 0;
+                const end = endLine ? Math.min(lines.length, endLine) : lines.length;
+                contentLines = lines.slice(start, end);
+                prefix = `Showing lines ${start + 1}-${end} of ${lines.length}:\n`;
+            }
+            let content = contentLines.join("\n");
+            if (content.length > CHARACTER_LIMIT) {
+                content = content.substring(0, CHARACTER_LIMIT) + "\n\n...[Content truncated for brevity]";
+            }
+            return {
+                content: [{ type: "text", text: prefix + content }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error reading file: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // edit_file_by_replace
+    server.registerTool("edit_file_by_replace", {
+        description: "Replace a specific block of text in a file with new content. Use this for precise edits.",
+        inputSchema: z.object({
+            path: z.string().describe("Path to the file to edit."),
+            oldText: z.string().describe("The exact text block to be replaced. Be as specific as possible to avoid wrong matches."),
+            newText: z.string().describe("The new text content to replace with."),
+        }).strict(),
+    }, async ({ path: filePath, oldText, newText }) => {
+        try {
+            const validatedPath = security.resolveAndValidatePath(filePath);
+            const content = await fs.readFile(validatedPath, "utf-8");
+            // Simple fuzzy match: try exact first, then trimmed
+            let index = content.indexOf(oldText);
+            if (index === -1) {
+                // Try fuzzy: trim and normalize line endings
+                const normalize = (s) => s.replace(/\r\n/g, "\n").trim();
+                const normalizedContent = normalize(content);
+                const normalizedOld = normalize(oldText);
+                if (normalizedContent.includes(normalizedOld)) {
+                    // If normalized matches, we need to find the actual position in the original content
+                    // For simplicity, if exact match fails but normalized would work, we warn the model
+                    return {
+                        content: [{ type: "text", text: `Error: The oldText provided did not match exactly. Please ensure whitespace and line endings match or provide more context.` }],
+                        isError: true,
+                    };
+                }
+                return {
+                    content: [{ type: "text", text: `Error: Could not find the text block to replace in ${filePath}. Check for typos or provide more context.` }],
+                    isError: true,
+                };
+            }
+            const updatedContent = content.slice(0, index) + newText + content.slice(index + oldText.length);
+            await fs.writeFile(validatedPath, updatedContent, "utf-8");
+            let response = `Successfully updated ${filePath}`;
+            // Add diagnostics feedback for TS files
+            if (filePath.endsWith(".ts") || filePath.endsWith(".tsx")) {
+                const diagnostics = await getPathDiagnostics(filePath, security);
+                if (diagnostics) {
+                    response += `\n\nWarning: TypeScript diagnostics found after editing:\n${diagnostics}`;
+                }
+            }
+            return {
+                content: [{ type: "text", text: response }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error editing file: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // write_file
+    server.registerTool("write_file", {
+        description: "Write or overwrite a file in the allowed workspace.",
+        inputSchema: z.object({
+            path: z.string().describe("Path to the file to write."),
+            content: z.string().describe("Content to write into the file."),
+        }).strict(),
+    }, async ({ path: filePath, content }) => {
+        try {
+            const validatedPath = security.resolveAndValidatePath(filePath);
+            await fs.mkdir(path.dirname(validatedPath), { recursive: true });
+            await fs.writeFile(validatedPath, content, "utf-8");
+            let response = `Successfully wrote file: ${filePath}`;
+            // Add diagnostics feedback for TS files
+            if (filePath.endsWith(".ts") || filePath.endsWith(".tsx")) {
+                const diagnostics = await getPathDiagnostics(filePath, security);
+                if (diagnostics) {
+                    response += `\n\nWarning: TypeScript diagnostics found after writing:\n${diagnostics}`;
+                }
+            }
+            return {
+                content: [{ type: "text", text: response }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error writing file: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // delete_file
+    server.registerTool("delete_file", {
+        description: "Delete a file from the allowed workspace.",
+        inputSchema: z.object({
+            path: z.string().describe("Path to the file to delete."),
+        }).strict(),
+    }, async ({ path: filePath }) => {
+        try {
+            const validatedPath = security.resolveAndValidatePath(filePath);
+            await fs.unlink(validatedPath);
+            return {
+                content: [{ type: "text", text: `Successfully deleted file: ${filePath}` }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error deleting file: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // list_dir
+    server.registerTool("list_dir", {
+        description: "List files and directories within a specific path.",
+        inputSchema: z.object({
+            path: z.string().default(".").describe("Path to list (defaults to workspace root)."),
+        }).strict(),
+    }, async ({ path: dirPath }) => {
+        try {
+            const validatedPath = security.resolveAndValidatePath(dirPath);
+            const entries = await fs.readdir(validatedPath, { withFileTypes: true });
+            const result = entries.map(entry => {
+                return `${entry.isDirectory() ? "[DIR]" : "[FILE]"} ${entry.name}`;
+            }).join("\n");
+            return {
+                content: [{ type: "text", text: result || "(Directory is empty)" }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error listing directory: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // search_file_content
+    server.registerTool("search_file_content", {
+        description: "Perform a global regex search for a specific string across all files in the project.",
+        inputSchema: z.object({
+            regex: z.string().describe("The regular expression pattern to search for."),
+            includeGlob: z.string().optional().describe("Glob pattern to limit the search (e.g. src/**/*.ts)."),
+        }).strict(),
+    }, async ({ regex, includeGlob }) => {
+        try {
+            const searchRegex = new RegExp(regex, "g");
+            const results = [];
+            const baseDir = security.resolveAndValidatePath(".");
+            async function searchRecursively(currentDir) {
+                const entries = await fs.readdir(currentDir, { withFileTypes: true });
+                for (const entry of entries) {
+                    const fullPath = path.join(currentDir, entry.name);
+                    // Simple check to skip node_modules and .git
+                    if (entry.name === "node_modules" || entry.name === ".git")
+                        continue;
+                    if (entry.isDirectory()) {
+                        await searchRecursively(fullPath);
+                    }
+                    else if (entry.isFile()) {
+                        const relPath = path.relative(baseDir, fullPath);
+                        // Basic glob matching (simple version)
+                        if (includeGlob && !relPath.includes(includeGlob.replace(/\*/g, "")))
+                            continue;
+                        const content = await fs.readFile(fullPath, "utf-8");
+                        let match;
+                        while ((match = searchRegex.exec(content)) !== null) {
+                            // Find line number using cross-platform line endings
+                            const lineNum = content.substring(0, match.index).split(/\r?\n/).length;
+                            const context = content.split(/\r?\n/)[lineNum - 1];
+                            results.push(`${relPath}:${lineNum} - ${context.trim()}`);
+                            if (results.length > 100) {
+                                results.push("... [Search results truncated after 100 matches]");
+                                return;
+                            }
+                        }
+                    }
+                }
+            }
+            await searchRecursively(baseDir);
+            return {
+                content: [{ type: "text", text: results.join("\n") || "No matches found." }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error during search: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=file-tools.js.map

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

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

package/dist/src/tools/lsp-tools.d.ts

@@ -0,0 +1,10 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { SecurityManager } from "../security.js";
+/**
+ * Internal helper to get diagnostics for a specific path.
+ */
+export declare function getPathDiagnostics(checkPath: string, security: SecurityManager): Promise<string>;
+/**
+ * Registers LSP-related tools using the latest registerTool API.
+ */
+export declare function registerLspTools(server: McpServer, security: SecurityManager): void;

package/dist/src/tools/lsp-tools.js

@@ -0,0 +1,124 @@
+import { Project } from "ts-morph";
+import { z } from "zod";
+/**
+ * Internal helper to get diagnostics for a specific path.
+ */
+export async function getPathDiagnostics(checkPath, security) {
+    const validatedPath = security.resolveAndValidatePath(checkPath);
+    const project = new Project();
+    project.addSourceFilesAtPaths([
+        validatedPath.endsWith(".ts") || validatedPath.endsWith(".js")
+            ? validatedPath
+            : `${validatedPath}/**/*.{ts,js,tsx,jsx}`
+    ]);
+    const diagnostics = project.getPreEmitDiagnostics();
+    return diagnostics.map(diag => {
+        const messageText = diag.getMessageText();
+        const line = diag.getLineNumber();
+        const file = diag.getSourceFile()?.getFilePath() || "Unknown file";
+        const formattedMessage = typeof messageText === "string" ? messageText : messageText.getMessageText();
+        return `[${file}:${line}] ${formattedMessage}`;
+    }).join("\n");
+}
+/**
+ * Registers LSP-related tools using the latest registerTool API.
+ */
+export function registerLspTools(server, security) {
+    // get_document_symbols
+    server.registerTool("get_document_symbols", {
+        description: "Extract high-level symbols (classes, functions, interfaces) from a TypeScript file.",
+        inputSchema: z.object({
+            path: z.string().describe("TypeScript/JavaScript file path to analyze."),
+        }).strict(),
+    }, async ({ path: filePath }) => {
+        try {
+            const validatedPath = security.resolveAndValidatePath(filePath);
+            const project = new Project();
+            const sourceFile = project.addSourceFileAtPath(validatedPath);
+            const symbols = [];
+            sourceFile.getClasses().forEach(c => symbols.push(`[Class] ${c.getName()} (Line ${c.getStartLineNumber()})`));
+            sourceFile.getInterfaces().forEach(i => symbols.push(`[Interface] ${i.getName()} (Line ${i.getStartLineNumber()})`));
+            sourceFile.getFunctions().forEach(f => symbols.push(`[Function] ${f.getName()} (Line ${f.getStartLineNumber()})`));
+            sourceFile.getEnums().forEach(e => symbols.push(`[Enum] ${e.getName()} (Line ${e.getStartLineNumber()})`));
+            sourceFile.getTypeAliases().forEach(t => symbols.push(`[TypeAlias] ${t.getName()} (Line ${t.getStartLineNumber()})`));
+            return {
+                content: [{ type: "text", text: symbols.join("\n") || "(No significant symbols found)" }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `LSP Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // get_diagnostics
+    server.registerTool("get_diagnostics", {
+        description: "Get TypeScript diagnostics/errors for a file or directory.",
+        inputSchema: z.object({
+            path: z.string().describe("File or directory path to check for TypeScript diagnostics."),
+        }).strict(),
+    }, async ({ path: checkPath }) => {
+        try {
+            const output = await getPathDiagnostics(checkPath, security);
+            return {
+                content: [{ type: "text", text: output || "No TypeScript diagnostics found." }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `LSP Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // find_references
+    server.registerTool("find_references", {
+        description: "Find all references to a symbol (function, class, variable) in the project.",
+        inputSchema: z.object({
+            path: z.string().describe("File path where the symbol is defined."),
+            symbolName: z.string().describe("The name of the symbol to find references for."),
+        }).strict(),
+    }, async ({ path: filePath, symbolName }) => {
+        try {
+            const validatedPath = security.resolveAndValidatePath(filePath);
+            const project = new Project();
+            project.addSourceFilesAtPaths("**/*.ts");
+            const sourceFile = project.getSourceFile(validatedPath);
+            if (!sourceFile) {
+                throw new Error(`File not found: ${filePath}`);
+            }
+            // Search for the symbol
+            let node;
+            // Simple search by name in classes, functions, etc.
+            const allNodes = sourceFile.getDescendantsOfKind(1 /* Identifier */);
+            node = allNodes.find(n => n.getText() === symbolName);
+            if (!node) {
+                return {
+                    content: [{ type: "text", text: `Could not find symbol "${symbolName}" in ${filePath}` }],
+                    isError: true,
+                };
+            }
+            const references = node.findReferences();
+            const results = [];
+            for (const reference of references) {
+                for (const ref of reference.getReferences()) {
+                    const refSourceFile = ref.getSourceFile();
+                    const line = refSourceFile.getLineAndColumnAtPos(ref.getTextSpan().getStart()).line;
+                    const relPath = security.resolveAndValidatePath(refSourceFile.getFilePath()); // Re-validate or just use relative
+                    results.push(`${refSourceFile.getFilePath()}:${line}`);
+                }
+            }
+            return {
+                content: [{ type: "text", text: results.join("\n") || "No references found." }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `LSP Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=lsp-tools.js.map

package/dist/src/tools/lsp-tools.js.map

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

package/dist/src/tools/shell-tools.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { SecurityManager } from "../security.js";
+/**
+ * Registers shell-related tools using the latest registerTool API.
+ */
+export declare function registerShellTools(server: McpServer, security: SecurityManager): void;

package/dist/src/tools/shell-tools.js

@@ -0,0 +1,138 @@
+import { exec, spawn } from "child_process";
+import { promisify } from "util";
+import { z } from "zod";
+import { DEFAULT_TIMEOUT } from "../constants.js";
+const execAsync = promisify(exec);
+// Store for background tasks
+const backgroundTasks = new Map();
+/**
+ * Registers shell-related tools using the latest registerTool API.
+ */
+export function registerShellTools(server, security) {
+    server.registerTool("execute_command", {
+        description: "Execute a shell command in a specified directory (sandboxed).",
+        inputSchema: z.object({
+            command: z.string().describe("The shell command to execute."),
+            cwd: z.string().optional().describe("Directory to execute command from (must be allowed). Defaults to the workspace root."),
+        }).strict(),
+    }, async ({ command, cwd }) => {
+        try {
+            const validatedCwd = security.validateDirectory(cwd || ".");
+            const { stdout, stderr } = await execAsync(command, {
+                cwd: validatedCwd,
+                timeout: DEFAULT_TIMEOUT,
+            });
+            // Truncate output if too long
+            const formatOutput = (out) => {
+                const lines = out.split(/\r?\n/);
+                if (lines.length > 500) {
+                    return lines.slice(0, 100).join("\n") +
+                        `\n\n...[${lines.length - 200} lines truncated for brevity]...\n\n` +
+                        lines.slice(-100).join("\n");
+                }
+                return out;
+            };
+            const output = [
+                stdout ? `STDOUT:\n${formatOutput(stdout)}` : "",
+                stderr ? `STDERR:\n${formatOutput(stderr)}` : "",
+            ].filter(Boolean).join("\n\n");
+            return {
+                content: [{ type: "text", text: output || "(No output from command)" }],
+            };
+        }
+        catch (error) {
+            // If timed out or error occurred, still try to return what we have or a meaningful error
+            return {
+                content: [{ type: "text", text: `Command execution failed or timed out: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // start_background_task
+    server.registerTool("start_background_task", {
+        description: "Start a background process (e.g. dev server) in the workspace.",
+        inputSchema: z.object({
+            command: z.string().describe("The shell command to start."),
+            cwd: z.string().optional().describe("Directory to start from (defaults to workspace root)."),
+        }).strict(),
+    }, async ({ command, cwd }) => {
+        try {
+            const validatedCwd = security.validateDirectory(cwd || ".");
+            // Use a single string for spawn when shell: true is enabled.
+            // This is more cross-platform and handles arguments/quotes better.
+            const child = spawn(command, {
+                cwd: validatedCwd,
+                shell: true,
+                // On Windows, shell: true uses cmd.exe /c.
+                // On Unix, shell: true uses /bin/sh -c.
+            });
+            const taskId = `task_${Math.random().toString(36).substring(2, 9)}`;
+            const logs = [];
+            child.stdout?.on("data", (data) => {
+                logs.push(data.toString());
+                if (logs.length > 1000)
+                    logs.shift(); // Keep last 1000 lines
+            });
+            child.stderr?.on("data", (data) => {
+                logs.push(`ERR: ${data.toString()}`);
+                if (logs.length > 1000)
+                    logs.shift();
+            });
+            backgroundTasks.set(taskId, { process: child, logs });
+            child.on("exit", (code) => {
+                logs.push(`[Process exited with code ${code}]`);
+                // Note: We don't remove from map yet so logs can be read
+            });
+            return {
+                content: [{ type: "text", text: `Task started with ID: ${taskId}` }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error starting task: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // get_background_task_logs
+    server.registerTool("get_background_task_logs", {
+        description: "Read the latest logs from a running or recently exited background task.",
+        inputSchema: z.object({
+            taskId: z.string().describe("The ID of the task."),
+            tail: z.number().optional().default(100).describe("Number of lines to return from the end."),
+        }).strict(),
+    }, async ({ taskId, tail }) => {
+        const task = backgroundTasks.get(taskId);
+        if (!task) {
+            return {
+                content: [{ type: "text", text: `Task ${taskId} not found.` }],
+                isError: true,
+            };
+        }
+        const logs = task.logs.slice(-tail);
+        return {
+            content: [{ type: "text", text: logs.join("") || "(No logs yet)" }],
+        };
+    });
+    // kill_background_task
+    server.registerTool("kill_background_task", {
+        description: "Terminate a background task by its ID.",
+        inputSchema: z.object({
+            taskId: z.string().describe("The ID of the task to kill."),
+        }).strict(),
+    }, async ({ taskId }) => {
+        const task = backgroundTasks.get(taskId);
+        if (!task) {
+            return {
+                content: [{ type: "text", text: `Task ${taskId} not found.` }],
+                isError: true,
+            };
+        }
+        task.process.kill();
+        backgroundTasks.delete(taskId);
+        return {
+            content: [{ type: "text", text: `Task ${taskId} killed.` }],
+        };
+    });
+}
+//# sourceMappingURL=shell-tools.js.map

package/dist/src/tools/shell-tools.js.map

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

package/dist/src/tools/skill-manager.d.ts

@@ -0,0 +1,14 @@
+export interface SkillInfo {
+    name: string;
+    description: string;
+    location: string;
+    content: string;
+}
+export declare class SkillManager {
+    private static readonly SEARCH_DIRS;
+    private static readonly SKILL_SUBDIRS;
+    static loadSkills(workingDir: string): Record<string, SkillInfo>;
+    private static scanDirSync;
+    private static addSkillSync;
+    private static parseMarkdown;
+}