@mastra/client-js 0.1.20-alpha.1 → 0.1.20-alpha.4

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @mastra/client-js@0.1.20-alpha.1 build /home/runner/work/mastra/mastra/client-sdks/client-js
+> @mastra/client-js@0.1.20-alpha.4 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 27.80 KB
-CJS ⚡️ Build success in 843ms
-ESM dist/index.js 27.62 KB
-ESM ⚡️ Build success in 844ms
+ESM dist/index.js 29.18 KB
+ESM ⚡️ Build success in 1376ms
+CJS dist/index.cjs 29.36 KB
+CJS ⚡️ Build success in 1385ms
 DTS Build start
-DTS ⚡️ Build success in 11136ms
-DTS dist/index.d.ts  24.60 KB
-DTS dist/index.d.cts 24.60 KB
+DTS ⚡️ Build success in 13669ms
+DTS dist/index.d.ts  24.97 KB
+DTS dist/index.d.cts 24.97 KB

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @mastra/client-js
 
+## 0.1.20-alpha.4
+
+### Patch Changes
+
+- Updated dependencies [ccef9f9]
+- Updated dependencies [51e6923]
+  - @mastra/core@0.9.2-alpha.4
+
+## 0.1.20-alpha.3
+
+### Patch Changes
+
+- 4155f47: Add parameters to filter workflow runs
+  Add fromDate and toDate to telemetry parameters
+- Updated dependencies [967b41c]
+- Updated dependencies [4155f47]
+- Updated dependencies [17826a9]
+  - @mastra/core@0.9.2-alpha.3
+
+## 0.1.20-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [26738f4]
+  - @mastra/core@0.9.2-alpha.2
+
 ## 0.1.20-alpha.1
 
 ### Patch Changes

package/dist/index.cjs

@@ -375,10 +375,31 @@ var Workflow = class extends BaseResource {
   }
   /**
    * Retrieves all runs for a workflow
+   * @param params - Parameters for filtering runs
    * @returns Promise containing workflow runs array
    */
