@calltelemetry/ct-lab-mcp 0.1.0

package/dist/src/tools/vm-action.js

@@ -0,0 +1,300 @@
+/**
+ * VM Action MCP Tool Handler
+ *
+ * Handles VM lifecycle operations (start, stop, reboot, shutdown, reset, status, clone, destroy)
+ * with non-bypassable safety guardrail enforcement protecting core fixtures and templates.
+ */
+import { z } from "zod";
+import { ProxmoxErrorCode, createToolErrorResult, } from "../types/index.js";
+import { defaultSafetyGuardrailEngine, ProtectedVmViolationError, } from "../guardrails/safety.js";
+import { formatVmActionResult } from "../utils/formatters.js";
+export const VmActionInputShape = {
+    vmIdOrName: z
+        .union([z.string().min(1), z.number().int().positive("VMID must be a positive integer.")])
+        .optional()
+        .describe("Target VMID (e.g. 105, 104) or VM name/path (e.g. 'ct-appliance-uat-105', 'CUCM14-01-6-30')."),
+    vmid: z
+        .union([z.string().min(1), z.number().int().positive("VMID must be a positive integer.")])
+        .optional()
+        .describe("Proxmox Virtual Machine ID or identifier (alias for vmIdOrName)."),
+    host: z
+        .string()
+        .optional()
+        .describe("Target hypervisor host hosting the VM (e.g. 'proxmox-lab', 'proxmox-mini', 'esxi-intel-192-168-123-176')."),
+    targetHost: z
+        .string()
+        .optional()
+        .describe("Alias for host."),
+    action: z
+        .enum(["start", "stop", "reboot", "shutdown", "reset", "status", "clone", "destroy", "config"])
+        .describe("VM lifecycle action to execute."),
+    cloneOptions: z
+        .object({
+        newid: z.number().int().positive().optional().describe("Target VMID for the cloned VM."),
+        newVmId: z.union([z.string(), z.number()]).optional(),
+        name: z.string().optional().describe("Name for the new cloned VM."),
+        newVmName: z.string().optional(),
+        targetHost: z.string().optional().describe("Target host for the clone if cross-node."),
+        full: z.boolean().optional().default(true).describe("Full clone vs linked clone."),
+        vlan: z.number().int().optional(),
+        ipAddress: z.string().optional(),
+        macAddress: z.string().optional(),
+        linearIssue: z.string().optional(),
+        tags: z.union([z.array(z.string()), z.string()]).optional(),
+    })
+        .optional()
+        .describe("Configuration options required when action is 'clone'."),
+    force: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Force action (e.g. hard power-off stop or force destroy). Note: Guardrails cannot be bypassed with force=true."),
+    timeoutSeconds: z
+        .number()
+        .int()
+        .min(1)
+        .max(600)
+        .optional()
+        .describe("Timeout in seconds to wait for task completion."),
+};
+export const VmActionInputSchema = z
+    .object(VmActionInputShape)
+    .refine((data) => data.vmIdOrName !== undefined || data.vmid !== undefined, { message: "Either 'vmIdOrName' or 'vmid' must be provided." });
+export async function handleVmAction(rawArgs, context) {
+    try {
+        const parseResult = VmActionInputSchema.safeParse(rawArgs);
+        if (!parseResult.success) {
+            const errMsg = parseResult.error.errors.map((e) => `${e.path.join(".")}: ${e.message}`).join("; ");
+            return createToolErrorResult(ProxmoxErrorCode.VALIDATION_ERROR, errMsg);
+        }
+        const args = parseResult.data;
+        const targetVm = (args.vmIdOrName !== undefined ? args.vmIdOrName : args.vmid);
+        const targetHost = args.host || args.targetHost;
+        const guardrailEngine = context.guardrailEngine || defaultSafetyGuardrailEngine;
+        let vmName = String(targetVm);
+        let isProtected;
+        let protectionReason;
+        let isTemplate;
+        let tags;
+        let hostName = targetHost || "unknown";
+        if (context.hypervisorManager) {
+            const found = await context.hypervisorManager.findVm(targetVm, targetHost);
+            if (found) {
+                vmName = found.vm.name;
+                isProtected = found.vm.isProtected;
+                protectionReason = found.vm.protectionReason;
+                isTemplate = found.vm.isTemplate;
+                tags = found.vm.tags;
+                hostName = found.driver.hostName;
+            }
+        }
+        if (vmName === String(targetVm) && context.proxmoxManager) {
+            const hostId = (targetHost || "proxmox-lab");
+            try {
+                const client = context.proxmoxManager.getClient(hostId);
+                const vms = await client.listVms();
+                const found = vms.find((v) => v.vmid === Number(targetVm) || v.name.toLowerCase() === String(targetVm).toLowerCase());
+                if (found) {
+                    vmName = found.name;
+                    isTemplate = found.template;
+                    tags = typeof found.tags === "string" ? found.tags.split(";") : undefined;
+                }
+            }
+            catch { }
+        }
+        // Validate guardrails
+        const vmTarget = {
+            vmid: targetVm,
+            name: vmName,
+            isProtected,
+            protectionReason,
+            template: isTemplate,
+            tags,
+            hostId: hostName,
+        };
+        try {
+            guardrailEngine.validateAction(vmTarget, args.action, args.force);
+        }
+        catch (guardrailErr) {
+            if (guardrailErr instanceof ProtectedVmViolationError) {
+                return createToolErrorResult(ProxmoxErrorCode.PROTECTED_VM_ACTION_DENIED, guardrailErr.message, {
+                    vmid: guardrailErr.vmid,
+                    vmName: guardrailErr.vmName,
+                    action: guardrailErr.action,
+                    reason: guardrailErr.reason,
+                });
+            }
+            throw guardrailErr;
+        }
+        // 1. If hypervisorManager is available, use unified multi-hypervisor manager
+        if (context.hypervisorManager) {
+            if (args.action === "clone") {
+                const cloneOpts = args.cloneOptions;
+                const newName = cloneOpts?.name || cloneOpts?.newVmName || `clone-${targetVm}`;
+                const newId = cloneOpts?.newid || cloneOpts?.newVmId;
+                const res = await context.hypervisorManager.provisionVm({
+                    sourceVmIdOrName: targetVm,
+                    newVmName: newName,
+                    newVmId: newId,
+                    targetHost: cloneOpts?.targetHost || targetHost,
+                    fullClone: cloneOpts?.full,
+                    vlan: cloneOpts?.vlan,
+                    ipAddress: cloneOpts?.ipAddress,
+                    macAddress: cloneOpts?.macAddress,
+                    linearIssue: cloneOpts?.linearIssue,
+                    tags: Array.isArray(cloneOpts?.tags) ? cloneOpts.tags : (cloneOpts?.tags ? [cloneOpts.tags] : undefined),
+                });
+                const formatted = formatVmActionResult({
+                    host: res.hostName,
+                    vmid: typeof targetVm === "number" ? targetVm : parseInt(String(targetVm), 10) || 100,
+                    action: "clone",
+                    success: true,
+                    message: `Successfully cloned VM '${targetVm}' to '${res.name}' (${res.vmId}) on host '${res.hostName}'.`,
+                    details: { clonedVm: res },
+                });
+                return {
+                    content: [{ type: "text", text: formatted.markdown }],
+                    structuredContent: formatted.structuredContent,
+                };
+            }
+            const actionParams = {
+                vmIdOrName: targetVm,
+                action: args.action,
+                force: args.force,
+                targetHost: targetHost,
+                timeoutSeconds: args.timeoutSeconds,
+            };
+            const result = await context.hypervisorManager.vmAction(actionParams);
+            const formatted = formatVmActionResult({
+                host: result.hostName,
+                vmid: typeof targetVm === "number" ? targetVm : parseInt(String(targetVm), 10) || 100,
+                action: result.action,
+                success: result.success,
+                message: result.message,
+                details: {
+                    previousStatus: result.previousStatus,
+                    newStatus: result.newStatus,
+                    hypervisor: result.hypervisor,
+                },
+            });
+            return {
+                content: [{ type: "text", text: formatted.markdown }],
+                structuredContent: formatted.structuredContent,
+            };
+        }
+        // 2. Standalone ProxmoxManager fallback
+        if (!context.proxmoxManager) {
+            return createToolErrorResult(ProxmoxErrorCode.UPSTREAM_API_ERROR, "No hypervisor manager configured on this MCP server instance.");
+        }
+        const numericVmid = typeof targetVm === "number" ? targetVm : parseInt(String(targetVm), 10);
+        const hostId = (targetHost || "proxmox-lab");
+        const client = context.proxmoxManager.getClient(hostId);
+        // Guardrail validation
+        let fallbackVmTarget = { vmid: numericVmid, hostId };
+        let vmStatus;
+        try {
+            vmStatus = await client.getVmStatus(numericVmid);
+            fallbackVmTarget = {
+                vmid: numericVmid,
+                name: vmStatus.name,
+                template: vmStatus.template,
+                tags: vmStatus.tags,
+                hostId,
+            };
+        }
+        catch {
+            // ignore get status failure
+        }
+        let taskResult;
+        let message;
+        switch (args.action) {
+            case "status":
+                if (!vmStatus) {
+                    vmStatus = await client.getVmStatus(numericVmid);
+                }
+                message = `VM ${numericVmid} is currently ${vmStatus.status} (${vmStatus.name}).`;
+                break;
+            case "start":
+                taskResult = await client.startVm(numericVmid);
+                message = `Start command dispatched for VM ${numericVmid}.`;
+                break;
+            case "stop":
+                taskResult = await client.stopVm(numericVmid);
+                message = `Stop command dispatched for VM ${numericVmid}.`;
+                break;
+            case "shutdown":
+                taskResult = await client.shutdownVm(numericVmid);
+                message = `Graceful shutdown initiated for VM ${numericVmid}.`;
+                break;
+            case "reboot":
+                taskResult = await client.rebootVm(numericVmid);
+                message = `Reboot command initiated for VM ${numericVmid}.`;
+                break;
+            case "clone": {
+                const newid = args.cloneOptions?.newid || (numericVmid >= 9000 ? 500 : numericVmid + 100);
+                const name = args.cloneOptions?.name || `vm-${newid}-clone`;
+                const full = args.cloneOptions?.full ?? true;
+                taskResult = await client.cloneVm(numericVmid, newid, name, {
+                    full,
+                    target: args.cloneOptions?.targetHost,
+                });
+                message = `Successfully cloned VM ${numericVmid} to new VM ${newid} ('${name}').`;
+                break;
+            }
+            case "destroy":
+                taskResult = await client.destroyVm(numericVmid, { purge: true });
+                message = `Successfully destroyed VM ${numericVmid}.`;
+                break;
+            default:
+                return createToolErrorResult(ProxmoxErrorCode.VALIDATION_ERROR, `Unsupported VM action: '${args.action}'.`);
+        }
+        if (args.action !== "destroy" && args.action !== "status") {
+            try {
+                vmStatus = await client.getVmStatus(numericVmid);
+            }
+            catch {
+                // Status may not be immediately updated
+            }
+        }
+        const formatted = formatVmActionResult({
+            host: hostId,
+            vmid: numericVmid,
+            action: args.action,
+            success: taskResult ? taskResult.success : true,
+            taskResult,
+            vmStatus,
+            message,
+        });
+        return {
+            content: [{ type: "text", text: formatted.markdown }],
+            structuredContent: formatted.structuredContent,
+        };
+    }
+    catch (error) {
+        if (error instanceof ProtectedVmViolationError) {
+            return createToolErrorResult(ProxmoxErrorCode.PROTECTED_VM_ACTION_DENIED, error.message, {
+                vmid: error.vmid,
+                vmName: error.vmName,
+                action: error.action,
+                reason: error.reason,
+            });
+        }
+        if (error instanceof z.ZodError) {
+            return createToolErrorResult(ProxmoxErrorCode.VALIDATION_ERROR, `Validation error: ${error.errors.map((e) => `${e.path.join(".")}: ${e.message}`).join(", ")}`);
+        }
+        const msg = error instanceof Error ? error.message : String(error);
+        const msgLower = msg.toLowerCase();
+        let code = ProxmoxErrorCode.UPSTREAM_API_ERROR;
+        if (msgLower.includes("not found") || msgLower.includes("404") || msgLower.includes("does not exist")) {
+            code = ProxmoxErrorCode.VM_NOT_FOUND;
+        }
+        else if (msgLower.includes("invalid state") || msgLower.includes("already running") || msgLower.includes("not running")) {
+            code = ProxmoxErrorCode.INVALID_VM_STATE;
+        }
+        else if (msgLower.includes("401") || msgLower.includes("unauthorized") || msgLower.includes("auth")) {
+            code = ProxmoxErrorCode.AUTHENTICATION_ERROR;
+        }
+        return createToolErrorResult(code, msg);
+    }
+}
+//# sourceMappingURL=vm-action.js.map

