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

package/dist/resources/observability.d.ts

@@ -1,6 +1,6 @@
 import type { ListScoresResponse, Trajectory } from '@mastra/core/evals';
 import type { SpanType } from '@mastra/core/observability';
-import type { TraceRecord, GetTraceLightResponse, GetSpanResponse, ListTracesArgs, ListTracesResponse, SpanIds, PaginationArgs, SpanRecord, PaginationInfo, ScoreTracesRequest, ScoreTracesResponse, ListLogsArgs, ListLogsResponse, ListScoresArgs, ListScoresResponse as ListScoresResponseNew, CreateScoreBody, CreateScoreResponse, GetScoreAggregateArgs, GetScoreAggregateResponse, GetScoreBreakdownArgs, GetScoreBreakdownResponse, GetScoreTimeSeriesArgs, GetScoreTimeSeriesResponse, GetScorePercentilesArgs, GetScorePercentilesResponse, ListFeedbackArgs, ListFeedbackResponse, CreateFeedbackBody, CreateFeedbackResponse, GetFeedbackAggregateArgs, GetFeedbackAggregateResponse, GetFeedbackBreakdownArgs, GetFeedbackBreakdownResponse, GetFeedbackTimeSeriesArgs, GetFeedbackTimeSeriesResponse, GetFeedbackPercentilesArgs, GetFeedbackPercentilesResponse, GetMetricAggregateArgs, GetMetricAggregateResponse, GetMetricBreakdownArgs, GetMetricBreakdownResponse, GetMetricTimeSeriesArgs, GetMetricTimeSeriesResponse, GetMetricPercentilesArgs, GetMetricPercentilesResponse, GetMetricNamesArgs, GetMetricNamesResponse, GetMetricLabelKeysArgs, GetMetricLabelKeysResponse, GetMetricLabelValuesArgs, GetMetricLabelValuesResponse, GetEntityTypesResponse, GetEntityNamesArgs, GetEntityNamesResponse, GetServiceNamesResponse, GetEnvironmentsResponse, GetTagsArgs, GetTagsResponse } from '@mastra/core/storage';
+import type { TraceRecord, GetTraceLightResponse, GetSpanResponse, ListTracesArgs, ListTracesResponse, ListBranchesArgs, ListBranchesResponse, GetBranchArgs, GetBranchResponse, SpanIds, PaginationArgs, SpanRecord, PaginationInfo, ScoreTracesRequest, ScoreTracesResponse, ListLogsArgs, ListLogsResponse, ListScoresArgs, ListScoresResponse as ListScoresResponseNew, CreateScoreBody, CreateScoreResponse, GetScoreAggregateArgs, GetScoreAggregateResponse, GetScoreBreakdownArgs, GetScoreBreakdownResponse, GetScoreTimeSeriesArgs, GetScoreTimeSeriesResponse, GetScorePercentilesArgs, GetScorePercentilesResponse, ListFeedbackArgs, ListFeedbackResponse, CreateFeedbackBody, CreateFeedbackResponse, GetFeedbackAggregateArgs, GetFeedbackAggregateResponse, GetFeedbackBreakdownArgs, GetFeedbackBreakdownResponse, GetFeedbackTimeSeriesArgs, GetFeedbackTimeSeriesResponse, GetFeedbackPercentilesArgs, GetFeedbackPercentilesResponse, GetMetricAggregateArgs, GetMetricAggregateResponse, GetMetricBreakdownArgs, GetMetricBreakdownResponse, GetMetricTimeSeriesArgs, GetMetricTimeSeriesResponse, GetMetricPercentilesArgs, GetMetricPercentilesResponse, GetMetricNamesArgs, GetMetricNamesResponse, GetMetricLabelKeysArgs, GetMetricLabelKeysResponse, GetMetricLabelValuesArgs, GetMetricLabelValuesResponse, GetEntityTypesResponse, GetEntityNamesArgs, GetEntityNamesResponse, GetServiceNamesResponse, GetEnvironmentsResponse, GetTagsArgs, GetTagsResponse } from '@mastra/core/storage';
 import type { ClientOptions } from '../types.js';
 import { BaseResource } from './base.js';
 /**
@@ -87,6 +87,28 @@ export declare class Observability extends BaseResource {
      * @returns Promise containing paginated traces and pagination info
      */
     listTraces(params?: ListTracesArgs): Promise<ListTracesResponse>;
