@datalayer/agent-runtimes 1.3.102 → 1.3.103

package/lib/runtimes/browser/a2aPeer.d.ts

@@ -185,6 +185,13 @@ export type AskA2APeerOptions = {
  * besides words comes with it, by media type. A task that ends other than
  * completed is thrown, with what the peer said.
  */
+/**
+ * What a peer that refused said, in its own sentence (STUDIO H-25): the A2A
+ * client throws an HTTP refusal as `HTTP error … : 429 . Response:
+ * {"detail": "…"}`, which a balloon would draw as it is — the route's
+ * sentence (a visitor's limit, a paused deployment) is its `detail`.
+ */
+export declare function peerRefusalOf(reason: unknown): string;
 export declare function askA2APeer(peer: A2APeer, request: string, options?: AskA2APeerOptions): Promise<A2APeerAnswer>;
 export type A2APeerToolOptions = {
     peer: A2APeer;

package/lib/runtimes/browser/a2aPeer.js

@@ -210,6 +210,28 @@ const ENDED_BADLY = {
  * besides words comes with it, by media type. A task that ends other than
  * completed is thrown, with what the peer said.
  */
+/**
+ * What a peer that refused said, in its own sentence (STUDIO H-25): the A2A
+ * client throws an HTTP refusal as `HTTP error … : 429 . Response:
+ * {"detail": "…"}`, which a balloon would draw as it is — the route's
+ * sentence (a visitor's limit, a paused deployment) is its `detail`.
+ */
+export function peerRefusalOf(reason) {
+    const message = reason instanceof Error ? reason.message : String(reason);
+    const body = /Response:\s*(\{[\s\S]*\})\s*$/.exec(message)?.[1];
+    if (body) {
+        try {
+            const detail = JSON.parse(body).detail;
+            if (typeof detail === 'string' && detail.trim()) {
+                return detail.trim();
+            }
+        }
+        catch {
+            // Not JSON: the message as it came.
+        }
+    }
+    return message;
+}
 export async function askA2APeer(peer, request, options = {}) {
     const { signal, onEvent, accept, action } = options;
     onEvent?.({
@@ -221,9 +243,11 @@ export async function askA2APeer(peer, request, options = {}) {
         return await streamTask(peer, request, signal, onEvent, accept, action);
     }
     catch (reason) {
-        const error = reason instanceof Error ? reason.message : String(reason);
+        const error = peerRefusalOf(reason);
         onEvent?.({ phase: 'failed', error });
-        throw reason;
+        throw reason instanceof Error && error !== reason.message
+            ? new Error(error)
+            : reason;
     }
 }
 async function streamTask(peer, request, signal, onEvent, accept, action) {
@@ -384,9 +408,7 @@ export function a2aPeerTool(options) {
                     : { answer };
             }
             catch (reason) {
-                return {
-                    error: reason instanceof Error ? reason.message : String(reason),
-                };
+                return { error: peerRefusalOf(reason) };
             }
         },
     });

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datalayer/agent-runtimes",
-    "version": "1.3.102",
+    "version": "1.3.103",
     "type": "module",
     "workspaces": [
         ".",