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

package/dist/src/domains/dashboards/kinds/timeseries/timeseries-plan.d.ts

@@ -0,0 +1,355 @@
+import type { TimeseriesOptions } from '../../lib/timeseries';
+import type { WidgetPlanContext, WidgetState } from '../../widget-kind';
+/** Only the open view is gated: a closed view's trace query mustn't hold up a metrics one. */
+export declare const timeseriesGatedQueries: (views: WidgetPlanContext<TimeseriesOptions>['views'], state: WidgetState) => ({
+    name: string[];
+    aggregation: "avg" | "count" | "count_distinct" | "last" | "max" | "min" | "sum";
+    distinctColumn?: "entityName" | "entityType" | "environment" | "executionSource" | "model" | "name" | "parentEntityName" | "parentEntityType" | "provider" | "resourceId" | "rootEntityName" | "rootEntityType" | "serviceName" | "threadId" | undefined;
+    source: "metrics";
+    id?: string | undefined;
+    compare?: "previousWindow" | undefined;
+    request: "aggregate";
+    filters?: {
+        traceId?: string | undefined;
+        spanId?: string | undefined;
+        entityType?: import("@mastra/core/storage").EntityType | undefined;
+        entityName?: string | undefined;
+        entityVersionId?: string | undefined;
+        parentEntityVersionId?: string | undefined;
+        rootEntityVersionId?: string | undefined;
+        userId?: string | undefined;
+        organizationId?: string | undefined;
+        experimentId?: string | undefined;
+        serviceName?: string | undefined;
+        environment?: string | undefined;
+        parentEntityType?: import("@mastra/core/storage").EntityType | undefined;
+        parentEntityName?: string | undefined;
+        rootEntityType?: import("@mastra/core/storage").EntityType | undefined;
+        rootEntityName?: string | undefined;
+        resourceId?: string | undefined;
+        runId?: string | undefined;
+        sessionId?: string | undefined;
+        threadId?: string | undefined;
+        requestId?: string | undefined;
+        executionSource?: string | undefined;
+        tags?: string[] | undefined;
+        traceIds?: string[] | undefined;
+        experimentIds?: string[] | undefined;
+        name?: string[] | undefined;
+        source?: string | undefined;
+        provider?: string | undefined;
+        model?: string | undefined;
+        costUnit?: string | undefined;
+        labels?: Record<string, string> | undefined;
+    } | undefined;
+} | {
+    name: string[];
+    groupBy: string[];
+    aggregation: "avg" | "count" | "count_distinct" | "last" | "max" | "min" | "sum";
+    distinctColumn?: "entityName" | "entityType" | "environment" | "executionSource" | "model" | "name" | "parentEntityName" | "parentEntityType" | "provider" | "resourceId" | "rootEntityName" | "rootEntityType" | "serviceName" | "threadId" | undefined;
+    limit?: number | undefined;
+    orderDirection?: "ASC" | "DESC" | undefined;
+    source: "metrics";
+    id?: string | undefined;
+    compare?: "previousWindow" | undefined;
+    request: "breakdown";
+    filters?: {
+        traceId?: string | undefined;
+        spanId?: string | undefined;
+        entityType?: import("@mastra/core/storage").EntityType | undefined;
+        entityName?: string | undefined;
+        entityVersionId?: string | undefined;
+        parentEntityVersionId?: string | undefined;
+        rootEntityVersionId?: string | undefined;
+        userId?: string | undefined;
+        organizationId?: string | undefined;
+        experimentId?: string | undefined;
+        serviceName?: string | undefined;
+        environment?: string | undefined;
+        parentEntityType?: import("@mastra/core/storage").EntityType | undefined;
+        parentEntityName?: string | undefined;
+        rootEntityType?: import("@mastra/core/storage").EntityType | undefined;
+        rootEntityName?: string | undefined;
+        resourceId?: string | undefined;
+        runId?: string | undefined;
+        sessionId?: string | undefined;
+        threadId?: string | undefined;
+        requestId?: string | undefined;
+        executionSource?: string | undefined;
+        tags?: string[] | undefined;
+        traceIds?: string[] | undefined;
+        experimentIds?: string[] | undefined;
+        name?: string[] | undefined;
+        source?: string | undefined;
+        provider?: string | undefined;
+        model?: string | undefined;
+        costUnit?: string | undefined;
+        labels?: Record<string, string> | undefined;
+    } | undefined;
+} | {
+    name: string[];
+    aggregation: "avg" | "count" | "count_distinct" | "last" | "max" | "min" | "sum";
+    distinctColumn?: "entityName" | "entityType" | "environment" | "executionSource" | "model" | "name" | "parentEntityName" | "parentEntityType" | "provider" | "resourceId" | "rootEntityName" | "rootEntityType" | "serviceName" | "threadId" | undefined;
+    groupBy?: string[] | undefined;
+    source: "metrics";
+    id?: string | undefined;
+    compare?: "previousWindow" | undefined;
+    request: "timeSeries";
+    interval?: "15m" | "1d" | "1h" | "1m" | "5m" | undefined;
+    filters?: {
+        traceId?: string | undefined;
+        spanId?: string | undefined;
+        entityType?: import("@mastra/core/storage").EntityType | undefined;
+        entityName?: string | undefined;
+        entityVersionId?: string | undefined;
+        parentEntityVersionId?: string | undefined;
+        rootEntityVersionId?: string | undefined;
+        userId?: string | undefined;
+        organizationId?: string | undefined;
+        experimentId?: string | undefined;
+        serviceName?: string | undefined;
+        environment?: string | undefined;
+        parentEntityType?: import("@mastra/core/storage").EntityType | undefined;
+        parentEntityName?: string | undefined;
+        rootEntityType?: import("@mastra/core/storage").EntityType | undefined;
+        rootEntityName?: string | undefined;
+        resourceId?: string | undefined;
+        runId?: string | undefined;
+        sessionId?: string | undefined;
+        threadId?: string | undefined;
+        requestId?: string | undefined;
+        executionSource?: string | undefined;
+        tags?: string[] | undefined;
+        traceIds?: string[] | undefined;
+        experimentIds?: string[] | undefined;
+        name?: string[] | undefined;
+        source?: string | undefined;
+        provider?: string | undefined;
+        model?: string | undefined;
+        costUnit?: string | undefined;
+        labels?: Record<string, string> | undefined;
+    } | undefined;
+} | {
+    name: string;
+    percentiles: number[];
+    source: "metrics";
+    id?: string | undefined;
+    compare?: "previousWindow" | undefined;
+    request: "percentiles";
+    interval?: "15m" | "1d" | "1h" | "1m" | "5m" | undefined;
+    filters?: {
+        traceId?: string | undefined;
+        spanId?: string | undefined;
+        entityType?: import("@mastra/core/storage").EntityType | undefined;
+        entityName?: string | undefined;
+        entityVersionId?: string | undefined;
+        parentEntityVersionId?: string | undefined;
+        rootEntityVersionId?: string | undefined;
+        userId?: string | undefined;
+        organizationId?: string | undefined;
+        experimentId?: string | undefined;
+        serviceName?: string | undefined;
+        environment?: string | undefined;
+        parentEntityType?: import("@mastra/core/storage").EntityType | undefined;
+        parentEntityName?: string | undefined;
+        rootEntityType?: import("@mastra/core/storage").EntityType | undefined;
+        rootEntityName?: string | undefined;
+        resourceId?: string | undefined;
+        runId?: string | undefined;
+        sessionId?: string | undefined;
+        threadId?: string | undefined;
+        requestId?: string | undefined;
+        executionSource?: string | undefined;
+        tags?: string[] | undefined;
+        traceIds?: string[] | undefined;
+        experimentIds?: string[] | undefined;
+        name?: string[] | undefined;
+        source?: string | undefined;
+        provider?: string | undefined;
+        model?: string | undefined;
+        costUnit?: string | undefined;
+        labels?: Record<string, string> | undefined;
+    } | undefined;
+} | {
+    scoreSource?: string | undefined;
+    aggregation: "avg" | "count" | "count_distinct" | "last" | "max" | "min" | "sum";
+    source: "scores";
+    id?: string | undefined;
+    compare?: "previousWindow" | undefined;
+    scorerId?: string | undefined;
+    request: "aggregate";
+    filters?: {
+        traceId?: string | undefined;
+        spanId?: string | undefined;
+        entityType?: import("@mastra/core/storage").EntityType | undefined;
+        entityName?: string | undefined;
+        entityVersionId?: string | undefined;
+        parentEntityVersionId?: string | undefined;
+        rootEntityVersionId?: string | undefined;
+        userId?: string | undefined;
+        organizationId?: string | undefined;
+        experimentId?: string | undefined;
+        serviceName?: string | undefined;
+        environment?: string | undefined;
+        parentEntityType?: import("@mastra/core/storage").EntityType | undefined;
+        parentEntityName?: string | undefined;
+        rootEntityType?: import("@mastra/core/storage").EntityType | undefined;
+        rootEntityName?: string | undefined;
+        resourceId?: string | undefined;
+        runId?: string | undefined;
+        sessionId?: string | undefined;
+        threadId?: string | undefined;
+        requestId?: string | undefined;
+        executionSource?: string | undefined;
+        tags?: string[] | undefined;
+        scorerId?: string | string[] | undefined;
+        scoreSource?: string | undefined;
+        metadata?: Record<string, unknown> | null | undefined;
+        source?: string | undefined;
+    } | undefined;
+} | {
+    scoreSource?: string | undefined;
+    groupBy: string[];
+    aggregation: "avg" | "count" | "count_distinct" | "last" | "max" | "min" | "sum";
+    source: "scores";
+    id?: string | undefined;
+    compare?: "previousWindow" | undefined;
+    scorerId?: string | undefined;
+    request: "breakdown";
+    filters?: {
+        traceId?: string | undefined;
+        spanId?: string | undefined;
+        entityType?: import("@mastra/core/storage").EntityType | undefined;
+        entityName?: string | undefined;
+        entityVersionId?: string | undefined;
+        parentEntityVersionId?: string | undefined;
+        rootEntityVersionId?: string | undefined;
+        userId?: string | undefined;
+        organizationId?: string | undefined;
+        experimentId?: string | undefined;
+        serviceName?: string | undefined;
+        environment?: string | undefined;
+        parentEntityType?: import("@mastra/core/storage").EntityType | undefined;
+        parentEntityName?: string | undefined;
+        rootEntityType?: import("@mastra/core/storage").EntityType | undefined;
+        rootEntityName?: string | undefined;
+        resourceId?: string | undefined;
+        runId?: string | undefined;
+        sessionId?: string | undefined;
+        threadId?: string | undefined;
+        requestId?: string | undefined;
+        executionSource?: string | undefined;
+        tags?: string[] | undefined;
+        scorerId?: string | string[] | undefined;
+        scoreSource?: string | undefined;
+        metadata?: Record<string, unknown> | null | undefined;
+        source?: string | undefined;
+    } | undefined;
+} | {
+    scoreSource?: string | undefined;
+    aggregation: "avg" | "count" | "count_distinct" | "last" | "max" | "min" | "sum";
+    groupBy?: string[] | undefined;
+    source: "scores";
+    id?: string | undefined;
+    compare?: "previousWindow" | undefined;
+    scorerId?: string | undefined;
+    request: "timeSeries";
+    interval?: "15m" | "1d" | "1h" | "1m" | "5m" | undefined;
+    filters?: {
+        traceId?: string | undefined;
+        spanId?: string | undefined;
+        entityType?: import("@mastra/core/storage").EntityType | undefined;
+        entityName?: string | undefined;
+        entityVersionId?: string | undefined;
+        parentEntityVersionId?: string | undefined;
+        rootEntityVersionId?: string | undefined;
+        userId?: string | undefined;
+        organizationId?: string | undefined;
+        experimentId?: string | undefined;
+        serviceName?: string | undefined;
+        environment?: string | undefined;
+        parentEntityType?: import("@mastra/core/storage").EntityType | undefined;
+        parentEntityName?: string | undefined;
+        rootEntityType?: import("@mastra/core/storage").EntityType | undefined;
+        rootEntityName?: string | undefined;
+        resourceId?: string | undefined;
+        runId?: string | undefined;
+        sessionId?: string | undefined;
+        threadId?: string | undefined;
+        requestId?: string | undefined;
+        executionSource?: string | undefined;
+        tags?: string[] | undefined;
+        scorerId?: string | string[] | undefined;
+        scoreSource?: string | undefined;
+        metadata?: Record<string, unknown> | null | undefined;
+        source?: string | undefined;
+    } | undefined;
+} | {
+    scoreSource?: string | undefined;
+    percentiles: number[];
+    source: "scores";
+    id?: string | undefined;
+    compare?: "previousWindow" | undefined;
+    scorerId?: string | undefined;
+    request: "percentiles";
+    interval?: "15m" | "1d" | "1h" | "1m" | "5m" | undefined;
+    filters?: {
+        traceId?: string | undefined;
+        spanId?: string | undefined;
+        entityType?: import("@mastra/core/storage").EntityType | undefined;
+        entityName?: string | undefined;
+        entityVersionId?: string | undefined;
+        parentEntityVersionId?: string | undefined;
+        rootEntityVersionId?: string | undefined;
+        userId?: string | undefined;
+        organizationId?: string | undefined;
+        experimentId?: string | undefined;
+        serviceName?: string | undefined;
+        environment?: string | undefined;
+        parentEntityType?: import("@mastra/core/storage").EntityType | undefined;
+        parentEntityName?: string | undefined;
+        rootEntityType?: import("@mastra/core/storage").EntityType | undefined;
+        rootEntityName?: string | undefined;
+        resourceId?: string | undefined;
+        runId?: string | undefined;
+        sessionId?: string | undefined;
+        threadId?: string | undefined;
+        requestId?: string | undefined;
+        executionSource?: string | undefined;
+        tags?: string[] | undefined;
+        scorerId?: string | string[] | undefined;
+        scoreSource?: string | undefined;
+        metadata?: Record<string, unknown> | null | undefined;
+        source?: string | undefined;
+    } | undefined;
+} | {
+    where?: import("@mastra/core/storage").TraceQueryPredicate | undefined;
+    groupBy?: string[] | undefined;
+    interval?: "15m" | "1d" | "1h" | "1m" | "5m" | undefined;
+    measures: ("cost.avg" | "cost.sum" | "count" | "duration.avg" | "duration.max" | "duration.min" | "duration.p50" | "duration.p90" | "duration.p95" | "duration.p99" | "errorCount" | "errorRate" | "timeToFirstChunk.avg" | "timeToFirstChunk.count" | "timeToFirstChunk.max" | "timeToFirstChunk.min" | "timeToFirstChunk.p50" | "timeToFirstChunk.p90" | "timeToFirstChunk.p95" | "timeToFirstChunk.p99" | "timeToFirstToken.avg" | "timeToFirstToken.count" | "timeToFirstToken.max" | "timeToFirstToken.min" | "timeToFirstToken.p50" | "timeToFirstToken.p90" | "timeToFirstToken.p95" | "timeToFirstToken.p99" | "tokens.cached.avg" | "tokens.cached.sum" | "tokens.input.avg" | "tokens.input.sum" | "tokens.output.avg" | "tokens.output.sum" | "tokens.reasoning.avg" | "tokens.reasoning.sum" | "tokens.total.avg" | "tokens.total.sum" | `countDistinct.${string}`)[];
+    having?: import("@mastra/core/storage").TraceQueryScalarPredicate | undefined;
+    orderBy?: {
+        field: string;
+        direction: "asc" | "desc";
+    } | undefined;
+    limit?: number | undefined;
+    source: "traceAggregate";
+    id?: string | undefined;
+    compare?: "previousWindow" | undefined;
+} | {
+    where?: import("@mastra/core/storage").TraceQueryScalarPredicate | undefined;
+    groupBy?: string[] | undefined;
+    interval?: "15m" | "1d" | "1h" | "1m" | "5m" | undefined;
+    measures: ("cost.avg" | "cost.sum" | "count" | "duration.avg" | "duration.max" | "duration.min" | "duration.p50" | "duration.p90" | "duration.p95" | "duration.p99" | "errorCount" | "errorRate" | "timeToFirstChunk.avg" | "timeToFirstChunk.count" | "timeToFirstChunk.max" | "timeToFirstChunk.min" | "timeToFirstChunk.p50" | "timeToFirstChunk.p90" | "timeToFirstChunk.p95" | "timeToFirstChunk.p99" | "timeToFirstToken.avg" | "timeToFirstToken.count" | "timeToFirstToken.max" | "timeToFirstToken.min" | "timeToFirstToken.p50" | "timeToFirstToken.p90" | "timeToFirstToken.p95" | "timeToFirstToken.p99" | "tokens.cached.avg" | "tokens.cached.sum" | "tokens.input.avg" | "tokens.input.sum" | "tokens.output.avg" | "tokens.output.sum" | "tokens.reasoning.avg" | "tokens.reasoning.sum" | "tokens.total.avg" | "tokens.total.sum" | `countDistinct.${string}`)[];
+    having?: import("@mastra/core/storage").TraceQueryScalarPredicate | undefined;
+    orderBy?: {
+        field: string;
+        direction: "asc" | "desc";
+    } | undefined;
+    limit?: number | undefined;
+    source: "spanAggregate";
+    id?: string | undefined;
+    compare?: "previousWindow" | undefined;
+})[];
+/** The open view's requests; totals span the whole window, so they ask for no buckets. */
+export declare function timeseriesRequests({ views, page, state }: WidgetPlanContext<TimeseriesOptions>): (import("../..").DashboardRequest | undefined)[];

