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

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

@@ -1 +1 @@
-{"version":3,"file":"timeseries.es.js","names":[],"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.es.js","names":[],"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/values.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"values.cjs.js","names":["z"],"sources":["../../../../src/domains/dashboards/lib/values.ts"],"sourcesContent":["import { z } from 'zod/v4';\n\n/**\n * The options vocabulary widget kinds share. Values reference a view's query results and\n * combine them with a few fixed operations; there are no free-form expressions.\n */\n\n/** Names one of the view's queries by its `id`, never its position, so reordering queries keeps refs. */\nexport const queryRefSchema = z.string().min(1);\n\n/** A number read from one query's result. */\nexport const valueRefSchema = z\n  .object({\n    /** The `id` of one of the view's queries. */\n    query: queryRefSchema,\n    /** Metrics and scores read `value` (or the price, `estimatedCost`); trace and span aggregates read a measure. */\n    field: z.enum(['value', 'estimatedCost']).optional(),\n    /** A trace or span aggregate measure, e.g. `countDistinct.threadId`. */\n    measure: z.string().min(1).optional(),\n    /** A percentile of a percentiles request, e.g. `0.95`. */\n    percentile: z.number().min(0).max(1).optional(),\n    /** Only the series whose group key is exactly one of these... */\n    groups: z.array(z.string()).min(1).optional(),\n    /** ...or is none of these. */\n    notGroups: z.array(z.string()).min(1).optional(),\n  })\n  .strict();\n\nexport type ValueRef = z.infer<typeof valueRefSchema>;\n\nexport type ValueExpr =\n  | ValueRef\n  | { const: number }\n  | { sum: ValueExpr[] }\n  /** The first minus the second. */\n  | { minus: [ValueExpr, ValueExpr] }\n  /** `of / over`; no value when `over` is 0 or has none. */\n  | { ratio: { of: ValueExpr; over: ValueExpr } }\n  /** The largest part that has a value. */\n  | { max: ValueExpr[] }\n  /** The first part that has a value. */\n  | { coalesce: ValueExpr[] };\n\n// Recursive through getters, as zod 4 recommends; `z.lazy` around a union recurses forever.\nconst constSchema = z.strictObject({ const: z.number() });\nconst sumSchema = z.strictObject({\n  get sum() {\n    return z.array(valueExprSchema).min(1);\n  },\n});\nconst minusSchema = z.strictObject({\n  get minus() {\n    return z.tuple([valueExprSchema, valueExprSchema]);\n  },\n});\nconst ratioSchema = z.strictObject({\n  get ratio() {\n    return z.strictObject({ of: valueExprSchema, over: valueExprSchema });\n  },\n});\nconst maxSchema = z.strictObject({\n  get max() {\n    return z.array(valueExprSchema).min(1);\n  },\n});\nconst coalesceSchema = z.strictObject({\n  get coalesce() {\n    return z.array(valueExprSchema).min(1);\n  },\n});\n\nexport const valueExprSchema: z.ZodType<ValueExpr> = z.union([\n  valueRefSchema,\n  constSchema,\n  sumSchema,\n  minusSchema,\n  ratioSchema,\n  maxSchema,\n  coalesceSchema,\n]);\n\nexport const VALUE_FORMATS = ['count', 'usd', 'duration', 'percent', 'score'] as const;\nexport const formatSchema = z.enum(VALUE_FORMATS);\nexport type ValueFormat = z.infer<typeof formatSchema>;\n\nexport const CHART_COLOR_NAMES = ['green', 'sky', 'violet', 'teal', 'indigo', 'warning', 'error', 'neutral'] as const;\nexport const colorSchema = z.enum(CHART_COLOR_NAMES);\n\n/** Every ref an expression reads, in order. */\nexport function exprRefs(expr: ValueExpr): ValueRef[] {\n  if ('const' in expr) return [];\n  if ('sum' in expr) return expr.sum.flatMap(exprRefs);\n  if ('minus' in expr) return expr.minus.flatMap(exprRefs);\n  if ('ratio' in expr) return [...exprRefs(expr.ratio.of), ...exprRefs(expr.ratio.over)];\n  if ('max' in expr) return expr.max.flatMap(exprRefs);\n  if ('coalesce' in expr) return expr.coalesce.flatMap(exprRefs);\n  return [expr];\n}\n\nconst defined = (values: (number | undefined)[]) => values.filter((v): v is number => v !== undefined);\n\n/**\n * Evaluates an expression, reading each ref through `read`. A missing operand counts as 0 in `sum` and\n * `minus` while another has a value; the result is missing when every operand is.\n */\nexport function evaluate(expr: ValueExpr, read: (ref: ValueRef) => number | undefined): number | undefined {\n  const run = (e: ValueExpr) => evaluate(e, read);\n  if ('const' in expr) return expr.const;\n  if ('sum' in expr) {\n    const parts = expr.sum.map(run);\n    return defined(parts).length ? parts.reduce<number>((total, p) => total + (p ?? 0), 0) : undefined;\n  }\n  if ('minus' in expr) {\n    const [a, b] = expr.minus.map(run);\n    return a === undefined && b === undefined ? undefined : (a ?? 0) - (b ?? 0);\n  }\n  if ('ratio' in expr) {\n    const over = run(expr.ratio.over);\n    if (!over) return undefined;\n    return (run(expr.ratio.of) ?? 0) / over;\n  }\n  if ('max' in expr) {\n    const parts = defined(expr.max.map(run));\n    return parts.length ? Math.max(...parts) : undefined;\n  }\n  if ('coalesce' in expr) {\n    for (const e of expr.coalesce) {\n      const v = run(e);\n      if (v !== undefined) return v;\n    }\n    return undefined;\n  }\n  return read(expr);\n}\n\n/** Whether the series with group key `name` is one a ref reads. */\nexport function matchesGroups(ref: ValueRef, name: string) {\n  if (ref.groups && !ref.groups.includes(name)) return false;\n  if (ref.notGroups?.includes(name)) return false;\n  return true;\n}\n\n/** Each query's answer under its id, for reading refs. Queries without an id can't be referenced. */\nexport function answersById<T>(queries: readonly { id?: string }[], answers: readonly T[]): Map<string, T | undefined> {\n  const byId = new Map<string, T | undefined>();\n  queries.forEach((q, i) => {\n    if (q.id !== undefined) byId.set(q.id, answers[i]);\n  });\n  return byId;\n}\n\n/** Where a query id sits in the view's queries, or `undefined` if no query has it. */\nexport const queryIndex = (queries: readonly { id?: string }[], id: string | undefined) => {\n  if (id === undefined) return undefined;\n  const index = queries.findIndex(q => q.id === id);\n  return index < 0 ? undefined : index;\n};\n\n/** An issue for each referenced query id the view doesn't have. */\nexport function unknownQueryIssues(ids: readonly string[], queries: readonly { id?: string }[], where = 'options') {\n  const known = new Set(queries.flatMap(q => (q.id === undefined ? [] : [q.id])));\n  return [...new Set(ids)]\n    .filter(id => !known.has(id))\n    .map(id => `${where}: reads query '${id}', which the view doesn't have`);\n}\n"],"mappings":"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"}
+{"version":3,"file":"values.cjs.js","names":["z"],"sources":["../../../../src/domains/dashboards/lib/values.ts"],"sourcesContent":["import { z } from 'zod/v4';\n\n/**\n * The options vocabulary widget kinds share. Values reference a view's query results and\n * combine them with a few fixed operations; there are no free-form expressions.\n */\n\n/** Names one of the view's queries by its `id`, never its position, so reordering queries keeps refs. */\nexport const queryRefSchema = z.string().min(1);\n\n/** A number read from one query's result. */\nexport const valueRefSchema = z\n  .object({\n    /** The `id` of one of the view's queries. */\n    query: queryRefSchema,\n    /** Metrics and scores read `value` (or the price, `estimatedCost`); trace and span aggregates read a measure. */\n    field: z.enum(['value', 'estimatedCost']).optional(),\n    /** A trace or span aggregate measure, e.g. `countDistinct.threadId`. */\n    measure: z.string().min(1).optional(),\n    /** A percentile of a percentiles request, e.g. `0.95`. */\n    percentile: z.number().min(0).max(1).optional(),\n    /** Only the series whose group key is exactly one of these... */\n    groups: z.array(z.string()).min(1).optional(),\n    /** ...or is none of these. */\n    notGroups: z.array(z.string()).min(1).optional(),\n  })\n  .strict();\n\nexport type ValueRef = z.infer<typeof valueRefSchema>;\n\nexport type ValueExpr =\n  | ValueRef\n  | { const: number }\n  | { sum: ValueExpr[] }\n  /** The first minus the second. */\n  | { minus: [ValueExpr, ValueExpr] }\n  /** `of / over`; no value when `over` is 0 or has none. */\n  | { ratio: { of: ValueExpr; over: ValueExpr } }\n  /** The largest part that has a value. */\n  | { max: ValueExpr[] }\n  /** The first part that has a value. */\n  | { coalesce: ValueExpr[] };\n\n// Recursive through getters, as zod 4 recommends; `z.lazy` around a union recurses forever.\nconst constSchema = z.strictObject({ const: z.number() });\nconst sumSchema = z.strictObject({\n  get sum() {\n    return z.array(valueExprSchema).min(1);\n  },\n});\nconst minusSchema = z.strictObject({\n  get minus() {\n    return z.tuple([valueExprSchema, valueExprSchema]);\n  },\n});\nconst ratioSchema = z.strictObject({\n  get ratio() {\n    return z.strictObject({ of: valueExprSchema, over: valueExprSchema });\n  },\n});\nconst maxSchema = z.strictObject({\n  get max() {\n    return z.array(valueExprSchema).min(1);\n  },\n});\nconst coalesceSchema = z.strictObject({\n  get coalesce() {\n    return z.array(valueExprSchema).min(1);\n  },\n});\n\nexport const valueExprSchema: z.ZodType<ValueExpr> = z.union([\n  valueRefSchema,\n  constSchema,\n  sumSchema,\n  minusSchema,\n  ratioSchema,\n  maxSchema,\n  coalesceSchema,\n]);\n\n/** A number a view shows, under the name it shows it by: what a Create alert button lists. */\nexport type LabelledValue = { label: string; value: ValueExpr };\n\nexport const VALUE_FORMATS = ['count', 'usd', 'duration', 'percent', 'score'] as const;\nexport const formatSchema = z.enum(VALUE_FORMATS);\nexport type ValueFormat = z.infer<typeof formatSchema>;\n\nexport const CHART_COLOR_NAMES = ['green', 'sky', 'violet', 'teal', 'indigo', 'warning', 'error', 'neutral'] as const;\nexport const colorSchema = z.enum(CHART_COLOR_NAMES);\n\n/** Every ref an expression reads, in order. */\nexport function exprRefs(expr: ValueExpr): ValueRef[] {\n  if ('const' in expr) return [];\n  if ('sum' in expr) return expr.sum.flatMap(exprRefs);\n  if ('minus' in expr) return expr.minus.flatMap(exprRefs);\n  if ('ratio' in expr) return [...exprRefs(expr.ratio.of), ...exprRefs(expr.ratio.over)];\n  if ('max' in expr) return expr.max.flatMap(exprRefs);\n  if ('coalesce' in expr) return expr.coalesce.flatMap(exprRefs);\n  return [expr];\n}\n\nconst defined = (values: (number | undefined)[]) => values.filter((v): v is number => v !== undefined);\n\n/**\n * Evaluates an expression, reading each ref through `read`. A missing operand counts as 0 in `sum` and\n * `minus` while another has a value; the result is missing when every operand is.\n */\nexport function evaluate(expr: ValueExpr, read: (ref: ValueRef) => number | undefined): number | undefined {\n  const run = (e: ValueExpr) => evaluate(e, read);\n  if ('const' in expr) return expr.const;\n  if ('sum' in expr) {\n    const parts = expr.sum.map(run);\n    return defined(parts).length ? parts.reduce<number>((total, p) => total + (p ?? 0), 0) : undefined;\n  }\n  if ('minus' in expr) {\n    const [a, b] = expr.minus.map(run);\n    return a === undefined && b === undefined ? undefined : (a ?? 0) - (b ?? 0);\n  }\n  if ('ratio' in expr) {\n    const over = run(expr.ratio.over);\n    if (!over) return undefined;\n    return (run(expr.ratio.of) ?? 0) / over;\n  }\n  if ('max' in expr) {\n    const parts = defined(expr.max.map(run));\n    return parts.length ? Math.max(...parts) : undefined;\n  }\n  if ('coalesce' in expr) {\n    for (const e of expr.coalesce) {\n      const v = run(e);\n      if (v !== undefined) return v;\n    }\n    return undefined;\n  }\n  return read(expr);\n}\n\n/** Whether the series with group key `name` is one a ref reads. */\nexport function matchesGroups(ref: ValueRef, name: string) {\n  if (ref.groups && !ref.groups.includes(name)) return false;\n  if (ref.notGroups?.includes(name)) return false;\n  return true;\n}\n\n/** Each query's answer under its id, for reading refs. Queries without an id can't be referenced. */\nexport function answersById<T>(queries: readonly { id?: string }[], answers: readonly T[]): Map<string, T | undefined> {\n  const byId = new Map<string, T | undefined>();\n  queries.forEach((q, i) => {\n    if (q.id !== undefined) byId.set(q.id, answers[i]);\n  });\n  return byId;\n}\n\n/** Where a query id sits in the view's queries, or `undefined` if no query has it. */\nexport const queryIndex = (queries: readonly { id?: string }[], id: string | undefined) => {\n  if (id === undefined) return undefined;\n  const index = queries.findIndex(q => q.id === id);\n  return index < 0 ? undefined : index;\n};\n\n/** An issue for each referenced query id the view doesn't have. */\nexport function unknownQueryIssues(ids: readonly string[], queries: readonly { id?: string }[], where = 'options') {\n  const known = new Set(queries.flatMap(q => (q.id === undefined ? [] : [q.id])));\n  return [...new Set(ids)]\n    .filter(id => !known.has(id))\n    .map(id => `${where}: reads query '${id}', which the view doesn't have`);\n}\n"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"values.es.js","names":[],"sources":["../../../../src/domains/dashboards/lib/values.ts"],"sourcesContent":["import { z } from 'zod/v4';\n\n/**\n * The options vocabulary widget kinds share. Values reference a view's query results and\n * combine them with a few fixed operations; there are no free-form expressions.\n */\n\n/** Names one of the view's queries by its `id`, never its position, so reordering queries keeps refs. */\nexport const queryRefSchema = z.string().min(1);\n\n/** A number read from one query's result. */\nexport const valueRefSchema = z\n  .object({\n    /** The `id` of one of the view's queries. */\n    query: queryRefSchema,\n    /** Metrics and scores read `value` (or the price, `estimatedCost`); trace and span aggregates read a measure. */\n    field: z.enum(['value', 'estimatedCost']).optional(),\n    /** A trace or span aggregate measure, e.g. `countDistinct.threadId`. */\n    measure: z.string().min(1).optional(),\n    /** A percentile of a percentiles request, e.g. `0.95`. */\n    percentile: z.number().min(0).max(1).optional(),\n    /** Only the series whose group key is exactly one of these... */\n    groups: z.array(z.string()).min(1).optional(),\n    /** ...or is none of these. */\n    notGroups: z.array(z.string()).min(1).optional(),\n  })\n  .strict();\n\nexport type ValueRef = z.infer<typeof valueRefSchema>;\n\nexport type ValueExpr =\n  | ValueRef\n  | { const: number }\n  | { sum: ValueExpr[] }\n  /** The first minus the second. */\n  | { minus: [ValueExpr, ValueExpr] }\n  /** `of / over`; no value when `over` is 0 or has none. */\n  | { ratio: { of: ValueExpr; over: ValueExpr } }\n  /** The largest part that has a value. */\n  | { max: ValueExpr[] }\n  /** The first part that has a value. */\n  | { coalesce: ValueExpr[] };\n\n// Recursive through getters, as zod 4 recommends; `z.lazy` around a union recurses forever.\nconst constSchema = z.strictObject({ const: z.number() });\nconst sumSchema = z.strictObject({\n  get sum() {\n    return z.array(valueExprSchema).min(1);\n  },\n});\nconst minusSchema = z.strictObject({\n  get minus() {\n    return z.tuple([valueExprSchema, valueExprSchema]);\n  },\n});\nconst ratioSchema = z.strictObject({\n  get ratio() {\n    return z.strictObject({ of: valueExprSchema, over: valueExprSchema });\n  },\n});\nconst maxSchema = z.strictObject({\n  get max() {\n    return z.array(valueExprSchema).min(1);\n  },\n});\nconst coalesceSchema = z.strictObject({\n  get coalesce() {\n    return z.array(valueExprSchema).min(1);\n  },\n});\n\nexport const valueExprSchema: z.ZodType<ValueExpr> = z.union([\n  valueRefSchema,\n  constSchema,\n  sumSchema,\n  minusSchema,\n  ratioSchema,\n  maxSchema,\n  coalesceSchema,\n]);\n\nexport const VALUE_FORMATS = ['count', 'usd', 'duration', 'percent', 'score'] as const;\nexport const formatSchema = z.enum(VALUE_FORMATS);\nexport type ValueFormat = z.infer<typeof formatSchema>;\n\nexport const CHART_COLOR_NAMES = ['green', 'sky', 'violet', 'teal', 'indigo', 'warning', 'error', 'neutral'] as const;\nexport const colorSchema = z.enum(CHART_COLOR_NAMES);\n\n/** Every ref an expression reads, in order. */\nexport function exprRefs(expr: ValueExpr): ValueRef[] {\n  if ('const' in expr) return [];\n  if ('sum' in expr) return expr.sum.flatMap(exprRefs);\n  if ('minus' in expr) return expr.minus.flatMap(exprRefs);\n  if ('ratio' in expr) return [...exprRefs(expr.ratio.of), ...exprRefs(expr.ratio.over)];\n  if ('max' in expr) return expr.max.flatMap(exprRefs);\n  if ('coalesce' in expr) return expr.coalesce.flatMap(exprRefs);\n  return [expr];\n}\n\nconst defined = (values: (number | undefined)[]) => values.filter((v): v is number => v !== undefined);\n\n/**\n * Evaluates an expression, reading each ref through `read`. A missing operand counts as 0 in `sum` and\n * `minus` while another has a value; the result is missing when every operand is.\n */\nexport function evaluate(expr: ValueExpr, read: (ref: ValueRef) => number | undefined): number | undefined {\n  const run = (e: ValueExpr) => evaluate(e, read);\n  if ('const' in expr) return expr.const;\n  if ('sum' in expr) {\n    const parts = expr.sum.map(run);\n    return defined(parts).length ? parts.reduce<number>((total, p) => total + (p ?? 0), 0) : undefined;\n  }\n  if ('minus' in expr) {\n    const [a, b] = expr.minus.map(run);\n    return a === undefined && b === undefined ? undefined : (a ?? 0) - (b ?? 0);\n  }\n  if ('ratio' in expr) {\n    const over = run(expr.ratio.over);\n    if (!over) return undefined;\n    return (run(expr.ratio.of) ?? 0) / over;\n  }\n  if ('max' in expr) {\n    const parts = defined(expr.max.map(run));\n    return parts.length ? Math.max(...parts) : undefined;\n  }\n  if ('coalesce' in expr) {\n    for (const e of expr.coalesce) {\n      const v = run(e);\n      if (v !== undefined) return v;\n    }\n    return undefined;\n  }\n  return read(expr);\n}\n\n/** Whether the series with group key `name` is one a ref reads. */\nexport function matchesGroups(ref: ValueRef, name: string) {\n  if (ref.groups && !ref.groups.includes(name)) return false;\n  if (ref.notGroups?.includes(name)) return false;\n  return true;\n}\n\n/** Each query's answer under its id, for reading refs. Queries without an id can't be referenced. */\nexport function answersById<T>(queries: readonly { id?: string }[], answers: readonly T[]): Map<string, T | undefined> {\n  const byId = new Map<string, T | undefined>();\n  queries.forEach((q, i) => {\n    if (q.id !== undefined) byId.set(q.id, answers[i]);\n  });\n  return byId;\n}\n\n/** Where a query id sits in the view's queries, or `undefined` if no query has it. */\nexport const queryIndex = (queries: readonly { id?: string }[], id: string | undefined) => {\n  if (id === undefined) return undefined;\n  const index = queries.findIndex(q => q.id === id);\n  return index < 0 ? undefined : index;\n};\n\n/** An issue for each referenced query id the view doesn't have. */\nexport function unknownQueryIssues(ids: readonly string[], queries: readonly { id?: string }[], where = 'options') {\n  const known = new Set(queries.flatMap(q => (q.id === undefined ? [] : [q.id])));\n  return [...new Set(ids)]\n    .filter(id => !known.has(id))\n    .map(id => `${where}: reads query '${id}', which the view doesn't have`);\n}\n"],"mappings":";;;;;;;AAQA,IAAa,iBAAiB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;;AAG9C,IAAa,iBAAiB,EAC3B,OAAO;;CAEN,OAAO;;CAEP,OAAO,EAAE,KAAK,CAAC,SAAS,eAAe,CAAC,CAAC,CAAC,SAAS;;CAEnD,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;;CAEpC,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;;CAE9C,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;;CAE5C,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;AACjD,CAAC,CAAC,CACD,OAAO;AAkBV,IAAM,cAAc,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACxD,IAAM,YAAY,EAAE,aAAa,EAC/B,IAAI,MAAM;CACR,OAAO,EAAE,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC;AACvC,EACF,CAAC;AACD,IAAM,cAAc,EAAE,aAAa,EACjC,IAAI,QAAQ;CACV,OAAO,EAAE,MAAM,CAAC,iBAAiB,eAAe,CAAC;AACnD,EACF,CAAC;AACD,IAAM,cAAc,EAAE,aAAa,EACjC,IAAI,QAAQ;CACV,OAAO,EAAE,aAAa;EAAE,IAAI;EAAiB,MAAM;CAAgB,CAAC;AACtE,EACF,CAAC;AACD,IAAM,YAAY,EAAE,aAAa,EAC/B,IAAI,MAAM;CACR,OAAO,EAAE,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC;AACvC,EACF,CAAC;AACD,IAAM,iBAAiB,EAAE,aAAa,EACpC,IAAI,WAAW;CACb,OAAO,EAAE,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC;AACvC,EACF,CAAC;AAED,IAAa,kBAAwC,EAAE,MAAM;CAC3D;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,IAAa,gBAAgB;CAAC;CAAS;CAAO;CAAY;CAAW;AAAO;AAC5E,IAAa,eAAe,EAAE,KAAK,aAAa;AAGhD,IAAa,oBAAoB;CAAC;CAAS;CAAO;CAAU;CAAQ;CAAU;CAAW;CAAS;AAAS;AAC3G,IAAa,cAAc,EAAE,KAAK,iBAAiB;;AAGnD,SAAgB,SAAS,MAA6B;CACpD,IAAI,WAAW,MAAM,OAAO,CAAC;CAC7B,IAAI,SAAS,MAAM,OAAO,KAAK,IAAI,QAAQ,QAAQ;CACnD,IAAI,WAAW,MAAM,OAAO,KAAK,MAAM,QAAQ,QAAQ;CACvD,IAAI,WAAW,MAAM,OAAO,CAAC,GAAG,SAAS,KAAK,MAAM,EAAE,GAAG,GAAG,SAAS,KAAK,MAAM,IAAI,CAAC;CACrF,IAAI,SAAS,MAAM,OAAO,KAAK,IAAI,QAAQ,QAAQ;CACnD,IAAI,cAAc,MAAM,OAAO,KAAK,SAAS,QAAQ,QAAQ;CAC7D,OAAO,CAAC,IAAI;AACd;AAEA,IAAM,WAAW,WAAmC,OAAO,QAAQ,MAAmB,MAAM,KAAA,CAAS;;;;;AAMrG,SAAgB,SAAS,MAAiB,MAAiE;CACzG,MAAM,OAAO,MAAiB,SAAS,GAAG,IAAI;CAC9C,IAAI,WAAW,MAAM,OAAO,KAAK;CACjC,IAAI,SAAS,MAAM;EACjB,MAAM,QAAQ,KAAK,IAAI,IAAI,GAAG;EAC9B,OAAO,QAAQ,KAAK,CAAC,CAAC,SAAS,MAAM,QAAgB,OAAO,MAAM,SAAS,KAAK,IAAI,CAAC,IAAI,KAAA;CAC3F;CACA,IAAI,WAAW,MAAM;EACnB,MAAM,CAAC,GAAG,KAAK,KAAK,MAAM,IAAI,GAAG;EACjC,OAAO,MAAM,KAAA,KAAa,MAAM,KAAA,IAAY,KAAA,KAAa,KAAK,MAAM,KAAK;CAC3E;CACA,IAAI,WAAW,MAAM;EACnB,MAAM,OAAO,IAAI,KAAK,MAAM,IAAI;EAChC,IAAI,CAAC,MAAM,OAAO,KAAA;EAClB,QAAQ,IAAI,KAAK,MAAM,EAAE,KAAK,KAAK;CACrC;CACA,IAAI,SAAS,MAAM;EACjB,MAAM,QAAQ,QAAQ,KAAK,IAAI,IAAI,GAAG,CAAC;EACvC,OAAO,MAAM,SAAS,KAAK,IAAI,GAAG,KAAK,IAAI,KAAA;CAC7C;CACA,IAAI,cAAc,MAAM;EACtB,KAAK,MAAM,KAAK,KAAK,UAAU;GAC7B,MAAM,IAAI,IAAI,CAAC;GACf,IAAI,MAAM,KAAA,GAAW,OAAO;EAC9B;EACA;CACF;CACA,OAAO,KAAK,IAAI;AAClB;;AAGA,SAAgB,cAAc,KAAe,MAAc;CACzD,IAAI,IAAI,UAAU,CAAC,IAAI,OAAO,SAAS,IAAI,GAAG,OAAO;CACrD,IAAI,IAAI,WAAW,SAAS,IAAI,GAAG,OAAO;CAC1C,OAAO;AACT;;AAGA,SAAgB,YAAe,SAAqC,SAAmD;CACrH,MAAM,uBAAO,IAAI,IAA2B;CAC5C,QAAQ,SAAS,GAAG,MAAM;EACxB,IAAI,EAAE,OAAO,KAAA,GAAW,KAAK,IAAI,EAAE,IAAI,QAAQ,EAAE;CACnD,CAAC;CACD,OAAO;AACT;;AAGA,IAAa,cAAc,SAAqC,OAA2B;CACzF,IAAI,OAAO,KAAA,GAAW,OAAO,KAAA;CAC7B,MAAM,QAAQ,QAAQ,WAAU,MAAK,EAAE,OAAO,EAAE;CAChD,OAAO,QAAQ,IAAI,KAAA,IAAY;AACjC;;AAGA,SAAgB,mBAAmB,KAAwB,SAAqC,QAAQ,WAAW;CACjH,MAAM,QAAQ,IAAI,IAAI,QAAQ,SAAQ,MAAM,EAAE,OAAO,KAAA,IAAY,CAAC,IAAI,CAAC,EAAE,EAAE,CAAE,CAAC;CAC9E,OAAO,CAAC,GAAG,IAAI,IAAI,GAAG,CAAC,CAAC,CACrB,QAAO,OAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAC5B,KAAI,OAAM,GAAG,MAAM,iBAAiB,GAAG,+BAA+B;AAC3E"}
+{"version":3,"file":"values.es.js","names":[],"sources":["../../../../src/domains/dashboards/lib/values.ts"],"sourcesContent":["import { z } from 'zod/v4';\n\n/**\n * The options vocabulary widget kinds share. Values reference a view's query results and\n * combine them with a few fixed operations; there are no free-form expressions.\n */\n\n/** Names one of the view's queries by its `id`, never its position, so reordering queries keeps refs. */\nexport const queryRefSchema = z.string().min(1);\n\n/** A number read from one query's result. */\nexport const valueRefSchema = z\n  .object({\n    /** The `id` of one of the view's queries. */\n    query: queryRefSchema,\n    /** Metrics and scores read `value` (or the price, `estimatedCost`); trace and span aggregates read a measure. */\n    field: z.enum(['value', 'estimatedCost']).optional(),\n    /** A trace or span aggregate measure, e.g. `countDistinct.threadId`. */\n    measure: z.string().min(1).optional(),\n    /** A percentile of a percentiles request, e.g. `0.95`. */\n    percentile: z.number().min(0).max(1).optional(),\n    /** Only the series whose group key is exactly one of these... */\n    groups: z.array(z.string()).min(1).optional(),\n    /** ...or is none of these. */\n    notGroups: z.array(z.string()).min(1).optional(),\n  })\n  .strict();\n\nexport type ValueRef = z.infer<typeof valueRefSchema>;\n\nexport type ValueExpr =\n  | ValueRef\n  | { const: number }\n  | { sum: ValueExpr[] }\n  /** The first minus the second. */\n  | { minus: [ValueExpr, ValueExpr] }\n  /** `of / over`; no value when `over` is 0 or has none. */\n  | { ratio: { of: ValueExpr; over: ValueExpr } }\n  /** The largest part that has a value. */\n  | { max: ValueExpr[] }\n  /** The first part that has a value. */\n  | { coalesce: ValueExpr[] };\n\n// Recursive through getters, as zod 4 recommends; `z.lazy` around a union recurses forever.\nconst constSchema = z.strictObject({ const: z.number() });\nconst sumSchema = z.strictObject({\n  get sum() {\n    return z.array(valueExprSchema).min(1);\n  },\n});\nconst minusSchema = z.strictObject({\n  get minus() {\n    return z.tuple([valueExprSchema, valueExprSchema]);\n  },\n});\nconst ratioSchema = z.strictObject({\n  get ratio() {\n    return z.strictObject({ of: valueExprSchema, over: valueExprSchema });\n  },\n});\nconst maxSchema = z.strictObject({\n  get max() {\n    return z.array(valueExprSchema).min(1);\n  },\n});\nconst coalesceSchema = z.strictObject({\n  get coalesce() {\n    return z.array(valueExprSchema).min(1);\n  },\n});\n\nexport const valueExprSchema: z.ZodType<ValueExpr> = z.union([\n  valueRefSchema,\n  constSchema,\n  sumSchema,\n  minusSchema,\n  ratioSchema,\n  maxSchema,\n  coalesceSchema,\n]);\n\n/** A number a view shows, under the name it shows it by: what a Create alert button lists. */\nexport type LabelledValue = { label: string; value: ValueExpr };\n\nexport const VALUE_FORMATS = ['count', 'usd', 'duration', 'percent', 'score'] as const;\nexport const formatSchema = z.enum(VALUE_FORMATS);\nexport type ValueFormat = z.infer<typeof formatSchema>;\n\nexport const CHART_COLOR_NAMES = ['green', 'sky', 'violet', 'teal', 'indigo', 'warning', 'error', 'neutral'] as const;\nexport const colorSchema = z.enum(CHART_COLOR_NAMES);\n\n/** Every ref an expression reads, in order. */\nexport function exprRefs(expr: ValueExpr): ValueRef[] {\n  if ('const' in expr) return [];\n  if ('sum' in expr) return expr.sum.flatMap(exprRefs);\n  if ('minus' in expr) return expr.minus.flatMap(exprRefs);\n  if ('ratio' in expr) return [...exprRefs(expr.ratio.of), ...exprRefs(expr.ratio.over)];\n  if ('max' in expr) return expr.max.flatMap(exprRefs);\n  if ('coalesce' in expr) return expr.coalesce.flatMap(exprRefs);\n  return [expr];\n}\n\nconst defined = (values: (number | undefined)[]) => values.filter((v): v is number => v !== undefined);\n\n/**\n * Evaluates an expression, reading each ref through `read`. A missing operand counts as 0 in `sum` and\n * `minus` while another has a value; the result is missing when every operand is.\n */\nexport function evaluate(expr: ValueExpr, read: (ref: ValueRef) => number | undefined): number | undefined {\n  const run = (e: ValueExpr) => evaluate(e, read);\n  if ('const' in expr) return expr.const;\n  if ('sum' in expr) {\n    const parts = expr.sum.map(run);\n    return defined(parts).length ? parts.reduce<number>((total, p) => total + (p ?? 0), 0) : undefined;\n  }\n  if ('minus' in expr) {\n    const [a, b] = expr.minus.map(run);\n    return a === undefined && b === undefined ? undefined : (a ?? 0) - (b ?? 0);\n  }\n  if ('ratio' in expr) {\n    const over = run(expr.ratio.over);\n    if (!over) return undefined;\n    return (run(expr.ratio.of) ?? 0) / over;\n  }\n  if ('max' in expr) {\n    const parts = defined(expr.max.map(run));\n    return parts.length ? Math.max(...parts) : undefined;\n  }\n  if ('coalesce' in expr) {\n    for (const e of expr.coalesce) {\n      const v = run(e);\n      if (v !== undefined) return v;\n    }\n    return undefined;\n  }\n  return read(expr);\n}\n\n/** Whether the series with group key `name` is one a ref reads. */\nexport function matchesGroups(ref: ValueRef, name: string) {\n  if (ref.groups && !ref.groups.includes(name)) return false;\n  if (ref.notGroups?.includes(name)) return false;\n  return true;\n}\n\n/** Each query's answer under its id, for reading refs. Queries without an id can't be referenced. */\nexport function answersById<T>(queries: readonly { id?: string }[], answers: readonly T[]): Map<string, T | undefined> {\n  const byId = new Map<string, T | undefined>();\n  queries.forEach((q, i) => {\n    if (q.id !== undefined) byId.set(q.id, answers[i]);\n  });\n  return byId;\n}\n\n/** Where a query id sits in the view's queries, or `undefined` if no query has it. */\nexport const queryIndex = (queries: readonly { id?: string }[], id: string | undefined) => {\n  if (id === undefined) return undefined;\n  const index = queries.findIndex(q => q.id === id);\n  return index < 0 ? undefined : index;\n};\n\n/** An issue for each referenced query id the view doesn't have. */\nexport function unknownQueryIssues(ids: readonly string[], queries: readonly { id?: string }[], where = 'options') {\n  const known = new Set(queries.flatMap(q => (q.id === undefined ? [] : [q.id])));\n  return [...new Set(ids)]\n    .filter(id => !known.has(id))\n    .map(id => `${where}: reads query '${id}', which the view doesn't have`);\n}\n"],"mappings":"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"}

package/dist/domains/dashboards/widget-kind.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"widget-kind.cjs.js","names":[],"sources":["../../../src/domains/dashboards/widget-kind.ts"],"sourcesContent":["import type { DashboardWidget, DashboardWidgetView } from '@mastra/client-js';\nimport type { ComponentType } from 'react';\nimport type { z } from 'zod/v4';\nimport type { ChartCardProps } from '../metrics/components/chart-card';\nimport type { DashboardScope, OnDashboardDrilldown } from './lib/definition';\n\n/** A view whose options passed its kind's schema. */\nexport type ResolvedView<Options> = DashboardWidgetView & { options: Options };\n\nexport type WidgetKindProps<Options> = {\n  widget: DashboardWidget;\n  /** The views at the page's scope, options parsed. Never empty. */\n  views: [ResolvedView<Options>, ...ResolvedView<Options>[]];\n  scope: DashboardScope;\n  onDrilldown?: OnDashboardDrilldown;\n  /** Where a chart card expands to; see `DashboardExpand`. */\n  expand?: DashboardExpand;\n};\n\n/**\n * Where a chart widget expands to (a host's query page), as the Gateway Overview's cards do: the card\n * shows its title with an expand icon linking there, in place of its views menu, on its first view.\n * `href` returns `undefined` for a widget with nowhere to go; that card keeps its menu.\n */\nexport type DashboardExpand = {\n  href: (widget: DashboardWidget) => string | undefined;\n  LinkComponent: NonNullable<ChartCardProps['LinkComponent']>;\n};\n\n/**\n * One kind of widget, self-contained: the renderer only looks it up by name, checks each view's\n * options against `optionsSchema`, and renders `component`.\n */\nexport type WidgetKind<Options = unknown> = {\n  kind: string;\n  /** Each view's `options`, parsed before the widget renders. */\n  optionsSchema: z.ZodType<Options>;\n  /** Further problems with a view, e.g. options naming a query the view doesn't have. */\n  issues?: (view: ResolvedView<Options>) => string[];\n  component: ComponentType<WidgetKindProps<Options>>;\n};\n\n/** Keeps a kind's options type while it joins a list of kinds of different options. */\nexport const defineWidgetKind = <Options>(kind: WidgetKind<Options>): WidgetKind<Options> => kind;\n\n/** A registry entry, whatever its options. */\nexport type AnyWidgetKind = WidgetKind<any>;\n"],"mappings":";;;AA2CA,IAAa,oBAA6B,SAAmD"}
+{"version":3,"file":"widget-kind.cjs.js","names":[],"sources":["../../../src/domains/dashboards/widget-kind.ts"],"sourcesContent":["import type { DashboardQuery, DashboardWidget, DashboardWidgetView } from '@mastra/client-js';\nimport type { ComponentType } from 'react';\nimport type { z } from 'zod/v4';\nimport type { ChartCardProps } from '../metrics/components/chart-card';\nimport type { DashboardScope, OnDashboardDrilldown } from './lib/definition';\nimport type { BlockedFields, WidgetGate } from './lib/gate';\nimport type { DashboardPageContext, DashboardRequest, DashboardResult } from './lib/requests';\nimport type { ValueRef } from './lib/values';\nimport type { MetricsCardDragHandleProps } from '@/ds/components/MetricsCard';\nimport type { MetricsTableSort } from '@/ds/components/MetricsTable';\n\n/** A view whose options passed its kind's schema. */\nexport type ResolvedView<Options> = DashboardWidgetView & { options: Options };\n\nexport type WidgetKindProps<Options> = {\n  widget: DashboardWidget;\n  /** The views at the page's scope, options parsed. Never empty. */\n  views: [ResolvedView<Options>, ...ResolvedView<Options>[]];\n  scope: DashboardScope;\n  onDrilldown?: OnDashboardDrilldown;\n  /** Where a chart card expands to; see `DashboardExpand`. */\n  expand?: DashboardExpand;\n  /** A grip to drag the widget by, shown left of its title: the host is arranging the dashboard. */\n  dragHandle?: MetricsCardDragHandleProps;\n  /** The widget's pin button, shown with its card's actions: the host can pin widgets. */\n  pin?: WidgetPin;\n  /** The card's Create alert button, for the open view: the host can turn views into alerts. */\n  alert?: DashboardAlert;\n  /** Whether the widget's queries can run on the page, and their page context once they can. */\n  gate: ShownGate;\n  /** What figures are compared against, e.g. `vs previous 24h`. */\n  comparisonLabel: string;\n  /** Display name for a project id, when the page spans several projects. */\n  projectLabel?: (projectId: string) => string;\n  /** What the user picked on the widget, held by the host. */\n  state: WidgetState;\n  /** Called with the whole next state when the user picks a view, sorts, or compares. */\n  onStateChange: (next: WidgetState) => void;\n  /** Answers to the kind's `discover` requests, in order. */\n  discovered: (DashboardResult | undefined)[];\n  /** Answers to the kind's `requests`, in order. */\n  results: (DashboardResult | undefined)[];\n  /** Asks the host to send the failed requests again. */\n  onRetry: () => void;\n};\n\n/** What a card's Create alert button watches: its open view, with the page's filters applied. */\nexport type DashboardAlertTarget = {\n  widget: DashboardWidget;\n  view: DashboardWidgetView;\n  /**\n   * The view's queries with the page's filter bar ANDed in (`pageQuery`). They carry no time window:\n   * the alert picks its own. As authored, so a scores query may lack `scorerId` (the card reads\n   * every scorer); the host has to pick one or disable the button.\n   */\n  queries: DashboardQuery[];\n  /**\n   * Each distinct number the view shows, read straight from one query: a series, column or KPI, or,\n   * for one combining several (a ratio, a sum), each part. Same order as the view's options.\n   */\n  sources: DashboardAlertSource[];\n};\n\n/** One number a view reads from one query, as a single alert could watch it. */\nexport type DashboardAlertSource = {\n  /** The series, column or KPI it belongs to; a part of a combined value adds its query and ref. */\n  label: string;\n  /** The query, with the page's filters applied, as in `queries`. */\n  query: DashboardQuery;\n  /** Which of the query's numbers: a measure, a field, a percentile, or only some groups. */\n  ref: DashboardAlertRef;\n};\n\nexport type DashboardAlertRef = Omit<ValueRef, 'query'>;\n\n/** Where the button opens the host's alert editor, or why the view can't become an alert. */\nexport type DashboardAlertAction = { href: string } | { disabled: string };\n\n/**\n * How a host turns a card's open view into an alert. `action` returns one action for the whole card,\n * `undefined` for no button, or an array aligned with `target.sources`: one action per source\n * (`undefined` leaves it out). A card with several sources the host can alert on opens a menu of them.\n * Links render through `LinkComponent`.\n */\nexport type DashboardAlert = {\n  action: (target: DashboardAlertTarget) => DashboardAlertAction | (DashboardAlertAction | undefined)[] | undefined;\n  LinkComponent: NonNullable<ChartCardProps['LinkComponent']>;\n};\n\n/** A widget's gate when it shows: waiting on, or ready to send, its requests. */\nexport type ShownGate = Exclude<WidgetGate, { status: 'hidden' }>;\n\n/**\n * What the user picked on a widget: the open view, and a table's sort and the value column its\n * % Change compares. Unset fields take the widget's defaults.\n */\nexport type WidgetState = { view?: number; sort?: MetricsTableSort; compared?: string };\n\n/** What a kind plans its requests from, once its gate is ready. */\nexport type WidgetPlanContext<Options> = {\n  widget: DashboardWidget;\n  views: WidgetKindProps<Options>['views'];\n  page: DashboardPageContext;\n  blocked: BlockedFields;\n  state: WidgetState;\n};\n\n/** A kind's requests, in the order its answers come back; `undefined` slots aren't sent. */\nexport type WidgetRequests = (DashboardRequest | undefined)[];\n\n/** A widget's pinned state, as the host holds it, and the call that asks the host to change it. */\nexport type WidgetPin = {\n  isPinned: boolean;\n  /** Called with the state the user asked for. */\n  onPin: (isPinned: boolean) => void;\n  /** The widget's name in the button's label (\"Pin Agent runs\"), so each card's button is told apart. */\n  name: string;\n};\n\n/**\n * Where a chart widget expands to (a host's query page), as the Gateway Overview's cards do: the card\n * shows its title with an expand icon linking there, in place of its views menu, on its first view.\n * `href` returns `undefined` for a widget with nowhere to go; that card keeps its menu.\n */\nexport type DashboardExpand = {\n  href: (widget: DashboardWidget) => string | undefined;\n  LinkComponent: NonNullable<ChartCardProps['LinkComponent']>;\n};\n\n/**\n * One kind of widget, self-contained: the renderer only looks it up by name, checks each view's\n * options against `optionsSchema`, sends what `discover` then `requests` plan, and renders\n * `component` with the answers. A kind planning neither sends nothing; its component may still fetch\n * on its own (`ViewGate`, `useDashboardRequests`), but then only `DashboardRenderer` can host it.\n */\nexport type WidgetKind<Options = unknown> = {\n  kind: string;\n  /** Each view's `options`, parsed before the widget renders. */\n  optionsSchema: z.ZodType<Options>;\n  /** Further problems with a view, e.g. options naming a query the view doesn't have. */\n  issues?: (view: ResolvedView<Options>) => string[];\n  /**\n   * Shows the widget even when a page filter can't apply to some of its queries: its views say so\n   * on their own, checking `blocked` (a table's tabs).\n   */\n  partial?: boolean;\n  /**\n   * The queries the page's gates check, given what the user picked. Defaults to every view's, so\n   * pick only the views the widget shows: a closed view's trace query mustn't hide an open metrics one.\n   */\n  gatedQueries?: (views: WidgetPlanContext<Options>['views'], state: WidgetState) => DashboardQuery[];\n  /** Requests whose answers decide what `requests` asks (the scorers to chart, a table's opening tab). */\n  discover?: (ctx: WidgetPlanContext<Options>) => WidgetRequests;\n  /** The requests the widget renders from, given the answers to `discover`. */\n  requests?: (ctx: WidgetPlanContext<Options>, discovered: (DashboardResult | undefined)[]) => WidgetRequests;\n  component: ComponentType<WidgetKindProps<Options>>;\n};\n\n/** Keeps a kind's options type while it joins a list of kinds of different options. */\nexport const defineWidgetKind = <Options>(kind: WidgetKind<Options>): WidgetKind<Options> => kind;\n\n/** A registry entry, whatever its options. */\nexport type AnyWidgetKind = WidgetKind<any>;\n"],"mappings":";;;AA+JA,IAAa,oBAA6B,SAAmD"}

package/dist/domains/dashboards/widget-kind.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"widget-kind.es.js","names":[],"sources":["../../../src/domains/dashboards/widget-kind.ts"],"sourcesContent":["import type { DashboardWidget, DashboardWidgetView } from '@mastra/client-js';\nimport type { ComponentType } from 'react';\nimport type { z } from 'zod/v4';\nimport type { ChartCardProps } from '../metrics/components/chart-card';\nimport type { DashboardScope, OnDashboardDrilldown } from './lib/definition';\n\n/** A view whose options passed its kind's schema. */\nexport type ResolvedView<Options> = DashboardWidgetView & { options: Options };\n\nexport type WidgetKindProps<Options> = {\n  widget: DashboardWidget;\n  /** The views at the page's scope, options parsed. Never empty. */\n  views: [ResolvedView<Options>, ...ResolvedView<Options>[]];\n  scope: DashboardScope;\n  onDrilldown?: OnDashboardDrilldown;\n  /** Where a chart card expands to; see `DashboardExpand`. */\n  expand?: DashboardExpand;\n};\n\n/**\n * Where a chart widget expands to (a host's query page), as the Gateway Overview's cards do: the card\n * shows its title with an expand icon linking there, in place of its views menu, on its first view.\n * `href` returns `undefined` for a widget with nowhere to go; that card keeps its menu.\n */\nexport type DashboardExpand = {\n  href: (widget: DashboardWidget) => string | undefined;\n  LinkComponent: NonNullable<ChartCardProps['LinkComponent']>;\n};\n\n/**\n * One kind of widget, self-contained: the renderer only looks it up by name, checks each view's\n * options against `optionsSchema`, and renders `component`.\n */\nexport type WidgetKind<Options = unknown> = {\n  kind: string;\n  /** Each view's `options`, parsed before the widget renders. */\n  optionsSchema: z.ZodType<Options>;\n  /** Further problems with a view, e.g. options naming a query the view doesn't have. */\n  issues?: (view: ResolvedView<Options>) => string[];\n  component: ComponentType<WidgetKindProps<Options>>;\n};\n\n/** Keeps a kind's options type while it joins a list of kinds of different options. */\nexport const defineWidgetKind = <Options>(kind: WidgetKind<Options>): WidgetKind<Options> => kind;\n\n/** A registry entry, whatever its options. */\nexport type AnyWidgetKind = WidgetKind<any>;\n"],"mappings":";;AA2CA,IAAa,oBAA6B,SAAmD"}
+{"version":3,"file":"widget-kind.es.js","names":[],"sources":["../../../src/domains/dashboards/widget-kind.ts"],"sourcesContent":["import type { DashboardQuery, DashboardWidget, DashboardWidgetView } from '@mastra/client-js';\nimport type { ComponentType } from 'react';\nimport type { z } from 'zod/v4';\nimport type { ChartCardProps } from '../metrics/components/chart-card';\nimport type { DashboardScope, OnDashboardDrilldown } from './lib/definition';\nimport type { BlockedFields, WidgetGate } from './lib/gate';\nimport type { DashboardPageContext, DashboardRequest, DashboardResult } from './lib/requests';\nimport type { ValueRef } from './lib/values';\nimport type { MetricsCardDragHandleProps } from '@/ds/components/MetricsCard';\nimport type { MetricsTableSort } from '@/ds/components/MetricsTable';\n\n/** A view whose options passed its kind's schema. */\nexport type ResolvedView<Options> = DashboardWidgetView & { options: Options };\n\nexport type WidgetKindProps<Options> = {\n  widget: DashboardWidget;\n  /** The views at the page's scope, options parsed. Never empty. */\n  views: [ResolvedView<Options>, ...ResolvedView<Options>[]];\n  scope: DashboardScope;\n  onDrilldown?: OnDashboardDrilldown;\n  /** Where a chart card expands to; see `DashboardExpand`. */\n  expand?: DashboardExpand;\n  /** A grip to drag the widget by, shown left of its title: the host is arranging the dashboard. */\n  dragHandle?: MetricsCardDragHandleProps;\n  /** The widget's pin button, shown with its card's actions: the host can pin widgets. */\n  pin?: WidgetPin;\n  /** The card's Create alert button, for the open view: the host can turn views into alerts. */\n  alert?: DashboardAlert;\n  /** Whether the widget's queries can run on the page, and their page context once they can. */\n  gate: ShownGate;\n  /** What figures are compared against, e.g. `vs previous 24h`. */\n  comparisonLabel: string;\n  /** Display name for a project id, when the page spans several projects. */\n  projectLabel?: (projectId: string) => string;\n  /** What the user picked on the widget, held by the host. */\n  state: WidgetState;\n  /** Called with the whole next state when the user picks a view, sorts, or compares. */\n  onStateChange: (next: WidgetState) => void;\n  /** Answers to the kind's `discover` requests, in order. */\n  discovered: (DashboardResult | undefined)[];\n  /** Answers to the kind's `requests`, in order. */\n  results: (DashboardResult | undefined)[];\n  /** Asks the host to send the failed requests again. */\n  onRetry: () => void;\n};\n\n/** What a card's Create alert button watches: its open view, with the page's filters applied. */\nexport type DashboardAlertTarget = {\n  widget: DashboardWidget;\n  view: DashboardWidgetView;\n  /**\n   * The view's queries with the page's filter bar ANDed in (`pageQuery`). They carry no time window:\n   * the alert picks its own. As authored, so a scores query may lack `scorerId` (the card reads\n   * every scorer); the host has to pick one or disable the button.\n   */\n  queries: DashboardQuery[];\n  /**\n   * Each distinct number the view shows, read straight from one query: a series, column or KPI, or,\n   * for one combining several (a ratio, a sum), each part. Same order as the view's options.\n   */\n  sources: DashboardAlertSource[];\n};\n\n/** One number a view reads from one query, as a single alert could watch it. */\nexport type DashboardAlertSource = {\n  /** The series, column or KPI it belongs to; a part of a combined value adds its query and ref. */\n  label: string;\n  /** The query, with the page's filters applied, as in `queries`. */\n  query: DashboardQuery;\n  /** Which of the query's numbers: a measure, a field, a percentile, or only some groups. */\n  ref: DashboardAlertRef;\n};\n\nexport type DashboardAlertRef = Omit<ValueRef, 'query'>;\n\n/** Where the button opens the host's alert editor, or why the view can't become an alert. */\nexport type DashboardAlertAction = { href: string } | { disabled: string };\n\n/**\n * How a host turns a card's open view into an alert. `action` returns one action for the whole card,\n * `undefined` for no button, or an array aligned with `target.sources`: one action per source\n * (`undefined` leaves it out). A card with several sources the host can alert on opens a menu of them.\n * Links render through `LinkComponent`.\n */\nexport type DashboardAlert = {\n  action: (target: DashboardAlertTarget) => DashboardAlertAction | (DashboardAlertAction | undefined)[] | undefined;\n  LinkComponent: NonNullable<ChartCardProps['LinkComponent']>;\n};\n\n/** A widget's gate when it shows: waiting on, or ready to send, its requests. */\nexport type ShownGate = Exclude<WidgetGate, { status: 'hidden' }>;\n\n/**\n * What the user picked on a widget: the open view, and a table's sort and the value column its\n * % Change compares. Unset fields take the widget's defaults.\n */\nexport type WidgetState = { view?: number; sort?: MetricsTableSort; compared?: string };\n\n/** What a kind plans its requests from, once its gate is ready. */\nexport type WidgetPlanContext<Options> = {\n  widget: DashboardWidget;\n  views: WidgetKindProps<Options>['views'];\n  page: DashboardPageContext;\n  blocked: BlockedFields;\n  state: WidgetState;\n};\n\n/** A kind's requests, in the order its answers come back; `undefined` slots aren't sent. */\nexport type WidgetRequests = (DashboardRequest | undefined)[];\n\n/** A widget's pinned state, as the host holds it, and the call that asks the host to change it. */\nexport type WidgetPin = {\n  isPinned: boolean;\n  /** Called with the state the user asked for. */\n  onPin: (isPinned: boolean) => void;\n  /** The widget's name in the button's label (\"Pin Agent runs\"), so each card's button is told apart. */\n  name: string;\n};\n\n/**\n * Where a chart widget expands to (a host's query page), as the Gateway Overview's cards do: the card\n * shows its title with an expand icon linking there, in place of its views menu, on its first view.\n * `href` returns `undefined` for a widget with nowhere to go; that card keeps its menu.\n */\nexport type DashboardExpand = {\n  href: (widget: DashboardWidget) => string | undefined;\n  LinkComponent: NonNullable<ChartCardProps['LinkComponent']>;\n};\n\n/**\n * One kind of widget, self-contained: the renderer only looks it up by name, checks each view's\n * options against `optionsSchema`, sends what `discover` then `requests` plan, and renders\n * `component` with the answers. A kind planning neither sends nothing; its component may still fetch\n * on its own (`ViewGate`, `useDashboardRequests`), but then only `DashboardRenderer` can host it.\n */\nexport type WidgetKind<Options = unknown> = {\n  kind: string;\n  /** Each view's `options`, parsed before the widget renders. */\n  optionsSchema: z.ZodType<Options>;\n  /** Further problems with a view, e.g. options naming a query the view doesn't have. */\n  issues?: (view: ResolvedView<Options>) => string[];\n  /**\n   * Shows the widget even when a page filter can't apply to some of its queries: its views say so\n   * on their own, checking `blocked` (a table's tabs).\n   */\n  partial?: boolean;\n  /**\n   * The queries the page's gates check, given what the user picked. Defaults to every view's, so\n   * pick only the views the widget shows: a closed view's trace query mustn't hide an open metrics one.\n   */\n  gatedQueries?: (views: WidgetPlanContext<Options>['views'], state: WidgetState) => DashboardQuery[];\n  /** Requests whose answers decide what `requests` asks (the scorers to chart, a table's opening tab). */\n  discover?: (ctx: WidgetPlanContext<Options>) => WidgetRequests;\n  /** The requests the widget renders from, given the answers to `discover`. */\n  requests?: (ctx: WidgetPlanContext<Options>, discovered: (DashboardResult | undefined)[]) => WidgetRequests;\n  component: ComponentType<WidgetKindProps<Options>>;\n};\n\n/** Keeps a kind's options type while it joins a list of kinds of different options. */\nexport const defineWidgetKind = <Options>(kind: WidgetKind<Options>): WidgetKind<Options> => kind;\n\n/** A registry entry, whatever its options. */\nexport type AnyWidgetKind = WidgetKind<any>;\n"],"mappings":";;AA+JA,IAAa,oBAA6B,SAAmD"}

