@runtypelabs/persona 3.34.1 → 3.35.0

package/dist/theme-editor.d.cts

@@ -529,7 +529,7 @@ interface AgentWidgetPlugin {
         defaultRenderer: () => HTMLElement;
         onSubmit: (text: string) => void;
         /**
-         * When true, the assistant stream is active — same moment `session.isStreaming()` becomes true.
+         * 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"`.
          */
@@ -578,14 +578,14 @@ interface AgentWidgetPlugin {
      * Custom renderer for `ask_user_question` tool calls.
      *
      * When a plugin returns an `HTMLElement`, it is inserted into the transcript
-     * in place of the default (which is no transcript bubble — the built-in
+     * in place of the default (which is no transcript bubble: the built-in
      * renders a sheet over the composer). The built-in composer-overlay sheet
      * is suppressed so the plugin's UI fully owns the interaction.
      *
      * Return `null` to fall through to the built-in overlay sheet.
      *
      * The context gives you a pre-parsed `payload` (may be partial while the
-     * tool call is still streaming — check `complete`) and two callbacks:
+     * tool call is still streaming: check `complete`) and two callbacks:
      * `resolve(answer)` resumes the paused LOCAL tool with the user's answer,
      * and `dismiss()` cancels with the sentinel `"(dismissed)"`.
      *
@@ -634,8 +634,8 @@ interface AgentWidgetPlugin {
      *
      * Return an `HTMLElement` to fully own the approval UI, `defaultRenderer()`
      * to render (or wrap) the built-in bubble, or `null` to fall through to the
-     * default. Unlike the built-in bubble — whose Approve/Deny buttons are wired
-     * via delegation — a fully custom element resolves the approval by calling
+     * default. Unlike the built-in bubble: whose Approve/Deny buttons are wired
+     * via delegation: a fully custom element resolves the approval by calling
      * the `approve`/`deny` callbacks. Both route through the same path the
      * built-in buttons use (optimistic update, `onDecision`, in-place anchoring).
      *
@@ -1026,6 +1026,7 @@ type RuntypeFlowSSEEvent = {
     totalSteps?: number;
     type: "flow_start";
 } | {
+    claudeManagedAgentId?: string;
     completedAt?: string;
     completedSteps?: number;
     duration?: number;
@@ -1140,6 +1141,7 @@ type RuntypeFlowSSEEvent = {
         toolId: string;
     };
     type: "step_complete";
+    unresolvedVariables?: Array<string>;
 }) | {
     error: string;
     executionId?: string;
@@ -1473,7 +1475,7 @@ type AgentConfig = {
     temperature?: number;
     /** Tool configuration for the agent */
     tools?: AgentToolsConfig;
-    /** Persona artifacts — sibling of tools (virtual agent / API parity) */
+    /** Persona artifacts: sibling of tools (virtual agent / API parity) */
     artifacts?: ArtifactConfigPayload;
     /** Loop configuration for multi-turn execution */
     loopConfig?: AgentLoopConfig;
@@ -1495,7 +1497,7 @@ type AgentRequestOptions = {
  * Wire shape for a single client-discovered tool sent on `dispatch.clientTools[]`.
  *
  * Mirrors the SDK's `ClientToolDefinition` in `@runtypelabs/sdk`. Only the
- * JSON-serializable surface of a WebMCP tool — the `execute` function stays
+ * JSON-serializable surface of a WebMCP tool: the `execute` function stays
  * client-side; the server merges these into the agent's tool catalog under
  * the `webmcp:` namespace.
  */
@@ -1503,16 +1505,16 @@ type ClientToolDefinition = {
     /** Bare tool name; the server prepends `webmcp:` on the wire. */
     name: string;
     description: string;
-    /** JSON Schema (per WebMCP spec) — passed through as-is. */
+    /** JSON Schema (per WebMCP spec): passed through as-is. */
     parametersSchema?: object;
     /**
      * `'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
+     * 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. */
+    /** Origin of the page that registered the tool: for server-side audit. */
     pageOrigin?: string;
     /**
      * WebMCP `Tool.annotations` (spec). Not used for gating server-side; the
@@ -1544,7 +1546,7 @@ type WebMcpConfirmInfo = {
         untrustedContentHint?: boolean;
     };
     /**
-     * Why the confirm was requested. Currently always `'gate'` — the default
+     * Why the confirm was requested. Currently always `'gate'`: the default
      * confirm-by-default gate that fires before every `webmcp:*` call. (The
      * `@mcp-b/webmcp-polyfill` owns the spec's `requestUserInteraction` callback
      * internally, so Persona no longer surfaces a nested in-tool confirm.)
@@ -1558,7 +1560,7 @@ type WebMcpConfirmHandler = (info: WebMcpConfirmInfo) => Promise<boolean>;
 /**
  * Widget-level WebMCP configuration. Set `enabled: true` to opt in. The
  * surface's server-side `webmcp` policy is the source of truth for which
- * tools are accepted — these client-side options are convenience filters.
+ * tools are accepted: these client-side options are convenience filters.
  */
 type AgentWidgetWebMcpConfig = {
     /** Master switch. Default: `false` (widget never installs the polyfill). */
@@ -1574,7 +1576,7 @@ type AgentWidgetWebMcpConfig = {
      * `webmcp:*` call; return `true` to approve immediately and skip the
      * confirmation UI entirely. Use this to auto-allow read-only tools (e.g.
      * a catalog search) while still gating mutating ones. Only consulted on
-     * the default-UI path — a custom `onConfirm` takes full control instead.
+     * the default-UI path: a custom `onConfirm` takes full control instead.
      */
     autoApprove?: (info: WebMcpConfirmInfo) => boolean;
     /**
@@ -1617,7 +1619,7 @@ type AgentMessageMetadata = {
      * `flow_await` events for a LOCAL tool (core#3878). Present only when the
      * server emits it. Two PARALLEL calls to the same tool in one turn share a
      * `toolName` (and a collapsed `toolId`) but get DISTINCT `webMcpToolCallId`s,
-     * so this is the key the widget batches a single `/resume` on — preferred
+     * so this is the key the widget batches a single `/resume` on: preferred
      * over tool name, which collides for same-tool parallel calls. Absent →
      * fall back to the legacy name-keyed resume contract.
      */
@@ -1702,15 +1704,6 @@ interface AgentWidgetStorageAdapter {
     save?: (state: AgentWidgetStoredState) => void | Promise<void>;
     clear?: () => void | Promise<void>;
 }
-type AgentWidgetVoiceStateEvent = {
-    active: boolean;
-    source: "user" | "auto" | "restore" | "system";
-    timestamp: number;
-};
-type AgentWidgetActionEventPayload = {
-    action: AgentWidgetParsedAction;
-    message: AgentWidgetMessage;
-};
 /**
  * Feedback event payload for upvote/downvote actions on messages
  */
@@ -1762,6 +1755,14 @@ type AgentWidgetMessageActionsConfig = {
      * @default false
      */
     showDownvote?: boolean;
+    /**
+     * Show a "Read aloud" button that speaks the assistant message via
+     * text-to-speech (play / pause / resume). Uses the browser Web Speech API by
+     * default, or a hosted engine supplied via `textToSpeech.createEngine`.
+     * Voice, rate and pitch are read from the `textToSpeech` config.
+     * @default false
+     */
+    showReadAloud?: boolean;
     /**
      * Visibility mode: 'always' shows buttons always, 'hover' shows on hover only
      * @default 'hover'
@@ -1796,44 +1797,6 @@ type AgentWidgetMessageActionsConfig = {
      */
     onCopy?: (message: AgentWidgetMessage) => void;
 };
-type AgentWidgetStateEvent = {
-    open: boolean;
-    source: "user" | "auto" | "api" | "system";
-    timestamp: number;
-};
-type AgentWidgetStateSnapshot = {
-    open: boolean;
-    launcherEnabled: boolean;
-    voiceActive: boolean;
-    streaming: boolean;
-};
-type AgentWidgetControllerEventMap = {
-    "user:message": AgentWidgetMessage;
-    "assistant:message": AgentWidgetMessage;
-    "assistant:complete": AgentWidgetMessage;
-    "voice:state": AgentWidgetVoiceStateEvent;
-    "action:detected": AgentWidgetActionEventPayload;
-    "action:resubmit": AgentWidgetActionEventPayload;
-    "widget:opened": AgentWidgetStateEvent;
-    "widget:closed": AgentWidgetStateEvent;
-    "widget:state": AgentWidgetStateSnapshot;
-    "message:feedback": AgentWidgetMessageFeedback;
-    "message:copy": AgentWidgetMessage;
-    "eventStream:opened": {
-        timestamp: number;
-    };
-    "eventStream:closed": {
-        timestamp: number;
-    };
-    "approval:requested": {
-        approval: AgentWidgetApproval;
-        message: AgentWidgetMessage;
-    };
-    "approval:resolved": {
-        approval: AgentWidgetApproval;
-        decision: string;
-    };
-};
 /**
  * Layout for the artifact split / drawer (CSS lengths unless noted).
  *
@@ -1874,8 +1837,8 @@ type AgentWidgetArtifactsLayoutConfig = {
     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.
+     * - `'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";
@@ -1889,7 +1852,7 @@ type AgentWidgetArtifactsLayoutConfig = {
      */
     paneBorder?: string;
     /**
-     * `border-left` shorthand only — typical for split view next to chat (with or without resizer).
+     * `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;
@@ -1916,8 +1879,8 @@ type AgentWidgetArtifactsLayoutConfig = {
     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`: "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";
@@ -1929,7 +1892,7 @@ type AgentWidgetArtifactsLayoutConfig = {
      * 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. */
+    /** 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;
@@ -2073,11 +2036,11 @@ type AgentWidgetToolCallDisplayFeature = {
     expandable?: boolean;
     /**
      * Animation mode applied to the tool call header text while the tool is active.
-     * - "none" — static text, no animation
-     * - "pulse" — opacity pulse on the entire header text
-     * - "shimmer" — monochrome opacity sweep per character
-     * - "shimmer-color" — color gradient sweep per character
-     * - "rainbow" — rainbow color cycle per character
+     * - "none": static text, no animation
+     * - "pulse": opacity pulse on the entire header text
+     * - "shimmer": monochrome opacity sweep per character
+     * - "shimmer-color": color gradient sweep per character
+     * - "rainbow": rainbow color cycle per character
      * @default "none"
      */
     loadingAnimation?: AgentWidgetToolCallLoadingAnimation;
@@ -2106,11 +2069,11 @@ type AgentWidgetReasoningDisplayFeature = {
     /**
      * Animation mode applied to the reasoning header text while reasoning is active.
      * Reuses the same modes as tool call animations.
-     * - "none" — static text, no animation
-     * - "pulse" — opacity pulse on the entire header text
-     * - "shimmer" — monochrome opacity sweep per character
-     * - "shimmer-color" — color gradient sweep per character
-     * - "rainbow" — rainbow color cycle per character
+     * - "none": static text, no animation
+     * - "pulse": opacity pulse on the entire header text
+     * - "shimmer": monochrome opacity sweep per character
+     * - "shimmer-color": color gradient sweep per character
+     * - "rainbow": rainbow color cycle per character
      * @default "none"
      */
     loadingAnimation?: AgentWidgetToolCallLoadingAnimation;
@@ -2119,34 +2082,34 @@ type AgentWidgetReasoningDisplayFeature = {
  * Reveal animation applied to assistant message text while it is streaming.
  *
  * Built-in types always available:
- * - `none` — text appears as tokens arrive (default).
- * - `typewriter` — characters fade in with a blinking caret.
- * - `pop-bubble` — the bubble scales in; text streams normally afterward.
- * - `letter-rise` — per-char translateY + fade reveal.
- * - `word-fade` — per-word blur + translateY fade-in.
+ * - `none`: text appears as tokens arrive (default).
+ * - `typewriter`: characters fade in with a blinking caret.
+ * - `pop-bubble`: the bubble scales in; text streams normally afterward.
+ * - `letter-rise`: per-char translateY + fade reveal.
+ * - `word-fade`: per-word blur + translateY fade-in.
  *
  * Subpath plugins (import from `@runtypelabs/persona/animations/*` to register):
  * - `wipe`, `glyph-cycle`.
  *
- * Custom types are allowed — register a plugin with any string name and
+ * Custom types are allowed: register a plugin with any string name and
  * reference it by that name in `type`.
  */
 type AgentWidgetStreamAnimationBuiltinType = "none" | "typewriter" | "word-fade" | "letter-rise" | "glyph-cycle" | "wipe" | "pop-bubble";
 type AgentWidgetStreamAnimationType = AgentWidgetStreamAnimationBuiltinType | (string & {});
 /**
  * Placeholder shown inside a streaming assistant bubble before the first token arrives.
- * - `none` — use the default typing-dots indicator (existing behavior).
- * - `skeleton` — shimmer bars, replaced by streaming content once it starts.
+ * - `none`: use the default typing-dots indicator (existing behavior).
+ * - `skeleton`: shimmer bars, replaced by streaming content once it starts.
  */
 type AgentWidgetStreamAnimationPlaceholder = "none" | "skeleton";
 /**
  * How much of the accumulated streaming content to display while tokens are
  * still arriving. Trimming to a boundary means in-progress words or lines
- * stay hidden until they complete — useful for animations that benefit from
+ * stay hidden until they complete: useful for animations that benefit from
  * unit-complete reveals (e.g. wipe, glyph-cycle).
- * - `none` — show every character as it arrives (default).
- * - `word` — trim to the last whitespace boundary.
- * - `line` — trim to the last newline boundary.
+ * - `none`: show every character as it arrives (default).
+ * - `word`: trim to the last whitespace boundary.
+ * - `line`: trim to the last newline boundary.
  */
 type AgentWidgetStreamAnimationBuffer = "none" | "word" | "line";
 /**
@@ -2177,7 +2140,7 @@ type StreamAnimationContext = {
  *   widget's style host.
  * - For each streaming assistant message whose `type` matches `name`, the
  *   widget applies `containerClass` / `bubbleClass`, wraps text per `wrap`,
- *   and — if `useCaret` is true — appends a blinking caret.
+ *   and, if `useCaret` is true, appends a blinking caret.
  * - Hooks fire after the live DOM is morphed; plugins use stable element IDs
  *   and `data-preserve-animation` to safely mutate per-char or per-word spans
  *   without idiomorph clobbering in-flight work.
@@ -2193,7 +2156,7 @@ type StreamAnimationPlugin = {
     wrap?: "none" | "char" | "word";
     /**
      * HTML tags whose descendant text is skipped during wrapping. Defaults to
-     * `["pre", "code", "a", "script", "style"]` — useful for keeping code
+     * `["pre", "code", "a", "script", "style"]`: useful for keeping code
      * blocks legible and link click-targets intact. Plugins that want to
      * animate characters inside inline code (e.g. `glyph-cycle`) can narrow
      * the list.
@@ -2222,8 +2185,7 @@ type StreamAnimationPlugin = {
     /**
      * Report whether the plugin still has in-flight animation work for a
      * message. When `true`, the widget keeps rendering the message in its
-     * "streaming-animated" mode even after `message.streaming` flips false —
-     * preventing the final non-animated render from yanking the rug out from
+     * "streaming-animated" mode even after `message.streaming` flips false:   * preventing the final non-animated render from yanking the rug out from
      * under unfinished per-char cycles or reveals.
      */
     isAnimating?: (message: AgentWidgetMessage) => boolean;
@@ -2236,7 +2198,7 @@ type AgentWidgetStreamAnimationFeature = {
     /**
      * Per-unit animation duration (ms) for `typewriter`, `letter-rise`, `word-fade`,
      * and per-unit plugin animations. Each arriving character/word animates from
-     * invisible to visible over this duration, independent of its position — the
+     * invisible to visible over this duration, independent of its position: the
      * streaming cadence itself provides the visible stagger.
      * @default 120
      */
@@ -2296,7 +2258,7 @@ type AgentWidgetFeatureFlags = {
      * 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.
+     * the execution: fire-and-forget, no user input awaited.
      */
     suggestReplies?: AgentWidgetSuggestRepliesFeature;
 };
@@ -2310,14 +2272,14 @@ type AgentWidgetFeatureFlags = {
 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
+     * 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
+     * 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`.
@@ -2333,7 +2295,7 @@ type AskUserQuestionOption = {
     label: string;
     /** Optional long-form description (shown as a subtitle on tap-hover). */
     description?: string;
-    /** Optional rich preview — reserved for future rendering; ignored in v1. */
+    /** Optional rich preview: reserved for future rendering; ignored in v1. */
     preview?: string;
 };
 /**
@@ -2385,14 +2347,14 @@ type AgentWidgetAskUserQuestionFeature = {
     enabled?: boolean;
     /**
      * Advertise the built-in `ask_user_question` tool to the agent on every
-     * dispatch via `clientTools[]` — no server-side `runtimeTools` declaration
+     * 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
+     * Ignored when `enabled` is `false`: never offer the agent a question
      * tool the widget can't render an answer UI for.
      */
     expose?: boolean;
@@ -2413,17 +2375,17 @@ type AgentWidgetAskUserQuestionFeature = {
     /**
      * In grouped (multi-question) mode, auto-advance to the next page after a
      * single-select pill pick or free-text submit on intermediate pages.
-     * Defaults to `true`. The final page never auto-submits — users always
+     * Defaults to `true`. The final page never auto-submits: users always
      * confirm with an explicit "Submit all" click. Multi-select pages always
      * require an explicit Next regardless of this setting.
      */
     groupedAutoAdvance?: boolean;
     /**
      * Visual layout for the option list.
-     * - `"rows"` (default) — full-width stacked rows with always-visible
+     * - `"rows"` (default): full-width stacked rows with always-visible
      *   descriptions, right-edge number badges (single-select) or checkboxes
      *   (multi-select), and an always-visible inline "Other" input.
-     * - `"pills"` — legacy compact pill list with horizontal wrap; description
+     * - `"pills"`: legacy compact pill list with horizontal wrap; description
      *   surfaces as a tooltip and the "Other…" pill expands on click.
      */
     layout?: "rows" | "pills";
@@ -2591,7 +2553,7 @@ type AgentWidgetDockConfig = {
      *
      * - 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
+     *   from the surrounding layout: make sure your page provides a definite
      *   height all the way down to the dock target's parent).
      *
      * @default "100dvh"
@@ -2665,7 +2627,7 @@ type AgentWidgetComposerBarConfig = {
      */
     modalMaxHeight?: string;
     /**
-     * Configuration for the "peek" banner — the chrome-less row above the
+     * Configuration for the "peek" banner: the chrome-less row above the
      * collapsed pill that previews the most recent assistant message.
      */
     peek?: AgentWidgetComposerBarPeekConfig;
@@ -2680,7 +2642,7 @@ type AgentWidgetComposerBarConfig = {
  * - Otherwise the peek inherits from `features.streamAnimation`.
  *
  * Per-surface carve-outs:
- * - `bubbleClass` from a plugin (used by `pop-bubble`) is ignored — the peek
+ * - `bubbleClass` from a plugin (used by `pop-bubble`) is ignored: the peek
  *   has no bubble analog.
  * - `containerClass`, `wrap` ("char" | "word"), `useCaret`, `placeholder`
  *   ("skeleton"), `buffer` ("word" | "line"), `speed`, `duration`, and
@@ -2926,6 +2888,11 @@ type AgentWidgetVoiceRecognitionConfig = {
     /** Button border color while speaking. Inherits idle borderColor if not set */
     speakingBorderColor?: string;
     autoResume?: boolean | "assistant";
+    /**
+     * Called with per-turn latency metrics on the realtime (`runtype`) voice path.
+     * Fires once per turn after the reply completes.
+     */
+    onMetrics?: (metrics: VoiceMetrics) => void;
     provider?: {
         type: 'browser' | 'runtype' | 'custom';
         browser?: {
@@ -2934,15 +2901,31 @@ type AgentWidgetVoiceRecognitionConfig = {
         };
         runtype?: {
             agentId: string;
-            clientToken: string;
+            /** Defaults to the widget's `clientToken` when omitted. */
+            clientToken?: string;
+            /** Defaults to the widget's `apiUrl` when omitted. */
             host?: string;
             voiceId?: string;
-            /** Duration of silence (ms) before auto-stopping recording. Default: 2000 */
+            /**
+             * Optional custom streaming playback engine. Defaults to the built-in
+             * `AudioPlaybackManager`. Import `createWorkletPlaybackEngine` from
+             * `@runtypelabs/persona/voice-worklet-player` for a jitter-buffered engine.
+             */
+            createPlaybackEngine?: () => VoicePlaybackEngine | Promise<VoicePlaybackEngine>;
+            /** @deprecated No-op on the realtime path: the server's STT owns turn-taking. */
             pauseDuration?: number;
-            /** RMS volume threshold below which counts as silence. Default: 0.01 */
+            /** @deprecated No-op on the realtime path: the server's STT owns turn-taking. */
             silenceThreshold?: number;
         };
-        custom?: any;
+        /**
+         * Bring-your-own voice provider. Set `type: 'custom'` and pass either a
+         * ready {@link VoiceProvider} instance or a `() => VoiceProvider` factory
+         * (the factory defers construction until voice is set up). STT-style
+         * providers deliver a final transcript via `onResult` (sent as a user
+         * message); full-duplex providers can drive `onTranscript`/`onMetrics` like
+         * the realtime `runtype` provider.
+         */
+        custom?: VoiceProvider | (() => VoiceProvider);
     };
 };
 /**
@@ -2965,18 +2948,68 @@ type TextToSpeechConfig = {
     enabled: boolean;
     /**
      * TTS provider.
-     * - `'browser'` — Use the Web Speech API for all assistant messages (default).
-     * - `'runtype'` — Server handles TTS for voice interactions.
-     *   Set `browserFallback: true` to also speak text-typed responses via the browser.
+     * - `'browser'`: Use the Web Speech API for all assistant messages (default).
+     * - `'runtype'`: Use Runtype-hosted TTS. The realtime voice path speaks
+     *   replies during a voice call, and the per-message "Read aloud" button (and
+     *   auto-speak of text-typed replies) stream from Runtype's
+     *   `POST {host}/v1/agents/:agentId/speak` endpoint via the built-in
+     *   {@link SpeechEngine}. `host`/`agentId`/`clientToken` are derived from the
+     *   widget config (see `agentId`/`host` below); unless `browserFallback` is
+     *   `false`, a missing endpoint or transient failure falls back to the browser
+     *   voice so the button is never broken.
      */
     provider?: 'browser' | 'runtype';
     /**
-     * When `provider` is `'runtype'`, fall back to browser TTS for assistant
-     * messages that the server didn't already speak (e.g. text-typed messages).
+     * When `provider` is `'runtype'`:
+     * - Read-aloud / auto-speak: acts as a safety net — if Runtype TTS is
+     *   unreachable (no endpoint yet, network/auth failure) or the Runtype config
+     *   is incomplete, speech falls back to the browser Web Speech API instead of
+     *   erroring. Set to `false` to surface Runtype errors instead. **Defaults to
+     *   on for this path.**
+     * - Auto-speak of text-typed replies also requires this to be truthy (the
+     *   realtime voice path already speaks voice-call replies).
+     *
      * Has no effect when provider is `'browser'` (browser TTS is always used).
-     * @default false
      */
     browserFallback?: boolean;
+    /**
+     * When `provider` is `'runtype'`, the agent whose configured voice synthesizes
+     * read-aloud / auto-speak audio. Falls back to
+     * `voiceRecognition.provider.runtype.agentId` when omitted. Required (here or
+     * there) for Runtype TTS to activate; without it the browser voice is used.
+     */
+    agentId?: string;
+    /**
+     * When `provider` is `'runtype'`, the Runtype API host (e.g.
+     * `https://api.runtype.com`). Defaults to the widget's `apiUrl`.
+     */
+    host?: string;
+    /**
+     * When `provider` is `'runtype'`, audio (ms) the streaming player buffers
+     * before the first sample and after an underrun. Lower = snappier start;
+     * higher = rides out delivery hiccups. Default 200. Applies to the default
+     * in-bundle player; a custom `createPlaybackEngine` manages its own prebuffer.
+     */
+    prebufferMs?: number;
+    /**
+     * When `provider` is `'runtype'`, an optional factory for the streaming PCM
+     * player that synthesizes read-aloud / auto-speak audio. Defaults to the
+     * in-bundle, main-thread `AudioPlaybackManager` (smooth for steady Runtype
+     * streams, no AudioWorklet — keeps the widget bundle lean).
+     *
+     * For the higher-quality, jitter-buffered AudioWorklet player, import
+     * `createPcmStreamPlayer` from `@runtypelabs/persona/voice-worklet-player` and
+     * pass it here — it then ships in your bundle, not Persona's:
+     *
+     * @example
+     * import { createPcmStreamPlayer } from '@runtypelabs/persona/voice-worklet-player'
+     * textToSpeech: {
+     *   enabled: true,
+     *   provider: 'runtype',
+     *   createPlaybackEngine: () => createPcmStreamPlayer({ prebufferMs: 400 }),
+     * }
+     */
+    createPlaybackEngine?: () => PcmStreamPlayer | Promise<PcmStreamPlayer>;
     /** Voice name to use for browser TTS (e.g., 'Google US English'). If not found, uses auto-detect. */
     voice?: string;
     /**
@@ -2995,7 +3028,177 @@ type TextToSpeechConfig = {
     rate?: number;
     /** Speech pitch (0 - 2). Default: 1 */
     pitch?: number;
+    /**
+     * Factory for a custom {@link SpeechEngine}, used by both the auto-speak path
+     * and the per-message "Read aloud" action. When omitted, the browser Web
+     * Speech API engine is used. Return a hosted engine here to use server-side
+     * TTS (e.g. Runtype) — such an engine can stream audio through the realtime
+     * voice {@link VoicePlaybackEngine}. May be async (it is resolved on first
+     * playback, inside the user gesture).
+     */
+    createEngine?: () => SpeechEngine | Promise<SpeechEngine>;
 };
+/** A unit of speech handed to a {@link SpeechEngine}. */
+interface SpeechRequest {
+    /** Plain text to speak. The widget strips Markdown before calling the engine. */
+    text: string;
+    /** Preferred voice identifier (engine-specific; browser = voice name). */
+    voice?: string;
+    /** Speech rate (engine-specific range; browser: 0.1–10, default 1). */
+    rate?: number;
+    /** Speech pitch (engine-specific range; browser: 0–2, default 1). */
+    pitch?: number;
+}
+/** Lifecycle callbacks a {@link SpeechEngine} invokes during playback. */
+interface SpeechCallbacks {
+    /** Audio has started playing. */
+    onStart?: () => void;
+    /** Playback finished naturally (or was canceled). */
+    onEnd?: () => void;
+    /** Playback failed. */
+    onError?: (error: Error) => void;
+}
+/**
+ * Pluggable text-to-speech engine behind the "Read aloud" message action.
+ *
+ * The widget ships a browser Web Speech API engine by default. Provide a hosted
+ * engine (Runtype TTS, ElevenLabs, a server proxy, …) by implementing this
+ * interface and returning it from {@link TextToSpeechConfig.createEngine}; a
+ * server engine can stream audio into the realtime voice
+ * {@link VoicePlaybackEngine}.
+ */
+interface SpeechEngine {
+    /** Stable identifier, e.g. `"browser"`, `"runtype"`, or a custom id. */
+    readonly id: string;
+    /**
+     * Whether {@link pause}/{@link resume} are supported. When `false`, the UI
+     * offers play/stop only (tapping a playing message stops it).
+     */
+    readonly supportsPause: boolean;
+    /** Begin speaking. Drives the lifecycle through `callbacks`. */
+    speak(request: SpeechRequest, callbacks: SpeechCallbacks): void;
+    /** Pause playback (no-op if unsupported). */
+    pause(): void;
+    /** Resume paused playback (no-op if unsupported). */
+    resume(): void;
+    /** Stop playback and discard any queued audio. */
+    stop(): void;
+    /** Optional teardown of engine resources. */
+    destroy?(): void;
+}
+/**
+ * Voice recognition result with transcript and optional audio
+ */
+type VoiceResult = {
+    text: string;
+    transcript?: string;
+    audio?: {
+        base64: string;
+        format: 'wav' | 'mp3' | 'ogg' | 'webm';
+        sampleRate: number;
+        duration: number;
+    };
+    confidence?: number;
+    provider: 'runtype' | 'browser' | 'custom';
+};
+/**
+ * Voice provider status states
+ */
+type VoiceStatus = 'disconnected' | 'connected' | 'listening' | 'processing' | 'speaking' | 'error' | 'idle';
+/**
+ * Per-turn latency metrics emitted by the realtime voice path.
+ * The wire frame is snake_case (`metrics`); decoded to camelCase at the
+ * provider boundary before being surfaced through `onMetrics`.
+ */
+type VoiceMetrics = {
+    /** LLM generation time (ms). */
+    llmMs?: number;
+    /** Text-to-speech synthesis time (ms). */
+    ttsMs?: number;
+    /** Time to first audio frame (ms). */
+    firstAudioMs?: number;
+    /** Total turn time (ms). */
+    totalMs?: number;
+};
+/**
+ * Streaming PCM playback engine used by the realtime voice provider.
+ *
+ * The provider feeds raw PCM16 LE mono @ 24kHz (WAV header already stripped)
+ * via `enqueue`, signals end-of-reply with `markStreamEnd`, and learns when
+ * playback has fully drained via `onFinished`. The default implementation is
+ * `AudioPlaybackManager`; an optional jitter-buffered AudioWorklet engine ships
+ * from `@runtypelabs/persona/voice-worklet-player` and can be injected via the
+ * `runtype.createPlaybackEngine` config hook.
+ */
+interface VoicePlaybackEngine {
+    /** Enqueue a raw PCM16 LE mono @ 24kHz chunk (no WAV header). */
+    enqueue(pcm: Uint8Array): void;
+    /** Signal that no more chunks will arrive for the current reply. */
+    markStreamEnd(): void;
+    /** Immediately stop playback and discard queued audio. */
+    flush(): void;
+    /** Register a callback fired once all queued audio has finished playing. */
+    onFinished(callback: () => void): void;
+    /** Release all audio resources. */
+    destroy(): Promise<void> | void;
+}
+/**
+ * A {@link VoicePlaybackEngine} that also supports pause/resume. Returned by
+ * `createPcmStreamPlayer` (`@runtypelabs/persona/voice-worklet-player`): a
+ * jitter-buffered AudioWorklet player for raw PCM16 / 24 kHz / mono streams.
+ * Reuse it inside a hosted {@link SpeechEngine} to get gapless playback with a
+ * configurable prebuffer and graceful underrun handling — feed each streamed
+ * chunk to {@link VoicePlaybackEngine.enqueue} and the worklet does the rest.
+ */
+interface PcmStreamPlayer extends VoicePlaybackEngine {
+    /** Pause playback; the audio clock suspends and {@link resume} continues in place. */
+    pause(): void;
+    /** Resume playback after {@link pause}. */
+    resume(): void;
+    /**
+     * Register a callback fired once audible playback actually begins — i.e. the
+     * prebuffer waterline filled and the first sample reached the output. Use this
+     * (rather than "first chunk enqueued") to flip a UI from loading to playing, so
+     * the spinner holds through the prebuffer. Fires once per playback session
+     * (cleared by {@link VoicePlaybackEngine.flush}); a mid-reply underrun re-buffer
+     * does not re-fire it.
+     */
+    onStarted(callback: () => void): void;
+}
+/**
+ * Voice provider interface
+ * Abstract interface for all voice providers in the Persona SDK
+ */
+interface VoiceProvider {
+    type: 'browser' | 'runtype' | 'custom';
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    startListening(): Promise<void>;
+    stopListening(): Promise<void>;
+    onResult(callback: (result: VoiceResult) => void): void;
+    onError(callback: (error: Error) => void): void;
+    onStatusChange(callback: (status: VoiceStatus) => void): void;
+    /** Register a callback fired when recording stops and audio is about to be sent */
+    onProcessingStart?(callback: () => void): void;
+    /**
+     * Register a callback for incremental transcript updates during a voice turn.
+     * `isFinal=false` is a live interim update (user partials, or assistant deltas
+     * on providers that stream them); `isFinal=true` finalizes that role's text.
+     * On the realtime `runtype` path, interim updates fire for the `user` only and
+     * the `assistant` arrives as a single final.
+     */
+    onTranscript?(callback: (role: 'user' | 'assistant', text: string, isFinal: boolean) => void): void;
+    /** Register a callback for per-turn latency metrics (realtime path). */
+    onMetrics?(callback: (metrics: VoiceMetrics) => 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;
+}
 /**
  * Extra context for an approval decision, surfaced to `onDecision` and to the
  * `approve`/`deny` callbacks passed to the `renderApproval` plugin hook.
@@ -3004,7 +3207,7 @@ type AgentWidgetApprovalDecisionOptions = {
     /**
      * The user chose a "remember this" affordance (e.g. an "Always allow"
      * button) rather than a one-time decision. The widget resolves the *current*
-     * approval identically whether or not this is set — an approval bubble is a
+     * approval identically whether or not this is set: an approval bubble is a
      * single binary gate (`approved`/`denied`). Persisting a don't-ask-again
      * policy for *future* approvals (auto-resolving them, or not surfacing them)
      * is the integrator's responsibility, typically inside `onDecision`.
@@ -3058,9 +3261,9 @@ type AgentWidgetApprovalConfig = {
     /**
      * How the technical details (the tool's agent-facing description and the
      * raw parameters JSON) are presented:
-     * - `"collapsed"` (default) — hidden behind a "Show details" toggle
-     * - `"expanded"` — visible, with the toggle available to hide them
-     * - `"hidden"` — never rendered
+     * - `"collapsed"` (default): hidden behind a "Show details" toggle
+     * - `"expanded"`: visible, with the toggle available to hide them
+     * - `"hidden"`: never rendered
      */
     detailsDisplay?: "collapsed" | "expanded" | "hidden";
     /** Label for the toggle that reveals the technical details */
@@ -3082,7 +3285,7 @@ type AgentWidgetApprovalConfig = {
         displayTitle?: string;
         /**
          * Agent-authored justification for this specific call, when the agent
-         * provided one. It is the agent's own claim — if you fold it into the
+         * provided one. It is the agent's own claim: if you fold it into the
          * summary, keep it attributed to the agent.
          */
         reason?: string;
@@ -3188,7 +3391,7 @@ type AgentWidgetToolCallConfig$1 = {
      *
      * **Placeholders:** `{toolName}` (tool name), `{duration}` (live-updating elapsed time).
      *
-     * **Inline formatting:** `~dim~`, `*italic*`, `**bold**` — parsed at render time and
+     * **Inline formatting:** `~dim~`, `*italic*`, `**bold**`: parsed at render time and
      * applied as styled `<span>` elements. Works with all animation modes.
      *
      * When not set, falls back to the current `collapsedMode` behavior.
@@ -3201,7 +3404,7 @@ type AgentWidgetToolCallConfig$1 = {
      *
      * **Placeholders:** `{toolName}` (tool name), `{duration}` (final elapsed time).
      *
-     * **Inline formatting:** `~dim~`, `*italic*`, `**bold**` — same syntax as `activeTextTemplate`.
+     * **Inline formatting:** `~dim~`, `*italic*`, `**bold**`: same syntax as `activeTextTemplate`.
      *
      * When not set, falls back to the existing "Used tool for X seconds" text.
      * @example "Finished {toolName} ~{duration}~"
@@ -3262,7 +3465,7 @@ type AgentWidgetReasoningConfig = {
      *
      * **Placeholders:** `{duration}` (live-updating elapsed time).
      *
-     * **Inline formatting:** `~dim~`, `*italic*`, `**bold**` — parsed at render time.
+     * **Inline formatting:** `~dim~`, `*italic*`, `**bold**`: parsed at render time.
      *
      * When not set, falls back to the default "Thinking..." text.
      * @example "Thinking... ~{duration}~"
@@ -3273,7 +3476,7 @@ type AgentWidgetReasoningConfig = {
      *
      * **Placeholders:** `{duration}` (final elapsed time).
      *
-     * **Inline formatting:** `~dim~`, `*italic*`, `**bold**` — same syntax as `activeTextTemplate`.
+     * **Inline formatting:** `~dim~`, `*italic*`, `**bold**`: same syntax as `activeTextTemplate`.
      *
      * When not set, falls back to the default "Thought for X seconds" text.
      * @example "Thought for ~{duration}~"
@@ -3372,7 +3575,7 @@ type AgentWidgetSSEEventResult = {
     done?: boolean;
     /** Error message if an error occurred */
     error?: string;
-    /** Text segment identity — when this changes, a new assistant message bubble is created */
+    /** Text segment identity: when this changes, a new assistant message bubble is created */
     partId?: string;
 } | null;
 /**
@@ -4352,7 +4555,7 @@ type AgentWidgetConfig = {
          * Per-stop-reason copy for the inline notice rendered on assistant
          * bubbles when the runtime reports a non-natural stop (e.g. the agent
          * loop hit `max_tool_calls` and was cut off mid-loop). Each key is
-         * optional — keys you omit fall back to the built-in defaults. Set a
+         * optional: keys you omit fall back to the built-in defaults. Set a
          * key to an empty string to suppress the notice for that reason.
          */
         stopReasonNotice?: Partial<Record<StopReasonKind, string>>;
@@ -4445,12 +4648,12 @@ type AgentWidgetConfig = {
      */
     approval?: AgentWidgetApprovalConfig | false;
     /**
-     * WebMCP — consume page-registered tools (`document.modelContext.registerTool`).
+     * WebMCP: consume page-registered tools (`document.modelContext.registerTool`).
      * When `enabled`, the widget installs `@mcp-b/webmcp-polyfill`, snapshots the
      * registry on every dispatch, ships it as `clientTools[]`, and executes
      * returned `webmcp:*` tool calls with confirm-by-default gating.
      *
-     * Server-side policy on the chat surface is the source of truth — these
+     * Server-side policy on the chat surface is the source of truth: these
      * fields layer on top.
      *
      * @example
@@ -4484,7 +4687,7 @@ type AgentWidgetConfig = {
      * This hook runs synchronously and must return the (potentially modified) state.
      *
      * Returning `{ state, open: true }` also signals that the widget panel should
-     * open after initialization — useful when injecting a post-navigation message
+     * open after initialization: useful when injecting a post-navigation message
      * that the user should immediately see.
      *
      * @example
@@ -4803,7 +5006,7 @@ type AgentWidgetConfig = {
      * Setting this to `false` is the explicit kill-switch: it disables UI-state
      * persistence **and** message-history persistence. When `false`, any
      * `storageAdapter` you configure is ignored and the default localStorage
-     * adapter is not created — no chat history is read or written. Pass `true`
+     * adapter is not created: no chat history is read or written. Pass `true`
      * (or omit) to keep the default behavior of persisting messages via the
      * configured `storageAdapter` (or the built-in localStorage adapter).
      *
@@ -4832,7 +5035,7 @@ type AgentWidgetConfig = {
      *
      * @example
      * ```typescript
-     * // Ephemeral widget — no message history written anywhere
+     * // Ephemeral widget: no message history written anywhere
      * config: {
      *   persistState: false
      * }
@@ -4899,7 +5102,7 @@ type AgentWidgetApproval = {
      * Agent-authored justification for this specific call (the agent's own
      * claim about its intent, extracted server-side from the reserved
      * `_approvalReason` parameter). Render it attributed to the agent and as
-     * plain text — it is approver context, not a system statement.
+     * plain text: it is approver context, not a system statement.
      */
     reason?: string;
     parameters?: unknown;
@@ -4909,16 +5112,16 @@ type AgentWidgetMessageVariant = "assistant" | "reasoning" | "tool" | "approval"
 /**
  * Per-turn / per-step stop reason emitted by the runtime on
  * `agent_turn_complete` and `step_complete` SSE events. The vocabulary is
- * owned by the upstream Runtype API — do not extend without coordination.
+ * owned by the upstream Runtype API: do not extend without coordination.
  *
- * - `end_turn` — natural completion (no affordance needed)
- * - `max_tool_calls` — agent loop tripped the configured tool-call ceiling
- * - `length` — provider hit max output tokens
- * - `content_filter` — provider content filter intervened
- * - `error` — provider/runtime error (prefer existing error rendering)
- * - `unknown` — explicitly reported but uninformative
+ * - `end_turn`: natural completion (no affordance needed)
+ * - `max_tool_calls`: agent loop tripped the configured tool-call ceiling
+ * - `length`: provider hit max output tokens
+ * - `content_filter`: provider content filter intervened
+ * - `error`: provider/runtime error (prefer existing error rendering)
+ * - `unknown`: explicitly reported but uninformative
  *
- * Absent (`undefined`) means "not reported" — distinct from `'unknown'`.
+ * Absent (`undefined`) means "not reported": distinct from `'unknown'`.
  */
 type StopReasonKind = RuntypeStopReasonKind;
 /**
@@ -5019,156 +5222,6 @@ type AgentWidgetMessage = {
      */
     stopReason?: StopReasonKind;
 };
-/**
- * Options for injecting a message into the conversation.
- * Supports dual-content where UI display differs from LLM context.
- *
- * @example
- * // Same content for user and LLM
- * {
- *   role: 'assistant',
- *   content: 'Here are your search results...'
- * }
- *
- * @example
- * // Different content: user sees full details, LLM sees summary
- * {
- *   role: 'assistant',
- *   content: '**Found 3 products:**\n- iPhone 15 Pro ($1,199)\n- iPhone 15 ($999)',
- *   llmContent: '[Search results: 3 iPhones, $999-$1199]'
- * }
- */
-type InjectMessageOptions = {
-    /**
-     * Message role: "assistant", "user", or "system"
-     */
-    role: AgentWidgetMessageRole;
-    /**
-     * Content displayed to the user in the chat UI.
-     * This is what appears in the message bubble.
-     */
-    content: string;
-    /**
-     * Content sent to the LLM in API requests.
-     * When omitted, `content` is used for both display and LLM.
-     *
-     * Use cases:
-     * - Redacted content: Show full product details to user, send summary to LLM
-     * - Structured data: Show formatted markdown to user, send JSON to LLM
-     * - Token optimization: Show verbose content to user, send concise version to LLM
-     */
-    llmContent?: string;
-    /**
-     * Multi-modal content parts for the LLM (images, files).
-     * Takes precedence over `llmContent` when present.
-     * The `content` field is still used for UI display.
-     */
-    contentParts?: ContentPart[];
-    /**
-     * Optional message ID. If omitted, auto-generated based on role.
-     */
-    id?: string;
-    /**
-     * Optional creation timestamp (ISO string). If omitted, uses current time.
-     */
-    createdAt?: string;
-    /**
-     * Optional sequence number for ordering.
-     */
-    sequence?: number;
-    /**
-     * Whether the message is still streaming (for incremental updates).
-     * @default false
-     */
-    streaming?: boolean;
-    /**
-     * Mark this message as a voice processing placeholder.
-     * Consumers can detect this in `messageTransform` to render custom UI.
-     */
-    voiceProcessing?: boolean;
-    /**
-     * Raw structured payload (typically a JSON string) representing the
-     * full directive that produced this message — e.g. `{ "text": "...",
-     * "component": "Foo", "props": {...} }`.
-     *
-     * Mirrors the field populated by stream parsers during normal LLM
-     * responses. Set this when injecting a message that should render as a
-     * component directive (`hasComponentDirective` /
-     * `extractComponentDirectiveFromMessage` look at `rawContent` first).
-     *
-     * Priority for the API payload remains:
-     * `contentParts > llmContent > rawContent > content`. Pass `llmContent`
-     * alongside `rawContent` if the LLM should see something other than the
-     * raw directive.
-     */
-    rawContent?: string;
-};
-/**
- * Options for injecting assistant messages (most common case).
- * Role defaults to 'assistant'.
- */
-type InjectAssistantMessageOptions = Omit<InjectMessageOptions, "role">;
-/**
- * Options for injecting user messages.
- * Role defaults to 'user'.
- */
-type InjectUserMessageOptions = Omit<InjectMessageOptions, "role">;
-/**
- * Options for injecting system messages.
- * Role defaults to 'system'.
- */
-type InjectSystemMessageOptions = Omit<InjectMessageOptions, "role">;
-/**
- * Options for injecting an assistant message that renders as a component
- * directive — sugar over `injectAssistantMessage` for the common case of
- * "render this registered component, same as if the LLM had emitted it".
- *
- * Equivalent to calling `injectAssistantMessage({ content: text, rawContent:
- * JSON.stringify({ text, component, props }), llmContent })`.
- *
- * @example
- * widget.injectComponentDirective({
- *   component: "DynamicForm",
- *   props: { title: "Book a demo", fields: [...] },
- *   text: "Share your details to book a demo.",
- *   llmContent: "[Showed booking form]"
- * });
- */
-type InjectComponentDirectiveOptions = {
-    /**
-     * Name of a renderer registered via `componentRegistry.register(...)`.
-     */
-    component: string;
-    /**
-     * Props passed to the component renderer.
-     */
-    props?: Record<string, unknown>;
-    /**
-     * Bubble copy displayed above (or with) the rendered component.
-     * Mirrors the `text` field in a streamed JSON directive.
-     * @default ""
-     */
-    text?: string;
-    /**
-     * Content sent to the LLM in API requests. When omitted, the raw
-     * directive JSON is what the LLM would see (per the standard
-     * priority chain). Provide a redacted/short version to avoid sending
-     * the full directive in subsequent turns.
-     */
-    llmContent?: string;
-    /**
-     * Optional message ID. If omitted, an assistant id is auto-generated.
-     */
-    id?: string;
-    /**
-     * Optional creation timestamp (ISO string). If omitted, uses current time.
-     */
-    createdAt?: string;
-    /**
-     * Optional sequence number for ordering.
-     */
-    sequence?: number;
-};
 type PersonaArtifactRecord = {
     id: string;
     artifactType: PersonaArtifactKind;
@@ -5178,49 +5231,8 @@ type PersonaArtifactRecord = {
     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;
-} | {
-    type: "status";
-    status: "connecting" | "connected" | "error" | "idle";
-} | {
-    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;
-};
 
-/** Field definition types for the declarative configurator system (headless — no DOM) */
+/** Field definition types for the declarative configurator system (headless: no DOM) */
 
 type FieldType = 'color' | 'slider' | 'toggle' | 'select' | 'text' | 'chip-list' | 'color-scale' | 'token-ref' | 'role-assignment';
 interface SliderOptions {
@@ -5413,7 +5425,7 @@ declare class ThemeEditorState {
     private restoreSnapshot;
 }
 
-/** Declarative section/field definitions for the theme editor (pure data — no DOM, no render logic) */
+/** Declarative section/field definitions for the theme editor (pure data: no DOM, no render logic) */
 
 declare const STYLE_SECTIONS: SectionDef[];
 declare const PALETTE_SECTION: SectionDef;
@@ -5426,19 +5438,19 @@ declare const COMPONENT_COLOR_SECTIONS: SectionDef[];
 declare const COMPONENTS_SECTIONS: SectionDef[];
 declare const CONFIGURE_SUB_GROUPS: SubGroupDef[];
 declare const CONFIGURE_SECTIONS: SectionDef[];
-/** Section 1: Theme — color mode selection */
+/** Section 1: Theme: color mode selection */
 declare const THEME_SECTION: SectionDef;
-/** Section 2: Brand Palette — primary colors + collapsed status colors */
+/** Section 2: Brand Palette: primary colors + collapsed status colors */
 declare const BRAND_PALETTE_SECTION: SectionDef;
-/** Section 2b: Status palette — collapsed under Brand Palette */
+/** Section 2b: Status palette: collapsed under Brand Palette */
 declare const STATUS_PALETTE_SECTION: SectionDef;
-/** Section 3: Interface Roles — the main theming surface */
+/** Section 3: Interface Roles: the main theming surface */
 declare const INTERFACE_ROLES_SECTION: SectionDef;
-/** Section 4: Status Colors — feedback semantic tokens */
+/** Section 4: Status Colors: feedback semantic tokens */
 declare const STATUS_COLORS_SECTION: SectionDef;
-/** Section 5: Advanced Tokens — entry point for drill-downs (no fields) */
+/** Section 5: Advanced Tokens: entry point for drill-downs (no fields) */
 declare const ADVANCED_TOKENS_SECTION: SectionDef;
-/** V2 Style tab sections — outcome-oriented editor */
+/** V2 Style tab sections: outcome-oriented editor */
 declare const STYLE_SECTIONS_V2: SectionDef[];
 declare const ALL_TABS: TabDef[];
 type ThemeScope = 'theme' | 'darkTheme';
@@ -5448,7 +5460,7 @@ declare function findSection(sections: SectionDef[], id: string): SectionDef;
 /** Create a light/dark scoped copy of a section */
 declare function scopeSection(section: SectionDef, scope: ThemeScope, variant: ThemeVariant, collapsed?: boolean | undefined): SectionDef;
 
-/** Theme editor presets — unified collection of built-in presets */
+/** Theme editor presets: unified collection of built-in presets */
 
 declare const BUILT_IN_PRESETS: ThemeEditorPreset[];
 /** All built-in presets */
@@ -5456,155 +5468,6 @@ declare const THEME_EDITOR_PRESETS: ThemeEditorPreset[];
 /** Look up a preset by ID */
 declare function getThemeEditorPreset(id: string): ThemeEditorPreset | undefined;
 
-type AgentWidgetSessionStatus = "idle" | "connecting" | "connected" | "error";
-
-/**
- * Feedback UI components for CSAT and NPS collection
- */
-type CSATFeedbackOptions = {
-    /** Callback when user submits CSAT feedback */
-    onSubmit: (rating: number, comment?: string) => void | Promise<void>;
-    /** Callback when user dismisses the feedback form */
-    onDismiss?: () => void;
-    /** Title text */
-    title?: string;
-    /** Subtitle/question text */
-    subtitle?: string;
-    /** Placeholder for optional comment field */
-    commentPlaceholder?: string;
-    /** Submit button text */
-    submitText?: string;
-    /** Skip button text */
-    skipText?: string;
-    /** Show comment field */
-    showComment?: boolean;
-    /** Rating labels (5 items for ratings 1-5) */
-    ratingLabels?: [string, string, string, string, string];
-};
-type NPSFeedbackOptions = {
-    /** Callback when user submits NPS feedback */
-    onSubmit: (rating: number, comment?: string) => void | Promise<void>;
-    /** Callback when user dismisses the feedback form */
-    onDismiss?: () => void;
-    /** Title text */
-    title?: string;
-    /** Subtitle/question text */
-    subtitle?: string;
-    /** Placeholder for optional comment field */
-    commentPlaceholder?: string;
-    /** Submit button text */
-    submitText?: string;
-    /** Skip button text */
-    skipText?: string;
-    /** Show comment field */
-    showComment?: boolean;
-    /** Low label (left side) */
-    lowLabel?: string;
-    /** High label (right side) */
-    highLabel?: string;
-};
-
-type Controller = {
-    update: (config: AgentWidgetConfig) => void;
-    destroy: () => void;
-    open: () => void;
-    close: () => void;
-    toggle: () => void;
-    clearChat: () => void;
-    setMessage: (message: string) => boolean;
-    submitMessage: (message?: string) => boolean;
-    startVoiceRecognition: () => boolean;
-    stopVoiceRecognition: () => boolean;
-    /**
-     * Inject a message into the conversation with dual-content support.
-     * Auto-opens the widget if closed and launcher is enabled.
-     */
-    injectMessage: (options: InjectMessageOptions) => AgentWidgetMessage;
-    /**
-     * Convenience method for injecting assistant messages.
-     */
-    injectAssistantMessage: (options: InjectAssistantMessageOptions) => AgentWidgetMessage;
-    /**
-     * Convenience method for injecting user messages.
-     */
-    injectUserMessage: (options: InjectUserMessageOptions) => AgentWidgetMessage;
-    /**
-     * Convenience method for injecting system messages.
-     */
-    injectSystemMessage: (options: InjectSystemMessageOptions) => AgentWidgetMessage;
-    /**
-     * Inject multiple messages in a single batch with one sort and one render pass.
-     */
-    injectMessageBatch: (optionsList: InjectMessageOptions[]) => AgentWidgetMessage[];
-    /**
-     * Convenience method for injecting an assistant message that renders as a
-     * registered component — same shape Persona produces from a streamed
-     * `{ "text": "...", "component": "...", "props": {...} }` payload.
-     */
-    injectComponentDirective: (options: InjectComponentDirectiveOptions) => AgentWidgetMessage;
-    /**
-     * @deprecated Use injectMessage() instead.
-     */
-    injectTestMessage: (event: AgentWidgetEvent) => void;
-    getMessages: () => AgentWidgetMessage[];
-    getStatus: () => AgentWidgetSessionStatus;
-    getPersistentMetadata: () => Record<string, unknown>;
-    updatePersistentMetadata: (updater: (prev: Record<string, unknown>) => Record<string, unknown>) => void;
-    on: <K extends keyof AgentWidgetControllerEventMap>(event: K, handler: (payload: AgentWidgetControllerEventMap[K]) => void) => () => void;
-    off: <K extends keyof AgentWidgetControllerEventMap>(event: K, handler: (payload: AgentWidgetControllerEventMap[K]) => void) => void;
-    isOpen: () => boolean;
-    isVoiceActive: () => boolean;
-    getState: () => AgentWidgetStateSnapshot;
-    showCSATFeedback: (options?: Partial<CSATFeedbackOptions>) => void;
-    showNPSFeedback: (options?: Partial<NPSFeedbackOptions>) => void;
-    submitCSATFeedback: (rating: number, comment?: string) => Promise<void>;
-    submitNPSFeedback: (rating: number, comment?: string) => Promise<void>;
-    /**
-     * Connect an external SSE stream and process it through the SDK's
-     * native event pipeline (tools, reasoning, streaming text, etc.).
-     */
-    connectStream: (stream: ReadableStream<Uint8Array>, options?: {
-        assistantMessageId?: string;
-    }) => Promise<void>;
-    /** Push a raw event into the event stream buffer (for testing/debugging) */
-    __pushEventStreamEvent: (event: {
-        type: string;
-        payload: unknown;
-    }) => void;
-    /** Opens the event stream panel */
-    showEventStream: () => void;
-    /** Closes the event stream panel */
-    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;
-    /** Read current artifacts (useful on init to rebuild host-side tab state after hydration). */
-    getArtifacts: () => PersonaArtifactRecord[];
-    /** Read the currently selected artifact id (paired with `getArtifacts`). */
-    getSelectedArtifactId: () => string | null;
-    /**
-     * Focus the chat input. Returns true if focus succeeded, false if panel is closed
-     * (launcher mode) or textarea is unavailable.
-     */
-    focusInput: () => boolean;
-    /**
-     * Programmatically resolve a pending approval.
-     * @param approvalId - The approval ID to resolve
-     * @param decision - "approved" or "denied"
-     * @param options - Optional decision context (e.g. `{ remember: true }`),
-     *   forwarded to `config.approval.onDecision`.
-     */
-    resolveApproval: (approvalId: string, decision: 'approved' | 'denied', options?: AgentWidgetApprovalDecisionOptions) => Promise<void>;
-};
-type AgentWidgetController = Controller;
-
 /**
  * Shared preview building blocks for theme editor preview renderers.
  * Used by both `createThemePreview()` (simple API) and the configurator's
@@ -5690,87 +5553,12 @@ interface PreviewConfigOptions {
 declare function buildPreviewConfig(options: PreviewConfigOptions, shellModeOverride?: 'light' | 'dark'): AgentWidgetConfig;
 declare function buildPreviewConfigWithMessages(options: PreviewConfigOptions, messages: AgentWidgetMessage[], shellModeOverride?: 'light' | 'dark'): AgentWidgetConfig;
 
-/**
- * Imperative preview renderer for the theme editor.
- * Manages iframe-based widget previews with device frames, zoom, scenes, and compare mode.
- * No external DOM dependencies — only needs a container element to mount into.
- *
- * For advanced preview needs (background URLs, inline editing, contrast checking),
- * use the lifecycle hooks in `ThemePreviewOptions` and import shared building blocks
- * from `./preview-utils` directly.
- */
-
-type PreviewDevice = 'desktop' | 'mobile';
-
-type PreviewShellMode = 'light' | 'dark';
-type CompareMode = 'off' | 'baseline' | 'themes';
-/** Context passed to lifecycle hooks after mounting or updating */
-interface PreviewLifecycleContext {
-    iframes: HTMLIFrameElement[];
-    controllers: AgentWidgetController[];
-}
-interface ThemePreviewOptions {
-    /** Device frame dimensions */
-    device?: PreviewDevice;
-    /** Widget state */
-    scene?: PreviewScene;
-    /** Browser chrome appearance */
-    shellMode?: PreviewShellMode;
-    /** Side-by-side comparison */
-    compareMode?: CompareMode;
-    /** Widget config */
-    config?: Partial<AgentWidgetConfig>;
-    /** Light mode theme */
-    theme?: DeepPartial<PersonaTheme>;
-    /** Dark mode theme */
-    darkTheme?: DeepPartial<PersonaTheme>;
-    /** Zoom level (0.15–1.5), or undefined for auto-fit */
-    zoom?: number;
-    /** Path to widget.css (defaults to looking for /widget-dist/widget.css) */
-    widgetCssPath?: string;
-    /** Config for the baseline side of a baseline comparison */
-    baselineConfig?: Partial<AgentWidgetConfig>;
-    /** Theme for the baseline side of a baseline comparison */
-    baselineTheme?: DeepPartial<PersonaTheme>;
-    /** Dark theme for the baseline side of a baseline comparison */
-    baselineDarkTheme?: DeepPartial<PersonaTheme>;
-    /** Called after all iframes load and widgets mount */
-    onAfterMount?: (ctx: PreviewLifecycleContext) => void;
-    /** Called after fast-path controller updates */
-    onAfterUpdate?: (ctx: PreviewLifecycleContext) => void;
-    /** Called before controllers are destroyed */
-    onBeforeDestroy?: () => void;
-    /** Called whenever the preview scale changes */
-    onScaleChange?: (scale: number) => void;
-    /** Override iframe srcdoc generation (for background URLs, etc.) */
-    buildSrcdoc?: (mountId: string, shellMode: PreviewShellMode, docked: boolean, cssPath: string) => string;
-    /** Override container HTML injection (for Idiomorph, etc.) */
-    morphContainer?: (container: HTMLElement, html: string) => void;
-}
-interface ThemePreviewHandle {
-    /** Update the preview (fast path when possible, full remount when needed) */
-    update(options: Partial<ThemePreviewOptions>): void;
-    /** Destroy preview and clean up */
-    destroy(): void;
-    /** Get live widget controllers */
-    getControllers(): AgentWidgetController[];
-    /** Recalculate auto-fit zoom */
-    fitToContainer(): void;
-    /** Get all preview iframes */
-    getIframes(): HTMLIFrameElement[];
-    /** Get current computed scale */
-    getScale(): number;
-    /** Set explicit zoom (or undefined to auto-fit) */
-    setZoom(zoom: number | undefined): void;
-}
-declare function createThemePreview(container: HTMLElement, initialOptions: ThemePreviewOptions): ThemePreviewHandle;
-
 /**
  * Interface Role → Token mapping layer.
  *
  * Maps high-level editor choices (family + intensity) to concrete palette
  * token references across multiple component/semantic paths. This is the
- * core of the "Interface Roles" editor section — one picker writes to
+ * core of the "Interface Roles" editor section: one picker writes to
  * many tokens atomically.
  *
  * All functions are pure and headless (no DOM).
@@ -5815,7 +5603,7 @@ interface DetectedRoleAssignment {
  */
 declare function detectRoleAssignment(getValue: (path: string) => unknown, role: RoleAssignmentOptions): DetectedRoleAssignment | null;
 
-/** Color parsing, normalization, and scale generation utilities (pure functions — no DOM) */
+/** Color parsing, normalization, and scale generation utilities (pure functions: no DOM) */
 
 interface ParsedCssValue {
     value: number;
@@ -5831,7 +5619,7 @@ declare function isValidHex(value: string): boolean;
  * Parse an `rgb()` / `rgba()` string into `#rrggbb`. Accepts integer (0-255) or
  * percentage channels; any alpha component is dropped. Returns `null` when the
  * string is not a parseable rgb/rgba value, so callers can fall back. This lets
- * the HSL/luminance paths — which otherwise `parseInt` hex digits — accept the
+ * the HSL/luminance paths, which otherwise `parseInt` hex digits, accept the
  * `rgb()` inputs that `coerceColor` admits without producing `#NaNNaNNaN`.
  */
 declare function rgbToHex(value: string): string | null;
@@ -5906,14 +5694,14 @@ interface WebMcpTool {
 }
 /**
  * Wrap a JSON-serializable payload in the MCP tool-result envelope. Compact
- * JSON (no indentation) — the text is consumed by a model, where pretty-print
+ * JSON (no indentation): the text is consumed by a model, where pretty-print
  * whitespace is pure token overhead.
  */
 declare function toolResult(payload: unknown): ToolResult;
 /**
  * Structural subset of `ThemeEditorState` (and the example app's `state`
  * module) that the tools require. Anything satisfying this shape can be wired
- * to the tools — the headless `ThemeEditorState`, or a host's stateful wrapper
+ * to the tools: the headless `ThemeEditorState`, or a host's stateful wrapper
  * that also drives a live preview (e.g. a Persona widget styling itself).
  */
 interface ThemeEditorLike {
@@ -5945,8 +5733,8 @@ interface CreateThemeEditorToolsOptions {
  * `createThemeEditorTools(state)` returns transport-agnostic tool definitions
  * designed for Agent Experience: intent-level operations (set brand colors,
  * assign a color role, set roundness…) rather than a 1:1 mapping of the ~150
- * editor fields. Two altitudes — high-level semantic tools plus a low-level
- * escape hatch (`set_theme_fields`) — keep the catalog small without losing
+ * editor fields. Two altitudes: high-level semantic tools plus a low-level
+ * escape hatch (`set_theme_fields`): keep the catalog small without losing
  * coverage. Every mutation returns a compact summary + contrast warnings.
  */
 
@@ -6057,4 +5845,4 @@ declare function runContrastChecks(state: ThemeEditorLike, level?: ContrastLevel
 /** Compact contrast warnings for the regions a mutation touched. */
 declare function quickContrastWarnings(state: ThemeEditorLike, pairKeys: string[], variant?: 'light' | 'dark' | 'both', level?: ContrastLevel): ContrastWarning[];
 
-export { ADVANCED_TOKENS_SECTION, ALL_ROLES, ALL_TABS, BRAND_PALETTE_SECTION, BUILT_IN_PRESETS, type BuildTranscriptStreamFramesOptions, COLORS_SECTIONS, COLOR_FAMILIES, COMPONENTS_SECTIONS, COMPONENT_COLOR_SECTIONS, COMPONENT_SHAPE_SECTIONS, CONFIGURE_SECTIONS, CONFIGURE_SUB_GROUPS, CONTRAST_PAIRS, CSS_NAMED_COLORS, type ColorScaleOptions, type CompareMode, type ConfigChangeListener, type ConfiguratorSnapshot, type ContrastCheck, type ContrastLevel, type ContrastReport, type ContrastWarning, type CreateThemeEditorToolsOptions, DEVICE_DIMENSIONS, type DetectedRoleAssignment, type EditTarget, type FieldDef, type FieldType, HOME_SUGGESTION_CHIPS, INTERFACE_ROLES_SECTION, MOCK_BROWSER_CONTENT, MOCK_WORKSPACE_CONTENT, type OnChangeCallback, PALETTE_SECTION, PREVIEW_STORAGE_ADAPTER, type PreviewConfigOptions, type PreviewDevice, type PreviewLifecycleContext, type PreviewScene, type PreviewShellMode, type PreviewShellPalette, type PreviewTranscriptEntryPreset, RADIUS_PRESETS, ROLE_ASSISTANT_MESSAGES, ROLE_BORDERS, ROLE_FAMILIES, ROLE_FAMILY_LABELS, ROLE_HEADER, ROLE_INPUT, ROLE_INTENSITIES, ROLE_LINKS_FOCUS, ROLE_PRIMARY_ACTIONS, ROLE_SCROLL_TO_BOTTOM, ROLE_SURFACES, ROLE_USER_MESSAGES, type RoleAssignmentOptions, type RoleFamily, type RoleIntensity, type RoleState, type RoleTarget, type RoleTargetKind, SEMANTIC_COLORS_SECTION, SHADE_KEYS, SHELL_STYLE_ID, STATUS_COLORS_SECTION, STATUS_PALETTE_SECTION, STYLE_SECTIONS, STYLE_SECTIONS_V2, type SectionDef, type SectionPreset, type SelectOption, type SliderOptions, type SubGroupDef, THEME_EDITOR_PRESETS, THEME_SECTION, type TabDef, type ThemeEditorLike, type ThemeEditorPreset, ThemeEditorState, type ThemePreviewHandle, type ThemePreviewOptions, type ThemeSummary, type TokenRefOptions, type ToolAnnotations, type ToolContent, type ToolExecute, type ToolImageContent, type ToolResult, type ToolTextContent, type TranscriptStreamFrame, type WebMcpTool, ZOOM_MAX, ZOOM_MIN, appendPreviewTranscriptEntry, applySceneConfig, applyShellTheme, buildPreviewConfig, buildPreviewConfigWithMessages, buildShellCss, buildSrcdoc, buildSummary, buildTranscriptStreamFrames, coerceColor, coerceFamily, coerceIntensity, coerceRadius, coerceRoundnessStyle, coerceScheme, convertFromPx, convertToPx, createPreviewMessages, createPreviewTranscriptEntry, createThemeEditorTools, createThemePreview, detectRoleAssignment, escapeHtml, findSection, formatCssValue, generateColorScale, getPreviewTranscriptPresetLabel, getShellPalette, getThemeEditorPreset, hexToHsl, hslToHex, isValidHex, normalizeColorValue, paletteColorPath, parseCssValue, presetStreamsText, quickContrastWarnings, resolveRoleAssignment, resolveThemeColorPath, rgbToHex, runContrastChecks, scopeSection, tokenRefDisplayName, toolResult, wcagContrastRatio };
+export { ADVANCED_TOKENS_SECTION, ALL_ROLES, ALL_TABS, BRAND_PALETTE_SECTION, BUILT_IN_PRESETS, type BuildTranscriptStreamFramesOptions, COLORS_SECTIONS, COLOR_FAMILIES, COMPONENTS_SECTIONS, COMPONENT_COLOR_SECTIONS, COMPONENT_SHAPE_SECTIONS, CONFIGURE_SECTIONS, CONFIGURE_SUB_GROUPS, CONTRAST_PAIRS, CSS_NAMED_COLORS, type ColorScaleOptions, type ConfigChangeListener, type ConfiguratorSnapshot, type ContrastCheck, type ContrastLevel, type ContrastReport, type ContrastWarning, type CreateThemeEditorToolsOptions, DEVICE_DIMENSIONS, type DetectedRoleAssignment, type EditTarget, type FieldDef, type FieldType, HOME_SUGGESTION_CHIPS, INTERFACE_ROLES_SECTION, MOCK_BROWSER_CONTENT, MOCK_WORKSPACE_CONTENT, type OnChangeCallback, PALETTE_SECTION, PREVIEW_STORAGE_ADAPTER, type PreviewConfigOptions, type PreviewScene, type PreviewShellPalette, type PreviewTranscriptEntryPreset, RADIUS_PRESETS, ROLE_ASSISTANT_MESSAGES, ROLE_BORDERS, ROLE_FAMILIES, ROLE_FAMILY_LABELS, ROLE_HEADER, ROLE_INPUT, ROLE_INTENSITIES, ROLE_LINKS_FOCUS, ROLE_PRIMARY_ACTIONS, ROLE_SCROLL_TO_BOTTOM, ROLE_SURFACES, ROLE_USER_MESSAGES, type RoleAssignmentOptions, type RoleFamily, type RoleIntensity, type RoleState, type RoleTarget, type RoleTargetKind, SEMANTIC_COLORS_SECTION, SHADE_KEYS, SHELL_STYLE_ID, STATUS_COLORS_SECTION, STATUS_PALETTE_SECTION, STYLE_SECTIONS, STYLE_SECTIONS_V2, type SectionDef, type SectionPreset, type SelectOption, type SliderOptions, type SubGroupDef, THEME_EDITOR_PRESETS, THEME_SECTION, type TabDef, type ThemeEditorLike, type ThemeEditorPreset, ThemeEditorState, type ThemeSummary, type TokenRefOptions, type ToolAnnotations, type ToolContent, type ToolExecute, type ToolImageContent, type ToolResult, type ToolTextContent, type TranscriptStreamFrame, type WebMcpTool, ZOOM_MAX, ZOOM_MIN, appendPreviewTranscriptEntry, applySceneConfig, applyShellTheme, buildPreviewConfig, buildPreviewConfigWithMessages, buildShellCss, buildSrcdoc, buildSummary, buildTranscriptStreamFrames, coerceColor, coerceFamily, coerceIntensity, coerceRadius, coerceRoundnessStyle, coerceScheme, convertFromPx, convertToPx, createPreviewMessages, createPreviewTranscriptEntry, createThemeEditorTools, detectRoleAssignment, escapeHtml, findSection, formatCssValue, generateColorScale, getPreviewTranscriptPresetLabel, getShellPalette, getThemeEditorPreset, hexToHsl, hslToHex, isValidHex, normalizeColorValue, paletteColorPath, parseCssValue, presetStreamsText, quickContrastWarnings, resolveRoleAssignment, resolveThemeColorPath, rgbToHex, runContrastChecks, scopeSection, tokenRefDisplayName, toolResult, wcagContrastRatio };