package/dist/src/domains/dashboards/lib/alert-actions.d.ts

@@ -0,0 +1,36 @@
+import type { DashboardWidget, DashboardWidgetView } from '@mastra/client-js';
+import type { ReactNode } from 'react';
+import type { DashboardAlert } from '../widget-kind';
+import type { ViewHeading } from './chrome';
+import type { PendingGate } from './gate';
+import type { DashboardPageContext } from './requests';
+import type { LabelledValue, ValueRef } from './values';
+/** What the open view runs against: the page's filters, or the page filters its aggregates can't apply. */
+export type AlertSource = {
+    page: DashboardPageContext;
+    /** The view's series, columns or KPIs, each becoming the alert's sources. */
+    values: LabelledValue[];
+} | {
+    blocked: string[];
+    /** The filter bar's names for `blocked`, as the card names them. */ names?: Record<string, string>;
+};
+export declare const UNSATISFIABLE_ALERT = "The page's filters exclude everything this card shows.";
+/**
+ * Each distinct ref the view's values read, labelled: by the label of a value that is just that ref
+ * if there is one, else as a part of the first combined value reading it (the value's label, its
+ * query and what it picks). In the order the values first read them.
+ */
+export declare function alertRefs(values: LabelledValue[]): {
+    label: string;
+    ref: ValueRef;
+}[];
+/**
+ * The open view's Create alert button, or nothing without an `alert` host. A view the page's filters
+ * block, or contradict, gets a disabled button saying so; otherwise the host decides, for the whole
+ * card or per source. A source whose query the page's filters contradict is disabled on its own.
+ */
+export declare function alertAction(alert: DashboardAlert | undefined, widget: DashboardWidget, view: DashboardWidgetView, source: AlertSource): ReactNode;
+/** `heading` with `action` first among its hover actions, so it sits left of the pin. */
+export declare function withAction(heading: ViewHeading, action: ReactNode): ViewHeading;
+/** A pending card's heading: a view the page's filters block gets its disabled button, saying so. */
+export declare function pendingHeading(heading: ViewHeading, gate: PendingGate, alert: DashboardAlert | undefined, widget: DashboardWidget, view: DashboardWidgetView): ViewHeading;