package/dist/domains/dashboards.cjs.js

@@ -1,21 +1,27 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_domains_dashboards_components_dashboard_renderer = require("./dashboards/components/dashboard-renderer.cjs.js");
+const require_domains_dashboards_lib_prepare_widget = require("./dashboards/lib/prepare-widget.cjs.js");
 const require_domains_dashboards_components_dashboard_grid = require("./dashboards/components/dashboard-grid.cjs.js");
-const require_domains_dashboards_widget_kind = require("./dashboards/widget-kind.cjs.js");
-const require_domains_dashboards_lib_requests = require("./dashboards/lib/requests.cjs.js");
 const require_domains_dashboards_components_view_gate = require("./dashboards/components/view-gate.cjs.js");
+const require_domains_dashboards_components_widget_error = require("./dashboards/components/widget-error.cjs.js");
+const require_domains_dashboards_components_widget_controls = require("./dashboards/components/widget-controls.cjs.js");
+const require_domains_dashboards_metrics_dashboard = require("./dashboards/metrics-dashboard.cjs.js");
+const require_domains_dashboards_components_stateless_widget = require("./dashboards/components/stateless-widget.cjs.js");
 const require_domains_dashboards_hooks_use_dashboard_requests = require("./dashboards/hooks/use-dashboard-requests.cjs.js");
