car-runtime 0.8.0 → 0.8.1

package/index.d.ts

@@ -1514,6 +1514,11 @@ export function agentsInvokeExternal(
 ): Promise<string>;
 
 // --- A2UI surface store (car-a2ui) ---
+//
+// NOTE: NAPI-rs converts `a2ui_*` snake-case Rust names to `a2Ui*`
+// camelCase at the JS boundary because the digit→letter transition
+// after `a2` is treated as a word boundary by heck's casing rules.
+// Names below match the actual runtime exports.
 
 /**
  * Process-singleton in-process A2UI v0.9 surface store. Wire shapes
@@ -1527,7 +1532,7 @@ export function agentsInvokeExternal(
  * Returns JSON `A2uiCapabilities` (version, mimeType, catalogs,
  * components, limits).
  */
-export function a2uiCapabilities(): string;
+export function a2UiCapabilities(): string;
 
 /**
  * Apply a single A2UI envelope (`createSurface` | `updateComponents`
@@ -1535,7 +1540,7 @@ export function a2uiCapabilities(): string;
  * direct envelope shape (one message field set). Returns JSON
  * `A2uiApplyResult` `{surfaceId, deleted, surface?}`.
  */
-export function a2uiApply(envelopeJson: string): Promise<string>;
+export function a2UiApply(envelopeJson: string): Promise<string>;
 
 /**
  * Extract A2UI envelopes from a carrier payload (`{a2ui: {...}}`,
@@ -1543,29 +1548,36 @@ export function a2uiApply(envelopeJson: string): Promise<string>;
  * Owner is auto-extracted from A2A `taskId`/`contextId` shapes.
  * Returns JSON `{applied: [A2uiApplyResult]}`.
  */
-export function a2uiIngest(payloadJson: string): Promise<string>;
+export function a2UiIngest(payloadJson: string): Promise<string>;
 
 /**
  * List all live A2UI surfaces in the in-process store. Returns
  * JSON `[A2uiSurface]`.
  */
-export function a2uiSurfaces(): Promise<string>;
+export function a2UiSurfaces(): Promise<string>;
 
 /**
  * Fetch a surface by id. Returns JSON `A2uiSurface` or `null` if
  * the surface doesn't exist.
  */
-export function a2uiGet(surfaceId: string): Promise<string>;
+export function a2UiGet(surfaceId: string): Promise<string>;
 
 /**
  * Reap surfaces older than `limits.maxSurfaceAgeSecs`. Returns JSON
  * `{removed: [surfaceId]}` — empty array when nothing was due.
  */
-export function a2uiReap(): Promise<string>;
+export function a2UiReap(): Promise<string>;
+
+/**
+ * Submit an A2UI user action (e.g. button click) back to the action
+ * handler. `actionJson` is the action payload. Returns JSON
+ * `{accepted: boolean, result?: any}`.
+ */
+export function a2UiAction(actionJson: string): Promise<string>;
 
 /**
  * Validate a JSON payload against the store's size limits. Returns
  * JSON `null` on success; rejects with a limit-exceeded error
  * message otherwise.
  */
-export function a2uiValidatePayload(valueJson: string): string;
+export function a2UiValidatePayload(valueJson: string): string;

package/package.json

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