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

package/dist/src/domains/knowledge/components/KnowledgePageExplorer.d.ts

@@ -1,3 +1,4 @@
+import type { ReactNode } from 'react';
 import type { KnowledgePageActivityPayload, KnowledgeNotePayload, KnowledgePageEdge, KnowledgePagePayload, KnowledgePinPayload, KnowledgeScopeGrantPayload } from '../pageTypes';
 /** `tree` is only a choice below `lg`; wider screens always show the tree beside the graph or the page. */
 export type KnowledgeExplorerView = 'tree' | 'graph' | 'page';
@@ -96,6 +97,8 @@ export interface KnowledgePageExplorerProps {
     onSelect: (pageId: string | null) => void;
     view: KnowledgeExplorerView;
     onViewChange: (view: KnowledgeExplorerView) => void;
+    toolbarEnd?: ReactNode;
+    flush?: boolean;
 }
 /** Links of the selected page drawn at most in each direction; the rest are counted. */
 export declare const FOCUS_LINK_CAP = 20;
@@ -106,4 +109,4 @@ export declare const FOCUS_LINK_CAP = 20;
  * opens it as a page straight away. Selecting in the tree keeps the current view, so the graph frames the
  * page instead.
  */
-export declare function KnowledgePageExplorer({ graph, source, selectedPageId, onSelect, view, onViewChange, }: KnowledgePageExplorerProps): import("react").JSX.Element;
+export declare function KnowledgePageExplorer({ graph, source, selectedPageId, onSelect, view: requestedView, onViewChange, toolbarEnd, flush, }: KnowledgePageExplorerProps): import("react").JSX.Element;

package/dist/src/domains/knowledge/components/KnowledgePageGraph.d.ts