+const require_domains_dashboards_hooks_use_dashboard_environment = require("./dashboards/hooks/use-dashboard-environment.cjs.js");
 const require_domains_dashboards_kinds_kpis = require("./dashboards/kinds/kpis.cjs.js");
 const require_domains_dashboards_kinds_scores = require("./dashboards/kinds/scores.cjs.js");
-const require_domains_dashboards_lib_definition = require("./dashboards/lib/definition.cjs.js");
 const require_domains_dashboards_hooks_use_widget_views = require("./dashboards/hooks/use-widget-views.cjs.js");
 const require_domains_dashboards_kinds_table = require("./dashboards/kinds/table.cjs.js");
-const require_domains_dashboards_components_widget_controls = require("./dashboards/components/widget-controls.cjs.js");
 const require_domains_dashboards_kinds_timeseries = require("./dashboards/kinds/timeseries.cjs.js");
+const require_domains_dashboards_lib_plan_widget = require("./dashboards/lib/plan-widget.cjs.js");
+const require_domains_dashboards_lib_gate = require("./dashboards/lib/gate.cjs.js");
 const require_domains_dashboards_kinds = require("./dashboards/kinds.cjs.js");
-const require_domains_dashboards_lib_prepare_widget = require("./dashboards/lib/prepare-widget.cjs.js");
-const require_domains_dashboards_components_widget_error = require("./dashboards/components/widget-error.cjs.js");
-const require_domains_dashboards_components_dashboard_renderer = require("./dashboards/components/dashboard-renderer.cjs.js");
-const require_domains_dashboards_metrics_dashboard = require("./dashboards/metrics-dashboard.cjs.js");
+const require_domains_dashboards_lib_definition = require("./dashboards/lib/definition.cjs.js");
+const require_domains_dashboards_lib_requests = require("./dashboards/lib/requests.cjs.js");
+const require_domains_dashboards_widget_kind = require("./dashboards/widget-kind.cjs.js");
+exports.AlertAction = require_domains_dashboards_components_widget_controls.AlertAction;
+exports.AlertMenu = require_domains_dashboards_components_widget_controls.AlertMenu;
 exports.BUILT_IN_WIDGET_KINDS = require_domains_dashboards_kinds.BUILT_IN_WIDGET_KINDS;
 exports.DashboardGrid = require_domains_dashboards_components_dashboard_grid.DashboardGrid;
 exports.DashboardGridCell = require_domains_dashboards_components_dashboard_grid.DashboardGridCell;
