@runtypelabs/persona 3.31.1 → 3.34.0

package/dist/index.d.cts

@@ -2119,12 +2119,44 @@ type AgentToolsConfig = {
     mcpServers?: Array<Record<string, unknown>>;
     /** Maximum number of tool invocations per execution */
     maxToolCalls?: number;
+    /** How the model is steered toward tools: let it decide, force a call, or disable */
+    toolCallStrategy?: "auto" | "required" | "none";
+    /** Per-tool invocation limits / requirements keyed by tool name */
+    perToolLimits?: Record<string, {
+        maxCalls?: number;
+        required?: boolean;
+    }>;
     /** Tool approval configuration for human-in-the-loop workflows */
     approval?: {
         /** Tool names/patterns to require approval for, or true for all tools */
         require: string[] | boolean;
         /** Approval timeout in milliseconds (default: 300000 / 5 minutes) */
         timeout?: number;
+        /** Ask the agent to state its intent alongside approval requests (default: true) */
+        requestReason?: boolean;
+    };
+    /**
+     * Enables the synthesized `spawn_subagent` tool: the model can spin up
+     * ad-hoc child agents at runtime, restricted to `toolPool` (tool IDs /
+     * runtime-tool names already granted to the parent agent).
+     */
+    subagentConfig?: {
+        toolPool: string[];
+        defaultMaxTurns?: number;
+        maxTurnsLimit?: number;
+        maxSpawnsPerRun?: number;
+        defaultModel?: string;
+        allowNesting?: boolean;
+        defaultTimeoutMs?: number;
+    };
+    /**
+     * Enables the synthesized `code_mode` tool: the model writes JS that calls
+     * pool tools inside a sandbox instead of issuing individual tool calls.
+     */
+    codeModeConfig?: {
+        toolPool: string[];
+        description?: string;
+        timeoutMs?: number;
     };
 };
 /** Artifact kinds for the Persona sidebar and dispatch payload */