package/dist/src/tools/vm-action.js.map

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

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

@@ -0,0 +1,3 @@
+export * from "./stdio.js";
+export * from "./sse.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/transports/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transports/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC"}

package/dist/src/transports/index.js

@@ -0,0 +1,3 @@
+export * from "./stdio.js";
+export * from "./sse.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/transports/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC"}

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

@@ -0,0 +1,38 @@
+/**
+ * HTTP with Server-Sent Events (SSE) Transport for Call Telemetry Lab MCP Server
+ * Provides multi-client networked HTTP communication over SSE with session routing,
+ * health status monitoring, and DNS rebinding protection.
+ */
+import { Express } from "express";
+import { Server as HttpServer } from "node:http";
+import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { SlotManager } from "../slot/manager.js";
+import { MultiHypervisorManager } from "../hypervisors/manager.js";
+export interface ActiveSession {
+    sessionId: string;
+    transport: SSEServerTransport;
+    server: McpServer;
+    createdAt: number;
+    lastActiveAt: number;
+}
+export interface SseServerOptions {
+    port?: number;
+    host?: string;
+    allowedHosts?: string[];
+    slotManager?: SlotManager;
+    hypervisorManager?: MultiHypervisorManager;
+    sessionTimeoutMs?: number;
+}
+export interface SseServerInstance {
+    app: Express;
+    httpServer?: HttpServer;
+    sessions: Map<string, ActiveSession>;
+    listen(port?: number, host?: string): Promise<HttpServer>;
+    close(): Promise<void>;
+}
+/**
+ * Creates an Express application and SSE server instance configured for Call Telemetry Lab MCP.
+ */
+export declare function createSseServer(serverFactoryOrInstance: McpServer | (() => McpServer), options?: SseServerOptions): SseServerInstance;
+//# sourceMappingURL=sse.d.ts.map

