@mastra/client-js 0.10.5-alpha.0 → 0.10.5-alpha.1

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @mastra/client-js@0.10.5-alpha.0 build /home/runner/work/mastra/mastra/client-sdks/client-js
+> @mastra/client-js@0.10.5-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
-ESM dist/index.js 46.36 KB
-ESM ⚡️ Build success in 1229ms
-CJS dist/index.cjs 46.65 KB
-CJS ⚡️ Build success in 1218ms
+CJS dist/index.cjs 47.24 KB
+CJS ⚡️ Build success in 1490ms
+ESM dist/index.js 46.95 KB
+ESM ⚡️ Build success in 2034ms
 DTS Build start
-DTS ⚡️ Build success in 14740ms
-DTS dist/index.d.ts  32.85 KB
-DTS dist/index.d.cts 32.85 KB
+DTS ⚡️ Build success in 15050ms
+DTS dist/index.d.ts  33.64 KB
+DTS dist/index.d.cts 33.64 KB

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @mastra/client-js
 
+## 0.10.5-alpha.1
+
+### Patch Changes
+
+- ee9af57: Add api for polling run execution result and get run by id
+- 3270d9d: Fix runtime context being undefined
+- Updated dependencies [ee9af57]
+- Updated dependencies [751c894]
+- Updated dependencies [577ce3a]
+- Updated dependencies [9260b3a]
+  - @mastra/core@0.10.6-alpha.1
+
 ## 0.10.5-alpha.0
 
 ### Patch Changes

package/dist/index.cjs

@@ -922,6 +922,22 @@ var Workflow = class extends BaseResource {
       return this.request(`/api/workflows/${this.workflowId}/runs`);
     }
   }
+  /**
+   * Retrieves a specific workflow run by its ID
+   * @param runId - The ID of the workflow run to retrieve
+   * @returns Promise containing the workflow run details
+   */
+  runById(runId) {
+    return this.request(`/api/workflows/${this.workflowId}/runs/${runId}`);
+  }
+  /**
+   * Retrieves the execution result for a specific workflow run by its ID
+   * @param runId - The ID of the workflow run to retrieve the execution result for
+   * @returns Promise containing the workflow run execution result
+   */
+  runExecutionResult(runId) {
+    return this.request(`/api/workflows/${this.workflowId}/runs/${runId}/execution-result`);
+  }
   /**
    * Creates a new workflow run
    * @param params - Optional object containing the optional runId
@@ -996,7 +1012,7 @@ var Workflow = class extends BaseResource {
     if (!!params?.runId) {
       searchParams.set("runId", params.runId);
     }
-    const runtimeContext = params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : void 0;
+    const runtimeContext = parseClientRuntimeContext(params.runtimeContext);
     const response = await this.request(
       `/api/workflows/${this.workflowId}/stream?${searchParams.toString()}`,
       {

package/dist/index.d.cts

@@ -1,13 +1,13 @@
 import { AbstractAgent } from '@ag-ui/client';
 import { ServerInfo, MCPToolType, ServerDetailInfo } from '@mastra/core/mcp';
 import { processDataStream } from '@ai-sdk/ui-utils';
-import { CoreMessage, AiMessageType, StorageThreadType, MastraMessageV1, LegacyWorkflowRuns, WorkflowRuns, QueryResult, GenerateReturn } from '@mastra/core';
+import { CoreMessage, AiMessageType, StorageThreadType, MastraMessageV1, LegacyWorkflowRuns, WorkflowRuns, WorkflowRun, QueryResult, GenerateReturn } from '@mastra/core';
 import { JSONSchema7 } from 'json-schema';
 import { ZodSchema } from 'zod';
 import { AgentGenerateOptions, AgentStreamOptions, ToolsInput } from '@mastra/core/agent';
 import { LogLevel, BaseLogMessage } from '@mastra/core/logger';
 import { RuntimeContext } from '@mastra/core/runtime-context';
-import { Workflow as Workflow$1, WorkflowResult, WatchEvent } from '@mastra/core/workflows';
+import { Workflow as Workflow$1, WatchEvent, WorkflowResult } 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';
@@ -89,6 +89,8 @@ interface GetWorkflowRunsParams {
 }
 type GetLegacyWorkflowRunsResponse = LegacyWorkflowRuns;
 type GetWorkflowRunsResponse = WorkflowRuns;
+type GetWorkflowRunByIdResponse = WorkflowRun;
+type GetWorkflowRunExecutionResultResponse = WatchEvent['payload']['workflowState'];
 type LegacyWorkflowRunResult = {
     activePaths: Record<string, {
         status: string;
@@ -624,6 +626,18 @@ declare class Workflow extends BaseResource {
      * @returns Promise containing workflow runs array
      */
     runs(params?: GetWorkflowRunsParams): Promise<GetWorkflowRunsResponse>;
