@forthix/forthic 0.7.0 → 0.7.2

package/dist/cjs/grpc/server.test.js

@@ -0,0 +1,156 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Phase 11.1: Basic server tests
+ * Verify that the TypeScript gRPC server can start and listen on port 50052
+ */
+const server_1 = require("./server");
+const grpc = __importStar(require("@grpc/grpc-js"));
+const protoLoader = __importStar(require("@grpc/proto-loader"));
+const path = __importStar(require("path"));
+describe('TypeScript gRPC Server', () => {
+    let server = null;
+    const TEST_PORT = 50053; // Use different port to avoid conflicts
+    afterEach(async () => {
+        // Clean up server if running
+        if (server) {
+            await new Promise((resolve) => {
+                server.tryShutdown(() => {
+                    resolve();
+                });
+            });
+            server = null;
+        }
+    });
+    test('server starts and listens on specified port', async () => {
+        // Start server in background (don't await)
+        const serverPromise = (0, server_1.serve)(TEST_PORT);
+        // Give server time to start
+        await new Promise((resolve) => setTimeout(resolve, 1000));
+        // Try to connect with a client
+        const possiblePaths = [
+            path.join(__dirname, '../../../../forthic/protos/forthic_runtime.proto'),
+            path.join(__dirname, '../../../forthic/protos/forthic_runtime.proto'),
+            path.join(process.cwd(), '../forthic/protos/forthic_runtime.proto'),
+        ];
+        let PROTO_PATH = possiblePaths[0];
+        const fs = require('fs');
+        for (const tryPath of possiblePaths) {
+            if (fs.existsSync(tryPath)) {
+                PROTO_PATH = tryPath;
+                break;
+            }
+        }
+        const packageDefinition = protoLoader.loadSync(PROTO_PATH, {
+            keepCase: true,
+            longs: Number,
+            enums: String,
+            defaults: true,
+            oneofs: true,
+        });
+        const protoDescriptor = grpc.loadPackageDefinition(packageDefinition);
+        const forthicProto = protoDescriptor.forthic;
+        // Create client
+        const client = new forthicProto.ForthicRuntime(`localhost:${TEST_PORT}`, grpc.credentials.createInsecure());
+        // Test that we can connect by calling ListModules
+        const response = await new Promise((resolve, reject) => {
+            client.ListModules({}, (error, response) => {
+                if (error) {
+                    reject(error);
+                }
+                else {
+                    resolve(response);
+                }
+            });
+        });
+        // Should succeed with empty module list (no TS-specific modules yet)
+        expect(response).toBeDefined();
+        expect(response.modules).toBeDefined();
+        expect(Array.isArray(response.modules)).toBe(true);
+        // Clean up client
+        grpc.closeClient(client);
+    }, 10000); // 10 second timeout
+    test('server can execute simple stdlib word', async () => {
+        // Start server
+        const serverPromise = (0, server_1.serve)(TEST_PORT);
+        await new Promise((resolve) => setTimeout(resolve, 1000));
+        // Load proto
+        const possiblePaths = [
+            path.join(__dirname, '../../../../forthic/protos/forthic_runtime.proto'),
+            path.join(__dirname, '../../../forthic/protos/forthic_runtime.proto'),
+            path.join(process.cwd(), '../forthic/protos/forthic_runtime.proto'),
+        ];
+        let PROTO_PATH = possiblePaths[0];
+        const fs = require('fs');
+        for (const tryPath of possiblePaths) {
+            if (fs.existsSync(tryPath)) {
+                PROTO_PATH = tryPath;
+                break;
+            }
+        }
+        const packageDefinition = protoLoader.loadSync(PROTO_PATH, {
+            keepCase: true,
+            longs: Number,
+            enums: String,
+            defaults: true,
+            oneofs: true,
+        });
+        const protoDescriptor = grpc.loadPackageDefinition(packageDefinition);
+        const forthicProto = protoDescriptor.forthic;
+        const client = new forthicProto.ForthicRuntime(`localhost:${TEST_PORT}`, grpc.credentials.createInsecure());
+        // Execute DUP word (duplicates top stack item)
+        const response = await new Promise((resolve, reject) => {
+            client.ExecuteWord({
+                word_name: 'DUP',
+                stack: [{ int_value: 42 }],
+            }, (error, response) => {
+                if (error) {
+                    reject(error);
+                }
+                else {
+                    resolve(response);
+                }
+            });
+        });
+        // Should have [42, 42] on stack
+        expect(response.result_stack).toBeDefined();
+        expect(response.result_stack.length).toBe(2);
+        expect(response.result_stack[0].int_value).toBe(42);
+        expect(response.result_stack[1].int_value).toBe(42);
+        grpc.closeClient(client);
+    }, 10000);
+});
+//# sourceMappingURL=server.test.js.map

package/dist/cjs/grpc/server.test.js.map

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

package/dist/cjs/grpc/temporal_utils.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Temporal Type Utilities
+ *
+ * Provides duck-typing helpers for checking Temporal types.
+ * Uses duck typing instead of instanceof to avoid issues with multiple
+ * instances of temporal-polyfill being loaded.
+ */
+/**
+ * Check if a value is a Temporal.PlainDate
+ * PlainDate has year, month, day properties but no hour property
+ */
+export declare function isPlainDate(value: any): boolean;
+/**
+ * Check if a value is a Temporal.Instant
+ * Instant has epochNanoseconds property as a bigint
+ */
+export declare function isInstant(value: any): boolean;
+/**
+ * Check if a value is a Temporal.ZonedDateTime
+ * ZonedDateTime has a timeZoneId property
+ */
+export declare function isZonedDateTime(value: any): boolean;
+/**
+ * Check if a value is a Temporal.PlainTime
+ * PlainTime has hour and minute properties but no year
+ */
+export declare function isPlainTime(value: any): boolean;
+/**
+ * Check if a value is a Temporal.PlainDateTime
+ * PlainDateTime has year, month, day, hour properties but no timeZoneId
+ */
+export declare function isPlainDateTime(value: any): boolean;
+/**
+ * Check if a value is any Temporal type
+ */
+export declare function isTemporal(value: any): boolean;

