winhelm-mcp 1.1.0

package/dist/gateway/streamable-gateway.js

@@ -0,0 +1,176 @@
+import { randomUUID } from "node:crypto";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { registerAllTools } from "../tools/index.js";
+export class StreamableGateway {
+    sessions = new Map();
+    cleanupTimer = null;
+    idleTimeoutMs;
+    maxSessions;
+    constructor(idleTimeoutMs = 45 * 60 * 1000, maxSessions = 100) {
+        this.idleTimeoutMs = idleTimeoutMs;
+        this.maxSessions = maxSessions;
+        // Check periodically for idle sessions; unref timer so it doesn't prevent process exit
+        const intervalMs = Math.min(60000, Math.max(1000, Math.floor(this.idleTimeoutMs / 2)));
+        this.cleanupTimer = setInterval(() => {
+            this.cleanupIdleSessions();
+        }, intervalMs);
+        if (this.cleanupTimer && this.cleanupTimer.unref) {
+            this.cleanupTimer.unref();
+        }
+    }
+    createMcpServerInstance() {
+        const server = new McpServer({
+            name: "winhelm-mcp",
+            version: "1.1.0",
+        });
+        registerAllTools(server);
+        return server;
+    }
+    /**
+     * Evict the least recently used session if capacity is reached
+     */
+    evictOldestIfNeeded() {
+        while (this.sessions.size >= this.maxSessions) {
+            let oldestKey = null;
+            let oldestTime = Infinity;
+            for (const [key, session] of this.sessions.entries()) {
+                if (session.lastActivityAt < oldestTime) {
+                    oldestTime = session.lastActivityAt;
+                    oldestKey = key;
+                }
+            }
+            if (oldestKey) {
+                const session = this.sessions.get(oldestKey);
+                this.sessions.delete(oldestKey);
+                if (session) {
+                    session.mcpServer.close().catch(() => { });
+                }
+            }
+            else {
+                break;
+            }
+        }
+    }
+    /**
+     * Cleanup sessions that have been idle longer than idleTimeoutMs
+     */
+    cleanupIdleSessions() {
+        const now = Date.now();
+        let count = 0;
+        for (const [key, session] of this.sessions.entries()) {
+            if (now - session.lastActivityAt > this.idleTimeoutMs) {
+                this.sessions.delete(key);
+                session.mcpServer.close().catch(() => { });
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * Handle ALL /mcp - Streamable HTTP transport
+     */
+    async handleRequest(req, res) {
+        try {
+            const sessionId = req.headers["mcp-session-id"];
+            // If an existing session ID is provided and active, use it.
+            // If provided but not found (evicted, idle timeout, or server restart),
+            // return 404 with JSON-RPC error immediately according to MCP specification.
+            if (sessionId) {
+                const session = this.sessions.get(sessionId);
+                if (!session) {
+                    res.status(404).json({
+                        jsonrpc: "2.0",
+                        error: { code: -32001, message: "Session not found" },
+                        id: null,
+                    });
+                    return;
+                }
+                session.lastActivityAt = Date.now();
+                await session.transport.handleRequest(req, res);
+                return;
+            }
+            // Create a new session for initialize requests
+            const mcpServer = this.createMcpServerInstance();
+            const transport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: () => randomUUID(),
+                onsessioninitialized: (newSessionId) => {
+                    this.evictOldestIfNeeded();
+                    this.sessions.set(newSessionId, {
+                        transport,
+                        mcpServer,
+                        lastActivityAt: Date.now(),
+                    });
+                },
+                onsessionclosed: (closedSessionId) => {
+                    const session = this.sessions.get(closedSessionId);
+                    if (session) {
+                        this.sessions.delete(closedSessionId);
+                        session.mcpServer.close().catch(() => { });
+                    }
+                },
+            });
+            // Set transport.onclose BEFORE mcpServer.connect(transport)
+            // so Protocol.connect preserves our handler alongside Protocol._onclose
+            transport.onclose = () => {
+                const sid = transport.sessionId;
+                if (sid) {
+                    this.sessions.delete(sid);
+                }
+                mcpServer.close().catch(() => { });
+            };
+            await mcpServer.connect(transport);
+            await transport.handleRequest(req, res);
+            // If transport.sessionId is still undefined after handleRequest
+            // (not an initialize request or request was rejected/invalid), clean up immediately to prevent leaks
+            if (!transport.sessionId) {
+                await transport.close().catch(() => { });
+                await mcpServer.close().catch(() => { });
+            }
+        }
+        catch (err) {
+            console.error("[StreamableHTTP] Error handling /mcp request:", err);
+            if (!res.headersSent) {
+                res.status(500).json({ error: "Internal server error", message: err.message });
+            }
+        }
+    }
+    getActiveSessionCount() {
+        return this.sessions.size;
+    }
+    getSession(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    setSessionLastActivity(sessionId, timestamp) {
+        const session = this.sessions.get(sessionId);
+        if (session) {
+            session.lastActivityAt = timestamp;
+            return true;
+        }
+        return false;
+    }
+    registerSessionForTest(sessionId, session = {}) {
+        this.evictOldestIfNeeded();
+        this.sessions.set(sessionId, {
+            transport: session.transport || {},
+            mcpServer: session.mcpServer || { close: async () => { } },
+            lastActivityAt: session.lastActivityAt ?? Date.now(),
+        });
+    }
+    async closeAll() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+        for (const session of this.sessions.values()) {
+            try {
+                await session.mcpServer.close();
+            }
+            catch {
+                // ignore
+            }
+        }
+        this.sessions.clear();
+    }
+}
+//# sourceMappingURL=streamable-gateway.js.map

package/dist/gateway/streamable-gateway.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { ConfigManager } from "./config/config-manager.js";
+import { createServer } from "./gateway/server.js";
+export { createServer, ConfigManager };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AA+KnD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,164 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ConfigManager } from "./config/config-manager.js";
+import { createServer } from "./gateway/server.js";
+import { isValidProfile, resolveCustomTools } from "./config/profiles.js";
+import { registerAllTools } from "./tools/index.js";
+// Parse CLI arguments
+const args = process.argv.slice(2);
+function getArg(flag, fallback) {
+    for (const arg of args) {
+        if (arg.startsWith(`${flag}=`)) {
+            return arg.slice(flag.length + 1);
+        }
+    }
+    const idx = args.indexOf(flag);
+    return idx !== -1 && args[idx + 1] && !args[idx + 1].startsWith("-") ? args[idx + 1] : fallback;
+}
+if (args.includes("--help") || args.includes("-h")) {
+    console.log(`
+WinHelm - Windows Native MCP Server
+Usage:
+  winhelm [options]
+
+Options:
+  --config <path>       Load configuration from a specific JSON file (e.g. project-specific config)
+  --port <number>       Port to listen on (default: 8788 or PORT env)
+  --host <string>       Host interface (default: 127.0.0.1 or HOST env)
+  --profile, -p <name>  Tool profile: minimal (6), core (15), dev (28), sysadmin (37), full (38) (default: full)
+  --stdio               Run in stdio mode for local MCP clients (OpenAI tunnel-client, Claude, Cursor)
+  --transport <type>    Transport mode: http (default) or stdio
+  --auth <token>        Bearer authentication token (or MCP_AUTH_TOKEN env)
+  --read-only           Enable read-only mode (block mutating actions)
+  --allowed-dirs <list> Comma-separated allowed directories (e.g. "D:\\mcp,C:\\Projects")
+  --tools <list>        Explicit comma-separated tools to load or +tool/-tool modifiers
+  --no-persist          Do not persist CLI overrides to config file (default behavior)
+  --persist             Persist CLI overrides back to config file
+  --help, -h            Show this help message
+`);
+    process.exit(0);
+}
+async function main() {
+    const IS_STDIO = args.includes("--stdio") || getArg("--transport") === "stdio";
+    if (IS_STDIO) {
+        // In stdio mode, process.stdout is the JSON-RPC wire. All logs must go to stderr.
+        console.log = (...a) => console.error(...a);
+    }
+    const CONFIG_ARG = getArg("--config");
+    const NO_PERSIST = args.includes("--no-persist");
+    const configManager = ConfigManager.getInstance(CONFIG_ARG);
+    await configManager.init(CONFIG_ARG);
+    const PORT = parseInt(getArg("--port", process.env.PORT || "8788"), 10);
+    const HOST = getArg("--host", process.env.HOST || "127.0.0.1");
+    const AUTH_TOKEN = getArg("--auth", process.env.MCP_AUTH_TOKEN || undefined);
+    const ALLOWED_DIRS = getArg("--allowed-dirs", process.env.MCP_ALLOWED_DIRECTORIES || undefined);
+    const READ_ONLY = args.includes("--read-only") || process.env.MCP_READ_ONLY === "true" || process.env.MCP_READ_ONLY === "1";
+    const PROFILE_ARG = getArg("--profile", getArg("-p", process.env.WINHELM_PROFILE || undefined));
+    const TOOLS_ARG = getArg("--tools");
+    const updates = {};
+    if (AUTH_TOKEN)
+        updates.authToken = AUTH_TOKEN;
+    if (READ_ONLY)
+        updates.readOnly = true;
+    if (PROFILE_ARG) {
+        if (isValidProfile(PROFILE_ARG)) {
+            updates.profile = PROFILE_ARG;
+        }
+        else {
+            console.error(`[WinHelm] Unknown profile: "${PROFILE_ARG}". Valid profiles: minimal, core, dev, sysadmin, full, custom`);
+            process.exit(1);
+        }
+    }
+    if (TOOLS_ARG) {
+        const baseProfile = (updates.profile || configManager.getConfig().profile || "full");
+        updates.customTools = resolveCustomTools(baseProfile, TOOLS_ARG);
+        if (!updates.profile)
+            updates.profile = "custom";
+    }
+    if (ALLOWED_DIRS) {
+        updates.allowedDirectories = ALLOWED_DIRS.split(",")
+            .map((d) => d.trim())
+            .filter(Boolean);
+    }
+    if (Object.keys(updates).length > 0) {
+        // By default, CLI overrides are in-memory session-only unless --persist is explicitly passed
+        const shouldPersist = args.includes("--persist") && !NO_PERSIST;
+        await configManager.updateConfig(updates, shouldPersist);
+    }
+    // Security warning if bound to non-loopback with no authentication token
+    const isLoopback = HOST === "127.0.0.1" || HOST.toLowerCase() === "localhost" || HOST === "::1";
+    const effectiveAuthToken = AUTH_TOKEN || configManager.getConfig().authToken;
+    if (!isLoopback && !effectiveAuthToken && !IS_STDIO) {
+        console.warn("\n" + "=".repeat(78));
+        console.warn("⚠️  WARNING: Server is bound to a non-loopback address with NO authentication token.");
+        console.warn(`   Interface: ${HOST}:${PORT}`);
+        console.warn("   Anyone on this network can execute commands on this machine.");
+        console.warn("   To protect your system, specify --auth <token> or set MCP_AUTH_TOKEN in environment.");
+        console.warn("=".repeat(78) + "\n");
+    }
+    if (IS_STDIO) {
+        const mcpServer = new McpServer({
+            name: "winhelm-mcp",
+            version: "1.1.0",
+        });
+        registerAllTools(mcpServer);
+        const transport = new StdioServerTransport();
+        await mcpServer.connect(transport);
+        console.error(`[WinHelm] Connected via stdio transport (Profile: ${configManager.getConfig().profile || "full"}).`);
+        const shutdown = async () => {
+            await mcpServer.close().catch(() => { });
+            process.exit(0);
+        };
+        process.on("SIGINT", shutdown);
+        process.on("SIGTERM", shutdown);
+        return;
+    }
+    const { start, stop } = createServer({
+        port: PORT,
+        host: HOST,
+        authToken: AUTH_TOKEN,
+    });
+    const server = await start();
+    let isShuttingDown = false;
+    const shutdown = async () => {
+        if (isShuttingDown) {
+            console.log("\n[WinHelm] Force exit.");
+            process.exit(0);
+        }
+        isShuttingDown = true;
+        console.log("\n[WinHelm] Shutting down server gracefully...");
+        // Safety timeout in case of any lingering event loop handles
+        const forceExitTimer = setTimeout(() => {
+            console.log("[WinHelm] Server stopped. Goodbye!");
+            process.exit(0);
+        }, 1200);
+        forceExitTimer.unref();
+        try {
+            await stop(server);
+        }
+        catch {
+            // ignore
+        }
+        console.log("[WinHelm] Server stopped. Goodbye!");
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+}
+// Auto-run if executed directly or in standalone SEA binary
+const argv1 = process.argv[1] || "";
+const isSeaBinary = process.execPath.toLowerCase().endsWith(".exe") && !process.execPath.toLowerCase().endsWith("node.exe");
+const isDirectEntry = isSeaBinary ||
+    argv1.endsWith("index.ts") ||
+    argv1.endsWith("index.js") ||
+    argv1.endsWith("winhelm") ||
+    (typeof import.meta !== "undefined" && import.meta?.url && argv1 && import.meta.url.includes(argv1.replace(/\\/g, "/")));
+if (isDirectEntry) {
+    main().catch((err) => {
+        console.error("[WinHelm] Fatal error on startup:", err);
+        process.exit(1);
+    });
+}
+export { createServer, ConfigManager };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

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

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerDesktopTools(server: McpServer): void;
+//# sourceMappingURL=desktop-tools.d.ts.map

package/dist/tools/desktop-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-tools.d.ts","sourceRoot":"","sources":["../../src/tools/desktop-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmBzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoU5D"}

package/dist/tools/desktop-tools.js

@@ -0,0 +1,280 @@
+import { z } from "zod";
+import { captureScreen, checkPort, controlService, getClipboard, getGpuInfo, getServiceStatus, getSystemInfo, killProcess, listProcesses, listServices, openTarget, queryEventLog, sendNotification, setClipboard, } from "../engine/system.js";
+import { registerTracedTool } from "./tool-wrapper.js";
+export function registerDesktopTools(server) {
+    // 1. Clipboard Get
+    registerTracedTool(server, "clipboard_get", {}, async () => {
+        try {
+            const text = await getClipboard();
+            return {
+                content: [{ type: "text", text: text || "(Clipboard is empty or contains non-text data)" }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Failed to get clipboard: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // 2. Clipboard Set
+    registerTracedTool(server, "clipboard_set", {
+        text: z.string().describe("Text content to copy to Windows clipboard"),
+    }, async ({ text }) => {
+        try {
+            await setClipboard(text);
+            return {
+                content: [
+                    { type: "text", text: `Successfully copied ${text.length} characters to clipboard` },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Failed to set clipboard: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // 3. Screen Capture
+    registerTracedTool(server, "screen_capture", {}, async () => {
+        try {
+            const base64 = await captureScreen();
+            return {
+                content: [
+                    {
+                        type: "image",
+                        data: base64,
+                        mimeType: "image/png",
+                    },
+                    {
+                        type: "text",
+                        text: "Screenshot captured successfully (primary display).",
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Screenshot failed: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // 4. System Open (URL, Folder, File)
+    registerTracedTool(server, "system_open", {
+        target: z.string().describe("URL, folder path, or file to open with default application"),
+    }, async ({ target }) => {
+        try {
+            const res = await openTarget(target);
+            return {
+                content: [{ type: "text", text: `Opened: ${res.target}` }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Open failed: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // 5. System Info
+    registerTracedTool(server, "system_info", {}, async () => {
+        try {
+            const info = await getSystemInfo();
+            return {
+                content: [{ type: "text", text: JSON.stringify(info, null, 2) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Failed to get system info: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // 6. Process Kill
+    registerTracedTool(server, "process_kill", {
+        pid: z.number().optional().describe("Process ID to terminate"),
+        name: z.string().optional().describe("Process Name (e.g. 'node', 'notepad')"),
+    }, async ({ pid, name }) => {
+        try {
+            const res = await killProcess(pid, name);
+            return {
+                content: [{ type: "text", text: JSON.stringify(res, null, 2) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Kill process failed: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // 7. Port Check
+    registerTracedTool(server, "port_check", {
+        port: z.number().describe("TCP port number to check (e.g. 8788, 3000)"),
+    }, async ({ port }) => {
+        try {
+            const res = await checkPort(port);
+            return {
+                content: [{ type: "text", text: JSON.stringify(res, null, 2) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Port check failed: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // 8. GPU Info
+    registerTracedTool(server, "gpu_info", {}, async () => {
+        try {
+            const info = await getGpuInfo();
+            return {
+                content: [{ type: "text", text: JSON.stringify(info, null, 2) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Failed to query GPU info: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // 9. Windows Services List
+    registerTracedTool(server, "service_list", {
+        filter: z.string().optional().describe("Filter services by name substring (e.g. 'docker', 'ssh', 'postgres')"),
+    }, async ({ filter }) => {
+        try {
+            const services = await listServices(filter);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: services.length > 0
+                            ? JSON.stringify(services, null, 2)
+                            : `No services matching filter "${filter || ""}"`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Failed to list services: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // 10. Windows Service Status
+    registerTracedTool(server, "service_status", {
+        service_name: z.string().describe("Exact name of the Windows service (e.g. 'ssh-agent', 'wslservice')"),
+    }, async ({ service_name }) => {
+        try {
+            const status = await getServiceStatus(service_name);
+            return {
+                content: [{ type: "text", text: JSON.stringify(status, null, 2) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Failed to get service status: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // 11. Windows Service Control
+    registerTracedTool(server, "service_control", {
+        service_name: z.string().describe("Exact name of the Windows service to control"),
+        action: z.enum(["start", "stop", "restart"]).describe("Action to perform on the service"),
+    }, async ({ service_name, action }) => {
+        try {
+            const res = await controlService(service_name, action);
+            return {
+                content: [{ type: "text", text: JSON.stringify(res, null, 2) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Failed to ${action} service: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // 12. Process List & Top Processes
+    registerTracedTool(server, "process_list", {
+        limit: z.number().optional().describe("Maximum number of processes to return (default: 20, max: 100)"),
+        sort_by: z.enum(["cpu", "memory", "name", "pid"]).optional().describe("Sort processes by resource or property (default: memory)"),
+        filter: z.string().optional().describe("Filter process name or path substring"),
+    }, async ({ limit, sort_by, filter }) => {
+        try {
+            const procs = await listProcesses({
+                limit,
+                sortBy: sort_by,
+                filter,
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(procs, null, 2) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Failed to list processes: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // 13. Windows Event Log Query
+    registerTracedTool(server, "eventlog_query", {
+        log_name: z.string().optional().describe("Windows Event Log name (e.g. 'Application', 'System', default: 'Application')"),
+        level: z.enum(["Critical", "Error", "Warning", "Information", "All"]).optional().describe("Event severity level (default: Error)"),
+        hours: z.number().optional().describe("Query events from past N hours (default: 24)"),
+        source: z.string().optional().describe("Filter by provider or application source name"),
+        limit: z.number().optional().describe("Maximum number of events to return (default: 20, max: 100)"),
+    }, async ({ log_name, level, hours, source, limit }) => {
+        try {
+            const events = await queryEventLog({
+                logName: log_name,
+                level,
+                hours,
+                source,
+                limit,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: events.length > 0 ? JSON.stringify(events, null, 2) : "[] (No matching events found)",
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Failed to query event log: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // 14. Windows Toast Notification
+    registerTracedTool(server, "notification_send", {
+        title: z.string().describe("Toast notification title (e.g. 'Task Complete')"),
+        message: z.string().describe("Notification body text"),
+        sound: z.boolean().optional().describe("Play alert sound with notification (default: true)"),
+    }, async ({ title, message, sound }) => {
+        try {
+            const res = await sendNotification(title, message, sound !== false);
+            return {
+                content: [{ type: "text", text: `Notification sent: "${res.title}" - ${res.message}` }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Failed to send notification: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=desktop-tools.js.map