@runtypelabs/persona 4.14.0 → 4.15.0

package/dist/index.d.cts

@@ -2,6 +2,40 @@ import { IconNode } from 'lucide';
 import { Marked } from 'marked';
 import DOMPurify from 'dompurify';
 
+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 AgentWidgetSuggestionSelectContext = {
+    suggestion: AgentWidgetResolvedSuggestion;
+    surface: AgentWidgetSuggestionSurface;
+    source: AgentWidgetSuggestionSource;
+    variant: AgentWidgetSuggestionVariant;
+    config: AgentWidgetConfig;
+};
 /**
  * Plugin interface for customizing widget components
  */
@@ -14,6 +48,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
@@ -609,6 +662,14 @@ interface ReasoningBubbleTokens {
 interface ComposerChromeTokens {
     /** Box-shadow on the composer form (raw CSS, e.g. `none`). */
     shadow: string;
+    /** 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 +819,26 @@ interface ScrollToBottomTokens extends ComponentTokenSet {
     fontSize?: string;
     iconSize?: string;
 }
+/** Visual tokens shared by one suggestion presentation variant. */
+interface SuggestionVariantTokens extends ComponentTokenSet {
+    gap?: 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). */
@@ -788,6 +869,8 @@ interface ComponentTokens {
     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 +1192,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 +1581,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 +1624,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;
 };
@@ -3641,10 +3744,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 +3795,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 +3808,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 +3889,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. */
@@ -4254,6 +4368,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 +5140,109 @@ 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. */
+    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` for starters
+     * and `scroll` for follow-ups. 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;
+};
 /**
  * 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.).
@@ -6268,7 +6489,11 @@ type AgentWidgetConfig = {
      * with `initialArtifacts`.
      */
     initialSelectedArtifactId?: string | null;
+    /** Rich starter and follow-up suggestion surfaces. */
+    suggestions?: AgentWidgetSuggestionsConfig;
+    /** @deprecated Prefer `suggestions.starters.items`. */
     suggestionChips?: string[];
+    /** @deprecated Prefer semantic tokens under `theme.components.suggestion`. */
     suggestionChipsConfig?: AgentWidgetSuggestionChipsConfig;
     debug?: boolean;
     formEndpoint?: string;
@@ -8473,6 +8698,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 +8893,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 +8993,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 +9010,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 +9024,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 +9052,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 +9060,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 = {
@@ -10533,4 +10793,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 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 AgentWidgetRenderSuggestionContext, 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 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 };