@ax-llm/ax 17.0.5 → 17.0.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ax-llm/ax",
-  "version": "17.0.5",
+  "version": "17.0.6",
   "type": "module",
   "description": "The best library to work with LLMs",
   "repository": {

package/skills/ax-agent.md

@@ -1,7 +1,7 @@
 ---
 name: ax-agent
 description: This skill helps with building AxAgent-based agents using @ax-llm/ax. Use when the user asks about agent(), AxAgent, child agents, tool functions, smart model routing, RLM mode, stopping agents, or composing multi-agent hierarchies.
-version: "17.0.5"
+version: "17.0.6"
 ---
 
 # AxAgent Guide (@ax-llm/ax)
@@ -469,6 +469,27 @@ In RLM mode, the agent gets a `codeInterpreter` tool. The LLM's typical workflow
 | `print(...args)` | Print output (appears in the function result) |
 | Context variables | All fields listed in `contextFields` are available by name |
 
+### Error handling in the code interpreter
+
+Errors thrown by code running inside `session.execute(code)` cross the worker boundary and can be caught on the host. Always `await` `session.execute()` inside a try/catch:
+
+```typescript
+try {
+  const result = await session.execute(code);
+  // use result
+} catch (e) {
+  // e is an Error with name and message preserved from the worker
+  if (e instanceof Error && e.name === 'WaitForUserActionError') {
+    // handle domain-specific error
+  }
+  console.error(e.message);
+}
+```
+
+- **`e.name`** and **`e.message`** are preserved, so you can branch on `e.name === 'WaitForUserActionError'` (or other custom error names) and use `e.message` for user-facing context.
+- **`e.cause`** is preserved when structured-cloneable, including recursive cause chains (with a depth limit).
+- **`instanceof`** works for built-in errors (e.g. `TypeError`, `RangeError`) and for `Error`; for custom classes defined only in the worker, use **`e.name`** checks instead, since prototype identity is not preserved across the boundary.
+
 ### Custom Interpreters
 
 The built-in `AxJSRuntime` uses Web Workers for sandboxed code execution. For other environments, implement the `AxCodeRuntime` interface:

package/skills/ax-llm.md

@@ -1,7 +1,7 @@
 ---
 name: ax-llm
 description: This skill helps with using the @ax-llm/ax TypeScript library for building LLM applications. Use when the user asks about ax(), ai(), f(), s(), agent(), flow(), AxGen, AxAgent, AxFlow, signatures, streaming, or mentions @ax-llm/ax.
-version: "17.0.5"
+version: "17.0.6"
 ---
 
 # Ax Library (@ax-llm/ax) Usage Guide