@runtypelabs/persona 1.40.0 → 1.41.0

package/dist/index.d.cts

@@ -65,6 +65,41 @@ interface AgentWidgetPlugin {
         defaultRenderer: () => HTMLElement;
         config: AgentWidgetConfig;
     }) => HTMLElement | null;
+    /**
+     * Custom renderer for loading indicator
+     * Return null to use default renderer (or config-based renderer)
+     *
+     * @example
+     * ```typescript
+     * renderLoadingIndicator: ({ location, defaultRenderer }) => {
+     *   if (location === 'standalone') {
+     *     const el = document.createElement('div');
+     *     el.textContent = 'Thinking...';
+     *     return el;
+     *   }
+     *   return defaultRenderer();
+     * }
+     * ```
+     */
+    renderLoadingIndicator?: (context: LoadingIndicatorRenderContext) => HTMLElement | null;
+    /**
+     * Custom renderer for idle state indicator.
+     * Called when the widget is idle (not streaming) and has at least one message.
+     * Return an HTMLElement to display, or null to hide (default).
+     *
+     * @example
+     * ```typescript
+     * renderIdleIndicator: ({ lastMessage, messageCount }) => {
+     *   if (messageCount === 0) return null;
+     *   if (lastMessage?.role !== 'assistant') return null;
+     *   const el = document.createElement('div');
+     *   el.className = 'idle-pulse';
+     *   el.setAttribute('data-preserve-animation', 'true');
+     *   return el;
+     * }
+     * ```
+     */
+    renderIdleIndicator?: (context: IdleIndicatorRenderContext) => HTMLElement | null;
     /**
      * Called when plugin is registered
      */
@@ -1217,6 +1252,137 @@ type AgentWidgetPersistStateConfig = {
      */
     clearOnChatClear?: boolean;
 };
