@mastra/client-js 0.1.21 → 0.1.22-alpha.1

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @mastra/client-js@0.1.21-alpha.1 build /home/runner/work/mastra/mastra/client-sdks/client-js
+> @mastra/client-js@0.1.22-alpha.1 build /home/runner/work/mastra/mastra/client-sdks/client-js
 > tsup src/index.ts --format esm,cjs --dts --clean --treeshake=smallest --splitting
 
 CLI Building entry: src/index.ts
@@ -9,11 +9,11 @@
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-CJS dist/index.cjs 35.18 KB
-CJS ⚡️ Build success in 1096ms
-ESM dist/index.js 34.95 KB
-ESM ⚡️ Build success in 1096ms
 DTS Build start
-DTS ⚡️ Build success in 13790ms
-DTS dist/index.d.ts  25.12 KB
-DTS dist/index.d.cts 25.12 KB
+CJS dist/index.cjs 38.24 KB
+CJS ⚡️ Build success in 1623ms
+ESM dist/index.js 38.02 KB
+ESM ⚡️ Build success in 1628ms
+DTS ⚡️ Build success in 14543ms
+DTS dist/index.d.ts  27.18 KB
+DTS dist/index.d.cts 27.18 KB

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @mastra/client-js
 
+## 0.1.22-alpha.1
+
+### Patch Changes
+
+- Updated dependencies [ab80e7e]
+- Updated dependencies [6fa1ad1]
+- Updated dependencies [c28d7a0]
+- Updated dependencies [edf1e88]
+  - @mastra/core@0.9.4-alpha.1
+
+## 0.1.22-alpha.0
+
+### Patch Changes
+
+- cb1f698: Set runtimeContext from playground for agents, tools, workflows
+- 0b8b868: Added A2A support + streaming
+- Updated dependencies [daf942f]
+- Updated dependencies [0b8b868]
+  - @mastra/core@0.9.4-alpha.0
+
 ## 0.1.21
 
 ### Patch Changes

package/dist/index.cjs

@@ -355,6 +355,22 @@ var Agent = class extends BaseResource {
   getTool(toolId) {
     return this.request(`/api/agents/${this.agentId}/tools/${toolId}`);
   }
+  /**
+   * Executes a tool for the agent
+   * @param toolId - ID of the tool to execute
+   * @param params - Parameters required for tool execution
+   * @returns Promise containing the tool execution results
+   */
+  executeTool(toolId, params) {
+    const body = {
+      data: params.data,
+      runtimeContext: params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : void 0
+    };
+    return this.request(`/api/agents/${this.agentId}/tools/${toolId}/execute`, {
+      method: "POST",
+      body
+    });
+  }
   /**
    * Retrieves evaluation results for the agent
    * @returns Promise containing agent evaluations
@@ -752,14 +768,16 @@ var Tool = class extends BaseResource {
     if (params.runId) {
       url.set("runId", params.runId);
     }
+    const body = {
+      data: params.data,
+      runtimeContext: params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : void 0
+    };
     return this.request(`/api/tools/${this.toolId}/execute?${url.toString()}`, {
       method: "POST",
-      body: params.data
+      body
     });
   }
 };
-
-// src/resources/vnext-workflow.ts
 var RECORD_SEPARATOR2 = "";
 var VNextWorkflow = class extends BaseResource {
   constructor(options, workflowId) {
@@ -866,9 +884,10 @@ var VNextWorkflow = class extends BaseResource {
    * @returns Promise containing success message
    */
   start(params) {
+    const runtimeContext = params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : void 0;
     return this.request(`/api/workflows/v-next/${this.workflowId}/start?runId=${params.runId}`, {
       method: "POST",
-      body: { inputData: params?.inputData, runtimeContext: params.runtimeContext }
+      body: { inputData: params?.inputData, runtimeContext }
     });
   }
   /**
@@ -880,8 +899,9 @@ var VNextWorkflow = class extends BaseResource {
     step,
     runId,
     resumeData,
-    runtimeContext
+    ...rest
   }) {
+    const runtimeContext = rest.runtimeContext ? Object.fromEntries(rest.runtimeContext.entries()) : void 0;
     return this.request(`/api/workflows/v-next/${this.workflowId}/resume?runId=${runId}`, {
       method: "POST",
       stream: true,
@@ -902,9 +922,10 @@ var VNextWorkflow = class extends BaseResource {
     if (!!params?.runId) {
       searchParams.set("runId", params.runId);
     }
+    const runtimeContext = params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : void 0;
     return this.request(`/api/workflows/v-next/${this.workflowId}/start-async?${searchParams.toString()}`, {
       method: "POST",
-      body: { inputData: params.inputData, runtimeContext: params.runtimeContext }
+      body: { inputData: params.inputData, runtimeContext }
     });
   }
   /**
@@ -913,12 +934,13 @@ var VNextWorkflow = class extends BaseResource {
    * @returns Promise containing the vNext workflow resume results
    */
   resumeAsync(params) {
+    const runtimeContext = params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : void 0;
     return this.request(`/api/workflows/v-next/${this.workflowId}/resume-async?runId=${params.runId}`, {
       method: "POST",
       body: {
         step: params.step,
         resumeData: params.resumeData,
-        runtimeContext: params.runtimeContext
+        runtimeContext
       }
     });
   }
@@ -943,6 +965,80 @@ var VNextWorkflow = class extends BaseResource {
   }
 };
 
