@runtypelabs/persona 4.14.0 → 4.16.0

package/dist/index.d.ts

@@ -2,6 +2,92 @@ import { IconNode } from 'lucide';
 import { Marked } from 'marked';
 import DOMPurify from 'dompurify';
 
+interface ResolvedWelcomeConfig {
+    title: string;
+    subtitle: string;
+    icon?: AgentWidgetWelcomeIcon;
+    variant: AgentWidgetWelcomeVariant;
+    dismiss: AgentWidgetWelcomeDismiss;
+    /** Undefined under `variant: "hero"`, which suppresses the greeting. */
+    message?: string;
+}
+/**
+ * Per-field, presence-based precedence: `welcome.*` wins, else the legacy
+ * `copy` alias, else the default above.
+ */
+declare const resolveWelcomeConfig: (config?: AgentWidgetConfig) => ResolvedWelcomeConfig;
+/**
+ * Derived visibility, never stored. "User activity" is the same predicate the
+ * starters use: the session contains at least one `role: "user"` message.
+ */
+declare const isWelcomeVisible: (resolved: ResolvedWelcomeConfig, messages: readonly AgentWidgetMessage[] | undefined) => boolean;
+
+/**
+ * Synchronous key-value store handed to plugin render hooks. Backed by
+ * `localStorage`, namespaced per plugin id. The async `storageAdapter` cannot
+ * back a synchronous API and `persistState` is not a general key-value surface.
+ */
+interface AgentWidgetPluginStorage {
+    get: (key: string) => string | null;
+    set: (key: string, value: string) => void;
+    remove: (key: string) => void;
+}
+
+type AgentWidgetTransformSuggestionsContext = {
+    /**
+     * Fresh copy of the suggestions entering this plugin, already normalized:
+     * shorthand strings expanded and the effective send/fill behavior resolved.
+     */
+    suggestions: AgentWidgetResolvedSuggestion[];
+    surface: AgentWidgetSuggestionSurface;
+    source: AgentWidgetSuggestionSource;
+    config: AgentWidgetConfig;
+};
+type AgentWidgetRenderSuggestionContext = {
+    /** Fully normalized suggestion, including the effective send/fill behavior. */
+    suggestion: AgentWidgetResolvedSuggestion;
+    index: number;
+    surface: AgentWidgetSuggestionSurface;
+    source: AgentWidgetSuggestionSource;
+    variant: AgentWidgetSuggestionVariant;
+    streaming: boolean;
+    config: AgentWidgetConfig;
+    /** Build Persona's standard chip, card, or list item. */
+    defaultRenderer: () => HTMLElement;
+    /**
+     * Run the normal selection pipeline: DOM event, plugin selection hooks, then
+     * send or fill. Custom renderers should call this instead of sending directly.
+     */
+    select: () => void;
+};
+type AgentWidgetRenderWelcomeContext = {
+    /** Alias-resolved welcome config; never the raw `copy.welcome*` shape. */
+    config: ResolvedWelcomeConfig;
+    variant: AgentWidgetWelcomeVariant;
+    /** Derived visibility for this render; governs the default renderer only. */
+    visible: boolean;
+    /** The core-owned welcome card, live-updated by `controller.update()`. */
+    defaultRenderer: () => HTMLElement;
+    sendMessage: (text: string) => void;
+    /** Re-run welcome arbitration: cleanups run, previous content is removed. */
+    requestRender: () => void;
+    /**
+     * Persona's starter renderer, wired through the full select pipeline:
+     * `onSuggestionSelect`, cancelable `persona:suggestion:*` events, send/fill.
+     */
+    renderStarter: (suggestion: AgentWidgetSuggestion) => HTMLElement;
+    /** Sync store namespaced by `persistState.keyPrefix` plus the plugin id. */
+    storage: AgentWidgetPluginStorage;
+    /** Teardown for this render; runs before the next one and on destroy. */
+    onCleanup: (fn: () => void) => void;
+};
+type AgentWidgetSuggestionSelectContext = {
+    suggestion: AgentWidgetResolvedSuggestion;
+    surface: AgentWidgetSuggestionSurface;
+    source: AgentWidgetSuggestionSource;
+    variant: AgentWidgetSuggestionVariant;
+    config: AgentWidgetConfig;
+};
 /**
  * Plugin interface for customizing widget components
  */
@@ -14,6 +100,25 @@ interface AgentWidgetPlugin {
      * Optional priority (higher = runs first). Default: 0
      */
     priority?: number;
+    /**
+     * Transform, filter, enrich, or reorder suggestions. Hooks receive normalized
+     * items and compose in plugin priority order; the return value may use the
+     * loose shape (string shorthand included) and is re-normalized before the next
+     * hook. A per-item `behavior` set here survives. `maxItems` caps the list
+     * after the full chain. Return an empty array to hide the surface.
+     */
+    transformSuggestions?: (context: AgentWidgetTransformSuggestionsContext) => AgentWidgetSuggestion[];
+    /**
+     * Render one starter or follow-up suggestion. Return null to use Persona's
+     * default chip/card/list renderer. Call `select()` from custom interaction
+     * controls to preserve events, selection hooks, and send/fill behavior.
+     */
+    renderSuggestion?: (context: AgentWidgetRenderSuggestionContext) => HTMLElement | null;
+    /**
+     * Observe or intercept a suggestion selection. Return false to cancel the
+     * built-in send/fill action. Hooks run in plugin priority order.
+     */
+    onSuggestionSelect?: (context: AgentWidgetSuggestionSelectContext) => void | boolean;
     /**
      * Custom renderer for message bubbles
      * Return null to use default renderer
@@ -32,6 +137,34 @@ interface AgentWidgetPlugin {
         defaultRenderer: () => HTMLElement;
         onToggle: () => void;
     }) => HTMLElement | null;
+    /**
+     * Custom renderer for the welcome surface (card, hero, greeting stack).
+     * First plugin returning an element wins; null falls through to the default,
+     * same contract as `renderSuggestion`.
+     *
+     * The core owns the welcome host: it stays mounted for the panel's lifetime
+     * and content is swapped inside it. A plugin element renders regardless of
+     * `ctx.visible` (derived visibility governs the default renderer only) and
+     * the host overlays the transcript while that element is active, so a home
+     * screen can return over an existing conversation. Return null again to
+     * clear the overlay.
+     *
+     * The ctx carries no controller: plugins are host-instantiated, so close a
+     * factory over the init handle (`plugin.attach(controller)`).
+     *
+     * @example
+     * ```typescript
+     * renderWelcome: ({ config, renderStarter, requestRender, onCleanup }) => {
+     *   const root = document.createElement("div");
+     *   root.textContent = config.title;
+     *   root.appendChild(renderStarter({ label: "Track my order" }));
+     *   const timer = setInterval(requestRender, 60_000);
+     *   onCleanup(() => clearInterval(timer));
+     *   return root;
+     * }
+     * ```
+     */
+    renderWelcome?: (context: AgentWidgetRenderWelcomeContext) => HTMLElement | null;
     /**
      * Custom renderer for panel header
      * Return null to use default renderer
@@ -76,6 +209,15 @@ interface AgentWidgetPlugin {
          * Omitted when `config.voiceRecognition.enabled` is not true.
          */
         onVoiceToggle?: () => void;
+        /**
+         * Re-run composer arbitration and swap the footer in place. The hook runs
+         * once at panel construction, so this is how a composer plugin unlocks
+         * (returns null) or re-renders later. Pending attachments, the mention
+         * affordances, and the composer listener registry are re-wired by the core.
+         */
+        requestRender: () => void;
+        /** Same sync store as the `renderWelcome` ctx, namespaced per plugin id. */
+        storage: AgentWidgetPluginStorage;
     }) => HTMLElement | null;
     /**
      * Custom renderer for reasoning bubbles
@@ -456,6 +598,15 @@ interface PanelTokens extends ComponentTokenSet {
     /** Background of the region revealed behind a detached panel. */
     canvasBackground?: string;
 }
