@runtypelabs/persona 1.47.0 → 2.0.0

package/dist/index.d.ts

@@ -45,7 +45,33 @@ interface AgentWidgetPlugin {
         config: AgentWidgetConfig;
         defaultRenderer: () => HTMLElement;
         onSubmit: (text: string) => void;
+        /**
+         * When true, the assistant stream is active — same moment `session.isStreaming()` becomes true.
+         * Prefer wiring controls to `data-persona-composer-disable-when-streaming` plus `setComposerDisabled`
+         * in the host, or react to `footer.dataset.personaComposerStreaming === "true"`.
+         */
+        streaming: boolean;
+        /**
+         * Legacy alias: host disables the primary submit control while `streaming` is true.
+         * @deprecated Use `streaming` for new plugins.
+         */
         disabled: boolean;
+        /** Opens the hidden file input when `config.attachments.enabled` is true (no-op otherwise). */
+        openAttachmentPicker: () => void;
+        /** From `config.composer.models` */
+        models?: Array<{
+            id: string;
+            label: string;
+        }>;
+        /** From `config.composer.selectedModelId` */
+        selectedModelId?: string;
+        /** Updates `config.composer.selectedModelId` for the running widget instance. */
+        onModelChange?: (modelId: string) => void;
+        /**
+         * Same behavior as the built-in mic when voice is enabled.
+         * Omitted when `config.voiceRecognition.enabled` is not true.
+         */
+        onVoiceToggle?: () => void;
     }) => HTMLElement | null;
     /**
      * Custom renderer for reasoning bubbles
@@ -189,34 +215,68 @@ type AgentWidgetRequestPayload = {
     flowId?: string;
     context?: Record<string, unknown>;
     metadata?: Record<string, unknown>;
+    /** Per-turn template variables for /v1/client/chat (merged as root-level {{var}} in Runtype). */
+    inputs?: Record<string, unknown>;
 };
 /**
  * Configuration for agent loop behavior.
  */
 type AgentLoopConfig = {
-    /** Maximum number of reasoning iterations */
-    maxIterations: number;
-    /** Stop condition: 'auto' for automatic detection, or a custom JS expression */
-    stopCondition?: 'auto' | string;
+    /** Maximum number of agent turns (1-100). The loop continues while the model calls tools. */
+    maxTurns: number;
+    /** Maximum cost budget in USD. Agent stops when exceeded. */
+    maxCost?: number;
     /** Enable periodic reflection during execution */
     enableReflection?: boolean;
-    /** Number of iterations between reflections */
+    /** Number of iterations between reflections (1-50) */
     reflectionInterval?: number;
 };
