@mastra/playground-ui 68.0.0 → 69.0.0-alpha.1

package/dist/domains/dashboards/lib/requests.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"requests.cjs.js","names":["intersectFilters","bucketPlan","toTraceAggregateTimeRange","previousWindow","AGGREGATE_PRIORITY"],"sources":["../../../../src/domains/dashboards/lib/requests.ts"],"sourcesContent":["import type { AggregateSpansArgs, AggregateTracesArgs, DashboardQuery, MastraClient } from '@mastra/client-js';\nimport type { MetricsQueryFilters } from '@mastra/react/hooks/metrics';\nimport { bucketPlan } from '../../metrics/lib/metrics-buckets';\nimport { AGGREGATE_PRIORITY } from '../../metrics/lib/request-limiter';\nimport type { AggregatePriority } from '../../metrics/lib/request-limiter';\nimport { previousWindow } from '../../metrics/lib/time-window';\nimport { toTraceAggregateTimeRange } from '../../metrics/lib/trace-aggregate';\nimport { intersectFilters } from './filters';\n\ntype Window = { start: Date; end: Date };\ntype Interval = '1h' | '1d';\ntype Args<M extends keyof MastraClient> = MastraClient[M] extends (args: infer A, ...rest: never[]) => unknown\n  ? A\n  : never;\n\ntype Call =\n  | { method: 'aggregateTraces'; args: AggregateTracesArgs; priority?: AggregatePriority }\n  | { method: 'aggregateSpans'; args: AggregateSpansArgs; priority?: AggregatePriority }\n  | { method: 'getMetricAggregate'; args: Args<'getMetricAggregate'> }\n  | { method: 'getMetricBreakdown'; args: Args<'getMetricBreakdown'> }\n  | { method: 'getMetricTimeSeries'; args: Args<'getMetricTimeSeries'> }\n  | { method: 'getMetricPercentiles'; args: Args<'getMetricPercentiles'> }\n  | { method: 'getScoreAggregate'; args: Args<'getScoreAggregate'> }\n  | { method: 'getScoreBreakdown'; args: Args<'getScoreBreakdown'> }\n  | { method: 'getScoreTimeSeries'; args: Args<'getScoreTimeSeries'> }\n  | { method: 'getScorePercentiles'; args: Args<'getScorePercentiles'> };\n\n/** One call a dashboard query makes, with the args it sends. */\nexport type DashboardRequest = Call & {\n  /** Its filters contradict the page's, so nothing can match: it isn't sent and answers empty. */\n  unsatisfiable?: true;\n};\n\nexport type DashboardRequestMethod = DashboardRequest['method'];\n\ntype Answers = { [M in DashboardRequestMethod]: Awaited<ReturnType<MastraClient[M]>> };\n\n/** A request's answer, tagged with the method that produced it so a widget narrows it by `method`. */\nexport type DashboardAnswer = {\n  [M in DashboardRequestMethod]: { method: M; data: Answers[M] };\n}[DashboardRequestMethod];\n\ntype TraceWhere = NonNullable<AggregateTracesArgs['where']>;\ntype SpanWhere = NonNullable<AggregateSpansArgs['where']>;\n\n/** What the page adds to every widget's query: its frozen window and its filter bar. */\nexport type DashboardPageContext = {\n  window: Window;\n  /** The page's metrics and scores filters, `timestamp` included. */\n  filters: MetricsQueryFilters['filters'];\n  /** The filter bar as trace and span predicates, from the aggregate gates. */\n  traceWhere?: TraceWhere;\n  spanWhere?: SpanWhere;\n};\n\n/** How the widget kind sends a query. */\nexport type DashboardRequestOptions = {\n  /** The bucket size, for a query that doesn't set its own. Unset sends the query as written. */\n  interval?: Interval;\n};\n\n/** The widget's predicate and the page's, both required; the widget's comes first. */\nfunction andTrace(widget: TraceWhere | undefined, page: TraceWhere | undefined): TraceWhere | undefined {\n  return widget && page ? { op: 'and', args: [widget, page] } : (widget ?? page);\n}\n\nfunction andSpan(widget: SpanWhere | undefined, page: SpanWhere | undefined): SpanWhere | undefined {\n  return widget && page ? { op: 'and', args: [widget, page] } : (widget ?? page);\n}\n\ntype ValuesQuery = Extract<DashboardQuery, { source: 'metrics' | 'scores' }>;\n\n/**\n * A metrics or scores query's args, the page's filters intersected with its own, over `window`;\n * `unsatisfiable` when they contradict.\n */\nfunction valuesArgs<Q extends ValuesQuery>(query: Q, page: DashboardPageContext, window: Window) {\n  const { source: _source, id: _id, request, compare, filters, ...rest } = query;\n  const combined = intersectFilters(page.filters, filters);\n  return {\n    unsatisfiable: combined === undefined ? (true as const) : undefined,\n    args: {\n      ...rest,\n      filters: { ...(combined ?? page.filters), timestamp: window },\n      // An aggregate compares in the same request; anything else sends a second one over `window`.\n      comparePeriod: request === 'aggregate' && compare === 'previousWindow' ? ('previous_period' as const) : undefined,\n    },\n  };\n}\n\n/** A bucketed request's interval: its own, else the kind's, else the bar charts' for `window`. */\nfunction bucketOf<I extends string>(own: I | undefined, interval: Interval | undefined, window: Window) {\n  return own ?? interval ?? bucketPlan(window.start, window.end).interval;\n}\n\n/**\n * The request a query sends over `window`, the page's filters ANDed with the widget's: trace and span\n * predicates are joined with `and`; metrics and scores filters intersect (`intersectFilters`), and a\n * contradiction marks the request unsatisfiable. A scores query without a scorer sends nothing: the\n * `scores` kind expands it per scorer first.\n */\nexport function buildRequest(\n  query: DashboardQuery,\n  page: DashboardPageContext,\n  { interval }: DashboardRequestOptions,\n  window: Window = page.window,\n  priority?: AggregatePriority,\n): DashboardRequest | undefined {\n  if (query.source === 'traceAggregate') {\n    const { source: _source, id: _id, compare: _compare, where, interval: own, ...rest } = query;\n    return {\n      method: 'aggregateTraces',\n      args: {\n        timeRange: toTraceAggregateTimeRange(window),\n        ...rest,\n        interval: own ?? interval,\n        where: andTrace(where, page.traceWhere),\n      },\n      priority,\n    };\n  }\n  if (query.source === 'spanAggregate') {\n    const { source: _source, id: _id, compare: _compare, where, interval: own, ...rest } = query;\n    return {\n      method: 'aggregateSpans',\n      args: {\n        timeRange: toTraceAggregateTimeRange(window),\n        ...rest,\n        interval: own ?? interval,\n        where: andSpan(where, page.spanWhere),\n      },\n      priority,\n    };\n  }\n  if (query.source === 'metrics') {\n    switch (query.request) {\n      case 'aggregate': {\n        const { args, unsatisfiable } = valuesArgs(query, page, window);\n        return { method: 'getMetricAggregate', args, unsatisfiable };\n      }\n      case 'breakdown': {\n        const { args, unsatisfiable } = valuesArgs(query, page, window);\n        return { method: 'getMetricBreakdown', args, unsatisfiable };\n      }\n      case 'timeSeries': {\n        const { args, unsatisfiable } = valuesArgs(query, page, window);\n        const bucketed = { ...args, interval: bucketOf(query.interval, interval, window) };\n        return { method: 'getMetricTimeSeries', args: bucketed, unsatisfiable };\n      }\n      case 'percentiles': {\n        const { args, unsatisfiable } = valuesArgs(query, page, window);\n        const bucketed = { ...args, interval: bucketOf(query.interval, interval, window) };\n        return { method: 'getMetricPercentiles', args: bucketed, unsatisfiable };\n      }\n    }\n  }\n  const { scorerId } = query;\n  if (scorerId === undefined) return undefined;\n  switch (query.request) {\n    case 'aggregate': {\n      const { args, unsatisfiable } = valuesArgs(query, page, window);\n      return { method: 'getScoreAggregate', args: { ...args, scorerId }, unsatisfiable };\n    }\n    case 'breakdown': {\n      const { args, unsatisfiable } = valuesArgs(query, page, window);\n      return { method: 'getScoreBreakdown', args: { ...args, scorerId }, unsatisfiable };\n    }\n    case 'timeSeries': {\n      const { args, unsatisfiable } = valuesArgs(query, page, window);\n      const bucketed = { ...args, scorerId, interval: bucketOf(query.interval, interval, window) };\n      return { method: 'getScoreTimeSeries', args: bucketed, unsatisfiable };\n    }\n    case 'percentiles': {\n      const { args, unsatisfiable } = valuesArgs(query, page, window);\n      const bucketed = { ...args, scorerId, interval: bucketOf(query.interval, interval, window) };\n      return { method: 'getScorePercentiles', args: bucketed, unsatisfiable };\n    }\n  }\n}\n\n/** Whether a query asks for the previous window as a request of its own. */\nexport function sendsPreviousRequest(query: DashboardQuery) {\n  if (query.compare !== 'previousWindow') return false;\n  return !((query.source === 'metrics' || query.source === 'scores') && query.request === 'aggregate');\n}\n\n/** The previous window's request, sent last so the widget never waits on it. */\nexport function buildPreviousRequest(\n  query: DashboardQuery,\n  page: DashboardPageContext,\n  options: DashboardRequestOptions,\n): DashboardRequest | undefined {\n  if (!sendsPreviousRequest(query)) return undefined;\n  return buildRequest(query, page, options, previousWindow(page.window), AGGREGATE_PRIORITY.last);\n}\n\n/** What an unsatisfiable request answers: nothing matched. */\nfunction emptyAnswer(method: DashboardRequestMethod): DashboardAnswer {\n  switch (method) {\n    case 'aggregateTraces':\n    case 'aggregateSpans':\n      return { method, data: { rows: [], truncated: false } };\n    case 'getMetricAggregate':\n    case 'getScoreAggregate':\n      return { method, data: { value: null } };\n    case 'getMetricBreakdown':\n    case 'getScoreBreakdown':\n      return { method, data: { groups: [] } };\n    case 'getMetricTimeSeries':\n    case 'getMetricPercentiles':\n    case 'getScoreTimeSeries':\n    case 'getScorePercentiles':\n      return { method, data: { series: [] } };\n  }\n}\n\n/** Runs a request on the client; an unsatisfiable one answers empty without a call. */\nexport async function sendRequest(client: MastraClient, request: DashboardRequest): Promise<DashboardAnswer> {\n  if (request.unsatisfiable) return emptyAnswer(request.method);\n  switch (request.method) {\n    case 'aggregateTraces':\n      return { method: request.method, data: await client.aggregateTraces(request.args) };\n    case 'aggregateSpans':\n      return { method: request.method, data: await client.aggregateSpans(request.args) };\n    case 'getMetricAggregate':\n      return { method: request.method, data: await client.getMetricAggregate(request.args) };\n    case 'getMetricBreakdown':\n      return { method: request.method, data: await client.getMetricBreakdown(request.args) };\n    case 'getMetricTimeSeries':\n      return { method: request.method, data: await client.getMetricTimeSeries(request.args) };\n    case 'getMetricPercentiles':\n      return { method: request.method, data: await client.getMetricPercentiles(request.args) };\n    case 'getScoreAggregate':\n      return { method: request.method, data: await client.getScoreAggregate(request.args) };\n    case 'getScoreBreakdown':\n      return { method: request.method, data: await client.getScoreBreakdown(request.args) };\n    case 'getScoreTimeSeries':\n      return { method: request.method, data: await client.getScoreTimeSeries(request.args) };\n    case 'getScorePercentiles':\n      return { method: request.method, data: await client.getScorePercentiles(request.args) };\n  }\n}\n\n/**\n * The React Query key. Answers are cached tagged with their method, so they live under the dashboards'\n * own keys rather than `useTraceAggregate`'s, whose entries hold the bare response.\n */\nexport function requestKey(request: DashboardRequest): readonly unknown[] {\n  if (request.unsatisfiable) return ['dashboards', 'unsatisfiable', request.method];\n  return ['dashboards', request.method, request.args];\n}\n\n/** Whether a query needs the trace or span aggregate gate. */\nexport const aggregateSource = (query: DashboardQuery) =>\n  query.source === 'traceAggregate' ? 'trace' : query.source === 'spanAggregate' ? 'span' : undefined;\n"],"mappings":"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"}
+{"version":3,"file":"requests.cjs.js","names":["intersectFilters","bucketPlan","toTraceAggregateTimeRange","previousWindow","AGGREGATE_PRIORITY"],"sources":["../../../../src/domains/dashboards/lib/requests.ts"],"sourcesContent":["import type { AggregateSpansArgs, AggregateTracesArgs, DashboardQuery, MastraClient } from '@mastra/client-js';\nimport type { MetricsQueryFilters } from '@mastra/react/hooks/metrics';\nimport { bucketPlan } from '../../metrics/lib/metrics-buckets';\nimport { AGGREGATE_PRIORITY } from '../../metrics/lib/request-limiter';\nimport type { AggregatePriority } from '../../metrics/lib/request-limiter';\nimport { previousWindow } from '../../metrics/lib/time-window';\nimport { toTraceAggregateTimeRange } from '../../metrics/lib/trace-aggregate';\nimport { intersectFilters } from './filters';\n\ntype Window = { start: Date; end: Date };\ntype Interval = '1h' | '1d';\ntype Args<M extends keyof MastraClient> = MastraClient[M] extends (args: infer A, ...rest: never[]) => unknown\n  ? A\n  : never;\n\ntype Call =\n  | { method: 'aggregateTraces'; args: AggregateTracesArgs; priority?: AggregatePriority }\n  | { method: 'aggregateSpans'; args: AggregateSpansArgs; priority?: AggregatePriority }\n  | { method: 'getMetricAggregate'; args: Args<'getMetricAggregate'> }\n  | { method: 'getMetricBreakdown'; args: Args<'getMetricBreakdown'> }\n  | { method: 'getMetricTimeSeries'; args: Args<'getMetricTimeSeries'> }\n  | { method: 'getMetricPercentiles'; args: Args<'getMetricPercentiles'> }\n  | { method: 'getScoreAggregate'; args: Args<'getScoreAggregate'> }\n  | { method: 'getScoreBreakdown'; args: Args<'getScoreBreakdown'> }\n  | { method: 'getScoreTimeSeries'; args: Args<'getScoreTimeSeries'> }\n  | { method: 'getScorePercentiles'; args: Args<'getScorePercentiles'> }\n  | { method: 'listScores'; args: Args<'listScores'> };\n\n/** One call a dashboard query makes, with the args it sends. */\nexport type DashboardRequest = Call & {\n  /** Its filters contradict the page's, so nothing can match: it isn't sent and answers empty. */\n  unsatisfiable?: true;\n};\n\nexport type DashboardRequestMethod = DashboardRequest['method'];\n\ntype Answers = { [M in DashboardRequestMethod]: Awaited<ReturnType<MastraClient[M]>> };\n\n/** A request's answer, tagged with the method that produced it so a widget narrows it by `method`. */\nexport type DashboardAnswer = {\n  [M in DashboardRequestMethod]: { method: M; data: Answers[M] };\n}[DashboardRequestMethod];\n\n/**\n * Where a request's answer stands, as plain data: what a widget renders from, whoever fetched it.\n * `isLoading` has no answer yet; `isRefetching` has one and is fetching it again.\n */\nexport type DashboardResult = {\n  data?: DashboardAnswer;\n  isLoading: boolean;\n  isRefetching: boolean;\n  isError: boolean;\n  error?: unknown;\n};\n\ntype TraceWhere = NonNullable<AggregateTracesArgs['where']>;\ntype SpanWhere = NonNullable<AggregateSpansArgs['where']>;\n\n/** What the page adds to every widget's query: its frozen window and its filter bar. */\nexport type DashboardPageContext = {\n  window: Window;\n  /** The page's metrics and scores filters, `timestamp` included. */\n  filters: MetricsQueryFilters['filters'];\n  /** The filter bar as trace and span predicates, from the aggregate gates. */\n  traceWhere?: TraceWhere;\n  spanWhere?: SpanWhere;\n};\n\n/** How the widget kind sends a query. */\nexport type DashboardRequestOptions = {\n  /** The bucket size, for a query that doesn't set its own. Unset sends the query as written. */\n  interval?: Interval;\n};\n\n/** The widget's predicate and the page's, both required; the widget's comes first. */\nfunction andTrace(widget: TraceWhere | undefined, page: TraceWhere | undefined): TraceWhere | undefined {\n  return widget && page ? { op: 'and', args: [widget, page] } : (widget ?? page);\n}\n\nfunction andSpan(widget: SpanWhere | undefined, page: SpanWhere | undefined): SpanWhere | undefined {\n  return widget && page ? { op: 'and', args: [widget, page] } : (widget ?? page);\n}\n\ntype ValuesQuery = Extract<DashboardQuery, { source: 'metrics' | 'scores' }>;\n\n/**\n * A metrics or scores query's args, the page's filters intersected with its own, over `window`;\n * `unsatisfiable` when they contradict.\n */\nfunction valuesArgs<Q extends ValuesQuery>(query: Q, page: DashboardPageContext, window: Window) {\n  const { source: _source, id: _id, request, compare, filters, ...rest } = query;\n  const combined = intersectFilters(page.filters, filters);\n  return {\n    unsatisfiable: combined === undefined ? (true as const) : undefined,\n    args: {\n      ...rest,\n      filters: { ...(combined ?? page.filters), timestamp: window },\n      // An aggregate compares in the same request; anything else sends a second one over `window`.\n      comparePeriod: request === 'aggregate' && compare === 'previousWindow' ? ('previous_period' as const) : undefined,\n    },\n  };\n}\n\n/**\n * The query with the page's filter bar ANDed in, as `buildRequest` applies it, but without the time\n * window: trace and span predicates joined with `and`, metrics and scores filters intersected.\n * `'unsatisfiable'` when the filters contradict, so nothing can match.\n */\nexport function pageQuery(query: DashboardQuery, page: DashboardPageContext): DashboardQuery | 'unsatisfiable' {\n  if (query.source === 'traceAggregate') {\n    const where = andTrace(query.where, page.traceWhere);\n    return where ? { ...query, where } : query;\n  }\n  if (query.source === 'spanAggregate') {\n    const where = andSpan(query.where, page.spanWhere);\n    return where ? { ...query, where } : query;\n  }\n  const combined = intersectFilters(page.filters, query.filters);\n  if (combined === undefined) return 'unsatisfiable';\n  const { timestamp: _timestamp, ...filters } = combined;\n  const { filters: _own, ...rest } = query;\n  return Object.keys(filters).length > 0 ? { ...rest, filters } : rest;\n}\n\n/** A bucketed request's interval: its own, else the kind's, else the bar charts' for `window`. */\nfunction bucketOf<I extends string>(own: I | undefined, interval: Interval | undefined, window: Window) {\n  return own ?? interval ?? bucketPlan(window.start, window.end).interval;\n}\n\n/**\n * The request a query sends over `window`, the page's filters ANDed with the widget's: trace and span\n * predicates are joined with `and`; metrics and scores filters intersect (`intersectFilters`), and a\n * contradiction marks the request unsatisfiable. A scores query without a scorer sends nothing: the\n * `scores` kind expands it per scorer first.\n */\nexport function buildRequest(\n  query: DashboardQuery,\n  page: DashboardPageContext,\n  { interval }: DashboardRequestOptions,\n  window: Window = page.window,\n  priority?: AggregatePriority,\n): DashboardRequest | undefined {\n  if (query.source === 'traceAggregate') {\n    const { source: _source, id: _id, compare: _compare, where, interval: own, ...rest } = query;\n    return {\n      method: 'aggregateTraces',\n      args: {\n        timeRange: toTraceAggregateTimeRange(window),\n        ...rest,\n        interval: own ?? interval,\n        where: andTrace(where, page.traceWhere),\n      },\n      priority,\n    };\n  }\n  if (query.source === 'spanAggregate') {\n    const { source: _source, id: _id, compare: _compare, where, interval: own, ...rest } = query;\n    return {\n      method: 'aggregateSpans',\n      args: {\n        timeRange: toTraceAggregateTimeRange(window),\n        ...rest,\n        interval: own ?? interval,\n        where: andSpan(where, page.spanWhere),\n      },\n      priority,\n    };\n  }\n  if (query.source === 'metrics') {\n    switch (query.request) {\n      case 'aggregate': {\n        const { args, unsatisfiable } = valuesArgs(query, page, window);\n        return { method: 'getMetricAggregate', args, unsatisfiable };\n      }\n      case 'breakdown': {\n        const { args, unsatisfiable } = valuesArgs(query, page, window);\n        return { method: 'getMetricBreakdown', args, unsatisfiable };\n      }\n      case 'timeSeries': {\n        const { args, unsatisfiable } = valuesArgs(query, page, window);\n        const bucketed = { ...args, interval: bucketOf(query.interval, interval, window) };\n        return { method: 'getMetricTimeSeries', args: bucketed, unsatisfiable };\n      }\n      case 'percentiles': {\n        const { args, unsatisfiable } = valuesArgs(query, page, window);\n        const bucketed = { ...args, interval: bucketOf(query.interval, interval, window) };\n        return { method: 'getMetricPercentiles', args: bucketed, unsatisfiable };\n      }\n    }\n  }\n  const { scorerId } = query;\n  if (scorerId === undefined) return undefined;\n  switch (query.request) {\n    case 'aggregate': {\n      const { args, unsatisfiable } = valuesArgs(query, page, window);\n      return { method: 'getScoreAggregate', args: { ...args, scorerId }, unsatisfiable };\n    }\n    case 'breakdown': {\n      const { args, unsatisfiable } = valuesArgs(query, page, window);\n      return { method: 'getScoreBreakdown', args: { ...args, scorerId }, unsatisfiable };\n    }\n    case 'timeSeries': {\n      const { args, unsatisfiable } = valuesArgs(query, page, window);\n      const bucketed = { ...args, scorerId, interval: bucketOf(query.interval, interval, window) };\n      return { method: 'getScoreTimeSeries', args: bucketed, unsatisfiable };\n    }\n    case 'percentiles': {\n      const { args, unsatisfiable } = valuesArgs(query, page, window);\n      const bucketed = { ...args, scorerId, interval: bucketOf(query.interval, interval, window) };\n      return { method: 'getScorePercentiles', args: bucketed, unsatisfiable };\n    }\n  }\n}\n\n/** Whether a query asks for the previous window as a request of its own. */\nexport function sendsPreviousRequest(query: DashboardQuery) {\n  if (query.compare !== 'previousWindow') return false;\n  return !((query.source === 'metrics' || query.source === 'scores') && query.request === 'aggregate');\n}\n\n/** The previous window's request, sent last so the widget never waits on it. */\nexport function buildPreviousRequest(\n  query: DashboardQuery,\n  page: DashboardPageContext,\n  options: DashboardRequestOptions,\n): DashboardRequest | undefined {\n  if (!sendsPreviousRequest(query)) return undefined;\n  return buildRequest(query, page, options, previousWindow(page.window), AGGREGATE_PRIORITY.last);\n}\n\n/** What an unsatisfiable request answers: nothing matched. */\nexport function emptyAnswer(method: DashboardRequestMethod): DashboardAnswer {\n  switch (method) {\n    case 'aggregateTraces':\n    case 'aggregateSpans':\n      return { method, data: { rows: [], truncated: false } };\n    case 'getMetricAggregate':\n    case 'getScoreAggregate':\n      return { method, data: { value: null } };\n    case 'getMetricBreakdown':\n    case 'getScoreBreakdown':\n      return { method, data: { groups: [] } };\n    case 'getMetricTimeSeries':\n    case 'getMetricPercentiles':\n    case 'getScoreTimeSeries':\n    case 'getScorePercentiles':\n      return { method, data: { series: [] } };\n    case 'listScores':\n      return { method, data: { scores: [], pagination: { total: 0, page: 0, perPage: 0, hasMore: false } } };\n  }\n}\n\n/** Runs a request on the client; an unsatisfiable one answers empty without a call. */\nexport async function sendRequest(client: MastraClient, request: DashboardRequest): Promise<DashboardAnswer> {\n  if (request.unsatisfiable) return emptyAnswer(request.method);\n  switch (request.method) {\n    case 'aggregateTraces':\n      return { method: request.method, data: await client.aggregateTraces(request.args) };\n    case 'aggregateSpans':\n      return { method: request.method, data: await client.aggregateSpans(request.args) };\n    case 'getMetricAggregate':\n      return { method: request.method, data: await client.getMetricAggregate(request.args) };\n    case 'getMetricBreakdown':\n      return { method: request.method, data: await client.getMetricBreakdown(request.args) };\n    case 'getMetricTimeSeries':\n      return { method: request.method, data: await client.getMetricTimeSeries(request.args) };\n    case 'getMetricPercentiles':\n      return { method: request.method, data: await client.getMetricPercentiles(request.args) };\n    case 'getScoreAggregate':\n      return { method: request.method, data: await client.getScoreAggregate(request.args) };\n    case 'getScoreBreakdown':\n      return { method: request.method, data: await client.getScoreBreakdown(request.args) };\n    case 'getScoreTimeSeries':\n      return { method: request.method, data: await client.getScoreTimeSeries(request.args) };\n    case 'getScorePercentiles':\n      return { method: request.method, data: await client.getScorePercentiles(request.args) };\n    case 'listScores':\n      return { method: request.method, data: await client.listScores(request.args) };\n  }\n}\n\n/**\n * The React Query key. Answers are cached tagged with their method, so they live under the dashboards'\n * own keys rather than `useTraceAggregate`'s, whose entries hold the bare response.\n */\nexport function requestKey(request: DashboardRequest): readonly unknown[] {\n  if (request.unsatisfiable) return ['dashboards', 'unsatisfiable', request.method];\n  return ['dashboards', request.method, request.args];\n}\n\n/** Whether a query needs the trace or span aggregate gate. */\nexport const aggregateSource = (query: DashboardQuery) =>\n  query.source === 'traceAggregate' ? 'trace' : query.source === 'spanAggregate' ? 'span' : undefined;\n"],"mappings":"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"}

