tywrap 0.3.0 → 0.5.0

package/dist/runtime/pyodide-io.js

@@ -13,8 +13,9 @@
  *
  * @see https://github.com/bbopen/tywrap/issues/149
  */
-import { BoundedContext } from './bounded-context.js';
-import { BridgeExecutionError, BridgeProtocolError } from './errors.js';
+import { DisposableBase } from './bounded-context.js';
+import { BridgeProtocolError } from './errors.js';
+import { PYODIDE_BRIDGE_CORE_SOURCE } from './pyodide-bootstrap-core.generated.js';
 import { PROTOCOL_ID, } from './transport.js';
 // =============================================================================
 // CONSTANTS
@@ -24,125 +25,99 @@ const DEFAULT_INDEX_URL = 'https://cdn.jsdelivr.net/pyodide/v0.28.0/full/';
 /**
  * Bootstrap Python code that sets up the dispatch function.
  *
- * This code is injected into Pyodide during initialization and provides
- * a single entry point for all protocol messages. The dispatch function
- * parses JSON messages, routes to appropriate handlers, and returns
- * JSON responses.
+ * This is injected into Pyodide once at init. It does two things:
+ *
+ *  1. Loads the SHARED bridge core (the exact same code runtime/python_bridge.py
+ *     imports) by exec'ing the build-time-embedded source into a fresh module and
+ *     registering it in sys.modules as 'tywrap_bridge_core'. Pyodide has no
+ *     filesystem to import from, so the source is shipped as a string constant
+ *     (PYODIDE_BRIDGE_CORE_SOURCE) kept in sync with the .py by a drift-guard test.
+ *
+ *  2. Defines the single dispatch entry point __tywrap_dispatch(message_json) the
+ *     JS transport calls. It routes through core.dispatch_request and encodes the
+ *     response through core.encode_value, mirroring the reference server's error
+ *     ladder so the on-the-wire envelopes are byte-identical.
+ *
+ * CONTRACT (Pyodide side): markers are forced to JSON (force_json_markers=True)
+ * because pyarrow is not available in WASM, NaN/Infinity are rejected
+ * (allow_nan=False), the bridge identifies itself as 'pyodide' with pid=None, and
+ * arrowAvailable is reported False. These choices match the JS-side decoder and
+ * the relaxed BridgeInfo validator (bridge in {python-subprocess, pyodide, http},
+ * pid number|null).
+ *
+ * The PYODIDE_CORE_MODULE_NAME must match the import name used inside the core
+ * module's own docstring/contract and the conformance harness.
  */
-const BOOTSTRAP_PYTHON = `
-import json
-import importlib
-
-__tywrap_instances = {}
-__tywrap_protocol = 'tywrap/1'
+const PYODIDE_CORE_MODULE_NAME = 'tywrap_bridge_core';
+// Exported so the cross-backend conformance suite can run the EXACT bootstrap
+// source (this string, with the generated core constant inlined and the real
+// __tywrap_dispatch error ladder) under CPython — proving the glue, not just the
+// shared core module. It is not part of the public package surface.
+export const BOOTSTRAP_PYTHON = `
+import sys as __tywrap_sys
+import json as __tywrap_json
+import types as __tywrap_types
 
-def __tywrap_require_str(params, key):
-    value = params.get(key)
-    if not isinstance(value, str) or not value:
-        raise ValueError(f'Missing {key}')
-    return value
+# Load the shared bridge core from the embedded source into a real module so the
+# Pyodide server runs the IDENTICAL protocol/serialization code as the reference
+# subprocess server. Registering in sys.modules lets the core's own internal
+# 'import sys' (used lazily in dispatch_request for meta) resolve normally.
+__tywrap_core_source = ${JSON.stringify(PYODIDE_BRIDGE_CORE_SOURCE)}
+__tywrap_core = __tywrap_types.ModuleType(${JSON.stringify(PYODIDE_CORE_MODULE_NAME)})
+__tywrap_sys.modules[${JSON.stringify(PYODIDE_CORE_MODULE_NAME)}] = __tywrap_core
+exec(compile(__tywrap_core_source, '<tywrap_bridge_core>', 'exec'), __tywrap_core.__dict__)
 
