@mastra/client-js 1.14.2 → 1.15.0-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @mastra/client-js
 
+## 1.15.0-alpha.0
+
+### Minor Changes
+
+- Added support for resuming suspended agent streams over HTTP with custom data. This adds the `POST /agents/:agentId/resume-stream` server endpoint and the client SDK `agent.resumeStream()` method, so apps can continue a suspended agent run through the Mastra client. ([#14579](https://github.com/mastra-ai/mastra/pull/14579))
+
+  **Usage example (client SDK):**
+
+  ```typescript
+  const agent = mastraClient.getAgent('my-agent');
+
+  // Resume a suspended agent stream with custom data
+  const response = await agent.resumeStream(
+    { approved: true, selectedOption: 'plan-b' },
+    { runId: 'previous-run-id', toolCallId: 'tool-123' },
+  );
+
+  await response.processDataStream({
+    onChunk: chunk => console.log(chunk),
+  });
+  ```
+
+### Patch Changes
+
+- Updated dependencies [[`b510d36`](https://github.com/mastra-ai/mastra/commit/b510d368f73dab6be2e2c2bc99035aaef1fb7d7a)]:
+  - @mastra/core@1.29.0-alpha.0
+
 ## 1.14.2
 
 ### Patch Changes

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.14.2"
+  version: "1.15.0-alpha.0"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

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

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

@@ -217,6 +217,26 @@ response.processDataStream({
 })
 ```
 
+### `resumeStream()`
+
+Resume a suspended agent stream with custom data. Use this to continue execution after a suspension point, such as a workflow suspend within an agent:
+
+```typescript
+const response = await agent.resumeStream(
+  { approved: true, selectedOption: 'plan-b' },
+  {
+    runId: 'run-123',
+    toolCallId: 'tool-call-456', // optional
+  },
+)
+
+await response.processDataStream({
+  onChunk: chunk => {
+    console.log(chunk)
+  },
+})
+```
+
 ### `approveToolCallGenerate()`
 
 Approve a pending tool call when using `generate()` (non-streaming). Returns the complete response:

package/dist/index.cjs

@@ -1210,9 +1210,14 @@ var Agent = class extends BaseResource {
     const { resource, thread } = memory ?? {};
     const threadId = processedParams.threadId ?? (typeof thread === "string" ? thread : thread?.id);
     const resourceId = processedParams.resourceId ?? resource;
+    let requestBody = processedParams;
+    if (route === "resume-stream") {
+      const { messages: _messages, ...resumeStreamBody } = processedParams;
+      requestBody = resumeStreamBody;
+    }
     const response = await this.request(`/agents/${this.agentId}/${route}`, {
       method: "POST",
-      body: processedParams,
+      body: requestBody,
       stream: true
     });
     if (!response.body) {
@@ -1511,6 +1516,43 @@ var Agent = class extends BaseResource {
     };
     return streamResponse;
   }
+  /**
+   * Resumes a suspended agent stream with custom resume data.
+   * Used to continue execution after a suspension point (e.g., workflow suspend within an agent).
+   */
+  async resumeStream(resumeData, options) {
+    const processedParams = {
+      ...options,
+      resumeData,
+      requestContext: parseClientRequestContext(options.requestContext),
+      clientTools: processClientTools(options.clientTools),
+      structuredOutput: options.structuredOutput ? {
+        ...options.structuredOutput,
+        schema: schema.standardSchemaToJSONSchema(schema.toStandardSchema(options.structuredOutput.schema))
+      } : void 0
+    };
+    let readableController;
+    const readable = new ReadableStream({
+      start(controller) {
+        readableController = controller;
+      }
+    });
+    const response = await this.processStreamResponse(processedParams, readableController, "resume-stream");
+    const streamResponse = new Response(readable, {
+      status: response.status,
+      statusText: response.statusText,
+      headers: response.headers
+    });
+    streamResponse.processDataStream = async ({
+      onChunk
+    }) => {
+      await processMastraStream({
+        stream: streamResponse.body,
+        onChunk
+      });
+    };
+    return streamResponse;
+  }
   /**
    * Approves a pending tool call and returns the complete response (non-streaming).
    * Used when `requireToolApproval` is enabled with generate() to allow the agent to proceed.