+    /**
+     * 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?: ListBranchesArgs): Promise<ListBranchesResponse>;
+    /**
+     * 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: GetBranchArgs): Promise<GetBranchResponse>;
     /**
      * Retrieves scores by trace ID and span ID
      * @param params - Parameters containing trace ID, span ID, and pagination options

package/dist/resources/observability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../src/resources/observability.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../src/resources/observability.ts"],"names":[],"mappings":"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"}

package/dist/route-types.generated.d.ts

@@ -7475,6 +7475,253 @@ export interface GetObservabilityTraces_RouteContract {
     response: GetObservabilityTraces_Response;
     responseType: 'json';
 }
+export type GetObservabilityBranches_QueryParams = {
+    startedAt?: (({
+        /** Start of date range (inclusive by default) */
+        start?: Date | undefined;
+        /** End of date range (inclusive by default) */
+        end?: Date | undefined;
+        /** When true, excludes the start date from results (uses > instead of >=) */
+        startExclusive?: boolean | undefined;
+        /** When true, excludes the end date from results (uses < instead of <=) */
+        endExclusive?: boolean | undefined;
+    } | undefined) | undefined) | any;
+    endedAt?: (({
+        /** Start of date range (inclusive by default) */
+        start?: Date | undefined;
+        /** End of date range (inclusive by default) */
+        end?: Date | undefined;
+        /** When true, excludes the start date from results (uses > instead of >=) */
+        startExclusive?: boolean | undefined;
+        /** When true, excludes the end date from results (uses < instead of <=) */
+        endExclusive?: boolean | undefined;
+    } | undefined) | undefined) | any;
+    spanType?: (('agent_run' | 'scorer_run' | 'scorer_step' | 'generic' | 'model_generation' | 'model_step' | 'model_chunk' | 'mcp_tool_call' | 'processor_run' | 'tool_call' | 'workflow_run' | 'workflow_step' | 'workflow_conditional' | 'workflow_conditional_eval' | 'workflow_parallel' | 'workflow_loop' | 'workflow_sleep' | 'workflow_wait_event' | 'memory_operation' | 'workspace_action' | 'rag_ingestion' | 'rag_embedding' | 'rag_vector_operation' | 'rag_action' | 'graph_action') | undefined) | undefined;
+    traceId?: (string | undefined) | undefined;
+    entityType?: ((('agent' | 'scorer' | 'rag_ingestion' | 'trajectory' | 'input_processor' | 'input_step_processor' | 'output_processor' | 'output_step_processor' | 'workflow_step' | 'tool' | 'workflow_run' | 'memory') | null) | undefined) | undefined;
+    entityId?: ((string | null) | undefined) | undefined;
+    entityName?: ((string | null) | undefined) | undefined;
+    parentEntityType?: ((('agent' | 'scorer' | 'rag_ingestion' | 'trajectory' | 'input_processor' | 'input_step_processor' | 'output_processor' | 'output_step_processor' | 'workflow_step' | 'tool' | 'workflow_run' | 'memory') | null) | undefined) | undefined;
+    parentEntityId?: ((string | null) | undefined) | undefined;
+    parentEntityName?: ((string | null) | undefined) | undefined;
+    rootEntityType?: ((('agent' | 'scorer' | 'rag_ingestion' | 'trajectory' | 'input_processor' | 'input_step_processor' | 'output_processor' | 'output_step_processor' | 'workflow_step' | 'tool' | 'workflow_run' | 'memory') | null) | undefined) | undefined;
+    rootEntityId?: ((string | null) | undefined) | undefined;
+    rootEntityName?: ((string | null) | undefined) | undefined;
+    userId?: ((string | null) | undefined) | undefined;
+    organizationId?: ((string | null) | undefined) | undefined;
+    resourceId?: ((string | null) | undefined) | undefined;
+    runId?: ((string | null) | undefined) | undefined;
+    sessionId?: ((string | null) | undefined) | undefined;
+    threadId?: ((string | null) | undefined) | undefined;
+    requestId?: ((string | null) | undefined) | undefined;
+    environment?: ((string | null) | undefined) | undefined;
+    serviceName?: ((string | null) | undefined) | undefined;
+    scope?: ((({
+        [key: string]: unknown;
+    } | null) | undefined) | undefined) | any;
+    entityVersionId?: ((string | null) | undefined) | undefined;
+    parentEntityVersionId?: ((string | null) | undefined) | undefined;
+    rootEntityVersionId?: ((string | null) | undefined) | undefined;
+    experimentId?: ((string | null) | undefined) | undefined;
+    source?: ((string | null) | undefined) | undefined;
+    metadata?: ((({
+        [key: string]: unknown;
+    } | null) | undefined) | undefined) | any;
+    tags?: (((string[] | null) | undefined) | undefined) | any;
+    status?: (('success' | 'error' | 'running') | undefined) | undefined;
+    page?: (number | undefined) | undefined;
+    perPage?: (number | undefined) | undefined;
+    field?: ('startedAt' | 'endedAt') | undefined;
+    direction?: ('ASC' | 'DESC') | undefined;
+};
+export type GetObservabilityBranches_Response = {
+    pagination: {
+        /** Total number of items available */
+        total: number;
+        /** Current page */
+        page: number;
+        /** Number of items per page, or false if pagination is disabled */
+        perPage: number | false;
+        /** True if more pages are available */
+        hasMore: boolean;
+    };
+    branches: {
+        /** Unique trace identifier */
+        traceId: string;
+        /** Unique span identifier within a trace */
+        spanId: string;
+        /** Human-readable span name */
+        name: string;
+        /** Span type (e.g., WORKFLOW_RUN, AGENT_RUN, TOOL_CALL, etc.) */
+        spanType: 'agent_run' | 'scorer_run' | 'scorer_step' | 'generic' | 'model_generation' | 'model_step' | 'model_chunk' | 'mcp_tool_call' | 'processor_run' | 'tool_call' | 'workflow_run' | 'workflow_step' | 'workflow_conditional' | 'workflow_conditional_eval' | 'workflow_parallel' | 'workflow_loop' | 'workflow_sleep' | 'workflow_wait_event' | 'memory_operation' | 'workspace_action' | 'rag_ingestion' | 'rag_embedding' | 'rag_vector_operation' | 'rag_action' | 'graph_action';
+        /** Whether this is an event (point-in-time) vs a span (duration) */
+        isEvent: boolean;
+        /** When the span started */
+        startedAt: Date;
+        parentSpanId?: (string | null) | undefined;
+        entityType?: (('agent' | 'scorer' | 'rag_ingestion' | 'trajectory' | 'input_processor' | 'input_step_processor' | 'output_processor' | 'output_step_processor' | 'workflow_step' | 'tool' | 'workflow_run' | 'memory') | null) | undefined;
+        entityId?: (string | null) | undefined;
+        entityName?: (string | null) | undefined;
+        parentEntityType?: (('agent' | 'scorer' | 'rag_ingestion' | 'trajectory' | 'input_processor' | 'input_step_processor' | 'output_processor' | 'output_step_processor' | 'workflow_step' | 'tool' | 'workflow_run' | 'memory') | null) | undefined;
+        parentEntityId?: (string | null) | undefined;
+        parentEntityName?: (string | null) | undefined;
+        rootEntityType?: (('agent' | 'scorer' | 'rag_ingestion' | 'trajectory' | 'input_processor' | 'input_step_processor' | 'output_processor' | 'output_step_processor' | 'workflow_step' | 'tool' | 'workflow_run' | 'memory') | null) | undefined;
+        rootEntityId?: (string | null) | undefined;
+        rootEntityName?: (string | null) | undefined;
+        userId?: (string | null) | undefined;
+        organizationId?: (string | null) | undefined;
+        resourceId?: (string | null) | undefined;
+        runId?: (string | null) | undefined;
+        sessionId?: (string | null) | undefined;
+        threadId?: (string | null) | undefined;
+        requestId?: (string | null) | undefined;
+        environment?: (string | null) | undefined;
+        serviceName?: (string | null) | undefined;
+        scope?: ({
+            [key: string]: unknown;
+        } | null) | undefined;
+        entityVersionId?: (string | null) | undefined;
+        parentEntityVersionId?: (string | null) | undefined;
+        rootEntityVersionId?: (string | null) | undefined;
+        /** Experiment or eval run identifier */
+        experimentId?: (string | null) | undefined;
+        source?: (string | null) | undefined;
+        metadata?: ({
+            [key: string]: unknown;
+        } | null) | undefined;
+        tags?: (string[] | null) | undefined;
+        attributes?: ({
+            [key: string]: unknown;
+        } | null) | undefined;
+        links?: (unknown[] | null) | undefined;
+        input?: (unknown | null) | undefined;
+        output?: (unknown | null) | undefined;
+        error?: (unknown | null) | undefined;
+        endedAt?: (Date | null) | undefined;
+        /** Request context data */
+        requestContext?: ({
+            [key: string]: unknown;
+        } | null) | undefined;
+        /** Database record creation time */
+        createdAt: Date;
+        updatedAt: Date | null;
+        /** Current status of the trace */
+        status: 'success' | 'error' | 'running';
+    }[];
+};
+export type GetObservabilityBranches_Request = Simplify<(never extends never ? {} : {
+    params: never;
+}) & (GetObservabilityBranches_QueryParams extends never ? {} : {} extends GetObservabilityBranches_QueryParams ? {
+    query?: GetObservabilityBranches_QueryParams;
+} : {
+    query: GetObservabilityBranches_QueryParams;
+}) & (never extends never ? {} : {} extends never ? {
+    body?: never;
+} : {
+    body: never;
+})>;
+export interface GetObservabilityBranches_RouteContract {
+    pathParams: never;
+    queryParams: GetObservabilityBranches_QueryParams;
+    body: never;
+    request: GetObservabilityBranches_Request;
+    response: GetObservabilityBranches_Response;
+    responseType: 'json';
+}
+export type GetObservabilityTracesTraceIdBranchesSpanId_PathParams = {
+    /** Unique trace identifier */
+    traceId: string;
+    /** Unique span identifier within a trace */
+    spanId: string;
+};
+export type GetObservabilityTracesTraceIdBranchesSpanId_QueryParams = {
+    /** Maximum descendant levels below the anchor span (omit for full subtree) */
+    depth?: number | undefined;
+};
+export type GetObservabilityTracesTraceIdBranchesSpanId_Response = {
+    /** Unique trace identifier */
+    traceId: string;
+    spans: {
+        /** Unique trace identifier */
+        traceId: string;
+        /** Unique span identifier within a trace */
+        spanId: string;
+        /** Human-readable span name */
+        name: string;
+        /** Span type (e.g., WORKFLOW_RUN, AGENT_RUN, TOOL_CALL, etc.) */
+        spanType: 'agent_run' | 'scorer_run' | 'scorer_step' | 'generic' | 'model_generation' | 'model_step' | 'model_chunk' | 'mcp_tool_call' | 'processor_run' | 'tool_call' | 'workflow_run' | 'workflow_step' | 'workflow_conditional' | 'workflow_conditional_eval' | 'workflow_parallel' | 'workflow_loop' | 'workflow_sleep' | 'workflow_wait_event' | 'memory_operation' | 'workspace_action' | 'rag_ingestion' | 'rag_embedding' | 'rag_vector_operation' | 'rag_action' | 'graph_action';
+        /** Whether this is an event (point-in-time) vs a span (duration) */
+        isEvent: boolean;
+        /** When the span started */
+        startedAt: Date;
+        parentSpanId?: (string | null) | undefined;
+        entityType?: (('agent' | 'scorer' | 'rag_ingestion' | 'trajectory' | 'input_processor' | 'input_step_processor' | 'output_processor' | 'output_step_processor' | 'workflow_step' | 'tool' | 'workflow_run' | 'memory') | null) | undefined;
+        entityId?: (string | null) | undefined;
+        entityName?: (string | null) | undefined;
+        parentEntityType?: (('agent' | 'scorer' | 'rag_ingestion' | 'trajectory' | 'input_processor' | 'input_step_processor' | 'output_processor' | 'output_step_processor' | 'workflow_step' | 'tool' | 'workflow_run' | 'memory') | null) | undefined;
+        parentEntityId?: (string | null) | undefined;
+        parentEntityName?: (string | null) | undefined;
+        rootEntityType?: (('agent' | 'scorer' | 'rag_ingestion' | 'trajectory' | 'input_processor' | 'input_step_processor' | 'output_processor' | 'output_step_processor' | 'workflow_step' | 'tool' | 'workflow_run' | 'memory') | null) | undefined;
+        rootEntityId?: (string | null) | undefined;
+        rootEntityName?: (string | null) | undefined;
+        userId?: (string | null) | undefined;
+        organizationId?: (string | null) | undefined;
+        resourceId?: (string | null) | undefined;
+        runId?: (string | null) | undefined;
+        sessionId?: (string | null) | undefined;
+        threadId?: (string | null) | undefined;
+        requestId?: (string | null) | undefined;
+        environment?: (string | null) | undefined;
+        serviceName?: (string | null) | undefined;
+        scope?: ({
+            [key: string]: unknown;
+        } | null) | undefined;
+        entityVersionId?: (string | null) | undefined;
+        parentEntityVersionId?: (string | null) | undefined;
+        rootEntityVersionId?: (string | null) | undefined;
+        /** Experiment or eval run identifier */
+        experimentId?: (string | null) | undefined;
+        source?: (string | null) | undefined;
+        metadata?: ({
+            [key: string]: unknown;
+        } | null) | undefined;
+        tags?: (string[] | null) | undefined;
+        attributes?: ({
+            [key: string]: unknown;
+        } | null) | undefined;
+        links?: (unknown[] | null) | undefined;
+        input?: (unknown | null) | undefined;
+        output?: (unknown | null) | undefined;
+        error?: (unknown | null) | undefined;
+        endedAt?: (Date | null) | undefined;
+        /** Request context data */
+        requestContext?: ({
+            [key: string]: unknown;
+        } | null) | undefined;
+        /** Database record creation time */
+        createdAt: Date;
+        updatedAt: Date | null;
+    }[];
+};
+export type GetObservabilityTracesTraceIdBranchesSpanId_Request = Simplify<(GetObservabilityTracesTraceIdBranchesSpanId_PathParams extends never ? {} : {
+    params: GetObservabilityTracesTraceIdBranchesSpanId_PathParams;
+}) & (GetObservabilityTracesTraceIdBranchesSpanId_QueryParams extends never ? {} : {} extends GetObservabilityTracesTraceIdBranchesSpanId_QueryParams ? {
+    query?: GetObservabilityTracesTraceIdBranchesSpanId_QueryParams;
+} : {
+    query: GetObservabilityTracesTraceIdBranchesSpanId_QueryParams;
+}) & (never extends never ? {} : {} extends never ? {
+    body?: never;
+} : {
+    body: never;
+})>;
+export interface GetObservabilityTracesTraceIdBranchesSpanId_RouteContract {
+    pathParams: GetObservabilityTracesTraceIdBranchesSpanId_PathParams;
+    queryParams: GetObservabilityTracesTraceIdBranchesSpanId_QueryParams;
+    body: never;
+    request: GetObservabilityTracesTraceIdBranchesSpanId_Request;
+    response: GetObservabilityTracesTraceIdBranchesSpanId_Response;
+    responseType: 'json';
+}
 export type GetObservabilityTracesTraceId_PathParams = {
     /** Unique trace identifier */
     traceId: string;
@@ -40726,6 +40973,8 @@ export interface GetBackgroundTasksBackgroundTaskId_RouteContract {
 export type GetSchedules_QueryParams = {
     workflowId?: string | undefined;
     status?: ('active' | 'paused') | undefined;
+    ownerType?: string | undefined;
+    ownerId?: string | undefined;
 };
 export type GetSchedules_Response = {
     schedules: {
@@ -40755,6 +41004,8 @@ export type GetSchedules_Response = {
         metadata?: {
             [key: string]: unknown;
         } | undefined;
+        ownerType?: string | undefined;
+        ownerId?: string | undefined;
         createdAt: number;
         updatedAt: number;
     }[];
@@ -40808,6 +41059,8 @@ export type GetSchedulesScheduleId_Response = {
     metadata?: {
         [key: string]: unknown;
     } | undefined;
+    ownerType?: string | undefined;
+    ownerId?: string | undefined;
     createdAt: number;
     updatedAt: number;
 };
@@ -40840,12 +41093,18 @@ export type GetSchedulesScheduleIdTriggers_QueryParams = {
 };
 export type GetSchedulesScheduleIdTriggers_Response = {
     triggers: {
+        id?: string | undefined;
         scheduleId: string;
-        runId: string;
+        runId: string | null;
         scheduledFireAt: number;
         actualFireAt: number;
-        status: 'published' | 'failed';
+        outcome: 'published' | 'failed' | 'skipped' | 'acked' | 'alerted' | 'deferred' | 'appended-from-queue' | 'dropped-stale' | 'dropped-superseded' | 'dropped-busy';
         error?: string | undefined;
+        triggerKind?: ('schedule-fire' | 'queue-drain') | undefined;
+        parentTriggerId?: string | undefined;
+        metadata?: {
+            [key: string]: unknown;
+        } | undefined;
         run?: {
             status: 'running' | 'success' | 'failed' | 'tripwire' | 'suspended' | 'waiting' | 'pending' | 'canceled' | 'bailed' | 'paused';
             startedAt?: number | undefined;
@@ -40904,6 +41163,8 @@ export type PostSchedulesScheduleIdPause_Response = {
     metadata?: {
         [key: string]: unknown;
     } | undefined;
+    ownerType?: string | undefined;
+    ownerId?: string | undefined;
     createdAt: number;
     updatedAt: number;
 };
@@ -40956,6 +41217,8 @@ export type PostSchedulesScheduleIdResume_Response = {
     metadata?: {
         [key: string]: unknown;
     } | undefined;
+    ownerType?: string | undefined;
+    ownerId?: string | undefined;
     createdAt: number;
     updatedAt: number;
 };
@@ -41236,6 +41499,8 @@ export interface RouteTypes {
     'GET /scores/entity/:entityType/:entityId': GetScoresEntityEntityTypeEntityId_RouteContract;
     'POST /scores': PostScores_RouteContract;
     'GET /observability/traces': GetObservabilityTraces_RouteContract;
+    'GET /observability/branches': GetObservabilityBranches_RouteContract;
+    'GET /observability/traces/:traceId/branches/:spanId': GetObservabilityTracesTraceIdBranchesSpanId_RouteContract;
     'GET /observability/traces/:traceId': GetObservabilityTracesTraceId_RouteContract;
     'GET /observability/traces/:traceId/light': GetObservabilityTracesTraceIdLight_RouteContract;
     'GET /observability/traces/:traceId/spans/:spanId': GetObservabilityTracesTraceIdSpansSpanId_RouteContract;
@@ -41808,6 +42073,9 @@ export interface Client {
         GET: GetMemoryThreadsThreadIdWorkingMemory_RouteContract;
         POST: PostMemoryThreadsThreadIdWorkingMemory_RouteContract;
     };
+    '/observability/branches': {
+        GET: GetObservabilityBranches_RouteContract;
+    };
     '/observability/discovery/entity-names': {
         GET: GetObservabilityDiscoveryEntityNames_RouteContract;
     };
@@ -41891,6 +42159,9 @@ export interface Client {
     '/observability/traces/:traceId/:spanId/scores': {
         GET: GetObservabilityTracesTraceIdSpanIdScores_RouteContract;
     };
+    '/observability/traces/:traceId/branches/:spanId': {
+        GET: GetObservabilityTracesTraceIdBranchesSpanId_RouteContract;
+    };
     '/observability/traces/:traceId/light': {
         GET: GetObservabilityTracesTraceIdLight_RouteContract;
     };