@sendbird/ai-agent-messenger-react 1.30.0 → 1.31.1

package/dist/index.d.ts

@@ -476,19 +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;
-            /**
-             * Controls how markdown links are displayed while a message is streaming.
-             * - `default`: Renders partial markdown as-is.
-             * - `complete-only`: Hides incomplete link markdown until the link token is complete.
-             * @default 'default'
-             * */
-            markdownLinkRenderMode: MarkdownLinkRenderMode;
+            deferredMarkdownElements: DeferredMarkdownElement[];
+            /** @deprecated Use `deferredMarkdownElements` with `'image'` instead. */
+            markdownImageRenderMode?: 'default' | 'complete-only';
+            /** @deprecated Use `deferredMarkdownElements` with `'link'` instead. */
+            markdownLinkRenderMode?: 'default' | 'complete-only';
         };
         header: {
             /**
@@ -1258,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 {
@@ -2091,10 +2104,16 @@ export declare type DateSeparatorProps = SBUFoundationProps<{
 /**
  * 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>;
@@ -2166,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
  */
@@ -2234,6 +2259,9 @@ export declare interface ExtendedMessagePayload {
     form?: Form;
     steward?: Steward;
 
+    // safeguard
+    flagged_types?: string[];
+
     // logs
     groundedness: GroundednessInfo[];
     manual: ActionbookInfo;
@@ -2364,8 +2392,7 @@ BaseMessageProps<{
     isFeedbackEnabled?: boolean;
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
-    markdownImageRenderMode?: MarkdownImageRenderMode;
-    markdownLinkRenderMode?: MarkdownLinkRenderMode;
+    deferredMarkdownElements?: DeferredMarkdownElement[];
 
     // handlers
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
@@ -2446,8 +2473,7 @@ export declare const IncomingMessageLayout: {
                 isFeedbackEnabled?: boolean;
                 isFeedbackCommentEnabled?: boolean;
                 isSenderAvatarVisible?: boolean;
-                markdownImageRenderMode?: MarkdownImageRenderMode;
-                markdownLinkRenderMode?: MarkdownLinkRenderMode;
+                deferredMarkdownElements?: DeferredMarkdownElement[];
                 onGetCachedMessageTemplate?: (templateKey: string) => string | null;
                 onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
                 onHandleTemplateInternalAction?: (action: Action) => void;
@@ -2525,8 +2551,7 @@ export declare const IncomingMessageLayout: {
                 isFeedbackEnabled?: boolean;
                 isFeedbackCommentEnabled?: boolean;
                 isSenderAvatarVisible?: boolean;
-                markdownImageRenderMode?: MarkdownImageRenderMode;
-                markdownLinkRenderMode?: MarkdownLinkRenderMode;
+                deferredMarkdownElements?: DeferredMarkdownElement[];
                 onGetCachedMessageTemplate?: (templateKey: string) => string | null;
                 onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
                 onHandleTemplateInternalAction?: (action: Action) => void;
@@ -2604,8 +2629,7 @@ export declare const IncomingMessageLayout: {
                 isFeedbackEnabled?: boolean;
                 isFeedbackCommentEnabled?: boolean;
                 isSenderAvatarVisible?: boolean;
-                markdownImageRenderMode?: MarkdownImageRenderMode;
-                markdownLinkRenderMode?: MarkdownLinkRenderMode;
+                deferredMarkdownElements?: DeferredMarkdownElement[];
                 onGetCachedMessageTemplate?: (templateKey: string) => string | null;
                 onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
                 onHandleTemplateInternalAction?: (action: Action) => void;
@@ -2679,8 +2703,7 @@ export declare const IncomingMessageLayout: {
                 isFeedbackEnabled?: boolean;
                 isFeedbackCommentEnabled?: boolean;
                 isSenderAvatarVisible?: boolean;
-                markdownImageRenderMode?: MarkdownImageRenderMode;
-                markdownLinkRenderMode?: MarkdownLinkRenderMode;
+                deferredMarkdownElements?: DeferredMarkdownElement[];
                 onGetCachedMessageTemplate?: (templateKey: string) => string | null;
                 onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
                 onHandleTemplateInternalAction?: (action: Action) => void;
@@ -2758,8 +2781,7 @@ export declare const IncomingMessageLayout: {
                 isFeedbackEnabled?: boolean;
                 isFeedbackCommentEnabled?: boolean;
                 isSenderAvatarVisible?: boolean;
-                markdownImageRenderMode?: MarkdownImageRenderMode;
-                markdownLinkRenderMode?: MarkdownLinkRenderMode;
+                deferredMarkdownElements?: DeferredMarkdownElement[];
                 onGetCachedMessageTemplate?: (templateKey: string) => string | null;
                 onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
                 onHandleTemplateInternalAction?: (action: Action) => void;
@@ -2837,8 +2859,7 @@ export declare const IncomingMessageLayout: {
                 isFeedbackEnabled?: boolean;
                 isFeedbackCommentEnabled?: boolean;
                 isSenderAvatarVisible?: boolean;
-                markdownImageRenderMode?: MarkdownImageRenderMode;
-                markdownLinkRenderMode?: MarkdownLinkRenderMode;
+                deferredMarkdownElements?: DeferredMarkdownElement[];
                 onGetCachedMessageTemplate?: (templateKey: string) => string | null;
                 onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
                 onHandleTemplateInternalAction?: (action: Action) => void;
@@ -2947,8 +2968,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackEnabled?: boolean;
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
-    markdownImageRenderMode?: MarkdownImageRenderMode;
-    markdownLinkRenderMode?: MarkdownLinkRenderMode;
+    deferredMarkdownElements?: DeferredMarkdownElement[];
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3026,8 +3046,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackEnabled?: boolean;
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
-    markdownImageRenderMode?: MarkdownImageRenderMode;
-    markdownLinkRenderMode?: MarkdownLinkRenderMode;
+    deferredMarkdownElements?: DeferredMarkdownElement[];
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3105,8 +3124,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackEnabled?: boolean;
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
-    markdownImageRenderMode?: MarkdownImageRenderMode;
-    markdownLinkRenderMode?: MarkdownLinkRenderMode;
+    deferredMarkdownElements?: DeferredMarkdownElement[];
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3180,8 +3198,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackEnabled?: boolean;
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
-    markdownImageRenderMode?: MarkdownImageRenderMode;
-    markdownLinkRenderMode?: MarkdownLinkRenderMode;
+    deferredMarkdownElements?: DeferredMarkdownElement[];
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3259,8 +3276,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackEnabled?: boolean;
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
-    markdownImageRenderMode?: MarkdownImageRenderMode;
-    markdownLinkRenderMode?: MarkdownLinkRenderMode;
+    deferredMarkdownElements?: DeferredMarkdownElement[];
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3338,8 +3354,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackEnabled?: boolean;
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
-    markdownImageRenderMode?: MarkdownImageRenderMode;
-    markdownLinkRenderMode?: MarkdownLinkRenderMode;
+    deferredMarkdownElements?: DeferredMarkdownElement[];
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3443,8 +3458,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackEnabled?: boolean;
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
-    markdownImageRenderMode?: MarkdownImageRenderMode;
-    markdownLinkRenderMode?: MarkdownLinkRenderMode;
+    deferredMarkdownElements?: DeferredMarkdownElement[];
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3522,8 +3536,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackEnabled?: boolean;
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
-    markdownImageRenderMode?: MarkdownImageRenderMode;
-    markdownLinkRenderMode?: MarkdownLinkRenderMode;
+    deferredMarkdownElements?: DeferredMarkdownElement[];
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3601,8 +3614,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackEnabled?: boolean;
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
-    markdownImageRenderMode?: MarkdownImageRenderMode;
-    markdownLinkRenderMode?: MarkdownLinkRenderMode;
+    deferredMarkdownElements?: DeferredMarkdownElement[];
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3676,8 +3688,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackEnabled?: boolean;
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
-    markdownImageRenderMode?: MarkdownImageRenderMode;
-    markdownLinkRenderMode?: MarkdownLinkRenderMode;
+    deferredMarkdownElements?: DeferredMarkdownElement[];
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3755,8 +3766,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackEnabled?: boolean;
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
-    markdownImageRenderMode?: MarkdownImageRenderMode;
-    markdownLinkRenderMode?: MarkdownLinkRenderMode;
+    deferredMarkdownElements?: DeferredMarkdownElement[];
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3834,8 +3844,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackEnabled?: boolean;
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
-    markdownImageRenderMode?: MarkdownImageRenderMode;
-    markdownLinkRenderMode?: MarkdownLinkRenderMode;
+    deferredMarkdownElements?: DeferredMarkdownElement[];
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3962,8 +3971,7 @@ export declare const IncomingMessageLayout: {
             isFeedbackEnabled?: boolean;
             isFeedbackCommentEnabled?: boolean;
             isSenderAvatarVisible?: boolean;
-            markdownImageRenderMode?: MarkdownImageRenderMode;
-            markdownLinkRenderMode?: MarkdownLinkRenderMode;
+            deferredMarkdownElements?: DeferredMarkdownElement[];
             onGetCachedMessageTemplate?: (templateKey: string) => string | null;
             onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
             onHandleTemplateInternalAction?: (action: Action) => void;
@@ -4041,8 +4049,7 @@ export declare const IncomingMessageLayout: {
             isFeedbackEnabled?: boolean;
             isFeedbackCommentEnabled?: boolean;
             isSenderAvatarVisible?: boolean;
-            markdownImageRenderMode?: MarkdownImageRenderMode;
-            markdownLinkRenderMode?: MarkdownLinkRenderMode;
+            deferredMarkdownElements?: DeferredMarkdownElement[];
             onGetCachedMessageTemplate?: (templateKey: string) => string | null;
             onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
             onHandleTemplateInternalAction?: (action: Action) => void;
@@ -4120,8 +4127,7 @@ export declare const IncomingMessageLayout: {
             isFeedbackEnabled?: boolean;
             isFeedbackCommentEnabled?: boolean;
             isSenderAvatarVisible?: boolean;
-            markdownImageRenderMode?: MarkdownImageRenderMode;
-            markdownLinkRenderMode?: MarkdownLinkRenderMode;
+            deferredMarkdownElements?: DeferredMarkdownElement[];
             onGetCachedMessageTemplate?: (templateKey: string) => string | null;
             onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
             onHandleTemplateInternalAction?: (action: Action) => void;
@@ -4197,8 +4203,7 @@ export declare const IncomingMessageLayout: {
             isFeedbackEnabled?: boolean;
             isFeedbackCommentEnabled?: boolean;
             isSenderAvatarVisible?: boolean;
-            markdownImageRenderMode?: MarkdownImageRenderMode;
-            markdownLinkRenderMode?: MarkdownLinkRenderMode;
+            deferredMarkdownElements?: DeferredMarkdownElement[];
             onGetCachedMessageTemplate?: (templateKey: string) => string | null;
             onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
             onHandleTemplateInternalAction?: (action: Action) => void;
@@ -4276,8 +4281,7 @@ export declare const IncomingMessageLayout: {
             isFeedbackEnabled?: boolean;
             isFeedbackCommentEnabled?: boolean;
             isSenderAvatarVisible?: boolean;
-            markdownImageRenderMode?: MarkdownImageRenderMode;
-            markdownLinkRenderMode?: MarkdownLinkRenderMode;
+            deferredMarkdownElements?: DeferredMarkdownElement[];
             onGetCachedMessageTemplate?: (templateKey: string) => string | null;
             onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
             onHandleTemplateInternalAction?: (action: Action) => void;
@@ -4355,8 +4359,7 @@ export declare const IncomingMessageLayout: {
             isFeedbackEnabled?: boolean;
             isFeedbackCommentEnabled?: boolean;
             isSenderAvatarVisible?: boolean;
-            markdownImageRenderMode?: MarkdownImageRenderMode;
-            markdownLinkRenderMode?: MarkdownLinkRenderMode;
+            deferredMarkdownElements?: DeferredMarkdownElement[];
             onGetCachedMessageTemplate?: (templateKey: string) => string | null;
             onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
             onHandleTemplateInternalAction?: (action: Action) => void;
@@ -4474,6 +4477,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;
@@ -4560,10 +4568,6 @@ declare interface ManualSessionInfoParams {
     sessionHandler: AIAgentSessionHandler;
 }
 
-declare type MarkdownImageRenderMode = 'default' | 'complete-only';
-
-declare type MarkdownLinkRenderMode = 'default' | 'complete-only';
-
 declare interface MemoryInfo {
     enabled: boolean;
     showIndicator: boolean;
@@ -4611,7 +4615,7 @@ export declare const MessageListUILayout: {
     }) => null;
 };
 
-export declare const MessageLogs: ({ actionbook, functionCalls, groundedness, agentMessageTemplates, onClickActionbook, onClickFunctionCall, onClickFunctionCallDetail, onClickGroundedness, onClickAgentMessageTemplate, topContent, bottomContent, renderCustomGroundednessIcon, style, }: Props_2) => JSX.Element;
+export declare const MessageLogs: ({ actionbook, functionCalls, groundedness, agentMessageTemplates, flaggedTypes, onClickActionbook, onClickFunctionCall, onClickFunctionCallDetail, onClickGroundedness, onClickAgentMessageTemplate, topContent, bottomContent, renderCustomGroundednessIcon, style, }: Props_2) => JSX.Element;
 
 declare interface MessageTemplateCache {
     set(key: string, value: string): void;
@@ -4736,7 +4740,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';
@@ -5112,6 +5116,7 @@ declare type Props_2 = {
     functionCalls?: FunctionCallsInfo[];
     groundedness?: GroundednessInfo[];
     agentMessageTemplates?: AgentMessageTemplateInfo[];
+    flaggedTypes?: string[];
     onClickActionbook?: (value: ActionbookInfo) => void;
     onClickFunctionCall?: (value: FunctionCallsInfo) => void;
     onClickFunctionCallDetail?: (value: FunctionCallsInfo) => void;
@@ -5155,7 +5160,7 @@ declare type Props_4 = PropsWithChildren<{
     style?: CSSProperties;
 }>;
 
-declare type ReactOnlyIconName = 'expand' | 'collapse' | 'chevron-right' | 'attach' | 'close-filled' | 'actionbook' | 'function' | 'confluence' | 'zendesk' | 'salesforce' | 'sprinklr' | 'website' | 'snippet' | 'template' | 'show' | 'mute';
+declare type ReactOnlyIconName = 'expand' | 'collapse' | 'chevron-right' | 'attach' | 'close-filled' | 'actionbook' | 'function' | 'confluence' | 'zendesk' | 'salesforce' | 'sprinklr' | 'website' | 'snippet' | 'template' | 'show' | 'mute' | 'activity';
 
 declare type ReleaseDisabledByValue =
 | 'unavailable'
@@ -5208,6 +5213,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;
@@ -5245,7 +5270,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;
@@ -5444,39 +5469,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';