@mastra/client-js 1.15.0-alpha.5 → 1.15.0-alpha.6

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @mastra/client-js
 
+## 1.15.0-alpha.6
+
+### Minor Changes
+
+- Improved the Mastra A2A client to feel closer to the official A2A SDK without introducing a breaking change. ([#15720](https://github.com/mastra-ai/mastra/pull/15720))
+  - Added official-style A2A methods such as `getAgentCard()`, `sendMessageStream()`, `getExtendedAgentCard()`, and `getTaskPushNotificationConfig()`.
+  - Added typed A2A stream consumption for `sendMessageStream()` and `resubscribeTask()`.
+  - Kept older methods available as deprecated compatibility methods, including `getCard()` and `sendStreamingMessage()`.
+
+### Patch Changes
+
+- Fixed Studio observability tabs so runtime-injected observability unlocks them. ([#15821](https://github.com/mastra-ai/mastra/pull/15821))
+
+- Updated dependencies [[`c1ae974`](https://github.com/mastra-ai/mastra/commit/c1ae97491f6e57378ce880c3a397778c42adcdf1), [`13b4d7c`](https://github.com/mastra-ai/mastra/commit/13b4d7c16de34dff9095d1cd80f22f544b6cfe75), [`5a4b1ee`](https://github.com/mastra-ai/mastra/commit/5a4b1ee80212969621228104995589c0fa59e575), [`5a4b1ee`](https://github.com/mastra-ai/mastra/commit/5a4b1ee80212969621228104995589c0fa59e575), [`5a4b1ee`](https://github.com/mastra-ai/mastra/commit/5a4b1ee80212969621228104995589c0fa59e575), [`6c8c6c7`](https://github.com/mastra-ai/mastra/commit/6c8c6c71518394321a4692614aa4b11f3bb0a343), [`5a4b1ee`](https://github.com/mastra-ai/mastra/commit/5a4b1ee80212969621228104995589c0fa59e575), [`ec4cb26`](https://github.com/mastra-ai/mastra/commit/ec4cb26919972eb2031fea510f8f013e1d5b7ee2)]:
+  - @mastra/core@1.29.0-alpha.6
+
 ## 1.15.0-alpha.5
 
 ### Patch Changes

package/dist/_types/@internal_ai-sdk-v5/dist/index.d.ts

@@ -1671,16 +1671,16 @@ declare interface EventSourceMessage {
      * implementation in that browsers will default this to `message`, whereas this parser will
      * leave this as `undefined` if not explicitly declared.
      */
-    event?: string | undefined;
+    event?: string | undefined
     /**
      * ID of the message, if any was provided by the server. Can be used by clients to keep the
      * last received message ID in sync when reconnecting.
      */
-    id?: string | undefined;
+    id?: string | undefined
     /**
      * The data received for this message
      */
-    data: string;
+    data: string
 }
 
 /**
@@ -1704,11 +1704,8 @@ declare interface EventSourceMessage {
  *
  * @public
  */
-declare class EventSourceParserStream extends TransformStream<
-string,
-EventSourceMessage
-> {
-    constructor({ onError, onRetry, onComment }?: StreamOptions);
+declare class EventSourceParserStream extends TransformStream<string, EventSourceMessage> {
+    constructor({onError, onRetry, onComment}?: StreamOptions)
 }
 
 /**
@@ -8149,19 +8146,19 @@ declare interface StreamOptions {
      *
      * @defaultValue `undefined`
      */
-    onError?: ("terminate" | ((error: Error) => void)) | undefined;
+    onError?: ('terminate' | ((error: Error) => void)) | undefined
     /**
      * Callback for when a reconnection interval is sent from the server.
      *
      * @param retry - The number of milliseconds to wait before reconnecting.
      */
-    onRetry?: ((retry: number) => void) | undefined;
+    onRetry?: ((retry: number) => void) | undefined
     /**
      * Callback for when a comment is encountered in the stream.
      *
      * @param comment - The comment encountered in the stream.
      */
-    onComment?: ((comment: string) => void) | undefined;
+    onComment?: ((comment: string) => void) | undefined
 }
 
 /**

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-client-js
 description: Documentation for @mastra/client-js. Use when working with @mastra/client-js APIs, configuration, or implementation.
 metadata:
   package: "@mastra/client-js"
-  version: "1.15.0-alpha.5"
+  version: "1.15.0-alpha.6"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.15.0-alpha.5",
+  "version": "1.15.0-alpha.6",
   "package": "@mastra/client-js",
   "exports": {
     "RequestContext": {

package/dist/index.cjs

@@ -6,6 +6,7 @@ var error = require('@mastra/core/error');
 var schema = require('@mastra/schema-compat/schema');
 var requestContext = require('@mastra/core/request-context');
 var zodToJson = require('@mastra/schema-compat/zod-to-json');
+var a2a = require('@mastra/core/a2a');
 
 // src/resources/agent.ts
 function normalizeRoutePath(path) {
@@ -2628,7 +2629,120 @@ var Workflow = class extends BaseResource {
   }
 };
 
+// src/utils/process-a2a-stream.ts
+function splitNextEvent(buffer) {
+  const normalizedBuffer = buffer.replace(/\x1E/g, "\n\n");
+  const match = normalizedBuffer.match(/\r?\n\r?\n/);
+  if (!match || match.index === void 0) {
+    return { rest: normalizedBuffer };
+  }
+  const separatorLength = match[0].length;
+  return {
+    eventBlock: normalizedBuffer.slice(0, match.index),
+    rest: normalizedBuffer.slice(match.index + separatorLength)
+  };
+}
+function parseEventBlock(eventBlock) {
+  const trimmedBlock = eventBlock.trim();
+  if (!trimmedBlock) {
+    return {};
+  }
+  const lines = trimmedBlock.split(/\r?\n/);
+  const dataLines = lines.filter((line) => line.startsWith("data:")).map((line) => line.slice(5).trimStart());
+  const payload = dataLines.length > 0 ? dataLines.join("\n") : trimmedBlock;
+  if (!payload || payload === "[DONE]") {
+    return { done: true };
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(payload);
+  } catch (error) {
+    throw new Error(
+      `Failed to parse A2A stream event: ${error instanceof Error ? error.message : "unknown parse error"}`
+    );
+  }
+  if (parsed && typeof parsed === "object" && "error" in parsed && parsed.error) {
+    throw new MastraClientError(200, "OK", `A2A stream error - ${JSON.stringify(parsed.error)}`, parsed.error);
+  }
+  if (parsed && typeof parsed === "object" && "result" in parsed) {
+    return { event: parsed.result };
+  }
+  return { event: parsed };
+}
+async function* processA2AStream(stream) {
+  const reader = stream.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) {
+        buffer += decoder.decode();
+      } else {
+        buffer += decoder.decode(value, { stream: true });
+      }
+      while (true) {
+        const { eventBlock, rest } = splitNextEvent(buffer);
+        buffer = rest;
+        if (!eventBlock) {
+          break;
+        }
+        const parsedEvent = parseEventBlock(eventBlock);
+        if (parsedEvent.done) {
+          return;
+        }
+        if (parsedEvent.event) {
+          yield parsedEvent.event;
+        }
+      }
+      if (done) {
+        break;
+      }
+    }
+    if (buffer.trim()) {
+      const parsedEvent = parseEventBlock(buffer);
+      if (!parsedEvent.done && parsedEvent.event) {
+        yield parsedEvent.event;
+      }
+    }
+  } finally {
+    reader.releaseLock();
+  }
+}
+
 // src/resources/a2a.ts
+function createA2AJsonRpcError(response) {
+  const error = response.error;
+  const message = error?.message ?? "Unknown A2A JSON-RPC error";
+  return typeof error?.code === "number" ? new a2a.MastraA2AError(error.code, message, error.data) : new MastraClientError(200, "OK", `A2A JSON-RPC error - ${message}`, error);
+}
+function unwrapA2AResult(response) {
+  if ("error" in response && response.error) {
+    throw createA2AJsonRpcError(response);
+  }
+  if ("result" in response) {
+    return response.result;
+  }
+  throw new MastraClientError(200, "OK", "A2A JSON-RPC response did not include a result", response);
+}
+async function requireResponseBody(response, method) {
+  if (response.body) {
+    return response.body;
+  }
+  const headerSummary = Array.from(response.headers.entries()).map(([key, value]) => `${key}: ${value}`).join(", ");
+  let responseText = "";
+  try {
+    responseText = await response.text();
+  } catch {
+  }
+  const details = [
+    `A2A ${method} stream response did not include a body`,
+    `(status: ${response.status} ${response.statusText})`,
+    headerSummary ? `headers: ${headerSummary}` : "",
+    responseText ? `body: ${responseText}` : ""
+  ].filter(Boolean).join(" ");
+  throw new MastraClientError(response.status, response.statusText, details);
+}
 var A2A = class extends BaseResource {
   constructor(options, agentId) {
     super(options);
@@ -2636,19 +2750,41 @@ var A2A = class extends BaseResource {
   }
   agentId;
   /**
-   * Get the agent card with metadata about the agent
+   * Get the agent card with metadata about the agent.
    * @returns Promise containing the agent card information
    */
-  async getCard() {
+  async getAgentCard() {
     return this.request(`/.well-known/${this.agentId}/agent-card.json`);
   }
   /**
-   * Send a message to the agent and gets a message or task response
+   * @deprecated Use getAgentCard() instead.
+   */
+  async getCard() {
+    return this.getAgentCard();
+  }
+  /**
+   * Get the authenticated extended agent card.
+   * @returns Promise containing the authenticated extended agent card
+   */
+  async getExtendedAgentCard() {
+    const response = await this.request(`/a2a/${this.agentId}`, {
+      method: "POST",
+      body: {
+        jsonrpc: "2.0",
+        id: crypto.randomUUID(),
+        method: "agent/getAuthenticatedExtendedCard"
+      }
+    });
+    return unwrapA2AResult(response);
+  }
+  /**
+   * @deprecated Use sendMessageStream() for the streaming experience.
+   * Send a message to the agent and gets a message or task response.
    * @param params - Parameters for the task
-   * @returns Promise containing the response
+   * @returns Promise containing the JSON-RPC response envelope
    */
   async sendMessage(params) {
-    const response = await this.request(`/a2a/${this.agentId}`, {
+    return this.request(`/a2a/${this.agentId}`, {
       method: "POST",
       body: {
         jsonrpc: "2.0",
@@ -2657,15 +2793,14 @@ var A2A = class extends BaseResource {
         params
       }
     });
-    return response;
   }
   /**
-   * Sends a message to an agent to initiate/continue a task and subscribes
+   * Sends a message to an agent to initiate or continue a task and subscribes
    * the client to real-time updates for that task via Server-Sent Events (SSE).
    * @param params - Parameters for the task
-   * @returns A stream of Server-Sent Events. Each SSE `data` field contains a `SendStreamingMessageResponse`
+   * @returns An async generator of typed A2A stream events
    */
-  async sendStreamingMessage(params) {
+  async *sendMessageStream(params) {
     const response = await this.request(`/a2a/${this.agentId}`, {
       method: "POST",
       body: {
@@ -2676,15 +2811,31 @@ var A2A = class extends BaseResource {
       },
       stream: true
     });
-    return response;
+    yield* processA2AStream(await requireResponseBody(response, "message/stream"));
   }
   /**
-   * Get the status and result of a task
+   * @deprecated Use sendMessageStream() instead.
+   */
+  async sendStreamingMessage(params) {
+    return this.request(`/a2a/${this.agentId}`, {
+      method: "POST",
+      body: {
+        jsonrpc: "2.0",
+        id: crypto.randomUUID(),
+        method: "message/stream",
+        params
+      },
+      stream: true
+    });
+  }
+  /**
+   * @deprecated
+   * Get the status and result of a task.
    * @param params - Parameters for querying the task
-   * @returns Promise containing the task response
+   * @returns Promise containing the JSON-RPC response envelope
    */
   async getTask(params) {
-    const response = await this.request(`/a2a/${this.agentId}`, {
+    return this.request(`/a2a/${this.agentId}`, {
       method: "POST",
       body: {
         jsonrpc: "2.0",
@@ -2693,10 +2844,10 @@ var A2A = class extends BaseResource {
         params
       }
     });
-    return response;
   }
   /**
-   * Cancel a running task
+   * @deprecated
+   * Cancel a running task.
    * @param params - Parameters identifying the task to cancel
    * @returns Promise containing the task response
    */
@@ -2711,6 +2862,92 @@ var A2A = class extends BaseResource {
       }
     });
   }
+  /**
+   * Resume a task stream for an existing task.
+   * @param params - Parameters identifying the task to resubscribe to
+   * @returns An async generator of typed A2A stream events
+   */
+  async *resubscribeTask(params) {
+    const response = await this.request(`/a2a/${this.agentId}`, {
+      method: "POST",
+      body: {
+        jsonrpc: "2.0",
+        id: crypto.randomUUID(),
+        method: "tasks/resubscribe",
+        params
+      },
+      stream: true
+    });
+    yield* processA2AStream(await requireResponseBody(response, "tasks/resubscribe"));
+  }
+  /**
+   * Set push notification config for a task.
+   * @param params - Push notification configuration for the task
+   * @returns Promise containing the push notification configuration
+   */
+  async setTaskPushNotificationConfig(params) {
+    const response = await this.request(`/a2a/${this.agentId}`, {
+      method: "POST",
+      body: {
+        jsonrpc: "2.0",
+        id: crypto.randomUUID(),
+        method: "tasks/pushNotificationConfig/set",
+        params
+      }
+    });
+    return unwrapA2AResult(response);
+  }
+  /**
+   * Get push notification config for a task.
+   * @param params - Parameters identifying the task
+   * @returns Promise containing the push notification configuration
+   */
+  async getTaskPushNotificationConfig(params) {
+    const response = await this.request(`/a2a/${this.agentId}`, {
+      method: "POST",
+      body: {
+        jsonrpc: "2.0",
+        id: crypto.randomUUID(),
+        method: "tasks/pushNotificationConfig/get",
+        params
+      }
+    });
+    return unwrapA2AResult(response);
+  }
+  /**
+   * List push notification configs for a task.
+   * @param params - Parameters identifying the task
+   * @returns Promise containing the push notification configurations
+   */
+  async listTaskPushNotificationConfig(params) {
+    const response = await this.request(`/a2a/${this.agentId}`, {
+      method: "POST",
+      body: {
+        jsonrpc: "2.0",
+        id: crypto.randomUUID(),
+        method: "tasks/pushNotificationConfig/list",
+        params
+      }
+    });
+    return unwrapA2AResult(response);
+  }
+  /**
+   * Delete a push notification config for a task.
+   * @param params - Parameters identifying the config to delete
+   * @returns Promise that resolves when the config is deleted
+   */
+  async deleteTaskPushNotificationConfig(params) {
+    const response = await this.request(`/a2a/${this.agentId}`, {
+      method: "POST",
+      body: {
+        jsonrpc: "2.0",
+        id: crypto.randomUUID(),
+        method: "tasks/pushNotificationConfig/delete",
+        params
+      }
+    });
+    unwrapA2AResult(response);
+  }
 };
 
 // src/resources/mcp-tool.ts