+/**
+ * Context provided to loading indicator render functions.
+ * Used for customizing the loading indicator appearance.
+ */
+type LoadingIndicatorRenderContext = {
+    /**
+     * Full widget configuration for accessing theme, etc.
+     */
+    config: AgentWidgetConfig;
+    /**
+     * Current streaming state (always true when indicator is shown)
+     */
+    streaming: boolean;
+    /**
+     * Location where the indicator is rendered:
+     * - 'inline': Inside a streaming assistant message bubble (when content is empty)
+     * - 'standalone': Separate bubble while waiting for stream to start
+     */
+    location: 'inline' | 'standalone';
+    /**
+     * Function to render the default 3-dot bouncing indicator.
+     * Call this if you want to use the default for certain cases.
+     */
+    defaultRenderer: () => HTMLElement;
+};
+/**
+ * Context provided to idle indicator render functions.
+ * Used for customizing the idle state indicator appearance.
+ */
+type IdleIndicatorRenderContext = {
+    /**
+     * Full widget configuration for accessing theme, etc.
+     */
+    config: AgentWidgetConfig;
+    /**
+     * The last message in the conversation (if any).
+     * Useful for conditional rendering based on who spoke last.
+     */
+    lastMessage: AgentWidgetMessage | undefined;
+    /**
+     * Total number of messages in the conversation.
+     */
+    messageCount: number;
+};
+/**
+ * Configuration for customizing the loading indicator.
+ * The loading indicator is shown while waiting for a response or
+ * when an assistant message is streaming but has no content yet.
+ *
+ * @example
+ * ```typescript
+ * // Custom animated spinner
+ * config: {
+ *   loadingIndicator: {
+ *     render: ({ location }) => {
+ *       const el = document.createElement('div');
+ *       el.innerHTML = '<svg class="spinner">...</svg>';
+ *       el.setAttribute('data-preserve-animation', 'true');
+ *       return el;
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Different indicators by location
+ * config: {
+ *   loadingIndicator: {
+ *     render: ({ location, defaultRenderer }) => {
+ *       if (location === 'inline') {
+ *         return defaultRenderer(); // Use default for inline
+ *       }
+ *       // Custom for standalone
+ *       const el = document.createElement('div');
+ *       el.textContent = 'Thinking...';
+ *       return el;
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Hide loading indicator entirely
+ * config: {
+ *   loadingIndicator: {
+ *     render: () => null
+ *   }
+ * }
+ * ```
+ */
+type AgentWidgetLoadingIndicatorConfig = {
+    /**
+     * Whether to show the bubble background and border around the standalone loading indicator.
+     * Set to false to render the loading indicator without any bubble styling.
+     * @default true
+     */
+    showBubble?: boolean;
+    /**
+     * Custom render function for the loading indicator.
+     * Return an HTMLElement to display, or null to hide the indicator.
+     *
+     * For custom animations, add `data-preserve-animation="true"` attribute
+     * to prevent the DOM morpher from interrupting the animation.
+     */
+    render?: (context: LoadingIndicatorRenderContext) => HTMLElement | null;
+    /**
+     * Render function for the idle state indicator.
+     * Called when the widget is idle (not streaming) and has at least one message.
+     * Return an HTMLElement to display, or null to hide (default).
+     *
+     * For animations, add `data-preserve-animation="true"` attribute
+     * to prevent the DOM morpher from interrupting the animation.
+     *
+     * @example
+     * ```typescript
+     * loadingIndicator: {
+     *   renderIdle: ({ lastMessage }) => {
+     *     // Only show idle indicator after assistant messages
+     *     if (lastMessage?.role !== 'assistant') return null;
+     *     const el = document.createElement('div');
+     *     el.className = 'pulse-dot';
+     *     el.setAttribute('data-preserve-animation', 'true');
+     *     return el;
+     *   }
+     * }
+     * ```
+     */
+    renderIdle?: (context: IdleIndicatorRenderContext) => HTMLElement | null;
+};
 type AgentWidgetConfig = {
     apiUrl?: string;
     flowId?: string;
@@ -1650,6 +1816,28 @@ type AgentWidgetConfig = {
      * ```
      */
     persistState?: boolean | AgentWidgetPersistStateConfig;
+    /**
+     * Configuration for customizing the loading indicator.
+     * The loading indicator is shown while waiting for a response or
+     * when an assistant message is streaming but has no content yet.
+     *
+     * @example
+     * ```typescript
+     * config: {
+     *   loadingIndicator: {
+     *     render: ({ location, defaultRenderer }) => {
+     *       if (location === 'standalone') {
+     *         const el = document.createElement('div');
+     *         el.textContent = 'Thinking...';
+     *         return el;
+     *       }
+     *       return defaultRenderer();
+     *     }
+     *   }
+     * }
+     * ```
+     */
+    loadingIndicator?: AgentWidgetLoadingIndicatorConfig;
 };
 type AgentWidgetMessageRole = "user" | "assistant" | "system";
 type AgentWidgetReasoning = {
@@ -2795,6 +2983,7 @@ declare function createComponentStreamParser(): {
  */
 declare function isComponentDirectiveType(obj: unknown): obj is ComponentDirective;
 
+type LoadingIndicatorRenderer = (context: LoadingIndicatorRenderContext) => HTMLElement | null;
 type MessageTransform = (context: {
     text: string;
     message: AgentWidgetMessage;
@@ -2806,20 +2995,39 @@ type MessageActionCallbacks = {
     onFeedback?: (feedback: AgentWidgetMessageFeedback) => void;
 };
 declare const createTypingIndicator: () => HTMLElement;
+/**
+ * Render loading indicator with fallback chain:
+ * 1. Custom renderer (if provided and returns non-null)
+ * 2. Default typing indicator
+ */
+declare const renderLoadingIndicatorWithFallback: (location: "inline" | "standalone", customRenderer?: LoadingIndicatorRenderer, widgetConfig?: AgentWidgetConfig) => HTMLElement | null;
 /**
  * Create message action buttons (copy, upvote, downvote)
  */
 declare const createMessageActions: (message: AgentWidgetMessage, actionsConfig: AgentWidgetMessageActionsConfig, callbacks?: MessageActionCallbacks) => HTMLElement;
+/**
+ * Options for creating a standard message bubble
+ */
+type CreateStandardBubbleOptions = {
+    /**
+     * Custom loading indicator renderer for inline location
+     */
+    loadingIndicatorRenderer?: LoadingIndicatorRenderer;
+    /**
+     * Full widget config (needed for loading indicator context)
+     */
+    widgetConfig?: AgentWidgetConfig;
+};
 /**
  * Create standard message bubble
  * Supports layout configuration for avatars, timestamps, and visual presets
  */
-declare const createStandardBubble: (message: AgentWidgetMessage, transform: MessageTransform, layoutConfig?: AgentWidgetMessageLayoutConfig, actionsConfig?: AgentWidgetMessageActionsConfig, actionCallbacks?: MessageActionCallbacks) => HTMLElement;
+declare const createStandardBubble: (message: AgentWidgetMessage, transform: MessageTransform, layoutConfig?: AgentWidgetMessageLayoutConfig, actionsConfig?: AgentWidgetMessageActionsConfig, actionCallbacks?: MessageActionCallbacks, options?: CreateStandardBubbleOptions) => HTMLElement;
 /**
  * Create bubble with custom renderer support
  * Uses custom renderer if provided in layout config, otherwise falls back to standard bubble
  */
-declare const createBubbleWithLayout: (message: AgentWidgetMessage, transform: MessageTransform, layoutConfig?: AgentWidgetMessageLayoutConfig, actionsConfig?: AgentWidgetMessageActionsConfig, actionCallbacks?: MessageActionCallbacks) => HTMLElement;
+declare const createBubbleWithLayout: (message: AgentWidgetMessage, transform: MessageTransform, layoutConfig?: AgentWidgetMessageLayoutConfig, actionsConfig?: AgentWidgetMessageActionsConfig, actionCallbacks?: MessageActionCallbacks, options?: CreateStandardBubbleOptions) => HTMLElement;
 
 /**
  * Options for component middleware
@@ -2971,4 +3179,4 @@ declare const getHeaderLayout: (layoutName: string) => HeaderLayoutRenderer;
  */
 declare const buildHeaderWithLayout: (config: AgentWidgetConfig, layoutConfig?: AgentWidgetHeaderLayoutConfig, context?: Partial<HeaderLayoutContext>) => HeaderElements;
 
-export { type AgentWidgetAttachmentsConfig, type AgentWidgetAvatarConfig, AgentWidgetClient, type AgentWidgetConfig, type AgentWidgetController, type AgentWidgetCustomFetch, type AgentWidgetEvent, type AgentWidgetFeatureFlags, type AgentWidgetHeaderLayoutConfig, type AgentWidgetHeadersFunction, type AgentWidgetInitHandle, type AgentWidgetInitOptions, type AgentWidgetLauncherConfig, type AgentWidgetLayoutConfig, 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, DEFAULT_DARK_THEME, DEFAULT_LIGHT_THEME, DEFAULT_WIDGET_CONFIG, type HeaderBuildContext, type HeaderElements, type HeaderLayoutContext, type HeaderLayoutRenderer, type HeaderRenderContext, type ImageContentPart, type InjectAssistantMessageOptions, type InjectMessageOptions, type InjectSystemMessageOptions, type InjectUserMessageOptions, type MarkdownProcessorOptions, type MessageActionCallbacks, type MessageContent, type MessageRenderContext, type MessageTransform, type NPSFeedbackOptions, type PendingAttachment, type SlotRenderContext, type SlotRenderer, type TextContentPart, VERSION, type WidgetLayoutSlot, attachHeaderToContainer, buildComposer, buildDefaultHeader, buildExpandedHeader, buildHeader, buildHeaderWithLayout, buildMinimalHeader, componentRegistry, createActionManager, createAgentExperience, createBubbleWithLayout, createCSATFeedback, createComponentMiddleware, createComponentStreamParser, createDirectivePostprocessor, createFlexibleJsonStreamParser, createImagePart, createJsonStreamParser, createLocalStorageAdapter, createMarkdownProcessor, createMarkdownProcessorFromConfig, createMessageActions, createNPSFeedback, createPlainTextParser, createRegexJsonParser, createStandardBubble, createTextPart, createTypingIndicator, createXmlParser, initAgentWidget as default, defaultActionHandlers, defaultJsonActionParser, directivePostprocessor, escapeHtml, extractComponentDirectiveFromMessage, fileToImagePart, generateAssistantMessageId, generateCodeSnippet, generateMessageId, generateUserMessageId, getDisplayText, getHeaderLayout, getImageParts, hasComponentDirective, hasImages, headerLayouts, initAgentWidget, isComponentDirectiveType, markdownPostprocessor, mergeWithDefaults, normalizeContent, pluginRegistry, renderComponentDirective, validateImageFile };
+export { type AgentWidgetAttachmentsConfig, type AgentWidgetAvatarConfig, AgentWidgetClient, type AgentWidgetConfig, type AgentWidgetController, 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 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 SlotRenderContext, type SlotRenderer, type TextContentPart, VERSION, type WidgetLayoutSlot, attachHeaderToContainer, buildComposer, buildDefaultHeader, buildExpandedHeader, buildHeader, buildHeaderWithLayout, buildMinimalHeader, componentRegistry, createActionManager, createAgentExperience, createBubbleWithLayout, createCSATFeedback, createComponentMiddleware, createComponentStreamParser, createDirectivePostprocessor, createFlexibleJsonStreamParser, createImagePart, createJsonStreamParser, createLocalStorageAdapter, createMarkdownProcessor, createMarkdownProcessorFromConfig, createMessageActions, createNPSFeedback, createPlainTextParser, createRegexJsonParser, createStandardBubble, createTextPart, createTypingIndicator, createXmlParser, initAgentWidget as default, defaultActionHandlers, defaultJsonActionParser, directivePostprocessor, escapeHtml, extractComponentDirectiveFromMessage, fileToImagePart, generateAssistantMessageId, generateCodeSnippet, generateMessageId, generateUserMessageId, getDisplayText, getHeaderLayout, getImageParts, hasComponentDirective, hasImages, headerLayouts, initAgentWidget, isComponentDirectiveType, markdownPostprocessor, mergeWithDefaults, normalizeContent, pluginRegistry, renderComponentDirective, renderLoadingIndicatorWithFallback, validateImageFile };

package/dist/index.d.ts

@@ -65,6 +65,41 @@ interface AgentWidgetPlugin {
         defaultRenderer: () => HTMLElement;
         config: AgentWidgetConfig;
     }) => HTMLElement | null;
+    /**
+     * Custom renderer for loading indicator
+     * Return null to use default renderer (or config-based renderer)
+     *
+     * @example
+     * ```typescript
+     * renderLoadingIndicator: ({ location, defaultRenderer }) => {
+     *   if (location === 'standalone') {
+     *     const el = document.createElement('div');
+     *     el.textContent = 'Thinking...';
+     *     return el;
+     *   }
+     *   return defaultRenderer();
+     * }
+     * ```
+     */
+    renderLoadingIndicator?: (context: LoadingIndicatorRenderContext) => HTMLElement | null;
+    /**
+     * Custom renderer for idle state indicator.
+     * Called when the widget is idle (not streaming) and has at least one message.
+     * Return an HTMLElement to display, or null to hide (default).
+     *
+     * @example
+     * ```typescript
+     * renderIdleIndicator: ({ lastMessage, messageCount }) => {
+     *   if (messageCount === 0) return null;
+     *   if (lastMessage?.role !== 'assistant') return null;
+     *   const el = document.createElement('div');
+     *   el.className = 'idle-pulse';
+     *   el.setAttribute('data-preserve-animation', 'true');
+     *   return el;
+     * }
+     * ```
+     */
+    renderIdleIndicator?: (context: IdleIndicatorRenderContext) => HTMLElement | null;
     /**
      * Called when plugin is registered
      */
@@ -1217,6 +1252,137 @@ type AgentWidgetPersistStateConfig = {
      */
     clearOnChatClear?: boolean;
 };
+/**
+ * Context provided to loading indicator render functions.
+ * Used for customizing the loading indicator appearance.
+ */
+type LoadingIndicatorRenderContext = {
+    /**
+     * Full widget configuration for accessing theme, etc.
+     */
+    config: AgentWidgetConfig;
+    /**
+     * Current streaming state (always true when indicator is shown)
+     */
+    streaming: boolean;
+    /**
+     * Location where the indicator is rendered:
+     * - 'inline': Inside a streaming assistant message bubble (when content is empty)
+     * - 'standalone': Separate bubble while waiting for stream to start
+     */
+    location: 'inline' | 'standalone';
+    /**
+     * Function to render the default 3-dot bouncing indicator.
+     * Call this if you want to use the default for certain cases.
+     */
+    defaultRenderer: () => HTMLElement;
+};
+/**
+ * Context provided to idle indicator render functions.
+ * Used for customizing the idle state indicator appearance.
+ */
+type IdleIndicatorRenderContext = {
+    /**
+     * Full widget configuration for accessing theme, etc.
+     */
+    config: AgentWidgetConfig;
+    /**
+     * The last message in the conversation (if any).
+     * Useful for conditional rendering based on who spoke last.
+     */
+    lastMessage: AgentWidgetMessage | undefined;
+    /**
+     * Total number of messages in the conversation.
+     */
+    messageCount: number;
+};
+/**
+ * Configuration for customizing the loading indicator.
+ * The loading indicator is shown while waiting for a response or
+ * when an assistant message is streaming but has no content yet.
+ *
+ * @example
+ * ```typescript
+ * // Custom animated spinner
+ * config: {
+ *   loadingIndicator: {
+ *     render: ({ location }) => {
+ *       const el = document.createElement('div');
+ *       el.innerHTML = '<svg class="spinner">...</svg>';
+ *       el.setAttribute('data-preserve-animation', 'true');
+ *       return el;
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Different indicators by location
+ * config: {
+ *   loadingIndicator: {
+ *     render: ({ location, defaultRenderer }) => {
+ *       if (location === 'inline') {
+ *         return defaultRenderer(); // Use default for inline
+ *       }
+ *       // Custom for standalone
+ *       const el = document.createElement('div');
+ *       el.textContent = 'Thinking...';
+ *       return el;
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Hide loading indicator entirely
+ * config: {
+ *   loadingIndicator: {
+ *     render: () => null
+ *   }
+ * }
+ * ```
+ */
+type AgentWidgetLoadingIndicatorConfig = {
+    /**
+     * Whether to show the bubble background and border around the standalone loading indicator.
+     * Set to false to render the loading indicator without any bubble styling.
+     * @default true
+     */
+    showBubble?: boolean;
+    /**
+     * Custom render function for the loading indicator.
+     * Return an HTMLElement to display, or null to hide the indicator.
+     *
+     * For custom animations, add `data-preserve-animation="true"` attribute
+     * to prevent the DOM morpher from interrupting the animation.
+     */
+    render?: (context: LoadingIndicatorRenderContext) => HTMLElement | null;
+    /**
+     * Render function for the idle state indicator.
+     * Called when the widget is idle (not streaming) and has at least one message.
+     * Return an HTMLElement to display, or null to hide (default).
+     *
+     * For animations, add `data-preserve-animation="true"` attribute
+     * to prevent the DOM morpher from interrupting the animation.
+     *
+     * @example
+     * ```typescript
+     * loadingIndicator: {
+     *   renderIdle: ({ lastMessage }) => {
+     *     // Only show idle indicator after assistant messages
+     *     if (lastMessage?.role !== 'assistant') return null;
+     *     const el = document.createElement('div');
+     *     el.className = 'pulse-dot';
+     *     el.setAttribute('data-preserve-animation', 'true');
+     *     return el;
+     *   }
+     * }
+     * ```
+     */
+    renderIdle?: (context: IdleIndicatorRenderContext) => HTMLElement | null;
+};
 type AgentWidgetConfig = {
     apiUrl?: string;
     flowId?: string;
@@ -1650,6 +1816,28 @@ type AgentWidgetConfig = {
      * ```
      */
     persistState?: boolean | AgentWidgetPersistStateConfig;
+    /**
+     * Configuration for customizing the loading indicator.
+     * The loading indicator is shown while waiting for a response or
+     * when an assistant message is streaming but has no content yet.
+     *
+     * @example
+     * ```typescript
+     * config: {
+     *   loadingIndicator: {
+     *     render: ({ location, defaultRenderer }) => {
+     *       if (location === 'standalone') {
+     *         const el = document.createElement('div');
+     *         el.textContent = 'Thinking...';
+     *         return el;
+     *       }
+     *       return defaultRenderer();
+     *     }
+     *   }
+     * }
+     * ```
+     */
+    loadingIndicator?: AgentWidgetLoadingIndicatorConfig;
 };
 type AgentWidgetMessageRole = "user" | "assistant" | "system";
 type AgentWidgetReasoning = {
@@ -2795,6 +2983,7 @@ declare function createComponentStreamParser(): {
  */
 declare function isComponentDirectiveType(obj: unknown): obj is ComponentDirective;
 
+type LoadingIndicatorRenderer = (context: LoadingIndicatorRenderContext) => HTMLElement | null;
 type MessageTransform = (context: {
     text: string;
     message: AgentWidgetMessage;
@@ -2806,20 +2995,39 @@ type MessageActionCallbacks = {
     onFeedback?: (feedback: AgentWidgetMessageFeedback) => void;
 };
 declare const createTypingIndicator: () => HTMLElement;
+/**
+ * Render loading indicator with fallback chain:
+ * 1. Custom renderer (if provided and returns non-null)
+ * 2. Default typing indicator
+ */
+declare const renderLoadingIndicatorWithFallback: (location: "inline" | "standalone", customRenderer?: LoadingIndicatorRenderer, widgetConfig?: AgentWidgetConfig) => HTMLElement | null;
 /**
  * Create message action buttons (copy, upvote, downvote)
  */
 declare const createMessageActions: (message: AgentWidgetMessage, actionsConfig: AgentWidgetMessageActionsConfig, callbacks?: MessageActionCallbacks) => HTMLElement;
+/**
+ * Options for creating a standard message bubble
+ */
+type CreateStandardBubbleOptions = {
+    /**
+     * Custom loading indicator renderer for inline location
+     */
+    loadingIndicatorRenderer?: LoadingIndicatorRenderer;
+    /**
+     * Full widget config (needed for loading indicator context)
+     */
+    widgetConfig?: AgentWidgetConfig;
+};
 /**
  * Create standard message bubble
  * Supports layout configuration for avatars, timestamps, and visual presets
  */
-declare const createStandardBubble: (message: AgentWidgetMessage, transform: MessageTransform, layoutConfig?: AgentWidgetMessageLayoutConfig, actionsConfig?: AgentWidgetMessageActionsConfig, actionCallbacks?: MessageActionCallbacks) => HTMLElement;
+declare const createStandardBubble: (message: AgentWidgetMessage, transform: MessageTransform, layoutConfig?: AgentWidgetMessageLayoutConfig, actionsConfig?: AgentWidgetMessageActionsConfig, actionCallbacks?: MessageActionCallbacks, options?: CreateStandardBubbleOptions) => HTMLElement;
 /**
  * Create bubble with custom renderer support
  * Uses custom renderer if provided in layout config, otherwise falls back to standard bubble
  */
-declare const createBubbleWithLayout: (message: AgentWidgetMessage, transform: MessageTransform, layoutConfig?: AgentWidgetMessageLayoutConfig, actionsConfig?: AgentWidgetMessageActionsConfig, actionCallbacks?: MessageActionCallbacks) => HTMLElement;
+declare const createBubbleWithLayout: (message: AgentWidgetMessage, transform: MessageTransform, layoutConfig?: AgentWidgetMessageLayoutConfig, actionsConfig?: AgentWidgetMessageActionsConfig, actionCallbacks?: MessageActionCallbacks, options?: CreateStandardBubbleOptions) => HTMLElement;
 
 /**
  * Options for component middleware
@@ -2971,4 +3179,4 @@ declare const getHeaderLayout: (layoutName: string) => HeaderLayoutRenderer;
  */
 declare const buildHeaderWithLayout: (config: AgentWidgetConfig, layoutConfig?: AgentWidgetHeaderLayoutConfig, context?: Partial<HeaderLayoutContext>) => HeaderElements;
 
-export { type AgentWidgetAttachmentsConfig, type AgentWidgetAvatarConfig, AgentWidgetClient, type AgentWidgetConfig, type AgentWidgetController, type AgentWidgetCustomFetch, type AgentWidgetEvent, type AgentWidgetFeatureFlags, type AgentWidgetHeaderLayoutConfig, type AgentWidgetHeadersFunction, type AgentWidgetInitHandle, type AgentWidgetInitOptions, type AgentWidgetLauncherConfig, type AgentWidgetLayoutConfig, 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, DEFAULT_DARK_THEME, DEFAULT_LIGHT_THEME, DEFAULT_WIDGET_CONFIG, type HeaderBuildContext, type HeaderElements, type HeaderLayoutContext, type HeaderLayoutRenderer, type HeaderRenderContext, type ImageContentPart, type InjectAssistantMessageOptions, type InjectMessageOptions, type InjectSystemMessageOptions, type InjectUserMessageOptions, type MarkdownProcessorOptions, type MessageActionCallbacks, type MessageContent, type MessageRenderContext, type MessageTransform, type NPSFeedbackOptions, type PendingAttachment, type SlotRenderContext, type SlotRenderer, type TextContentPart, VERSION, type WidgetLayoutSlot, attachHeaderToContainer, buildComposer, buildDefaultHeader, buildExpandedHeader, buildHeader, buildHeaderWithLayout, buildMinimalHeader, componentRegistry, createActionManager, createAgentExperience, createBubbleWithLayout, createCSATFeedback, createComponentMiddleware, createComponentStreamParser, createDirectivePostprocessor, createFlexibleJsonStreamParser, createImagePart, createJsonStreamParser, createLocalStorageAdapter, createMarkdownProcessor, createMarkdownProcessorFromConfig, createMessageActions, createNPSFeedback, createPlainTextParser, createRegexJsonParser, createStandardBubble, createTextPart, createTypingIndicator, createXmlParser, initAgentWidget as default, defaultActionHandlers, defaultJsonActionParser, directivePostprocessor, escapeHtml, extractComponentDirectiveFromMessage, fileToImagePart, generateAssistantMessageId, generateCodeSnippet, generateMessageId, generateUserMessageId, getDisplayText, getHeaderLayout, getImageParts, hasComponentDirective, hasImages, headerLayouts, initAgentWidget, isComponentDirectiveType, markdownPostprocessor, mergeWithDefaults, normalizeContent, pluginRegistry, renderComponentDirective, validateImageFile };
+export { type AgentWidgetAttachmentsConfig, type AgentWidgetAvatarConfig, AgentWidgetClient, type AgentWidgetConfig, type AgentWidgetController, 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 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 SlotRenderContext, type SlotRenderer, type TextContentPart, VERSION, type WidgetLayoutSlot, attachHeaderToContainer, buildComposer, buildDefaultHeader, buildExpandedHeader, buildHeader, buildHeaderWithLayout, buildMinimalHeader, componentRegistry, createActionManager, createAgentExperience, createBubbleWithLayout, createCSATFeedback, createComponentMiddleware, createComponentStreamParser, createDirectivePostprocessor, createFlexibleJsonStreamParser, createImagePart, createJsonStreamParser, createLocalStorageAdapter, createMarkdownProcessor, createMarkdownProcessorFromConfig, createMessageActions, createNPSFeedback, createPlainTextParser, createRegexJsonParser, createStandardBubble, createTextPart, createTypingIndicator, createXmlParser, initAgentWidget as default, defaultActionHandlers, defaultJsonActionParser, directivePostprocessor, escapeHtml, extractComponentDirectiveFromMessage, fileToImagePart, generateAssistantMessageId, generateCodeSnippet, generateMessageId, generateUserMessageId, getDisplayText, getHeaderLayout, getImageParts, hasComponentDirective, hasImages, headerLayouts, initAgentWidget, isComponentDirectiveType, markdownPostprocessor, mergeWithDefaults, normalizeContent, pluginRegistry, renderComponentDirective, renderLoadingIndicatorWithFallback, validateImageFile };