tywrap 0.3.0 → 0.5.0

package/dist/runtime/{bridge-protocol.d.ts → rpc-client.d.ts}

@@ -1,22 +1,24 @@
 /**
- * BridgeProtocol - Unified abstraction for JS<->Python communication.
+ * RpcClient - the single correlated-RPC client for JS<->Python communication.
  *
- * Combines BoundedContext + SafeCodec + Transport into a single base class
- * that handles all cross-boundary concerns:
- * - Lifecycle management (init/dispose state machine)
- * - Request/response encoding with validation
- * - Transport-agnostic message passing
- * - Bounded execution (timeout, retry, abort)
+ * It HOLDS a Transport and a codec (SafeCodec) and is, in turn, HELD by the
+ * bridge facades (NodeBridge/HttpBridge/PyodideBridge) via composition — it is
+ * NOT a base class bridges extend. It owns the one place where the wire frame
+ * is built and correlated: id generation, {id, protocol} stamping, codec
+ * encode/decode, and transport.send. It composes DisposableBase to obtain its
+ * lifecycle (init/dispose) and bounded execution (timeout/retry/abort), but it
+ * carries no PythonRuntime contract obligation — the facade implements
+ * PythonRuntime and delegates the four RPC methods to this client.
  *
- * Subclasses (NodeBridge, HttpBridge, PyodideBridge) only need to:
- * 1. Create their transport in their constructor
- * 2. Pass it to super() via BridgeProtocolOptions
- * 3. Optionally override doInit() and doDispose() for additional setup/teardown
+ * Why composition (not inheritance): inheritance previously forced the RPC
+ * contract onto a lifecycle base, leaking throwing RPC stubs into transports.
+ * Holding one RpcClient keeps exactly one encode/decode/correlation site and
+ * lets transports stay pure byte-movers.
  *
  * @see https://github.com/bbopen/tywrap/issues/149
  */
 import type { BridgeInfo } from '../types/index.js';