-def __tywrap_coerce_list(value, key):
-    if value is None:
-        return []
-    if not isinstance(value, list):
-        raise ValueError(f'Invalid {key}')
-    return value
+__tywrap_instances = {}
+__tywrap_protocol = __tywrap_core.PROTOCOL
 
-def __tywrap_coerce_dict(value, key):
-    if value is None:
-        return {}
-    if not isinstance(value, dict):
-        raise ValueError(f'Invalid {key}')
-    return value
 
 def __tywrap_dispatch(message_json):
     """
-    Dispatch a protocol message and return a JSON response.
-
-    Args:
-        message_json: JSON-encoded ProtocolMessage string
+    Dispatch a protocol message and return a JSON response string.
 
-    Returns:
-        JSON-encoded ProtocolResponse string
+    Mirrors runtime/python_bridge.py main()'s error ladder: ProtocolError ->
+    error envelope WITHOUT traceback; any other handler error -> error envelope
+    WITH traceback. The final encode goes through core.encode_value(allow_nan=False)
+    so NaN/Infinity is rejected with the same wording the subprocess server uses.
     """
-    msg = None
-    msg_id = -1
+    core = __tywrap_core
+    mid = None
     try:
-        msg = json.loads(message_json)
-        if not isinstance(msg, dict):
-            raise ValueError('Invalid request payload')
-
-        msg_id = msg.get('id')
-        if not isinstance(msg_id, int):
-            raise ValueError(f'Invalid request id: {msg_id}')
-
-        protocol = msg.get('protocol')
-        if protocol != __tywrap_protocol:
-            raise ValueError(f'Invalid protocol: {protocol}')
-
-        method = msg.get('method')
-        if not isinstance(method, str):
-            raise ValueError('Missing method')
-
-        params = __tywrap_coerce_dict(msg.get('params'), 'params')
-
-        if method == 'call':
-            module_name = __tywrap_require_str(params, 'module')
-            function_name = __tywrap_require_str(params, 'functionName')
-            args = __tywrap_coerce_list(params.get('args'), 'args')
-            kwargs = __tywrap_coerce_dict(params.get('kwargs'), 'kwargs')
-            mod = importlib.import_module(module_name)
-            fn = getattr(mod, function_name)
-            result = fn(*args, **kwargs)
-
-        elif method == 'instantiate':
-            module_name = __tywrap_require_str(params, 'module')
-            class_name = __tywrap_require_str(params, 'className')
-            args = __tywrap_coerce_list(params.get('args'), 'args')
-            kwargs = __tywrap_coerce_dict(params.get('kwargs'), 'kwargs')
-            mod = importlib.import_module(module_name)
-            cls = getattr(mod, class_name)
-            obj = cls(*args, **kwargs)
-            handle = str(id(obj))
-            __tywrap_instances[handle] = obj
-            result = handle
-
-        elif method == 'call_method':
-            handle = __tywrap_require_str(params, 'handle')
-            method_name = __tywrap_require_str(params, 'methodName')
-            args = __tywrap_coerce_list(params.get('args'), 'args')
-            kwargs = __tywrap_coerce_dict(params.get('kwargs'), 'kwargs')
-            if handle not in __tywrap_instances:
-                raise ValueError(f'Unknown instance handle: {handle}')
-            obj = __tywrap_instances[handle]
-            bound_method = getattr(obj, method_name)
-            result = bound_method(*args, **kwargs)
-
-        elif method == 'dispose_instance':
-            handle = __tywrap_require_str(params, 'handle')
-            result = __tywrap_instances.pop(handle, None) is not None
-
-        else:
-            raise ValueError(f'Unknown method: {method}')
-
-        return json.dumps({
-            'id': msg_id,
-            'protocol': __tywrap_protocol,
-            'result': result
-        })
+        msg = __tywrap_json.loads(message_json)
+        if isinstance(msg, dict) and isinstance(msg.get('id'), int):
+            mid = msg.get('id')
+        try:
+            out = core.dispatch_request(
+                msg,
+                __tywrap_instances,
+                bridge='pyodide',
+                pid=None,
+                force_json_markers=True,
+                allow_nan=False,
+                arrow_available_override=False,
+            )
+        except core.ProtocolError as e:
+            out = core.build_error_payload(mid, e, include_traceback=False)
+        except Exception as e:
+            out = core.build_error_payload(mid, e, include_traceback=True)
+    except Exception as e:
+        # Malformed JSON / unexpected pre-dispatch failure: well-formed error,
+        # no traceback (matches the reference's outer handler).
+        out = core.build_error_payload(mid, e, include_traceback=False)
 