@@ -23,17 +29,29 @@ exports.DashboardGridRow = require_domains_dashboards_components_dashboard_grid.
 exports.DashboardRenderer = require_domains_dashboards_components_dashboard_renderer.DashboardRenderer;
 exports.DrilldownAction = require_domains_dashboards_components_widget_controls.DrilldownAction;
 exports.METRICS_DASHBOARD = require_domains_dashboards_metrics_dashboard.METRICS_DASHBOARD;
+exports.PinAction = require_domains_dashboards_components_widget_controls.PinAction;
+exports.StatelessWidget = require_domains_dashboards_components_stateless_widget.StatelessWidget;
 exports.ViewGate = require_domains_dashboards_components_view_gate.ViewGate;
 exports.WidgetError = require_domains_dashboards_components_widget_error.WidgetError;
 exports.buildRequest = require_domains_dashboards_lib_requests.buildRequest;
 exports.dashboardDefaults = require_domains_dashboards_lib_definition.dashboardDefaults;
 exports.defineWidgetKind = require_domains_dashboards_widget_kind.defineWidgetKind;
+exports.emptyAnswer = require_domains_dashboards_lib_requests.emptyAnswer;
 exports.hasDrilldownAction = require_domains_dashboards_hooks_use_widget_views.hasDrilldownAction;
 exports.kpisKind = require_domains_dashboards_kinds_kpis.kpisKind;
