@mastra/client-js 1.47.0-alpha.1 → 1.47.0-alpha.3

package/dist/docs/references/docs-connections-a2a.md

@@ -67,7 +67,7 @@ Mastra supports A2A Protocol v0.3 and v1.0 on the same agent card and execution
 - `1.0`: Uses the v1.0 API.
 - Any other value: Returns a `VersionNotSupported` protocol error.
 
-Existing `A2AAgent` and `MastraClient.getA2A()` integrations continue to use v0.3. Use `MastraClient.getA2AV1()` for v1.0 requests. The v1 client sends `A2A-Version: 1.0` automatically and adds the `tasks/list` operation.
+`A2AAgent` and `MastraClient.getA2A()` use v0.3 by default. Set `protocolVersion: '1.0'` on `A2AAgent` for v1.0 subagent delegation, or use `MastraClient.getA2AV1()` for direct v1.0 requests. Both v1.0 clients send `A2A-Version: 1.0` automatically. The direct v1.0 client also adds the `tasks/list` operation.
 
 Import v1.0 protocol types and codecs from `@mastra/core/a2a/v1`. The existing `@mastra/core/a2a/client` export remains on v0.3.
 
@@ -82,7 +82,7 @@ Use `A2AAgent` when another Mastra agent should delegate work to a remote agent.
 
 ## Consume A2A agents as subagents
 
