@mastra/server 1.72.0-alpha.8 → 1.72.0

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

@@ -1 +1 @@
-{"version":3,"file":"observability-shared.cjs","names":["coreStorage","candidate","HTTPException","coreFeatures","z","paginationArgsSchema","wrapSchemaForQueryParams","listModeSchema","deltaCursorSchema","deltaLimitSchema"],"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  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_QUERY_ROOT_DURATION_STORAGE_FEATURE = 'trace-query-root-duration';\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 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\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\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  traceQueryDiscovery: boolean;\n  traceQueryTenantScope: boolean;\n  threadQuery: boolean;\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  traceQueryDiscovery: false,\n  traceQueryTenantScope: false,\n  threadQuery: 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\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    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    threadQuery,\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  QUERY_THREADS: {\n    method: 'POST',\n    path: '/observability/threads/query',\n    summary: 'Query threads',\n    description: 'Returns thread identities matching eligible trace and cross-trace predicates',\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.cjs","names":["coreStorage","candidate","HTTPException","coreFeatures","z","paginationArgsSchema","wrapSchemaForQueryParams","listModeSchema","deltaCursorSchema","deltaLimitSchema"],"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  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_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_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 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 assertObservabilityTraceAggregateSupported(observabilityStore: ObservabilityStorage) {\n  if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_AGGREGATE_STORAGE_FEATURE)) return;\n\n  throw new HTTPException(501, {\n    message: 'Trace aggregation is not supported by the configured observability store',\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\nfunction usesContextId(predicate: TrustedTraceQueryPredicate | TrustedThreadPredicate | undefined): boolean {\n  if (!predicate) return false;\n  if (predicate.type === 'boolean') return predicate.args.some(usesContextId);\n  if (predicate.type === 'not') return usesContextId(predicate.arg);\n  if (predicate.type === 'relation') return usesContextId(predicate.predicate);\n  return TRACE_QUERY_CONTEXT_ID_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 (!usesContextId(predicate) || supportsObservabilityTraceQueryContextIds(observabilityStore)) return;\n\n  throw new HTTPException(501, {\n    message: 'Context identifier predicates are 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  traceQueryDiscovery: boolean;\n  traceQueryTenantScope: boolean;\n  threadQuery: boolean;\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  traceQueryDiscovery: false,\n  traceQueryTenantScope: false,\n  threadQuery: 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\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    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    threadQuery,\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: 'Returns thread identities matching eligible trace and cross-trace predicates',\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-shared.d.ts

@@ -8,6 +8,7 @@ export declare const OBSERVABILITY_DELTA_POLLING_UPGRADE_MESSAGE = "Delta pollin
 export declare const OBSERVABILITY_TRACE_QUERY_TENANT_SCOPE_CORE_FEATURE = "observability-trace-query-tenant-scope";
 export declare const OBSERVABILITY_TRACE_QUERY_TENANT_SCOPE_UPGRADE_MESSAGE = "Trusted tenant scope requires a newer @mastra/core with trace-query tenant scope support. Please upgrade.";
 export declare function supportsTraceQueryDiscoveryCore(): boolean;
+export declare function supportsTraceAggregateCore(): boolean;
 export declare const OBSERVABILITY_LIST_ENDPOINTS: {
     readonly traces: 'traces';
     readonly branches: 'branches';
@@ -24,8 +25,12 @@ export declare function getObservabilityStore(mastra: Mastra): Promise<Observabi
 /** Retrieves the scores storage domain or throws 501 if unavailable. */
 export declare function getScoresStore(mastra: Mastra): Promise<ScoresStorage>;
 export declare function assertObservabilityTraceQuerySupported(observabilityStore: ObservabilityStorage): void;
+export declare function assertObservabilityTraceAggregateSupported(observabilityStore: ObservabilityStorage): void;
 export declare function supportsObservabilityTraceQueryRootDuration(observabilityStore: ObservabilityStorage): boolean;
 export declare function assertObservabilityTraceQueryRootDurationSupported(observabilityStore: ObservabilityStorage, predicate: TrustedTraceQueryPredicate | TrustedThreadPredicate | undefined): void;
+export declare function supportsObservabilityTraceQueryContextIds(observabilityStore: ObservabilityStorage): boolean;
+export declare function isTraceQueryContextIdField(path: string): boolean;
+export declare function assertObservabilityTraceQueryContextIdsSupported(observabilityStore: ObservabilityStorage, predicate: TrustedTraceQueryPredicate | TrustedThreadPredicate | undefined): void;
 export declare function assertObservabilityTraceQueryDiscoverySupported(observabilityStore: ObservabilityStorage): void;
 /**
  * A scoped request must never run unscoped: a store that predates tenant scope would
@@ -49,6 +54,7 @@ export type ObservabilityStorageCapabilities = {
     deltaPolling: boolean;
     traceQuery: boolean;
     traceQueryRootDuration: boolean;
+    traceQueryContextIds: boolean;
     traceQueryDiscovery: boolean;
     traceQueryTenantScope: boolean;
     threadQuery: boolean;
@@ -93,6 +99,13 @@ export declare const NEW_ROUTE_DEFS: {
         readonly description: 'Returns completed logical traces or distinct thread groups matching an advanced trace query. Thread grouping remains supported but is deprecated; use queryTraceThreads instead.';
         readonly requiresPermission: 'observability:read';
     };
+    readonly AGGREGATE_TRACES: {
+        readonly method: 'POST';
+        readonly path: '/observability/traces/aggregate';
+        readonly summary: 'Aggregate traces';
+        readonly description: 'Returns grouped and optionally time-bucketed measures (counts, durations, error rates) over completed logical traces matching an advanced trace predicate';
+        readonly requiresPermission: 'observability:read';
+    };
     readonly QUERY_THREADS: {
         readonly method: 'POST';
         readonly path: '/observability/threads/query';

package/dist/server/handlers/observability-shared.d.ts.map

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

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

@@ -8,7 +8,15 @@ import { coreFeatures } from "@mastra/core/features";
 const OBSERVABILITY_DELTA_POLLING_FEATURE = "observability-delta-polling";
 const OBSERVABILITY_DELTA_POLLING_UPGRADE_MESSAGE = "Delta polling requires a newer @mastra/core with observability delta polling support. Please upgrade.";
 const OBSERVABILITY_TRACE_QUERY_STORAGE_FEATURE = "trace-query";
+const OBSERVABILITY_TRACE_AGGREGATE_STORAGE_FEATURE = "trace-aggregate";
 const OBSERVABILITY_TRACE_QUERY_ROOT_DURATION_STORAGE_FEATURE = "trace-query-root-duration";
+const OBSERVABILITY_TRACE_QUERY_CONTEXT_IDS_STORAGE_FEATURE = "trace-query-context-ids";
+const TRACE_QUERY_CONTEXT_ID_FIELDS = /* @__PURE__ */ new Set([
+	"runId",
+	"sessionId",
+	"userId",
+	"organizationId"
+]);
 const OBSERVABILITY_TRACE_QUERY_DISCOVERY_STORAGE_FEATURE = "trace-query-discovery";
 const OBSERVABILITY_THREAD_QUERY_STORAGE_FEATURE = "thread-query";
 const OBSERVABILITY_TRACE_QUERY_TENANT_SCOPE_STORAGE_FEATURE = "trace-query-tenant-scope";
@@ -18,6 +26,9 @@ const OBSERVABILITY_TRACE_QUERY_TENANT_SCOPE_UPGRADE_MESSAGE = "Trusted tenant s
 function supportsTraceQueryDiscoveryCore() {
 	return coreStorage.getTraceQueryFieldsArgsSchema !== void 0 && coreStorage.getTraceQueryFieldsResponseSchema !== void 0 && coreStorage.getTraceQueryValuesArgsSchema !== void 0 && coreStorage.getTraceQueryValuesResponseSchema !== void 0 && typeof coreStorage.planTraceQueryObservedFields === "function" && typeof coreStorage.planTraceQueryValues === "function" && typeof coreStorage.getTraceQueryCanonicalFieldDescriptors === "function" && typeof coreStorage.TraceQueryResourceLimitError === "function";
 }
+function supportsTraceAggregateCore() {
+	return coreStorage.traceAggregateRequestSchema !== void 0 && coreStorage.traceAggregateResponseSchema !== void 0 && typeof coreStorage.planTraceAggregate === "function";
+}
 const OBSERVABILITY_LIST_ENDPOINTS = {
 	traces: "traces",
 	branches: "branches",
@@ -52,6 +63,10 @@ function assertObservabilityTraceQuerySupported(observabilityStore) {
 	if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_QUERY_STORAGE_FEATURE)) return;
 	throw new HTTPException(501, { message: "Advanced trace queries are not supported by the configured observability store" });
 }
+function assertObservabilityTraceAggregateSupported(observabilityStore) {
+	if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_AGGREGATE_STORAGE_FEATURE)) return;
+	throw new HTTPException(501, { message: "Trace aggregation is not supported by the configured observability store" });
+}
 function usesRootDuration(predicate) {
 	if (!predicate) return false;
 	if (predicate.type === "boolean") return predicate.args.some(usesRootDuration);
@@ -66,6 +81,23 @@ function assertObservabilityTraceQueryRootDurationSupported(observabilityStore,
 	if (!usesRootDuration(predicate) || supportsObservabilityTraceQueryRootDuration(observabilityStore)) return;
 	throw new HTTPException(501, { message: "Root duration predicates are not supported by the configured observability store" });
 }
+function usesContextId(predicate) {
+	if (!predicate) return false;
+	if (predicate.type === "boolean") return predicate.args.some(usesContextId);
+	if (predicate.type === "not") return usesContextId(predicate.arg);
+	if (predicate.type === "relation") return usesContextId(predicate.predicate);
+	return TRACE_QUERY_CONTEXT_ID_FIELDS.has(predicate.field);
+}
+function supportsObservabilityTraceQueryContextIds(observabilityStore) {
+	return getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_QUERY_CONTEXT_IDS_STORAGE_FEATURE) === true;
+}
+function isTraceQueryContextIdField(path) {
+	return TRACE_QUERY_CONTEXT_ID_FIELDS.has(path);
+}
+function assertObservabilityTraceQueryContextIdsSupported(observabilityStore, predicate) {
+	if (!usesContextId(predicate) || supportsObservabilityTraceQueryContextIds(observabilityStore)) return;
+	throw new HTTPException(501, { message: "Context identifier predicates are not supported by the configured observability store" });
+}
 function assertObservabilityTraceQueryDiscoverySupported(observabilityStore) {
 	if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_QUERY_DISCOVERY_STORAGE_FEATURE)) return;
 	throw new HTTPException(501, { message: "Trace query discovery is not supported by the configured observability store" });