+exports.pageQuery = require_domains_dashboards_lib_requests.pageQuery;
+exports.planWidget = require_domains_dashboards_lib_plan_widget.planWidget;
 exports.prepareWidget = require_domains_dashboards_lib_prepare_widget.prepareWidget;
+exports.requestKey = require_domains_dashboards_lib_requests.requestKey;
 exports.scoresKind = require_domains_dashboards_kinds_scores.scoresKind;
+exports.sendRequest = require_domains_dashboards_lib_requests.sendRequest;
 exports.tableKind = require_domains_dashboards_kinds_table.tableKind;
 exports.timeseriesKind = require_domains_dashboards_kinds_timeseries.timeseriesKind;
+exports.toDashboardResult = require_domains_dashboards_hooks_use_dashboard_requests.toDashboardResult;
+exports.useDashboardEnvironment = require_domains_dashboards_hooks_use_dashboard_environment.useDashboardEnvironment;
 exports.useDashboardRequests = require_domains_dashboards_hooks_use_dashboard_requests.useDashboardRequests;
+exports.useDashboardResults = require_domains_dashboards_hooks_use_dashboard_requests.useDashboardResults;
 exports.useDrilldown = require_domains_dashboards_hooks_use_widget_views.useDrilldown;
 exports.useViewMenu = require_domains_dashboards_hooks_use_widget_views.useViewMenu;
