@mastra/client-js 0.10.2-alpha.2 → 0.10.3-alpha.0

package/.turbo/turbo-build.log

@@ -1,19 +1,19 @@
 
-> @mastra/client-js@0.10.2-alpha.2 build /home/runner/work/mastra/mastra/client-sdks/client-js
+> @mastra/client-js@0.10.3-alpha.0 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
-ESM dist/index.js 43.65 KB
-ESM ⚡️ Build success in 1542ms
-CJS dist/index.cjs 43.94 KB
-CJS ⚡️ Build success in 1549ms
+ESM dist/index.js 46.36 KB
+ESM ⚡️ Build success in 2170ms
+CJS dist/index.cjs 46.65 KB
+CJS ⚡️ Build success in 2178ms
 DTS Build start
-DTS ⚡️ Build success in 14713ms
-DTS dist/index.d.ts  31.92 KB
-DTS dist/index.d.cts 31.92 KB
+DTS ⚡️ Build success in 16147ms
+DTS dist/index.d.ts  32.85 KB
+DTS dist/index.d.cts 32.85 KB

package/CHANGELOG.md

@@ -1,5 +1,60 @@
 # @mastra/client-js
 
+## 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
+
+- 592a2db: Added different icons for agents and workflows in mcp tools list
+- 37643b8: Fix tool access
+- c5bf1ce: Add backwards compat code for new MessageList in storage
+- b72c768: [Bug fix] Serialize parameters in clientTools
+- f0d559f: Fix peerdeps for alpha channel
+- Updated dependencies [ee77e78]
+- Updated dependencies [592a2db]
+- Updated dependencies [e5dc18d]
+- Updated dependencies [ab5adbe]
+- Updated dependencies [1e8bb40]
+- Updated dependencies [1b5fc55]
+- Updated dependencies [195c428]
+- Updated dependencies [f73e11b]
+- Updated dependencies [37643b8]
+- Updated dependencies [99fd6cf]
+- Updated dependencies [c5bf1ce]
+- Updated dependencies [add596e]
+- Updated dependencies [8dc94d8]
+- Updated dependencies [ecebbeb]
+- Updated dependencies [79d5145]
+- Updated dependencies [12b7002]
+- Updated dependencies [2901125]
+  - @mastra/core@0.10.2
+
+## 0.10.2-alpha.3
+
+### Patch Changes
+
+- 37643b8: Fix tool access
+- b72c768: [Bug fix] Serialize parameters in clientTools
+- Updated dependencies [37643b8]
+- Updated dependencies [79d5145]
+  - @mastra/core@0.10.2-alpha.8
+
 ## 0.10.2-alpha.2
 
 ### Patch Changes

package/dist/index.cjs

@@ -5,6 +5,7 @@ var rxjs = require('rxjs');
 var uiUtils = require('@ai-sdk/ui-utils');
 var zod = require('zod');
 var originalZodToJsonSchema = require('zod-to-json-schema');
+var tools = require('@mastra/core/tools');
 var runtimeContext = require('@mastra/core/runtime-context');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
@@ -202,6 +203,33 @@ function zodToJsonSchema(zodSchema) {
   }
   return originalZodToJsonSchema__default.default(zodSchema, { $refStrategy: "none" });
 }