-  runs() {
-    return this.request(`/api/workflows/${this.workflowId}/runs`);
+  runs(params) {
+    const searchParams = new URLSearchParams();
+    if (params?.fromDate) {
+      searchParams.set("fromDate", params.fromDate.toISOString());
+    }
+    if (params?.toDate) {
+      searchParams.set("toDate", params.toDate.toISOString());
+    }
+    if (params?.limit) {
+      searchParams.set("limit", String(params.limit));
+    }
+    if (params?.offset) {
+      searchParams.set("offset", String(params.offset));
+    }
+    if (params?.resourceId) {
+      searchParams.set("resourceId", params.resourceId);
+    }
+    if (searchParams.size) {
+      return this.request(`/api/workflows/${this.workflowId}/runs?${searchParams}`);
+    } else {
+      return this.request(`/api/workflows/${this.workflowId}/runs`);
+    }
   }
   /**
    * @deprecated Use `startAsync` instead
@@ -622,10 +643,31 @@ var VNextWorkflow = class extends BaseResource {
   }
   /**
    * Retrieves all runs for a vNext workflow
+   * @param params - Parameters for filtering runs
    * @returns Promise containing vNext workflow runs array
    */
-  runs() {
-    return this.request(`/api/workflows/v-next/${this.workflowId}/runs`);
+  runs(params) {
+    const searchParams = new URLSearchParams();
+    if (params?.fromDate) {
+      searchParams.set("fromDate", params.fromDate.toISOString());
+    }
+    if (params?.toDate) {
+      searchParams.set("toDate", params.toDate.toISOString());
+    }
+    if (params?.limit) {
+      searchParams.set("limit", String(params.limit));
+    }
+    if (params?.offset) {
+      searchParams.set("offset", String(params.offset));
+    }
+    if (params?.resourceId) {
+      searchParams.set("resourceId", params.resourceId);
+    }
+    if (searchParams.size) {
+      return this.request(`/api/workflows/v-next/${this.workflowId}/runs?${searchParams}`);
+    } else {
+      return this.request(`/api/workflows/v-next/${this.workflowId}/runs`);
+    }
   }
   /**
    * Creates a new vNext workflow run
@@ -868,7 +910,7 @@ var MastraClient = class extends BaseResource {
    * @returns Promise containing telemetry data
    */
   getTelemetry(params) {
-    const { name, scope, page, perPage, attribute } = params || {};
+    const { name, scope, page, perPage, attribute, fromDate, toDate } = params || {};
     const _attribute = attribute ? Object.entries(attribute).map(([key, value]) => `${key}:${value}`) : [];
     const searchParams = new URLSearchParams();
     if (name) {
@@ -892,6 +934,12 @@ var MastraClient = class extends BaseResource {
         searchParams.set("attribute", _attribute);
       }
     }
+    if (fromDate) {
+      searchParams.set("fromDate", fromDate.toISOString());
+    }
+    if (toDate) {
+      searchParams.set("toDate", toDate.toISOString());
+    }
     if (searchParams.size) {
       return this.request(`/api/telemetry?${searchParams}`);
     } else {

package/dist/index.d.cts

@@ -58,6 +58,13 @@ interface GetWorkflowResponse {
     stepSubscriberGraph: Record<string, StepGraph>;
     workflowId?: string;
 }
+interface GetWorkflowRunsParams {
+    fromDate?: Date;
+    toDate?: Date;
+    limit?: number;
+    offset?: number;
+    resourceId?: string;
+}
 type GetWorkflowRunsResponse = WorkflowRuns;
 type WorkflowRunResult = {
     activePaths: Record<string, {
@@ -197,6 +204,8 @@ interface GetTelemetryParams {
     page?: number;
     perPage?: number;
     attribute?: Record<string, string>;
+    fromDate?: Date;
+    toDate?: Date;
 }
 interface GetNetworkResponse {
     name: string;
@@ -404,9 +413,10 @@ declare class Workflow extends BaseResource {
     details(): Promise<GetWorkflowResponse>;
     /**
      * Retrieves all runs for a workflow
+     * @param params - Parameters for filtering runs
      * @returns Promise containing workflow runs array
      */
-    runs(): Promise<GetWorkflowRunsResponse>;
+    runs(params?: GetWorkflowRunsParams): Promise<GetWorkflowRunsResponse>;
     /**
      * @deprecated Use `startAsync` instead
      * Executes the workflow with the provided parameters
@@ -522,9 +532,10 @@ declare class VNextWorkflow extends BaseResource {
     details(): Promise<GetVNextWorkflowResponse>;
     /**
      * Retrieves all runs for a vNext workflow
+     * @param params - Parameters for filtering runs
      * @returns Promise containing vNext workflow runs array
      */
-    runs(): Promise<GetWorkflowRunsResponse>;
+    runs(params?: GetWorkflowRunsParams): Promise<GetWorkflowRunsResponse>;
     /**
      * Creates a new vNext workflow run
      * @param params - Optional object containing the optional runId
@@ -712,4 +723,4 @@ declare class MastraClient extends BaseResource {
     getNetwork(networkId: string): Network;
 }
 
-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 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 };
+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

@@ -58,6 +58,13 @@ interface GetWorkflowResponse {
     stepSubscriberGraph: Record<string, StepGraph>;
     workflowId?: string;
 }
+interface GetWorkflowRunsParams {
+    fromDate?: Date;
+    toDate?: Date;
+    limit?: number;
+    offset?: number;
+    resourceId?: string;
+}
 type GetWorkflowRunsResponse = WorkflowRuns;
 type WorkflowRunResult = {
     activePaths: Record<string, {
@@ -197,6 +204,8 @@ interface GetTelemetryParams {
     page?: number;
     perPage?: number;
     attribute?: Record<string, string>;
+    fromDate?: Date;
+    toDate?: Date;
 }
 interface GetNetworkResponse {
     name: string;
@@ -404,9 +413,10 @@ declare class Workflow extends BaseResource {
     details(): Promise<GetWorkflowResponse>;
     /**
      * Retrieves all runs for a workflow
+     * @param params - Parameters for filtering runs
      * @returns Promise containing workflow runs array
      */
-    runs(): Promise<GetWorkflowRunsResponse>;
+    runs(params?: GetWorkflowRunsParams): Promise<GetWorkflowRunsResponse>;
     /**
      * @deprecated Use `startAsync` instead
      * Executes the workflow with the provided parameters
@@ -522,9 +532,10 @@ declare class VNextWorkflow extends BaseResource {
     details(): Promise<GetVNextWorkflowResponse>;
     /**
      * Retrieves all runs for a vNext workflow
+     * @param params - Parameters for filtering runs
      * @returns Promise containing vNext workflow runs array
      */
-    runs(): Promise<GetWorkflowRunsResponse>;
+    runs(params?: GetWorkflowRunsParams): Promise<GetWorkflowRunsResponse>;
     /**
      * Creates a new vNext workflow run
      * @param params - Optional object containing the optional runId
@@ -712,4 +723,4 @@ declare class MastraClient extends BaseResource {
     getNetwork(networkId: string): Network;
 }
 
-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 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 };
+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

@@ -373,10 +373,31 @@ var Workflow = class extends BaseResource {
   }
   /**
    * Retrieves all runs for a workflow
+   * @param params - Parameters for filtering runs
    * @returns Promise containing workflow runs array
    */
-  runs() {
-    return this.request(`/api/workflows/${this.workflowId}/runs`);
+  runs(params) {
+    const searchParams = new URLSearchParams();
+    if (params?.fromDate) {
+      searchParams.set("fromDate", params.fromDate.toISOString());
+    }
+    if (params?.toDate) {
+      searchParams.set("toDate", params.toDate.toISOString());
+    }
+    if (params?.limit) {
+      searchParams.set("limit", String(params.limit));
+    }
+    if (params?.offset) {
+      searchParams.set("offset", String(params.offset));
+    }
+    if (params?.resourceId) {
+      searchParams.set("resourceId", params.resourceId);
+    }
+    if (searchParams.size) {
+      return this.request(`/api/workflows/${this.workflowId}/runs?${searchParams}`);
+    } else {
+      return this.request(`/api/workflows/${this.workflowId}/runs`);
+    }
   }
   /**
    * @deprecated Use `startAsync` instead
@@ -620,10 +641,31 @@ var VNextWorkflow = class extends BaseResource {
   }
   /**
    * Retrieves all runs for a vNext workflow
+   * @param params - Parameters for filtering runs
    * @returns Promise containing vNext workflow runs array
    */
-  runs() {
-    return this.request(`/api/workflows/v-next/${this.workflowId}/runs`);
+  runs(params) {
+    const searchParams = new URLSearchParams();
+    if (params?.fromDate) {
+      searchParams.set("fromDate", params.fromDate.toISOString());
+    }
+    if (params?.toDate) {
+      searchParams.set("toDate", params.toDate.toISOString());
+    }
+    if (params?.limit) {
+      searchParams.set("limit", String(params.limit));
+    }
+    if (params?.offset) {
+      searchParams.set("offset", String(params.offset));
+    }
+    if (params?.resourceId) {
+      searchParams.set("resourceId", params.resourceId);
+    }
+    if (searchParams.size) {
+      return this.request(`/api/workflows/v-next/${this.workflowId}/runs?${searchParams}`);
+    } else {
+      return this.request(`/api/workflows/v-next/${this.workflowId}/runs`);
+    }
   }
   /**
    * Creates a new vNext workflow run
@@ -866,7 +908,7 @@ var MastraClient = class extends BaseResource {
    * @returns Promise containing telemetry data
    */
   getTelemetry(params) {
-    const { name, scope, page, perPage, attribute } = params || {};
+    const { name, scope, page, perPage, attribute, fromDate, toDate } = params || {};
     const _attribute = attribute ? Object.entries(attribute).map(([key, value]) => `${key}:${value}`) : [];
     const searchParams = new URLSearchParams();
     if (name) {
@@ -890,6 +932,12 @@ var MastraClient = class extends BaseResource {
         searchParams.set("attribute", _attribute);
       }
     }
+    if (fromDate) {
+      searchParams.set("fromDate", fromDate.toISOString());
+    }
+    if (toDate) {
+      searchParams.set("toDate", toDate.toISOString());
+    }
     if (searchParams.size) {
       return this.request(`/api/telemetry?${searchParams}`);
     } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/client-js",
-  "version": "0.1.20-alpha.1",
+  "version": "0.1.20-alpha.4",
   "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.9.2-alpha.1"
+    "@mastra/core": "^0.9.2-alpha.4"
   },
   "peerDependencies": {
     "zod": "^3.24.2"

package/src/client.ts

@@ -180,7 +180,7 @@ export class MastraClient extends BaseResource {
    * @returns Promise containing telemetry data
    */
   public getTelemetry(params?: GetTelemetryParams): Promise<GetTelemetryResponse> {
-    const { name, scope, page, perPage, attribute } = params || {};
+    const { name, scope, page, perPage, attribute, fromDate, toDate } = params || {};
     const _attribute = attribute ? Object.entries(attribute).map(([key, value]) => `${key}:${value}`) : [];
 
     const searchParams = new URLSearchParams();
@@ -205,6 +205,12 @@ export class MastraClient extends BaseResource {
         searchParams.set('attribute', _attribute);
       }
     }
+    if (fromDate) {
+      searchParams.set('fromDate', fromDate.toISOString());
+    }
+    if (toDate) {
+      searchParams.set('toDate', toDate.toISOString());
+    }
 
     if (searchParams.size) {
       return this.request(`/api/telemetry?${searchParams}`);

package/src/resources/vnext-workflow.ts

@@ -2,6 +2,7 @@ import type { RuntimeContext } from '@mastra/core/runtime-context';
 import type {
   ClientOptions,
   GetVNextWorkflowResponse,
+  GetWorkflowRunsParams,
   GetWorkflowRunsResponse,
   VNextWorkflowRunResult,
   VNextWorkflowWatchResult,
@@ -100,10 +101,32 @@ export class VNextWorkflow extends BaseResource {
 
   /**
    * Retrieves all runs for a vNext workflow
+   * @param params - Parameters for filtering runs
    * @returns Promise containing vNext workflow runs array
    */
-  runs(): Promise<GetWorkflowRunsResponse> {
-    return this.request(`/api/workflows/v-next/${this.workflowId}/runs`);
+  runs(params?: GetWorkflowRunsParams): Promise<GetWorkflowRunsResponse> {
+    const searchParams = new URLSearchParams();
+    if (params?.fromDate) {
+      searchParams.set('fromDate', params.fromDate.toISOString());
+    }
+    if (params?.toDate) {
+      searchParams.set('toDate', params.toDate.toISOString());
+    }
+    if (params?.limit) {
+      searchParams.set('limit', String(params.limit));
+    }
+    if (params?.offset) {
+      searchParams.set('offset', String(params.offset));
+    }
+    if (params?.resourceId) {
+      searchParams.set('resourceId', params.resourceId);
+    }
+
+    if (searchParams.size) {
+      return this.request(`/api/workflows/v-next/${this.workflowId}/runs?${searchParams}`);
+    } else {
+      return this.request(`/api/workflows/v-next/${this.workflowId}/runs`);
+    }
   }
 
   /**

package/src/resources/workflow.ts

@@ -1,4 +1,10 @@
-import type { GetWorkflowResponse, ClientOptions, WorkflowRunResult, GetWorkflowRunsResponse } from '../types';
+import type {
+  GetWorkflowResponse,
+  ClientOptions,
+  WorkflowRunResult,
+  GetWorkflowRunsResponse,
+  GetWorkflowRunsParams,
+} from '../types';
 
 import { BaseResource } from './base';
 
@@ -22,10 +28,32 @@ export class Workflow extends BaseResource {
 
   /**
    * Retrieves all runs for a workflow
+   * @param params - Parameters for filtering runs
    * @returns Promise containing workflow runs array
    */
-  runs(): Promise<GetWorkflowRunsResponse> {
-    return this.request(`/api/workflows/${this.workflowId}/runs`);
+  runs(params?: GetWorkflowRunsParams): Promise<GetWorkflowRunsResponse> {
+    const searchParams = new URLSearchParams();
+    if (params?.fromDate) {
+      searchParams.set('fromDate', params.fromDate.toISOString());
+    }
+    if (params?.toDate) {
+      searchParams.set('toDate', params.toDate.toISOString());
+    }
+    if (params?.limit) {
+      searchParams.set('limit', String(params.limit));
+    }
+    if (params?.offset) {
+      searchParams.set('offset', String(params.offset));
+    }
+    if (params?.resourceId) {
+      searchParams.set('resourceId', params.resourceId);
+    }
+
+    if (searchParams.size) {
+      return this.request(`/api/workflows/${this.workflowId}/runs?${searchParams}`);
+    } else {
+      return this.request(`/api/workflows/${this.workflowId}/runs`);
+    }
   }
 
   /**

package/src/types.ts

@@ -77,6 +77,14 @@ export interface GetWorkflowResponse {
   workflowId?: string;
 }
 
+export interface GetWorkflowRunsParams {
+  fromDate?: Date;
+  toDate?: Date;
+  limit?: number;
+  offset?: number;
+  resourceId?: string;
+}
+
 export type GetWorkflowRunsResponse = WorkflowRuns;
 
 export type WorkflowRunResult = {
@@ -234,6 +242,8 @@ export interface GetTelemetryParams {
   page?: number;
   perPage?: number;
   attribute?: Record<string, string>;
+  fromDate?: Date;
+  toDate?: Date;
 }
 
 export interface GetNetworkResponse {