car-runtime 0.9.0 → 0.10.0

package/index.d.ts

@@ -642,8 +642,11 @@ export class CarRuntime {
 
 /**
  * Execute a proposal through a CarRuntime with a JS tool callback.
- * The callback receives `{"tool":"name","params":{...}}` as a JSON string
- * and must return a JSON string.
+ * The callback receives
+ * `{"tool":"name","params":{...},"action_id":"<id>"}` as a JSON
+ * string and must return a JSON string. `action_id` is the
+ * originating `Action.id` from the proposal — useful for routing
+ * when the same callback closes over multiple in-flight calls.
  *
  * `sessionId`, when provided, scopes per-action policy validation to
  * the named session opened via `CarRuntime.openSession()`. Global
@@ -844,10 +847,17 @@ export function registerVoiceEventHandler(
  * proposal carrying host-owned tools, every tool routes through
  * this handler.
  *
- * `handlerFn(callJson)` receives `{"tool":"name","params":{...}}`
- * as a JSON string and MUST return a Promise resolving to the
- * tool's JSON-encoded result. Throwing rejects the daemon-side
- * action with a -32000 JSON-RPC error.
+ * `handlerFn(callJson)` receives
+ * `{"tool":"name","params":{...},"action_id":"<id>"}` as a JSON
+ * string and MUST return a Promise resolving to the tool's
+ * JSON-encoded result. Throwing rejects the daemon-side action
+ * with a -32000 JSON-RPC error.
+ *
+ * `action_id` carries the originating `Action.id` from the
+ * proposal so process-wide handlers can route concurrent
+ * callbacks back to the right per-call closure. Empty string when
+ * the daemon's `tools.execute` payload omits it (legacy daemons;
+ * not expected on >=0.9.x).
  *
  * Process-wide setter — re-calling overwrites the previous
  * handler. Pair with `unregisterToolHandler` to clear. Symmetric

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "car-runtime",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Common Agent Runtime — a deterministic execution layer for AI agents",
   "main": "index.js",
   "types": "index.d.ts",