@mastra/client-js 0.1.14-alpha.2 → 0.1.14-alpha.3

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @mastra/client-js@0.1.14-alpha.2 build /home/runner/work/mastra/mastra/client-sdks/client-js
+> @mastra/client-js@0.1.14-alpha.3 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 21.12 KB
-ESM ⚡️ Build success in 893ms
-CJS dist/index.cjs 21.30 KB
-CJS ⚡️ Build success in 900ms
+ESM dist/index.js 21.30 KB
+ESM ⚡️ Build success in 809ms
+CJS dist/index.cjs 21.48 KB
+CJS ⚡️ Build success in 810ms
 DTS Build start
-DTS ⚡️ Build success in 12468ms
-DTS dist/index.d.ts  18.89 KB
-DTS dist/index.d.cts 18.89 KB
+DTS ⚡️ Build success in 12001ms
+DTS dist/index.d.ts  18.97 KB
+DTS dist/index.d.cts 18.97 KB

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @mastra/client-js
 
+## 0.1.14-alpha.3
+
+### Patch Changes
+
+- 789bef3: Make runId optional for workflow startAsync api
+- 8393832: Handle nested workflow view on workflow graph
+- Updated dependencies [5ae0180]
+- Updated dependencies [9bfa12b]
+- Updated dependencies [515ebfb]
+- Updated dependencies [88fa727]
+- Updated dependencies [f37f535]
+- Updated dependencies [4d67826]
+- Updated dependencies [6330967]
+- Updated dependencies [8393832]
+- Updated dependencies [6330967]
+  - @mastra/core@0.8.0-alpha.3
+
 ## 0.1.14-alpha.2
 
 ### Patch Changes

package/dist/index.cjs

