@mastra/client-js 1.10.1-alpha.4 → 1.11.0-alpha.6

package/dist/index.js

@@ -329,11 +329,22 @@ async function executeToolCallAndRespond({
   return response;
 }
 var AgentVoice = class extends BaseResource {
-  constructor(options, agentId) {
+  constructor(options, agentId, version) {
     super(options);
     this.agentId = agentId;
+    this.version = version;
     this.agentId = agentId;
   }
+  getQueryString(requestContext, delimiter = "?") {
+    const searchParams = new URLSearchParams(requestContextQueryString(requestContext).slice(1));
+    if (this.version) {
+      new URLSearchParams(toQueryParams(this.version)).forEach((value, key) => {
+        searchParams.set(key, value);
+      });
+    }
+    const queryString = searchParams.toString();
+    return queryString ? `${delimiter}${queryString}` : "";
+  }
   /**
    * Convert text to speech using the agent's voice provider
    * @param text - Text to convert to speech
@@ -374,7 +385,7 @@ var AgentVoice = class extends BaseResource {
    * @returns Promise containing list of available speakers
    */
   getSpeakers(requestContext) {
-    return this.request(`/agents/${this.agentId}/voice/speakers${requestContextQueryString(requestContext)}`);
+    return this.request(`/agents/${this.agentId}/voice/speakers${this.getQueryString(requestContext)}`);
   }
   /**
    * Get the listener configuration for the agent's voice provider
@@ -383,23 +394,34 @@ var AgentVoice = class extends BaseResource {
    * @returns Promise containing a check if the agent has listening capabilities
    */
   getListener(requestContext) {
-    return this.request(`/agents/${this.agentId}/voice/listener${requestContextQueryString(requestContext)}`);
+    return this.request(`/agents/${this.agentId}/voice/listener${this.getQueryString(requestContext)}`);
   }
 };
 var Agent = class extends BaseResource {
-  constructor(options, agentId) {
+  constructor(options, agentId, version) {
     super(options);
     this.agentId = agentId;
-    this.voice = new AgentVoice(options, this.agentId);
+    this.version = version;
+    this.voice = new AgentVoice(options, this.agentId, this.version);
   }
   voice;
+  getQueryString(requestContext, delimiter = "?") {
+    const searchParams = new URLSearchParams(requestContextQueryString(requestContext).slice(1));
+    if (this.version) {
+      new URLSearchParams(toQueryParams(this.version)).forEach((value, key) => {
+        searchParams.set(key, value);
+      });
+    }
+    const queryString = searchParams.toString();
+    return queryString ? `${delimiter}${queryString}` : "";
+  }
   /**
    * Retrieves details about the agent
    * @param requestContext - Optional request context to pass as query parameter
    * @returns Promise containing agent details including model and instructions
    */
   details(requestContext) {
-    return this.request(`/agents/${this.agentId}${requestContextQueryString(requestContext)}`);
+    return this.request(`/agents/${this.agentId}${this.getQueryString(requestContext)}`);
   }
   enhanceInstructions(instructions, comment) {
     return this.request(`/agents/${this.agentId}/instructions/enhance`, {
@@ -422,6 +444,108 @@ var Agent = class extends BaseResource {
       }
     });
   }
+  /**
+   * Lists all override versions for this code agent
+   * @param params - Optional pagination and sorting parameters
+   * @param requestContext - Optional request context to pass as query parameter
+   * @returns Promise containing paginated list of versions
+   */
+  listVersions(params, requestContext) {
+    const queryParams = new URLSearchParams();
+    if (params?.page !== void 0) queryParams.set("page", String(params.page));
+    if (params?.perPage !== void 0) queryParams.set("perPage", String(params.perPage));
+    if (params?.orderBy) queryParams.set("orderBy", params.orderBy);
+    if (params?.sortDirection) queryParams.set("sortDirection", params.sortDirection);
+    const queryString = queryParams.toString();
+    const contextString = requestContextQueryString(requestContext);
+    return this.request(
+      `/stored/agents/${encodeURIComponent(this.agentId)}/versions${queryString ? `?${queryString}` : ""}${contextString ? `${queryString ? "&" : "?"}${contextString.slice(1)}` : ""}`
+    );
+  }
+  /**
+   * Creates a new override version snapshot for this code agent
+   * @param params - Optional override fields and change message for the version
+   * @param requestContext - Optional request context to pass as query parameter
+   * @returns Promise containing the created version
+   */
+  createVersion(params, requestContext) {
+    return this.request(
+      `/stored/agents/${encodeURIComponent(this.agentId)}/versions${requestContextQueryString(requestContext)}`,
+      {
+        method: "POST",
+        body: params || {}
+      }
+    );
+  }
+  /**
+   * Retrieves a specific override version by its ID
+   * @param versionId - The UUID of the version to retrieve
+   * @param requestContext - Optional request context to pass as query parameter
+   * @returns Promise containing the version details
+   */
+  getVersion(versionId, requestContext) {
+    return this.request(
+      `/stored/agents/${encodeURIComponent(this.agentId)}/versions/${encodeURIComponent(versionId)}${requestContextQueryString(requestContext)}`
+    );
+  }
+  /**
+   * Activates a specific override version for this code agent
+   * @param versionId - The UUID of the version to activate
+   * @param requestContext - Optional request context to pass as query parameter
+   * @returns Promise containing the activated version details
+   */
+  activateVersion(versionId, requestContext) {
+    return this.request(
+      `/stored/agents/${encodeURIComponent(this.agentId)}/versions/${encodeURIComponent(versionId)}/activate${requestContextQueryString(requestContext)}`,
+      {
+        method: "POST"
+      }
+    );
+  }
+  /**
+   * Restores a version by creating a new override version with the same configuration
+   * @param versionId - The UUID of the version to restore
+   * @param requestContext - Optional request context to pass as query parameter
+   * @returns Promise containing the newly created version
+   */
+  restoreVersion(versionId, requestContext) {
+    return this.request(
+      `/stored/agents/${encodeURIComponent(this.agentId)}/versions/${encodeURIComponent(versionId)}/restore${requestContextQueryString(requestContext)}`,
+      {
+        method: "POST"
+      }
+    );
+  }
+  /**
+   * Deletes a specific override version
+   * @param versionId - The UUID of the version to delete
+   * @param requestContext - Optional request context to pass as query parameter
+   * @returns Promise that resolves with deletion response
+   */
+  deleteVersion(versionId, requestContext) {
+    return this.request(
+      `/stored/agents/${encodeURIComponent(this.agentId)}/versions/${encodeURIComponent(versionId)}${requestContextQueryString(requestContext)}`,
+      {
+        method: "DELETE"
+      }
+    );
+  }
+  /**
+   * Compares two override versions and returns their differences
+   * @param fromId - The UUID of the source version
+   * @param toId - The UUID of the target version
+   * @param requestContext - Optional request context to pass as query parameter
+   * @returns Promise containing the comparison results
+   */
+  compareVersions(fromId, toId, requestContext) {
+    const queryParams = new URLSearchParams();
+    queryParams.set("from", fromId);
+    queryParams.set("to", toId);
+    const contextString = requestContextQueryString(requestContext);
+    return this.request(
+      `/stored/agents/${encodeURIComponent(this.agentId)}/versions/compare?${queryParams.toString()}${contextString ? `&${contextString.slice(1)}` : ""}`
+    );
+  }
   async generateLegacy(params) {
     const processedParams = {
       ...params,
@@ -1515,7 +1639,7 @@ var Agent = class extends BaseResource {
    * @returns Promise containing tool details
    */
   getTool(toolId, requestContext) {
-    return this.request(`/agents/${this.agentId}/tools/${toolId}${requestContextQueryString(requestContext)}`);
+    return this.request(`/agents/${this.agentId}/tools/${toolId}${this.getQueryString(requestContext)}`);
   }
   /**
    * Executes a tool for the agent
@@ -3935,10 +4059,11 @@ var MastraClient = class extends BaseResource {
   /**
    * Gets an agent instance by ID
    * @param agentId - ID of the agent to retrieve
+   * @param version - Optional version selector for stored agent overrides
    * @returns Agent instance
    */
-  getAgent(agentId) {
-    return new Agent(this.options, agentId);
+  getAgent(agentId, version) {
+    return new Agent(this.options, agentId, version);
   }
   /**
    * Lists memory threads with optional filtering by resourceId and/or metadata