@vscxml/mcp 0.1.0

package/dist/bridges/simulator-bridge.js

@@ -0,0 +1,451 @@
+import WebSocket from 'ws';
+/**
+ * Response types the simulator sends for each command action.
+ * The server does NOT echo commandId, so we match by response type.
+ */
+const RESPONSE_TYPES = {
+    load_scxml: ['session_created'],
+    start: ['success'],
+    stop: ['success'],
+    reset: ['session_created'],
+    pause: ['success'],
+    resume: ['success'],
+    step: ['success'],
+    send_event: ['success'],
+    set_variable: ['success'],
+    get_state: ['state'],
+    get_scxml: ['scxml_content'],
+    get_history: ['history'],
+    clear_history: ['success'],
+    add_breakpoint: ['success'],
+    remove_breakpoint: ['success'],
+    list_traces: ['trace_list'],
+    save_trace: ['trace_saved'],
+    delete_trace: ['trace_deleted'],
+    load_trace: ['trace_loaded'],
+    play_trace: ['trace_playback_started'],
+    step_trace: ['trace_stepped'],
+    pause_trace: ['trace_paused'],
+    trace_status: ['trace_status'],
+};
+/**
+ * WebSocket bridge to the VSCXML-Simulator.
+ * Uses response-type matching (the server does not echo commandId).
+ * Buffers broadcast events (state_update, transition_fired, etc.) into a trace.
+ */
+export class SimulatorBridge {
+    ws = null;
+    url;
+    pendingResolve = null;
+    traceBuffer = [];
+    sessionId = null;
+    connected = false;
+    reconnectTimer = null;
+    activeStates = [];
+    variables = {};
+    enabledEvents = [];
+    finished = false;
+    mode = 'PAUSED';
+    constructor(url) {
+        this.url = url || `ws://localhost:${48621}`;
+    }
+    setUrl(url) {
+        this.url = url;
+    }
+    isConnected() {
+        return this.connected;
+    }
+    getSessionId() {
+        return this.sessionId;
+    }
+    /** Connect to the simulator WebSocket */
+    async connect() {
+        if (this.connected)
+            return;
+        return new Promise((resolve, reject) => {
+            try {
+                this.ws = new WebSocket(this.url);
+                const timeout = setTimeout(() => {
+                    reject(new Error(`Connection timeout to simulator at ${this.url}`));
+                    this.ws?.close();
+                }, 5000);
+                this.ws.on('open', () => {
+                    clearTimeout(timeout);
+                    this.connected = true;
+                    resolve();
+                });
+                this.ws.on('message', (data) => {
+                    this.handleMessage(data.toString());
+                });
+                this.ws.on('close', () => {
+                    this.connected = false;
+                    this.ws = null;
+                    if (this.pendingResolve) {
+                        clearTimeout(this.pendingResolve.timer);
+                        this.pendingResolve.reject(new Error('Connection closed'));
+                        this.pendingResolve = null;
+                    }
+                });
+                this.ws.on('error', (err) => {
+                    clearTimeout(timeout);
+                    if (!this.connected) {
+                        reject(err);
+                    }
+                });
+            }
+            catch (err) {
+                reject(err);
+            }
+        });
+    }
+    disconnect() {
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+        this.connected = false;
+    }
+    async isAvailable() {
+        try {
+            await this.connect();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Load SCXML and return session info */
+    async loadScxml(scxml) {
+        const response = await this.sendCommand('load_scxml', { scxml });
+        if (response.sessionId) {
+            this.sessionId = response.sessionId;
+        }
+        this.traceBuffer = [];
+        return this.getCurrentState();
+    }
+    /** Start the state machine */
+    async start() {
+        await this.sendCommand('start', { sessionId: this.sessionId });
+        await this.waitForSettle();
+        return this.getCurrentState();
+    }
+    /** Send an event and return trace + state */
+    async sendEvent(eventName, eventData) {
+        const preTrace = this.drainTrace();
+        const event = { name: eventName };
+        if (eventData !== undefined) {
+            event.data = eventData;
+        }
+        await this.sendCommand('send_event', {
+            sessionId: this.sessionId,
+            event,
+        });
+        await this.waitForSettle();
+        const trace = this.drainTrace();
+        return { trace: [...preTrace, ...trace], state: this.getCurrentState() };
+    }
+    /** Get current state without sending an event */
+    async getState() {
+        const response = await this.sendCommand('get_state', {
+            sessionId: this.sessionId,
+        });
+        if (response.activeStates)
+            this.activeStates = response.activeStates;
+        if (response.variables)
+            this.variables = response.variables;
+        if (response.enabledEvents)
+            this.enabledEvents = response.enabledEvents;
+        if (response.finished !== undefined)
+            this.finished = response.finished;
+        if (response.mode)
+            this.mode = response.mode;
+        return {
+            ...this.getCurrentState(),
+            mode: this.mode,
+            history: [...this.traceBuffer],
+        };
+    }
+    /** Reset the simulation */
+    async reset() {
+        const response = await this.sendCommand('reset', {
+            sessionId: this.sessionId,
+        });
+        this.traceBuffer = [];
+        if (response.sessionId) {
+            this.sessionId = response.sessionId;
+        }
+        // Fetch state after reset
+        const stateResp = await this.sendCommand('get_state', {
+            sessionId: this.sessionId,
+        });
+        if (stateResp.activeStates)
+            this.activeStates = stateResp.activeStates;
+        if (stateResp.variables)
+            this.variables = stateResp.variables;
+        if (stateResp.enabledEvents)
+            this.enabledEvents = stateResp.enabledEvents;
+        return this.getCurrentState();
+    }
+    /** Get current SCXML content */
+    async getScxml() {
+        const response = await this.sendCommand('get_scxml', {
+            sessionId: this.sessionId,
+        });
+        return response.scxml;
+    }
+    // --- Trace management methods ---
+    /** List embedded traces in the current SCXML document */
+    async listTraces() {
+        const response = await this.sendCommand('list_traces', {
+            sessionId: this.sessionId,
+        });
+        return response.traces || [];
+    }
+    /** Save/embed a trace into the SCXML document */
+    async saveTrace(name, options) {
+        const params = {
+            sessionId: this.sessionId,
+            name,
+        };
+        if (options?.description)
+            params.description = options.description;
+        if (options?.content)
+            params.content = options.content;
+        const response = await this.sendCommand('save_trace', params);
+        return {
+            entryCount: response.entryCount,
+            scxml: response.scxml,
+        };
+    }
+    /** Delete an embedded trace by name */
+    async deleteTrace(name) {
+        const response = await this.sendCommand('delete_trace', {
+            sessionId: this.sessionId,
+            name,
+        });
+        return { scxml: response.scxml };
+    }
+    /** Load an embedded trace by name (returns parsed entries) */
+    async loadTrace(name) {
+        const response = await this.sendCommand('load_trace', {
+            sessionId: this.sessionId,
+            name,
+        });
+        return {
+            entries: response.entries || [],
+            entryCount: response.entryCount,
+            description: response.description,
+        };
+    }
+    // --- Trace playback methods ---
+    /** Start playing an embedded trace by name */
+    async playTrace(name, speed) {
+        const params = {
+            sessionId: this.sessionId,
+            name,
+        };
+        if (speed !== undefined)
+            params.speed = speed;
+        const response = await this.sendCommand('play_trace', params);
+        return { entryCount: response.entryCount };
+    }
+    /** Step forward/backward in trace playback */
+    async stepTrace(delta) {
+        const response = await this.sendCommand('step_trace', {
+            sessionId: this.sessionId,
+            delta,
+        });
+        return {
+            index: response.index,
+            total: response.total,
+            entry: response.entry,
+        };
+    }
+    /** Pause trace playback */
+    async pauseTrace() {
+        const response = await this.sendCommand('pause_trace', {
+            sessionId: this.sessionId,
+        });
+        return {
+            index: response.index,
+            total: response.total,
+        };
+    }
+    /** Get trace playback status */
+    async getTraceStatus() {
+        const response = await this.sendCommand('trace_status', {
+            sessionId: this.sessionId,
+        });
+        return response;
+    }
+    /** Set a variable value during simulation */
+    async setVariable(name, value) {
+        await this.sendCommand('set_variable', {
+            sessionId: this.sessionId,
+            name,
+            value,
+        });
+    }
+    // --- Private methods ---
+    getCurrentState() {
+        return {
+            sessionId: this.sessionId || '',
+            activeStates: [...this.activeStates],
+            variables: { ...this.variables },
+            enabledEvents: [...this.enabledEvents],
+            finished: this.finished,
+            mode: this.mode,
+        };
+    }
+    drainTrace() {
+        const trace = [...this.traceBuffer];
+        this.traceBuffer = [];
+        return trace;
+    }
+    async waitForSettle(timeoutMs = 2000) {
+        return new Promise((resolve) => {
+            let lastEventTime = Date.now();
+            let lastSeenLen = this.traceBuffer.length;
+            const startTime = Date.now();
+            const check = () => {
+                const now = Date.now();
+                const currentLen = this.traceBuffer.length;
+                const newEvents = currentLen > lastSeenLen;
+                if (this.finished) {
+                    resolve();
+                    return;
+                }
+                if (newEvents) {
+                    lastEventTime = now;
+                    lastSeenLen = currentLen;
+                }
+                if (now - lastEventTime >= 50) {
+                    resolve();
+                    return;
+                }
+                if (now - startTime >= timeoutMs) {
+                    resolve();
+                    return;
+                }
+                setTimeout(check, 10);
+            };
+            setTimeout(check, 50);
+        });
+    }
+    handleMessage(data) {
+        let msg;
+        try {
+            msg = JSON.parse(data);
+        }
+        catch {
+            return;
+        }
+        const type = msg.type;
+        // Check if this message resolves a pending command
+        if (this.pendingResolve) {
+            if (type === 'error') {
+                // Errors always resolve pending commands
+                clearTimeout(this.pendingResolve.timer);
+                const pending = this.pendingResolve;
+                this.pendingResolve = null;
+                pending.reject(new Error(msg.message || msg.error || 'Unknown error'));
+                return;
+            }
+            if (this.pendingResolve.expectedTypes.includes(type)) {
+                clearTimeout(this.pendingResolve.timer);
+                const pending = this.pendingResolve;
+                this.pendingResolve = null;
+                pending.resolve(msg);
+                // Fall through to also process as broadcast event
+            }
+        }
+        // Buffer broadcast events
+        switch (type) {
+            case 'state_update': {
+                const eventType = msg.eventType;
+                const stateId = msg.stateId;
+                this.traceBuffer.push({
+                    type: eventType === 'enter' ? 'state_enter' : 'state_exit',
+                    state: stateId,
+                });
+                if (msg.activeStates)
+                    this.activeStates = msg.activeStates;
+                if (msg.variables)
+                    this.variables = msg.variables;
+                if (msg.enabledEvents)
+                    this.enabledEvents = msg.enabledEvents;
+                break;
+            }
+            case 'transition_fired':
+                this.traceBuffer.push({
+                    type: 'transition',
+                    from: msg.from,
+                    to: msg.to,
+                    event: msg.event,
+                });
+                if (msg.activeStates)
+                    this.activeStates = msg.activeStates;
+                break;
+            case 'variable_changed':
+                this.traceBuffer.push({
+                    type: 'variable_changed',
+                    name: msg.name,
+                    oldValue: msg.oldValue,
+                    newValue: msg.newValue,
+                });
+                break;
+            case 'started':
+                this.traceBuffer.push({ type: 'started' });
+                if (msg.activeStates)
+                    this.activeStates = msg.activeStates;
+                this.finished = false;
+                break;
+            case 'finished':
+                this.traceBuffer.push({ type: 'finished' });
+                this.finished = true;
+                break;
+            case 'log':
+                this.traceBuffer.push({
+                    type: 'log',
+                    message: `${msg.label || ''}: ${msg.message || ''}`.trim(),
+                });
+                break;
+            case 'session_info':
+                // Auto-association welcome message
+                if (msg.sessionId)
+                    this.sessionId = msg.sessionId;
+                break;
+            case 'session_created':
+                if (msg.sessionId)
+                    this.sessionId = msg.sessionId;
+                break;
+        }
+    }
+    sendCommand(action, params = {}, timeoutMs = 10000) {
+        return new Promise((resolve, reject) => {
+            if (!this.ws || !this.connected) {
+                reject(new Error('Not connected to simulator'));
+                return;
+            }
+            const expectedTypes = RESPONSE_TYPES[action] || ['success'];
+            const message = JSON.stringify({
+                type: 'command',
+                action,
+                ...params,
+            });
+            const timer = setTimeout(() => {
+                if (this.pendingResolve) {
+                    this.pendingResolve = null;
+                }
+                reject(new Error(`Command '${action}' timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            this.pendingResolve = { expectedTypes, resolve, reject, timer };
+            this.ws.send(message);
+        });
+    }
+}
+//# sourceMappingURL=simulator-bridge.js.map

package/dist/bridges/simulator-bridge.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import type { McpConfig } from './types.js';
+export { createServer } from './server.js';
+export type { McpConfig } from './types.js';
+/**
+ * Start the MCP server with stdio transport.
+ * This is the main entry point when running as an MCP server.
+ */
+export declare function startStdio(config?: McpConfig): Promise<void>;

package/dist/index.js

@@ -0,0 +1,29 @@
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from './server.js';
+import { ProcessManager } from './process-manager.js';
+export { createServer } from './server.js';
+/**
+ * Start the MCP server with stdio transport.
+ * This is the main entry point when running as an MCP server.
+ */
+export async function startStdio(config = {}) {
+    const processManager = new ProcessManager();
+    // Auto-discover backends
+    const genUrl = await processManager.ensureGenerator(config.generatorUrl);
+    if (genUrl) {
+        config.generatorUrl = genUrl;
+        console.error(`[MCP] Generator: ${genUrl}`);
+    }
+    const simUrl = await processManager.ensureSimulator(config.simulatorUrl);
+    if (simUrl) {
+        config.simulatorUrl = simUrl;
+        console.error(`[MCP] Simulator: ${simUrl}`);
+    }
+    const server = createServer(config);
+    const transport = new StdioServerTransport();
+    // Cleanup on exit
+    process.on('SIGINT', () => { processManager.shutdown(); process.exit(0); });
+    process.on('SIGTERM', () => { processManager.shutdown(); process.exit(0); });
+    await server.connect(transport);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,SAAoB,EAAE;IACrD,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC;IAE5C,yBAAyB;IACzB,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,eAAe,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACzE,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC;QAC7B,OAAO,CAAC,KAAK,CAAC,oBAAoB,MAAM,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,eAAe,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACzE,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC;QAC7B,OAAO,CAAC,KAAK,CAAC,oBAAoB,MAAM,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,kBAAkB;IAClB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7E,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}

package/dist/process-manager.d.ts

@@ -0,0 +1,42 @@
+import { ChildProcess } from 'child_process';
+/**
+ * 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 declare class ProcessManager {
+    private children;
+    /** Discover the generator URL */
+    discoverGenerator(configUrl?: string): Promise<string | null>;
+    /** Discover the simulator URL */
+    discoverSimulator(configUrl?: string): Promise<string | null>;
+    /** Discover the editor URL */
+    discoverEditor(configUrl?: string): Promise<string | null>;
+    /** Get known install paths for the generator CLI */
+    getGeneratorPaths(): string[];
+    /** Get known install paths for the simulator */
+    getSimulatorPaths(): string[];
+    /** Spawn a generator process */
+    spawnGenerator(execPath: string, port?: number): ChildProcess;
+    /** Spawn a simulator process */
+    spawnSimulator(execPath: string, wsPort?: number, restPort?: number): ChildProcess;
+    /** Shut down all spawned child processes */
+    shutdown(): void;
+    /**
+     * Auto-discover and optionally spawn the generator backend.
+     * Returns the URL if available, null if not.
+     */
+    ensureGenerator(configUrl?: string): Promise<string | null>;
+    /**
+     * Auto-discover and optionally spawn the simulator backend.
+     */
+    ensureSimulator(configUrl?: string): Promise<string | null>;
+    private waitForHealth;
+    private waitForWs;
+    private probeHttp;
+    private probeWs;
+}