@@ -116,6 +148,7 @@ const NO_OBSERVABILITY_STORAGE_CAPABILITIES = {
 	deltaPolling: false,
 	traceQuery: false,
 	traceQueryRootDuration: false,
+	traceQueryContextIds: false,
 	traceQueryDiscovery: false,
 	traceQueryTenantScope: false,
 	threadQuery: false,
@@ -170,6 +203,7 @@ function getObservabilityStorageCapabilities(observabilityStore) {
 		deltaPolling: coreFeatures.has("observability-delta-polling") && declares(OBSERVABILITY_DELTA_POLLING_STORAGE_FEATURE),
 		traceQuery,
 		traceQueryRootDuration: (traceQuery || threadQuery) && declares(OBSERVABILITY_TRACE_QUERY_ROOT_DURATION_STORAGE_FEATURE),
+		traceQueryContextIds: (traceQuery || threadQuery) && declares(OBSERVABILITY_TRACE_QUERY_CONTEXT_IDS_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),
 		threadQuery,
@@ -214,6 +248,13 @@ const NEW_ROUTE_DEFS = {
 		description: "Returns completed logical traces or distinct thread groups matching an advanced trace query. Thread grouping remains supported but is deprecated; use queryTraceThreads instead.",
 		requiresPermission: "observability:read"
 	},
+	AGGREGATE_TRACES: {
+		method: "POST",
+		path: "/observability/traces/aggregate",
+		summary: "Aggregate traces",
+		description: "Returns grouped and optionally time-bucketed measures (counts, durations, error rates) over completed logical traces matching an advanced trace predicate",
+		requiresPermission: "observability:read"
+	},
 	QUERY_THREADS: {
 		method: "POST",
 		path: "/observability/threads/query",
@@ -503,6 +544,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, assertObservabilityThreadQuerySupported, assertObservabilityTraceQueryDiscoverySupported, assertObservabilityTraceQueryRootDurationSupported, assertObservabilityTraceQuerySupported, assertObservabilityTraceQueryTenantScopeSupported, createObservabilityListQuerySchema, getObservabilityStorageCapabilities, getObservabilityStore, getScoresStore, getStorage, supportsObservabilityTraceQueryRootDuration, 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, assertObservabilityThreadQuerySupported, assertObservabilityTraceAggregateSupported, assertObservabilityTraceQueryContextIdsSupported, assertObservabilityTraceQueryDiscoverySupported, assertObservabilityTraceQueryRootDurationSupported, assertObservabilityTraceQuerySupported, assertObservabilityTraceQueryTenantScopeSupported, createObservabilityListQuerySchema, getObservabilityStorageCapabilities, getObservabilityStore, getScoresStore, getStorage, isTraceQueryContextIdField, supportsObservabilityTraceQueryContextIds, supportsObservabilityTraceQueryRootDuration, 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  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_QUERY_ROOT_DURATION_STORAGE_FEATURE = 'trace-query-root-duration';\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 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\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\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  traceQueryDiscovery: boolean;\n  traceQueryTenantScope: boolean;\n  threadQuery: boolean;\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  traceQueryDiscovery: false,\n  traceQueryTenantScope: false,\n  threadQuery: 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\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    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    threadQuery,\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  QUERY_THREADS: {\n    method: 'POST',\n    path: '/observability/threads/query',\n    summary: 'Query threads',\n    description: 'Returns thread identities matching eligible trace and cross-trace predicates',\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":";;;;;;;AAqBA,MAAa,sCAAsC;AACnD,MAAa,8CACX;AACF,MAAM,4CAA4C;AAClD,MAAM,0DAA0D;AAChE,MAAM,sDAAsD;AAC5D,MAAM,6CAA6C;AACnD,MAAM,yDAAyD;AAC/D,MAAM,yCAAyC;AAC/C,MAAa,sDAAsD;AACnE,MAAa,yDACX;AAEF,SAAgB,kCAAkC;CAChD,OACE,YAAY,kCAAkC,KAAA,KAC9C,YAAY,sCAAsC,KAAA,KAClD,YAAY,kCAAkC,KAAA,KAC9C,YAAY,sCAAsC,KAAA,KAClD,OAAO,YAAY,iCAAiC,cACpD,OAAO,YAAY,yBAAyB,cAC5C,OAAO,YAAY,2CAA2C,cAC9D,OAAO,YAAY,iCAAiC;AAExD;AAEA,MAAa,+BAA+B;CAC1C,QAAQ;CACR,UAAU;CACV,MAAM;CACN,SAAS;CACT,QAAQ;CACR,UAAU;AACZ;AAIA,MAAM,8CAA8C;AAEpD,SAAS,YAAY,oBAAyE;CAI5F,OAAOA,mBAAU,cAAc;AACjC;;AAGA,SAAgB,WAAW,QAAsC;CAC/D,MAAM,UAAU,OAAO,WAAW;CAClC,IAAI,CAAC,SACH,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,2BAA2B,CAAC;CAEtE,OAAO;AACT;;AAGA,eAAsB,sBAAsB,QAA+C;CAEzF,MAAM,gBAAgB,MADN,WAAW,MACO,CAAC,CAAC,SAAS,eAAe;CAC5D,IAAI,CAAC,eAIH,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,gDAAgD,CAAC;CAE3F,OAAO;AACT;;AAGA,eAAsB,eAAe,QAAwC;CAE3E,MAAM,SAAS,MADC,WAAW,MACA,CAAC,CAAC,SAAS,QAAQ;CAC9C,IAAI,CAAC,QACH,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,yCAAyC,CAAC;CAEpF,OAAO;AACT;AAEA,SAAgB,uCAAuC,oBAA0C;CAC/F,IAAI,YAAY,kBAAkB,CAAC,EAAE,SAAS,yCAAyC,GAAG;CAE1F,MAAM,IAAI,cAAc,KAAK,EAC3B,SAAS,iFACX,CAAC;AACH;AAEA,SAAS,iBAAiB,WAAqF;CAC7G,IAAI,CAAC,WAAW,OAAO;CACvB,IAAI,UAAU,SAAS,WAAW,OAAO,UAAU,KAAK,KAAK,gBAAgB;CAC7E,IAAI,UAAU,SAAS,OAAO,OAAO,iBAAiB,UAAU,GAAG;CACnE,IAAI,UAAU,SAAS,YACrB,OAAO,UAAU,eAAe,YAAY,iBAAiB,UAAU,SAAS;CAElF,OAAO,UAAU,UAAU;AAC7B;AAEA,SAAgB,4CAA4C,oBAA0C;CACpG,OAAO,YAAY,kBAAkB,CAAC,EAAE,SAAS,uDAAuD,MAAM;AAChH;AAEA,SAAgB,mDACd,oBACA,WACA;CACA,IAAI,CAAC,iBAAiB,SAAS,KAAK,4CAA4C,kBAAkB,GAAG;CAErG,MAAM,IAAI,cAAc,KAAK,EAC3B,SAAS,mFACX,CAAC;AACH;AAEA,SAAgB,gDAAgD,oBAA0C;CACxG,IAAI,YAAY,kBAAkB,CAAC,EAAE,SAAS,mDAAmD,GAAG;CAEpG,MAAM,IAAI,cAAc,KAAK,EAC3B,SAAS,+EACX,CAAC;AACH;;;;;;AAOA,SAAgB,kDACd,oBACA,OACA;CACA,IAAI,UAAU,KAAA,GAAW;CACzB,IAAI,YAAY,kBAAkB,CAAC,EAAE,SAAS,sDAAsD,GAAG;CAEvG,MAAM,IAAI,cAAc,KAAK,EAC3B,SAAS,6EACX,CAAC;AACH;AAEA,SAAgB,wCAAwC,oBAA0C;CAChG,IAAI,YAAY,kBAAkB,CAAC,EAAE,SAAS,0CAA0C,GAAG;CAE3F,MAAM,IAAI,cAAc,KAAK,EAC3B,SAAS,kFACX,CAAC;AACH;;;;;;;;;AAUA,SAAS,qCAAqC,oBAA4B,QAAyB;CACjG,IAAI,OAAO,UAAU,eAAe,KAAK,oBAAoB,MAAM,GAAG,OAAO;CAE7E,IAAI;CACJ,IAAI;CACJ,KACE,IAAI,QAAuB,OAAO,eAAe,kBAAkB,GACnE,SAAS,UAAU,OAAO,WAC1B,QAAQ,OAAO,eAAe,KAAK,GAEnC,IAAI,OAAO,UAAU,eAAe,KAAK,OAAO,MAAM,GAAG;EACvD,kBAAkB;EAClB,gBAAgB;CAClB;CAEF,OAAO,kBAAkB,KAAA,KAAa,kBAAkB;AAC1D;AAwBA,MAAa,wCAA0E;CACrF,SAAS;CACT,MAAM;CACN,WAAW;EACT,aAAa;EACb,aAAa;EACb,cAAc;EACd,cAAc;EACd,MAAM;EACN,SAAS;CACX;CACA,cAAc;CACd,YAAY;CACZ,wBAAwB;CACxB,qBAAqB;CACrB,uBAAuB;CACvB,aAAa;CACb,UAAU;AACZ;;;;;;;;;;;;;;AAeA,SAAgB,oCACd,oBACkC;CAClC,MAAM,mBAAmB,YAAY,kBAAkB;CACvD,MAAM,WAAW,oBAAoB,CAAC;CACtC,MAAM,aAAa,aAAa,IAAI,uBAAuB;CAC3D,MAAM,YAAY,YAAoB,SAAS,SAAS,OAAO;CAE/D,MAAM,YAAY,SAAiB,YAA+B;EAChE,IAAI,CAAC,YAAY,OAAO;EACxB,IAAI,CAAC,kBACH,OAAO,QAAQ,OAAM,WAAU,qCAAqC,oBAAoB,MAAM,CAAC;EAEjG,OAAO,SAAS,OAAO;CACzB;CAGA,MAAM,qBAAqB,SAAiB,YAC1C,SAAS,SAAS,OAAO,KAAM,cAAc,SAAS,yCAAyC;CACjG,MAAM,aACJ,cACA,OAAO,YAAY,mBAAmB,cACtC,SAAS,yCAAyC;CACpD,MAAM,cACJ,cACA,OAAO,YAAY,oBAAoB,cACvC,SAAS,0CAA0C;CAErD,OAAO;EAGL,SAAS,SAAS,WAAW;GAC3B;GACA;GACA;GACA;EACF,CAAC;EACD,MAAM,SAAS,QAAQ,CAAC,UAAU,CAAC;EACnC,WAAW;GACT,aAAa,kBAAkB,yBAAyB,CAAC,gBAAgB,CAAC;GAC1E,aAAa,kBAAkB,yBAAyB,CAAC,gBAAgB,CAAC;GAC1E,cAAc,kBAAkB,0BAA0B,CAAC,iBAAiB,CAAC;GAC7E,cAAc,kBAAkB,yBAAyB,CAAC,iBAAiB,CAAC;GAC5E,MAAM,kBAAkB,iBAAiB,CAAC,SAAS,CAAC;GACpD,SAAS,kBAAkB,oBAAoB;IAAC;IAAkB;IAAsB;GAAsB,CAAC;EACjH;EACA,cACE,aAAa,IAAA,6BAAuC,KAAK,SAAS,2CAA2C;EAC/G;EACA,yBACG,cAAc,gBAAgB,SAAS,uDAAuD;EACjG,qBACE,cAAc,gCAAgC,KAAK,SAAS,mDAAmD;EACjH,wBACG,cAAc,gBACf,aAAa,IAAA,wCAAuD,KACpE,SAAS,sDAAsD;EACjE;EACA,UAAU,cAAc,SAAS,sCAAsC;CACzE;AACF;;;;;;;AAQA,SAAS,0CAA0C,OAAyB;CAC1E,MAAM,KAAK,SAAS,OAAO,UAAU,YAAY,QAAQ,QAAQ,MAAM,KAAK,KAAA;CAC5E,OAAO,OAAO,OAAO,YAAY,GAAG,WAAW,wBAAwB,KAAK,GAAG,SAAS,kBAAkB;AAC5G;;;;;;;;AASA,eAAsB,sBAAyB,KAAuB,OAAsB;CAC1F,IAAI;EACF,OAAO,MAAM,IAAI;CACnB,SAAS,OAAO;EACd,IAAI,0CAA0C,KAAK,GAAG,OAAO;EAC7D,MAAM;CACR;AACF;AAEA,SAAgB,kCACd,oBACA,UACA;CACA,IAAI,CAAC,aAAa,IAAA,6BAAuC,GACvD,MAAM,IAAI,cAAc,KAAK,EAC3B,SAAS,GAAG,4CAA4C,cAAc,SAAS,GACjF,CAAC;CAGH,IAAI,YAAY,kBAAkB,CAAC,EAAE,SAAS,2CAA2C,GACvF;CAGF,MAAM,IAAI,cAAc,KAAK,EAC3B,SAAS,4EAA4E,WACvF,CAAC;AACH;AAUA,MAAa,iBAAiB;CAC5B,cAAc;EACZ,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aACE;EACF,oBAAoB;CACtB;CAEA,eAAe;EACb,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;EACb,oBAAoB;CACtB;CAEA,wBAAwB;EACtB,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;EACb,oBAAoB;CACtB;CAEA,wBAAwB;EACtB,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;EACb,oBAAoB;CACtB;CAEA,cAAc;EACZ,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;CACf;CAEA,WAAW;EACT,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;CACf;CAEA,aAAa;EACX,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;CACf;CAEA,cAAc;EACZ,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;CACf;CAEA,eAAe;EACb,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;EACb,oBAAoB;CACtB;CAEA,WAAW;EACT,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;CACf;CAEA,qBAAqB;EACnB,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;EACb,oBAAoB;CACtB;CAEA,qBAAqB;EACnB,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;EACb,oBAAoB;CACtB;CAEA,uBAAuB;EACrB,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;EACb,oBAAoB;CACtB;CAEA,uBAAuB;EACrB,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;EACb,oBAAoB;CACtB;CAEA,eAAe;EACb,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;CACf;CAEA,iBAAiB;EACf,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;CACf;CAEA,iBAAiB;EACf,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;EACb,oBAAoB;CACtB;CAEA,+BAA+B;EAC7B,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;EACb,oBAAoB;CACtB;CAEA,wBAAwB;EACtB,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;EACb,oBAAoB;CACtB;CAEA,wBAAwB;EACtB,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;EACb,oBAAoB;CACtB;CAEA,0BAA0B;EACxB,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;EACb,oBAAoB;CACtB;CAEA,0BAA0B;EACxB,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;EACb,oBAAoB;CACtB;CAEA,sBAAsB;EACpB,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;EACb,oBAAoB;CACtB;CAEA,sBAAsB;EACpB,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;EACb,oBAAoB;CACtB;CAEA,wBAAwB;EACtB,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;EACb,oBAAoB;CACtB;CAEA,wBAAwB;EACtB,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;EACb,oBAAoB;CACtB;CAEA,kBAAkB;EAChB,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;CACf;CAEA,uBAAuB;EACrB,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;CACf;CAEA,yBAAyB;EACvB,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;CACf;CAEA,kBAAkB;EAChB,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;CACf;CAEA,kBAAkB;EAChB,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;CACf;CAEA,mBAAmB;EACjB,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;CACf;CAEA,kBAAkB;EAChB,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;CACf;CAEA,UAAU;EACR,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;CACf;CAEA,kBAAkB;EAChB,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aACE;CACJ;AACF;AAKA,SAAgB,mCAGd,cAAuB,eAAyB;CAChD,MAAM,iBAAiB,WAAoB;EACzC,MAAM,YAAY;EAClB,OAAO,qBAAqB,EAAE,aAAa,UAAU,OAAO,IAAI;CAClE;CACA,MAAM,kBAAkB,qBAAqB;CAC7C,MAAM,eAAe,cAAc;CAEnC,MAAM,aAAa,cAAc,gBAAgB,IAAI;CACrD,MAAM,gBAAgB,cAAc,gBAAgB,OAAO;CAC3D,MAAM,cAAc,aAAa,QAAQ,cAAc,aAAa,KAAK,IAAI,EAAE,MAAM,CAAC,CAAC,SAAS;CAChG,MAAM,kBAAkB,aAAa,YAAY,cAAc,aAAa,SAAS,IAAI,EAAE,MAAM,CAAC,CAAC,SAAS;CAE5G,OAAO,yBACL,EACG,OAAO;EACN,GAAG,aAAa;EAChB,MAAM;EACN,SAAS;EACT,OAAO;EACP,WAAW;EACX,MAAM,eAAe,SAAS;EAC9B,OAAO,kBAAkB,SAAS;EAClC,OAAO;CACT,CAAC,CAAC,CACD,QAAQ,CACb,CAAC,CAAC,aAAa,OAAO,QAAQ;EAC5B,MAAM,UAAU,MAAM,SAAS;EAC/B,MAAM,gBAAgB,MAAM,SAAS,KAAA,KAAa,MAAM,YAAY,KAAA;EACpE,MAAM,aAAa,MAAM,UAAU,KAAA,KAAa,MAAM,cAAc,KAAA;EACpE,MAAM,WAAW,MAAM,UAAU,KAAA;EACjC,MAAM,WAAW,MAAM,UAAU,KAAA;EAEjC,IAAI,SAAS;GACX,IAAI,eAAe;IACjB,IAAI,MAAM,SAAS,KAAA,GACjB,IAAI,SAAS;KACX,MAAM,EAAE,aAAa;KACrB,MAAM,CAAC,MAAM;KACb,SAAS;IACX,CAAC;IAEH,IAAI,MAAM,YAAY,KAAA,GACpB,IAAI,SAAS;KACX,MAAM,EAAE,aAAa;KACrB,MAAM,CAAC,SAAS;KAChB,SAAS;IACX,CAAC;GAEL;GACA,IAAI,YAAY;IACd,IAAI,MAAM,UAAU,KAAA,GAClB,IAAI,SAAS;KACX,MAAM,EAAE,aAAa;KACrB,MAAM,CAAC,OAAO;KACd,SAAS;IACX,CAAC;IAEH,IAAI,MAAM,cAAc,KAAA,GACtB,IAAI,SAAS;KACX,MAAM,EAAE,aAAa;KACrB,MAAM,CAAC,WAAW;KAClB,SAAS;IACX,CAAC;GAEL;GACA;EACF;EAEA,IAAI,UACF,IAAI,SAAS;GACX,MAAM,EAAE,aAAa;GACrB,MAAM,CAAC,OAAO;GACd,SAAS;EACX,CAAC;EAEH,IAAI,UACF,IAAI,SAAS;GACX,MAAM,EAAE,aAAa;GACrB,MAAM,CAAC,OAAO;GACd,SAAS;EACX,CAAC;CAEL,CAAC;AACH"}
+{"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  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_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_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 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 assertObservabilityTraceAggregateSupported(observabilityStore: ObservabilityStorage) {\n  if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_AGGREGATE_STORAGE_FEATURE)) return;\n\n  throw new HTTPException(501, {\n    message: 'Trace aggregation is not supported by the configured observability store',\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\nfunction usesContextId(predicate: TrustedTraceQueryPredicate | TrustedThreadPredicate | undefined): boolean {\n  if (!predicate) return false;\n  if (predicate.type === 'boolean') return predicate.args.some(usesContextId);\n  if (predicate.type === 'not') return usesContextId(predicate.arg);\n  if (predicate.type === 'relation') return usesContextId(predicate.predicate);\n  return TRACE_QUERY_CONTEXT_ID_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 (!usesContextId(predicate) || supportsObservabilityTraceQueryContextIds(observabilityStore)) return;\n\n  throw new HTTPException(501, {\n    message: 'Context identifier predicates are 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  traceQueryDiscovery: boolean;\n  traceQueryTenantScope: boolean;\n  threadQuery: boolean;\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  traceQueryDiscovery: false,\n  traceQueryTenantScope: false,\n  threadQuery: 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\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    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    threadQuery,\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: 'Returns thread identities matching eligible trace and cross-trace predicates',\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,13 +6,14 @@ 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-Ct0CSLE4.cjs");
+const require_observability_new_endpoints = require("../../observability-new-endpoints-7Zd6uEZf.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");
 let _mastra_core_storage = require("@mastra/core/storage");
 //#region src/server/handlers/observability.ts
 var observability_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
+	AGGREGATE_TRACES: () => require_observability_new_endpoints.AGGREGATE_TRACES,
 	CREATE_FEEDBACK: () => require_observability_new_endpoints.CREATE_FEEDBACK,
 	CREATE_SCORE: () => require_observability_new_endpoints.CREATE_SCORE,
 	DELETE_FEEDBACK: () => require_observability_new_endpoints.DELETE_FEEDBACK,
@@ -423,6 +424,7 @@ const LIST_SCORES_BY_SPAN_ROUTE = require_route_builder.createRoute({
 	}
 });
 //#endregion
+exports.AGGREGATE_TRACES = require_observability_new_endpoints.AGGREGATE_TRACES;
 exports.CREATE_FEEDBACK = require_observability_new_endpoints.CREATE_FEEDBACK;
 exports.CREATE_SCORE = require_observability_new_endpoints.CREATE_SCORE;
 exports.DELETE_FEEDBACK = require_observability_new_endpoints.DELETE_FEEDBACK;