@mastra/client-js 0.10.2 → 0.10.3-alpha.1

package/.turbo/turbo-build.log

@@ -1,19 +1,19 @@
 
-> @mastra/client-js@0.10.2-alpha.3 build /home/runner/work/mastra/mastra/client-sdks/client-js
+> @mastra/client-js@0.10.3-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
 CLI Using tsconfig: tsconfig.json
-CLI tsup v8.4.0
+CLI tsup v8.5.0
 CLI Target: es2022
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-CJS dist/index.cjs 44.77 KB
-CJS ⚡️ Build success in 1691ms
-ESM dist/index.js 44.48 KB
-ESM ⚡️ Build success in 1693ms
+ESM dist/index.js 46.36 KB
+ESM ⚡️ Build success in 1304ms
+CJS dist/index.cjs 46.65 KB
+CJS ⚡️ Build success in 1319ms
 DTS Build start
-DTS ⚡️ Build success in 13187ms
-DTS dist/index.d.ts  32.02 KB
-DTS dist/index.d.cts 32.02 KB
+DTS ⚡️ Build success in 16865ms
+DTS dist/index.d.ts  32.85 KB
+DTS dist/index.d.cts 32.85 KB

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # @mastra/client-js
 
+## 0.10.3-alpha.1
+
+### Patch Changes
+
+- 1ccccff: dependencies updates:
+  - Updated dependency [`zod@^3.25.56` ↗︎](https://www.npmjs.com/package/zod/v/3.25.56) (from `^3.24.3`, in `dependencies`)
+- 1ccccff: dependencies updates:
+  - Updated dependency [`zod@^3.25.56` ↗︎](https://www.npmjs.com/package/zod/v/3.25.56) (from `^3.24.3`, in `dependencies`)
+- Updated dependencies [f6fd25f]
+- Updated dependencies [dffb67b]
+- Updated dependencies [f1309d3]
+- Updated dependencies [f7f8293]
+  - @mastra/core@0.10.4-alpha.1
+
+## 0.10.3-alpha.0
+
+### Patch Changes
+
+- f1f1f1b: Add basic filtering capabilities to logs
+- b2810ab: Move @mastra/core to deps
+- 82090c1: Add pagination to logs
+- 67d21b5: Added overloading to the generate method of the Agent class to enhance type definition using ZodSchema.
+- Updated dependencies [d1ed912]
+- Updated dependencies [f1f1f1b]
+- Updated dependencies [f9816ae]
+- Updated dependencies [82090c1]
+- Updated dependencies [1b443fd]
+- Updated dependencies [ce97900]
+- Updated dependencies [14a2566]
+  - @mastra/core@0.10.4-alpha.0
+
 ## 0.10.2
 
 ### Patch Changes

package/dist/index.cjs

@@ -368,11 +368,6 @@ var Agent = class extends BaseResource {
   details() {
     return this.request(`/api/agents/${this.agentId}`);
   }
-  /**
-   * Generates a response from the agent
-   * @param params - Generation parameters including prompt
-   * @returns Promise containing the generated response
-   */
   generate(params) {
     const processedParams = {
       ...params,
@@ -1346,7 +1341,41 @@ var MastraClient = class extends BaseResource {
    * @returns Promise containing array of log messages
    */
   getLogs(params) {
-    return this.request(`/api/logs?transportId=${params.transportId}`);
+    const { transportId, fromDate, toDate, logLevel, filters, page, perPage } = params;
+    const _filters = filters ? Object.entries(filters).map(([key, value]) => `${key}:${value}`) : [];
+    const searchParams = new URLSearchParams();
+    if (transportId) {
+      searchParams.set("transportId", transportId);
+    }
+    if (fromDate) {
+      searchParams.set("fromDate", fromDate.toISOString());
+    }
+    if (toDate) {
+      searchParams.set("toDate", toDate.toISOString());
+    }
+    if (logLevel) {
+      searchParams.set("logLevel", logLevel);
+    }
+    if (page) {
+      searchParams.set("page", String(page));
+    }
+    if (perPage) {
+      searchParams.set("perPage", String(perPage));
+    }
+    if (_filters) {
+      if (Array.isArray(_filters)) {
+        for (const filter of _filters) {
+          searchParams.append("filters", filter);
+        }
+      } else {
+        searchParams.set("filters", _filters);
+      }
+    }
+    if (searchParams.size) {
+      return this.request(`/api/logs?${searchParams}`);
+    } else {
+      return this.request(`/api/logs`);
+    }
   }
   /**
    * Gets logs for a specific run
@@ -1354,7 +1383,44 @@ var MastraClient = class extends BaseResource {
    * @returns Promise containing array of log messages
    */
   getLogForRun(params) {
-    return this.request(`/api/logs/${params.runId}?transportId=${params.transportId}`);
+    const { runId, transportId, fromDate, toDate, logLevel, filters, page, perPage } = params;
+    const _filters = filters ? Object.entries(filters).map(([key, value]) => `${key}:${value}`) : [];
+    const searchParams = new URLSearchParams();
+    if (runId) {
+      searchParams.set("runId", runId);
+    }
+    if (transportId) {
+      searchParams.set("transportId", transportId);
+    }
+    if (fromDate) {
+      searchParams.set("fromDate", fromDate.toISOString());
+    }
+    if (toDate) {
+      searchParams.set("toDate", toDate.toISOString());
+    }
+    if (logLevel) {
+      searchParams.set("logLevel", logLevel);
+    }
+    if (page) {
+      searchParams.set("page", String(page));
+    }
+    if (perPage) {
+      searchParams.set("perPage", String(perPage));
+    }
+    if (_filters) {
+      if (Array.isArray(_filters)) {
+        for (const filter of _filters) {
+          searchParams.append("filters", filter);
+        }
+      } else {
+        searchParams.set("filters", _filters);
+      }
+    }
+    if (searchParams.size) {
+      return this.request(`/api/logs/${runId}?${searchParams}`);
+    } else {
+      return this.request(`/api/logs/${runId}`);
+    }
   }
   /**
    * List of all log transports

package/dist/index.d.cts

@@ -5,7 +5,7 @@ import { CoreMessage, AiMessageType, StorageThreadType, MastraMessageV1, LegacyW
 import { JSONSchema7 } from 'json-schema';
 import { ZodSchema } from 'zod';
 import { AgentGenerateOptions, AgentStreamOptions, ToolsInput } from '@mastra/core/agent';
-import { BaseLogMessage } from '@mastra/core/logger';
+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 { StepAction, StepGraph, LegacyWorkflowRunResult as LegacyWorkflowRunResult$1 } from '@mastra/core/workflows/legacy';
@@ -181,12 +181,30 @@ interface GetMemoryThreadMessagesResponse {
 }
 interface GetLogsParams {
     transportId: string;
+    fromDate?: Date;
+    toDate?: Date;
+    logLevel?: LogLevel;
+    filters?: Record<string, string>;
+    page?: number;
+    perPage?: number;
 }
 interface GetLogParams {
     runId: string;
     transportId: string;
+    fromDate?: Date;
+    toDate?: Date;
+    logLevel?: LogLevel;
+    filters?: Record<string, string>;
+    page?: number;
+    perPage?: number;
 }
-type GetLogsResponse = BaseLogMessage[];
+type GetLogsResponse = {
+    logs: BaseLogMessage[];
+    total: number;
+    page: number;
+    perPage: number;
+    hasMore: boolean;
+};
 type RequestFunction = (path: string, options?: RequestOptions) => Promise<any>;
 type SpanStatus = {
     code: number;
@@ -331,7 +349,18 @@ declare class Agent extends BaseResource {
      * @param params - Generation parameters including prompt
      * @returns Promise containing the generated response
      */
-    generate<T extends JSONSchema7 | ZodSchema | undefined = undefined>(params: GenerateParams<T>): Promise<GenerateReturn<T>>;
+    generate<T extends JSONSchema7 | ZodSchema | undefined = undefined>(params: GenerateParams<T> & {
+        output?: never;
+        experimental_output?: never;
+    }): Promise<GenerateReturn<T>>;
+    generate<T extends JSONSchema7 | ZodSchema | undefined = undefined>(params: GenerateParams<T> & {
+        output: T;
+        experimental_output?: never;
+    }): Promise<GenerateReturn<T>>;
+    generate<T extends JSONSchema7 | ZodSchema | undefined = undefined>(params: GenerateParams<T> & {
+        output?: never;
+        experimental_output: T;
+    }): Promise<GenerateReturn<T>>;
     /**
      * Streams a response from the agent
      * @param params - Stream parameters including prompt

package/dist/index.d.ts

@@ -5,7 +5,7 @@ import { CoreMessage, AiMessageType, StorageThreadType, MastraMessageV1, LegacyW
 import { JSONSchema7 } from 'json-schema';
 import { ZodSchema } from 'zod';
 import { AgentGenerateOptions, AgentStreamOptions, ToolsInput } from '@mastra/core/agent';
-import { BaseLogMessage } from '@mastra/core/logger';
+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 { StepAction, StepGraph, LegacyWorkflowRunResult as LegacyWorkflowRunResult$1 } from '@mastra/core/workflows/legacy';
@@ -181,12 +181,30 @@ interface GetMemoryThreadMessagesResponse {
 }
 interface GetLogsParams {
     transportId: string;
+    fromDate?: Date;
+    toDate?: Date;
+    logLevel?: LogLevel;
+    filters?: Record<string, string>;
+    page?: number;
+    perPage?: number;
 }
 interface GetLogParams {
     runId: string;
     transportId: string;
+    fromDate?: Date;
+    toDate?: Date;
+    logLevel?: LogLevel;
+    filters?: Record<string, string>;
+    page?: number;
+    perPage?: number;
 }
-type GetLogsResponse = BaseLogMessage[];
+type GetLogsResponse = {
+    logs: BaseLogMessage[];
+    total: number;
+    page: number;
+    perPage: number;
+    hasMore: boolean;
+};
 type RequestFunction = (path: string, options?: RequestOptions) => Promise<any>;
 type SpanStatus = {
     code: number;
@@ -331,7 +349,18 @@ declare class Agent extends BaseResource {
      * @param params - Generation parameters including prompt
      * @returns Promise containing the generated response
      */
-    generate<T extends JSONSchema7 | ZodSchema | undefined = undefined>(params: GenerateParams<T>): Promise<GenerateReturn<T>>;
+    generate<T extends JSONSchema7 | ZodSchema | undefined = undefined>(params: GenerateParams<T> & {
+        output?: never;
+        experimental_output?: never;
+    }): Promise<GenerateReturn<T>>;
+    generate<T extends JSONSchema7 | ZodSchema | undefined = undefined>(params: GenerateParams<T> & {
+        output: T;
+        experimental_output?: never;
+    }): Promise<GenerateReturn<T>>;
+    generate<T extends JSONSchema7 | ZodSchema | undefined = undefined>(params: GenerateParams<T> & {
+        output?: never;
+        experimental_output: T;
+    }): Promise<GenerateReturn<T>>;
     /**
      * Streams a response from the agent
      * @param params - Stream parameters including prompt

package/dist/index.js

@@ -362,11 +362,6 @@ var Agent = class extends BaseResource {
   details() {
     return this.request(`/api/agents/${this.agentId}`);
   }
-  /**
-   * Generates a response from the agent
-   * @param params - Generation parameters including prompt
-   * @returns Promise containing the generated response
-   */
   generate(params) {
     const processedParams = {
       ...params,
@@ -1340,7 +1335,41 @@ var MastraClient = class extends BaseResource {
    * @returns Promise containing array of log messages
    */
   getLogs(params) {
-    return this.request(`/api/logs?transportId=${params.transportId}`);
+    const { transportId, fromDate, toDate, logLevel, filters, page, perPage } = params;
+    const _filters = filters ? Object.entries(filters).map(([key, value]) => `${key}:${value}`) : [];
+    const searchParams = new URLSearchParams();
+    if (transportId) {
+      searchParams.set("transportId", transportId);
+    }
+    if (fromDate) {
+      searchParams.set("fromDate", fromDate.toISOString());
+    }
+    if (toDate) {
+      searchParams.set("toDate", toDate.toISOString());
+    }
+    if (logLevel) {
+      searchParams.set("logLevel", logLevel);
+    }
+    if (page) {
+      searchParams.set("page", String(page));
+    }
+    if (perPage) {
+      searchParams.set("perPage", String(perPage));
+    }
+    if (_filters) {
+      if (Array.isArray(_filters)) {
+        for (const filter of _filters) {
+          searchParams.append("filters", filter);
+        }
+      } else {
+        searchParams.set("filters", _filters);
+      }
+    }
+    if (searchParams.size) {
+      return this.request(`/api/logs?${searchParams}`);
+    } else {
+      return this.request(`/api/logs`);
+    }
   }
   /**
    * Gets logs for a specific run
@@ -1348,7 +1377,44 @@ var MastraClient = class extends BaseResource {
    * @returns Promise containing array of log messages
    */
   getLogForRun(params) {
-    return this.request(`/api/logs/${params.runId}?transportId=${params.transportId}`);
+    const { runId, transportId, fromDate, toDate, logLevel, filters, page, perPage } = params;
+    const _filters = filters ? Object.entries(filters).map(([key, value]) => `${key}:${value}`) : [];
+    const searchParams = new URLSearchParams();
+    if (runId) {
+      searchParams.set("runId", runId);
+    }
+    if (transportId) {
+      searchParams.set("transportId", transportId);
+    }
+    if (fromDate) {
+      searchParams.set("fromDate", fromDate.toISOString());
+    }
+    if (toDate) {
+      searchParams.set("toDate", toDate.toISOString());
+    }
+    if (logLevel) {
+      searchParams.set("logLevel", logLevel);
+    }
+    if (page) {
+      searchParams.set("page", String(page));
+    }
+    if (perPage) {
+      searchParams.set("perPage", String(perPage));
+    }
+    if (_filters) {
+      if (Array.isArray(_filters)) {
+        for (const filter of _filters) {
+          searchParams.append("filters", filter);
+        }
+      } else {
+        searchParams.set("filters", _filters);
+      }
+    }
+    if (searchParams.size) {
+      return this.request(`/api/logs/${runId}?${searchParams}`);
+    } else {
+      return this.request(`/api/logs/${runId}`);
+    }
   }
   /**
    * List of all log transports

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/client-js",
-  "version": "0.10.2",
+  "version": "0.10.3-alpha.1",
   "description": "The official TypeScript library for the Mastra Client API",
   "author": "",
   "type": "module",
@@ -26,24 +26,23 @@
     "@ai-sdk/ui-utils": "^1.1.19",
     "json-schema": "^0.4.0",
     "rxjs": "7.8.1",
-    "zod": "^3.24.3",
-    "zod-to-json-schema": "^3.24.5"
+    "zod": "^3.25.56",
+    "zod-to-json-schema": "^3.24.5",
+    "@mastra/core": "0.10.4-alpha.1"
   },
   "peerDependencies": {
-    "zod": "^3.0.0",
-    "@mastra/core": "^0.10.2-alpha.0"
+    "zod": "^3.0.0"
   },
   "devDependencies": {
     "@babel/preset-env": "^7.26.9",
     "@babel/preset-typescript": "^7.27.0",
     "@tsconfig/recommended": "^1.0.8",
     "@types/json-schema": "^7.0.15",
-    "@types/node": "^20.17.27",
-    "tsup": "^8.4.0",
+    "@types/node": "^20.17.57",
+    "tsup": "^8.5.0",
     "typescript": "^5.8.2",
-    "vitest": "^3.1.2",
-    "@internal/lint": "0.0.8",
-    "@mastra/core": "0.10.2"
+    "vitest": "^3.2.2",
+    "@internal/lint": "0.0.10"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --clean --treeshake=smallest --splitting",

package/src/client.ts

@@ -189,7 +189,43 @@ export class MastraClient extends BaseResource {
    * @returns Promise containing array of log messages
    */
   public getLogs(params: GetLogsParams): Promise<GetLogsResponse> {
-    return this.request(`/api/logs?transportId=${params.transportId}`);
+    const { transportId, fromDate, toDate, logLevel, filters, page, perPage } = params;
+    const _filters = filters ? Object.entries(filters).map(([key, value]) => `${key}:${value}`) : [];
+
+    const searchParams = new URLSearchParams();
+    if (transportId) {
+      searchParams.set('transportId', transportId);
+    }
+    if (fromDate) {
+      searchParams.set('fromDate', fromDate.toISOString());
+    }
+    if (toDate) {
+      searchParams.set('toDate', toDate.toISOString());
+    }
+    if (logLevel) {
+      searchParams.set('logLevel', logLevel);
+    }
+    if (page) {
+      searchParams.set('page', String(page));
+    }
+    if (perPage) {
+      searchParams.set('perPage', String(perPage));
+    }
+    if (_filters) {
+      if (Array.isArray(_filters)) {
+        for (const filter of _filters) {
+          searchParams.append('filters', filter);
+        }
+      } else {
+        searchParams.set('filters', _filters);
+      }
+    }
+
+    if (searchParams.size) {
+      return this.request(`/api/logs?${searchParams}`);
+    } else {
+      return this.request(`/api/logs`);
+    }
   }
 
   /**
@@ -198,7 +234,47 @@ export class MastraClient extends BaseResource {
    * @returns Promise containing array of log messages
    */
   public getLogForRun(params: GetLogParams): Promise<GetLogsResponse> {
-    return this.request(`/api/logs/${params.runId}?transportId=${params.transportId}`);
+    const { runId, transportId, fromDate, toDate, logLevel, filters, page, perPage } = params;
+
+    const _filters = filters ? Object.entries(filters).map(([key, value]) => `${key}:${value}`) : [];
+    const searchParams = new URLSearchParams();
+    if (runId) {
+      searchParams.set('runId', runId);
+    }
+    if (transportId) {
+      searchParams.set('transportId', transportId);
+    }
+    if (fromDate) {
+      searchParams.set('fromDate', fromDate.toISOString());
+    }
+    if (toDate) {
+      searchParams.set('toDate', toDate.toISOString());
+    }
+    if (logLevel) {
+      searchParams.set('logLevel', logLevel);
+    }
+    if (page) {
+      searchParams.set('page', String(page));
+    }
+    if (perPage) {
+      searchParams.set('perPage', String(perPage));
+    }
+
+    if (_filters) {
+      if (Array.isArray(_filters)) {
+        for (const filter of _filters) {
+          searchParams.append('filters', filter);
+        }
+      } else {
+        searchParams.set('filters', _filters);
+      }
+    }
+
+    if (searchParams.size) {
+      return this.request(`/api/logs/${runId}?${searchParams}`);
+    } else {
+      return this.request(`/api/logs/${runId}`);
+    }
   }
 
   /**

package/src/resources/agent.ts

@@ -105,6 +105,15 @@ export class Agent extends BaseResource {
    * @param params - Generation parameters including prompt
    * @returns Promise containing the generated response
    */
+  generate<T extends JSONSchema7 | ZodSchema | undefined = undefined>(
+    params: GenerateParams<T> & { output?: never; experimental_output?: never },
+  ): Promise<GenerateReturn<T>>;
+  generate<T extends JSONSchema7 | ZodSchema | undefined = undefined>(
+    params: GenerateParams<T> & { output: T; experimental_output?: never },
+  ): Promise<GenerateReturn<T>>;
+  generate<T extends JSONSchema7 | ZodSchema | undefined = undefined>(
+    params: GenerateParams<T> & { output?: never; experimental_output: T },
+  ): Promise<GenerateReturn<T>>;
   generate<T extends JSONSchema7 | ZodSchema | undefined = undefined>(
     params: GenerateParams<T>,
   ): Promise<GenerateReturn<T>> {

package/src/types.ts

@@ -8,7 +8,7 @@ import type {
   LegacyWorkflowRuns,
 } from '@mastra/core';
 import type { AgentGenerateOptions, AgentStreamOptions, ToolsInput } from '@mastra/core/agent';
-import type { BaseLogMessage } from '@mastra/core/logger';
+import type { BaseLogMessage, LogLevel } from '@mastra/core/logger';
 
 import type { MCPToolType, ServerInfo } from '@mastra/core/mcp';
 import type { RuntimeContext } from '@mastra/core/runtime-context';
@@ -217,14 +217,32 @@ export interface GetMemoryThreadMessagesResponse {
 
 export interface GetLogsParams {
   transportId: string;
+  fromDate?: Date;
+  toDate?: Date;
+  logLevel?: LogLevel;
+  filters?: Record<string, string>;
+  page?: number;
+  perPage?: number;
 }
 
 export interface GetLogParams {
   runId: string;
   transportId: string;
+  fromDate?: Date;
+  toDate?: Date;
+  logLevel?: LogLevel;
+  filters?: Record<string, string>;
+  page?: number;
+  perPage?: number;
 }
 
-export type GetLogsResponse = BaseLogMessage[];
+export type GetLogsResponse = {
+  logs: BaseLogMessage[];
+  total: number;
+  page: number;
+  perPage: number;
+  hasMore: boolean;
+};
 
 export type RequestFunction = (path: string, options?: RequestOptions) => Promise<any>;