@forthix/forthic 0.3.0 → 0.4.0

package/dist/cjs/websocket/action_cable/remote_word.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketRemoteWord = void 0;
+/**
+ * WebSocketRemoteWord - Word that executes in a remote runtime via ActionCable
+ * Mirrors RemoteWord from gRPC implementation
+ */
+const module_js_1 = require("../../forthic/module.js");
+/**
+ * WebSocketRemoteWord - Proxy word that delegates execution to a remote runtime
+ *
+ * When executed:
+ * 1. Captures current interpreter stack
+ * 2. Sends word name + stack to remote runtime via ActionCable
+ * 3. Replaces local stack with result stack from remote execution
+ *
+ * This allows seamless integration of remote runtime words
+ * into the local TypeScript interpreter.
+ */
+class WebSocketRemoteWord extends module_js_1.Word {
+    client;
+    runtimeName;
+    moduleName;
+    stackEffect;
+    description;
+    /**
+     * @param name - Word name (e.g., "DF_FROM_RECORDS")
+     * @param client - ActionCable client connected to remote runtime
+     * @param runtimeName - Name of remote runtime (e.g., "rails", "ruby")
+     * @param moduleName - Module name (e.g., "pandas")
+     * @param stackEffect - Stack notation (e.g., "( records:array -- df:DataFrame )")
+     * @param description - Human-readable description
+     */
+    constructor(name, client, runtimeName, moduleName, stackEffect = '( -- )', description = '') {
+        super(name);
+        this.client = client;
+        this.runtimeName = runtimeName;
+        this.moduleName = moduleName;
+        this.stackEffect = stackEffect;
+        this.description = description;
+    }
+    /**
+     * Execute word in remote runtime
+     *
+     * Captures entire stack, sends to remote runtime, and replaces stack with result.
+     */
+    async execute(interp) {
+        try {
+            // Capture current stack state
+            const stack = interp.get_stack();
+            const stackItems = stack.get_items();
+            // Execute word in remote runtime
+            const resultStack = await this.client.executeWord(this.name, stackItems);
+            // Clear local stack and replace with result
+            while (interp.get_stack().length > 0) {
+                interp.stack_pop();
+            }
+            // Push all result items
+            for (const item of resultStack) {
+                interp.stack_push(item);
+            }
+        }
+        catch (error) {
+            throw new Error(`Error executing remote word ${this.moduleName}.${this.name} in ${this.runtimeName} runtime: ${error.message}`);
+        }
+    }
+    /**
+     * Get runtime name for debugging/introspection
+     */
+    getRuntimeName() {
+        return this.runtimeName;
+    }
+    /**
+     * Get module name for debugging/introspection
+     */
+    getModuleName() {
+        return this.moduleName;
+    }
+    /**
+     * Get runtime execution information
+     * RemoteWords are runtime-specific and can only execute in their designated runtime
+     */
+    getRuntimeInfo() {
+        return {
+            runtime: this.runtimeName,
+            isRemote: true,
+            isStandard: false,
+            availableIn: [this.runtimeName]
+        };
+    }
+}
+exports.WebSocketRemoteWord = WebSocketRemoteWord;
+//# sourceMappingURL=remote_word.js.map

package/dist/cjs/websocket/action_cable/remote_word.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote_word.js","sourceRoot":"","sources":["../../../../src/websocket/action_cable/remote_word.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,uDAA4D;AAI5D;;;;;;;;;;GAUG;AACH,MAAa,mBAAoB,SAAQ,gBAAI;IACnC,MAAM,CAAoB;IAC1B,WAAW,CAAS;IACpB,UAAU,CAAS;IACpB,WAAW,CAAS;IACpB,WAAW,CAAS;IAE3B;;;;;;;OAOG;IACH,YACE,IAAY,EACZ,MAAyB,EACzB,WAAmB,EACnB,UAAkB,EAClB,cAAsB,QAAQ,EAC9B,cAAsB,EAAE;QAExB,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,MAAmB;QAC/B,IAAI,CAAC;YACH,8BAA8B;YAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;YACjC,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;YAErC,iCAAiC;YACjC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAEzE,4CAA4C;YAC5C,OAAO,MAAM,CAAC,SAAS,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrC,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,CAAC;YAED,wBAAwB;YACxB,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;gBAC/B,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,+BAA+B,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,WAAW,aAAc,KAAe,CAAC,OAAO,EAAE,CAC1H,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,cAAc;QACZ,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,WAAW;YACzB,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,KAAK;YACjB,WAAW,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC;SAChC,CAAC;IACJ,CAAC;CACF;AAvFD,kDAuFC"}

