@mastra/server 1.79.0-alpha.1 → 1.79.0-alpha.10

package/dist/server/server-adapter/routes/observability.d.ts

@@ -283,7 +283,7 @@ export declare const OBSERVABILITY_ROUTES: readonly [import(".").ServerRoute, Om
             by: ["threadId"];
         } | undefined;
         orderBy?: {
-            field: "endedAt" | "startedAt";
+            field: "endedAt" | "startedAt" | "timeToFirstChunkMs";
             direction: "asc" | "desc";
         }[] | undefined;
         page?: {
@@ -317,6 +317,7 @@ export declare const OBSERVABILITY_ROUTES: readonly [import(".").ServerRoute, Om
             entityType: string | null;
             environment: string | null;
             status: "error" | "success";
+            timeToFirstChunkMs?: number | null | undefined;
         }[];
         page: {
             next: string | null;
@@ -341,6 +342,7 @@ export declare const OBSERVABILITY_ROUTES: readonly [import(".").ServerRoute, Om
             entityType: string | null;
             environment: string | null;
             status: "error" | "success";
+            timeToFirstChunkMs?: number | null | undefined;
         }[];
         pagination: {
             total: number;
@@ -369,6 +371,7 @@ export declare const OBSERVABILITY_ROUTES: readonly [import(".").ServerRoute, Om
             entityType: string | null;
             environment: string | null;
             status: "error" | "success";
+            timeToFirstChunkMs?: number | null | undefined;
         }[];
         delta: {
             limit: number;
@@ -406,6 +409,7 @@ export declare const OBSERVABILITY_ROUTES: readonly [import(".").ServerRoute, Om
             field: import("zod").ZodEnum<{
                 endedAt: "endedAt";
                 startedAt: "startedAt";
+                timeToFirstChunkMs: "timeToFirstChunkMs";
             }>;
             direction: import("zod").ZodEnum<{
                 asc: "asc";
@@ -446,6 +450,7 @@ export declare const OBSERVABILITY_ROUTES: readonly [import(".").ServerRoute, Om
                 error: "error";
                 success: "success";
             }>;
+            timeToFirstChunkMs: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>;
         }, import("zod/v4/core").$strict>>;
         page: import("zod").ZodObject<{
             next: import("zod").ZodNullable<import("zod").ZodString>;
@@ -473,6 +478,7 @@ export declare const OBSERVABILITY_ROUTES: readonly [import(".").ServerRoute, Om
                 error: "error";
                 success: "success";
             }>;
+            timeToFirstChunkMs: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>;
         }, import("zod/v4/core").$strict>>;
         pagination: import("zod").ZodObject<{
             total: import("zod").ZodNumber;
@@ -504,6 +510,7 @@ export declare const OBSERVABILITY_ROUTES: readonly [import(".").ServerRoute, Om
                 error: "error";
                 success: "success";
             }>;
+            timeToFirstChunkMs: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>;
         }, import("zod/v4/core").$strict>>;
         delta: import("zod").ZodObject<{
             limit: import("zod").ZodNumber;
@@ -653,22 +660,86 @@ export declare const OBSERVABILITY_ROUTES: readonly [import(".").ServerRoute, Om
     responseType: "json";
     streamFormat?: 'sse' | 'stream';
     sseFlushOnConnect?: boolean;
-    handler(params: {
-        traces: {
-            timeRange: {
-                from: string;
-                to: string;
-            };
-            where?: import("@mastra/core/storage").TraceQueryPredicate | undefined;
-        };
-        where?: import("@mastra/core/storage").ThreadPredicate | undefined;
+    handler(params: import(".").InferParams<undefined, undefined, import("zod").ZodUnion<readonly [import("zod").ZodPreprocess<import("zod").ZodObject<{
+        timeRange: import("zod").ZodUnion<readonly [import("zod").ZodObject<{
+            traces: import("zod").ZodObject<{
+                from: import("zod").ZodString;
+                to: import("zod").ZodString;
+            }, import("zod/v4/core").$strict>;
+        }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+            threads: import("zod").ZodObject<{
+                from: import("zod").ZodString;
+                to: import("zod").ZodString;
+                field: import("zod").ZodEnum<{
+                    endedAt: "endedAt";
+                    startedAt: "startedAt";
+                }>;
+            }, import("zod/v4/core").$strict>;
+        }, import("zod/v4/core").$strict>]>;
+        where: import("zod").ZodOptional<import("zod").ZodType<import("@mastra/core/storage").TraceQueryScalarPredicate, unknown, import("zod/v4/core").$ZodTypeInternals<import("@mastra/core/storage").TraceQueryScalarPredicate, unknown>>>;
+        orderBy: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodObject<{
+            field: import("zod").ZodEnum<{
+                endedAt: "endedAt";
+                startedAt: "startedAt";
+            }>;
+            direction: import("zod").ZodEnum<{
+                asc: "asc";
+                desc: "desc";
+            }>;
+        }, import("zod/v4/core").$strict>>>;
+        page: import("zod").ZodDefault<import("zod").ZodObject<{
+            limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+            after: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strict>>;
+    }, import("zod/v4/core").$strict>, unknown>, import("zod").ZodPreprocess<import("zod").ZodObject<{
+        traces: import("zod").ZodObject<{
+            timeRange: import("zod").ZodObject<{
+                from: import("zod").ZodString;
+                to: import("zod").ZodString;
+            }, import("zod/v4/core").$strict>;
+            where: import("zod").ZodOptional<import("zod").ZodType<import("@mastra/core/storage").TraceQueryPredicate, unknown, import("zod/v4/core").$ZodTypeInternals<import("@mastra/core/storage").TraceQueryPredicate, unknown>>>;
+        }, import("zod/v4/core").$strict>;
+        where: import("zod").ZodOptional<import("zod").ZodType<import("@mastra/core/storage").ThreadPredicate, unknown, import("zod/v4/core").$ZodTypeInternals<import("@mastra/core/storage").ThreadPredicate, unknown>>>;
+        page: import("zod").ZodDefault<import("zod").ZodObject<{
+            limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+            after: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        }, import("zod/v4/core").$strict>>;
+    }, import("zod/v4/core").$strict>, unknown>]>> & import(".").ServerContext): Promise<{
+        threads: {
+            threadId: string;
+        }[];
         page: {
-            limit: number;
-            after?: string | null | undefined;
+            next: string | null;
         };
-    } & import(".").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;
@@ -684,7 +755,38 @@ export declare const OBSERVABILITY_ROUTES: readonly [import(".").ServerRoute, Om
     requiresPermission?: import("@mastra/core/auth").MastraFGAPermissionInput | import("@mastra/core/auth").MastraFGAPermissionInput[];
     fga?: import("@mastra/core/auth").FGARouteConfig;
     onValidationError?: import("@mastra/core/server").ValidationErrorHook;
-    readonly __schemas?: import(".").RouteSchemas<undefined, undefined, import("zod").ZodPreprocess<import("zod").ZodObject<{
+    readonly __schemas?: import(".").RouteSchemas<undefined, undefined, import("zod").ZodUnion<readonly [import("zod").ZodPreprocess<import("zod").ZodObject<{
+        timeRange: import("zod").ZodUnion<readonly [import("zod").ZodObject<{
+            traces: import("zod").ZodObject<{
+                from: import("zod").ZodString;
+                to: import("zod").ZodString;
+            }, import("zod/v4/core").$strict>;
+        }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+            threads: import("zod").ZodObject<{
+                from: import("zod").ZodString;
+                to: import("zod").ZodString;
+                field: import("zod").ZodEnum<{
+                    endedAt: "endedAt";
+                    startedAt: "startedAt";
+                }>;
+            }, import("zod/v4/core").$strict>;
+        }, import("zod/v4/core").$strict>]>;
+        where: import("zod").ZodOptional<import("zod").ZodType<import("@mastra/core/storage").TraceQueryScalarPredicate, unknown, import("zod/v4/core").$ZodTypeInternals<import("@mastra/core/storage").TraceQueryScalarPredicate, unknown>>>;
+        orderBy: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodObject<{
+            field: import("zod").ZodEnum<{
+                endedAt: "endedAt";
+                startedAt: "startedAt";
+            }>;
+            direction: import("zod").ZodEnum<{
+                asc: "asc";
+                desc: "desc";
+            }>;
+        }, import("zod/v4/core").$strict>>>;
+        page: import("zod").ZodDefault<import("zod").ZodObject<{
+            limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+            after: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strict>>;
+    }, import("zod/v4/core").$strict>, unknown>, import("zod").ZodPreprocess<import("zod").ZodObject<{
         traces: import("zod").ZodObject<{
             timeRange: import("zod").ZodObject<{
                 from: import("zod").ZodString;
@@ -697,14 +799,57 @@ export declare const OBSERVABILITY_ROUTES: readonly [import(".").ServerRoute, Om
             limit: import("zod").ZodDefault<import("zod").ZodNumber>;
             after: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         }, import("zod/v4/core").$strict>>;
-    }, import("zod/v4/core").$strict>, unknown>, import("zod").ZodObject<{
+    }, import("zod/v4/core").$strict>, unknown>]>, import("zod").ZodObject<{
         threads: import("zod").ZodArray<import("zod").ZodObject<{
             threadId: import("zod").ZodString;
         }, import("zod/v4/core").$strict>>;
         page: import("zod").ZodObject<{
             next: import("zod").ZodNullable<import("zod").ZodString>;
         }, import("zod/v4/core").$strict>;
-    }, import("zod/v4/core").$strict>> | undefined;
+    }, import("zod/v4/core").$strict> | import("zod").ZodUnion<readonly [import("zod").ZodObject<{
+        threads: import("zod").ZodArray<import("zod").ZodObject<{
+            organizationId: import("zod").ZodNullable<import("zod").ZodString>;
+            threadId: import("zod").ZodString;
+            firstTraceId: import("zod").ZodString;
+            lastTraceId: import("zod").ZodString;
+            resourceId: import("zod").ZodNullable<import("zod").ZodString>;
+            userId: import("zod").ZodNullable<import("zod").ZodString>;
+            entityType: import("zod").ZodNullable<import("zod").ZodString>;
+            entityId: import("zod").ZodNullable<import("zod").ZodString>;
+            entityName: import("zod").ZodNullable<import("zod").ZodString>;
+            entityVersionId: import("zod").ZodNullable<import("zod").ZodString>;
+            runId: import("zod").ZodNullable<import("zod").ZodString>;
+            sessionId: import("zod").ZodNullable<import("zod").ZodString>;
+            requestId: import("zod").ZodNullable<import("zod").ZodString>;
+            serviceName: import("zod").ZodNullable<import("zod").ZodString>;
+            experimentId: import("zod").ZodNullable<import("zod").ZodString>;
+            environment: import("zod").ZodNullable<import("zod").ZodString>;
+            executionSource: import("zod").ZodNullable<import("zod").ZodString>;
+            status: import("zod").ZodEnum<{
+                error: "error";
+                success: "success";
+            }>;
+            startedAt: import("zod").ZodString;
+            endedAt: import("zod").ZodString;
+            timeToFirstChunkMs: import("zod").ZodNullable<import("zod").ZodNumber>;
+            inputPreview: import("zod").ZodNullable<import("zod").ZodString>;
+            outputPreview: import("zod").ZodNullable<import("zod").ZodString>;
+            errorPreview: import("zod").ZodNullable<import("zod").ZodString>;
+            traceCount: import("zod").ZodNumber;
+            model: import("zod").ZodNullable<import("zod").ZodString>;
+            provider: import("zod").ZodNullable<import("zod").ZodString>;
+        }, import("zod/v4/core").$strict>>;
+        page: import("zod").ZodObject<{
+            next: import("zod").ZodNullable<import("zod").ZodString>;
+        }, import("zod/v4/core").$strict>;
+    }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+        threads: import("zod").ZodArray<import("zod").ZodObject<{
+            threadId: import("zod").ZodString;
+        }, import("zod/v4/core").$strict>>;
+        page: import("zod").ZodObject<{
+            next: import("zod").ZodNullable<import("zod").ZodString>;
+        }, import("zod/v4/core").$strict>;
+    }, import("zod/v4/core").$strict>]>> | undefined;
 } & {
     readonly _mastraSchemaRoute: true;
 }, Omit<import("@mastra/core/server").ApiRoute, "createHandler" | "handler" | "method" | "openapi" | "path"> & {
@@ -720,7 +865,7 @@ export declare const OBSERVABILITY_ROUTES: readonly [import(".").ServerRoute, Om
         };
         where?: import("@mastra/core/storage").TraceQueryScalarPredicate | undefined;
         orderBy: {
-            field: "endedAt" | "startedAt";
+            field: "endedAt" | "startedAt" | "timeToFirstChunkMs";
             direction: "asc" | "desc";
         }[];
         page: {
@@ -766,6 +911,7 @@ export declare const OBSERVABILITY_ROUTES: readonly [import(".").ServerRoute, Om
             inputPreview: string | null;
             outputPreview: string | null;
             errorPreview: string | null;
+            timeToFirstChunkMs?: number | null | undefined;
         }[];
         page: {
             next: string | null;
@@ -791,6 +937,7 @@ export declare const OBSERVABILITY_ROUTES: readonly [import(".").ServerRoute, Om
             field: import("zod").ZodEnum<{
                 endedAt: "endedAt";
                 startedAt: "startedAt";
+                timeToFirstChunkMs: "timeToFirstChunkMs";
             }>;
             direction: import("zod").ZodEnum<{
                 asc: "asc";
@@ -843,6 +990,7 @@ export declare const OBSERVABILITY_ROUTES: readonly [import(".").ServerRoute, Om
             inputPreview: import("zod").ZodNullable<import("zod").ZodString>;
             outputPreview: import("zod").ZodNullable<import("zod").ZodString>;
             errorPreview: import("zod").ZodNullable<import("zod").ZodString>;
+            timeToFirstChunkMs: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>;
         }, import("zod/v4/core").$strict>>;
         page: import("zod").ZodObject<{
             next: import("zod").ZodNullable<import("zod").ZodString>;
@@ -3901,11 +4049,17 @@ export declare const OBSERVABILITY_ROUTES: readonly [import(".").ServerRoute, Om
             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;
         };
@@ -3937,11 +4091,17 @@ export declare const OBSERVABILITY_ROUTES: readonly [import(".").ServerRoute, Om
             traceQuery: import("zod").ZodBoolean;
             traceQueryRootDuration: import("zod").ZodBoolean;
             traceQueryContextIds: import("zod").ZodBoolean;
+            traceQueryTimeToFirstChunk: import("zod").ZodBoolean;
+            traceQueryRootSpanFields: import("zod").ZodBoolean;
+            traceQueryRootEntityId: import("zod").ZodBoolean;
+            traceQueryTimeToFirstChunkSort: import("zod").ZodBoolean;
             traceQueryDiscovery: import("zod").ZodBoolean;
             traceQueryTenantScope: import("zod").ZodBoolean;
             traceAggregate: import("zod").ZodBoolean;
             threadQuery: import("zod").ZodBoolean;
+            threadQueryRows: import("zod").ZodDefault<import("zod").ZodBoolean>;
             spanQuery: import("zod").ZodBoolean;
+            spanQueryContextFields: import("zod").ZodDefault<import("zod").ZodBoolean>;
             traceRetentionDays: import("zod").ZodOptional<import("zod").ZodNumber>;
             feedback: import("zod").ZodBoolean;
         }, import("zod/v4/core").$strip>;

package/dist/server/server-adapter/routes/observability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../../../src/server/server-adapter/routes/observability.ts"],"names":[],"mappings":"AAqDA,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmDvB,CAAC"}
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../../../src/server/server-adapter/routes/observability.ts"],"names":[],"mappings":"AAqDA,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmDvB,CAAC"}

package/dist/server/server-adapter/routes/system.d.ts

@@ -48,11 +48,17 @@ export declare const SYSTEM_ROUTES: readonly [Omit<import("@mastra/core/server")
             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;
         } | undefined;
@@ -118,11 +124,17 @@ export declare const SYSTEM_ROUTES: readonly [Omit<import("@mastra/core/server")
             traceQuery: import("zod").ZodBoolean;
             traceQueryRootDuration: import("zod").ZodBoolean;
             traceQueryContextIds: import("zod").ZodBoolean;
+            traceQueryTimeToFirstChunk: import("zod").ZodBoolean;
+            traceQueryRootSpanFields: import("zod").ZodBoolean;
+            traceQueryRootEntityId: import("zod").ZodBoolean;
+            traceQueryTimeToFirstChunkSort: import("zod").ZodBoolean;
             traceQueryDiscovery: import("zod").ZodBoolean;
             traceQueryTenantScope: import("zod").ZodBoolean;
             traceAggregate: import("zod").ZodBoolean;
             threadQuery: import("zod").ZodBoolean;
+            threadQueryRows: import("zod").ZodDefault<import("zod").ZodBoolean>;
             spanQuery: import("zod").ZodBoolean;
+            spanQueryContextFields: import("zod").ZodDefault<import("zod").ZodBoolean>;
             traceRetentionDays: import("zod").ZodOptional<import("zod").ZodNumber>;
             feedback: import("zod").ZodBoolean;
         }, import("zod/v4/core").$strip>>;

package/dist/server/server-adapter/routes/system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../../src/server/server-adapter/routes/system.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAA6D,CAAC"}
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../../src/server/server-adapter/routes/system.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAA6D,CAAC"}

package/dist/{system-DY6UweSl.cjs → system-BvpFMIJB.cjs}

@@ -30,11 +30,17 @@ const observabilityStorageCapabilitiesSchema = zod_v4.z.object({
 	traceQuery: zod_v4.z.boolean().describe("Advanced trace queries (POST /observability/traces/query). When false, list traces with GET /observability/traces/light instead."),
 	traceQueryRootDuration: zod_v4.z.boolean().describe("`durationMs` predicates in trace and thread queries"),
 	traceQueryContextIds: zod_v4.z.boolean().describe("`runId`, `sessionId`, `userId` and `organizationId` predicates in trace and thread queries"),
+	traceQueryTimeToFirstChunk: zod_v4.z.boolean().describe("`timeToFirstChunkMs` in trace and span query results, and predicates on it in trace, thread and span queries"),
+	traceQueryRootSpanFields: zod_v4.z.boolean().describe("Root span `name` and `spanType` in trace-scope predicates, aggregate `groupBy` and `countDistinct`"),
+	traceQueryRootEntityId: zod_v4.z.boolean().describe("Root span `entityId` in trace-scope predicates, aggregate `groupBy` and `countDistinct`"),
+	traceQueryTimeToFirstChunkSort: zod_v4.z.boolean().describe("Sorting trace and span queries by `timeToFirstChunkMs`"),
 	traceQueryDiscovery: zod_v4.z.boolean().describe("Trace query field discovery (POST /observability/traces/query/fields and /values)"),
 	traceQueryTenantScope: zod_v4.z.boolean().describe("Trusted tenant scoping of trace and thread queries"),
 	traceAggregate: zod_v4.z.boolean().describe("Trace aggregation (POST /observability/traces/aggregate). Unlike `traceQuery`, clients should treat a missing value as unavailable."),
 	threadQuery: zod_v4.z.boolean().describe("Advanced thread queries (POST /observability/threads/query)"),
+	threadQueryRows: zod_v4.z.boolean().default(false).describe("Full-history thread rows with activity windows, filters and sorting. Treat a missing value as unavailable."),
 	spanQuery: zod_v4.z.boolean().describe("Span queries (POST /observability/spans/query)"),
+	spanQueryContextFields: zod_v4.z.boolean().default(false).describe("Additional identity, context and parent/root entity predicates in span queries. Treat a missing value as unavailable."),
 	traceRetentionDays: zod_v4.z.number().int().positive().optional().describe("Days of traces the store keeps. Older traces are gone, so clients can stop users from picking dates before them. Omitted when the store does not report a limit."),
 	feedback: zod_v4.z.boolean().describe("Feedback endpoints (/observability/feedback and /observability/feedback/*). Unsupported feedback routes return 501.")
 });
@@ -164,4 +170,4 @@ Object.defineProperty(exports, "systemPackagesResponseSchema", {
 	}
 });
 
-//# sourceMappingURL=system-DY6UweSl.cjs.map
+//# sourceMappingURL=system-BvpFMIJB.cjs.map

package/dist/system-BvpFMIJB.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-BvpFMIJB.cjs","names":["z"],"sources":["../src/server/schemas/system.ts"],"sourcesContent":["import { z } from 'zod/v4';\n\nexport const mastraPackageSchema = z.object({\n  name: z.string(),\n  version: z.string(),\n});\n\nexport const observabilityRuntimeStrategySchema = z.enum([\n  'realtime',\n  'batch-with-updates',\n  'insert-only',\n  'event-sourced',\n]);\n\nexport const observabilityDiscoveryCapabilitiesSchema = z.object({\n  entityTypes: z.boolean().describe('GET /observability/discovery/entity-types'),\n  entityNames: z.boolean().describe('GET /observability/discovery/entity-names'),\n  serviceNames: z.boolean().describe('GET /observability/discovery/service-names'),\n  environments: z.boolean().describe('GET /observability/discovery/environments'),\n  tags: z.boolean().describe('GET /observability/discovery/tags'),\n  metrics: z.boolean().describe('GET /observability/discovery/metric-names, metric-label-keys and metric-label-values'),\n});\n\n/**\n * Optional observability APIs the configured observability store can serve.\n * Omitted when no observability store is configured.\n */\nexport const observabilityStorageCapabilitiesSchema = z.object({\n  metrics: z.boolean().describe('Metrics endpoints (/observability/metrics and /observability/metrics/*)'),\n  logs: z.boolean().describe('Logs endpoint (GET /observability/logs)'),\n  discovery: observabilityDiscoveryCapabilitiesSchema.describe(\n    'Filter discovery endpoints. Unsupported discovery routes return empty results.',\n  ),\n  deltaPolling: z.boolean().describe(\"Cursor-based `mode: 'delta'` polling on observability list endpoints\"),\n  traceQuery: z\n    .boolean()\n    .describe(\n      'Advanced trace queries (POST /observability/traces/query). When false, list traces with GET /observability/traces/light instead.',\n    ),\n  traceQueryRootDuration: z.boolean().describe('`durationMs` predicates in trace and thread queries'),\n  traceQueryContextIds: z\n    .boolean()\n    .describe('`runId`, `sessionId`, `userId` and `organizationId` predicates in trace and thread queries'),\n  traceQueryTimeToFirstChunk: z\n    .boolean()\n    .describe(\n      '`timeToFirstChunkMs` in trace and span query results, and predicates on it in trace, thread and span queries',\n    ),\n  traceQueryRootSpanFields: z\n    .boolean()\n    .describe('Root span `name` and `spanType` in trace-scope predicates, aggregate `groupBy` and `countDistinct`'),\n  traceQueryRootEntityId: z\n    .boolean()\n    .describe('Root span `entityId` in trace-scope predicates, aggregate `groupBy` and `countDistinct`'),\n  traceQueryTimeToFirstChunkSort: z.boolean().describe('Sorting trace and span queries by `timeToFirstChunkMs`'),\n  traceQueryDiscovery: z\n    .boolean()\n    .describe('Trace query field discovery (POST /observability/traces/query/fields and /values)'),\n  traceQueryTenantScope: z.boolean().describe('Trusted tenant scoping of trace and thread queries'),\n  traceAggregate: z\n    .boolean()\n    .describe(\n      'Trace aggregation (POST /observability/traces/aggregate). Unlike `traceQuery`, clients should treat a missing value as unavailable.',\n    ),\n  threadQuery: z.boolean().describe('Advanced thread queries (POST /observability/threads/query)'),\n  threadQueryRows: z\n    .boolean()\n    .default(false)\n    .describe(\n      'Full-history thread rows with activity windows, filters and sorting. Treat a missing value as unavailable.',\n    ),\n  spanQuery: z.boolean().describe('Span queries (POST /observability/spans/query)'),\n  spanQueryContextFields: z\n    .boolean()\n    .default(false)\n    .describe(\n      'Additional identity, context and parent/root entity predicates in span queries. Treat a missing value as unavailable.',\n    ),\n  traceRetentionDays: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe(\n      'Days of traces the store keeps. Older traces are gone, so clients can stop users from picking dates before them. Omitted when the store does not report a limit.',\n    ),\n  feedback: z\n    .boolean()\n    .describe(\n      'Feedback endpoints (/observability/feedback and /observability/feedback/*). Unsupported feedback routes return 501.',\n    ),\n});\n\nexport const editorSourceSchema = z.enum(['code', 'db']);\n\nexport const editorSourceCapabilitiesSchema = z.object({\n  source: editorSourceSchema,\n  storage: z.enum(['database', 'filesystem', 'source-provider', 'unavailable']),\n  provider: z\n    .object({\n      id: z.string(),\n      displayName: z.string(),\n    })\n    .optional(),\n  canSave: z.boolean(),\n  canOpenChangeRequest: z.boolean(),\n  unavailableReason: z.string().optional(),\n});\n\nexport const systemPackagesResponseSchema = z.object({\n  packages: z.array(mastraPackageSchema),\n  isDev: z.boolean(),\n  cmsEnabled: z.boolean(),\n  /** Whether the default LiveKit connection-details route is registered — not whether credentials or a worker exist. */\n  liveKitConnectionRouteEnabled: z.boolean(),\n  /** True when the default LiveKit trace recording review route is registered. */\n  liveKitRecordingRouteEnabled: z.boolean().optional(),\n  /**\n   * The editor's configured source, when set. `'code'` swaps Studio's\n   * Save/Publish UI for Download JSON + Open PR. `'db'` keeps the standard\n   * Save/Publish flow. Omitted when the editor has no explicit source.\n   */\n  editorSource: editorSourceSchema.optional(),\n  editorSourceCapabilities: editorSourceCapabilitiesSchema.optional(),\n  observabilityEnabled: z.boolean(),\n  storageType: z.string().optional(),\n  observabilityStorageType: z.string().optional(),\n  observabilityStorageCapabilities: observabilityStorageCapabilitiesSchema.optional(),\n  observabilityRuntimeStrategy: observabilityRuntimeStrategySchema.optional(),\n});\n\nconst jsonSchemaRecordSchema = z.record(z.string(), z.unknown());\n\nexport const apiSchemaResponseShapeSchema = z.object({\n  kind: z.enum(['array', 'record', 'object-property', 'single', 'unknown']),\n  listProperty: z.string().optional(),\n  paginationProperty: z.string().optional(),\n});\n\nexport const apiSchemaManifestRouteSchema = z.object({\n  method: z.string(),\n  path: z.string(),\n  responseType: z.string(),\n  pathParamSchema: jsonSchemaRecordSchema.optional(),\n  queryParamSchema: jsonSchemaRecordSchema.optional(),\n  bodySchema: jsonSchemaRecordSchema.optional(),\n  responseSchema: jsonSchemaRecordSchema.optional(),\n  responseShape: apiSchemaResponseShapeSchema,\n});\n\nexport const apiSchemaManifestResponseSchema = z.object({\n  version: z.literal(1),\n  routes: z.array(apiSchemaManifestRouteSchema),\n});\n\nexport type MastraPackage = z.infer<typeof mastraPackageSchema>;\nexport type SystemPackagesResponse = z.infer<typeof systemPackagesResponseSchema>;\n"],"mappings":"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"}

package/dist/{system-MGpkVA20.js → system-CpzPxRRq.js}

@@ -30,11 +30,17 @@ const observabilityStorageCapabilitiesSchema = z.object({
 	traceQuery: z.boolean().describe("Advanced trace queries (POST /observability/traces/query). When false, list traces with GET /observability/traces/light instead."),
 	traceQueryRootDuration: z.boolean().describe("`durationMs` predicates in trace and thread queries"),
 	traceQueryContextIds: z.boolean().describe("`runId`, `sessionId`, `userId` and `organizationId` predicates in trace and thread queries"),
+	traceQueryTimeToFirstChunk: z.boolean().describe("`timeToFirstChunkMs` in trace and span query results, and predicates on it in trace, thread and span queries"),
+	traceQueryRootSpanFields: z.boolean().describe("Root span `name` and `spanType` in trace-scope predicates, aggregate `groupBy` and `countDistinct`"),
+	traceQueryRootEntityId: z.boolean().describe("Root span `entityId` in trace-scope predicates, aggregate `groupBy` and `countDistinct`"),
+	traceQueryTimeToFirstChunkSort: z.boolean().describe("Sorting trace and span queries by `timeToFirstChunkMs`"),
 	traceQueryDiscovery: z.boolean().describe("Trace query field discovery (POST /observability/traces/query/fields and /values)"),
 	traceQueryTenantScope: z.boolean().describe("Trusted tenant scoping of trace and thread queries"),
 	traceAggregate: z.boolean().describe("Trace aggregation (POST /observability/traces/aggregate). Unlike `traceQuery`, clients should treat a missing value as unavailable."),
 	threadQuery: z.boolean().describe("Advanced thread queries (POST /observability/threads/query)"),
+	threadQueryRows: z.boolean().default(false).describe("Full-history thread rows with activity windows, filters and sorting. Treat a missing value as unavailable."),
 	spanQuery: z.boolean().describe("Span queries (POST /observability/spans/query)"),
+	spanQueryContextFields: z.boolean().default(false).describe("Additional identity, context and parent/root entity predicates in span queries. Treat a missing value as unavailable."),
 	traceRetentionDays: z.number().int().positive().optional().describe("Days of traces the store keeps. Older traces are gone, so clients can stop users from picking dates before them. Omitted when the store does not report a limit."),
 	feedback: z.boolean().describe("Feedback endpoints (/observability/feedback and /observability/feedback/*). Unsupported feedback routes return 501.")
 });
@@ -105,4 +111,4 @@ const apiSchemaManifestResponseSchema = z.object({
 //#endregion
 export { editorSourceSchema as a, observabilityRuntimeStrategySchema as c, editorSourceCapabilitiesSchema as i, observabilityStorageCapabilitiesSchema as l, apiSchemaManifestRouteSchema as n, mastraPackageSchema as o, apiSchemaResponseShapeSchema as r, observabilityDiscoveryCapabilitiesSchema as s, apiSchemaManifestResponseSchema as t, systemPackagesResponseSchema as u };
 
-//# sourceMappingURL=system-MGpkVA20.js.map
+//# sourceMappingURL=system-CpzPxRRq.js.map

package/dist/system-CpzPxRRq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-CpzPxRRq.js","names":[],"sources":["../src/server/schemas/system.ts"],"sourcesContent":["import { z } from 'zod/v4';\n\nexport const mastraPackageSchema = z.object({\n  name: z.string(),\n  version: z.string(),\n});\n\nexport const observabilityRuntimeStrategySchema = z.enum([\n  'realtime',\n  'batch-with-updates',\n  'insert-only',\n  'event-sourced',\n]);\n\nexport const observabilityDiscoveryCapabilitiesSchema = z.object({\n  entityTypes: z.boolean().describe('GET /observability/discovery/entity-types'),\n  entityNames: z.boolean().describe('GET /observability/discovery/entity-names'),\n  serviceNames: z.boolean().describe('GET /observability/discovery/service-names'),\n  environments: z.boolean().describe('GET /observability/discovery/environments'),\n  tags: z.boolean().describe('GET /observability/discovery/tags'),\n  metrics: z.boolean().describe('GET /observability/discovery/metric-names, metric-label-keys and metric-label-values'),\n});\n\n/**\n * Optional observability APIs the configured observability store can serve.\n * Omitted when no observability store is configured.\n */\nexport const observabilityStorageCapabilitiesSchema = z.object({\n  metrics: z.boolean().describe('Metrics endpoints (/observability/metrics and /observability/metrics/*)'),\n  logs: z.boolean().describe('Logs endpoint (GET /observability/logs)'),\n  discovery: observabilityDiscoveryCapabilitiesSchema.describe(\n    'Filter discovery endpoints. Unsupported discovery routes return empty results.',\n  ),\n  deltaPolling: z.boolean().describe(\"Cursor-based `mode: 'delta'` polling on observability list endpoints\"),\n  traceQuery: z\n    .boolean()\n    .describe(\n      'Advanced trace queries (POST /observability/traces/query). When false, list traces with GET /observability/traces/light instead.',\n    ),\n  traceQueryRootDuration: z.boolean().describe('`durationMs` predicates in trace and thread queries'),\n  traceQueryContextIds: z\n    .boolean()\n    .describe('`runId`, `sessionId`, `userId` and `organizationId` predicates in trace and thread queries'),\n  traceQueryTimeToFirstChunk: z\n    .boolean()\n    .describe(\n      '`timeToFirstChunkMs` in trace and span query results, and predicates on it in trace, thread and span queries',\n    ),\n  traceQueryRootSpanFields: z\n    .boolean()\n    .describe('Root span `name` and `spanType` in trace-scope predicates, aggregate `groupBy` and `countDistinct`'),\n  traceQueryRootEntityId: z\n    .boolean()\n    .describe('Root span `entityId` in trace-scope predicates, aggregate `groupBy` and `countDistinct`'),\n  traceQueryTimeToFirstChunkSort: z.boolean().describe('Sorting trace and span queries by `timeToFirstChunkMs`'),\n  traceQueryDiscovery: z\n    .boolean()\n    .describe('Trace query field discovery (POST /observability/traces/query/fields and /values)'),\n  traceQueryTenantScope: z.boolean().describe('Trusted tenant scoping of trace and thread queries'),\n  traceAggregate: z\n    .boolean()\n    .describe(\n      'Trace aggregation (POST /observability/traces/aggregate). Unlike `traceQuery`, clients should treat a missing value as unavailable.',\n    ),\n  threadQuery: z.boolean().describe('Advanced thread queries (POST /observability/threads/query)'),\n  threadQueryRows: z\n    .boolean()\n    .default(false)\n    .describe(\n      'Full-history thread rows with activity windows, filters and sorting. Treat a missing value as unavailable.',\n    ),\n  spanQuery: z.boolean().describe('Span queries (POST /observability/spans/query)'),\n  spanQueryContextFields: z\n    .boolean()\n    .default(false)\n    .describe(\n      'Additional identity, context and parent/root entity predicates in span queries. Treat a missing value as unavailable.',\n    ),\n  traceRetentionDays: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe(\n      'Days of traces the store keeps. Older traces are gone, so clients can stop users from picking dates before them. Omitted when the store does not report a limit.',\n    ),\n  feedback: z\n    .boolean()\n    .describe(\n      'Feedback endpoints (/observability/feedback and /observability/feedback/*). Unsupported feedback routes return 501.',\n    ),\n});\n\nexport const editorSourceSchema = z.enum(['code', 'db']);\n\nexport const editorSourceCapabilitiesSchema = z.object({\n  source: editorSourceSchema,\n  storage: z.enum(['database', 'filesystem', 'source-provider', 'unavailable']),\n  provider: z\n    .object({\n      id: z.string(),\n      displayName: z.string(),\n    })\n    .optional(),\n  canSave: z.boolean(),\n  canOpenChangeRequest: z.boolean(),\n  unavailableReason: z.string().optional(),\n});\n\nexport const systemPackagesResponseSchema = z.object({\n  packages: z.array(mastraPackageSchema),\n  isDev: z.boolean(),\n  cmsEnabled: z.boolean(),\n  /** Whether the default LiveKit connection-details route is registered — not whether credentials or a worker exist. */\n  liveKitConnectionRouteEnabled: z.boolean(),\n  /** True when the default LiveKit trace recording review route is registered. */\n  liveKitRecordingRouteEnabled: z.boolean().optional(),\n  /**\n   * The editor's configured source, when set. `'code'` swaps Studio's\n   * Save/Publish UI for Download JSON + Open PR. `'db'` keeps the standard\n   * Save/Publish flow. Omitted when the editor has no explicit source.\n   */\n  editorSource: editorSourceSchema.optional(),\n  editorSourceCapabilities: editorSourceCapabilitiesSchema.optional(),\n  observabilityEnabled: z.boolean(),\n  storageType: z.string().optional(),\n  observabilityStorageType: z.string().optional(),\n  observabilityStorageCapabilities: observabilityStorageCapabilitiesSchema.optional(),\n  observabilityRuntimeStrategy: observabilityRuntimeStrategySchema.optional(),\n});\n\nconst jsonSchemaRecordSchema = z.record(z.string(), z.unknown());\n\nexport const apiSchemaResponseShapeSchema = z.object({\n  kind: z.enum(['array', 'record', 'object-property', 'single', 'unknown']),\n  listProperty: z.string().optional(),\n  paginationProperty: z.string().optional(),\n});\n\nexport const apiSchemaManifestRouteSchema = z.object({\n  method: z.string(),\n  path: z.string(),\n  responseType: z.string(),\n  pathParamSchema: jsonSchemaRecordSchema.optional(),\n  queryParamSchema: jsonSchemaRecordSchema.optional(),\n  bodySchema: jsonSchemaRecordSchema.optional(),\n  responseSchema: jsonSchemaRecordSchema.optional(),\n  responseShape: apiSchemaResponseShapeSchema,\n});\n\nexport const apiSchemaManifestResponseSchema = z.object({\n  version: z.literal(1),\n  routes: z.array(apiSchemaManifestRouteSchema),\n});\n\nexport type MastraPackage = z.infer<typeof mastraPackageSchema>;\nexport type SystemPackagesResponse = z.infer<typeof systemPackagesResponseSchema>;\n"],"mappings":"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"}

package/dist/{utils-D5DHrO3K.js → utils-BBJlS81s.js}

@@ -162,6 +162,23 @@ function getEffectiveThreadId(requestContext, clientThreadId) {
 	return requestContext?.get("mastra__threadId") || clientThreadId;
 }
 /**
+* Applies the effective threadId to a client memory thread option. Object
+* threads keep their other fields (metadata, title, ...) so they reach thread
+* creation; a client-supplied resourceId is dropped because the server decides
+* the resource.
+*/
+function applyEffectiveThreadId(thread, effectiveThreadId) {
+	if (!effectiveThreadId) return thread;
+	if (thread && typeof thread === "object") {
+		const { resourceId: _resourceId, ...fields } = thread;
+		return {
+			...fields,
+			id: effectiveThreadId
+		};
+	}
+	return effectiveThreadId;
+}
+/**
 * Validates that a thread belongs to the specified resourceId.
 * Throws 403 if the thread exists but belongs to a different resource.
 * Threads with no resourceId are accessible to all (shared threads).
@@ -211,6 +228,6 @@ async function validateRunOwnership(run, effectiveResourceId, mastra) {
 	if (!server?.fga) throw new HTTPException(403, { message: "Access denied: unscoped workflow run access requires explicit authorization. Configure an FGA provider to authorize privileged run access." });
 }
 //#endregion
-export { getPublicWorkflowById as a, parsePerPage as c, stripClientCredentialHeaders as d, validateBody as f, MastraFGAPermissions as h, getEffectiveThreadId as i, requireEffectiveResourceId as l, validateThreadOwnership as m, getContextResourceId as n, mergeBodyRequestContext as o, validateRunOwnership as p, getEffectiveResourceId as r, parseFilters as s, enforceThreadAccess as t, sanitizeBody as u };
+export { getEffectiveThreadId as a, parseFilters as c, sanitizeBody as d, stripClientCredentialHeaders as f, MastraFGAPermissions as g, validateThreadOwnership as h, getEffectiveResourceId as i, parsePerPage as l, validateRunOwnership as m, enforceThreadAccess as n, getPublicWorkflowById as o, validateBody as p, getContextResourceId as r, mergeBodyRequestContext as s, applyEffectiveThreadId as t, requireEffectiveResourceId as u };
 
-//# sourceMappingURL=utils-D5DHrO3K.js.map
+//# sourceMappingURL=utils-BBJlS81s.js.map

package/dist/{utils-D5DHrO3K.js.map → utils-BBJlS81s.js.map}

@@ -1 +1 @@
-{"version":3,"file":"utils-D5DHrO3K.js","names":[],"sources":["../src/server/fga-permissions.ts","../src/server/handlers/utils.ts"],"sourcesContent":["/**\n * Safe re-export of `MastraFGAPermissions` from `@mastra/core/auth/ee`.\n *\n * Why this shim exists:\n * `MastraFGAPermissions` was introduced in `@mastra/core@1.32.0`. Earlier\n * versions of `@mastra/core` ship `@mastra/core/auth/ee` but do not export\n * this constant. A direct named import (`import { MastraFGAPermissions }\n * from '@mastra/core/auth/ee'`) fails at ESM link time when this version\n * of `@mastra/server` is paired with `@mastra/core < 1.32.0`, taking the\n * entire user bundle down before any code runs.\n *\n * A namespace import tolerates missing names — `ns.MissingExport` is just\n * `undefined`, no link-time error. We then expose the permission map.\n *\n * Fallback values:\n * If the consuming `@mastra/core` does not export `MastraFGAPermissions`,\n * we substitute a hardcoded map of the canonical permission strings used\n * by routes in `@mastra/server`. This preserves the explicit RBAC\n * permission overrides those routes already had as string literals in\n * `@mastra/server@1.31.0` (e.g. `requiresPermission: \"agents:execute\"`\n * on `/v1/responses`). Without this fallback, `requiresPermission` would\n * be `undefined` on old core and the auth layer would derive the wrong\n * permission from the route path (e.g. `v1:write` instead of\n * `agents:execute`), breaking RBAC users who upgrade `@mastra/server`\n * but stay on `@mastra/core@1.31.0`.\n *\n * Once the consuming `@mastra/core` is on `1.32.0+` the values are real\n * and behaviour is identical to a direct named import.\n */\n\nimport * as authEE from '@mastra/core/auth/ee';\n\n// Canonical strings for the FGA permission keys actually referenced by\n// `@mastra/server` source. Mirrors `MastraFGAPermissions` in\n// `@mastra/core@1.32.0+` for these specific keys, and matches the string\n// literals previously hardcoded on the same routes in `@mastra/server@1.31.0`.\nconst FALLBACK_PERMISSIONS = {\n  AGENTS_CREATE: 'agents:create',\n  AGENTS_DELETE: 'agents:delete',\n  AGENTS_EXECUTE: 'agents:execute',\n  AGENTS_READ: 'agents:read',\n  MEMORY_DELETE: 'memory:delete',\n  MEMORY_READ: 'memory:read',\n  MEMORY_WRITE: 'memory:write',\n  TOOLS_EXECUTE: 'tools:execute',\n  TOOLS_READ: 'tools:read',\n  STORED_WORKFLOWS_READ: 'stored-workflows:read',\n  STORED_WORKFLOWS_WRITE: 'stored-workflows:write',\n  WORKFLOWS_EXECUTE: 'workflows:execute',\n  WORKFLOWS_READ: 'workflows:read',\n} as const;\n\nconst realPermissions = (authEE as any).MastraFGAPermissions;\n\n// Typed as `any` on purpose: consumers of `@mastra/server` may run their\n// typecheck against a `@mastra/core` that doesn't export `MastraFGAPermissions`\n// (anything < 1.32.0). Pinning to the real type would push that name into the\n// emitted `.d.ts` and break downstream typecheck. `any` lets the property\n// accesses (`MastraFGAPermissions.AGENTS_READ`) flow through cleanly on every\n// supported core.\nexport const MastraFGAPermissions: any =\n  realPermissions && Object.keys(realPermissions).length > 0 ? realPermissions : FALLBACK_PERMISSIONS;\n","import type { Mastra } from '@mastra/core';\nimport type { MastraFGAPermissionInput } from '@mastra/core/auth/ee';\nimport type { RequestContext } from '@mastra/core/di';\nimport { MastraMemory } from '@mastra/core/memory';\nimport type { Workflow } from '@mastra/core/workflows';\nimport { MASTRA_RESOURCE_ID_KEY, MASTRA_THREAD_ID_KEY, isReservedRequestContextKey } from '../constants';\nimport { MastraFGAPermissions } from '../fga-permissions';\nimport { HTTPException } from '../http-exception';\n\n/**\n * Resolves a workflow by id or registration key from the set Mastra exposes\n * publicly. Unlike `mastra.getWorkflowById`, this excludes hidden internal\n * workflows (e.g. a durable agent's backing loop), which must never be\n * runnable through HTTP routes.\n */\nexport function getPublicWorkflowById(mastra: Mastra, workflowId: string): Workflow | undefined {\n  const workflows = mastra.listWorkflows();\n  return (\n    Object.values(workflows).find(workflow => workflow.id === workflowId) ??\n    (Object.hasOwn(workflows, workflowId) ? workflows[workflowId] : undefined)\n  );\n}\n\n// Validation helper\nexport function validateBody(body: Record<string, unknown>) {\n  const errorResponse = Object.entries(body).reduce<Record<string, string>>((acc, [key, value]) => {\n    if (!value) {\n      acc[key] = `Argument \"${key}\" is required`;\n    }\n    return acc;\n  }, {});\n\n  if (Object.keys(errorResponse).length > 0) {\n    throw new HTTPException(400, { message: Object.values(errorResponse)[0] });\n  }\n}\n\n/**\n * sanitizes the body by removing disallowed keys.\n * @param body body to sanitize\n * @param disallowedKeys keys to remove from the body\n */\nexport function sanitizeBody(body: Record<string, unknown>, disallowedKeys: string[]) {\n  for (const key of disallowedKeys) {\n    if (key in body) {\n      delete body[key];\n    }\n  }\n}\n\nconst CREDENTIAL_HEADER_NAMES = new Set([\n  'authorization',\n  'proxy-authorization',\n  'x-api-key',\n  'api-key',\n  'x-goog-api-key',\n  'cookie',\n]);\n\n/**\n * Removes credential-bearing headers from client-supplied `modelSettings.headers`\n * so a caller's own auth (e.g. the app's bearer token) can never override the\n * provider credential configured on the server. Non-credential headers are kept.\n */\nexport function stripClientCredentialHeaders(body: Record<string, unknown>) {\n  const modelSettings = body.modelSettings;\n  if (!modelSettings || typeof modelSettings !== 'object') return;\n  const headers = (modelSettings as { headers?: unknown }).headers;\n  if (!headers || typeof headers !== 'object') return;\n\n  const kept = Object.fromEntries(\n    Object.entries(headers).filter(([name]) => !CREDENTIAL_HEADER_NAMES.has(name.toLowerCase())),\n  );\n  body.modelSettings = { ...modelSettings, headers: kept };\n}\n\nexport function parsePerPage(\n  value: string | undefined,\n  defaultValue: number = 100,\n  max: number = 1000,\n): number | false {\n  const normalized = (value || '').trim().toLowerCase();\n  // Handle explicit false to bypass pagination\n  if (normalized === 'false') {\n    return false;\n  }\n  const parsed = parseInt(value || String(defaultValue), 10);\n  if (isNaN(parsed)) return defaultValue;\n  return Math.min(max, Math.max(1, parsed));\n}\n\n/**\n * Parses filter query parameters into a key-value object.\n */\nexport function parseFilters(filters: string | string[] | undefined): Record<string, string> | undefined {\n  if (!filters) return undefined;\n\n  return Object.fromEntries(\n    (Array.isArray(filters) ? filters : [filters]).map((attr: string) => {\n      const [key, ...valueParts] = attr.split(':');\n      const value = valueParts.join(':'); // ✅ Handles colons in values\n      return [key, value];\n    }),\n  );\n}\n\n/**\n * Merges a body-supplied requestContext into the trusted server RequestContext.\n * The server context is authoritative: reserved keys are skipped and body values\n * only fill keys the server context has not already set.\n */\nexport function mergeBodyRequestContext(serverRequestContext: RequestContext, bodyRequestContext: unknown): void {\n  if (!bodyRequestContext || typeof bodyRequestContext !== 'object') {\n    return;\n  }\n\n  for (const [key, value] of Object.entries(bodyRequestContext)) {\n    if (isReservedRequestContextKey(key)) continue;\n    if (serverRequestContext.get(key) === undefined) {\n      serverRequestContext.set(key, value);\n    }\n  }\n}\n\n// ============================================================================\n// Authorization Utilities\n// ============================================================================\n\n/**\n * Gets the effective resourceId, preferring the reserved key from requestContext\n * over client-provided values for security.\n */\nexport function getEffectiveResourceId(\n  requestContext: RequestContext | undefined,\n  clientResourceId: string | undefined,\n): string | undefined {\n  const contextResourceId = requestContext?.get(MASTRA_RESOURCE_ID_KEY) as string | undefined;\n  return contextResourceId || clientResourceId;\n}\n\n/**\n * Returns the resource id resolved from the request context alone (set via\n * `mapUserToResourceId` or the `x-resource-id` header), ignoring any\n * client-provided value. Its presence indicates a resource-scoped caller;\n * its absence indicates a privileged/service context.\n */\nexport function getContextResourceId(requestContext: RequestContext | undefined): string | undefined {\n  return requestContext?.get(MASTRA_RESOURCE_ID_KEY) as string | undefined;\n}\n\n/**\n * Ensures a memory request has a resolvable resource ID. The body's\n * `memory.resource` is optional so authenticated setups can rely on the\n * server-derived resource ID (MASTRA_RESOURCE_ID_KEY set via mapUserToResourceId).\n * When neither the body nor the request context provides one, reject with a\n * clear 400 instead of failing deep inside agent execution.\n */\nexport function requireEffectiveResourceId(\n  effectiveResourceId: string | undefined,\n): asserts effectiveResourceId is string {\n  if (!effectiveResourceId) {\n    throw new HTTPException(400, {\n      message:\n        'A resource ID is required when using memory. Provide memory.resource in the request body, or configure server auth with mapUserToResourceId to derive it from the authenticated user.',\n    });\n  }\n}\n\n/**\n * Gets the effective threadId, preferring the reserved key from requestContext\n * over client-provided values for security.\n */\nexport function getEffectiveThreadId(\n  requestContext: RequestContext | undefined,\n  clientThreadId: string | undefined,\n): string | undefined {\n  const contextThreadId = requestContext?.get(MASTRA_THREAD_ID_KEY) as string | undefined;\n  return contextThreadId || clientThreadId;\n}\n\n/**\n * Validates that a thread belongs to the specified resourceId.\n * Throws 403 if the thread exists but belongs to a different resource.\n * Threads with no resourceId are accessible to all (shared threads).\n */\nexport async function validateThreadOwnership(\n  thread: { resourceId?: string | null } | null | undefined,\n  effectiveResourceId: string | undefined,\n): Promise<void> {\n  if (thread && effectiveResourceId && thread.resourceId && thread.resourceId !== effectiveResourceId) {\n    throw new HTTPException(403, { message: 'Access denied: thread belongs to a different resource' });\n  }\n}\n\n/**\n * Validates both coarse resource ownership and fine-grained thread access.\n * FGA enforcement is a no-op when no FGA provider is configured.\n */\nexport async function enforceThreadAccess({\n  mastra,\n  requestContext,\n  threadId,\n  thread,\n  effectiveResourceId,\n  permission = MastraFGAPermissions.MEMORY_READ,\n}: {\n  mastra: any;\n  requestContext?: RequestContext;\n  threadId: string;\n  thread?: { resourceId?: string | null } | null;\n  effectiveResourceId?: string;\n  permission?: MastraFGAPermissionInput;\n}): Promise<void> {\n  await validateThreadOwnership(thread, effectiveResourceId);\n\n  const fgaProvider = mastra?.getServer?.()?.fga;\n  if (!fgaProvider) {\n    return;\n  }\n\n  const user = requestContext?.get('user');\n  if (!user || typeof user !== 'object') {\n    throw new HTTPException(403, { message: 'FGA authorization denied: authenticated user is required' });\n  }\n\n  await MastraMemory.checkThreadFGA({\n    mastra,\n    user: user as { id: string; [key: string]: unknown },\n    threadId,\n    resourceId: thread?.resourceId ?? effectiveResourceId,\n    requestContext,\n    permission,\n  });\n}\n\n/**\n * Validates that a caller may act on a workflow run.\n *\n * Without `server.auth.mapUserToResourceId` there is no tenancy model, and only a mismatch\n * between two present resource ids is denied. With a mapper, a resource-scoped caller may only\n * act on runs it owns (an owner-less run is not its run). An unscoped caller is a\n * privileged/service context (see getContextResourceId), but that privilege is only granted when\n * an FGA provider authorizes the route; otherwise it is refused rather than granted implicitly,\n * as on the thread-transfer route.\n */\nexport async function validateRunOwnership(\n  run: { resourceId?: string | null } | null | undefined,\n  effectiveResourceId: string | undefined,\n  mastra?: { getServer?: () => { auth?: unknown; fga?: unknown } | undefined },\n): Promise<void> {\n  if (!run) return;\n  const server = mastra?.getServer?.();\n  const tenancy =\n    typeof (server?.auth as { mapUserToResourceId?: unknown } | undefined)?.mapUserToResourceId === 'function';\n  if (!tenancy) {\n    if (effectiveResourceId && run.resourceId && run.resourceId !== effectiveResourceId) {\n      throw new HTTPException(403, { message: 'Access denied: workflow run belongs to a different resource' });\n    }\n    return;\n  }\n  if (effectiveResourceId) {\n    if (run.resourceId !== effectiveResourceId) {\n      throw new HTTPException(403, { message: 'Access denied: workflow run belongs to a different resource' });\n    }\n    return;\n  }\n  if (!server?.fga) {\n    throw new HTTPException(403, {\n      message:\n        'Access denied: unscoped workflow run access requires explicit authorization. Configure an FGA provider to authorize privileged run access.',\n    });\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"utils-BBJlS81s.js","names":[],"sources":["../src/server/fga-permissions.ts","../src/server/handlers/utils.ts"],"sourcesContent":["/**\n * Safe re-export of `MastraFGAPermissions` from `@mastra/core/auth/ee`.\n *\n * Why this shim exists:\n * `MastraFGAPermissions` was introduced in `@mastra/core@1.32.0`. Earlier\n * versions of `@mastra/core` ship `@mastra/core/auth/ee` but do not export\n * this constant. A direct named import (`import { MastraFGAPermissions }\n * from '@mastra/core/auth/ee'`) fails at ESM link time when this version\n * of `@mastra/server` is paired with `@mastra/core < 1.32.0`, taking the\n * entire user bundle down before any code runs.\n *\n * A namespace import tolerates missing names — `ns.MissingExport` is just\n * `undefined`, no link-time error. We then expose the permission map.\n *\n * Fallback values:\n * If the consuming `@mastra/core` does not export `MastraFGAPermissions`,\n * we substitute a hardcoded map of the canonical permission strings used\n * by routes in `@mastra/server`. This preserves the explicit RBAC\n * permission overrides those routes already had as string literals in\n * `@mastra/server@1.31.0` (e.g. `requiresPermission: \"agents:execute\"`\n * on `/v1/responses`). Without this fallback, `requiresPermission` would\n * be `undefined` on old core and the auth layer would derive the wrong\n * permission from the route path (e.g. `v1:write` instead of\n * `agents:execute`), breaking RBAC users who upgrade `@mastra/server`\n * but stay on `@mastra/core@1.31.0`.\n *\n * Once the consuming `@mastra/core` is on `1.32.0+` the values are real\n * and behaviour is identical to a direct named import.\n */\n\nimport * as authEE from '@mastra/core/auth/ee';\n\n// Canonical strings for the FGA permission keys actually referenced by\n// `@mastra/server` source. Mirrors `MastraFGAPermissions` in\n// `@mastra/core@1.32.0+` for these specific keys, and matches the string\n// literals previously hardcoded on the same routes in `@mastra/server@1.31.0`.\nconst FALLBACK_PERMISSIONS = {\n  AGENTS_CREATE: 'agents:create',\n  AGENTS_DELETE: 'agents:delete',\n  AGENTS_EXECUTE: 'agents:execute',\n  AGENTS_READ: 'agents:read',\n  MEMORY_DELETE: 'memory:delete',\n  MEMORY_READ: 'memory:read',\n  MEMORY_WRITE: 'memory:write',\n  TOOLS_EXECUTE: 'tools:execute',\n  TOOLS_READ: 'tools:read',\n  STORED_WORKFLOWS_READ: 'stored-workflows:read',\n  STORED_WORKFLOWS_WRITE: 'stored-workflows:write',\n  WORKFLOWS_EXECUTE: 'workflows:execute',\n  WORKFLOWS_READ: 'workflows:read',\n} as const;\n\nconst realPermissions = (authEE as any).MastraFGAPermissions;\n\n// Typed as `any` on purpose: consumers of `@mastra/server` may run their\n// typecheck against a `@mastra/core` that doesn't export `MastraFGAPermissions`\n// (anything < 1.32.0). Pinning to the real type would push that name into the\n// emitted `.d.ts` and break downstream typecheck. `any` lets the property\n// accesses (`MastraFGAPermissions.AGENTS_READ`) flow through cleanly on every\n// supported core.\nexport const MastraFGAPermissions: any =\n  realPermissions && Object.keys(realPermissions).length > 0 ? realPermissions : FALLBACK_PERMISSIONS;\n","import type { Mastra } from '@mastra/core';\nimport type { MastraFGAPermissionInput } from '@mastra/core/auth/ee';\nimport type { RequestContext } from '@mastra/core/di';\nimport { MastraMemory } from '@mastra/core/memory';\nimport type { Workflow } from '@mastra/core/workflows';\nimport { MASTRA_RESOURCE_ID_KEY, MASTRA_THREAD_ID_KEY, isReservedRequestContextKey } from '../constants';\nimport { MastraFGAPermissions } from '../fga-permissions';\nimport { HTTPException } from '../http-exception';\n\n/**\n * Resolves a workflow by id or registration key from the set Mastra exposes\n * publicly. Unlike `mastra.getWorkflowById`, this excludes hidden internal\n * workflows (e.g. a durable agent's backing loop), which must never be\n * runnable through HTTP routes.\n */\nexport function getPublicWorkflowById(mastra: Mastra, workflowId: string): Workflow | undefined {\n  const workflows = mastra.listWorkflows();\n  return (\n    Object.values(workflows).find(workflow => workflow.id === workflowId) ??\n    (Object.hasOwn(workflows, workflowId) ? workflows[workflowId] : undefined)\n  );\n}\n\n// Validation helper\nexport function validateBody(body: Record<string, unknown>) {\n  const errorResponse = Object.entries(body).reduce<Record<string, string>>((acc, [key, value]) => {\n    if (!value) {\n      acc[key] = `Argument \"${key}\" is required`;\n    }\n    return acc;\n  }, {});\n\n  if (Object.keys(errorResponse).length > 0) {\n    throw new HTTPException(400, { message: Object.values(errorResponse)[0] });\n  }\n}\n\n/**\n * sanitizes the body by removing disallowed keys.\n * @param body body to sanitize\n * @param disallowedKeys keys to remove from the body\n */\nexport function sanitizeBody(body: Record<string, unknown>, disallowedKeys: string[]) {\n  for (const key of disallowedKeys) {\n    if (key in body) {\n      delete body[key];\n    }\n  }\n}\n\nconst CREDENTIAL_HEADER_NAMES = new Set([\n  'authorization',\n  'proxy-authorization',\n  'x-api-key',\n  'api-key',\n  'x-goog-api-key',\n  'cookie',\n]);\n\n/**\n * Removes credential-bearing headers from client-supplied `modelSettings.headers`\n * so a caller's own auth (e.g. the app's bearer token) can never override the\n * provider credential configured on the server. Non-credential headers are kept.\n */\nexport function stripClientCredentialHeaders(body: Record<string, unknown>) {\n  const modelSettings = body.modelSettings;\n  if (!modelSettings || typeof modelSettings !== 'object') return;\n  const headers = (modelSettings as { headers?: unknown }).headers;\n  if (!headers || typeof headers !== 'object') return;\n\n  const kept = Object.fromEntries(\n    Object.entries(headers).filter(([name]) => !CREDENTIAL_HEADER_NAMES.has(name.toLowerCase())),\n  );\n  body.modelSettings = { ...modelSettings, headers: kept };\n}\n\nexport function parsePerPage(\n  value: string | undefined,\n  defaultValue: number = 100,\n  max: number = 1000,\n): number | false {\n  const normalized = (value || '').trim().toLowerCase();\n  // Handle explicit false to bypass pagination\n  if (normalized === 'false') {\n    return false;\n  }\n  const parsed = parseInt(value || String(defaultValue), 10);\n  if (isNaN(parsed)) return defaultValue;\n  return Math.min(max, Math.max(1, parsed));\n}\n\n/**\n * Parses filter query parameters into a key-value object.\n */\nexport function parseFilters(filters: string | string[] | undefined): Record<string, string> | undefined {\n  if (!filters) return undefined;\n\n  return Object.fromEntries(\n    (Array.isArray(filters) ? filters : [filters]).map((attr: string) => {\n      const [key, ...valueParts] = attr.split(':');\n      const value = valueParts.join(':'); // ✅ Handles colons in values\n      return [key, value];\n    }),\n  );\n}\n\n/**\n * Merges a body-supplied requestContext into the trusted server RequestContext.\n * The server context is authoritative: reserved keys are skipped and body values\n * only fill keys the server context has not already set.\n */\nexport function mergeBodyRequestContext(serverRequestContext: RequestContext, bodyRequestContext: unknown): void {\n  if (!bodyRequestContext || typeof bodyRequestContext !== 'object') {\n    return;\n  }\n\n  for (const [key, value] of Object.entries(bodyRequestContext)) {\n    if (isReservedRequestContextKey(key)) continue;\n    if (serverRequestContext.get(key) === undefined) {\n      serverRequestContext.set(key, value);\n    }\n  }\n}\n\n// ============================================================================\n// Authorization Utilities\n// ============================================================================\n\n/**\n * Gets the effective resourceId, preferring the reserved key from requestContext\n * over client-provided values for security.\n */\nexport function getEffectiveResourceId(\n  requestContext: RequestContext | undefined,\n  clientResourceId: string | undefined,\n): string | undefined {\n  const contextResourceId = requestContext?.get(MASTRA_RESOURCE_ID_KEY) as string | undefined;\n  return contextResourceId || clientResourceId;\n}\n\n/**\n * Returns the resource id resolved from the request context alone (set via\n * `mapUserToResourceId` or the `x-resource-id` header), ignoring any\n * client-provided value. Its presence indicates a resource-scoped caller;\n * its absence indicates a privileged/service context.\n */\nexport function getContextResourceId(requestContext: RequestContext | undefined): string | undefined {\n  return requestContext?.get(MASTRA_RESOURCE_ID_KEY) as string | undefined;\n}\n\n/**\n * Ensures a memory request has a resolvable resource ID. The body's\n * `memory.resource` is optional so authenticated setups can rely on the\n * server-derived resource ID (MASTRA_RESOURCE_ID_KEY set via mapUserToResourceId).\n * When neither the body nor the request context provides one, reject with a\n * clear 400 instead of failing deep inside agent execution.\n */\nexport function requireEffectiveResourceId(\n  effectiveResourceId: string | undefined,\n): asserts effectiveResourceId is string {\n  if (!effectiveResourceId) {\n    throw new HTTPException(400, {\n      message:\n        'A resource ID is required when using memory. Provide memory.resource in the request body, or configure server auth with mapUserToResourceId to derive it from the authenticated user.',\n    });\n  }\n}\n\n/**\n * Gets the effective threadId, preferring the reserved key from requestContext\n * over client-provided values for security.\n */\nexport function getEffectiveThreadId(\n  requestContext: RequestContext | undefined,\n  clientThreadId: string | undefined,\n): string | undefined {\n  const contextThreadId = requestContext?.get(MASTRA_THREAD_ID_KEY) as string | undefined;\n  return contextThreadId || clientThreadId;\n}\n\n/**\n * Applies the effective threadId to a client memory thread option. Object\n * threads keep their other fields (metadata, title, ...) so they reach thread\n * creation; a client-supplied resourceId is dropped because the server decides\n * the resource.\n */\nexport function applyEffectiveThreadId<T extends string | { id: string } | undefined>(\n  thread: T,\n  effectiveThreadId: string | undefined,\n): T | string {\n  if (!effectiveThreadId) return thread;\n  if (thread && typeof thread === 'object') {\n    const { resourceId: _resourceId, ...fields } = thread as { id: string; resourceId?: unknown };\n    return { ...fields, id: effectiveThreadId } as T;\n  }\n  return effectiveThreadId;\n}\n\n/**\n * Validates that a thread belongs to the specified resourceId.\n * Throws 403 if the thread exists but belongs to a different resource.\n * Threads with no resourceId are accessible to all (shared threads).\n */\nexport async function validateThreadOwnership(\n  thread: { resourceId?: string | null } | null | undefined,\n  effectiveResourceId: string | undefined,\n): Promise<void> {\n  if (thread && effectiveResourceId && thread.resourceId && thread.resourceId !== effectiveResourceId) {\n    throw new HTTPException(403, { message: 'Access denied: thread belongs to a different resource' });\n  }\n}\n\n/**\n * Validates both coarse resource ownership and fine-grained thread access.\n * FGA enforcement is a no-op when no FGA provider is configured.\n */\nexport async function enforceThreadAccess({\n  mastra,\n  requestContext,\n  threadId,\n  thread,\n  effectiveResourceId,\n  permission = MastraFGAPermissions.MEMORY_READ,\n}: {\n  mastra: any;\n  requestContext?: RequestContext;\n  threadId: string;\n  thread?: { resourceId?: string | null } | null;\n  effectiveResourceId?: string;\n  permission?: MastraFGAPermissionInput;\n}): Promise<void> {\n  await validateThreadOwnership(thread, effectiveResourceId);\n\n  const fgaProvider = mastra?.getServer?.()?.fga;\n  if (!fgaProvider) {\n    return;\n  }\n\n  const user = requestContext?.get('user');\n  if (!user || typeof user !== 'object') {\n    throw new HTTPException(403, { message: 'FGA authorization denied: authenticated user is required' });\n  }\n\n  await MastraMemory.checkThreadFGA({\n    mastra,\n    user: user as { id: string; [key: string]: unknown },\n    threadId,\n    resourceId: thread?.resourceId ?? effectiveResourceId,\n    requestContext,\n    permission,\n  });\n}\n\n/**\n * Validates that a caller may act on a workflow run.\n *\n * Without `server.auth.mapUserToResourceId` there is no tenancy model, and only a mismatch\n * between two present resource ids is denied. With a mapper, a resource-scoped caller may only\n * act on runs it owns (an owner-less run is not its run). An unscoped caller is a\n * privileged/service context (see getContextResourceId), but that privilege is only granted when\n * an FGA provider authorizes the route; otherwise it is refused rather than granted implicitly,\n * as on the thread-transfer route.\n */\nexport async function validateRunOwnership(\n  run: { resourceId?: string | null } | null | undefined,\n  effectiveResourceId: string | undefined,\n  mastra?: { getServer?: () => { auth?: unknown; fga?: unknown } | undefined },\n): Promise<void> {\n  if (!run) return;\n  const server = mastra?.getServer?.();\n  const tenancy =\n    typeof (server?.auth as { mapUserToResourceId?: unknown } | undefined)?.mapUserToResourceId === 'function';\n  if (!tenancy) {\n    if (effectiveResourceId && run.resourceId && run.resourceId !== effectiveResourceId) {\n      throw new HTTPException(403, { message: 'Access denied: workflow run belongs to a different resource' });\n    }\n    return;\n  }\n  if (effectiveResourceId) {\n    if (run.resourceId !== effectiveResourceId) {\n      throw new HTTPException(403, { message: 'Access denied: workflow run belongs to a different resource' });\n    }\n    return;\n  }\n  if (!server?.fga) {\n    throw new HTTPException(403, {\n      message:\n        'Access denied: unscoped workflow run access requires explicit authorization. Configure an FGA provider to authorize privileged run access.',\n    });\n  }\n}\n"],"mappings":"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"}