package/dist/domains/dashboards/lib/requests.es.js

@@ -1,7 +1,7 @@
-import { AGGREGATE_PRIORITY } from "../../metrics/lib/request-limiter.es.js";
 import { bucketPlan } from "../../metrics/lib/metrics-buckets.es.js";
-import { toTraceAggregateTimeRange } from "../../metrics/lib/trace-aggregate.es.js";
+import { AGGREGATE_PRIORITY } from "../../metrics/lib/request-limiter.es.js";
 import { previousWindow } from "../../metrics/lib/time-window.es.js";
+import { toTraceAggregateTimeRange } from "../../metrics/lib/trace-aggregate.es.js";
 import { intersectFilters } from "./filters.es.js";
 // src/domains/dashboards/lib/requests.ts
 /** The widget's predicate and the page's, both required; the widget's comes first. */
@@ -36,6 +36,35 @@ function valuesArgs(query, page, window) {
 		}
 	};
 }
+/**
+* The query with the page's filter bar ANDed in, as `buildRequest` applies it, but without the time
+* window: trace and span predicates joined with `and`, metrics and scores filters intersected.
+* `'unsatisfiable'` when the filters contradict, so nothing can match.
+*/
+function pageQuery(query, page) {
+	if (query.source === "traceAggregate") {
+		const where = andTrace(query.where, page.traceWhere);
+		return where ? {
+			...query,
+			where
+		} : query;
+	}
+	if (query.source === "spanAggregate") {
+		const where = andSpan(query.where, page.spanWhere);
+		return where ? {
+			...query,
+			where
+		} : query;
+	}
+	const combined = intersectFilters(page.filters, query.filters);
+	if (combined === void 0) return "unsatisfiable";
+	const { timestamp: _timestamp, ...filters } = combined;
+	const { filters: _own, ...rest } = query;
+	return Object.keys(filters).length > 0 ? {
+		...rest,
+		filters
+	} : rest;
+}
 /** A bucketed request's interval: its own, else the kind's, else the bar charts' for `window`. */
 function bucketOf(own, interval, window) {
 	return own ?? interval ?? bucketPlan(window.start, window.end).interval;
@@ -202,6 +231,18 @@ function emptyAnswer(method) {
 			method,
 			data: { series: [] }
 		};
+		case "listScores": return {
+			method,
+			data: {
+				scores: [],
+				pagination: {
+					total: 0,
+					page: 0,
+					perPage: 0,
+					hasMore: false
+				}
+			}
+		};
 	}
 }
 /** Runs a request on the client; an unsatisfiable one answers empty without a call. */
@@ -248,6 +289,10 @@ async function sendRequest(client, request) {
 			method: request.method,
 			data: await client.getScorePercentiles(request.args)
 		};
