@mastra/client-js 0.10.1-alpha.0 → 0.10.1-alpha.2

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @mastra/client-js@0.10.1-alpha.0 build /home/runner/work/mastra/mastra/client-sdks/client-js
+> @mastra/client-js@0.10.1-alpha.2 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
-ESM dist/index.js 41.00 KB
-ESM ⚡️ Build success in 1666ms
-CJS dist/index.cjs 41.29 KB
-CJS ⚡️ Build success in 1695ms
+ESM dist/index.js 43.30 KB
+ESM ⚡️ Build success in 1577ms
+CJS dist/index.cjs 43.59 KB
+CJS ⚡️ Build success in 1577ms
 DTS Build start
-DTS ⚡️ Build success in 16148ms
-DTS dist/index.d.ts  30.61 KB
-DTS dist/index.d.cts 30.61 KB
+DTS ⚡️ Build success in 14357ms
+DTS dist/index.d.ts  31.64 KB
+DTS dist/index.d.cts 31.64 KB

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @mastra/client-js
 
+## 0.10.1-alpha.2
+
+### Patch Changes
+
+- 6015bdf: Leverage defaultAgentStreamOption, defaultAgentGenerateOption in playground
+- Updated dependencies [6015bdf]
+  - @mastra/core@0.10.1-alpha.2
+
+## 0.10.1-alpha.1
+
+### Patch Changes
+
+- 5343f93: Move emitter to symbol to make private
+- Updated dependencies [200d0da]
+- Updated dependencies [bf5f17b]
+- Updated dependencies [5343f93]
+- Updated dependencies [38aee50]
+- Updated dependencies [5c41100]
+- Updated dependencies [d6a759b]
+  - @mastra/core@0.10.1-alpha.1
+
 ## 0.10.1-alpha.0
 
 ### Patch Changes

package/dist/index.cjs

@@ -954,6 +954,53 @@ var Workflow = class extends BaseResource {
       body: { inputData: params.inputData, runtimeContext }
     });
   }
+  /**
+   * Starts a vNext workflow run and returns a stream
+   * @param params - Object containing the optional runId, inputData and runtimeContext
+   * @returns Promise containing the vNext workflow execution results
+   */
+  async stream(params) {
+    const searchParams = new URLSearchParams();
+    if (!!params?.runId) {
+      searchParams.set("runId", params.runId);
+    }
+    const runtimeContext = params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : void 0;
+    const response = await this.request(
+      `/api/workflows/${this.workflowId}/stream?${searchParams.toString()}`,
+      {
+        method: "POST",
+        body: { inputData: params.inputData, runtimeContext },
+        stream: true
+      }
+    );
+    if (!response.ok) {
+      throw new Error(`Failed to stream vNext workflow: ${response.statusText}`);
+    }
+    if (!response.body) {
+      throw new Error("Response body is null");
+    }
+    const transformStream = new TransformStream({
+      start() {
+      },
+      async transform(chunk, controller) {
+        try {
+          const decoded = new TextDecoder().decode(chunk);
+          const chunks = decoded.split(RECORD_SEPARATOR2);
+          for (const chunk2 of chunks) {
+            if (chunk2) {
+              try {
+                const parsedChunk = JSON.parse(chunk2);
+                controller.enqueue(parsedChunk);
+              } catch {
+              }
+            }
+          }
+        } catch {
+        }
+      }
+    });
+    return response.body.pipeThrough(transformStream);
+  }
   /**
    * Resumes a suspended workflow step asynchronously and returns a promise that resolves when the workflow is complete
    * @param params - Object containing the runId, step, resumeData and runtimeContext
@@ -989,6 +1036,29 @@ var Workflow = class extends BaseResource {
       onRecord(record);
     }
   }
+  /**
+   * Creates a new ReadableStream from an iterable or async iterable of objects,
+   * serializing each as JSON and separating them with the record separator (\x1E).
+   *
+   * @param records - An iterable or async iterable of objects to stream
+   * @returns A ReadableStream emitting the records as JSON strings separated by the record separator
+   */
+  static createRecordStream(records) {
+    const encoder = new TextEncoder();
+    return new ReadableStream({
+      async start(controller) {
+        try {
+          for await (const record of records) {
+            const json = JSON.stringify(record) + RECORD_SEPARATOR2;
+            controller.enqueue(encoder.encode(json));
+          }
+          controller.close();
+        } catch (err) {
+          controller.error(err);
+        }
+      }
+    });
+  }
 };
 
 // src/resources/a2a.ts

