tywrap 0.2.0 → 0.3.0

package/dist/runtime/worker-pool.d.ts

@@ -0,0 +1,208 @@
+/**
+ * WorkerPool - Manages multiple Transport instances for concurrent request handling.
+ *
+ * Provides semaphore-based concurrency control with configurable limits per worker
+ * and a wait queue for callers when all workers are at capacity.
+ *
+ * @see https://github.com/bbopen/tywrap/issues/149
+ */
+import { BoundedContext } from './bounded-context.js';
+import type { Transport } from './transport.js';
+/**
+ * Configuration options for the WorkerPool.
+ */
+export interface WorkerPoolOptions {
+    /** Factory function to create transports */
+    createTransport: () => Transport;
+    /** Maximum number of workers in the pool */
+    maxWorkers: number;
+    /** Minimum number of workers to pre-spawn during init. Default: 0 (lazy) */
+    minWorkers?: number;
+    /** Timeout for waiting in queue (ms). Default: 30000 */
+    queueTimeoutMs?: number;
+    /** Maximum concurrent requests per worker. Default: 1 */
+    maxConcurrentPerWorker?: number;
+    /**
+     * Callback invoked after each worker is created and initialized.
+     * Use this for per-worker warmup (e.g., importing modules, running setup).
+     */
+    onWorkerReady?: (worker: PooledWorker) => Promise<void>;
+    /**
+     * Optional callback used only for background replacement workers after a
+     * fatal timeout/crash. This lets callers publish a replacement only after it
+     * is proven ready, without charging hidden work to normal request startup.
+     */
+    onReplacementWorkerReady?: (worker: PooledWorker) => Promise<void>;
+}
+/**
+ * A pooled worker with its transport and current in-flight request count.
+ */
+export interface PooledWorker {
+    /** The underlying transport instance */
+    transport: Transport;
+    /** Number of requests currently being processed by this worker */
+    inFlightCount: number;
+}
+/**
+ * Pool of Transport workers with semaphore-based concurrency control.
+ *
+ * Features:
+ * - Lazy worker creation (workers created on demand)
+ * - Configurable concurrency per worker
+ * - Wait queue with timeout for callers when pool is at capacity
+ * - Automatic cleanup of timers and workers on disposal
+ *
+ * @example
+ * ```typescript
+ * const pool = new WorkerPool({
+ *   createTransport: () => new ProcessIO({ pythonPath: 'python3' }),
+ *   maxWorkers: 4,
+ *   maxConcurrentPerWorker: 2,
+ *   queueTimeoutMs: 5000,
+ * });
+ *
+ * await pool.init();
+ *
+ * // Use withWorker for automatic acquire/release
+ * const result = await pool.withWorker(async (worker) => {
+ *   return worker.transport.send(message, timeout);
+ * });
+ *
+ * await pool.dispose();
+ * ```
+ */
+export declare class WorkerPool extends BoundedContext {
+    private readonly options;
+    private readonly workers;
+    private readonly waitQueue;
+    /** Tracks workers being created to prevent race condition in acquire() */
+    private pendingCreations;
+    /**
+     * Create a new WorkerPool.
+     *
+     * @param options - Pool configuration options
+     */
+    constructor(options: WorkerPoolOptions);
+    /**
+     * Initialize the pool.
+     *
+     * If minWorkers > 0, pre-spawns workers during initialization.
+     * Otherwise, workers are created lazily on demand.
+     */
+    protected doInit(): Promise<void>;
+    /**
+     * Dispose the pool and all workers.
+     *
+     * - Rejects all waiters in the queue
+     * - Disposes all transport instances
+     * - Clears internal state
+     */
+    protected doDispose(): Promise<void>;
+    /**
+     * Acquire a worker from the pool.
+     *
+     * This method:
+     * - Returns an available worker if one exists (inFlightCount < maxConcurrentPerWorker)
+     * - Creates a new worker if under the maxWorkers limit
+     * - Waits in queue if all workers are at capacity
+     *
+     * @returns Promise resolving to a pooled worker
+     * @throws BridgeTimeoutError if queue timeout expires
+     * @throws BridgeExecutionError if pool is disposed while waiting
+     */
+    acquire(): Promise<PooledWorker>;
+    /**
+     * Release a worker back to the pool.
+     *
+     * Decrements the worker's in-flight count and notifies any waiters
+     * that a worker may be available.
+     *
+     * @param worker - The worker to release
+     */
+    release(worker: PooledWorker): void;
+    /**
+     * Execute a function with an acquired worker, automatically releasing afterward.
+     *
+     * This is the recommended way to use the pool, as it ensures proper cleanup
+     * even if the function throws an error.
+     *
+     * @param fn - Async function to execute with the worker
+     * @returns Promise resolving to the function's return value
+     *
+     * @example
+     * ```typescript
+     * const result = await pool.withWorker(async (worker) => {
+     *   return worker.transport.send(message, timeout);
+     * });
+     * ```
+     */
+    withWorker<T>(fn: (worker: PooledWorker) => Promise<T>): Promise<T>;
+    /**
+     * Check if an error indicates the worker is dead and should be removed.
+     *
+     * Fatal errors include:
+     * - Process not running
+     * - Process exited unexpectedly
+     * - Pipe errors (EPIPE)
+     * - Connection reset errors (ECONNRESET)
+     * - Request timeouts (the worker may still be busy with an uncancellable request)
+     */
+    private isFatalWorkerError;
+    /**
+     * Remove a worker from the pool.
+     *
+     * This is called when a worker is detected as dead (crashed, pipe error, etc.).
+     * The worker's transport is disposed in the background.
+     */
+    private removeWorker;
+    /**
+     * Current number of workers in the pool.
+     */
+    get workerCount(): number;
+    /**
+     * Number of callers waiting in the queue.
+     */
+    get queueLength(): number;
+    /**
+     * Total number of in-flight requests across all workers.
+     */
+    get totalInFlight(): number;
+    /**
+     * Find an available worker with capacity for another request.
+     */
+    private findAvailableWorker;
+    /**
+     * Replace a removed worker in the background so the next caller does not pay
+     * the full worker cold-start penalty after a timeout or crash.
+     */
+    private scheduleReplacementWorker;
+    /**
+     * Create a new worker and add it to the pool.
+     *
+     * If onWorkerReady is configured, calls it after the transport is initialized.
+     * This is useful for per-worker warmup (importing modules, running setup).
+     */
+    private createWorker;
+    /**
+     * Wait in queue for a worker to become available.
+     */
+    private waitForWorker;
+    /**
+     * Not implemented - WorkerPool does not execute Python calls directly.
+     * Use the BridgeProtocol layer with a pooled worker's transport.
+     */
+    call<T = unknown>(_module: string, _functionName: string, _args: unknown[], _kwargs?: Record<string, unknown>): Promise<T>;
+    /**
+     * Not implemented - WorkerPool does not execute Python calls directly.
+     */
+    instantiate<T = unknown>(_module: string, _className: string, _args: unknown[], _kwargs?: Record<string, unknown>): Promise<T>;
+    /**
+     * Not implemented - WorkerPool does not execute Python calls directly.
+     */
+    callMethod<T = unknown>(_handle: string, _methodName: string, _args: unknown[], _kwargs?: Record<string, unknown>): Promise<T>;
+    /**
+     * Not implemented - WorkerPool does not execute Python calls directly.
+     */
+    disposeInstance(_handle: string): Promise<void>;
+}
+//# sourceMappingURL=worker-pool.d.ts.map