+		case "listScores": return {
+			method: request.method,
+			data: await client.listScores(request.args)
+		};
 	}
 }
 /**
@@ -268,6 +313,6 @@ function requestKey(request) {
 }
 /** Whether a query needs the trace or span aggregate gate. */
 var aggregateSource = (query) => query.source === "traceAggregate" ? "trace" : query.source === "spanAggregate" ? "span" : void 0;
-export { aggregateSource, buildPreviousRequest, buildRequest, requestKey, sendRequest, sendsPreviousRequest };
+export { aggregateSource, buildPreviousRequest, buildRequest, emptyAnswer, pageQuery, requestKey, sendRequest, sendsPreviousRequest };
 
 //# sourceMappingURL=requests.es.js.map

package/dist/domains/dashboards/lib/requests.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"requests.es.js","names":[],"sources":["../../../../src/domains/dashboards/lib/requests.ts"],"sourcesContent":["import type { AggregateSpansArgs, AggregateTracesArgs, DashboardQuery, MastraClient } from '@mastra/client-js';\nimport type { MetricsQueryFilters } from '@mastra/react/hooks/metrics';\nimport { bucketPlan } from '../../metrics/lib/metrics-buckets';\nimport { AGGREGATE_PRIORITY } from '../../metrics/lib/request-limiter';\nimport type { AggregatePriority } from '../../metrics/lib/request-limiter';\nimport { previousWindow } from '../../metrics/lib/time-window';\nimport { toTraceAggregateTimeRange } from '../../metrics/lib/trace-aggregate';\nimport { intersectFilters } from './filters';\n\ntype Window = { start: Date; end: Date };\ntype Interval = '1h' | '1d';\ntype Args<M extends keyof MastraClient> = MastraClient[M] extends (args: infer A, ...rest: never[]) => unknown\n  ? A\n  : never;\n\ntype Call =\n  | { method: 'aggregateTraces'; args: AggregateTracesArgs; priority?: AggregatePriority }\n  | { method: 'aggregateSpans'; args: AggregateSpansArgs; priority?: AggregatePriority }\n  | { method: 'getMetricAggregate'; args: Args<'getMetricAggregate'> }\n  | { method: 'getMetricBreakdown'; args: Args<'getMetricBreakdown'> }\n  | { method: 'getMetricTimeSeries'; args: Args<'getMetricTimeSeries'> }\n  | { method: 'getMetricPercentiles'; args: Args<'getMetricPercentiles'> }\n  | { method: 'getScoreAggregate'; args: Args<'getScoreAggregate'> }\n  | { method: 'getScoreBreakdown'; args: Args<'getScoreBreakdown'> }\n  | { method: 'getScoreTimeSeries'; args: Args<'getScoreTimeSeries'> }\n  | { method: 'getScorePercentiles'; args: Args<'getScorePercentiles'> };\n\n/** One call a dashboard query makes, with the args it sends. */\nexport type DashboardRequest = Call & {\n  /** Its filters contradict the page's, so nothing can match: it isn't sent and answers empty. */\n  unsatisfiable?: true;\n};\n\nexport type DashboardRequestMethod = DashboardRequest['method'];\n\ntype Answers = { [M in DashboardRequestMethod]: Awaited<ReturnType<MastraClient[M]>> };\n\n/** A request's answer, tagged with the method that produced it so a widget narrows it by `method`. */\nexport type DashboardAnswer = {\n  [M in DashboardRequestMethod]: { method: M; data: Answers[M] };\n}[DashboardRequestMethod];\n\ntype TraceWhere = NonNullable<AggregateTracesArgs['where']>;\ntype SpanWhere = NonNullable<AggregateSpansArgs['where']>;\n\n/** What the page adds to every widget's query: its frozen window and its filter bar. */\nexport type DashboardPageContext = {\n  window: Window;\n  /** The page's metrics and scores filters, `timestamp` included. */\n  filters: MetricsQueryFilters['filters'];\n  /** The filter bar as trace and span predicates, from the aggregate gates. */\n  traceWhere?: TraceWhere;\n  spanWhere?: SpanWhere;\n};\n\n/** How the widget kind sends a query. */\nexport type DashboardRequestOptions = {\n  /** The bucket size, for a query that doesn't set its own. Unset sends the query as written. */\n  interval?: Interval;\n};\n\n/** The widget's predicate and the page's, both required; the widget's comes first. */\nfunction andTrace(widget: TraceWhere | undefined, page: TraceWhere | undefined): TraceWhere | undefined {\n  return widget && page ? { op: 'and', args: [widget, page] } : (widget ?? page);\n}\n\nfunction andSpan(widget: SpanWhere | undefined, page: SpanWhere | undefined): SpanWhere | undefined {\n  return widget && page ? { op: 'and', args: [widget, page] } : (widget ?? page);\n}\n\ntype ValuesQuery = Extract<DashboardQuery, { source: 'metrics' | 'scores' }>;\n\n/**\n * A metrics or scores query's args, the page's filters intersected with its own, over `window`;\n * `unsatisfiable` when they contradict.\n */\nfunction valuesArgs<Q extends ValuesQuery>(query: Q, page: DashboardPageContext, window: Window) {\n  const { source: _source, id: _id, request, compare, filters, ...rest } = query;\n  const combined = intersectFilters(page.filters, filters);\n  return {\n    unsatisfiable: combined === undefined ? (true as const) : undefined,\n    args: {\n      ...rest,\n      filters: { ...(combined ?? page.filters), timestamp: window },\n      // An aggregate compares in the same request; anything else sends a second one over `window`.\n      comparePeriod: request === 'aggregate' && compare === 'previousWindow' ? ('previous_period' as const) : undefined,\n    },\n  };\n}\n\n/** A bucketed request's interval: its own, else the kind's, else the bar charts' for `window`. */\nfunction bucketOf<I extends string>(own: I | undefined, interval: Interval | undefined, window: Window) {\n  return own ?? interval ?? bucketPlan(window.start, window.end).interval;\n}\n\n/**\n * The request a query sends over `window`, the page's filters ANDed with the widget's: trace and span\n * predicates are joined with `and`; metrics and scores filters intersect (`intersectFilters`), and a\n * contradiction marks the request unsatisfiable. A scores query without a scorer sends nothing: the\n * `scores` kind expands it per scorer first.\n */\nexport function buildRequest(\n  query: DashboardQuery,\n  page: DashboardPageContext,\n  { interval }: DashboardRequestOptions,\n  window: Window = page.window,\n  priority?: AggregatePriority,\n): DashboardRequest | undefined {\n  if (query.source === 'traceAggregate') {\n    const { source: _source, id: _id, compare: _compare, where, interval: own, ...rest } = query;\n    return {\n      method: 'aggregateTraces',\n      args: {\n        timeRange: toTraceAggregateTimeRange(window),\n        ...rest,\n        interval: own ?? interval,\n        where: andTrace(where, page.traceWhere),\n      },\n      priority,\n    };\n  }\n  if (query.source === 'spanAggregate') {\n    const { source: _source, id: _id, compare: _compare, where, interval: own, ...rest } = query;\n    return {\n      method: 'aggregateSpans',\n      args: {\n        timeRange: toTraceAggregateTimeRange(window),\n        ...rest,\n        interval: own ?? interval,\n        where: andSpan(where, page.spanWhere),\n      },\n      priority,\n    };\n  }\n  if (query.source === 'metrics') {\n    switch (query.request) {\n      case 'aggregate': {\n        const { args, unsatisfiable } = valuesArgs(query, page, window);\n        return { method: 'getMetricAggregate', args, unsatisfiable };\n      }\n      case 'breakdown': {\n        const { args, unsatisfiable } = valuesArgs(query, page, window);\n        return { method: 'getMetricBreakdown', args, unsatisfiable };\n      }\n      case 'timeSeries': {\n        const { args, unsatisfiable } = valuesArgs(query, page, window);\n        const bucketed = { ...args, interval: bucketOf(query.interval, interval, window) };\n        return { method: 'getMetricTimeSeries', args: bucketed, unsatisfiable };\n      }\n      case 'percentiles': {\n        const { args, unsatisfiable } = valuesArgs(query, page, window);\n        const bucketed = { ...args, interval: bucketOf(query.interval, interval, window) };\n        return { method: 'getMetricPercentiles', args: bucketed, unsatisfiable };\n      }\n    }\n  }\n  const { scorerId } = query;\n  if (scorerId === undefined) return undefined;\n  switch (query.request) {\n    case 'aggregate': {\n      const { args, unsatisfiable } = valuesArgs(query, page, window);\n      return { method: 'getScoreAggregate', args: { ...args, scorerId }, unsatisfiable };\n    }\n    case 'breakdown': {\n      const { args, unsatisfiable } = valuesArgs(query, page, window);\n      return { method: 'getScoreBreakdown', args: { ...args, scorerId }, unsatisfiable };\n    }\n    case 'timeSeries': {\n      const { args, unsatisfiable } = valuesArgs(query, page, window);\n      const bucketed = { ...args, scorerId, interval: bucketOf(query.interval, interval, window) };\n      return { method: 'getScoreTimeSeries', args: bucketed, unsatisfiable };\n    }\n    case 'percentiles': {\n      const { args, unsatisfiable } = valuesArgs(query, page, window);\n      const bucketed = { ...args, scorerId, interval: bucketOf(query.interval, interval, window) };\n      return { method: 'getScorePercentiles', args: bucketed, unsatisfiable };\n    }\n  }\n}\n\n/** Whether a query asks for the previous window as a request of its own. */\nexport function sendsPreviousRequest(query: DashboardQuery) {\n  if (query.compare !== 'previousWindow') return false;\n  return !((query.source === 'metrics' || query.source === 'scores') && query.request === 'aggregate');\n}\n\n/** The previous window's request, sent last so the widget never waits on it. */\nexport function buildPreviousRequest(\n  query: DashboardQuery,\n  page: DashboardPageContext,\n  options: DashboardRequestOptions,\n): DashboardRequest | undefined {\n  if (!sendsPreviousRequest(query)) return undefined;\n  return buildRequest(query, page, options, previousWindow(page.window), AGGREGATE_PRIORITY.last);\n}\n\n/** What an unsatisfiable request answers: nothing matched. */\nfunction emptyAnswer(method: DashboardRequestMethod): DashboardAnswer {\n  switch (method) {\n    case 'aggregateTraces':\n    case 'aggregateSpans':\n      return { method, data: { rows: [], truncated: false } };\n    case 'getMetricAggregate':\n    case 'getScoreAggregate':\n      return { method, data: { value: null } };\n    case 'getMetricBreakdown':\n    case 'getScoreBreakdown':\n      return { method, data: { groups: [] } };\n    case 'getMetricTimeSeries':\n    case 'getMetricPercentiles':\n    case 'getScoreTimeSeries':\n    case 'getScorePercentiles':\n      return { method, data: { series: [] } };\n  }\n}\n\n/** Runs a request on the client; an unsatisfiable one answers empty without a call. */\nexport async function sendRequest(client: MastraClient, request: DashboardRequest): Promise<DashboardAnswer> {\n  if (request.unsatisfiable) return emptyAnswer(request.method);\n  switch (request.method) {\n    case 'aggregateTraces':\n      return { method: request.method, data: await client.aggregateTraces(request.args) };\n    case 'aggregateSpans':\n      return { method: request.method, data: await client.aggregateSpans(request.args) };\n    case 'getMetricAggregate':\n      return { method: request.method, data: await client.getMetricAggregate(request.args) };\n    case 'getMetricBreakdown':\n      return { method: request.method, data: await client.getMetricBreakdown(request.args) };\n    case 'getMetricTimeSeries':\n      return { method: request.method, data: await client.getMetricTimeSeries(request.args) };\n    case 'getMetricPercentiles':\n      return { method: request.method, data: await client.getMetricPercentiles(request.args) };\n    case 'getScoreAggregate':\n      return { method: request.method, data: await client.getScoreAggregate(request.args) };\n    case 'getScoreBreakdown':\n      return { method: request.method, data: await client.getScoreBreakdown(request.args) };\n    case 'getScoreTimeSeries':\n      return { method: request.method, data: await client.getScoreTimeSeries(request.args) };\n    case 'getScorePercentiles':\n      return { method: request.method, data: await client.getScorePercentiles(request.args) };\n  }\n}\n\n/**\n * The React Query key. Answers are cached tagged with their method, so they live under the dashboards'\n * own keys rather than `useTraceAggregate`'s, whose entries hold the bare response.\n */\nexport function requestKey(request: DashboardRequest): readonly unknown[] {\n  if (request.unsatisfiable) return ['dashboards', 'unsatisfiable', request.method];\n  return ['dashboards', request.method, request.args];\n}\n\n/** Whether a query needs the trace or span aggregate gate. */\nexport const aggregateSource = (query: DashboardQuery) =>\n  query.source === 'traceAggregate' ? 'trace' : query.source === 'spanAggregate' ? 'span' : undefined;\n"],"mappings":"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"}
+{"version":3,"file":"requests.es.js","names":[],"sources":["../../../../src/domains/dashboards/lib/requests.ts"],"sourcesContent":["import type { AggregateSpansArgs, AggregateTracesArgs, DashboardQuery, MastraClient } from '@mastra/client-js';\nimport type { MetricsQueryFilters } from '@mastra/react/hooks/metrics';\nimport { bucketPlan } from '../../metrics/lib/metrics-buckets';\nimport { AGGREGATE_PRIORITY } from '../../metrics/lib/request-limiter';\nimport type { AggregatePriority } from '../../metrics/lib/request-limiter';\nimport { previousWindow } from '../../metrics/lib/time-window';\nimport { toTraceAggregateTimeRange } from '../../metrics/lib/trace-aggregate';\nimport { intersectFilters } from './filters';\n\ntype Window = { start: Date; end: Date };\ntype Interval = '1h' | '1d';\ntype Args<M extends keyof MastraClient> = MastraClient[M] extends (args: infer A, ...rest: never[]) => unknown\n  ? A\n  : never;\n\ntype Call =\n  | { method: 'aggregateTraces'; args: AggregateTracesArgs; priority?: AggregatePriority }\n  | { method: 'aggregateSpans'; args: AggregateSpansArgs; priority?: AggregatePriority }\n  | { method: 'getMetricAggregate'; args: Args<'getMetricAggregate'> }\n  | { method: 'getMetricBreakdown'; args: Args<'getMetricBreakdown'> }\n  | { method: 'getMetricTimeSeries'; args: Args<'getMetricTimeSeries'> }\n  | { method: 'getMetricPercentiles'; args: Args<'getMetricPercentiles'> }\n  | { method: 'getScoreAggregate'; args: Args<'getScoreAggregate'> }\n  | { method: 'getScoreBreakdown'; args: Args<'getScoreBreakdown'> }\n  | { method: 'getScoreTimeSeries'; args: Args<'getScoreTimeSeries'> }\n  | { method: 'getScorePercentiles'; args: Args<'getScorePercentiles'> }\n  | { method: 'listScores'; args: Args<'listScores'> };\n\n/** One call a dashboard query makes, with the args it sends. */\nexport type DashboardRequest = Call & {\n  /** Its filters contradict the page's, so nothing can match: it isn't sent and answers empty. */\n  unsatisfiable?: true;\n};\n\nexport type DashboardRequestMethod = DashboardRequest['method'];\n\ntype Answers = { [M in DashboardRequestMethod]: Awaited<ReturnType<MastraClient[M]>> };\n\n/** A request's answer, tagged with the method that produced it so a widget narrows it by `method`. */\nexport type DashboardAnswer = {\n  [M in DashboardRequestMethod]: { method: M; data: Answers[M] };\n}[DashboardRequestMethod];\n\n/**\n * Where a request's answer stands, as plain data: what a widget renders from, whoever fetched it.\n * `isLoading` has no answer yet; `isRefetching` has one and is fetching it again.\n */\nexport type DashboardResult = {\n  data?: DashboardAnswer;\n  isLoading: boolean;\n  isRefetching: boolean;\n  isError: boolean;\n  error?: unknown;\n};\n\ntype TraceWhere = NonNullable<AggregateTracesArgs['where']>;\ntype SpanWhere = NonNullable<AggregateSpansArgs['where']>;\n\n/** What the page adds to every widget's query: its frozen window and its filter bar. */\nexport type DashboardPageContext = {\n  window: Window;\n  /** The page's metrics and scores filters, `timestamp` included. */\n  filters: MetricsQueryFilters['filters'];\n  /** The filter bar as trace and span predicates, from the aggregate gates. */\n  traceWhere?: TraceWhere;\n  spanWhere?: SpanWhere;\n};\n\n/** How the widget kind sends a query. */\nexport type DashboardRequestOptions = {\n  /** The bucket size, for a query that doesn't set its own. Unset sends the query as written. */\n  interval?: Interval;\n};\n\n/** The widget's predicate and the page's, both required; the widget's comes first. */\nfunction andTrace(widget: TraceWhere | undefined, page: TraceWhere | undefined): TraceWhere | undefined {\n  return widget && page ? { op: 'and', args: [widget, page] } : (widget ?? page);\n}\n\nfunction andSpan(widget: SpanWhere | undefined, page: SpanWhere | undefined): SpanWhere | undefined {\n  return widget && page ? { op: 'and', args: [widget, page] } : (widget ?? page);\n}\n\ntype ValuesQuery = Extract<DashboardQuery, { source: 'metrics' | 'scores' }>;\n\n/**\n * A metrics or scores query's args, the page's filters intersected with its own, over `window`;\n * `unsatisfiable` when they contradict.\n */\nfunction valuesArgs<Q extends ValuesQuery>(query: Q, page: DashboardPageContext, window: Window) {\n  const { source: _source, id: _id, request, compare, filters, ...rest } = query;\n  const combined = intersectFilters(page.filters, filters);\n  return {\n    unsatisfiable: combined === undefined ? (true as const) : undefined,\n    args: {\n      ...rest,\n      filters: { ...(combined ?? page.filters), timestamp: window },\n      // An aggregate compares in the same request; anything else sends a second one over `window`.\n      comparePeriod: request === 'aggregate' && compare === 'previousWindow' ? ('previous_period' as const) : undefined,\n    },\n  };\n}\n\n/**\n * The query with the page's filter bar ANDed in, as `buildRequest` applies it, but without the time\n * window: trace and span predicates joined with `and`, metrics and scores filters intersected.\n * `'unsatisfiable'` when the filters contradict, so nothing can match.\n */\nexport function pageQuery(query: DashboardQuery, page: DashboardPageContext): DashboardQuery | 'unsatisfiable' {\n  if (query.source === 'traceAggregate') {\n    const where = andTrace(query.where, page.traceWhere);\n    return where ? { ...query, where } : query;\n  }\n  if (query.source === 'spanAggregate') {\n    const where = andSpan(query.where, page.spanWhere);\n    return where ? { ...query, where } : query;\n  }\n  const combined = intersectFilters(page.filters, query.filters);\n  if (combined === undefined) return 'unsatisfiable';\n  const { timestamp: _timestamp, ...filters } = combined;\n  const { filters: _own, ...rest } = query;\n  return Object.keys(filters).length > 0 ? { ...rest, filters } : rest;\n}\n\n/** A bucketed request's interval: its own, else the kind's, else the bar charts' for `window`. */\nfunction bucketOf<I extends string>(own: I | undefined, interval: Interval | undefined, window: Window) {\n  return own ?? interval ?? bucketPlan(window.start, window.end).interval;\n}\n\n/**\n * The request a query sends over `window`, the page's filters ANDed with the widget's: trace and span\n * predicates are joined with `and`; metrics and scores filters intersect (`intersectFilters`), and a\n * contradiction marks the request unsatisfiable. A scores query without a scorer sends nothing: the\n * `scores` kind expands it per scorer first.\n */\nexport function buildRequest(\n  query: DashboardQuery,\n  page: DashboardPageContext,\n  { interval }: DashboardRequestOptions,\n  window: Window = page.window,\n  priority?: AggregatePriority,\n): DashboardRequest | undefined {\n  if (query.source === 'traceAggregate') {\n    const { source: _source, id: _id, compare: _compare, where, interval: own, ...rest } = query;\n    return {\n      method: 'aggregateTraces',\n      args: {\n        timeRange: toTraceAggregateTimeRange(window),\n        ...rest,\n        interval: own ?? interval,\n        where: andTrace(where, page.traceWhere),\n      },\n      priority,\n    };\n  }\n  if (query.source === 'spanAggregate') {\n    const { source: _source, id: _id, compare: _compare, where, interval: own, ...rest } = query;\n    return {\n      method: 'aggregateSpans',\n      args: {\n        timeRange: toTraceAggregateTimeRange(window),\n        ...rest,\n        interval: own ?? interval,\n        where: andSpan(where, page.spanWhere),\n      },\n      priority,\n    };\n  }\n  if (query.source === 'metrics') {\n    switch (query.request) {\n      case 'aggregate': {\n        const { args, unsatisfiable } = valuesArgs(query, page, window);\n        return { method: 'getMetricAggregate', args, unsatisfiable };\n      }\n      case 'breakdown': {\n        const { args, unsatisfiable } = valuesArgs(query, page, window);\n        return { method: 'getMetricBreakdown', args, unsatisfiable };\n      }\n      case 'timeSeries': {\n        const { args, unsatisfiable } = valuesArgs(query, page, window);\n        const bucketed = { ...args, interval: bucketOf(query.interval, interval, window) };\n        return { method: 'getMetricTimeSeries', args: bucketed, unsatisfiable };\n      }\n      case 'percentiles': {\n        const { args, unsatisfiable } = valuesArgs(query, page, window);\n        const bucketed = { ...args, interval: bucketOf(query.interval, interval, window) };\n        return { method: 'getMetricPercentiles', args: bucketed, unsatisfiable };\n      }\n    }\n  }\n  const { scorerId } = query;\n  if (scorerId === undefined) return undefined;\n  switch (query.request) {\n    case 'aggregate': {\n      const { args, unsatisfiable } = valuesArgs(query, page, window);\n      return { method: 'getScoreAggregate', args: { ...args, scorerId }, unsatisfiable };\n    }\n    case 'breakdown': {\n      const { args, unsatisfiable } = valuesArgs(query, page, window);\n      return { method: 'getScoreBreakdown', args: { ...args, scorerId }, unsatisfiable };\n    }\n    case 'timeSeries': {\n      const { args, unsatisfiable } = valuesArgs(query, page, window);\n      const bucketed = { ...args, scorerId, interval: bucketOf(query.interval, interval, window) };\n      return { method: 'getScoreTimeSeries', args: bucketed, unsatisfiable };\n    }\n    case 'percentiles': {\n      const { args, unsatisfiable } = valuesArgs(query, page, window);\n      const bucketed = { ...args, scorerId, interval: bucketOf(query.interval, interval, window) };\n      return { method: 'getScorePercentiles', args: bucketed, unsatisfiable };\n    }\n  }\n}\n\n/** Whether a query asks for the previous window as a request of its own. */\nexport function sendsPreviousRequest(query: DashboardQuery) {\n  if (query.compare !== 'previousWindow') return false;\n  return !((query.source === 'metrics' || query.source === 'scores') && query.request === 'aggregate');\n}\n\n/** The previous window's request, sent last so the widget never waits on it. */\nexport function buildPreviousRequest(\n  query: DashboardQuery,\n  page: DashboardPageContext,\n  options: DashboardRequestOptions,\n): DashboardRequest | undefined {\n  if (!sendsPreviousRequest(query)) return undefined;\n  return buildRequest(query, page, options, previousWindow(page.window), AGGREGATE_PRIORITY.last);\n}\n\n/** What an unsatisfiable request answers: nothing matched. */\nexport function emptyAnswer(method: DashboardRequestMethod): DashboardAnswer {\n  switch (method) {\n    case 'aggregateTraces':\n    case 'aggregateSpans':\n      return { method, data: { rows: [], truncated: false } };\n    case 'getMetricAggregate':\n    case 'getScoreAggregate':\n      return { method, data: { value: null } };\n    case 'getMetricBreakdown':\n    case 'getScoreBreakdown':\n      return { method, data: { groups: [] } };\n    case 'getMetricTimeSeries':\n    case 'getMetricPercentiles':\n    case 'getScoreTimeSeries':\n    case 'getScorePercentiles':\n      return { method, data: { series: [] } };\n    case 'listScores':\n      return { method, data: { scores: [], pagination: { total: 0, page: 0, perPage: 0, hasMore: false } } };\n  }\n}\n\n/** Runs a request on the client; an unsatisfiable one answers empty without a call. */\nexport async function sendRequest(client: MastraClient, request: DashboardRequest): Promise<DashboardAnswer> {\n  if (request.unsatisfiable) return emptyAnswer(request.method);\n  switch (request.method) {\n    case 'aggregateTraces':\n      return { method: request.method, data: await client.aggregateTraces(request.args) };\n    case 'aggregateSpans':\n      return { method: request.method, data: await client.aggregateSpans(request.args) };\n    case 'getMetricAggregate':\n      return { method: request.method, data: await client.getMetricAggregate(request.args) };\n    case 'getMetricBreakdown':\n      return { method: request.method, data: await client.getMetricBreakdown(request.args) };\n    case 'getMetricTimeSeries':\n      return { method: request.method, data: await client.getMetricTimeSeries(request.args) };\n    case 'getMetricPercentiles':\n      return { method: request.method, data: await client.getMetricPercentiles(request.args) };\n    case 'getScoreAggregate':\n      return { method: request.method, data: await client.getScoreAggregate(request.args) };\n    case 'getScoreBreakdown':\n      return { method: request.method, data: await client.getScoreBreakdown(request.args) };\n    case 'getScoreTimeSeries':\n      return { method: request.method, data: await client.getScoreTimeSeries(request.args) };\n    case 'getScorePercentiles':\n      return { method: request.method, data: await client.getScorePercentiles(request.args) };\n    case 'listScores':\n      return { method: request.method, data: await client.listScores(request.args) };\n  }\n}\n\n/**\n * The React Query key. Answers are cached tagged with their method, so they live under the dashboards'\n * own keys rather than `useTraceAggregate`'s, whose entries hold the bare response.\n */\nexport function requestKey(request: DashboardRequest): readonly unknown[] {\n  if (request.unsatisfiable) return ['dashboards', 'unsatisfiable', request.method];\n  return ['dashboards', request.method, request.args];\n}\n\n/** Whether a query needs the trace or span aggregate gate. */\nexport const aggregateSource = (query: DashboardQuery) =>\n  query.source === 'traceAggregate' ? 'trace' : query.source === 'spanAggregate' ? 'span' : undefined;\n"],"mappings":"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"}