-import { BoundedContext, type ExecuteOptions } from './bounded-context.js';
+import { DisposableBase, type ExecuteOptions } from './bounded-context.js';
 import { SafeCodec, type CodecOptions } from './safe-codec.js';
 import { type Transport, type ProtocolMessage } from './transport.js';
 export interface GetBridgeInfoOptions {
@@ -27,9 +29,9 @@ export interface GetBridgeInfoOptions {
     refresh?: boolean;
 }
 /**
- * Configuration options for BridgeProtocol.
+ * Configuration options for RpcClient.
  */
-export interface BridgeProtocolOptions {
+export interface RpcClientOptions {
     /** The transport to use for communication */
     transport: Transport;
     /** Codec options for validation/serialization */
@@ -38,60 +40,51 @@ export interface BridgeProtocolOptions {
     defaultTimeoutMs?: number;
 }
 /**
- * BridgeProtocol combines BoundedContext + SafeCodec + Transport
- * into a unified abstraction for all JS<->Python communication.
- *
- * This class provides:
- * - Automatic transport lifecycle management
- * - Request encoding with guardrails (special float rejection, key validation)
- * - Response decoding with Arrow support
- * - Full RuntimeExecution interface implementation
- *
- * Subclasses should:
- * 1. Create their transport in their constructor
- * 2. Pass it to super() via BridgeProtocolOptions
- * 3. Optionally override doInit() and doDispose() for additional setup/teardown
+ * RpcClient holds a SafeCodec + Transport and composes DisposableBase for
+ * lifecycle/bounded-execution. It is the one correlated-RPC client; bridge
+ * facades HOLD an instance and delegate their PythonRuntime methods to it.
  *
  * @example
  * ```typescript
- * class NodeBridge extends BridgeProtocol {
+ * class NodeBridge extends DisposableBase implements PythonRuntime {
+ *   private readonly rpc: RpcClient;
  *   constructor(options: NodeBridgeOptions) {
+ *     super();
  *     const transport = new ProcessIO(options);
- *     super({ transport, defaultTimeoutMs: options.timeout });
+ *     this.rpc = new RpcClient({ transport, defaultTimeoutMs: options.timeout });
+ *     this.trackResource(this.rpc);
  *   }
+ *   // call/instantiate/callMethod/disposeInstance delegate to this.rpc.*
  * }
  * ```
  */
-export declare class BridgeProtocol extends BoundedContext {
+export declare class RpcClient extends DisposableBase {
     /** Codec instance for validation and serialization */
-    protected readonly codec: SafeCodec;
+    readonly codec: SafeCodec;
     /** Transport instance for message passing */
-    protected readonly transport: Transport;
+    readonly transport: Transport;
     /** Default timeout for operations in milliseconds */
-    protected readonly defaultTimeoutMs: number;
+    readonly defaultTimeoutMs: number;
     /** Counter for generating unique request IDs */
     private requestId;
     /** Cached bridge diagnostics info (populated by getBridgeInfo). */
     private bridgeInfoCache?;
     /**
-     * Create a new BridgeProtocol instance.
+     * Create a new RpcClient instance.
      *
      * @param options - Configuration options including transport and codec settings
      */
-    constructor(options: BridgeProtocolOptions);
+    constructor(options: RpcClientOptions);
     /**
-     * Initialize the protocol.
-     *
-     * Initializes the underlying transport. Subclasses can override this
-     * to add additional initialization logic, but must call super.doInit().
+     * Initialize the client by initializing the underlying transport.
+     * Driven by the holding facade's lifecycle (facade.init() -> rpc.init()).
      */
     protected doInit(): Promise<void>;
     /**
-     * Dispose the protocol.
+     * Dispose the client.
      *
-     * The transport is tracked as a resource and will be disposed automatically
-     * by BoundedContext. Subclasses can override this to add additional cleanup,
-     * but should not need to dispose the transport manually.
+     * The transport is tracked as a resource and is disposed automatically by
+     * DisposableBase. Here we only clear the cached bridge info.
      */
     protected doDispose(): Promise<void>;
     /**
@@ -111,7 +104,7 @@ export declare class BridgeProtocol extends BoundedContext {
      * @throws BridgeExecutionError if Python returns an error
      * @throws BridgeTimeoutError if the operation times out
      */
-    protected sendMessage<T>(message: Omit<ProtocolMessage, 'id' | 'protocol'>, options?: ExecuteOptions<T>): Promise<T>;
+    sendMessage<T>(message: Omit<ProtocolMessage, 'id' | 'protocol'>, options?: ExecuteOptions<T>): Promise<T>;
     /**
      * Async version that uses decodeResponseAsync for Arrow support.
      *
@@ -126,7 +119,27 @@ export declare class BridgeProtocol extends BoundedContext {
      * @throws BridgeExecutionError if Python returns an error
      * @throws BridgeTimeoutError if the operation times out
      */
-    protected sendMessageAsync<T>(message: Omit<ProtocolMessage, 'id' | 'protocol'>, options?: ExecuteOptions<T>): Promise<T>;
+    sendMessageAsync<T>(message: Omit<ProtocolMessage, 'id' | 'protocol'>, options?: ExecuteOptions<T>): Promise<T>;
+    /**
+     * Send a message over an EXPLICIT transport (not this.transport) with the
+     * same id-generation + codec encode/decode as the normal send path, but
+     * WITHOUT this.execute() and WITHOUT auto-init.
+     *
+     * This is the warmup path: NodeBridge runs warmup commands inside
+     * transport.init() (worker spawn -> onWorkerReady), which happens DURING
+     * rpc.init(). Routing those through this.execute() would auto-init this same
+     * client and re-await the in-flight init() that is itself waiting on warmup,
+     * deadlocking. So sendOn deliberately skips lifecycle: it only unifies the
+     * id counter + codec, never the state machine.
+     *
+     * @param transport - The specific worker transport to send on
+     * @param message - The protocol message (without id/protocol; stamped here)
+     * @param opts - Optional timeout / abort signal
+     */
+    sendOn<T>(transport: Transport, message: Omit<ProtocolMessage, 'id' | 'protocol'>, opts?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<T>;
     /**
      * Generate a unique request ID.
      *
@@ -181,4 +194,4 @@ export declare class BridgeProtocol extends BoundedContext {
      */
     getBridgeInfo(options?: GetBridgeInfoOptions): Promise<BridgeInfo>;
 }
-//# sourceMappingURL=bridge-protocol.d.ts.map
+//# sourceMappingURL=rpc-client.d.ts.map

package/dist/runtime/rpc-client.d.ts.map

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

package/dist/runtime/{bridge-protocol.js → rpc-client.js}

@@ -1,21 +1,23 @@
 /**
- * BridgeProtocol - Unified abstraction for JS<->Python communication.
+ * RpcClient - the single correlated-RPC client for JS<->Python communication.
  *
- * Combines BoundedContext + SafeCodec + Transport into a single base class
- * that handles all cross-boundary concerns:
- * - Lifecycle management (init/dispose state machine)
- * - Request/response encoding with validation
- * - Transport-agnostic message passing
- * - Bounded execution (timeout, retry, abort)
+ * It HOLDS a Transport and a codec (SafeCodec) and is, in turn, HELD by the
+ * bridge facades (NodeBridge/HttpBridge/PyodideBridge) via composition — it is
+ * NOT a base class bridges extend. It owns the one place where the wire frame
+ * is built and correlated: id generation, {id, protocol} stamping, codec
+ * encode/decode, and transport.send. It composes DisposableBase to obtain its
+ * lifecycle (init/dispose) and bounded execution (timeout/retry/abort), but it
+ * carries no PythonRuntime contract obligation — the facade implements
+ * PythonRuntime and delegates the four RPC methods to this client.
  *
- * Subclasses (NodeBridge, HttpBridge, PyodideBridge) only need to:
- * 1. Create their transport in their constructor
- * 2. Pass it to super() via BridgeProtocolOptions
- * 3. Optionally override doInit() and doDispose() for additional setup/teardown
+ * Why composition (not inheritance): inheritance previously forced the RPC
+ * contract onto a lifecycle base, leaking throwing RPC stubs into transports.
+ * Holding one RpcClient keeps exactly one encode/decode/correlation site and
+ * lets transports stay pure byte-movers.
  *
  * @see https://github.com/bbopen/tywrap/issues/149
  */
-import { BoundedContext } from './bounded-context.js';
+import { DisposableBase } from './bounded-context.js';
 import { BridgeProtocolError } from './errors.js';
 import { SafeCodec } from './safe-codec.js';
 import { TYWRAP_PROTOCOL_VERSION } from './protocol.js';
@@ -94,34 +96,28 @@ function validateBridgeInfoPayload(value) {
     };
 }
 // =============================================================================
-// BRIDGE PROTOCOL BASE CLASS
+// RPC CLIENT
 // =============================================================================
 /**
- * BridgeProtocol combines BoundedContext + SafeCodec + Transport
- * into a unified abstraction for all JS<->Python communication.
- *
- * This class provides:
- * - Automatic transport lifecycle management
- * - Request encoding with guardrails (special float rejection, key validation)
- * - Response decoding with Arrow support
- * - Full RuntimeExecution interface implementation
- *
- * Subclasses should:
- * 1. Create their transport in their constructor
- * 2. Pass it to super() via BridgeProtocolOptions
- * 3. Optionally override doInit() and doDispose() for additional setup/teardown
+ * RpcClient holds a SafeCodec + Transport and composes DisposableBase for
+ * lifecycle/bounded-execution. It is the one correlated-RPC client; bridge
+ * facades HOLD an instance and delegate their PythonRuntime methods to it.
  *
  * @example
  * ```typescript
- * class NodeBridge extends BridgeProtocol {
+ * class NodeBridge extends DisposableBase implements PythonRuntime {
+ *   private readonly rpc: RpcClient;
  *   constructor(options: NodeBridgeOptions) {
+ *     super();
  *     const transport = new ProcessIO(options);
- *     super({ transport, defaultTimeoutMs: options.timeout });
+ *     this.rpc = new RpcClient({ transport, defaultTimeoutMs: options.timeout });
+ *     this.trackResource(this.rpc);
  *   }
+ *   // call/instantiate/callMethod/disposeInstance delegate to this.rpc.*
  * }
  * ```
  */
-export class BridgeProtocol extends BoundedContext {
+export class RpcClient extends DisposableBase {
     /** Codec instance for validation and serialization */
     codec;
     /** Transport instance for message passing */
@@ -133,7 +129,7 @@ export class BridgeProtocol extends BoundedContext {
     /** Cached bridge diagnostics info (populated by getBridgeInfo). */
     bridgeInfoCache;
     /**
-     * Create a new BridgeProtocol instance.
+     * Create a new RpcClient instance.
      *
      * @param options - Configuration options including transport and codec settings
      */
@@ -149,25 +145,21 @@ export class BridgeProtocol extends BoundedContext {
     // LIFECYCLE
     // ===========================================================================
     /**
-     * Initialize the protocol.
-     *
-     * Initializes the underlying transport. Subclasses can override this
-     * to add additional initialization logic, but must call super.doInit().
+     * Initialize the client by initializing the underlying transport.
+     * Driven by the holding facade's lifecycle (facade.init() -> rpc.init()).
      */
     async doInit() {
         await this.transport.init();
     }
     /**
-     * Dispose the protocol.
+     * Dispose the client.
      *
-     * The transport is tracked as a resource and will be disposed automatically
-     * by BoundedContext. Subclasses can override this to add additional cleanup,
-     * but should not need to dispose the transport manually.
+     * The transport is tracked as a resource and is disposed automatically by
+     * DisposableBase. Here we only clear the cached bridge info.
      */
     async doDispose() {
         this.bridgeInfoCache = undefined;
-        // Transport is tracked and will be disposed by BoundedContext
-        // Subclasses can override to add additional cleanup
+        // Transport is tracked and will be disposed by DisposableBase.
     }
     // ===========================================================================
     // MESSAGE SENDING
@@ -233,6 +225,32 @@ export class BridgeProtocol extends BoundedContext {
             return this.codec.decodeResponseAsync(responseStr);
         }, options);
     }
+    /**
+     * Send a message over an EXPLICIT transport (not this.transport) with the
+     * same id-generation + codec encode/decode as the normal send path, but
+     * WITHOUT this.execute() and WITHOUT auto-init.
+     *
+     * This is the warmup path: NodeBridge runs warmup commands inside
+     * transport.init() (worker spawn -> onWorkerReady), which happens DURING
+     * rpc.init(). Routing those through this.execute() would auto-init this same
+     * client and re-await the in-flight init() that is itself waiting on warmup,
+     * deadlocking. So sendOn deliberately skips lifecycle: it only unifies the
+     * id counter + codec, never the state machine.
+     *
+     * @param transport - The specific worker transport to send on
+     * @param message - The protocol message (without id/protocol; stamped here)
+     * @param opts - Optional timeout / abort signal
+     */
+    async sendOn(transport, message, opts) {
+        const fullMessage = {
+            ...message,
+            id: this.generateId(),
+            protocol: PROTOCOL_ID,
+        };
+        const encoded = this.codec.encodeRequest(fullMessage);
+        const responseStr = await transport.send(encoded, opts?.timeoutMs ?? this.defaultTimeoutMs, opts?.signal);
+        return this.codec.decodeResponseAsync(responseStr);
+    }
     /**
      * Generate a unique request ID.
      *
@@ -243,7 +261,7 @@ export class BridgeProtocol extends BoundedContext {
         return ++this.requestId;
     }
     // ===========================================================================
-    // RUNTIME EXECUTION INTERFACE
+    // RPC METHODS (delegated to by the facade's PythonRuntime implementation)
     // ===========================================================================
     /**
      * Call a Python function.
@@ -341,4 +359,4 @@ export class BridgeProtocol extends BoundedContext {
         return info;
     }
 }
-//# sourceMappingURL=bridge-protocol.js.map
+//# sourceMappingURL=rpc-client.js.map

package/dist/runtime/rpc-client.js.map

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

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

@@ -6,7 +6,7 @@
  *
  * @see https://github.com/bbopen/tywrap/issues/149
  */
-import { BoundedContext } from './bounded-context.js';
+import { DisposableBase } from './bounded-context.js';
 import type { Transport } from './transport.js';
 /**
  * Configuration options for the WorkerPool.
@@ -71,7 +71,7 @@ export interface PooledWorker {
  * await pool.dispose();
  * ```
  */
-export declare class WorkerPool extends BoundedContext {
+export declare class WorkerPool extends DisposableBase {
     private readonly options;
     private readonly workers;
     private readonly waitQueue;
@@ -145,7 +145,6 @@ export declare class WorkerPool extends BoundedContext {
      * - Process exited unexpectedly
      * - Pipe errors (EPIPE)
      * - Connection reset errors (ECONNRESET)
-     * - Request timeouts (the worker may still be busy with an uncancellable request)
      */
     private isFatalWorkerError;
     /**
@@ -171,11 +170,17 @@ export declare class WorkerPool extends BoundedContext {
      * Find an available worker with capacity for another request.
      */
     private findAvailableWorker;
+    private getMinimumWorkerDeficit;
+    private isShuttingDown;
+    private fillToMinimumWorkers;
+    private spawnWorkers;
     /**
      * 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;
+    private spawnWorkerToPool;
+    private publishAvailableWorker;
     /**
      * Create a new worker and add it to the pool.
      *
@@ -187,22 +192,5 @@ export declare class WorkerPool extends BoundedContext {
      * 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

@@ -1 +1 @@
-{"version":3,"file":"worker-pool.d.ts","sourceRoot":"","sources":["../../src/runtime/worker-pool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"worker-pool.d.ts","sourceRoot":"","sources":["../../src/runtime/worker-pool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAMhD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,eAAe,EAAE,MAAM,SAAS,CAAC;IAEjC,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IAEnB,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,yDAAyD;IACzD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAEhC;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,SAAS,EAAE,SAAS,CAAC;IAErB,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;CACvB;AAoBD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,UAAW,SAAQ,cAAc;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAMtB;IACF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,0EAA0E;IAC1E,OAAO,CAAC,gBAAgB,CAAK;IAE7B;;;;OAIG;gBACS,OAAO,EAAE,iBAAiB;IA+BtC;;;;;OAKG;cACa,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAKvC;;;;;;OAMG;cACa,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC1C;;;;;;;;;;;OAWG;IACG,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC;IAqCtC;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAWnC;;;;;;;;;;;;;;;OAeG;IACG,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAyBzE;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAkBpB;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAMD;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,uBAAuB;IAI/B,OAAO,CAAC,cAAc;YAIR,oBAAoB;YAIpB,YAAY;IAY1B;;;OAGG;IACH,OAAO,CAAC,yBAAyB;YAmBnB,iBAAiB;IAc/B,OAAO,CAAC,sBAAsB;IAe9B;;;;;OAKG;YACW,YAAY;IAoC1B;;OAEG;IACH,OAAO,CAAC,aAAa;CAuBtB"}

package/dist/runtime/worker-pool.js

@@ -6,7 +6,7 @@
  *
  * @see https://github.com/bbopen/tywrap/issues/149
  */
-import { BoundedContext } from './bounded-context.js';
+import { DisposableBase } from './bounded-context.js';
 import { BridgeTimeoutError, BridgeExecutionError, BridgeProtocolError } from './errors.js';
 // =============================================================================
 // WORKER POOL
@@ -39,7 +39,7 @@ import { BridgeTimeoutError, BridgeExecutionError, BridgeProtocolError } from '.
  * await pool.dispose();
  * ```
  */
-export class WorkerPool extends BoundedContext {
+export class WorkerPool extends DisposableBase {
     options;
     workers = [];
     waitQueue = [];
@@ -84,13 +84,7 @@ export class WorkerPool extends BoundedContext {
      */
     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);
-        }
+        await this.fillToMinimumWorkers();
     }
     /**
      * Dispose the pool and all workers.
@@ -142,7 +136,7 @@ export class WorkerPool extends BoundedContext {
      */
     async acquire() {
         // Check for disposed state
-        if (this.isDisposed) {
+        if (this.isDisposed || this.state === 'disposing') {
             throw new BridgeExecutionError('Pool has been disposed');
         }
         // Find an available worker (one with capacity)
@@ -159,7 +153,12 @@ export class WorkerPool extends BoundedContext {
             this.pendingCreations++;
             try {
                 const newWorker = await this.createWorker();
+                if (this.isShuttingDown()) {
+                    this.removeWorker(newWorker);
+                    throw new BridgeExecutionError('Pool has been disposed');
+                }
                 newWorker.inFlightCount++;
+                this.publishAvailableWorker(newWorker);
                 return newWorker;
             }
             finally {
@@ -184,15 +183,7 @@ export class WorkerPool extends BoundedContext {
         }
         // 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);
-            }
-        }
+        this.publishAvailableWorker(worker);
     }
     /**
      * Execute a function with an acquired worker, automatically releasing afterward.
@@ -242,14 +233,8 @@ export class WorkerPool extends BoundedContext {
      * - 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') ||
@@ -273,7 +258,9 @@ export class WorkerPool extends BoundedContext {
             worker.transport.dispose().catch(() => {
                 // Ignore disposal errors for dead workers
             });
-            this.scheduleReplacementWorker();
+            if (this.state === 'ready') {
+                this.scheduleReplacementWorker();
+            }
         }
     }
     // ===========================================================================
@@ -306,6 +293,27 @@ export class WorkerPool extends BoundedContext {
     findAvailableWorker() {
         return this.workers.find(w => w.inFlightCount < this.options.maxConcurrentPerWorker);
     }
+    getMinimumWorkerDeficit() {
+        return Math.max(0, this.options.minWorkers - (this.workers.length + this.pendingCreations));
+    }
+    isShuttingDown() {
+        return this.isDisposed || this.state === 'disposing';
+    }
+    async fillToMinimumWorkers() {
+        await this.spawnWorkers(this.getMinimumWorkerDeficit());
+    }
+    async spawnWorkers(count) {
+        if (count === 0) {
+            return;
+        }
+        this.pendingCreations += count;
+        try {
+            await Promise.all(Array.from({ length: count }, () => this.spawnWorkerToPool()));
+        }
+        finally {
+            this.pendingCreations = Math.max(0, this.pendingCreations - count);
+        }
+    }
     /**
      * 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.
@@ -319,11 +327,7 @@ export class WorkerPool extends BoundedContext {
         }
         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);
-        })
+        this.spawnWorkerToPool(replacementReady)
             .catch(() => {
             // Ignore background replacement failures. A later acquire() can retry.
         })
@@ -331,6 +335,29 @@ export class WorkerPool extends BoundedContext {
             this.pendingCreations = Math.max(0, this.pendingCreations - 1);
         });
     }
+    async spawnWorkerToPool(onWorkerReady = this.options.onWorkerReady) {
+        if (this.isShuttingDown()) {
+            return;
+        }
+        const worker = await this.createWorker(onWorkerReady);
+        if (this.isShuttingDown()) {
+            this.removeWorker(worker);
+            return;
+        }
+        this.publishAvailableWorker(worker);
+    }
+    publishAvailableWorker(worker) {
+        while (this.waitQueue.length > 0 &&
+            worker.inFlightCount < this.options.maxConcurrentPerWorker) {
+            const waiter = this.waitQueue.shift();
+            if (!waiter) {
+                return;
+            }
+            clearTimeout(waiter.timer);
+            worker.inFlightCount++;
+            waiter.resolve(worker);
+        }
+    }
     /**
      * Create a new worker and add it to the pool.
      *
@@ -387,33 +414,5 @@ export class WorkerPool extends BoundedContext {
             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