-Use `A2AAgent` to wrap a remote A2A agent, then add it to a parent agent with the [supervisor agents](https://mastra.ai/docs/subagents) pattern. Pass an explicit agent card URL when the remote server hosts multiple agents or uses a custom well-known path.
+Use `A2AAgent` to wrap a remote A2A agent, then add it to a parent agent with the [supervisor agents](https://mastra.ai/docs/subagents) pattern. Pass an explicit agent card URL when the remote server hosts multiple agents or uses a custom well-known path. Set `protocolVersion: '1.0'` when the remote agent requires A2A v1.0. Omit it to use v0.3.
 
 ```typescript
 import { Agent } from '@mastra/core/agent'
@@ -90,6 +90,7 @@ import { A2AAgent } from '@mastra/core/a2a'
 
 const remoteWeatherAgent = new A2AAgent({
   url: 'https://weather.example.com/api/.well-known/weather-agent/agent-card.json',
+  protocolVersion: '1.0',
   headers: {
     Authorization: `Bearer ${process.env.WEATHER_AGENT_TOKEN}`,
   },
@@ -112,7 +113,7 @@ During execution, `A2AAgent`:
 
 - Fetches and caches the remote agent card.
 - Reads the execution URL and capabilities from the card.
-- Calls `message/send` for non-streaming runs or `message/stream` when streaming is supported.
+- Calls `message/send` or `message/stream` with v0.3, and `SendMessage` or `SendStreamingMessage` with v1.0.
 - Converts remote messages, tasks, artifacts, and status updates into Mastra subagent results.
 - Supports `resumeGenerate()` and `resumeStream()` when the remote task requires follow-up input or resubscription.
 

package/dist/docs/references/reference-client-js-mastra-client.md

@@ -81,7 +81,7 @@ You can also pass `requestContext` as a `Record<string, any>`.
 
 **getWorkflow(workflowId)** (`Workflow`): Retrieves a specific workflow instance by ID.
 
-**getAgentBuilderActions()** (`Promise<Record<string, WorkflowInfo>>`): Returns all available Agent Builder actions. See Agent Builder API.
+**getAgentBuilderActions()** (`Promise<GetAgentBuilderActionsResponse>`): Returns all available Agent Builder actions. See Agent Builder API.
 
 **getAgentBuilderAction(actionId)** (`AgentBuilder`): Retrieves an Agent Builder action by ID. See Agent Builder API.
 

package/dist/index.cjs

@@ -919,6 +919,11 @@ var Agent = class extends BaseResource {
 	* depending on the toolset's scope).
 	*
 	* @param threadId - Optional thread ID for thread-scoped browser sessions
+	*
+	* @remarks This is a browser-stream adapter compatibility endpoint, not a
+	* `SERVER_ROUTES` route. Its historical deployer implementation returns
+	* `{ success: true }`; no generated contract exists while the adapter owns it.
+	* The public `boolean` result remains broad for backwards compatibility.
 	*/
 	closeBrowser(threadId) {
 		return this.request(`/agents/${this.agentId}/browser/close`, {
@@ -3235,7 +3240,7 @@ var Run = class extends BaseResource {
 				resourceId: params.resourceId,
 				perStep: params.perStep
 			}
-		}).then(deserializeWorkflowError);
+		}).then((result) => deserializeWorkflowError(result));
 	}
 	/**
 	* Starts a workflow run and returns a stream
@@ -3317,7 +3322,7 @@ var Run = class extends BaseResource {
 				perStep: params.perStep,
 				forEachIndex: params.forEachIndex
 			}
-		}).then(deserializeWorkflowError);
+		}).then((result) => deserializeWorkflowError(result));
 	}
 	/**
 	* Resumes a suspended workflow step without waiting for the workflow to complete (fire-and-forget)
@@ -3401,7 +3406,7 @@ var Run = class extends BaseResource {
 				requestContext,
 				tracingOptions: params?.tracingOptions
 			}
-		}).then(deserializeWorkflowError);
+		}).then((result) => deserializeWorkflowError(result));
 	}
 	/**
 	* Time travels a workflow run synchronously without waiting for the workflow to complete
@@ -3431,7 +3436,7 @@ var Run = class extends BaseResource {
 				...params,
 				requestContext
 			}
-		}).then(deserializeWorkflowError);
+		}).then((result) => deserializeWorkflowError(result));
 	}
 	/**
 	* Time travels a workflow run and returns a stream
@@ -4017,13 +4022,14 @@ var MCPTool = class extends BaseResource {
 	/**
 	* Executes this specific tool on the MCP server.
 	* @param params - Parameters for tool execution, including data/args and optional requestContext.
-	* @returns Promise containing the result of the tool execution.
+	* On a 2026-07-28 server a tool can answer `{ status: 'suspended', suspendPayload, resumeSchema }`;
+	* call again with the same `data` plus `resumeData` (matching `resumeSchema`) and the echoed
+	* `suspendPayload` to continue it.
+	* @returns Promise containing `{ result }`, or the suspended shape described above.
 	*/
 	execute(params) {
-		const body = {};
-		if (params.data !== void 0) body.data = params.data;
-		if (params.requestContext !== void 0) body.requestContext = params.requestContext;
-		return this.request(`/mcp/${encodeURIComponent(this.serverId)}/tools/${encodeURIComponent(this.toolId)}/execute`, {
+		const { requestContext, ...body } = params;
+		return this.request(`/mcp/${encodeURIComponent(this.serverId)}/tools/${encodeURIComponent(this.toolId)}/execute${requestContextQueryString(requestContext)}`, {
 			method: "POST",
 			body
 		});
@@ -4041,23 +4047,29 @@ var AgentBuilder = class extends BaseResource {
 		this.actionId = actionId;
 	}
 	transformWorkflowResult(result) {
-		if (result.status === "success") return {
-			success: result.result.success || false,
-			applied: result.result.applied || false,
-			branchName: result.result.branchName,
-			message: result.result.message || "Agent builder action completed",
-			validationResults: result.result.validationResults,
-			error: result.result.error,
-			errors: result.result.errors,
-			stepResults: result.result.stepResults
-		};
-		else if (result.status === "failed") return {
-			success: false,
-			applied: false,
-			message: `Agent builder action failed: ${result.error.message}`,
-			error: result.error.message
-		};
-		else return {
+		if (result.status === "success") {
+			const actionResult = result.result;
+			return {
+				success: actionResult?.success ?? false,
+				applied: actionResult?.applied ?? false,
+				branchName: actionResult?.branchName,
+				message: actionResult?.message ?? "Agent builder action completed",
+				validationResults: actionResult?.validationResults,
+				error: actionResult?.error,
+				errors: actionResult?.errors,
+				stepResults: actionResult?.stepResults
+			};
+		}
+		if (result.status === "failed") {
+			const message = result.error?.message ?? "Agent builder action failed";
+			return {
+				success: false,
+				applied: false,
+				message: `Agent builder action failed: ${message}`,
+				error: message
+			};
+		}
+		return {
 			success: false,
 			applied: false,
 			message: "Agent builder action was suspended",
@@ -4253,7 +4265,7 @@ var AgentBuilder = class extends BaseResource {
 	* This calls `/agent-builder/:actionId`.
 	*/
 	async details() {
-		return await this.request(`/agent-builder/${this.actionId}`);
+		return this.request(`/agent-builder/${this.actionId}`);
 	}
 	/**
 	* Gets all runs for this agent builder action.
@@ -4482,7 +4494,7 @@ var Observability = class extends BaseResource {
 	deleteTraces(params) {
 		return this.request(`/observability/traces/delete`, {
 			method: "POST",
-			body: { traceIds: params.traceIds }
+			body: params
 		});
 	}
 	/**