+function processClientTools(clientTools) {
+  if (!clientTools) {
+    return void 0;
+  }
+  return Object.fromEntries(
+    Object.entries(clientTools).map(([key, value]) => {
+      if (tools.isVercelTool(value)) {
+        return [
+          key,
+          {
+            ...value,
+            parameters: value.parameters ? zodToJsonSchema(value.parameters) : void 0
+          }
+        ];
+      } else {
+        return [
+          key,
+          {
+            ...value,
+            inputSchema: value.inputSchema ? zodToJsonSchema(value.inputSchema) : void 0,
+            outputSchema: value.outputSchema ? zodToJsonSchema(value.outputSchema) : void 0
+          }
+        ];
+      }
+    })
+  );
+}
 
 // src/resources/base.ts
 var BaseResource = class {
@@ -340,17 +368,13 @@ 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,
       output: params.output ? zodToJsonSchema(params.output) : void 0,
       experimental_output: params.experimental_output ? zodToJsonSchema(params.experimental_output) : void 0,
-      runtimeContext: parseClientRuntimeContext(params.runtimeContext)
+      runtimeContext: parseClientRuntimeContext(params.runtimeContext),
+      clientTools: processClientTools(params.clientTools)
     };
     return this.request(`/api/agents/${this.agentId}/generate`, {
       method: "POST",
@@ -367,7 +391,8 @@ var Agent = class extends BaseResource {
       ...params,
       output: params.output ? zodToJsonSchema(params.output) : void 0,
       experimental_output: params.experimental_output ? zodToJsonSchema(params.experimental_output) : void 0,
-      runtimeContext: parseClientRuntimeContext(params.runtimeContext)
+      runtimeContext: parseClientRuntimeContext(params.runtimeContext),
+      clientTools: processClientTools(params.clientTools)
     };
     const response = await this.request(`/api/agents/${this.agentId}/stream`, {
       method: "POST",
@@ -1316,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
@@ -1324,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

@@ -4,8 +4,8 @@ import { processDataStream } from '@ai-sdk/ui-utils';
 import { CoreMessage, AiMessageType, StorageThreadType, MastraMessageV1, LegacyWorkflowRuns, WorkflowRuns, QueryResult, GenerateReturn } from '@mastra/core';
 import { JSONSchema7 } from 'json-schema';
 import { ZodSchema } from 'zod';
-import { AgentGenerateOptions, AgentStreamOptions } from '@mastra/core/agent';
-import { BaseLogMessage } from '@mastra/core/logger';
+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 { StepAction, StepGraph, LegacyWorkflowRunResult as LegacyWorkflowRunResult$1 } from '@mastra/core/workflows/legacy';
@@ -51,13 +51,15 @@ type GenerateParams<T extends JSONSchema7 | ZodSchema | undefined = undefined> =
     output?: T;
     experimental_output?: T;
     runtimeContext?: RuntimeContext | Record<string, any>;
-} & WithoutMethods<Omit<AgentGenerateOptions<T>, 'output' | 'experimental_output' | 'runtimeContext'>>;
+    clientTools?: ToolsInput;
+} & WithoutMethods<Omit<AgentGenerateOptions<T>, 'output' | 'experimental_output' | 'runtimeContext' | 'clientTools'>>;
 type StreamParams<T extends JSONSchema7 | ZodSchema | undefined = undefined> = {
     messages: string | string[] | CoreMessage[] | AiMessageType[];
     output?: T;
     experimental_output?: T;
     runtimeContext?: RuntimeContext | Record<string, any>;
-} & WithoutMethods<Omit<AgentStreamOptions<T>, 'output' | 'experimental_output' | 'runtimeContext'>>;
+    clientTools?: ToolsInput;
+} & WithoutMethods<Omit<AgentStreamOptions<T>, 'output' | 'experimental_output' | 'runtimeContext' | 'clientTools'>>;
 interface GetEvalsByAgentIdResponse extends GetAgentResponse {
     evals: any[];
     instructions: string;
@@ -179,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;
@@ -329,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

@@ -4,8 +4,8 @@ import { processDataStream } from '@ai-sdk/ui-utils';
 import { CoreMessage, AiMessageType, StorageThreadType, MastraMessageV1, LegacyWorkflowRuns, WorkflowRuns, QueryResult, GenerateReturn } from '@mastra/core';
 import { JSONSchema7 } from 'json-schema';
 import { ZodSchema } from 'zod';
-import { AgentGenerateOptions, AgentStreamOptions } from '@mastra/core/agent';
-import { BaseLogMessage } from '@mastra/core/logger';
+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 { StepAction, StepGraph, LegacyWorkflowRunResult as LegacyWorkflowRunResult$1 } from '@mastra/core/workflows/legacy';
@@ -51,13 +51,15 @@ type GenerateParams<T extends JSONSchema7 | ZodSchema | undefined = undefined> =
     output?: T;
     experimental_output?: T;
     runtimeContext?: RuntimeContext | Record<string, any>;
-} & WithoutMethods<Omit<AgentGenerateOptions<T>, 'output' | 'experimental_output' | 'runtimeContext'>>;
+    clientTools?: ToolsInput;
+} & WithoutMethods<Omit<AgentGenerateOptions<T>, 'output' | 'experimental_output' | 'runtimeContext' | 'clientTools'>>;
 type StreamParams<T extends JSONSchema7 | ZodSchema | undefined = undefined> = {
     messages: string | string[] | CoreMessage[] | AiMessageType[];
     output?: T;
     experimental_output?: T;
     runtimeContext?: RuntimeContext | Record<string, any>;
-} & WithoutMethods<Omit<AgentStreamOptions<T>, 'output' | 'experimental_output' | 'runtimeContext'>>;
+    clientTools?: ToolsInput;
+} & WithoutMethods<Omit<AgentStreamOptions<T>, 'output' | 'experimental_output' | 'runtimeContext' | 'clientTools'>>;
 interface GetEvalsByAgentIdResponse extends GetAgentResponse {
     evals: any[];
     instructions: string;
@@ -179,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;
@@ -329,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

@@ -3,6 +3,7 @@ import { Observable } from 'rxjs';
 import { processDataStream } from '@ai-sdk/ui-utils';
 import { ZodSchema } from 'zod';
 import originalZodToJsonSchema from 'zod-to-json-schema';
+import { isVercelTool } from '@mastra/core/tools';
 import { RuntimeContext } from '@mastra/core/runtime-context';
 
 // src/adapters/agui.ts
@@ -196,6 +197,33 @@ function zodToJsonSchema(zodSchema) {
   }
   return originalZodToJsonSchema(zodSchema, { $refStrategy: "none" });
 }
