staff-mcp 1.0.0

package/dist/src/tools/skill-manager.js

@@ -0,0 +1,97 @@
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+export class SkillManager {
+    // 定义搜索的基准目录名（隐藏目录）
+    static SEARCH_DIRS = [".staff", ".claude", ".agents", ".opencode"];
+    // 定义技能子目录名
+    static SKILL_SUBDIRS = ["skills", "skill"];
+    static loadSkills(workingDir) {
+        const skills = {};
+        const searchPaths = [];
+        // 0. 直接检查工作目录下的 skills (兼容旧逻辑)
+        searchPaths.push(path.join(workingDir, "skills"));
+        searchPaths.push(path.join(workingDir, "skill"));
+        // 1. 添加当前工作区搜索路径
+        this.SEARCH_DIRS.forEach(dir => {
+            this.SKILL_SUBDIRS.forEach(sub => {
+                searchPaths.push(path.join(workingDir, dir, sub));
+            });
+        });
+        // 2. 添加全局搜索路径 (用户主目录)
+        const homeDir = os.homedir();
+        this.SEARCH_DIRS.forEach(dir => {
+            this.SKILL_SUBDIRS.forEach(sub => {
+                searchPaths.push(path.join(homeDir, dir, sub));
+            });
+        });
+        // 3. 扫描所有有效路径
+        for (const root of searchPaths) {
+            if (fs.existsSync(root) && fs.statSync(root).isDirectory()) {
+                this.scanDirSync(root, skills);
+            }
+        }
+        return skills;
+    }
+    static scanDirSync(dir, skills) {
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                // 跳过常见的忽略目录
+                if (entry.name === "node_modules" || entry.name === ".git")
+                    continue;
+                const fullPath = path.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    // 递归搜索子目录
+                    this.scanDirSync(fullPath, skills);
+                }
+                else if (entry.name === "SKILL.md") {
+                    this.addSkillSync(fullPath, skills);
+                }
+            }
+        }
+        catch (e) {
+            // 忽略读取错误
+        }
+    }
+    static addSkillSync(filePath, skills) {
+        try {
+            const fileContent = fs.readFileSync(filePath, "utf-8");
+            const { data, content } = this.parseMarkdown(fileContent);
+            // 确保有必要的元数据
+            if (data.name && data.description) {
+                // 如果名称冲突，优先保留先扫描到的（项目本地优先于全局）
+                if (!skills[data.name]) {
+                    skills[data.name] = {
+                        name: data.name,
+                        description: data.description,
+                        location: filePath,
+                        content: content.trim(),
+                    };
+                }
+            }
+        }
+        catch (e) {
+            console.error(`[SkillManager] Failed to load skill from ${filePath}`, e);
+        }
+    }
+    static parseMarkdown(content) {
+        // 匹配 Markdown Frontmatter (--- yaml --- content)
+        const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/);
+        if (!match)
+            return { data: {}, content };
+        const yamlStr = match[1];
+        const body = match[2];
+        const data = {};
+        for (const line of yamlStr.split("\n")) {
+            const colonIndex = line.indexOf(":");
+            if (colonIndex > -1) {
+                const key = line.slice(0, colonIndex).trim();
+                const value = line.slice(colonIndex + 1).trim().replace(/^['"]|['"]$/g, "");
+                data[key] = value;
+            }
+        }
+        return { data, content: body };
+    }
+}
+//# sourceMappingURL=skill-manager.js.map

package/dist/src/tools/skill-manager.js.map

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

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

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { SecurityManager } from "../security.js";
+export declare function registerSkillTools(server: McpServer, workingDir: string, security: SecurityManager): void;

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