package/dist/src/transports/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../src/transports/sse.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAqB,MAAM,SAAS,CAAC;AACrD,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAE7E,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAGnE,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;IAC3C,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,OAAO,CAAC;IACb,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACrC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,uBAAuB,EAAE,SAAS,GAAG,CAAC,MAAM,SAAS,CAAC,EACtD,OAAO,GAAE,gBAAqB,GAC7B,iBAAiB,CA4KnB"}

package/dist/src/transports/sse.js

@@ -0,0 +1,167 @@
+/**
+ * HTTP with Server-Sent Events (SSE) Transport for Call Telemetry Lab MCP Server
+ * Provides multi-client networked HTTP communication over SSE with session routing,
+ * health status monitoring, and DNS rebinding protection.
+ */
+import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
+import { createMcpExpressApp } from "@modelcontextprotocol/sdk/server/express.js";
+import { logger } from "../utils/logger.js";
+/**
+ * Creates an Express application and SSE server instance configured for Call Telemetry Lab MCP.
+ */
+export function createSseServer(serverFactoryOrInstance, options = {}) {
+    const host = options.host || "127.0.0.1";
+    const port = options.port || 3000;
+    const sessionTimeoutMs = options.sessionTimeoutMs || 30 * 60 * 1000; // 30 minutes
+    // createMcpExpressApp includes express.json() and DNS rebinding validation
+    const app = createMcpExpressApp(options.allowedHosts
+        ? { host, allowedHosts: options.allowedHosts }
+        : { host });
+    const sessions = new Map();
+    let activeHttpServer;
+    // Background session cleanup timer
+    const cleanupInterval = setInterval(() => {
+        const now = Date.now();
+        for (const [id, session] of sessions.entries()) {
+            if (now - session.lastActiveAt > sessionTimeoutMs) {
+                logger.warn(`Pruning timed out SSE session: ${id}`);
+                sessions.delete(id);
+                session.transport.close().catch(() => { });
+                session.server.close().catch(() => { });
+            }
+        }
+    }, 60000);
+    if (cleanupInterval.unref) {
+        cleanupInterval.unref();
+    }
+    // 1. Health Status Endpoint (GET /health)
+    app.get("/health", async (_req, res) => {
+        let capacity;
+        if (options.slotManager) {
+            try {
+                capacity = await options.slotManager.listHosts();
+            }
+            catch (err) {
+                logger.error("Failed to query capacity for /health:", err);
+            }
+        }
+        let hostCapacities;
+        if (options.hypervisorManager) {
+            try {
+                hostCapacities = await options.hypervisorManager.listAllHostsCapacity();
+            }
+            catch (err) {
+                logger.error("Failed to query hypervisor capacities for /health:", err);
+            }
+        }
+        res.status(200).json({
+            status: "healthy",
+            timestamp: new Date().toISOString(),
+            version: "0.1.0",
+            activeSessions: sessions.size,
+            capacity,
+            hostCapacities,
+        });
+    });
+    // 2. SSE Connection Endpoint (GET /sse)
+    app.get("/sse", async (_req, res) => {
+        try {
+            const serverInstance = typeof serverFactoryOrInstance === "function"
+                ? serverFactoryOrInstance()
+                : serverFactoryOrInstance;
+            const transport = new SSEServerTransport("/messages", res);
+            const sessionId = transport.sessionId;
+            logger.info(`Established SSE connection: ${sessionId}`);
+            const session = {
+                sessionId,
+                transport,
+                server: serverInstance,
+                createdAt: Date.now(),
+                lastActiveAt: Date.now(),
+            };
+            sessions.set(sessionId, session);
+            res.on("close", async () => {
+                logger.info(`SSE connection closed for session: ${sessionId}`);
+                sessions.delete(sessionId);
+                try {
+                    await transport.close();
+                }
+                catch { }
+                try {
+                    await serverInstance.close();
+                }
+                catch { }
+            });
+            // server.connect() starts the transport automatically
+            await serverInstance.connect(transport);
+        }
+        catch (err) {
+            logger.error("Error establishing SSE session:", err);
+            if (!res.headersSent) {
+                res.status(500).json({ error: "Failed to establish SSE session" });
+            }
+        }
+    });
+    // 3. Message Ingestion Endpoint (POST /messages)
+    app.post("/messages", async (req, res) => {
+        const sessionId = req.query.sessionId || req.headers["x-session-id"];
+        if (!sessionId || !sessions.has(sessionId)) {
+            res.status(404).json({ error: `Session not found: ${sessionId || "none"}` });
+            return;
+        }
+        const session = sessions.get(sessionId);
+        session.lastActiveAt = Date.now();
+        try {
+            await session.transport.handlePostMessage(req, res, req.body);
+        }
+        catch (err) {
+            logger.error(`Error handling POST message for session ${sessionId}:`, err);
+            if (!res.headersSent) {
+                res.status(500).json({ error: "Failed to handle message" });
+            }
+        }
+    });
+    const instance = {
+        app,
+        sessions,
+        async listen(customPort, customHost) {
+            const targetPort = customPort !== undefined ? customPort : port;
+            const targetHost = customHost || host;
+            return new Promise((resolve) => {
+                activeHttpServer = app.listen(targetPort, targetHost, () => {
+                    console.error(`[ct-lab-mcp-sse] Call Telemetry Lab MCP SSE server listening at http://${targetHost}:${targetPort}`);
+                    resolve(activeHttpServer);
+                });
+                instance.httpServer = activeHttpServer;
+            });
+        },
+        async close() {
+            clearInterval(cleanupInterval);
+            for (const [id, session] of sessions.entries()) {
+                try {
+                    await session.transport.close();
+                }
+                catch { }
+                try {
+                    await session.server.close();
+                }
+                catch { }
+                sessions.delete(id);
+            }
+            if (activeHttpServer) {
+                await new Promise((resolve, reject) => {
+                    activeHttpServer.close((err) => {
+                        if (err)
+                            reject(err);
+                        else
+                            resolve();
+                    });
+                });
+                activeHttpServer = undefined;
+                instance.httpServer = undefined;
+            }
+        },
+    };
+    return instance;
+}
+//# sourceMappingURL=sse.js.map

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * Stdio Server Transport for Call Telemetry Lab MCP Server
+ * Operates over standard input and standard output for local MCP clients (Claude Desktop, Cursor).
+ * Stderr is strictly used for logging to prevent corrupting JSON-RPC stdout stream.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+export interface StdioServerOptions {
+    installSignalHandlers?: boolean;
+}
+/**
+ * Connects an McpServer instance to the StdioServerTransport.
+ */
+export declare function startStdioServer(server: McpServer, options?: StdioServerOptions): Promise<StdioServerTransport>;
+//# sourceMappingURL=stdio.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../../src/transports/stdio.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAGjF,MAAM,WAAW,kBAAkB;IACjC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,oBAAoB,CAAC,CAwB/B"}

