@forthix/forthic 0.7.2 → 0.8.0

package/dist/cjs/websocket/client.js

@@ -1,266 +0,0 @@
-"use strict";
-/**
- * WebSocket Client for Forthic
- * Browser-compatible client that mirrors GrpcClient API
- * Connects to Rails ActionCable server and executes remote words
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WebSocketClient = void 0;
-const serializer_js_1 = require("./serializer.js");
-const errors_js_1 = require("./errors.js");
-/**
- * WebSocket client for executing words in remote Forthic runtimes
- * Mirrors the GrpcClient API for compatibility
- */
-class WebSocketClient {
-    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
-     */
-    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
-     */
-    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.WebSocketClient = WebSocketClient;
-//# sourceMappingURL=client.js.map

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

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

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

@@ -1,68 +0,0 @@
-/**
- * WebSocketRemoteModule - Module that wraps runtime-specific words from a remote runtime
- * Mirrors RemoteModule from gRPC implementation
- */
-import { Module } from '../forthic/module.js';
-import { Interpreter } from '../forthic/interpreter.js';
-import { ActionCableClient, type ModuleInfo } from './action_cable_client.js';
-/**
- * WebSocketRemoteModule - Module containing proxy words that execute in a remote runtime
- *
- * This module discovers words from a remote runtime (e.g., pandas module in Ruby)
- * and creates WebSocketRemoteWord proxies for each discovered word. When used in TypeScript
- * Forthic code, these words execute in the remote runtime via ActionCable.
- *
- * Example usage:
- * ```typescript
- * const client = new ActionCableClient({ url: 'ws://localhost:3000/cable' });
- * const pandasModule = new WebSocketRemoteModule('pandas', client, 'rails');
- * await pandasModule.initialize();
- * interp.register_module(pandasModule);
- * interp.use_modules(['pandas']);
- *
- * // Now pandas words execute in Rails runtime
- * await interp.run(`
- *   [ [[.name "Alice"]  [.age 30]] REC]
- *   DF-FROM-RECORDS  # Executes in Rails!
- * `);
- * ```
- */
-export declare class WebSocketRemoteModule extends Module {
-    private client;
-    private runtimeName;
-    private initialized;
-    private moduleInfo;
-    /**
-     * @param moduleName - Name of the module in the remote runtime (e.g., "pandas")
-     * @param client - ActionCable client connected to the remote runtime
-     * @param runtimeName - Name of the runtime (e.g., "rails") for debugging
-     */
-    constructor(moduleName: string, client: ActionCableClient, runtimeName?: string);
-    /**
-     * Initialize the module by discovering words from the remote runtime
-     *
-     * This must be called before the module is registered with an interpreter.
-     * It fetches the module metadata and creates WebSocketRemoteWord proxies for each word.
-     */
-    initialize(): Promise<void>;
-    /**
-     * Override set_interp to ensure module is initialized
-     */
-    set_interp(interp: Interpreter): void;
-    /**
-     * Get the module metadata from the remote runtime
-     */
-    getModuleInfo(): ModuleInfo | null;
-    /**
-     * Get runtime name for debugging
-     */
-    getRuntimeName(): string;
-    /**
-     * Check if module is initialized
-     */
-    isInitialized(): boolean;
-    /**
-     * Get count of discovered words
-     */
-    getWordCount(): number;
-}

package/dist/cjs/websocket/remote_module.js

@@ -1,107 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WebSocketRemoteModule = void 0;
-/**
- * WebSocketRemoteModule - Module that wraps runtime-specific words from a remote runtime
- * Mirrors RemoteModule from gRPC implementation
- */
-const module_js_1 = require("../forthic/module.js");
-const remote_word_js_1 = require("./remote_word.js");
-/**
- * WebSocketRemoteModule - Module containing proxy words that execute in a remote runtime
- *
- * This module discovers words from a remote runtime (e.g., pandas module in Ruby)
- * and creates WebSocketRemoteWord proxies for each discovered word. When used in TypeScript
- * Forthic code, these words execute in the remote runtime via ActionCable.
- *
- * Example usage:
- * ```typescript
- * const client = new ActionCableClient({ url: 'ws://localhost:3000/cable' });
- * const pandasModule = new WebSocketRemoteModule('pandas', client, 'rails');
- * await pandasModule.initialize();
- * interp.register_module(pandasModule);
- * interp.use_modules(['pandas']);
- *
- * // Now pandas words execute in Rails runtime
- * await interp.run(`
- *   [ [[.name "Alice"]  [.age 30]] REC]
- *   DF-FROM-RECORDS  # Executes in Rails!
- * `);
- * ```
- */
-class WebSocketRemoteModule extends module_js_1.Module {
-    client;
-    runtimeName;
-    initialized = false;
-    moduleInfo = null;
-    /**
-     * @param moduleName - Name of the module in the remote runtime (e.g., "pandas")
-     * @param client - ActionCable client connected to the remote runtime
-     * @param runtimeName - Name of the runtime (e.g., "rails") for debugging
-     */
-    constructor(moduleName, client, runtimeName = 'remote') {
-        super(moduleName);
-        this.client = client;
-        this.runtimeName = runtimeName;
-    }
-    /**
-     * Initialize the module by discovering words from the remote runtime
-     *
-     * This must be called before the module is registered with an interpreter.
-     * It fetches the module metadata and creates WebSocketRemoteWord proxies for each word.
-     */
-    async initialize() {
-        if (this.initialized) {
-            return;
-        }
-        try {
-            // Discover module info from remote runtime
-            this.moduleInfo = await this.client.getModuleInfo(this.name);
-            // Create WebSocketRemoteWord for each discovered word
-            for (const wordInfo of this.moduleInfo.words) {
-                const remoteWord = new remote_word_js_1.WebSocketRemoteWord(wordInfo.name, this.client, this.runtimeName, this.name, wordInfo.stack_effect, wordInfo.description);
-                // Add as exportable word (visible when module is imported)
-                this.add_exportable_word(remoteWord);
-            }
-            this.initialized = true;
-        }
-        catch (error) {
-            throw new Error(`Failed to initialize remote module '${this.name}' from ${this.runtimeName} runtime: ${error.message}`);
-        }
-    }
-    /**
-     * Override set_interp to ensure module is initialized
-     */
-    set_interp(interp) {
-        if (!this.initialized) {
-            throw new Error(`WebSocketRemoteModule '${this.name}' must be initialized before being registered with an interpreter. Call await module.initialize() first.`);
-        }
-        super.set_interp(interp);
-    }
-    /**
-     * Get the module metadata from the remote runtime
-     */
-    getModuleInfo() {
-        return this.moduleInfo;
-    }
-    /**
-     * Get runtime name for debugging
-     */
-    getRuntimeName() {
-        return this.runtimeName;
-    }
-    /**
-     * Check if module is initialized
-     */
-    isInitialized() {
-        return this.initialized;
-    }
-    /**
-     * Get count of discovered words
-     */
-    getWordCount() {
-        return this.moduleInfo?.words?.length || 0;
-    }
-}
-exports.WebSocketRemoteModule = WebSocketRemoteModule;
-//# sourceMappingURL=remote_module.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"remote_module.js","sourceRoot":"","sources":["../../../src/websocket/remote_module.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,oDAA8C;AAG9C,qDAAuD;AAEvD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAa,qBAAsB,SAAQ,kBAAM;IACvC,MAAM,CAAoB;IAC1B,WAAW,CAAS;IACpB,WAAW,GAAY,KAAK,CAAC;IAC7B,UAAU,GAAsB,IAAI,CAAC;IAE7C;;;;OAIG;IACH,YAAY,UAAkB,EAAE,MAAyB,EAAE,cAAsB,QAAQ;QACvF,KAAK,CAAC,UAAU,CAAC,CAAC;QAClB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,2CAA2C;YAC3C,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAE7D,sDAAsD;YACtD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;gBAC7C,MAAM,UAAU,GAAG,IAAI,oCAAmB,CACxC,QAAQ,CAAC,IAAI,EACb,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,IAAI,EACT,QAAQ,CAAC,YAAY,EACrB,QAAQ,CAAC,WAAW,CACrB,CAAC;gBAEF,2DAA2D;gBAC3D,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;YACvC,CAAC;YAED,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,uCAAuC,IAAI,CAAC,IAAI,UAAU,IAAI,CAAC,WAAW,aAAc,KAAe,CAAC,OAAO,EAAE,CAClH,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,MAAmB;QAC5B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,0BAA0B,IAAI,CAAC,IAAI,0GAA0G,CAC9I,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC;IAC7C,CAAC;CACF;AA9FD,sDA8FC"}

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

@@ -1,53 +0,0 @@
-/**
- * WebSocketRemoteWord - Word that executes in a remote runtime via ActionCable
- * Mirrors RemoteWord from gRPC implementation
- */
-import { Word, RuntimeInfo } from '../forthic/module.js';
-import { Interpreter } from '../forthic/interpreter.js';
-import { ActionCableClient } from './action_cable_client.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.
- */
-export declare class WebSocketRemoteWord extends Word {
-    private client;
-    private runtimeName;
-    private moduleName;
-    stackEffect: string;
-    description: string;
-    /**
-     * @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: string, client: ActionCableClient, runtimeName: string, moduleName: string, stackEffect?: string, description?: string);
-    /**
-     * Execute word in remote runtime
-     *
-     * Captures entire stack, sends to remote runtime, and replaces stack with result.
-     */
-    execute(interp: Interpreter): Promise<void>;
-    /**
-     * Get runtime name for debugging/introspection
-     */
-    getRuntimeName(): string;
-    /**
-     * Get module name for debugging/introspection
-     */
-    getModuleName(): string;
-    /**
-     * Get runtime execution information
-     * RemoteWords are runtime-specific and can only execute in their designated runtime
-     */
-    getRuntimeInfo(): RuntimeInfo;
-}

package/dist/cjs/websocket/remote_word.js

@@ -1,93 +0,0 @@
-"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/remote_word.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"remote_word.js","sourceRoot":"","sources":["../../../src/websocket/remote_word.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,oDAAyD;AAIzD;;;;;;;;;;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/runtime_manager.d.ts

@@ -1,69 +0,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
- */
-import { ActionCableClient, ActionCableClientConfig } from './action_cable_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;
-}