@mastra/server 1.79.0-alpha.8 → 1.79.0-alpha.9

package/dist/server/handlers/observability-shared.js

@@ -39,7 +39,12 @@ const TRACE_QUERY_CONTEXT_ID_FIELDS = /* @__PURE__ */ new Set([
 const OBSERVABILITY_TRACE_QUERY_TIME_TO_FIRST_CHUNK_STORAGE_FEATURE = "trace-query-time-to-first-chunk";
 const TRACE_QUERY_TIME_TO_FIRST_CHUNK_FIELDS = /* @__PURE__ */ new Set(["timeToFirstChunkMs"]);
 const OBSERVABILITY_TRACE_QUERY_ROOT_SPAN_FIELDS_STORAGE_FEATURE = "trace-query-root-span-fields";
-const TRACE_QUERY_ROOT_SPAN_FIELDS = /* @__PURE__ */ new Set(["name", "spanType"]);
+const OBSERVABILITY_TRACE_QUERY_ROOT_ENTITY_ID_STORAGE_FEATURE = "trace-query-root-entity-id";
+const TRACE_QUERY_ROOT_SPAN_FIELD_FEATURES = /* @__PURE__ */ new Map([
+	["name", OBSERVABILITY_TRACE_QUERY_ROOT_SPAN_FIELDS_STORAGE_FEATURE],
+	["spanType", OBSERVABILITY_TRACE_QUERY_ROOT_SPAN_FIELDS_STORAGE_FEATURE],
+	["entityId", OBSERVABILITY_TRACE_QUERY_ROOT_ENTITY_ID_STORAGE_FEATURE]
+]);
 const OBSERVABILITY_TRACE_QUERY_TIME_TO_FIRST_CHUNK_SORT_STORAGE_FEATURE = "trace-query-time-to-first-chunk-sort";
 const OBSERVABILITY_TRACE_QUERY_DISCOVERY_STORAGE_FEATURE = "trace-query-discovery";
 const OBSERVABILITY_THREAD_QUERY_STORAGE_FEATURE = "thread-query";
@@ -151,12 +156,12 @@ function assertObservabilityTraceQueryTimeToFirstChunkSupported(observabilitySto
 	if (!usesField(predicate, TRACE_QUERY_TIME_TO_FIRST_CHUNK_FIELDS) || supportsObservabilityTraceQueryTimeToFirstChunk(observabilityStore)) return;
 	throw new HTTPException(501, { message: "Time to first chunk predicates are not supported by the configured observability store" });
 }
-function rootSpanFieldIssues(predicate) {
+function rootSpanFieldIssues(observabilityStore, predicate) {
 	if (!predicate) return [];
-	if (predicate.type === "boolean") return predicate.args.flatMap(rootSpanFieldIssues);
-	if (predicate.type === "not") return rootSpanFieldIssues(predicate.arg);
-	if (predicate.type === "relation") return predicate.collection === "traces" ? rootSpanFieldIssues(predicate.predicate) : [];
-	return TRACE_QUERY_ROOT_SPAN_FIELDS.has(predicate.field) ? [rootSpanFieldIssue(["where"], predicate.field)] : [];
+	if (predicate.type === "boolean") return predicate.args.flatMap((arg) => rootSpanFieldIssues(observabilityStore, arg));
+	if (predicate.type === "not") return rootSpanFieldIssues(observabilityStore, predicate.arg);
+	if (predicate.type === "relation") return predicate.collection === "traces" ? rootSpanFieldIssues(observabilityStore, predicate.predicate) : [];
+	return supportsObservabilityTraceQueryRootSpanField(observabilityStore, predicate.field) ? [] : [rootSpanFieldIssue(["where"], predicate.field)];
 }
 function rootSpanFieldIssue(path, field) {
 	return {
@@ -165,28 +170,30 @@ function rootSpanFieldIssue(path, field) {
 		message: `Root span ${field} requires an updated storage adapter with trace-query root span field support.`
 	};
 }
-function supportsObservabilityTraceQueryRootSpanFields(observabilityStore) {
-	return getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_QUERY_ROOT_SPAN_FIELDS_STORAGE_FEATURE) === true;
-}
-function isTraceQueryRootSpanField(path) {
-	return TRACE_QUERY_ROOT_SPAN_FIELDS.has(path);
+/**
+* Whether the store can serve `path` at trace scope. Fields that don't read the root span are
+* always supported here; other gates cover them.
+*/
+function supportsObservabilityTraceQueryRootSpanField(observabilityStore, path) {
+	const feature = TRACE_QUERY_ROOT_SPAN_FIELD_FEATURES.get(path);
+	return feature === void 0 || getFeatures(observabilityStore)?.includes(feature) === true;
 }
 /**
-* Stores that predate trace-scope `name`/`spanType` have no SQL for them and would fail with a
-* 500, so requests that use them are rejected as invalid instead.
+* Stores that predate a trace-scope root span field have no SQL for it and would fail with a
+* 500, so requests that use it are rejected as invalid instead.
 */
 function assertObservabilityTraceQueryRootSpanFieldsSupported(observabilityStore, plan) {
-	if (supportsObservabilityTraceQueryRootSpanFields(observabilityStore)) return;
+	const supported = (field) => supportsObservabilityTraceQueryRootSpanField(observabilityStore, field);
 	const issues = [
-		...rootSpanFieldIssues(plan.where),
-		...(plan.dimensions ?? []).flatMap((dimension, index) => isTraceQueryRootSpanField(dimension) ? [rootSpanFieldIssue(["groupBy", index], dimension)] : []),
-		...(plan.measures ?? []).flatMap((measure, index) => measure.type === "countDistinct" && measure.field !== void 0 && isTraceQueryRootSpanField(measure.field) ? [rootSpanFieldIssue(["measures", index], measure.field)] : [])
+		...rootSpanFieldIssues(observabilityStore, plan.where),
+		...(plan.dimensions ?? []).flatMap((dimension, index) => supported(dimension) ? [] : [rootSpanFieldIssue(["groupBy", index], dimension)]),
+		...(plan.measures ?? []).flatMap((measure, index) => measure.type === "countDistinct" && measure.field !== void 0 && !supported(measure.field) ? [rootSpanFieldIssue(["measures", index], measure.field)] : [])
 	];
 	if (issues.length > 0) throw new coreStorage.TraceQueryValidationError(issues);
 }
 function assertObservabilityTraceQueryRootSpanValuesSupported(observabilityStore, plan) {
-	if (plan.predicateScope !== "trace" || !isTraceQueryRootSpanField(plan.path)) return;
-	if (supportsObservabilityTraceQueryRootSpanFields(observabilityStore)) return;
+	if (plan.predicateScope !== "trace") return;
+	if (supportsObservabilityTraceQueryRootSpanField(observabilityStore, plan.path)) return;
 	throw new coreStorage.TraceQueryValidationError([rootSpanFieldIssue(["path"], plan.path)]);
 }
 function supportsObservabilityTraceQueryTimeToFirstChunkSort(observabilityStore) {
@@ -250,6 +257,7 @@ const NO_OBSERVABILITY_STORAGE_CAPABILITIES = {
 	traceQueryContextIds: false,
 	traceQueryTimeToFirstChunk: false,
 	traceQueryRootSpanFields: false,
+	traceQueryRootEntityId: false,
 	traceQueryTimeToFirstChunkSort: false,
 	traceQueryDiscovery: false,
 	traceQueryTenantScope: false,
@@ -257,6 +265,7 @@ const NO_OBSERVABILITY_STORAGE_CAPABILITIES = {
 	threadQuery: false,
 	threadQueryRows: false,
 	spanQuery: false,
+	spanQueryContextFields: false,
 	feedback: false
 };
 /**
@@ -312,6 +321,7 @@ function getObservabilityStorageCapabilities(observabilityStore) {
 		traceQueryContextIds: (traceQuery || threadQuery) && declares(OBSERVABILITY_TRACE_QUERY_CONTEXT_IDS_STORAGE_FEATURE),
 		traceQueryTimeToFirstChunk: (traceQuery || threadQuery || spanQuery) && declares(OBSERVABILITY_TRACE_QUERY_TIME_TO_FIRST_CHUNK_STORAGE_FEATURE),
 		traceQueryRootSpanFields: (traceQuery || threadQuery) && declares(OBSERVABILITY_TRACE_QUERY_ROOT_SPAN_FIELDS_STORAGE_FEATURE),
+		traceQueryRootEntityId: (traceQuery || threadQuery) && declares(OBSERVABILITY_TRACE_QUERY_ROOT_ENTITY_ID_STORAGE_FEATURE),
 		traceQueryTimeToFirstChunkSort: (traceQuery || spanQuery) && declares(OBSERVABILITY_TRACE_QUERY_TIME_TO_FIRST_CHUNK_SORT_STORAGE_FEATURE),
 		traceQueryDiscovery: newApiCore && supportsTraceQueryDiscoveryCore() && declares(OBSERVABILITY_TRACE_QUERY_DISCOVERY_STORAGE_FEATURE),
 		traceQueryTenantScope: (traceQuery || threadQuery) && coreFeatures.has("observability-trace-query-tenant-scope") && declares(OBSERVABILITY_TRACE_QUERY_TENANT_SCOPE_STORAGE_FEATURE),
@@ -319,6 +329,7 @@ function getObservabilityStorageCapabilities(observabilityStore) {
 		threadQuery,
 		threadQueryRows: threadQuery && typeof coreStorage.planThreadRowsQuery === "function" && declares("thread-query-rows"),
 		spanQuery,
+		spanQueryContextFields: spanQuery && declares("span-query-context-fields"),
 		feedback: newApiCore && declares(OBSERVABILITY_FEEDBACK_STORAGE_FEATURE)
 	};
 }
@@ -663,6 +674,6 @@ function createObservabilityListQuerySchema(filterSchema, orderBySchema) {
 	});
 }
 //#endregion
-export { NEW_ROUTE_DEFS, NO_OBSERVABILITY_STORAGE_CAPABILITIES, OBSERVABILITY_DELTA_POLLING_FEATURE, OBSERVABILITY_DELTA_POLLING_UPGRADE_MESSAGE, OBSERVABILITY_LIST_ENDPOINTS, OBSERVABILITY_TRACE_QUERY_TENANT_SCOPE_CORE_FEATURE, OBSERVABILITY_TRACE_QUERY_TENANT_SCOPE_UPGRADE_MESSAGE, assertObservabilityDeltaSupported, assertObservabilitySpanQueryFieldsSupported, assertObservabilitySpanQuerySupported, assertObservabilityThreadQuerySupported, assertObservabilityTraceAggregateSupported, assertObservabilityTraceQueryContextIdsSupported, assertObservabilityTraceQueryDiscoverySupported, assertObservabilityTraceQueryRootDurationSupported, assertObservabilityTraceQueryRootSpanFieldsSupported, assertObservabilityTraceQueryRootSpanValuesSupported, assertObservabilityTraceQuerySupported, assertObservabilityTraceQueryTenantScopeSupported, assertObservabilityTraceQueryTimeToFirstChunkSortSupported, assertObservabilityTraceQueryTimeToFirstChunkSupported, createObservabilityListQuerySchema, getObservabilityStorageCapabilities, getObservabilityStore, getScoresStore, getStorage, isTraceQueryContextIdField, isTraceQueryRootSpanField, supportsObservabilityTraceAggregate, supportsObservabilityTraceQueryContextIds, supportsObservabilityTraceQueryRootDuration, supportsObservabilityTraceQueryRootSpanFields, supportsObservabilityTraceQueryTimeToFirstChunk, supportsObservabilityTraceQueryTimeToFirstChunkSort, supportsSpanQueryCore, supportsTraceAggregateCore, supportsTraceQueryDiscoveryCore, withDiscoveryFallback };
+export { NEW_ROUTE_DEFS, NO_OBSERVABILITY_STORAGE_CAPABILITIES, OBSERVABILITY_DELTA_POLLING_FEATURE, OBSERVABILITY_DELTA_POLLING_UPGRADE_MESSAGE, OBSERVABILITY_LIST_ENDPOINTS, OBSERVABILITY_TRACE_QUERY_TENANT_SCOPE_CORE_FEATURE, OBSERVABILITY_TRACE_QUERY_TENANT_SCOPE_UPGRADE_MESSAGE, assertObservabilityDeltaSupported, assertObservabilitySpanQueryFieldsSupported, assertObservabilitySpanQuerySupported, assertObservabilityThreadQuerySupported, assertObservabilityTraceAggregateSupported, assertObservabilityTraceQueryContextIdsSupported, assertObservabilityTraceQueryDiscoverySupported, assertObservabilityTraceQueryRootDurationSupported, assertObservabilityTraceQueryRootSpanFieldsSupported, assertObservabilityTraceQueryRootSpanValuesSupported, assertObservabilityTraceQuerySupported, assertObservabilityTraceQueryTenantScopeSupported, assertObservabilityTraceQueryTimeToFirstChunkSortSupported, assertObservabilityTraceQueryTimeToFirstChunkSupported, createObservabilityListQuerySchema, getObservabilityStorageCapabilities, getObservabilityStore, getScoresStore, getStorage, isTraceQueryContextIdField, supportsObservabilityTraceAggregate, supportsObservabilityTraceQueryContextIds, supportsObservabilityTraceQueryRootDuration, supportsObservabilityTraceQueryRootSpanField, supportsObservabilityTraceQueryTimeToFirstChunk, supportsObservabilityTraceQueryTimeToFirstChunkSort, supportsSpanQueryCore, supportsTraceAggregateCore, supportsTraceQueryDiscoveryCore, withDiscoveryFallback };
 
 //# sourceMappingURL=observability-shared.js.map

package/dist/server/handlers/observability-shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"observability-shared.js","names":["candidate"],"sources":["../../../src/server/handlers/observability-shared.ts"],"sourcesContent":["import type { Mastra } from '@mastra/core';\nimport { coreFeatures } from '@mastra/core/features';\nimport type {\n  MastraCompositeStore,\n  ObservabilityStorage,\n  ScoresStorage,\n  TraceQueryIssue,\n  TrustedTraceQueryScalarPredicate,\n  TrustedThreadPredicate,\n  TrustedTraceQueryPredicate,\n} from '@mastra/core/storage';\nimport * as coreStorage from '@mastra/core/storage';\nimport { z } from 'zod/v4';\nimport { HTTPException } from '../http-exception';\nimport type { ServerRoute } from '../server-adapter/routes';\nimport { wrapSchemaForQueryParams } from '../server-adapter/routes/route-builder';\nimport {\n  deltaCursorSchema,\n  deltaLimitSchema,\n  listModeSchema,\n  paginationArgsSchema,\n} from './observability-list-query-schemas';\n\nexport const OBSERVABILITY_DELTA_POLLING_FEATURE = 'observability-delta-polling';\nexport const OBSERVABILITY_DELTA_POLLING_UPGRADE_MESSAGE =\n  'Delta polling requires a newer @mastra/core with observability delta polling support. Please upgrade.';\nconst OBSERVABILITY_TRACE_QUERY_STORAGE_FEATURE = 'trace-query';\nconst OBSERVABILITY_TRACE_AGGREGATE_STORAGE_FEATURE = 'trace-aggregate';\nconst OBSERVABILITY_SPAN_QUERY_STORAGE_FEATURE = 'span-query';\nconst SPAN_QUERY_CONTEXT_FIELDS = new Set([\n  'traceId',\n  'spanId',\n  'parentSpanId',\n  'threadId',\n  'resourceId',\n  'requestId',\n  'serviceName',\n  'experimentId',\n  'environment',\n  'executionSource',\n  'parentEntityType',\n  'parentEntityId',\n  'parentEntityName',\n  'rootEntityType',\n  'rootEntityId',\n  'rootEntityName',\n]);\nconst OBSERVABILITY_TRACE_QUERY_ROOT_DURATION_STORAGE_FEATURE = 'trace-query-root-duration';\nconst OBSERVABILITY_TRACE_QUERY_CONTEXT_IDS_STORAGE_FEATURE = 'trace-query-context-ids';\nconst TRACE_QUERY_CONTEXT_ID_FIELDS = new Set(['runId', 'sessionId', 'userId', 'organizationId']);\nconst OBSERVABILITY_TRACE_QUERY_TIME_TO_FIRST_CHUNK_STORAGE_FEATURE = 'trace-query-time-to-first-chunk';\nconst TRACE_QUERY_TIME_TO_FIRST_CHUNK_FIELDS = new Set(['timeToFirstChunkMs']);\nconst OBSERVABILITY_TRACE_QUERY_ROOT_SPAN_FIELDS_STORAGE_FEATURE = 'trace-query-root-span-fields';\nconst TRACE_QUERY_ROOT_SPAN_FIELDS = new Set(['name', 'spanType']);\nconst OBSERVABILITY_TRACE_QUERY_TIME_TO_FIRST_CHUNK_SORT_STORAGE_FEATURE = 'trace-query-time-to-first-chunk-sort';\nconst OBSERVABILITY_TRACE_QUERY_DISCOVERY_STORAGE_FEATURE = 'trace-query-discovery';\nconst OBSERVABILITY_THREAD_QUERY_STORAGE_FEATURE = 'thread-query';\nconst OBSERVABILITY_TRACE_QUERY_TENANT_SCOPE_STORAGE_FEATURE = 'trace-query-tenant-scope';\nconst OBSERVABILITY_FEEDBACK_STORAGE_FEATURE = 'feedback';\nexport const OBSERVABILITY_TRACE_QUERY_TENANT_SCOPE_CORE_FEATURE = 'observability-trace-query-tenant-scope';\nexport const OBSERVABILITY_TRACE_QUERY_TENANT_SCOPE_UPGRADE_MESSAGE =\n  'Trusted tenant scope requires a newer @mastra/core with trace-query tenant scope support. Please upgrade.';\n\nexport function supportsTraceQueryDiscoveryCore() {\n  return (\n    coreStorage.getTraceQueryFieldsArgsSchema !== undefined &&\n    coreStorage.getTraceQueryFieldsResponseSchema !== undefined &&\n    coreStorage.getTraceQueryValuesArgsSchema !== undefined &&\n    coreStorage.getTraceQueryValuesResponseSchema !== undefined &&\n    typeof coreStorage.planTraceQueryObservedFields === 'function' &&\n    typeof coreStorage.planTraceQueryValues === 'function' &&\n    typeof coreStorage.getTraceQueryCanonicalFieldDescriptors === 'function' &&\n    typeof coreStorage.TraceQueryResourceLimitError === 'function'\n  );\n}\n\nexport function supportsTraceAggregateCore() {\n  return (\n    coreStorage.traceAggregateRequestSchema !== undefined &&\n    coreStorage.traceAggregateResponseSchema !== undefined &&\n    typeof coreStorage.planTraceAggregate === 'function'\n  );\n}\n\nexport function supportsSpanQueryCore() {\n  return (\n    coreStorage.spanQueryRequestSchema !== undefined &&\n    coreStorage.spanQueryResponseSchema !== undefined &&\n    typeof coreStorage.planSpanQuery === 'function'\n  );\n}\n\nexport const OBSERVABILITY_LIST_ENDPOINTS = {\n  traces: 'traces',\n  branches: 'branches',\n  logs: 'logs',\n  metrics: 'metrics',\n  scores: 'scores',\n  feedback: 'feedback',\n} as const;\n\nexport type ObservabilityListEndpoint =\n  (typeof OBSERVABILITY_LIST_ENDPOINTS)[keyof typeof OBSERVABILITY_LIST_ENDPOINTS];\nconst OBSERVABILITY_DELTA_POLLING_STORAGE_FEATURE = 'delta-polling';\n\nfunction getFeatures(observabilityStore: ObservabilityStorage): readonly string[] | undefined {\n  const candidate = observabilityStore as ObservabilityStorage & {\n    getFeatures?: () => readonly string[] | undefined;\n  };\n  return candidate.getFeatures?.();\n}\n\n/** Retrieves MastraCompositeStore or throws 500 if unavailable. */\nexport function getStorage(mastra: Mastra): MastraCompositeStore {\n  const storage = mastra.getStorage();\n  if (!storage) {\n    throw new HTTPException(500, { message: 'Storage is not available' });\n  }\n  return storage;\n}\n\n/** Retrieves the observability storage domain or throws 501 if unavailable. */\nexport async function getObservabilityStore(mastra: Mastra): Promise<ObservabilityStorage> {\n  const storage = getStorage(mastra);\n  const observability = await storage.getStore('observability');\n  if (!observability) {\n    // 501, not 500: a missing or explicitly disabled observability domain\n    // (e.g. `domains: { observability: false }`) is a capability gap, not a\n    // server failure — matching the other 501s in this file.\n    throw new HTTPException(501, { message: 'Observability storage domain is not available' });\n  }\n  return observability;\n}\n\n/** Retrieves the scores storage domain or throws 501 if unavailable. */\nexport async function getScoresStore(mastra: Mastra): Promise<ScoresStorage> {\n  const storage = getStorage(mastra);\n  const scores = await storage.getStore('scores');\n  if (!scores) {\n    throw new HTTPException(501, { message: 'Scores storage domain is not available' });\n  }\n  return scores;\n}\n\nexport function assertObservabilityTraceQuerySupported(observabilityStore: ObservabilityStorage) {\n  if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_QUERY_STORAGE_FEATURE)) return;\n\n  throw new HTTPException(501, {\n    message: 'Advanced trace queries are not supported by the configured observability store',\n  });\n}\n\nexport function supportsObservabilityTraceAggregate(observabilityStore: ObservabilityStorage) {\n  return getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_AGGREGATE_STORAGE_FEATURE) === true;\n}\n\nexport function assertObservabilityTraceAggregateSupported(observabilityStore: ObservabilityStorage) {\n  if (supportsObservabilityTraceAggregate(observabilityStore)) return;\n\n  throw new HTTPException(501, {\n    message: 'Trace aggregation is not supported by the configured observability store',\n  });\n}\n\nexport function assertObservabilitySpanQuerySupported(observabilityStore: ObservabilityStorage) {\n  if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_SPAN_QUERY_STORAGE_FEATURE)) return;\n\n  throw new HTTPException(501, {\n    message: 'Span queries are not supported by the configured observability store',\n  });\n}\n\nexport function assertObservabilitySpanQueryFieldsSupported(\n  observabilityStore: ObservabilityStorage,\n  predicate: TrustedTraceQueryScalarPredicate | undefined,\n) {\n  if (!predicate || getFeatures(observabilityStore)?.includes('span-query-context-fields')) return;\n  if (predicate.type === 'boolean') {\n    for (const arg of predicate.args) assertObservabilitySpanQueryFieldsSupported(observabilityStore, arg);\n  } else if (predicate.type === 'not') {\n    assertObservabilitySpanQueryFieldsSupported(observabilityStore, predicate.arg);\n  } else if (SPAN_QUERY_CONTEXT_FIELDS.has(predicate.field)) {\n    throw new coreStorage.TraceQueryValidationError([\n      {\n        code: 'field_not_allowed',\n        path: ['where'],\n        message: `Filtering by ${predicate.field} requires an updated storage adapter with span query context-field support.`,\n      },\n    ]);\n  }\n}\n\nfunction usesRootDuration(predicate: TrustedTraceQueryPredicate | TrustedThreadPredicate | undefined): boolean {\n  if (!predicate) return false;\n  if (predicate.type === 'boolean') return predicate.args.some(usesRootDuration);\n  if (predicate.type === 'not') return usesRootDuration(predicate.arg);\n  if (predicate.type === 'relation') {\n    return predicate.collection === 'traces' && usesRootDuration(predicate.predicate);\n  }\n  return predicate.field === 'durationMs';\n}\n\nexport function supportsObservabilityTraceQueryRootDuration(observabilityStore: ObservabilityStorage) {\n  return getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_QUERY_ROOT_DURATION_STORAGE_FEATURE) === true;\n}\n\nexport function assertObservabilityTraceQueryRootDurationSupported(\n  observabilityStore: ObservabilityStorage,\n  predicate: TrustedTraceQueryPredicate | TrustedThreadPredicate | undefined,\n) {\n  if (!usesRootDuration(predicate) || supportsObservabilityTraceQueryRootDuration(observabilityStore)) return;\n\n  throw new HTTPException(501, {\n    message: 'Root duration predicates are not supported by the configured observability store',\n  });\n}\n\n/** Whether any scalar predicate, at any depth and inside any relation, names one of `fields`. */\nfunction usesField(\n  predicate: TrustedTraceQueryPredicate | TrustedThreadPredicate | undefined,\n  fields: ReadonlySet<string>,\n): boolean {\n  if (!predicate) return false;\n  if (predicate.type === 'boolean') return predicate.args.some(arg => usesField(arg, fields));\n  if (predicate.type === 'not') return usesField(predicate.arg, fields);\n  if (predicate.type === 'relation') return usesField(predicate.predicate, fields);\n  return fields.has(predicate.field);\n}\n\nexport function supportsObservabilityTraceQueryContextIds(observabilityStore: ObservabilityStorage) {\n  return getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_QUERY_CONTEXT_IDS_STORAGE_FEATURE) === true;\n}\n\nexport function isTraceQueryContextIdField(path: string): boolean {\n  return TRACE_QUERY_CONTEXT_ID_FIELDS.has(path);\n}\n\nexport function assertObservabilityTraceQueryContextIdsSupported(\n  observabilityStore: ObservabilityStorage,\n  predicate: TrustedTraceQueryPredicate | TrustedThreadPredicate | undefined,\n) {\n  if (\n    !usesField(predicate, TRACE_QUERY_CONTEXT_ID_FIELDS) ||\n    supportsObservabilityTraceQueryContextIds(observabilityStore)\n  ) {\n    return;\n  }\n\n  throw new HTTPException(501, {\n    message: 'Context identifier predicates are not supported by the configured observability store',\n  });\n}\n\nexport function supportsObservabilityTraceQueryTimeToFirstChunk(observabilityStore: ObservabilityStorage) {\n  return (\n    getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_QUERY_TIME_TO_FIRST_CHUNK_STORAGE_FEATURE) === true\n  );\n}\n\n/** Covers trace, thread and span query predicates, including `spans` and `traces` relations. */\nexport function assertObservabilityTraceQueryTimeToFirstChunkSupported(\n  observabilityStore: ObservabilityStorage,\n  predicate: TrustedTraceQueryPredicate | TrustedThreadPredicate | undefined,\n) {\n  if (\n    !usesField(predicate, TRACE_QUERY_TIME_TO_FIRST_CHUNK_FIELDS) ||\n    supportsObservabilityTraceQueryTimeToFirstChunk(observabilityStore)\n  ) {\n    return;\n  }\n\n  throw new HTTPException(501, {\n    message: 'Time to first chunk predicates are not supported by the configured observability store',\n  });\n}\n\nfunction rootSpanFieldIssues(\n  predicate: TrustedTraceQueryPredicate | TrustedThreadPredicate | undefined,\n): TraceQueryIssue[] {\n  if (!predicate) return [];\n  if (predicate.type === 'boolean') return predicate.args.flatMap(rootSpanFieldIssues);\n  if (predicate.type === 'not') return rootSpanFieldIssues(predicate.arg);\n  // Only trace-scope `name`/`spanType` read the root; inside `spans.some` they are long-supported span fields.\n  if (predicate.type === 'relation') {\n    return predicate.collection === 'traces' ? rootSpanFieldIssues(predicate.predicate) : [];\n  }\n  return TRACE_QUERY_ROOT_SPAN_FIELDS.has(predicate.field) ? [rootSpanFieldIssue(['where'], predicate.field)] : [];\n}\n\nfunction rootSpanFieldIssue(path: Array<string | number>, field: string): TraceQueryIssue {\n  return {\n    code: 'field_not_allowed',\n    path,\n    message: `Root span ${field} requires an updated storage adapter with trace-query root span field support.`,\n  };\n}\n\nexport function supportsObservabilityTraceQueryRootSpanFields(observabilityStore: ObservabilityStorage) {\n  return getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_QUERY_ROOT_SPAN_FIELDS_STORAGE_FEATURE) === true;\n}\n\nexport function isTraceQueryRootSpanField(path: string): boolean {\n  return TRACE_QUERY_ROOT_SPAN_FIELDS.has(path);\n}\n\n/**\n * Stores that predate trace-scope `name`/`spanType` have no SQL for them and would fail with a\n * 500, so requests that use them are rejected as invalid instead.\n */\nexport function assertObservabilityTraceQueryRootSpanFieldsSupported(\n  observabilityStore: ObservabilityStorage,\n  plan: {\n    where?: TrustedTraceQueryPredicate | TrustedThreadPredicate;\n    dimensions?: readonly string[];\n    measures?: ReadonlyArray<{ type: string; field?: string }>;\n  },\n) {\n  if (supportsObservabilityTraceQueryRootSpanFields(observabilityStore)) return;\n  const issues = [\n    ...rootSpanFieldIssues(plan.where),\n    ...(plan.dimensions ?? []).flatMap((dimension, index) =>\n      isTraceQueryRootSpanField(dimension) ? [rootSpanFieldIssue(['groupBy', index], dimension)] : [],\n    ),\n    ...(plan.measures ?? []).flatMap((measure, index) =>\n      measure.type === 'countDistinct' && measure.field !== undefined && isTraceQueryRootSpanField(measure.field)\n        ? [rootSpanFieldIssue(['measures', index], measure.field)]\n        : [],\n    ),\n  ];\n  if (issues.length > 0) throw new coreStorage.TraceQueryValidationError(issues);\n}\n\nexport function assertObservabilityTraceQueryRootSpanValuesSupported(\n  observabilityStore: ObservabilityStorage,\n  plan: { predicateScope: string; path: string },\n) {\n  if (plan.predicateScope !== 'trace' || !isTraceQueryRootSpanField(plan.path)) return;\n  if (supportsObservabilityTraceQueryRootSpanFields(observabilityStore)) return;\n  throw new coreStorage.TraceQueryValidationError([rootSpanFieldIssue(['path'], plan.path)]);\n}\n\nexport function supportsObservabilityTraceQueryTimeToFirstChunkSort(observabilityStore: ObservabilityStorage) {\n  return (\n    getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_QUERY_TIME_TO_FIRST_CHUNK_SORT_STORAGE_FEATURE) ===\n    true\n  );\n}\n\n/** Covers the sort of trace and span queries. */\nexport function assertObservabilityTraceQueryTimeToFirstChunkSortSupported(\n  observabilityStore: ObservabilityStorage,\n  orderBy: { field: string },\n) {\n  if (\n    !TRACE_QUERY_TIME_TO_FIRST_CHUNK_FIELDS.has(orderBy.field) ||\n    supportsObservabilityTraceQueryTimeToFirstChunkSort(observabilityStore)\n  ) {\n    return;\n  }\n\n  throw new HTTPException(501, {\n    message: 'Sorting by time to first chunk is not supported by the configured observability store',\n  });\n}\n\nexport function assertObservabilityTraceQueryDiscoverySupported(observabilityStore: ObservabilityStorage) {\n  if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_QUERY_DISCOVERY_STORAGE_FEATURE)) return;\n\n  throw new HTTPException(501, {\n    message: 'Trace query discovery is not supported by the configured observability store',\n  });\n}\n\n/**\n * A scoped request must never run unscoped: a store that predates tenant scope would\n * silently ignore `plan.scope` and return every tenant's rows, so it is rejected instead.\n * Unscoped requests are unaffected.\n */\nexport function assertObservabilityTraceQueryTenantScopeSupported(\n  observabilityStore: ObservabilityStorage,\n  scope: coreStorage.TraceQueryTenantScope | undefined,\n) {\n  if (scope === undefined) return;\n  if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_QUERY_TENANT_SCOPE_STORAGE_FEATURE)) return;\n\n  throw new HTTPException(501, {\n    message: 'The configured observability store cannot enforce the trusted tenant scope',\n  });\n}\n\nexport function assertObservabilityThreadQuerySupported(observabilityStore: ObservabilityStorage) {\n  if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_THREAD_QUERY_STORAGE_FEATURE)) return;\n\n  throw new HTTPException(501, {\n    message: 'Advanced thread queries are not supported by the configured observability store',\n  });\n}\n\n/**\n * Returns true when the store's class chain overrides `method` below the class\n * that first declares it (the `ObservabilityStorage` base, whose default\n * throws `*_NOT_IMPLEMENTED`). Walks the store's own prototype chain instead of\n * comparing against this package's `ObservabilityStorage.prototype`, so it\n * works for stores built against older or duplicated `@mastra/core` installs\n * and for stores that predate {@link ObservabilityStorage.getFeatures}.\n */\nfunction implementsObservabilityStorageMethod(observabilityStore: object, method: string): boolean {\n  if (Object.prototype.hasOwnProperty.call(observabilityStore, method)) return true;\n\n  let resolvedOwner: object | undefined;\n  let declaringBase: object | undefined;\n  for (\n    let proto: object | null = Object.getPrototypeOf(observabilityStore);\n    proto && proto !== Object.prototype;\n    proto = Object.getPrototypeOf(proto)\n  ) {\n    if (Object.prototype.hasOwnProperty.call(proto, method)) {\n      resolvedOwner ??= proto;\n      declaringBase = proto;\n    }\n  }\n  return resolvedOwner !== undefined && resolvedOwner !== declaringBase;\n}\n\nexport type ObservabilityDiscoveryCapabilities = {\n  entityTypes: boolean;\n  entityNames: boolean;\n  serviceNames: boolean;\n  environments: boolean;\n  tags: boolean;\n  metrics: boolean;\n};\n\nexport type ObservabilityStorageCapabilities = {\n  metrics: boolean;\n  logs: boolean;\n  discovery: ObservabilityDiscoveryCapabilities;\n  deltaPolling: boolean;\n  traceQuery: boolean;\n  traceQueryRootDuration: boolean;\n  traceQueryContextIds: boolean;\n  traceQueryTimeToFirstChunk: boolean;\n  traceQueryRootSpanFields: boolean;\n  traceQueryTimeToFirstChunkSort: boolean;\n  traceQueryDiscovery: boolean;\n  traceQueryTenantScope: boolean;\n  traceAggregate: boolean;\n  threadQuery: boolean;\n  threadQueryRows: boolean;\n  spanQuery: boolean;\n  /** Days of traces the store keeps. Omitted when the store does not report a limit. */\n  traceRetentionDays?: number;\n  feedback: boolean;\n};\n\nexport const NO_OBSERVABILITY_STORAGE_CAPABILITIES: ObservabilityStorageCapabilities = {\n  metrics: false,\n  logs: false,\n  discovery: {\n    entityTypes: false,\n    entityNames: false,\n    serviceNames: false,\n    environments: false,\n    tags: false,\n    metrics: false,\n  },\n  deltaPolling: false,\n  traceQuery: false,\n  traceQueryRootDuration: false,\n  traceQueryContextIds: false,\n  traceQueryTimeToFirstChunk: false,\n  traceQueryRootSpanFields: false,\n  traceQueryTimeToFirstChunkSort: false,\n  traceQueryDiscovery: false,\n  traceQueryTenantScope: false,\n  traceAggregate: false,\n  threadQuery: false,\n  threadQueryRows: false,\n  spanQuery: false,\n  feedback: false,\n};\n\n/**\n * Resolves which optional observability APIs the configured store can serve.\n *\n * Feature declarations (`getFeatures()`) are optional. When a store declares\n * a feature list, that list is final. Stores without `getFeatures()` predate\n * declarations: metrics, logs and filter discovery are detected by whether the\n * store implements the underlying method, so those packages report accurately\n * without being upgraded. Delta polling and the trace/thread query APIs depend\n * on runtime behavior a method check can't see, so they are only reported for\n * stores that declare them. Feedback is also declaration-only: Studio hides\n * the feedback UI behind this flag, and store versions that implement feedback\n * without declaring it simply don't advertise it until upgraded.\n */\nexport function getObservabilityStorageCapabilities(\n  observabilityStore: ObservabilityStorage,\n): ObservabilityStorageCapabilities {\n  const declaredFeatures = getFeatures(observabilityStore);\n  const features = declaredFeatures ?? [];\n  const newApiCore = coreFeatures.has('observability:v1.13.2');\n  const declares = (feature: string) => features.includes(feature);\n  // Undeclared stores must implement every method behind the feature.\n  const supports = (feature: string, methods: readonly string[]) => {\n    if (!newApiCore) return false;\n    if (!declaredFeatures) {\n      return methods.every(method => implementsObservabilityStorageMethod(observabilityStore, method));\n    }\n    return declares(feature);\n  };\n  // Stores released before the per-endpoint discovery features existed declare\n  // `trace-query` and implement every discovery method, so treat it as implying discovery.\n  const supportsDiscovery = (feature: string, methods: readonly string[]) =>\n    supports(feature, methods) || (newApiCore && declares(OBSERVABILITY_TRACE_QUERY_STORAGE_FEATURE));\n  const traceQuery =\n    newApiCore &&\n    typeof coreStorage.planTraceQuery === 'function' &&\n    declares(OBSERVABILITY_TRACE_QUERY_STORAGE_FEATURE);\n  const threadQuery =\n    newApiCore &&\n    typeof coreStorage.planThreadQuery === 'function' &&\n    declares(OBSERVABILITY_THREAD_QUERY_STORAGE_FEATURE);\n  const spanQuery = newApiCore && supportsSpanQueryCore() && declares(OBSERVABILITY_SPAN_QUERY_STORAGE_FEATURE);\n\n  return {\n    // `listMetrics` is left out: it backs a newer route that metric dashboards don't use,\n    // and older stores that implement the OLAP methods predate it.\n    metrics: supports('metrics', [\n      'getMetricAggregate',\n      'getMetricBreakdown',\n      'getMetricTimeSeries',\n      'getMetricPercentiles',\n    ]),\n    logs: supports('logs', ['listLogs']),\n    discovery: {\n      entityTypes: supportsDiscovery('entity-type-discovery', ['getEntityTypes']),\n      entityNames: supportsDiscovery('entity-name-discovery', ['getEntityNames']),\n      serviceNames: supportsDiscovery('service-name-discovery', ['getServiceNames']),\n      environments: supportsDiscovery('environment-discovery', ['getEnvironments']),\n      tags: supportsDiscovery('tag-discovery', ['getTags']),\n      metrics: supportsDiscovery('metric-discovery', ['getMetricNames', 'getMetricLabelKeys', 'getMetricLabelValues']),\n    },\n    deltaPolling:\n      coreFeatures.has(OBSERVABILITY_DELTA_POLLING_FEATURE) && declares(OBSERVABILITY_DELTA_POLLING_STORAGE_FEATURE),\n    traceQuery,\n    traceQueryRootDuration:\n      (traceQuery || threadQuery) && declares(OBSERVABILITY_TRACE_QUERY_ROOT_DURATION_STORAGE_FEATURE),\n    traceQueryContextIds:\n      (traceQuery || threadQuery) && declares(OBSERVABILITY_TRACE_QUERY_CONTEXT_IDS_STORAGE_FEATURE),\n    traceQueryTimeToFirstChunk:\n      (traceQuery || threadQuery || spanQuery) &&\n      declares(OBSERVABILITY_TRACE_QUERY_TIME_TO_FIRST_CHUNK_STORAGE_FEATURE),\n    traceQueryRootSpanFields:\n      (traceQuery || threadQuery) && declares(OBSERVABILITY_TRACE_QUERY_ROOT_SPAN_FIELDS_STORAGE_FEATURE),\n    traceQueryTimeToFirstChunkSort:\n      (traceQuery || spanQuery) && declares(OBSERVABILITY_TRACE_QUERY_TIME_TO_FIRST_CHUNK_SORT_STORAGE_FEATURE),\n    traceQueryDiscovery:\n      newApiCore && supportsTraceQueryDiscoveryCore() && declares(OBSERVABILITY_TRACE_QUERY_DISCOVERY_STORAGE_FEATURE),\n    traceQueryTenantScope:\n      (traceQuery || threadQuery) &&\n      coreFeatures.has(OBSERVABILITY_TRACE_QUERY_TENANT_SCOPE_CORE_FEATURE) &&\n      declares(OBSERVABILITY_TRACE_QUERY_TENANT_SCOPE_STORAGE_FEATURE),\n    traceAggregate:\n      newApiCore && supportsTraceAggregateCore() && declares(OBSERVABILITY_TRACE_AGGREGATE_STORAGE_FEATURE),\n    threadQuery,\n    threadQueryRows:\n      threadQuery && typeof coreStorage.planThreadRowsQuery === 'function' && declares('thread-query-rows'),\n    spanQuery,\n    feedback: newApiCore && declares(OBSERVABILITY_FEEDBACK_STORAGE_FEATURE),\n  };\n}\n\n/**\n * Matches the `OBSERVABILITY_STORAGE_*_NOT_IMPLEMENTED` MastraError the base\n * observability store throws for every optional method a store doesn't\n * implement. Checked by id (not `instanceof`) so it holds across duplicated\n * `@mastra/core` installs.\n */\nfunction isObservabilityStorageNotImplementedError(error: unknown): boolean {\n  const id = error && typeof error === 'object' && 'id' in error ? error.id : undefined;\n  return typeof id === 'string' && id.startsWith('OBSERVABILITY_STORAGE_') && id.endsWith('_NOT_IMPLEMENTED');\n}\n\n/**\n * Discovery is optional for observability stores. When the configured store\n * doesn't implement a discovery method, answer with an empty result instead of\n * a 500 so filter lookups degrade quietly on stores without discovery support.\n * Clients should check `observabilityStorageCapabilities.discovery` from\n * `GET /system/packages` before calling these routes.\n */\nexport async function withDiscoveryFallback<T>(run: () => Promise<T>, empty: T): Promise<T> {\n  try {\n    return await run();\n  } catch (error) {\n    if (isObservabilityStorageNotImplementedError(error)) return empty;\n    throw error;\n  }\n}\n\nexport function assertObservabilityDeltaSupported(\n  observabilityStore: ObservabilityStorage,\n  endpoint: ObservabilityListEndpoint,\n) {\n  if (!coreFeatures.has(OBSERVABILITY_DELTA_POLLING_FEATURE)) {\n    throw new HTTPException(501, {\n      message: `${OBSERVABILITY_DELTA_POLLING_UPGRADE_MESSAGE} (endpoint: ${endpoint})`,\n    });\n  }\n\n  if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_DELTA_POLLING_STORAGE_FEATURE)) {\n    return;\n  }\n\n  throw new HTTPException(501, {\n    message: `Delta polling is not supported by the configured observability store for ${endpoint}`,\n  });\n}\n\nexport interface RouteDetails {\n  method: ServerRoute['method'];\n  path: `/${string}`;\n  summary: string;\n  description: string;\n  requiresPermission?: ServerRoute['requiresPermission'];\n}\n\nexport const NEW_ROUTE_DEFS = {\n  QUERY_TRACES: {\n    method: 'POST',\n    path: '/observability/traces/query',\n    summary: 'Query traces',\n    description:\n      'Returns completed logical traces or distinct thread groups matching an advanced trace query. Thread grouping remains supported but is deprecated; use queryTraceThreads instead.',\n    requiresPermission: 'observability:read',\n  },\n\n  AGGREGATE_TRACES: {\n    method: 'POST',\n    path: '/observability/traces/aggregate',\n    summary: 'Aggregate traces',\n    description:\n      'Returns grouped and optionally time-bucketed measures (counts, durations, error rates) over completed logical traces matching an advanced trace predicate',\n    requiresPermission: 'observability:read',\n  },\n\n  QUERY_THREADS: {\n    method: 'POST',\n    path: '/observability/threads/query',\n    summary: 'Query threads',\n    description:\n      'Returns full-history thread rows with activity timestamps, first/last traces, previews and context fields',\n    requiresPermission: 'observability:read',\n  },\n\n  QUERY_SPANS: {\n    method: 'POST',\n    path: '/observability/spans/query',\n    summary: 'Query spans',\n    description: 'Returns completed spans matching a span predicate, one row per span, with cursor pagination',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_TRACE_QUERY_FIELDS: {\n    method: 'POST',\n    path: '/observability/traces/query/fields',\n    summary: 'Discover trace query fields',\n    description: 'Returns canonical query fields and observed top-level string metadata fields',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_TRACE_QUERY_VALUES: {\n    method: 'POST',\n    path: '/observability/traces/query/values',\n    summary: 'Discover trace query values',\n    description: 'Returns bounded string value suggestions and occurrence counts for one eligible query field',\n    requiresPermission: 'observability:read',\n  },\n\n  LIST_METRICS: {\n    method: 'GET',\n    path: '/observability/metrics',\n    summary: 'List metrics',\n    description: 'Returns a paginated list of metrics with optional filtering and sorting',\n  },\n\n  LIST_LOGS: {\n    method: 'GET',\n    path: '/observability/logs',\n    summary: 'List logs',\n    description: 'Returns a paginated list of logs with optional filtering and sorting',\n  },\n\n  LIST_SCORES: {\n    method: 'GET',\n    path: '/observability/scores',\n    summary: 'List scores',\n    description: 'Returns a paginated list of scores with optional filtering and sorting',\n  },\n\n  CREATE_SCORE: {\n    method: 'POST',\n    path: '/observability/scores',\n    summary: 'Create a score',\n    description: 'Creates a single score record in the observability store',\n  },\n\n  DELETE_SCORES: {\n    method: 'DELETE',\n    path: '/observability/scores',\n    summary: 'Delete scores',\n    description: 'Deletes score records by scoreId, optionally scoped to a tenant',\n    requiresPermission: 'observability:delete',\n  },\n\n  GET_SCORE: {\n    method: 'GET',\n    path: '/observability/scores/:scoreId',\n    summary: 'Get score',\n    description: 'Returns a single score by scoreId',\n  },\n\n  GET_SCORE_AGGREGATE: {\n    method: 'POST',\n    path: '/observability/scores/aggregate',\n    summary: 'Get score aggregate',\n    description: 'Returns an aggregated score value with optional period-over-period comparison',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_SCORE_BREAKDOWN: {\n    method: 'POST',\n    path: '/observability/scores/breakdown',\n    summary: 'Get score breakdown',\n    description: 'Returns score values grouped by specified dimensions',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_SCORE_TIME_SERIES: {\n    method: 'POST',\n    path: '/observability/scores/timeseries',\n    summary: 'Get score time series',\n    description: 'Returns score values bucketed by time interval with optional grouping',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_SCORE_PERCENTILES: {\n    method: 'POST',\n    path: '/observability/scores/percentiles',\n    summary: 'Get score percentiles',\n    description: 'Returns percentile values for a score bucketed by time interval',\n    requiresPermission: 'observability:read',\n  },\n\n  LIST_FEEDBACK: {\n    method: 'GET',\n    path: '/observability/feedback',\n    summary: 'List feedback',\n    description: 'Returns a paginated list of feedback with optional filtering and sorting',\n  },\n\n  CREATE_FEEDBACK: {\n    method: 'POST',\n    path: '/observability/feedback',\n    summary: 'Create feedback',\n    description: 'Creates a single feedback record in the observability store',\n  },\n\n  DELETE_FEEDBACK: {\n    method: 'DELETE',\n    path: '/observability/feedback',\n    summary: 'Delete feedback',\n    description: 'Deletes feedback records by feedbackId, optionally scoped to a tenant',\n    requiresPermission: 'observability:delete',\n  },\n\n  UPDATE_FEEDBACK_REVIEW_STATUS: {\n    method: 'PATCH',\n    path: '/observability/feedback/:feedbackId/review-status',\n    summary: 'Update feedback review status',\n    description: \"Updates a feedback record's review workflow status\",\n    requiresPermission: 'observability:write',\n  },\n\n  GET_FEEDBACK_AGGREGATE: {\n    method: 'POST',\n    path: '/observability/feedback/aggregate',\n    summary: 'Get feedback aggregate',\n    description: 'Returns an aggregated numeric feedback value with optional period-over-period comparison',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_FEEDBACK_BREAKDOWN: {\n    method: 'POST',\n    path: '/observability/feedback/breakdown',\n    summary: 'Get feedback breakdown',\n    description: 'Returns numeric feedback values grouped by specified dimensions',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_FEEDBACK_TIME_SERIES: {\n    method: 'POST',\n    path: '/observability/feedback/timeseries',\n    summary: 'Get feedback time series',\n    description: 'Returns numeric feedback values bucketed by time interval with optional grouping',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_FEEDBACK_PERCENTILES: {\n    method: 'POST',\n    path: '/observability/feedback/percentiles',\n    summary: 'Get feedback percentiles',\n    description: 'Returns percentile values for numeric feedback bucketed by time interval',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_METRIC_AGGREGATE: {\n    method: 'POST',\n    path: '/observability/metrics/aggregate',\n    summary: 'Get metric aggregate',\n    description: 'Returns an aggregated metric value with optional period-over-period comparison',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_METRIC_BREAKDOWN: {\n    method: 'POST',\n    path: '/observability/metrics/breakdown',\n    summary: 'Get metric breakdown',\n    description: 'Returns metric values grouped by specified dimensions',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_METRIC_TIME_SERIES: {\n    method: 'POST',\n    path: '/observability/metrics/timeseries',\n    summary: 'Get metric time series',\n    description: 'Returns metric values bucketed by time interval with optional grouping',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_METRIC_PERCENTILES: {\n    method: 'POST',\n    path: '/observability/metrics/percentiles',\n    summary: 'Get metric percentiles',\n    description: 'Returns percentile values for a metric bucketed by time interval',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_METRIC_NAMES: {\n    method: 'GET',\n    path: '/observability/discovery/metric-names',\n    summary: 'Get metric names',\n    description: 'Returns distinct metric names with optional prefix filtering',\n  },\n\n  GET_METRIC_LABEL_KEYS: {\n    method: 'GET',\n    path: '/observability/discovery/metric-label-keys',\n    summary: 'Get metric label keys',\n    description: 'Returns distinct label keys for a given metric',\n  },\n\n  GET_METRIC_LABEL_VALUES: {\n    method: 'GET',\n    path: '/observability/discovery/metric-label-values',\n    summary: 'Get label values',\n    description: 'Returns distinct values for a given metric label key',\n  },\n\n  GET_ENTITY_TYPES: {\n    method: 'GET',\n    path: '/observability/discovery/entity-types',\n    summary: 'Get entity types',\n    description: 'Returns distinct entity types from observability data',\n  },\n\n  GET_ENTITY_NAMES: {\n    method: 'GET',\n    path: '/observability/discovery/entity-names',\n    summary: 'Get entity names',\n    description: 'Returns distinct entity names with optional type filtering',\n  },\n\n  GET_SERVICE_NAMES: {\n    method: 'GET',\n    path: '/observability/discovery/service-names',\n    summary: 'Get service names',\n    description: 'Returns distinct service names from observability data',\n  },\n\n  GET_ENVIRONMENTS: {\n    method: 'GET',\n    path: '/observability/discovery/environments',\n    summary: 'Get environments',\n    description: 'Returns distinct environments from observability data',\n  },\n\n  GET_TAGS: {\n    method: 'GET',\n    path: '/observability/discovery/tags',\n    summary: 'Get tags',\n    description: 'Returns distinct tags with optional entity type filtering',\n  },\n\n  GET_CAPABILITIES: {\n    method: 'GET',\n    path: '/observability/capabilities',\n    summary: 'Get observability capabilities',\n    description:\n      'Returns which optional observability APIs the configured observability storage supports. Every flag is false when no observability storage is configured.',\n  },\n} as const satisfies Record<string, RouteDetails>;\n\nexport type NewRoutesKey = keyof typeof NEW_ROUTE_DEFS;\nexport type NewRoutesDefinitions = (typeof NEW_ROUTE_DEFS)[NewRoutesKey];\n\nexport function createObservabilityListQuerySchema<\n  TFilter extends z.ZodObject<z.ZodRawShape>,\n  TOrderBy extends z.ZodObject<z.ZodRawShape>,\n>(filterSchema: TFilter, orderBySchema: TOrderBy) {\n  const unwrapDefault = (schema: unknown) => {\n    const zodSchema = schema as z.ZodTypeAny;\n    return zodSchema instanceof z.ZodDefault ? zodSchema.unwrap() : zodSchema;\n  };\n  const paginationShape = paginationArgsSchema.shape as unknown as Record<string, z.ZodTypeAny>;\n  const orderByShape = orderBySchema.shape as unknown as Record<string, z.ZodTypeAny>;\n\n  const pageSchema = unwrapDefault(paginationShape.page);\n  const perPageSchema = unwrapDefault(paginationShape.perPage);\n  const fieldSchema = orderByShape.field ? unwrapDefault(orderByShape.field) : z.never().optional();\n  const directionSchema = orderByShape.direction ? unwrapDefault(orderByShape.direction) : z.never().optional();\n\n  return wrapSchemaForQueryParams(\n    z\n      .object({\n        ...filterSchema.shape,\n        page: pageSchema,\n        perPage: perPageSchema,\n        field: fieldSchema,\n        direction: directionSchema,\n        mode: listModeSchema.optional(),\n        after: deltaCursorSchema.optional(),\n        limit: deltaLimitSchema,\n      })\n      .partial(),\n  ).superRefine((value, ctx) => {\n    const isDelta = value.mode === 'delta';\n    const hasPagination = value.page !== undefined || value.perPage !== undefined;\n    const hasOrderBy = value.field !== undefined || value.direction !== undefined;\n    const hasAfter = value.after !== undefined;\n    const hasLimit = value.limit !== undefined;\n\n    if (isDelta) {\n      if (hasPagination) {\n        if (value.page !== undefined) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: ['page'],\n            message: '`page` is not allowed when `mode=delta`',\n          });\n        }\n        if (value.perPage !== undefined) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: ['perPage'],\n            message: '`perPage` is not allowed when `mode=delta`',\n          });\n        }\n      }\n      if (hasOrderBy) {\n        if (value.field !== undefined) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: ['field'],\n            message: '`field` is not allowed when `mode=delta`',\n          });\n        }\n        if (value.direction !== undefined) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: ['direction'],\n            message: '`direction` is not allowed when `mode=delta`',\n          });\n        }\n      }\n      return;\n    }\n\n    if (hasAfter) {\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        path: ['after'],\n        message: '`after` is only allowed when `mode=delta`',\n      });\n    }\n    if (hasLimit) {\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        path: ['limit'],\n        message: '`limit` is only allowed when `mode=delta`',\n      });\n    }\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"observability-shared.js","names":["candidate"],"sources":["../../../src/server/handlers/observability-shared.ts"],"sourcesContent":["import type { Mastra } from '@mastra/core';\nimport { coreFeatures } from '@mastra/core/features';\nimport type {\n  MastraCompositeStore,\n  ObservabilityStorage,\n  ScoresStorage,\n  TraceQueryIssue,\n  TrustedTraceQueryScalarPredicate,\n  TrustedThreadPredicate,\n  TrustedTraceQueryPredicate,\n} from '@mastra/core/storage';\nimport * as coreStorage from '@mastra/core/storage';\nimport { z } from 'zod/v4';\nimport { HTTPException } from '../http-exception';\nimport type { ServerRoute } from '../server-adapter/routes';\nimport { wrapSchemaForQueryParams } from '../server-adapter/routes/route-builder';\nimport {\n  deltaCursorSchema,\n  deltaLimitSchema,\n  listModeSchema,\n  paginationArgsSchema,\n} from './observability-list-query-schemas';\n\nexport const OBSERVABILITY_DELTA_POLLING_FEATURE = 'observability-delta-polling';\nexport const OBSERVABILITY_DELTA_POLLING_UPGRADE_MESSAGE =\n  'Delta polling requires a newer @mastra/core with observability delta polling support. Please upgrade.';\nconst OBSERVABILITY_TRACE_QUERY_STORAGE_FEATURE = 'trace-query';\nconst OBSERVABILITY_TRACE_AGGREGATE_STORAGE_FEATURE = 'trace-aggregate';\nconst OBSERVABILITY_SPAN_QUERY_STORAGE_FEATURE = 'span-query';\nconst SPAN_QUERY_CONTEXT_FIELDS = new Set([\n  'traceId',\n  'spanId',\n  'parentSpanId',\n  'threadId',\n  'resourceId',\n  'requestId',\n  'serviceName',\n  'experimentId',\n  'environment',\n  'executionSource',\n  'parentEntityType',\n  'parentEntityId',\n  'parentEntityName',\n  'rootEntityType',\n  'rootEntityId',\n  'rootEntityName',\n]);\nconst OBSERVABILITY_TRACE_QUERY_ROOT_DURATION_STORAGE_FEATURE = 'trace-query-root-duration';\nconst OBSERVABILITY_TRACE_QUERY_CONTEXT_IDS_STORAGE_FEATURE = 'trace-query-context-ids';\nconst TRACE_QUERY_CONTEXT_ID_FIELDS = new Set(['runId', 'sessionId', 'userId', 'organizationId']);\nconst OBSERVABILITY_TRACE_QUERY_TIME_TO_FIRST_CHUNK_STORAGE_FEATURE = 'trace-query-time-to-first-chunk';\nconst TRACE_QUERY_TIME_TO_FIRST_CHUNK_FIELDS = new Set(['timeToFirstChunkMs']);\nconst OBSERVABILITY_TRACE_QUERY_ROOT_SPAN_FIELDS_STORAGE_FEATURE = 'trace-query-root-span-fields';\nconst OBSERVABILITY_TRACE_QUERY_ROOT_ENTITY_ID_STORAGE_FEATURE = 'trace-query-root-entity-id';\n// Trace-scope fields read from the root span, keyed by the storage feature that added their SQL.\nconst TRACE_QUERY_ROOT_SPAN_FIELD_FEATURES = new Map([\n  ['name', OBSERVABILITY_TRACE_QUERY_ROOT_SPAN_FIELDS_STORAGE_FEATURE],\n  ['spanType', OBSERVABILITY_TRACE_QUERY_ROOT_SPAN_FIELDS_STORAGE_FEATURE],\n  ['entityId', OBSERVABILITY_TRACE_QUERY_ROOT_ENTITY_ID_STORAGE_FEATURE],\n]);\nconst OBSERVABILITY_TRACE_QUERY_TIME_TO_FIRST_CHUNK_SORT_STORAGE_FEATURE = 'trace-query-time-to-first-chunk-sort';\nconst OBSERVABILITY_TRACE_QUERY_DISCOVERY_STORAGE_FEATURE = 'trace-query-discovery';\nconst OBSERVABILITY_THREAD_QUERY_STORAGE_FEATURE = 'thread-query';\nconst OBSERVABILITY_TRACE_QUERY_TENANT_SCOPE_STORAGE_FEATURE = 'trace-query-tenant-scope';\nconst OBSERVABILITY_FEEDBACK_STORAGE_FEATURE = 'feedback';\nexport const OBSERVABILITY_TRACE_QUERY_TENANT_SCOPE_CORE_FEATURE = 'observability-trace-query-tenant-scope';\nexport const OBSERVABILITY_TRACE_QUERY_TENANT_SCOPE_UPGRADE_MESSAGE =\n  'Trusted tenant scope requires a newer @mastra/core with trace-query tenant scope support. Please upgrade.';\n\nexport function supportsTraceQueryDiscoveryCore() {\n  return (\n    coreStorage.getTraceQueryFieldsArgsSchema !== undefined &&\n    coreStorage.getTraceQueryFieldsResponseSchema !== undefined &&\n    coreStorage.getTraceQueryValuesArgsSchema !== undefined &&\n    coreStorage.getTraceQueryValuesResponseSchema !== undefined &&\n    typeof coreStorage.planTraceQueryObservedFields === 'function' &&\n    typeof coreStorage.planTraceQueryValues === 'function' &&\n    typeof coreStorage.getTraceQueryCanonicalFieldDescriptors === 'function' &&\n    typeof coreStorage.TraceQueryResourceLimitError === 'function'\n  );\n}\n\nexport function supportsTraceAggregateCore() {\n  return (\n    coreStorage.traceAggregateRequestSchema !== undefined &&\n    coreStorage.traceAggregateResponseSchema !== undefined &&\n    typeof coreStorage.planTraceAggregate === 'function'\n  );\n}\n\nexport function supportsSpanQueryCore() {\n  return (\n    coreStorage.spanQueryRequestSchema !== undefined &&\n    coreStorage.spanQueryResponseSchema !== undefined &&\n    typeof coreStorage.planSpanQuery === 'function'\n  );\n}\n\nexport const OBSERVABILITY_LIST_ENDPOINTS = {\n  traces: 'traces',\n  branches: 'branches',\n  logs: 'logs',\n  metrics: 'metrics',\n  scores: 'scores',\n  feedback: 'feedback',\n} as const;\n\nexport type ObservabilityListEndpoint =\n  (typeof OBSERVABILITY_LIST_ENDPOINTS)[keyof typeof OBSERVABILITY_LIST_ENDPOINTS];\nconst OBSERVABILITY_DELTA_POLLING_STORAGE_FEATURE = 'delta-polling';\n\nfunction getFeatures(observabilityStore: ObservabilityStorage): readonly string[] | undefined {\n  const candidate = observabilityStore as ObservabilityStorage & {\n    getFeatures?: () => readonly string[] | undefined;\n  };\n  return candidate.getFeatures?.();\n}\n\n/** Retrieves MastraCompositeStore or throws 500 if unavailable. */\nexport function getStorage(mastra: Mastra): MastraCompositeStore {\n  const storage = mastra.getStorage();\n  if (!storage) {\n    throw new HTTPException(500, { message: 'Storage is not available' });\n  }\n  return storage;\n}\n\n/** Retrieves the observability storage domain or throws 501 if unavailable. */\nexport async function getObservabilityStore(mastra: Mastra): Promise<ObservabilityStorage> {\n  const storage = getStorage(mastra);\n  const observability = await storage.getStore('observability');\n  if (!observability) {\n    // 501, not 500: a missing or explicitly disabled observability domain\n    // (e.g. `domains: { observability: false }`) is a capability gap, not a\n    // server failure — matching the other 501s in this file.\n    throw new HTTPException(501, { message: 'Observability storage domain is not available' });\n  }\n  return observability;\n}\n\n/** Retrieves the scores storage domain or throws 501 if unavailable. */\nexport async function getScoresStore(mastra: Mastra): Promise<ScoresStorage> {\n  const storage = getStorage(mastra);\n  const scores = await storage.getStore('scores');\n  if (!scores) {\n    throw new HTTPException(501, { message: 'Scores storage domain is not available' });\n  }\n  return scores;\n}\n\nexport function assertObservabilityTraceQuerySupported(observabilityStore: ObservabilityStorage) {\n  if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_QUERY_STORAGE_FEATURE)) return;\n\n  throw new HTTPException(501, {\n    message: 'Advanced trace queries are not supported by the configured observability store',\n  });\n}\n\nexport function supportsObservabilityTraceAggregate(observabilityStore: ObservabilityStorage) {\n  return getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_AGGREGATE_STORAGE_FEATURE) === true;\n}\n\nexport function assertObservabilityTraceAggregateSupported(observabilityStore: ObservabilityStorage) {\n  if (supportsObservabilityTraceAggregate(observabilityStore)) return;\n\n  throw new HTTPException(501, {\n    message: 'Trace aggregation is not supported by the configured observability store',\n  });\n}\n\nexport function assertObservabilitySpanQuerySupported(observabilityStore: ObservabilityStorage) {\n  if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_SPAN_QUERY_STORAGE_FEATURE)) return;\n\n  throw new HTTPException(501, {\n    message: 'Span queries are not supported by the configured observability store',\n  });\n}\n\nexport function assertObservabilitySpanQueryFieldsSupported(\n  observabilityStore: ObservabilityStorage,\n  predicate: TrustedTraceQueryScalarPredicate | undefined,\n) {\n  if (!predicate || getFeatures(observabilityStore)?.includes('span-query-context-fields')) return;\n  if (predicate.type === 'boolean') {\n    for (const arg of predicate.args) assertObservabilitySpanQueryFieldsSupported(observabilityStore, arg);\n  } else if (predicate.type === 'not') {\n    assertObservabilitySpanQueryFieldsSupported(observabilityStore, predicate.arg);\n  } else if (SPAN_QUERY_CONTEXT_FIELDS.has(predicate.field)) {\n    throw new coreStorage.TraceQueryValidationError([\n      {\n        code: 'field_not_allowed',\n        path: ['where'],\n        message: `Filtering by ${predicate.field} requires an updated storage adapter with span query context-field support.`,\n      },\n    ]);\n  }\n}\n\nfunction usesRootDuration(predicate: TrustedTraceQueryPredicate | TrustedThreadPredicate | undefined): boolean {\n  if (!predicate) return false;\n  if (predicate.type === 'boolean') return predicate.args.some(usesRootDuration);\n  if (predicate.type === 'not') return usesRootDuration(predicate.arg);\n  if (predicate.type === 'relation') {\n    return predicate.collection === 'traces' && usesRootDuration(predicate.predicate);\n  }\n  return predicate.field === 'durationMs';\n}\n\nexport function supportsObservabilityTraceQueryRootDuration(observabilityStore: ObservabilityStorage) {\n  return getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_QUERY_ROOT_DURATION_STORAGE_FEATURE) === true;\n}\n\nexport function assertObservabilityTraceQueryRootDurationSupported(\n  observabilityStore: ObservabilityStorage,\n  predicate: TrustedTraceQueryPredicate | TrustedThreadPredicate | undefined,\n) {\n  if (!usesRootDuration(predicate) || supportsObservabilityTraceQueryRootDuration(observabilityStore)) return;\n\n  throw new HTTPException(501, {\n    message: 'Root duration predicates are not supported by the configured observability store',\n  });\n}\n\n/** Whether any scalar predicate, at any depth and inside any relation, names one of `fields`. */\nfunction usesField(\n  predicate: TrustedTraceQueryPredicate | TrustedThreadPredicate | undefined,\n  fields: ReadonlySet<string>,\n): boolean {\n  if (!predicate) return false;\n  if (predicate.type === 'boolean') return predicate.args.some(arg => usesField(arg, fields));\n  if (predicate.type === 'not') return usesField(predicate.arg, fields);\n  if (predicate.type === 'relation') return usesField(predicate.predicate, fields);\n  return fields.has(predicate.field);\n}\n\nexport function supportsObservabilityTraceQueryContextIds(observabilityStore: ObservabilityStorage) {\n  return getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_QUERY_CONTEXT_IDS_STORAGE_FEATURE) === true;\n}\n\nexport function isTraceQueryContextIdField(path: string): boolean {\n  return TRACE_QUERY_CONTEXT_ID_FIELDS.has(path);\n}\n\nexport function assertObservabilityTraceQueryContextIdsSupported(\n  observabilityStore: ObservabilityStorage,\n  predicate: TrustedTraceQueryPredicate | TrustedThreadPredicate | undefined,\n) {\n  if (\n    !usesField(predicate, TRACE_QUERY_CONTEXT_ID_FIELDS) ||\n    supportsObservabilityTraceQueryContextIds(observabilityStore)\n  ) {\n    return;\n  }\n\n  throw new HTTPException(501, {\n    message: 'Context identifier predicates are not supported by the configured observability store',\n  });\n}\n\nexport function supportsObservabilityTraceQueryTimeToFirstChunk(observabilityStore: ObservabilityStorage) {\n  return (\n    getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_QUERY_TIME_TO_FIRST_CHUNK_STORAGE_FEATURE) === true\n  );\n}\n\n/** Covers trace, thread and span query predicates, including `spans` and `traces` relations. */\nexport function assertObservabilityTraceQueryTimeToFirstChunkSupported(\n  observabilityStore: ObservabilityStorage,\n  predicate: TrustedTraceQueryPredicate | TrustedThreadPredicate | undefined,\n) {\n  if (\n    !usesField(predicate, TRACE_QUERY_TIME_TO_FIRST_CHUNK_FIELDS) ||\n    supportsObservabilityTraceQueryTimeToFirstChunk(observabilityStore)\n  ) {\n    return;\n  }\n\n  throw new HTTPException(501, {\n    message: 'Time to first chunk predicates are not supported by the configured observability store',\n  });\n}\n\nfunction rootSpanFieldIssues(\n  observabilityStore: ObservabilityStorage,\n  predicate: TrustedTraceQueryPredicate | TrustedThreadPredicate | undefined,\n): TraceQueryIssue[] {\n  if (!predicate) return [];\n  if (predicate.type === 'boolean') return predicate.args.flatMap(arg => rootSpanFieldIssues(observabilityStore, arg));\n  if (predicate.type === 'not') return rootSpanFieldIssues(observabilityStore, predicate.arg);\n  // Only trace-scope root span fields read the root; inside `spans.some` they are long-supported span fields.\n  if (predicate.type === 'relation') {\n    return predicate.collection === 'traces' ? rootSpanFieldIssues(observabilityStore, predicate.predicate) : [];\n  }\n  return supportsObservabilityTraceQueryRootSpanField(observabilityStore, predicate.field)\n    ? []\n    : [rootSpanFieldIssue(['where'], predicate.field)];\n}\n\nfunction rootSpanFieldIssue(path: Array<string | number>, field: string): TraceQueryIssue {\n  return {\n    code: 'field_not_allowed',\n    path,\n    message: `Root span ${field} requires an updated storage adapter with trace-query root span field support.`,\n  };\n}\n\n/**\n * Whether the store can serve `path` at trace scope. Fields that don't read the root span are\n * always supported here; other gates cover them.\n */\nexport function supportsObservabilityTraceQueryRootSpanField(observabilityStore: ObservabilityStorage, path: string) {\n  const feature = TRACE_QUERY_ROOT_SPAN_FIELD_FEATURES.get(path);\n  return feature === undefined || getFeatures(observabilityStore)?.includes(feature) === true;\n}\n\n/**\n * Stores that predate a trace-scope root span field have no SQL for it and would fail with a\n * 500, so requests that use it are rejected as invalid instead.\n */\nexport function assertObservabilityTraceQueryRootSpanFieldsSupported(\n  observabilityStore: ObservabilityStorage,\n  plan: {\n    where?: TrustedTraceQueryPredicate | TrustedThreadPredicate;\n    dimensions?: readonly string[];\n    measures?: ReadonlyArray<{ type: string; field?: string }>;\n  },\n) {\n  const supported = (field: string) => supportsObservabilityTraceQueryRootSpanField(observabilityStore, field);\n  const issues = [\n    ...rootSpanFieldIssues(observabilityStore, plan.where),\n    ...(plan.dimensions ?? []).flatMap((dimension, index) =>\n      supported(dimension) ? [] : [rootSpanFieldIssue(['groupBy', index], dimension)],\n    ),\n    ...(plan.measures ?? []).flatMap((measure, index) =>\n      measure.type === 'countDistinct' && measure.field !== undefined && !supported(measure.field)\n        ? [rootSpanFieldIssue(['measures', index], measure.field)]\n        : [],\n    ),\n  ];\n  if (issues.length > 0) throw new coreStorage.TraceQueryValidationError(issues);\n}\n\nexport function assertObservabilityTraceQueryRootSpanValuesSupported(\n  observabilityStore: ObservabilityStorage,\n  plan: { predicateScope: string; path: string },\n) {\n  if (plan.predicateScope !== 'trace') return;\n  if (supportsObservabilityTraceQueryRootSpanField(observabilityStore, plan.path)) return;\n  throw new coreStorage.TraceQueryValidationError([rootSpanFieldIssue(['path'], plan.path)]);\n}\n\nexport function supportsObservabilityTraceQueryTimeToFirstChunkSort(observabilityStore: ObservabilityStorage) {\n  return (\n    getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_QUERY_TIME_TO_FIRST_CHUNK_SORT_STORAGE_FEATURE) ===\n    true\n  );\n}\n\n/** Covers the sort of trace and span queries. */\nexport function assertObservabilityTraceQueryTimeToFirstChunkSortSupported(\n  observabilityStore: ObservabilityStorage,\n  orderBy: { field: string },\n) {\n  if (\n    !TRACE_QUERY_TIME_TO_FIRST_CHUNK_FIELDS.has(orderBy.field) ||\n    supportsObservabilityTraceQueryTimeToFirstChunkSort(observabilityStore)\n  ) {\n    return;\n  }\n\n  throw new HTTPException(501, {\n    message: 'Sorting by time to first chunk is not supported by the configured observability store',\n  });\n}\n\nexport function assertObservabilityTraceQueryDiscoverySupported(observabilityStore: ObservabilityStorage) {\n  if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_QUERY_DISCOVERY_STORAGE_FEATURE)) return;\n\n  throw new HTTPException(501, {\n    message: 'Trace query discovery is not supported by the configured observability store',\n  });\n}\n\n/**\n * A scoped request must never run unscoped: a store that predates tenant scope would\n * silently ignore `plan.scope` and return every tenant's rows, so it is rejected instead.\n * Unscoped requests are unaffected.\n */\nexport function assertObservabilityTraceQueryTenantScopeSupported(\n  observabilityStore: ObservabilityStorage,\n  scope: coreStorage.TraceQueryTenantScope | undefined,\n) {\n  if (scope === undefined) return;\n  if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_QUERY_TENANT_SCOPE_STORAGE_FEATURE)) return;\n\n  throw new HTTPException(501, {\n    message: 'The configured observability store cannot enforce the trusted tenant scope',\n  });\n}\n\nexport function assertObservabilityThreadQuerySupported(observabilityStore: ObservabilityStorage) {\n  if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_THREAD_QUERY_STORAGE_FEATURE)) return;\n\n  throw new HTTPException(501, {\n    message: 'Advanced thread queries are not supported by the configured observability store',\n  });\n}\n\n/**\n * Returns true when the store's class chain overrides `method` below the class\n * that first declares it (the `ObservabilityStorage` base, whose default\n * throws `*_NOT_IMPLEMENTED`). Walks the store's own prototype chain instead of\n * comparing against this package's `ObservabilityStorage.prototype`, so it\n * works for stores built against older or duplicated `@mastra/core` installs\n * and for stores that predate {@link ObservabilityStorage.getFeatures}.\n */\nfunction implementsObservabilityStorageMethod(observabilityStore: object, method: string): boolean {\n  if (Object.prototype.hasOwnProperty.call(observabilityStore, method)) return true;\n\n  let resolvedOwner: object | undefined;\n  let declaringBase: object | undefined;\n  for (\n    let proto: object | null = Object.getPrototypeOf(observabilityStore);\n    proto && proto !== Object.prototype;\n    proto = Object.getPrototypeOf(proto)\n  ) {\n    if (Object.prototype.hasOwnProperty.call(proto, method)) {\n      resolvedOwner ??= proto;\n      declaringBase = proto;\n    }\n  }\n  return resolvedOwner !== undefined && resolvedOwner !== declaringBase;\n}\n\nexport type ObservabilityDiscoveryCapabilities = {\n  entityTypes: boolean;\n  entityNames: boolean;\n  serviceNames: boolean;\n  environments: boolean;\n  tags: boolean;\n  metrics: boolean;\n};\n\nexport type ObservabilityStorageCapabilities = {\n  metrics: boolean;\n  logs: boolean;\n  discovery: ObservabilityDiscoveryCapabilities;\n  deltaPolling: boolean;\n  traceQuery: boolean;\n  traceQueryRootDuration: boolean;\n  traceQueryContextIds: boolean;\n  traceQueryTimeToFirstChunk: boolean;\n  traceQueryRootSpanFields: boolean;\n  traceQueryRootEntityId: boolean;\n  traceQueryTimeToFirstChunkSort: boolean;\n  traceQueryDiscovery: boolean;\n  traceQueryTenantScope: boolean;\n  traceAggregate: boolean;\n  threadQuery: boolean;\n  threadQueryRows: boolean;\n  spanQuery: boolean;\n  spanQueryContextFields: boolean;\n  /** Days of traces the store keeps. Omitted when the store does not report a limit. */\n  traceRetentionDays?: number;\n  feedback: boolean;\n};\n\nexport const NO_OBSERVABILITY_STORAGE_CAPABILITIES: ObservabilityStorageCapabilities = {\n  metrics: false,\n  logs: false,\n  discovery: {\n    entityTypes: false,\n    entityNames: false,\n    serviceNames: false,\n    environments: false,\n    tags: false,\n    metrics: false,\n  },\n  deltaPolling: false,\n  traceQuery: false,\n  traceQueryRootDuration: false,\n  traceQueryContextIds: false,\n  traceQueryTimeToFirstChunk: false,\n  traceQueryRootSpanFields: false,\n  traceQueryRootEntityId: false,\n  traceQueryTimeToFirstChunkSort: false,\n  traceQueryDiscovery: false,\n  traceQueryTenantScope: false,\n  traceAggregate: false,\n  threadQuery: false,\n  threadQueryRows: false,\n  spanQuery: false,\n  spanQueryContextFields: false,\n  feedback: false,\n};\n\n/**\n * Resolves which optional observability APIs the configured store can serve.\n *\n * Feature declarations (`getFeatures()`) are optional. When a store declares\n * a feature list, that list is final. Stores without `getFeatures()` predate\n * declarations: metrics, logs and filter discovery are detected by whether the\n * store implements the underlying method, so those packages report accurately\n * without being upgraded. Delta polling and the trace/thread query APIs depend\n * on runtime behavior a method check can't see, so they are only reported for\n * stores that declare them. Feedback is also declaration-only: Studio hides\n * the feedback UI behind this flag, and store versions that implement feedback\n * without declaring it simply don't advertise it until upgraded.\n */\nexport function getObservabilityStorageCapabilities(\n  observabilityStore: ObservabilityStorage,\n): ObservabilityStorageCapabilities {\n  const declaredFeatures = getFeatures(observabilityStore);\n  const features = declaredFeatures ?? [];\n  const newApiCore = coreFeatures.has('observability:v1.13.2');\n  const declares = (feature: string) => features.includes(feature);\n  // Undeclared stores must implement every method behind the feature.\n  const supports = (feature: string, methods: readonly string[]) => {\n    if (!newApiCore) return false;\n    if (!declaredFeatures) {\n      return methods.every(method => implementsObservabilityStorageMethod(observabilityStore, method));\n    }\n    return declares(feature);\n  };\n  // Stores released before the per-endpoint discovery features existed declare\n  // `trace-query` and implement every discovery method, so treat it as implying discovery.\n  const supportsDiscovery = (feature: string, methods: readonly string[]) =>\n    supports(feature, methods) || (newApiCore && declares(OBSERVABILITY_TRACE_QUERY_STORAGE_FEATURE));\n  const traceQuery =\n    newApiCore &&\n    typeof coreStorage.planTraceQuery === 'function' &&\n    declares(OBSERVABILITY_TRACE_QUERY_STORAGE_FEATURE);\n  const threadQuery =\n    newApiCore &&\n    typeof coreStorage.planThreadQuery === 'function' &&\n    declares(OBSERVABILITY_THREAD_QUERY_STORAGE_FEATURE);\n  const spanQuery = newApiCore && supportsSpanQueryCore() && declares(OBSERVABILITY_SPAN_QUERY_STORAGE_FEATURE);\n\n  return {\n    // `listMetrics` is left out: it backs a newer route that metric dashboards don't use,\n    // and older stores that implement the OLAP methods predate it.\n    metrics: supports('metrics', [\n      'getMetricAggregate',\n      'getMetricBreakdown',\n      'getMetricTimeSeries',\n      'getMetricPercentiles',\n    ]),\n    logs: supports('logs', ['listLogs']),\n    discovery: {\n      entityTypes: supportsDiscovery('entity-type-discovery', ['getEntityTypes']),\n      entityNames: supportsDiscovery('entity-name-discovery', ['getEntityNames']),\n      serviceNames: supportsDiscovery('service-name-discovery', ['getServiceNames']),\n      environments: supportsDiscovery('environment-discovery', ['getEnvironments']),\n      tags: supportsDiscovery('tag-discovery', ['getTags']),\n      metrics: supportsDiscovery('metric-discovery', ['getMetricNames', 'getMetricLabelKeys', 'getMetricLabelValues']),\n    },\n    deltaPolling:\n      coreFeatures.has(OBSERVABILITY_DELTA_POLLING_FEATURE) && declares(OBSERVABILITY_DELTA_POLLING_STORAGE_FEATURE),\n    traceQuery,\n    traceQueryRootDuration:\n      (traceQuery || threadQuery) && declares(OBSERVABILITY_TRACE_QUERY_ROOT_DURATION_STORAGE_FEATURE),\n    traceQueryContextIds:\n      (traceQuery || threadQuery) && declares(OBSERVABILITY_TRACE_QUERY_CONTEXT_IDS_STORAGE_FEATURE),\n    traceQueryTimeToFirstChunk:\n      (traceQuery || threadQuery || spanQuery) &&\n      declares(OBSERVABILITY_TRACE_QUERY_TIME_TO_FIRST_CHUNK_STORAGE_FEATURE),\n    traceQueryRootSpanFields:\n      (traceQuery || threadQuery) && declares(OBSERVABILITY_TRACE_QUERY_ROOT_SPAN_FIELDS_STORAGE_FEATURE),\n    traceQueryRootEntityId:\n      (traceQuery || threadQuery) && declares(OBSERVABILITY_TRACE_QUERY_ROOT_ENTITY_ID_STORAGE_FEATURE),\n    traceQueryTimeToFirstChunkSort:\n      (traceQuery || spanQuery) && declares(OBSERVABILITY_TRACE_QUERY_TIME_TO_FIRST_CHUNK_SORT_STORAGE_FEATURE),\n    traceQueryDiscovery:\n      newApiCore && supportsTraceQueryDiscoveryCore() && declares(OBSERVABILITY_TRACE_QUERY_DISCOVERY_STORAGE_FEATURE),\n    traceQueryTenantScope:\n      (traceQuery || threadQuery) &&\n      coreFeatures.has(OBSERVABILITY_TRACE_QUERY_TENANT_SCOPE_CORE_FEATURE) &&\n      declares(OBSERVABILITY_TRACE_QUERY_TENANT_SCOPE_STORAGE_FEATURE),\n    traceAggregate:\n      newApiCore && supportsTraceAggregateCore() && declares(OBSERVABILITY_TRACE_AGGREGATE_STORAGE_FEATURE),\n    threadQuery,\n    threadQueryRows:\n      threadQuery && typeof coreStorage.planThreadRowsQuery === 'function' && declares('thread-query-rows'),\n    spanQuery,\n    spanQueryContextFields: spanQuery && declares('span-query-context-fields'),\n    feedback: newApiCore && declares(OBSERVABILITY_FEEDBACK_STORAGE_FEATURE),\n  };\n}\n\n/**\n * Matches the `OBSERVABILITY_STORAGE_*_NOT_IMPLEMENTED` MastraError the base\n * observability store throws for every optional method a store doesn't\n * implement. Checked by id (not `instanceof`) so it holds across duplicated\n * `@mastra/core` installs.\n */\nfunction isObservabilityStorageNotImplementedError(error: unknown): boolean {\n  const id = error && typeof error === 'object' && 'id' in error ? error.id : undefined;\n  return typeof id === 'string' && id.startsWith('OBSERVABILITY_STORAGE_') && id.endsWith('_NOT_IMPLEMENTED');\n}\n\n/**\n * Discovery is optional for observability stores. When the configured store\n * doesn't implement a discovery method, answer with an empty result instead of\n * a 500 so filter lookups degrade quietly on stores without discovery support.\n * Clients should check `observabilityStorageCapabilities.discovery` from\n * `GET /system/packages` before calling these routes.\n */\nexport async function withDiscoveryFallback<T>(run: () => Promise<T>, empty: T): Promise<T> {\n  try {\n    return await run();\n  } catch (error) {\n    if (isObservabilityStorageNotImplementedError(error)) return empty;\n    throw error;\n  }\n}\n\nexport function assertObservabilityDeltaSupported(\n  observabilityStore: ObservabilityStorage,\n  endpoint: ObservabilityListEndpoint,\n) {\n  if (!coreFeatures.has(OBSERVABILITY_DELTA_POLLING_FEATURE)) {\n    throw new HTTPException(501, {\n      message: `${OBSERVABILITY_DELTA_POLLING_UPGRADE_MESSAGE} (endpoint: ${endpoint})`,\n    });\n  }\n\n  if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_DELTA_POLLING_STORAGE_FEATURE)) {\n    return;\n  }\n\n  throw new HTTPException(501, {\n    message: `Delta polling is not supported by the configured observability store for ${endpoint}`,\n  });\n}\n\nexport interface RouteDetails {\n  method: ServerRoute['method'];\n  path: `/${string}`;\n  summary: string;\n  description: string;\n  requiresPermission?: ServerRoute['requiresPermission'];\n}\n\nexport const NEW_ROUTE_DEFS = {\n  QUERY_TRACES: {\n    method: 'POST',\n    path: '/observability/traces/query',\n    summary: 'Query traces',\n    description:\n      'Returns completed logical traces or distinct thread groups matching an advanced trace query. Thread grouping remains supported but is deprecated; use queryTraceThreads instead.',\n    requiresPermission: 'observability:read',\n  },\n\n  AGGREGATE_TRACES: {\n    method: 'POST',\n    path: '/observability/traces/aggregate',\n    summary: 'Aggregate traces',\n    description:\n      'Returns grouped and optionally time-bucketed measures (counts, durations, error rates) over completed logical traces matching an advanced trace predicate',\n    requiresPermission: 'observability:read',\n  },\n\n  QUERY_THREADS: {\n    method: 'POST',\n    path: '/observability/threads/query',\n    summary: 'Query threads',\n    description:\n      'Returns full-history thread rows with activity timestamps, first/last traces, previews and context fields',\n    requiresPermission: 'observability:read',\n  },\n\n  QUERY_SPANS: {\n    method: 'POST',\n    path: '/observability/spans/query',\n    summary: 'Query spans',\n    description: 'Returns completed spans matching a span predicate, one row per span, with cursor pagination',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_TRACE_QUERY_FIELDS: {\n    method: 'POST',\n    path: '/observability/traces/query/fields',\n    summary: 'Discover trace query fields',\n    description: 'Returns canonical query fields and observed top-level string metadata fields',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_TRACE_QUERY_VALUES: {\n    method: 'POST',\n    path: '/observability/traces/query/values',\n    summary: 'Discover trace query values',\n    description: 'Returns bounded string value suggestions and occurrence counts for one eligible query field',\n    requiresPermission: 'observability:read',\n  },\n\n  LIST_METRICS: {\n    method: 'GET',\n    path: '/observability/metrics',\n    summary: 'List metrics',\n    description: 'Returns a paginated list of metrics with optional filtering and sorting',\n  },\n\n  LIST_LOGS: {\n    method: 'GET',\n    path: '/observability/logs',\n    summary: 'List logs',\n    description: 'Returns a paginated list of logs with optional filtering and sorting',\n  },\n\n  LIST_SCORES: {\n    method: 'GET',\n    path: '/observability/scores',\n    summary: 'List scores',\n    description: 'Returns a paginated list of scores with optional filtering and sorting',\n  },\n\n  CREATE_SCORE: {\n    method: 'POST',\n    path: '/observability/scores',\n    summary: 'Create a score',\n    description: 'Creates a single score record in the observability store',\n  },\n\n  DELETE_SCORES: {\n    method: 'DELETE',\n    path: '/observability/scores',\n    summary: 'Delete scores',\n    description: 'Deletes score records by scoreId, optionally scoped to a tenant',\n    requiresPermission: 'observability:delete',\n  },\n\n  GET_SCORE: {\n    method: 'GET',\n    path: '/observability/scores/:scoreId',\n    summary: 'Get score',\n    description: 'Returns a single score by scoreId',\n  },\n\n  GET_SCORE_AGGREGATE: {\n    method: 'POST',\n    path: '/observability/scores/aggregate',\n    summary: 'Get score aggregate',\n    description: 'Returns an aggregated score value with optional period-over-period comparison',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_SCORE_BREAKDOWN: {\n    method: 'POST',\n    path: '/observability/scores/breakdown',\n    summary: 'Get score breakdown',\n    description: 'Returns score values grouped by specified dimensions',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_SCORE_TIME_SERIES: {\n    method: 'POST',\n    path: '/observability/scores/timeseries',\n    summary: 'Get score time series',\n    description: 'Returns score values bucketed by time interval with optional grouping',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_SCORE_PERCENTILES: {\n    method: 'POST',\n    path: '/observability/scores/percentiles',\n    summary: 'Get score percentiles',\n    description: 'Returns percentile values for a score bucketed by time interval',\n    requiresPermission: 'observability:read',\n  },\n\n  LIST_FEEDBACK: {\n    method: 'GET',\n    path: '/observability/feedback',\n    summary: 'List feedback',\n    description: 'Returns a paginated list of feedback with optional filtering and sorting',\n  },\n\n  CREATE_FEEDBACK: {\n    method: 'POST',\n    path: '/observability/feedback',\n    summary: 'Create feedback',\n    description: 'Creates a single feedback record in the observability store',\n  },\n\n  DELETE_FEEDBACK: {\n    method: 'DELETE',\n    path: '/observability/feedback',\n    summary: 'Delete feedback',\n    description: 'Deletes feedback records by feedbackId, optionally scoped to a tenant',\n    requiresPermission: 'observability:delete',\n  },\n\n  UPDATE_FEEDBACK_REVIEW_STATUS: {\n    method: 'PATCH',\n    path: '/observability/feedback/:feedbackId/review-status',\n    summary: 'Update feedback review status',\n    description: \"Updates a feedback record's review workflow status\",\n    requiresPermission: 'observability:write',\n  },\n\n  GET_FEEDBACK_AGGREGATE: {\n    method: 'POST',\n    path: '/observability/feedback/aggregate',\n    summary: 'Get feedback aggregate',\n    description: 'Returns an aggregated numeric feedback value with optional period-over-period comparison',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_FEEDBACK_BREAKDOWN: {\n    method: 'POST',\n    path: '/observability/feedback/breakdown',\n    summary: 'Get feedback breakdown',\n    description: 'Returns numeric feedback values grouped by specified dimensions',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_FEEDBACK_TIME_SERIES: {\n    method: 'POST',\n    path: '/observability/feedback/timeseries',\n    summary: 'Get feedback time series',\n    description: 'Returns numeric feedback values bucketed by time interval with optional grouping',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_FEEDBACK_PERCENTILES: {\n    method: 'POST',\n    path: '/observability/feedback/percentiles',\n    summary: 'Get feedback percentiles',\n    description: 'Returns percentile values for numeric feedback bucketed by time interval',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_METRIC_AGGREGATE: {\n    method: 'POST',\n    path: '/observability/metrics/aggregate',\n    summary: 'Get metric aggregate',\n    description: 'Returns an aggregated metric value with optional period-over-period comparison',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_METRIC_BREAKDOWN: {\n    method: 'POST',\n    path: '/observability/metrics/breakdown',\n    summary: 'Get metric breakdown',\n    description: 'Returns metric values grouped by specified dimensions',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_METRIC_TIME_SERIES: {\n    method: 'POST',\n    path: '/observability/metrics/timeseries',\n    summary: 'Get metric time series',\n    description: 'Returns metric values bucketed by time interval with optional grouping',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_METRIC_PERCENTILES: {\n    method: 'POST',\n    path: '/observability/metrics/percentiles',\n    summary: 'Get metric percentiles',\n    description: 'Returns percentile values for a metric bucketed by time interval',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_METRIC_NAMES: {\n    method: 'GET',\n    path: '/observability/discovery/metric-names',\n    summary: 'Get metric names',\n    description: 'Returns distinct metric names with optional prefix filtering',\n  },\n\n  GET_METRIC_LABEL_KEYS: {\n    method: 'GET',\n    path: '/observability/discovery/metric-label-keys',\n    summary: 'Get metric label keys',\n    description: 'Returns distinct label keys for a given metric',\n  },\n\n  GET_METRIC_LABEL_VALUES: {\n    method: 'GET',\n    path: '/observability/discovery/metric-label-values',\n    summary: 'Get label values',\n    description: 'Returns distinct values for a given metric label key',\n  },\n\n  GET_ENTITY_TYPES: {\n    method: 'GET',\n    path: '/observability/discovery/entity-types',\n    summary: 'Get entity types',\n    description: 'Returns distinct entity types from observability data',\n  },\n\n  GET_ENTITY_NAMES: {\n    method: 'GET',\n    path: '/observability/discovery/entity-names',\n    summary: 'Get entity names',\n    description: 'Returns distinct entity names with optional type filtering',\n  },\n\n  GET_SERVICE_NAMES: {\n    method: 'GET',\n    path: '/observability/discovery/service-names',\n    summary: 'Get service names',\n    description: 'Returns distinct service names from observability data',\n  },\n\n  GET_ENVIRONMENTS: {\n    method: 'GET',\n    path: '/observability/discovery/environments',\n    summary: 'Get environments',\n    description: 'Returns distinct environments from observability data',\n  },\n\n  GET_TAGS: {\n    method: 'GET',\n    path: '/observability/discovery/tags',\n    summary: 'Get tags',\n    description: 'Returns distinct tags with optional entity type filtering',\n  },\n\n  GET_CAPABILITIES: {\n    method: 'GET',\n    path: '/observability/capabilities',\n    summary: 'Get observability capabilities',\n    description:\n      'Returns which optional observability APIs the configured observability storage supports. Every flag is false when no observability storage is configured.',\n  },\n} as const satisfies Record<string, RouteDetails>;\n\nexport type NewRoutesKey = keyof typeof NEW_ROUTE_DEFS;\nexport type NewRoutesDefinitions = (typeof NEW_ROUTE_DEFS)[NewRoutesKey];\n\nexport function createObservabilityListQuerySchema<\n  TFilter extends z.ZodObject<z.ZodRawShape>,\n  TOrderBy extends z.ZodObject<z.ZodRawShape>,\n>(filterSchema: TFilter, orderBySchema: TOrderBy) {\n  const unwrapDefault = (schema: unknown) => {\n    const zodSchema = schema as z.ZodTypeAny;\n    return zodSchema instanceof z.ZodDefault ? zodSchema.unwrap() : zodSchema;\n  };\n  const paginationShape = paginationArgsSchema.shape as unknown as Record<string, z.ZodTypeAny>;\n  const orderByShape = orderBySchema.shape as unknown as Record<string, z.ZodTypeAny>;\n\n  const pageSchema = unwrapDefault(paginationShape.page);\n  const perPageSchema = unwrapDefault(paginationShape.perPage);\n  const fieldSchema = orderByShape.field ? unwrapDefault(orderByShape.field) : z.never().optional();\n  const directionSchema = orderByShape.direction ? unwrapDefault(orderByShape.direction) : z.never().optional();\n\n  return wrapSchemaForQueryParams(\n    z\n      .object({\n        ...filterSchema.shape,\n        page: pageSchema,\n        perPage: perPageSchema,\n        field: fieldSchema,\n        direction: directionSchema,\n        mode: listModeSchema.optional(),\n        after: deltaCursorSchema.optional(),\n        limit: deltaLimitSchema,\n      })\n      .partial(),\n  ).superRefine((value, ctx) => {\n    const isDelta = value.mode === 'delta';\n    const hasPagination = value.page !== undefined || value.perPage !== undefined;\n    const hasOrderBy = value.field !== undefined || value.direction !== undefined;\n    const hasAfter = value.after !== undefined;\n    const hasLimit = value.limit !== undefined;\n\n    if (isDelta) {\n      if (hasPagination) {\n        if (value.page !== undefined) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: ['page'],\n            message: '`page` is not allowed when `mode=delta`',\n          });\n        }\n        if (value.perPage !== undefined) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: ['perPage'],\n            message: '`perPage` is not allowed when `mode=delta`',\n          });\n        }\n      }\n      if (hasOrderBy) {\n        if (value.field !== undefined) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: ['field'],\n            message: '`field` is not allowed when `mode=delta`',\n          });\n        }\n        if (value.direction !== undefined) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: ['direction'],\n            message: '`direction` is not allowed when `mode=delta`',\n          });\n        }\n      }\n      return;\n    }\n\n    if (hasAfter) {\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        path: ['after'],\n        message: '`after` is only allowed when `mode=delta`',\n      });\n    }\n    if (hasLimit) {\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        path: ['limit'],\n        message: '`limit` is only allowed when `mode=delta`',\n      });\n    }\n  });\n}\n"],"mappings":"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"}

package/dist/server/handlers/observability.cjs

@@ -6,7 +6,7 @@ const require_server_handlers_error = require("./error.cjs");
 const require_server_handlers_observability_list_query_schemas = require("./observability-list-query-schemas.cjs");
 const require_server_handlers_observability_shared = require("./observability-shared.cjs");
 const require_server_handlers_observability_storage_schemas = require("./observability-storage-schemas.cjs");
-const require_observability_new_endpoints = require("../../observability-new-endpoints-outfOdc8.cjs");
+const require_observability_new_endpoints = require("../../observability-new-endpoints-AMp9bnMV.cjs");
 let zod_v4 = require("zod/v4");
 let _mastra_core_evals = require("@mastra/core/evals");
 let _mastra_core_evals_scoreTraces = require("@mastra/core/evals/scoreTraces");

package/dist/server/handlers/observability.js

@@ -5,7 +5,7 @@ import { handleError } from "./error.js";
 import { paginationArgsSchema } from "./observability-list-query-schemas.js";
 import { OBSERVABILITY_LIST_ENDPOINTS, assertObservabilityDeltaSupported, createObservabilityListQuerySchema, getObservabilityStore, getScoresStore, getStorage } from "./observability-shared.js";
 import { batchDeleteTracesArgsSchema, batchDeleteTracesResponseSchema, branchesFilterSchema, branchesOrderBySchema, getBranchArgsSchema, getBranchResponseSchema, listBranchesResponseSchema, listTracesLightResponseSchema } from "./observability-storage-schemas.js";
-import { A as LIST_FEEDBACK, C as GET_SCORE_BREAKDOWN, D as GET_TAGS, E as GET_SERVICE_NAMES, F as QUERY_SPANS, I as QUERY_THREADS, L as QUERY_TRACES, M as LIST_METRICS, N as LIST_SCORES, O as GET_TRACE_QUERY_FIELDS, P as NEW_ROUTES, R as UPDATE_FEEDBACK_REVIEW_STATUS, S as GET_SCORE_AGGREGATE, T as GET_SCORE_TIME_SERIES, _ as GET_METRIC_LABEL_VALUES, a as DELETE_SCORES, b as GET_METRIC_TIME_SERIES, c as GET_ENTITY_TYPES, d as GET_FEEDBACK_BREAKDOWN, f as GET_FEEDBACK_PERCENTILES, g as GET_METRIC_LABEL_KEYS, h as GET_METRIC_BREAKDOWN, i as DELETE_FEEDBACK, j as LIST_LOGS, k as GET_TRACE_QUERY_VALUES, l as GET_ENVIRONMENTS, m as GET_METRIC_AGGREGATE, n as CREATE_FEEDBACK, o as GET_CAPABILITIES, p as GET_FEEDBACK_TIME_SERIES, r as CREATE_SCORE, s as GET_ENTITY_NAMES, t as AGGREGATE_TRACES, u as GET_FEEDBACK_AGGREGATE, v as GET_METRIC_NAMES, w as GET_SCORE_PERCENTILES, x as GET_SCORE, y as GET_METRIC_PERCENTILES } from "../../observability-new-endpoints-7wGwP3se.js";
+import { A as LIST_FEEDBACK, C as GET_SCORE_BREAKDOWN, D as GET_TAGS, E as GET_SERVICE_NAMES, F as QUERY_SPANS, I as QUERY_THREADS, L as QUERY_TRACES, M as LIST_METRICS, N as LIST_SCORES, O as GET_TRACE_QUERY_FIELDS, P as NEW_ROUTES, R as UPDATE_FEEDBACK_REVIEW_STATUS, S as GET_SCORE_AGGREGATE, T as GET_SCORE_TIME_SERIES, _ as GET_METRIC_LABEL_VALUES, a as DELETE_SCORES, b as GET_METRIC_TIME_SERIES, c as GET_ENTITY_TYPES, d as GET_FEEDBACK_BREAKDOWN, f as GET_FEEDBACK_PERCENTILES, g as GET_METRIC_LABEL_KEYS, h as GET_METRIC_BREAKDOWN, i as DELETE_FEEDBACK, j as LIST_LOGS, k as GET_TRACE_QUERY_VALUES, l as GET_ENVIRONMENTS, m as GET_METRIC_AGGREGATE, n as CREATE_FEEDBACK, o as GET_CAPABILITIES, p as GET_FEEDBACK_TIME_SERIES, r as CREATE_SCORE, s as GET_ENTITY_NAMES, t as AGGREGATE_TRACES, u as GET_FEEDBACK_AGGREGATE, v as GET_METRIC_NAMES, w as GET_SCORE_PERCENTILES, x as GET_SCORE, y as GET_METRIC_PERCENTILES } from "../../observability-new-endpoints-BU8JYPfh.js";
 import { z } from "zod/v4";
 import { extractTrajectoryFromTrace, listScoresResponseSchema } from "@mastra/core/evals";
 import { scoreTraces } from "@mastra/core/evals/scoreTraces";

package/dist/server/handlers/system.cjs

@@ -3,7 +3,7 @@ require("../../rolldown-runtime-Bd6kNlEP.cjs");
 const require_route_builder = require("../../route-builder-BNZs643f.cjs");
 const require_server_handlers_error = require("./error.cjs");
 const require_server_handlers_observability_shared = require("./observability-shared.cjs");
-const require_system = require("../../system-DvpPWdIa.cjs");
+const require_system = require("../../system-BvpFMIJB.cjs");
 let fs = require("fs");
 //#region src/server/handlers/system.ts
 const SOURCE_PROVIDER_CAPABILITIES_TIMEOUT_MS = 3e3;
@@ -90,7 +90,7 @@ const GET_API_SCHEMA_ROUTE = require_route_builder.createRoute({
 	tags: ["System"],
 	requiresAuth: true,
 	handler: async () => {
-		const { buildApiSchemaManifest } = await Promise.resolve().then(() => require("../../api-schema-manifest-Cs2cYG-m.cjs"));
+		const { buildApiSchemaManifest } = await Promise.resolve().then(() => require("../../api-schema-manifest-DUseI2VG.cjs"));
 		return buildApiSchemaManifest();
 	}
 });

package/dist/server/handlers/system.d.ts

@@ -104,6 +104,7 @@ export declare const GET_SYSTEM_PACKAGES_ROUTE: Omit<import("@mastra/core/server
             traceQueryContextIds: boolean;
             traceQueryTimeToFirstChunk: boolean;
             traceQueryRootSpanFields: boolean;
+            traceQueryRootEntityId: boolean;
             traceQueryTimeToFirstChunkSort: boolean;
             traceQueryDiscovery: boolean;
             traceQueryTenantScope: boolean;
@@ -111,6 +112,7 @@ export declare const GET_SYSTEM_PACKAGES_ROUTE: Omit<import("@mastra/core/server
             threadQuery: boolean;
             threadQueryRows: boolean;
             spanQuery: boolean;
+            spanQueryContextFields: boolean;
             traceRetentionDays?: number | undefined;
             feedback: boolean;
         } | undefined;
@@ -178,6 +180,7 @@ export declare const GET_SYSTEM_PACKAGES_ROUTE: Omit<import("@mastra/core/server
             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;
@@ -185,6 +188,7 @@ export declare const GET_SYSTEM_PACKAGES_ROUTE: Omit<import("@mastra/core/server
             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/handlers/system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/system.ts"],"names":[],"mappings":"AA+HA,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAc/B,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgEpC,CAAC"}
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/system.ts"],"names":[],"mappings":"AA+HA,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAc/B,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgEpC,CAAC"}

package/dist/server/handlers/system.js

@@ -1,7 +1,7 @@
 import { n as createRoute } from "../../route-builder-BfQYtclb.js";
 import { handleError } from "./error.js";
 import { getObservabilityStorageCapabilities } from "./observability-shared.js";
-import { t as apiSchemaManifestResponseSchema, u as systemPackagesResponseSchema } from "../../system-BLcPGYXT.js";
+import { t as apiSchemaManifestResponseSchema, u as systemPackagesResponseSchema } from "../../system-CpzPxRRq.js";
 import { readFileSync } from "fs";
 //#region src/server/handlers/system.ts
 const SOURCE_PROVIDER_CAPABILITIES_TIMEOUT_MS = 3e3;
@@ -88,7 +88,7 @@ const GET_API_SCHEMA_ROUTE = createRoute({
 	tags: ["System"],
 	requiresAuth: true,
 	handler: async () => {
-		const { buildApiSchemaManifest } = await import("../../api-schema-manifest-CXiWNHBm.js");
+		const { buildApiSchemaManifest } = await import("../../api-schema-manifest-CWRIJP-B.js");
 		return buildApiSchemaManifest();
 	}
 });

package/dist/server/schemas/index.cjs

@@ -18,7 +18,7 @@ const require_responses = require("../../responses-CKNdSRkS.cjs");
 const require_conversations = require("../../conversations-Bj5TLNqF.cjs");
 const require_logs = require("../../logs-CY8AGOCO.cjs");
 const require_mcp = require("../../mcp-ShaKO7gA.cjs");
-const require_system = require("../../system-DvpPWdIa.cjs");
+const require_system = require("../../system-BvpFMIJB.cjs");
 const require_scores = require("../../scores-CetVKM4g.cjs");
 const require_vectors = require("../../vectors-LFI1jch0.cjs");
 const require_version_common = require("../../version-common-DrzXq7Ct.cjs");

package/dist/server/schemas/index.js

@@ -16,7 +16,7 @@ import { _ as responseToolSchema, a as deleteResponseSchema, c as responseInputT
 import { a as createConversationBodySchema, i as conversationObjectSchema, n as conversationIdPathParams, r as conversationItemsListSchema, t as conversationDeletedSchema } from "../../conversations-BzBHVFYe.js";
 import { n as listLogsQuerySchema, r as listLogsResponseSchema, t as listLogTransportsResponseSchema } from "../../logs-Bd_xpsYw.js";
 import { _ as serverInfoSchema, a as listMcpServerToolsResponseSchema, f as mcpServerToolPathParams, g as serverDetailSchema, i as jsonRpcErrorSchema, l as mcpServerDetailPathParams, n as executeToolResponseSchema$1, o as listMcpServersQuerySchema, p as mcpToolInfoSchema, r as getMcpServerDetailQuerySchema, s as listMcpServersResponseSchema, t as executeToolBodySchema$1, u as mcpServerIdPathParams, v as versionDetailSchema } from "../../mcp-DzpwLXEY.js";
-import { a as editorSourceSchema, c as observabilityRuntimeStrategySchema, i as editorSourceCapabilitiesSchema, l as observabilityStorageCapabilitiesSchema, n as apiSchemaManifestRouteSchema, o as mastraPackageSchema, r as apiSchemaResponseShapeSchema, s as observabilityDiscoveryCapabilitiesSchema, t as apiSchemaManifestResponseSchema, u as systemPackagesResponseSchema } from "../../system-BLcPGYXT.js";
+import { a as editorSourceSchema, c as observabilityRuntimeStrategySchema, i as editorSourceCapabilitiesSchema, l as observabilityStorageCapabilitiesSchema, n as apiSchemaManifestRouteSchema, o as mastraPackageSchema, r as apiSchemaResponseShapeSchema, s as observabilityDiscoveryCapabilitiesSchema, t as apiSchemaManifestResponseSchema, u as systemPackagesResponseSchema } from "../../system-CpzPxRRq.js";
 import { a as listScoresByScorerIdQuerySchema, c as scorerEntrySchema, i as listScoresByRunIdQuerySchema, l as scorerIdPathParams, n as listScorersResponseSchema, o as saveScoreBodySchema, r as listScoresByEntityIdQuerySchema, s as saveScoreResponseSchema, t as entityPathParams, u as scoresWithPaginationResponseSchema } from "../../scores-BbqFfKcy.js";
 import { a as listEmbeddersResponseSchema, c as queryVectorsBodySchema, d as upsertVectorsResponseSchema, f as vectorIndexPathParams, i as describeIndexResponseSchema, l as queryVectorsResponseSchema, n as createIndexResponseSchema, o as listIndexesResponseSchema, p as vectorNamePathParams, r as deleteIndexResponseSchema, s as listVectorsResponseSchema, t as createIndexBodySchema, u as upsertVectorsBodySchema } from "../../vectors-CJtupgIF.js";
 import { a as createVersionBodySchema, c as versionDiffEntrySchema, i as createListVersionsResponseSchema, l as versionOrderBySchema, n as compareVersionsQuerySchema, o as deleteVersionResponseSchema, r as createCompareVersionsResponseSchema, s as listVersionsQuerySchema, t as activateVersionResponseSchema } from "../../version-common-4xFzvCS5.js";

package/dist/server/schemas/system.d.ts

@@ -38,6 +38,7 @@ export declare const observabilityStorageCapabilitiesSchema: z.ZodObject<{
     traceQueryContextIds: z.ZodBoolean;
     traceQueryTimeToFirstChunk: z.ZodBoolean;
     traceQueryRootSpanFields: z.ZodBoolean;
+    traceQueryRootEntityId: z.ZodBoolean;
     traceQueryTimeToFirstChunkSort: z.ZodBoolean;
     traceQueryDiscovery: z.ZodBoolean;
     traceQueryTenantScope: z.ZodBoolean;
@@ -45,6 +46,7 @@ export declare const observabilityStorageCapabilitiesSchema: z.ZodObject<{
     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>;
@@ -123,6 +125,7 @@ export declare const systemPackagesResponseSchema: z.ZodObject<{
         traceQueryContextIds: z.ZodBoolean;
         traceQueryTimeToFirstChunk: z.ZodBoolean;
         traceQueryRootSpanFields: z.ZodBoolean;
+        traceQueryRootEntityId: z.ZodBoolean;
         traceQueryTimeToFirstChunkSort: z.ZodBoolean;
         traceQueryDiscovery: z.ZodBoolean;
         traceQueryTenantScope: z.ZodBoolean;
@@ -130,6 +133,7 @@ export declare const systemPackagesResponseSchema: z.ZodObject<{
         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>>;

package/dist/server/schemas/system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../src/server/schemas/system.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,eAAO,MAAM,mBAAmB;;;iBAG9B,CAAC;AAEH,eAAO,MAAM,kCAAkC;;;;;EAK7C,CAAC;AAEH,eAAO,MAAM,wCAAwC;;;;;;;iBAOnD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuDjD,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;EAAyB,CAAC;AAEzD,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;iBAYzC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoBvC,CAAC;AAIH,eAAO,MAAM,4BAA4B;;;;;;;;;;iBAIvC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;iBASvC,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;iBAG1C,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC"}
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../src/server/schemas/system.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,eAAO,MAAM,mBAAmB;;;iBAG9B,CAAC;AAEH,eAAO,MAAM,kCAAkC;;;;;EAK7C,CAAC;AAEH,eAAO,MAAM,wCAAwC;;;;;;;iBAOnD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgEjD,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;EAAyB,CAAC;AAEzD,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;iBAYzC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoBvC,CAAC;AAIH,eAAO,MAAM,4BAA4B;;;;;;;;;;iBAIvC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;iBASvC,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;iBAG1C,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC"}

package/dist/server/server-adapter/index.cjs

@@ -6,7 +6,7 @@ const require_utils = require("../../utils-DCgeTrq2.cjs");
 const require_constants = require("../../constants-e7aaPCLj.cjs");
 const require_server_handlers_error = require("../handlers/error.cjs");
 const require_helpers = require("../../helpers-ElhPeCSK.cjs");
-const require_routes = require("../../routes-gZRBp2vK.cjs");
+const require_routes = require("../../routes-DPojsNf1.cjs");
 let zod_v4 = require("zod/v4");
 let stream = require("stream");
 let _mastra_core_request_context = require("@mastra/core/request-context");

package/dist/server/server-adapter/index.js

@@ -4,7 +4,7 @@ import { o as normalizeRoutePath, t as WorkflowRegistry } from "../../utils-DCAU
 import { f as RESERVED_REQUEST_CONTEXT_KEYS, h as isStudioClientTypeHeader, i as MASTRA_IS_STUDIO_KEY, l as MASTRA_USER_KEY, m as isReservedRequestContextKey, n as MASTRA_AUTH_TOKEN_KEY, o as MASTRA_RESOURCE_ID_KEY$1, r as MASTRA_CLIENT_TYPE_HEADER, s as MASTRA_STUDIO_CLIENT_TYPE, t as MASTRA_AUTH_MODE_KEY } from "../../constants-DazK_RZj.js";
 import { formatZodError, isZodError } from "../handlers/error.js";
 import { d as pathMatchesPattern, i as findMatchingCustomRoute, o as isCustomRoutePublic, r as coreAuthMiddleware } from "../../helpers-DLhX1fqc.js";
-import { t as SERVER_ROUTES } from "../../routes-BYcXmjX3.js";
+import { t as SERVER_ROUTES } from "../../routes-rwufkyUe.js";
 import { z } from "zod/v4";
 import { Readable } from "stream";
 import { RequestContext } from "@mastra/core/request-context";

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

@@ -4051,6 +4051,7 @@ export declare const OBSERVABILITY_ROUTES: readonly [import(".").ServerRoute, Om
             traceQueryContextIds: boolean;
             traceQueryTimeToFirstChunk: boolean;
             traceQueryRootSpanFields: boolean;
+            traceQueryRootEntityId: boolean;
             traceQueryTimeToFirstChunkSort: boolean;
             traceQueryDiscovery: boolean;
             traceQueryTenantScope: boolean;
@@ -4058,6 +4059,7 @@ export declare const OBSERVABILITY_ROUTES: readonly [import(".").ServerRoute, Om
             threadQuery: boolean;
             threadQueryRows: boolean;
             spanQuery: boolean;
+            spanQueryContextFields: boolean;
             traceRetentionDays?: number | undefined;
             feedback: boolean;
         };
@@ -4091,6 +4093,7 @@ export declare const OBSERVABILITY_ROUTES: readonly [import(".").ServerRoute, Om
             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;
@@ -4098,6 +4101,7 @@ export declare const OBSERVABILITY_ROUTES: readonly [import(".").ServerRoute, Om
             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>;