+    try:
+        return core.encode_value(out, allow_nan=False)
+    except core.CodecError as e:
+        # The subprocess server's encode_response() converts CodecError -> ValueError
+        # so the NaN/Infinity rejection surfaces with type 'ValueError'. Match that
+        # so the error envelope is byte-identical across backends.
+        err_out = core.build_error_payload(mid, ValueError(str(e)), include_traceback=False)
+        return __tywrap_json.dumps(err_out)
     except Exception as e:
-        import traceback
-        return json.dumps({
-            'id': msg_id,
-            'protocol': __tywrap_protocol,
-            'error': {
-                'type': type(e).__name__,
-                'message': str(e),
-                'traceback': traceback.format_exc()
-            }
-        })
+        # Any other encoding failure: well-formed error envelope, no traceback,
+        # exactly as the subprocess server's fallback does.
+        err_out = core.build_error_payload(mid, e, include_traceback=False)
+        return __tywrap_json.dumps(err_out)
 `;
 // =============================================================================
 // PYODIDE IO TRANSPORT
@@ -150,8 +125,10 @@ def __tywrap_dispatch(message_json):
 /**
  * Transport implementation for in-memory Pyodide communication.
  *
- * This transport extends BoundedContext for lifecycle management and
- * implements the Transport interface for message-based communication.
+ * This transport extends DisposableBase for lifecycle management and
+ * implements the Transport interface for message-based communication. It is a
+ * pure transport: it moves bytes via send() and carries no RPC methods (those
+ * live on PythonRuntime, implemented by PyodideBridge through an RpcClient).
  *
  * @example
  * ```typescript
