@mastra/client-js 1.17.0-alpha.2 → 1.17.0-alpha.4

package/dist/index.js

@@ -3505,6 +3505,37 @@ var Observability = class extends BaseResource {
     const queryString = toQueryParams(params, ["filters", "pagination", "orderBy"]);
     return this.request(`/observability/traces${queryString ? `?${queryString}` : ""}`);
   }
+  /**
+   * Retrieves a paginated list of trace branches with optional filtering and sorting.
+   *
+   * Each row is a single branch-anchor span (e.g., AGENT_RUN, WORKFLOW_RUN, TOOL_CALL),
+   * including ones nested under a different root entity. Use this to list every run of
+   * a given agent/workflow/tool regardless of how it was triggered. Pairs with
+   * {@link getBranch} to expand a single branch into its subtree.
+   *
+   * @param params - Parameters for pagination, filtering, and ordering
+   * @returns Promise containing paginated branch-anchor spans and pagination info
+   */
+  listBranches(params = {}) {
+    const queryString = toQueryParams(params, ["filters", "pagination", "orderBy"]);
+    return this.request(`/observability/branches${queryString ? `?${queryString}` : ""}`);
+  }
+  /**
+   * Retrieves the subtree of spans rooted at a given span.
+   *
+   * @param params - Parameters containing trace ID, span ID, and optional depth.
+   *   When `depth` is omitted the full descendant subtree is returned; with a finite
+   *   `depth` only that many levels below the anchor are returned (depth: 0 → only the
+   *   anchor span; depth: 1 → anchor plus immediate children; etc).
+   * @returns Promise containing the branch (anchor span plus descendants)
+   */
+  getBranch(params) {
+    const { traceId, spanId, depth } = params;
+    const queryString = depth !== void 0 ? `?depth=${depth}` : "";
+    return this.request(
+      `/observability/traces/${encodeURIComponent(traceId)}/branches/${encodeURIComponent(spanId)}${queryString}`
+    );
+  }
   /**
    * Retrieves scores by trace ID and span ID
    * @param params - Parameters containing trace ID, span ID, and pagination options
@@ -5221,6 +5252,27 @@ var MastraClient = class extends BaseResource {
   getMcpServerTool(serverId, toolId) {
     return new MCPTool(this.options, serverId, toolId);
   }
+  /**
+   * Lists resources available on an MCP server.
+   * @param serverId - The ID of the MCP server.
+   * @returns Promise containing the list of resources.
+   */
+  getMcpServerResources(serverId) {
+    return this.request(`/mcp/${encodeURIComponent(serverId)}/resources`);
+  }
+  /**
+   * Reads the content of a resource from an MCP server.
+   * Used for fetching ui:// MCP App HTML content.
+   * @param serverId - The ID of the MCP server.
+   * @param uri - The resource URI to read.
+   * @returns Promise containing the resource content.
+   */
+  readMcpServerResource(serverId, uri) {
+    return this.request(`/mcp/${encodeURIComponent(serverId)}/resources/read`, {
+      method: "POST",
+      body: { uri }
+    });
+  }
   /**
    * Gets an A2A client for interacting with an agent via the A2A protocol
    * @param agentId - ID of the agent to interact with
@@ -5410,6 +5462,22 @@ var MastraClient = class extends BaseResource {
   listTraces(params = {}) {
     return this.observability.listTraces(params);
   }
+  /**
+   * Retrieves a paginated list of trace branches with optional filtering and sorting.
+   * Each row is a branch-anchor span (AGENT_RUN, WORKFLOW_RUN, TOOL_CALL, etc.) including
+   * ones nested under a different root entity. Pairs with {@link getBranch} to expand
+   * a single branch into its subtree.
+   */
+  listBranches(params = {}) {
+    return this.observability.listBranches(params);
+  }
+  /**
+   * Retrieves the subtree of spans rooted at a given span. The optional `depth` field
+   * bounds descendant levels below the anchor (0 = anchor only; omitted = full subtree).
+   */
+  getBranch(params) {
+    return this.observability.getBranch(params);
+  }
   listScoresBySpan(params) {
     return this.observability.listScoresBySpan(params);
   }