@runtypelabs/persona 1.44.2 → 1.46.0

package/dist/index.d.cts

@@ -65,6 +65,15 @@ interface AgentWidgetPlugin {
         defaultRenderer: () => HTMLElement;
         config: AgentWidgetConfig;
     }) => HTMLElement | null;
+    /**
+     * Custom renderer for approval bubbles
+     * Return null to use default renderer
+     */
+    renderApproval?: (context: {
+        message: AgentWidgetMessage;
+        defaultRenderer: () => HTMLElement;
+        config: AgentWidgetConfig;
+    }) => HTMLElement | null;
     /**
      * Custom renderer for loading indicator
      * Return null to use default renderer (or config-based renderer)
@@ -431,6 +440,14 @@ type AgentWidgetControllerEventMap = {
     "eventStream:closed": {
         timestamp: number;
     };
+    "approval:requested": {
+        approval: AgentWidgetApproval;
+        message: AgentWidgetMessage;
+    };
+    "approval:resolved": {
+        approval: AgentWidgetApproval;
+        decision: string;
+    };
 };
 type AgentWidgetFeatureFlags = {
     showReasoning?: boolean;
@@ -748,6 +765,49 @@ type AgentWidgetVoiceRecognitionConfig = {
     showRecordingIndicator?: boolean;
     autoResume?: boolean | "assistant";
 };
+/**
+ * Configuration for tool approval bubbles.
+ * Controls styling, labels, and behavior of the approval UI.
+ */
+type AgentWidgetApprovalConfig = {
+    /** Background color of the approval bubble */
+    backgroundColor?: string;
+    /** Border color of the approval bubble */
+    borderColor?: string;
+    /** Color for the title text */
+    titleColor?: string;
+    /** Color for the description text */
+    descriptionColor?: string;
+    /** Background color for the approve button */
+    approveButtonColor?: string;
+    /** Text color for the approve button */
+    approveButtonTextColor?: string;
+    /** Background color for the deny button */
+    denyButtonColor?: string;
+    /** Text color for the deny button */
+    denyButtonTextColor?: string;
+    /** Background color for the parameters block */
+    parameterBackgroundColor?: string;
+    /** Text color for the parameters block */
+    parameterTextColor?: string;
+    /** Title text displayed above the description */
+    title?: string;
+    /** Label for the approve button */
+    approveLabel?: string;
+    /** Label for the deny button */
+    denyLabel?: string;
+    /**
+     * Custom handler for approval decisions.
+     * Return void to let the SDK auto-resolve via the API,
+     * or return a Response/ReadableStream for custom handling.
+     */
+    onDecision?: (data: {
+        approvalId: string;
+        executionId: string;
+        agentId: string;
+        toolName: string;
+    }, decision: 'approved' | 'denied') => Promise<Response | ReadableStream<Uint8Array> | void>;
+};
 type AgentWidgetToolCallConfig = {
     backgroundColor?: string;
     borderColor?: string;
@@ -1760,6 +1820,13 @@ type AgentWidgetConfig = {
      */
     colorScheme?: 'auto' | 'light' | 'dark';
     features?: AgentWidgetFeatureFlags;
+    /**
+     * When true, focus the chat input after the panel opens and the open animation completes.
+     * Applies to launcher mode (user click, controller.open(), autoExpand) and inline mode (on init).
+     * Skip when voice is active to avoid stealing focus from voice UI.
+     * @default false
+     */
+    autoFocusInput?: boolean;
     launcher?: AgentWidgetLauncherConfig;
     initialMessages?: AgentWidgetMessage[];
     suggestionChips?: string[];
@@ -1771,6 +1838,23 @@ type AgentWidgetConfig = {
     statusIndicator?: AgentWidgetStatusIndicatorConfig;
     voiceRecognition?: AgentWidgetVoiceRecognitionConfig;
     toolCall?: AgentWidgetToolCallConfig;
+    /**
+     * Configuration for tool approval bubbles.
+     * Set to `false` to disable built-in approval handling entirely.
+     *
+     * @example
+     * ```typescript
+     * config: {
+     *   approval: {
+     *     title: "Permission Required",
+     *     approveLabel: "Allow",
+     *     denyLabel: "Block",
+     *     approveButtonColor: "#16a34a"
+     *   }
+     * }
+     * ```
+     */
+    approval?: AgentWidgetApprovalConfig | false;
     postprocessMessage?: (context: {
         text: string;
         message: AgentWidgetMessage;
@@ -2110,7 +2194,22 @@ type AgentWidgetToolCall = {
     completedAt?: number;
     durationMs?: number;
 };
-type AgentWidgetMessageVariant = "assistant" | "reasoning" | "tool";
+/**
+ * Represents a tool approval request in the chat conversation.
+ * Created when the agent requires human approval before executing a tool.
+ */
+type AgentWidgetApproval = {
+    id: string;
+    status: "pending" | "approved" | "denied" | "timeout";
+    agentId: string;
+    executionId: string;
+    toolName: string;
+    toolType?: string;
+    description: string;
+    parameters?: unknown;
+    resolvedAt?: number;
+};
+type AgentWidgetMessageVariant = "assistant" | "reasoning" | "tool" | "approval";
 /**
  * Represents a message in the chat conversation.
  *
@@ -2145,6 +2244,8 @@ type AgentWidgetMessage = {
     reasoning?: AgentWidgetReasoning;
     toolCall?: AgentWidgetToolCall;
     tools?: AgentWidgetToolCall[];
+    /** Approval data for messages with variant "approval" */
+    approval?: AgentWidgetApproval;
     viaVoice?: boolean;
     /**
      * Raw structured payload for this message (e.g., JSON action response).
@@ -2409,6 +2510,21 @@ declare class AgentWidgetClient {
      * Agent mode dispatch
      */
     private dispatchAgent;
+    /**
+     * Process an external SSE stream through the SDK's event pipeline.
+     * This allows piping responses from endpoints like agent approval
+     * through the same message/tool/reasoning handling as dispatch().
+     */
+    processStream(body: ReadableStream<Uint8Array>, onEvent: SSEHandler, assistantMessageId?: string): Promise<void>;
+    /**
+     * Send an approval decision to the API and return the response
+     * for streaming continuation.
+     */
+    resolveApproval(approval: {
+        agentId: string;
+        executionId: string;
+        approvalId: string;
+    }, decision: 'approved' | 'denied'): Promise<Response>;
     private buildAgentPayload;
     private buildPayload;
     /**
@@ -2604,6 +2720,19 @@ declare class AgentWidgetSession {
      * session.continueConversation();
      */
     continueConversation(): Promise<void>;
+    /**
+     * Connect an external SSE stream (e.g. from an approval endpoint) and
+     * process it through the SDK's native event pipeline.
+     */
+    connectStream(stream: ReadableStream<Uint8Array>, options?: {
+        assistantMessageId?: string;
+    }): Promise<void>;
+    /**
+     * Resolve a tool approval request (approve or deny).
+     * Updates the approval message status, calls the API (or custom onDecision),
+     * and pipes the response stream through connectStream().
+     */
+    resolveApproval(approval: AgentWidgetApproval, decision: 'approved' | 'denied'): Promise<void>;
     cancel(): void;
     clearMessages(): void;
     hydrateMessages(messages: AgentWidgetMessage[]): void;
@@ -2722,6 +2851,13 @@ type Controller = {
     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;
@@ -2733,6 +2869,17 @@ type Controller = {
     hideEventStream: () => void;
     /** Returns current visibility state of the event stream panel */
     isEventStreamVisible: () => boolean;
+    /**
+     * 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"
+     */
+    resolveApproval: (approvalId: string, decision: 'approved' | 'denied') => Promise<void>;
 };
 declare const createAgentExperience: (mount: HTMLElement, initialConfig?: AgentWidgetConfig, runtimeOptions?: {
     debugTools?: boolean;
@@ -3493,4 +3640,4 @@ declare const getHeaderLayout: (layoutName: string) => HeaderLayoutRenderer;
  */
 declare const buildHeaderWithLayout: (config: AgentWidgetConfig, layoutConfig?: AgentWidgetHeaderLayoutConfig, context?: Partial<HeaderLayoutContext>) => HeaderElements;
 
-export { type AgentConfig, type AgentExecutionState, type AgentLoopConfig, type AgentMessageMetadata, type AgentRequestOptions, type AgentWidgetAgentRequestPayload, type AgentWidgetAttachmentsConfig, type AgentWidgetAvatarConfig, AgentWidgetClient, type AgentWidgetConfig, type AgentWidgetController, type AgentWidgetControllerEventMap, type AgentWidgetCustomFetch, type AgentWidgetEvent, type AgentWidgetFeatureFlags, type AgentWidgetHeaderLayoutConfig, type AgentWidgetHeadersFunction, type AgentWidgetInitHandle, type AgentWidgetInitOptions, type AgentWidgetLauncherConfig, type AgentWidgetLayoutConfig, type AgentWidgetLoadingIndicatorConfig, type AgentWidgetMarkdownConfig, type AgentWidgetMarkdownOptions, type AgentWidgetMarkdownRendererOverrides, type AgentWidgetMessage, type AgentWidgetMessageActionsConfig, type AgentWidgetMessageFeedback, type AgentWidgetMessageLayoutConfig, type AgentWidgetPlugin, type AgentWidgetRequestPayload, type AgentWidgetSSEEventParser, type AgentWidgetSSEEventResult, AgentWidgetSession, type AgentWidgetSessionStatus, type AgentWidgetStreamParser, type AgentWidgetStreamParserResult, type AgentWidgetTheme, type AgentWidgetTimestampConfig, AttachmentManager, type AttachmentManagerConfig, type CSATFeedbackOptions, type ClientChatRequest, type ClientFeedbackRequest, type ClientFeedbackType, type ClientInitResponse, type ClientSession, type CodeFormat, type CodeGeneratorHooks, type CodeGeneratorOptions, type ComponentContext, type ComponentDirective, type ComponentRenderer, type ComposerBuildContext, type ComposerElements, type ContentPart, type CreateStandardBubbleOptions, DEFAULT_DARK_THEME, DEFAULT_LIGHT_THEME, DEFAULT_WIDGET_CONFIG, type EventStreamBadgeColor, type EventStreamConfig, type EventStreamPayloadRenderContext, type EventStreamRowRenderContext, type EventStreamToolbarRenderContext, type EventStreamViewRenderContext, type HeaderBuildContext, type HeaderElements, type HeaderLayoutContext, type HeaderLayoutRenderer, type HeaderRenderContext, type IdleIndicatorRenderContext, type ImageContentPart, type InjectAssistantMessageOptions, type InjectMessageOptions, type InjectSystemMessageOptions, type InjectUserMessageOptions, type LoadingIndicatorRenderContext, type LoadingIndicatorRenderer, type MarkdownProcessorOptions, type MessageActionCallbacks, type MessageContent, type MessageRenderContext, type MessageTransform, type NPSFeedbackOptions, type PendingAttachment, type SSEEventCallback, type SSEEventRecord, type SlotRenderContext, type SlotRenderer, type TextContentPart, VERSION, type 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 };
+export { type AgentConfig, type AgentExecutionState, type AgentLoopConfig, type AgentMessageMetadata, type AgentRequestOptions, type AgentWidgetAgentRequestPayload, type AgentWidgetApproval, type AgentWidgetApprovalConfig, type AgentWidgetAttachmentsConfig, type AgentWidgetAvatarConfig, AgentWidgetClient, type AgentWidgetConfig, type AgentWidgetController, type AgentWidgetControllerEventMap, type AgentWidgetCustomFetch, type AgentWidgetEvent, type AgentWidgetFeatureFlags, type AgentWidgetHeaderLayoutConfig, type AgentWidgetHeadersFunction, type AgentWidgetInitHandle, type AgentWidgetInitOptions, type AgentWidgetLauncherConfig, type AgentWidgetLayoutConfig, type AgentWidgetLoadingIndicatorConfig, type AgentWidgetMarkdownConfig, type AgentWidgetMarkdownOptions, type AgentWidgetMarkdownRendererOverrides, type AgentWidgetMessage, type AgentWidgetMessageActionsConfig, type AgentWidgetMessageFeedback, type AgentWidgetMessageLayoutConfig, type AgentWidgetPlugin, type AgentWidgetRequestPayload, type AgentWidgetSSEEventParser, type AgentWidgetSSEEventResult, AgentWidgetSession, type AgentWidgetSessionStatus, type AgentWidgetStreamParser, type AgentWidgetStreamParserResult, type AgentWidgetTheme, type AgentWidgetTimestampConfig, AttachmentManager, type AttachmentManagerConfig, type CSATFeedbackOptions, type ClientChatRequest, type ClientFeedbackRequest, type ClientFeedbackType, type ClientInitResponse, type ClientSession, type CodeFormat, type CodeGeneratorHooks, type CodeGeneratorOptions, type ComponentContext, type ComponentDirective, type ComponentRenderer, type ComposerBuildContext, type ComposerElements, type ContentPart, type CreateStandardBubbleOptions, DEFAULT_DARK_THEME, DEFAULT_LIGHT_THEME, DEFAULT_WIDGET_CONFIG, type EventStreamBadgeColor, type EventStreamConfig, type EventStreamPayloadRenderContext, type EventStreamRowRenderContext, type EventStreamToolbarRenderContext, type EventStreamViewRenderContext, type HeaderBuildContext, type HeaderElements, type HeaderLayoutContext, type HeaderLayoutRenderer, type HeaderRenderContext, type IdleIndicatorRenderContext, type ImageContentPart, type InjectAssistantMessageOptions, type InjectMessageOptions, type InjectSystemMessageOptions, type InjectUserMessageOptions, type LoadingIndicatorRenderContext, type LoadingIndicatorRenderer, type MarkdownProcessorOptions, type MessageActionCallbacks, type MessageContent, type MessageRenderContext, type MessageTransform, type NPSFeedbackOptions, type PendingAttachment, type SSEEventCallback, type SSEEventRecord, type SlotRenderContext, type SlotRenderer, type TextContentPart, VERSION, type 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,15 @@ interface AgentWidgetPlugin {
         defaultRenderer: () => HTMLElement;
         config: AgentWidgetConfig;
     }) => HTMLElement | null;
+    /**
+     * Custom renderer for approval bubbles
+     * Return null to use default renderer
+     */
+    renderApproval?: (context: {
+        message: AgentWidgetMessage;
+        defaultRenderer: () => HTMLElement;
+        config: AgentWidgetConfig;
+    }) => HTMLElement | null;
     /**
      * Custom renderer for loading indicator
      * Return null to use default renderer (or config-based renderer)
@@ -431,6 +440,14 @@ type AgentWidgetControllerEventMap = {
     "eventStream:closed": {
         timestamp: number;
     };
+    "approval:requested": {
+        approval: AgentWidgetApproval;
+        message: AgentWidgetMessage;
+    };
+    "approval:resolved": {
+        approval: AgentWidgetApproval;
+        decision: string;
+    };
 };
 type AgentWidgetFeatureFlags = {
     showReasoning?: boolean;
@@ -748,6 +765,49 @@ type AgentWidgetVoiceRecognitionConfig = {
     showRecordingIndicator?: boolean;
     autoResume?: boolean | "assistant";
 };
+/**
+ * Configuration for tool approval bubbles.
+ * Controls styling, labels, and behavior of the approval UI.
+ */
+type AgentWidgetApprovalConfig = {
+    /** Background color of the approval bubble */
+    backgroundColor?: string;
+    /** Border color of the approval bubble */
+    borderColor?: string;
+    /** Color for the title text */
+    titleColor?: string;
+    /** Color for the description text */
+    descriptionColor?: string;
+    /** Background color for the approve button */
+    approveButtonColor?: string;
+    /** Text color for the approve button */
+    approveButtonTextColor?: string;
+    /** Background color for the deny button */
+    denyButtonColor?: string;
+    /** Text color for the deny button */
+    denyButtonTextColor?: string;
+    /** Background color for the parameters block */
+    parameterBackgroundColor?: string;
+    /** Text color for the parameters block */
+    parameterTextColor?: string;
+    /** Title text displayed above the description */
+    title?: string;
+    /** Label for the approve button */
+    approveLabel?: string;
+    /** Label for the deny button */
+    denyLabel?: string;
+    /**
+     * Custom handler for approval decisions.
+     * Return void to let the SDK auto-resolve via the API,
+     * or return a Response/ReadableStream for custom handling.
+     */
+    onDecision?: (data: {
+        approvalId: string;
+        executionId: string;
+        agentId: string;
+        toolName: string;
+    }, decision: 'approved' | 'denied') => Promise<Response | ReadableStream<Uint8Array> | void>;
+};
 type AgentWidgetToolCallConfig = {
     backgroundColor?: string;
     borderColor?: string;
@@ -1760,6 +1820,13 @@ type AgentWidgetConfig = {
      */
     colorScheme?: 'auto' | 'light' | 'dark';
     features?: AgentWidgetFeatureFlags;
+    /**
+     * When true, focus the chat input after the panel opens and the open animation completes.
+     * Applies to launcher mode (user click, controller.open(), autoExpand) and inline mode (on init).
+     * Skip when voice is active to avoid stealing focus from voice UI.
+     * @default false
+     */
+    autoFocusInput?: boolean;
     launcher?: AgentWidgetLauncherConfig;
     initialMessages?: AgentWidgetMessage[];
     suggestionChips?: string[];
@@ -1771,6 +1838,23 @@ type AgentWidgetConfig = {
     statusIndicator?: AgentWidgetStatusIndicatorConfig;
     voiceRecognition?: AgentWidgetVoiceRecognitionConfig;
     toolCall?: AgentWidgetToolCallConfig;
+    /**
+     * Configuration for tool approval bubbles.
+     * Set to `false` to disable built-in approval handling entirely.
+     *
+     * @example
+     * ```typescript
+     * config: {
+     *   approval: {
+     *     title: "Permission Required",
+     *     approveLabel: "Allow",
+     *     denyLabel: "Block",
+     *     approveButtonColor: "#16a34a"
+     *   }
+     * }
+     * ```
+     */
+    approval?: AgentWidgetApprovalConfig | false;
     postprocessMessage?: (context: {
         text: string;
         message: AgentWidgetMessage;
@@ -2110,7 +2194,22 @@ type AgentWidgetToolCall = {
     completedAt?: number;
     durationMs?: number;
 };
-type AgentWidgetMessageVariant = "assistant" | "reasoning" | "tool";
+/**
+ * Represents a tool approval request in the chat conversation.
+ * Created when the agent requires human approval before executing a tool.
+ */
+type AgentWidgetApproval = {
+    id: string;
+    status: "pending" | "approved" | "denied" | "timeout";
+    agentId: string;
+    executionId: string;
+    toolName: string;
+    toolType?: string;
+    description: string;
+    parameters?: unknown;
+    resolvedAt?: number;
+};
+type AgentWidgetMessageVariant = "assistant" | "reasoning" | "tool" | "approval";
 /**
  * Represents a message in the chat conversation.
  *
@@ -2145,6 +2244,8 @@ type AgentWidgetMessage = {
     reasoning?: AgentWidgetReasoning;
     toolCall?: AgentWidgetToolCall;
     tools?: AgentWidgetToolCall[];
+    /** Approval data for messages with variant "approval" */
+    approval?: AgentWidgetApproval;
     viaVoice?: boolean;
     /**
      * Raw structured payload for this message (e.g., JSON action response).
@@ -2409,6 +2510,21 @@ declare class AgentWidgetClient {
      * Agent mode dispatch
      */
     private dispatchAgent;
+    /**
+     * Process an external SSE stream through the SDK's event pipeline.
+     * This allows piping responses from endpoints like agent approval
+     * through the same message/tool/reasoning handling as dispatch().
+     */
+    processStream(body: ReadableStream<Uint8Array>, onEvent: SSEHandler, assistantMessageId?: string): Promise<void>;
+    /**
+     * Send an approval decision to the API and return the response
+     * for streaming continuation.
+     */
+    resolveApproval(approval: {
+        agentId: string;
+        executionId: string;
+        approvalId: string;
+    }, decision: 'approved' | 'denied'): Promise<Response>;
     private buildAgentPayload;
     private buildPayload;
     /**
@@ -2604,6 +2720,19 @@ declare class AgentWidgetSession {
      * session.continueConversation();
      */
     continueConversation(): Promise<void>;
+    /**
+     * Connect an external SSE stream (e.g. from an approval endpoint) and
+     * process it through the SDK's native event pipeline.
+     */
+    connectStream(stream: ReadableStream<Uint8Array>, options?: {
+        assistantMessageId?: string;
+    }): Promise<void>;
+    /**
+     * Resolve a tool approval request (approve or deny).
+     * Updates the approval message status, calls the API (or custom onDecision),
+     * and pipes the response stream through connectStream().
+     */
+    resolveApproval(approval: AgentWidgetApproval, decision: 'approved' | 'denied'): Promise<void>;
     cancel(): void;
     clearMessages(): void;
     hydrateMessages(messages: AgentWidgetMessage[]): void;
@@ -2722,6 +2851,13 @@ type Controller = {
     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;
@@ -2733,6 +2869,17 @@ type Controller = {
     hideEventStream: () => void;
     /** Returns current visibility state of the event stream panel */
     isEventStreamVisible: () => boolean;
+    /**
+     * 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"
+     */
+    resolveApproval: (approvalId: string, decision: 'approved' | 'denied') => Promise<void>;
 };
 declare const createAgentExperience: (mount: HTMLElement, initialConfig?: AgentWidgetConfig, runtimeOptions?: {
     debugTools?: boolean;
@@ -3493,4 +3640,4 @@ declare const getHeaderLayout: (layoutName: string) => HeaderLayoutRenderer;
  */
 declare const buildHeaderWithLayout: (config: AgentWidgetConfig, layoutConfig?: AgentWidgetHeaderLayoutConfig, context?: Partial<HeaderLayoutContext>) => HeaderElements;
 
-export { type AgentConfig, type AgentExecutionState, type AgentLoopConfig, type AgentMessageMetadata, type AgentRequestOptions, type AgentWidgetAgentRequestPayload, type AgentWidgetAttachmentsConfig, type AgentWidgetAvatarConfig, AgentWidgetClient, type AgentWidgetConfig, type AgentWidgetController, type AgentWidgetControllerEventMap, type AgentWidgetCustomFetch, type AgentWidgetEvent, type AgentWidgetFeatureFlags, type AgentWidgetHeaderLayoutConfig, type AgentWidgetHeadersFunction, type AgentWidgetInitHandle, type AgentWidgetInitOptions, type AgentWidgetLauncherConfig, type AgentWidgetLayoutConfig, type AgentWidgetLoadingIndicatorConfig, type AgentWidgetMarkdownConfig, type AgentWidgetMarkdownOptions, type AgentWidgetMarkdownRendererOverrides, type AgentWidgetMessage, type AgentWidgetMessageActionsConfig, type AgentWidgetMessageFeedback, type AgentWidgetMessageLayoutConfig, type AgentWidgetPlugin, type AgentWidgetRequestPayload, type AgentWidgetSSEEventParser, type AgentWidgetSSEEventResult, AgentWidgetSession, type AgentWidgetSessionStatus, type AgentWidgetStreamParser, type AgentWidgetStreamParserResult, type AgentWidgetTheme, type AgentWidgetTimestampConfig, AttachmentManager, type AttachmentManagerConfig, type CSATFeedbackOptions, type ClientChatRequest, type ClientFeedbackRequest, type ClientFeedbackType, type ClientInitResponse, type ClientSession, type CodeFormat, type CodeGeneratorHooks, type CodeGeneratorOptions, type ComponentContext, type ComponentDirective, type ComponentRenderer, type ComposerBuildContext, type ComposerElements, type ContentPart, type CreateStandardBubbleOptions, DEFAULT_DARK_THEME, DEFAULT_LIGHT_THEME, DEFAULT_WIDGET_CONFIG, type EventStreamBadgeColor, type EventStreamConfig, type EventStreamPayloadRenderContext, type EventStreamRowRenderContext, type EventStreamToolbarRenderContext, type EventStreamViewRenderContext, type HeaderBuildContext, type HeaderElements, type HeaderLayoutContext, type HeaderLayoutRenderer, type HeaderRenderContext, type IdleIndicatorRenderContext, type ImageContentPart, type InjectAssistantMessageOptions, type InjectMessageOptions, type InjectSystemMessageOptions, type InjectUserMessageOptions, type LoadingIndicatorRenderContext, type LoadingIndicatorRenderer, type MarkdownProcessorOptions, type MessageActionCallbacks, type MessageContent, type MessageRenderContext, type MessageTransform, type NPSFeedbackOptions, type PendingAttachment, type SSEEventCallback, type SSEEventRecord, type SlotRenderContext, type SlotRenderer, type TextContentPart, VERSION, type 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 };
+export { type AgentConfig, type AgentExecutionState, type AgentLoopConfig, type AgentMessageMetadata, type AgentRequestOptions, type AgentWidgetAgentRequestPayload, type AgentWidgetApproval, type AgentWidgetApprovalConfig, type AgentWidgetAttachmentsConfig, type AgentWidgetAvatarConfig, AgentWidgetClient, type AgentWidgetConfig, type AgentWidgetController, type AgentWidgetControllerEventMap, type AgentWidgetCustomFetch, type AgentWidgetEvent, type AgentWidgetFeatureFlags, type AgentWidgetHeaderLayoutConfig, type AgentWidgetHeadersFunction, type AgentWidgetInitHandle, type AgentWidgetInitOptions, type AgentWidgetLauncherConfig, type AgentWidgetLayoutConfig, type AgentWidgetLoadingIndicatorConfig, type AgentWidgetMarkdownConfig, type AgentWidgetMarkdownOptions, type AgentWidgetMarkdownRendererOverrides, type AgentWidgetMessage, type AgentWidgetMessageActionsConfig, type AgentWidgetMessageFeedback, type AgentWidgetMessageLayoutConfig, type AgentWidgetPlugin, type AgentWidgetRequestPayload, type AgentWidgetSSEEventParser, type AgentWidgetSSEEventResult, AgentWidgetSession, type AgentWidgetSessionStatus, type AgentWidgetStreamParser, type AgentWidgetStreamParserResult, type AgentWidgetTheme, type AgentWidgetTimestampConfig, AttachmentManager, type AttachmentManagerConfig, type CSATFeedbackOptions, type ClientChatRequest, type ClientFeedbackRequest, type ClientFeedbackType, type ClientInitResponse, type ClientSession, type CodeFormat, type CodeGeneratorHooks, type CodeGeneratorOptions, type ComponentContext, type ComponentDirective, type ComponentRenderer, type ComposerBuildContext, type ComposerElements, type ContentPart, type CreateStandardBubbleOptions, DEFAULT_DARK_THEME, DEFAULT_LIGHT_THEME, DEFAULT_WIDGET_CONFIG, type EventStreamBadgeColor, type EventStreamConfig, type EventStreamPayloadRenderContext, type EventStreamRowRenderContext, type EventStreamToolbarRenderContext, type EventStreamViewRenderContext, type HeaderBuildContext, type HeaderElements, type HeaderLayoutContext, type HeaderLayoutRenderer, type HeaderRenderContext, type IdleIndicatorRenderContext, type ImageContentPart, type InjectAssistantMessageOptions, type InjectMessageOptions, type InjectSystemMessageOptions, type InjectUserMessageOptions, type LoadingIndicatorRenderContext, type LoadingIndicatorRenderer, type MarkdownProcessorOptions, type MessageActionCallbacks, type MessageContent, type MessageRenderContext, type MessageTransform, type NPSFeedbackOptions, type PendingAttachment, type SSEEventCallback, type SSEEventRecord, type SlotRenderContext, type SlotRenderer, type TextContentPart, VERSION, type 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 };