@@ -0,0 +1,117 @@
+import { z } from "zod";
+import { SkillManager } from "./skill-manager.js";
+import * as fs from "fs/promises";
+import * as path from "path";
+export function registerSkillTools(server, workingDir, security) {
+    const skillsMap = SkillManager.loadSkills(workingDir);
+    const list = Object.values(skillsMap);
+    // skill
+    const description = list.length === 0
+        ? "Load a specialized skill that provides domain-specific instructions and workflows. No skills are currently available."
+        : [
+            "The following skills provide specialized sets of instructions for particular tasks",
+            "Invoke this tool to load a skill when a task matches one of the available skills listed below:",
+            "",
+            "<available_skills>",
+            ...list.flatMap((skill) => [
+                `  <skill>`,
+                `    <name>${skill.name}</name>`,
+                `    <description>${skill.description}</description>`,
+                `  </skill>`,
+            ]),
+            "</available_skills>",
+        ].join("\n");
+    const examples = list.map((skill) => `'${skill.name}'`).slice(0, 3).join(", ");
+    const hint = examples.length > 0 ? ` (e.g., ${examples}, ...)` : "";
+    server.registerTool("skill", {
+        description: description,
+        inputSchema: z.object({
+            name: z.string().describe(`The name of the skill from available_skills${hint}`),
+        }).strict(),
+    }, async ({ name }) => {
+        const skill = skillsMap[name];
+        if (!skill) {
+            const available = list.map((s) => s.name).join(", ");
+            throw new Error(`Skill "${name}" not found. Available skills: ${available || "none"}`);
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: buildSkillOutput(skill)
+                }]
+        };
+    });
+    // read_skill_file
+    server.registerTool("read_skill_file", {
+        description: "Read the contents of a file associated with a specific loaded skill.",
+        inputSchema: z.object({
+            skillName: z.string().describe('The name of the skill (e.g., "react-component")'),
+            relativePath: z.string().describe('The relative path of the file to read (e.g., "templates/Component.tsx")')
+        }).strict(),
+    }, async ({ skillName, relativePath }) => {
+        const skill = skillsMap[skillName];
+        if (!skill) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Error: Skill "${skillName}" not found.` }]
+            };
+        }
+        const baseDir = path.dirname(skill.location);
+        const targetPath = path.resolve(baseDir, relativePath);
+        // Security check: ensure targetPath is within baseDir
+        if (!targetPath.startsWith(baseDir)) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Security Error: Access denied. Cannot read files outside skill directory.` }]
+            };
+        }
+        try {
+            const content = await fs.readFile(targetPath, "utf-8");
+            return {
+                content: [{
+                        type: "text",
+                        text: content
+                    }]
+            };
+        }
+        catch (e) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Failed to read skill file: ${e.message}` }]
+            };
+        }
+    });
+    // Register Prompts
+    for (const skill of list) {
+        server.registerPrompt(skill.name, {
+            description: skill.description,
+            argsSchema: {}
+        }, () => {
+            return {
+                messages: [
+                    {
+                        role: "user",
+                        content: {
+                            type: "text",
+                            text: buildSkillOutput(skill)
+                        }
+                    }
+                ]
+            };
+        });
+    }
+}
+function buildSkillOutput(skill) {
+    const dir = path.dirname(skill.location);
+    return [
+        `<skill_content name="${skill.name}">`,
+        `# Skill: ${skill.name}`,
+        "",
+        skill.content.trim(),
+        "",
+        `Base directory: ${dir}`,
+        "Relative paths in this skill are relative to this base directory.",
+        "</skill_content>"
+    ].join("\n");
+}
+//# sourceMappingURL=skill-tools.js.map

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

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

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

@@ -0,0 +1,6 @@
+import { SecurityManager } from "../security.js";
+/**
+ * Returns a concise instruction string for the MCP server to guide tool usage.
+ * Focuses on environment context and tool relationships rather than defining identity.
+ */
+export declare function getMcpInstructions(workingDir: string, security: SecurityManager): string;

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

@@ -0,0 +1,36 @@
+import * as os from "os";
+import * as path from "path";
+/**
+ * Returns a concise instruction string for the MCP server to guide tool usage.
+ * Focuses on environment context and tool relationships rather than defining identity.
+ */
+export function getMcpInstructions(workingDir, security) {
+    const platform = os.platform();
+    const isWin = platform === "win32";
+    const shell = isWin ? "cmd.exe or PowerShell" : (process.env.SHELL || "/bin/sh");
+    const allowedDirs = security.getAllowedDirs();
+    return `
+# MCP Context: staff-mcp
+Environment:
+- OS: ${platform}
+- Default Shell: ${shell}
+- Working Directory: ${workingDir}
+- Access Constraints: Only paths within [${allowedDirs.join(", ")}] are accessible.
+- Path Separator: '${path.sep}'
+
+Tool Usage Guidance:
+1. File Navigation: Always start by using 'list_dir' to understand the project structure before reading files.
+2. Content Inspection: 
+   - Use 'read_file' for specific files. 
+   - Use 'search_file_content' (regex-backed grep) to find patterns or usage across the codebase.
+   - Use 'get_document_symbols' for a quick structural overview of a file.
+3. Command Execution:
+   - For quick, non-interactive tasks, use 'execute_command'.
+   - For long-running processes (e.g., dev servers), use 'start_background_task' and follow up with 'get_background_task_logs'.
+   - ${isWin ? "Critical: Use Windows-compatible commands (e.g., 'dir', 'copy', 'del', 'type'). Use backslashes '\\' for paths in commands." : "Critical: Use POSIX-compatible commands (e.g., 'ls', 'cp', 'rm', 'cat'). Use forward slashes '/' for paths."}
+4. Specialized Skills: If a '.staff/skills' or '.claude/skills' directory exists, use the 'skill' tool to load domain-specific workflows which will augment your current context.
+5. Search & Replace: When refactoring, use 'search_file_content' to find all occurrences, then 'edit_file_by_replace' for precise, line-based replacements.
+6. Verification: Use 'get_diagnostics' after editing code to ensure no errors were introduced.
+`.trim();
+}
+//# sourceMappingURL=system-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"system-tools.js","sourceRoot":"","sources":["../../../src/tools/system-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAG7B;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB,EAAE,QAAyB;IAC9E,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,QAAQ,KAAK,OAAO,CAAC;IACnC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,SAAS,CAAC,CAAC;IACjF,MAAM,WAAW,GAAG,QAAQ,CAAC,cAAc,EAAE,CAAC;IAE9C,OAAO;;;QAGD,QAAQ;mBACG,KAAK;uBACD,UAAU;2CACU,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;qBAC5C,IAAI,CAAC,GAAG;;;;;;;;;;;OAWtB,KAAK,CAAC,CAAC,CAAC,6HAA6H,CAAC,CAAC,CAAC,6GAA6G;;;;CAI3P,CAAC,IAAI,EAAE,CAAC;AACT,CAAC"}