package/dist/src/transports/stdio.js

@@ -0,0 +1,34 @@
+/**
+ * Stdio Server Transport for Call Telemetry Lab MCP Server
+ * Operates over standard input and standard output for local MCP clients (Claude Desktop, Cursor).
+ * Stderr is strictly used for logging to prevent corrupting JSON-RPC stdout stream.
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { logger } from "../utils/logger.js";
+/**
+ * Connects an McpServer instance to the StdioServerTransport.
+ */
+export async function startStdioServer(server, options = {}) {
+    const transport = new StdioServerTransport();
+    if (options.installSignalHandlers !== false) {
+        const handleSignal = async (signal) => {
+            logger.info(`Received ${signal}, shutting down...`);
+            try {
+                await server.close();
+            }
+            catch (err) {
+                logger.error("Error closing server during signal handling:", err);
+            }
+            finally {
+                process.exit(0);
+            }
+        };
+        process.once("SIGINT", () => handleSignal("SIGINT"));
+        process.once("SIGTERM", () => handleSignal("SIGTERM"));
+    }
+    await server.connect(transport);
+    console.error("[proxmox-mcp] Proxmox MCP Server connected via stdio transport.");
+    console.error("[ct-lab-mcp] Call Telemetry Lab MCP Server connected via stdio transport.");
+    return transport;
+}
+//# 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":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAM5C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAiB,EACjB,UAA8B,EAAE;IAEhC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,IAAI,OAAO,CAAC,qBAAqB,KAAK,KAAK,EAAE,CAAC;QAC5C,MAAM,YAAY,GAAG,KAAK,EAAE,MAAc,EAAE,EAAE;YAC5C,MAAM,CAAC,IAAI,CAAC,YAAY,MAAM,oBAAoB,CAAC,CAAC;YACpD,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACvB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,KAAK,CAAC,8CAA8C,EAAE,GAAG,CAAC,CAAC;YACpE,CAAC;oBAAS,CAAC;gBACT,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC,CAAC;QAEF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;QACrD,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACjF,OAAO,CAAC,KAAK,CAAC,2EAA2E,CAAC,CAAC;IAE3F,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/src/types/config.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Host and credential configuration types for Proxmox and ESXi Lab MCP Server.
+ */
+export * from "../credentials/types.js";
+import { ProxmoxHostConfig, EsxiHostConfig, VmCredentialConfig, DopplerConfig } from "../credentials/types.js";
+export interface ServerConfig {
+    hosts?: ProxmoxHostConfig[];
+    proxmoxHosts?: ProxmoxHostConfig[];
+    esxiHosts?: EsxiHostConfig[];
+    vmCredentials?: VmCredentialConfig;
+    doppler?: DopplerConfig;
+    mockMode?: boolean;
+    transport?: "stdio" | "sse";
+    port?: number;
+    host?: string;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/src/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/types/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,yBAAyB,CAAC;AAExC,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE/G,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACnC,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAC7B,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/src/types/config.js

@@ -0,0 +1,5 @@
+/**
+ * Host and credential configuration types for Proxmox and ESXi Lab MCP Server.
+ */
+export * from "../credentials/types.js";
+//# sourceMappingURL=config.js.map