+exports.viewMenu = require_domains_dashboards_hooks_use_widget_views.viewMenu;
+exports.widgetGate = require_domains_dashboards_lib_gate.widgetGate;

package/dist/domains/dashboards.es.js

@@ -1,18 +1,22 @@
+import { DashboardRenderer } from "./dashboards/components/dashboard-renderer.es.js";
+import { prepareWidget } from "./dashboards/lib/prepare-widget.es.js";
 import { DashboardGrid, DashboardGridCell, DashboardGridRow } from "./dashboards/components/dashboard-grid.es.js";
-import { defineWidgetKind } from "./dashboards/widget-kind.es.js";
-import { buildRequest } from "./dashboards/lib/requests.es.js";
 import { ViewGate } from "./dashboards/components/view-gate.es.js";
-import { useDashboardRequests } from "./dashboards/hooks/use-dashboard-requests.es.js";
+import { WidgetError } from "./dashboards/components/widget-error.es.js";
+import { AlertAction, AlertMenu, DrilldownAction, PinAction } from "./dashboards/components/widget-controls.es.js";
+import { METRICS_DASHBOARD } from "./dashboards/metrics-dashboard.es.js";
+import { StatelessWidget } from "./dashboards/components/stateless-widget.es.js";
+import { toDashboardResult, useDashboardRequests, useDashboardResults } from "./dashboards/hooks/use-dashboard-requests.es.js";
+import { useDashboardEnvironment } from "./dashboards/hooks/use-dashboard-environment.es.js";
 import { kpisKind } from "./dashboards/kinds/kpis.es.js";
 import { scoresKind } from "./dashboards/kinds/scores.es.js";
-import { dashboardDefaults } from "./dashboards/lib/definition.es.js";
-import { hasDrilldownAction, useDrilldown, useViewMenu } from "./dashboards/hooks/use-widget-views.es.js";
+import { hasDrilldownAction, useDrilldown, useViewMenu, viewMenu } from "./dashboards/hooks/use-widget-views.es.js";
 import { tableKind } from "./dashboards/kinds/table.es.js";
-import { DrilldownAction } from "./dashboards/components/widget-controls.es.js";
 import { timeseriesKind } from "./dashboards/kinds/timeseries.es.js";
+import { planWidget } from "./dashboards/lib/plan-widget.es.js";
+import { widgetGate } from "./dashboards/lib/gate.es.js";
 import { BUILT_IN_WIDGET_KINDS } from "./dashboards/kinds.es.js";
-import { prepareWidget } from "./dashboards/lib/prepare-widget.es.js";
-import { WidgetError } from "./dashboards/components/widget-error.es.js";
-import { DashboardRenderer } from "./dashboards/components/dashboard-renderer.es.js";
-import { METRICS_DASHBOARD } from "./dashboards/metrics-dashboard.es.js";
-export { BUILT_IN_WIDGET_KINDS, DashboardGrid, DashboardGridCell, DashboardGridRow, DashboardRenderer, DrilldownAction, METRICS_DASHBOARD, ViewGate, WidgetError, buildRequest, dashboardDefaults, defineWidgetKind, hasDrilldownAction, kpisKind, prepareWidget, scoresKind, tableKind, timeseriesKind, useDashboardRequests, useDrilldown, useViewMenu };
+import { dashboardDefaults } from "./dashboards/lib/definition.es.js";
+import { buildRequest, emptyAnswer, pageQuery, requestKey, sendRequest } from "./dashboards/lib/requests.es.js";
+import { defineWidgetKind } from "./dashboards/widget-kind.es.js";
+export { AlertAction, AlertMenu, BUILT_IN_WIDGET_KINDS, DashboardGrid, DashboardGridCell, DashboardGridRow, DashboardRenderer, DrilldownAction, METRICS_DASHBOARD, PinAction, StatelessWidget, ViewGate, WidgetError, buildRequest, dashboardDefaults, defineWidgetKind, emptyAnswer, hasDrilldownAction, kpisKind, pageQuery, planWidget, prepareWidget, requestKey, scoresKind, sendRequest, tableKind, timeseriesKind, toDashboardResult, useDashboardEnvironment, useDashboardRequests, useDashboardResults, useDrilldown, useViewMenu, viewMenu, widgetGate };

package/dist/domains/datasets/components/add-dataset-item-dialog/add-dataset-item-dialog.cjs.js

@@ -1,22 +1,22 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_lib_framework = require("../../../../lib/framework.cjs.js");
-const require_utils = require("../../../../utils-uDc1ofX1.cjs");
-const require_Button = require("../../../../Button-DLcMcuUL.cjs");
-const require_Txt = require("../../../../Txt-BnoSqxKE.cjs");
-const require_toast_api = require("../../../../toast-api-qtkOucy2.cjs");
-const require_Badge = require("../../../../Badge-DZ6r6bcw.cjs");
-const require_Dialog = require("../../../../Dialog-BvWF9HE-.cjs");
-const require_CodeEditor = require("../../../../CodeEditor-CLzs0yVc.cjs");
-const require_components_Field = require("../../../../components/Field.cjs.js");
-const require_domains_datasets_components_add_dataset_item_dialog_trajectory_types = require("./trajectory-types.cjs.js");
 const require_domains_datasets_components_add_dataset_item_dialog_build_add_item_payload = require("./build-add-item-payload.cjs.js");
-const require_settings_row = require("../../../../settings-row-a7g1V6lB.cjs");
 const require_domains_datasets_components_add_dataset_item_dialog_collapsible_settings_row = require("./collapsible-settings-row.cjs.js");
 const require_domains_datasets_components_add_dataset_item_dialog_dataset_field_errors = require("./dataset-field-errors.cjs.js");
 const require_domains_datasets_components_add_dataset_item_dialog_dataset_picker = require("./dataset-picker.cjs.js");
 const require_domains_datasets_components_add_dataset_item_dialog_field_errors = require("./field-errors.cjs.js");
 const require_domains_datasets_components_add_dataset_item_dialog_trajectory_editor = require("./trajectory-editor.cjs.js");