package/dist/src/domains/dashboards/lib/chrome.d.ts

@@ -1,8 +1,11 @@
 import type { DashboardWidget, DashboardWidgetView } from '@mastra/client-js';
 import type { ChartCardProps } from '../../metrics/components/chart-card';
 import type { DashboardExpand } from '../widget-kind';
-/** What a widget's card shows as its title: `title`, and `titleMenu` with several views or an expand link. */
-export type ViewHeading = Pick<ChartCardProps, 'title' | 'titleMenu' | 'href' | 'LinkComponent'>;
+/**
+ * What a widget's card shows in its top bar: `title`, and `titleMenu` with several views or an
+ * expand link, plus the widget's own actions (its pin button; always shown once pinned).
+ */
+export type ViewHeading = Pick<ChartCardProps, 'title' | 'titleMenu' | 'href' | 'LinkComponent' | 'dragHandle' | 'actions' | 'persistentActions'>;
 export declare const unsupportedMessage: (fields: string[], names?: Record<string, string>) => string;
 /** A view's value in the card's menu: its label in kebab case (`Token usage` → `token-usage`), or its position when unlabelled or blank. */
 export declare const viewValue: (label: string | undefined, index: number) => string;

package/dist/src/domains/dashboards/lib/gate.d.ts

@@ -0,0 +1,65 @@
+import type { DashboardQuery } from '@mastra/client-js';
+import type { DashboardPageContext } from './requests';
+/** One aggregate backend's readiness, as plain data a host can provide. */
+export type AggregateGateInput<Where> = 
+/** Capabilities are still loading. */
+{
+    status: 'loading';
+}
+/** The server can't answer these aggregates: widgets that need them are hidden. */
+ | {
+    status: 'unavailable';
+}
+/** A page filter has no equivalent on this backend, so its numbers would ignore it. */
+ | {
+    status: 'unsupported-filter';
+    unsupportedFields: string[];
+} | {
+    status: 'ready';
+    where?: Where;
+};
+/** What a widget needs from its page: the frozen window, the filters, and the aggregate gates. */
+export type DashboardEnvironment = {
+    window: DashboardPageContext['window'];
+    filters: DashboardPageContext['filters'];
+    /** What figures are compared against, e.g. `vs previous 24h`. */
+    comparisonLabel: string;
+    /** Display name for a project id, when the page spans several projects; ids show as they are without it. */
+    projectLabel?: (projectId: string) => string;
+    gates: {
+        trace: AggregateGateInput<NonNullable<DashboardPageContext['traceWhere']>>;
+        span: AggregateGateInput<NonNullable<DashboardPageContext['spanWhere']>>;
+    };
+};
+/** A view that can't run yet: capabilities loading, or a page filter its aggregates can't apply. */
+export type PendingGate = {
+    status: 'loading';
+} | {
+    status: 'unsupported-filter';
+    unsupportedFields: string[];
+};
+/** The page filters `queries` can't apply; `undefined` when they apply them all. */
+export type BlockedFields = (queries: readonly DashboardQuery[]) => string[] | undefined;
+export type WidgetGate = 
+/** The server can't answer the widget: it renders nothing. */
+{
+    status: 'hidden';
+} | {
+    status: 'pending';
+    gate: PendingGate;
+} | {
+    status: 'ready';
+    page: DashboardPageContext;
+    blocked: BlockedFields;
+};
+/** Whether any of `queries` reads trace or span aggregates, so the page's gates apply to it. */
+export declare const needsAggregates: (queries: readonly DashboardQuery[]) => boolean;
+/**
+ * Whether `queries` can run on the page `env` describes, and their page context when they can.
+ * Metrics and scores answer every filter; trace and span aggregates wait on their gates. With
+ * `partial`, a page filter the aggregates can't apply doesn't hold the widget up: its views check
+ * `blocked` themselves (a table's tabs).
+ */
+export declare function widgetGate(queries: readonly DashboardQuery[], env: DashboardEnvironment, { partial }?: {
+    partial?: boolean;
+}): WidgetGate;

package/dist/src/domains/dashboards/lib/pin-actions.d.ts

@@ -0,0 +1,7 @@
+import type { WidgetPin } from '../widget-kind';
+import type { ViewHeading } from './chrome';
+/**
+ * Where a card's pin goes: with the actions shown on hover, or always once pinned, so a pinned card
+ * reads as pinned at rest and can be unpinned without hover (on touch).
+ */
+export declare function pinActions(pin: WidgetPin | undefined): Pick<ViewHeading, 'actions' | 'persistentActions'>;