package/dist/runtime/worker-pool.d.ts.map

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

package/dist/runtime/worker-pool.js

@@ -0,0 +1,419 @@
+/**
+ * WorkerPool - Manages multiple Transport instances for concurrent request handling.
+ *
+ * Provides semaphore-based concurrency control with configurable limits per worker
+ * and a wait queue for callers when all workers are at capacity.
+ *
+ * @see https://github.com/bbopen/tywrap/issues/149
+ */
+import { BoundedContext } from './bounded-context.js';
+import { BridgeTimeoutError, BridgeExecutionError, BridgeProtocolError } from './errors.js';
+// =============================================================================
+// WORKER POOL
+// =============================================================================
+/**
+ * Pool of Transport workers with semaphore-based concurrency control.
+ *
+ * Features:
+ * - Lazy worker creation (workers created on demand)
+ * - Configurable concurrency per worker
+ * - Wait queue with timeout for callers when pool is at capacity
+ * - Automatic cleanup of timers and workers on disposal
+ *
+ * @example
+ * ```typescript
+ * const pool = new WorkerPool({
+ *   createTransport: () => new ProcessIO({ pythonPath: 'python3' }),
+ *   maxWorkers: 4,
+ *   maxConcurrentPerWorker: 2,
+ *   queueTimeoutMs: 5000,
+ * });
+ *
+ * await pool.init();
+ *
+ * // Use withWorker for automatic acquire/release
+ * const result = await pool.withWorker(async (worker) => {
+ *   return worker.transport.send(message, timeout);
+ * });
+ *
+ * await pool.dispose();
+ * ```
+ */
+export class WorkerPool extends BoundedContext {
+    options;
+    workers = [];
+    waitQueue = [];
+    /** Tracks workers being created to prevent race condition in acquire() */
+    pendingCreations = 0;
+    /**
+     * Create a new WorkerPool.
+     *
+     * @param options - Pool configuration options
+     */
+    constructor(options) {
+        super();
+        // Validate required options
+        if (typeof options.createTransport !== 'function') {
+            throw new BridgeExecutionError('createTransport must be a function');
+        }
+        if (typeof options.maxWorkers !== 'number' || options.maxWorkers < 1) {
+            throw new BridgeExecutionError('maxWorkers must be a positive number');
+        }
+        const minWorkers = options.minWorkers ?? 0;
+        if (minWorkers > options.maxWorkers) {
+            throw new BridgeExecutionError('minWorkers cannot exceed maxWorkers');
+        }
+        this.options = {
+            createTransport: options.createTransport,
+            maxWorkers: options.maxWorkers,
+            minWorkers,
+            queueTimeoutMs: options.queueTimeoutMs ?? 30000,
+            maxConcurrentPerWorker: options.maxConcurrentPerWorker ?? 1,
+            onWorkerReady: options.onWorkerReady,
+            onReplacementWorkerReady: options.onReplacementWorkerReady,
+        };
+    }
+    // ===========================================================================
+    // LIFECYCLE
+    // ===========================================================================
+    /**
+     * Initialize the pool.
+     *
+     * If minWorkers > 0, pre-spawns workers during initialization.
+     * Otherwise, workers are created lazily on demand.
+     */
+    async doInit() {
+        // Pre-spawn minimum workers if configured
+        if (this.options.minWorkers > 0) {
+            const spawns = [];
+            for (let i = 0; i < this.options.minWorkers; i++) {
+                spawns.push(this.createWorker());
+            }
+            await Promise.all(spawns);
+        }
+    }
+    /**
+     * Dispose the pool and all workers.
+     *
+     * - Rejects all waiters in the queue
+     * - Disposes all transport instances
+     * - Clears internal state
+     */
+    async doDispose() {
+        // Reject all waiters in the queue
+        for (const waiter of this.waitQueue) {
+            clearTimeout(waiter.timer);
+            waiter.reject(new BridgeExecutionError('Pool disposed'));
+        }
+        this.waitQueue.length = 0;
+        // Dispose all workers
+        const errors = [];
+        for (const worker of this.workers) {
+            try {
+                await worker.transport.dispose();
+            }
+            catch (e) {
+                errors.push(e instanceof Error ? e : new Error(String(e)));
+            }
+        }
+        this.workers.length = 0;
+        // Report errors if any
+        if (errors.length === 1) {
+            throw errors[0];
+        }
+        if (errors.length > 1) {
+            throw new AggregateError(errors, 'Multiple errors during worker disposal');
+        }
+    }
+    // ===========================================================================
+    // WORKER MANAGEMENT
+    // ===========================================================================
+    /**
+     * Acquire a worker from the pool.
+     *
+     * This method:
+     * - Returns an available worker if one exists (inFlightCount < maxConcurrentPerWorker)
+     * - Creates a new worker if under the maxWorkers limit
+     * - Waits in queue if all workers are at capacity
+     *
+     * @returns Promise resolving to a pooled worker
+     * @throws BridgeTimeoutError if queue timeout expires
+     * @throws BridgeExecutionError if pool is disposed while waiting
+     */
+    async acquire() {
+        // Check for disposed state
+        if (this.isDisposed) {
+            throw new BridgeExecutionError('Pool has been disposed');
+        }
+        // Find an available worker (one with capacity)
+        const availableWorker = this.findAvailableWorker();
+        if (availableWorker) {
+            availableWorker.inFlightCount++;
+            return availableWorker;
+        }
+        // Create a new worker if under the limit
+        // Include pendingCreations to prevent race condition where multiple
+        // concurrent acquire() calls all pass the length check before any
+        // worker is actually added to the array
+        if (this.workers.length + this.pendingCreations < this.options.maxWorkers) {
+            this.pendingCreations++;
+            try {
+                const newWorker = await this.createWorker();
+                newWorker.inFlightCount++;
+                return newWorker;
+            }
+            finally {
+                this.pendingCreations--;
+            }
+        }
+        // All workers at capacity - wait in queue
+        return this.waitForWorker();
+    }
+    /**
+     * Release a worker back to the pool.
+     *
+     * Decrements the worker's in-flight count and notifies any waiters
+     * that a worker may be available.
+     *
+     * @param worker - The worker to release
+     */
+    release(worker) {
+        // Validate the worker belongs to this pool
+        if (!this.workers.includes(worker)) {
+            return;
+        }
+        // Decrement in-flight count (minimum 0)
+        worker.inFlightCount = Math.max(0, worker.inFlightCount - 1);
+        // If there are waiters and this worker has capacity, fulfill the first waiter
+        if (this.waitQueue.length > 0 && worker.inFlightCount < this.options.maxConcurrentPerWorker) {
+            const waiter = this.waitQueue.shift();
+            if (waiter) {
+                clearTimeout(waiter.timer);
+                worker.inFlightCount++;
+                waiter.resolve(worker);
+            }
+        }
+    }
+    /**
+     * Execute a function with an acquired worker, automatically releasing afterward.
+     *
+     * This is the recommended way to use the pool, as it ensures proper cleanup
+     * even if the function throws an error.
+     *
+     * @param fn - Async function to execute with the worker
+     * @returns Promise resolving to the function's return value
+     *
+     * @example
+     * ```typescript
+     * const result = await pool.withWorker(async (worker) => {
+     *   return worker.transport.send(message, timeout);
+     * });
+     * ```
+     */
+    async withWorker(fn) {
+        const worker = await this.acquire();
+        let workerRemoved = false;
+        try {
+            return await fn(worker);
+        }
+        catch (error) {
+            // If this is a fatal error indicating the worker is dead, remove it from the pool
+            if (this.isFatalWorkerError(error)) {
+                this.removeWorker(worker);
+                workerRemoved = true;
+            }
+            throw error;
+        }
+        finally {
+            // Only release if worker wasn't removed due to fatal error
+            if (!workerRemoved) {
+                this.release(worker);
+            }
+        }
+    }
+    // ===========================================================================
+    // WORKER HEALTH
+    // ===========================================================================
+    /**
+     * Check if an error indicates the worker is dead and should be removed.
+     *
+     * Fatal errors include:
+     * - Process not running
+     * - Process exited unexpectedly
+     * - Pipe errors (EPIPE)
+     * - Connection reset errors (ECONNRESET)
+     * - Request timeouts (the worker may still be busy with an uncancellable request)
+     */
+    isFatalWorkerError(error) {
+        // If a request times out, the underlying transport may still be executing it.
+        // Quarantine this worker so subsequent requests don't get stuck behind it.
+        if (error instanceof BridgeTimeoutError) {
+            return true;
+        }
+        if (error instanceof BridgeProtocolError) {
+            const msg = error.message.toLowerCase();
+            return (msg.includes('not running') ||
+                msg.includes('process exited') ||
+                msg.includes('epipe') ||
+                msg.includes('econnreset'));
+        }
+        return false;
+    }
+    /**
+     * Remove a worker from the pool.
+     *
+     * This is called when a worker is detected as dead (crashed, pipe error, etc.).
+     * The worker's transport is disposed in the background.
+     */
+    removeWorker(worker) {
+        const index = this.workers.indexOf(worker);
+        if (index !== -1) {
+            this.workers.splice(index, 1);
+            // Dispose transport in background - don't await to avoid blocking
+            worker.transport.dispose().catch(() => {
+                // Ignore disposal errors for dead workers
+            });
+            this.scheduleReplacementWorker();
+        }
+    }
+    // ===========================================================================
+    // POOL STATISTICS
+    // ===========================================================================
+    /**
+     * Current number of workers in the pool.
+     */
+    get workerCount() {
+        return this.workers.length;
+    }
+    /**
+     * Number of callers waiting in the queue.
+     */
+    get queueLength() {
+        return this.waitQueue.length;
+    }
+    /**
+     * Total number of in-flight requests across all workers.
+     */
+    get totalInFlight() {
+        return this.workers.reduce((sum, w) => sum + w.inFlightCount, 0);
+    }
+    // ===========================================================================
+    // PRIVATE HELPERS
+    // ===========================================================================
+    /**
+     * Find an available worker with capacity for another request.
+     */
+    findAvailableWorker() {
+        return this.workers.find(w => w.inFlightCount < this.options.maxConcurrentPerWorker);
+    }
+    /**
+     * Replace a removed worker in the background so the next caller does not pay
+     * the full worker cold-start penalty after a timeout or crash.
+     */
+    scheduleReplacementWorker() {
+        if (this.state !== 'ready') {
+            return;
+        }
+        if (this.workers.length + this.pendingCreations >= this.options.maxWorkers) {
+            return;
+        }
+        this.pendingCreations++;
+        const replacementReady = this.options.onReplacementWorkerReady ?? this.options.onWorkerReady;
+        this.createWorker(replacementReady)
+            .then(worker => {
+            // Reuse release() to wake queued callers if one is waiting.
+            this.release(worker);
+        })
+            .catch(() => {
+            // Ignore background replacement failures. A later acquire() can retry.
+        })
+            .finally(() => {
+            this.pendingCreations = Math.max(0, this.pendingCreations - 1);
+        });
+    }
+    /**
+     * Create a new worker and add it to the pool.
+     *
+     * If onWorkerReady is configured, calls it after the transport is initialized.
+     * This is useful for per-worker warmup (importing modules, running setup).
+     */
+    async createWorker(onWorkerReady = this.options.onWorkerReady) {
+        const transport = this.options.createTransport();
+        // Initialize the transport
+        await transport.init();
+        const worker = {
+            transport,
+            inFlightCount: 0,
+        };
+        try {
+            // Call onWorkerReady callback if provided
+            if (onWorkerReady) {
+                await onWorkerReady(worker);
+            }
+        }
+        catch (error) {
+            // Ensure partially initialized workers do not leak when warmup fails.
+            await transport.dispose().catch(() => {
+                // Ignore disposal failures during warmup failure handling.
+            });
+            throw error;
+        }
+        if (this.state === 'disposing' || this.state === 'disposed') {
+            await transport.dispose().catch(() => {
+                // Ignore disposal failures if the pool was torn down mid-creation.
+            });
+            throw new BridgeExecutionError('Pool disposed during worker creation');
+        }
+        this.workers.push(worker);
+        return worker;
+    }
+    /**
+     * Wait in queue for a worker to become available.
+     */
+    waitForWorker() {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                // Remove this waiter from the queue
+                const index = this.waitQueue.findIndex(w => w.timer === timer);
+                if (index !== -1) {
+                    this.waitQueue.splice(index, 1);
+                }
+                reject(new BridgeTimeoutError(`Timed out waiting for available worker after ${this.options.queueTimeoutMs}ms`));
+            }, this.options.queueTimeoutMs);
+            // Unref the timer so it doesn't keep the Node.js process alive
+            if (typeof timer.unref === 'function') {
+                timer.unref();
+            }
+            this.waitQueue.push({ resolve, reject, timer });
+        });
+    }
+    // ===========================================================================
+    // RUNTIME EXECUTION (Not implemented - WorkerPool is just for worker management)
+    // ===========================================================================
+    /**
+     * Not implemented - WorkerPool does not execute Python calls directly.
+     * Use the BridgeProtocol layer with a pooled worker's transport.
+     */
+    async call(_module, _functionName, _args, _kwargs) {
+        throw new BridgeExecutionError('WorkerPool does not implement call() - use withWorker() to get a transport');
+    }
+    /**
+     * Not implemented - WorkerPool does not execute Python calls directly.
+     */
+    async instantiate(_module, _className, _args, _kwargs) {
+        throw new BridgeExecutionError('WorkerPool does not implement instantiate() - use withWorker() to get a transport');
+    }
+    /**
+     * Not implemented - WorkerPool does not execute Python calls directly.
+     */
+    async callMethod(_handle, _methodName, _args, _kwargs) {
+        throw new BridgeExecutionError('WorkerPool does not implement callMethod() - use withWorker() to get a transport');
+    }
+    /**
+     * Not implemented - WorkerPool does not execute Python calls directly.
+     */
+    async disposeInstance(_handle) {
+        throw new BridgeExecutionError('WorkerPool does not implement disposeInstance() - use withWorker() to get a transport');
+    }
+}
+//# sourceMappingURL=worker-pool.js.map

package/dist/runtime/worker-pool.js.map

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