package/dist/cjs/websocket/action_cable/runtime_manager.d.ts

@@ -0,0 +1,69 @@
+/**
+ * WebSocketRuntimeManager - Singleton for managing ActionCable connections to remote runtimes
+ *
+ * Provides centralized access to ActionCable clients for different runtimes
+ * Mirrors the gRPC RuntimeManager API for compatibility
+ */
+import { ActionCableClient, ActionCableClientConfig } from './client.js';
+/**
+ * WebSocketRuntimeManager - Manages ActionCable connections to remote Forthic runtimes
+ */
+export declare class WebSocketRuntimeManager {
+    private static instance;
+    private clients;
+    private constructor();
+    /**
+     * Get the singleton instance
+     */
+    static getInstance(): WebSocketRuntimeManager;
+    /**
+     * Connect to a runtime and register the client
+     *
+     * @param runtimeName - Name of the runtime (e.g., "rails", "ruby")
+     * @param url - ActionCable URL (e.g., "ws://localhost:3000/cable")
+     * @param config - Optional additional configuration
+     * @returns ActionCableClient instance
+     */
+    connectRuntime(runtimeName: string, url: string, config?: Partial<ActionCableClientConfig>): ActionCableClient;
+    /**
+     * Register an ActionCable client for a specific runtime
+     *
+     * @param runtimeName - Name of the runtime (e.g., "rails", "ruby")
+     * @param client - ActionCableClient instance connected to that runtime
+     */
+    registerClient(runtimeName: string, client: ActionCableClient): void;
+    /**
+     * Get the ActionCable client for a specific runtime
+     *
+     * @param runtimeName - Name of the runtime
+     * @returns ActionCableClient instance or undefined if not registered
+     */
+    getClient(runtimeName: string): ActionCableClient | undefined;
+    /**
+     * Check if a runtime has a registered client
+     *
+     * @param runtimeName - Name of the runtime
+     * @returns True if client is registered
+     */
+    hasClient(runtimeName: string): boolean;
+    /**
+     * Get all registered runtime names
+     *
+     * @returns Array of runtime names
+     */
+    getRegisteredRuntimes(): string[];
+    /**
+     * Disconnect a specific runtime
+     *
+     * @param runtimeName - Name of the runtime to disconnect
+     */
+    disconnectRuntime(runtimeName: string): void;
+    /**
+     * Clear all registered clients (useful for testing)
+     */
+    clearAll(): void;
+    /**
+     * Reset the singleton (useful for testing)
+     */
+    static reset(): void;
+}