package/dist/domains/dashboards/lib/scores.cjs.js

@@ -21,6 +21,36 @@ function discoveredScorers(scores) {
 		name: names.get(scorerId) ?? scorerId
 	}));
 }
+/** How many recent scores to read to find the scorers in the range (the API's page limit). */
+var DISCOVERY_PAGE_SIZE = 100;
+/**
+* The range's most recent scores, read to find the scorers when the queries leave theirs out (the API
+* can't list scorers); `undefined` when they name their own.
+*/
+function scorerDiscoveryRequest(queries, page) {
+	if (!queries.some(needsScorer)) return void 0;
+	return {
+		method: "listScores",
+		args: {
+			filters: page.filters,
+			pagination: {
+				page: 0,
+				perPage: DISCOVERY_PAGE_SIZE
+			}
+		}
+	};
+}
+/**
+* The scorers to chart: the queries' own scorer, or, when they leave it out, every scorer among the
+* discovery request's answer, as the Scores card finds them.
+*/
+function scorersOf(queries, discovery) {
+	if (!queries.some(needsScorer)) return ownScorers(queries);
+	return discoveredScorers((discovery?.method === "listScores" ? discovery.data.scores : []).map((s) => ({
+		scorerId: s.scorerId,
+		scorerName: s.scorerName ?? void 0
+	})));
+}
 /** The query for one scorer: its own scorer if it names one, else `scorerId`. */
 var withScorer = (query, scorerId) => query?.source === "scores" && query.scorerId === void 0 ? {
 	...query,
@@ -52,6 +82,8 @@ function shapeScores(scorers, means, points, window, stepHours) {
 exports.discoveredScorers = discoveredScorers;
 exports.needsScorer = needsScorer;
 exports.ownScorers = ownScorers;
+exports.scorerDiscoveryRequest = scorerDiscoveryRequest;
+exports.scorersOf = scorersOf;
 exports.shapeScores = shapeScores;
 exports.withScorer = withScorer;
 

package/dist/domains/dashboards/lib/scores.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"scores.cjs.js","names":["bucketGrid","gridIndex","seriesOf","valueOf"],"sources":["../../../../src/domains/dashboards/lib/scores.ts"],"sourcesContent":["import type { DashboardQuery } from '@mastra/client-js';\nimport type { BucketLabels } from '../../metrics/lib/bucket-labels';\nimport { bucketGrid, gridIndex } from '../../metrics/lib/metrics-buckets';\nimport { seriesOf, valueOf } from './answers';\nimport type { DashboardAnswer } from './requests';\n\nexport type Scorer = { scorerId: string; name: string };\n\nexport type ScoresBucket = BucketLabels & Record<string, number | string | undefined>;\n\n/** Whether the query leaves its scorer out, so the widget has to find the scorers itself. */\nexport const needsScorer = (query: DashboardQuery | undefined) =>\n  query?.source === 'scores' && query.scorerId === undefined;\n\n/** The scorer the view's queries name themselves, when none of them leaves it out. */\nexport function ownScorers(queries: DashboardQuery[]): Scorer[] {\n  const own = queries.find(q => q.source === 'scores' && q.scorerId);\n  const scorerId = own?.source === 'scores' ? own.scorerId : undefined;\n  return scorerId ? [{ scorerId, name: scorerId }] : [];\n}\n\n/** Every scorer among the recent scores, sorted by id, named as the scores name them. */\nexport function discoveredScorers(scores: { scorerId: string; scorerName?: string }[]): Scorer[] {\n  const names = new Map(scores.map(s => [s.scorerId, s.scorerName ?? s.scorerId]));\n  return [...names.keys()].toSorted().map(scorerId => ({ scorerId, name: names.get(scorerId) ?? scorerId }));\n}\n\n/** The query for one scorer: its own scorer if it names one, else `scorerId`. */\nexport const withScorer = (query: DashboardQuery | undefined, scorerId: string): DashboardQuery | undefined =>\n  query?.source === 'scores' && query.scorerId === undefined ? { ...query, scorerId } : query;\n\n/**\n * Lays each scorer's points on the window's bucket grid, keyed by scorer id, and reads each scorer's\n * mean (0 when the aggregate has no value, as the Scores card shows it). `means` and `points` hold\n * one answer per scorer, in `scorers`' order.\n */\nexport function shapeScores(\n  scorers: Scorer[],\n  means: (DashboardAnswer | undefined)[],\n  points: (DashboardAnswer | undefined)[],\n  window: { start: Date; end: Date },\n  stepHours: number,\n) {\n  const buckets: ScoresBucket[] = bucketGrid(window.start, window.end, stepHours);\n  const indexOf = gridIndex(buckets, stepHours);\n  scorers.forEach(({ scorerId }, i) => {\n    for (const s of seriesOf(points[i]) ?? []) {\n      for (const p of s.points) {\n        const at = indexOf(p);\n        const bucket = at === undefined ? undefined : buckets[at];\n        if (bucket) bucket[scorerId] = p.value;\n      }\n    }\n  });\n  const lines = scorers.map((scorer, i) => ({ ...scorer, mean: valueOf(means[i])?.value ?? 0 }));\n  return { buckets, lines };\n}\n"],"mappings":";;;;;AAWA,IAAa,eAAe,UAC1B,OAAO,WAAW,YAAY,MAAM,aAAa,KAAA;;AAGnD,SAAgB,WAAW,SAAqC;CAC9D,MAAM,MAAM,QAAQ,MAAK,MAAK,EAAE,WAAW,YAAY,EAAE,QAAQ;CACjE,MAAM,WAAW,KAAK,WAAW,WAAW,IAAI,WAAW,KAAA;CAC3D,OAAO,WAAW,CAAC;EAAE;EAAU,MAAM;CAAS,CAAC,IAAI,CAAC;AACtD;;AAGA,SAAgB,kBAAkB,QAA+D;CAC/F,MAAM,QAAQ,IAAI,IAAI,OAAO,KAAI,MAAK,CAAC,EAAE,UAAU,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;CAC/E,OAAO,CAAC,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,KAAI,cAAa;EAAE;EAAU,MAAM,MAAM,IAAI,QAAQ,KAAK;CAAS,EAAE;AAC3G;;AAGA,IAAa,cAAc,OAAmC,aAC5D,OAAO,WAAW,YAAY,MAAM,aAAa,KAAA,IAAY;CAAE,GAAG;CAAO;AAAS,IAAI;;;;;;AAOxF,SAAgB,YACd,SACA,OACA,QACA,QACA,WACA;CACA,MAAM,UAA0BA,4CAAAA,WAAW,OAAO,OAAO,OAAO,KAAK,SAAS;CAC9E,MAAM,UAAUC,4CAAAA,UAAU,SAAS,SAAS;CAC5C,QAAQ,SAAS,EAAE,YAAY,MAAM;EACnC,KAAK,MAAM,KAAKC,uCAAAA,SAAS,OAAO,EAAE,KAAK,CAAC,GACtC,KAAK,MAAM,KAAK,EAAE,QAAQ;GACxB,MAAM,KAAK,QAAQ,CAAC;GACpB,MAAM,SAAS,OAAO,KAAA,IAAY,KAAA,IAAY,QAAQ;GACtD,IAAI,QAAQ,OAAO,YAAY,EAAE;EACnC;CAEJ,CAAC;CAED,OAAO;EAAE;EAAS,OADJ,QAAQ,KAAK,QAAQ,OAAO;GAAE,GAAG;GAAQ,MAAMC,uCAAAA,QAAQ,MAAM,EAAE,CAAC,EAAE,SAAS;EAAE,EACzE;CAAM;AAC1B"}
+{"version":3,"file":"scores.cjs.js","names":["bucketGrid","gridIndex","seriesOf","valueOf"],"sources":["../../../../src/domains/dashboards/lib/scores.ts"],"sourcesContent":["import type { DashboardQuery } from '@mastra/client-js';\nimport type { BucketLabels } from '../../metrics/lib/bucket-labels';\nimport { bucketGrid, gridIndex } from '../../metrics/lib/metrics-buckets';\nimport { seriesOf, valueOf } from './answers';\nimport type { DashboardAnswer, DashboardPageContext, DashboardRequest } from './requests';\n\nexport type Scorer = { scorerId: string; name: string };\n\nexport type ScoresBucket = BucketLabels & Record<string, number | string | undefined>;\n\n/** Whether the query leaves its scorer out, so the widget has to find the scorers itself. */\nexport const needsScorer = (query: DashboardQuery | undefined) =>\n  query?.source === 'scores' && query.scorerId === undefined;\n\n/** The scorer the view's queries name themselves, when none of them leaves it out. */\nexport function ownScorers(queries: DashboardQuery[]): Scorer[] {\n  const own = queries.find(q => q.source === 'scores' && q.scorerId);\n  const scorerId = own?.source === 'scores' ? own.scorerId : undefined;\n  return scorerId ? [{ scorerId, name: scorerId }] : [];\n}\n\n/** Every scorer among the recent scores, sorted by id, named as the scores name them. */\nexport function discoveredScorers(scores: { scorerId: string; scorerName?: string }[]): Scorer[] {\n  const names = new Map(scores.map(s => [s.scorerId, s.scorerName ?? s.scorerId]));\n  return [...names.keys()].toSorted().map(scorerId => ({ scorerId, name: names.get(scorerId) ?? scorerId }));\n}\n\n/** How many recent scores to read to find the scorers in the range (the API's page limit). */\nconst DISCOVERY_PAGE_SIZE = 100;\n\n/**\n * The range's most recent scores, read to find the scorers when the queries leave theirs out (the API\n * can't list scorers); `undefined` when they name their own.\n */\nexport function scorerDiscoveryRequest(\n  queries: DashboardQuery[],\n  page: DashboardPageContext,\n): DashboardRequest | undefined {\n  if (!queries.some(needsScorer)) return undefined;\n  return {\n    method: 'listScores',\n    args: { filters: page.filters, pagination: { page: 0, perPage: DISCOVERY_PAGE_SIZE } },\n  };\n}\n\n/**\n * The scorers to chart: the queries' own scorer, or, when they leave it out, every scorer among the\n * discovery request's answer, as the Scores card finds them.\n */\nexport function scorersOf(queries: DashboardQuery[], discovery: DashboardAnswer | undefined): Scorer[] {\n  if (!queries.some(needsScorer)) return ownScorers(queries);\n  const scores = discovery?.method === 'listScores' ? discovery.data.scores : [];\n  return discoveredScorers(scores.map(s => ({ scorerId: s.scorerId, scorerName: s.scorerName ?? undefined })));\n}\n\n/** The query for one scorer: its own scorer if it names one, else `scorerId`. */\nexport const withScorer = (query: DashboardQuery | undefined, scorerId: string): DashboardQuery | undefined =>\n  query?.source === 'scores' && query.scorerId === undefined ? { ...query, scorerId } : query;\n\n/**\n * Lays each scorer's points on the window's bucket grid, keyed by scorer id, and reads each scorer's\n * mean (0 when the aggregate has no value, as the Scores card shows it). `means` and `points` hold\n * one answer per scorer, in `scorers`' order.\n */\nexport function shapeScores(\n  scorers: Scorer[],\n  means: (DashboardAnswer | undefined)[],\n  points: (DashboardAnswer | undefined)[],\n  window: { start: Date; end: Date },\n  stepHours: number,\n) {\n  const buckets: ScoresBucket[] = bucketGrid(window.start, window.end, stepHours);\n  const indexOf = gridIndex(buckets, stepHours);\n  scorers.forEach(({ scorerId }, i) => {\n    for (const s of seriesOf(points[i]) ?? []) {\n      for (const p of s.points) {\n        const at = indexOf(p);\n        const bucket = at === undefined ? undefined : buckets[at];\n        if (bucket) bucket[scorerId] = p.value;\n      }\n    }\n  });\n  const lines = scorers.map((scorer, i) => ({ ...scorer, mean: valueOf(means[i])?.value ?? 0 }));\n  return { buckets, lines };\n}\n"],"mappings":";;;;;AAWA,IAAa,eAAe,UAC1B,OAAO,WAAW,YAAY,MAAM,aAAa,KAAA;;AAGnD,SAAgB,WAAW,SAAqC;CAC9D,MAAM,MAAM,QAAQ,MAAK,MAAK,EAAE,WAAW,YAAY,EAAE,QAAQ;CACjE,MAAM,WAAW,KAAK,WAAW,WAAW,IAAI,WAAW,KAAA;CAC3D,OAAO,WAAW,CAAC;EAAE;EAAU,MAAM;CAAS,CAAC,IAAI,CAAC;AACtD;;AAGA,SAAgB,kBAAkB,QAA+D;CAC/F,MAAM,QAAQ,IAAI,IAAI,OAAO,KAAI,MAAK,CAAC,EAAE,UAAU,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;CAC/E,OAAO,CAAC,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,KAAI,cAAa;EAAE;EAAU,MAAM,MAAM,IAAI,QAAQ,KAAK;CAAS,EAAE;AAC3G;;AAGA,IAAM,sBAAsB;;;;;AAM5B,SAAgB,uBACd,SACA,MAC8B;CAC9B,IAAI,CAAC,QAAQ,KAAK,WAAW,GAAG,OAAO,KAAA;CACvC,OAAO;EACL,QAAQ;EACR,MAAM;GAAE,SAAS,KAAK;GAAS,YAAY;IAAE,MAAM;IAAG,SAAS;GAAoB;EAAE;CACvF;AACF;;;;;AAMA,SAAgB,UAAU,SAA2B,WAAkD;CACrG,IAAI,CAAC,QAAQ,KAAK,WAAW,GAAG,OAAO,WAAW,OAAO;CAEzD,OAAO,mBADQ,WAAW,WAAW,eAAe,UAAU,KAAK,SAAS,CAAC,EAAA,CAC7C,KAAI,OAAM;EAAE,UAAU,EAAE;EAAU,YAAY,EAAE,cAAc,KAAA;CAAU,EAAE,CAAC;AAC7G;;AAGA,IAAa,cAAc,OAAmC,aAC5D,OAAO,WAAW,YAAY,MAAM,aAAa,KAAA,IAAY;CAAE,GAAG;CAAO;AAAS,IAAI;;;;;;AAOxF,SAAgB,YACd,SACA,OACA,QACA,QACA,WACA;CACA,MAAM,UAA0BA,4CAAAA,WAAW,OAAO,OAAO,OAAO,KAAK,SAAS;CAC9E,MAAM,UAAUC,4CAAAA,UAAU,SAAS,SAAS;CAC5C,QAAQ,SAAS,EAAE,YAAY,MAAM;EACnC,KAAK,MAAM,KAAKC,uCAAAA,SAAS,OAAO,EAAE,KAAK,CAAC,GACtC,KAAK,MAAM,KAAK,EAAE,QAAQ;GACxB,MAAM,KAAK,QAAQ,CAAC;GACpB,MAAM,SAAS,OAAO,KAAA,IAAY,KAAA,IAAY,QAAQ;GACtD,IAAI,QAAQ,OAAO,YAAY,EAAE;EACnC;CAEJ,CAAC;CAED,OAAO;EAAE;EAAS,OADJ,QAAQ,KAAK,QAAQ,OAAO;GAAE,GAAG;GAAQ,MAAMC,uCAAAA,QAAQ,MAAM,EAAE,CAAC,EAAE,SAAS;EAAE,EACzE;CAAM;AAC1B"}

package/dist/domains/dashboards/lib/scores.es.js

@@ -20,6 +20,36 @@ function discoveredScorers(scores) {
 		name: names.get(scorerId) ?? scorerId
 	}));
 }