package/dist/index.d.cts

@@ -9,6 +9,7 @@ import { AgentGenerateOptions, AgentStreamOptions } from '@mastra/core/agent';
 import { RuntimeContext } from '@mastra/core/runtime-context';
 import { Workflow as Workflow$1, WorkflowResult, WatchEvent } from '@mastra/core/workflows';
 import { StepAction, StepGraph, LegacyWorkflowRunResult as LegacyWorkflowRunResult$1 } from '@mastra/core/workflows/legacy';
+import * as stream_web from 'stream/web';
 import { AgentCard, TaskSendParams, Task, TaskQueryParams, TaskIdParams } from '@mastra/core/a2a';
 
 interface ClientOptions {
@@ -42,6 +43,8 @@ interface GetAgentResponse {
     workflows: Record<string, GetWorkflowResponse>;
     provider: string;
     modelId: string;
+    defaultGenerateOptions: WithoutMethods<AgentGenerateOptions>;
+    defaultStreamOptions: WithoutMethods<AgentStreamOptions>;
 }
 type GenerateParams<T extends JSONSchema7 | ZodSchema | undefined = undefined> = {
     messages: string | string[] | CoreMessage[] | AiMessageType[];
@@ -627,6 +630,16 @@ declare class Workflow extends BaseResource {
         inputData: Record<string, any>;
         runtimeContext?: RuntimeContext | Record<string, any>;
     }): Promise<WorkflowRunResult>;
+    /**
+     * Starts a vNext workflow run and returns a stream
+     * @param params - Object containing the optional runId, inputData and runtimeContext
+     * @returns Promise containing the vNext workflow execution results
+     */
+    stream(params: {
+        runId?: string;
+        inputData: Record<string, any>;
+        runtimeContext?: RuntimeContext;
+    }): Promise<stream_web.ReadableStream<WorkflowWatchResult>>;
     /**
      * Resumes a suspended workflow step asynchronously and returns a promise that resolves when the workflow is complete
      * @param params - Object containing the runId, step, resumeData and runtimeContext
@@ -646,6 +659,14 @@ declare class Workflow extends BaseResource {
     watch({ runId }: {
         runId?: string;
     }, onRecord: (record: WorkflowWatchResult) => void): Promise<void>;
+    /**
+     * Creates a new ReadableStream from an iterable or async iterable of objects,
+     * serializing each as JSON and separating them with the record separator (\x1E).
+     *
+     * @param records - An iterable or async iterable of objects to stream
+     * @returns A ReadableStream emitting the records as JSON strings separated by the record separator
+     */
+    static createRecordStream(records: Iterable<any> | AsyncIterable<any>): ReadableStream;
 }
 
 /**

package/dist/index.d.ts

@@ -9,6 +9,7 @@ import { AgentGenerateOptions, AgentStreamOptions } from '@mastra/core/agent';
 import { RuntimeContext } from '@mastra/core/runtime-context';
 import { Workflow as Workflow$1, WorkflowResult, WatchEvent } from '@mastra/core/workflows';
 import { StepAction, StepGraph, LegacyWorkflowRunResult as LegacyWorkflowRunResult$1 } from '@mastra/core/workflows/legacy';
+import * as stream_web from 'stream/web';
 import { AgentCard, TaskSendParams, Task, TaskQueryParams, TaskIdParams } from '@mastra/core/a2a';
 
 interface ClientOptions {
@@ -42,6 +43,8 @@ interface GetAgentResponse {
     workflows: Record<string, GetWorkflowResponse>;
     provider: string;
     modelId: string;
+    defaultGenerateOptions: WithoutMethods<AgentGenerateOptions>;
+    defaultStreamOptions: WithoutMethods<AgentStreamOptions>;
 }
 type GenerateParams<T extends JSONSchema7 | ZodSchema | undefined = undefined> = {
     messages: string | string[] | CoreMessage[] | AiMessageType[];
@@ -627,6 +630,16 @@ declare class Workflow extends BaseResource {
         inputData: Record<string, any>;
         runtimeContext?: RuntimeContext | Record<string, any>;
     }): Promise<WorkflowRunResult>;
+    /**
+     * Starts a vNext workflow run and returns a stream
+     * @param params - Object containing the optional runId, inputData and runtimeContext
+     * @returns Promise containing the vNext workflow execution results
+     */
+    stream(params: {
+        runId?: string;
+        inputData: Record<string, any>;
+        runtimeContext?: RuntimeContext;
+    }): Promise<stream_web.ReadableStream<WorkflowWatchResult>>;
     /**
      * Resumes a suspended workflow step asynchronously and returns a promise that resolves when the workflow is complete
      * @param params - Object containing the runId, step, resumeData and runtimeContext
@@ -646,6 +659,14 @@ declare class Workflow extends BaseResource {
     watch({ runId }: {
         runId?: string;
     }, onRecord: (record: WorkflowWatchResult) => void): Promise<void>;
+    /**
+     * Creates a new ReadableStream from an iterable or async iterable of objects,
+     * serializing each as JSON and separating them with the record separator (\x1E).
+     *
+     * @param records - An iterable or async iterable of objects to stream
+     * @returns A ReadableStream emitting the records as JSON strings separated by the record separator
+     */
+    static createRecordStream(records: Iterable<any> | AsyncIterable<any>): ReadableStream;
 }
 
 /**

package/dist/index.js

@@ -948,6 +948,53 @@ var Workflow = class extends BaseResource {
       body: { inputData: params.inputData, runtimeContext }
     });
   }
+  /**
+   * Starts a vNext workflow run and returns a stream
+   * @param params - Object containing the optional runId, inputData and runtimeContext
+   * @returns Promise containing the vNext workflow execution results
+   */
+  async stream(params) {
+    const searchParams = new URLSearchParams();
+    if (!!params?.runId) {
+      searchParams.set("runId", params.runId);
+    }
+    const runtimeContext = params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : void 0;
+    const response = await this.request(
+      `/api/workflows/${this.workflowId}/stream?${searchParams.toString()}`,
+      {
+        method: "POST",
+        body: { inputData: params.inputData, runtimeContext },
+        stream: true
+      }
+    );
+    if (!response.ok) {
+      throw new Error(`Failed to stream vNext workflow: ${response.statusText}`);
+    }
+    if (!response.body) {
+      throw new Error("Response body is null");
+    }
+    const transformStream = new TransformStream({
+      start() {
+      },
+      async transform(chunk, controller) {
+        try {
+          const decoded = new TextDecoder().decode(chunk);
+          const chunks = decoded.split(RECORD_SEPARATOR2);
+          for (const chunk2 of chunks) {
+            if (chunk2) {
+              try {
+                const parsedChunk = JSON.parse(chunk2);
+                controller.enqueue(parsedChunk);
+              } catch {
+              }
+            }
+          }
+        } catch {
+        }
+      }
+    });
+    return response.body.pipeThrough(transformStream);
+  }
   /**
    * Resumes a suspended workflow step asynchronously and returns a promise that resolves when the workflow is complete
    * @param params - Object containing the runId, step, resumeData and runtimeContext
@@ -983,6 +1030,29 @@ var Workflow = class extends BaseResource {
       onRecord(record);
     }
   }
+  /**
+   * Creates a new ReadableStream from an iterable or async iterable of objects,
+   * serializing each as JSON and separating them with the record separator (\x1E).
+   *
+   * @param records - An iterable or async iterable of objects to stream
+   * @returns A ReadableStream emitting the records as JSON strings separated by the record separator
+   */
+  static createRecordStream(records) {
+    const encoder = new TextEncoder();
+    return new ReadableStream({
+      async start(controller) {
+        try {
+          for await (const record of records) {
+            const json = JSON.stringify(record) + RECORD_SEPARATOR2;
+            controller.enqueue(encoder.encode(json));
+          }
+          controller.close();
+        } catch (err) {
+          controller.error(err);
+        }
+      }
+    });
+  }
 };
 
 // src/resources/a2a.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/client-js",