@@ -2195,8 +2227,13 @@ type ClientToolDefinition = {
     description: string;
     /** JSON Schema (per WebMCP spec) — passed through as-is. */
     parametersSchema?: object;
-    /** Set to `'webmcp'` for tools discovered via the polyfill. */
-    origin?: 'webmcp' | 'local';
+    /**
+     * `'webmcp'` for tools discovered via the polyfill (server prepends the
+     * `webmcp:` wire prefix); `'sdk'` for widget/SDK-provided tools (name stays
+     * bare on the wire). Matches the server's accepted enum — any other value
+     * fails dispatch validation.
+     */
+    origin?: 'webmcp' | 'sdk';
     /** Origin of the page that registered the tool — for server-side audit. */
     pageOrigin?: string;
     /**
@@ -2358,6 +2395,13 @@ type AgentMessageMetadata = {
      * paginated stepper. Persists alongside `askUserQuestionAnswers`.
      */
     askUserQuestionIndex?: number;
+    /**
+     * Set to `true` once a `suggest_replies` tool call's fire-and-forget
+     * `/resume` has been accepted by the server. Persisted belt-and-suspenders
+     * mirror of the in-memory resolved-key dedupe, so hydration/re-emit paths
+     * never re-resume the call.
+     */
+    suggestRepliesResolved?: boolean;
 };
 type AgentWidgetRequestMiddlewareContext = {
     payload: AgentWidgetRequestPayload;
@@ -3003,6 +3047,37 @@ type AgentWidgetFeatureFlags = {
      * pills + optional free-text input.
      */
     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.
+     */
+    suggestReplies?: AgentWidgetSuggestRepliesFeature;
+};
+/**
+ * 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.
+ */
+type AgentWidgetSuggestRepliesFeature = {
+    /**
+     * Enable the feature. 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`: flows that already declare the tool via
+     * `runtimeTools` would otherwise present it to the model twice. Ignored
+     * when `enabled` is `false`.
+     */
+    expose?: boolean;
 };
 /**
  * Single selectable option in an `ask_user_question` prompt.
@@ -3063,6 +3138,19 @@ type AgentWidgetAskUserQuestionStyles = {
 type AgentWidgetAskUserQuestionFeature = {
     /** Enable the feature. Defaults to true. When false, `ask_user_question` renders as a regular tool bubble. */
     enabled?: boolean;
+    /**
+     * Advertise the built-in `ask_user_question` tool to the agent on every
+     * dispatch via `clientTools[]` — no server-side `runtimeTools` declaration
+     * needed. The tool ships with a model-facing description and JSON schema
+     * 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.
+     */
+    expose?: boolean;
     /** Slide-in animation duration in ms. Defaults to 180. */
     slideInMs?: number;
     /** Label for the free-text pill. Defaults to "Other…". */
@@ -3244,6 +3332,26 @@ type AgentWidgetDockConfig = {
      *   it appears to emerge at full width like a floating widget.
      */
     reveal?: "resize" | "overlay" | "push" | "emerge";
+    /**
+     * Maximum height of the dock panel, applied as a viewport-overflow guard.
+     *
+     * The docked shell sizes itself with `height: 100%`, which only resolves when
+     * an ancestor (usually `html, body { height: 100% }`) provides a definite
+     * height. Without one, the dock column would otherwise grow with the
+     * conversation and scroll off the page. This cap clamps the panel to the
+     * viewport (and keeps the `resize`/`emerge` reveals pinned with
+     * `position: sticky`; `push`/`overlay` get the cap only, since their
+     * transform/absolute contexts defeat sticky) so a missing height chain
+     * degrades gracefully instead of breaking the chat.
+     *
+     * - Set a CSS length (e.g. `"600px"`, `"80vh"`) to override the cap.
+     * - Set `false` to disable the guard entirely (the panel then sizes purely
+     *   from the surrounding layout — make sure your page provides a definite
+     *   height all the way down to the dock target's parent).
+     *
+     * @default "100dvh"
+     */
+    maxHeight?: string | false;
 };
 /**
  * Layout configuration for `mountMode: "composer-bar"`. Controls how the
@@ -6034,6 +6142,25 @@ declare class AgentWidgetClient {
     private clientToolsFingerprintSessionId;
     private readonly webMcpBridge;
     constructor(config?: AgentWidgetConfig);
+    /**
+     * Refresh config in place WITHOUT tearing down the live connection or the
+     * WebMCP bridge. `AgentWidgetSession.updateConfig` calls this when only
+     * connection-irrelevant fields changed (theme, copy, layout, suggestions, …),
+     * so a UI update that lands mid-turn — e.g. a `webmcp:*` tool restyling the
+     * widget while the agent's turn is still streaming — doesn't abandon the
+     * in-flight stream/resume. Connection or request-shaping changes (apiUrl,
+     * clientToken, webmcp, headers, parser, …) take the full client rebuild path
+     * in the session instead, which is the only place the bridge is recreated.
+     *
+     * Only the live-read `config` is refreshed (e.g. `iterationDisplay`); the
+     * constructor-derived request-shaping fields (apiUrl, headers, parser,
+     * contextProviders, middleware, …) are left untouched because the session
+     * routes any change to those down the full-rebuild path instead — so they are
+     * guaranteed unchanged here. The `webMcpBridge` instance and its
+     * installed-polyfill memo are deliberately preserved, which keeps any
+     * in-flight resolve alive.
+     */
+    updateConfig(next: AgentWidgetConfig): void;
     /**
      * Set callback for capturing raw SSE events
      */
@@ -6559,7 +6686,8 @@ declare class AgentWidgetSession {
     markAskUserQuestionResolved(toolMessage: AgentWidgetMessage, answers?: Record<string, string | string[]>): void;
     resolveAskUserQuestion(toolMessage: AgentWidgetMessage, answer: string | Record<string, string | string[]>): Promise<void>;
     /**
-     * Collect a `webmcp:*` LOCAL-tool `step_await` into a per-executionId batch
+     * Collect an auto-resolving LOCAL-tool `step_await` (`webmcp:*` page tools
+     * and the built-in `suggest_replies`) into a per-executionId batch
      * and schedule a single deferred flush. Parallel calls (core#3878) emit
      * several `step_await`s for ONE paused execution within the same stream tick;
      * buffering them and flushing once lets us post ONE `/resume` keyed by the
@@ -6596,6 +6724,17 @@ declare class AgentWidgetSession {
      */
     private flushWebMcpAwaitBatch;
     private resolveWebMcpToolStartedAt;
+    /**
+     * Persisted-resolution guard for `suggest_replies`. The in-memory dedupe
+     * sets (`webMcpInflightKeys` / `webMcpResolvedKeys`) are cleared by
+     * hydrateMessages/clearMessages/cancel, but `suggestRepliesResolved`
+     * survives on the stored message — so a stale `step_await` re-emit after a
+     * hydration must not re-POST `/resume` for an already-resolved call (the
+     * historical double-resume failure mode the batching work exists to avoid).
+     * Checks the LIVE message first; the handleEvent snapshot is a fresh wire
+     * skeleton whose metadata never carries the flag.
+     */
+    private isSuggestRepliesAlreadyResolved;
     private markWebMcpToolRunning;
     private markWebMcpToolComplete;
     /**
@@ -6614,12 +6753,16 @@ declare class AgentWidgetSession {
      */
     private resolveWebMcpToolCallBatch;
     /**
-     * Resolve a paused `webmcp:*` LOCAL tool call by executing it against the
-     * host page's tool registry and posting the result to `/resume`.
+     * Resolve a paused auto-resolving LOCAL tool call and post the result to
+     * `/resume`: `webmcp:*` calls execute against the host page's tool
+     * registry; the built-in `suggest_replies` skips execution entirely and
+     * resumes with a canned "shown" result (the chips render from the message
+     * list, not from this resolve).
      *
      * Triggered automatically from `handleEvent` when a `step_await`-derived
-     * message arrives with a `webmcp:` prefix — the user does not click a
-     * pill; the bridge's confirm-bubble gate is the only interactive surface.
+     * message arrives for such a tool — the user does not click a pill; the
+     * bridge's confirm-bubble gate (WebMCP only) is the only interactive
+     * surface.
      *
      * Idempotent on the message's `toolCall.id`: re-emits of the same step_await
      * (e.g. from message coalescing) won't double-fire `tool.execute`. Failure
@@ -6893,6 +7036,175 @@ declare const ensureAskUserQuestionSheet: (message: AgentWidgetMessage, config:
  */
 declare const removeAskUserQuestionSheet: (overlay: HTMLElement | null | undefined, toolCallId?: string) => void;
 
+/**
+ * Built-in `ask_user_question` client tool.
+ *
+ * The widget can advertise this tool to the agent on every dispatch via
+ * `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.
+ *
+ * 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.
+ */
+
+/**
+ * JSON Schema for the tool's parameters. Mirrors {@link AskUserQuestionPayload}
+ * — the shape `parseAskUserQuestionPayload` hydrates the answer sheet from —
+ * so the schema the model is held to and the schema the renderer expects can
+ * never drift.
+ */
+declare const ASK_USER_QUESTION_PARAMETERS_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly questions: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 8;
+            readonly description: "Questions to ask the user. Prefer a single question.";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly question: {
+                        readonly type: "string";
+                        readonly description: "The complete question, ending with a question mark.";
+                    };
+                    readonly header: {
+                        readonly type: "string";
+                        readonly maxLength: 12;
+                        readonly description: "Short topic label, e.g. \"Auth method\".";
+                    };
+                    readonly options: {
+                        readonly type: "array";
+                        readonly minItems: 2;
+                        readonly maxItems: 4;
+                        readonly description: "2-4 distinct choices. Do NOT add an \"Other\" option — free text is automatic.";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly label: {
+                                    readonly type: "string";
+                                    readonly description: "Concise choice text (1-5 words).";
+                                };
+                                readonly description: {
+                                    readonly type: "string";
+                                    readonly description: "What the option means or implies.";
+                                };
+                            };
+                            readonly required: readonly ["label"];
+                            readonly additionalProperties: false;
+                        };
+                    };
+                    readonly multiSelect: {
+                        readonly type: "boolean";
+                        readonly description: "Allow selecting multiple options. Default false.";
+                    };
+                    readonly allowFreeText: {
+                        readonly type: "boolean";
+                        readonly description: "Show a free-text input. Default true.";
+                    };
+                };
+                readonly required: readonly ["question", "options"];
+                readonly additionalProperties: false;
+            };
+        };
+    };
+    readonly required: readonly ["questions"];
+    readonly additionalProperties: false;
+};
+/**
+ * The `ClientToolDefinition` shipped on `dispatch.clientTools[]` when
+ * `features.askUserQuestion.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.
+ */
+declare const ASK_USER_QUESTION_CLIENT_TOOL: ClientToolDefinition;
+/**
+ * Built-in client tools to append to a dispatch's `clientTools[]` for the
+ * given widget config: `ask_user_question` and `suggest_replies`; future
+ * built-in local tools join here.
+ *
+ * Each tool is gated on BOTH of its feature flags: `expose` opts the tool
+ * into the agent's catalog, and `enabled !== false` guarantees the widget can
+ * actually render UI (and, for fire-and-forget tools, auto-resume) for it —
+ * exposing a tool with its feature disabled would park the execution on a
+ * generic tool bubble with no way to advance.
+ */
+declare const builtInClientToolsForDispatch: (config: AgentWidgetConfig | undefined) => ClientToolDefinition[];
+
+/**
+ * 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
+ * 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.
+ *
+ * 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
+ * shown (see {@link latestAgentSuggestions}). That single rule covers
+ * soft-dismiss on any user message (typed, voice, or chip click), restore on
+ * reload/hydration, and latest-wins when a turn carries multiple calls.
+ */
+
+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.
+ */
+declare const SUGGEST_REPLIES_PARAMETERS_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly suggestions: {
+            readonly type: "array";
+            readonly minItems: 1;
+            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 required: readonly ["suggestions"];
+    readonly additionalProperties: false;
+};
+/**
+ * The `ClientToolDefinition` shipped on `dispatch.clientTools[]` when
+ * `features.suggestReplies.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.
+ */
+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.
+ */
+declare const parseSuggestRepliesPayload: (args: unknown) => string[];
+/**
+ * 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;
+
 type WidgetHostLayoutMode = "direct" | "docked";
 type WidgetHostLayout = {
     mode: WidgetHostLayoutMode;
@@ -8671,4 +8983,4 @@ interface DemoCarouselHandle {
 }
 declare function createDemoCarousel(container: HTMLElement, options: DemoCarouselOptions): DemoCarouselHandle;
 
-export { 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 AgentWidgetComposerConfig, type AgentWidgetConfig, 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 AgentWidgetMessage, type AgentWidgetMessageActionsConfig, type AgentWidgetMessageFeedback, type AgentWidgetMessageLayoutConfig, type AgentWidgetParsedAction, type AgentWidgetPlugin, type AgentWidgetRequestPayload, type AgentWidgetSSEEventParser, type AgentWidgetSSEEventResult, AgentWidgetSession, type AgentWidgetSessionStatus, type AgentWidgetStreamAnimationBuffer, type AgentWidgetStreamAnimationBuiltinType, type AgentWidgetStreamAnimationFeature, type AgentWidgetStreamAnimationPlaceholder, type AgentWidgetStreamAnimationType, type AgentWidgetStreamParser, type AgentWidgetStreamParserResult, type AgentWidgetTimestampConfig, type AgentWidgetWebMcpConfig, type ArtifactConfigPayload, type ArtifactPaneTokens, type ArtifactTabTokens, type ArtifactToolbarTokens, type AskUserQuestionOption, type AskUserQuestionPayload, type AskUserQuestionPrompt, AttachmentManager, type AttachmentManagerConfig, type BorderScale, 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 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 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 MarkdownProcessorOptions, type MessageActionCallbacks, type MessageContent, type MessageRenderContext, type MessageTransform, type NPSFeedbackOptions, PRESETS, PRESET_FULLSCREEN, PRESET_MINIMAL, PRESET_SHOP, type ParseOptionsConfig, type ParseRule, type PendingAttachment, type PersonaArtifactKind, type PersonaArtifactManualUpsert, type PersonaArtifactRecord, type PersonaTheme, type PersonaThemePlugin, type RadiusScale, type RuleScoringContext, type RuntypeAgentSSEEvent, type RuntypeAgentTurnCompleteEvent, type RuntypeClientChatRequest, type RuntypeClientChatStreamEvent, type RuntypeClientFeedbackRequest, type RuntypeClientFeedbackResponse, type RuntypeClientFeedbackType, type RuntypeClientInitRequest, type RuntypeClientInitResponse, type RuntypeClientResumeRequest, type RuntypeClientResumeStreamEvent, type RuntypeDispatchSSEEvent, type RuntypeFlowSSEEvent, type RuntypeStepCompleteEvent, type RuntypeStopReasonKind, type RuntypeStreamEventOf, type SSEEventCallback, type SSEEventRecord, type SanitizeFunction, type SemanticColors, type SemanticSpacing, type SemanticTypography, type ShadowScale, type SlotRenderContext, type SlotRenderer, type SpacingScale, type StreamAnimationContext, type StreamAnimationPlugin, THEME_ZONES, type TextContentPart, type ThemeValidationError, type ThemeValidationResult, type ThemeZone, type ToggleGroupHandle, type ToggleGroupItem, type ToggleGroupTokens, type TokenReference, type TypographyScale, VERSION, type VoiceConfig, type VoiceProvider, type VoiceResult, type VoiceStatus, WEBMCP_TOOL_PREFIX, WebMcpBridge, type WebMcpConfirmHandler, type WebMcpConfirmInfo, type WebMcpToolResult, type WidgetHostLayout, type WidgetHostLayoutMode, type WidgetLayoutSlot, type WidgetPreset, accessibilityPlugin, animationsPlugin, applyThemeVariables, attachHeaderToContainer, brandPlugin, buildComposer, buildDefaultHeader, buildHeader, buildHeaderWithLayout, buildMinimalHeader, 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, createStandardBubble, createTextPart, createTheme, createThemeObserver, createToggleGroup, createTypingIndicator, createVoiceProvider, createWidgetHostLayout, createXmlParser, initAgentWidget as default, defaultActionHandlers, defaultJsonActionParser, 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, isVoiceSupported, isWebMcpToolName, listRegisteredStreamAnimations, markdownPostprocessor, mergeWithDefaults, normalizeContent, parseAskUserQuestionPayload, pluginRegistry, reducedMotionPlugin, registerStreamAnimationPlugin, removeAskUserQuestionSheet, renderComponentDirective, renderLoadingIndicatorWithFallback, renderLucideIcon, 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 AgentWidgetComposerConfig, type AgentWidgetConfig, 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 AgentWidgetMessage, type AgentWidgetMessageActionsConfig, type AgentWidgetMessageFeedback, type AgentWidgetMessageLayoutConfig, type AgentWidgetParsedAction, type AgentWidgetPlugin, type AgentWidgetRequestPayload, type AgentWidgetSSEEventParser, type AgentWidgetSSEEventResult, AgentWidgetSession, type AgentWidgetSessionStatus, type AgentWidgetStreamAnimationBuffer, type AgentWidgetStreamAnimationBuiltinType, type AgentWidgetStreamAnimationFeature, type AgentWidgetStreamAnimationPlaceholder, type AgentWidgetStreamAnimationType, type AgentWidgetStreamParser, type AgentWidgetStreamParserResult, type AgentWidgetTimestampConfig, type AgentWidgetWebMcpConfig, type ArtifactConfigPayload, type ArtifactPaneTokens, type ArtifactTabTokens, type ArtifactToolbarTokens, type AskUserQuestionOption, type AskUserQuestionPayload, type AskUserQuestionPrompt, AttachmentManager, type AttachmentManagerConfig, type BorderScale, 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 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 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 MarkdownProcessorOptions, type MessageActionCallbacks, type MessageContent, type MessageRenderContext, type MessageTransform, type NPSFeedbackOptions, PRESETS, PRESET_FULLSCREEN, PRESET_MINIMAL, PRESET_SHOP, type ParseOptionsConfig, type ParseRule, type PendingAttachment, type PersonaArtifactKind, type PersonaArtifactManualUpsert, type PersonaArtifactRecord, type PersonaTheme, type PersonaThemePlugin, type RadiusScale, type RuleScoringContext, type RuntypeAgentSSEEvent, type RuntypeAgentTurnCompleteEvent, type RuntypeClientChatRequest, type RuntypeClientChatStreamEvent, type RuntypeClientFeedbackRequest, type RuntypeClientFeedbackResponse, type RuntypeClientFeedbackType, type RuntypeClientInitRequest, type RuntypeClientInitResponse, type RuntypeClientResumeRequest, type RuntypeClientResumeStreamEvent, type RuntypeDispatchSSEEvent, type RuntypeFlowSSEEvent, type RuntypeStepCompleteEvent, type RuntypeStopReasonKind, type RuntypeStreamEventOf, 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 SlotRenderContext, type SlotRenderer, type SpacingScale, type StreamAnimationContext, type StreamAnimationPlugin, THEME_ZONES, type TextContentPart, type ThemeValidationError, type ThemeValidationResult, type ThemeZone, type ToggleGroupHandle, type ToggleGroupItem, type ToggleGroupTokens, type TokenReference, type TypographyScale, VERSION, type VoiceConfig, type VoiceProvider, type VoiceResult, type VoiceStatus, WEBMCP_TOOL_PREFIX, WebMcpBridge, type WebMcpConfirmHandler, type WebMcpConfirmInfo, type WebMcpToolResult, type WidgetHostLayout, type WidgetHostLayoutMode, type WidgetLayoutSlot, type WidgetPreset, accessibilityPlugin, animationsPlugin, applyThemeVariables, attachHeaderToContainer, brandPlugin, buildComposer, buildDefaultHeader, buildHeader, buildHeaderWithLayout, buildMinimalHeader, builtInClientToolsForDispatch, 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, createStandardBubble, createTextPart, createTheme, createThemeObserver, createToggleGroup, createTypingIndicator, createVoiceProvider, createWidgetHostLayout, createXmlParser, initAgentWidget as default, defaultActionHandlers, defaultJsonActionParser, 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, markdownPostprocessor, mergeWithDefaults, normalizeContent, parseAskUserQuestionPayload, parseSuggestRepliesPayload, pluginRegistry, reducedMotionPlugin, registerStreamAnimationPlugin, removeAskUserQuestionSheet, renderComponentDirective, renderLoadingIndicatorWithFallback, renderLucideIcon, resolveDockConfig, resolveSanitizer, resolveTokens, stripWebMcpPrefix, themeToCssVariables, unregisterStreamAnimationPlugin, validateImageFile, validateTheme };