+/** How many recent scores to read to find the scorers in the range (the API's page limit). */
+var DISCOVERY_PAGE_SIZE = 100;
+/**
+* The range's most recent scores, read to find the scorers when the queries leave theirs out (the API
+* can't list scorers); `undefined` when they name their own.
+*/
+function scorerDiscoveryRequest(queries, page) {
+	if (!queries.some(needsScorer)) return void 0;
+	return {
+		method: "listScores",
+		args: {
+			filters: page.filters,
+			pagination: {
+				page: 0,
+				perPage: DISCOVERY_PAGE_SIZE
+			}
+		}
+	};
+}
+/**
+* The scorers to chart: the queries' own scorer, or, when they leave it out, every scorer among the
+* discovery request's answer, as the Scores card finds them.
+*/
+function scorersOf(queries, discovery) {
+	if (!queries.some(needsScorer)) return ownScorers(queries);
+	return discoveredScorers((discovery?.method === "listScores" ? discovery.data.scores : []).map((s) => ({
+		scorerId: s.scorerId,
+		scorerName: s.scorerName ?? void 0
+	})));
+}
 /** The query for one scorer: its own scorer if it names one, else `scorerId`. */
 var withScorer = (query, scorerId) => query?.source === "scores" && query.scorerId === void 0 ? {
 	...query,
@@ -48,6 +78,6 @@ function shapeScores(scorers, means, points, window, stepHours) {
 		}))
 	};
 }
