vanilla-agent 1.21.0 → 1.22.0

package/dist/index.d.cts

@@ -135,6 +135,64 @@ type AgentWidgetActionEventPayload = {
     action: AgentWidgetParsedAction;
     message: AgentWidgetMessage;
 };
+/**
+ * Feedback event payload for upvote/downvote actions on messages
+ */
+type AgentWidgetMessageFeedback = {
+    type: "upvote" | "downvote";
+    messageId: string;
+    message: AgentWidgetMessage;
+};
+/**
+ * Configuration for message action buttons (copy, upvote, downvote)
+ */
+type AgentWidgetMessageActionsConfig = {
+    /**
+     * Enable/disable message actions entirely
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Show copy button
+     * @default true
+     */
+    showCopy?: boolean;
+    /**
+     * Show upvote button
+     * @default false (requires backend)
+     */
+    showUpvote?: boolean;
+    /**
+     * Show downvote button
+     * @default false (requires backend)
+     */
+    showDownvote?: boolean;
+    /**
+     * Visibility mode: 'always' shows buttons always, 'hover' shows on hover only
+     * @default 'hover'
+     */
+    visibility?: "always" | "hover";
+    /**
+     * Horizontal alignment of action buttons
+     * @default 'right'
+     */
+    align?: "left" | "center" | "right";
+    /**
+     * Layout style for action buttons
+     * - 'pill-inside': Compact floating pill around just the buttons (default for hover)
+     * - 'row-inside': Full-width row at the bottom of the message
+     * @default 'pill-inside'
+     */
+    layout?: "pill-inside" | "row-inside";
+    /**
+     * Callback when user submits feedback (upvote/downvote)
+     */
+    onFeedback?: (feedback: AgentWidgetMessageFeedback) => void;
+    /**
+     * Callback when user copies a message
+     */
+    onCopy?: (message: AgentWidgetMessage) => void;
+};
 type AgentWidgetStateEvent = {
     open: boolean;
     source: "user" | "auto" | "api" | "system";
@@ -154,6 +212,8 @@ type AgentWidgetControllerEventMap = {
     "widget:opened": AgentWidgetStateEvent;
     "widget:closed": AgentWidgetStateEvent;
     "widget:state": AgentWidgetStateSnapshot;
+    "message:feedback": AgentWidgetMessageFeedback;
+    "message:copy": AgentWidgetMessage;
 };
 type AgentWidgetFeatureFlags = {
     showReasoning?: boolean;
@@ -464,6 +524,55 @@ type AgentWidgetCustomFetch = (url: string, init: RequestInit, payload: AgentWid
  * Dynamic headers function - called before each request
  */
 type AgentWidgetHeadersFunction = () => Record<string, string> | Promise<Record<string, string>>;
+/**
+ * Session information returned after client token initialization.
+ * Contains session ID, expiry time, flow info, and config from the server.
+ */
+type ClientSession = {
+    /** Unique session identifier */
+    sessionId: string;
+    /** When the session expires */
+    expiresAt: Date;
+    /** Flow information */
+    flow: {
+        id: string;
+        name: string;
+        description: string | null;
+    };
+    /** Configuration from the server */
+    config: {
+        welcomeMessage: string | null;
+        placeholder: string;
+        theme: Record<string, unknown> | null;
+    };
+};
+/**
+ * Raw API response from /v1/client/init endpoint
+ */
+type ClientInitResponse = {
+    session_id: string;
+    expires_at: string;
+    flow: {
+        id: string;
+        name: string;
+        description: string | null;
+    };
+    config: {
+        welcome_message: string | null;
+        placeholder: string;
+        theme: Record<string, unknown> | null;
+    };
+};
+/**
+ * Request payload for /v1/client/chat endpoint
+ */
+type ClientChatRequest = {
+    session_id: string;
+    messages: Array<{
+        role: 'user' | 'assistant' | 'system';
+        content: string;
+    }>;
+};
 /**
  * Context provided to header render functions
  */
@@ -877,6 +986,47 @@ type AgentWidgetMarkdownConfig = {
 type AgentWidgetConfig = {
     apiUrl?: string;
     flowId?: string;
+    /**
+     * Client token for direct browser-to-API communication.
+     * When set, the widget uses /v1/client/* endpoints instead of /v1/dispatch.
+     * Mutually exclusive with apiKey/headers authentication.
+     *
+     * @example
+     * ```typescript
+     * config: {
+     *   clientToken: 'ct_live_flow01k7_a8b9c0d1e2f3g4h5i6j7k8l9'
+     * }
+     * ```
+     */
+    clientToken?: string;
+    /**
+     * Callback when session is initialized (client token mode only).
+     * Receives session info including expiry time.
+     *
+     * @example
+     * ```typescript
+     * config: {
+     *   onSessionInit: (session) => {
+     *     console.log('Session started:', session.sessionId);
+     *   }
+     * }
+     * ```
+     */
+    onSessionInit?: (session: ClientSession) => void;
+    /**
+     * Callback when session expires or errors (client token mode only).
+     * Widget should prompt user to refresh.
+     *
+     * @example
+     * ```typescript
+     * config: {
+     *   onSessionExpired: () => {
+     *     alert('Your session has expired. Please refresh the page.');
+     *   }
+     * }
+     * ```
+     */
+    onSessionExpired?: () => void;
     /**
      * Static headers to include with each request.
      * For dynamic headers (e.g., auth tokens), use `getHeaders` instead.
@@ -1108,6 +1258,30 @@ type AgentWidgetConfig = {
      * ```
      */
     markdown?: AgentWidgetMarkdownConfig;
+    /**
+     * Configuration for message action buttons (copy, upvote, downvote).
+     * Shows action buttons on assistant messages for user feedback.
+     *
+     * @example
+     * ```typescript
+     * config: {
+     *   messageActions: {
+     *     enabled: true,
+     *     showCopy: true,
+     *     showUpvote: true,
+     *     showDownvote: true,
+     *     visibility: 'hover',
+     *     onFeedback: (feedback) => {
+     *       console.log('Feedback:', feedback.type, feedback.messageId);
+     *     },
+     *     onCopy: (message) => {
+     *       console.log('Copied message:', message.id);
+     *     }
+     *   }
+     * }
+     * ```
+     */
+    messageActions?: AgentWidgetMessageActionsConfig;
 };
 type AgentWidgetMessageRole = "user" | "assistant" | "system";
 type AgentWidgetReasoning = {
@@ -1200,7 +1374,34 @@ declare class AgentWidgetSession {
     private streaming;
     private abortController;
     private sequenceCounter;
+    private clientSession;
     constructor(config: AgentWidgetConfig | undefined, callbacks: SessionCallbacks);
+    /**
+     * Check if running in client token mode
+     */
+    isClientTokenMode(): boolean;
+    /**
+     * Initialize the client session (for client token mode).
+     * This is called automatically on first message, but can be called
+     * explicitly to pre-initialize the session and get config from server.
+     */
+    initClientSession(): Promise<ClientSession | null>;
+    /**
+     * Set the client session after initialization
+     */
+    setClientSession(session: ClientSession): void;
+    /**
+     * Get current client session
+     */
+    getClientSession(): ClientSession | null;
+    /**
+     * Check if session is valid and not expired
+     */
+    isSessionValid(): boolean;
+    /**
+     * Clear session (on expiry or error)
+     */
+    clearClientSession(): void;
     updateConfig(next: AgentWidgetConfig): void;
     getMessages(): AgentWidgetMessage[];
     getStatus(): AgentWidgetSessionStatus;
@@ -1270,8 +1471,43 @@ declare class AgentWidgetClient {
     private readonly customFetch?;
     private readonly parseSSEEvent?;
     private readonly getHeaders?;
+    private clientSession;
+    private sessionInitPromise;
     constructor(config?: AgentWidgetConfig);
+    /**
+     * Check if running in client token mode
+     */
+    isClientTokenMode(): boolean;
+    /**
+     * Get the appropriate API URL based on mode
+     */
+    private getClientApiUrl;
+    /**
+     * Get the current client session (if any)
+     */
+    getClientSession(): ClientSession | null;
+    /**
+     * Initialize session for client token mode.
+     * Called automatically on first message if not already initialized.
+     */
+    initSession(): Promise<ClientSession>;
+    private _doInitSession;
+    /**
+     * Clear the current client session
+     */
+    clearClientSession(): void;
+    /**
+     * Send a message - handles both proxy and client token modes
+     */
     dispatch(options: DispatchOptions, onEvent: SSEHandler): Promise<void>;
+    /**
+     * Client token mode dispatch
+     */
+    private dispatchClientToken;
+    /**
+     * Proxy mode dispatch (original implementation)
+     */
+    private dispatchProxy;
     private buildPayload;
     /**
      * Handle custom SSE event parsing via parseSSEEvent callback
@@ -1537,17 +1773,25 @@ type MessageTransform = (context: {
     streaming: boolean;
     raw?: string;
 }) => string;
+type MessageActionCallbacks = {
+    onCopy?: (message: AgentWidgetMessage) => void;
+    onFeedback?: (feedback: AgentWidgetMessageFeedback) => void;
+};
 declare const createTypingIndicator: () => HTMLElement;
+/**
+ * Create message action buttons (copy, upvote, downvote)
+ */
+declare const createMessageActions: (message: AgentWidgetMessage, actionsConfig: AgentWidgetMessageActionsConfig, callbacks?: MessageActionCallbacks) => HTMLElement;
 /**
  * Create standard message bubble
  * Supports layout configuration for avatars, timestamps, and visual presets
  */
-declare const createStandardBubble: (message: AgentWidgetMessage, transform: MessageTransform, layoutConfig?: AgentWidgetMessageLayoutConfig) => HTMLElement;
+declare const createStandardBubble: (message: AgentWidgetMessage, transform: MessageTransform, layoutConfig?: AgentWidgetMessageLayoutConfig, actionsConfig?: AgentWidgetMessageActionsConfig, actionCallbacks?: MessageActionCallbacks) => 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) => HTMLElement;
+declare const createBubbleWithLayout: (message: AgentWidgetMessage, transform: MessageTransform, layoutConfig?: AgentWidgetMessageLayoutConfig, actionsConfig?: AgentWidgetMessageActionsConfig, actionCallbacks?: MessageActionCallbacks) => HTMLElement;
 
 /**
  * Options for component middleware
@@ -1684,4 +1928,4 @@ declare const getHeaderLayout: (layoutName: string) => HeaderLayoutRenderer;
  */
 declare const buildHeaderWithLayout: (config: AgentWidgetConfig, layoutConfig?: AgentWidgetHeaderLayoutConfig, context?: Partial<HeaderLayoutContext>) => HeaderElements;
 
-export { 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 AgentWidgetMessageLayoutConfig, type AgentWidgetPlugin, type AgentWidgetRequestPayload, type AgentWidgetSSEEventParser, type AgentWidgetSSEEventResult, AgentWidgetSession, type AgentWidgetSessionStatus, type AgentWidgetStreamParser, type AgentWidgetStreamParserResult, type AgentWidgetTheme, type AgentWidgetTimestampConfig, type CodeFormat, type ComponentContext, type ComponentDirective, type ComponentRenderer, type ComposerBuildContext, type ComposerElements, DEFAULT_WIDGET_CONFIG, type HeaderBuildContext, type HeaderElements, type HeaderLayoutContext, type HeaderLayoutRenderer, type HeaderRenderContext, type MarkdownProcessorOptions, type MessageRenderContext, type MessageTransform, type SlotRenderContext, type SlotRenderer, type WidgetLayoutSlot, attachHeaderToContainer, buildComposer, buildDefaultHeader, buildExpandedHeader, buildHeader, buildHeaderWithLayout, buildMinimalHeader, componentRegistry, createActionManager, createAgentExperience, createBubbleWithLayout, createComponentMiddleware, createComponentStreamParser, createDirectivePostprocessor, createFlexibleJsonStreamParser, createJsonStreamParser, createLocalStorageAdapter, createMarkdownProcessor, createMarkdownProcessorFromConfig, createPlainTextParser, createRegexJsonParser, createStandardBubble, createTypingIndicator, createXmlParser, initAgentWidget as default, defaultActionHandlers, defaultJsonActionParser, directivePostprocessor, escapeHtml, extractComponentDirectiveFromMessage, generateCodeSnippet, getHeaderLayout, hasComponentDirective, headerLayouts, initAgentWidget, isComponentDirectiveType, markdownPostprocessor, mergeWithDefaults, pluginRegistry, renderComponentDirective };
+export { 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, type ClientChatRequest, type ClientInitResponse, type ClientSession, type CodeFormat, type ComponentContext, type ComponentDirective, type ComponentRenderer, type ComposerBuildContext, type ComposerElements, DEFAULT_WIDGET_CONFIG, type HeaderBuildContext, type HeaderElements, type HeaderLayoutContext, type HeaderLayoutRenderer, type HeaderRenderContext, type MarkdownProcessorOptions, type MessageActionCallbacks, type MessageRenderContext, type MessageTransform, type SlotRenderContext, type SlotRenderer, type WidgetLayoutSlot, attachHeaderToContainer, buildComposer, buildDefaultHeader, buildExpandedHeader, buildHeader, buildHeaderWithLayout, buildMinimalHeader, componentRegistry, createActionManager, createAgentExperience, createBubbleWithLayout, createComponentMiddleware, createComponentStreamParser, createDirectivePostprocessor, createFlexibleJsonStreamParser, createJsonStreamParser, createLocalStorageAdapter, createMarkdownProcessor, createMarkdownProcessorFromConfig, createMessageActions, createPlainTextParser, createRegexJsonParser, createStandardBubble, createTypingIndicator, createXmlParser, initAgentWidget as default, defaultActionHandlers, defaultJsonActionParser, directivePostprocessor, escapeHtml, extractComponentDirectiveFromMessage, generateCodeSnippet, getHeaderLayout, hasComponentDirective, headerLayouts, initAgentWidget, isComponentDirectiveType, markdownPostprocessor, mergeWithDefaults, pluginRegistry, renderComponentDirective };

package/dist/index.d.ts

@@ -135,6 +135,64 @@ type AgentWidgetActionEventPayload = {
     action: AgentWidgetParsedAction;
     message: AgentWidgetMessage;
 };
+/**
+ * Feedback event payload for upvote/downvote actions on messages
+ */
+type AgentWidgetMessageFeedback = {
+    type: "upvote" | "downvote";
+    messageId: string;
+    message: AgentWidgetMessage;
+};
+/**
+ * Configuration for message action buttons (copy, upvote, downvote)
+ */
+type AgentWidgetMessageActionsConfig = {
+    /**
+     * Enable/disable message actions entirely
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Show copy button
+     * @default true
+     */
+    showCopy?: boolean;
+    /**
+     * Show upvote button
+     * @default false (requires backend)
+     */
+    showUpvote?: boolean;
+    /**
+     * Show downvote button
+     * @default false (requires backend)
+     */
+    showDownvote?: boolean;
+    /**
+     * Visibility mode: 'always' shows buttons always, 'hover' shows on hover only
+     * @default 'hover'
+     */
+    visibility?: "always" | "hover";
+    /**
+     * Horizontal alignment of action buttons
+     * @default 'right'
+     */
+    align?: "left" | "center" | "right";
+    /**
+     * Layout style for action buttons
+     * - 'pill-inside': Compact floating pill around just the buttons (default for hover)
+     * - 'row-inside': Full-width row at the bottom of the message
+     * @default 'pill-inside'
+     */
+    layout?: "pill-inside" | "row-inside";
+    /**
+     * Callback when user submits feedback (upvote/downvote)
+     */
+    onFeedback?: (feedback: AgentWidgetMessageFeedback) => void;
+    /**
+     * Callback when user copies a message
+     */
+    onCopy?: (message: AgentWidgetMessage) => void;
+};
 type AgentWidgetStateEvent = {
     open: boolean;
     source: "user" | "auto" | "api" | "system";
@@ -154,6 +212,8 @@ type AgentWidgetControllerEventMap = {
     "widget:opened": AgentWidgetStateEvent;
     "widget:closed": AgentWidgetStateEvent;
     "widget:state": AgentWidgetStateSnapshot;
+    "message:feedback": AgentWidgetMessageFeedback;
+    "message:copy": AgentWidgetMessage;
 };
 type AgentWidgetFeatureFlags = {
     showReasoning?: boolean;
@@ -464,6 +524,55 @@ type AgentWidgetCustomFetch = (url: string, init: RequestInit, payload: AgentWid
  * Dynamic headers function - called before each request
  */
 type AgentWidgetHeadersFunction = () => Record<string, string> | Promise<Record<string, string>>;
+/**
+ * Session information returned after client token initialization.
+ * Contains session ID, expiry time, flow info, and config from the server.
+ */
+type ClientSession = {
+    /** Unique session identifier */
+    sessionId: string;
+    /** When the session expires */
+    expiresAt: Date;
+    /** Flow information */
+    flow: {
+        id: string;
+        name: string;
+        description: string | null;
+    };
+    /** Configuration from the server */
+    config: {
+        welcomeMessage: string | null;
+        placeholder: string;
+        theme: Record<string, unknown> | null;
+    };
+};
+/**
+ * Raw API response from /v1/client/init endpoint
+ */
+type ClientInitResponse = {
+    session_id: string;
+    expires_at: string;
+    flow: {
+        id: string;
+        name: string;
+        description: string | null;
+    };
+    config: {
+        welcome_message: string | null;
+        placeholder: string;
+        theme: Record<string, unknown> | null;
+    };
+};
+/**
+ * Request payload for /v1/client/chat endpoint
+ */
+type ClientChatRequest = {
+    session_id: string;
+    messages: Array<{
+        role: 'user' | 'assistant' | 'system';
+        content: string;
+    }>;
+};
 /**
  * Context provided to header render functions
  */
@@ -877,6 +986,47 @@ type AgentWidgetMarkdownConfig = {
 type AgentWidgetConfig = {
     apiUrl?: string;
     flowId?: string;
+    /**
+     * Client token for direct browser-to-API communication.
+     * When set, the widget uses /v1/client/* endpoints instead of /v1/dispatch.
+     * Mutually exclusive with apiKey/headers authentication.
+     *
+     * @example
+     * ```typescript
+     * config: {
+     *   clientToken: 'ct_live_flow01k7_a8b9c0d1e2f3g4h5i6j7k8l9'
+     * }
+     * ```
+     */
+    clientToken?: string;
+    /**
+     * Callback when session is initialized (client token mode only).
+     * Receives session info including expiry time.
+     *
+     * @example
+     * ```typescript
+     * config: {
+     *   onSessionInit: (session) => {
+     *     console.log('Session started:', session.sessionId);
+     *   }
+     * }
+     * ```
+     */
+    onSessionInit?: (session: ClientSession) => void;
+    /**
+     * Callback when session expires or errors (client token mode only).
+     * Widget should prompt user to refresh.
+     *
+     * @example
+     * ```typescript
+     * config: {
+     *   onSessionExpired: () => {
+     *     alert('Your session has expired. Please refresh the page.');
+     *   }
+     * }
+     * ```
+     */
+    onSessionExpired?: () => void;
     /**
      * Static headers to include with each request.
      * For dynamic headers (e.g., auth tokens), use `getHeaders` instead.
@@ -1108,6 +1258,30 @@ type AgentWidgetConfig = {
      * ```
      */
     markdown?: AgentWidgetMarkdownConfig;
+    /**
+     * Configuration for message action buttons (copy, upvote, downvote).
+     * Shows action buttons on assistant messages for user feedback.
+     *
+     * @example
+     * ```typescript
+     * config: {
+     *   messageActions: {
+     *     enabled: true,
+     *     showCopy: true,
+     *     showUpvote: true,
+     *     showDownvote: true,
+     *     visibility: 'hover',
+     *     onFeedback: (feedback) => {
+     *       console.log('Feedback:', feedback.type, feedback.messageId);
+     *     },
+     *     onCopy: (message) => {
+     *       console.log('Copied message:', message.id);
+     *     }
+     *   }
+     * }
+     * ```
+     */
+    messageActions?: AgentWidgetMessageActionsConfig;
 };
 type AgentWidgetMessageRole = "user" | "assistant" | "system";
 type AgentWidgetReasoning = {
@@ -1200,7 +1374,34 @@ declare class AgentWidgetSession {
     private streaming;
     private abortController;
     private sequenceCounter;
+    private clientSession;
     constructor(config: AgentWidgetConfig | undefined, callbacks: SessionCallbacks);
+    /**
+     * Check if running in client token mode
+     */
+    isClientTokenMode(): boolean;
+    /**
+     * Initialize the client session (for client token mode).
+     * This is called automatically on first message, but can be called
+     * explicitly to pre-initialize the session and get config from server.
+     */
+    initClientSession(): Promise<ClientSession | null>;
+    /**
+     * Set the client session after initialization
+     */
+    setClientSession(session: ClientSession): void;
+    /**
+     * Get current client session
+     */
+    getClientSession(): ClientSession | null;
+    /**
+     * Check if session is valid and not expired
+     */
+    isSessionValid(): boolean;
+    /**
+     * Clear session (on expiry or error)
+     */
+    clearClientSession(): void;
     updateConfig(next: AgentWidgetConfig): void;
     getMessages(): AgentWidgetMessage[];
     getStatus(): AgentWidgetSessionStatus;
@@ -1270,8 +1471,43 @@ declare class AgentWidgetClient {
     private readonly customFetch?;
     private readonly parseSSEEvent?;
     private readonly getHeaders?;
+    private clientSession;
+    private sessionInitPromise;
     constructor(config?: AgentWidgetConfig);
+    /**
+     * Check if running in client token mode
+     */
+    isClientTokenMode(): boolean;
+    /**
+     * Get the appropriate API URL based on mode
+     */
+    private getClientApiUrl;
+    /**
+     * Get the current client session (if any)
+     */
+    getClientSession(): ClientSession | null;
+    /**
+     * Initialize session for client token mode.
+     * Called automatically on first message if not already initialized.
+     */
+    initSession(): Promise<ClientSession>;
+    private _doInitSession;
+    /**
+     * Clear the current client session
+     */
+    clearClientSession(): void;
+    /**
+     * Send a message - handles both proxy and client token modes
+     */
     dispatch(options: DispatchOptions, onEvent: SSEHandler): Promise<void>;
+    /**
+     * Client token mode dispatch
+     */
+    private dispatchClientToken;
+    /**
+     * Proxy mode dispatch (original implementation)
+     */
+    private dispatchProxy;
     private buildPayload;
     /**
      * Handle custom SSE event parsing via parseSSEEvent callback
@@ -1537,17 +1773,25 @@ type MessageTransform = (context: {
     streaming: boolean;
     raw?: string;
 }) => string;
+type MessageActionCallbacks = {
+    onCopy?: (message: AgentWidgetMessage) => void;
+    onFeedback?: (feedback: AgentWidgetMessageFeedback) => void;
+};
 declare const createTypingIndicator: () => HTMLElement;
+/**
+ * Create message action buttons (copy, upvote, downvote)
+ */
+declare const createMessageActions: (message: AgentWidgetMessage, actionsConfig: AgentWidgetMessageActionsConfig, callbacks?: MessageActionCallbacks) => HTMLElement;
 /**
  * Create standard message bubble
  * Supports layout configuration for avatars, timestamps, and visual presets
  */
-declare const createStandardBubble: (message: AgentWidgetMessage, transform: MessageTransform, layoutConfig?: AgentWidgetMessageLayoutConfig) => HTMLElement;
+declare const createStandardBubble: (message: AgentWidgetMessage, transform: MessageTransform, layoutConfig?: AgentWidgetMessageLayoutConfig, actionsConfig?: AgentWidgetMessageActionsConfig, actionCallbacks?: MessageActionCallbacks) => 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) => HTMLElement;
+declare const createBubbleWithLayout: (message: AgentWidgetMessage, transform: MessageTransform, layoutConfig?: AgentWidgetMessageLayoutConfig, actionsConfig?: AgentWidgetMessageActionsConfig, actionCallbacks?: MessageActionCallbacks) => HTMLElement;
 
 /**
  * Options for component middleware
@@ -1684,4 +1928,4 @@ declare const getHeaderLayout: (layoutName: string) => HeaderLayoutRenderer;
  */
 declare const buildHeaderWithLayout: (config: AgentWidgetConfig, layoutConfig?: AgentWidgetHeaderLayoutConfig, context?: Partial<HeaderLayoutContext>) => HeaderElements;
 
-export { 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 AgentWidgetMessageLayoutConfig, type AgentWidgetPlugin, type AgentWidgetRequestPayload, type AgentWidgetSSEEventParser, type AgentWidgetSSEEventResult, AgentWidgetSession, type AgentWidgetSessionStatus, type AgentWidgetStreamParser, type AgentWidgetStreamParserResult, type AgentWidgetTheme, type AgentWidgetTimestampConfig, type CodeFormat, type ComponentContext, type ComponentDirective, type ComponentRenderer, type ComposerBuildContext, type ComposerElements, DEFAULT_WIDGET_CONFIG, type HeaderBuildContext, type HeaderElements, type HeaderLayoutContext, type HeaderLayoutRenderer, type HeaderRenderContext, type MarkdownProcessorOptions, type MessageRenderContext, type MessageTransform, type SlotRenderContext, type SlotRenderer, type WidgetLayoutSlot, attachHeaderToContainer, buildComposer, buildDefaultHeader, buildExpandedHeader, buildHeader, buildHeaderWithLayout, buildMinimalHeader, componentRegistry, createActionManager, createAgentExperience, createBubbleWithLayout, createComponentMiddleware, createComponentStreamParser, createDirectivePostprocessor, createFlexibleJsonStreamParser, createJsonStreamParser, createLocalStorageAdapter, createMarkdownProcessor, createMarkdownProcessorFromConfig, createPlainTextParser, createRegexJsonParser, createStandardBubble, createTypingIndicator, createXmlParser, initAgentWidget as default, defaultActionHandlers, defaultJsonActionParser, directivePostprocessor, escapeHtml, extractComponentDirectiveFromMessage, generateCodeSnippet, getHeaderLayout, hasComponentDirective, headerLayouts, initAgentWidget, isComponentDirectiveType, markdownPostprocessor, mergeWithDefaults, pluginRegistry, renderComponentDirective };
+export { 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, type ClientChatRequest, type ClientInitResponse, type ClientSession, type CodeFormat, type ComponentContext, type ComponentDirective, type ComponentRenderer, type ComposerBuildContext, type ComposerElements, DEFAULT_WIDGET_CONFIG, type HeaderBuildContext, type HeaderElements, type HeaderLayoutContext, type HeaderLayoutRenderer, type HeaderRenderContext, type MarkdownProcessorOptions, type MessageActionCallbacks, type MessageRenderContext, type MessageTransform, type SlotRenderContext, type SlotRenderer, type WidgetLayoutSlot, attachHeaderToContainer, buildComposer, buildDefaultHeader, buildExpandedHeader, buildHeader, buildHeaderWithLayout, buildMinimalHeader, componentRegistry, createActionManager, createAgentExperience, createBubbleWithLayout, createComponentMiddleware, createComponentStreamParser, createDirectivePostprocessor, createFlexibleJsonStreamParser, createJsonStreamParser, createLocalStorageAdapter, createMarkdownProcessor, createMarkdownProcessorFromConfig, createMessageActions, createPlainTextParser, createRegexJsonParser, createStandardBubble, createTypingIndicator, createXmlParser, initAgentWidget as default, defaultActionHandlers, defaultJsonActionParser, directivePostprocessor, escapeHtml, extractComponentDirectiveFromMessage, generateCodeSnippet, getHeaderLayout, hasComponentDirective, headerLayouts, initAgentWidget, isComponentDirectiveType, markdownPostprocessor, mergeWithDefaults, pluginRegistry, renderComponentDirective };