+const require_domains_datasets_components_add_dataset_item_dialog_trajectory_types = require("./trajectory-types.cjs.js");
 const require_domains_datasets_components_add_dataset_item_dialog_use_target_agent_tools = require("./use-target-agent-tools.cjs.js");
+const require_Badge = require("../../../../Badge-DqaMg7Gy.cjs");
+const require_Button = require("../../../../Button-BfICfyxD.cjs");
+const require_CodeEditor = require("../../../../CodeEditor-DHIDfP5g.cjs");
+const require_Dialog = require("../../../../Dialog-Duy3M1ny.cjs");
+const require_components_Field = require("../../../../components/Field.cjs.js");
+const require_Txt = require("../../../../Txt-_00wWxTd.cjs");
+const require_settings_row = require("../../../../settings-row-a7g1V6lB.cjs");
+const require_lib_framework = require("../../../../lib/framework.cjs.js");
+const require_utils = require("../../../../utils-uDc1ofX1.cjs");
+const require_toast_api = require("../../../../toast-api-DDcGCbIw.cjs");
 let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
 let _mastra_react_hooks_datasets = require("@mastra/react/hooks/datasets");

package/dist/domains/datasets/components/add-dataset-item-dialog/add-dataset-item-dialog.es.js

@@ -1,21 +1,21 @@
-import { useLinkComponent } from "../../../../lib/framework.es.js";
-import { t as cn } from "../../../../utils-DQx8TpNT.js";
-import { t as Button } from "../../../../Button-CLXTbAY8.js";
-import { t as Txt } from "../../../../Txt-BM6TVV_c.js";
-import { t as toast } from "../../../../toast-api-D_rrRhNG.js";
-import { t as Badge } from "../../../../Badge-aVu5iGAF.js";
-import { a as DialogContent, c as DialogHeader, d as DialogTitle, n as DialogBody, o as DialogDescription, p as DialogAction, r as DialogCancel, s as DialogFooter, t as Dialog } from "../../../../Dialog-DaWtxwd9.js";
-import { t as CodeEditor } from "../../../../CodeEditor-COnz9c6B.js";
-import { Field, FieldDescription, FieldError, FieldLabel } from "../../../../components/Field.es.js";
-import { toTrajectoryStepRow } from "./trajectory-types.es.js";
 import { buildAddItemPayload } from "./build-add-item-payload.es.js";
-import { i as SettingsContainer } from "../../../../settings-row-O9qu9rre.js";
 import { CollapsibleSettingsRow } from "./collapsible-settings-row.es.js";
 import { DatasetFieldErrors } from "./dataset-field-errors.es.js";
 import { DatasetPicker } from "./dataset-picker.es.js";
 import { parseFieldErrors } from "./field-errors.es.js";
 import { TrajectoryEditor } from "./trajectory-editor.es.js";
+import { toTrajectoryStepRow } from "./trajectory-types.es.js";
 import { useTargetAgentTools } from "./use-target-agent-tools.es.js";
+import { t as Badge } from "../../../../Badge-C7NnqmMx.js";
+import { t as Button } from "../../../../Button-Bi7aXd_G.js";
+import { t as CodeEditor } from "../../../../CodeEditor-ZoBu3Gjw.js";
+import { a as DialogContent, c as DialogHeader, d as DialogTitle, n as DialogBody, o as DialogDescription, p as DialogAction, r as DialogCancel, s as DialogFooter, t as Dialog } from "../../../../Dialog-OBPu3rl2.js";
+import { Field, FieldDescription, FieldError, FieldLabel } from "../../../../components/Field.es.js";
+import { t as Txt } from "../../../../Txt-5efBsb2p.js";
+import { i as SettingsContainer } from "../../../../settings-row-O9qu9rre.js";
+import { useLinkComponent } from "../../../../lib/framework.es.js";
+import { t as cn } from "../../../../utils-DQx8TpNT.js";
+import { t as toast } from "../../../../toast-api-Cak5N8pT.js";
 import { useState } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { useDataset, useDatasetMutations, useDatasets } from "@mastra/react/hooks/datasets";

package/dist/domains/datasets/components/add-dataset-item-dialog/dataset-picker.cjs.js

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_icons_Icon = require("../../../../icons/Icon.cjs.js");
-const require_select = require("../../../../select-Dg8L5ROX.cjs");
-const require_Txt = require("../../../../Txt-BnoSqxKE.cjs");
 const require_components_Field = require("../../../../components/Field.cjs.js");
+const require_select = require("../../../../select-CeukeSn_.cjs");
+const require_Txt = require("../../../../Txt-_00wWxTd.cjs");
+const require_icons_Icon = require("../../../../icons/Icon.cjs.js");
 let react_jsx_runtime = require("react/jsx-runtime");
 let lucide_react = require("lucide-react");
 // src/domains/datasets/components/add-dataset-item-dialog/dataset-picker.tsx

package/dist/domains/datasets/components/add-dataset-item-dialog/dataset-picker.es.js

@@ -1,7 +1,7 @@
-import { Icon } from "../../../../icons/Icon.es.js";
-import { a as SelectSeparator, i as SelectItem, n as SelectContent, o as SelectTrigger, s as SelectValue, t as Select } from "../../../../select-BdIZEdcy.js";
-import { t as Txt } from "../../../../Txt-BM6TVV_c.js";
 import { Field, FieldLabel } from "../../../../components/Field.es.js";
+import { a as SelectSeparator, i as SelectItem, n as SelectContent, o as SelectTrigger, s as SelectValue, t as Select } from "../../../../select-dNX9If-s.js";
+import { t as Txt } from "../../../../Txt-5efBsb2p.js";
+import { Icon } from "../../../../icons/Icon.es.js";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { Plus } from "lucide-react";
 // src/domains/datasets/components/add-dataset-item-dialog/dataset-picker.tsx

package/dist/domains/datasets/components/add-dataset-item-dialog/trajectory-editor.cjs.js

@@ -1,13 +1,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_Button = require("../../../../Button-DLcMcuUL.cjs");
-const require_select = require("../../../../select-Dg8L5ROX.cjs");
-const require_Txt = require("../../../../Txt-BnoSqxKE.cjs");
-const require_input = require("../../../../input-2hRXcZIu.cjs");
+const require_domains_datasets_components_add_dataset_item_dialog_trajectory_types = require("./trajectory-types.cjs.js");
+const require_Button = require("../../../../Button-BfICfyxD.cjs");
+const require_CodeEditor = require("../../../../CodeEditor-DHIDfP5g.cjs");
 const require_components_Collapsible = require("../../../../components/Collapsible.cjs.js");
 const require_components_DisclosureChevron = require("../../../../components/DisclosureChevron.cjs.js");
-const require_CodeEditor = require("../../../../CodeEditor-CLzs0yVc.cjs");
-const require_domains_datasets_components_add_dataset_item_dialog_trajectory_types = require("./trajectory-types.cjs.js");
+const require_input = require("../../../../input-BpnUsQSt.cjs");
 const require_components_SegmentedControl = require("../../../../components/SegmentedControl.cjs.js");
+const require_select = require("../../../../select-CeukeSn_.cjs");
+const require_Txt = require("../../../../Txt-_00wWxTd.cjs");
 let react_jsx_runtime = require("react/jsx-runtime");
 let lucide_react = require("lucide-react");
 // src/domains/datasets/components/add-dataset-item-dialog/trajectory-editor.tsx

package/dist/domains/datasets/components/add-dataset-item-dialog/trajectory-editor.es.js

@@ -1,12 +1,12 @@
-import { t as Button } from "../../../../Button-CLXTbAY8.js";
-import { i as SelectItem, n as SelectContent, o as SelectTrigger, s as SelectValue, t as Select } from "../../../../select-BdIZEdcy.js";
-import { t as Txt } from "../../../../Txt-BM6TVV_c.js";
-import { t as Input } from "../../../../input-0l1uzOBZ.js";
+import { ORDERING_LABELS, STEP_TYPE_OPTIONS, isStepTypeOption, isToolStepType, isTrajectoryOrdering, newTrajectoryStep, recordedDetails } from "./trajectory-types.es.js";
+import { t as Button } from "../../../../Button-Bi7aXd_G.js";
+import { t as CodeEditor } from "../../../../CodeEditor-ZoBu3Gjw.js";
 import { Collapsible, CollapsibleContent, CollapsibleTrigger } from "../../../../components/Collapsible.es.js";
 import { DisclosureChevron } from "../../../../components/DisclosureChevron.es.js";
-import { t as CodeEditor } from "../../../../CodeEditor-COnz9c6B.js";
-import { ORDERING_LABELS, STEP_TYPE_OPTIONS, isStepTypeOption, isToolStepType, isTrajectoryOrdering, newTrajectoryStep, recordedDetails } from "./trajectory-types.es.js";
+import { t as Input } from "../../../../input-Cyit5ZSc.js";
 import { SegmentedControl, SegmentedControlItem } from "../../../../components/SegmentedControl.es.js";
+import { i as SelectItem, n as SelectContent, o as SelectTrigger, s as SelectValue, t as Select } from "../../../../select-dNX9If-s.js";
+import { t as Txt } from "../../../../Txt-5efBsb2p.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { ArrowDown, ArrowUp, Plus, Trash2 } from "lucide-react";
 // src/domains/datasets/components/add-dataset-item-dialog/trajectory-editor.tsx

package/dist/domains/datasets/components/save-as-dataset-item-dialog.cjs.js

@@ -1,14 +1,14 @@
 "use client";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_lib_framework = require("../../../lib/framework.cjs.js");
-const require_Button = require("../../../Button-DLcMcuUL.cjs");
-const require_select = require("../../../select-Dg8L5ROX.cjs");
-const require_Txt = require("../../../Txt-BnoSqxKE.cjs");
-const require_toast_api = require("../../../toast-api-qtkOucy2.cjs");
-const require_CodeEditor = require("../../../CodeEditor-CLzs0yVc.cjs");
-const require_DataPanel = require("../../../DataPanel-Coc9h35I.cjs");
+const require_Button = require("../../../Button-BfICfyxD.cjs");
+const require_CodeEditor = require("../../../CodeEditor-DHIDfP5g.cjs");
+const require_DataPanel = require("../../../DataPanel-BRRAvWYQ.cjs");
 const require_components_Field = require("../../../components/Field.cjs.js");
 const require_components_Form = require("../../../components/Form.cjs.js");
+const require_select = require("../../../select-CeukeSn_.cjs");
+const require_Txt = require("../../../Txt-_00wWxTd.cjs");
+const require_lib_framework = require("../../../lib/framework.cjs.js");
+const require_toast_api = require("../../../toast-api-DDcGCbIw.cjs");
 let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
 let lucide_react = require("lucide-react");

package/dist/domains/datasets/components/save-as-dataset-item-dialog.es.js

@@ -1,13 +1,13 @@
 "use client";