package/dist/src/transports/http.d.ts

@@ -0,0 +1,5 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Starts an Express server that hosts the MCP server over Streamable HTTP.
+ */
+export declare function startHttpServer(server: McpServer, port: number, host?: string): Promise<void>;

package/dist/src/transports/http.js

@@ -0,0 +1,58 @@
+import express from "express";
+import cors from "cors";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { randomUUID } from "node:crypto";
+/**
+ * Starts an Express server that hosts the MCP server over Streamable HTTP.
+ */
+export async function startHttpServer(server, port, host = "0.0.0.0") {
+    const app = express();
+    // Enable CORS for all origins, including the MCP Inspector
+    app.use(cors());
+    // Necessary for processing JSON-RPC messages (POST)
+    // We use express.json() but also need to be careful not to consume the stream if transport needs it.
+    // However, StreamableHTTPServerTransport.handleRequest accepts parsedBody.
+    app.use(express.json());
+    // Use a single transport instance for the lifetime of the HTTP server.
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: () => randomUUID(),
+        // VERY IMPORTANT: Enable JSON responses for POST requests. 
+        // This allows the client to receive tool lists and call results directly in the POST response,
+        // which is what the Anthropic Inspector and many other clients expect.
+        enableJsonResponse: true,
+    });
+    // Connect the MCP server instance to this transport.
+    await server.connect(transport);
+    /**
+     * Unified handler for MCP requests.
+     * Handles GET (SSE) and POST (JSON-RPC).
+     */
+    const mcpHandler = async (req, res) => {
+        try {
+            // In Streamable HTTP, handleRequest handles the full lifecycle based on method.
+            await transport.handleRequest(req, res, req.body);
+        }
+        catch (error) {
+            console.error("[MCP HTTP Error]:", error);
+            if (!res.headersSent) {
+                res.status(500).json({
+                    error: "Internal Server Error",
+                    message: error instanceof Error ? error.message : String(error)
+                });
+            }
+        }
+    };
+    // Route for all MCP interactions.
+    app.all("/mcp", mcpHandler);
+    // Standard fallbacks
+    app.get("/sse", mcpHandler);
+    app.post("/messages", mcpHandler);
+    return new Promise((resolve) => {
+        app.listen(port, host, () => {
+            console.error(`[MCP HTTP] Server listening on http://${host}:${port}/mcp`);
+            console.error(`[MCP HTTP] JSON Response enabled: true`);
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=http.js.map

package/dist/src/transports/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/transports/http.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAiB,EAAE,IAAY,EAAE,OAAe,SAAS;IAC7F,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IAEtB,2DAA2D;IAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAEhB,oDAAoD;IACpD,qGAAqG;IACrG,2EAA2E;IAC3E,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAExB,uEAAuE;IACvE,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC;QAClD,kBAAkB,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE;QACtC,4DAA4D;QAC5D,+FAA+F;QAC/F,uEAAuE;QACvE,kBAAkB,EAAE,IAAI;KACzB,CAAC,CAAC;IAEH,qDAAqD;IACrD,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC;;;OAGG;IACH,MAAM,UAAU,GAAG,KAAK,EAAE,GAAoB,EAAE,GAAqB,EAAE,EAAE;QACvE,IAAI,CAAC;YACH,gFAAgF;YAChF,MAAM,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;YAC1C,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;gBACrB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;oBACnB,KAAK,EAAE,uBAAuB;oBAC9B,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBAChE,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,kCAAkC;IAClC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAE5B,qBAAqB;IACrB,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC5B,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAElC,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACnC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE;YAC1B,OAAO,CAAC,KAAK,CAAC,yCAAyC,IAAI,IAAI,IAAI,MAAM,CAAC,CAAC;YAC3E,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;YACxD,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/transports/stdio.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function startStdioServer(server: McpServer): Promise<void>;

package/dist/src/transports/stdio.js

@@ -0,0 +1,18 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+export async function startStdioServer(server) {
+    const transport = new StdioServerTransport();
+    // Redirect stdout to stderr so console.log doesn't break protocol
+    const originalLog = console.log;
+    console.log = (...args) => {
+        console.error(...args);
+    };
+    try {
+        await server.connect(transport);
+        console.error("MCP Server (Stdio) is running.");
+    }
+    catch (error) {
+        console.error("Stdio connection failed:", error);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=stdio.js.map

package/dist/src/transports/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../../src/transports/stdio.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAiB;IACtD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,kEAAkE;IAClE,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;IAChC,OAAO,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,EAAE,EAAE;QACxB,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IACzB,CAAC,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/tests/security.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/security.test.js

@@ -0,0 +1,21 @@
+import { test } from "node:test";
+import assert from "node:assert";
+import path from "path";
+import { SecurityManager } from "../src/security.js";
+test("SecurityManager - Should allow paths inside allowed directories", () => {
+    const security = new SecurityManager("/tmp/sandbox");
+    const validated = security.resolveAndValidatePath("test.txt", "/tmp/sandbox");
+    assert.strictEqual(validated, path.resolve("/tmp/sandbox/test.txt"));
+});
+test("SecurityManager - Should block paths outside allowed directories", () => {
+    const security = new SecurityManager("/tmp/sandbox");
+    assert.throws(() => {
+        security.resolveAndValidatePath("../outside.txt", "/tmp/sandbox");
+    }, /Security Error/);
+});
+test("SecurityManager - Should allow subdirectory access", () => {
+    const security = new SecurityManager("/tmp/sandbox");
+    const validated = security.resolveAndValidatePath("subdir/file.ts", "/tmp/sandbox");
+    assert.strictEqual(validated, path.resolve("/tmp/sandbox/subdir/file.ts"));
+});
+//# sourceMappingURL=security.test.js.map

package/dist/tests/security.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.test.js","sourceRoot":"","sources":["../../tests/security.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,IAAI,CAAC,iEAAiE,EAAE,GAAG,EAAE;IAC3E,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,cAAc,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,QAAQ,CAAC,sBAAsB,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IAC9E,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC,CAAC;AACvE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,kEAAkE,EAAE,GAAG,EAAE;IAC5E,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,cAAc,CAAC,CAAC;IACrD,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE;QACjB,QAAQ,CAAC,sBAAsB,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;IACpE,CAAC,EAAE,gBAAgB,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,oDAAoD,EAAE,GAAG,EAAE;IAC9D,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,cAAc,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,QAAQ,CAAC,sBAAsB,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;IACpF,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC,CAAC;AAC7E,CAAC,CAAC,CAAC"}

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

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

package/dist/tools/file-tools.js

@@ -0,0 +1,102 @@
+import fs from "fs/promises";
+import path from "path";
+import { z } from "zod";
+import { CHARACTER_LIMIT } from "../constants.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."),
+        }).strict(),
+    }, async ({ path: filePath }) => {
+        try {
+            const validatedPath = security.resolveAndValidatePath(filePath);
+            let content = await fs.readFile(validatedPath, "utf-8");
+            if (content.length > CHARACTER_LIMIT) {
+                content = content.substring(0, CHARACTER_LIMIT) + "\n\n...[Content truncated for brevity]";
+            }
+            return {
+                content: [{ type: "text", text: content }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error reading 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");
+            return {
+                content: [{ type: "text", text: `Successfully wrote file: ${filePath}` }],
+            };
+        }
+        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,
+            };
+        }
+    });
+}
+//# sourceMappingURL=file-tools.js.map

package/dist/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/tools/lsp-tools.d.ts

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

package/dist/tools/lsp-tools.js

@@ -0,0 +1,70 @@
+import { Project } from "ts-morph";
+import { z } from "zod";
+/**
+ * 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 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();
+            const output = 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");
+            return {
+                content: [{ type: "text", text: output || "No TypeScript diagnostics found." }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `LSP Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=lsp-tools.js.map

package/dist/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/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;