-export { discoveredScorers, needsScorer, ownScorers, shapeScores, withScorer };
+export { discoveredScorers, needsScorer, ownScorers, scorerDiscoveryRequest, scorersOf, shapeScores, withScorer };
 
 //# sourceMappingURL=scores.es.js.map

package/dist/domains/dashboards/lib/scores.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"scores.es.js","names":[],"sources":["../../../../src/domains/dashboards/lib/scores.ts"],"sourcesContent":["import type { DashboardQuery } from '@mastra/client-js';\nimport type { BucketLabels } from '../../metrics/lib/bucket-labels';\nimport { bucketGrid, gridIndex } from '../../metrics/lib/metrics-buckets';\nimport { seriesOf, valueOf } from './answers';\nimport type { DashboardAnswer } from './requests';\n\nexport type Scorer = { scorerId: string; name: string };\n\nexport type ScoresBucket = BucketLabels & Record<string, number | string | undefined>;\n\n/** Whether the query leaves its scorer out, so the widget has to find the scorers itself. */\nexport const needsScorer = (query: DashboardQuery | undefined) =>\n  query?.source === 'scores' && query.scorerId === undefined;\n\n/** The scorer the view's queries name themselves, when none of them leaves it out. */\nexport function ownScorers(queries: DashboardQuery[]): Scorer[] {\n  const own = queries.find(q => q.source === 'scores' && q.scorerId);\n  const scorerId = own?.source === 'scores' ? own.scorerId : undefined;\n  return scorerId ? [{ scorerId, name: scorerId }] : [];\n}\n\n/** Every scorer among the recent scores, sorted by id, named as the scores name them. */\nexport function discoveredScorers(scores: { scorerId: string; scorerName?: string }[]): Scorer[] {\n  const names = new Map(scores.map(s => [s.scorerId, s.scorerName ?? s.scorerId]));\n  return [...names.keys()].toSorted().map(scorerId => ({ scorerId, name: names.get(scorerId) ?? scorerId }));\n}\n\n/** The query for one scorer: its own scorer if it names one, else `scorerId`. */\nexport const withScorer = (query: DashboardQuery | undefined, scorerId: string): DashboardQuery | undefined =>\n  query?.source === 'scores' && query.scorerId === undefined ? { ...query, scorerId } : query;\n\n/**\n * Lays each scorer's points on the window's bucket grid, keyed by scorer id, and reads each scorer's\n * mean (0 when the aggregate has no value, as the Scores card shows it). `means` and `points` hold\n * one answer per scorer, in `scorers`' order.\n */\nexport function shapeScores(\n  scorers: Scorer[],\n  means: (DashboardAnswer | undefined)[],\n  points: (DashboardAnswer | undefined)[],\n  window: { start: Date; end: Date },\n  stepHours: number,\n) {\n  const buckets: ScoresBucket[] = bucketGrid(window.start, window.end, stepHours);\n  const indexOf = gridIndex(buckets, stepHours);\n  scorers.forEach(({ scorerId }, i) => {\n    for (const s of seriesOf(points[i]) ?? []) {\n      for (const p of s.points) {\n        const at = indexOf(p);\n        const bucket = at === undefined ? undefined : buckets[at];\n        if (bucket) bucket[scorerId] = p.value;\n      }\n    }\n  });\n  const lines = scorers.map((scorer, i) => ({ ...scorer, mean: valueOf(means[i])?.value ?? 0 }));\n  return { buckets, lines };\n}\n"],"mappings":";;;;AAWA,IAAa,eAAe,UAC1B,OAAO,WAAW,YAAY,MAAM,aAAa,KAAA;;AAGnD,SAAgB,WAAW,SAAqC;CAC9D,MAAM,MAAM,QAAQ,MAAK,MAAK,EAAE,WAAW,YAAY,EAAE,QAAQ;CACjE,MAAM,WAAW,KAAK,WAAW,WAAW,IAAI,WAAW,KAAA;CAC3D,OAAO,WAAW,CAAC;EAAE;EAAU,MAAM;CAAS,CAAC,IAAI,CAAC;AACtD;;AAGA,SAAgB,kBAAkB,QAA+D;CAC/F,MAAM,QAAQ,IAAI,IAAI,OAAO,KAAI,MAAK,CAAC,EAAE,UAAU,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;CAC/E,OAAO,CAAC,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,KAAI,cAAa;EAAE;EAAU,MAAM,MAAM,IAAI,QAAQ,KAAK;CAAS,EAAE;AAC3G;;AAGA,IAAa,cAAc,OAAmC,aAC5D,OAAO,WAAW,YAAY,MAAM,aAAa,KAAA,IAAY;CAAE,GAAG;CAAO;AAAS,IAAI;;;;;;AAOxF,SAAgB,YACd,SACA,OACA,QACA,QACA,WACA;CACA,MAAM,UAA0B,WAAW,OAAO,OAAO,OAAO,KAAK,SAAS;CAC9E,MAAM,UAAU,UAAU,SAAS,SAAS;CAC5C,QAAQ,SAAS,EAAE,YAAY,MAAM;EACnC,KAAK,MAAM,KAAK,SAAS,OAAO,EAAE,KAAK,CAAC,GACtC,KAAK,MAAM,KAAK,EAAE,QAAQ;GACxB,MAAM,KAAK,QAAQ,CAAC;GACpB,MAAM,SAAS,OAAO,KAAA,IAAY,KAAA,IAAY,QAAQ;GACtD,IAAI,QAAQ,OAAO,YAAY,EAAE;EACnC;CAEJ,CAAC;CAED,OAAO;EAAE;EAAS,OADJ,QAAQ,KAAK,QAAQ,OAAO;GAAE,GAAG;GAAQ,MAAM,QAAQ,MAAM,EAAE,CAAC,EAAE,SAAS;EAAE,EACzE;CAAM;AAC1B"}
+{"version":3,"file":"scores.es.js","names":[],"sources":["../../../../src/domains/dashboards/lib/scores.ts"],"sourcesContent":["import type { DashboardQuery } from '@mastra/client-js';\nimport type { BucketLabels } from '../../metrics/lib/bucket-labels';\nimport { bucketGrid, gridIndex } from '../../metrics/lib/metrics-buckets';\nimport { seriesOf, valueOf } from './answers';\nimport type { DashboardAnswer, DashboardPageContext, DashboardRequest } from './requests';\n\nexport type Scorer = { scorerId: string; name: string };\n\nexport type ScoresBucket = BucketLabels & Record<string, number | string | undefined>;\n\n/** Whether the query leaves its scorer out, so the widget has to find the scorers itself. */\nexport const needsScorer = (query: DashboardQuery | undefined) =>\n  query?.source === 'scores' && query.scorerId === undefined;\n\n/** The scorer the view's queries name themselves, when none of them leaves it out. */\nexport function ownScorers(queries: DashboardQuery[]): Scorer[] {\n  const own = queries.find(q => q.source === 'scores' && q.scorerId);\n  const scorerId = own?.source === 'scores' ? own.scorerId : undefined;\n  return scorerId ? [{ scorerId, name: scorerId }] : [];\n}\n\n/** Every scorer among the recent scores, sorted by id, named as the scores name them. */\nexport function discoveredScorers(scores: { scorerId: string; scorerName?: string }[]): Scorer[] {\n  const names = new Map(scores.map(s => [s.scorerId, s.scorerName ?? s.scorerId]));\n  return [...names.keys()].toSorted().map(scorerId => ({ scorerId, name: names.get(scorerId) ?? scorerId }));\n}\n\n/** How many recent scores to read to find the scorers in the range (the API's page limit). */\nconst DISCOVERY_PAGE_SIZE = 100;\n\n/**\n * The range's most recent scores, read to find the scorers when the queries leave theirs out (the API\n * can't list scorers); `undefined` when they name their own.\n */\nexport function scorerDiscoveryRequest(\n  queries: DashboardQuery[],\n  page: DashboardPageContext,\n): DashboardRequest | undefined {\n  if (!queries.some(needsScorer)) return undefined;\n  return {\n    method: 'listScores',\n    args: { filters: page.filters, pagination: { page: 0, perPage: DISCOVERY_PAGE_SIZE } },\n  };\n}\n\n/**\n * The scorers to chart: the queries' own scorer, or, when they leave it out, every scorer among the\n * discovery request's answer, as the Scores card finds them.\n */\nexport function scorersOf(queries: DashboardQuery[], discovery: DashboardAnswer | undefined): Scorer[] {\n  if (!queries.some(needsScorer)) return ownScorers(queries);\n  const scores = discovery?.method === 'listScores' ? discovery.data.scores : [];\n  return discoveredScorers(scores.map(s => ({ scorerId: s.scorerId, scorerName: s.scorerName ?? undefined })));\n}\n\n/** The query for one scorer: its own scorer if it names one, else `scorerId`. */\nexport const withScorer = (query: DashboardQuery | undefined, scorerId: string): DashboardQuery | undefined =>\n  query?.source === 'scores' && query.scorerId === undefined ? { ...query, scorerId } : query;\n\n/**\n * Lays each scorer's points on the window's bucket grid, keyed by scorer id, and reads each scorer's\n * mean (0 when the aggregate has no value, as the Scores card shows it). `means` and `points` hold\n * one answer per scorer, in `scorers`' order.\n */\nexport function shapeScores(\n  scorers: Scorer[],\n  means: (DashboardAnswer | undefined)[],\n  points: (DashboardAnswer | undefined)[],\n  window: { start: Date; end: Date },\n  stepHours: number,\n) {\n  const buckets: ScoresBucket[] = bucketGrid(window.start, window.end, stepHours);\n  const indexOf = gridIndex(buckets, stepHours);\n  scorers.forEach(({ scorerId }, i) => {\n    for (const s of seriesOf(points[i]) ?? []) {\n      for (const p of s.points) {\n        const at = indexOf(p);\n        const bucket = at === undefined ? undefined : buckets[at];\n        if (bucket) bucket[scorerId] = p.value;\n      }\n    }\n  });\n  const lines = scorers.map((scorer, i) => ({ ...scorer, mean: valueOf(means[i])?.value ?? 0 }));\n  return { buckets, lines };\n}\n"],"mappings":";;;;AAWA,IAAa,eAAe,UAC1B,OAAO,WAAW,YAAY,MAAM,aAAa,KAAA;;AAGnD,SAAgB,WAAW,SAAqC;CAC9D,MAAM,MAAM,QAAQ,MAAK,MAAK,EAAE,WAAW,YAAY,EAAE,QAAQ;CACjE,MAAM,WAAW,KAAK,WAAW,WAAW,IAAI,WAAW,KAAA;CAC3D,OAAO,WAAW,CAAC;EAAE;EAAU,MAAM;CAAS,CAAC,IAAI,CAAC;AACtD;;AAGA,SAAgB,kBAAkB,QAA+D;CAC/F,MAAM,QAAQ,IAAI,IAAI,OAAO,KAAI,MAAK,CAAC,EAAE,UAAU,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;CAC/E,OAAO,CAAC,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,KAAI,cAAa;EAAE;EAAU,MAAM,MAAM,IAAI,QAAQ,KAAK;CAAS,EAAE;AAC3G;;AAGA,IAAM,sBAAsB;;;;;AAM5B,SAAgB,uBACd,SACA,MAC8B;CAC9B,IAAI,CAAC,QAAQ,KAAK,WAAW,GAAG,OAAO,KAAA;CACvC,OAAO;EACL,QAAQ;EACR,MAAM;GAAE,SAAS,KAAK;GAAS,YAAY;IAAE,MAAM;IAAG,SAAS;GAAoB;EAAE;CACvF;AACF;;;;;AAMA,SAAgB,UAAU,SAA2B,WAAkD;CACrG,IAAI,CAAC,QAAQ,KAAK,WAAW,GAAG,OAAO,WAAW,OAAO;CAEzD,OAAO,mBADQ,WAAW,WAAW,eAAe,UAAU,KAAK,SAAS,CAAC,EAAA,CAC7C,KAAI,OAAM;EAAE,UAAU,EAAE;EAAU,YAAY,EAAE,cAAc,KAAA;CAAU,EAAE,CAAC;AAC7G;;AAGA,IAAa,cAAc,OAAmC,aAC5D,OAAO,WAAW,YAAY,MAAM,aAAa,KAAA,IAAY;CAAE,GAAG;CAAO;AAAS,IAAI;;;;;;AAOxF,SAAgB,YACd,SACA,OACA,QACA,QACA,WACA;CACA,MAAM,UAA0B,WAAW,OAAO,OAAO,OAAO,KAAK,SAAS;CAC9E,MAAM,UAAU,UAAU,SAAS,SAAS;CAC5C,QAAQ,SAAS,EAAE,YAAY,MAAM;EACnC,KAAK,MAAM,KAAK,SAAS,OAAO,EAAE,KAAK,CAAC,GACtC,KAAK,MAAM,KAAK,EAAE,QAAQ;GACxB,MAAM,KAAK,QAAQ,CAAC;GACpB,MAAM,SAAS,OAAO,KAAA,IAAY,KAAA,IAAY,QAAQ;GACtD,IAAI,QAAQ,OAAO,YAAY,EAAE;EACnC;CAEJ,CAAC;CAED,OAAO;EAAE;EAAS,OADJ,QAAQ,KAAK,QAAQ,OAAO;GAAE,GAAG;GAAQ,MAAM,QAAQ,MAAM,EAAE,CAAC,EAAE,SAAS;EAAE,EACzE;CAAM;AAC1B"}

package/dist/domains/dashboards/lib/timeseries.cjs.js