package/dist/cjs/websocket/action_cable/runtime_manager.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketRuntimeManager = void 0;
+/**
+ * WebSocketRuntimeManager - Singleton for managing ActionCable connections to remote runtimes
+ *
+ * Provides centralized access to ActionCable clients for different runtimes
+ * Mirrors the gRPC RuntimeManager API for compatibility
+ */
+const client_js_1 = require("./client.js");
+/**
+ * WebSocketRuntimeManager - Manages ActionCable connections to remote Forthic runtimes
+ */
+class WebSocketRuntimeManager {
+    static instance = null;
+    clients;
+    constructor() {
+        this.clients = new Map();
+    }
+    /**
+     * Get the singleton instance
+     */
+    static getInstance() {
+        if (!WebSocketRuntimeManager.instance) {
+            WebSocketRuntimeManager.instance = new WebSocketRuntimeManager();
+        }
+        return WebSocketRuntimeManager.instance;
+    }
+    /**
+     * Connect to a runtime and register the client
+     *
+     * @param runtimeName - Name of the runtime (e.g., "rails", "ruby")
+     * @param url - ActionCable URL (e.g., "ws://localhost:3000/cable")
+     * @param config - Optional additional configuration
+     * @returns ActionCableClient instance
+     */
+    connectRuntime(runtimeName, url, config) {
+        // Create a new client for the runtime
+        const client = new client_js_1.ActionCableClient({ url, ...config });
+        // Register it
+        this.clients.set(runtimeName, client);
+        return client;
+    }
+    /**
+     * Register an ActionCable client for a specific runtime
+     *
+     * @param runtimeName - Name of the runtime (e.g., "rails", "ruby")
+     * @param client - ActionCableClient instance connected to that runtime
+     */
+    registerClient(runtimeName, client) {
+        this.clients.set(runtimeName, client);
+    }
+    /**
+     * Get the ActionCable client for a specific runtime
+     *
+     * @param runtimeName - Name of the runtime
+     * @returns ActionCableClient instance or undefined if not registered
+     */
+    getClient(runtimeName) {
+        return this.clients.get(runtimeName);
+    }
+    /**
+     * Check if a runtime has a registered client
+     *
+     * @param runtimeName - Name of the runtime
+     * @returns True if client is registered
+     */
+    hasClient(runtimeName) {
+        return this.clients.has(runtimeName);
+    }
+    /**
+     * Get all registered runtime names
+     *
+     * @returns Array of runtime names
+     */
+    getRegisteredRuntimes() {
+        return Array.from(this.clients.keys());
+    }
+    /**
+     * Disconnect a specific runtime
+     *
+     * @param runtimeName - Name of the runtime to disconnect
+     */
+    disconnectRuntime(runtimeName) {
+        const client = this.clients.get(runtimeName);
+        if (client) {
+            client.close();
+            this.clients.delete(runtimeName);
+        }
+    }
+    /**
+     * Clear all registered clients (useful for testing)
+     */
+    clearAll() {
+        // Close all clients
+        for (const client of this.clients.values()) {
+            client.close();
+        }
+        this.clients.clear();
+    }
+    /**
+     * Reset the singleton (useful for testing)
+     */
+    static reset() {
+        if (WebSocketRuntimeManager.instance) {
+            WebSocketRuntimeManager.instance.clearAll();
+            WebSocketRuntimeManager.instance = null;
+        }
+    }
+}
+exports.WebSocketRuntimeManager = WebSocketRuntimeManager;
+//# sourceMappingURL=runtime_manager.js.map

package/dist/cjs/websocket/action_cable/runtime_manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime_manager.js","sourceRoot":"","sources":["../../../../src/websocket/action_cable/runtime_manager.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,2CAAyE;AAEzE;;GAEG;AACH,MAAa,uBAAuB;IAC1B,MAAM,CAAC,QAAQ,GAAmC,IAAI,CAAC;IACvD,OAAO,CAAiC;IAEhD;QACE,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,uBAAuB,CAAC,QAAQ,EAAE,CAAC;YACtC,uBAAuB,CAAC,QAAQ,GAAG,IAAI,uBAAuB,EAAE,CAAC;QACnE,CAAC;QACD,OAAO,uBAAuB,CAAC,QAAQ,CAAC;IAC1C,CAAC;IAED;;;;;;;OAOG;IACH,cAAc,CACZ,WAAmB,EACnB,GAAW,EACX,MAAyC;QAEzC,sCAAsC;QACtC,MAAM,MAAM,GAAG,IAAI,6BAAiB,CAAC,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QAEzD,cAAc;QACd,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAEtC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,WAAmB,EAAE,MAAyB;QAC3D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,WAAmB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,WAAmB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACH,qBAAqB;QACnB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,WAAmB;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC7C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,oBAAoB;QACpB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK;QACV,IAAI,uBAAuB,CAAC,QAAQ,EAAE,CAAC;YACrC,uBAAuB,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC5C,uBAAuB,CAAC,QAAQ,GAAG,IAAI,CAAC;QAC1C,CAAC;IACH,CAAC;;AA/GH,0DAgHC"}

package/dist/cjs/websocket/action_cable_client.d.ts

