@mastra/client-js 0.0.0-fix-persist-session-cache-option-mcp-server-20251031182703 → 0.0.0-fix-9244-clickhouse-metadata-20251104220626

package/dist/index.cjs

@@ -203,7 +203,6 @@ var BaseResource = class {
 async function executeToolCallAndRespond({
   response,
   params,
-  runId,
   resourceId,
   threadId,
   requestContext,
@@ -217,22 +216,18 @@ async function executeToolCallAndRespond({
     for (const toolCall of toolCalls) {
       const clientTool = params.clientTools?.[toolCall.toolName];
       if (clientTool && clientTool.execute) {
-        const result = await clientTool.execute(
-          {
-            context: toolCall?.args,
-            runId,
-            resourceId,
-            threadId,
-            requestContext,
-            tracingContext: { currentSpan: void 0 },
-            suspend: async () => {
-            }
-          },
-          {
+        const result = await clientTool.execute(toolCall?.args, {
+          requestContext,
+          tracingContext: { currentSpan: void 0 },
+          agent: {
             messages: response.messages,
-            toolCallId: toolCall?.toolCallId
+            toolCallId: toolCall?.toolCallId,
+            suspend: async () => {
+            },
+            threadId,
+            resourceId
           }
-        );
+        });
         const updatedMessages = [
           ...response.response.messages || [],
           {
@@ -342,7 +337,7 @@ var Agent = class extends BaseResource {
       requestContext: parseClientRequestContext(params.requestContext),
       clientTools: processClientTools(params.clientTools)
     };
-    const { runId, resourceId, threadId, requestContext } = processedParams;
+    const { resourceId, threadId, requestContext } = processedParams;
     const response = await this.request(
       `/api/agents/${this.agentId}/generate-legacy`,
       {
@@ -358,22 +353,18 @@ var Agent = class extends BaseResource {
       for (const toolCall of toolCalls) {
         const clientTool = params.clientTools?.[toolCall.toolName];
         if (clientTool && clientTool.execute) {
-          const result = await clientTool.execute(
-            {
-              context: toolCall?.args,
-              runId,
-              resourceId,
-              threadId,
-              requestContext,
-              tracingContext: { currentSpan: void 0 },
-              suspend: async () => {
-              }
-            },
-            {
+          const result = await clientTool.execute(toolCall?.args, {
+            requestContext,
+            tracingContext: { currentSpan: void 0 },
+            agent: {
               messages: response.messages,
-              toolCallId: toolCall?.toolCallId
+              toolCallId: toolCall?.toolCallId,
+              suspend: async () => {
+              },
+              threadId,
+              resourceId
             }
-          );
+          });
           const updatedMessages = [
             ...response.response.messages,
             {
@@ -416,7 +407,7 @@ var Agent = class extends BaseResource {
         schema: zodToJsonSchema(params.structuredOutput.schema)
       } : void 0
     };
-    const { runId, resourceId, threadId, requestContext } = processedParams;
+    const { resourceId, threadId, requestContext } = processedParams;
     const response = await this.request(
       `/api/agents/${this.agentId}/generate`,
       {
@@ -428,7 +419,6 @@ var Agent = class extends BaseResource {
       return executeToolCallAndRespond({
         response,
         params,
-        runId,
         resourceId,
         threadId,
         requestContext,
@@ -1048,23 +1038,19 @@ var Agent = class extends BaseResource {
               const clientTool = processedParams.clientTools?.[toolCall2.toolName];
               if (clientTool && clientTool.execute) {
                 shouldExecuteClientTool = true;
-                const result = await clientTool.execute(
-                  {
-                    context: toolCall2?.args,
-                    runId: processedParams.runId,
-                    resourceId: processedParams.resourceId,
-                    threadId: processedParams.threadId,
-                    requestContext: processedParams.requestContext,
-                    // TODO: Pass proper tracing context when client-js supports tracing
-                    tracingContext: { currentSpan: void 0 },
-                    suspend: async () => {
-                    }
-                  },
-                  {
+                const result = await clientTool.execute(toolCall2?.args, {
+                  requestContext: processedParams.requestContext,
+                  // TODO: Pass proper tracing context when client-js supports tracing
+                  tracingContext: { currentSpan: void 0 },
+                  agent: {
                     messages: response.messages,
-                    toolCallId: toolCall2?.toolCallId
+                    toolCallId: toolCall2?.toolCallId,
+                    suspend: async () => {
+                    },
+                    threadId: processedParams.threadId,
+                    resourceId: processedParams.resourceId
                   }
-                );
+                });
                 const lastMessageRaw = messages[messages.length - 1];
                 const lastMessage = lastMessageRaw != null ? JSON.parse(JSON.stringify(lastMessageRaw)) : void 0;
                 const toolInvocationPart = lastMessage?.parts?.find(
@@ -1252,23 +1238,19 @@ var Agent = class extends BaseResource {
             for (const toolCall2 of toolCalls) {
               const clientTool = processedParams.clientTools?.[toolCall2.toolName];
               if (clientTool && clientTool.execute) {
-                const result = await clientTool.execute(
-                  {
-                    context: toolCall2?.args,
-                    runId: processedParams.runId,
-                    resourceId: processedParams.resourceId,
-                    threadId: processedParams.threadId,
-                    requestContext: processedParams.requestContext,
-                    // TODO: Pass proper tracing context when client-js supports tracing
-                    tracingContext: { currentSpan: void 0 },
-                    suspend: async () => {
-                    }
-                  },
-                  {
+                const result = await clientTool.execute(toolCall2?.args, {
+                  requestContext: processedParams.requestContext,
+                  // TODO: Pass proper tracing context when client-js supports tracing
+                  tracingContext: { currentSpan: void 0 },
+                  agent: {
                     messages: response.messages,
-                    toolCallId: toolCall2?.toolCallId
+                    toolCallId: toolCall2?.toolCallId,
+                    suspend: async () => {
+                    },
+                    threadId: processedParams.threadId,
+                    resourceId: processedParams.resourceId
                   }
-                );
+                });
                 const lastMessage = JSON.parse(JSON.stringify(messages[messages.length - 1]));
                 const toolInvocationPart = lastMessage?.parts?.find(
                   (part) => part.type === "tool-invocation" && part.toolInvocation?.toolCallId === toolCall2.toolCallId
@@ -1393,12 +1375,6 @@ var Agent = class extends BaseResource {
       body: params
     });
   }
-  async generateVNext(_messagesOrParams, _options) {
-    throw new Error("generateVNext has been renamed to generate. Please use generate instead.");
-  }
-  async streamVNext(_messagesOrParams, _options) {
-    throw new Error("streamVNext has been renamed to stream. Please use stream instead.");
-  }
 };
 
 // src/resources/memory-thread.ts
@@ -1446,9 +1422,9 @@ var MemoryThread = class extends BaseResource {
     );
   }
   /**
-   * Retrieves messages associated with the thread
+   * Retrieves messages associated with the thread (always returns mastra-db format)
    * @param params - Optional parameters including limit for number of messages to retrieve and request context
-   * @returns Promise containing thread messages and UI messages
+   * @returns Promise containing thread messages in mastra-db format
    */
   getMessages(params) {
     const query = new URLSearchParams({
@@ -1460,19 +1436,20 @@ var MemoryThread = class extends BaseResource {
     );
   }
   /**
-   * Retrieves paginated messages associated with the thread with advanced filtering and selection options
-   * @param params - Pagination parameters including selectBy criteria, page, perPage, date ranges, message inclusion options, and request context
+   * Retrieves paginated messages associated with the thread with filtering and ordering options
+   * @param params - Pagination parameters including page, perPage, orderBy, filter, include options, and request context
    * @returns Promise containing paginated thread messages with pagination metadata (total, page, perPage, hasMore)
    */
-  getMessagesPaginated({
-    selectBy,
-    requestContext,
-    ...rest
-  }) {
-    const query = new URLSearchParams({
-      ...rest,
-      ...selectBy ? { selectBy: JSON.stringify(selectBy) } : {}
-    });
+  listMessages(params = {}) {
+    const { page, perPage, orderBy, filter, include, resourceId, requestContext } = params;
+    const queryParams = {};
+    if (resourceId) queryParams.resourceId = resourceId;
+    if (page !== void 0) queryParams.page = String(page);
+    if (perPage !== void 0) queryParams.perPage = String(perPage);
+    if (orderBy) queryParams.orderBy = JSON.stringify(orderBy);
+    if (filter) queryParams.filter = JSON.stringify(filter);
+    if (include) queryParams.include = JSON.stringify(include);
+    const query = new URLSearchParams(queryParams);
     return this.request(
       `/api/memory/threads/${this.threadId}/messages/paginated?${query.toString()}${requestContextQueryString(requestContext, "&")}`
     );
@@ -1610,51 +1587,6 @@ var Workflow = class extends BaseResource {
     super(options);
     this.workflowId = workflowId;
   }
-  /**
-   * Creates an async generator that processes a readable stream and yields workflow records
-   * separated by the Record Separator character (\x1E)
-   *
-   * @param stream - The readable stream to process
-   * @returns An async generator that yields parsed records
-   */
-  async *streamProcessor(stream) {
-    const reader = stream.getReader();
-    let doneReading = false;
-    let buffer = "";
-    try {
-      while (!doneReading) {
-        const { done, value } = await reader.read();
-        doneReading = done;
-        if (done && !value) continue;
-        try {
-          const decoded = value ? new TextDecoder().decode(value) : "";
-          const chunks = (buffer + decoded).split(RECORD_SEPARATOR);
-          buffer = chunks.pop() || "";
-          for (const chunk of chunks) {
-            if (chunk) {
-              if (typeof chunk === "string") {
-                try {
-                  const parsedChunk = JSON.parse(chunk);
-                  yield parsedChunk;
-                } catch {
-                }
-              }
-            }
-          }
-        } catch {
-        }
-      }
-      if (buffer) {
-        try {
-          yield JSON.parse(buffer);
-        } catch {
-        }
-      }
-    } finally {
-      reader.cancel().catch(() => {
-      });
-    }
-  }
   /**
    * Retrieves details about the workflow
    * @param requestContext - Optional request context to pass as query parameter
@@ -1678,11 +1610,15 @@ var Workflow = class extends BaseResource {
     if (params?.toDate) {
       searchParams.set("toDate", params.toDate.toISOString());
     }
-    if (params?.limit !== null && params?.limit !== void 0 && !isNaN(Number(params?.limit))) {
-      searchParams.set("limit", String(params.limit));
+    if (params?.perPage !== null && params?.perPage !== void 0) {
+      if (params.perPage === false) {
+        searchParams.set("perPage", "false");
+      } else if (typeof params.perPage === "number" && params.perPage > 0 && Number.isInteger(params.perPage)) {
+        searchParams.set("perPage", String(params.perPage));
+      }
     }
-    if (params?.offset !== null && params?.offset !== void 0 && !isNaN(Number(params?.offset))) {
-      searchParams.set("offset", String(params.offset));
+    if (params?.page !== null && params?.page !== void 0 && !isNaN(Number(params?.page))) {
+      searchParams.set("page", String(params.page));
     }
     if (params?.resourceId) {
       searchParams.set("resourceId", params.resourceId);
@@ -1737,21 +1673,12 @@ var Workflow = class extends BaseResource {
       body: { event: params.event, data: params.data }
     });
   }
-  /**
-   * @deprecated Use createRunAsync() instead.
-   * @throws {Error} Always throws an error directing users to use createRunAsync()
-   */
-  async createRun(_params) {
-    throw new Error(
-      "createRun() has been deprecated. Please use createRunAsync() instead.\n\nMigration guide:\n  Before: const run = workflow.createRun();\n  After:  const run = await workflow.createRunAsync();\n\nNote: createRunAsync() is an async method, so make sure your calling function is async."
-    );
-  }
   /**
    * Creates a new workflow run
    * @param params - Optional object containing the optional runId
    * @returns Promise containing the runId of the created run with methods to control execution
    */
-  async createRunAsync(params) {
+  async createRun(params) {
     const searchParams = new URLSearchParams();
     if (!!params?.runId) {
       searchParams.set("runId", params.runId);
@@ -1781,9 +1708,6 @@ var Workflow = class extends BaseResource {
           tracingOptions: p.tracingOptions
         });
       },
-      watch: async (onRecord) => {
-        return this.watch({ runId }, onRecord);
-      },
       stream: async (p) => {
         return this.stream({ runId, inputData: p.inputData, requestContext: p.requestContext });
       },
@@ -2138,29 +2062,6 @@ var Workflow = class extends BaseResource {
     });
     return response.body.pipeThrough(transformStream);
   }
-  /**
-   * Watches workflow transitions in real-time
-   * @param runId - Optional run ID to filter the watch stream
-   * @returns AsyncGenerator that yields parsed records from the workflow watch stream
-   */
-  async watch({ runId }, onRecord) {
-    const response = await this.request(`/api/workflows/${this.workflowId}/watch?runId=${runId}`, {
-      stream: true
-    });
-    if (!response.ok) {
-      throw new Error(`Failed to watch workflow: ${response.statusText}`);
-    }
-    if (!response.body) {
-      throw new Error("Response body is null");
-    }
-    for await (const record of this.streamProcessor(response.body)) {
-      if (typeof record === "string") {
-        onRecord(JSON.parse(record));
-      } else {
-        onRecord(record);
-      }
-    }
-  }
   /**
    * Creates a new ReadableStream from an iterable or async iterable of objects,
    * serializing each as JSON and separating them with the record separator (\x1E).
@@ -2361,20 +2262,11 @@ var AgentBuilder = class extends BaseResource {
       }
     });
   }
-  /**
-   * @deprecated Use createRunAsync() instead.
-   * @throws {Error} Always throws an error directing users to use createRunAsync()
-   */
-  async createRun(_params) {
-    throw new Error(
-      "createRun() has been deprecated. Please use createRunAsync() instead.\n\nMigration guide:\n  Before: const run = agentBuilder.createRun();\n  After:  const run = await agentBuilder.createRunAsync();\n\nNote: createRunAsync() is an async method, so make sure your calling function is async."
-    );
-  }
   /**
    * Creates a new agent builder action run and returns the runId.
    * This calls `/api/agent-builder/:actionId/create-run`.
    */
-  async createRunAsync(params) {
+  async createRun(params) {
     const searchParams = new URLSearchParams();
     if (!!params?.runId) {
       searchParams.set("runId", params.runId);
@@ -2543,32 +2435,6 @@ var AgentBuilder = class extends BaseResource {
     }
     return response.body.pipeThrough(this.createRecordParserTransform());
   }
-  /**
-   * Watches an existing agent builder action run by runId.
-   * This is used for hot reload recovery - it loads the existing run state
-   * and streams any remaining progress.
-   * This calls `/api/agent-builder/:actionId/watch`.
-   */
-  async watch({ runId, eventType }, onRecord) {
-    const url = `/api/agent-builder/${this.actionId}/watch?runId=${runId}${eventType ? `&eventType=${eventType}` : ""}`;
-    const response = await this.request(url, {
-      method: "GET",
-      stream: true
-    });
-    if (!response.ok) {
-      throw new Error(`Failed to watch agent builder action: ${response.statusText}`);
-    }
-    if (!response.body) {
-      throw new Error("Response body is null");
-    }
-    for await (const record of this.streamProcessor(response.body)) {
-      if (typeof record === "string") {
-        onRecord(JSON.parse(record));
-      } else {
-        onRecord(record);
-      }
-    }
-  }
   /**
    * Observes an existing agent builder action run stream.
    * Replays cached execution from the beginning, then continues with live stream.
@@ -2686,11 +2552,11 @@ var AgentBuilder = class extends BaseResource {
     if (params?.toDate) {
       searchParams.set("toDate", params.toDate.toISOString());
     }
-    if (params?.limit !== void 0) {
-      searchParams.set("limit", String(params.limit));
+    if (params?.perPage !== void 0) {
+      searchParams.set("perPage", String(params.perPage));
     }
-    if (params?.offset !== void 0) {
-      searchParams.set("offset", String(params.offset));
+    if (params?.page !== void 0) {
+      searchParams.set("page", String(params.page));
     }
     if (params?.resourceId) {
       searchParams.set("resourceId", params.resourceId);
@@ -2787,7 +2653,7 @@ var Observability = class extends BaseResource {
    * @param params - Parameters containing trace ID, span ID, and pagination options
    * @returns Promise containing scores and pagination info
    */
-  getScoresBySpan(params) {
+  listScoresBySpan(params) {
     const { traceId, spanId, page, perPage } = params;
     const searchParams = new URLSearchParams();
     if (page !== void 0) {
@@ -2850,8 +2716,8 @@ var MastraClient = class extends BaseResource {
     const queryParams = new URLSearchParams({
       resourceId: params.resourceId,
       agentId: params.agentId,
-      ...params.offset !== void 0 && { offset: params.offset.toString() },
-      ...params.limit !== void 0 && { limit: params.limit.toString() },
+      ...params.page !== void 0 && { page: params.page.toString() },
+      ...params.perPage !== void 0 && { perPage: params.perPage.toString() },
       ...params.orderBy && { orderBy: params.orderBy },
       ...params.sortDirection && { sortDirection: params.sortDirection }
     });
@@ -3091,16 +2957,16 @@ var MastraClient = class extends BaseResource {
   }
   /**
    * Retrieves a list of available MCP servers.
-   * @param params - Optional parameters for pagination (limit, offset).
+   * @param params - Optional parameters for pagination (perPage, page).
    * @returns Promise containing the list of MCP servers and pagination info.
    */
   getMcpServers(params) {
     const searchParams = new URLSearchParams();
-    if (params?.limit !== void 0) {
-      searchParams.set("limit", String(params.limit));
+    if (params?.perPage !== void 0) {
+      searchParams.set("perPage", String(params.perPage));
     }
-    if (params?.offset !== void 0) {
-      searchParams.set("offset", String(params.offset));
+    if (params?.page !== void 0) {
+      searchParams.set("page", String(params.page));
     }
     const queryString = searchParams.toString();
     return this.request(`/api/mcp/v0/servers${queryString ? `?${queryString}` : ""}`);
@@ -3223,7 +3089,7 @@ var MastraClient = class extends BaseResource {
   getScorer(scorerId) {
     return this.request(`/api/scores/scorers/${encodeURIComponent(scorerId)}`);
   }
-  getScoresByScorerId(params) {
+  listScoresByScorerId(params) {
     const { page, perPage, scorerId, entityId, entityType } = params;
     const searchParams = new URLSearchParams();
     if (entityId) {
@@ -3246,7 +3112,7 @@ var MastraClient = class extends BaseResource {
    * @param params - Parameters containing run ID and pagination options
    * @returns Promise containing scores and pagination info
    */
-  getScoresByRunId(params) {
+  listScoresByRunId(params) {
     const { runId, page, perPage } = params;
     const searchParams = new URLSearchParams();
     if (page !== void 0) {
@@ -3263,7 +3129,7 @@ var MastraClient = class extends BaseResource {
    * @param params - Parameters containing entity ID, type, and pagination options
    * @returns Promise containing scores and pagination info
    */
-  getScoresByEntityId(params) {
+  listScoresByEntityId(params) {
     const { entityId, entityType, page, perPage } = params;
     const searchParams = new URLSearchParams();
     if (page !== void 0) {
@@ -3288,21 +3154,14 @@ var MastraClient = class extends BaseResource {
       body: params
     });
   }
-  /**
-   * Retrieves model providers with available keys
-   * @returns Promise containing model providers with available keys
-   */
-  getModelProviders() {
-    return this.request(`/api/model-providers`);
-  }
   getAITrace(traceId) {
     return this.observability.getTrace(traceId);
   }
   getAITraces(params) {
     return this.observability.getTraces(params);
   }
-  getScoresBySpan(params) {
-    return this.observability.getScoresBySpan(params);
+  listScoresBySpan(params) {
+    return this.observability.listScoresBySpan(params);
   }
   score(params) {
     return this.observability.score(params);