@mastra/client-js 1.51.0-alpha.8 → 1.51.0

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-client-js
 description: Documentation for @mastra/client-js. Use when working with @mastra/client-js APIs, configuration, or implementation.
 metadata:
   package: "@mastra/client-js"
-  version: "1.51.0-alpha.8"
+  version: "1.51.0"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.51.0-alpha.8",
+  "version": "1.51.0",
   "package": "@mastra/client-js",
   "exports": {},
   "modules": {}

package/dist/docs/references/docs-harness-agent-controller.md

@@ -401,7 +401,7 @@ Create the session under `thread.resourceId`. Because a session can bind only th
 
 Failures that aren't refusals (a storage outage, a bug in your resolver's dependencies) still post an error to the thread, so a broken bot doesn't look like a silent one. If you need to tell them apart in your own code, a refusal is a `ChannelSessionRejectedError` with the original error as its `cause`.
 
-`resolveSession` also runs when a user answers an approval card, with that action's request context, so a shared install revalidates the person approving rather than trusting the person who sent the original message.
+`resolveSession` also runs when a user answers an approval card, with that action's request context. A shared install revalidates the person approving rather than trusting the person who sent the original message.
 
 ### Handle stale approvals
 
@@ -470,7 +470,7 @@ const subscription = await session.subscribe({
 subscription.unsubscribe()
 ```
 
-`subscribe()` takes an options object and is async, unlike the in-process listener. Its promise resolves once the stream is established and rejects when it can't connect, so a rejected call leaves nothing running in the background. `reconnect: true` re-establishes a stream that drops after it was established, with exponential backoff.
+`subscribe()` takes an options object and is async, unlike the in-process listener. Its promise resolves once the stream is established and rejects when it can't connect. A rejected call leaves nothing running in the background. `reconnect: true` re-establishes a stream that drops after it was established, with exponential backoff.
 
 The server doesn't replay events missed while the stream was down, so read `session.state()` from `onReconnect` for the current mode, model, and thread. The client surface has no `session.displayState.get()`.
 
@@ -483,4 +483,6 @@ Send work with `session.sendMessage(content)`, or `session.sendMessage({ content
 - [Agents](https://mastra.ai/docs/agents/overview)
 - [Workspace](https://mastra.ai/docs/sandbox/overview)
 - [Observational memory](https://mastra.ai/docs/memory/observational-memory)
-- [Channels](https://mastra.ai/docs/channels)
+- [Channels](https://mastra.ai/docs/channels)
+- [Mastra Code](https://code.mastra.ai)
+- [Mastra Factory](https://factory.mastra.ai)

package/dist/docs/references/docs-harness-schedules.md

@@ -73,7 +73,7 @@ Without a `threadId`, each fire is an isolated `agent.generate()` run. Nothing i
 
 ### Threaded
 
-With a `threadId`, the schedule sends a [signal](https://mastra.ai/docs/harness/signals) into that thread, so the prompt joins the agent's conversation. Threaded schedules require a `resourceId` alongside the `threadId`.
+With a `threadId`, the schedule sends a [signal](https://mastra.ai/docs/harness/signals) into that thread. The prompt joins the agent's conversation. Threaded schedules require a `resourceId` alongside the `threadId`.
 
 ```typescript
 await mastra.schedules.create({
@@ -196,6 +196,33 @@ Every hook context includes `agentId` (the agent the schedule fired for) alongsi
 
 Hook exceptions are caught and logged. They never re-route the worker or trigger another hook.
 
+## Recurring prompts in Mastra Code
+
+Mastra Code offers the `/schedules` command, which attaches a recurring prompt to the current conversation thread. Unlike `mastra.schedules`, these schedules live only in the Mastra Code process that created them: nothing is written to storage, and each fire is sent to the thread with `agent.sendSignal()` directly.
+
+Run `/schedules` to open a menu with **Create schedule** and one row per schedule on the current thread. Creating a schedule walks through these steps:
+
+1. Choose what each fire sends: a **Prompt**, a **Prompt file** that's re-read on every fire, or a **Script** that runs on every fire.
+2. Enter the prompt text or the file path. Paths resolve from the project root. For a script, you can add a prompt that's sent after the script output.
+3. Pick a cadence from `1m` to `1d`, or type one such as `20m` or `3h`. Minute steps must divide an hour and hour steps must divide a day.
+4. Confirm.
+
+Scripts run from the project root with a 60-second timeout, and their stdout, stderr, and exit code become the prompt. The extra prompt is never passed to the script.
+
+Selecting an existing schedule offers **Run now**, **Pause** or **Resume**, and **Delete**. **Run now** fires the schedule once without changing its cadence, works on paused schedules, and is skipped while a fire of the same schedule is still running.
+
+Each fire arrives on the thread as a `user`-type signal and shows in the transcript as a `schedule` entry with the schedule's id, cadence, source, and script exit status. If the thread is busy, the running agent receives the prompt as its next input, the same way a message you type mid-run does. If the thread is idle, it wakes and runs. Schedules fire on any thread in the process, not only the one focused in the terminal. After `/new`, a new schedule binds to the new thread.
+
+Things to know:
+
+- **Session scoped.** Schedules exist only in the Mastra Code process that created them and stop when it exits. Other Mastra Code processes sharing the same database never see or fire them.
+- **Clock boundaries.** `5m` fires at :00, :05, :10 and so on, not five minutes after creation, and `1d` fires at local midnight. Hour and day cadences follow wall-clock time across daylight saving changes, like cron. A fire missed while the machine slept, or one whose timer runs more than a minute late, is skipped, and the schedule resumes at the next boundary.
+- **Overlapping fires are skipped.** If a script is still running when the next boundary arrives, that fire doesn't run.
+
+### Agent schedule tools
+
+Turning on **Experimental schedule tools** in `/settings` (restart required) gives the agent tools that manage the same schedules: `schedule_create`, `schedule_list`, `schedule_update` (pause or delete), `schedule_resume`, and `schedule_run`. The tools only see and change schedules on the thread of the run that calls them. Because a schedule can run a script on every fire, `schedule_create`, `schedule_resume`, and `schedule_run` need the same approval as running a shell command unless YOLO mode is on. Schedules the agent creates are marked `created by agent` in the transcript.
+
 ## Related
 
 - [`mastra.schedules`](https://mastra.ai/reference/schedules/overview): API reference for creating and managing schedules.

package/dist/docs/references/docs-harness-signals.md

@@ -218,7 +218,7 @@ export const agentsMdReminderProcessor: Processor = {
 }
 ```
 
-Reactive signals default to `tagName: 'system-reminder'`, so the model receives this context as
+Reactive signals default to `tagName: 'system-reminder'`. The model receives this context as
 
 ```xml
 <system-reminder type="dynamic-agents-md" path="packages/ui/AGENTS.md">
@@ -411,7 +411,7 @@ export const mastra = new Mastra({
 })
 ```
 
-`RedisStreamsPubSub` implements both the event delivery contract and distributed leasing, so a single backend handles cross-instance signal delivery and lease ownership. Vercel's managed Redis integration and Upstash Redis both work well. For more on when a distributed pub/sub is needed, see the [PubSub guide](https://mastra.ai/docs/server/pubsub) and the [`RedisStreamsPubSub` reference](https://mastra.ai/reference/pubsub/redis-streams).
+`RedisStreamsPubSub` implements both the event delivery contract and distributed leasing. A single backend handles cross-instance signal delivery and lease ownership. Vercel's managed Redis integration and Upstash Redis both work well. For more on when a distributed pub/sub is needed, see the [PubSub guide](https://mastra.ai/docs/server/pubsub) and the [`RedisStreamsPubSub` reference](https://mastra.ai/reference/pubsub/redis-streams).
 
 ## Compatibility and APIs
 

package/dist/docs/references/reference-client-js-agent-controller.md

@@ -91,7 +91,7 @@ Returns: `Promise<CreateAgentControllerSessionResponse>`
 
 ### `subscribe(options)`
 
-Subscribes to the session's event stream over SSE. The promise resolves once the stream is established and rejects when it can't connect, so a rejected call leaves nothing running in the background. `reconnect` only governs re-establishing a stream that drops after it was established. To retry the initial connection, loop around `subscribe()`.
+Subscribes to the session's event stream over SSE. The promise resolves once the stream is established and rejects when it can't connect. A rejected call leaves nothing running in the background. `reconnect` only governs re-establishing a stream that drops after it was established. To retry the initial connection, loop around `subscribe()`.
 
 **onEvent** (`(event: AgentControllerEvent) => void`): Called for each event received over the stream. See Events for the event types.
 

package/dist/docs/references/reference-observability-tracing-trace-query.md

@@ -283,21 +283,21 @@ Hono and Fastify enforce the request-body limit before JSON parsing. Express and
 
 ## Fields and operators
 
-| Predicate context | Fields                                                                                                                                                       | Operators                                                                  |
-| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------- |
-| Trace             | `traceId`, `threadId`, `resourceId`, `entityName`, `entityType`, `environment`, `status`                                                                     | `eq`, `ne`, `in`, `notIn`, `exists`, `notExists`                           |
-| Trace metadata    | `metadata.<key>`                                                                                                                                             | `eq`, `ne`, `in`, `notIn`, `exists`, `notExists`                           |
-| Trace             | `startedAt`, `endedAt`, `durationMs`                                                                                                                         | `eq`, `ne`, `in`, `notIn`, `lt`, `lte`, `gt`, `gte`, `exists`, `notExists` |
-| Trace             | `tags`                                                                                                                                                       | `includes`, `notIncludes`, `exists`, `notExists`                           |
-| Span              | `name`, `spanType`, `model`, `provider`, `status`, `entityType`, `entityId`, `entityName`, `entityVersionId`, `parentEntityVersionId`, `rootEntityVersionId` | `eq`, `ne`, `in`, `notIn`, `exists`, `notExists`                           |
-| Span              | `startedAt`, `endedAt`, `durationMs`                                                                                                                         | `eq`, `ne`, `in`, `notIn`, `lt`, `lte`, `gt`, `gte`, `exists`, `notExists` |
-| Span              | `error`                                                                                                                                                      | `exists`, `notExists`                                                      |
-| Score             | `scorerId`, `scorerVersion`, `scoreSource`, `entityVersionId`, `parentEntityVersionId`, `rootEntityVersionId`                                                | `eq`, `ne`, `in`, `notIn`, `exists`, `notExists`                           |
-| Score             | `score`, `timestamp`                                                                                                                                         | `eq`, `ne`, `in`, `notIn`, `lt`, `lte`, `gt`, `gte`, `exists`, `notExists` |
-| Score             | `spanId`                                                                                                                                                     | `exists`, `notExists`                                                      |
-| Feedback          | `feedbackType`, `feedbackSource`, `feedbackUserId`, `sourceId`, `entityVersionId`, `parentEntityVersionId`, `rootEntityVersionId`                            | `eq`, `ne`, `in`, `notIn`, `exists`, `notExists`                           |
-| Feedback          | `value`, `timestamp`                                                                                                                                         | `eq`, `ne`, `in`, `notIn`, `lt`, `lte`, `gt`, `gte`, `exists`, `notExists` |
-| Feedback          | `comment`                                                                                                                                                    | `exists`, `notExists`                                                      |
+| Predicate context | Fields                                                                                                                                                                                                         | Operators                                                                  |
+| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
+| Trace             | `traceId`, `threadId`, `resourceId`, `runId`, `sessionId`, `userId`, `organizationId`, `entityName`, `entityType`, `environment`, `status`                                                                     | `eq`, `ne`, `in`, `notIn`, `exists`, `notExists`                           |
+| Trace metadata    | `metadata.<key>`                                                                                                                                                                                               | `eq`, `ne`, `in`, `notIn`, `exists`, `notExists`                           |
+| Trace             | `startedAt`, `endedAt`, `durationMs`                                                                                                                                                                           | `eq`, `ne`, `in`, `notIn`, `lt`, `lte`, `gt`, `gte`, `exists`, `notExists` |
+| Trace             | `tags`                                                                                                                                                                                                         | `includes`, `notIncludes`, `exists`, `notExists`                           |
+| Span              | `name`, `spanType`, `model`, `provider`, `status`, `entityType`, `entityId`, `entityName`, `entityVersionId`, `parentEntityVersionId`, `rootEntityVersionId`, `runId`, `sessionId`, `userId`, `organizationId` | `eq`, `ne`, `in`, `notIn`, `exists`, `notExists`                           |
+| Span              | `startedAt`, `endedAt`, `durationMs`                                                                                                                                                                           | `eq`, `ne`, `in`, `notIn`, `lt`, `lte`, `gt`, `gte`, `exists`, `notExists` |
+| Span              | `error`                                                                                                                                                                                                        | `exists`, `notExists`                                                      |
+| Score             | `scorerId`, `scorerVersion`, `scoreSource`, `entityVersionId`, `parentEntityVersionId`, `rootEntityVersionId`                                                                                                  | `eq`, `ne`, `in`, `notIn`, `exists`, `notExists`                           |
+| Score             | `score`, `timestamp`                                                                                                                                                                                           | `eq`, `ne`, `in`, `notIn`, `lt`, `lte`, `gt`, `gte`, `exists`, `notExists` |
+| Score             | `spanId`                                                                                                                                                                                                       | `exists`, `notExists`                                                      |
+| Feedback          | `feedbackType`, `feedbackSource`, `feedbackUserId`, `sourceId`, `entityVersionId`, `parentEntityVersionId`, `rootEntityVersionId`                                                                              | `eq`, `ne`, `in`, `notIn`, `exists`, `notExists`                           |
+| Feedback          | `value`, `timestamp`                                                                                                                                                                                           | `eq`, `ne`, `in`, `notIn`, `lt`, `lte`, `gt`, `gte`, `exists`, `notExists` |
+| Feedback          | `comment`                                                                                                                                                                                                      | `exists`, `notExists`                                                      |
 
 Compose predicates with `{ op: 'and', args: [...] }`, `{ op: 'or', args: [...] }`, and `{ op: 'not', arg: ... }`. Comparison predicates place a field reference on the left and a literal on the right. Membership predicates use a field reference in `value` and a homogeneous literal array in `set`. Tag predicates name the stored tag collection in `path`. `includes` and `notIncludes` also take one tag in `value`, while `exists` and `notExists` take only `op` and `path`. See [Filter by tags](#filter-by-tags).
 
@@ -319,6 +319,27 @@ This top-level predicate doesn't inspect child spans. In contrast, `spans.some`
 
 Trace queries exclude incomplete roots before evaluating predicates. As a result, `{ op: 'notExists', path: 'durationMs' }` doesn't find running traces or malformed roots without a usable `endedAt`.
 
+### Filter by context identifiers
+
+`runId`, `sessionId`, `userId`, and `organizationId` are available at trace scope and inside `spans.some` / `spans.none`. Trace-scope predicates read the current root span. Span-scope predicates bind to one related current span, so a run recorded only on a child span is found through `spans.some`:
+
+```typescript
+const sessionTracesWithRun = {
+  op: 'and',
+  args: [
+    { op: 'eq', left: { path: 'organizationId' }, right: { literal: 'org-123' } },
+    { op: 'eq', left: { path: 'sessionId' }, right: { literal: 'session-123' } },
+    {
+      spans: {
+        some: { op: 'eq', left: { path: 'runId' }, right: { literal: 'run-42' } },
+      },
+    },
+  ],
+}
+```
+
+These identifiers support `eq`, `ne`, `in`, `notIn`, `exists`, and `notExists`. Field discovery lists them, but value discovery doesn't return their recorded values. Stores advertise support through the `trace-query-context-ids` feature. A predicate on one of these fields against an older store returns `501` before storage runs, and field discovery omits them for that store.
+
 ### Filter by span properties
 
 Every condition inside one `spans.some` or `spans.none` clause applies to the same current span. For example, this predicate finds a failed tool span whose name is `medication_lookup`; a matching name on one span and an error on another don't satisfy it:
@@ -679,7 +700,7 @@ const plan = planTraceQuery(parseTraceQueryRequest(request), {
 })
 ```
 
-`resourceId` is optional and narrows within the organization. Keyset and delta cursors are bound to the scope, so a cursor minted under one scope and reused under another returns `409` before storage runs. A scoped request against an observability store or `@mastra/core` that predates tenant scope returns `501` instead of running unscoped. Stores advertise support through the `trace-query-tenant-scope` feature. Callers can't name `organizationId` or `projectId` in predicates. Without a scope the routes behave as before, so self-hosted installations keep their own tenant model.
+`resourceId` is optional and narrows within the organization. Keyset and delta cursors are bound to the scope. A cursor created under one scope and reused under another returns `409` before storage runs. A scoped request against an observability store or `@mastra/core` that predates tenant scope returns `501` instead of running unscoped. Stores advertise support through the `trace-query-tenant-scope` feature. Callers can't name `projectId` in predicates. An `organizationId` predicate compares recorded data and is ANDed with the scope, so it can only narrow the tenant's own traces and never widens it. Without a scope the routes behave as before, so self-hosted installations keep their own tenant model.
 
 Cursor pagination is deterministic, but it isn't a database snapshot. Traces or replacement signals written between page requests can change later pages.
 

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

@@ -96,12 +96,12 @@ type InputShared_Auxiliary_223 = {
     op: 'not';
     arg: InputShared_Auxiliary_223;
 };
-type InputShared_Auxiliary_251 = {
+type InputShared_Auxiliary_254 = {
     op: 'and' | 'or';
-    args: InputShared_Auxiliary_251[];
+    args: InputShared_Auxiliary_254[];
 } | {
     op: 'not';
-    arg: InputShared_Auxiliary_251;
+    arg: InputShared_Auxiliary_254;
 } | {
     traces: {
         some: InputShared_Auxiliary_204;
@@ -109,7 +109,7 @@ type InputShared_Auxiliary_251 = {
         none: InputShared_Auxiliary_204;
     };
 };
-type InputShared_Auxiliary_667 = {
+type InputShared_Auxiliary_670 = {
     op: 'eq' | 'ne' | 'lt' | 'lte' | 'gt' | 'gte';
     left: {
         path: string;
@@ -141,24 +141,24 @@ type InputShared_Auxiliary_667 = {
     };
 } | {
     op: 'and' | 'or';
-    args: InputShared_Auxiliary_667[];
+    args: InputShared_Auxiliary_670[];
 } | {
     op: 'not';
-    arg: InputShared_Auxiliary_667;
+    arg: InputShared_Auxiliary_670;
 };
-type InputShared_Auxiliary_741 = {
+type InputShared_Auxiliary_744 = {
     id?: string | undefined;
     name: string;
     type: 'file' | 'folder';
     content?: string | undefined;
-    children?: InputShared_Auxiliary_741[] | undefined;
+    children?: InputShared_Auxiliary_744[] | undefined;
 };
-type Shared_Auxiliary_750 = {
+type Shared_Auxiliary_752 = {
     id?: string | undefined;
     name: string;
     type: 'file' | 'folder';
     content?: string | undefined;
-    children?: Shared_Auxiliary_750[] | undefined;
+    children?: Shared_Auxiliary_752[] | undefined;
 };
 type InputShared_Type_0 = {
     thread: string | {
@@ -1280,7 +1280,7 @@ type InputShared_Type_86 = {
         [key: string]: unknown;
     } | undefined;
     steps: InputShared_Type_81[];
-    predicates: InputShared_Auxiliary_667[];
+    predicates: InputShared_Auxiliary_670[];
 };
 type InputShared_Type_87 = {
     type: 'loop';
@@ -1291,7 +1291,7 @@ type InputShared_Type_87 = {
     } | undefined;
     step: InputShared_Type_81;
     loopType: 'dowhile' | 'dountil';
-    predicate: InputShared_Auxiliary_667;
+    predicate: InputShared_Auxiliary_670;
 };
 type InputShared_Type_88 = InputShared_Type_78 | InputShared_Type_79 | InputShared_Type_80 | {
     type: 'workflow';
@@ -2671,6 +2671,8 @@ type Shared_Type_65 = {
     traceQuery: boolean;
     /** `durationMs` predicates in trace and thread queries */
     traceQueryRootDuration: boolean;
+    /** `runId`, `sessionId`, `userId` and `organizationId` predicates in trace and thread queries */
+    traceQueryContextIds: boolean;
     /** Trace query field discovery (POST /observability/traces/query/fields and /values) */
     traceQueryDiscovery: boolean;
     /** Trusted tenant scoping of trace and thread queries */
@@ -3073,7 +3075,7 @@ type Shared_Type_81 = {
     /** List of asset file paths */
     assets?: string[] | undefined;
     /** Full file tree structure for the skill */
-    files?: Shared_Auxiliary_750[] | undefined;
+    files?: Shared_Auxiliary_752[] | undefined;
     /** Additional metadata for the skill */
     metadata?: {
         [key: string]: unknown;
@@ -7850,6 +7852,53 @@ export interface PostObservabilityTracesQuery_RouteContract {
     response: PostObservabilityTracesQuery_Response;
     responseType: 'json';
 }
+export type PostObservabilityTracesAggregate_Body = {
+    timeRange: {
+        from: string;
+        to: string;
+    };
+    where?: InputShared_Auxiliary_204 | undefined;
+    groupBy?: string[];
+    interval?: ('1m' | '5m' | '15m' | '1h' | '1d') | undefined;
+    measures: (('count' | 'duration.avg' | 'duration.min' | 'duration.max' | 'duration.p50' | 'duration.p90' | 'duration.p95' | 'duration.p99' | 'errorCount' | 'errorRate') | `countDistinct.${string}`)[];
+    having?: InputShared_Auxiliary_223 | undefined;
+    orderBy?: {
+        field: string;
+        direction: 'asc' | 'desc';
+    };
+    limit?: number;
+};
+export type PostObservabilityTracesAggregate_Response = {
+    rows: {
+        dimensions?: {
+            [key: string]: string | null;
+        } | undefined;
+        bucket?: string | undefined;
+        measures: {
+            [K in ('count' | 'duration.avg' | 'duration.min' | 'duration.max' | 'duration.p50' | 'duration.p90' | 'duration.p95' | 'duration.p99' | 'errorCount' | 'errorRate') | `countDistinct.${string}`]?: number;
+        };
+    }[];
+    truncated: boolean;
+};
+export type PostObservabilityTracesAggregate_Request = Simplify<(never extends never ? {} : {
+    params: never;
+}) & (never extends never ? {} : {} extends never ? {
+    query?: never;
+} : {
+    query: never;
+}) & (PostObservabilityTracesAggregate_Body extends never ? {} : {} extends PostObservabilityTracesAggregate_Body ? {
+    body?: PostObservabilityTracesAggregate_Body;
+} : {
+    body: PostObservabilityTracesAggregate_Body;
+})>;
+export interface PostObservabilityTracesAggregate_RouteContract {
+    pathParams: never;
+    queryParams: never;
+    body: PostObservabilityTracesAggregate_Body;
+    request: PostObservabilityTracesAggregate_Request;
+    response: PostObservabilityTracesAggregate_Response;
+    responseType: 'json';
+}
 export type PostObservabilityThreadsQuery_Body = {
     traces: {
         timeRange: {
@@ -7858,7 +7907,7 @@ export type PostObservabilityThreadsQuery_Body = {
         };
         where?: InputShared_Auxiliary_204 | undefined;
     };
-    where?: InputShared_Auxiliary_251 | undefined;
+    where?: InputShared_Auxiliary_254 | undefined;
     page?: {
         limit?: number;
         after?: (string | null) | undefined;
@@ -14150,7 +14199,7 @@ export type PostStoredSkills_Body = {
     /** List of asset file paths */
     assets?: string[] | undefined;
     /** Full file tree structure for the skill */
-    files?: InputShared_Auxiliary_741[] | undefined;
+    files?: InputShared_Auxiliary_744[] | undefined;
     /** Additional metadata for the skill */
     metadata?: {
         [key: string]: unknown;
@@ -14200,7 +14249,7 @@ export type PatchStoredSkillsStoredSkillId_Body = {
     /** List of asset file paths */
     assets?: (string[] | undefined) | undefined;
     /** Full file tree structure for the skill */
-    files?: (InputShared_Auxiliary_741[] | undefined) | undefined;
+    files?: (InputShared_Auxiliary_744[] | undefined) | undefined;
     /** Additional metadata for the skill */
     metadata?: ({
         [key: string]: unknown;
@@ -18550,6 +18599,7 @@ export interface RouteTypes {
     'POST /observability/traces/score': PostObservabilityTracesScore_RouteContract;
     'GET /observability/traces/:traceId/:spanId/scores': GetObservabilityTracesTraceIdSpanIdScores_RouteContract;
     'POST /observability/traces/query': PostObservabilityTracesQuery_RouteContract;
+    'POST /observability/traces/aggregate': PostObservabilityTracesAggregate_RouteContract;
     'POST /observability/threads/query': PostObservabilityThreadsQuery_RouteContract;
     'POST /observability/traces/query/fields': PostObservabilityTracesQueryFields_RouteContract;
     'POST /observability/traces/query/values': PostObservabilityTracesQueryValues_RouteContract;
@@ -19507,6 +19557,9 @@ export interface Client {
     '/observability/traces/:traceId/trajectory': {
         GET: GetObservabilityTracesTraceIdTrajectory_RouteContract;
     };
+    '/observability/traces/aggregate': {
+        POST: PostObservabilityTracesAggregate_RouteContract;
+    };
     '/observability/traces/delete': {
         POST: PostObservabilityTracesDelete_RouteContract;
     };