@mastra/server 1.78.1-alpha.0 → 1.79.0-alpha.10

package/dist/server/handlers/observability-new-endpoints.d.ts

@@ -1,7 +1,7 @@
 import type { ValidationErrorHook } from '@mastra/core/server';
 import * as coreStorage from '@mastra/core/storage';
 import { z } from 'zod/v4';
-import type { ServerContext } from '../server-adapter/routes/index.js';
+import type { InferParams, ServerContext } from '../server-adapter/routes/index.js';
 export declare const QUERY_TRACES: Omit<import("@mastra/core/server").ApiRoute, "createHandler" | "handler" | "method" | "openapi" | "path"> & {
     method: string;
     path: `/${string}`;
@@ -18,7 +18,7 @@ export declare const QUERY_TRACES: Omit<import("@mastra/core/server").ApiRoute,
             by: ["threadId"];
         } | undefined;
         orderBy?: {
-            field: "endedAt" | "startedAt";
+            field: "endedAt" | "startedAt" | "timeToFirstChunkMs";
             direction: "asc" | "desc";
         }[] | undefined;
         page?: {
@@ -52,6 +52,7 @@ export declare const QUERY_TRACES: Omit<import("@mastra/core/server").ApiRoute,
             entityType: string | null;
             environment: string | null;
             status: "error" | "success";
+            timeToFirstChunkMs?: number | null | undefined;
         }[];
         page: {
             next: string | null;
@@ -76,6 +77,7 @@ export declare const QUERY_TRACES: Omit<import("@mastra/core/server").ApiRoute,
             entityType: string | null;
             environment: string | null;
             status: "error" | "success";
+            timeToFirstChunkMs?: number | null | undefined;
         }[];
         pagination: {
             total: number;
@@ -104,6 +106,7 @@ export declare const QUERY_TRACES: Omit<import("@mastra/core/server").ApiRoute,
             entityType: string | null;
             environment: string | null;
             status: "error" | "success";
+            timeToFirstChunkMs?: number | null | undefined;
         }[];
         delta: {
             limit: number;
@@ -141,6 +144,7 @@ export declare const QUERY_TRACES: Omit<import("@mastra/core/server").ApiRoute,
             field: z.ZodEnum<{
                 endedAt: "endedAt";
                 startedAt: "startedAt";
+                timeToFirstChunkMs: "timeToFirstChunkMs";
             }>;
             direction: z.ZodEnum<{
                 asc: "asc";
@@ -181,6 +185,7 @@ export declare const QUERY_TRACES: Omit<import("@mastra/core/server").ApiRoute,
                 error: "error";
                 success: "success";
             }>;
+            timeToFirstChunkMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         }, z.core.$strict>>;
         page: z.ZodObject<{
             next: z.ZodNullable<z.ZodString>;
@@ -208,6 +213,7 @@ export declare const QUERY_TRACES: Omit<import("@mastra/core/server").ApiRoute,
                 error: "error";
                 success: "success";
             }>;
+            timeToFirstChunkMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         }, z.core.$strict>>;
         pagination: z.ZodObject<{
             total: z.ZodNumber;
@@ -239,6 +245,7 @@ export declare const QUERY_TRACES: Omit<import("@mastra/core/server").ApiRoute,
                 error: "error";
                 success: "success";
             }>;