+    /**
+     * Retrieves a specific workflow run by its ID
+     * @param runId - The ID of the workflow run to retrieve
+     * @returns Promise containing the workflow run details
+     */
+    runById(runId: string): Promise<GetWorkflowRunByIdResponse>;
+    /**
+     * Retrieves the execution result for a specific workflow run by its ID
+     * @param runId - The ID of the workflow run to retrieve the execution result for
+     * @returns Promise containing the workflow run execution result
+     */
+    runExecutionResult(runId: string): Promise<GetWorkflowRunExecutionResultResponse>;
     /**
      * Creates a new workflow run
      * @param params - Optional object containing the optional runId
@@ -935,4 +949,4 @@ declare class MastraClient extends BaseResource {
     getA2A(agentId: string): A2A;
 }
 
-export { type ClientOptions, type CreateIndexParams, type CreateMemoryThreadParams, type CreateMemoryThreadResponse, type GenerateParams, type GetAgentResponse, type GetEvalsByAgentIdResponse, type GetLegacyWorkflowResponse, type GetLegacyWorkflowRunsResponse, type GetLogParams, type GetLogsParams, type GetLogsResponse, type GetMemoryThreadMessagesParams, type GetMemoryThreadMessagesResponse, type GetMemoryThreadParams, type GetMemoryThreadResponse, type GetNetworkResponse, type GetTelemetryParams, type GetTelemetryResponse, type GetToolResponse, type GetVectorIndexResponse, type GetWorkflowResponse, type GetWorkflowRunsParams, type GetWorkflowRunsResponse, type LegacyWorkflowRunResult, MastraClient, type McpServerListResponse, type McpServerToolListResponse, type McpToolInfo, type QueryVectorParams, type QueryVectorResponse, type RequestFunction, type RequestOptions, type SaveMessageToMemoryParams, type SaveMessageToMemoryResponse, type StreamParams, type UpdateMemoryThreadParams, type UpsertVectorParams, type WorkflowRunResult, type WorkflowWatchResult };
+export { type ClientOptions, type CreateIndexParams, type CreateMemoryThreadParams, type CreateMemoryThreadResponse, type GenerateParams, type GetAgentResponse, type GetEvalsByAgentIdResponse, type GetLegacyWorkflowResponse, type GetLegacyWorkflowRunsResponse, type GetLogParams, type GetLogsParams, type GetLogsResponse, type GetMemoryThreadMessagesParams, type GetMemoryThreadMessagesResponse, type GetMemoryThreadParams, type GetMemoryThreadResponse, type GetNetworkResponse, type GetTelemetryParams, type GetTelemetryResponse, type GetToolResponse, type GetVectorIndexResponse, type GetWorkflowResponse, type GetWorkflowRunByIdResponse, type GetWorkflowRunExecutionResultResponse, type GetWorkflowRunsParams, type GetWorkflowRunsResponse, type LegacyWorkflowRunResult, MastraClient, type McpServerListResponse, type McpServerToolListResponse, type McpToolInfo, type QueryVectorParams, type QueryVectorResponse, type RequestFunction, type RequestOptions, type SaveMessageToMemoryParams, type SaveMessageToMemoryResponse, type StreamParams, type UpdateMemoryThreadParams, type UpsertVectorParams, type WorkflowRunResult, type WorkflowWatchResult };

package/dist/index.d.ts

@@ -1,13 +1,13 @@
 import { AbstractAgent } from '@ag-ui/client';
 import { ServerInfo, MCPToolType, ServerDetailInfo } from '@mastra/core/mcp';
 import { processDataStream } from '@ai-sdk/ui-utils';
-import { CoreMessage, AiMessageType, StorageThreadType, MastraMessageV1, LegacyWorkflowRuns, WorkflowRuns, QueryResult, GenerateReturn } from '@mastra/core';
+import { CoreMessage, AiMessageType, StorageThreadType, MastraMessageV1, LegacyWorkflowRuns, WorkflowRuns, WorkflowRun, QueryResult, GenerateReturn } from '@mastra/core';
 import { JSONSchema7 } from 'json-schema';
 import { ZodSchema } from 'zod';
 import { AgentGenerateOptions, AgentStreamOptions, ToolsInput } from '@mastra/core/agent';
 import { LogLevel, BaseLogMessage } from '@mastra/core/logger';
 import { RuntimeContext } from '@mastra/core/runtime-context';
-import { Workflow as Workflow$1, WorkflowResult, WatchEvent } from '@mastra/core/workflows';
+import { Workflow as Workflow$1, WatchEvent, WorkflowResult } 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';
@@ -89,6 +89,8 @@ interface GetWorkflowRunsParams {
 }
 type GetLegacyWorkflowRunsResponse = LegacyWorkflowRuns;
 type GetWorkflowRunsResponse = WorkflowRuns;
+type GetWorkflowRunByIdResponse = WorkflowRun;
+type GetWorkflowRunExecutionResultResponse = WatchEvent['payload']['workflowState'];
 type LegacyWorkflowRunResult = {
     activePaths: Record<string, {
         status: string;
@@ -624,6 +626,18 @@ declare class Workflow extends BaseResource {
      * @returns Promise containing workflow runs array
      */
     runs(params?: GetWorkflowRunsParams): Promise<GetWorkflowRunsResponse>;