+/** Per-element text styling shared by themable text surfaces. */
+interface TextStyleTokens {
+    fontFamily?: string;
+    fontSize?: string;
+    fontWeight?: string;
+    lineHeight?: string;
+    letterSpacing?: string;
+    color?: TokenReference<'color'>;
+}
 interface HeaderTokens extends ComponentTokenSet {
     background: TokenReference<'color'>;
     border: TokenReference<'color'>;
@@ -464,10 +615,14 @@ interface HeaderTokens extends ComponentTokenSet {
     iconBackground: TokenReference<'color'>;
     /** Foreground (glyph stroke or emoji text) on the header avatar tile. */
     iconForeground: TokenReference<'color'>;
-    /** Header title line (next to the icon, or minimal layout title). */
+    /** Legacy alias of `title.color`; `title.color` wins when both are set. */
     titleForeground: TokenReference<'color'>;
-    /** Header subtitle line under the title. */
+    /** Legacy alias of `subtitle.color`; `subtitle.color` wins when both are set. */
     subtitleForeground: TokenReference<'color'>;
+    /** Header title typography (next to the icon, or minimal layout title). */
+    title?: TextStyleTokens;
+    /** Header subtitle typography, for the line under the title. */
+    subtitle?: TextStyleTokens;
     /** Default color for clear / close icon buttons when launcher overrides are unset. */
     actionIconForeground: TokenReference<'color'>;
     /** Box-shadow on the header (e.g., a fade shadow to replace the default border). */
@@ -497,7 +652,7 @@ interface MessageTokens {
 }
 /**
  * Welcome / intro card rendered above the message list when no messages exist.
- * Set `copy.showWelcomeCard: false` to hide it; use `layout.slots["body-top"]`
+ * Set `welcome.variant: "none"` to hide it; use `layout.slots["body-top"]`
  * to replace it wholesale.
  */
 interface IntroCardTokens extends ComponentTokenSet {
@@ -506,6 +661,12 @@ interface IntroCardTokens extends ComponentTokenSet {
     padding?: TokenReference<'spacing'>;
     /** Box-shadow on the intro card (token ref or raw CSS, e.g. `none`). */
     shadow?: string;
+    /** Full border shorthand on the intro card (raw CSS, e.g. `"1px solid rgba(0,0,0,0.1)"`). @default "none" */
+    border?: string;
+    /** Welcome title typography. */
+    title?: TextStyleTokens;
+    /** Welcome subtitle typography. */
+    subtitle?: TextStyleTokens;
 }
 /** Collapsible widget chrome (tool bubbles, reasoning bubbles, approval bubbles). */
 interface CollapsibleWidgetTokens {
@@ -548,6 +709,8 @@ interface MarkdownTokens {
         background?: TokenReference<'color'>;
         borderColor?: TokenReference<'color'>;
         textColor?: TokenReference<'color'>;
+        /** Corner radius; follows `palette.radius.md` by default so square-corner themes get square code blocks. */
+        borderRadius?: TokenReference<'radius'>;
     };
     /** Table styling. */
     table?: {
@@ -605,10 +768,27 @@ interface ToolBubbleTokens {
 interface ReasoningBubbleTokens {
     shadow: string;
 }
+/** Scrollbar appearance shared by every scroller in the widget. */
+interface ScrollbarTokens {
+    /** Thumb color. @default semantic.colors.border */
+    thumb?: TokenReference<'color'>;
+    /** Track color. @default "transparent" */
+    track?: TokenReference<'color'>;
+}
 /** Composer (message input) chrome. */
 interface ComposerChromeTokens {
     /** Box-shadow on the composer form (raw CSS, e.g. `none`). */
     shadow: string;
+    /** Border color of the composer form. @default semantic.colors.border */
+    borderColor?: TokenReference<'color'>;
+    /** Inner padding of the composer form (raw CSS shorthand). @default "0.75rem 1rem" */
+    padding?: string;
+    /** Gap between the textarea row and the actions row. @default "0.5rem" */
+    gap?: string;
+    /** Composer textarea font-size. @default "0.875rem" */
+    fontSize?: string;
+    /** Composer textarea line-height. @default "1.25rem" */
+    lineHeight?: string;
 }
 /** Artifact toolbar chrome. */
 interface ArtifactToolbarTokens {
@@ -758,6 +938,29 @@ interface ScrollToBottomTokens extends ComponentTokenSet {
     fontSize?: string;
     iconSize?: string;
 }
+/** Visual tokens shared by one suggestion presentation variant. */
+interface SuggestionVariantTokens extends ComponentTokenSet {
+    /** Space inside one item, between its icon and its copy. */
+    gap?: string;
+    /** Space between suggestion items in the container. */
+    itemGap?: string;
+    minHeight?: string;
+    fontSize?: string;
+    lineHeight?: string;
+    iconSize?: string;
+    hoverBackground?: TokenReference<'color'>;
+    hoverForeground?: TokenReference<'color'>;
+    hoverBorder?: TokenReference<'color'>;
+    pressedBackground?: TokenReference<'color'>;
+    focusRing?: TokenReference<'color'>;
+    disabledOpacity?: string;
+}
+/** Starter and follow-up suggestion chrome. */
+interface SuggestionTokens {
+    chip: SuggestionVariantTokens;
+    card: SuggestionVariantTokens;
+    list: SuggestionVariantTokens;
+}
 /** Toggle group chrome (used by createToggleGroup). */
 interface ToggleGroupTokens {
     /** Gap between toggle buttons. Default: 0 (connected). */
@@ -782,12 +985,16 @@ interface ComponentTokens {
     toolBubble: ToolBubbleTokens;
     reasoningBubble: ReasoningBubbleTokens;
     composer: ComposerChromeTokens;
+    /** Scrollbar appearance for every scroller in the widget. */
+    scrollbar?: ScrollbarTokens;
     /** Icon button styling tokens. */
     iconButton?: IconButtonTokens;
     /** Label button styling tokens. */
     labelButton?: LabelButtonTokens;
     /** Scroll-to-bottom indicator styling tokens. */
     scrollToBottom?: ScrollToBottomTokens;
+    /** Starter prompt and follow-up suggestion styling tokens. */
+    suggestion?: SuggestionTokens;
     /** Toggle group styling tokens. */
     toggleGroup?: ToggleGroupTokens;
     /** Artifact toolbar, tab strip, and pane chrome. */
@@ -1109,7 +1316,24 @@ type RuntypeExecutionStreamEvent = ({
     type: "source";
     url?: string;
     [key: string]: unknown;
+} | {
+    executionId: string;
+    iteration?: number;
+    seq: number;
+    state: Record<string, unknown>;
+    type: "state_snapshot";
 } | ({
+    executionId: string;
+    iteration?: number;
+    patch: Array<{
+        from?: string;
+        op: "add" | "remove" | "replace" | "move" | "copy" | "test";
+        path: string;
+        value?: unknown;
+    }>;
+    seq: number;
+    type: "state_delta";
+}) | ({
     executionId: string;
     hiddenParameterNames?: Array<string>;
     iteration?: number;
@@ -1481,6 +1705,7 @@ declare const LUCIDE_ICONS: {
     readonly plus: IconNode;
     readonly minus: IconNode;
     readonly pencil: IconNode;
+    readonly "pen-line": IconNode;
     readonly trash: IconNode;
     readonly "trash-2": IconNode;
     readonly save: IconNode;
@@ -1523,11 +1748,13 @@ declare const LUCIDE_ICONS: {
     readonly folder: IconNode;
     readonly "folder-open": IconNode;
     readonly files: IconNode;
+    readonly "chart-column": IconNode;
     readonly sparkles: IconNode;
     readonly zap: IconNode;
     readonly sun: IconNode;
     readonly moon: IconNode;
     readonly flag: IconNode;
+    readonly lightbulb: IconNode;
     readonly monitor: IconNode;
     readonly smartphone: IconNode;
 };
@@ -2680,6 +2907,13 @@ type AgentWidgetArtifactsLayoutConfig = {
      * @default 520
      */
     narrowHostMaxWidth?: number;
+    /**
+     * Width of the slide-over artifact drawer (the narrow-host and mobile
+     * presentations; `paneWidth`/`paneMaxWidth` only size the desktop split).
+     * CSS length; `"100%"` makes the drawer cover the whole panel.
+     * @default min(calc(100% - 1rem), 22rem)
+     */
+    drawerWidth?: string;
     /**
      * When true (default), widen the launcher panel while artifacts are visible and not user-dismissed.
      * No-op for inline embed (`launcher.enabled === false`).
@@ -3308,6 +3542,18 @@ type AgentWidgetScrollMode = "follow" | "anchor-top" | "none";
  *   restored thread opens at a readable place rather than at the very bottom.
  */
 type AgentWidgetScrollRestorePosition = "bottom" | "last-user-turn";
+/**
+ * Scrollbar visibility policy for every scroll surface in the widget.
+ *
+ * - `"on-scroll"` hides bars at rest and reveals them on genuine reader
+ *   input, keeping them visible while the reader is away from the resting
+ *   position: overlay-scrollbar semantics on every platform.
+ * - `"auto"` keeps the themed bar under native visibility semantics: overlay
+ *   platforms still auto-hide, classic-scrollbar platforms (Windows,
+ *   always-show macOS) show it persistently.
+ * - `"hidden"` never shows an indicator. Scrolling itself is unaffected.
+ */
+type AgentWidgetScrollbarPolicy = "on-scroll" | "auto" | "hidden";
 type AgentWidgetScrollBehaviorFeature = {
     /** Scroll behavior during streamed responses. @default "anchor-top" */
     mode?: AgentWidgetScrollMode;
@@ -3352,6 +3598,13 @@ type AgentWidgetScrollBehaviorFeature = {
      * @default false
      */
     announce?: boolean;
+    /**
+     * Scrollbar visibility policy, applied to the transcript and every inner
+     * scroller through one root attribute. Themable via
+     * `--persona-scrollbar-thumb` and `--persona-scrollbar-track`.
+     * @default "on-scroll"
+     */
+    scrollbar?: AgentWidgetScrollbarPolicy;
 };
 type AgentWidgetScrollToBottomFeature = {
     /**
@@ -3641,10 +3894,13 @@ type AgentWidgetFeatureFlags = {
      */
     askUserQuestion?: AgentWidgetAskUserQuestionFeature;
     /**
-     * Built-in `suggest_replies` quick-reply chips. When the assistant invokes
-     * the tool, the widget shows the suggestions as tappable chips above the
-     * composer (reusing the suggestion-chips surface) and immediately resumes
-     * the execution: fire-and-forget, no user input awaited.
+     * Built-in `suggest_replies` follow-ups. When the assistant invokes the
+     * tool, the widget shows the suggestions using `suggestions.followUps` and
+     * immediately resumes the execution: fire-and-forget, no user input awaited.
+     *
+     * @deprecated Both keys moved to `suggestions.followUps`: use
+     * `suggestions.followUps.enabled` and `suggestions.followUps.expose`. This
+     * alias keeps working per key, with `suggestions.followUps` winning.
      */
     suggestReplies?: AgentWidgetSuggestRepliesFeature;
 };
@@ -3689,11 +3945,12 @@ type WidgetPreferenceSlice = {
     };
 };
 /**
- * Feature config for the built-in `suggest_replies` quick-reply chips.
- * Chips render in the existing suggestions slot above the composer and are
- * styled by the widget-level `suggestionChipsConfig`. A tapped chip is sent
- * verbatim as the user's next message; chips clear once any user message
- * follows them.
+ * Feature config for the built-in `suggest_replies` follow-ups.
+ *
+ * @deprecated Both keys moved to `suggestions.followUps`
+ * (`suggestions.followUps.enabled` / `suggestions.followUps.expose`), which
+ * also owns presentation, placement, and send/fill behavior. Resolution is
+ * per key with `suggestions.followUps` winning; removal waits for 5.0.
  */
 type AgentWidgetSuggestRepliesFeature = {
     /**
@@ -3701,14 +3958,18 @@ type AgentWidgetSuggestRepliesFeature = {
      * renders as a regular tool bubble and is NOT auto-resumed: only set this
      * with no server-side `suggest_replies` declaration, or the execution
      * parks awaiting a resume that never comes.
+     * @deprecated Use `suggestions.followUps.enabled`.
      */
     enabled?: boolean;
     /**
      * Advertise the built-in `suggest_replies` tool to the agent on every
      * dispatch via `clientTools[]`: no server-side `runtimeTools` declaration
-     * needed. Defaults to `false`: flows that already declare the tool via
-     * `runtimeTools` would otherwise present it to the model twice. Ignored
-     * when `enabled` is `false`.
+     * needed. Defaults to `false`. Declare the tool in one place: the API
+     * dedupes a double declaration by name with `clientTools[]` winning, so the
+     * model still sees exactly one tool, but the widget's description and schema
+     * win and the effective tool type becomes `local` (the execution pauses and
+     * the widget auto-resumes it). Ignored when `enabled` is `false`.
+     * @deprecated Use `suggestions.followUps.expose`.
      */
     expose?: boolean;
 };
@@ -3778,10 +4039,13 @@ type AgentWidgetAskUserQuestionFeature = {
      * matching {@link AskUserQuestionPayload}; when the model calls it, the
      * existing answer-pill sheet renders and the answer resumes the execution.
      *
-     * Defaults to `false`: flows that already declare `ask_user_question` via
-     * `runtimeTools` would otherwise present the tool to the model twice.
-     * Ignored when `enabled` is `false`: never offer the agent a question
-     * tool the widget can't render an answer UI for.
+     * Defaults to `false`. Declare the tool in one place: the API dedupes a
+     * double declaration by name with `clientTools[]` winning, so the model
+     * still sees exactly one tool, but the widget's description and schema win
+     * and the effective tool type becomes `local` (the execution pauses and the
+     * widget resumes it with the user's answer). Ignored when `enabled` is
+     * `false`: never offer the agent a question tool the widget can't render an
+     * answer UI for.
      */
     expose?: boolean;
     /** Slide-in animation duration in ms. Defaults to 180. */
@@ -4246,6 +4510,57 @@ type AgentWidgetLauncherConfig = {
      * @example "min(380px, calc(100vw - 48px))"
      */
     collapsedMaxWidth?: string;
+    /**
+     * Proactive nudge bubble anchored above the collapsed floating launcher.
+     * Omit it (the default) and no teaser renders.
+     */
+    teaser?: AgentWidgetLauncherTeaserConfig;
+};
+/**
+ * Launcher teaser: a small bubble above the collapsed launcher. Clicking it
+ * opens the panel and consumes the teaser exactly like an explicit dismissal.
+ * Within a single page load the teaser appears at most once under either
+ * frequency.
+ *
+ * @example
+ * ```typescript
+ * launcher: {
+ *   teaser: { text: "Need a hand picking a plan?", delayMs: 3000 }
+ * }
+ * ```
+ */
+type AgentWidgetLauncherTeaserConfig = {
+    /** Bubble copy. An empty string renders no teaser. */
+    text: string;
+    /**
+     * Delay before the bubble appears, in milliseconds.
+     * @default 0
+     */
+    delayMs?: number;
+    /**
+     * How often the teaser may return.
+     *
+     * `"once"`: a dismissal or a click-through is remembered in `localStorage`
+     * under `` `${persistState.keyPrefix ?? "persona-"}teaser-dismissed` `` and
+     * the teaser never returns on that browser. `"always"`: shows on every page
+     * load, tracked in memory only. `persistState: false` downgrades `"once"` to
+     * in-memory too, so the teaser reappears each load.
+     *
+     * Custom `storageAdapter` implementations do not participate in teaser state.
+     *
+     * @default "once"
+     */
+    frequency?: "once" | "always";
+    /**
+     * Render an x affordance that dismisses the teaser without opening the panel.
+     * @default true
+     */
+    dismissible?: boolean;
+    /**
+     * Accessible label for the dismiss affordance.
+     * @default "Dismiss message"
+     */
+    dismissLabel?: string;
 };
 type AgentWidgetSendButtonConfig = {
     borderWidth?: string;
@@ -4254,6 +4569,10 @@ type AgentWidgetSendButtonConfig = {
     paddingY?: string;
     iconText?: string;
     iconName?: string;
+    /** Icon glyph box in icon mode, e.g. "20px". Defaults to half of `size`. */
+    iconSize?: string;
+    /** Stroke width for the icon glyph, in viewBox units. Default 2. */
+    iconStrokeWidth?: number;
     useIcon?: boolean;
     tooltipText?: string;
     showTooltip?: boolean;
@@ -5022,6 +5341,177 @@ type AgentWidgetSuggestionChipsConfig = {
     paddingX?: string;
     paddingY?: string;
 };
+/** A suggested next action shown to the user. Strings remain supported as shorthand. */
+type AgentWidgetSuggestion = string | {
+    /** Stable analytics / DOM identity. Falls back to the prompt or label. */
+    id?: string;
+    /** Concise visible action label. */
+    label: string;
+    /** Text placed in the composer or sent. Defaults to `label`. */
+    prompt?: string;
+    /**
+     * Optional supporting copy, most useful with the `card` variant. The
+     * `chip` variant ignores it and renders the label alone.
+     */
+    description?: string;
+    /** Optional icon from Persona's bundled Lucide registry. */
+    icon?: IconName;
+    /**
+     * CSS color for this item's glyph. Tints the icon only: label, border,
+     * and background stay neutral. Ignored without an `icon`.
+     */
+    iconColor?: string;
+    /** Override the surface's click behavior for this item. */
+    behavior?: AgentWidgetSuggestionBehavior;
+    /** Visually promote one high-confidence action. */
+    emphasis?: "default" | "primary";
+};
+type AgentWidgetSuggestionBehavior = "send" | "fill";
+type AgentWidgetSuggestionVariant = "chip" | "card" | "list";
+type AgentWidgetSuggestionSurface = "starter" | "followUp";
+/**
+ * Who produced the rendered suggestions: static config, the agent's
+ * `suggest_replies` tool, or `controller.setFollowUpSuggestions`.
+ */
+type AgentWidgetSuggestionSource = "config" | "agent" | "host";
+/**
+ * A suggestion after Persona has normalized shorthand strings and resolved the
+ * effective click behavior. Plugin hooks receive this stable shape.
+ */
+type AgentWidgetResolvedSuggestion = {
+    id: string;
+    label: string;
+    prompt: string;
+    description?: string;
+    icon?: IconName;
+    /** CSS color for the glyph only; never the label, border, or background. */
+    iconColor?: string;
+    behavior: AgentWidgetSuggestionBehavior;
+    emphasis: "default" | "primary";
+};
+/** Presentation keys shared by every suggestion surface. */
+type AgentWidgetSuggestionSurfaceConfig = {
+    /** Item density. Defaults to `card` for starters and `chip` for follow-ups. */
+    variant?: AgentWidgetSuggestionVariant;
+    /** Default click behavior, overridable per item. Defaults to `send`. */
+    behavior?: AgentWidgetSuggestionBehavior;
+    /**
+     * Layout for items past the surface width. Defaults to `wrap` on every
+     * surface; `scroll` opts into a horizontal strip for large sets. Applies
+     * to the `chip` variant only; the `card` and `list` layouts manage their
+     * own stacking.
+     */
+    overflow?: "scroll" | "wrap";
+    /** Maximum visible items. Defaults to 4. */
+    maxItems?: number;
+};
+type AgentWidgetStarterSuggestionsConfig = AgentWidgetSuggestionSurfaceConfig & {
+    /** Suggestions shown before the first user message. */
+    items?: AgentWidgetSuggestion[];
+    /**
+     * `auto` uses the welcome surface when the welcome card renders and the
+     * composer otherwise. Explicit values are literal: `welcome` renders
+     * nothing when the welcome card is hidden. Defaults to `auto`.
+     */
+    placement?: "auto" | "welcome" | "composer";
+};
+type AgentWidgetFollowUpSuggestionsConfig = AgentWidgetSuggestionSurfaceConfig & {
+    /**
+     * Enable the built-in `suggest_replies` follow-ups. Defaults to true. When
+     * false, `suggest_replies` renders as a regular tool bubble and is NOT
+     * auto-resumed: only set this with no server-side `suggest_replies`
+     * declaration, or the execution parks awaiting a resume that never comes.
+     */
+    enabled?: boolean;
+    /**
+     * Advertise the built-in `suggest_replies` tool to the agent on every
+     * dispatch via `clientTools[]`: no server-side `runtimeTools` declaration
+     * needed. Defaults to `false`. Declare the tool in one place: the API
+     * dedupes a double declaration by name with `clientTools[]` winning, so
+     * the model still sees exactly one tool, but the widget's description and
+     * schema win and the effective tool type becomes `local` (the execution
+     * pauses and the widget auto-resumes it). Ignored when `enabled` is
+     * `false`.
+     */
+    expose?: boolean;
+    /**
+     * `auto` places follow-ups after the transcript in regular panels and above
+     * the composer in composer-bar mode. Defaults to `auto`.
+     */
+    placement?: "auto" | "after-message" | "composer";
+};
+/**
+ * Structured suggestions configuration. The legacy `suggestionChips` and
+ * `suggestionChipsConfig` fields remain supported for backwards compatibility.
+ */
+type AgentWidgetSuggestionsConfig = {
+    starters?: AgentWidgetStarterSuggestionsConfig;
+    followUps?: AgentWidgetFollowUpSuggestionsConfig;
+};
+/**
+ * Which welcome surface renders.
+ * `"card"` is the top-of-scroll intro card (default, back-compatible),
+ * `"hero"` centers it in the empty conversation, `"none"` renders no surface.
+ */
+type AgentWidgetWelcomeVariant = "card" | "hero" | "none";
+/**
+ * When the welcome surface goes away. `"never"` is the default for `"card"`;
+ * `"on-first-message"` is the default for `"hero"` and cannot be overridden
+ * there.
+ */
+type AgentWidgetWelcomeDismiss = "never" | "on-first-message";
+/**
+ * Avatar or logo shown above the welcome title. Discriminated union; the
+ * function form is the escape hatch for custom markup. There is deliberately
+ * no raw HTML string variant (sanitization surface plus accessibility hole).
+ */
+type AgentWidgetWelcomeIcon = {
+    type: "lucide";
+    name: IconName;
+}
+/** `alt` is required, and may be `""` for a decorative logo. */
+ | {
+    type: "image";
+    url: string;
+    alt: string;
+}
+/** Emoji or short text glyph. */
+ | {
+    type: "text";
+    text: string;
+} | (() => HTMLElement | SVGElement);
+/**
+ * First-open welcome surface. Consolidates the deprecated
+ * `copy.welcomeTitle` / `copy.welcomeSubtitle` / `copy.showWelcomeCard`
+ * options; a field present here wins over its legacy alias.
+ *
+ * All defaults live in the resolver (`resolveWelcomeConfig`), never in
+ * `DEFAULT_WIDGET_CONFIG`: presence on this object is what distinguishes a
+ * host-set value from a filled-in default.
+ */
+interface AgentWidgetWelcomeConfig {
+    /** Card or hero title. Defaults to "Hello 👋". */
+    title?: string;
+    /** Scope statement in the assistant's voice. Empty string omits it. */
+    subtitle?: string;
+    /** Avatar or logo shown above the title. */
+    icon?: AgentWidgetWelcomeIcon;
+    /** @default "card" */
+    variant?: AgentWidgetWelcomeVariant;
+    /** @default "never" for `card`, always `"on-first-message"` for `hero`. */
+    dismiss?: AgentWidgetWelcomeDismiss;
+    /**
+     * Display-only greeting bubble pinned at transcript position zero. It is UI
+     * chrome derived from config, never a session message: it does not appear in
+     * `getMessages()`, is never persisted or sent to the model, `onMessage` does
+     * not fire for it, and it survives `clearChat()`. Use an assistant
+     * `initialMessages` entry instead when the model should see the greeting.
+     *
+     * Ignored (with a debug-mode warning) when `variant` is `"hero"`: the hero
+     * is the greeting.
+     */
+    message?: string;
+}
 /**
  * Interface for pluggable stream parsers that extract text from streaming responses.
  * Parsers handle incremental parsing to extract text values from structured formats (JSON, XML, etc.).
@@ -5268,7 +5758,9 @@ type AgentWidgetHeaderLayoutConfig = {
      */
     render?: (context: HeaderRenderContext) => HTMLElement;
     /**
-     * Shown after the title in `minimal` header layout (e.g. chevron menu affordance).
+     * Icon action buttons at the trailing edge of the `minimal` header layout,
+     * clustered with the close button and sharing its chrome. For a menu
+     * affordance next to the title, use `titleMenu` instead.
      */
     trailingActions?: AgentWidgetHeaderTrailingAction[];
     /** Called when a `trailingActions` button is clicked. */
@@ -5448,7 +5940,11 @@ type AgentWidgetLayoutConfig = {
     /**
      * Max width for the content area (messages + composer).
      * Applied with `margin: 0 auto` for centering.
-     * Accepts any CSS width value (e.g. "90ch", "720px", "80%").
+     * Accepts any CSS width value (e.g. "90ch", "720px", "80%"), or "none"
+     * for a full-width column. Only engages on panels wider than the cap,
+     * so launcher-width panels are unaffected.
+     * @default "768px" ("720px" in composer-bar mode via
+     * `launcher.composerBar.contentMaxWidth`)
      */
     contentMaxWidth?: string;
 };
@@ -6196,7 +6692,9 @@ type AgentWidgetConfig = {
      */
     getHeaders?: AgentWidgetHeadersFunction;
     copy?: {
+        /** @deprecated Use `welcome.title`. */
         welcomeTitle?: string;
+        /** @deprecated Use `welcome.subtitle`. */
         welcomeSubtitle?: string;
         inputPlaceholder?: string;
         sendButtonLabel?: string;
@@ -6204,6 +6702,7 @@ type AgentWidgetConfig = {
         stopButtonLabel?: string;
         /**
          * When false, the welcome / intro card is not shown above the message list.
+         * @deprecated Use `welcome.variant: "none"`.
          * @default true
          */
         showWelcomeCard?: boolean;
@@ -6268,7 +6767,17 @@ type AgentWidgetConfig = {
      * with `initialArtifacts`.
      */
     initialSelectedArtifactId?: string | null;
+    /** Rich starter and follow-up suggestion surfaces. */
+    suggestions?: AgentWidgetSuggestionsConfig;
+    /**
+     * First-open welcome surface (card, hero, or none) plus the optional
+     * display-only greeting bubble. Supersedes `copy.welcomeTitle`,
+     * `copy.welcomeSubtitle`, and `copy.showWelcomeCard`.
+     */
+    welcome?: AgentWidgetWelcomeConfig;
+    /** @deprecated Prefer `suggestions.starters.items`. */
     suggestionChips?: string[];
+    /** @deprecated Prefer semantic tokens under `theme.components.suggestion`. */
     suggestionChipsConfig?: AgentWidgetSuggestionChipsConfig;
     debug?: boolean;
     formEndpoint?: string;
@@ -8473,6 +8982,19 @@ type Controller = {
      * @deprecated Use injectMessage() instead.
      */
     injectTestMessage: (event: AgentWidgetEvent) => void;
+    /**
+     * Show follow-up suggestions from host code. An ephemeral UI overlay: the
+     * items never enter the transcript, the wire payload, or persisted state, so
+     * they do not survive a refresh. Cleared automatically when the next user
+     * message appends. Latest writer wins against the agent's `suggest_replies`
+     * payloads: this call overrides chips shown now, and a payload arriving
+     * afterwards overrides these. Renders through the `suggestions.followUps`
+     * presentation config and the full plugin and `persona:suggestReplies:*`
+     * event pipeline, with source `"host"`. An empty array clears.
+     */
+    setFollowUpSuggestions: (items: AgentWidgetSuggestion[]) => void;
+    /** Remove host-set follow-up suggestions. Agent-set chips are untouched. */
+    clearFollowUpSuggestions: () => void;
     getMessages: () => AgentWidgetMessage[];
     getStatus: () => AgentWidgetSessionStatus;
     getPersistentMetadata: () => Record<string, unknown>;
@@ -8655,15 +9177,18 @@ declare const removeAskUserQuestionSheet: (overlay: HTMLElement | null | undefin
  * `clientTools[]` (set `features.askUserQuestion.expose: true`): the same
  * wire surface WebMCP page tools ride. The server registers it as a LOCAL
  * tool under its bare name (`origin: 'sdk'` tools are not `webmcp:`-prefixed),
- * so when the model calls it the execution pauses with a `step_await`
- * (`awaitReason: "local_tool_required"`), the widget's answer-pill sheet
- * renders, and `session.resolveAskUserQuestion()` resumes the execution with
- * the structured answers.
+ * so when the model calls it the execution pauses with a `step_await`, the
+ * widget's answer-pill sheet renders, and `session.resolveAskUserQuestion()`
+ * resumes the execution with the structured answers. The public await frame
+ * for a local-tool pause carries no `awaitReason`; that discriminator is
+ * internal, and its absence is what marks a client-resolvable pause.
  *
  * This replaces the previous integrator burden of hand-declaring the tool in
  * a flow's `runtimeTools` and keeping that schema in sync with the renderer.
  * Flows that already declare `ask_user_question` server-side should leave
- * `expose` off: the model would otherwise see the tool twice.
+ * `expose` off: the API dedupes a double declaration by name with
+ * `clientTools[]` winning, so the model still sees exactly one tool, but the
+ * widget's description and schema silently replace the flow's.
  */
 
 /**
@@ -8752,14 +9277,13 @@ declare const builtInClientToolsForDispatch: (config: AgentWidgetConfig | undefi
  * Built-in `suggest_replies` client tool.
  *
  * The widget can advertise this tool to the agent on every dispatch via
- * `clientTools[]` (set `features.suggestReplies.expose: true`): the same
+ * `clientTools[]` (set `suggestions.followUps.expose: true`): the same
  * wire surface as `ask_user_question` and WebMCP page tools. When the model
- * calls it, the execution pauses with a `step_await`
- * (`awaitReason: "local_tool_required"`); unlike `ask_user_question`, the
- * widget resolves it FIRE-AND-FORGET: it renders the suggestions as tappable
- * chips above the composer and immediately resumes the execution with a
- * canned "shown" result, so the agent's turn completes without waiting on the
- * user. Tapping a chip sends its text verbatim as the user's next message.
+ * calls it, the execution pauses with a `step_await` (a local-tool pause
+ * carries no `awaitReason`; that discriminator is internal). Unlike
+ * `ask_user_question`, the widget resolves it FIRE-AND-FORGET: it renders the
+ * configured follow-up surface and immediately resumes the execution with a
+ * canned "shown" result, so the turn completes without waiting on the user.
  *
  * Chip visibility is DERIVED state, not imperative show/hide: the chips of
  * the last `suggest_replies` tool message with no user message after it are
@@ -8770,9 +9294,10 @@ declare const builtInClientToolsForDispatch: (config: AgentWidgetConfig | undefi
 
 declare const SUGGEST_REPLIES_TOOL_NAME = "suggest_replies";
 /**
- * JSON Schema for the tool's parameters. Mirrors what
- * {@link parseSuggestRepliesPayload} hydrates the chips from, so the schema
- * the model is held to and the shape the renderer expects can never drift.
+ * JSON Schema for the tool's parameters. The model owns semantics only: id,
+ * icon, behavior, and emphasis are presentation, and hosts set them with the
+ * `transformSuggestions` plugin hook. A single object type is used because
+ * strict structured-output modes reject or flatten `oneOf`.
  */
 declare const SUGGEST_REPLIES_PARAMETERS_SCHEMA: {
     readonly type: "object";
@@ -8783,9 +9308,26 @@ declare const SUGGEST_REPLIES_PARAMETERS_SCHEMA: {
             readonly maxItems: 4;
             readonly description: "1-4 short, distinct follow-up replies, phrased in the user's voice.";
             readonly items: {
-                readonly type: "string";
-                readonly minLength: 1;
-                readonly maxLength: 60;
+                readonly type: "object";
+                readonly properties: {
+                    readonly label: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 80;
+                    };
+                    readonly prompt: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 500;
+                    };
+                    readonly description: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 160;
+                    };
+                };
+                readonly required: readonly ["label"];
+                readonly additionalProperties: false;
             };
         };
     };
@@ -8794,7 +9336,7 @@ declare const SUGGEST_REPLIES_PARAMETERS_SCHEMA: {
 };
 /**
  * The `ClientToolDefinition` shipped on `dispatch.clientTools[]` when
- * `features.suggestReplies.expose` is on. Exported so integrators who prefer
+ * `suggestions.followUps.expose` is on. Exported so integrators who prefer
  * declaring the tool server-side (a flow's `runtimeTools`) can reuse the same
  * description and schema instead of hand-writing them.
  */
@@ -8802,18 +9344,20 @@ declare const SUGGEST_REPLIES_CLIENT_TOOL: ClientToolDefinition;
 /** A tool-variant message produced by a `suggest_replies` call. */
 declare const isSuggestRepliesMessage: (message: AgentWidgetMessage) => boolean;
 /**
- * Tolerant parse of a `suggest_replies` tool call's args into chip labels:
- * accepts a JSON string or object, coerces items to trimmed strings, drops
- * empties, and truncates past the renderer cap with a console warning.
+ * Tolerant parse of a `suggest_replies` tool call's args into suggestion
+ * items. Plain strings stay strings for older flows that emit
+ * `suggestions: string[]`; objects keep only label, prompt, and description,
+ * so a model that ignores `additionalProperties` cannot set presentation.
+ * Hosts add id, icon, behavior, and emphasis via `transformSuggestions`.
  */
-declare const parseSuggestRepliesPayload: (args: unknown) => string[];
+declare const parseSuggestRepliesPayload: (args: unknown) => AgentWidgetSuggestion[];
 /**
  * The chips to show right now: those of the LAST `suggest_replies` tool
  * message with NO user message after it, or `null` when none apply. All
  * calls in a turn still get resumed (the server awaits each); only the
  * latest renders.
  */
-declare const latestAgentSuggestions: (messages: AgentWidgetMessage[]) => string[] | null;
+declare const latestAgentSuggestions: (messages: AgentWidgetMessage[]) => AgentWidgetSuggestion[] | null;
 
 type WidgetHostLayoutMode = "direct" | "docked";
 type WidgetHostLayout = {
@@ -9434,6 +9978,11 @@ declare class AttachmentManager {
      * Set the previews container element
      */
     setPreviewsContainer(container: HTMLElement | null): void;
+    /**
+     * Re-point previews at a new container and repaint from state. A composer
+     * rebuild swaps the footer, so pending attachments must follow it.
+     */
+    remountPreviews(container: HTMLElement | null): void;
     /**
      * Update the configuration (e.g., when allowed types change)
      */
@@ -10533,4 +11082,4 @@ interface RovingTablistController {
 }
 declare function createRovingTablist(container: HTMLElement, options: RovingTablistOptions): RovingTablistController;
 
-export { ASK_USER_QUESTION_CLIENT_TOOL, ASK_USER_QUESTION_PARAMETERS_SCHEMA, ASK_USER_QUESTION_TOOL_NAME, type AgentConfig, type AgentExecutionState, type AgentLoopConfig, type AgentMessageMetadata, type AgentRequestOptions, type AgentToolsConfig, type AgentWidgetActionContext, type AgentWidgetActionEventPayload, type AgentWidgetActionHandler, type AgentWidgetActionHandlerResult, type AgentWidgetActionParser, type AgentWidgetAgentRequestPayload, type AgentWidgetApproval, type AgentWidgetApprovalConfig, type AgentWidgetApprovalDecisionOptions, type AgentWidgetArtifactsFeature, type AgentWidgetArtifactsLayoutConfig, type AgentWidgetAskUserQuestionFeature, type AgentWidgetAskUserQuestionStyles, type AgentWidgetAttachmentsConfig, type AgentWidgetAvatarConfig, AgentWidgetClient, type AgentWidgetComponentRenderer, type AgentWidgetComposerConfig, type AgentWidgetConfig, type AgentWidgetConfigPatch, type AgentWidgetContextMentionChipRenderContext, type AgentWidgetContextMentionCommandContext, type AgentWidgetContextMentionComposerCapability, type AgentWidgetContextMentionConfig, type AgentWidgetContextMentionItem, type AgentWidgetContextMentionItemRenderContext, type AgentWidgetContextMentionMenuRenderContext, type AgentWidgetContextMentionPayload, type AgentWidgetContextMentionRef, type AgentWidgetContextMentionResolveContext, type AgentWidgetContextMentionSearchContext, type AgentWidgetContextMentionSource, type AgentWidgetContextMentionTokenRenderContext, type AgentWidgetContextProvider, type AgentWidgetContextProviderContext, type AgentWidgetController, type AgentWidgetControllerEventMap, type AgentWidgetCustomFetch, type AgentWidgetDockConfig, type AgentWidgetEvent, type AgentWidgetFeatureFlags, type AgentWidgetHeaderLayoutConfig, type AgentWidgetHeadersFunction, type AgentWidgetInitHandle, type AgentWidgetInitOptions, type AgentWidgetLauncherConfig, type AgentWidgetLayoutConfig, type AgentWidgetLoadingIndicatorConfig, type AgentWidgetMarkdownConfig, type AgentWidgetMarkdownOptions, type AgentWidgetMarkdownRendererOverrides, type AgentWidgetMentionLlmEntry, type AgentWidgetMentionTriggerChannel, type AgentWidgetMentionTriggerPosition, type AgentWidgetMessage, type AgentWidgetMessageActionsConfig, type AgentWidgetMessageFeedback, type AgentWidgetMessageLayoutConfig, type AgentWidgetMessageRoleLayout, type AgentWidgetParsedAction, type AgentWidgetPlugin, type AgentWidgetReadAloudEvent, type AgentWidgetRequestPayload, type AgentWidgetSSEEventParser, type AgentWidgetSSEEventResult, type AgentWidgetScrollBehaviorFeature, type AgentWidgetScrollMode, type AgentWidgetScrollRestorePosition, type AgentWidgetScrollToBottomFeature, AgentWidgetSession, type AgentWidgetSessionStatus, type AgentWidgetStorageAdapter, type AgentWidgetStoredState, type AgentWidgetStreamAnimationBuffer, type AgentWidgetStreamAnimationBuiltinType, type AgentWidgetStreamAnimationFeature, type AgentWidgetStreamAnimationPlaceholder, type AgentWidgetStreamAnimationType, type AgentWidgetStreamParser, type AgentWidgetStreamParserResult, type AgentWidgetTimestampConfig, type AgentWidgetVoiceStatusEvent, type AgentWidgetWebMcpConfig, type ArtifactConfigPayload, type ArtifactPaneTokens, type ArtifactTabTokens, type ArtifactToolbarTokens, type AskUserQuestionOption, type AskUserQuestionPayload, type AskUserQuestionPrompt, AttachmentManager, type AttachmentManagerConfig, type BorderScale, BrowserSpeechEngine, type BrowserSpeechEngineOptions, type CSATFeedbackOptions, type ClientChatRequest, type ClientFeedbackRequest, type ClientFeedbackType, type ClientInitResponse, type ClientSession, type ClientToolDefinition, type CodeFormat, type CodeGeneratorHooks, type CodeGeneratorOptions, type ColorPalette, type ColorShade, type ComboButtonHandle, type ComponentContext, type ComponentDirective, type ComponentRegistrationOptions, type ComponentRenderer, type ComponentTokens, type ComposerBuildContext, type ComposerElements, type ContentPart, type CreateComboButtonOptions, type CreateDropdownOptions, type CreateIconButtonOptions, type CreateLabelButtonOptions, type CreateStandardBubbleOptions, type CreateThemeOptions, type CreateToggleGroupOptions, DEFAULT_COMPONENTS, DEFAULT_FLOATING_LAUNCHER_MAX_WIDTH, DEFAULT_FLOATING_LAUNCHER_WIDTH, DEFAULT_PALETTE, DEFAULT_SEMANTIC, DEFAULT_WIDGET_CONFIG, type DeepPartial, type DemoCarouselHandle, type DemoCarouselItem, type DemoCarouselOptions, type DomContextMode, type DomContextOptions, type DropdownMenuHandle, type DropdownMenuItem, type EnrichedPageElement, type EventStreamBadgeColor, type EventStreamConfig, type EventStreamPayloadRenderContext, type EventStreamRowRenderContext, type EventStreamToolbarRenderContext, type EventStreamViewRenderContext, type FallbackSpeechEngineOptions, type FormatEnrichedContextOptions, type HeaderBuildContext, type HeaderElements, type HeaderLayoutContext, type HeaderLayoutRenderer, type HeaderRenderContext, type IconButtonTokens, type IconName, type IdleIndicatorRenderContext, type ImageContentPart, type InjectAssistantMessageOptions, type InjectComponentDirectiveOptions, type InjectMessageOptions, type InjectSystemMessageOptions, type InjectUserMessageOptions, type LabelButtonTokens, type LoadingIndicatorRenderContext, type LoadingIndicatorRenderer, type MarkdownParsersModule, type MarkdownProcessorOptions, type MessageActionCallbacks, type MessageContent, type MessageRenderContext, type MessageTransform, type NPSFeedbackOptions, PRESETS, PRESET_FULLSCREEN, PRESET_MINIMAL, PRESET_SHOP, type ParseOptionsConfig, type ParseRule, type PcmStreamPlayer, type PendingAttachment, type PersonaArtifactActionContext, type PersonaArtifactCustomAction, type PersonaArtifactDisplayDescriptor, type PersonaArtifactDisplayMatch, type PersonaArtifactDisplayMode, type PersonaArtifactDisplayModeInput, type PersonaArtifactDisplayResolution, type PersonaArtifactDisplayRules, type PersonaArtifactFilesDisplayRules, type PersonaArtifactKind, type PersonaArtifactManualUpsert, type PersonaArtifactPresentation, type PersonaArtifactRecord, type PersonaArtifactStatusLabelContext, type PersonaTheme, type PersonaThemePlugin, type RadiusScale, ReadAloudController, type ReadAloudListener, type ReadAloudState, type ResolvedTarget, type RovingTablistController, type RovingTablistOptions, type RuleScoringContext, type RuntypeClientChatRequest, type RuntypeClientChatStreamEvent, type RuntypeClientFeedbackRequest, type RuntypeClientFeedbackResponse, type RuntypeClientFeedbackType, type RuntypeClientInitRequest, type RuntypeClientInitResponse, type RuntypeClientResumeRequest, type RuntypeClientResumeStreamEvent, type RuntypeExecutionStreamEvent, type RuntypeFlowSSEEvent, type RuntypeStepCompleteEvent, type RuntypeStopReasonKind, type RuntypeStreamEventOf, type RuntypeTurnCompleteEvent, type SSEEventCallback, type SSEEventRecord, SUGGEST_REPLIES_CLIENT_TOOL, SUGGEST_REPLIES_PARAMETERS_SCHEMA, SUGGEST_REPLIES_TOOL_NAME, type SanitizeFunction, type SemanticColors, type SemanticSpacing, type SemanticTypography, type ShadowScale, type SlashCommandDefinition, type SlotRenderContext, type SlotRenderer, type SpacingScale, type SpeechCallbacks, type SpeechEngine, type SpeechRequest, type StreamAnimationContext, type StreamAnimationPlugin, THEME_ZONES, type TargetResolver, type TextContentPart, type ThemeValidationError, type ThemeValidationResult, type ThemeZone, type ToggleGroupHandle, type ToggleGroupItem, type ToggleGroupTokens, type TokenReference, type TypographyScale, VERSION, type VoiceConfig, type VoiceMetrics, type VoicePlaybackEngine, type VoiceProvider, type VoiceResult, type VoiceStatus, WEBMCP_TOOL_PREFIX, WebMcpBridge, type WebMcpConfirmHandler, type WebMcpConfirmInfo, type WebMcpToolResult, type WidgetArtifactLayoutPreference, type WidgetHostLayout, type WidgetHostLayoutMode, type WidgetLayoutSlot, type WidgetPreferenceCapabilities, type WidgetPreferenceParseIssue, type WidgetPreferenceParseIssueCode, type WidgetPreferenceParseResult, type WidgetPreferenceSlice, type WidgetPreset, accessibilityPlugin, animationsPlugin, applyFeaturePreferences, applyThemeVariables, attachHeaderToContainer, brandPlugin, buildComposer, buildDefaultHeader, buildHeader, buildHeaderWithLayout, buildMinimalHeader, builtInClientToolsForDispatch, canonicalArtifactDisplayMode, collectEnrichedPageContext, componentRegistry, createActionManager, createAgentExperience, createAskUserQuestionBubble, createBestAvailableVoiceProvider, createBubbleWithLayout, createCSATFeedback, createComboButton, createComponentMiddleware, createComponentStreamParser, createDefaultSanitizer, createDemoCarousel, createDirectivePostprocessor, createDropdownMenu, createFlexibleJsonStreamParser, createIconButton, createImagePart, createJsonStreamParser, createLabelButton, createLocalStorageAdapter, createMarkdownProcessor, createMarkdownProcessorFromConfig, createMessageActions, createNPSFeedback, createPlainTextParser, createPlugin, createRegexJsonParser, createRovingTablist, createSlashCommandsSource, createStandardBubble, createStaticMentionSource, createTextPart, createTheme, createThemeObserver, createToggleGroup, createTypingIndicator, createVoiceProvider, createWidgetHostLayout, createXmlParser, initAgentWidget as default, defaultActionHandlers, defaultJsonActionParser, defaultMentionFilter, defaultParseRules, detectColorScheme, directivePostprocessor, ensureAskUserQuestionSheet, escapeHtml, extractComponentDirectiveFromMessage, fileToImagePart, formatEnrichedContext, generateAssistantMessageId, generateCodeSnippet, generateMessageId, generateStableSelector, generateUserMessageId, getActiveTheme, getColorScheme, getDisplayText, getHeaderLayout, getImageParts, getPreset, hasComponentDirective, hasImages, headerLayouts, highContrastPlugin, initAgentWidget, isAskUserQuestionMessage, isComponentDirectiveType, isDockedMountMode, isSuggestRepliesMessage, isVoiceSupported, isWebMcpToolName, latestAgentSuggestions, listRegisteredStreamAnimations, loadMarkdownParsers, markdownPostprocessor, mergeWithDefaults, normalizeContent, normalizeMediaType, onMarkdownParsersReady, parseAskUserQuestionPayload, parseSuggestRepliesPayload, parseWidgetPreferenceSlice, pickBestVoice, pluginRegistry, reducedMotionPlugin, registerStreamAnimationPlugin, removeAskUserQuestionSheet, renderComponentDirective, renderLoadingIndicatorWithFallback, renderLucideIcon, resolveArtifactDisplay, resolveArtifactDisplayMode, resolveConfigPreferences, resolveDockConfig, resolveSanitizer, resolveTokens, stripWebMcpPrefix, themeToCssVariables, unregisterStreamAnimationPlugin, validateImageFile, validateTheme };
+export { ASK_USER_QUESTION_CLIENT_TOOL, ASK_USER_QUESTION_PARAMETERS_SCHEMA, ASK_USER_QUESTION_TOOL_NAME, type AgentConfig, type AgentExecutionState, type AgentLoopConfig, type AgentMessageMetadata, type AgentRequestOptions, type AgentToolsConfig, type AgentWidgetActionContext, type AgentWidgetActionEventPayload, type AgentWidgetActionHandler, type AgentWidgetActionHandlerResult, type AgentWidgetActionParser, type AgentWidgetAgentRequestPayload, type AgentWidgetApproval, type AgentWidgetApprovalConfig, type AgentWidgetApprovalDecisionOptions, type AgentWidgetArtifactsFeature, type AgentWidgetArtifactsLayoutConfig, type AgentWidgetAskUserQuestionFeature, type AgentWidgetAskUserQuestionStyles, type AgentWidgetAttachmentsConfig, type AgentWidgetAvatarConfig, AgentWidgetClient, type AgentWidgetComponentRenderer, type AgentWidgetComposerConfig, type AgentWidgetConfig, type AgentWidgetConfigPatch, type AgentWidgetContextMentionChipRenderContext, type AgentWidgetContextMentionCommandContext, type AgentWidgetContextMentionComposerCapability, type AgentWidgetContextMentionConfig, type AgentWidgetContextMentionItem, type AgentWidgetContextMentionItemRenderContext, type AgentWidgetContextMentionMenuRenderContext, type AgentWidgetContextMentionPayload, type AgentWidgetContextMentionRef, type AgentWidgetContextMentionResolveContext, type AgentWidgetContextMentionSearchContext, type AgentWidgetContextMentionSource, type AgentWidgetContextMentionTokenRenderContext, type AgentWidgetContextProvider, type AgentWidgetContextProviderContext, type AgentWidgetController, type AgentWidgetControllerEventMap, type AgentWidgetCustomFetch, type AgentWidgetDockConfig, type AgentWidgetEvent, type AgentWidgetFeatureFlags, type AgentWidgetFollowUpSuggestionsConfig, type AgentWidgetHeaderLayoutConfig, type AgentWidgetHeadersFunction, type AgentWidgetInitHandle, type AgentWidgetInitOptions, type AgentWidgetLauncherConfig, type AgentWidgetLauncherTeaserConfig, type AgentWidgetLayoutConfig, type AgentWidgetLoadingIndicatorConfig, type AgentWidgetMarkdownConfig, type AgentWidgetMarkdownOptions, type AgentWidgetMarkdownRendererOverrides, type AgentWidgetMentionLlmEntry, type AgentWidgetMentionTriggerChannel, type AgentWidgetMentionTriggerPosition, type AgentWidgetMessage, type AgentWidgetMessageActionsConfig, type AgentWidgetMessageFeedback, type AgentWidgetMessageLayoutConfig, type AgentWidgetMessageRoleLayout, type AgentWidgetParsedAction, type AgentWidgetPlugin, type AgentWidgetPluginStorage, type AgentWidgetReadAloudEvent, type AgentWidgetRenderSuggestionContext, type AgentWidgetRenderWelcomeContext, type AgentWidgetRequestPayload, type AgentWidgetResolvedSuggestion, type AgentWidgetSSEEventParser, type AgentWidgetSSEEventResult, type AgentWidgetScrollBehaviorFeature, type AgentWidgetScrollMode, type AgentWidgetScrollRestorePosition, type AgentWidgetScrollToBottomFeature, AgentWidgetSession, type AgentWidgetSessionStatus, type AgentWidgetStarterSuggestionsConfig, type AgentWidgetStorageAdapter, type AgentWidgetStoredState, type AgentWidgetStreamAnimationBuffer, type AgentWidgetStreamAnimationBuiltinType, type AgentWidgetStreamAnimationFeature, type AgentWidgetStreamAnimationPlaceholder, type AgentWidgetStreamAnimationType, type AgentWidgetStreamParser, type AgentWidgetStreamParserResult, type AgentWidgetSuggestion, type AgentWidgetSuggestionBehavior, type AgentWidgetSuggestionChipsConfig, type AgentWidgetSuggestionSelectContext, type AgentWidgetSuggestionSource, type AgentWidgetSuggestionSurface, type AgentWidgetSuggestionSurfaceConfig, type AgentWidgetSuggestionVariant, type AgentWidgetSuggestionsConfig, type AgentWidgetTimestampConfig, type AgentWidgetTransformSuggestionsContext, type AgentWidgetVoiceStatusEvent, type AgentWidgetWebMcpConfig, type AgentWidgetWelcomeConfig, type AgentWidgetWelcomeDismiss, type AgentWidgetWelcomeIcon, type AgentWidgetWelcomeVariant, type ArtifactConfigPayload, type ArtifactPaneTokens, type ArtifactTabTokens, type ArtifactToolbarTokens, type AskUserQuestionOption, type AskUserQuestionPayload, type AskUserQuestionPrompt, AttachmentManager, type AttachmentManagerConfig, type BorderScale, BrowserSpeechEngine, type BrowserSpeechEngineOptions, type CSATFeedbackOptions, type ClientChatRequest, type ClientFeedbackRequest, type ClientFeedbackType, type ClientInitResponse, type ClientSession, type ClientToolDefinition, type CodeFormat, type CodeGeneratorHooks, type CodeGeneratorOptions, type ColorPalette, type ColorShade, type ComboButtonHandle, type ComponentContext, type ComponentDirective, type ComponentRegistrationOptions, type ComponentRenderer, type ComponentTokens, type ComposerBuildContext, type ComposerElements, type ContentPart, type CreateComboButtonOptions, type CreateDropdownOptions, type CreateIconButtonOptions, type CreateLabelButtonOptions, type CreateStandardBubbleOptions, type CreateThemeOptions, type CreateToggleGroupOptions, DEFAULT_COMPONENTS, DEFAULT_FLOATING_LAUNCHER_MAX_WIDTH, DEFAULT_FLOATING_LAUNCHER_WIDTH, DEFAULT_PALETTE, DEFAULT_SEMANTIC, DEFAULT_WIDGET_CONFIG, type DeepPartial, type DemoCarouselHandle, type DemoCarouselItem, type DemoCarouselOptions, type DomContextMode, type DomContextOptions, type DropdownMenuHandle, type DropdownMenuItem, type EnrichedPageElement, type EventStreamBadgeColor, type EventStreamConfig, type EventStreamPayloadRenderContext, type EventStreamRowRenderContext, type EventStreamToolbarRenderContext, type EventStreamViewRenderContext, type FallbackSpeechEngineOptions, type FormatEnrichedContextOptions, type HeaderBuildContext, type HeaderElements, type HeaderLayoutContext, type HeaderLayoutRenderer, type HeaderRenderContext, type IconButtonTokens, type IconName, type IdleIndicatorRenderContext, type ImageContentPart, type InjectAssistantMessageOptions, type InjectComponentDirectiveOptions, type InjectMessageOptions, type InjectSystemMessageOptions, type InjectUserMessageOptions, type LabelButtonTokens, type LoadingIndicatorRenderContext, type LoadingIndicatorRenderer, type MarkdownParsersModule, type MarkdownProcessorOptions, type MessageActionCallbacks, type MessageContent, type MessageRenderContext, type MessageTransform, type NPSFeedbackOptions, PRESETS, PRESET_FULLSCREEN, PRESET_MINIMAL, PRESET_SHOP, type ParseOptionsConfig, type ParseRule, type PcmStreamPlayer, type PendingAttachment, type PersonaArtifactActionContext, type PersonaArtifactCustomAction, type PersonaArtifactDisplayDescriptor, type PersonaArtifactDisplayMatch, type PersonaArtifactDisplayMode, type PersonaArtifactDisplayModeInput, type PersonaArtifactDisplayResolution, type PersonaArtifactDisplayRules, type PersonaArtifactFilesDisplayRules, type PersonaArtifactKind, type PersonaArtifactManualUpsert, type PersonaArtifactPresentation, type PersonaArtifactRecord, type PersonaArtifactStatusLabelContext, type PersonaTheme, type PersonaThemePlugin, type RadiusScale, ReadAloudController, type ReadAloudListener, type ReadAloudState, type ResolvedTarget, type ResolvedWelcomeConfig, type RovingTablistController, type RovingTablistOptions, type RuleScoringContext, type RuntypeClientChatRequest, type RuntypeClientChatStreamEvent, type RuntypeClientFeedbackRequest, type RuntypeClientFeedbackResponse, type RuntypeClientFeedbackType, type RuntypeClientInitRequest, type RuntypeClientInitResponse, type RuntypeClientResumeRequest, type RuntypeClientResumeStreamEvent, type RuntypeExecutionStreamEvent, type RuntypeFlowSSEEvent, type RuntypeStepCompleteEvent, type RuntypeStopReasonKind, type RuntypeStreamEventOf, type RuntypeTurnCompleteEvent, type SSEEventCallback, type SSEEventRecord, SUGGEST_REPLIES_CLIENT_TOOL, SUGGEST_REPLIES_PARAMETERS_SCHEMA, SUGGEST_REPLIES_TOOL_NAME, type SanitizeFunction, type SemanticColors, type SemanticSpacing, type SemanticTypography, type ShadowScale, type SlashCommandDefinition, type SlotRenderContext, type SlotRenderer, type SpacingScale, type SpeechCallbacks, type SpeechEngine, type SpeechRequest, type StreamAnimationContext, type StreamAnimationPlugin, THEME_ZONES, type TargetResolver, type TextContentPart, type TextStyleTokens, type ThemeValidationError, type ThemeValidationResult, type ThemeZone, type ToggleGroupHandle, type ToggleGroupItem, type ToggleGroupTokens, type TokenReference, type TypographyScale, VERSION, type VoiceConfig, type VoiceMetrics, type VoicePlaybackEngine, type VoiceProvider, type VoiceResult, type VoiceStatus, WEBMCP_TOOL_PREFIX, WebMcpBridge, type WebMcpConfirmHandler, type WebMcpConfirmInfo, type WebMcpToolResult, type WidgetArtifactLayoutPreference, type WidgetHostLayout, type WidgetHostLayoutMode, type WidgetLayoutSlot, type WidgetPreferenceCapabilities, type WidgetPreferenceParseIssue, type WidgetPreferenceParseIssueCode, type WidgetPreferenceParseResult, type WidgetPreferenceSlice, type WidgetPreset, accessibilityPlugin, animationsPlugin, applyFeaturePreferences, applyThemeVariables, attachHeaderToContainer, brandPlugin, buildComposer, buildDefaultHeader, buildHeader, buildHeaderWithLayout, buildMinimalHeader, builtInClientToolsForDispatch, canonicalArtifactDisplayMode, collectEnrichedPageContext, componentRegistry, createActionManager, createAgentExperience, createAskUserQuestionBubble, createBestAvailableVoiceProvider, createBubbleWithLayout, createCSATFeedback, createComboButton, createComponentMiddleware, createComponentStreamParser, createDefaultSanitizer, createDemoCarousel, createDirectivePostprocessor, createDropdownMenu, createFlexibleJsonStreamParser, createIconButton, createImagePart, createJsonStreamParser, createLabelButton, createLocalStorageAdapter, createMarkdownProcessor, createMarkdownProcessorFromConfig, createMessageActions, createNPSFeedback, createPlainTextParser, createPlugin, createRegexJsonParser, createRovingTablist, createSlashCommandsSource, createStandardBubble, createStaticMentionSource, createTextPart, createTheme, createThemeObserver, createToggleGroup, createTypingIndicator, createVoiceProvider, createWidgetHostLayout, createXmlParser, initAgentWidget as default, defaultActionHandlers, defaultJsonActionParser, defaultMentionFilter, defaultParseRules, detectColorScheme, directivePostprocessor, ensureAskUserQuestionSheet, escapeHtml, extractComponentDirectiveFromMessage, fileToImagePart, formatEnrichedContext, generateAssistantMessageId, generateCodeSnippet, generateMessageId, generateStableSelector, generateUserMessageId, getActiveTheme, getColorScheme, getDisplayText, getHeaderLayout, getImageParts, getPreset, hasComponentDirective, hasImages, headerLayouts, highContrastPlugin, initAgentWidget, isAskUserQuestionMessage, isComponentDirectiveType, isDockedMountMode, isSuggestRepliesMessage, isVoiceSupported, isWebMcpToolName, isWelcomeVisible, latestAgentSuggestions, listRegisteredStreamAnimations, loadMarkdownParsers, markdownPostprocessor, mergeWithDefaults, normalizeContent, normalizeMediaType, onMarkdownParsersReady, parseAskUserQuestionPayload, parseSuggestRepliesPayload, parseWidgetPreferenceSlice, pickBestVoice, pluginRegistry, reducedMotionPlugin, registerStreamAnimationPlugin, removeAskUserQuestionSheet, renderComponentDirective, renderLoadingIndicatorWithFallback, renderLucideIcon, resolveArtifactDisplay, resolveArtifactDisplayMode, resolveConfigPreferences, resolveDockConfig, resolveSanitizer, resolveTokens, resolveWelcomeConfig, stripWebMcpPrefix, themeToCssVariables, unregisterStreamAnimationPlugin, validateImageFile, validateTheme };