@mastra/client-js 0.16.7 → 0.16.9-alpha.0

package/dist/index.js

@@ -22,13 +22,13 @@ function base64RuntimeContext(runtimeContext) {
   }
   return void 0;
 }
-function runtimeContextQueryString(runtimeContext) {
+function runtimeContextQueryString(runtimeContext, delimiter = "?") {
   const runtimeContextParam = base64RuntimeContext(parseClientRuntimeContext(runtimeContext));
   if (!runtimeContextParam) return "";
   const searchParams = new URLSearchParams();
   searchParams.set("runtimeContext", runtimeContextParam);
   const queryString = searchParams.toString();
-  return queryString ? `?${queryString}` : "";
+  return queryString ? `${delimiter}${queryString}` : "";
 }
 function isZodType(value) {
   return typeof value === "object" && value !== null && "_def" in value && "parse" in value && typeof value.parse === "function" && "safeParse" in value && typeof value.safeParse === "function";
@@ -1368,6 +1368,15 @@ var Agent = class extends BaseResource {
       body: params
     });
   }
+  /**
+   * Resets the agent's model to the original model that was set during construction
+   * @returns Promise containing a success message
+   */
+  resetModel() {
+    return this.request(`/api/agents/${this.agentId}/model/reset`, {
+      method: "POST"
+    });
+  }
   /**
    * Updates the model for the agent in the model list
    * @param params - Parameters for updating the model
@@ -1407,34 +1416,44 @@ var MemoryThread = class extends BaseResource {
   }
   /**
    * Retrieves the memory thread details
+   * @param runtimeContext - Optional runtime context to pass as query parameter
    * @returns Promise containing thread details including title and metadata
    */