+    /**
+     * Retrieves a specific workflow run by its ID
+     * @param runId - The ID of the workflow run to retrieve
+     * @returns Promise containing the workflow run details
+     */
+    runById(runId: string): Promise<GetWorkflowRunByIdResponse>;
+    /**
+     * Retrieves the execution result for a specific workflow run by its ID
+     * @param runId - The ID of the workflow run to retrieve the execution result for
+     * @returns Promise containing the workflow run execution result
+     */
+    runExecutionResult(runId: string): Promise<GetWorkflowRunExecutionResultResponse>;
     /**
      * Creates a new workflow run
      * @param params - Optional object containing the optional runId
@@ -935,4 +949,4 @@ declare class MastraClient extends BaseResource {
     getA2A(agentId: string): A2A;
 }
 
-export { type ClientOptions, type CreateIndexParams, type CreateMemoryThreadParams, type CreateMemoryThreadResponse, type GenerateParams, type GetAgentResponse, type GetEvalsByAgentIdResponse, type GetLegacyWorkflowResponse, type GetLegacyWorkflowRunsResponse, type GetLogParams, type GetLogsParams, type GetLogsResponse, type GetMemoryThreadMessagesParams, type GetMemoryThreadMessagesResponse, type GetMemoryThreadParams, type GetMemoryThreadResponse, type GetNetworkResponse, type GetTelemetryParams, type GetTelemetryResponse, type GetToolResponse, type GetVectorIndexResponse, type GetWorkflowResponse, type GetWorkflowRunsParams, type GetWorkflowRunsResponse, type LegacyWorkflowRunResult, MastraClient, type McpServerListResponse, type McpServerToolListResponse, type McpToolInfo, type QueryVectorParams, type QueryVectorResponse, type RequestFunction, type RequestOptions, type SaveMessageToMemoryParams, type SaveMessageToMemoryResponse, type StreamParams, type UpdateMemoryThreadParams, type UpsertVectorParams, type WorkflowRunResult, type WorkflowWatchResult };
+export { type ClientOptions, type CreateIndexParams, type CreateMemoryThreadParams, type CreateMemoryThreadResponse, type GenerateParams, type GetAgentResponse, type GetEvalsByAgentIdResponse, type GetLegacyWorkflowResponse, type GetLegacyWorkflowRunsResponse, type GetLogParams, type GetLogsParams, type GetLogsResponse, type GetMemoryThreadMessagesParams, type GetMemoryThreadMessagesResponse, type GetMemoryThreadParams, type GetMemoryThreadResponse, type GetNetworkResponse, type GetTelemetryParams, type GetTelemetryResponse, type GetToolResponse, type GetVectorIndexResponse, type GetWorkflowResponse, type GetWorkflowRunByIdResponse, type GetWorkflowRunExecutionResultResponse, type GetWorkflowRunsParams, type GetWorkflowRunsResponse, type LegacyWorkflowRunResult, MastraClient, type McpServerListResponse, type McpServerToolListResponse, type McpToolInfo, type QueryVectorParams, type QueryVectorResponse, type RequestFunction, type RequestOptions, type SaveMessageToMemoryParams, type SaveMessageToMemoryResponse, type StreamParams, type UpdateMemoryThreadParams, type UpsertVectorParams, type WorkflowRunResult, type WorkflowWatchResult };

package/dist/index.js

@@ -916,6 +916,22 @@ var Workflow = class extends BaseResource {
       return this.request(`/api/workflows/${this.workflowId}/runs`);
     }
   }
+  /**
+   * Retrieves a specific workflow run by its ID
+   * @param runId - The ID of the workflow run to retrieve
+   * @returns Promise containing the workflow run details
+   */
+  runById(runId) {
+    return this.request(`/api/workflows/${this.workflowId}/runs/${runId}`);
+  }
+  /**
+   * Retrieves the execution result for a specific workflow run by its ID
+   * @param runId - The ID of the workflow run to retrieve the execution result for
+   * @returns Promise containing the workflow run execution result
+   */
+  runExecutionResult(runId) {
+    return this.request(`/api/workflows/${this.workflowId}/runs/${runId}/execution-result`);
+  }
   /**
    * Creates a new workflow run
    * @param params - Optional object containing the optional runId
@@ -990,7 +1006,7 @@ var Workflow = class extends BaseResource {
     if (!!params?.runId) {
       searchParams.set("runId", params.runId);
     }
-    const runtimeContext = params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : void 0;
+    const runtimeContext = parseClientRuntimeContext(params.runtimeContext);
     const response = await this.request(
       `/api/workflows/${this.workflowId}/stream?${searchParams.toString()}`,
       {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/client-js",
-  "version": "0.10.5-alpha.0",
+  "version": "0.10.5-alpha.1",
   "description": "The official TypeScript library for the Mastra Client API",
   "author": "",
   "type": "module",
@@ -33,7 +33,7 @@
     "rxjs": "7.8.1",
     "zod": "^3.25.57",
     "zod-to-json-schema": "^3.24.5",
-    "@mastra/core": "0.10.6-alpha.0"
+    "@mastra/core": "0.10.6-alpha.1"
   },
   "peerDependencies": {
     "zod": "^3.0.0"

package/src/resources/workflow.ts

@@ -6,6 +6,8 @@ import type {
   GetWorkflowRunsParams,
   WorkflowRunResult,
   WorkflowWatchResult,
+  GetWorkflowRunByIdResponse,
+  GetWorkflowRunExecutionResultResponse,
 } from '../types';
 
 import { parseClientRuntimeContext } from '../utils';
@@ -130,6 +132,24 @@ export class Workflow extends BaseResource {
     }
   }
 
+  /**
+   * Retrieves a specific workflow run by its ID
+   * @param runId - The ID of the workflow run to retrieve
+   * @returns Promise containing the workflow run details
+   */
+  runById(runId: string): Promise<GetWorkflowRunByIdResponse> {
+    return this.request(`/api/workflows/${this.workflowId}/runs/${runId}`);
+  }
+
+  /**
+   * Retrieves the execution result for a specific workflow run by its ID
+   * @param runId - The ID of the workflow run to retrieve the execution result for
+   * @returns Promise containing the workflow run execution result
+   */
+  runExecutionResult(runId: string): Promise<GetWorkflowRunExecutionResultResponse> {
+    return this.request(`/api/workflows/${this.workflowId}/runs/${runId}/execution-result`);
+  }
+
   /**
    * Creates a new workflow run
    * @param params - Optional object containing the optional runId
@@ -228,7 +248,7 @@ export class Workflow extends BaseResource {
       searchParams.set('runId', params.runId);
     }
 
-    const runtimeContext = params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : undefined;
+    const runtimeContext = parseClientRuntimeContext(params.runtimeContext);
     const response: Response = await this.request(
       `/api/workflows/${this.workflowId}/stream?${searchParams.toString()}`,
       {

package/src/types.ts

@@ -5,6 +5,7 @@ import type {
   QueryResult,
   StorageThreadType,
   WorkflowRuns,
+  WorkflowRun,
   LegacyWorkflowRuns,
 } from '@mastra/core';
 import type { AgentGenerateOptions, AgentStreamOptions, ToolsInput } from '@mastra/core/agent';
@@ -115,6 +116,10 @@ export type GetLegacyWorkflowRunsResponse = LegacyWorkflowRuns;
 
 export type GetWorkflowRunsResponse = WorkflowRuns;
 
+export type GetWorkflowRunByIdResponse = WorkflowRun;
+
+export type GetWorkflowRunExecutionResultResponse = WatchEvent['payload']['workflowState'];
+
 export type LegacyWorkflowRunResult = {
   activePaths: Record<string, { status: string; suspendPayload?: any; stepPath: string[] }>;
   results: CoreLegacyWorkflowRunResult<any, any, any>['results'];