@mastra/server 1.75.0-alpha.3 → 1.75.0-alpha.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/{api-schema-manifest-D9_jxxNw.cjs → api-schema-manifest-BmNlBOvP.cjs} +2 -2
- package/dist/{api-schema-manifest-D9_jxxNw.cjs.map → api-schema-manifest-BmNlBOvP.cjs.map} +1 -1
- package/dist/{api-schema-manifest-B0p6nxU1.js → api-schema-manifest-Bsnp8kpD.js} +2 -2
- package/dist/{api-schema-manifest-B0p6nxU1.js.map → api-schema-manifest-Bsnp8kpD.js.map} +1 -1
- package/dist/docs/SKILL.md +2 -2
- package/dist/docs/assets/SOURCE_MAP.json +1 -1
- package/dist/docs/references/reference-observability-tracing-trace-query.md +65 -4
- package/dist/{observability-new-endpoints-lNC3o66-.js → observability-new-endpoints-DQuhr8aL.js} +114 -4
- package/dist/observability-new-endpoints-DQuhr8aL.js.map +1 -0
- package/dist/{observability-new-endpoints-7Zd6uEZf.cjs → observability-new-endpoints-Kphyk3do.cjs} +118 -2
- package/dist/observability-new-endpoints-Kphyk3do.cjs.map +1 -0
- package/dist/{routes-CJygX0-a.js → routes--Al6ya95.js} +3 -2
- package/dist/routes--Al6ya95.js.map +1 -0
- package/dist/{routes-BuiLQCOQ.cjs → routes-CeYKJ-Re.cjs} +3 -2
- package/dist/routes-CeYKJ-Re.cjs.map +1 -0
- package/dist/server/handlers/observability-new-endpoints.cjs +2 -1
- package/dist/server/handlers/observability-new-endpoints.d.ts +260 -0
- package/dist/server/handlers/observability-new-endpoints.d.ts.map +1 -1
- package/dist/server/handlers/observability-new-endpoints.js +2 -2
- package/dist/server/handlers/observability-shared.cjs +19 -0
- package/dist/server/handlers/observability-shared.cjs.map +1 -1
- package/dist/server/handlers/observability-shared.d.ts +10 -0
- package/dist/server/handlers/observability-shared.d.ts.map +1 -1
- package/dist/server/handlers/observability-shared.js +18 -1
- package/dist/server/handlers/observability-shared.js.map +1 -1
- package/dist/server/handlers/observability.cjs +3 -1
- package/dist/server/handlers/observability.cjs.map +1 -1
- package/dist/server/handlers/observability.js +3 -2
- package/dist/server/handlers/observability.js.map +1 -1
- package/dist/server/handlers/system.cjs +2 -2
- package/dist/server/handlers/system.d.ts +2 -0
- package/dist/server/handlers/system.d.ts.map +1 -1
- package/dist/server/handlers/system.js +2 -2
- package/dist/server/schemas/index.cjs +1 -1
- package/dist/server/schemas/index.js +1 -1
- package/dist/server/schemas/system.d.ts +2 -0
- package/dist/server/schemas/system.d.ts.map +1 -1
- package/dist/server/server-adapter/index.cjs +1 -1
- package/dist/server/server-adapter/index.js +1 -1
- package/dist/server/server-adapter/routes/observability.d.ts +129 -0
- package/dist/server/server-adapter/routes/observability.d.ts.map +1 -1
- package/dist/server/server-adapter/routes/system.d.ts +2 -0
- package/dist/server/server-adapter/routes/system.d.ts.map +1 -1
- package/dist/{system-CskEzH1o.cjs → system-Be5n6H_z.cjs} +2 -1
- package/dist/system-Be5n6H_z.cjs.map +1 -0
- package/dist/{system-6qFm79mm.js → system-BtGAJr9R.js} +2 -1
- package/dist/system-BtGAJr9R.js.map +1 -0
- package/package.json +6 -6
- package/dist/observability-new-endpoints-7Zd6uEZf.cjs.map +0 -1
- package/dist/observability-new-endpoints-lNC3o66-.js.map +0 -1
- package/dist/routes-BuiLQCOQ.cjs.map +0 -1
- package/dist/routes-CJygX0-a.js.map +0 -1
- package/dist/system-6qFm79mm.js.map +0 -1
- package/dist/system-CskEzH1o.cjs.map +0 -1
|
@@ -1 +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_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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"}
|
|
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_AGGREGATE_STORAGE_FEATURE = 'trace-aggregate';\nconst OBSERVABILITY_SPAN_QUERY_STORAGE_FEATURE = 'span-query';\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 function supportsSpanQueryCore() {\n return (\n coreStorage.spanQueryRequestSchema !== undefined &&\n coreStorage.spanQueryResponseSchema !== undefined &&\n typeof coreStorage.planSpanQuery === 'function'\n );\n}\n\nexport const OBSERVABILITY_LIST_ENDPOINTS = {\n traces: 'traces',\n branches: 'branches',\n logs: 'logs',\n metrics: 'metrics',\n scores: 'scores',\n feedback: 'feedback',\n} as const;\n\nexport type ObservabilityListEndpoint =\n (typeof OBSERVABILITY_LIST_ENDPOINTS)[keyof typeof OBSERVABILITY_LIST_ENDPOINTS];\nconst OBSERVABILITY_DELTA_POLLING_STORAGE_FEATURE = 'delta-polling';\n\nfunction getFeatures(observabilityStore: ObservabilityStorage): readonly string[] | undefined {\n const candidate = observabilityStore as ObservabilityStorage & {\n getFeatures?: () => readonly string[] | undefined;\n };\n return candidate.getFeatures?.();\n}\n\n/** Retrieves MastraCompositeStore or throws 500 if unavailable. */\nexport function getStorage(mastra: Mastra): MastraCompositeStore {\n const storage = mastra.getStorage();\n if (!storage) {\n throw new HTTPException(500, { message: 'Storage is not available' });\n }\n return storage;\n}\n\n/** Retrieves the observability storage domain or throws 501 if unavailable. */\nexport async function getObservabilityStore(mastra: Mastra): Promise<ObservabilityStorage> {\n const storage = getStorage(mastra);\n const observability = await storage.getStore('observability');\n if (!observability) {\n // 501, not 500: a missing or explicitly disabled observability domain\n // (e.g. `domains: { observability: false }`) is a capability gap, not a\n // server failure — matching the other 501s in this file.\n throw new HTTPException(501, { message: 'Observability storage domain is not available' });\n }\n return observability;\n}\n\n/** Retrieves the scores storage domain or throws 501 if unavailable. */\nexport async function getScoresStore(mastra: Mastra): Promise<ScoresStorage> {\n const storage = getStorage(mastra);\n const scores = await storage.getStore('scores');\n if (!scores) {\n throw new HTTPException(501, { message: 'Scores storage domain is not available' });\n }\n return scores;\n}\n\nexport function assertObservabilityTraceQuerySupported(observabilityStore: ObservabilityStorage) {\n if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_QUERY_STORAGE_FEATURE)) return;\n\n throw new HTTPException(501, {\n message: 'Advanced trace queries are not supported by the configured observability store',\n });\n}\n\nexport function 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\nexport function assertObservabilitySpanQuerySupported(observabilityStore: ObservabilityStorage) {\n if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_SPAN_QUERY_STORAGE_FEATURE)) return;\n\n throw new HTTPException(501, {\n message: 'Span queries are not supported by the configured observability store',\n });\n}\n\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 spanQuery: 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 spanQuery: false,\n feedback: false,\n};\n\n/**\n * Resolves which optional observability APIs the configured store can serve.\n *\n * Feature declarations (`getFeatures()`) are optional. When a store declares\n * a feature list, that list is final. Stores without `getFeatures()` predate\n * declarations: metrics, logs and filter discovery are detected by whether the\n * store implements the underlying method, so those packages report accurately\n * without being upgraded. Delta polling and the trace/thread query APIs depend\n * on runtime behavior a method check can't see, so they are only reported for\n * stores that declare them. Feedback is also declaration-only: Studio hides\n * the feedback UI behind this flag, and store versions that implement feedback\n * without declaring it simply don't advertise it until upgraded.\n */\nexport function getObservabilityStorageCapabilities(\n observabilityStore: ObservabilityStorage,\n): ObservabilityStorageCapabilities {\n const declaredFeatures = getFeatures(observabilityStore);\n const features = declaredFeatures ?? [];\n const newApiCore = coreFeatures.has('observability:v1.13.2');\n const declares = (feature: string) => features.includes(feature);\n // Undeclared stores must implement every method behind the feature.\n const supports = (feature: string, methods: readonly string[]) => {\n if (!newApiCore) return false;\n if (!declaredFeatures) {\n return methods.every(method => implementsObservabilityStorageMethod(observabilityStore, method));\n }\n return declares(feature);\n };\n // Stores released before the per-endpoint discovery features existed declare\n // `trace-query` and implement every discovery method, so treat it as implying discovery.\n const supportsDiscovery = (feature: string, methods: readonly string[]) =>\n supports(feature, methods) || (newApiCore && declares(OBSERVABILITY_TRACE_QUERY_STORAGE_FEATURE));\n const traceQuery =\n newApiCore &&\n typeof coreStorage.planTraceQuery === 'function' &&\n declares(OBSERVABILITY_TRACE_QUERY_STORAGE_FEATURE);\n const threadQuery =\n newApiCore &&\n typeof coreStorage.planThreadQuery === 'function' &&\n declares(OBSERVABILITY_THREAD_QUERY_STORAGE_FEATURE);\n\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 spanQuery: newApiCore && supportsSpanQueryCore() && declares(OBSERVABILITY_SPAN_QUERY_STORAGE_FEATURE),\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 QUERY_SPANS: {\n method: 'POST',\n path: '/observability/spans/query',\n summary: 'Query spans',\n description: 'Returns completed spans matching a span predicate, one row per span, with cursor pagination',\n requiresPermission: 'observability:read',\n },\n\n GET_TRACE_QUERY_FIELDS: {\n method: 'POST',\n path: '/observability/traces/query/fields',\n summary: 'Discover trace query fields',\n description: 'Returns canonical query fields and observed top-level string metadata fields',\n requiresPermission: 'observability:read',\n },\n\n GET_TRACE_QUERY_VALUES: {\n method: 'POST',\n path: '/observability/traces/query/values',\n summary: 'Discover trace query values',\n description: 'Returns bounded string value suggestions and occurrence counts for one eligible query field',\n requiresPermission: 'observability:read',\n },\n\n LIST_METRICS: {\n method: 'GET',\n path: '/observability/metrics',\n summary: 'List metrics',\n description: 'Returns a paginated list of metrics with optional filtering and sorting',\n },\n\n LIST_LOGS: {\n method: 'GET',\n path: '/observability/logs',\n summary: 'List logs',\n description: 'Returns a paginated list of logs with optional filtering and sorting',\n },\n\n LIST_SCORES: {\n method: 'GET',\n path: '/observability/scores',\n summary: 'List scores',\n description: 'Returns a paginated list of scores with optional filtering and sorting',\n },\n\n CREATE_SCORE: {\n method: 'POST',\n path: '/observability/scores',\n summary: 'Create a score',\n description: 'Creates a single score record in the observability store',\n },\n\n DELETE_SCORES: {\n method: 'DELETE',\n path: '/observability/scores',\n summary: 'Delete scores',\n description: 'Deletes score records by scoreId, optionally scoped to a tenant',\n requiresPermission: 'observability:delete',\n },\n\n GET_SCORE: {\n method: 'GET',\n path: '/observability/scores/:scoreId',\n summary: 'Get score',\n description: 'Returns a single score by scoreId',\n },\n\n GET_SCORE_AGGREGATE: {\n method: 'POST',\n path: '/observability/scores/aggregate',\n summary: 'Get score aggregate',\n description: 'Returns an aggregated score value with optional period-over-period comparison',\n requiresPermission: 'observability:read',\n },\n\n GET_SCORE_BREAKDOWN: {\n method: 'POST',\n path: '/observability/scores/breakdown',\n summary: 'Get score breakdown',\n description: 'Returns score values grouped by specified dimensions',\n requiresPermission: 'observability:read',\n },\n\n GET_SCORE_TIME_SERIES: {\n method: 'POST',\n path: '/observability/scores/timeseries',\n summary: 'Get score time series',\n description: 'Returns score values bucketed by time interval with optional grouping',\n requiresPermission: 'observability:read',\n },\n\n GET_SCORE_PERCENTILES: {\n method: 'POST',\n path: '/observability/scores/percentiles',\n summary: 'Get score percentiles',\n description: 'Returns percentile values for a score bucketed by time interval',\n requiresPermission: 'observability:read',\n },\n\n LIST_FEEDBACK: {\n method: 'GET',\n path: '/observability/feedback',\n summary: 'List feedback',\n description: 'Returns a paginated list of feedback with optional filtering and sorting',\n },\n\n CREATE_FEEDBACK: {\n method: 'POST',\n path: '/observability/feedback',\n summary: 'Create feedback',\n description: 'Creates a single feedback record in the observability store',\n },\n\n DELETE_FEEDBACK: {\n method: 'DELETE',\n path: '/observability/feedback',\n summary: 'Delete feedback',\n description: 'Deletes feedback records by feedbackId, optionally scoped to a tenant',\n requiresPermission: 'observability:delete',\n },\n\n UPDATE_FEEDBACK_REVIEW_STATUS: {\n method: 'PATCH',\n path: '/observability/feedback/:feedbackId/review-status',\n summary: 'Update feedback review status',\n description: \"Updates a feedback record's review workflow status\",\n requiresPermission: 'observability:write',\n },\n\n GET_FEEDBACK_AGGREGATE: {\n method: 'POST',\n path: '/observability/feedback/aggregate',\n summary: 'Get feedback aggregate',\n description: 'Returns an aggregated numeric feedback value with optional period-over-period comparison',\n requiresPermission: 'observability:read',\n },\n\n GET_FEEDBACK_BREAKDOWN: {\n method: 'POST',\n path: '/observability/feedback/breakdown',\n summary: 'Get feedback breakdown',\n description: 'Returns numeric feedback values grouped by specified dimensions',\n requiresPermission: 'observability:read',\n },\n\n GET_FEEDBACK_TIME_SERIES: {\n method: 'POST',\n path: '/observability/feedback/timeseries',\n summary: 'Get feedback time series',\n description: 'Returns numeric feedback values bucketed by time interval with optional grouping',\n requiresPermission: 'observability:read',\n },\n\n GET_FEEDBACK_PERCENTILES: {\n method: 'POST',\n path: '/observability/feedback/percentiles',\n summary: 'Get feedback percentiles',\n description: 'Returns percentile values for numeric feedback bucketed by time interval',\n requiresPermission: 'observability:read',\n },\n\n GET_METRIC_AGGREGATE: {\n method: 'POST',\n path: '/observability/metrics/aggregate',\n summary: 'Get metric aggregate',\n description: 'Returns an aggregated metric value with optional period-over-period comparison',\n requiresPermission: 'observability:read',\n },\n\n GET_METRIC_BREAKDOWN: {\n method: 'POST',\n path: '/observability/metrics/breakdown',\n summary: 'Get metric breakdown',\n description: 'Returns metric values grouped by specified dimensions',\n requiresPermission: 'observability:read',\n },\n\n GET_METRIC_TIME_SERIES: {\n method: 'POST',\n path: '/observability/metrics/timeseries',\n summary: 'Get metric time series',\n description: 'Returns metric values bucketed by time interval with optional grouping',\n requiresPermission: 'observability:read',\n },\n\n GET_METRIC_PERCENTILES: {\n method: 'POST',\n path: '/observability/metrics/percentiles',\n summary: 'Get metric percentiles',\n description: 'Returns percentile values for a metric bucketed by time interval',\n requiresPermission: 'observability:read',\n },\n\n GET_METRIC_NAMES: {\n method: 'GET',\n path: '/observability/discovery/metric-names',\n summary: 'Get metric names',\n description: 'Returns distinct metric names with optional prefix filtering',\n },\n\n GET_METRIC_LABEL_KEYS: {\n method: 'GET',\n path: '/observability/discovery/metric-label-keys',\n summary: 'Get metric label keys',\n description: 'Returns distinct label keys for a given metric',\n },\n\n GET_METRIC_LABEL_VALUES: {\n method: 'GET',\n path: '/observability/discovery/metric-label-values',\n summary: 'Get label values',\n description: 'Returns distinct values for a given metric label key',\n },\n\n GET_ENTITY_TYPES: {\n method: 'GET',\n path: '/observability/discovery/entity-types',\n summary: 'Get entity types',\n description: 'Returns distinct entity types from observability data',\n },\n\n GET_ENTITY_NAMES: {\n method: 'GET',\n path: '/observability/discovery/entity-names',\n summary: 'Get entity names',\n description: 'Returns distinct entity names with optional type filtering',\n },\n\n GET_SERVICE_NAMES: {\n method: 'GET',\n path: '/observability/discovery/service-names',\n summary: 'Get service names',\n description: 'Returns distinct service names from observability data',\n },\n\n GET_ENVIRONMENTS: {\n method: 'GET',\n path: '/observability/discovery/environments',\n summary: 'Get environments',\n description: 'Returns distinct environments from observability data',\n },\n\n GET_TAGS: {\n method: 'GET',\n path: '/observability/discovery/tags',\n summary: 'Get tags',\n description: 'Returns distinct tags with optional entity type filtering',\n },\n\n GET_CAPABILITIES: {\n method: 'GET',\n path: '/observability/capabilities',\n summary: 'Get observability capabilities',\n description:\n 'Returns which optional observability APIs the configured observability storage supports. Every flag is false when no observability storage is configured.',\n },\n} as const satisfies Record<string, RouteDetails>;\n\nexport type NewRoutesKey = keyof typeof NEW_ROUTE_DEFS;\nexport type NewRoutesDefinitions = (typeof NEW_ROUTE_DEFS)[NewRoutesKey];\n\nexport function createObservabilityListQuerySchema<\n TFilter extends z.ZodObject<z.ZodRawShape>,\n TOrderBy extends z.ZodObject<z.ZodRawShape>,\n>(filterSchema: TFilter, orderBySchema: TOrderBy) {\n const unwrapDefault = (schema: unknown) => {\n const zodSchema = schema as z.ZodTypeAny;\n return zodSchema instanceof z.ZodDefault ? zodSchema.unwrap() : zodSchema;\n };\n const paginationShape = paginationArgsSchema.shape as unknown as Record<string, z.ZodTypeAny>;\n const orderByShape = orderBySchema.shape as unknown as Record<string, z.ZodTypeAny>;\n\n const pageSchema = unwrapDefault(paginationShape.page);\n const perPageSchema = unwrapDefault(paginationShape.perPage);\n const fieldSchema = orderByShape.field ? unwrapDefault(orderByShape.field) : z.never().optional();\n const directionSchema = orderByShape.direction ? unwrapDefault(orderByShape.direction) : z.never().optional();\n\n return wrapSchemaForQueryParams(\n z\n .object({\n ...filterSchema.shape,\n page: pageSchema,\n perPage: perPageSchema,\n field: fieldSchema,\n direction: directionSchema,\n mode: listModeSchema.optional(),\n after: deltaCursorSchema.optional(),\n limit: deltaLimitSchema,\n })\n .partial(),\n ).superRefine((value, ctx) => {\n const isDelta = value.mode === 'delta';\n const hasPagination = value.page !== undefined || value.perPage !== undefined;\n const hasOrderBy = value.field !== undefined || value.direction !== undefined;\n const hasAfter = value.after !== undefined;\n const hasLimit = value.limit !== undefined;\n\n if (isDelta) {\n if (hasPagination) {\n if (value.page !== undefined) {\n ctx.addIssue({\n code: z.ZodIssueCode.custom,\n path: ['page'],\n message: '`page` is not allowed when `mode=delta`',\n });\n }\n if (value.perPage !== undefined) {\n ctx.addIssue({\n code: z.ZodIssueCode.custom,\n path: ['perPage'],\n message: '`perPage` is not allowed when `mode=delta`',\n });\n }\n }\n if (hasOrderBy) {\n if (value.field !== undefined) {\n ctx.addIssue({\n code: z.ZodIssueCode.custom,\n path: ['field'],\n message: '`field` is not allowed when `mode=delta`',\n });\n }\n if (value.direction !== undefined) {\n ctx.addIssue({\n code: z.ZodIssueCode.custom,\n path: ['direction'],\n message: '`direction` is not allowed when `mode=delta`',\n });\n }\n }\n return;\n }\n\n if (hasAfter) {\n ctx.addIssue({\n code: z.ZodIssueCode.custom,\n path: ['after'],\n message: '`after` is only allowed when `mode=delta`',\n });\n }\n if (hasLimit) {\n ctx.addIssue({\n code: z.ZodIssueCode.custom,\n path: ['limit'],\n message: '`limit` is only allowed when `mode=delta`',\n });\n }\n });\n}\n"],"mappings":"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"}
|
|
@@ -9,6 +9,7 @@ export declare const OBSERVABILITY_TRACE_QUERY_TENANT_SCOPE_CORE_FEATURE = "obse
|
|
|
9
9
|
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.";
|
|
10
10
|
export declare function supportsTraceQueryDiscoveryCore(): boolean;
|
|
11
11
|
export declare function supportsTraceAggregateCore(): boolean;
|
|
12
|
+
export declare function supportsSpanQueryCore(): boolean;
|
|
12
13
|
export declare const OBSERVABILITY_LIST_ENDPOINTS: {
|
|
13
14
|
readonly traces: 'traces';
|
|
14
15
|
readonly branches: 'branches';
|
|
@@ -26,6 +27,7 @@ export declare function getObservabilityStore(mastra: Mastra): Promise<Observabi
|
|
|
26
27
|
export declare function getScoresStore(mastra: Mastra): Promise<ScoresStorage>;
|
|
27
28
|
export declare function assertObservabilityTraceQuerySupported(observabilityStore: ObservabilityStorage): void;
|
|
28
29
|
export declare function assertObservabilityTraceAggregateSupported(observabilityStore: ObservabilityStorage): void;
|
|
30
|
+
export declare function assertObservabilitySpanQuerySupported(observabilityStore: ObservabilityStorage): void;
|
|
29
31
|
export declare function supportsObservabilityTraceQueryRootDuration(observabilityStore: ObservabilityStorage): boolean;
|
|
30
32
|
export declare function assertObservabilityTraceQueryRootDurationSupported(observabilityStore: ObservabilityStorage, predicate: TrustedTraceQueryPredicate | TrustedThreadPredicate | undefined): void;
|
|
31
33
|
export declare function supportsObservabilityTraceQueryContextIds(observabilityStore: ObservabilityStorage): boolean;
|
|
@@ -58,6 +60,7 @@ export type ObservabilityStorageCapabilities = {
|
|
|
58
60
|
traceQueryDiscovery: boolean;
|
|
59
61
|
traceQueryTenantScope: boolean;
|
|
60
62
|
threadQuery: boolean;
|
|
63
|
+
spanQuery: boolean;
|
|
61
64
|
feedback: boolean;
|
|
62
65
|
};
|
|
63
66
|
export declare const NO_OBSERVABILITY_STORAGE_CAPABILITIES: ObservabilityStorageCapabilities;
|
|
@@ -113,6 +116,13 @@ export declare const NEW_ROUTE_DEFS: {
|
|
|
113
116
|
readonly description: 'Returns thread identities matching eligible trace and cross-trace predicates';
|
|
114
117
|
readonly requiresPermission: 'observability:read';
|
|
115
118
|
};
|
|
119
|
+
readonly QUERY_SPANS: {
|
|
120
|
+
readonly method: 'POST';
|
|
121
|
+
readonly path: '/observability/spans/query';
|
|
122
|
+
readonly summary: 'Query spans';
|
|
123
|
+
readonly description: 'Returns completed spans matching a span predicate, one row per span, with cursor pagination';
|
|
124
|
+
readonly requiresPermission: 'observability:read';
|
|
125
|
+
};
|
|
116
126
|
readonly GET_TRACE_QUERY_FIELDS: {
|
|
117
127
|
readonly method: 'POST';
|
|
118
128
|
readonly path: '/observability/traces/query/fields';
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"observability-shared.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/observability-shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,0BAA0B,EAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,WAAW,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAS5D,eAAO,MAAM,mCAAmC,gCAAgC,CAAC;AACjF,eAAO,MAAM,2CAA2C,0GACiD,CAAC;
|
|
1
|
+
{"version":3,"file":"observability-shared.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/observability-shared.ts"],"names":[],"mappings":"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"}
|
|
@@ -9,6 +9,7 @@ const OBSERVABILITY_DELTA_POLLING_FEATURE = "observability-delta-polling";
|
|
|
9
9
|
const OBSERVABILITY_DELTA_POLLING_UPGRADE_MESSAGE = "Delta polling requires a newer @mastra/core with observability delta polling support. Please upgrade.";
|
|
10
10
|
const OBSERVABILITY_TRACE_QUERY_STORAGE_FEATURE = "trace-query";
|
|
11
11
|
const OBSERVABILITY_TRACE_AGGREGATE_STORAGE_FEATURE = "trace-aggregate";
|
|
12
|
+
const OBSERVABILITY_SPAN_QUERY_STORAGE_FEATURE = "span-query";
|
|
12
13
|
const OBSERVABILITY_TRACE_QUERY_ROOT_DURATION_STORAGE_FEATURE = "trace-query-root-duration";
|
|
13
14
|
const OBSERVABILITY_TRACE_QUERY_CONTEXT_IDS_STORAGE_FEATURE = "trace-query-context-ids";
|
|
14
15
|
const TRACE_QUERY_CONTEXT_ID_FIELDS = /* @__PURE__ */ new Set([
|
|
@@ -29,6 +30,9 @@ function supportsTraceQueryDiscoveryCore() {
|
|
|
29
30
|
function supportsTraceAggregateCore() {
|
|
30
31
|
return coreStorage.traceAggregateRequestSchema !== void 0 && coreStorage.traceAggregateResponseSchema !== void 0 && typeof coreStorage.planTraceAggregate === "function";
|
|
31
32
|
}
|
|
33
|
+
function supportsSpanQueryCore() {
|
|
34
|
+
return coreStorage.spanQueryRequestSchema !== void 0 && coreStorage.spanQueryResponseSchema !== void 0 && typeof coreStorage.planSpanQuery === "function";
|
|
35
|
+
}
|
|
32
36
|
const OBSERVABILITY_LIST_ENDPOINTS = {
|
|
33
37
|
traces: "traces",
|
|
34
38
|
branches: "branches",
|
|
@@ -67,6 +71,10 @@ function assertObservabilityTraceAggregateSupported(observabilityStore) {
|
|
|
67
71
|
if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_AGGREGATE_STORAGE_FEATURE)) return;
|
|
68
72
|
throw new HTTPException(501, { message: "Trace aggregation is not supported by the configured observability store" });
|
|
69
73
|
}
|
|
74
|
+
function assertObservabilitySpanQuerySupported(observabilityStore) {
|
|
75
|
+
if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_SPAN_QUERY_STORAGE_FEATURE)) return;
|
|
76
|
+
throw new HTTPException(501, { message: "Span queries are not supported by the configured observability store" });
|
|
77
|
+
}
|
|
70
78
|
function usesRootDuration(predicate) {
|
|
71
79
|
if (!predicate) return false;
|
|
72
80
|
if (predicate.type === "boolean") return predicate.args.some(usesRootDuration);
|
|
@@ -152,6 +160,7 @@ const NO_OBSERVABILITY_STORAGE_CAPABILITIES = {
|
|
|
152
160
|
traceQueryDiscovery: false,
|
|
153
161
|
traceQueryTenantScope: false,
|
|
154
162
|
threadQuery: false,
|
|
163
|
+
spanQuery: false,
|
|
155
164
|
feedback: false
|
|
156
165
|
};
|
|
157
166
|
/**
|
|
@@ -207,6 +216,7 @@ function getObservabilityStorageCapabilities(observabilityStore) {
|
|
|
207
216
|
traceQueryDiscovery: newApiCore && supportsTraceQueryDiscoveryCore() && declares(OBSERVABILITY_TRACE_QUERY_DISCOVERY_STORAGE_FEATURE),
|
|
208
217
|
traceQueryTenantScope: (traceQuery || threadQuery) && coreFeatures.has("observability-trace-query-tenant-scope") && declares(OBSERVABILITY_TRACE_QUERY_TENANT_SCOPE_STORAGE_FEATURE),
|
|
209
218
|
threadQuery,
|
|
219
|
+
spanQuery: newApiCore && supportsSpanQueryCore() && declares(OBSERVABILITY_SPAN_QUERY_STORAGE_FEATURE),
|
|
210
220
|
feedback: newApiCore && declares(OBSERVABILITY_FEEDBACK_STORAGE_FEATURE)
|
|
211
221
|
};
|
|
212
222
|
}
|
|
@@ -262,6 +272,13 @@ const NEW_ROUTE_DEFS = {
|
|
|
262
272
|
description: "Returns thread identities matching eligible trace and cross-trace predicates",
|
|
263
273
|
requiresPermission: "observability:read"
|
|
264
274
|
},
|
|
275
|
+
QUERY_SPANS: {
|
|
276
|
+
method: "POST",
|
|
277
|
+
path: "/observability/spans/query",
|
|
278
|
+
summary: "Query spans",
|
|
279
|
+
description: "Returns completed spans matching a span predicate, one row per span, with cursor pagination",
|
|
280
|
+
requiresPermission: "observability:read"
|
|
281
|
+
},
|
|
265
282
|
GET_TRACE_QUERY_FIELDS: {
|
|
266
283
|
method: "POST",
|
|
267
284
|
path: "/observability/traces/query/fields",
|
|
@@ -544,6 +561,6 @@ function createObservabilityListQuerySchema(filterSchema, orderBySchema) {
|
|
|
544
561
|
});
|
|
545
562
|
}
|
|
546
563
|
//#endregion
|
|
547
|
-
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 };
|
|
564
|
+
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, assertObservabilitySpanQuerySupported, assertObservabilityThreadQuerySupported, assertObservabilityTraceAggregateSupported, assertObservabilityTraceQueryContextIdsSupported, assertObservabilityTraceQueryDiscoverySupported, assertObservabilityTraceQueryRootDurationSupported, assertObservabilityTraceQuerySupported, assertObservabilityTraceQueryTenantScopeSupported, createObservabilityListQuerySchema, getObservabilityStorageCapabilities, getObservabilityStore, getScoresStore, getStorage, isTraceQueryContextIdField, supportsObservabilityTraceQueryContextIds, supportsObservabilityTraceQueryRootDuration, supportsSpanQueryCore, supportsTraceAggregateCore, supportsTraceQueryDiscoveryCore, withDiscoveryFallback };
|
|
548
565
|
|
|
549
566
|
//# sourceMappingURL=observability-shared.js.map
|
|
@@ -1 +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_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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"}
|
|
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_AGGREGATE_STORAGE_FEATURE = 'trace-aggregate';\nconst OBSERVABILITY_SPAN_QUERY_STORAGE_FEATURE = 'span-query';\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 function supportsSpanQueryCore() {\n return (\n coreStorage.spanQueryRequestSchema !== undefined &&\n coreStorage.spanQueryResponseSchema !== undefined &&\n typeof coreStorage.planSpanQuery === 'function'\n );\n}\n\nexport const OBSERVABILITY_LIST_ENDPOINTS = {\n traces: 'traces',\n branches: 'branches',\n logs: 'logs',\n metrics: 'metrics',\n scores: 'scores',\n feedback: 'feedback',\n} as const;\n\nexport type ObservabilityListEndpoint =\n (typeof OBSERVABILITY_LIST_ENDPOINTS)[keyof typeof OBSERVABILITY_LIST_ENDPOINTS];\nconst OBSERVABILITY_DELTA_POLLING_STORAGE_FEATURE = 'delta-polling';\n\nfunction getFeatures(observabilityStore: ObservabilityStorage): readonly string[] | undefined {\n const candidate = observabilityStore as ObservabilityStorage & {\n getFeatures?: () => readonly string[] | undefined;\n };\n return candidate.getFeatures?.();\n}\n\n/** Retrieves MastraCompositeStore or throws 500 if unavailable. */\nexport function getStorage(mastra: Mastra): MastraCompositeStore {\n const storage = mastra.getStorage();\n if (!storage) {\n throw new HTTPException(500, { message: 'Storage is not available' });\n }\n return storage;\n}\n\n/** Retrieves the observability storage domain or throws 501 if unavailable. */\nexport async function getObservabilityStore(mastra: Mastra): Promise<ObservabilityStorage> {\n const storage = getStorage(mastra);\n const observability = await storage.getStore('observability');\n if (!observability) {\n // 501, not 500: a missing or explicitly disabled observability domain\n // (e.g. `domains: { observability: false }`) is a capability gap, not a\n // server failure — matching the other 501s in this file.\n throw new HTTPException(501, { message: 'Observability storage domain is not available' });\n }\n return observability;\n}\n\n/** Retrieves the scores storage domain or throws 501 if unavailable. */\nexport async function getScoresStore(mastra: Mastra): Promise<ScoresStorage> {\n const storage = getStorage(mastra);\n const scores = await storage.getStore('scores');\n if (!scores) {\n throw new HTTPException(501, { message: 'Scores storage domain is not available' });\n }\n return scores;\n}\n\nexport function assertObservabilityTraceQuerySupported(observabilityStore: ObservabilityStorage) {\n if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_TRACE_QUERY_STORAGE_FEATURE)) return;\n\n throw new HTTPException(501, {\n message: 'Advanced trace queries are not supported by the configured observability store',\n });\n}\n\nexport function 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\nexport function assertObservabilitySpanQuerySupported(observabilityStore: ObservabilityStorage) {\n if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_SPAN_QUERY_STORAGE_FEATURE)) return;\n\n throw new HTTPException(501, {\n message: 'Span queries are not supported by the configured observability store',\n });\n}\n\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 spanQuery: 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 spanQuery: false,\n feedback: false,\n};\n\n/**\n * Resolves which optional observability APIs the configured store can serve.\n *\n * Feature declarations (`getFeatures()`) are optional. When a store declares\n * a feature list, that list is final. Stores without `getFeatures()` predate\n * declarations: metrics, logs and filter discovery are detected by whether the\n * store implements the underlying method, so those packages report accurately\n * without being upgraded. Delta polling and the trace/thread query APIs depend\n * on runtime behavior a method check can't see, so they are only reported for\n * stores that declare them. Feedback is also declaration-only: Studio hides\n * the feedback UI behind this flag, and store versions that implement feedback\n * without declaring it simply don't advertise it until upgraded.\n */\nexport function getObservabilityStorageCapabilities(\n observabilityStore: ObservabilityStorage,\n): ObservabilityStorageCapabilities {\n const declaredFeatures = getFeatures(observabilityStore);\n const features = declaredFeatures ?? [];\n const newApiCore = coreFeatures.has('observability:v1.13.2');\n const declares = (feature: string) => features.includes(feature);\n // Undeclared stores must implement every method behind the feature.\n const supports = (feature: string, methods: readonly string[]) => {\n if (!newApiCore) return false;\n if (!declaredFeatures) {\n return methods.every(method => implementsObservabilityStorageMethod(observabilityStore, method));\n }\n return declares(feature);\n };\n // Stores released before the per-endpoint discovery features existed declare\n // `trace-query` and implement every discovery method, so treat it as implying discovery.\n const supportsDiscovery = (feature: string, methods: readonly string[]) =>\n supports(feature, methods) || (newApiCore && declares(OBSERVABILITY_TRACE_QUERY_STORAGE_FEATURE));\n const traceQuery =\n newApiCore &&\n typeof coreStorage.planTraceQuery === 'function' &&\n declares(OBSERVABILITY_TRACE_QUERY_STORAGE_FEATURE);\n const threadQuery =\n newApiCore &&\n typeof coreStorage.planThreadQuery === 'function' &&\n declares(OBSERVABILITY_THREAD_QUERY_STORAGE_FEATURE);\n\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 spanQuery: newApiCore && supportsSpanQueryCore() && declares(OBSERVABILITY_SPAN_QUERY_STORAGE_FEATURE),\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 QUERY_SPANS: {\n method: 'POST',\n path: '/observability/spans/query',\n summary: 'Query spans',\n description: 'Returns completed spans matching a span predicate, one row per span, with cursor pagination',\n requiresPermission: 'observability:read',\n },\n\n GET_TRACE_QUERY_FIELDS: {\n method: 'POST',\n path: '/observability/traces/query/fields',\n summary: 'Discover trace query fields',\n description: 'Returns canonical query fields and observed top-level string metadata fields',\n requiresPermission: 'observability:read',\n },\n\n GET_TRACE_QUERY_VALUES: {\n method: 'POST',\n path: '/observability/traces/query/values',\n summary: 'Discover trace query values',\n description: 'Returns bounded string value suggestions and occurrence counts for one eligible query field',\n requiresPermission: 'observability:read',\n },\n\n LIST_METRICS: {\n method: 'GET',\n path: '/observability/metrics',\n summary: 'List metrics',\n description: 'Returns a paginated list of metrics with optional filtering and sorting',\n },\n\n LIST_LOGS: {\n method: 'GET',\n path: '/observability/logs',\n summary: 'List logs',\n description: 'Returns a paginated list of logs with optional filtering and sorting',\n },\n\n LIST_SCORES: {\n method: 'GET',\n path: '/observability/scores',\n summary: 'List scores',\n description: 'Returns a paginated list of scores with optional filtering and sorting',\n },\n\n CREATE_SCORE: {\n method: 'POST',\n path: '/observability/scores',\n summary: 'Create a score',\n description: 'Creates a single score record in the observability store',\n },\n\n DELETE_SCORES: {\n method: 'DELETE',\n path: '/observability/scores',\n summary: 'Delete scores',\n description: 'Deletes score records by scoreId, optionally scoped to a tenant',\n requiresPermission: 'observability:delete',\n },\n\n GET_SCORE: {\n method: 'GET',\n path: '/observability/scores/:scoreId',\n summary: 'Get score',\n description: 'Returns a single score by scoreId',\n },\n\n GET_SCORE_AGGREGATE: {\n method: 'POST',\n path: '/observability/scores/aggregate',\n summary: 'Get score aggregate',\n description: 'Returns an aggregated score value with optional period-over-period comparison',\n requiresPermission: 'observability:read',\n },\n\n GET_SCORE_BREAKDOWN: {\n method: 'POST',\n path: '/observability/scores/breakdown',\n summary: 'Get score breakdown',\n description: 'Returns score values grouped by specified dimensions',\n requiresPermission: 'observability:read',\n },\n\n GET_SCORE_TIME_SERIES: {\n method: 'POST',\n path: '/observability/scores/timeseries',\n summary: 'Get score time series',\n description: 'Returns score values bucketed by time interval with optional grouping',\n requiresPermission: 'observability:read',\n },\n\n GET_SCORE_PERCENTILES: {\n method: 'POST',\n path: '/observability/scores/percentiles',\n summary: 'Get score percentiles',\n description: 'Returns percentile values for a score bucketed by time interval',\n requiresPermission: 'observability:read',\n },\n\n LIST_FEEDBACK: {\n method: 'GET',\n path: '/observability/feedback',\n summary: 'List feedback',\n description: 'Returns a paginated list of feedback with optional filtering and sorting',\n },\n\n CREATE_FEEDBACK: {\n method: 'POST',\n path: '/observability/feedback',\n summary: 'Create feedback',\n description: 'Creates a single feedback record in the observability store',\n },\n\n DELETE_FEEDBACK: {\n method: 'DELETE',\n path: '/observability/feedback',\n summary: 'Delete feedback',\n description: 'Deletes feedback records by feedbackId, optionally scoped to a tenant',\n requiresPermission: 'observability:delete',\n },\n\n UPDATE_FEEDBACK_REVIEW_STATUS: {\n method: 'PATCH',\n path: '/observability/feedback/:feedbackId/review-status',\n summary: 'Update feedback review status',\n description: \"Updates a feedback record's review workflow status\",\n requiresPermission: 'observability:write',\n },\n\n GET_FEEDBACK_AGGREGATE: {\n method: 'POST',\n path: '/observability/feedback/aggregate',\n summary: 'Get feedback aggregate',\n description: 'Returns an aggregated numeric feedback value with optional period-over-period comparison',\n requiresPermission: 'observability:read',\n },\n\n GET_FEEDBACK_BREAKDOWN: {\n method: 'POST',\n path: '/observability/feedback/breakdown',\n summary: 'Get feedback breakdown',\n description: 'Returns numeric feedback values grouped by specified dimensions',\n requiresPermission: 'observability:read',\n },\n\n GET_FEEDBACK_TIME_SERIES: {\n method: 'POST',\n path: '/observability/feedback/timeseries',\n summary: 'Get feedback time series',\n description: 'Returns numeric feedback values bucketed by time interval with optional grouping',\n requiresPermission: 'observability:read',\n },\n\n GET_FEEDBACK_PERCENTILES: {\n method: 'POST',\n path: '/observability/feedback/percentiles',\n summary: 'Get feedback percentiles',\n description: 'Returns percentile values for numeric feedback bucketed by time interval',\n requiresPermission: 'observability:read',\n },\n\n GET_METRIC_AGGREGATE: {\n method: 'POST',\n path: '/observability/metrics/aggregate',\n summary: 'Get metric aggregate',\n description: 'Returns an aggregated metric value with optional period-over-period comparison',\n requiresPermission: 'observability:read',\n },\n\n GET_METRIC_BREAKDOWN: {\n method: 'POST',\n path: '/observability/metrics/breakdown',\n summary: 'Get metric breakdown',\n description: 'Returns metric values grouped by specified dimensions',\n requiresPermission: 'observability:read',\n },\n\n GET_METRIC_TIME_SERIES: {\n method: 'POST',\n path: '/observability/metrics/timeseries',\n summary: 'Get metric time series',\n description: 'Returns metric values bucketed by time interval with optional grouping',\n requiresPermission: 'observability:read',\n },\n\n GET_METRIC_PERCENTILES: {\n method: 'POST',\n path: '/observability/metrics/percentiles',\n summary: 'Get metric percentiles',\n description: 'Returns percentile values for a metric bucketed by time interval',\n requiresPermission: 'observability:read',\n },\n\n GET_METRIC_NAMES: {\n method: 'GET',\n path: '/observability/discovery/metric-names',\n summary: 'Get metric names',\n description: 'Returns distinct metric names with optional prefix filtering',\n },\n\n GET_METRIC_LABEL_KEYS: {\n method: 'GET',\n path: '/observability/discovery/metric-label-keys',\n summary: 'Get metric label keys',\n description: 'Returns distinct label keys for a given metric',\n },\n\n GET_METRIC_LABEL_VALUES: {\n method: 'GET',\n path: '/observability/discovery/metric-label-values',\n summary: 'Get label values',\n description: 'Returns distinct values for a given metric label key',\n },\n\n GET_ENTITY_TYPES: {\n method: 'GET',\n path: '/observability/discovery/entity-types',\n summary: 'Get entity types',\n description: 'Returns distinct entity types from observability data',\n },\n\n GET_ENTITY_NAMES: {\n method: 'GET',\n path: '/observability/discovery/entity-names',\n summary: 'Get entity names',\n description: 'Returns distinct entity names with optional type filtering',\n },\n\n GET_SERVICE_NAMES: {\n method: 'GET',\n path: '/observability/discovery/service-names',\n summary: 'Get service names',\n description: 'Returns distinct service names from observability data',\n },\n\n GET_ENVIRONMENTS: {\n method: 'GET',\n path: '/observability/discovery/environments',\n summary: 'Get environments',\n description: 'Returns distinct environments from observability data',\n },\n\n GET_TAGS: {\n method: 'GET',\n path: '/observability/discovery/tags',\n summary: 'Get tags',\n description: 'Returns distinct tags with optional entity type filtering',\n },\n\n GET_CAPABILITIES: {\n method: 'GET',\n path: '/observability/capabilities',\n summary: 'Get observability capabilities',\n description:\n 'Returns which optional observability APIs the configured observability storage supports. Every flag is false when no observability storage is configured.',\n },\n} as const satisfies Record<string, RouteDetails>;\n\nexport type NewRoutesKey = keyof typeof NEW_ROUTE_DEFS;\nexport type NewRoutesDefinitions = (typeof NEW_ROUTE_DEFS)[NewRoutesKey];\n\nexport function createObservabilityListQuerySchema<\n TFilter extends z.ZodObject<z.ZodRawShape>,\n TOrderBy extends z.ZodObject<z.ZodRawShape>,\n>(filterSchema: TFilter, orderBySchema: TOrderBy) {\n const unwrapDefault = (schema: unknown) => {\n const zodSchema = schema as z.ZodTypeAny;\n return zodSchema instanceof z.ZodDefault ? zodSchema.unwrap() : zodSchema;\n };\n const paginationShape = paginationArgsSchema.shape as unknown as Record<string, z.ZodTypeAny>;\n const orderByShape = orderBySchema.shape as unknown as Record<string, z.ZodTypeAny>;\n\n const pageSchema = unwrapDefault(paginationShape.page);\n const perPageSchema = unwrapDefault(paginationShape.perPage);\n const fieldSchema = orderByShape.field ? unwrapDefault(orderByShape.field) : z.never().optional();\n const directionSchema = orderByShape.direction ? unwrapDefault(orderByShape.direction) : z.never().optional();\n\n return wrapSchemaForQueryParams(\n z\n .object({\n ...filterSchema.shape,\n page: pageSchema,\n perPage: perPageSchema,\n field: fieldSchema,\n direction: directionSchema,\n mode: listModeSchema.optional(),\n after: deltaCursorSchema.optional(),\n limit: deltaLimitSchema,\n })\n .partial(),\n ).superRefine((value, ctx) => {\n const isDelta = value.mode === 'delta';\n const hasPagination = value.page !== undefined || value.perPage !== undefined;\n const hasOrderBy = value.field !== undefined || value.direction !== undefined;\n const hasAfter = value.after !== undefined;\n const hasLimit = value.limit !== undefined;\n\n if (isDelta) {\n if (hasPagination) {\n if (value.page !== undefined) {\n ctx.addIssue({\n code: z.ZodIssueCode.custom,\n path: ['page'],\n message: '`page` is not allowed when `mode=delta`',\n });\n }\n if (value.perPage !== undefined) {\n ctx.addIssue({\n code: z.ZodIssueCode.custom,\n path: ['perPage'],\n message: '`perPage` is not allowed when `mode=delta`',\n });\n }\n }\n if (hasOrderBy) {\n if (value.field !== undefined) {\n ctx.addIssue({\n code: z.ZodIssueCode.custom,\n path: ['field'],\n message: '`field` is not allowed when `mode=delta`',\n });\n }\n if (value.direction !== undefined) {\n ctx.addIssue({\n code: z.ZodIssueCode.custom,\n path: ['direction'],\n message: '`direction` is not allowed when `mode=delta`',\n });\n }\n }\n return;\n }\n\n if (hasAfter) {\n ctx.addIssue({\n code: z.ZodIssueCode.custom,\n path: ['after'],\n message: '`after` is only allowed when `mode=delta`',\n });\n }\n if (hasLimit) {\n ctx.addIssue({\n code: z.ZodIssueCode.custom,\n path: ['limit'],\n message: '`limit` is only allowed when `mode=delta`',\n });\n }\n });\n}\n"],"mappings":";;;;;;;AAqBA,MAAa,sCAAsC;AACnD,MAAa,8CACX;AACF,MAAM,4CAA4C;AAClD,MAAM,gDAAgD;AACtD,MAAM,2CAA2C;AACjD,MAAM,0DAA0D;AAChE,MAAM,wDAAwD;AAC9D,MAAM,gDAAgC,IAAI,IAAI;CAAC;CAAS;CAAa;CAAU;AAAgB,CAAC;AAChG,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,SAAgB,6BAA6B;CAC3C,OACE,YAAY,gCAAgC,KAAA,KAC5C,YAAY,iCAAiC,KAAA,KAC7C,OAAO,YAAY,uBAAuB;AAE9C;AAEA,SAAgB,wBAAwB;CACtC,OACE,YAAY,2BAA2B,KAAA,KACvC,YAAY,4BAA4B,KAAA,KACxC,OAAO,YAAY,kBAAkB;AAEzC;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,SAAgB,2CAA2C,oBAA0C;CACnG,IAAI,YAAY,kBAAkB,CAAC,EAAE,SAAS,6CAA6C,GAAG;CAE9F,MAAM,IAAI,cAAc,KAAK,EAC3B,SAAS,2EACX,CAAC;AACH;AAEA,SAAgB,sCAAsC,oBAA0C;CAC9F,IAAI,YAAY,kBAAkB,CAAC,EAAE,SAAS,wCAAwC,GAAG;CAEzF,MAAM,IAAI,cAAc,KAAK,EAC3B,SAAS,uEACX,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,SAAS,cAAc,WAAqF;CAC1G,IAAI,CAAC,WAAW,OAAO;CACvB,IAAI,UAAU,SAAS,WAAW,OAAO,UAAU,KAAK,KAAK,aAAa;CAC1E,IAAI,UAAU,SAAS,OAAO,OAAO,cAAc,UAAU,GAAG;CAChE,IAAI,UAAU,SAAS,YAAY,OAAO,cAAc,UAAU,SAAS;CAC3E,OAAO,8BAA8B,IAAI,UAAU,KAAK;AAC1D;AAEA,SAAgB,0CAA0C,oBAA0C;CAClG,OAAO,YAAY,kBAAkB,CAAC,EAAE,SAAS,qDAAqD,MAAM;AAC9G;AAEA,SAAgB,2BAA2B,MAAuB;CAChE,OAAO,8BAA8B,IAAI,IAAI;AAC/C;AAEA,SAAgB,iDACd,oBACA,WACA;CACA,IAAI,CAAC,cAAc,SAAS,KAAK,0CAA0C,kBAAkB,GAAG;CAEhG,MAAM,IAAI,cAAc,KAAK,EAC3B,SAAS,wFACX,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;AA0BA,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,sBAAsB;CACtB,qBAAqB;CACrB,uBAAuB;CACvB,aAAa;CACb,WAAW;CACX,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,uBACG,cAAc,gBAAgB,SAAS,qDAAqD;EAC/F,qBACE,cAAc,gCAAgC,KAAK,SAAS,mDAAmD;EACjH,wBACG,cAAc,gBACf,aAAa,IAAA,wCAAuD,KACpE,SAAS,sDAAsD;EACjE;EACA,WAAW,cAAc,sBAAsB,KAAK,SAAS,wCAAwC;EACrG,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,kBAAkB;EAChB,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aACE;EACF,oBAAoB;CACtB;CAEA,eAAe;EACb,QAAQ;EACR,MAAM;EACN,SAAS;EACT,aAAa;EACb,oBAAoB;CACtB;CAEA,aAAa;EACX,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"}
|
|
@@ -6,7 +6,7 @@ const require_server_handlers_error = require("./error.cjs");
|
|
|
6
6
|
const require_server_handlers_observability_list_query_schemas = require("./observability-list-query-schemas.cjs");
|
|
7
7
|
const require_server_handlers_observability_shared = require("./observability-shared.cjs");
|
|
8
8
|
const require_server_handlers_observability_storage_schemas = require("./observability-storage-schemas.cjs");
|
|
9
|
-
const require_observability_new_endpoints = require("../../observability-new-endpoints-
|
|
9
|
+
const require_observability_new_endpoints = require("../../observability-new-endpoints-Kphyk3do.cjs");
|
|
10
10
|
let zod_v4 = require("zod/v4");
|
|
11
11
|
let _mastra_core_evals = require("@mastra/core/evals");
|
|
12
12
|
let _mastra_core_evals_scoreTraces = require("@mastra/core/evals/scoreTraces");
|
|
@@ -57,6 +57,7 @@ var observability_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll
|
|
|
57
57
|
LIST_TRACES_LIGHT_ROUTE: () => LIST_TRACES_LIGHT_ROUTE,
|
|
58
58
|
LIST_TRACES_ROUTE: () => LIST_TRACES_ROUTE,
|
|
59
59
|
NEW_ROUTES: () => require_observability_new_endpoints.NEW_ROUTES,
|
|
60
|
+
QUERY_SPANS: () => require_observability_new_endpoints.QUERY_SPANS,
|
|
60
61
|
QUERY_THREADS: () => require_observability_new_endpoints.QUERY_THREADS,
|
|
61
62
|
QUERY_TRACES: () => require_observability_new_endpoints.QUERY_TRACES,
|
|
62
63
|
SCORE_TRACES_ROUTE: () => SCORE_TRACES_ROUTE,
|
|
@@ -468,6 +469,7 @@ exports.LIST_SCORES_BY_SPAN_ROUTE = LIST_SCORES_BY_SPAN_ROUTE;
|
|
|
468
469
|
exports.LIST_TRACES_LIGHT_ROUTE = LIST_TRACES_LIGHT_ROUTE;
|
|
469
470
|
exports.LIST_TRACES_ROUTE = LIST_TRACES_ROUTE;
|
|
470
471
|
exports.NEW_ROUTES = require_observability_new_endpoints.NEW_ROUTES;
|
|
472
|
+
exports.QUERY_SPANS = require_observability_new_endpoints.QUERY_SPANS;
|
|
471
473
|
exports.QUERY_THREADS = require_observability_new_endpoints.QUERY_THREADS;
|
|
472
474
|
exports.QUERY_TRACES = require_observability_new_endpoints.QUERY_TRACES;
|
|
473
475
|
exports.SCORE_TRACES_ROUTE = SCORE_TRACES_ROUTE;
|