-  get() {
-    return this.request(`/api/memory/threads/${this.threadId}?agentId=${this.agentId}`);
+  get(runtimeContext) {
+    return this.request(
+      `/api/memory/threads/${this.threadId}?agentId=${this.agentId}${runtimeContextQueryString(runtimeContext, "&")}`
+    );
   }
   /**
    * Updates the memory thread properties
-   * @param params - Update parameters including title and metadata
+   * @param params - Update parameters including title, metadata, and optional runtime context
    * @returns Promise containing updated thread details
    */
   update(params) {
-    return this.request(`/api/memory/threads/${this.threadId}?agentId=${this.agentId}`, {
-      method: "PATCH",
-      body: params
-    });
+    return this.request(
+      `/api/memory/threads/${this.threadId}?agentId=${this.agentId}${runtimeContextQueryString(params.runtimeContext, "&")}`,
+      {
+        method: "PATCH",
+        body: params
+      }
+    );
   }
   /**
    * Deletes the memory thread
+   * @param runtimeContext - Optional runtime context to pass as query parameter
    * @returns Promise containing deletion result
    */
-  delete() {
-    return this.request(`/api/memory/threads/${this.threadId}?agentId=${this.agentId}`, {
-      method: "DELETE"
-    });
+  delete(runtimeContext) {
+    return this.request(
+      `/api/memory/threads/${this.threadId}?agentId=${this.agentId}${runtimeContextQueryString(runtimeContext, "&")}`,
+      {
+        method: "DELETE"
+      }
+    );
   }
   /**
    * Retrieves messages associated with the thread
-   * @param params - Optional parameters including limit for number of messages to retrieve
+   * @param params - Optional parameters including limit for number of messages to retrieve and runtime context
    * @returns Promise containing thread messages and UI messages
    */
   getMessages(params) {
@@ -1442,37 +1461,46 @@ var MemoryThread = class extends BaseResource {
       agentId: this.agentId,
       ...params?.limit ? { limit: params.limit.toString() } : {}
     });
-    return this.request(`/api/memory/threads/${this.threadId}/messages?${query.toString()}`);
+    return this.request(
+      `/api/memory/threads/${this.threadId}/messages?${query.toString()}${runtimeContextQueryString(params?.runtimeContext, "&")}`
+    );
   }
   /**
    * Retrieves paginated messages associated with the thread with advanced filtering and selection options
-   * @param params - Pagination parameters including selectBy criteria, page, perPage, date ranges, and message inclusion options
+   * @param params - Pagination parameters including selectBy criteria, page, perPage, date ranges, message inclusion options, and runtime context
    * @returns Promise containing paginated thread messages with pagination metadata (total, page, perPage, hasMore)
    */
   getMessagesPaginated({
     selectBy,
+    runtimeContext,
     ...rest
   }) {
     const query = new URLSearchParams({
       ...rest,
       ...selectBy ? { selectBy: JSON.stringify(selectBy) } : {}
     });
-    return this.request(`/api/memory/threads/${this.threadId}/messages/paginated?${query.toString()}`);
+    return this.request(
+      `/api/memory/threads/${this.threadId}/messages/paginated?${query.toString()}${runtimeContextQueryString(runtimeContext, "&")}`
+    );
   }
   /**
    * Deletes one or more messages from the thread
    * @param messageIds - Can be a single message ID (string), array of message IDs,
    *                     message object with id property, or array of message objects
+   * @param runtimeContext - Optional runtime context to pass as query parameter
    * @returns Promise containing deletion result
    */
-  deleteMessages(messageIds) {
+  deleteMessages(messageIds, runtimeContext) {
     const query = new URLSearchParams({
       agentId: this.agentId
     });
-    return this.request(`/api/memory/messages/delete?${query.toString()}`, {
-      method: "POST",
-      body: { messageIds }
-    });
+    return this.request(
+      `/api/memory/messages/delete?${query.toString()}${runtimeContextQueryString(runtimeContext, "&")}`,
+      {
+        method: "POST",
+        body: { messageIds }
+      }
+    );
   }
 };
 
@@ -2813,27 +2841,34 @@ var MastraClient = class extends BaseResource {
   }
   /**
    * Retrieves memory threads for a resource
-   * @param params - Parameters containing the resource ID
+   * @param params - Parameters containing the resource ID and optional runtime context
    * @returns Promise containing array of memory threads
    */
   getMemoryThreads(params) {
-    return this.request(`/api/memory/threads?resourceid=${params.resourceId}&agentId=${params.agentId}`);
+    return this.request(
+      `/api/memory/threads?resourceid=${params.resourceId}&agentId=${params.agentId}${runtimeContextQueryString(params.runtimeContext, "&")}`
+    );
   }
   /**
    * Retrieves memory config for a resource
-   * @param params - Parameters containing the resource ID
-   * @returns Promise containing array of memory threads
+   * @param params - Parameters containing the resource ID and optional runtime context
+   * @returns Promise containing memory configuration
    */
   getMemoryConfig(params) {
-    return this.request(`/api/memory/config?agentId=${params.agentId}`);
+    return this.request(
+      `/api/memory/config?agentId=${params.agentId}${runtimeContextQueryString(params.runtimeContext, "&")}`
+    );
   }
   /**
    * Creates a new memory thread
-   * @param params - Parameters for creating the memory thread
+   * @param params - Parameters for creating the memory thread including optional runtime context
    * @returns Promise containing the created memory thread
    */
   createMemoryThread(params) {
-    return this.request(`/api/memory/threads?agentId=${params.agentId}`, { method: "POST", body: params });
+    return this.request(
+      `/api/memory/threads?agentId=${params.agentId}${runtimeContextQueryString(params.runtimeContext, "&")}`,
+      { method: "POST", body: params }
+    );
   }
   /**
    * Gets a memory thread instance by ID
@@ -2846,38 +2881,43 @@ var MastraClient = class extends BaseResource {
   getThreadMessages(threadId, opts = {}) {
     let url = "";
     if (opts.agentId) {
-      url = `/api/memory/threads/${threadId}/messages?agentId=${opts.agentId}`;
+      url = `/api/memory/threads/${threadId}/messages?agentId=${opts.agentId}${runtimeContextQueryString(opts.runtimeContext, "&")}`;
     } else if (opts.networkId) {
-      url = `/api/memory/network/threads/${threadId}/messages?networkId=${opts.networkId}`;
+      url = `/api/memory/network/threads/${threadId}/messages?networkId=${opts.networkId}${runtimeContextQueryString(opts.runtimeContext, "&")}`;
     }
     return this.request(url);
   }
   deleteThread(threadId, opts = {}) {
     let url = "";
     if (opts.agentId) {
-      url = `/api/memory/threads/${threadId}?agentId=${opts.agentId}`;
+      url = `/api/memory/threads/${threadId}?agentId=${opts.agentId}${runtimeContextQueryString(opts.runtimeContext, "&")}`;
     } else if (opts.networkId) {
-      url = `/api/memory/network/threads/${threadId}?networkId=${opts.networkId}`;
+      url = `/api/memory/network/threads/${threadId}?networkId=${opts.networkId}${runtimeContextQueryString(opts.runtimeContext, "&")}`;
     }
     return this.request(url, { method: "DELETE" });
   }
   /**
    * Saves messages to memory
-   * @param params - Parameters containing messages to save
+   * @param params - Parameters containing messages to save and optional runtime context
    * @returns Promise containing the saved messages
    */
   saveMessageToMemory(params) {
-    return this.request(`/api/memory/save-messages?agentId=${params.agentId}`, {
-      method: "POST",
-      body: params
-    });
+    return this.request(
+      `/api/memory/save-messages?agentId=${params.agentId}${runtimeContextQueryString(params.runtimeContext, "&")}`,
+      {
+        method: "POST",
+        body: params
+      }
+    );
   }
   /**
    * Gets the status of the memory system
+   * @param agentId - The agent ID
+   * @param runtimeContext - Optional runtime context to pass as query parameter
    * @returns Promise containing memory system status
    */
-  getMemoryStatus(agentId) {
-    return this.request(`/api/memory/status?agentId=${agentId}`);
+  getMemoryStatus(agentId, runtimeContext) {
+    return this.request(`/api/memory/status?agentId=${agentId}${runtimeContextQueryString(runtimeContext, "&")}`);
   }
   /**
    * Retrieves memory threads for a resource
@@ -3189,9 +3229,12 @@ var MastraClient = class extends BaseResource {
   getWorkingMemory({
     agentId,
     threadId,
-    resourceId
+    resourceId,
+    runtimeContext
   }) {
-    return this.request(`/api/memory/threads/${threadId}/working-memory?agentId=${agentId}&resourceId=${resourceId}`);
+    return this.request(
+      `/api/memory/threads/${threadId}/working-memory?agentId=${agentId}&resourceId=${resourceId}${runtimeContextQueryString(runtimeContext, "&")}`
+    );
   }
   /**
    * Updates the working memory for a specific thread (optionally resource-scoped).
@@ -3204,15 +3247,19 @@ var MastraClient = class extends BaseResource {
     agentId,
     threadId,
     workingMemory,
-    resourceId
+    resourceId,
+    runtimeContext
   }) {
-    return this.request(`/api/memory/threads/${threadId}/working-memory?agentId=${agentId}`, {
-      method: "POST",
-      body: {
-        workingMemory,
-        resourceId
+    return this.request(
+      `/api/memory/threads/${threadId}/working-memory?agentId=${agentId}${runtimeContextQueryString(runtimeContext, "&")}`,
+      {
+        method: "POST",
+        body: {
+          workingMemory,
+          resourceId
+        }
       }
-    });
+    );
   }
   /**
    * Retrieves all available scorers
@@ -3294,13 +3341,6 @@ 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);
   }