@@ -150,6 +150,22 @@ function shapeTimeseries({ options, responses, window, hasTraceQueries }) {
 /** Aggregations whose values for several groups add up to the value for all of them. */
 var ADDITIVE = /* @__PURE__ */ new Set(["sum", "count"]);
 /**
+* The numbers an alert could watch: each series over the range (its `rangeTotal`, else its value),
+* then the card's total when it is an expression.
+*/
+function timeseriesAlertValues(options) {
+	const values = options.series.map((s) => ({
+		label: s.label,
+		value: s.rangeTotal ?? s.value
+	}));
+	const total = options.total?.value;
+	if (total && total !== "total" && !("peak" in total)) values.push({
+		label: "Total",
+		value: total
+	});
+	return values;
+}
+/**
 * What the schema can't say: query ids the view has, bucketed queries that leave their interval to the
 * chart's grid, refs that pick one of the percentiles their query asks for, and refs that pick one group
 * of a grouped aggregation that can't be added up.
@@ -185,6 +201,7 @@ function timeseriesIssues(options, queries) {
 	];
 }
 exports.shapeTimeseries = shapeTimeseries;
+exports.timeseriesAlertValues = timeseriesAlertValues;
 exports.timeseriesIssues = timeseriesIssues;
 exports.timeseriesOptionsSchema = timeseriesOptionsSchema;
 exports.timeseriesSeriesSchema = timeseriesSeriesSchema;

package/dist/domains/dashboards/lib/timeseries.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"timeseries.cjs.js","names":["z","colorSchema","valueExprSchema","formatSchema","queryRefSchema","measureOf","rowsOf","valueOf","bucketPlan","intervalHours","bucketGrid","gridIndex","seriesOf","matchesGroups","evaluate","exprRefs","unknownQueryIssues"],"sources":["../../../../src/domains/dashboards/lib/timeseries.ts"],"sourcesContent":["import type { DashboardQuery } from '@mastra/client-js';\nimport { z } from 'zod/v4';\nimport type { BucketLabels } from '../../metrics/lib/bucket-labels';\nimport { bucketGrid, bucketPlan, gridIndex, intervalHours } from '../../metrics/lib/metrics-buckets';\nimport type { ApiInterval } from '../../metrics/lib/metrics-buckets';\nimport { bucketTraceAggregateRows } from '../../metrics/lib/trace-aggregate';\nimport type { TraceAggregateRow } from '../../metrics/lib/trace-aggregate';\nimport { measureOf, rowsOf, seriesOf, valueOf } from './answers';\nimport type { DashboardAnswer } from './requests';\nimport {\n  colorSchema,\n  evaluate,\n  exprRefs,\n  formatSchema,\n  matchesGroups,\n  queryRefSchema,\n  unknownQueryIssues,\n  valueExprSchema,\n} from './values';\nimport type { ValueExpr, ValueRef } from './values';\n\nexport const timeseriesSeriesSchema = z\n  .object({\n    dataKey: z.string().min(1),\n    label: z.string().min(1),\n    color: colorSchema,\n    emphasis: z.boolean().optional(),\n    /** The series' value per bucket. */\n    value: valueExprSchema,\n    /** The series' value over the whole range, shown beside the card's title marked with the series' color. */\n    rangeTotal: valueExprSchema.optional(),\n    /** Rounds each bucket's value to a whole number. */\n    round: z.boolean().optional(),\n  })\n  .strict();\n\nexport const timeseriesOptionsSchema = z\n  .object({\n    chart: z.enum(['stackedBar', 'line']),\n    format: formatSchema,\n    /** `false` leaves the y-axis to the chart's default labels. */\n    axis: z.boolean().optional(),\n    series: z.array(timeseriesSeriesSchema).min(1),\n    /**\n     * `chart` re-buckets metrics onto the bar charts' grid (sums merge); `api` keeps the API's 1h or 1d\n     * buckets (percentiles and averages can't merge). Trace and span aggregates always keep the API's.\n     */\n    buckets: z.enum(['chart', 'api']).optional(),\n    /** Ids of queries sent over the whole range, without an interval (e.g. distinct counts, which can't be summed). */\n    totals: z.array(queryRefSchema).optional(),\n    /** Hides a series whose range total (or, without one, sum of buckets) is zero. */\n    hideEmpty: z.boolean().optional(),\n    /** Emphasizes the first series shown. */\n    emphasizeFirst: z.boolean().optional(),\n    xLabels: z.literal('edges').optional(),\n    /** The y-axis range when every plotted value is zero. */\n    flatYDomain: z.tuple([z.number(), z.number()]).optional(),\n    yDomain: z.tuple([z.number(), z.number()]).optional(),\n    /** The card's total, beside its title. Ignored when a series has a `rangeTotal`. */\n    total: z\n      .object({\n        /** `total`: every series summed over the range; `peak`: one series' highest bucket; or an expression over range totals. */\n        value: z.union([z.literal('total'), z.object({ peak: z.string().min(1) }).strict(), valueExprSchema]),\n        format: formatSchema.optional(),\n      })\n      .strict()\n      .optional(),\n    emptyMessage: z.string().optional(),\n    /** Empty when this is zero over the range; by default, when every plotted value is zero. */\n    emptyWhenZero: valueExprSchema.optional(),\n  })\n  .strict();\n\nexport type TimeseriesOptions = z.infer<typeof timeseriesOptionsSchema>;\nexport type TimeseriesSeries = z.infer<typeof timeseriesSeriesSchema>;\n\ntype Window = { start: Date; end: Date };\n\nexport type ChartBucket = BucketLabels & Record<string, number | string | undefined>;\n\nexport type ShapedTimeseries = {\n  data: ChartBucket[];\n  /** The series shown, each with its range total when it has one. */\n  series: (Omit<TimeseriesSeries, 'rangeTotal'> & { rangeTotal?: number })[];\n  /** Hours per bucket, for a clicked bucket's window. */\n  stepHours: number;\n  /** The card's total, from `options.total`. */\n  total?: number;\n  /** Every plotted value is zero (or missing). */\n  flat: boolean;\n  /** Nothing to show in the range. */\n  empty: boolean;\n};\n\n/** A ref's value in one trace aggregate row set (ungrouped: one row). */\nfunction fromRows(rows: TraceAggregateRow[], ref: ValueRef) {\n  const { measure } = ref;\n  if (!measure) return undefined;\n  const values = rows.flatMap(r => measureOf(r.measures, measure) ?? []);\n  return values.length ? values.reduce((a, b) => a + b, 0) : undefined;\n}\n\n/** A ref's value over the whole range, from a totals query or the sum of its buckets. */\nfunction rangeValue(answer: DashboardAnswer | undefined, ref: ValueRef, perBucket: (number | undefined)[] | undefined) {\n  const aggregate = rowsOf(answer);\n  if (aggregate && !aggregate.rows.some(r => r.bucket)) return fromRows(aggregate.rows, ref) ?? 0;\n  const value = valueOf(answer);\n  if (value) return (ref.field === 'estimatedCost' ? value.estimatedCost : value.value) ?? undefined;\n  return perBucket?.reduce<number>((sum, v) => sum + (v ?? 0), 0);\n}\n\n/**\n * Lays a timeseries view's answers on the chart's bucket grid. `chart` buckets add every point that\n * falls in a bucket (missing is 0); `api` buckets take the API's point (missing stays unset).\n */\nexport function shapeTimeseries({\n  options,\n  responses,\n  window,\n  hasTraceQueries,\n}: {\n  options: TimeseriesOptions;\n  /** Each query's answer, by query id. */\n  responses: ReadonlyMap<string, DashboardAnswer | undefined>;\n  window: Window;\n  hasTraceQueries: boolean;\n}): ShapedTimeseries {\n  const plan = bucketPlan(window.start, window.end);\n  const merged = !hasTraceQueries && (options.buckets ?? 'chart') === 'chart';\n  const stepHours = merged ? plan.stepHours : intervalHours(plan.interval);\n  const grid: BucketLabels[] = bucketGrid(window.start, window.end, stepHours);\n  const indexOf = gridIndex(grid, stepHours);\n  const totals = new Set(options.totals ?? []);\n\n  const cache = new Map<string, (number | undefined)[]>();\n  const bucketed = (ref: ValueRef): (number | undefined)[] => {\n    const key = JSON.stringify(ref);\n    const hit = cache.get(key);\n    if (hit) return hit;\n    const values: (number | undefined)[] = grid.map(() => (merged ? 0 : undefined));\n    const answer = responses.get(ref.query);\n    const aggregate = rowsOf(answer);\n    if (aggregate) {\n      bucketTraceAggregateRows(aggregate.rows, window).forEach((b, i) => {\n        values[i] = fromRows(b.rows, ref) ?? 0;\n      });\n    }\n    for (const s of seriesOf(answer) ?? []) {\n      if (ref.percentile !== undefined && s.percentile !== ref.percentile) continue;\n      if (!matchesGroups(ref, s.name ?? '')) continue;\n      for (const p of s.points) {\n        const i = indexOf(p);\n        if (i === undefined) continue;\n        const v = ref.field === 'estimatedCost' ? (p.estimatedCost ?? 0) : p.value;\n        // Every series the ref matches adds up (e.g. a grouped count); `api` buckets stay unset until one answers.\n        values[i] = (values[i] ?? 0) + v;\n      }\n    }\n    cache.set(key, values);\n    return values;\n  };\n  const rangeOf = (ref: ValueRef) =>\n    rangeValue(responses.get(ref.query), ref, totals.has(ref.query) ? undefined : bucketed(ref)) ?? 0;\n  const overRange = (expr: ValueExpr) => evaluate(expr, rangeOf) ?? 0;\n\n  const perSeries = options.series.map(s => {\n    const values = grid.map((_, i) => {\n      const v = evaluate(s.value, ref => bucketed(ref)[i]);\n      return v === undefined ? undefined : s.round ? Math.round(v) : v;\n    });\n    const sum = values.reduce<number>((a, v) => a + (v ?? 0), 0);\n    return { s, values, rangeTotal: s.rangeTotal ? overRange(s.rangeTotal) : undefined, sum };\n  });\n\n  const shown = perSeries.filter(p => !options.hideEmpty || (p.rangeTotal ?? p.sum) > 0);\n  const data: ChartBucket[] = grid.map((labels, i) => {\n    const bucket: ChartBucket = { ...labels };\n    for (const p of shown) {\n      const v = p.values[i];\n      if (v !== undefined) bucket[p.s.dataKey] = v;\n    }\n    return bucket;\n  });\n\n  let total: number | undefined;\n  const spec = options.total?.value;\n  if (spec === 'total') total = shown.reduce((a, p) => a + p.sum, 0);\n  else if (spec && 'peak' in spec) {\n    const peak = perSeries.find(p => p.s.dataKey === spec.peak);\n    total = Math.max(0, ...(peak?.values ?? []).map(v => v ?? 0));\n  } else if (spec) total = overRange(spec);\n\n  const flat = shown.every(p => p.values.every(v => !v));\n  return {\n    data,\n    series: shown.map((p, i) => ({\n      ...p.s,\n      emphasis: options.emphasizeFirst ? i === 0 : p.s.emphasis,\n      rangeTotal: p.rangeTotal,\n    })),\n    stepHours,\n    total,\n    flat,\n    empty: options.emptyWhenZero ? overRange(options.emptyWhenZero) === 0 : flat,\n  };\n}\n\n/** Aggregations whose values for several groups add up to the value for all of them. */\nconst ADDITIVE = new Set<string>(['sum', 'count']);\n\n/**\n * What the schema can't say: query ids the view has, bucketed queries that leave their interval to the\n * chart's grid, refs that pick one of the percentiles their query asks for, and refs that pick one group\n * of a grouped aggregation that can't be added up.\n */\nexport function timeseriesIssues(options: TimeseriesOptions, queries: readonly DashboardQuery[]): string[] {\n  const exprs = options.series.flatMap(s => (s.rangeTotal ? [s.value, s.rangeTotal] : [s.value]));\n  const total = options.total?.value;\n  if (total && total !== 'total' && !('peak' in total)) exprs.push(total);\n  if (options.emptyWhenZero) exprs.push(options.emptyWhenZero);\n  const refs = exprs.flatMap(exprRefs);\n  const totals = new Set(options.totals ?? []);\n  const byId = new Map(queries.map(q => [q.id, q]));\n\n  // The chart lays every query on one grid built from the page's range; a query's own interval would\n  // land its points in the wrong buckets.\n  const ownIntervals = queries\n    .filter(q => q.id !== undefined && !totals.has(q.id) && 'interval' in q && q.interval !== undefined)\n    .map(q => `query '${q.id}' sets its own interval; the chart's buckets follow the page's range`);\n  // Percentiles of one metric can't be added up, so a ref must pick one when its query asks for several.\n  const ambiguousPercentiles = refs\n    .filter(r => {\n      const query = byId.get(r.query);\n      return (\n        r.percentile === undefined &&\n        query !== undefined &&\n        'request' in query &&\n        query.request === 'percentiles' &&\n        query.percentiles.length > 1\n      );\n    })\n    .map(r => `a value reading query '${r.query}' must pick one of its percentiles`);\n  const missingPercentiles = refs\n    .filter(r => {\n      const query = byId.get(r.query);\n      return (\n        r.percentile !== undefined &&\n        query !== undefined &&\n        'request' in query &&\n        query.request === 'percentiles' &&\n        !query.percentiles.includes(r.percentile)\n      );\n    })\n    .map(r => `a value reading query '${r.query}' picks percentile ${r.percentile}, which the query doesn't ask for`);\n  // Every series a ref matches adds up, which is only right for counts and sums.\n  const mixedGroups = refs\n    .filter(r => {\n      const query = byId.get(r.query);\n      return (\n        r.groups?.length !== 1 &&\n        query !== undefined &&\n        'request' in query &&\n        query.request === 'timeSeries' &&\n        (query.groupBy?.length ?? 0) > 0 &&\n        !ADDITIVE.has(query.aggregation)\n      );\n    })\n    .map(r => `a value reading query '${r.query}' must pick one group, since its groups' values can't be added up`);\n\n  return [\n    ...unknownQueryIssues(\n      refs.map(r => r.query),\n      queries,\n    ),\n    ...unknownQueryIssues(options.totals ?? [], queries, 'options.totals'),\n    ...ownIntervals,\n    ...new Set(ambiguousPercentiles),\n    ...new Set(missingPercentiles),\n    ...new Set(mixedGroups),\n  ];\n}\n"],"mappings":"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"}
+{"version":3,"file":"timeseries.cjs.js","names":["z","colorSchema","valueExprSchema","formatSchema","queryRefSchema","measureOf","rowsOf","valueOf","bucketPlan","intervalHours","bucketGrid","gridIndex","seriesOf","matchesGroups","evaluate","exprRefs","unknownQueryIssues"],"sources":["../../../../src/domains/dashboards/lib/timeseries.ts"],"sourcesContent":["import type { DashboardQuery } from '@mastra/client-js';\nimport { z } from 'zod/v4';\nimport type { BucketLabels } from '../../metrics/lib/bucket-labels';\nimport { bucketGrid, bucketPlan, gridIndex, intervalHours } from '../../metrics/lib/metrics-buckets';\nimport type { ApiInterval } from '../../metrics/lib/metrics-buckets';\nimport { bucketTraceAggregateRows } from '../../metrics/lib/trace-aggregate';\nimport type { TraceAggregateRow } from '../../metrics/lib/trace-aggregate';\nimport { measureOf, rowsOf, seriesOf, valueOf } from './answers';\nimport type { DashboardAnswer } from './requests';\nimport {\n  colorSchema,\n  evaluate,\n  exprRefs,\n  formatSchema,\n  matchesGroups,\n  queryRefSchema,\n  unknownQueryIssues,\n  valueExprSchema,\n} from './values';\nimport type { LabelledValue, ValueExpr, ValueRef } from './values';\n\nexport const timeseriesSeriesSchema = z\n  .object({\n    dataKey: z.string().min(1),\n    label: z.string().min(1),\n    color: colorSchema,\n    emphasis: z.boolean().optional(),\n    /** The series' value per bucket. */\n    value: valueExprSchema,\n    /** The series' value over the whole range, shown beside the card's title marked with the series' color. */\n    rangeTotal: valueExprSchema.optional(),\n    /** Rounds each bucket's value to a whole number. */\n    round: z.boolean().optional(),\n  })\n  .strict();\n\nexport const timeseriesOptionsSchema = z\n  .object({\n    chart: z.enum(['stackedBar', 'line']),\n    format: formatSchema,\n    /** `false` leaves the y-axis to the chart's default labels. */\n    axis: z.boolean().optional(),\n    series: z.array(timeseriesSeriesSchema).min(1),\n    /**\n     * `chart` re-buckets metrics onto the bar charts' grid (sums merge); `api` keeps the API's 1h or 1d\n     * buckets (percentiles and averages can't merge). Trace and span aggregates always keep the API's.\n     */\n    buckets: z.enum(['chart', 'api']).optional(),\n    /** Ids of queries sent over the whole range, without an interval (e.g. distinct counts, which can't be summed). */\n    totals: z.array(queryRefSchema).optional(),\n    /** Hides a series whose range total (or, without one, sum of buckets) is zero. */\n    hideEmpty: z.boolean().optional(),\n    /** Emphasizes the first series shown. */\n    emphasizeFirst: z.boolean().optional(),\n    xLabels: z.literal('edges').optional(),\n    /** The y-axis range when every plotted value is zero. */\n    flatYDomain: z.tuple([z.number(), z.number()]).optional(),\n    yDomain: z.tuple([z.number(), z.number()]).optional(),\n    /** The card's total, beside its title. Ignored when a series has a `rangeTotal`. */\n    total: z\n      .object({\n        /** `total`: every series summed over the range; `peak`: one series' highest bucket; or an expression over range totals. */\n        value: z.union([z.literal('total'), z.object({ peak: z.string().min(1) }).strict(), valueExprSchema]),\n        format: formatSchema.optional(),\n      })\n      .strict()\n      .optional(),\n    emptyMessage: z.string().optional(),\n    /** Empty when this is zero over the range; by default, when every plotted value is zero. */\n    emptyWhenZero: valueExprSchema.optional(),\n  })\n  .strict();\n\nexport type TimeseriesOptions = z.infer<typeof timeseriesOptionsSchema>;\nexport type TimeseriesSeries = z.infer<typeof timeseriesSeriesSchema>;\n\ntype Window = { start: Date; end: Date };\n\nexport type ChartBucket = BucketLabels & Record<string, number | string | undefined>;\n\nexport type ShapedTimeseries = {\n  data: ChartBucket[];\n  /** The series shown, each with its range total when it has one. */\n  series: (Omit<TimeseriesSeries, 'rangeTotal'> & { rangeTotal?: number })[];\n  /** Hours per bucket, for a clicked bucket's window. */\n  stepHours: number;\n  /** The card's total, from `options.total`. */\n  total?: number;\n  /** Every plotted value is zero (or missing). */\n  flat: boolean;\n  /** Nothing to show in the range. */\n  empty: boolean;\n};\n\n/** A ref's value in one trace aggregate row set (ungrouped: one row). */\nfunction fromRows(rows: TraceAggregateRow[], ref: ValueRef) {\n  const { measure } = ref;\n  if (!measure) return undefined;\n  const values = rows.flatMap(r => measureOf(r.measures, measure) ?? []);\n  return values.length ? values.reduce((a, b) => a + b, 0) : undefined;\n}\n\n/** A ref's value over the whole range, from a totals query or the sum of its buckets. */\nfunction rangeValue(answer: DashboardAnswer | undefined, ref: ValueRef, perBucket: (number | undefined)[] | undefined) {\n  const aggregate = rowsOf(answer);\n  if (aggregate && !aggregate.rows.some(r => r.bucket)) return fromRows(aggregate.rows, ref) ?? 0;\n  const value = valueOf(answer);\n  if (value) return (ref.field === 'estimatedCost' ? value.estimatedCost : value.value) ?? undefined;\n  return perBucket?.reduce<number>((sum, v) => sum + (v ?? 0), 0);\n}\n\n/**\n * Lays a timeseries view's answers on the chart's bucket grid. `chart` buckets add every point that\n * falls in a bucket (missing is 0); `api` buckets take the API's point (missing stays unset).\n */\nexport function shapeTimeseries({\n  options,\n  responses,\n  window,\n  hasTraceQueries,\n}: {\n  options: TimeseriesOptions;\n  /** Each query's answer, by query id. */\n  responses: ReadonlyMap<string, DashboardAnswer | undefined>;\n  window: Window;\n  hasTraceQueries: boolean;\n}): ShapedTimeseries {\n  const plan = bucketPlan(window.start, window.end);\n  const merged = !hasTraceQueries && (options.buckets ?? 'chart') === 'chart';\n  const stepHours = merged ? plan.stepHours : intervalHours(plan.interval);\n  const grid: BucketLabels[] = bucketGrid(window.start, window.end, stepHours);\n  const indexOf = gridIndex(grid, stepHours);\n  const totals = new Set(options.totals ?? []);\n\n  const cache = new Map<string, (number | undefined)[]>();\n  const bucketed = (ref: ValueRef): (number | undefined)[] => {\n    const key = JSON.stringify(ref);\n    const hit = cache.get(key);\n    if (hit) return hit;\n    const values: (number | undefined)[] = grid.map(() => (merged ? 0 : undefined));\n    const answer = responses.get(ref.query);\n    const aggregate = rowsOf(answer);\n    if (aggregate) {\n      bucketTraceAggregateRows(aggregate.rows, window).forEach((b, i) => {\n        values[i] = fromRows(b.rows, ref) ?? 0;\n      });\n    }\n    for (const s of seriesOf(answer) ?? []) {\n      if (ref.percentile !== undefined && s.percentile !== ref.percentile) continue;\n      if (!matchesGroups(ref, s.name ?? '')) continue;\n      for (const p of s.points) {\n        const i = indexOf(p);\n        if (i === undefined) continue;\n        const v = ref.field === 'estimatedCost' ? (p.estimatedCost ?? 0) : p.value;\n        // Every series the ref matches adds up (e.g. a grouped count); `api` buckets stay unset until one answers.\n        values[i] = (values[i] ?? 0) + v;\n      }\n    }\n    cache.set(key, values);\n    return values;\n  };\n  const rangeOf = (ref: ValueRef) =>\n    rangeValue(responses.get(ref.query), ref, totals.has(ref.query) ? undefined : bucketed(ref)) ?? 0;\n  const overRange = (expr: ValueExpr) => evaluate(expr, rangeOf) ?? 0;\n\n  const perSeries = options.series.map(s => {\n    const values = grid.map((_, i) => {\n      const v = evaluate(s.value, ref => bucketed(ref)[i]);\n      return v === undefined ? undefined : s.round ? Math.round(v) : v;\n    });\n    const sum = values.reduce<number>((a, v) => a + (v ?? 0), 0);\n    return { s, values, rangeTotal: s.rangeTotal ? overRange(s.rangeTotal) : undefined, sum };\n  });\n\n  const shown = perSeries.filter(p => !options.hideEmpty || (p.rangeTotal ?? p.sum) > 0);\n  const data: ChartBucket[] = grid.map((labels, i) => {\n    const bucket: ChartBucket = { ...labels };\n    for (const p of shown) {\n      const v = p.values[i];\n      if (v !== undefined) bucket[p.s.dataKey] = v;\n    }\n    return bucket;\n  });\n\n  let total: number | undefined;\n  const spec = options.total?.value;\n  if (spec === 'total') total = shown.reduce((a, p) => a + p.sum, 0);\n  else if (spec && 'peak' in spec) {\n    const peak = perSeries.find(p => p.s.dataKey === spec.peak);\n    total = Math.max(0, ...(peak?.values ?? []).map(v => v ?? 0));\n  } else if (spec) total = overRange(spec);\n\n  const flat = shown.every(p => p.values.every(v => !v));\n  return {\n    data,\n    series: shown.map((p, i) => ({\n      ...p.s,\n      emphasis: options.emphasizeFirst ? i === 0 : p.s.emphasis,\n      rangeTotal: p.rangeTotal,\n    })),\n    stepHours,\n    total,\n    flat,\n    empty: options.emptyWhenZero ? overRange(options.emptyWhenZero) === 0 : flat,\n  };\n}\n\n/** Aggregations whose values for several groups add up to the value for all of them. */\nconst ADDITIVE = new Set<string>(['sum', 'count']);\n\n/**\n * The numbers an alert could watch: each series over the range (its `rangeTotal`, else its value),\n * then the card's total when it is an expression.\n */\nexport function timeseriesAlertValues(options: TimeseriesOptions): LabelledValue[] {\n  const values = options.series.map(s => ({ label: s.label, value: s.rangeTotal ?? s.value }));\n  const total = options.total?.value;\n  if (total && total !== 'total' && !('peak' in total)) values.push({ label: 'Total', value: total });\n  return values;\n}\n\n/**\n * What the schema can't say: query ids the view has, bucketed queries that leave their interval to the\n * chart's grid, refs that pick one of the percentiles their query asks for, and refs that pick one group\n * of a grouped aggregation that can't be added up.\n */\nexport function timeseriesIssues(options: TimeseriesOptions, queries: readonly DashboardQuery[]): string[] {\n  const exprs = options.series.flatMap(s => (s.rangeTotal ? [s.value, s.rangeTotal] : [s.value]));\n  const total = options.total?.value;\n  if (total && total !== 'total' && !('peak' in total)) exprs.push(total);\n  if (options.emptyWhenZero) exprs.push(options.emptyWhenZero);\n  const refs = exprs.flatMap(exprRefs);\n  const totals = new Set(options.totals ?? []);\n  const byId = new Map(queries.map(q => [q.id, q]));\n\n  // The chart lays every query on one grid built from the page's range; a query's own interval would\n  // land its points in the wrong buckets.\n  const ownIntervals = queries\n    .filter(q => q.id !== undefined && !totals.has(q.id) && 'interval' in q && q.interval !== undefined)\n    .map(q => `query '${q.id}' sets its own interval; the chart's buckets follow the page's range`);\n  // Percentiles of one metric can't be added up, so a ref must pick one when its query asks for several.\n  const ambiguousPercentiles = refs\n    .filter(r => {\n      const query = byId.get(r.query);\n      return (\n        r.percentile === undefined &&\n        query !== undefined &&\n        'request' in query &&\n        query.request === 'percentiles' &&\n        query.percentiles.length > 1\n      );\n    })\n    .map(r => `a value reading query '${r.query}' must pick one of its percentiles`);\n  const missingPercentiles = refs\n    .filter(r => {\n      const query = byId.get(r.query);\n      return (\n        r.percentile !== undefined &&\n        query !== undefined &&\n        'request' in query &&\n        query.request === 'percentiles' &&\n        !query.percentiles.includes(r.percentile)\n      );\n    })\n    .map(r => `a value reading query '${r.query}' picks percentile ${r.percentile}, which the query doesn't ask for`);\n  // Every series a ref matches adds up, which is only right for counts and sums.\n  const mixedGroups = refs\n    .filter(r => {\n      const query = byId.get(r.query);\n      return (\n        r.groups?.length !== 1 &&\n        query !== undefined &&\n        'request' in query &&\n        query.request === 'timeSeries' &&\n        (query.groupBy?.length ?? 0) > 0 &&\n        !ADDITIVE.has(query.aggregation)\n      );\n    })\n    .map(r => `a value reading query '${r.query}' must pick one group, since its groups' values can't be added up`);\n\n  return [\n    ...unknownQueryIssues(\n      refs.map(r => r.query),\n      queries,\n    ),\n    ...unknownQueryIssues(options.totals ?? [], queries, 'options.totals'),\n    ...ownIntervals,\n    ...new Set(ambiguousPercentiles),\n    ...new Set(missingPercentiles),\n    ...new Set(mixedGroups),\n  ];\n}\n"],"mappings":"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"}

package/dist/domains/dashboards/lib/timeseries.es.js

@@ -149,6 +149,22 @@ function shapeTimeseries({ options, responses, window, hasTraceQueries }) {
 /** Aggregations whose values for several groups add up to the value for all of them. */
 var ADDITIVE = /* @__PURE__ */ new Set(["sum", "count"]);
 /**
+* The numbers an alert could watch: each series over the range (its `rangeTotal`, else its value),
+* then the card's total when it is an expression.
+*/
+function timeseriesAlertValues(options) {
+	const values = options.series.map((s) => ({
+		label: s.label,
+		value: s.rangeTotal ?? s.value
+	}));
+	const total = options.total?.value;
+	if (total && total !== "total" && !("peak" in total)) values.push({
+		label: "Total",
+		value: total
+	});
+	return values;
+}
+/**
 * What the schema can't say: query ids the view has, bucketed queries that leave their interval to the
 * chart's grid, refs that pick one of the percentiles their query asks for, and refs that pick one group
 * of a grouped aggregation that can't be added up.
@@ -183,6 +199,6 @@ function timeseriesIssues(options, queries) {
 		...new Set(mixedGroups)
 	];
 }
-export { shapeTimeseries, timeseriesIssues, timeseriesOptionsSchema, timeseriesSeriesSchema };
+export { shapeTimeseries, timeseriesAlertValues, timeseriesIssues, timeseriesOptionsSchema, timeseriesSeriesSchema };
 
 //# sourceMappingURL=timeseries.es.js.map