-import { useLinkComponent } from "../../../lib/framework.es.js";
-import { t as Button } from "../../../Button-CLXTbAY8.js";
-import { i as SelectItem, n as SelectContent, o as SelectTrigger, s as SelectValue, t as Select } from "../../../select-BdIZEdcy.js";
-import { t as Txt } from "../../../Txt-BM6TVV_c.js";
-import { t as toast } from "../../../toast-api-D_rrRhNG.js";
-import { t as CodeEditor } from "../../../CodeEditor-COnz9c6B.js";
-import { t as DataPanel } from "../../../DataPanel-IgB9D5PO.js";
+import { t as Button } from "../../../Button-Bi7aXd_G.js";
+import { t as CodeEditor } from "../../../CodeEditor-ZoBu3Gjw.js";
+import { t as DataPanel } from "../../../DataPanel-pVr5LVaK.js";
 import { Field, FieldLabel } from "../../../components/Field.es.js";
 import { Form } from "../../../components/Form.es.js";
+import { i as SelectItem, n as SelectContent, o as SelectTrigger, s as SelectValue, t as Select } from "../../../select-dNX9If-s.js";
+import { t as Txt } from "../../../Txt-5efBsb2p.js";
+import { useLinkComponent } from "../../../lib/framework.es.js";
+import { t as toast } from "../../../toast-api-Cak5N8pT.js";
 import { useEffect, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Check, X } from "lucide-react";

package/dist/domains/knowledge/components/KnowledgePageCard.cjs.js

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_Txt = require("../../../Txt-BnoSqxKE.cjs");
 const require_domains_knowledge_lib_linkCountsText = require("../lib/linkCountsText.cjs.js");
+const require_Metadata = require("../../../Metadata-5GJlO4GU.cjs");
+const require_Txt = require("../../../Txt-_00wWxTd.cjs");
 let react_jsx_runtime = require("react/jsx-runtime");
 // src/domains/knowledge/components/KnowledgePageCard.tsx
 /**
@@ -21,7 +22,7 @@ function KnowledgePageCard({ name, kind, pageRef, path, childCount, links, notSh
 			as: "span",
 			variant: "meta",
 			tone: "muted",
-			children: pageRef ? `${kind} · ${pageRef}` : kind
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_Metadata.Metadata, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_Metadata.Metadata.Item, { children: kind }), pageRef && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_Metadata.Metadata.Item, { children: pageRef })] })
 		}),
 		path ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_Txt.Txt, {
 			as: "span",

package/dist/domains/knowledge/components/KnowledgePageCard.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"KnowledgePageCard.cjs.js","names":["linkCountsText","_Fragment","Txt"],"sources":["../../../../src/domains/knowledge/components/KnowledgePageCard.tsx"],"sourcesContent":["import { linkCountsText } from '../lib/linkCountsText';\nimport { Txt } from '@/ds/components/Txt';\n\nexport interface KnowledgePageCardProps {\n  name: string;\n  /** `Page`, `Scope` or a scope's display label. */\n  kind: string;\n  /** Where the page is addressed, e.g. `org:acme#policies/refunds`. */\n  pageRef?: string;\n  /** Where the page sits, from its root scope down. */\n  path?: string;\n  /** Already formatted (`1000+` when the server capped the count); left out when unknown or zero. */\n  childCount?: string;\n  /** Left out when unknown or both zero. */\n  links?: { in: number; out: number };\n  /** Of `links`, how many go to pages the graph doesn't draw. */\n  notShown?: number;\n}\n\n/**\n * What the explorer's graph tooltip says about a page: name, kind and ref, children, links. The graph's\n * dots and the hover cards on page links in chat both draw it.\n */\nexport function KnowledgePageCard({ name, kind, pageRef, path, childCount, links, notShown }: KnowledgePageCardProps) {\n  const children =\n    childCount && childCount !== '0' ? `${childCount} ${childCount === '1' ? 'child' : 'children'}` : null;\n  const linkText = links && (links.in > 0 || links.out > 0) ? linkCountsText(links, notShown) : null;\n  return (\n    <>\n      <Txt as=\"span\" variant=\"label\" tone=\"ink\">\n        {name}\n      </Txt>\n      <Txt as=\"span\" variant=\"meta\" tone=\"muted\">\n        {pageRef ? `${kind} · ${pageRef}` : kind}\n      </Txt>\n      {path ? (\n        <Txt as=\"span\" variant=\"meta\" tone=\"muted\">\n          {path}\n        </Txt>\n      ) : null}\n      {children ? (\n        <Txt as=\"span\" variant=\"meta\" tone=\"muted\">\n          {children}\n        </Txt>\n      ) : null}\n      {linkText ? (\n        <Txt as=\"span\" variant=\"meta\" tone=\"muted\">\n          {linkText}\n        </Txt>\n      ) : null}\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;AAuBA,SAAgB,kBAAkB,EAAE,MAAM,MAAM,SAAS,MAAM,YAAY,OAAO,YAAoC;CACpH,MAAM,WACJ,cAAc,eAAe,MAAM,GAAG,WAAW,GAAG,eAAe,MAAM,UAAU,eAAe;CACpG,MAAM,WAAW,UAAU,MAAM,KAAK,KAAK,MAAM,MAAM,KAAKA,6CAAAA,eAAe,OAAO,QAAQ,IAAI;CAC9F,OACE,iBAAA,GAAA,kBAAA,KAAA,CAAAC,kBAAAA,UAAA,EAAA,UAAA;EACE,iBAAA,GAAA,kBAAA,IAAA,CAACC,YAAAA,KAAD;GAAK,IAAG;GAAO,SAAQ;GAAQ,MAAK;GACjC,UAAA;EACE,CAAA;EACL,iBAAA,GAAA,kBAAA,IAAA,CAACA,YAAAA,KAAD;GAAK,IAAG;GAAO,SAAQ;GAAO,MAAK;GAChC,UAAA,UAAU,GAAG,KAAK,KAAK,YAAY;EACjC,CAAA;EACJ,OACC,iBAAA,GAAA,kBAAA,IAAA,CAACA,YAAAA,KAAD;GAAK,IAAG;GAAO,SAAQ;GAAO,MAAK;GAChC,UAAA;EACE,CAAA,IACH;EACH,WACC,iBAAA,GAAA,kBAAA,IAAA,CAACA,YAAAA,KAAD;GAAK,IAAG;GAAO,SAAQ;GAAO,MAAK;GAChC;EACE,CAAA,IACH;EACH,WACC,iBAAA,GAAA,kBAAA,IAAA,CAACA,YAAAA,KAAD;GAAK,IAAG;GAAO,SAAQ;GAAO,MAAK;GAChC,UAAA;EACE,CAAA,IACH;CACJ,EAAA,CAAA;AAEN"}
+{"version":3,"file":"KnowledgePageCard.cjs.js","names":["linkCountsText","_Fragment","Txt","Metadata"],"sources":["../../../../src/domains/knowledge/components/KnowledgePageCard.tsx"],"sourcesContent":["import { linkCountsText } from '../lib/linkCountsText';\nimport { Metadata } from '@/ds/components/Metadata';\nimport { Txt } from '@/ds/components/Txt';\n\nexport interface KnowledgePageCardProps {\n  name: string;\n  /** `Page`, `Scope` or a scope's display label. */\n  kind: string;\n  /** Where the page is addressed, e.g. `org:acme#policies/refunds`. */\n  pageRef?: string;\n  /** Where the page sits, from its root scope down. */\n  path?: string;\n  /** Already formatted (`1000+` when the server capped the count); left out when unknown or zero. */\n  childCount?: string;\n  /** Left out when unknown or both zero. */\n  links?: { in: number; out: number };\n  /** Of `links`, how many go to pages the graph doesn't draw. */\n  notShown?: number;\n}\n\n/**\n * What the explorer's graph tooltip says about a page: name, kind and ref, children, links. The graph's\n * dots and the hover cards on page links in chat both draw it.\n */\nexport function KnowledgePageCard({ name, kind, pageRef, path, childCount, links, notShown }: KnowledgePageCardProps) {\n  const children =\n    childCount && childCount !== '0' ? `${childCount} ${childCount === '1' ? 'child' : 'children'}` : null;\n  const linkText = links && (links.in > 0 || links.out > 0) ? linkCountsText(links, notShown) : null;\n  return (\n    <>\n      <Txt as=\"span\" variant=\"label\" tone=\"ink\">\n        {name}\n      </Txt>\n      <Txt as=\"span\" variant=\"meta\" tone=\"muted\">\n        <Metadata>\n          <Metadata.Item>{kind}</Metadata.Item>\n          {pageRef && <Metadata.Item>{pageRef}</Metadata.Item>}\n        </Metadata>\n      </Txt>\n      {path ? (\n        <Txt as=\"span\" variant=\"meta\" tone=\"muted\">\n          {path}\n        </Txt>\n      ) : null}\n      {children ? (\n        <Txt as=\"span\" variant=\"meta\" tone=\"muted\">\n          {children}\n        </Txt>\n      ) : null}\n      {linkText ? (\n        <Txt as=\"span\" variant=\"meta\" tone=\"muted\">\n          {linkText}\n        </Txt>\n      ) : null}\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;AAwBA,SAAgB,kBAAkB,EAAE,MAAM,MAAM,SAAS,MAAM,YAAY,OAAO,YAAoC;CACpH,MAAM,WACJ,cAAc,eAAe,MAAM,GAAG,WAAW,GAAG,eAAe,MAAM,UAAU,eAAe;CACpG,MAAM,WAAW,UAAU,MAAM,KAAK,KAAK,MAAM,MAAM,KAAKA,6CAAAA,eAAe,OAAO,QAAQ,IAAI;CAC9F,OACE,iBAAA,GAAA,kBAAA,KAAA,CAAAC,kBAAAA,UAAA,EAAA,UAAA;EACE,iBAAA,GAAA,kBAAA,IAAA,CAACC,YAAAA,KAAD;GAAK,IAAG;GAAO,SAAQ;GAAQ,MAAK;GACjC,UAAA;EACE,CAAA;EACL,iBAAA,GAAA,kBAAA,IAAA,CAACA,YAAAA,KAAD;GAAK,IAAG;GAAO,SAAQ;GAAO,MAAK;GACjC,UAAA,iBAAA,GAAA,kBAAA,KAAA,CAACC,iBAAAA,UAAD,EAAA,UAAA,CACE,iBAAA,GAAA,kBAAA,IAAA,CAACA,iBAAAA,SAAS,MAAV,EAAA,UAAgB,KAAoB,CAAA,GACnC,WAAW,iBAAA,GAAA,kBAAA,IAAA,CAACA,iBAAAA,SAAS,MAAV,EAAA,UAAgB,QAAuB,CAAA,CAC3C,EAAA,CAAA;EACP,CAAA;EACJ,OACC,iBAAA,GAAA,kBAAA,IAAA,CAACD,YAAAA,KAAD;GAAK,IAAG;GAAO,SAAQ;GAAO,MAAK;GAChC,UAAA;EACE,CAAA,IACH;EACH,WACC,iBAAA,GAAA,kBAAA,IAAA,CAACA,YAAAA,KAAD;GAAK,IAAG;GAAO,SAAQ;GAAO,MAAK;GAChC;EACE,CAAA,IACH;EACH,WACC,iBAAA,GAAA,kBAAA,IAAA,CAACA,YAAAA,KAAD;GAAK,IAAG;GAAO,SAAQ;GAAO,MAAK;GAChC,UAAA;EACE,CAAA,IACH;CACJ,EAAA,CAAA;AAEN"}