-  "version": "0.10.1-alpha.0",
+  "version": "0.10.1-alpha.2",
   "description": "The official TypeScript library for the Mastra Client API",
   "author": "",
   "type": "module",
@@ -43,7 +43,7 @@
     "typescript": "^5.8.2",
     "vitest": "^3.1.2",
     "@internal/lint": "0.0.6",
-    "@mastra/core": "0.10.1-alpha.0"
+    "@mastra/core": "0.10.1-alpha.3"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --clean --treeshake=smallest --splitting",

package/src/resources/workflow.ts

@@ -216,6 +216,68 @@ export class Workflow extends BaseResource {
     });
   }
 
+  /**
+   * Starts a vNext workflow run and returns a stream
+   * @param params - Object containing the optional runId, inputData and runtimeContext
+   * @returns Promise containing the vNext workflow execution results
+   */
+  async stream(params: { runId?: string; inputData: Record<string, any>; runtimeContext?: RuntimeContext }) {
+    const searchParams = new URLSearchParams();
+
+    if (!!params?.runId) {
+      searchParams.set('runId', params.runId);
+    }
+
+    const runtimeContext = params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : undefined;
+    const response: Response = await this.request(
+      `/api/workflows/${this.workflowId}/stream?${searchParams.toString()}`,
+      {
+        method: 'POST',
+        body: { inputData: params.inputData, runtimeContext },
+        stream: true,
+      },
+    );
+
+    if (!response.ok) {
+      throw new Error(`Failed to stream vNext workflow: ${response.statusText}`);
+    }
+
+    if (!response.body) {
+      throw new Error('Response body is null');
+    }
+
+    // Create a transform stream that processes the response body
+    const transformStream = new TransformStream<ArrayBuffer, WorkflowWatchResult>({
+      start() {},
+      async transform(chunk, controller) {
+        try {
+          // Decode binary data to text
+          const decoded = new TextDecoder().decode(chunk);
+
+          // Split by record separator
+          const chunks = decoded.split(RECORD_SEPARATOR);
+
+          // Process each chunk
+          for (const chunk of chunks) {
+            if (chunk) {
+              try {
+                const parsedChunk = JSON.parse(chunk);
+                controller.enqueue(parsedChunk);
+              } catch {
+                // Silently ignore parsing errors
+              }
+            }
+          }
+        } catch {
+          // Silently ignore processing errors
+        }
+      },
+    });
+
+    // Pipe the response body through the transform stream
+    return response.body.pipeThrough(transformStream);
+  }
+
   /**
    * Resumes a suspended workflow step asynchronously and returns a promise that resolves when the workflow is complete
    * @param params - Object containing the runId, step, resumeData and runtimeContext
@@ -260,4 +322,28 @@ export class Workflow extends BaseResource {
       onRecord(record);
     }
   }
+
+  /**
+   * Creates a new ReadableStream from an iterable or async iterable of objects,
+   * serializing each as JSON and separating them with the record separator (\x1E).
+   *
+   * @param records - An iterable or async iterable of objects to stream
+   * @returns A ReadableStream emitting the records as JSON strings separated by the record separator
+   */
+  static createRecordStream(records: Iterable<any> | AsyncIterable<any>): ReadableStream {
+    const encoder = new TextEncoder();
+    return new ReadableStream({
+      async start(controller) {
+        try {
+          for await (const record of records as AsyncIterable<any>) {
+            const json = JSON.stringify(record) + RECORD_SEPARATOR;
+            controller.enqueue(encoder.encode(json));
+          }
+          controller.close();
+        } catch (err) {
+          controller.error(err);
+        }
+      },
+    });
+  }
 }

package/src/types.ts

@@ -60,6 +60,8 @@ export interface GetAgentResponse {
   workflows: Record<string, GetWorkflowResponse>;
   provider: string;
   modelId: string;
+  defaultGenerateOptions: WithoutMethods<AgentGenerateOptions>;
+  defaultStreamOptions: WithoutMethods<AgentStreamOptions>;
 }
 
 export type GenerateParams<T extends JSONSchema7 | ZodSchema | undefined = undefined> = {