+function processClientTools(clientTools) {
+  if (!clientTools) {
+    return void 0;
+  }
+  return Object.fromEntries(
+    Object.entries(clientTools).map(([key, value]) => {
+      if (isVercelTool(value)) {
+        return [
+          key,
+          {
+            ...value,
+            parameters: value.parameters ? zodToJsonSchema(value.parameters) : void 0
+          }
+        ];
+      } else {
+        return [
+          key,
+          {
+            ...value,
+            inputSchema: value.inputSchema ? zodToJsonSchema(value.inputSchema) : void 0,
+            outputSchema: value.outputSchema ? zodToJsonSchema(value.outputSchema) : void 0
+          }
+        ];
+      }
+    })
+  );
+}
 
 // src/resources/base.ts
 var BaseResource = class {
@@ -334,17 +362,13 @@ 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,
       output: params.output ? zodToJsonSchema(params.output) : void 0,
       experimental_output: params.experimental_output ? zodToJsonSchema(params.experimental_output) : void 0,
-      runtimeContext: parseClientRuntimeContext(params.runtimeContext)
+      runtimeContext: parseClientRuntimeContext(params.runtimeContext),
+      clientTools: processClientTools(params.clientTools)
     };
     return this.request(`/api/agents/${this.agentId}/generate`, {
       method: "POST",
@@ -361,7 +385,8 @@ var Agent = class extends BaseResource {
       ...params,
       output: params.output ? zodToJsonSchema(params.output) : void 0,
       experimental_output: params.experimental_output ? zodToJsonSchema(params.experimental_output) : void 0,
-      runtimeContext: parseClientRuntimeContext(params.runtimeContext)
+      runtimeContext: parseClientRuntimeContext(params.runtimeContext),
+      clientTools: processClientTools(params.clientTools)
     };
     const response = await this.request(`/api/agents/${this.agentId}/stream`, {
       method: "POST",
@@ -1310,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
@@ -1318,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-alpha.2",
+  "version": "0.10.3-alpha.0",
   "description": "The official TypeScript library for the Mastra Client API",
   "author": "",
   "type": "module",
@@ -27,23 +27,22 @@
     "json-schema": "^0.4.0",
     "rxjs": "7.8.1",
     "zod": "^3.24.3",
-    "zod-to-json-schema": "^3.24.5"
+    "zod-to-json-schema": "^3.24.5",
+    "@mastra/core": "0.10.4-alpha.0"
   },
   "peerDependencies": {
-    "zod": "^3.0.0",
-    "@mastra/core": "^0.10.0-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.7",
-    "@mastra/core": "0.10.2-alpha.4"
+    "@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

@@ -1,8 +1,9 @@
 import { processDataStream } from '@ai-sdk/ui-utils';
-import type { GenerateReturn } from '@mastra/core';
+import { type GenerateReturn } from '@mastra/core';
 import type { JSONSchema7 } from 'json-schema';
 import { ZodSchema } from 'zod';
 import { zodToJsonSchema } from '../utils/zod-to-json-schema';
+import { processClientTools } from '../utils/process-client-tools';
 
 import type {
   GenerateParams,
@@ -104,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>> {
@@ -112,6 +122,7 @@ export class Agent extends BaseResource {
       output: params.output ? zodToJsonSchema(params.output) : undefined,
       experimental_output: params.experimental_output ? zodToJsonSchema(params.experimental_output) : undefined,
       runtimeContext: parseClientRuntimeContext(params.runtimeContext),
+      clientTools: processClientTools(params.clientTools),
     };
 
     return this.request(`/api/agents/${this.agentId}/generate`, {
@@ -137,6 +148,7 @@ export class Agent extends BaseResource {
       output: params.output ? zodToJsonSchema(params.output) : undefined,
       experimental_output: params.experimental_output ? zodToJsonSchema(params.experimental_output) : undefined,
       runtimeContext: parseClientRuntimeContext(params.runtimeContext),
+      clientTools: processClientTools(params.clientTools),
     };
 
     const response: Response & {

package/src/types.ts

@@ -7,8 +7,8 @@ import type {
   WorkflowRuns,
   LegacyWorkflowRuns,
 } from '@mastra/core';
-import type { AgentGenerateOptions, AgentStreamOptions } from '@mastra/core/agent';
-import type { BaseLogMessage } from '@mastra/core/logger';
+import type { AgentGenerateOptions, AgentStreamOptions, ToolsInput } from '@mastra/core/agent';
+import type { BaseLogMessage, LogLevel } from '@mastra/core/logger';
 
 import type { MCPToolType, ServerInfo } from '@mastra/core/mcp';
 import type { RuntimeContext } from '@mastra/core/runtime-context';
@@ -69,14 +69,16 @@ export type GenerateParams<T extends JSONSchema7 | ZodSchema | undefined = undef
   output?: T;
   experimental_output?: T;
   runtimeContext?: RuntimeContext | Record<string, any>;
-} & WithoutMethods<Omit<AgentGenerateOptions<T>, 'output' | 'experimental_output' | 'runtimeContext'>>;
+  clientTools?: ToolsInput;
+} & WithoutMethods<Omit<AgentGenerateOptions<T>, 'output' | 'experimental_output' | 'runtimeContext' | 'clientTools'>>;
 
 export type StreamParams<T extends JSONSchema7 | ZodSchema | undefined = undefined> = {
   messages: string | string[] | CoreMessage[] | AiMessageType[];
   output?: T;
   experimental_output?: T;
   runtimeContext?: RuntimeContext | Record<string, any>;
-} & WithoutMethods<Omit<AgentStreamOptions<T>, 'output' | 'experimental_output' | 'runtimeContext'>>;
+  clientTools?: ToolsInput;
+} & WithoutMethods<Omit<AgentStreamOptions<T>, 'output' | 'experimental_output' | 'runtimeContext' | 'clientTools'>>;
 
 export interface GetEvalsByAgentIdResponse extends GetAgentResponse {
   evals: any[];
@@ -215,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>;
 

package/src/utils/process-client-tools.ts

@@ -0,0 +1,31 @@
+import { isVercelTool } from '@mastra/core/tools';
+import { zodToJsonSchema } from './zod-to-json-schema';
+
+export function processClientTools(clientTools: Record<string, any> | undefined): Record<string, any> | undefined {
+  if (!clientTools) {
+    return undefined;
+  }
+
+  return Object.fromEntries(
+    Object.entries(clientTools).map(([key, value]) => {
+      if (isVercelTool(value)) {
+        return [
+          key,
+          {
+            ...value,
+            parameters: value.parameters ? zodToJsonSchema(value.parameters) : undefined,
+          },
+        ];
+      } else {
+        return [
+          key,
+          {
+            ...value,
+            inputSchema: value.inputSchema ? zodToJsonSchema(value.inputSchema) : undefined,
+            outputSchema: value.outputSchema ? zodToJsonSchema(value.outputSchema) : undefined,
+          },
+        ];
+      }
+    }),
+  ) as Record<string, any>;
+}