@mastra/client-js 1.6.0 → 1.7.0-alpha.0

package/dist/index.js

@@ -4097,6 +4097,159 @@ var StoredAgent = class extends BaseResource {
   }
 };
 
+// src/resources/stored-prompt-block.ts
+var StoredPromptBlock = class extends BaseResource {
+  constructor(options, storedPromptBlockId) {
+    super(options);
+    this.storedPromptBlockId = storedPromptBlockId;
+  }
+  /**
+   * Retrieves details about the stored prompt block
+   * @param requestContext - Optional request context to pass as query parameter
+   * @param options - Optional options like status filter
+   * @returns Promise containing stored prompt block details
+   */
+  details(requestContext, options) {
+    const contextString = requestContextQueryString(requestContext);
+    const statusParam = options?.status ? `status=${options.status}` : "";
+    const url = `/stored/prompt-blocks/${encodeURIComponent(this.storedPromptBlockId)}${contextString}${statusParam ? `${contextString ? "&" : "?"}${statusParam}` : ""}`;
+    return this.request(url);
+  }
+  /**
+   * Updates the stored prompt block with the provided fields
+   * @param params - Fields to update
+   * @param requestContext - Optional request context to pass as query parameter
+   * @returns Promise containing the updated stored prompt block
+   */
+  update(params, requestContext) {
+    return this.request(
+      `/stored/prompt-blocks/${encodeURIComponent(this.storedPromptBlockId)}${requestContextQueryString(requestContext)}`,
+      {
+        method: "PATCH",
+        body: params
+      }
+    );
+  }
+  /**
+   * Deletes the stored prompt block
+   * @param requestContext - Optional request context to pass as query parameter
+   * @returns Promise containing deletion confirmation
+   */
+  delete(requestContext) {
+    return this.request(
+      `/stored/prompt-blocks/${encodeURIComponent(this.storedPromptBlockId)}${requestContextQueryString(requestContext)}`,
+      {
+        method: "DELETE"
+      }
+    );
+  }
+  // ==========================================================================
+  // Version Methods
+  // ==========================================================================
+  /**
+   * Lists all versions for this stored prompt block
+   * @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, queryString ? "&" : "?");
+    return this.request(
+      `/stored/prompt-blocks/${encodeURIComponent(this.storedPromptBlockId)}/versions${queryString ? `?${queryString}` : ""}${contextString}`
+    );
+  }
+  /**
+   * Creates a new version snapshot for this stored prompt block
+   * @param params - Optional name 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/prompt-blocks/${encodeURIComponent(this.storedPromptBlockId)}/versions${requestContextQueryString(requestContext)}`,
+      {
+        method: "POST",
+        body: params || {}
+      }
+    );
+  }
+  /**
+   * Retrieves a specific 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/prompt-blocks/${encodeURIComponent(this.storedPromptBlockId)}/versions/${encodeURIComponent(versionId)}${requestContextQueryString(requestContext)}`
+    );
+  }
+  /**
+   * Activates a specific version, making it the active version for this prompt block
+   * @param versionId - The UUID of the version to activate
+   * @param requestContext - Optional request context to pass as query parameter
+   * @returns Promise containing activation confirmation with success status, message, and active version ID
+   */
+  activateVersion(versionId, requestContext) {
+    return this.request(
+      `/stored/prompt-blocks/${encodeURIComponent(this.storedPromptBlockId)}/versions/${encodeURIComponent(versionId)}/activate${requestContextQueryString(requestContext)}`,
+      {
+        method: "POST"
+      }
+    );
+  }
+  /**
+   * Restores a version by creating a new 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/prompt-blocks/${encodeURIComponent(this.storedPromptBlockId)}/versions/${encodeURIComponent(versionId)}/restore${requestContextQueryString(requestContext)}`,
+      {
+        method: "POST"
+      }
+    );
+  }
+  /**
+   * Deletes a specific 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/prompt-blocks/${encodeURIComponent(this.storedPromptBlockId)}/versions/${encodeURIComponent(versionId)}${requestContextQueryString(requestContext)}`,
+      {
+        method: "DELETE"
+      }
+    );
+  }
+  /**
+   * Compares two 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/prompt-blocks/${encodeURIComponent(this.storedPromptBlockId)}/versions/compare?${queryParams.toString()}${contextString}`
+    );
+  }
+};
+
 // src/resources/stored-mcp-client.ts
 var StoredMCPClient = class extends BaseResource {
   constructor(options, storedMCPClientId) {
@@ -5288,6 +5441,61 @@ var MastraClient = class extends BaseResource {
     return new StoredAgent(this.options, storedAgentId);
   }
   // ============================================================================
+  // Stored Prompt Blocks
+  // ============================================================================
+  /**
+   * Lists all stored prompt blocks with optional pagination
+   * @param params - Optional pagination and ordering parameters
+   * @returns Promise containing paginated list of stored prompt blocks
+   */
+  listStoredPromptBlocks(params) {
+    const searchParams = new URLSearchParams();
+    if (params?.page !== void 0) {
+      searchParams.set("page", String(params.page));
+    }
+    if (params?.perPage !== void 0) {
+      searchParams.set("perPage", String(params.perPage));
+    }
+    if (params?.orderBy) {
+      if (params.orderBy.field) {
+        searchParams.set("orderBy[field]", params.orderBy.field);
+      }
+      if (params.orderBy.direction) {
+        searchParams.set("orderBy[direction]", params.orderBy.direction);
+      }
+    }
+    if (params?.authorId) {
+      searchParams.set("authorId", params.authorId);
+    }
+    if (params?.status) {
+      searchParams.set("status", params.status);
+    }
+    if (params?.metadata) {
+      searchParams.set("metadata", JSON.stringify(params.metadata));
+    }
+    const queryString = searchParams.toString();
+    return this.request(`/stored/prompt-blocks${queryString ? `?${queryString}` : ""}`);
+  }
+  /**
+   * Creates a new stored prompt block
+   * @param params - Prompt block configuration including name, content, rules, etc.
+   * @returns Promise containing the created stored prompt block
+   */
+  createStoredPromptBlock(params) {
+    return this.request("/stored/prompt-blocks", {
+      method: "POST",
+      body: params
+    });
+  }
+  /**
+   * Gets a stored prompt block instance by ID for further operations (details, update, delete)
+   * @param storedPromptBlockId - ID of the stored prompt block to retrieve
+   * @returns StoredPromptBlock instance
+   */
+  getStoredPromptBlock(storedPromptBlockId) {
+    return new StoredPromptBlock(this.options, storedPromptBlockId);
+  }
+  // ============================================================================
   // Stored Scorer Definitions
   // ============================================================================
   /**