+// src/resources/a2a.ts
+var A2A = class extends BaseResource {
+  constructor(options, agentId) {
+    super(options);
+    this.agentId = agentId;
+  }
+  /**
+   * Get the agent card with metadata about the agent
+   * @returns Promise containing the agent card information
+   */
+  async getCard() {
+    return this.request(`/.well-known/${this.agentId}/agent.json`);
+  }
+  /**
+   * Send a message to the agent and get a response
+   * @param params - Parameters for the task
+   * @returns Promise containing the task response
+   */
+  async sendMessage(params) {
+    const response = await this.request(`/a2a/${this.agentId}`, {
+      method: "POST",
+      body: {
+        method: "tasks/send",
+        params
+      }
+    });
+    return { task: response.result };
+  }
+  /**
+   * Get the status and result of a task
+   * @param params - Parameters for querying the task
+   * @returns Promise containing the task response
+   */
+  async getTask(params) {
+    const response = await this.request(`/a2a/${this.agentId}`, {
+      method: "POST",
+      body: {
+        method: "tasks/get",
+        params
+      }
+    });
+    return response.result;
+  }
+  /**
+   * Cancel a running task
+   * @param params - Parameters identifying the task to cancel
+   * @returns Promise containing the task response
+   */
+  async cancelTask(params) {
+    return this.request(`/a2a/${this.agentId}`, {
+      method: "POST",
+      body: {
+        method: "tasks/cancel",
+        params
+      }
+    });
+  }
+  /**
+   * Send a message and subscribe to streaming updates (not fully implemented)
+   * @param params - Parameters for the task
+   * @returns Promise containing the task response
+   */
+  async sendAndSubscribe(params) {
+    return this.request(`/a2a/${this.agentId}`, {
+      method: "POST",
+      body: {
+        method: "tasks/sendSubscribe",
+        params
+      },
+      stream: true
+    });
+  }
+};
+
 // src/client.ts
 var MastraClient = class extends BaseResource {
   constructor(options) {
@@ -1153,6 +1249,14 @@ var MastraClient = class extends BaseResource {
   getNetwork(networkId) {
     return new Network(this.options, networkId);
   }
+  /**
+   * Gets an A2A client for interacting with an agent via the A2A protocol
+   * @param agentId - ID of the agent to interact with
+   * @returns A2A client instance
+   */
+  getA2A(agentId) {
+    return new A2A(this.options, agentId);
+  }
 };
 
 exports.MastraClient = MastraClient;

package/dist/index.d.cts

@@ -5,7 +5,9 @@ import { JSONSchema7 } from 'json-schema';
 import { ZodSchema } from 'zod';
 import { AgentGenerateOptions, AgentStreamOptions } from '@mastra/core/agent';
 import { NewWorkflow, WorkflowResult, WatchEvent } from '@mastra/core/workflows/vNext';
-import { RuntimeContext } from '@mastra/core/runtime-context';
+import { RuntimeContext } from '@mastra/core/di';
+import { RuntimeContext as RuntimeContext$1 } from '@mastra/core/runtime-context';
+import { AgentCard, TaskSendParams, Task, TaskQueryParams, TaskIdParams } from '@mastra/core/a2a';
 
 interface ClientOptions {
     /** Base URL for API requests */
@@ -293,6 +295,16 @@ declare class Agent extends BaseResource {
      * @returns Promise containing tool details
      */
     getTool(toolId: string): Promise<GetToolResponse>;
+    /**
+     * Executes a tool for the agent
+     * @param toolId - ID of the tool to execute
+     * @param params - Parameters required for tool execution
+     * @returns Promise containing the tool execution results
+     */
+    executeTool(toolId: string, params: {
+        data: any;
+        runtimeContext?: RuntimeContext;
+    }): Promise<any>;
     /**
      * Retrieves evaluation results for the agent
      * @returns Promise containing agent evaluations
@@ -512,6 +524,7 @@ declare class Tool extends BaseResource {
     execute(params: {
         data: any;
         runId?: string;
+        runtimeContext?: RuntimeContext;
     }): Promise<any>;
 }
 
@@ -555,7 +568,7 @@ declare class VNextWorkflow extends BaseResource {
     start(params: {
         runId: string;
         inputData: Record<string, any>;
-        runtimeContext?: RuntimeContext;
+        runtimeContext?: RuntimeContext$1;
     }): Promise<{
         message: string;
     }>;
@@ -564,11 +577,11 @@ declare class VNextWorkflow extends BaseResource {
      * @param params - Object containing the runId, step, resumeData and runtimeContext
      * @returns Promise containing success message
      */
-    resume({ step, runId, resumeData, runtimeContext, }: {
+    resume({ step, runId, resumeData, ...rest }: {
         step: string | string[];
         runId: string;
         resumeData?: Record<string, any>;
-        runtimeContext?: RuntimeContext;
+        runtimeContext?: RuntimeContext$1;
     }): Promise<{
         message: string;
     }>;
@@ -580,7 +593,7 @@ declare class VNextWorkflow extends BaseResource {
     startAsync(params: {
         runId?: string;
         inputData: Record<string, any>;
-        runtimeContext?: RuntimeContext;
+        runtimeContext?: RuntimeContext$1;
     }): Promise<VNextWorkflowRunResult>;
     /**
      * Resumes a suspended vNext workflow step asynchronously and returns a promise that resolves when the vNext workflow is complete
@@ -591,7 +604,7 @@ declare class VNextWorkflow extends BaseResource {
         runId: string;
         step: string | string[];
         resumeData?: Record<string, any>;
-        runtimeContext?: RuntimeContext;
+        runtimeContext?: RuntimeContext$1;
     }): Promise<VNextWorkflowRunResult>;
     /**
      * Watches vNext workflow transitions in real-time
@@ -603,6 +616,47 @@ declare class VNextWorkflow extends BaseResource {
     }, onRecord: (record: VNextWorkflowWatchResult) => void): Promise<void>;
 }
 
+/**
+ * Class for interacting with an agent via the A2A protocol
+ */
+declare class A2A extends BaseResource {
+    private agentId;
+    constructor(options: ClientOptions, agentId: string);
+    /**
+     * Get the agent card with metadata about the agent
+     * @returns Promise containing the agent card information
+     */
+    getCard(): Promise<AgentCard>;
+    /**
+     * Send a message to the agent and get a response
+     * @param params - Parameters for the task
+     * @returns Promise containing the task response
+     */
+    sendMessage(params: TaskSendParams): Promise<{
+        task: Task;
+    }>;
+    /**
+     * Get the status and result of a task
+     * @param params - Parameters for querying the task
+     * @returns Promise containing the task response
+     */
+    getTask(params: TaskQueryParams): Promise<Task>;
+    /**
+     * Cancel a running task
+     * @param params - Parameters identifying the task to cancel
+     * @returns Promise containing the task response
+     */
+    cancelTask(params: TaskIdParams): Promise<{
+        task: Task;
+    }>;
+    /**
+     * Send a message and subscribe to streaming updates (not fully implemented)
+     * @param params - Parameters for the task
+     * @returns Promise containing the task response
+     */
+    sendAndSubscribe(params: TaskSendParams): Promise<Response>;
+}
+
 declare class MastraClient extends BaseResource {
     constructor(options: ClientOptions);
     /**
@@ -725,6 +779,12 @@ declare class MastraClient extends BaseResource {
      * @returns Network instance
      */
     getNetwork(networkId: string): Network;
+    /**
+     * Gets an A2A client for interacting with an agent via the A2A protocol
+     * @param agentId - ID of the agent to interact with
+     * @returns A2A client instance
+     */
+    getA2A(agentId: string): A2A;
 }
 
 export { type ClientOptions, type CreateIndexParams, type CreateMemoryThreadParams, type CreateMemoryThreadResponse, type GenerateParams, type GetAgentResponse, type GetEvalsByAgentIdResponse, type GetLogParams, type GetLogsParams, type GetLogsResponse, type GetMemoryThreadMessagesResponse, type GetMemoryThreadParams, type GetMemoryThreadResponse, type GetNetworkResponse, type GetTelemetryParams, type GetTelemetryResponse, type GetToolResponse, type GetVNextWorkflowResponse, type GetVectorIndexResponse, type GetWorkflowResponse, type GetWorkflowRunsParams, type GetWorkflowRunsResponse, MastraClient, type QueryVectorParams, type QueryVectorResponse, type RequestFunction, type RequestOptions, type SaveMessageToMemoryParams, type SaveMessageToMemoryResponse, type StreamParams, type UpdateMemoryThreadParams, type UpsertVectorParams, type VNextWorkflowRunResult, type VNextWorkflowWatchResult, type WorkflowRunResult };

package/dist/index.d.ts

@@ -5,7 +5,9 @@ import { JSONSchema7 } from 'json-schema';
 import { ZodSchema } from 'zod';
 import { AgentGenerateOptions, AgentStreamOptions } from '@mastra/core/agent';
 import { NewWorkflow, WorkflowResult, WatchEvent } from '@mastra/core/workflows/vNext';
-import { RuntimeContext } from '@mastra/core/runtime-context';
+import { RuntimeContext } from '@mastra/core/di';
+import { RuntimeContext as RuntimeContext$1 } from '@mastra/core/runtime-context';
+import { AgentCard, TaskSendParams, Task, TaskQueryParams, TaskIdParams } from '@mastra/core/a2a';
 
 interface ClientOptions {
     /** Base URL for API requests */
@@ -293,6 +295,16 @@ declare class Agent extends BaseResource {
      * @returns Promise containing tool details
      */
     getTool(toolId: string): Promise<GetToolResponse>;
+    /**
+     * Executes a tool for the agent
+     * @param toolId - ID of the tool to execute
+     * @param params - Parameters required for tool execution
+     * @returns Promise containing the tool execution results
+     */
+    executeTool(toolId: string, params: {
+        data: any;
+        runtimeContext?: RuntimeContext;
+    }): Promise<any>;
     /**
      * Retrieves evaluation results for the agent
      * @returns Promise containing agent evaluations
@@ -512,6 +524,7 @@ declare class Tool extends BaseResource {
     execute(params: {
         data: any;
         runId?: string;
+        runtimeContext?: RuntimeContext;
     }): Promise<any>;
 }
 
@@ -555,7 +568,7 @@ declare class VNextWorkflow extends BaseResource {
     start(params: {
         runId: string;
         inputData: Record<string, any>;
-        runtimeContext?: RuntimeContext;
+        runtimeContext?: RuntimeContext$1;
     }): Promise<{
         message: string;
     }>;
@@ -564,11 +577,11 @@ declare class VNextWorkflow extends BaseResource {
      * @param params - Object containing the runId, step, resumeData and runtimeContext
      * @returns Promise containing success message
      */
-    resume({ step, runId, resumeData, runtimeContext, }: {
+    resume({ step, runId, resumeData, ...rest }: {
         step: string | string[];
         runId: string;
         resumeData?: Record<string, any>;
-        runtimeContext?: RuntimeContext;
+        runtimeContext?: RuntimeContext$1;
     }): Promise<{
         message: string;
     }>;
@@ -580,7 +593,7 @@ declare class VNextWorkflow extends BaseResource {
     startAsync(params: {
         runId?: string;
         inputData: Record<string, any>;
-        runtimeContext?: RuntimeContext;
+        runtimeContext?: RuntimeContext$1;
     }): Promise<VNextWorkflowRunResult>;
     /**
      * Resumes a suspended vNext workflow step asynchronously and returns a promise that resolves when the vNext workflow is complete
@@ -591,7 +604,7 @@ declare class VNextWorkflow extends BaseResource {
         runId: string;
         step: string | string[];
         resumeData?: Record<string, any>;
-        runtimeContext?: RuntimeContext;
+        runtimeContext?: RuntimeContext$1;
     }): Promise<VNextWorkflowRunResult>;
     /**
      * Watches vNext workflow transitions in real-time
@@ -603,6 +616,47 @@ declare class VNextWorkflow extends BaseResource {
     }, onRecord: (record: VNextWorkflowWatchResult) => void): Promise<void>;
 }
 
+/**
+ * Class for interacting with an agent via the A2A protocol
+ */
+declare class A2A extends BaseResource {
+    private agentId;
+    constructor(options: ClientOptions, agentId: string);
+    /**
+     * Get the agent card with metadata about the agent
+     * @returns Promise containing the agent card information
+     */
+    getCard(): Promise<AgentCard>;
+    /**
+     * Send a message to the agent and get a response
+     * @param params - Parameters for the task
+     * @returns Promise containing the task response
+     */
+    sendMessage(params: TaskSendParams): Promise<{
+        task: Task;
+    }>;
+    /**
+     * Get the status and result of a task
+     * @param params - Parameters for querying the task
+     * @returns Promise containing the task response
+     */
+    getTask(params: TaskQueryParams): Promise<Task>;
+    /**
+     * Cancel a running task
+     * @param params - Parameters identifying the task to cancel
+     * @returns Promise containing the task response
+     */
+    cancelTask(params: TaskIdParams): Promise<{
+        task: Task;
+    }>;
+    /**
+     * Send a message and subscribe to streaming updates (not fully implemented)
+     * @param params - Parameters for the task
+     * @returns Promise containing the task response
+     */
+    sendAndSubscribe(params: TaskSendParams): Promise<Response>;
+}
+
 declare class MastraClient extends BaseResource {
     constructor(options: ClientOptions);
     /**
@@ -725,6 +779,12 @@ declare class MastraClient extends BaseResource {
      * @returns Network instance
      */
     getNetwork(networkId: string): Network;
+    /**
+     * Gets an A2A client for interacting with an agent via the A2A protocol
+     * @param agentId - ID of the agent to interact with
+     * @returns A2A client instance
+     */
+    getA2A(agentId: string): A2A;
 }
 
 export { type ClientOptions, type CreateIndexParams, type CreateMemoryThreadParams, type CreateMemoryThreadResponse, type GenerateParams, type GetAgentResponse, type GetEvalsByAgentIdResponse, type GetLogParams, type GetLogsParams, type GetLogsResponse, type GetMemoryThreadMessagesResponse, type GetMemoryThreadParams, type GetMemoryThreadResponse, type GetNetworkResponse, type GetTelemetryParams, type GetTelemetryResponse, type GetToolResponse, type GetVNextWorkflowResponse, type GetVectorIndexResponse, type GetWorkflowResponse, type GetWorkflowRunsParams, type GetWorkflowRunsResponse, MastraClient, type QueryVectorParams, type QueryVectorResponse, type RequestFunction, type RequestOptions, type SaveMessageToMemoryParams, type SaveMessageToMemoryResponse, type StreamParams, type UpdateMemoryThreadParams, type UpsertVectorParams, type VNextWorkflowRunResult, type VNextWorkflowWatchResult, type WorkflowRunResult };

package/dist/index.js

@@ -353,6 +353,22 @@ var Agent = class extends BaseResource {
   getTool(toolId) {
     return this.request(`/api/agents/${this.agentId}/tools/${toolId}`);
   }
+  /**
+   * Executes a tool for the agent
+   * @param toolId - ID of the tool to execute
+   * @param params - Parameters required for tool execution
+   * @returns Promise containing the tool execution results
+   */
+  executeTool(toolId, params) {
+    const body = {
+      data: params.data,
+      runtimeContext: params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : void 0
+    };
+    return this.request(`/api/agents/${this.agentId}/tools/${toolId}/execute`, {
+      method: "POST",
+      body
+    });
+  }
   /**
    * Retrieves evaluation results for the agent
    * @returns Promise containing agent evaluations
@@ -750,14 +766,16 @@ var Tool = class extends BaseResource {
     if (params.runId) {
       url.set("runId", params.runId);
     }
+    const body = {
+      data: params.data,
+      runtimeContext: params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : void 0
+    };
     return this.request(`/api/tools/${this.toolId}/execute?${url.toString()}`, {
       method: "POST",
-      body: params.data
+      body
     });
   }
 };
-
-// src/resources/vnext-workflow.ts
 var RECORD_SEPARATOR2 = "";
 var VNextWorkflow = class extends BaseResource {
   constructor(options, workflowId) {
@@ -864,9 +882,10 @@ var VNextWorkflow = class extends BaseResource {
    * @returns Promise containing success message
    */
   start(params) {
+    const runtimeContext = params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : void 0;
     return this.request(`/api/workflows/v-next/${this.workflowId}/start?runId=${params.runId}`, {
       method: "POST",
-      body: { inputData: params?.inputData, runtimeContext: params.runtimeContext }
+      body: { inputData: params?.inputData, runtimeContext }
     });
   }
   /**
@@ -878,8 +897,9 @@ var VNextWorkflow = class extends BaseResource {
     step,
     runId,
     resumeData,
-    runtimeContext
+    ...rest
   }) {
+    const runtimeContext = rest.runtimeContext ? Object.fromEntries(rest.runtimeContext.entries()) : void 0;
     return this.request(`/api/workflows/v-next/${this.workflowId}/resume?runId=${runId}`, {
       method: "POST",
       stream: true,
@@ -900,9 +920,10 @@ var VNextWorkflow = class extends BaseResource {
     if (!!params?.runId) {
       searchParams.set("runId", params.runId);
     }
+    const runtimeContext = params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : void 0;
     return this.request(`/api/workflows/v-next/${this.workflowId}/start-async?${searchParams.toString()}`, {
       method: "POST",
-      body: { inputData: params.inputData, runtimeContext: params.runtimeContext }
+      body: { inputData: params.inputData, runtimeContext }
     });
   }
   /**
@@ -911,12 +932,13 @@ var VNextWorkflow = class extends BaseResource {
    * @returns Promise containing the vNext workflow resume results
    */
   resumeAsync(params) {
+    const runtimeContext = params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : void 0;
     return this.request(`/api/workflows/v-next/${this.workflowId}/resume-async?runId=${params.runId}`, {
       method: "POST",
       body: {
         step: params.step,
         resumeData: params.resumeData,
-        runtimeContext: params.runtimeContext
+        runtimeContext
       }
     });
   }
@@ -941,6 +963,80 @@ var VNextWorkflow = class extends BaseResource {
   }
 };
 
+// src/resources/a2a.ts
+var A2A = class extends BaseResource {
+  constructor(options, agentId) {
+    super(options);
+    this.agentId = agentId;
+  }
+  /**
+   * Get the agent card with metadata about the agent
+   * @returns Promise containing the agent card information
+   */
+  async getCard() {
+    return this.request(`/.well-known/${this.agentId}/agent.json`);
+  }
+  /**
+   * Send a message to the agent and get a response
+   * @param params - Parameters for the task
+   * @returns Promise containing the task response
+   */
+  async sendMessage(params) {
+    const response = await this.request(`/a2a/${this.agentId}`, {
+      method: "POST",
+      body: {
+        method: "tasks/send",
+        params
+      }
+    });
+    return { task: response.result };
+  }
+  /**
+   * Get the status and result of a task
+   * @param params - Parameters for querying the task
+   * @returns Promise containing the task response
+   */
+  async getTask(params) {
+    const response = await this.request(`/a2a/${this.agentId}`, {
+      method: "POST",
+      body: {
+        method: "tasks/get",
+        params
+      }
+    });
+    return response.result;
+  }
+  /**
+   * Cancel a running task
+   * @param params - Parameters identifying the task to cancel
+   * @returns Promise containing the task response
+   */
+  async cancelTask(params) {
+    return this.request(`/a2a/${this.agentId}`, {
+      method: "POST",
+      body: {
+        method: "tasks/cancel",
+        params
+      }
+    });
+  }
+  /**
+   * Send a message and subscribe to streaming updates (not fully implemented)
+   * @param params - Parameters for the task
+   * @returns Promise containing the task response
+   */
+  async sendAndSubscribe(params) {
+    return this.request(`/a2a/${this.agentId}`, {
+      method: "POST",
+      body: {
+        method: "tasks/sendSubscribe",
+        params
+      },
+      stream: true
+    });
+  }
+};
+
 // src/client.ts
 var MastraClient = class extends BaseResource {
   constructor(options) {
@@ -1151,6 +1247,14 @@ var MastraClient = class extends BaseResource {
   getNetwork(networkId) {
     return new Network(this.options, networkId);
   }
+  /**
+   * Gets an A2A client for interacting with an agent via the A2A protocol
+   * @param agentId - ID of the agent to interact with
+   * @returns A2A client instance
+   */
+  getA2A(agentId) {
+    return new A2A(this.options, agentId);
+  }
 };
 
 export { MastraClient };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/client-js",
-  "version": "0.1.21",
+  "version": "0.1.22-alpha.1",
   "description": "The official TypeScript library for the Mastra Client API",
   "author": "",
   "type": "module",
@@ -28,10 +28,10 @@
     "rxjs": "7.8.1",
     "zod": "^3.24.3",
     "zod-to-json-schema": "^3.24.5",
-    "@mastra/core": "^0.9.3"
+    "@mastra/core": "^0.9.4-alpha.1"
   },
   "peerDependencies": {
-    "zod": "^3.24.2"
+    "zod": "^3.0.0"
   },
   "devDependencies": {
     "@babel/preset-env": "^7.26.9",

package/src/client.ts

@@ -1,6 +1,6 @@
 import type { AbstractAgent } from '@ag-ui/client';
 import { AGUIAdapter } from './adapters/agui';
-import { Agent, MemoryThread, Tool, Workflow, Vector, BaseResource, Network, VNextWorkflow } from './resources';
+import { Agent, MemoryThread, Tool, Workflow, Vector, BaseResource, Network, VNextWorkflow, A2A } from './resources';
 import type {
   ClientOptions,
   CreateMemoryThreadParams,
@@ -256,4 +256,13 @@ export class MastraClient extends BaseResource {
   public getNetwork(networkId: string) {
     return new Network(this.options, networkId);
   }
+
+  /**
+   * Gets an A2A client for interacting with an agent via the A2A protocol
+   * @param agentId - ID of the agent to interact with
+   * @returns A2A client instance
+   */
+  public getA2A(agentId: string) {
+    return new A2A(this.options, agentId);
+  }
 }

package/src/resources/a2a.ts

@@ -0,0 +1,88 @@
+import type { TaskSendParams, TaskQueryParams, TaskIdParams, Task, AgentCard, JSONRPCResponse } from '@mastra/core/a2a';
+import type { ClientOptions } from '../types';
+import { BaseResource } from './base';
+
+/**
+ * Class for interacting with an agent via the A2A protocol
+ */
+export class A2A extends BaseResource {
+  constructor(
+    options: ClientOptions,
+    private agentId: string,
+  ) {
+    super(options);
+  }
+
+  /**
+   * Get the agent card with metadata about the agent
+   * @returns Promise containing the agent card information
+   */
+  async getCard(): Promise<AgentCard> {
+    return this.request(`/.well-known/${this.agentId}/agent.json`);
+  }
+
+  /**
+   * Send a message to the agent and get a response
+   * @param params - Parameters for the task
+   * @returns Promise containing the task response
+   */
+  async sendMessage(params: TaskSendParams): Promise<{ task: Task }> {
+    const response = await this.request<JSONRPCResponse<Task>>(`/a2a/${this.agentId}`, {
+      method: 'POST',
+      body: {
+        method: 'tasks/send',
+        params,
+      },
+    });
+
+    return { task: response.result! };
+  }
+
+  /**
+   * Get the status and result of a task
+   * @param params - Parameters for querying the task
+   * @returns Promise containing the task response
+   */
+  async getTask(params: TaskQueryParams): Promise<Task> {
+    const response = await this.request<JSONRPCResponse<Task>>(`/a2a/${this.agentId}`, {
+      method: 'POST',
+      body: {
+        method: 'tasks/get',
+        params,
+      },
+    });
+
+    return response.result!;
+  }
+
+  /**
+   * Cancel a running task
+   * @param params - Parameters identifying the task to cancel
+   * @returns Promise containing the task response
+   */
+  async cancelTask(params: TaskIdParams): Promise<{ task: Task }> {
+    return this.request(`/a2a/${this.agentId}`, {
+      method: 'POST',
+      body: {
+        method: 'tasks/cancel',
+        params,
+      },
+    });
+  }
+
+  /**
+   * Send a message and subscribe to streaming updates (not fully implemented)
+   * @param params - Parameters for the task
+   * @returns Promise containing the task response
+   */
+  async sendAndSubscribe(params: TaskSendParams): Promise<Response> {
+    return this.request(`/a2a/${this.agentId}`, {
+      method: 'POST',
+      body: {
+        method: 'tasks/sendSubscribe',
+        params,
+      },
+      stream: true,
+    });
+  }
+}

package/src/resources/agent.ts

@@ -14,28 +14,7 @@ import type {
 } from '../types';
 
 import { BaseResource } from './base';
-
-export class AgentTool extends BaseResource {
-  constructor(
-    options: ClientOptions,
-    private agentId: string,
-    private toolId: string,
-  ) {
-    super(options);
-  }
-
-  /**
-   * Executes a specific tool for an agent
-   * @param params - Parameters required for tool execution
-   * @returns Promise containing tool execution results
-   */
-  execute(params: { data: any }): Promise<any> {
-    return this.request(`/api/agents/${this.agentId}/tools/${this.toolId}/execute`, {
-      method: 'POST',
-      body: params,
-    });
-  }
-}
+import type { RuntimeContext } from '@mastra/core/di';
 
 export class AgentVoice extends BaseResource {
   constructor(
@@ -188,6 +167,23 @@ export class Agent extends BaseResource {
     return this.request(`/api/agents/${this.agentId}/tools/${toolId}`);
   }
 
+  /**
+   * Executes a tool for the agent
+   * @param toolId - ID of the tool to execute
+   * @param params - Parameters required for tool execution
+   * @returns Promise containing the tool execution results
+   */
+  executeTool(toolId: string, params: { data: any; runtimeContext?: RuntimeContext }): Promise<any> {
+    const body = {
+      data: params.data,
+      runtimeContext: params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : undefined,
+    };
+    return this.request(`/api/agents/${this.agentId}/tools/${toolId}/execute`, {
+      method: 'POST',
+      body,
+    });
+  }
+
   /**
    * Retrieves evaluation results for the agent
    * @returns Promise containing agent evaluations

package/src/resources/index.ts

@@ -6,3 +6,4 @@ export * from './workflow';
 export * from './tool';
 export * from './base';
 export * from './vnext-workflow';
+export * from './a2a';

package/src/resources/tool.ts

@@ -1,3 +1,4 @@
+import type { RuntimeContext } from '@mastra/core/di';
 import type { GetToolResponse, ClientOptions } from '../types';
 
 import { BaseResource } from './base';
@@ -23,16 +24,21 @@ export class Tool extends BaseResource {
    * @param params - Parameters required for tool execution
    * @returns Promise containing the tool execution results
    */
-  execute(params: { data: any; runId?: string }): Promise<any> {
+  execute(params: { data: any; runId?: string; runtimeContext?: RuntimeContext }): Promise<any> {
     const url = new URLSearchParams();
 
     if (params.runId) {
       url.set('runId', params.runId);
     }
 
+    const body = {
+      data: params.data,
+      runtimeContext: params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : undefined,
+    };
+
     return this.request(`/api/tools/${this.toolId}/execute?${url.toString()}`, {
       method: 'POST',
-      body: params.data,
+      body,
     });
   }
 }

package/src/resources/vnext-workflow.ts

@@ -1,4 +1,4 @@
-import type { RuntimeContext } from '@mastra/core/runtime-context';
+import { RuntimeContext } from '@mastra/core/runtime-context';
 import type {
   ClientOptions,
   GetVNextWorkflowResponse,
@@ -156,9 +156,10 @@ export class VNextWorkflow extends BaseResource {
     inputData: Record<string, any>;
     runtimeContext?: RuntimeContext;
   }): Promise<{ message: string }> {
+    const runtimeContext = params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : undefined;
     return this.request(`/api/workflows/v-next/${this.workflowId}/start?runId=${params.runId}`, {
       method: 'POST',
-      body: { inputData: params?.inputData, runtimeContext: params.runtimeContext },
+      body: { inputData: params?.inputData, runtimeContext },
     });
   }
 
@@ -171,13 +172,14 @@ export class VNextWorkflow extends BaseResource {
     step,
     runId,
     resumeData,
-    runtimeContext,
+    ...rest
   }: {
     step: string | string[];
     runId: string;
     resumeData?: Record<string, any>;
     runtimeContext?: RuntimeContext;
   }): Promise<{ message: string }> {
+    const runtimeContext = rest.runtimeContext ? Object.fromEntries(rest.runtimeContext.entries()) : undefined;
     return this.request(`/api/workflows/v-next/${this.workflowId}/resume?runId=${runId}`, {
       method: 'POST',
       stream: true,
@@ -205,9 +207,10 @@ export class VNextWorkflow extends BaseResource {
       searchParams.set('runId', params.runId);
     }
 
+    const runtimeContext = params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : undefined;
     return this.request(`/api/workflows/v-next/${this.workflowId}/start-async?${searchParams.toString()}`, {
       method: 'POST',
-      body: { inputData: params.inputData, runtimeContext: params.runtimeContext },
+      body: { inputData: params.inputData, runtimeContext },
     });
   }
 
@@ -222,12 +225,13 @@ export class VNextWorkflow extends BaseResource {
     resumeData?: Record<string, any>;
     runtimeContext?: RuntimeContext;
   }): Promise<VNextWorkflowRunResult> {
+    const runtimeContext = params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : undefined;
     return this.request(`/api/workflows/v-next/${this.workflowId}/resume-async?runId=${params.runId}`, {
       method: 'POST',
       body: {
         step: params.step,
         resumeData: params.resumeData,
-        runtimeContext: params.runtimeContext,
+        runtimeContext,
       },
     });
   }