@boundaryml/baml-core-node 0.11.2-nightly.20260604.d → 0.11.3-nightly.20260606.b

package/dist/define_function.d.ts

@@ -13,7 +13,7 @@ export declare const UNSET: unique symbol;
  * that maps positional args to kwargs, encodes, calls the runtime, and decodes.
  * `sync` returns the decoded value; `async` returns a `Promise` of it.
  */
-export declare function defineFunction(bamlFqn: string, mode: Mode, paramNames: readonly string[], requiredPositionalCount?: number): (...args: unknown[]) => unknown;
+export declare function defineFunction(bamlFqn: string, mode: Mode, requiredParamNames: readonly string[], optionalParamNames?: readonly string[] | undefined): (...args: unknown[]) => unknown;
 /**
  * Receiver-binding factory for instance methods. `paramNames[0]` is always
  * `"self"`. Codegen emits the binding as a class-field initializer
@@ -21,7 +21,7 @@ export declare function defineFunction(bamlFqn: string, mode: Mode, paramNames:
  * captures the instance at construction time; the synthetic `self` param never
  * appears in the surface type.
  */
-export declare function defineInstanceFunction(bamlFqn: string, mode: Mode, paramNames: readonly string[]): {
+export declare function defineInstanceFunction(bamlFqn: string, mode: Mode, requiredParamNames: readonly string[], optionalParamNames?: readonly string[] | undefined): {
     bind(self: unknown): (...args: unknown[]) => unknown;
 };
 //# sourceMappingURL=define_function.d.ts.map

package/dist/define_function.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define_function.d.ts","sourceRoot":"","sources":["../typescript_src/define_function.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpC,8EAA8E;AAC9E,eAAO,MAAM,KAAK,EAAE,OAAO,MAA6B,CAAC;AAsBzD;;;;GAIG;AACH,wBAAgB,cAAc,CAC1B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,uBAAuB,CAAC,EAAE,MAAM,GACjC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAqBjC;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAClC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,SAAS,MAAM,EAAE,GAC9B;IAAE,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAA;CAAE,CAkC1D"}
+{"version":3,"file":"define_function.d.ts","sourceRoot":"","sources":["../typescript_src/define_function.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpC,8EAA8E;AAC9E,eAAO,MAAM,KAAK,EAAE,OAAO,MAA6B,CAAC;AAwCzD;;;;GAIG;AACH,wBAAgB,cAAc,CAC1B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,IAAI,EACV,kBAAkB,EAAE,SAAS,MAAM,EAAE,EACrC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GACnD,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAsBjC;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAClC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,IAAI,EACV,kBAAkB,EAAE,SAAS,MAAM,EAAE,EACrC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GACnD;IAAE,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAA;CAAE,CAmC1D"}

package/dist/define_function.js

@@ -14,24 +14,43 @@
 // and per instance method (inside the class body):
 //   m = defineInstanceFunction("user.ns.C.m", "sync", ["self"]).bind(this) as () => R;
 //
-// The factory captures (fqn, mode, paramNames) by closure; the returned
-// callable zips positional args against paramNames into a kwargs object,
+// The factory captures (fqn, mode, requiredNames, optionalNames) by closure;
+// the returned callable zips positional args against requiredNames into kwargs,
 // encodes it, calls the runtime, and decodes the result.
 import { getRuntime } from './native.js';
 import { encodeCallArgs, decodeCallResult } from './proto.js';
 /** Sentinel for "argument not supplied" so optional kwargs can be skipped. */
 export const UNSET = Symbol('baml.UNSET');
-function buildKwargs(args, paramNames, requiredPositionalCount) {
-    const positionalLimit = requiredPositionalCount ?? paramNames.length;
-    if (args.length > positionalLimit) {
+function buildKwargs(args, requiredParamNames, optionalParamNames) {
+    const positionalLimit = requiredParamNames.length;
+    const hasOpts = optionalParamNames.length > 0;
+    if (args.length > positionalLimit + (hasOpts ? 1 : 0)) {
         throw new TypeError(`got ${args.length} positional arguments but only ${positionalLimit} positional ` +
-            `parameter names (${JSON.stringify(paramNames.slice(0, positionalLimit))})`);
+            `parameter names (${JSON.stringify(requiredParamNames)})`);
     }
     const built = {};
-    for (let i = 0; i < args.length && i < paramNames.length; i++) {
+    for (let i = 0; i < args.length && i < positionalLimit; i++) {
         if (args[i] === UNSET)
             continue;
-        built[paramNames[i]] = args[i];
+        built[requiredParamNames[i]] = args[i];
+    }
+    if (hasOpts && args.length > positionalLimit) {
+        const opts = args[positionalLimit];
+        if (opts === undefined || opts === UNSET) {
+            return built;
+        }
+        if (opts === null || Array.isArray(opts) || typeof opts !== 'object') {
+            throw new TypeError('optional arguments must be passed as an object');
+        }
+        const optionNames = new Set(optionalParamNames);
+        for (const [key, value] of Object.entries(opts)) {
+            if (!optionNames.has(key)) {
+                throw new TypeError(`unknown optional argument ${JSON.stringify(key)}`);
+            }
+            if (value === undefined || value === UNSET)
+                continue;
+            built[key] = value;
+        }
     }
     return built;
 }
@@ -40,11 +59,12 @@ function buildKwargs(args, paramNames, requiredPositionalCount) {
  * that maps positional args to kwargs, encodes, calls the runtime, and decodes.
  * `sync` returns the decoded value; `async` returns a `Promise` of it.
  */
-export function defineFunction(bamlFqn, mode, paramNames, requiredPositionalCount) {
-    const names = [...paramNames];
+export function defineFunction(bamlFqn, mode, requiredParamNames, optionalParamNames) {
+    const requiredNames = [...requiredParamNames];
+    const optionNames = [...(optionalParamNames ?? [])];
     if (mode === 'sync') {
         return (...args) => {
-            const merged = buildKwargs(args, names, requiredPositionalCount);
+            const merged = buildKwargs(args, requiredNames, optionNames);
             const rt = getRuntime();
             const argsProto = encodeCallArgs(merged, /* syncMode */ true);
             const resultBytes = rt.callFunctionSync(bamlFqn, argsProto, null, null, null);
@@ -53,7 +73,7 @@ export function defineFunction(bamlFqn, mode, paramNames, requiredPositionalCoun
     }
     if (mode === 'async') {
         return async (...args) => {
-            const merged = buildKwargs(args, names, requiredPositionalCount);
+            const merged = buildKwargs(args, requiredNames, optionNames);
             const rt = getRuntime();
             const argsProto = encodeCallArgs(merged);
             const resultBytes = await rt.callFunction(bamlFqn, argsProto, null, null, null);
@@ -69,12 +89,13 @@ export function defineFunction(bamlFqn, mode, paramNames, requiredPositionalCoun
  * captures the instance at construction time; the synthetic `self` param never
  * appears in the surface type.
  */
-export function defineInstanceFunction(bamlFqn, mode, paramNames) {
-    const names = [...paramNames];
-    const selfName = names[0] ?? 'self';
-    const rest = names.slice(1);
+export function defineInstanceFunction(bamlFqn, mode, requiredParamNames, optionalParamNames) {
+    const requiredNames = [...requiredParamNames];
+    const optionNames = [...(optionalParamNames ?? [])];
+    const selfName = requiredNames[0] ?? 'self';
+    const rest = requiredNames.slice(1);
     const makeKwargs = (self, args) => {
-        const merged = buildKwargs(args, rest);
+        const merged = buildKwargs(args, rest, optionNames);
         merged[selfName] = self;
         return merged;
     };

package/dist/define_function.js.map

@@ -1 +1 @@
-{"version":3,"file":"define_function.js","sourceRoot":"","sources":["../typescript_src/define_function.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"define_function.js","sourceRoot":"","sources":["../typescript_src/define_function.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,iEAAiE;AACjE,EAAE;AACF,+CAA+C;AAC/C,gFAAgF;AAChF,gGAAgG;AAChG,mDAAmD;AACnD,uFAAuF;AACvF,EAAE;AACF,6EAA6E;AAC7E,gFAAgF;AAChF,yDAAyD;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAI9D,8EAA8E;AAC9E,MAAM,CAAC,MAAM,KAAK,GAAkB,MAAM,CAAC,YAAY,CAAC,CAAC;AAEzD,SAAS,WAAW,CAChB,IAAe,EACf,kBAAqC,EACrC,kBAAqC;IAErC,MAAM,eAAe,GAAG,kBAAkB,CAAC,MAAM,CAAC;IAClD,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9C,IAAI,IAAI,CAAC,MAAM,GAAG,eAAe,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,SAAS,CACf,OAAO,IAAI,CAAC,MAAM,kCAAkC,eAAe,cAAc;YACjF,oBAAoB,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,GAAG,CAC5D,CAAC;IACN,CAAC;IACD,MAAM,KAAK,GAA4B,EAAE,CAAC;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,eAAe,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1D,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK;YAAE,SAAS;QAChC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,OAAO,IAAI,IAAI,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC;QACnC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACvC,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnE,MAAM,IAAI,SAAS,CAAC,gDAAgD,CAAC,CAAC;QAC1E,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAChD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAA+B,CAAC,EAAE,CAAC;YACzE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,SAAS,CAAC,6BAA6B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC5E,CAAC;YACD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK;gBAAE,SAAS;YACrD,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACvB,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC1B,OAAe,EACf,IAAU,EACV,kBAAqC,EACrC,kBAAkD;IAElD,MAAM,aAAa,GAAG,CAAC,GAAG,kBAAkB,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,CAAC;IACpD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,IAAe,EAAW,EAAE;YACnC,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;YAC7D,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;YACxB,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;YAC9D,MAAM,WAAW,GAAG,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YAC9E,OAAO,gBAAgB,CAAC,WAAW,CAAC,CAAC;QACzC,CAAC,CAAC;IACN,CAAC;IACD,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACnB,OAAO,KAAK,EAAE,GAAG,IAAe,EAAoB,EAAE;YAClD,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;YAC7D,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;YACxB,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;YACzC,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YAChF,OAAO,gBAAgB,CAAC,WAAW,CAAC,CAAC;QACzC,CAAC,CAAC;IACN,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACnF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAClC,OAAe,EACf,IAAU,EACV,kBAAqC,EACrC,kBAAkD;IAElD,MAAM,aAAa,GAAG,CAAC,GAAG,kBAAkB,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;IAC5C,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEpC,MAAM,UAAU,GAAG,CAAC,IAAa,EAAE,IAAe,EAA2B,EAAE;QAC3E,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QACpD,MAAM,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;QACxB,OAAO,MAAM,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO;QACH,IAAI,CAAC,IAAa;YACd,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;gBAClB,OAAO,CAAC,GAAG,IAAe,EAAW,EAAE;oBACnC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;oBACtC,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;oBACxB,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;oBAC9D,MAAM,WAAW,GAAG,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;oBAC9E,OAAO,gBAAgB,CAAC,WAAW,CAAC,CAAC;gBACzC,CAAC,CAAC;YACN,CAAC;YACD,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;gBACnB,OAAO,KAAK,EAAE,GAAG,IAAe,EAAoB,EAAE;oBAClD,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;oBACtC,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;oBACxB,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;oBACzC,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;oBAChF,OAAO,gBAAgB,CAAC,WAAW,CAAC,CAAC;gBACzC,CAAC,CAAC;YACN,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnF,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/host_error_registry.d.ts

@@ -0,0 +1,57 @@
+/**
+ * THIS FILE IS AUTO-GENERATED — DO NOT EDIT BY HAND.
+ *
+ * Source: baml_language/crates/bridge_nodejs/typescript_src/
+ * Proto:  baml_language/crates/bridge_ctypes/types/baml_core/cffi/v1/*.proto
+ * Build:  cd baml_language/crates/bridge_nodejs && pnpm build:debug
+ */
+import { type HandleKey } from './native.js';
+/**
+ * Register a JS error object and return its native `HandleKey` for the
+ * `_handle: Handle(HOST_VALUE_ERROR, key)` slot of a
+ * `baml.errors.HostCallable` Instance. Mints a fresh key via the Rust
+ * side's shared counter (guaranteed non-zero — Rust `next_key` skips
+ * `0`); stores the error keyed by the same key (recomposed as a
+ * `bigint` for `Map`-key equality).
+ *
+ * Returns the native `HandleKey` directly so it can flow into the
+ * protobufjs encoder without an intermediate `bigint→Long` conversion
+ * (protobufjs reads `uint64` fields from a `{low, high}` shape, which
+ * the native `HandleKey` already provides; a bare `bigint` does not
+ * encode correctly through the `IInboundValue.handle.key` field).
+ */
+export declare function registerHostError(err: unknown): HandleKey;
+/**
+ * Look up a host-registered JS error by key. Returns `undefined` when:
+ * - the key is the reserved sentinel `0n` (no real error was registered);
+ * - the engine has already released the entry (last `HostValueArc` clone
+ *   dropped → Rust `host_release_callback` fired → `_releaseHostError`
+ *   removed the entry);
+ * - the key was minted by a different Node process (cross-runtime handle).
+ *
+ * Callers should fall back to a metadata-built exception in those cases.
+ *
+ * GC/decode race: a release notification and a rehydrating decode can be
+ * scheduled on the libuv loop concurrently in principle, but in practice
+ * the same `HostValueArc` cannot drop *while* the engine is actively
+ * emitting an outbound proto referencing its key — the outbound encode
+ * holds a strong handle through proto serialization, and the release tsfn
+ * isn't fired until that strong handle drops. By the time the TS decoder
+ * runs `tryRehydrateFromHandle`, the only way the map entry is gone is if
+ * a *prior* outbound completed and the engine has since dropped its last
+ * Arc; in that case the user has already observed the original throw at
+ * least once, so a second lookup-miss → metadata-fallback is acceptable.
+ */
+export declare function lookupHostError(key: bigint): unknown;
+/**
+ * Convenience for the outbound decoder: if `handle` is a `BamlHandle`
+ * tagged `HOST_VALUE_ERROR`, look up the originating JS error object in
+ * the registry and return it. Returns `undefined` for any other handle
+ * type, a non-`BamlHandle` argument, or a key that doesn't resolve.
+ *
+ * Used by `decodeCallResult`'s `error` arm to rehydrate the original JS
+ * exception when a BAML-thrown `baml.errors.HostCallable` propagates back
+ * to the same Node process that originated it.
+ */
+export declare function tryRehydrateFromHandle(handle: unknown): unknown;
+//# sourceMappingURL=host_error_registry.d.ts.map

package/dist/host_error_registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host_error_registry.d.ts","sourceRoot":"","sources":["../typescript_src/host_error_registry.ts"],"names":[],"mappings":"AAmCA,OAAO,EAA8D,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AA4BzG;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,CAIzD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAI/D"}

package/dist/host_error_registry.js

@@ -0,0 +1,139 @@
+/**
+ * THIS FILE IS AUTO-GENERATED — DO NOT EDIT BY HAND.
+ *
+ * Source: baml_language/crates/bridge_nodejs/typescript_src/
+ * Proto:  baml_language/crates/bridge_ctypes/types/baml_core/cffi/v1/*.proto
+ * Build:  cd baml_language/crates/bridge_nodejs && pnpm build:debug
+ */
+// host_error_registry.ts — mirrors bridge_python's `register_host_error`
+// + `lookup_host_value` pair.
+//
+// A native JS exception raised inside a user callable round-trips back to
+// the *same* Node process as the *same* `Error` object (`raised === caught`
+// identity), not flattened into a metadata-only `BamlError(HostCallable(...))`
+// wrapper. The plumbing:
+//
+//   1. The TS bridge catches the JS error inside `sendHostCallableError`
+//      (proto.ts) and calls `registerHostError(err)` here.
+//   2. `registerHostError` mints a globally-unique key via
+//      `native.mintHostErrorKey` (drawing from the shared callable+error
+//      counter on the Rust side so the engine sees one keyspace), stores
+//      the JS error in the local `Map<bigint, unknown>`, returns the key.
+//   3. The bridge emits an `InboundValue.Class(name="baml.errors.HostCallable",
+//      fields=[..., _handle: Handle(HOST_VALUE_ERROR, key)])`. The engine
+//      interns an `Arc<HostValueArc>` per the same key.
+//   4. When BAML propagates the throw back out to the host, the outbound
+//      encoder re-emits the `_handle: Handle(HOST_VALUE_ERROR, key)`. The
+//      TS decoder (proto.ts) inspects a decoded `HostCallable` instance,
+//      reads `_handle.key`, calls `lookupHostError(key)` here, and re-throws
+//      the original JS error.
+//   5. When the engine drops its last `Arc<HostValueArc>(key)`, the Rust
+//      `host_release_callback` fires the TS-installed release callback
+//      (`native.registerErrorReleaseCallback`), which calls `_releaseHostError`
+//      here to remove the map entry.
+//
+// Foreign runtimes (a different Node process, the Python bridge, etc.) see
+// a `_handle` whose key doesn't resolve in their local registry; the
+// decoder falls back to the metadata-bearing `BamlError(HostCallable(...))`
+// wrapper. The reserved `0` is used as a sentinel by code paths that
+// cannot register a real JS error (engine-internal synthetic faults like
+// "no JS callable for this key"); `_releaseHostError(0n)` is a benign
+// no-op since `mintHostErrorKey` never returns `0`.
+import { mintHostErrorKey, registerErrorReleaseCallback, BamlHandle } from './native.js';
+import { baml_core } from './proto/baml_cffi.js';
+const BamlHandleType = baml_core.cffi.v1.BamlHandleType;
+const errorMap = new Map();
+/**
+ * Convert a `HandleKey` (`{ low, high }`) to a `bigint` for use as a `Map` key.
+ * Native `HandleKey` instances split a `u64` across two `i32` low/high halves
+ * (signed, two's-complement). Recompose by treating each half as a 32-bit
+ * unsigned value via `>>> 0`, then shift+or as `bigint`.
+ *
+ * The `>>> 0` coercion matters whenever either half's MSB is set: without it,
+ * a negative `i32` would widen to a negative `bigint` and corrupt the
+ * recomposed `u64`. Examples:
+ *
+ *   - `{ low: 1, high: 0 }` →  `0x1n`               (small key, no MSB set)
+ *   - `{ low: -1, high: -1 }` → `0xFFFFFFFFFFFFFFFFn` (u64::MAX; both halves'
+ *      MSB set — `>>> 0` reinterprets `-1` as `0xFFFFFFFF` before widening)
+ *   - `{ low: 0, high: 1 }` →  `0x1_00000000n`     (2^32)
+ */
+function handleKeyToBigint(key) {
+    const low = BigInt(key.low >>> 0);
+    const high = BigInt(key.high >>> 0);
+    return (high << 32n) | low;
+}
+/**
+ * Register a JS error object and return its native `HandleKey` for the
+ * `_handle: Handle(HOST_VALUE_ERROR, key)` slot of a
+ * `baml.errors.HostCallable` Instance. Mints a fresh key via the Rust
+ * side's shared counter (guaranteed non-zero — Rust `next_key` skips
+ * `0`); stores the error keyed by the same key (recomposed as a
+ * `bigint` for `Map`-key equality).
+ *
+ * Returns the native `HandleKey` directly so it can flow into the
+ * protobufjs encoder without an intermediate `bigint→Long` conversion
+ * (protobufjs reads `uint64` fields from a `{low, high}` shape, which
+ * the native `HandleKey` already provides; a bare `bigint` does not
+ * encode correctly through the `IInboundValue.handle.key` field).
+ */
+export function registerHostError(err) {
+    const key = mintHostErrorKey();
+    errorMap.set(handleKeyToBigint(key), err);
+    return key;
+}
+/**
+ * Look up a host-registered JS error by key. Returns `undefined` when:
+ * - the key is the reserved sentinel `0n` (no real error was registered);
+ * - the engine has already released the entry (last `HostValueArc` clone
+ *   dropped → Rust `host_release_callback` fired → `_releaseHostError`
+ *   removed the entry);
+ * - the key was minted by a different Node process (cross-runtime handle).
+ *
+ * Callers should fall back to a metadata-built exception in those cases.
+ *
+ * GC/decode race: a release notification and a rehydrating decode can be
+ * scheduled on the libuv loop concurrently in principle, but in practice
+ * the same `HostValueArc` cannot drop *while* the engine is actively
+ * emitting an outbound proto referencing its key — the outbound encode
+ * holds a strong handle through proto serialization, and the release tsfn
+ * isn't fired until that strong handle drops. By the time the TS decoder
+ * runs `tryRehydrateFromHandle`, the only way the map entry is gone is if
+ * a *prior* outbound completed and the engine has since dropped its last
+ * Arc; in that case the user has already observed the original throw at
+ * least once, so a second lookup-miss → metadata-fallback is acceptable.
+ */
+export function lookupHostError(key) {
+    return errorMap.get(key);
+}
+/**
+ * Convenience for the outbound decoder: if `handle` is a `BamlHandle`
+ * tagged `HOST_VALUE_ERROR`, look up the originating JS error object in
+ * the registry and return it. Returns `undefined` for any other handle
+ * type, a non-`BamlHandle` argument, or a key that doesn't resolve.
+ *
+ * Used by `decodeCallResult`'s `error` arm to rehydrate the original JS
+ * exception when a BAML-thrown `baml.errors.HostCallable` propagates back
+ * to the same Node process that originated it.
+ */
+export function tryRehydrateFromHandle(handle) {
+    if (!(handle instanceof BamlHandle))
+        return undefined;
+    if (handle.handleType !== BamlHandleType.HOST_VALUE_ERROR)
+        return undefined;
+    return lookupHostError(handleKeyToBigint(handle.key));
+}
+/**
+ * Internal: remove the map entry for `key`. Wired at module init as the
+ * Rust-side release callback. Idempotent and absent-key-safe so the same
+ * callback can be invoked for *every* `HostValueArc` release (including
+ * callable keys, which never have a TS-side error entry).
+ */
+function _releaseHostError(key) {
+    errorMap.delete(handleKeyToBigint(key));
+}
+// Install the Rust-side release callback exactly once at module load. The
+// napi function is itself first-call-wins on the Rust side, so reloads
+// (e.g. test harnesses) are harmless.
+registerErrorReleaseCallback(_releaseHostError);
+//# sourceMappingURL=host_error_registry.js.map

package/dist/host_error_registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host_error_registry.js","sourceRoot":"","sources":["../typescript_src/host_error_registry.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,8BAA8B;AAC9B,EAAE;AACF,0EAA0E;AAC1E,4EAA4E;AAC5E,+EAA+E;AAC/E,yBAAyB;AACzB,EAAE;AACF,yEAAyE;AACzE,2DAA2D;AAC3D,2DAA2D;AAC3D,yEAAyE;AACzE,yEAAyE;AACzE,0EAA0E;AAC1E,gFAAgF;AAChF,0EAA0E;AAC1E,wDAAwD;AACxD,yEAAyE;AACzE,0EAA0E;AAC1E,yEAAyE;AACzE,6EAA6E;AAC7E,8BAA8B;AAC9B,yEAAyE;AACzE,uEAAuE;AACvE,gFAAgF;AAChF,qCAAqC;AACrC,EAAE;AACF,2EAA2E;AAC3E,qEAAqE;AACrE,4EAA4E;AAC5E,qEAAqE;AACrE,yEAAyE;AACzE,sEAAsE;AACtE,oDAAoD;AAEpD,OAAO,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,UAAU,EAAkB,MAAM,aAAa,CAAC;AACzG,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,MAAM,cAAc,GAAG,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC;AAExD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;AAE5C;;;;;;;;;;;;;;GAcG;AACH,SAAS,iBAAiB,CAAC,GAAc;IACrC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;IACpC,OAAO,CAAC,IAAI,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC;AAC/B,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC1C,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1C,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACvC,OAAO,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAe;IAClD,IAAI,CAAC,CAAC,MAAM,YAAY,UAAU,CAAC;QAAE,OAAO,SAAS,CAAC;IACtD,IAAI,MAAM,CAAC,UAAU,KAAK,cAAc,CAAC,gBAAgB;QAAE,OAAO,SAAS,CAAC;IAC5E,OAAO,eAAe,CAAC,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,GAAc;IACrC,QAAQ,CAAC,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,0EAA0E;AAC1E,uEAAuE;AACvE,sCAAsC;AACtC,4BAA4B,CAAC,iBAAiB,CAAC,CAAC"}

package/dist/index.d.ts

@@ -8,7 +8,7 @@
 import { BamlRuntime, AbortController, HostSpanManager, Collector as NativeCollector, FunctionLog as NativeFunctionLog, Timing, Usage, LLMCall } from './native.js';
 export { BamlRuntime, AbortController, BamlHandle, HostSpanManager, getRuntime, getVersion, flushEvents } from './native.js';
 export { Timing, Usage, LLMCall } from './native.js';
-export { takeHandleFromTable, putHandleIntoTable, _seedFunctionRefHandle, _seedGenericMediaHandle, } from './native.js';
+export { _seedFunctionRefHandle, _seedGenericMediaHandle } from './native.js';
 export { BamlImage, BamlAudio, BamlVideo, BamlPdf } from './native.js';
 export { BamlStream } from './stream.js';
 export { encodeCallArgs, decodeCallResult } from './proto.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -11,8 +11,7 @@ import { encodeCallArgs, decodeCallResult } from './proto.js';
 import { installFlushOnExit } from './exit_hook.js';
 export { BamlRuntime, AbortController, BamlHandle, HostSpanManager, getRuntime, getVersion, flushEvents } from './native.js';
 export { Timing, Usage } from './native.js';
-// Handle-table helpers (decode validate-on-take / encode clone-on-put + test seeds).
-export { takeHandleFromTable, putHandleIntoTable, _seedFunctionRefHandle, _seedGenericMediaHandle, } from './native.js';
+export { _seedFunctionRefHandle, _seedGenericMediaHandle } from './native.js';
 // Runtime-owned stdlib value classes. Exported under their `Baml*` names only;
 // codegen aliases them as Image/Audio/Video/Pdf on re-export.
 export { BamlImage, BamlAudio, BamlVideo, BamlPdf } from './native.js';
@@ -101,24 +100,36 @@ export function callFunctionSync(rt, functionName, kwargs, ctx, collectors, abor
     // starving libuv so the dispatch could never run.
     const argsProto = encodeCallArgs(kwargs, /* syncMode */ true);
     const nativeCollectors = collectors?.map(c => c._native()) ?? null;
+    // Only the napi call gets `wrapNativeError`'d — its `napi::Error`
+    // messages need parsing into typed `Baml*Error` subclasses. The
+    // decoder's throws (`BamlError`/`BamlPanic`, *or* a re-raised
+    // original JS exception from the host-callable rehydration path)
+    // already carry the right type and must propagate by identity.
+    let resultBytes;
     try {
-        const resultBytes = rt.callFunctionSync(functionName, argsProto, ctx ?? null, nativeCollectors, abortController ?? null);
-        return new FunctionResult(decodeCallResult(resultBytes));
+        resultBytes = rt.callFunctionSync(functionName, argsProto, ctx ?? null, nativeCollectors, abortController ?? null);
     }
     catch (err) {
         throw wrapNativeError(err);
     }
+    return new FunctionResult(decodeCallResult(resultBytes));
 }
 export async function callFunction(rt, functionName, kwargs, ctx, collectors, abortController) {
     const argsProto = encodeCallArgs(kwargs);
     const nativeCollectors = collectors?.map(c => c._native()) ?? null;
+    // Only the napi call gets `wrapNativeError`'d — its `napi::Error`
+    // messages need parsing into typed `Baml*Error` subclasses. The
+    // decoder's throws (`BamlError`/`BamlPanic`, *or* a re-raised
+    // original JS exception from the host-callable rehydration path)
+    // already carry the right type and must propagate by identity.
+    let resultBytes;
     try {
-        const resultBytes = await rt.callFunction(functionName, argsProto, ctx ?? null, nativeCollectors, abortController ?? null);
-        return new FunctionResult(decodeCallResult(resultBytes));
+        resultBytes = await rt.callFunction(functionName, argsProto, ctx ?? null, nativeCollectors, abortController ?? null);
     }
     catch (err) {
         throw wrapNativeError(err);
     }
+    return new FunctionResult(decodeCallResult(resultBytes));
 }
 // Register flush on process exit (single registration; see exit_hook.ts).
 installFlushOnExit();

package/dist/index.js.map

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

package/dist/native.d.ts

@@ -47,6 +47,7 @@ export declare class BamlHandle {
   get key(): HandleKey
   get handleType(): number
   clone(): BamlHandle
+  _cloneKeyForWire(): HandleKey
 }
 
 export declare class BamlImage {
@@ -197,8 +198,9 @@ export declare function _seedGenericMediaHandle(): [HandleKey, number]
  *
  * Exposed to JS as `completeHostCall(callId, isError, content)`. The JS
  * dispatch wrapper invokes this after it has decoded `argsBytes`, called
- * the user function, and encoded the result (success) or constructed a
- * `HostCallableError` (failure).
+ * the user function, and encoded the result as an `InboundValue` (success
+ * is the value itself; an error is an `Instance` of
+ * `baml.errors.HostCallable` carrying the four metadata fields).
  *
  * Forwards directly to the `bridge_cffi::complete_host_call` C entry point
  * the engine uses for cross-language completion.
@@ -236,12 +238,44 @@ export interface HandleKey {
 }
 
 /**
- * Allocate a fresh `HANDLE_TABLE` row sharing the same `Arc` as `handle`,
- * returning the new key so the caller can stage a wire `BamlHandle`. The
- * original `handle` keeps its key and stays usable. Mirrors
- * `bridge_python::py_handle::put_pyhandle_into_table`.
+ * Mint a fresh host-value key, drawing from the shared callable+error
+ * counter so the engine sees one globally-unique keyspace. Returned to
+ * TS by `registerHostError` (the TS-side function in
+ * `host_error_registry.ts`).
+ *
+ * Exposed to JS as `mintHostErrorKey() -> HandleKey`. The TS-side error
+ * registry calls this once per `registerHostError(err)` before inserting
+ * the error into its `Map<bigint, unknown>`.
+ */
+export declare function mintHostErrorKey(): HandleKey
+
+/**
+ * Install the TS-side release callback. First-call-wins; subsequent
+ * calls are a no-op (matching the bridge_cffi dispatch-registration
+ * semantics). The callback fires for *every* `HostValueArc` release —
+ * for callable keys it's a TS-side no-op (`Map.delete(key)` on an absent
+ * key), so Rust doesn't need to distinguish kinds here.
+ *
+ * The tsfn is built with `weak::<true>()` (i.e. `napi_unref_threadsafe_
+ * function`). Holding it strong would pin the libuv loop for the
+ * lifetime of the process (the tsfn is parked in a `OnceLock` and never
+ * dropped), preventing the Node process from exiting even after all
+ * host work is done. Weak is correct here: the callback is a *release*
+ * notification — purely informational from the engine's side. Pending
+ * notifications that never deliver because the loop has already exited
+ * are harmless; the engine has already dropped its `Arc<HostValueArc>`,
+ * and the TS-side map entry would be torn down with the process
+ * anyway.
+ *
+ * Note this is the inverse of `register_host_callable`'s dispatch tsfn,
+ * which is `weak::<false>()` — that one pins the loop because a hung
+ * host callback awaiting completion *must* keep the loop alive so the
+ * JS callback can actually run.
+ *
+ * Exposed to JS as `registerErrorReleaseCallback(cb)`. Must be called
+ * exactly once at SDK module init, before any host call is dispatched.
  */
-export declare function putHandleIntoTable(handle: BamlHandle): HandleKey
+export declare function registerErrorReleaseCallback(callback: (key: HandleKey) => void): void
 
 /**
  * Register a JS dispatch wrapper in the host-value table and return its key.
@@ -270,11 +304,3 @@ export declare function registerHostCallable(callable: (callId: number, argsByte
  * key it registered during a failed encode.
  */
 export declare function releaseHostCallable(key: HandleKey): void
-
-/**
- * Validate that `key` exists in `HANDLE_TABLE`, then wrap as a `BamlHandle`.
- * Used by the proto decoder's handle path. Does **not** drain — the entry
- * stays in the table and is owned by the returned `BamlHandle`. Mirrors
- * `bridge_python::py_handle::take_pyhandle_from_table`.
- */
-export declare function takeHandleFromTable(key: HandleKey, handleType: number): BamlHandle