+            timeToFirstChunkMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         }, z.core.$strict>>;
         delta: z.ZodObject<{
             limit: z.ZodNumber;
@@ -397,7 +404,7 @@ export declare const QUERY_SPANS: Omit<import("@mastra/core/server").ApiRoute, "
         };
         where?: coreStorage.TraceQueryScalarPredicate | undefined;
         orderBy: {
-            field: "endedAt" | "startedAt";
+            field: "endedAt" | "startedAt" | "timeToFirstChunkMs";
             direction: "asc" | "desc";
         }[];
         page: {
@@ -420,23 +427,30 @@ export declare const QUERY_SPANS: Omit<import("@mastra/core/server").ApiRoute, "
             entityType: string | null;
             entityId: string | null;
             entityName: string | null;
+            entityVersionId: string | null;
+            parentEntityType: string | null;
+            parentEntityId: string | null;
+            parentEntityName: string | null;
+            parentEntityVersionId: string | null;
+            rootEntityType: string | null;
+            rootEntityId: string | null;
+            rootEntityName: string | null;
+            rootEntityVersionId: string | null;
+            threadId: string | null;
+            runId: string | null;
+            sessionId: string | null;
+            userId: string | null;
+            requestId: string | null;
+            serviceName: string | null;
+            experimentId: string | null;
+            environment: string | null;
+            executionSource: string | null;
             model: string | null;
             provider: string | null;
             inputPreview: string | null;
-            inputTruncated: boolean;
             outputPreview: string | null;
-            outputTruncated: boolean;
             errorPreview: string | null;
-            errorTruncated: boolean;
-            cost: {
-                state: "available";
-                amount: number;
-                currency: string;
-            } | {
-                state: "missing";
-            } | {
-                state: "unavailable";
-            };
+            timeToFirstChunkMs?: number | null | undefined;
         }[];
         page: {
             next: string | null;
@@ -462,6 +476,7 @@ export declare const QUERY_SPANS: Omit<import("@mastra/core/server").ApiRoute, "
             field: z.ZodEnum<{
                 endedAt: "endedAt";
                 startedAt: "startedAt";
+                timeToFirstChunkMs: "timeToFirstChunkMs";
             }>;
             direction: z.ZodEnum<{
                 asc: "asc";
@@ -491,23 +506,30 @@ export declare const QUERY_SPANS: Omit<import("@mastra/core/server").ApiRoute, "
             entityType: z.ZodNullable<z.ZodString>;
             entityId: z.ZodNullable<z.ZodString>;
             entityName: z.ZodNullable<z.ZodString>;
+            entityVersionId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            parentEntityType: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            parentEntityId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            parentEntityName: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            parentEntityVersionId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            rootEntityType: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            rootEntityId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            rootEntityName: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            rootEntityVersionId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            threadId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            runId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            sessionId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            userId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            requestId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            serviceName: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            experimentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            environment: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            executionSource: z.ZodDefault<z.ZodNullable<z.ZodString>>;
             model: z.ZodNullable<z.ZodString>;
             provider: z.ZodNullable<z.ZodString>;
             inputPreview: z.ZodNullable<z.ZodString>;
-            inputTruncated: z.ZodBoolean;
             outputPreview: z.ZodNullable<z.ZodString>;
-            outputTruncated: z.ZodBoolean;
             errorPreview: z.ZodNullable<z.ZodString>;
-            errorTruncated: z.ZodBoolean;
-            cost: z.ZodDiscriminatedUnion<[z.ZodObject<{
-                state: z.ZodLiteral<"available">;
-                amount: z.ZodNumber;
-                currency: z.ZodString;
-            }, z.core.$strict>, z.ZodObject<{
-                state: z.ZodLiteral<"missing">;
-            }, z.core.$strict>, z.ZodObject<{
-                state: z.ZodLiteral<"unavailable">;
-            }, z.core.$strict>], "state">;
+            timeToFirstChunkMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         }, z.core.$strict>>;
         page: z.ZodObject<{
             next: z.ZodNullable<z.ZodString>;
@@ -726,22 +748,86 @@ export declare const QUERY_THREADS: Omit<import("@mastra/core/server").ApiRoute,
     responseType: "json";
     streamFormat?: 'sse' | 'stream';
     sseFlushOnConnect?: boolean;
-    handler(params: {
-        traces: {
-            timeRange: {
-                from: string;
-                to: string;
-            };
-            where?: coreStorage.TraceQueryPredicate | undefined;
-        };
-        where?: coreStorage.ThreadPredicate | undefined;
+    handler(params: InferParams<undefined, undefined, z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
+        timeRange: z.ZodUnion<readonly [z.ZodObject<{
+            traces: z.ZodObject<{
+                from: z.ZodString;
+                to: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            threads: z.ZodObject<{
+                from: z.ZodString;
+                to: z.ZodString;
+                field: z.ZodEnum<{
+                    endedAt: "endedAt";
+                    startedAt: "startedAt";
+                }>;
+            }, z.core.$strict>;
+        }, z.core.$strict>]>;
+        where: z.ZodOptional<z.ZodType<coreStorage.TraceQueryScalarPredicate, unknown, z.core.$ZodTypeInternals<coreStorage.TraceQueryScalarPredicate, unknown>>>;
+        orderBy: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            field: z.ZodEnum<{
+                endedAt: "endedAt";
+                startedAt: "startedAt";
+            }>;
+            direction: z.ZodEnum<{
+                asc: "asc";
+                desc: "desc";
+            }>;
+        }, z.core.$strict>>>;
+        page: z.ZodDefault<z.ZodObject<{
+            limit: z.ZodDefault<z.ZodNumber>;
+            after: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, unknown>, z.ZodPreprocess<z.ZodObject<{
+        traces: z.ZodObject<{
+            timeRange: z.ZodObject<{
+                from: z.ZodString;
+                to: z.ZodString;
+            }, z.core.$strict>;
+            where: z.ZodOptional<z.ZodType<coreStorage.TraceQueryPredicate, unknown, z.core.$ZodTypeInternals<coreStorage.TraceQueryPredicate, unknown>>>;
+        }, z.core.$strict>;
+        where: z.ZodOptional<z.ZodType<coreStorage.ThreadPredicate, unknown, z.core.$ZodTypeInternals<coreStorage.ThreadPredicate, unknown>>>;
+        page: z.ZodDefault<z.ZodObject<{
+            limit: z.ZodDefault<z.ZodNumber>;
+            after: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, unknown>]>> & ServerContext): Promise<{
+        threads: {
+            threadId: string;
+        }[];
         page: {
-            limit: number;
-            after?: string | null | undefined;
+            next: string | null;
         };
-    } & ServerContext): Promise<{
+    } | {
         threads: {
+            organizationId: string | null;
             threadId: string;
+            firstTraceId: string;
+            lastTraceId: string;
+            resourceId: string | null;
+            userId: string | null;
+            entityType: string | null;
+            entityId: string | null;
+            entityName: string | null;
+            entityVersionId: string | null;
+            runId: string | null;
+            sessionId: string | null;
+            requestId: string | null;
+            serviceName: string | null;
+            experimentId: string | null;
+            environment: string | null;
+            executionSource: string | null;
+            status: "error" | "success";
+            startedAt: string;
+            endedAt: string;
+            timeToFirstChunkMs: number | null;
+            inputPreview: string | null;
+            outputPreview: string | null;
+            errorPreview: string | null;
+            traceCount: number;
+            model: string | null;
+            provider: string | null;
         }[];
         page: {
             next: string | null;
@@ -757,7 +843,38 @@ export declare const QUERY_THREADS: Omit<import("@mastra/core/server").ApiRoute,
     requiresPermission?: import("@mastra/core/auth").MastraFGAPermissionInput | import("@mastra/core/auth").MastraFGAPermissionInput[];
     fga?: import("@mastra/core/auth").FGARouteConfig;
     onValidationError?: ValidationErrorHook;
-    readonly __schemas?: import("../server-adapter").RouteSchemas<undefined, undefined, z.ZodPreprocess<z.ZodObject<{
+    readonly __schemas?: import("../server-adapter").RouteSchemas<undefined, undefined, z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
+        timeRange: z.ZodUnion<readonly [z.ZodObject<{
+            traces: z.ZodObject<{
+                from: z.ZodString;
+                to: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            threads: z.ZodObject<{
+                from: z.ZodString;
+                to: z.ZodString;
+                field: z.ZodEnum<{
+                    endedAt: "endedAt";
+                    startedAt: "startedAt";
+                }>;
+            }, z.core.$strict>;
+        }, z.core.$strict>]>;
+        where: z.ZodOptional<z.ZodType<coreStorage.TraceQueryScalarPredicate, unknown, z.core.$ZodTypeInternals<coreStorage.TraceQueryScalarPredicate, unknown>>>;
+        orderBy: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            field: z.ZodEnum<{
+                endedAt: "endedAt";
+                startedAt: "startedAt";
+            }>;
+            direction: z.ZodEnum<{
+                asc: "asc";
+                desc: "desc";
+            }>;
+        }, z.core.$strict>>>;
+        page: z.ZodDefault<z.ZodObject<{
+            limit: z.ZodDefault<z.ZodNumber>;
+            after: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, unknown>, z.ZodPreprocess<z.ZodObject<{
         traces: z.ZodObject<{
             timeRange: z.ZodObject<{
                 from: z.ZodString;
@@ -770,14 +887,57 @@ export declare const QUERY_THREADS: Omit<import("@mastra/core/server").ApiRoute,
             limit: z.ZodDefault<z.ZodNumber>;
             after: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strict>>;
-    }, z.core.$strict>, unknown>, z.ZodObject<{
+    }, z.core.$strict>, unknown>]>, z.ZodObject<{
         threads: z.ZodArray<z.ZodObject<{
             threadId: z.ZodString;
         }, z.core.$strict>>;
         page: z.ZodObject<{
             next: z.ZodNullable<z.ZodString>;
         }, z.core.$strict>;
-    }, z.core.$strict>> | undefined;
+    }, z.core.$strict> | z.ZodUnion<readonly [z.ZodObject<{
+        threads: z.ZodArray<z.ZodObject<{
+            organizationId: z.ZodNullable<z.ZodString>;
+            threadId: z.ZodString;
+            firstTraceId: z.ZodString;
+            lastTraceId: z.ZodString;
+            resourceId: z.ZodNullable<z.ZodString>;
+            userId: z.ZodNullable<z.ZodString>;
+            entityType: z.ZodNullable<z.ZodString>;
+            entityId: z.ZodNullable<z.ZodString>;
+            entityName: z.ZodNullable<z.ZodString>;
+            entityVersionId: z.ZodNullable<z.ZodString>;
+            runId: z.ZodNullable<z.ZodString>;
+            sessionId: z.ZodNullable<z.ZodString>;
+            requestId: z.ZodNullable<z.ZodString>;
+            serviceName: z.ZodNullable<z.ZodString>;
+            experimentId: z.ZodNullable<z.ZodString>;
+            environment: z.ZodNullable<z.ZodString>;
+            executionSource: z.ZodNullable<z.ZodString>;
+            status: z.ZodEnum<{
+                error: "error";
+                success: "success";
+            }>;
+            startedAt: z.ZodString;
+            endedAt: z.ZodString;
+            timeToFirstChunkMs: z.ZodNullable<z.ZodNumber>;
+            inputPreview: z.ZodNullable<z.ZodString>;
+            outputPreview: z.ZodNullable<z.ZodString>;
+            errorPreview: z.ZodNullable<z.ZodString>;
+            traceCount: z.ZodNumber;
+            model: z.ZodNullable<z.ZodString>;
+            provider: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+        page: z.ZodObject<{
+            next: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        threads: z.ZodArray<z.ZodObject<{
+            threadId: z.ZodString;
+        }, z.core.$strict>>;
+        page: z.ZodObject<{
+            next: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>]>> | undefined;
 } & {
     readonly _mastraSchemaRoute: true;
 };
@@ -2864,6 +3024,7 @@ export declare const GET_METRIC_AGGREGATE: Omit<import("@mastra/core/server").Ap
             executionSource?: string | undefined;
             tags?: string[] | undefined;
             traceIds?: string[] | undefined;
+            experimentIds?: string[] | undefined;
             name?: string[] | undefined;
             source?: string | undefined;
             provider?: string | undefined;
@@ -2949,6 +3110,7 @@ export declare const GET_METRIC_AGGREGATE: Omit<import("@mastra/core/server").Ap
             executionSource: z.ZodOptional<z.ZodString>;
             tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             traceIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            experimentIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
             name: z.ZodOptional<z.ZodArray<z.ZodString>>;
             source: z.ZodOptional<z.ZodString>;
             provider: z.ZodOptional<z.ZodString>;
@@ -3015,6 +3177,7 @@ export declare const GET_METRIC_BREAKDOWN: Omit<import("@mastra/core/server").Ap
             executionSource?: string | undefined;
             tags?: string[] | undefined;
             traceIds?: string[] | undefined;
+            experimentIds?: string[] | undefined;
             name?: string[] | undefined;
             source?: string | undefined;
             provider?: string | undefined;
@@ -3101,6 +3264,7 @@ export declare const GET_METRIC_BREAKDOWN: Omit<import("@mastra/core/server").Ap
             executionSource: z.ZodOptional<z.ZodString>;
             tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             traceIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            experimentIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
             name: z.ZodOptional<z.ZodArray<z.ZodString>>;
             source: z.ZodOptional<z.ZodString>;
             provider: z.ZodOptional<z.ZodString>;
@@ -3166,6 +3330,7 @@ export declare const GET_METRIC_TIME_SERIES: Omit<import("@mastra/core/server").
             executionSource?: string | undefined;
             tags?: string[] | undefined;
             traceIds?: string[] | undefined;
+            experimentIds?: string[] | undefined;
             name?: string[] | undefined;
             source?: string | undefined;
             provider?: string | undefined;
@@ -3260,6 +3425,7 @@ export declare const GET_METRIC_TIME_SERIES: Omit<import("@mastra/core/server").
             executionSource: z.ZodOptional<z.ZodString>;
             tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             traceIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            experimentIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
             name: z.ZodOptional<z.ZodArray<z.ZodString>>;
             source: z.ZodOptional<z.ZodString>;
             provider: z.ZodOptional<z.ZodString>;
@@ -3323,6 +3489,7 @@ export declare const GET_METRIC_PERCENTILES: Omit<import("@mastra/core/server").
             executionSource?: string | undefined;
             tags?: string[] | undefined;
             traceIds?: string[] | undefined;
+            experimentIds?: string[] | undefined;
             name?: string[] | undefined;
             source?: string | undefined;
             provider?: string | undefined;
@@ -3390,6 +3557,7 @@ export declare const GET_METRIC_PERCENTILES: Omit<import("@mastra/core/server").
             executionSource: z.ZodOptional<z.ZodString>;
             tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             traceIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            experimentIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
             name: z.ZodOptional<z.ZodArray<z.ZodString>>;
             source: z.ZodOptional<z.ZodString>;
             provider: z.ZodOptional<z.ZodString>;
@@ -3652,11 +3820,17 @@ export declare const GET_CAPABILITIES: Omit<import("@mastra/core/server").ApiRou
             traceQuery: boolean;
             traceQueryRootDuration: boolean;
             traceQueryContextIds: boolean;
+            traceQueryTimeToFirstChunk: boolean;
+            traceQueryRootSpanFields: boolean;
+            traceQueryRootEntityId: boolean;
+            traceQueryTimeToFirstChunkSort: boolean;
             traceQueryDiscovery: boolean;
             traceQueryTenantScope: boolean;
             traceAggregate: boolean;
             threadQuery: boolean;
+            threadQueryRows: boolean;
             spanQuery: boolean;
+            spanQueryContextFields: boolean;
             traceRetentionDays?: number | undefined;
             feedback: boolean;
         };
@@ -3688,11 +3862,17 @@ export declare const GET_CAPABILITIES: Omit<import("@mastra/core/server").ApiRou
             traceQuery: z.ZodBoolean;
             traceQueryRootDuration: z.ZodBoolean;
             traceQueryContextIds: z.ZodBoolean;
+            traceQueryTimeToFirstChunk: z.ZodBoolean;
+            traceQueryRootSpanFields: z.ZodBoolean;
+            traceQueryRootEntityId: z.ZodBoolean;
+            traceQueryTimeToFirstChunkSort: z.ZodBoolean;
             traceQueryDiscovery: z.ZodBoolean;
             traceQueryTenantScope: z.ZodBoolean;
             traceAggregate: z.ZodBoolean;
             threadQuery: z.ZodBoolean;
+            threadQueryRows: z.ZodDefault<z.ZodBoolean>;
             spanQuery: z.ZodBoolean;
+            spanQueryContextFields: z.ZodDefault<z.ZodBoolean>;
             traceRetentionDays: z.ZodOptional<z.ZodNumber>;
             feedback: z.ZodBoolean;
         }, z.core.$strip>;
@@ -3717,7 +3897,7 @@ export declare const NEW_ROUTES: {
                 by: ["threadId"];
             } | undefined;
             orderBy?: {
-                field: "endedAt" | "startedAt";
+                field: "endedAt" | "startedAt" | "timeToFirstChunkMs";
                 direction: "asc" | "desc";
             }[] | undefined;
             page?: {
@@ -3751,6 +3931,7 @@ export declare const NEW_ROUTES: {
                 entityType: string | null;
                 environment: string | null;
                 status: "error" | "success";
+                timeToFirstChunkMs?: number | null | undefined;
             }[];
             page: {
                 next: string | null;
@@ -3775,6 +3956,7 @@ export declare const NEW_ROUTES: {
                 entityType: string | null;
                 environment: string | null;
                 status: "error" | "success";
+                timeToFirstChunkMs?: number | null | undefined;
             }[];
             pagination: {
                 total: number;
@@ -3803,6 +3985,7 @@ export declare const NEW_ROUTES: {
                 entityType: string | null;
                 environment: string | null;
                 status: "error" | "success";
+                timeToFirstChunkMs?: number | null | undefined;
             }[];
             delta: {
                 limit: number;
@@ -3840,6 +4023,7 @@ export declare const NEW_ROUTES: {
                 field: z.ZodEnum<{
                     endedAt: "endedAt";
                     startedAt: "startedAt";
+                    timeToFirstChunkMs: "timeToFirstChunkMs";
                 }>;
                 direction: z.ZodEnum<{
                     asc: "asc";
@@ -3880,6 +4064,7 @@ export declare const NEW_ROUTES: {
                     error: "error";
                     success: "success";
                 }>;
+                timeToFirstChunkMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             }, z.core.$strict>>;
             page: z.ZodObject<{
                 next: z.ZodNullable<z.ZodString>;
@@ -3907,6 +4092,7 @@ export declare const NEW_ROUTES: {
                     error: "error";
                     success: "success";
                 }>;
+                timeToFirstChunkMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             }, z.core.$strict>>;
             pagination: z.ZodObject<{
                 total: z.ZodNumber;
@@ -3938,6 +4124,7 @@ export declare const NEW_ROUTES: {
                     error: "error";
                     success: "success";
                 }>;
+                timeToFirstChunkMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             }, z.core.$strict>>;
             delta: z.ZodObject<{
                 limit: z.ZodNumber;
@@ -3961,22 +4148,86 @@ export declare const NEW_ROUTES: {
         responseType: "json";
         streamFormat?: 'sse' | 'stream';
         sseFlushOnConnect?: boolean;
-        handler(params: {
-            traces: {
-                timeRange: {
-                    from: string;
-                    to: string;
-                };
-                where?: coreStorage.TraceQueryPredicate | undefined;
-            };
-            where?: coreStorage.ThreadPredicate | undefined;
+        handler(params: InferParams<undefined, undefined, z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
+            timeRange: z.ZodUnion<readonly [z.ZodObject<{
+                traces: z.ZodObject<{
+                    from: z.ZodString;
+                    to: z.ZodString;
+                }, z.core.$strict>;
+            }, z.core.$strict>, z.ZodObject<{
+                threads: z.ZodObject<{
+                    from: z.ZodString;
+                    to: z.ZodString;
+                    field: z.ZodEnum<{
+                        endedAt: "endedAt";
+                        startedAt: "startedAt";
+                    }>;
+                }, z.core.$strict>;
+            }, z.core.$strict>]>;
+            where: z.ZodOptional<z.ZodType<coreStorage.TraceQueryScalarPredicate, unknown, z.core.$ZodTypeInternals<coreStorage.TraceQueryScalarPredicate, unknown>>>;
+            orderBy: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                field: z.ZodEnum<{
+                    endedAt: "endedAt";
+                    startedAt: "startedAt";
+                }>;
+                direction: z.ZodEnum<{
+                    asc: "asc";
+                    desc: "desc";
+                }>;
+            }, z.core.$strict>>>;
+            page: z.ZodDefault<z.ZodObject<{
+                limit: z.ZodDefault<z.ZodNumber>;
+                after: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, unknown>, z.ZodPreprocess<z.ZodObject<{
+            traces: z.ZodObject<{
+                timeRange: z.ZodObject<{
+                    from: z.ZodString;
+                    to: z.ZodString;
+                }, z.core.$strict>;
+                where: z.ZodOptional<z.ZodType<coreStorage.TraceQueryPredicate, unknown, z.core.$ZodTypeInternals<coreStorage.TraceQueryPredicate, unknown>>>;
+            }, z.core.$strict>;
+            where: z.ZodOptional<z.ZodType<coreStorage.ThreadPredicate, unknown, z.core.$ZodTypeInternals<coreStorage.ThreadPredicate, unknown>>>;
+            page: z.ZodDefault<z.ZodObject<{
+                limit: z.ZodDefault<z.ZodNumber>;
+                after: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, unknown>]>> & ServerContext): Promise<{
+            threads: {
+                threadId: string;
+            }[];
             page: {
-                limit: number;
-                after?: string | null | undefined;
+                next: string | null;
             };
-        } & ServerContext): Promise<{
+        } | {
             threads: {
+                organizationId: string | null;
                 threadId: string;
+                firstTraceId: string;
+                lastTraceId: string;
+                resourceId: string | null;
+                userId: string | null;
+                entityType: string | null;
+                entityId: string | null;
+                entityName: string | null;
+                entityVersionId: string | null;
+                runId: string | null;
+                sessionId: string | null;
+                requestId: string | null;
+                serviceName: string | null;
+                experimentId: string | null;
+                environment: string | null;
+                executionSource: string | null;
+                status: "error" | "success";
+                startedAt: string;
+                endedAt: string;
+                timeToFirstChunkMs: number | null;
+                inputPreview: string | null;
+                outputPreview: string | null;
+                errorPreview: string | null;
+                traceCount: number;
+                model: string | null;
+                provider: string | null;
             }[];
             page: {
                 next: string | null;
@@ -3992,7 +4243,38 @@ export declare const NEW_ROUTES: {
         requiresPermission?: import("@mastra/core/auth").MastraFGAPermissionInput | import("@mastra/core/auth").MastraFGAPermissionInput[];
         fga?: import("@mastra/core/auth").FGARouteConfig;
         onValidationError?: ValidationErrorHook;
-        readonly __schemas?: import("../server-adapter").RouteSchemas<undefined, undefined, z.ZodPreprocess<z.ZodObject<{
+        readonly __schemas?: import("../server-adapter").RouteSchemas<undefined, undefined, z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
+            timeRange: z.ZodUnion<readonly [z.ZodObject<{
+                traces: z.ZodObject<{
+                    from: z.ZodString;
+                    to: z.ZodString;
+                }, z.core.$strict>;
+            }, z.core.$strict>, z.ZodObject<{
+                threads: z.ZodObject<{
+                    from: z.ZodString;
+                    to: z.ZodString;
+                    field: z.ZodEnum<{
+                        endedAt: "endedAt";
+                        startedAt: "startedAt";
+                    }>;
+                }, z.core.$strict>;
+            }, z.core.$strict>]>;
+            where: z.ZodOptional<z.ZodType<coreStorage.TraceQueryScalarPredicate, unknown, z.core.$ZodTypeInternals<coreStorage.TraceQueryScalarPredicate, unknown>>>;
+            orderBy: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                field: z.ZodEnum<{
+                    endedAt: "endedAt";
+                    startedAt: "startedAt";
+                }>;
+                direction: z.ZodEnum<{
+                    asc: "asc";
+                    desc: "desc";
+                }>;
+            }, z.core.$strict>>>;
+            page: z.ZodDefault<z.ZodObject<{
+                limit: z.ZodDefault<z.ZodNumber>;
+                after: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, unknown>, z.ZodPreprocess<z.ZodObject<{
             traces: z.ZodObject<{
                 timeRange: z.ZodObject<{
                     from: z.ZodString;
@@ -4005,14 +4287,57 @@ export declare const NEW_ROUTES: {
                 limit: z.ZodDefault<z.ZodNumber>;
                 after: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             }, z.core.$strict>>;
-        }, z.core.$strict>, unknown>, z.ZodObject<{
+        }, z.core.$strict>, unknown>]>, z.ZodObject<{
             threads: z.ZodArray<z.ZodObject<{
                 threadId: z.ZodString;
             }, z.core.$strict>>;
             page: z.ZodObject<{
                 next: z.ZodNullable<z.ZodString>;
             }, z.core.$strict>;
-        }, z.core.$strict>> | undefined;
+        }, z.core.$strict> | z.ZodUnion<readonly [z.ZodObject<{
+            threads: z.ZodArray<z.ZodObject<{
+                organizationId: z.ZodNullable<z.ZodString>;
+                threadId: z.ZodString;
+                firstTraceId: z.ZodString;
+                lastTraceId: z.ZodString;
+                resourceId: z.ZodNullable<z.ZodString>;
+                userId: z.ZodNullable<z.ZodString>;
+                entityType: z.ZodNullable<z.ZodString>;
+                entityId: z.ZodNullable<z.ZodString>;
+                entityName: z.ZodNullable<z.ZodString>;
+                entityVersionId: z.ZodNullable<z.ZodString>;
+                runId: z.ZodNullable<z.ZodString>;
+                sessionId: z.ZodNullable<z.ZodString>;
+                requestId: z.ZodNullable<z.ZodString>;
+                serviceName: z.ZodNullable<z.ZodString>;
+                experimentId: z.ZodNullable<z.ZodString>;
+                environment: z.ZodNullable<z.ZodString>;
+                executionSource: z.ZodNullable<z.ZodString>;
+                status: z.ZodEnum<{
+                    error: "error";
+                    success: "success";
+                }>;
+                startedAt: z.ZodString;
+                endedAt: z.ZodString;
+                timeToFirstChunkMs: z.ZodNullable<z.ZodNumber>;
+                inputPreview: z.ZodNullable<z.ZodString>;
+                outputPreview: z.ZodNullable<z.ZodString>;
+                errorPreview: z.ZodNullable<z.ZodString>;
+                traceCount: z.ZodNumber;
+                model: z.ZodNullable<z.ZodString>;
+                provider: z.ZodNullable<z.ZodString>;
+            }, z.core.$strict>>;
+            page: z.ZodObject<{
+                next: z.ZodNullable<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            threads: z.ZodArray<z.ZodObject<{
+                threadId: z.ZodString;
+            }, z.core.$strict>>;
+            page: z.ZodObject<{
+                next: z.ZodNullable<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>]>> | undefined;
     } & {
         readonly _mastraSchemaRoute: true;
     };
@@ -4029,7 +4354,7 @@ export declare const NEW_ROUTES: {
             };
             where?: coreStorage.TraceQueryScalarPredicate | undefined;
             orderBy: {
-                field: "endedAt" | "startedAt";
+                field: "endedAt" | "startedAt" | "timeToFirstChunkMs";
                 direction: "asc" | "desc";
             }[];
             page: {
@@ -4052,23 +4377,30 @@ export declare const NEW_ROUTES: {
                 entityType: string | null;
                 entityId: string | null;
                 entityName: string | null;
+                entityVersionId: string | null;
+                parentEntityType: string | null;
+                parentEntityId: string | null;
+                parentEntityName: string | null;
+                parentEntityVersionId: string | null;
+                rootEntityType: string | null;
+                rootEntityId: string | null;
+                rootEntityName: string | null;
+                rootEntityVersionId: string | null;
+                threadId: string | null;
+                runId: string | null;
+                sessionId: string | null;
+                userId: string | null;
+                requestId: string | null;
+                serviceName: string | null;
+                experimentId: string | null;
+                environment: string | null;
+                executionSource: string | null;
                 model: string | null;
                 provider: string | null;
                 inputPreview: string | null;
-                inputTruncated: boolean;
                 outputPreview: string | null;
-                outputTruncated: boolean;
                 errorPreview: string | null;
-                errorTruncated: boolean;
-                cost: {
-                    state: "available";
-                    amount: number;
-                    currency: string;
-                } | {
-                    state: "missing";
-                } | {
-                    state: "unavailable";
-                };
+                timeToFirstChunkMs?: number | null | undefined;
             }[];
             page: {
                 next: string | null;
@@ -4094,6 +4426,7 @@ export declare const NEW_ROUTES: {
                 field: z.ZodEnum<{
                     endedAt: "endedAt";
                     startedAt: "startedAt";
+                    timeToFirstChunkMs: "timeToFirstChunkMs";
                 }>;
                 direction: z.ZodEnum<{
                     asc: "asc";
@@ -4123,23 +4456,30 @@ export declare const NEW_ROUTES: {
                 entityType: z.ZodNullable<z.ZodString>;
                 entityId: z.ZodNullable<z.ZodString>;
                 entityName: z.ZodNullable<z.ZodString>;
+                entityVersionId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                parentEntityType: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                parentEntityId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                parentEntityName: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                parentEntityVersionId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                rootEntityType: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                rootEntityId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                rootEntityName: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                rootEntityVersionId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                threadId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                runId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                sessionId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                userId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                requestId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                serviceName: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                experimentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                environment: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                executionSource: z.ZodDefault<z.ZodNullable<z.ZodString>>;
                 model: z.ZodNullable<z.ZodString>;
                 provider: z.ZodNullable<z.ZodString>;
                 inputPreview: z.ZodNullable<z.ZodString>;
-                inputTruncated: z.ZodBoolean;
                 outputPreview: z.ZodNullable<z.ZodString>;
-                outputTruncated: z.ZodBoolean;
                 errorPreview: z.ZodNullable<z.ZodString>;
-                errorTruncated: z.ZodBoolean;
-                cost: z.ZodDiscriminatedUnion<[z.ZodObject<{
-                    state: z.ZodLiteral<"available">;
-                    amount: z.ZodNumber;
-                    currency: z.ZodString;
-                }, z.core.$strict>, z.ZodObject<{
-                    state: z.ZodLiteral<"missing">;
-                }, z.core.$strict>, z.ZodObject<{
-                    state: z.ZodLiteral<"unavailable">;
-                }, z.core.$strict>], "state">;
+                timeToFirstChunkMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             }, z.core.$strict>>;
             page: z.ZodObject<{
                 next: z.ZodNullable<z.ZodString>;
@@ -6231,6 +6571,7 @@ export declare const NEW_ROUTES: {
                 executionSource?: string | undefined;
                 tags?: string[] | undefined;
                 traceIds?: string[] | undefined;
+                experimentIds?: string[] | undefined;
                 name?: string[] | undefined;
                 source?: string | undefined;
                 provider?: string | undefined;
@@ -6316,6 +6657,7 @@ export declare const NEW_ROUTES: {
                 executionSource: z.ZodOptional<z.ZodString>;
                 tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 traceIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                experimentIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 name: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 source: z.ZodOptional<z.ZodString>;
                 provider: z.ZodOptional<z.ZodString>;
@@ -6382,6 +6724,7 @@ export declare const NEW_ROUTES: {
                 executionSource?: string | undefined;
                 tags?: string[] | undefined;
                 traceIds?: string[] | undefined;
+                experimentIds?: string[] | undefined;
                 name?: string[] | undefined;
                 source?: string | undefined;
                 provider?: string | undefined;
@@ -6468,6 +6811,7 @@ export declare const NEW_ROUTES: {
                 executionSource: z.ZodOptional<z.ZodString>;
                 tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 traceIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                experimentIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 name: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 source: z.ZodOptional<z.ZodString>;
                 provider: z.ZodOptional<z.ZodString>;
@@ -6533,6 +6877,7 @@ export declare const NEW_ROUTES: {
                 executionSource?: string | undefined;
                 tags?: string[] | undefined;
                 traceIds?: string[] | undefined;
+                experimentIds?: string[] | undefined;
                 name?: string[] | undefined;
                 source?: string | undefined;
                 provider?: string | undefined;
@@ -6627,6 +6972,7 @@ export declare const NEW_ROUTES: {
                 executionSource: z.ZodOptional<z.ZodString>;
                 tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 traceIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                experimentIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 name: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 source: z.ZodOptional<z.ZodString>;
                 provider: z.ZodOptional<z.ZodString>;
@@ -6690,6 +7036,7 @@ export declare const NEW_ROUTES: {
                 executionSource?: string | undefined;
                 tags?: string[] | undefined;
                 traceIds?: string[] | undefined;
+                experimentIds?: string[] | undefined;
                 name?: string[] | undefined;
                 source?: string | undefined;
                 provider?: string | undefined;
@@ -6757,6 +7104,7 @@ export declare const NEW_ROUTES: {
                 executionSource: z.ZodOptional<z.ZodString>;
                 tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 traceIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                experimentIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 name: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 source: z.ZodOptional<z.ZodString>;
                 provider: z.ZodOptional<z.ZodString>;
@@ -7019,11 +7367,17 @@ export declare const NEW_ROUTES: {
                 traceQuery: boolean;
                 traceQueryRootDuration: boolean;
                 traceQueryContextIds: boolean;
+                traceQueryTimeToFirstChunk: boolean;
+                traceQueryRootSpanFields: boolean;
+                traceQueryRootEntityId: boolean;
+                traceQueryTimeToFirstChunkSort: boolean;
                 traceQueryDiscovery: boolean;
                 traceQueryTenantScope: boolean;
                 traceAggregate: boolean;
                 threadQuery: boolean;
+                threadQueryRows: boolean;
                 spanQuery: boolean;
+                spanQueryContextFields: boolean;
                 traceRetentionDays?: number | undefined;
                 feedback: boolean;
             };
@@ -7055,11 +7409,17 @@ export declare const NEW_ROUTES: {
                 traceQuery: z.ZodBoolean;
                 traceQueryRootDuration: z.ZodBoolean;
                 traceQueryContextIds: z.ZodBoolean;
+                traceQueryTimeToFirstChunk: z.ZodBoolean;
+                traceQueryRootSpanFields: z.ZodBoolean;
+                traceQueryRootEntityId: z.ZodBoolean;
+                traceQueryTimeToFirstChunkSort: z.ZodBoolean;
                 traceQueryDiscovery: z.ZodBoolean;
                 traceQueryTenantScope: z.ZodBoolean;
                 traceAggregate: z.ZodBoolean;
                 threadQuery: z.ZodBoolean;
+                threadQueryRows: z.ZodDefault<z.ZodBoolean>;
                 spanQuery: z.ZodBoolean;
+                spanQueryContextFields: z.ZodDefault<z.ZodBoolean>;
                 traceRetentionDays: z.ZodOptional<z.ZodNumber>;
                 feedback: z.ZodBoolean;
             }, z.core.$strip>;