@@ -171,10 +148,9 @@ def __tywrap_dispatch(message_json):
  * await transport.dispose();
  * ```
  */
-export class PyodideIO extends BoundedContext {
+export class PyodideIO extends DisposableBase {
     indexURL;
     packages;
-    requestId = 0;
     py;
     /**
      * Create a new PyodideIO transport.
@@ -187,7 +163,7 @@ export class PyodideIO extends BoundedContext {
         this.packages = Object.freeze([...(options.packages ?? [])]);
     }
     // ===========================================================================
-    // LIFECYCLE (BoundedContext implementation)
+    // LIFECYCLE
     // ===========================================================================
     /**
      * Initialize the Pyodide runtime.
@@ -303,86 +279,6 @@ export class PyodideIO extends BoundedContext {
         }, { timeoutMs, signal });
     }
     // ===========================================================================
-    // RUNTIME EXECUTION (BoundedContext abstract methods)
-    // ===========================================================================
-    /**
-     * Call a Python function.
-     *
-     * Convenience method that constructs a 'call' message and sends it.
-     */
-    async call(module, functionName, args, kwargs) {
-        const message = {
-            id: this.generateId(),
-            protocol: PROTOCOL_ID,
-            method: 'call',
-            params: {
-                module,
-                functionName,
-                args: args ?? [],
-                kwargs,
-            },
-        };
-        const responseJson = await this.send(JSON.stringify(message), 30000);
-        return this.parseResponse(responseJson);
-    }
-    /**
-     * Instantiate a Python class.
-     *
-     * Convenience method that constructs an 'instantiate' message and sends it.
-     */
-    async instantiate(module, className, args, kwargs) {
-        const message = {
-            id: this.generateId(),
-            protocol: PROTOCOL_ID,
-            method: 'instantiate',
-            params: {
-                module,
-                className,
-                args: args ?? [],
-                kwargs,
-            },
-        };
-        const responseJson = await this.send(JSON.stringify(message), 30000);
-        return this.parseResponse(responseJson);
-    }
-    /**
-     * Call a method on a Python instance.
-     *
-     * Convenience method that constructs a 'call_method' message and sends it.
-     */
-    async callMethod(handle, methodName, args, kwargs) {
-        const message = {
-            id: this.generateId(),
-            protocol: PROTOCOL_ID,
-            method: 'call_method',
-            params: {
-                handle,
-                methodName,
-                args: args ?? [],
-                kwargs,
-            },
-        };
-        const responseJson = await this.send(JSON.stringify(message), 30000);
-        return this.parseResponse(responseJson);
-    }
-    /**
-     * Dispose a Python instance.
-     *
-     * Convenience method that constructs a 'dispose_instance' message and sends it.
-     */
-    async disposeInstance(handle) {
-        const message = {
-            id: this.generateId(),
-            protocol: PROTOCOL_ID,
-            method: 'dispose_instance',
-            params: {
-                handle,
-            },
-        };
-        const responseJson = await this.send(JSON.stringify(message), 30000);
-        this.parseResponse(responseJson);
-    }
-    // ===========================================================================
     // PRIVATE HELPERS
     // ===========================================================================
     /**
@@ -419,26 +315,6 @@ export class PyodideIO extends BoundedContext {
         }
         await this.py.runPythonAsync(BOOTSTRAP_PYTHON);
     }
-    /**
-     * Parse a JSON response and extract the result or throw an error.
-     */
-    parseResponse(responseJson) {
-        const response = JSON.parse(responseJson);
-        if (response.error) {
-            const err = new BridgeExecutionError(`${response.error.type}: ${response.error.message}`, {
-                code: response.error.type,
-            });
-            err.traceback = response.error.traceback;
-            throw err;
-        }
-        return response.result;
-    }
-    /**
-     * Generate a unique message ID.
-     */
-    generateId() {
-        return ++this.requestId;
-    }
     /**
      * Safely destroy a Pyodide proxy object.
      *

package/dist/runtime/pyodide-io.js.map

@@ -1 +1 @@
-{"version":3,"file":"pyodide-io.js","sourceRoot":"","sources":["../../src/runtime/pyodide-io.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EACL,WAAW,GAIZ,MAAM,gBAAgB,CAAC;AAkCxB,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,8BAA8B;AAC9B,MAAM,iBAAiB,GAAG,gDAAgD,CAAC;AAE3E;;;;;;;GAOG;AACH,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkHxB,CAAC;AAEF,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,SAAU,SAAQ,cAAc;IAC1B,QAAQ,CAAS;IACjB,QAAQ,CAAoB;IACrC,SAAS,GAAG,CAAC,CAAC;IACd,EAAE,CAAmB;IAE7B;;;;OAIG;IACH,YAAY,UAA4B,EAAE;QACxC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,iBAAiB,CAAC;QACtD,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,8EAA8E;IAC9E,4CAA4C;IAC5C,8EAA8E;IAE9E;;;;;;;;;;OAUG;IACO,KAAK,CAAC,MAAM;QACpB,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACtD,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,MAAM,IAAI,mBAAmB,CAC3B,gDAAgD;gBAC9C,gEAAgE,CACnE,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,EAAE,GAAG,MAAM,aAAa,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAE3D,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;IACnC,CAAC;IAED;;;;;OAKG;IACO,KAAK,CAAC,SAAS;QACvB,IAAI,CAAC,EAAE,GAAG,SAAS,CAAC;IACtB,CAAC;IAED,8EAA8E;IAC9E,sBAAsB;IACtB,8EAA8E;IAE9E;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,KAAK,CAAC,IAAI,CAAC,OAAe,EAAE,SAAiB,EAAE,MAAoB;QACjE,OAAO,IAAI,CAAC,OAAO,CACjB,KAAK,IAAI,EAAE;YACT,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACb,MAAM,IAAI,mBAAmB,CAAC,yBAAyB,CAAC,CAAC;YAC3D,CAAC;YAED,qCAAqC;YACrC,IAAI,MAAuB,CAAC;YAC5B,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAoB,CAAC;YAClD,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,IAAI,mBAAmB,CAAC,yBAA0B,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;YACjF,CAAC;YAED,2BAA2B;YAC3B,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;gBAClE,MAAM,IAAI,mBAAmB,CAAC,6CAA6C,CAAC,CAAC;YAC/E,CAAC;YACD,IAAI,MAAM,CAAC,QAAQ,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACzE,MAAM,IAAI,mBAAmB,CAAC,6CAA6C,CAAC,CAAC;YAC/E,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxF,MAAM,IAAI,mBAAmB,CAAC,6CAA6C,CAAC,CAAC;YAC/E,CAAC;YAED,4BAA4B;YAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;YAC5D,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,IAAI,mBAAmB,CAAC,2CAA2C,CAAC,CAAC;YAC7E,CAAC;YAED,IAAI,CAAC;gBACH,6BAA6B;gBAC7B,MAAM,MAAM,GAAG,UAA6C,CAAC;gBAC7D,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;gBAErC,kCAAkC;gBAClC,IAAI,CAAC;oBACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAqB,CAAC;oBAC9D,IAAI,OAAO,QAAQ,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;wBACtE,MAAM,IAAI,mBAAmB,CAAC,kDAAkD,CAAC,CAAC;oBACpF,CAAC;oBACD,IAAI,QAAQ,CAAC,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;wBACzE,MAAM,IAAI,mBAAmB,CAC3B,uCAAuC,WAAW,WAAW,QAAQ,CAAC,QAAQ,GAAG,CAClF,CAAC;oBACJ,CAAC;oBACD,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;wBACnB,6DAA6D;wBAC7D,OAAO,YAAY,CAAC;oBACtB,CAAC;oBACD,OAAO,YAAY,CAAC;gBACtB,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,IAAI,mBAAmB,CAAC,sCAAsC,YAAY,EAAE,CAAC,CAAC;gBACtF,CAAC;YACH,CAAC;oBAAS,CAAC;gBACT,qBAAqB;gBACrB,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;YAClC,CAAC;QACH,CAAC,EACD,EAAE,SAAS,EAAE,MAAM,EAAE,CACtB,CAAC;IACJ,CAAC;IAED,8EAA8E;IAC9E,sDAAsD;IACtD,8EAA8E;IAE9E;;;;OAIG;IACH,KAAK,CAAC,IAAI,CACR,MAAc,EACd,YAAoB,EACpB,IAAe,EACf,MAAgC;QAEhC,MAAM,OAAO,GAAoB;YAC/B,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE;YACrB,QAAQ,EAAE,WAAW;YACrB,MAAM,EAAE,MAAM;YACd,MAAM,EAAE;gBACN,MAAM;gBACN,YAAY;gBACZ,IAAI,EAAE,IAAI,IAAI,EAAE;gBAChB,MAAM;aACP;SACF,CAAC;QAEF,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC,aAAa,CAAI,YAAY,CAAC,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW,CACf,MAAc,EACd,SAAiB,EACjB,IAAe,EACf,MAAgC;QAEhC,MAAM,OAAO,GAAoB;YAC/B,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE;YACrB,QAAQ,EAAE,WAAW;YACrB,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE;gBACN,MAAM;gBACN,SAAS;gBACT,IAAI,EAAE,IAAI,IAAI,EAAE;gBAChB,MAAM;aACP;SACF,CAAC;QAEF,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC,aAAa,CAAI,YAAY,CAAC,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CACd,MAAc,EACd,UAAkB,EAClB,IAAe,EACf,MAAgC;QAEhC,MAAM,OAAO,GAAoB;YAC/B,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE;YACrB,QAAQ,EAAE,WAAW;YACrB,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE;gBACN,MAAM;gBACN,UAAU;gBACV,IAAI,EAAE,IAAI,IAAI,EAAE;gBAChB,MAAM;aACP;SACF,CAAC;QAEF,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC,aAAa,CAAI,YAAY,CAAC,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,eAAe,CAAC,MAAc;QAClC,MAAM,OAAO,GAAoB;YAC/B,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE;YACrB,QAAQ,EAAE,WAAW;YACrB,MAAM,EAAE,kBAAkB;YAC1B,MAAM,EAAE;gBACN,MAAM;aACP;SACF,CAAC;QAEF,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;QACrE,IAAI,CAAC,aAAa,CAAO,YAAY,CAAC,CAAC;IACzC,CAAC;IAED,8EAA8E;IAC9E,kBAAkB;IAClB,8EAA8E;IAE9E;;;;;OAKG;IACK,KAAK,CAAC,kBAAkB;QAC9B,oDAAoD;QACpD,MAAM,CAAC,GAAG,UAAsD,CAAC;QACjE,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;YACxC,OAAO,CAAC,CAAC,WAAW,CAAC;QACvB,CAAC;QAED,qBAAqB;QACrB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAA6C,CAAC;YAClF,IAAI,OAAO,GAAG,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;gBAC1C,OAAO,GAAG,CAAC,WAAW,CAAC;YACzB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;YAC/B,wCAAwC;QAC1C,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,mBAAmB;QAC/B,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QACD,MAAM,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACK,aAAa,CAAI,YAAoB;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAqB,CAAC;QAE9D,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,GAAG,GAAG,IAAI,oBAAoB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE;gBACxF,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI;aAC1B,CAAC,CAAC;YACH,GAAG,CAAC,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC;YACzC,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,OAAO,QAAQ,CAAC,MAAW,CAAC;IAC9B,CAAC;IAED;;OAEG;IACK,UAAU;QAChB,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACK,cAAc,CAAC,KAAc;QACnC,IAAI,KAAK,IAAI,OAAQ,KAAkC,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YAC/E,IAAI,CAAC;gBACF,KAAiC,CAAC,OAAO,EAAE,CAAC;YAC/C,CAAC;YAAC,MAAM,CAAC;gBACP,0BAA0B;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"pyodide-io.js","sourceRoot":"","sources":["../../src/runtime/pyodide-io.ts"],"names":[],"mappings":"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"}

package/dist/runtime/pyodide.d.ts

@@ -1,12 +1,15 @@
 /**
- * Pyodide runtime bridge for BridgeProtocol.
+ * Pyodide runtime bridge.
  *
- * PyodideBridge extends BridgeProtocol and uses PyodideIO transport for
- * in-memory Python execution in browser environments via WebAssembly.
+ * PyodideBridge is a thin facade: it extends DisposableBase (lifecycle) and
+ * implements PythonRuntime by HOLDING an RpcClient over a PyodideIO transport
+ * for in-memory Python execution in browser environments via WebAssembly.
  *
  * @see https://github.com/bbopen/tywrap/issues/149
  */
-import { BridgeProtocol } from './bridge-protocol.js';
+import type { PythonRuntime, BridgeInfo } from '../types/index.js';
+import { DisposableBase } from './bounded-context.js';
+import { type GetBridgeInfoOptions } from './rpc-client.js';
 import type { CodecOptions } from './safe-codec.js';
 /**
  * Configuration options for PyodideBridge.
@@ -48,12 +51,29 @@ export interface PyodideBridgeOptions {
  * await bridge.dispose();
  * ```
  */