@@ -1,3 +1,4 @@
+import type { PaneInsets } from '../lib/fitViewport';
 import type { KnowledgePageEdge, KnowledgePagePayload, KnowledgeScopeGrantPayload } from '../pageTypes';
 export interface KnowledgePageGraphProps {
     pages: KnowledgePagePayload[];
@@ -20,6 +21,8 @@ export interface KnowledgePageGraphProps {
     nearIds?: ReadonlySet<string>;
     /** False while the pages the selected page needs are loading: the graph keeps its last layout until they are in. */
     settled?: boolean;
+    insets?: PaneInsets;
+    collapsibleLegend?: boolean;
     /** Exact links into and out of pages, from the store; they replace the counts taken from `knownLinks`. */
     exactLinkCounts?: ReadonlyMap<string, {
         in: number;

package/dist/src/domains/knowledge/components/KnowledgeSourceIcon.d.ts

@@ -0,0 +1,5 @@
+import type { KnowledgePagePayload } from '../pageTypes';
+export declare function KnowledgeSourceIcon({ page, className }: {
+    page: KnowledgePagePayload;
+    className?: string;
+}): import("react").JSX.Element | null;

package/dist/src/domains/knowledge/components/KnowledgeTooltip.d.ts

@@ -0,0 +1,5 @@
+import type { ReactElement, ReactNode } from 'react';
+export declare function KnowledgeTooltip({ label, children }: {
+    label: ReactNode;
+    children: ReactElement;
+}): import("react").JSX.Element;

package/dist/src/domains/knowledge/lib/fitViewport.d.ts

@@ -21,12 +21,18 @@ interface FitInput {
         width?: number;
         height?: number;
     };
+    insets?: PaneInsets;
 }
+export interface PaneInsets {
+    left: number;
+    right: number;
+}
+export declare function uncoveredInsets(width: number, insets: PaneInsets): PaneInsets;
 /**
  * The viewport that frames `bounds`. Zoom stops at the readable floor, so what is cropped is the edge, not
  * the page being looked at; only Fit view, with an outer ring, goes lower so the whole ring shows.
  */
-export declare function fitViewport({ bounds, width, height, ring, anchor }: FitInput): Viewport;
+export declare function fitViewport({ bounds, width, height, ring, anchor, insets: drawers }: FitInput): Viewport;
 /** Margin around the drawn nodes on the first view, as a share of the pane. */
 export declare const INITIAL_FIT_PADDING = 0.05;
 /** The first view never zooms in past the pages' own size, however few there are. */
@@ -45,7 +51,7 @@ type Rect = {
  * fit would put a node under the legend, the pane is fitted again beside it or below it, whichever keeps
  * the pages larger.
  */
-export declare function fitAllViewport({ bounds, nodes, width, height, legend, }: {
+export declare function fitAllViewport({ bounds, nodes, width, height, legend, insets: drawers, }: {
     bounds: Rect;
     nodes: Rect[];
     width: number;
@@ -54,6 +60,7 @@ export declare function fitAllViewport({ bounds, nodes, width, height, legend, }
         right: number;
         bottom: number;
     };
+    insets?: PaneInsets;
 }): Viewport;
 /** How long a view change animates: the same as the layout's own transition, and none under reduced motion. */
 export declare const fitDuration: (motion: boolean) => 0 | 700;

package/dist/src/domains/knowledge/lib/pageAddress.d.ts

@@ -1,5 +1,15 @@
+import type { ComponentType, SVGProps } from 'react';
 import type { KnowledgePagePayload } from '../pageTypes';
+type KnowledgeSource = {
+    label: string;
+    icon?: ComponentType<SVGProps<SVGSVGElement>>;
+};
+/** The source an imported scope came from, read from its address prefix (`linear:…`). */
+export declare function scopeSource(page: KnowledgePagePayload): KnowledgeSource | undefined;
+/** A scope's readable name: an imported scope named only by its address reads as its source, e.g. "Linear". */
+export declare function scopeTitle(page: KnowledgePagePayload): string;
 /** The page's place from its root scope down, through the pages the graph holds. */
 export declare function pagePath(page: KnowledgePagePayload, byId: ReadonlyMap<string, KnowledgePagePayload>): string;
 /** How the page is addressed: its scope's address, then the keys down to it. Scopes are just their address. */
 export declare function pageRef(page: KnowledgePagePayload, byId: ReadonlyMap<string, KnowledgePagePayload>): string | undefined;
+export {};

package/dist/src/domains/knowledge/lib/pageRefs.d.ts

@@ -8,7 +8,18 @@ import type { KnowledgePageEdge, KnowledgePagePayload } from '../pageTypes';
 export interface KnowledgePageRefIndex {
     resolve: (ref: string) => KnowledgePagePayload | undefined;
 }
-export declare function knowledgePageRefIndex(pages: Iterable<KnowledgePagePayload>): KnowledgePageRefIndex;
+/**
+ * `byRef` holds pages fetched by the exact ref that names them, so a `scope#key/key` ref resolves even when
+ * the pages on its path aren't loaded.
+ */
+export declare function knowledgePageRefIndex(pages: Iterable<KnowledgePagePayload>, byRef?: ReadonlyMap<string, KnowledgePagePayload>): KnowledgePageRefIndex;
+/**
+ * The page a note's `[[ref]]` links to: only one the server resolved the note's mentions to. When the index
+ * can't walk the ref's path (pages on the way aren't loaded), a mentioned page stands for it if it is the only
+ * one in the ref's scope (which must be loaded) whose key ends the path and whose loaded parents match the
+ * keys before it.
+ */
+export declare function noteMentionTarget(index: KnowledgePageRefIndex, pagesById: ReadonlyMap<string, KnowledgePagePayload>, mentions: readonly string[], ref: string): KnowledgePagePayload | undefined;
 /** The `[[ref]]`s in a markdown body, outside code. */
 export declare function bodyLinkRefs(body: string): string[];
 /** One `link` edge per page whose body links another loaded page; `count` is how many times. */

package/dist/src/domains/knowledge/lib/pagesByRefContext.d.ts

@@ -0,0 +1,6 @@
+import type { KnowledgePagePayload } from '../pageTypes';
+/**
+ * Pages the host fetched by the exact `[[ref]]` that names them, so those refs link even when the pages on
+ * their path aren't loaded.
+ */
+export declare const KnowledgePagesByRef: import("react").Context<ReadonlyMap<string, KnowledgePagePayload>>;

package/dist/src/domains/llm/models-dev-logo-slugs.d.ts

@@ -0,0 +1 @@
+export declare const modelsDevLogoSlugs: Set<string>;

package/dist/src/domains/llm/provider-logo-monogram.d.ts

@@ -0,0 +1,8 @@
+import type { CSSProperties } from 'react';
+interface ProviderLogoMonogramProps {
+    providerId: string;
+    className?: string;
+    style?: CSSProperties;
+}
+export declare const ProviderLogoMonogram: ({ providerId, className, style }: ProviderLogoMonogramProps) => import("react").JSX.Element;
+export {};

package/dist/src/domains/llm/provider-logo.d.ts

@@ -6,9 +6,5 @@ interface ProviderLogoProps {
     size?: IconSize | number;
     style?: CSSProperties;
 }
-/**
- * Component to display provider logos from models.dev
- * Falls back to local icons if the logo fails to load
- */
 export declare const ProviderLogo: ({ providerId, className, size, style }: ProviderLogoProps) => import("react").JSX.Element;
 export {};

package/dist/src/domains/mcps/components/mcp-app-tool-result.d.ts

@@ -3,7 +3,10 @@ interface McpAppToolResultProps {
     appInfo: McpAppToolInfo;
     toolArgs?: Record<string, unknown>;
     toolResult?: unknown;
+    /** The chat tool call that rendered this app. Required for an `McpAppHostProvider` to reach the app. */
+    toolCallId?: string;
     onSendMessage?: (content: string) => void;
+    onUpdateModelContext?: (context: string | undefined) => void;
     readOnly?: boolean;
 }
 /**
@@ -14,5 +17,5 @@ interface McpAppToolResultProps {
  * (ui/notifications/tool-input and ui/notifications/tool-result), enabling
  * the app to hydrate with data from the tool call.
  */
-export declare function McpAppToolResult({ appInfo, toolArgs, toolResult, onSendMessage, readOnly }: McpAppToolResultProps): import("react").JSX.Element;
+export declare function McpAppToolResult({ appInfo, toolArgs, toolResult, toolCallId, onSendMessage, onUpdateModelContext, readOnly, }: McpAppToolResultProps): import("react").JSX.Element;
 export {};

package/dist/src/domains/mcps/components/mcp-app-viewer.d.ts

@@ -1,3 +1,4 @@
+import type { McpAppModelContextParams } from '../context/mcp-app-host-context-value';
 export interface McpAppViewerProps {
     /** The HTML content to render in the sandboxed iframe */
     html: string;
@@ -9,10 +10,19 @@ export interface McpAppViewerProps {
     toolInput?: Record<string, unknown>;
     /** Tool execution result (delivered via tool-result notification) */
     toolResult?: unknown;
-    /** Callback when the app sends a tool call request via callServerTool */
+    /** Callback when the app sends a tool call request via callServerTool. Resolves with the tool's output. */
     onToolCall?: (toolName: string, args: Record<string, unknown>) => Promise<unknown>;
     /** Callback when the app sends a message via sendMessage (drives new chat turns) */
     onSendMessage?: (content: string) => void;
+    /**
+     * Callback when the app updates its model context via updateModelContext. Receives the context as
+     * text for the agent's next turn, or `undefined` when the app clears it.
+     */
+    onUpdateModelContext?: (context: string | undefined) => void;
+    /** Callback with the raw params of each updateModelContext, alongside `onUpdateModelContext`. */
+    onModelContext?: (params: McpAppModelContextParams) => void;
+    /** Extra host-context keys sent to the app; `theme` stays the viewer's own. Changes reach the running app. */
+    hostContext?: Record<string, unknown>;
     /** Sandbox configuration — URL to the sandbox proxy HTML. If omitted, a blob URL is generated automatically. */
     sandboxUrl?: URL;
     /** Optional className for the container */
@@ -25,4 +35,4 @@ export interface McpAppViewerProps {
  * all MCP Apps protocol handling (bridge injection, handshake, tool input/result
  * delivery, JSON-RPC communication) to the standard implementation.
  */
-export declare function McpAppViewer({ html, title: _title, toolName, toolInput, toolResult, onToolCall, onSendMessage, sandboxUrl, className, }: McpAppViewerProps): import("react").JSX.Element;
+export declare function McpAppViewer({ html, title: _title, toolName, toolInput, toolResult, onToolCall, onSendMessage, onUpdateModelContext, onModelContext, hostContext: extraHostContext, sandboxUrl, className, }: McpAppViewerProps): import("react").JSX.Element;

package/dist/src/domains/mcps/context/mcp-app-host-context-value.d.ts

@@ -0,0 +1,23 @@
+/** The MCP App instance a host callback is about: one tool call's app. */
+export interface McpAppRef {
+    /** Name of the MCP tool whose app this is */
+    toolName: string;
+    /** The chat tool call that rendered the app */
+    toolCallId: string;
+    /** The app's `ui://` resource URI */
+    resourceUri: string;
+}
+/** `ui/update-model-context` params as the app sent them. Untrusted: parse before use. */
+export interface McpAppModelContextParams {
+    content?: unknown[];
+    structuredContent?: Record<string, unknown>;
+}
+/** Lets a chat host extend the MCP Apps rendered in its tool cards. */
+export interface McpAppHostValue {
+    /** Extra host-context keys for this app instance; `theme` stays the viewer's own. */
+    hostContext?: (app: McpAppRef) => Record<string, unknown> | undefined;
+    /** Called with the raw params of every `ui/update-model-context` from this app instance. */
+    onModelContext?: (app: McpAppRef, params: McpAppModelContextParams) => void;
+}
+export declare const McpAppHostContext: import("react").Context<McpAppHostValue | null>;
+export declare function useMcpAppHostContext(): McpAppHostValue | null;

package/dist/src/domains/mcps/context/mcp-app-host-context.d.ts

@@ -0,0 +1,7 @@
+import type { ReactNode } from 'react';
+import type { McpAppHostValue } from './mcp-app-host-context-value';
+/** Extends the MCP Apps rendered in the chat's tool cards; see `McpAppHostValue`. */
+export declare function McpAppHostProvider({ value, children }: {
+    value: McpAppHostValue;
+    children: ReactNode;
+}): import("react").JSX.Element;

package/dist/src/domains/mcps/hooks/use-mcp-app-tool-call.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Runs the tools an MCP App calls on its own server. Tools the server keeps for the model
+ * (`_meta.ui.visibility` without `"app"`) are refused, as the MCP Apps spec requires of hosts.
+ */
+export declare function useMcpAppToolCall(serverId: string): (toolName: string, args: Record<string, unknown>) => Promise<unknown>;

package/dist/src/domains/mcps/index.d.ts

@@ -0,0 +1,3 @@
+export { McpAppHostProvider } from './context/mcp-app-host-context';
+export { useMcpAppHostContext } from './context/mcp-app-host-context-value';
+export type { McpAppHostValue, McpAppModelContextParams, McpAppRef } from './context/mcp-app-host-context-value';

package/dist/src/domains/metrics/components/chart-card.d.ts

@@ -1,5 +1,5 @@
 import type { ElementType, ReactNode } from 'react';
-import type { MetricsCardTitleMenuProps, MetricsCardTotalPart } from '../../../ds/components/MetricsCard';
+import type { MetricsCardDragHandleProps, MetricsCardTitleMenuProps, MetricsCardTotalPart } from '../../../ds/components/MetricsCard';
 import type { LinkComponentProps } from '../../../lib/framework';
 /** What `LinkComponent` gets: anchor props, with `href` always set. */
 type ChartCardLinkProps = LinkComponentProps & {
@@ -29,6 +29,8 @@ export type ChartCardProps<V extends string = string> = {
      * place of tabs. `title` is the picked view's label. Ignored on `hero` cards.
      */
     titleMenu?: Omit<MetricsCardTitleMenuProps<V>, 'title' | 'className'>;
+    /** A grip left of the title that drags the card, e.g. while a dashboard is being arranged. Ignored on `hero` cards. */
+    dragHandle?: MetricsCardDragHandleProps;
     /**
      * The card's headline number: right of the title, or the large value on `hero` cards. A card
      * charting a few different things can pass one total each, marked with its series' color.
@@ -40,6 +42,8 @@ export type ChartCardProps<V extends string = string> = {
     isLoading?: boolean;
     /** Top-bar buttons, e.g. "View in traces": revealed on hover, except on `hero` cards. */
     actions?: ReactNode;
+    /** Top-bar buttons always shown, after `actions`: ones that show a state, e.g. a pinned widget's unpin button. */
+    persistentActions?: ReactNode;
     /**
      * Legend and controls above the body; they stay in every state. Pass `false` or `null` while
      * there's nothing to show yet, and the row keeps its height.
@@ -60,5 +64,5 @@ export type ChartCardProps<V extends string = string> = {
  * Pure layout for a metrics chart card. The body has a fixed height, so the loading,
  * error, empty and loaded states take the same room and nothing shifts around the card.
  */
-export declare function ChartCard<V extends string = string>({ variant, title, href, LinkComponent, titleMenu, total, change, isLoading, actions, toolbar, isUpdating, bodyHeight, className, children, }: ChartCardProps<V>): import("react").JSX.Element;
+export declare function ChartCard<V extends string = string>({ variant, title, href, LinkComponent, titleMenu, dragHandle, total, change, isLoading, actions, persistentActions, toolbar, isUpdating, bodyHeight, className, children, }: ChartCardProps<V>): import("react").JSX.Element;
 export {};

package/dist/src/domains/metrics/components/kpi-card.d.ts

@@ -1,4 +1,5 @@
 import type { LucideIcon } from 'lucide-react';
+import type { ReactNode } from 'react';
 export type KpiCardProps = {
     label: string;
     icon: LucideIcon;
@@ -6,7 +7,7 @@ export type KpiCardProps = {
     /** Change from the previous period, in percent. Omitted when there is nothing to compare. */
     change?: number;
     lowerIsBetter?: boolean;
-    detail: string;
+    detail: ReactNode;
     /** The previous period's value, formatted. Shown only beside a `change`. */
     previous?: string;
     /** Names the window the change compares against, e.g. "vs previous 7d". */

package/dist/src/domains/metrics/lib/index.d.ts

@@ -4,3 +4,4 @@ export { formatAxisCount, formatAxisDuration, formatAxisUsd, formatCount, format
 export { bucketLabels, isMultiDay, type BucketLabels } from './bucket-labels';
 export { BREAKDOWN_GROUP_LIMIT, BREAKDOWN_SPAN_TYPES, breakdownGroupBy, buildBreakdownRows, changeTrend, entitiesAggregateRequest, environmentsAggregateRequest, previousFigures, projectsAggregateRequest, rowChange, threadsAggregateRequest, type BreakdownEntityTab, type BreakdownRow, type BreakdownTab, type Change, type ChangeMetric, type PreviousFigures, } from './breakdown';
 export { previousWindow, windowLength } from './time-window';
+export { LAB_HUES, SERIES_HUES, seriesColor, seriesColors, seriesLab, type SeriesColorItem, type SeriesHue, } from './series-colors';

package/dist/src/domains/metrics/lib/series-colors.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Series colors for breakdowns by model, provider or any other key, from one palette of eleven hues
+ * (`--chart-series-*`). Each lab reserves its hue, so a lab reads the same on every chart; its other
+ * next two models take shifted shades of it, and the rest stand apart in hues of their own. Series with
+ * no lab take the hues left over.
+ */
+export declare const SERIES_HUES: readonly ['pink', 'orange', 'amber', 'lime', 'green', 'teal', 'cyan', 'blue', 'indigo', 'violet', 'magenta'];
+export type SeriesHue = (typeof SERIES_HUES)[number] | 'neutral';
+/** Each lab's hue, by the provider ids `ProviderLogo` knows. Labs not listed take a free hue. */
+export declare const LAB_HUES: Record<string, SeriesHue>;
+/**
+ * The lab behind a series: its provider, or for rows a host served the lab its model names.
+ *
+ * @example
+ * seriesLab('anthropic.messages', 'claude-opus-5-5') // 'anthropic'
+ * seriesLab('openrouter', 'meta-llama/llama-4-scout') // 'meta'
+ * seriesLab('groq', 'llama-4-maverick') // 'meta'
+ * seriesLab(undefined, 'gpt-5-mini') // 'openai'
+ */
+export declare function seriesLab(provider?: string, model?: string): string | undefined;
+/**
+ * Shades of a hue handed out more than once: a little lighter, then darker, then further, each
+ * nudged warmer or cooler. Lightness moves a share of the room left (toward white when positive,
+ * toward black when negative), so a light base like xAI's white never clips. The hue nudge stays
+ * under half the gap between hues, so a shade never reads as the next lab's color. Ten in all, as
+ * many as a chart names; past that they repeat. `[lightness share, hue in degrees, chroma factor]`.
+ */
+export declare const SHADES: [number, number, number][];
+/** A shade's lightness from its base's: a share of the way to white, or to black. */
+export declare const shadeLightness: (l: number, share: number) => number;
+/** A hue's color, or its nth shade. */
+export declare function seriesColor(hue: SeriesHue, shade?: number): string;
+export type SeriesColorItem = {
+    /** What the lookup is keyed by: a model name, a provider id, an API key id. */
+    key: string;
+    provider?: string;
+    model?: string;
+};
+export declare function seriesColors(items: SeriesColorItem[]): Map<string, string>;

package/dist/src/domains/traces/components/feedback-options.d.ts

@@ -0,0 +1,8 @@
+import type { FeedbackWriteOptions } from '@mastra/react/hooks/traces';
+/** Host-specific write context and supported actions for the existing feedback composer. */
+export type FeedbackOptions = FeedbackWriteOptions & {
+    /** Defaults to true. Hide deletion when the host does not support the client DELETE contract. */
+    allowDelete?: boolean;
+    /** Defaults to true. Hide review updates when the host does not support review-status PATCH. */
+    allowReview?: boolean;
+};

package/dist/src/domains/traces/components/feedback-thread.d.ts

@@ -7,6 +7,7 @@ type FeedbackThreadProps = {
     /** Rejecting (or throwing) keeps the draft in the composer so it can be retried. */
     onSubmit: (text: string) => void | Promise<unknown>;
     isSubmitting?: boolean;
+    submitError?: string;
     /** When provided, records with a feedbackId get a delete action. */
     onDelete?: (feedbackId: string) => void | Promise<unknown>;
     isDeleting?: boolean;
@@ -24,5 +25,5 @@ type FeedbackThreadProps = {
  * Feedback rendered as a comment thread: a composer above, existing records below.
  * Pagination, submission, deletion, and review status are driven by the caller.
  */
-export declare function FeedbackThread({ feedbackData, isLoadingFeedbackData, onPageChange, onSubmit, isSubmitting, onDelete, isDeleting, variant, onMarkReviewed, pendingFeedbackId, }: FeedbackThreadProps): import("react").JSX.Element;
+export declare function FeedbackThread({ feedbackData, isLoadingFeedbackData, onPageChange, onSubmit, isSubmitting, submitError, onDelete, isDeleting, variant, onMarkReviewed, pendingFeedbackId, }: FeedbackThreadProps): import("react").JSX.Element;
 export {};

package/dist/src/domains/traces/components/span-feedback-tab.d.ts

@@ -1,10 +1,12 @@
+import type { FeedbackOptions } from './feedback-options';
 type SpanFeedbackTabProps = {
     traceId: string;
+    feedbackOptions?: FeedbackOptions;
     spanId: string;
 };
 /**
  * Feedback for a single span. Owns its own pagination: mount it with a `key`
  * on the trace/span pair so a page index never leaks across spans.
  */
-export declare function SpanFeedbackTab({ traceId, spanId }: SpanFeedbackTabProps): import("react").JSX.Element;
-export {};
+export declare function SpanFeedbackTab({ traceId, spanId, feedbackOptions }: SpanFeedbackTabProps): import("react").JSX.Element;
+export type { FeedbackOptions } from './feedback-options';

package/dist/src/domains/traces/components/span-token-usage.utils.d.ts

@@ -2,7 +2,7 @@ import type { UsageStats } from '@mastra/core/observability';
 export type TokenUsageRow = {
     label: 'Input' | 'Output';
     total: number;
-    /** Non-zero breakdown, e.g. `5,632 cached · 974 text`. */
+    /** Non-zero breakdown, e.g. `5,632 cached, 974 text`. */
     breakdown: string | undefined;
 };
 /** One row per direction that reports a token count; null when neither does. */

package/dist/src/domains/traces/components/thread-view-by-trace.d.ts

@@ -1,3 +1,4 @@
+import type { FeedbackOptions } from './feedback-options';
 import type { ThreadTraceSelectedSpan } from './thread-trace';
 export interface ThreadViewByTraceProps {
     threadId: string;
@@ -5,6 +6,7 @@ export interface ThreadViewByTraceProps {
     withQueryTrace: boolean;
     /** Shows the per-trace Feedback tab and fetches its feedback. */
     withFeedback: boolean;
+    feedbackOptions?: FeedbackOptions;
     /** Fires when a span detail opens or closes (`null`). */
     onSelectedSpanChange?: (selected: ThreadTraceSelectedSpan | null) => void;
     /** Opens a score from a trace's Scores tab; the app owns routing. */
@@ -18,4 +20,5 @@ export interface ThreadViewByTraceProps {
  * reconstructed messages on the left and the span tree on the right. Clicking a span opens its
  * detail panel on the side so the conversation stays readable.
  */
-export declare function ThreadViewByTrace({ threadId, withQueryTrace, withFeedback, onSelectedSpanChange, onOpenScore, pageSize, }: ThreadViewByTraceProps): import("react").JSX.Element;
+export declare function ThreadViewByTrace({ threadId, withQueryTrace, withFeedback, feedbackOptions, onSelectedSpanChange, onOpenScore, pageSize, }: ThreadViewByTraceProps): import("react").JSX.Element;
+export type { FeedbackOptions } from './feedback-options';

package/dist/src/domains/traces/components/trace-feedback-tab.d.ts

@@ -1,6 +1,8 @@
+import type { FeedbackOptions } from './feedback-options';
 import type { CommentVariant } from '../../../ds/components/Comment';
 type TraceFeedbackTabProps = {
     traceId: string;
+    feedbackOptions?: FeedbackOptions;
     /** Comment layout variant — forwarded to `FeedbackThread`. */
     variant?: CommentVariant;
 };
@@ -8,5 +10,5 @@ type TraceFeedbackTabProps = {
  * Trace-level feedback (no span). Owns its own pagination: mount it with a `key`
  * on the trace id so a page index never leaks across traces.
  */
-export declare function TraceFeedbackTab({ traceId, variant }: TraceFeedbackTabProps): import("react").JSX.Element;
-export {};
+export declare function TraceFeedbackTab({ traceId, variant, feedbackOptions }: TraceFeedbackTabProps): import("react").JSX.Element;
+export type { FeedbackOptions } from './feedback-options';

package/dist/src/domains/traces/components/trace-span-panel.d.ts

@@ -1,4 +1,5 @@
 import type { ComponentProps, ReactNode } from 'react';
+import type { FeedbackOptions } from './feedback-options';
 import { SpanDataPanelView } from './span-data-panel-view';
 import type { TraceDataPanelView } from './trace-data-panel-view';
 type TraceDataPanelViewProps = ComponentProps<typeof TraceDataPanelView>;
@@ -35,6 +36,7 @@ export interface TraceSpanPanelProps {
     withQueryTrace: boolean;
     /** Full-thread view: shows the per-trace Feedback tab. */
     withFeedback: boolean;
+    feedbackOptions?: FeedbackOptions;
     /** Full-thread view: opens a score of one of the thread's traces (the app owns routing). */
     onOpenScore: (traceId: string, scoreId: string) => void;
     scoresTabBadge?: ReactNode;
@@ -65,5 +67,5 @@ export interface TraceSpanPanelProps {
  * Encapsulates the span-detail fetch and prev/next span navigation that the traces page
  * and the agent chat traces aside used to duplicate.
  */
-export declare function TraceSpanPanel({ traceId, spans, isLoadingSpans, selectedSpanId, onSpanSelect, onClose, anchorSpanId, entityType, initialSpanId, onPrevious, onNext, onSaveAsDatasetItem, feedbackTabBadge, feedbackTabSlot, showPartialThread, featuredSpanIds, onHighlightSpans, isFullThreadOpen, onFullThreadOpenChange, withQueryTrace, withFeedback, onOpenScore, scoresTabBadge, scoresTabSlot, usage, rootStreamingTimings, traceHref, size, depth, headerSlot, headerActionsSlot, title, showUnavailableFeaturesMsg, spanView, onSpanViewChange, spanActiveTab, onSpanTabChange, spanFeedbackTabBadge, spanFeedbackTabSlot, }: TraceSpanPanelProps): import("react").JSX.Element;
+export declare function TraceSpanPanel({ traceId, spans, isLoadingSpans, selectedSpanId, onSpanSelect, onClose, anchorSpanId, entityType, initialSpanId, onPrevious, onNext, onSaveAsDatasetItem, feedbackTabBadge, feedbackTabSlot, showPartialThread, featuredSpanIds, onHighlightSpans, isFullThreadOpen, onFullThreadOpenChange, withQueryTrace, withFeedback, feedbackOptions, onOpenScore, scoresTabBadge, scoresTabSlot, usage, rootStreamingTimings, traceHref, size, depth, headerSlot, headerActionsSlot, title, showUnavailableFeaturesMsg, spanView, onSpanViewChange, spanActiveTab, onSpanTabChange, spanFeedbackTabBadge, spanFeedbackTabSlot, }: TraceSpanPanelProps): import("react").JSX.Element;
 export {};

package/dist/src/domains/traces/components/trace-thread-panel.d.ts

@@ -1,9 +1,11 @@
+import type { FeedbackOptions } from './feedback-options';
 export interface TraceThreadPanelProps {
     /** Keep the panel mounted and toggle `open` so the drawer animates in and out. */
     open: boolean;
     threadId: string;
     withQueryTrace: boolean;
     withFeedback: boolean;
+    feedbackOptions?: FeedbackOptions;
     onOpenScore: (traceId: string, scoreId: string) => void;
     /** Close the thread drawer, revealing the trace panel underneath. */
     onClose: () => void;
@@ -15,4 +17,4 @@ export interface TraceThreadPanelProps {
     closeLabel?: string;
 }
 /** The full thread in its own drawer, stacked above the trace panel: every turn as traces, opened on the latest one. */
-export declare function TraceThreadPanel({ open, threadId, withQueryTrace, withFeedback, onOpenScore, onClose, depth, title, closeLabel, }: TraceThreadPanelProps): import("react").JSX.Element;
+export declare function TraceThreadPanel({ open, threadId, withQueryTrace, withFeedback, feedbackOptions, onOpenScore, onClose, depth, title, closeLabel, }: TraceThreadPanelProps): import("react").JSX.Element;

package/dist/src/domains/traces/components/traces-explorer/index.d.ts

@@ -31,3 +31,4 @@ export { useTraceUsageColumns, useTracesColumns, useTracesConfig, useTracesFilte
 export type { TracesExplorerFeatures, TracesExplorerScope, TracesMetricsSupport } from './traces-explorer-context';
 export { useTracesFilterBar, useTracesFilterBarFields } from './use-traces-filter-bar';
 export { useTracesDiscovery } from './use-traces-discovery';
+export type { FeedbackOptions } from '../feedback-options';

package/dist/src/domains/traces/components/traces-explorer/traces-explorer-context.d.ts

@@ -4,6 +4,7 @@ import type { useTraceColumnPreferences } from '../../hooks/use-trace-column-pre
 import type { useTracesListSource } from '../../hooks/use-traces-list-source';
 import type { TraceColumnPreferences } from '../../trace-list-columns';
 import type { SpanTab, TraceDatePreset } from '../../types';
+import type { FeedbackOptions } from '../feedback-options';
 import type { TraceSpanView } from '../trace-data-panel-view';
 import type { TracesFilters, TracesSelection, TracesSort } from './traces-explorer-actions';
 export type TracesExplorerScope = {
@@ -32,6 +33,7 @@ export type TracesConfigContextValue = {
     hiddenFieldIds: readonly string[];
     withQueryTrace: boolean;
     withFeedback: boolean;
+    feedbackOptions?: FeedbackOptions;
     /** The span query API is on, so the host can offer a spans view next to the traces list. */
     withSpanQuery: boolean;
     /** The thread rows API is on, so the host can offer a threads view next to the traces list. */

package/dist/src/domains/traces/components/traces-explorer/traces-explorer-root.d.ts

@@ -1,4 +1,5 @@
 import type { ReactNode } from 'react';
+import type { FeedbackOptions } from '../feedback-options';
 import type { TracesExplorerState, TracesFilters, TracesSelection, TracesSort } from './traces-explorer-actions';
 import type { TracesExplorerFeatures, TracesExplorerScope, TracesMetricsSupport } from './traces-explorer-context';
 export type TracesExplorerRootProps = {
@@ -14,8 +15,10 @@ export type TracesExplorerRootProps = {
     metricsSupport: TracesMetricsSupport;
     /** Host switches combined with the server capabilities; a feature runs only when both allow it. */
     features?: TracesExplorerFeatures;
+    /** Write context and action support for feedback in trace, span and thread panels. */
+    feedbackOptions?: FeedbackOptions;
     /** The host's default filters. Filters matching them don't count as applied (e.g. in empty states). */
     initialFilters?: TracesFilters;
     children: ReactNode;
 };
-export declare function TracesExplorerRoot({ selection, filters: rawFilters, onChange, sort, onSortChange: onHostSortChange, scope, metricsSupport, features, initialFilters, children, }: TracesExplorerRootProps): import("react").JSX.Element;
+export declare function TracesExplorerRoot({ selection, filters: rawFilters, onChange, sort, onSortChange: onHostSortChange, scope, metricsSupport, features, feedbackOptions, initialFilters, children, }: TracesExplorerRootProps): import("react").JSX.Element;

package/dist/src/domains/workflows/components/workflow-combobox.d.ts

@@ -10,7 +10,8 @@ export interface WorkflowComboboxProps {
     disabled?: boolean;
     variant?: ComboboxProps['variant'];
     size?: ComboboxProps['size'];
+    popupWidth?: ComboboxProps['popupWidth'];
     'aria-label'?: string;
     align?: ComboboxProps['align'];
 }
-export declare function WorkflowCombobox({ value, onValueChange, placeholder, searchPlaceholder, emptyText, className, disabled, variant, size, 'aria-label': ariaLabel, align, requestContext, }: WorkflowComboboxProps): import("react").JSX.Element;
+export declare function WorkflowCombobox({ value, onValueChange, placeholder, searchPlaceholder, emptyText, className, disabled, variant, size, popupWidth, 'aria-label': ariaLabel, align, requestContext, }: WorkflowComboboxProps): import("react").JSX.Element;

package/dist/src/ds/components/AgentIndicator/paint.d.ts

@@ -4,6 +4,9 @@ export interface Ball {
     cy: string;
     r: string;
 }
+export interface Ring extends Ball {
+    width: string;
+}
 /** A segment with no width keeps its last `d`, so the live painter skips rewriting it. */
 export interface Stroke {
     width: string;
@@ -12,10 +15,11 @@ export interface Stroke {
 export interface FrameParts {
     body: string;
     balls: Ball[];
+    rings: Ring[];
     cuts: Stroke[];
     inks: Stroke[];
     trailCuts: Stroke[];
     trailInks: Stroke[];
 }
-export declare function frameParts(f: Frame): FrameParts;
-export declare function painter(svg: SVGSVGElement): (f: Frame) => void;
+export declare function frameParts(frame: Frame): FrameParts;
+export declare function painter(svg: SVGSVGElement): (frame: Frame) => void;

package/dist/src/ds/components/AgentIndicator/poses/coordination.d.ts

@@ -0,0 +1,7 @@
+import type { Pose } from '../poses';
+export declare const delegating: Pose;
+export declare const workflow: Pose;
+export declare const connecting: Pose;
+export declare const planning: Pose;
+export declare const messaging: Pose;
+export declare const branching: Pose;

package/dist/src/ds/components/AgentIndicator/poses/documents.d.ts

@@ -0,0 +1,2 @@
+import type { Pose } from '../poses';
+export declare const writing: Pose;

package/dist/src/ds/components/AgentIndicator/poses/files.d.ts

@@ -0,0 +1,5 @@
+import type { Pose } from '../poses';
+export declare const finding: Pose;
+export declare const creating: Pose;
+export declare const listing: Pose;
+export declare const inspecting: Pose;

package/dist/src/ds/components/AgentIndicator/poses/interface.d.ts

@@ -0,0 +1,8 @@
+import type { Pose } from '../poses';
+export declare const fetching: Pose;
+export declare const clicking: Pose;
+export declare const typing: Pose;
+export declare const screenshot: Pose;
+export declare const asking: Pose;
+export declare const inbox: Pose;
+export declare const scheduling: Pose;

package/dist/src/ds/components/AgentIndicator/poses/knowledge-actions.d.ts

@@ -0,0 +1,6 @@
+import type { Pose } from '../poses';
+export declare const noting: Pose;
+export declare const pinning: Pose;
+export declare const unpinning: Pose;
+export declare const moving: Pose;
+export declare const merging: Pose;

package/dist/src/ds/components/AgentIndicator/poses/knowledge.d.ts

@@ -0,0 +1,2 @@
+import type { Pose } from '../poses';
+export declare const knowledge: Pose;

package/dist/src/ds/components/AgentIndicator/poses/skills.d.ts

@@ -0,0 +1,4 @@
+import type { Pose } from '../poses';
+export declare const skill: Pose;
+export declare const skillSearching: Pose;
+export declare const skillReading: Pose;

package/dist/src/ds/components/AgentIndicator/poses/terminal.d.ts

@@ -0,0 +1,4 @@
+import type { Pose } from '../poses';
+export declare const running: Pose;
+export declare const stopping: Pose;
+export declare const output: Pose;

package/dist/src/ds/components/AgentIndicator/poses/thinking.d.ts

@@ -0,0 +1,2 @@
+import type { Pose } from '../poses';
+export declare const thinking: Pose;