package/dist/cjs/grpc/temporal_utils.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * Temporal Type Utilities
+ *
+ * Provides duck-typing helpers for checking Temporal types.
+ * Uses duck typing instead of instanceof to avoid issues with multiple
+ * instances of temporal-polyfill being loaded.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPlainDate = isPlainDate;
+exports.isInstant = isInstant;
+exports.isZonedDateTime = isZonedDateTime;
+exports.isPlainTime = isPlainTime;
+exports.isPlainDateTime = isPlainDateTime;
+exports.isTemporal = isTemporal;
+/**
+ * Check if a value is a Temporal.PlainDate
+ * PlainDate has year, month, day properties but no hour property
+ */
+function isPlainDate(value) {
+    return value && typeof value === 'object' &&
+        typeof value.year === 'number' &&
+        typeof value.month === 'number' &&
+        typeof value.day === 'number' &&
+        typeof value.toString === 'function' &&
+        !value.hour; // PlainDate doesn't have hour
+}
+/**
+ * Check if a value is a Temporal.Instant
+ * Instant has epochNanoseconds property as a bigint
+ */
+function isInstant(value) {
+    return value && typeof value === 'object' &&
+        typeof value.epochNanoseconds === 'bigint' &&
+        typeof value.toString === 'function';
+}
+/**
+ * Check if a value is a Temporal.ZonedDateTime
+ * ZonedDateTime has a timeZoneId property
+ */
+function isZonedDateTime(value) {
+    return value && typeof value === 'object' &&
+        typeof value.timeZoneId === 'string' &&
+        typeof value.toString === 'function';
+}
+/**
+ * Check if a value is a Temporal.PlainTime
+ * PlainTime has hour and minute properties but no year
+ */
+function isPlainTime(value) {
+    return value && typeof value === 'object' &&
+        typeof value.hour === 'number' &&
+        typeof value.minute === 'number' &&
+        typeof value.toString === 'function' &&
+        !value.year; // PlainTime doesn't have year
+}
+/**
+ * Check if a value is a Temporal.PlainDateTime
+ * PlainDateTime has year, month, day, hour properties but no timeZoneId
+ */
+function isPlainDateTime(value) {
+    return value && typeof value === 'object' &&
+        typeof value.year === 'number' &&
+        typeof value.month === 'number' &&
+        typeof value.day === 'number' &&
+        typeof value.hour === 'number' &&
+        typeof value.toString === 'function' &&
+        !value.timeZoneId; // PlainDateTime doesn't have timeZoneId
+}
+/**
+ * Check if a value is any Temporal type
+ */
+function isTemporal(value) {
+    return isPlainDate(value) ||
+        isInstant(value) ||
+        isZonedDateTime(value) ||
+        isPlainTime(value) ||
+        isPlainDateTime(value);
+}
+//# sourceMappingURL=temporal_utils.js.map

package/dist/cjs/grpc/temporal_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal_utils.js","sourceRoot":"","sources":["../../../src/grpc/temporal_utils.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAMH,kCAOC;AAMD,8BAIC;AAMD,0CAIC;AAMD,kCAMC;AAMD,0CAQC;AAKD,gCAMC;AApED;;;GAGG;AACH,SAAgB,WAAW,CAAC,KAAU;IACpC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAClC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;QAC/B,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ;QAC7B,OAAO,KAAK,CAAC,QAAQ,KAAK,UAAU;QACpC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAE,8BAA8B;AACrD,CAAC;AAED;;;GAGG;AACH,SAAgB,SAAS,CAAC,KAAU;IAClC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAClC,OAAO,KAAK,CAAC,gBAAgB,KAAK,QAAQ;QAC1C,OAAO,KAAK,CAAC,QAAQ,KAAK,UAAU,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAAC,KAAU;IACxC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAClC,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ;QACpC,OAAO,KAAK,CAAC,QAAQ,KAAK,UAAU,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,SAAgB,WAAW,CAAC,KAAU;IACpC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAClC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAChC,OAAO,KAAK,CAAC,QAAQ,KAAK,UAAU;QACpC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAE,8BAA8B;AACrD,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAAC,KAAU;IACxC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAClC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;QAC/B,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ;QAC7B,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,OAAO,KAAK,CAAC,QAAQ,KAAK,UAAU;QACpC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAE,wCAAwC;AACrE,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU,CAAC,KAAU;IACnC,OAAO,WAAW,CAAC,KAAK,CAAC;QAClB,SAAS,CAAC,KAAK,CAAC;QAChB,eAAe,CAAC,KAAK,CAAC;QACtB,WAAW,CAAC,KAAK,CAAC;QAClB,eAAe,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC"}

package/dist/cjs/test-setup.d.ts

@@ -0,0 +1 @@
+import "temporal-polyfill/global";

package/dist/cjs/test-setup.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+require("temporal-polyfill/global");
+//# sourceMappingURL=test-setup.js.map

package/dist/cjs/test-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-setup.js","sourceRoot":"","sources":["../../src/test-setup.ts"],"names":[],"mappings":";;AAAA,oCAAkC"}

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