@mastra/client-js 1.17.0-alpha.1 → 1.17.0-alpha.3

package/dist/index.d.ts

@@ -4,4 +4,5 @@ export * from './tools.js';
 export type { ChannelPlatformInfo, ChannelInstallationInfo, ChannelConnectOAuth, ChannelConnectDeepLink, ChannelConnectImmediate, ChannelConnectResult, } from './resources/channels.js';
 export { RequestContext } from '@mastra/core/request-context';
 export type { UIMessageWithMetadata } from '@mastra/core/agent';
+export type { Body, Client, ClientMethod, ClientPath, ClientRequest, ClientResponse, ClientResponseKind, ClientRoute, PathParams, QueryParams, RouteKey, RouteRequest, RouteResponse, RouteResponseType, RouteTypes, } from './route-types.generated.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EACV,IAAI,EACJ,MAAM,EACN,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,UAAU,GACX,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -1187,15 +1187,15 @@ var Agent = class extends BaseResource {
           }
           case "step-finish": {
             step += 1;
-            currentTextPart = chunk.payload.stepResult.isContinued ? currentTextPart : void 0;
+            currentTextPart = chunk.payload?.stepResult?.isContinued ? currentTextPart : void 0;
             currentReasoningPart = void 0;
             currentReasoningTextDetail = void 0;
             execUpdate();
             break;
           }
           case "finish": {
-            finishReason = chunk.payload.stepResult.reason;
-            if (chunk.payload.usage != null) {
+            finishReason = chunk.payload?.stepResult?.reason ?? finishReason;
+            if (chunk.payload?.usage != null) {
               usage = chunk.payload.usage;
             }
             break;
@@ -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
@@ -5410,6 +5441,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);
   }