@@ -0,0 +1,106 @@
+/**
+ * ActionCable Client for Forthic
+ * Browser-compatible client that mirrors GrpcClient API
+ * Specifically designed for Rails ActionCable WebSocket protocol
+ */
+import { StackValue } from './serializer.js';
+export interface ModuleSummary {
+    name: string;
+    description: string;
+    word_count: number;
+}
+export interface WordInfo {
+    name: string;
+    stack_effect: string;
+    description: string;
+}
+export interface ModuleInfo {
+    module_name: string;
+    words: WordInfo[];
+}
+export interface ProgressUpdate {
+    step: number;
+    total_steps: number;
+    current_word: string;
+    message?: string;
+    partial_stack?: StackValue[];
+}
+export interface ActionCableClientConfig {
+    url: string;
+    timezone?: string;
+    reconnect?: boolean;
+    reconnectDelay?: number;
+    channel?: string;
+}
+/**
+ * ActionCable client for executing words in remote Forthic runtimes
+ * Mirrors the GrpcClient API for compatibility
+ * Uses Rails ActionCable WebSocket protocol
+ */
+export declare class ActionCableClient {
+    private ws?;
+    private config;
+    private pendingRequests;
+    private messageId;
+    private connected;
+    private connectionPromise?;
+    constructor(config: ActionCableClientConfig);
+    /**
+     * Connect to the WebSocket server
+     */
+    private connect;
+    /**
+     * Handle incoming WebSocket messages
+     */
+    private handleMessage;
+    /**
+     * Generate next message ID
+     */
+    private nextMessageId;
+    /**
+     * Send a request and wait for response
+     * @template T The expected result type (the value of the `result` field)
+     */
+    private sendRequest;
+    /**
+     * Send a streaming request with progress callbacks
+     * @template T The expected result type (the value of the `result` field)
+     */
+    private sendStreamingRequest;
+    /**
+     * Ensure WebSocket is connected
+     */
+    private ensureConnected;
+    /**
+     * Execute a word in the remote runtime
+     * Mirrors GrpcClient.executeWord
+     */
+    executeWord(word: string, stack: any[]): Promise<any[]>;
+    /**
+     * Execute a sequence of words (batched execution)
+     * Mirrors GrpcClient.executeSequence
+     */
+    executeSequence(words: string[], stack: any[]): Promise<any[]>;
+    /**
+     * List available runtime-specific modules
+     * Mirrors GrpcClient.listModules
+     */
+    listModules(): Promise<ModuleSummary[]>;
+    /**
+     * Get detailed information about a specific module
+     * Mirrors GrpcClient.getModuleInfo
+     */
+    getModuleInfo(moduleName: string): Promise<ModuleInfo>;
+    /**
+     * Execute code with streaming progress updates (NEW capability)
+     */
+    streamingExecute(code: string, stack: any[], onProgress?: (progress: ProgressUpdate) => void): Promise<any[]>;
+    /**
+     * Close the WebSocket connection
+     */
+    close(): void;
+    /**
+     * Check if the client is connected
+     */
+    isConnected(): boolean;
+}

package/dist/cjs/websocket/action_cable_client.js