@@ -373,6 +373,7 @@ var Workflow = class extends BaseResource {
     return this.request(`/api/workflows/${this.workflowId}`);
   }
   /**
+   * @deprecated Use `startAsync` instead
    * Executes the workflow with the provided parameters
    * @param params - Parameters required for workflow execution
    * @returns Promise containing the workflow execution results
@@ -429,11 +430,15 @@ var Workflow = class extends BaseResource {
   }
   /**
    * Starts a workflow run asynchronously and returns a promise that resolves when the workflow is complete
-   * @param params - Object containing the runId and triggerData
+   * @param params - Object containing the optional runId and triggerData
    * @returns Promise containing the workflow execution results
    */
   startAsync(params) {
-    return this.request(`/api/workflows/${this.workflowId}/startAsync?runId=${params.runId}`, {
+    const searchParams = new URLSearchParams();
+    if (!!params?.runId) {
+      searchParams.set("runId", params.runId);
+    }
+    return this.request(`/api/workflows/${this.workflowId}/start-async?${searchParams.toString()}`, {
       method: "POST",
       body: params?.triggerData
     });
@@ -444,7 +449,7 @@ var Workflow = class extends BaseResource {
    * @returns Promise containing the workflow resume results
    */
   resumeAsync(params) {
-    return this.request(`/api/workflows/${this.workflowId}/resumeAsync?runId=${params.runId}`, {
+    return this.request(`/api/workflows/${this.workflowId}/resume-async?runId=${params.runId}`, {
       method: "POST",
       body: {
         stepId: params.stepId,

package/dist/index.d.cts

@@ -51,6 +51,7 @@ interface GetWorkflowResponse {
     steps: Record<string, StepAction<any, any, any, any>>;
     stepGraph: StepGraph;
     stepSubscriberGraph: Record<string, StepGraph>;
+    workflowId?: string;
 }
 type WorkflowRunResult = {
     activePaths: Record<string, {
@@ -339,6 +340,7 @@ declare class Workflow extends BaseResource {
      */
     details(): Promise<GetWorkflowResponse>;
     /**
+     * @deprecated Use `startAsync` instead
      * Executes the workflow with the provided parameters
      * @param params - Parameters required for workflow execution
      * @returns Promise containing the workflow execution results
@@ -380,11 +382,11 @@ declare class Workflow extends BaseResource {
     }>;
     /**
      * Starts a workflow run asynchronously and returns a promise that resolves when the workflow is complete
-     * @param params - Object containing the runId and triggerData
+     * @param params - Object containing the optional runId and triggerData
      * @returns Promise containing the workflow execution results
      */
     startAsync(params: {
-        runId: string;
+        runId?: string;
         triggerData: Record<string, any>;
     }): Promise<WorkflowRunResult>;
     /**

package/dist/index.d.ts

@@ -51,6 +51,7 @@ interface GetWorkflowResponse {
     steps: Record<string, StepAction<any, any, any, any>>;
     stepGraph: StepGraph;
     stepSubscriberGraph: Record<string, StepGraph>;
+    workflowId?: string;
 }
 type WorkflowRunResult = {
     activePaths: Record<string, {
@@ -339,6 +340,7 @@ declare class Workflow extends BaseResource {
      */
     details(): Promise<GetWorkflowResponse>;
     /**
+     * @deprecated Use `startAsync` instead
      * Executes the workflow with the provided parameters
      * @param params - Parameters required for workflow execution
      * @returns Promise containing the workflow execution results
@@ -380,11 +382,11 @@ declare class Workflow extends BaseResource {
     }>;
     /**
      * Starts a workflow run asynchronously and returns a promise that resolves when the workflow is complete
-     * @param params - Object containing the runId and triggerData
+     * @param params - Object containing the optional runId and triggerData
      * @returns Promise containing the workflow execution results
      */
     startAsync(params: {
-        runId: string;
+        runId?: string;
         triggerData: Record<string, any>;
     }): Promise<WorkflowRunResult>;
     /**

package/dist/index.js

@@ -371,6 +371,7 @@ var Workflow = class extends BaseResource {
     return this.request(`/api/workflows/${this.workflowId}`);
   }
   /**
+   * @deprecated Use `startAsync` instead
    * Executes the workflow with the provided parameters
    * @param params - Parameters required for workflow execution
    * @returns Promise containing the workflow execution results
@@ -427,11 +428,15 @@ var Workflow = class extends BaseResource {
   }
   /**
    * Starts a workflow run asynchronously and returns a promise that resolves when the workflow is complete
-   * @param params - Object containing the runId and triggerData
+   * @param params - Object containing the optional runId and triggerData
    * @returns Promise containing the workflow execution results
    */
   startAsync(params) {
-    return this.request(`/api/workflows/${this.workflowId}/startAsync?runId=${params.runId}`, {
+    const searchParams = new URLSearchParams();
+    if (!!params?.runId) {
+      searchParams.set("runId", params.runId);
+    }
+    return this.request(`/api/workflows/${this.workflowId}/start-async?${searchParams.toString()}`, {
       method: "POST",
       body: params?.triggerData
     });
@@ -442,7 +447,7 @@ var Workflow = class extends BaseResource {
    * @returns Promise containing the workflow resume results
    */
   resumeAsync(params) {
-    return this.request(`/api/workflows/${this.workflowId}/resumeAsync?runId=${params.runId}`, {
+    return this.request(`/api/workflows/${this.workflowId}/resume-async?runId=${params.runId}`, {
       method: "POST",
       body: {
         stepId: params.stepId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/client-js",
-  "version": "0.1.14-alpha.2",
+  "version": "0.1.14-alpha.3",
   "description": "The official TypeScript library for the Mastra Client API",
   "author": "",
   "type": "module",
@@ -26,7 +26,7 @@
     "json-schema": "^0.4.0",
     "zod": "^3.24.2",
     "zod-to-json-schema": "^3.24.3",
-    "@mastra/core": "^0.8.0-alpha.2"
+    "@mastra/core": "^0.8.0-alpha.3"
   },
   "devDependencies": {
     "@babel/preset-env": "^7.26.9",

package/src/index.test.ts

@@ -12,6 +12,7 @@ describe('MastraClient Resources', () => {
     baseUrl: 'http://localhost:4111',
     headers: {
       Authorization: 'Bearer test-key',
+      'x-mastra-client-type': 'js',
     },
   };
 
@@ -631,14 +632,14 @@ describe('MastraClient Resources', () => {
       };
       mockFetchResponse(mockResponse);
 
-      const result = await workflow.execute({ trigger: 'test' });
+      const result = await workflow.startAsync({ triggerData: { test: 'test' } });
       expect(result).toEqual(mockResponse);
       expect(global.fetch).toHaveBeenCalledWith(
-        `${clientOptions.baseUrl}/api/workflows/test-workflow/execute`,
+        `${clientOptions.baseUrl}/api/workflows/test-workflow/start-async?`,
         expect.objectContaining({
           method: 'POST',
           headers: expect.objectContaining(clientOptions.headers),
-          body: JSON.stringify({ trigger: 'test' }),
+          body: JSON.stringify({ test: 'test' }),
         }),
       );
     });

package/src/resources/workflow.ts

@@ -21,6 +21,7 @@ export class Workflow extends BaseResource {
   }
 
   /**
+   * @deprecated Use `startAsync` instead
    * Executes the workflow with the provided parameters
    * @param params - Parameters required for workflow execution
    * @returns Promise containing the workflow execution results
@@ -87,11 +88,17 @@ export class Workflow extends BaseResource {
 
   /**
    * Starts a workflow run asynchronously and returns a promise that resolves when the workflow is complete
-   * @param params - Object containing the runId and triggerData
+   * @param params - Object containing the optional runId and triggerData
    * @returns Promise containing the workflow execution results
    */
-  startAsync(params: { runId: string; triggerData: Record<string, any> }): Promise<WorkflowRunResult> {
-    return this.request(`/api/workflows/${this.workflowId}/startAsync?runId=${params.runId}`, {
+  startAsync(params: { runId?: string; triggerData: Record<string, any> }): Promise<WorkflowRunResult> {
+    const searchParams = new URLSearchParams();
+
+    if (!!params?.runId) {
+      searchParams.set('runId', params.runId);
+    }
+
+    return this.request(`/api/workflows/${this.workflowId}/start-async?${searchParams.toString()}`, {
       method: 'POST',
       body: params?.triggerData,
     });
@@ -103,7 +110,7 @@ export class Workflow extends BaseResource {
    * @returns Promise containing the workflow resume results
    */
   resumeAsync(params: { runId: string; stepId: string; context: Record<string, any> }): Promise<WorkflowRunResult> {
-    return this.request(`/api/workflows/${this.workflowId}/resumeAsync?runId=${params.runId}`, {
+    return this.request(`/api/workflows/${this.workflowId}/resume-async?runId=${params.runId}`, {
       method: 'POST',
       body: {
         stepId: params.stepId,

package/src/types.ts

@@ -69,6 +69,7 @@ export interface GetWorkflowResponse {
   steps: Record<string, StepAction<any, any, any, any>>;
   stepGraph: StepGraph;
   stepSubscriberGraph: Record<string, StepGraph>;
+  workflowId?: string;
 }
 
 export type WorkflowRunResult = {