@sendbird/ai-agent-messenger-react 1.29.0 → 1.31.0

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import { Action } from '@sendbird/uikit-message-template';
 import type { AIAgentChannelFilter } from '@sendbird/chat/aiAgent';
 import type { AIAgentModule } from '@sendbird/chat/aiAgent';
+import { AriaRole } from 'react';
 import type { BaseChannelCollectionEventHandler } from '@sendbird/chat/groupChannel';
 import type { BaseMessage } from '@sendbird/chat/message';
 import type { CollectionEventSource } from '@sendbird/chat';
@@ -475,12 +476,15 @@ declare interface AIAgentConfig_2 {
              * */
             senderAvatarEnabled: boolean;
             /**
-             * Controls how markdown images are displayed while a message is streaming.
-             * - `default`: Renders partial markdown as-is.
-             * - `complete-only`: Hides incomplete image markdown until the image token is complete.
-             * @default 'default'
+             * Markdown elements whose rendering is deferred until their token is complete while streaming.
+             * Deferred elements stay hidden until fully streamed; others render partial markdown as-is.
+             * @default []
              * */
-            markdownImageRenderMode: MarkdownImageRenderMode;
+            deferredMarkdownElements: DeferredMarkdownElement[];
+            /** @deprecated Use `deferredMarkdownElements` with `'image'` instead. */
+            markdownImageRenderMode?: 'default' | 'complete-only';
+            /** @deprecated Use `deferredMarkdownElements` with `'link'` instead. */
+            markdownLinkRenderMode?: 'default' | 'complete-only';
         };
         header: {
             /**
@@ -1250,6 +1254,23 @@ declare interface AIAgentStringSet {
     };
 }
 
+declare type AnnouncementQueueMode = 'latestOnly' | 'ordered';
+
+declare interface AnnounceOptions {
+    /**
+     * How to queue announcements while throttled.
+     * - `latestOnly` (default): keep only the latest queued announcement within the throttle window
+     * - `ordered`: preserve FIFO ordering for queued announcements within the throttle window
+     */
+    mode?: AnnouncementQueueMode;
+    /**
+     * Event identity for dedup. When provided, ordered-mode dedup compares this key
+     * (instead of speech text), so two distinct content-bearing events whose rendered
+     * text happens to match are both heard. Undefined preserves the legacy text-based dedup.
+     */
+    dedupeKey?: string;
+}
+
 declare type AnonUserSessionData = { userId: string; authToken: string; expireAt: number };
 
 export declare class AnonymousSessionInfo {
@@ -1511,7 +1532,7 @@ declare interface ContextObject {
     context: Record<string, string>;
 }
 
-export declare const Conversation: ({ children, onNavigateToConversationList, channelUrl, onClearChannelUrl, shouldMarkAsRead, announcementsEnabled, style, closedChannelUrl, onClearClosedChannelUrl, }: Props_3) => JSX.Element;
+export declare const Conversation: ({ children, onNavigateToConversationList, channelUrl, onClearChannelUrl, shouldMarkAsRead, announcementsEnabled, initialFocusTarget, style, closedChannelUrl, onClearClosedChannelUrl, }: Props_3) => JSX.Element;
 
 export declare const ConversationContext: Context<ConversationContextValue | null>;
 
@@ -1619,6 +1640,8 @@ declare interface ConversationHeaderTemplateProps {
     titleAlign?: 'start' | 'center' | 'end';
 }
 
+declare type ConversationInitialFocusTarget = 'messageInput';
+
 declare class ConversationInitialRenderStats extends AIAgentBaseStats {
     private presentMethod: PresentMethod = 'direct_present';
 
@@ -1832,13 +1855,13 @@ export declare const ConversationListContext: Context<ConversationListContextVal
 declare interface ConversationListContextProps {
     conversationListLimit?: number;
     conversationListFilter?: Partial<AIAgentGroupChannelFilter>;
-    onOpenConversationView?: (channelUrl: string, status: 'open' | 'closed') => void;
+    onOpenConversationView?: (channelUrl: string, status: 'open' | 'closed', options?: ConversationListOpenOptions) => void;
 }
 
 export declare function ConversationListContextProvider({ conversationListLimit, conversationListFilter, onOpenConversationView, children, }: PropsWithChildren<ConversationListContextProps>): JSX.Element;
 
 declare interface ConversationListContextValue extends AIAgentConversationListContextValue {
-    onOpenConversationView: (channelUrl: string, status: 'open' | 'closed') => void;
+    onOpenConversationView: (channelUrl: string, status: 'open' | 'closed', options?: ConversationListOpenOptions) => void;
 }
 
 export declare const ConversationListHeaderLayout: {
@@ -1953,6 +1976,10 @@ export declare const ConversationListLayout: {
     }) => null;
 };
 
+declare interface ConversationListOpenOptions {
+    initialFocusTarget?: 'messageInput';
+}
+
 declare type ConversationMessageEvent = ConversationMessageEventPayload & { id: number };
 
 declare type ConversationMessageEventPayload =
@@ -2071,15 +2098,22 @@ export declare interface CustomMessageTemplateData {
 export declare type DateSeparatorProps = SBUFoundationProps<{
     /** date or timestamp */
     date?: Date | number;
+    role?: AriaRole;
 }>;
 
 /**
  * Recursively makes every property of T optional, including nested objects.
  */
-declare type DeepPartial<T> = T extends object ? { [K in keyof T]?: DeepPartial<T[K]> } : T;
+declare type DeepPartial<T> = T extends (infer U)[]
+? DeepPartial<U>[]
+: T extends object
+? { [K in keyof T]?: DeepPartial<T[K]> }
+: T;
 
 export declare const DefaultMessenger: ForwardRefExoticComponent<MessengerProps & RefAttributes<MessengerSessionRef>>;
 
+declare type DeferredMarkdownElement = 'image' | 'link';
+
 export declare interface DeskClientInterface {
     /** Gets a ticket by its ID. */
     getTicket(id: number): Promise<DeskTicketInterface>;
@@ -2151,6 +2185,12 @@ declare interface Dispatcher {
     ): void;
 }
 
+declare type ErrorAnnouncementParams =
+| { type: 'fileSizeExceeded'; maxSizeMB?: number }
+| { type: 'sendFailed' }
+| { type: 'csatFormError' }
+| { type: 'generic'; message: string };
+
 /**
  * For better understanding: https://sendbird.atlassian.net/wiki/spaces/AA/pages/3075014695/Extended+Message+Payload+Spec
  */
@@ -2349,7 +2389,7 @@ BaseMessageProps<{
     isFeedbackEnabled?: boolean;
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
-    markdownImageRenderMode?: MarkdownImageRenderMode;
+    deferredMarkdownElements?: DeferredMarkdownElement[];
 
     // handlers
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
@@ -2430,7 +2470,7 @@ export declare const IncomingMessageLayout: {
                 isFeedbackEnabled?: boolean;
                 isFeedbackCommentEnabled?: boolean;
                 isSenderAvatarVisible?: boolean;
-                markdownImageRenderMode?: MarkdownImageRenderMode;
+                deferredMarkdownElements?: DeferredMarkdownElement[];
                 onGetCachedMessageTemplate?: (templateKey: string) => string | null;
                 onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
                 onHandleTemplateInternalAction?: (action: Action) => void;
@@ -2508,7 +2548,7 @@ export declare const IncomingMessageLayout: {
                 isFeedbackEnabled?: boolean;
                 isFeedbackCommentEnabled?: boolean;
                 isSenderAvatarVisible?: boolean;
-                markdownImageRenderMode?: MarkdownImageRenderMode;
+                deferredMarkdownElements?: DeferredMarkdownElement[];
                 onGetCachedMessageTemplate?: (templateKey: string) => string | null;
                 onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
                 onHandleTemplateInternalAction?: (action: Action) => void;
@@ -2586,7 +2626,7 @@ export declare const IncomingMessageLayout: {
                 isFeedbackEnabled?: boolean;
                 isFeedbackCommentEnabled?: boolean;
                 isSenderAvatarVisible?: boolean;
-                markdownImageRenderMode?: MarkdownImageRenderMode;
+                deferredMarkdownElements?: DeferredMarkdownElement[];
                 onGetCachedMessageTemplate?: (templateKey: string) => string | null;
                 onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
                 onHandleTemplateInternalAction?: (action: Action) => void;
@@ -2660,7 +2700,7 @@ export declare const IncomingMessageLayout: {
                 isFeedbackEnabled?: boolean;
                 isFeedbackCommentEnabled?: boolean;
                 isSenderAvatarVisible?: boolean;
-                markdownImageRenderMode?: MarkdownImageRenderMode;
+                deferredMarkdownElements?: DeferredMarkdownElement[];
                 onGetCachedMessageTemplate?: (templateKey: string) => string | null;
                 onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
                 onHandleTemplateInternalAction?: (action: Action) => void;
@@ -2738,7 +2778,7 @@ export declare const IncomingMessageLayout: {
                 isFeedbackEnabled?: boolean;
                 isFeedbackCommentEnabled?: boolean;
                 isSenderAvatarVisible?: boolean;
-                markdownImageRenderMode?: MarkdownImageRenderMode;
+                deferredMarkdownElements?: DeferredMarkdownElement[];
                 onGetCachedMessageTemplate?: (templateKey: string) => string | null;
                 onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
                 onHandleTemplateInternalAction?: (action: Action) => void;
@@ -2816,7 +2856,7 @@ export declare const IncomingMessageLayout: {
                 isFeedbackEnabled?: boolean;
                 isFeedbackCommentEnabled?: boolean;
                 isSenderAvatarVisible?: boolean;
-                markdownImageRenderMode?: MarkdownImageRenderMode;
+                deferredMarkdownElements?: DeferredMarkdownElement[];
                 onGetCachedMessageTemplate?: (templateKey: string) => string | null;
                 onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
                 onHandleTemplateInternalAction?: (action: Action) => void;
@@ -2925,7 +2965,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackEnabled?: boolean;
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
-    markdownImageRenderMode?: MarkdownImageRenderMode;
+    deferredMarkdownElements?: DeferredMarkdownElement[];
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3003,7 +3043,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackEnabled?: boolean;
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
-    markdownImageRenderMode?: MarkdownImageRenderMode;
+    deferredMarkdownElements?: DeferredMarkdownElement[];
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3081,7 +3121,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackEnabled?: boolean;
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
-    markdownImageRenderMode?: MarkdownImageRenderMode;
+    deferredMarkdownElements?: DeferredMarkdownElement[];
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3155,7 +3195,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackEnabled?: boolean;
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
-    markdownImageRenderMode?: MarkdownImageRenderMode;
+    deferredMarkdownElements?: DeferredMarkdownElement[];
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3233,7 +3273,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackEnabled?: boolean;
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
-    markdownImageRenderMode?: MarkdownImageRenderMode;
+    deferredMarkdownElements?: DeferredMarkdownElement[];
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3311,7 +3351,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackEnabled?: boolean;
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
-    markdownImageRenderMode?: MarkdownImageRenderMode;
+    deferredMarkdownElements?: DeferredMarkdownElement[];
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3415,7 +3455,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackEnabled?: boolean;
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
-    markdownImageRenderMode?: MarkdownImageRenderMode;
+    deferredMarkdownElements?: DeferredMarkdownElement[];
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3493,7 +3533,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackEnabled?: boolean;
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
-    markdownImageRenderMode?: MarkdownImageRenderMode;
+    deferredMarkdownElements?: DeferredMarkdownElement[];
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3571,7 +3611,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackEnabled?: boolean;
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
-    markdownImageRenderMode?: MarkdownImageRenderMode;
+    deferredMarkdownElements?: DeferredMarkdownElement[];
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3645,7 +3685,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackEnabled?: boolean;
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
-    markdownImageRenderMode?: MarkdownImageRenderMode;
+    deferredMarkdownElements?: DeferredMarkdownElement[];
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3723,7 +3763,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackEnabled?: boolean;
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
-    markdownImageRenderMode?: MarkdownImageRenderMode;
+    deferredMarkdownElements?: DeferredMarkdownElement[];
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3801,7 +3841,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackEnabled?: boolean;
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
-    markdownImageRenderMode?: MarkdownImageRenderMode;
+    deferredMarkdownElements?: DeferredMarkdownElement[];
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3928,7 +3968,7 @@ export declare const IncomingMessageLayout: {
             isFeedbackEnabled?: boolean;
             isFeedbackCommentEnabled?: boolean;
             isSenderAvatarVisible?: boolean;
-            markdownImageRenderMode?: MarkdownImageRenderMode;
+            deferredMarkdownElements?: DeferredMarkdownElement[];
             onGetCachedMessageTemplate?: (templateKey: string) => string | null;
             onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
             onHandleTemplateInternalAction?: (action: Action) => void;
@@ -4006,7 +4046,7 @@ export declare const IncomingMessageLayout: {
             isFeedbackEnabled?: boolean;
             isFeedbackCommentEnabled?: boolean;
             isSenderAvatarVisible?: boolean;
-            markdownImageRenderMode?: MarkdownImageRenderMode;
+            deferredMarkdownElements?: DeferredMarkdownElement[];
             onGetCachedMessageTemplate?: (templateKey: string) => string | null;
             onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
             onHandleTemplateInternalAction?: (action: Action) => void;
@@ -4084,7 +4124,7 @@ export declare const IncomingMessageLayout: {
             isFeedbackEnabled?: boolean;
             isFeedbackCommentEnabled?: boolean;
             isSenderAvatarVisible?: boolean;
-            markdownImageRenderMode?: MarkdownImageRenderMode;
+            deferredMarkdownElements?: DeferredMarkdownElement[];
             onGetCachedMessageTemplate?: (templateKey: string) => string | null;
             onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
             onHandleTemplateInternalAction?: (action: Action) => void;
@@ -4160,7 +4200,7 @@ export declare const IncomingMessageLayout: {
             isFeedbackEnabled?: boolean;
             isFeedbackCommentEnabled?: boolean;
             isSenderAvatarVisible?: boolean;
-            markdownImageRenderMode?: MarkdownImageRenderMode;
+            deferredMarkdownElements?: DeferredMarkdownElement[];
             onGetCachedMessageTemplate?: (templateKey: string) => string | null;
             onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
             onHandleTemplateInternalAction?: (action: Action) => void;
@@ -4238,7 +4278,7 @@ export declare const IncomingMessageLayout: {
             isFeedbackEnabled?: boolean;
             isFeedbackCommentEnabled?: boolean;
             isSenderAvatarVisible?: boolean;
-            markdownImageRenderMode?: MarkdownImageRenderMode;
+            deferredMarkdownElements?: DeferredMarkdownElement[];
             onGetCachedMessageTemplate?: (templateKey: string) => string | null;
             onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
             onHandleTemplateInternalAction?: (action: Action) => void;
@@ -4316,7 +4356,7 @@ export declare const IncomingMessageLayout: {
             isFeedbackEnabled?: boolean;
             isFeedbackCommentEnabled?: boolean;
             isSenderAvatarVisible?: boolean;
-            markdownImageRenderMode?: MarkdownImageRenderMode;
+            deferredMarkdownElements?: DeferredMarkdownElement[];
             onGetCachedMessageTemplate?: (templateKey: string) => string | null;
             onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
             onHandleTemplateInternalAction?: (action: Action) => void;
@@ -4434,6 +4474,11 @@ declare type InternalExtraProps = {
     testerMode?: boolean;
 };
 
+declare type InternalExtraProps_2 = {
+    announceStatus?: (params: StatusAnnouncementParams, options?: StatusAnnouncementOptions) => void;
+    announceError?: (params: ErrorAnnouncementParams, focusTarget?: HTMLElement | null) => void;
+};
+
 declare interface InternalMessageTemplateVariables {
     carousel_padding_left?: number;
     carousel_padding_right?: number;
@@ -4520,8 +4565,6 @@ declare interface ManualSessionInfoParams {
     sessionHandler: AIAgentSessionHandler;
 }
 
-declare type MarkdownImageRenderMode = 'default' | 'complete-only';
-
 declare interface MemoryInfo {
     enabled: boolean;
     showIndicator: boolean;
@@ -4544,7 +4587,7 @@ export declare const MessageListUILayout: {
     defaults: {
         template: ComponentType<unknown>;
         components: {
-            DateSeparator: ({ className, date, style }: DateSeparatorProps) => ReactNode;
+            DateSeparator: ({ className, date, role, style }: DateSeparatorProps) => ReactNode;
             ScrollToBottomButton: ({ className, style, onClick }: ScrollToBottomButtonProps) => ReactNode;
         };
     };
@@ -4553,23 +4596,23 @@ export declare const MessageListUILayout: {
         children?: ReactNode;
     }) => JSX.Element;
     Context: Context<LayoutContextValue<unknown, {
-    DateSeparator: ({ className, date, style }: DateSeparatorProps) => ReactNode;
+    DateSeparator: ({ className, date, role, style }: DateSeparatorProps) => ReactNode;
     ScrollToBottomButton: ({ className, style, onClick }: ScrollToBottomButtonProps) => ReactNode;
     }>>;
     useContext: () => LayoutContextValue<unknown, {
-    DateSeparator: ({ className, date, style }: DateSeparatorProps) => ReactNode;
+    DateSeparator: ({ className, date, role, style }: DateSeparatorProps) => ReactNode;
     ScrollToBottomButton: ({ className, style, onClick }: ScrollToBottomButtonProps) => ReactNode;
     }>;
 } & {
     DateSeparator: (props: {
-        component: ({ className, date, style }: DateSeparatorProps) => ReactNode;
+        component: ({ className, date, role, style }: DateSeparatorProps) => ReactNode;
     }) => null;
     ScrollToBottomButton: (props: {
         component: ({ className, style, onClick }: ScrollToBottomButtonProps) => ReactNode;
     }) => null;
 };
 
-export declare const MessageLogs: ({ actionbook, functionCalls, groundedness, agentMessageTemplates, onClickActionbook, onClickFunctionCall, onClickFunctionCallDetail, onClickGroundedness, onClickAgentMessageTemplate, bottomContent, renderCustomGroundednessIcon, style, }: Props_2) => JSX.Element;
+export declare const MessageLogs: ({ actionbook, functionCalls, groundedness, agentMessageTemplates, onClickActionbook, onClickFunctionCall, onClickFunctionCallDetail, onClickGroundedness, onClickAgentMessageTemplate, topContent, bottomContent, renderCustomGroundednessIcon, style, }: Props_2) => JSX.Element;
 
 declare interface MessageTemplateCache {
     set(key: string, value: string): void;
@@ -4694,7 +4737,7 @@ declare interface MessengerSessionContextValue extends AIAgentMessengerSessionCo
 export declare interface MessengerSessionRef extends AIAgentMessengerSessionRef {
 }
 
-declare interface MessengerSettingsResponse {
+export declare interface MessengerSettingsResponse {
     active_channel: {
         channel_url: string;
         attachment_mode: 'always' | 'handed_off_only' | 'off';
@@ -5081,6 +5124,7 @@ declare type Props_2 = {
         barColor?: string;
         highlightColor?: string;
     };
+    topContent?: ReactNode;
     bottomContent?: ReactNode;
     renderCustomGroundednessIcon?: (props: {
         default: ReactNode;
@@ -5094,6 +5138,7 @@ declare type Props_3 = PropsWithChildren<{
     onNavigateToConversationList?: () => void;
     shouldMarkAsRead?: boolean;
     announcementsEnabled?: boolean;
+    initialFocusTarget?: ConversationInitialFocusTarget;
     /** Custom styles for the conversation container. */
     style?: CSSProperties;
     /** @deprecated Please use `channelUrl` instead. **/
@@ -5105,7 +5150,7 @@ declare type Props_3 = PropsWithChildren<{
 declare type Props_4 = PropsWithChildren<{
     conversationListLimit?: number;
     conversationListFilter?: Partial<AIAgentGroupChannelFilter>;
-    onOpenConversationView?: (channelUrl: string, status: 'open' | 'closed') => void;
+    onOpenConversationView?: (channelUrl: string, status: 'open' | 'closed', options?: ConversationListOpenOptions) => void;
     announcementsEnabled?: boolean;
     /** Custom styles for the conversation list container. */
     style?: CSSProperties;
@@ -5164,6 +5209,26 @@ declare type SingleSelectField = {
 
 declare type StatsAppendCallback = (type: string, data: AIAgentStatPayload) => boolean;
 
+/** Per-event override for the platform `announceStatus` wrappers — same shape as `AnnounceOptions`. */
+declare type StatusAnnouncementOptions = AnnounceOptions;
+
+declare type StatusAnnouncementParams =
+| {
+    event: 'newMessage';
+    senderName?: string;
+    body?: string;
+    time?: string;
+}
+| { event: 'typing'; agentName?: string }
+| { event: 'sendFailed' }
+| { event: 'agentConnected'; agentName?: string }
+| { event: 'conversationClosed' }
+| { event: 'csatDisplayed' }
+| { event: 'csatSubmitted'; submittedLabel: string }
+| { event: 'csatExpired' }
+| { event: 'emptyState' }
+| { event: 'inputDisabled' };
+
 declare interface Steward {
     title: string;
     description?: string;
@@ -5201,7 +5266,7 @@ declare enum StewardTaskStatus {
  * StringSet type for React components
  * Uses SNAKE_CASE keys for backward compatibility
  */
-declare type StringSet = {
+export declare type StringSet = {
     PLACE_HOLDER__WRONG: string;
     PLACE_HOLDER__NO_MESSAGES: string;
     UNKNOWN__UNKNOWN_MESSAGE_TYPE: string;
@@ -5400,39 +5465,46 @@ declare type StringSet = {
 
 declare type SystemBaseMessageProps<T> = T & BaseMessageProps<{}>;
 
+declare type SystemCSATMessageProps = SystemMessageProps & {
+    announceStatus?: (params: StatusAnnouncementParams, options?: StatusAnnouncementOptions) => void;
+    announceError?: (params: ErrorAnnouncementParams, focusTarget?: HTMLElement | null) => void;
+};
+
 export declare const SystemMessageLayout: {
     (props: PropsWithChildren): ReactNode;
     defaults: {
-        template: ComponentType<SystemMessageProps>;
+        template: ComponentType<SystemMessageTemplateProps>;
         components: {
             AdminMessage: (props: SystemMessageProps) => ReactNode;
-            CSATMessage: (props: SystemMessageProps) => ReactNode;
+            CSATMessage: (props: SystemCSATMessageProps) => ReactNode;
         };
     };
     Template: ({ template, children }: {
-        template?: ComponentType<SystemMessageProps> | undefined;
+        template?: ComponentType<SystemMessageTemplateProps> | undefined;
         children?: ReactNode;
     }) => JSX.Element;
-    Context: Context<LayoutContextValue<SystemMessageProps, {
+    Context: Context<LayoutContextValue<SystemMessageTemplateProps, {
     AdminMessage: (props: SystemMessageProps) => ReactNode;
-    CSATMessage: (props: SystemMessageProps) => ReactNode;
+    CSATMessage: (props: SystemCSATMessageProps) => ReactNode;
     }>>;
-    useContext: () => LayoutContextValue<SystemMessageProps, {
+    useContext: () => LayoutContextValue<SystemMessageTemplateProps, {
     AdminMessage: (props: SystemMessageProps) => ReactNode;
-    CSATMessage: (props: SystemMessageProps) => ReactNode;
+    CSATMessage: (props: SystemCSATMessageProps) => ReactNode;
     }>;
 } & {
     AdminMessage: (props: {
         component: (props: SystemMessageProps) => ReactNode;
     }) => null;
     CSATMessage: (props: {
-        component: (props: SystemMessageProps) => ReactNode;
+        component: (props: SystemCSATMessageProps) => ReactNode;
     }) => null;
 };
 
 export declare type SystemMessageProps<T extends SystemMessageUnion['messageType'] = SystemMessageUnion['messageType']> =
 PickMessageProps<SystemMessageUnion, T>;
 
+declare type SystemMessageTemplateProps = SystemMessageProps & Partial<InternalExtraProps_2>;
+
 declare type SystemMessageUnion =
 | SystemBaseMessageProps<{
     messageType: 'admin';