@@ -0,0 +1,269 @@
+"use strict";
+/**
+ * ActionCable Client for Forthic
+ * Browser-compatible client that mirrors GrpcClient API
+ * Specifically designed for Rails ActionCable WebSocket protocol
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActionCableClient = void 0;
+const serializer_js_1 = require("./serializer.js");
+const errors_js_1 = require("./errors.js");
+/**
+ * ActionCable client for executing words in remote Forthic runtimes
+ * Mirrors the GrpcClient API for compatibility
+ * Uses Rails ActionCable WebSocket protocol
+ */
+class ActionCableClient {
+    ws;
+    config;
+    pendingRequests = new Map();
+    messageId = 0;
+    connected = false;
+    connectionPromise;
+    constructor(config) {
+        this.config = {
+            url: config.url,
+            timezone: config.timezone || 'UTC',
+            reconnect: config.reconnect ?? true,
+            reconnectDelay: config.reconnectDelay || 3000,
+            channel: config.channel || 'ForthicRuntimeChannel',
+        };
+        this.connect();
+    }
+    /**
+     * Connect to the WebSocket server
+     */
+    connect() {
+        if (this.connectionPromise) {
+            return this.connectionPromise;
+        }
+        this.connectionPromise = new Promise((resolve, reject) => {
+            try {
+                this.ws = new WebSocket(this.config.url);
+                this.ws.onopen = () => {
+                    this.connected = true;
+                    // Subscribe to ActionCable channel
+                    const subscribeMessage = {
+                        command: 'subscribe',
+                        identifier: JSON.stringify({
+                            channel: this.config.channel,
+                            timezone: this.config.timezone,
+                        }),
+                    };
+                    this.ws.send(JSON.stringify(subscribeMessage));
+                    resolve();
+                };
+                this.ws.onmessage = (event) => {
+                    this.handleMessage(event);
+                };
+                this.ws.onerror = (error) => {
+                    console.error('WebSocket error:', error);
+                    reject(new Error('WebSocket connection error'));
+                };
+                this.ws.onclose = () => {
+                    this.connected = false;
+                    this.connectionPromise = undefined;
+                    // Reject all pending requests
+                    for (const [id, pending] of this.pendingRequests.entries()) {
+                        pending.reject(new Error('WebSocket connection closed'));
+                    }
+                    this.pendingRequests.clear();
+                    // Attempt reconnect if enabled
+                    if (this.config.reconnect) {
+                        setTimeout(() => this.connect(), this.config.reconnectDelay);
+                    }
+                };
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+        return this.connectionPromise;
+    }
+    /**
+     * Handle incoming WebSocket messages
+     */
+    handleMessage(event) {
+        try {
+            const data = JSON.parse(event.data);
+            // Handle ActionCable control messages
+            if (data.type === 'welcome' || data.type === 'ping' || data.type === 'confirm_subscription') {
+                return;
+            }
+            // Extract the actual message from ActionCable envelope
+            const message = data.message || data;
+            if (!message.id) {
+                console.warn('Received message without ID:', message);
+                return;
+            }
+            // Handle streaming progress updates
+            if (message.type === 'streaming_progress') {
+                const pending = this.pendingRequests.get(message.id);
+                if (pending?.onProgress) {
+                    pending.onProgress(message.progress);
+                }
+                return;
+            }
+            // Handle final responses
+            const pending = this.pendingRequests.get(message.id);
+            if (!pending) {
+                console.warn('Received response for unknown request:', message.id);
+                return;
+            }
+            if (message.error) {
+                pending.reject(new errors_js_1.RemoteRuntimeError(message.error));
+            }
+            else {
+                pending.resolve(message.result);
+            }
+            this.pendingRequests.delete(message.id);
+        }
+        catch (error) {
+            console.error('Error handling WebSocket message:', error);
+        }
+    }
+    /**
+     * Generate next message ID
+     */
+    nextMessageId() {
+        return `msg-${++this.messageId}-${Date.now()}`;
+    }
+    /**
+     * Send a request and wait for response
+     * @template T The expected result type (the value of the `result` field)
+     */
+    async sendRequest(message) {
+        await this.ensureConnected();
+        return new Promise((resolve, reject) => {
+            this.pendingRequests.set(message.id, { resolve, reject });
+            // Wrap message in ActionCable format
+            const actionCableMessage = {
+                command: 'message',
+                identifier: JSON.stringify({
+                    channel: this.config.channel,
+                }),
+                data: JSON.stringify(message),
+            };
+            this.ws.send(JSON.stringify(actionCableMessage));
+        });
+    }
+    /**
+     * Send a streaming request with progress callbacks
+     * @template T The expected result type (the value of the `result` field)
+     */
+    async sendStreamingRequest(message, onProgress) {
+        await this.ensureConnected();
+        return new Promise((resolve, reject) => {
+            this.pendingRequests.set(message.id, { resolve, reject, onProgress });
+            // Wrap message in ActionCable format
+            const actionCableMessage = {
+                command: 'message',
+                identifier: JSON.stringify({
+                    channel: this.config.channel,
+                }),
+                data: JSON.stringify(message),
+            };
+            this.ws.send(JSON.stringify(actionCableMessage));
+        });
+    }
+    /**
+     * Ensure WebSocket is connected
+     */
+    async ensureConnected() {
+        if (!this.connected) {
+            await this.connect();
+        }
+    }
+    /**
+     * Execute a word in the remote runtime
+     * Mirrors GrpcClient.executeWord
+     */
+    async executeWord(word, stack) {
+        const message = {
+            type: 'execute_word',
+            id: this.nextMessageId(),
+            params: {
+                word,
+                stack: (0, serializer_js_1.serializeStack)(stack),
+            },
+        };
+        const result = await this.sendRequest(message);
+        return (0, serializer_js_1.deserializeStack)(result.stack);
+    }
+    /**
+     * Execute a sequence of words (batched execution)
+     * Mirrors GrpcClient.executeSequence
+     */
+    async executeSequence(words, stack) {
+        const message = {
+            type: 'execute_sequence',
+            id: this.nextMessageId(),
+            params: {
+                words,
+                stack: (0, serializer_js_1.serializeStack)(stack),
+            },
+        };
+        const result = await this.sendRequest(message);
+        return (0, serializer_js_1.deserializeStack)(result.stack);
+    }
+    /**
+     * List available runtime-specific modules
+     * Mirrors GrpcClient.listModules
+     */
+    async listModules() {
+        const message = {
+            type: 'list_modules',
+            id: this.nextMessageId(),
+        };
+        const result = await this.sendRequest(message);
+        return result.modules || [];
+    }
+    /**
+     * Get detailed information about a specific module
+     * Mirrors GrpcClient.getModuleInfo
+     */
+    async getModuleInfo(moduleName) {
+        const message = {
+            type: 'get_module_info',
+            id: this.nextMessageId(),
+            params: {
+                module_name: moduleName,
+            },
+        };
+        return await this.sendRequest(message);
+    }
+    /**
+     * Execute code with streaming progress updates (NEW capability)
+     */
+    async streamingExecute(code, stack, onProgress) {
+        const message = {
+            type: 'streaming_execute',
+            id: this.nextMessageId(),
+            params: {
+                code,
+                stack: (0, serializer_js_1.serializeStack)(stack),
+            },
+        };
+        const result = await this.sendStreamingRequest(message, onProgress);
+        return (0, serializer_js_1.deserializeStack)(result.stack);
+    }
+    /**
+     * Close the WebSocket connection
+     */
+    close() {
+        if (this.ws) {
+            this.config.reconnect = false; // Disable auto-reconnect
+            this.ws.close();
+            this.ws = undefined;
+            this.connected = false;
+        }
+    }
+    /**
+     * Check if the client is connected
+     */
+    isConnected() {
+        return this.connected;
+    }
+}
+exports.ActionCableClient = ActionCableClient;
+//# sourceMappingURL=action_cable_client.js.map

package/dist/cjs/websocket/action_cable_client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action_cable_client.js","sourceRoot":"","sources":["../../../src/websocket/action_cable_client.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,mDAA+E;AAC/E,2CAAiD;AAoIjD;;;;GAIG;AACH,MAAa,iBAAiB;IACpB,EAAE,CAAa;IACf,MAAM,CAAoC;IAC1C,eAAe,GAAgC,IAAI,GAAG,EAAE,CAAC;IACzD,SAAS,GAAW,CAAC,CAAC;IACtB,SAAS,GAAY,KAAK,CAAC;IAC3B,iBAAiB,CAAiB;IAE1C,YAAY,MAA+B;QACzC,IAAI,CAAC,MAAM,GAAG;YACZ,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,KAAK;YAClC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI;YACnC,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,IAAI;YAC7C,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,uBAAuB;SACnD,CAAC;QAEF,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,OAAO;QACb,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,iBAAiB,CAAC;QAChC,CAAC;QAED,IAAI,CAAC,iBAAiB,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACvD,IAAI,CAAC;gBACH,IAAI,CAAC,EAAE,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAEzC,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,GAAG,EAAE;oBACpB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;oBAEtB,mCAAmC;oBACnC,MAAM,gBAAgB,GAAG;wBACvB,OAAO,EAAE,WAAW;wBACpB,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC;4BACzB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;4BAC5B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;yBAC/B,CAAC;qBACH,CAAC;oBACF,IAAI,CAAC,EAAG,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC;oBAEhD,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC;gBAEF,IAAI,CAAC,EAAE,CAAC,SAAS,GAAG,CAAC,KAAmB,EAAE,EAAE;oBAC1C,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;gBAC5B,CAAC,CAAC;gBAEF,IAAI,CAAC,EAAE,CAAC,OAAO,GAAG,CAAC,KAAY,EAAE,EAAE;oBACjC,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;oBACzC,MAAM,CAAC,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;gBAClD,CAAC,CAAC;gBAEF,IAAI,CAAC,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE;oBACrB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;oBACvB,IAAI,CAAC,iBAAiB,GAAG,SAAS,CAAC;oBAEnC,8BAA8B;oBAC9B,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,EAAE,CAAC;wBAC3D,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC,CAAC;oBAC3D,CAAC;oBACD,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;oBAE7B,+BAA+B;oBAC/B,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;wBAC1B,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;oBAC/D,CAAC;gBACH,CAAC,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,KAAmB;QACvC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAEpC,sCAAsC;YACtC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;gBAC5F,OAAO;YACT,CAAC;YAED,uDAAuD;YACvD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;YAErC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;gBAChB,OAAO,CAAC,IAAI,CAAC,8BAA8B,EAAE,OAAO,CAAC,CAAC;gBACtD,OAAO;YACT,CAAC;YAED,oCAAoC;YACpC,IAAI,OAAO,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;gBAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBACrD,IAAI,OAAO,EAAE,UAAU,EAAE,CAAC;oBACxB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACvC,CAAC;gBACD,OAAO;YACT,CAAC;YAED,yBAAyB;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACrD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,wCAAwC,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;gBACnE,OAAO;YACT,CAAC;YAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBAClB,OAAO,CAAC,MAAM,CAAC,IAAI,8BAAkB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YACxD,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAClC,CAAC;YAED,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED;;OAEG;IACK,aAAa;QACnB,OAAO,OAAO,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IACjD,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,WAAW,CAAI,OAAoB;QAC/C,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAE7B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YAE1D,qCAAqC;YACrC,MAAM,kBAAkB,GAAG;gBACzB,OAAO,EAAE,SAAS;gBAClB,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC;oBACzB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;iBAC7B,CAAC;gBACF,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;aAC9B,CAAC;YAEF,IAAI,CAAC,EAAG,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,oBAAoB,CAChC,OAAoB,EACpB,UAA+C;QAE/C,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAE7B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;YAEtE,qCAAqC;YACrC,MAAM,kBAAkB,GAAG;gBACzB,OAAO,EAAE,SAAS;gBAClB,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC;oBACzB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;iBAC7B,CAAC;gBACF,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;aAC9B,CAAC;YAEF,IAAI,CAAC,EAAG,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe;QAC3B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CAAC,IAAY,EAAE,KAAY;QAC1C,MAAM,OAAO,GAAuB;YAClC,IAAI,EAAE,cAAc;YACpB,EAAE,EAAE,IAAI,CAAC,aAAa,EAAE;YACxB,MAAM,EAAE;gBACN,IAAI;gBACJ,KAAK,EAAE,IAAA,8BAAc,EAAC,KAAK,CAAC;aAC7B;SACF,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAA0B,OAAO,CAAC,CAAC;QACxE,OAAO,IAAA,gCAAgB,EAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,CAAC,KAAe,EAAE,KAAY;QACjD,MAAM,OAAO,GAA2B;YACtC,IAAI,EAAE,kBAAkB;YACxB,EAAE,EAAE,IAAI,CAAC,aAAa,EAAE;YACxB,MAAM,EAAE;gBACN,KAAK;gBACL,KAAK,EAAE,IAAA,8BAAc,EAAC,KAAK,CAAC;aAC7B;SACF,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAA0B,OAAO,CAAC,CAAC;QACxE,OAAO,IAAA,gCAAgB,EAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW;QACf,MAAM,OAAO,GAAuB;YAClC,IAAI,EAAE,cAAc;YACpB,EAAE,EAAE,IAAI,CAAC,aAAa,EAAE;SACzB,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAA+B,OAAO,CAAC,CAAC;QAC7E,OAAO,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,aAAa,CAAC,UAAkB;QACpC,MAAM,OAAO,GAAyB;YACpC,IAAI,EAAE,iBAAiB;YACvB,EAAE,EAAE,IAAI,CAAC,aAAa,EAAE;YACxB,MAAM,EAAE;gBACN,WAAW,EAAE,UAAU;aACxB;SACF,CAAC;QAEF,OAAO,MAAM,IAAI,CAAC,WAAW,CAAa,OAAO,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CACpB,IAAY,EACZ,KAAY,EACZ,UAA+C;QAE/C,MAAM,OAAO,GAA4B;YACvC,IAAI,EAAE,mBAAmB;YACzB,EAAE,EAAE,IAAI,CAAC,aAAa,EAAE;YACxB,MAAM,EAAE;gBACN,IAAI;gBACJ,KAAK,EAAE,IAAA,8BAAc,EAAC,KAAK,CAAC;aAC7B;SACF,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAA0B,OAAO,EAAE,UAAU,CAAC,CAAC;QAC7F,OAAO,IAAA,gCAAgB,EAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC,yBAAyB;YACxD,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,EAAE,GAAG,SAAS,CAAC;YACpB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACzB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CACF;AA1SD,8CA0SC"}