+/**
+ * Configuration for agent tools (search, code execution, MCP servers, etc.)
+ */
+type AgentToolsConfig = {
+    /** Tool IDs to enable (e.g., "builtin:exa", "builtin:dalle", "builtin:openai_web_search") */
+    toolIds?: string[];
+    /** Per-tool configuration overrides keyed by tool ID */
+    toolConfigs?: Record<string, Record<string, unknown>>;
+    /** Inline tool definitions for runtime-defined tools */
+    runtimeTools?: Array<Record<string, unknown>>;
+    /** Custom MCP server connections */
+    mcpServers?: Array<Record<string, unknown>>;
+    /** Maximum number of tool invocations per execution */
+    maxToolCalls?: number;
+    /** 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;
+    };
+};
+/** Artifact kinds for the Persona sidebar and dispatch payload */
+type PersonaArtifactKind = "markdown" | "component";
 /**
  * Agent configuration for agent execution mode.
  * When provided in the widget config, enables agent loop execution instead of flow dispatch.
  */
+type ArtifactConfigPayload = {
+    enabled: true;
+    types: PersonaArtifactKind[];
+};
 type AgentConfig = {
     /** Agent display name */
     name: string;
-    /** Model identifier (e.g., 'openai:gpt-4o-mini') */
+    /** Model identifier (e.g., 'openai:gpt-4o-mini', 'qwen/qwen3-8b') */
     model: string;
     /** System prompt for the agent */
     systemPrompt: string;
     /** Temperature for model responses */
     temperature?: number;
-    /** Loop configuration for multi-iteration execution */
+    /** Tool configuration for the agent */
+    tools?: AgentToolsConfig;
+    /** Persona artifacts — sibling of tools (virtual agent / API parity) */
+    artifacts?: ArtifactConfigPayload;
+    /** Loop configuration for multi-turn execution */
     loopConfig?: AgentLoopConfig;
 };
 /**
@@ -251,10 +311,10 @@ type AgentExecutionState = {
     agentName: string;
     status: 'running' | 'complete' | 'error';
     currentIteration: number;
-    maxIterations: number;
+    maxTurns: number;
     startedAt?: number;
     completedAt?: number;
-    stopReason?: 'max_iterations' | 'complete' | 'error' | 'manual';
+    stopReason?: 'complete' | 'end_turn' | 'max_turns' | 'max_cost' | 'timeout' | 'error';
 };
 /**
  * Metadata attached to messages created during agent execution.
@@ -449,12 +509,144 @@ type AgentWidgetControllerEventMap = {
         decision: string;
     };
 };
+/**
+ * Layout for the artifact split / drawer (CSS lengths unless noted).
+ *
+ * **Close behavior:** In desktop split mode, the artifact chrome `Close` control uses the same
+ * dismiss path as the mobile drawer (`onDismiss` on the artifact pane): the pane is hidden until
+ * new artifact content arrives or the host calls `showArtifacts()` on the widget handle.
+ */
+type AgentWidgetArtifactsLayoutConfig = {
+    /** Flex gap between chat column and artifact pane. @default 0.5rem */
+    splitGap?: string;
+    /** Artifact column width in split mode. @default 40% */
+    paneWidth?: string;
+    /** Max width of artifact column. @default 28rem */
+    paneMaxWidth?: string;
+    /** Min width of artifact column (optional). */
+    paneMinWidth?: string;
+    /**
+     * When the floating panel is at most this wide (px), use in-panel drawer for artifacts
+     * instead of a side-by-side split (viewport can still be wide).
+     * @default 520
+     */
+    narrowHostMaxWidth?: number;
+    /**
+     * When true (default), widen the launcher panel while artifacts are visible and not user-dismissed.
+     * No-op for inline embed (`launcher.enabled === false`).
+     */
+    expandLauncherPanelWhenOpen?: boolean;
+    /** Panel width when expanded (launcher + artifacts visible). @default min(720px, calc(100vw - 24px)) */
+    expandedPanelWidth?: string;
+    /**
+     * When true, shows a drag handle between chat and artifact columns in desktop split mode only
+     * (hidden in narrow-host drawer and viewport ≤640px). Width is not persisted across reloads.
+     */
+    resizable?: boolean;
+    /** Min artifact column width while resizing. Only `px` strings are supported. @default 200px */
+    resizableMinWidth?: string;
+    /** Optional max artifact width cap while resizing (`px` only). Layout still bounds by chat min width. */
+    resizableMaxWidth?: string;
+    /**
+     * Visual treatment for the artifact column in split mode.
+     * - `'panel'` — bordered sidebar with left border, gap, and shadow (default).
+     * - `'seamless'` — flush with chat: no border or shadow, container background, zero gap.
+     * @default 'panel'
+     */
+    paneAppearance?: "panel" | "seamless";
+    /** Border radius on the artifact pane (CSS length). Works with any `paneAppearance`. */
+    paneBorderRadius?: string;
+    /** CSS `box-shadow` on the artifact pane. Set `"none"` to suppress the default shadow. */
+    paneShadow?: string;
+    /**
+     * Full `border` shorthand for the artifact `<aside>` (all sides). Overrides default pane borders.
+     * Example: `"1px solid #cccccc"`.
+     */
+    paneBorder?: string;
+    /**
+     * `border-left` shorthand only — typical for split view next to chat (with or without resizer).
+     * Ignored if `paneBorder` is set. Example: `"1px solid #cccccc"`.
+     */
+    paneBorderLeft?: string;
+    /**
+     * Desktop split only (not narrow-host drawer / not ≤640px): square the **main chat card’s**
+     * top-right and bottom-right radii, and round the **artifact pane’s** top-right and bottom-right
+     * to match `persona-rounded-2xl` (`--persona-radius-lg`) so the two columns read as one shell.
+     */
+    unifiedSplitChrome?: boolean;
+    /**
+     * When `unifiedSplitChrome` is true, outer-right corner radius on the artifact column (CSS length).
+     * @default matches theme large radius (`--persona-radius-lg`)
+     */
+    unifiedSplitOuterRadius?: string;
+    /**
+     * Background color for the artifact column (CSS color). Sets `--persona-artifact-pane-bg` on the widget root.
+     */
+    paneBackground?: string;
+    /**
+     * Horizontal padding for artifact toolbar and content (CSS length), e.g. `24px`.
+     */
+    panePadding?: string;
+    /**
+     * Toolbar layout preset.
+     * - `default` — "Artifacts" title, horizontal tabs, text close.
+     * - `document` — view/source toggle, document title, copy / refresh / close; tab strip hidden when only one artifact.
+     * @default 'default'
+     */
+    toolbarPreset?: "default" | "document";
+    /**
+     * When `toolbarPreset` is `document`, show a visible "Copy" label next to the copy icon.
+     */
+    documentToolbarShowCopyLabel?: boolean;
+    /**
+     * When `toolbarPreset` is `document`, show a small chevron after the copy control (e.g. menu affordance).
+     */
+    documentToolbarShowCopyChevron?: boolean;
+    /** Document toolbar icon buttons (view, code, copy, refresh, close) — CSS color. Sets `--persona-artifact-doc-toolbar-icon-color` on the widget root. */
+    documentToolbarIconColor?: string;
+    /** Active view/source toggle background. Sets `--persona-artifact-doc-toggle-active-bg`. */
+    documentToolbarToggleActiveBackground?: string;
+    /** Active view/source toggle border color. Sets `--persona-artifact-doc-toggle-active-border`. */
+    documentToolbarToggleActiveBorderColor?: string;
+    /**
+     * Invoked when the document toolbar Refresh control is used (before the pane re-renders).
+     * Use to replay `connectStream`, refetch, etc.
+     */
+    onDocumentToolbarRefresh?: () => void | Promise<void>;
+    /**
+     * Optional copy dropdown entries (shown when `documentToolbarShowCopyChevron` is true and this array is non-empty).
+     * The main Copy control still performs default copy unless `onDocumentToolbarCopyMenuSelect` handles everything.
+     */
+    documentToolbarCopyMenuItems?: Array<{
+        id: string;
+        label: string;
+    }>;
+    /**
+     * When set, invoked for the chevron menu (and can override default copy per `actionId`).
+     */
+    onDocumentToolbarCopyMenuSelect?: (payload: {
+        actionId: string;
+        artifactId: string | null;
+        markdown: string;
+        jsonPayload: string;
+    }) => void | Promise<void>;
+};
+type AgentWidgetArtifactsFeature = {
+    /** When true, Persona shows the artifact pane and handles artifact_* SSE events */
+    enabled?: boolean;
+    /** If set, artifact events for other types are ignored */
+    allowedTypes?: PersonaArtifactKind[];
+    /** Split / drawer dimensions and launcher widen behavior */
+    layout?: AgentWidgetArtifactsLayoutConfig;
+};
 type AgentWidgetFeatureFlags = {
     showReasoning?: boolean;
     showToolCalls?: boolean;
     showEventStreamToggle?: boolean;
     /** Configuration for the Event Stream inspector view */
     eventStream?: EventStreamConfig;
+    /** Optional artifact sidebar (split pane / mobile drawer) */
+    artifacts?: AgentWidgetArtifactsFeature;
 };
 type SSEEventRecord = {
     id: string;
@@ -607,7 +799,7 @@ type AgentWidgetTheme = {
     /**
      * Border style for the chat panel container.
      * @example "1px solid #e5e7eb" | "none"
-     * @default "1px solid var(--tvw-cw-border)"
+     * @default "1px solid var(--persona-border)"
      */
     panelBorder?: string;
     /**
@@ -623,6 +815,23 @@ type AgentWidgetTheme = {
      */
     panelBorderRadius?: string;
 };
+type AgentWidgetDockConfig = {
+    /**
+     * Side of the wrapped container where the docked panel should render.
+     * @default "right"
+     */
+    side?: "left" | "right";
+    /**
+     * Expanded width of the docked panel.
+     * @default "420px"
+     */
+    width?: string;
+    /**
+     * Width of the collapsed launcher rail when the docked panel is closed.
+     * @default "72px"
+     */
+    collapsedWidth?: string;
+};
 type AgentWidgetLauncherConfig = {
     enabled?: boolean;
     title?: string;
@@ -633,6 +842,18 @@ type AgentWidgetLauncherConfig = {
     agentIconName?: string;
     agentIconHidden?: boolean;
     position?: "bottom-right" | "bottom-left" | "top-right" | "top-left";
+    /**
+     * Controls how the launcher panel is mounted relative to the host page.
+     * - "floating": default floating launcher / panel behavior
+     * - "docked": wraps the target container and renders as a sibling dock
+     *
+     * @default "floating"
+     */
+    mountMode?: "floating" | "docked";
+    /**
+     * Layout configuration for docked mode.
+     */
+    dock?: AgentWidgetDockConfig;
     autoExpand?: boolean;
     width?: string;
     /**
@@ -672,6 +893,21 @@ type AgentWidgetLauncherConfig = {
      * @default 0
      */
     heightOffset?: number;
+    /**
+     * When true, the widget panel expands to fill the full viewport on mobile devices.
+     * Removes border-radius, margins, and shadows for a native app-like experience.
+     * Applies when viewport width is at or below `mobileBreakpoint`.
+     *
+     * @default true
+     */
+    mobileFullscreen?: boolean;
+    /**
+     * Viewport width (in pixels) at or below which the widget enters mobile fullscreen mode.
+     * Only applies when `mobileFullscreen` is true.
+     *
+     * @default 640
+     */
+    mobileBreakpoint?: number;
     callToActionIconText?: string;
     callToActionIconName?: string;
     callToActionIconColor?: string;
@@ -724,6 +960,15 @@ type AgentWidgetSendButtonConfig = {
     textColor?: string;
     size?: string;
 };
+/** Optional composer UI state for custom `renderComposer` implementations. */
+type AgentWidgetComposerConfig = {
+    models?: Array<{
+        id: string;
+        label: string;
+    }>;
+    /** Current selection; host or plugin may update this at runtime. */
+    selectedModelId?: string;
+};
 type AgentWidgetClearChatConfig = {
     enabled?: boolean;
     placement?: "inline" | "top-right";
@@ -767,6 +1012,22 @@ type AgentWidgetVoiceRecognitionConfig = {
     recordingBackgroundColor?: string;
     recordingBorderColor?: string;
     showRecordingIndicator?: boolean;
+    /** Icon name shown while processing voice input. Default: "loader" */
+    processingIconName?: string;
+    /** Icon color during processing. Inherits idle iconColor if not set */
+    processingIconColor?: string;
+    /** Button background color during processing. Inherits idle backgroundColor if not set */
+    processingBackgroundColor?: string;
+    /** Button border color during processing. Inherits idle borderColor if not set */
+    processingBorderColor?: string;
+    /** Icon name shown while agent is speaking. Default: "volume-2" (or "square" in cancel mode) */
+    speakingIconName?: string;
+    /** Icon color while speaking. Inherits idle iconColor if not set */
+    speakingIconColor?: string;
+    /** Button background color while speaking. Inherits idle backgroundColor if not set */
+    speakingBackgroundColor?: string;
+    /** Button border color while speaking. Inherits idle borderColor if not set */
+    speakingBorderColor?: string;
     autoResume?: boolean | "assistant";
     provider?: {
         type: 'browser' | 'runtype' | 'custom';
@@ -856,7 +1117,7 @@ type VoiceResult = {
 /**
  * Voice provider status states
  */
-type VoiceStatus = 'disconnected' | 'connected' | 'listening' | 'processing' | 'error' | 'idle';
+type VoiceStatus = 'disconnected' | 'connected' | 'listening' | 'processing' | 'speaking' | 'error' | 'idle';
 /**
  * Voice provider configuration
  * Determines which voice provider to use and its specific settings
@@ -894,6 +1155,14 @@ interface VoiceProvider {
     onStatusChange(callback: (status: VoiceStatus) => void): void;
     /** Register a callback fired when recording stops and audio is about to be sent */
     onProcessingStart?(callback: () => void): void;
+    /** Returns the current interruption mode (only meaningful for Runtype provider) */
+    getInterruptionMode?(): "none" | "cancel" | "barge-in";
+    /** Returns true if the barge-in mic stream is alive (hot mic between turns) */
+    isBargeInActive?(): boolean;
+    /** Tear down the barge-in mic pipeline — "hang up" the always-on mic */
+    deactivateBargeIn?(): Promise<void>;
+    /** Stop playback / cancel in-flight request without starting recording */
+    stopPlayback?(): void;
 }
 /**
  * Configuration for tool approval bubbles.
@@ -1099,6 +1368,8 @@ type ClientChatRequest = {
     /** ID for the expected assistant response message */
     assistantMessageId?: string;
     metadata?: Record<string, unknown>;
+    /** Per-turn inputs for Runtype prompt templates (e.g. {{page_url}}). */
+    inputs?: Record<string, unknown>;
     context?: Record<string, unknown>;
 };
 /**
@@ -1118,6 +1389,14 @@ type ClientFeedbackRequest = {
     /** Optional comment for any feedback type */
     comment?: string;
 };
+/** Icon button in the header title row (minimal layout). */
+type AgentWidgetHeaderTrailingAction = {
+    id: string;
+    /** Lucide icon name, e.g. `chevron-down` */
+    icon?: string;
+    label?: string;
+    ariaLabel?: string;
+};
 /**
  * Context provided to header render functions
  */
@@ -1125,6 +1404,10 @@ type HeaderRenderContext = {
     config: AgentWidgetConfig;
     onClose?: () => void;
     onClearChat?: () => void;
+    /** Built from `layout.header.trailingActions` for custom `render` implementations. */
+    trailingActions?: AgentWidgetHeaderTrailingAction[];
+    /** Fired when a built-in trailing action is activated (same as `layout.header.onAction`). */
+    onAction?: (actionId: string) => void;
 };
 /**
  * Context provided to message render functions
@@ -1147,12 +1430,11 @@ type SlotRenderContext = {
  */
 type AgentWidgetHeaderLayoutConfig = {
     /**
-     * Layout preset: "default" | "minimal" | "expanded"
+     * Layout preset: "default" | "minimal"
      * - default: Standard layout with icon, title, subtitle, and buttons
      * - minimal: Simplified layout with just title and close button
-     * - expanded: Full branding area with additional content space
      */
-    layout?: "default" | "minimal" | "expanded";
+    layout?: "default" | "minimal";
     /** Show/hide the header icon */
     showIcon?: boolean;
     /** Show/hide the title */
@@ -1168,6 +1450,12 @@ type AgentWidgetHeaderLayoutConfig = {
      * When provided, replaces the entire header with custom content
      */
     render?: (context: HeaderRenderContext) => HTMLElement;
+    /**
+     * Shown after the title in `minimal` header layout (e.g. chevron menu affordance).
+     */
+    trailingActions?: AgentWidgetHeaderTrailingAction[];
+    /** Called when a `trailingActions` button is clicked. */
+    onAction?: (actionId: string) => void;
 };
 /**
  * Avatar configuration for message bubbles
@@ -1275,6 +1563,12 @@ type AgentWidgetLayoutConfig = {
      * @default true
      */
     showFooter?: boolean;
+    /**
+     * 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%").
+     */
+    contentMaxWidth?: string;
 };
 /**
  * Token types for marked renderer methods
@@ -1803,7 +2097,7 @@ type AgentWidgetConfig = {
      *     name: 'Assistant',
      *     model: 'openai:gpt-4o-mini',
      *     systemPrompt: 'You are a helpful assistant.',
-     *     loopConfig: { maxIterations: 3, stopCondition: 'auto' }
+      *     loopConfig: { maxTurns: 5 }
      *   }
      * }
      * ```
@@ -1919,6 +2213,11 @@ type AgentWidgetConfig = {
         welcomeSubtitle?: string;
         inputPlaceholder?: string;
         sendButtonLabel?: string;
+        /**
+         * When false, the welcome / intro card is not shown above the message list.
+         * @default true
+         */
+        showWelcomeCard?: boolean;
     };
     theme?: AgentWidgetTheme;
     /**
@@ -2070,6 +2369,12 @@ type AgentWidgetConfig = {
      * @default true
      */
     enableComponentStreaming?: boolean;
+    /**
+     * When false, JSON component directives render without the default bubble chrome
+     * (surface background, border, extra padding). Use for wide custom cards in the transcript.
+     * @default true
+     */
+    wrapComponentDirectiveInBubble?: boolean;
     /**
      * Custom stream parser for extracting text from streaming structured responses.
      * Handles incremental parsing of JSON, XML, or other formats.
@@ -2268,6 +2573,11 @@ type AgentWidgetConfig = {
      * ```
      */
     attachments?: AgentWidgetAttachmentsConfig;
+    /**
+     * Composer extras for custom `renderComposer` plugins (model picker, etc.).
+     * `selectedModelId` may be updated at runtime by the host.
+     */
+    composer?: AgentWidgetComposerConfig;
     /**
      * Persist widget state (open/closed, voice mode) across page navigations.
      * When `true`, uses default settings with sessionStorage.
@@ -2521,6 +2831,28 @@ type InjectUserMessageOptions = Omit<InjectMessageOptions, "role">;
  * Role defaults to 'system'.
  */
 type InjectSystemMessageOptions = Omit<InjectMessageOptions, "role">;
+type PersonaArtifactRecord = {
+    id: string;
+    artifactType: PersonaArtifactKind;
+    title?: string;
+    status: "streaming" | "complete";
+    markdown?: string;
+    component?: string;
+    props?: Record<string, unknown>;
+};
+/** Programmatic artifact upsert (controller / window API) */
+type PersonaArtifactManualUpsert = {
+    id?: string;
+    artifactType: "markdown";
+    title?: string;
+    content: string;
+} | {
+    id?: string;
+    artifactType: "component";
+    title?: string;
+    component: string;
+    props?: Record<string, unknown>;
+};
 type AgentWidgetEvent = {
     type: "message";
     message: AgentWidgetMessage;
@@ -2530,6 +2862,24 @@ type AgentWidgetEvent = {
 } | {
     type: "error";
     error: Error;
+} | {
+    type: "artifact_start";
+    id: string;
+    artifactType: PersonaArtifactKind;
+    title?: string;
+    component?: string;
+} | {
+    type: "artifact_delta";
+    id: string;
+    artDelta: string;
+} | {
+    type: "artifact_update";
+    id: string;
+    props: Record<string, unknown>;
+    component?: string;
+} | {
+    type: "artifact_complete";
+    id: string;
 };
 type AgentWidgetInitOptions = {
     target: string | HTMLElement;
@@ -2707,6 +3057,10 @@ type SessionCallbacks = {
     onStreamingChanged: (streaming: boolean) => void;
     onError?: (error: Error) => void;
     onVoiceStatusChanged?: (status: VoiceStatus) => void;
+    onArtifactsState?: (state: {
+        artifacts: PersonaArtifactRecord[];
+        selectedId: string | null;
+    }) => void;
 };
 declare class AgentWidgetSession {
     private config;
@@ -2719,6 +3073,8 @@ declare class AgentWidgetSession {
     private sequenceCounter;
     private clientSession;
     private agentExecution;
+    private artifacts;
+    private selectedArtifactId;
     private voiceProvider;
     private voiceActive;
     private voiceStatus;
@@ -2755,6 +3111,19 @@ declare class AgentWidgetSession {
      * Get current voice status
      */
     getVoiceStatus(): VoiceStatus;
+    /**
+     * Get the voice interruption mode from the provider (none/cancel/barge-in)
+     */
+    getVoiceInterruptionMode(): "none" | "cancel" | "barge-in";
+    /**
+     * Stop voice playback / cancel in-flight request without starting recording.
+     * Returns to idle state.
+     */
+    stopVoicePlayback(): void;
+    /** Returns true if the barge-in mic stream is alive (hot mic between turns) */
+    isBargeInActive(): boolean;
+    /** Tear down the barge-in mic pipeline — "hang up" the always-on mic */
+    deactivateBargeIn(): Promise<void>;
     private pendingVoiceUserMessageId;
     private pendingVoiceAssistantMessageId;
     private ttsSpokenMessageIds;
@@ -2935,6 +3304,15 @@ declare class AgentWidgetSession {
     resolveApproval(approval: AgentWidgetApproval, decision: 'approved' | 'denied'): Promise<void>;
     cancel(): void;
     clearMessages(): void;
+    getArtifacts(): PersonaArtifactRecord[];
+    getArtifactById(id: string): PersonaArtifactRecord | undefined;
+    getSelectedArtifactId(): string | null;
+    selectArtifact(id: string | null): void;
+    clearArtifacts(): void;
+    upsertArtifact(manual: PersonaArtifactManualUpsert): PersonaArtifactRecord;
+    private clearArtifactState;
+    private emitArtifactsState;
+    private applyArtifactStreamEvent;
     hydrateMessages(messages: AgentWidgetMessage[]): void;
     private handleEvent;
     private setStatus;
@@ -3089,6 +3467,14 @@ type Controller = {
     hideEventStream: () => void;
     /** Returns current visibility state of the event stream panel */
     isEventStreamVisible: () => boolean;
+    /** Show artifact sidebar (no-op if features.artifacts.enabled is false) */
+    showArtifacts: () => void;
+    /** Hide artifact sidebar */
+    hideArtifacts: () => void;
+    /** Upsert an artifact programmatically */
+    upsertArtifact: (manual: PersonaArtifactManualUpsert) => PersonaArtifactRecord | null;
+    selectArtifact: (id: string) => void;
+    clearArtifacts: () => void;
     /**
      * Focus the chat input. Returns true if focus succeeded, false if panel is closed
      * (launcher mode) or textarea is unavailable.
@@ -3111,6 +3497,17 @@ type AgentWidgetInitHandle = AgentWidgetController & {
 };
 declare const initAgentWidget: (options: AgentWidgetInitOptions) => AgentWidgetInitHandle;
 
+type WidgetHostLayoutMode = "direct" | "docked";
+type WidgetHostLayout = {
+    mode: WidgetHostLayoutMode;
+    host: HTMLElement;
+    shell: HTMLElement | null;
+    syncWidgetState: (state: Pick<AgentWidgetStateSnapshot, "open" | "launcherEnabled">) => void;
+    updateConfig: (config?: AgentWidgetConfig) => void;
+    destroy: () => void;
+};
+declare const createWidgetHostLayout: (target: HTMLElement, config?: AgentWidgetConfig) => WidgetHostLayout;
+
 declare const createLocalStorageAdapter: (key?: string) => AgentWidgetStorageAdapter;
 
 type ActionManagerProcessContext = {
@@ -3302,6 +3699,142 @@ declare function validateImageFile(file: File, acceptedTypes?: string[], maxSize
     error?: string;
 };
 
+/**
+ * Enriched DOM context collection for providing richer page information to AI.
+ *
+ * Captures interactive elements, stable CSS selectors, ARIA roles, data attributes,
+ * and visibility state — giving the LLM much better context than basic className/innerText.
+ *
+ * ## Modes
+ *
+ * - **structured** (default): collects candidates, scores them with optional {@link ParseRule}
+ *   hooks, then applies `maxElements`. Rich containers (e.g. product cards) can surface
+ *   before unrelated static noise.
+ * - **simple**: legacy behavior — cap during traversal, interactive-first ordering, no rule
+ *   scoring or {@link EnrichedPageElement.formattedSummary}.
+ */
+interface EnrichedPageElement {
+    /** Stable CSS selector the LLM can use directly */
+    selector: string;
+    /** Lowercase tag name */
+    tagName: string;
+    /** Visible text content, trimmed */
+    text: string;
+    /** ARIA role or null */
+    role: string | null;
+    /** Interactivity classification */
+    interactivity: "clickable" | "input" | "navigable" | "static";
+    /** Relevant attributes: id, data-*, href, aria-label, type, value, name */
+    attributes: Record<string, string>;
+    /**
+     * When set (structured mode + matching rule), {@link formatEnrichedContext} prefers this
+     * markdown-like line instead of raw `text`.
+     */
+    formattedSummary?: string;
+}
+/** How DOM context is collected and formatted. */
+type DomContextMode = "simple" | "structured";
+/**
+ * Options that control collection limits, visibility, and mode.
+ * Prefer nesting these under {@link DomContextOptions.options}; top-level fields remain
+ * supported for backward compatibility.
+ */
+interface ParseOptionsConfig {
+    /**
+     * `structured` (default): score candidates with rules, then apply `maxElements`.
+     * `simple`: legacy traversal cap and ordering only — rules are ignored (with a warning
+     * if `rules` was passed on {@link DomContextOptions}).
+     */
+    mode?: DomContextMode;
+    /** Maximum number of elements to return. Default: 80 */
+    maxElements?: number;
+    /** CSS selector for elements to exclude (e.g. the widget host). Default: '.persona-host' */
+    excludeSelector?: string;
+    /** Maximum text length per element. Default: 200 */
+    maxTextLength?: number;
+    /** Only include visible elements. Default: true */
+    visibleOnly?: boolean;
+    /** Root element to walk. Default: document.body */
+    root?: HTMLElement;
+    /**
+     * Maximum candidates gathered before scoring (structured mode only).
+     * Default: `max(500, maxElements * 10)`.
+     */
+    maxCandidates?: number;
+}
+interface RuleScoringContext {
+    doc: Document;
+    maxTextLength: number;
+}
+/**
+ * Extensible rule for structured DOM context: scoring, descendant suppression, and
+ * optional formatted output.
+ */
+interface ParseRule {
+    /** Stable id for debugging and tests */
+    id: string;
+    /**
+     * Score bonus when this rule applies to the element (0 when it does not).
+     * Higher scores are kept first when applying `maxElements`.
+     */
+    scoreElement(el: HTMLElement, enriched: EnrichedPageElement, ctx: RuleScoringContext): number;
+    /**
+     * When `owner` is kept in the final set and matched this rule for formatting,
+     * return true to drop `descendant` (redundant price text, CTAs summarized on the card, etc.).
+     */
+    shouldSuppressDescendant?(owner: HTMLElement, descendant: HTMLElement, descendantEnriched: EnrichedPageElement): boolean;
+    /**
+     * Markdown-like summary for the LLM. Only used when `scoreElement` &gt; 0 for this rule.
+     */
+    formatSummary?(el: HTMLElement, enriched: EnrichedPageElement, ctx: RuleScoringContext): string | null;
+}
+interface DomContextOptions {
+    /** Nested parse options (mode, limits, root). Merged with legacy top-level fields. */
+    options?: ParseOptionsConfig;
+    /** Custom rules for structured mode. Default: {@link defaultParseRules} */
+    rules?: ParseRule[];
+    /** @inheritdoc ParseOptionsConfig.maxElements */
+    maxElements?: number;
+    /** @inheritdoc ParseOptionsConfig.excludeSelector */
+    excludeSelector?: string;
+    /** @inheritdoc ParseOptionsConfig.maxTextLength */
+    maxTextLength?: number;
+    /** @inheritdoc ParseOptionsConfig.visibleOnly */
+    visibleOnly?: boolean;
+    /** @inheritdoc ParseOptionsConfig.root */
+    root?: HTMLElement;
+}
+interface FormatEnrichedContextOptions {
+    /** When `simple`, ignore {@link EnrichedPageElement.formattedSummary}. Default: structured */
+    mode?: DomContextMode;
+}
+/** Default structured rules: commerce-style cards and generic search/result rows. */
+declare const defaultParseRules: ParseRule[];
+/**
+ * Generate a stable, unique CSS selector for an element.
+ * Priority: #id → [data-testid]/[data-product] → tag.classes with :nth-of-type()
+ */
+declare function generateStableSelector(el: HTMLElement): string;
+/**
+ * Collect enriched page context from the DOM.
+ *
+ * - **Default (structured):** walks up to `maxCandidates` nodes, scores with
+ *   {@link defaultParseRules} (or `rules`), suppresses redundant descendants when a
+ *   formatting rule matches, then keeps the top `maxElements` by score (DOM order tie-break).
+ * - **simple:** legacy path — stops once `maxElements` nodes are collected during traversal
+ *   and sorts interactive before static.
+ *
+ * Pass `options: { mode: "simple" }` to disable rules. If `mode` is `simple` and `rules` is
+ * non-empty, rules are ignored and a console warning is emitted.
+ */
+declare function collectEnrichedPageContext(options?: DomContextOptions): EnrichedPageElement[];
+/**
+ * Format enriched page elements as a structured string for LLM consumption.
+ * When `mode` is structured (default) and elements include {@link EnrichedPageElement.formattedSummary},
+ * those render under **Structured summaries** before the usual interactivity groups.
+ */
+declare function formatEnrichedContext(elements: EnrichedPageElement[], options?: FormatEnrichedContextOptions): string;
+
 /**
  * Attachment Manager
  *
@@ -3410,6 +3943,9 @@ declare function generateUserMessageId(): string;
  */
 declare function generateAssistantMessageId(): string;
 
+declare const isDockedMountMode: (config?: AgentWidgetConfig) => boolean;
+declare const resolveDockConfig: (config?: AgentWidgetConfig) => Required<AgentWidgetDockConfig>;
+
 type CodeFormat = "esm" | "script-installer" | "script-manual" | "script-advanced" | "react-component" | "react-advanced";
 /**
  * Hook code templates for code generation.
@@ -3578,6 +4114,538 @@ declare class PluginRegistry {
 }
 declare const pluginRegistry: PluginRegistry;
 
+type TokenType = 'color' | 'spacing' | 'typography' | 'shadow' | 'border' | 'radius';
+type TokenReference<_T extends TokenType = TokenType> = string;
+interface ColorShade {
+    50?: string;
+    100?: string;
+    200?: string;
+    300?: string;
+    400?: string;
+    500?: string;
+    600?: string;
+    700?: string;
+    800?: string;
+    900?: string;
+    950?: string;
+    [key: string]: string | undefined;
+}
+interface ColorPalette {
+    gray: ColorShade;
+    primary: ColorShade;
+    secondary: ColorShade;
+    accent: ColorShade;
+    success: ColorShade;
+    warning: ColorShade;
+    error: ColorShade;
+    [key: string]: ColorShade;
+}
+interface SpacingScale {
+    0: string;
+    1: string;
+    2: string;
+    3: string;
+    4: string;
+    5: string;
+    6: string;
+    8: string;
+    10: string;
+    12: string;
+    16: string;
+    20: string;
+    24: string;
+    32: string;
+    40: string;
+    48: string;
+    56: string;
+    64: string;
+    [key: string]: string;
+}
+interface ShadowScale {
+    none: string;
+    sm: string;
+    md: string;
+    lg: string;
+    xl: string;
+    '2xl': string;
+    [key: string]: string;
+}
+interface BorderScale {
+    none: string;
+    sm: string;
+    md: string;
+    lg: string;
+    [key: string]: string;
+}
+interface RadiusScale {
+    none: string;
+    sm: string;
+    md: string;
+    lg: string;
+    xl: string;
+    full: string;
+    [key: string]: string;
+}
+interface TypographyScale {
+    fontFamily: {
+        sans: string;
+        serif: string;
+        mono: string;
+    };
+    fontSize: {
+        xs: string;
+        sm: string;
+        base: string;
+        lg: string;
+        xl: string;
+        '2xl': string;
+        '3xl': string;
+        '4xl': string;
+    };
+    fontWeight: {
+        normal: string;
+        medium: string;
+        semibold: string;
+        bold: string;
+    };
+    lineHeight: {
+        tight: string;
+        normal: string;
+        relaxed: string;
+    };
+}
+interface SemanticColors {
+    primary: TokenReference<'color'>;
+    secondary: TokenReference<'color'>;
+    accent: TokenReference<'color'>;
+    surface: TokenReference<'color'>;
+    background: TokenReference<'color'>;
+    container: TokenReference<'color'>;
+    text: TokenReference<'color'>;
+    textMuted: TokenReference<'color'>;
+    textInverse: TokenReference<'color'>;
+    border: TokenReference<'color'>;
+    divider: TokenReference<'color'>;
+    interactive: {
+        default: TokenReference<'color'>;
+        hover: TokenReference<'color'>;
+        focus: TokenReference<'color'>;
+        active: TokenReference<'color'>;
+        disabled: TokenReference<'color'>;
+    };
+    feedback: {
+        success: TokenReference<'color'>;
+        warning: TokenReference<'color'>;
+        error: TokenReference<'color'>;
+        info: TokenReference<'color'>;
+    };
+}
+interface SemanticSpacing {
+    xs: TokenReference<'spacing'>;
+    sm: TokenReference<'spacing'>;
+    md: TokenReference<'spacing'>;
+    lg: TokenReference<'spacing'>;
+    xl: TokenReference<'spacing'>;
+    '2xl': TokenReference<'spacing'>;
+}
+interface SemanticTypography {
+    fontFamily: TokenReference<'typography'>;
+    fontSize: TokenReference<'typography'>;
+    fontWeight: TokenReference<'typography'>;
+    lineHeight: TokenReference<'typography'>;
+}
+interface SemanticTokens {
+    colors: SemanticColors;
+    spacing: SemanticSpacing;
+    typography: SemanticTypography;
+}
+interface ComponentTokenSet {
+    background?: TokenReference<'color'>;
+    foreground?: TokenReference<'color'>;
+    border?: TokenReference<'color'>;
+    borderRadius?: TokenReference<'radius'>;
+    padding?: TokenReference<'spacing'>;
+    margin?: TokenReference<'spacing'>;
+    shadow?: TokenReference<'shadow'>;
+    opacity?: number;
+}
+interface ButtonTokens extends ComponentTokenSet {
+    primary: ComponentTokenSet;
+    secondary: ComponentTokenSet;
+    ghost: ComponentTokenSet;
+}
+interface InputTokens extends ComponentTokenSet {
+    background: TokenReference<'color'>;
+    placeholder: TokenReference<'color'>;
+    focus: {
+        border: TokenReference<'color'>;
+        ring: TokenReference<'color'>;
+    };
+}
+interface LauncherTokens extends ComponentTokenSet {
+    size: string;
+    iconSize: string;
+    shadow: TokenReference<'shadow'>;
+}
+interface PanelTokens extends ComponentTokenSet {
+    width: string;
+    maxWidth: string;
+    height: string;
+    maxHeight: string;
+}
+interface HeaderTokens extends ComponentTokenSet {
+    background: TokenReference<'color'>;
+    border: TokenReference<'color'>;
+    borderRadius: TokenReference<'radius'>;
+}
+interface MessageTokens {
+    user: {
+        background: TokenReference<'color'>;
+        text: TokenReference<'color'>;
+        borderRadius: TokenReference<'radius'>;
+    };
+    assistant: {
+        background: TokenReference<'color'>;
+        text: TokenReference<'color'>;
+        borderRadius: TokenReference<'radius'>;
+        /** Assistant bubble border color (CSS color). */
+        border?: TokenReference<'color'>;
+        /** Assistant bubble box-shadow (token ref or raw CSS, e.g. `none`). */
+        shadow?: string;
+    };
+}
+interface MarkdownTokens {
+    inlineCode: {
+        background: TokenReference<'color'>;
+        foreground: TokenReference<'color'>;
+    };
+    /** Foreground for `<a>` in rendered markdown (assistant bubbles + artifact pane). */
+    link?: {
+        foreground: TokenReference<'color'>;
+    };
+    /**
+     * Body font for rendered markdown blocks (artifact pane + markdown bubbles).
+     * Use a raw CSS `font-family` value, e.g. `Georgia, serif`.
+     */
+    prose?: {
+        fontFamily?: string;
+    };
+    /** Optional heading scale overrides (raw CSS or resolvable token paths). */
+    heading?: {
+        h1?: {
+            fontSize?: string;
+            fontWeight?: string;
+        };
+        h2?: {
+            fontSize?: string;
+            fontWeight?: string;
+        };
+    };
+}
+interface VoiceTokens {
+    recording: {
+        indicator: TokenReference<'color'>;
+        background: TokenReference<'color'>;
+        border: TokenReference<'color'>;
+    };
+    processing: {
+        icon: TokenReference<'color'>;
+        background: TokenReference<'color'>;
+    };
+    speaking: {
+        icon: TokenReference<'color'>;
+    };
+}
+interface ApprovalTokens {
+    requested: {
+        background: TokenReference<'color'>;
+        border: TokenReference<'color'>;
+        text: TokenReference<'color'>;
+    };
+    approve: ComponentTokenSet;
+    deny: ComponentTokenSet;
+}
+interface AttachmentTokens {
+    image: {
+        background: TokenReference<'color'>;
+        border: TokenReference<'color'>;
+    };
+}
+interface ComponentTokens {
+    button: ButtonTokens;
+    input: InputTokens;
+    launcher: LauncherTokens;
+    panel: PanelTokens;
+    header: HeaderTokens;
+    message: MessageTokens;
+    /** Markdown surfaces (chat + artifact pane). */
+    markdown?: MarkdownTokens;
+    voice: VoiceTokens;
+    approval: ApprovalTokens;
+    attachment: AttachmentTokens;
+}
+interface PaletteExtras {
+    transitions?: Record<string, string>;
+    easings?: Record<string, string>;
+}
+interface PersonaThemeBase {
+    palette: {
+        colors: ColorPalette;
+        spacing: SpacingScale;
+        typography: TypographyScale;
+        shadows: ShadowScale;
+        borders: BorderScale;
+        radius: RadiusScale;
+    } & PaletteExtras;
+}
+interface PersonaThemeSemantic {
+    semantic: SemanticTokens;
+}
+interface PersonaThemeComponents {
+    components: ComponentTokens;
+}
+type PersonaTheme = PersonaThemeBase & PersonaThemeSemantic & PersonaThemeComponents;
+interface ResolvedToken {
+    path: string;
+    value: string;
+    type: TokenType;
+}
+interface ThemeValidationError {
+    path: string;
+    message: string;
+    severity: 'error' | 'warning';
+}
+interface ThemeValidationResult {
+    valid: boolean;
+    errors: ThemeValidationError[];
+    warnings: ThemeValidationError[];
+}
+interface PersonaThemePlugin {
+    name: string;
+    version: string;
+    transform(theme: PersonaTheme): PersonaTheme;
+    cssVariables?: Record<string, string>;
+    afterResolve?(resolved: Record<string, string>): Record<string, string>;
+}
+interface CreateThemeOptions {
+    plugins?: PersonaThemePlugin[];
+    validate?: boolean;
+    extend?: PersonaTheme;
+}
+
+declare const DEFAULT_PALETTE: {
+    colors: {
+        primary: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+            950: string;
+        };
+        secondary: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+            950: string;
+        };
+        accent: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+            950: string;
+        };
+        gray: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+            950: string;
+        };
+        success: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+        };
+        warning: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+        };
+        error: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+        };
+    };
+    spacing: {
+        0: string;
+        1: string;
+        2: string;
+        3: string;
+        4: string;
+        5: string;
+        6: string;
+        8: string;
+        10: string;
+        12: string;
+        16: string;
+        20: string;
+        24: string;
+        32: string;
+        40: string;
+        48: string;
+        56: string;
+        64: string;
+    };
+    typography: {
+        fontFamily: {
+            sans: string;
+            serif: string;
+            mono: string;
+        };
+        fontSize: {
+            xs: string;
+            sm: string;
+            base: string;
+            lg: string;
+            xl: string;
+            '2xl': string;
+            '3xl': string;
+            '4xl': string;
+        };
+        fontWeight: {
+            normal: string;
+            medium: string;
+            semibold: string;
+            bold: string;
+        };
+        lineHeight: {
+            tight: string;
+            normal: string;
+            relaxed: string;
+        };
+    };
+    shadows: {
+        none: string;
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+        '2xl': string;
+    };
+    borders: {
+        none: string;
+        sm: string;
+        md: string;
+        lg: string;
+    };
+    radius: {
+        none: string;
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+        '2xl': string;
+        full: string;
+    };
+};
+declare const DEFAULT_SEMANTIC: SemanticTokens;
+declare const DEFAULT_COMPONENTS: ComponentTokens;
+declare function resolveTokens(theme: PersonaTheme): Record<string, ResolvedToken>;
+declare function validateTheme(theme: Partial<PersonaTheme>): ThemeValidationResult;
+declare function createTheme(userConfig?: Partial<PersonaTheme>, options?: CreateThemeOptions): PersonaTheme;
+declare function themeToCssVariables(theme: PersonaTheme): Record<string, string>;
+
+type ColorScheme = 'light' | 'dark' | 'auto';
+interface PersonaWidgetConfig {
+    theme?: Partial<PersonaTheme>;
+    darkTheme?: Partial<PersonaTheme>;
+    colorScheme?: ColorScheme;
+}
+type WidgetConfig = PersonaWidgetConfig | AgentWidgetConfig;
+declare const detectColorScheme: () => "light" | "dark";
+declare const getColorScheme: (config?: WidgetConfig) => "light" | "dark";
+declare const getActiveTheme: (config?: WidgetConfig) => PersonaTheme;
+declare const applyThemeVariables: (element: HTMLElement, config?: WidgetConfig) => void;
+declare const createThemeObserver: (callback: (scheme: "light" | "dark") => void) => (() => void);
+
+declare function accessibilityPlugin(): PersonaThemePlugin;
+declare function animationsPlugin(): PersonaThemePlugin;
+declare function brandPlugin(brandConfig: {
+    colors?: {
+        primary?: string;
+        secondary?: string;
+        accent?: string;
+    };
+    logo?: string;
+}): PersonaThemePlugin;
+declare function reducedMotionPlugin(): PersonaThemePlugin;
+declare function highContrastPlugin(): PersonaThemePlugin;
+declare function createPlugin(config: {
+    name: string;
+    version: string;
+    transform?: (theme: PersonaTheme) => PersonaTheme;
+    cssVariables?: Record<string, string>;
+    afterResolve?: (resolved: Record<string, string>) => Record<string, string>;
+}): PersonaThemePlugin;
+
+interface V1ToV2MigrationOptions {
+    warn?: boolean;
+    colorScheme?: 'light' | 'dark' | 'auto';
+}
+declare function migrateV1Theme(v1Theme: AgentWidgetTheme | undefined, options?: V1ToV2MigrationOptions): Partial<PersonaTheme>;
+declare function validateV1Theme(v1Theme: unknown): {
+    valid: boolean;
+    warnings: string[];
+};
+
 /**
  * Context provided to component renderers
  */
@@ -3684,6 +4752,12 @@ declare const createTypingIndicator: () => HTMLElement;
 declare const renderLoadingIndicatorWithFallback: (location: "inline" | "standalone", customRenderer?: LoadingIndicatorRenderer, widgetConfig?: AgentWidgetConfig) => HTMLElement | null;
 /**
  * Create message action buttons (copy, upvote, downvote)
+ *
+ * This is a pure rendering function. It creates button elements with the
+ * correct `data-action` attributes, icons, and CSS classes. All click
+ * handling, vote state management, clipboard logic, and callback dispatch
+ * is handled via event delegation in `ui.ts` so that handlers survive
+ * idiomorph DOM morphing.
  */
 declare const createMessageActions: (message: AgentWidgetMessage, actionsConfig: AgentWidgetMessageActionsConfig, _callbacks?: MessageActionCallbacks) => HTMLElement;
 /**
@@ -3828,6 +4902,9 @@ interface HeaderLayoutContext {
     showClose?: boolean;
     onClose?: () => void;
     onClearChat?: () => void;
+    /** Passed from `buildHeaderWithLayout` for minimal/default chrome extensions */
+    layoutHeaderConfig?: AgentWidgetHeaderLayoutConfig;
+    onHeaderAction?: (actionId: string) => void;
 }
 type HeaderLayoutRenderer = (context: HeaderLayoutContext) => HeaderElements;
 /**
@@ -3835,16 +4912,7 @@ type HeaderLayoutRenderer = (context: HeaderLayoutContext) => HeaderElements;
  * Full header with icon, title, subtitle, clear chat, and close button
  */
 declare const buildDefaultHeader: HeaderLayoutRenderer;
-/**
- * Build minimal header layout
- * Simplified layout with just title and close button
- */
 declare const buildMinimalHeader: HeaderLayoutRenderer;
-/**
- * Build expanded header layout
- * Full branding area with additional space for custom content
- */
-declare const buildExpandedHeader: HeaderLayoutRenderer;
 /**
  * Header layout registry
  * Maps layout names to their renderer functions
@@ -3864,4 +4932,4 @@ declare function createVoiceProvider(config: VoiceConfig): VoiceProvider;
 declare function createBestAvailableVoiceProvider(config?: Partial<VoiceConfig>): VoiceProvider;
 declare function isVoiceSupported(config?: Partial<VoiceConfig>): boolean;
 
-export { type AgentConfig, type AgentExecutionState, type AgentLoopConfig, type AgentMessageMetadata, type AgentRequestOptions, type AgentWidgetAgentRequestPayload, type AgentWidgetApproval, type AgentWidgetApprovalConfig, type AgentWidgetAttachmentsConfig, type AgentWidgetAvatarConfig, AgentWidgetClient, type AgentWidgetConfig, type AgentWidgetController, type AgentWidgetControllerEventMap, type AgentWidgetCustomFetch, 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 AgentWidgetPlugin, type AgentWidgetRequestPayload, type AgentWidgetSSEEventParser, type AgentWidgetSSEEventResult, AgentWidgetSession, type AgentWidgetSessionStatus, type AgentWidgetStreamParser, type AgentWidgetStreamParserResult, type AgentWidgetTheme, type AgentWidgetTimestampConfig, AttachmentManager, type AttachmentManagerConfig, type CSATFeedbackOptions, type ClientChatRequest, type ClientFeedbackRequest, type ClientFeedbackType, type ClientInitResponse, type ClientSession, type CodeFormat, type CodeGeneratorHooks, type CodeGeneratorOptions, type ComponentContext, type ComponentDirective, type ComponentRenderer, type ComposerBuildContext, type ComposerElements, type ContentPart, type CreateStandardBubbleOptions, DEFAULT_DARK_THEME, DEFAULT_LIGHT_THEME, DEFAULT_WIDGET_CONFIG, type EventStreamBadgeColor, type EventStreamConfig, type EventStreamPayloadRenderContext, type EventStreamRowRenderContext, type EventStreamToolbarRenderContext, type EventStreamViewRenderContext, type HeaderBuildContext, type HeaderElements, type HeaderLayoutContext, type HeaderLayoutRenderer, type HeaderRenderContext, type IdleIndicatorRenderContext, type ImageContentPart, type InjectAssistantMessageOptions, type InjectMessageOptions, type InjectSystemMessageOptions, type InjectUserMessageOptions, type LoadingIndicatorRenderContext, type LoadingIndicatorRenderer, type MarkdownProcessorOptions, type MessageActionCallbacks, type MessageContent, type MessageRenderContext, type MessageTransform, type NPSFeedbackOptions, type PendingAttachment, type SSEEventCallback, type SSEEventRecord, type SlotRenderContext, type SlotRenderer, type TextContentPart, VERSION, type VoiceConfig, type VoiceProvider, type VoiceResult, type VoiceStatus, type WidgetLayoutSlot, attachHeaderToContainer, buildComposer, buildDefaultHeader, buildExpandedHeader, buildHeader, buildHeaderWithLayout, buildMinimalHeader, componentRegistry, createActionManager, createAgentExperience, createBestAvailableVoiceProvider, createBubbleWithLayout, createCSATFeedback, createComponentMiddleware, createComponentStreamParser, createDirectivePostprocessor, createFlexibleJsonStreamParser, createImagePart, createJsonStreamParser, createLocalStorageAdapter, createMarkdownProcessor, createMarkdownProcessorFromConfig, createMessageActions, createNPSFeedback, createPlainTextParser, createRegexJsonParser, createStandardBubble, createTextPart, createTypingIndicator, createVoiceProvider, createXmlParser, initAgentWidget as default, defaultActionHandlers, defaultJsonActionParser, directivePostprocessor, escapeHtml, extractComponentDirectiveFromMessage, fileToImagePart, generateAssistantMessageId, generateCodeSnippet, generateMessageId, generateUserMessageId, getDisplayText, getHeaderLayout, getImageParts, hasComponentDirective, hasImages, headerLayouts, initAgentWidget, isComponentDirectiveType, isVoiceSupported, markdownPostprocessor, mergeWithDefaults, normalizeContent, pluginRegistry, renderComponentDirective, renderLoadingIndicatorWithFallback, validateImageFile };
+export { type AgentConfig, type AgentExecutionState, type AgentLoopConfig, type AgentMessageMetadata, type AgentRequestOptions, type AgentToolsConfig, type AgentWidgetAgentRequestPayload, type AgentWidgetApproval, type AgentWidgetApprovalConfig, type AgentWidgetArtifactsFeature, type AgentWidgetArtifactsLayoutConfig, type AgentWidgetAttachmentsConfig, type AgentWidgetAvatarConfig, AgentWidgetClient, type AgentWidgetComposerConfig, type AgentWidgetConfig, 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 AgentWidgetPlugin, type AgentWidgetRequestPayload, type AgentWidgetSSEEventParser, type AgentWidgetSSEEventResult, AgentWidgetSession, type AgentWidgetSessionStatus, type AgentWidgetStreamParser, type AgentWidgetStreamParserResult, type AgentWidgetTheme, type AgentWidgetTimestampConfig, type ArtifactConfigPayload, AttachmentManager, type AttachmentManagerConfig, type BorderScale, type CSATFeedbackOptions, type ClientChatRequest, type ClientFeedbackRequest, type ClientFeedbackType, type ClientInitResponse, type ClientSession, type CodeFormat, type CodeGeneratorHooks, type CodeGeneratorOptions, type ColorPalette, type ColorShade, type ComponentContext, type ComponentDirective, type ComponentRenderer, type ComponentTokens, type ComposerBuildContext, type ComposerElements, type ContentPart, type CreateStandardBubbleOptions, type CreateThemeOptions, DEFAULT_COMPONENTS, DEFAULT_DARK_THEME, DEFAULT_LIGHT_THEME, DEFAULT_PALETTE, DEFAULT_SEMANTIC, DEFAULT_WIDGET_CONFIG, type DomContextMode, type DomContextOptions, 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 IdleIndicatorRenderContext, type ImageContentPart, type InjectAssistantMessageOptions, type InjectMessageOptions, type InjectSystemMessageOptions, type InjectUserMessageOptions, type LoadingIndicatorRenderContext, type LoadingIndicatorRenderer, type MarkdownProcessorOptions, type MessageActionCallbacks, type MessageContent, type MessageRenderContext, type MessageTransform, type NPSFeedbackOptions, type ParseOptionsConfig, type ParseRule, type PendingAttachment, type PersonaArtifactKind, type PersonaArtifactManualUpsert, type PersonaArtifactRecord, type PersonaTheme, type PersonaThemePlugin, type RadiusScale, type RuleScoringContext, type SSEEventCallback, type SSEEventRecord, type SemanticColors, type SemanticSpacing, type SemanticTypography, type ShadowScale, type SlotRenderContext, type SlotRenderer, type SpacingScale, type TextContentPart, type ThemeValidationError, type ThemeValidationResult, type TokenReference, type TypographyScale, VERSION, type VoiceConfig, type VoiceProvider, type VoiceResult, type VoiceStatus, type WidgetHostLayout, type WidgetHostLayoutMode, type WidgetLayoutSlot, accessibilityPlugin, animationsPlugin, applyThemeVariables, attachHeaderToContainer, brandPlugin, buildComposer, buildDefaultHeader, buildHeader, buildHeaderWithLayout, buildMinimalHeader, collectEnrichedPageContext, componentRegistry, createActionManager, createAgentExperience, createBestAvailableVoiceProvider, createBubbleWithLayout, createCSATFeedback, createComponentMiddleware, createComponentStreamParser, createDirectivePostprocessor, createFlexibleJsonStreamParser, createImagePart, createJsonStreamParser, createLocalStorageAdapter, createMarkdownProcessor, createMarkdownProcessorFromConfig, createMessageActions, createNPSFeedback, createPlainTextParser, createPlugin, createRegexJsonParser, createStandardBubble, createTextPart, createTheme, createThemeObserver, createTypingIndicator, createVoiceProvider, createWidgetHostLayout, createXmlParser, initAgentWidget as default, defaultActionHandlers, defaultJsonActionParser, defaultParseRules, detectColorScheme, directivePostprocessor, escapeHtml, extractComponentDirectiveFromMessage, fileToImagePart, formatEnrichedContext, generateAssistantMessageId, generateCodeSnippet, generateMessageId, generateStableSelector, generateUserMessageId, getActiveTheme, getColorScheme, getDisplayText, getHeaderLayout, getImageParts, hasComponentDirective, hasImages, headerLayouts, highContrastPlugin, initAgentWidget, isComponentDirectiveType, isDockedMountMode, isVoiceSupported, markdownPostprocessor, mergeWithDefaults, migrateV1Theme, normalizeContent, pluginRegistry, reducedMotionPlugin, renderComponentDirective, renderLoadingIndicatorWithFallback, resolveDockConfig, resolveTokens, themeToCssVariables, validateImageFile, validateTheme, validateV1Theme };