-export declare class PyodideBridge extends BridgeProtocol {
+export declare class PyodideBridge extends DisposableBase implements PythonRuntime {
+    private readonly rpc;
     /**
      * Create a new PyodideBridge instance.
      *
      * @param options - Configuration options for the bridge
      */
     constructor(options?: PyodideBridgeOptions);
+    protected doInit(): Promise<void>;
+    /**
+     * No facade-specific teardown: the RpcClient (and its transport) is tracked
+     * as a resource and disposed automatically by DisposableBase.
+     */
+    protected doDispose(): Promise<void>;
+    call<T = unknown>(module: string, functionName: string, args: unknown[], kwargs?: Record<string, unknown>): Promise<T>;
+    instantiate<T = unknown>(module: string, className: string, args: unknown[], kwargs?: Record<string, unknown>): Promise<T>;
+    callMethod<T = unknown>(handle: string, methodName: string, args: unknown[], kwargs?: Record<string, unknown>): Promise<T>;
+    disposeInstance(handle: string): Promise<void>;
+    getBridgeInfo(options?: GetBridgeInfoOptions): Promise<BridgeInfo>;
+    /**
+     * Ensure the facade is initialized before delegating an RPC, replicating the
+     * auto-init that the bounded execute path provided pre-composition.
+     */
+    private ensureReady;
 }
 //# sourceMappingURL=pyodide.d.ts.map

package/dist/runtime/pyodide.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pyodide.d.ts","sourceRoot":"","sources":["../../src/runtime/pyodide.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAA8B,MAAM,sBAAsB,CAAC;AAElF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAMpD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,iDAAiD;IACjD,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAC/C;;;;OAIG;gBACS,OAAO,GAAE,oBAAyB;CAgB/C"}
+{"version":3,"file":"pyodide.d.ts","sourceRoot":"","sources":["../../src/runtime/pyodide.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAa,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAMpD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,iDAAiD;IACjD,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,aAAc,SAAQ,cAAe,YAAW,aAAa;IACxE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAEhC;;;;OAIG;gBACS,OAAO,GAAE,oBAAyB;cAqB9B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAKvC;;;OAGG;cACa,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAQpC,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,OAAO,EAAE,EACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IAKP,WAAW,CAAC,CAAC,GAAG,OAAO,EAC3B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,OAAO,EAAE,EACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IAKP,UAAU,CAAC,CAAC,GAAG,OAAO,EAC1B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,OAAO,EAAE,EACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IAKP,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9C,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;IAKxE;;;OAGG;YACW,WAAW;CAK1B"}

package/dist/runtime/pyodide.js

@@ -1,12 +1,14 @@
 /**
- * Pyodide runtime bridge for BridgeProtocol.
+ * Pyodide runtime bridge.
  *
- * PyodideBridge extends BridgeProtocol and uses PyodideIO transport for
- * in-memory Python execution in browser environments via WebAssembly.
+ * PyodideBridge is a thin facade: it extends DisposableBase (lifecycle) and
+ * implements PythonRuntime by HOLDING an RpcClient over a PyodideIO transport
+ * for in-memory Python execution in browser environments via WebAssembly.
  *
  * @see https://github.com/bbopen/tywrap/issues/149
  */
-import { BridgeProtocol } from './bridge-protocol.js';
+import { DisposableBase } from './bounded-context.js';
+import { RpcClient } from './rpc-client.js';
 import { PyodideIO } from './pyodide-io.js';
 // =============================================================================
 // PYODIDE BRIDGE
@@ -38,25 +40,72 @@ import { PyodideIO } from './pyodide-io.js';
  * await bridge.dispose();
  * ```
  */
-export class PyodideBridge extends BridgeProtocol {
+export class PyodideBridge extends DisposableBase {
+    rpc;
     /**
      * Create a new PyodideBridge instance.
      *
      * @param options - Configuration options for the bridge
      */
     constructor(options = {}) {
-        // Create Pyodide transport
+        super();
         const transport = new PyodideIO({
             indexURL: options.indexURL,
             packages: options.packages,
         });
-        // Initialize BridgeProtocol with transport and codec options
-        const protocolOptions = {
+        this.rpc = new RpcClient({
             transport,
             codec: options.codec,
             defaultTimeoutMs: options.timeoutMs,
-        };
-        super(protocolOptions);
+        });
+        // One disposal chain: facade -> rpc -> transport.
+        this.trackResource(this.rpc);
+    }
+    // ===========================================================================
+    // LIFECYCLE
+    // ===========================================================================
+    async doInit() {
+        // No facade-specific pre-init; the held RpcClient drives transport.init().
+        await this.rpc.init();
+    }
+    /**
+     * No facade-specific teardown: the RpcClient (and its transport) is tracked
+     * as a resource and disposed automatically by DisposableBase.
+     */
+    async doDispose() {
+        // Intentionally empty; tracked resources handle disposal.
+    }
+    // ===========================================================================
+    // RPC METHODS (delegate to the held RpcClient; never PyodideIO directly)
+    // ===========================================================================
+    async call(module, functionName, args, kwargs) {
+        await this.ensureReady();
+        return this.rpc.call(module, functionName, args, kwargs);
+    }
+    async instantiate(module, className, args, kwargs) {
+        await this.ensureReady();
+        return this.rpc.instantiate(module, className, args, kwargs);
+    }
+    async callMethod(handle, methodName, args, kwargs) {
+        await this.ensureReady();
+        return this.rpc.callMethod(handle, methodName, args, kwargs);
+    }
+    async disposeInstance(handle) {
+        await this.ensureReady();
+        return this.rpc.disposeInstance(handle);
+    }
+    async getBridgeInfo(options) {
+        await this.ensureReady();
+        return this.rpc.getBridgeInfo(options);
+    }
+    /**
+     * Ensure the facade is initialized before delegating an RPC, replicating the
+     * auto-init that the bounded execute path provided pre-composition.
+     */
+    async ensureReady() {
+        if (!this.isReady) {
+            await this.init();
+        }
     }
 }
 //# sourceMappingURL=pyodide.js.map

package/dist/runtime/pyodide.js.map

@@ -1 +1 @@
-{"version":3,"file":"pyodide.js","sourceRoot":"","sources":["../../src/runtime/pyodide.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAA8B,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAwB5C,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,OAAO,aAAc,SAAQ,cAAc;IAC/C;;;;OAIG;IACH,YAAY,UAAgC,EAAE;QAC5C,2BAA2B;QAC3B,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC;YAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;QAEH,6DAA6D;QAC7D,MAAM,eAAe,GAA0B;YAC7C,SAAS;YACT,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,gBAAgB,EAAE,OAAO,CAAC,SAAS;SACpC,CAAC;QAEF,KAAK,CAAC,eAAe,CAAC,CAAC;IACzB,CAAC;CACF"}
+{"version":3,"file":"pyodide.js","sourceRoot":"","sources":["../../src/runtime/pyodide.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,SAAS,EAA6B,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAwB5C,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,OAAO,aAAc,SAAQ,cAAc;IAC9B,GAAG,CAAY;IAEhC;;;;OAIG;IACH,YAAY,UAAgC,EAAE;QAC5C,KAAK,EAAE,CAAC;QAER,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC;YAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,GAAG,IAAI,SAAS,CAAC;YACvB,SAAS;YACT,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,gBAAgB,EAAE,OAAO,CAAC,SAAS;SACpC,CAAC,CAAC;QACH,kDAAkD;QAClD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,8EAA8E;IAC9E,YAAY;IACZ,8EAA8E;IAEpE,KAAK,CAAC,MAAM;QACpB,2EAA2E;QAC3E,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;IAED;;;OAGG;IACO,KAAK,CAAC,SAAS;QACvB,0DAA0D;IAC5D,CAAC;IAED,8EAA8E;IAC9E,yEAAyE;IACzE,8EAA8E;IAE9E,KAAK,CAAC,IAAI,CACR,MAAc,EACd,YAAoB,EACpB,IAAe,EACf,MAAgC;QAEhC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAI,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,WAAW,CACf,MAAc,EACd,SAAiB,EACjB,IAAe,EACf,MAAgC;QAEhC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAI,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,UAAU,CACd,MAAc,EACd,UAAkB,EAClB,IAAe,EACf,MAAgC;QAEhC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,CAAI,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,MAAc;QAClC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAA8B;QAChD,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,WAAW;QACvB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;CACF"}