@vscxml/mcp 0.1.0

package/dist/process-manager.js

@@ -0,0 +1,211 @@
+import { spawn } from 'child_process';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { DEFAULT_PORTS } from './types.js';
+/**
+ * Discovers and optionally auto-spawns VSCXML backend processes.
+ *
+ * Discovery order for each backend:
+ * 1. Environment variable (VSCXML_GENERATOR_URL, etc.)
+ * 2. MCP config args (--generator, --simulator)
+ * 3. Default ports (probe localhost)
+ * 4. Auto-spawn from known install paths
+ */
+export class ProcessManager {
+    children = [];
+    /** Discover the generator URL */
+    async discoverGenerator(configUrl) {
+        // 1. Env var
+        const envUrl = process.env.VSCXML_GENERATOR_URL;
+        if (envUrl)
+            return envUrl;
+        // 2. Config
+        if (configUrl)
+            return configUrl;
+        // 3. Probe default port
+        const defaultUrl = `http://localhost:${DEFAULT_PORTS.generator}`;
+        if (await this.probeHttp(defaultUrl))
+            return defaultUrl;
+        return null;
+    }
+    /** Discover the simulator URL */
+    async discoverSimulator(configUrl) {
+        // 1. Env var
+        const envUrl = process.env.VSCXML_SIMULATOR_URL;
+        if (envUrl)
+            return envUrl;
+        // 2. Config
+        if (configUrl)
+            return configUrl;
+        // 3. Probe default port
+        const defaultUrl = `ws://localhost:${DEFAULT_PORTS.simulatorWs}`;
+        if (await this.probeWs(defaultUrl))
+            return defaultUrl;
+        return null;
+    }
+    /** Discover the editor URL */
+    async discoverEditor(configUrl) {
+        const envUrl = process.env.VSCXML_EDITOR_URL;
+        if (envUrl)
+            return envUrl;
+        if (configUrl)
+            return configUrl;
+        const defaultUrl = `ws://localhost:${DEFAULT_PORTS.editorApi}`;
+        if (await this.probeWs(defaultUrl))
+            return defaultUrl;
+        return null;
+    }
+    /** Get known install paths for the generator CLI */
+    getGeneratorPaths() {
+        const platform = process.platform;
+        const paths = [];
+        if (platform === 'win32') {
+            const localAppData = process.env.LOCALAPPDATA || '';
+            paths.push(join(localAppData, 'VSCXML-Generator-CLI', 'vscxml-generator-cli.exe'));
+        }
+        else if (platform === 'darwin') {
+            paths.push('/Applications/VSCXML-Generator-CLI.app/Contents/MacOS/VSCXML-Generator-CLI');
+        }
+        else {
+            paths.push('/opt/vscxml-generator-cli/bin/vscxml-generator-cli');
+        }
+        return paths.filter((p) => existsSync(p));
+    }
+    /** Get known install paths for the simulator */
+    getSimulatorPaths() {
+        const platform = process.platform;
+        const paths = [];
+        if (platform === 'win32') {
+            const localAppData = process.env.LOCALAPPDATA || '';
+            paths.push(join(localAppData, 'VSCXML-Simulator', 'vscxml-simulator.exe'));
+        }
+        else if (platform === 'darwin') {
+            paths.push('/Applications/VSCXML-Simulator.app/Contents/MacOS/VSCXML-Simulator');
+        }
+        else {
+            paths.push('/opt/vscxml-simulator/bin/vscxml-simulator');
+        }
+        return paths.filter((p) => existsSync(p));
+    }
+    /** Spawn a generator process */
+    spawnGenerator(execPath, port = DEFAULT_PORTS.generator) {
+        const child = spawn(execPath, ['serve', '--port', String(port), '--cors'], {
+            stdio: 'ignore',
+            detached: false,
+        });
+        this.children.push(child);
+        return child;
+    }
+    /** Spawn a simulator process */
+    spawnSimulator(execPath, wsPort = DEFAULT_PORTS.simulatorWs, restPort = DEFAULT_PORTS.simulatorRest) {
+        const child = spawn(execPath, ['serve', '--ws-port', String(wsPort), '--rest-port', String(restPort), '--cors'], { stdio: 'ignore', detached: false });
+        this.children.push(child);
+        return child;
+    }
+    /** Shut down all spawned child processes */
+    shutdown() {
+        for (const child of this.children) {
+            try {
+                child.kill();
+            }
+            catch {
+                // ignore
+            }
+        }
+        this.children = [];
+    }
+    /**
+     * Auto-discover and optionally spawn the generator backend.
+     * Returns the URL if available, null if not.
+     */
+    async ensureGenerator(configUrl) {
+        // Try discovery first
+        const url = await this.discoverGenerator(configUrl);
+        if (url)
+            return url;
+        // Try auto-spawn
+        const paths = this.getGeneratorPaths();
+        if (paths.length === 0)
+            return null;
+        console.error(`[ProcessManager] Generator not found on default port, spawning ${paths[0]}...`);
+        this.spawnGenerator(paths[0]);
+        // Wait for it to come up (poll health)
+        const targetUrl = `http://localhost:${DEFAULT_PORTS.generator}`;
+        if (await this.waitForHealth(targetUrl, 15000)) {
+            return targetUrl;
+        }
+        console.error('[ProcessManager] Generator failed to start');
+        return null;
+    }
+    /**
+     * Auto-discover and optionally spawn the simulator backend.
+     */
+    async ensureSimulator(configUrl) {
+        const url = await this.discoverSimulator(configUrl);
+        if (url)
+            return url;
+        const paths = this.getSimulatorPaths();
+        if (paths.length === 0)
+            return null;
+        console.error(`[ProcessManager] Simulator not found on default port, spawning ${paths[0]}...`);
+        this.spawnSimulator(paths[0]);
+        const targetUrl = `ws://localhost:${DEFAULT_PORTS.simulatorWs}`;
+        if (await this.waitForWs(targetUrl, 15000)) {
+            return targetUrl;
+        }
+        console.error('[ProcessManager] Simulator failed to start');
+        return null;
+    }
+    async waitForHealth(url, timeoutMs) {
+        const deadline = Date.now() + timeoutMs;
+        while (Date.now() < deadline) {
+            if (await this.probeHttp(url))
+                return true;
+            await new Promise((r) => setTimeout(r, 500));
+        }
+        return false;
+    }
+    async waitForWs(url, timeoutMs) {
+        const deadline = Date.now() + timeoutMs;
+        while (Date.now() < deadline) {
+            if (await this.probeWs(url))
+                return true;
+            await new Promise((r) => setTimeout(r, 500));
+        }
+        return false;
+    }
+    async probeHttp(url) {
+        try {
+            const res = await fetch(`${url}/api/health`, {
+                signal: AbortSignal.timeout(2000),
+            });
+            return res.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    async probeWs(url) {
+        // Use a simple TCP connection probe instead of full WS handshake.
+        // More reliable on Windows where WS open/close races can cause false negatives.
+        const { createConnection } = await import('net');
+        const parsed = new URL(url);
+        const port = parseInt(parsed.port) || 48621;
+        const host = parsed.hostname || '127.0.0.1';
+        return new Promise((resolve) => {
+            try {
+                const socket = createConnection({ host, port }, () => {
+                    socket.destroy();
+                    resolve(true);
+                });
+                socket.setTimeout(2000);
+                socket.on('timeout', () => { socket.destroy(); resolve(false); });
+                socket.on('error', () => { resolve(false); });
+            }
+            catch {
+                resolve(false);
+            }
+        });
+    }
+}
+//# sourceMappingURL=process-manager.js.map

package/dist/process-manager.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpConfig } from './types.js';
+export declare function createServer(config?: McpConfig): McpServer;