@sendbird/ai-agent-messenger-react 1.36.0 → 1.38.0

package/dist/index.d.ts

@@ -8,6 +8,7 @@ import { ComponentType } from 'react';
 import { Context } from 'react';
 import type { Conversation as Conversation_2 } from '@sendbird/chat/aiAgent';
 import type { ConversationStatus } from '@sendbird/chat/aiAgent';
+import type { CPAAuthorizationErrorCode } from '@sendbird/chat/aiAgent';
 import { CSSProperties } from 'react';
 import type { DeskChannelFilter } from '@sendbird/chat/aiAgent';
 import type { FileMessage } from '@sendbird/chat/message';
@@ -226,6 +227,11 @@ countryCode?: string;
 context?: Record<string, string>;
 /**
 * @public
+* @description Customer-provided authorization codes to submit after the messenger session connects.
+* */
+cpaAuthorizationCodes?: CPAAuthorizationCode[];
+/**
+* @public
 * @description AIAgent global default query parameters.
 * */
 queryParams?: AIAgentQueryParams;
@@ -579,6 +585,7 @@ declare interface AIAgentContextValue {
     language: string;
     countryCode?: string;
     context?: Record<string, string>;
+    cpaAuthorizationCodes?: CPAAuthorizationCode[];
 
     logger: Loggable;
     dispatcher: Dispatcher;
@@ -623,11 +630,7 @@ declare interface AIAgentConversationContextValue {
     };
 
     state: {
-        streamAnimation: {
-            isAnimating: boolean;
-            start: (id: string | number) => void;
-            stop: (id: string | number) => void;
-        };
+        streamAnimation: StreamAnimation;
         input: InputState;
     };
 
@@ -745,6 +748,8 @@ declare interface AIAgentInterface {
     countryCode?: string;
     /** The context object for AI Agent */
     context?: Record<string, string>;
+    /** Customer-provided authorization codes to submit after authentication connects */
+    cpaAuthorizationCodes?: CPAAuthorizationCode[];
 
     /** @internal Agent version for conversation initialization */
     agentVersion?: number;
@@ -776,6 +781,10 @@ declare interface AIAgentInterface {
     updateContext: (channelUrl: string, context: Record<string, string>) => Promise<ContextObject>;
     /** Retrieves the context data for the specified channel */
     getContextObject: (channelUrl: string) => Promise<ContextObject>;
+    /** Requests a nudge message to be shown above the launcher. Fire-and-forget: the result is only broadcast to onNudgeMessageReceived subscribers */
+    requestNudgeMessage: (params: RequestNudgeMessageParams) => Promise<void>;
+    /** Submits customer-provided authorization codes for the current user */
+    submitCPAAuthorizationCodes: (authCodes: CPAAuthorizationCode[]) => Promise<SubmitCPAAuthorizationCodesResponse>;
     /** Clears memories saved for the current user */
     clearUserMemories: (params?: ClearUserMemoriesParams) => Promise<void>;
 
@@ -786,7 +795,7 @@ declare interface AIAgentInterface {
     setUserMemoryState: (params: SetUserMemoryStateParams) => Promise<MemoryInfo>;
 
     /** @internal Initializes a conversation on the channel if needed (AI Agent channel without conversation). */
-    initConversationIfNeeded: (channel: ChatSDKGroupChannel) => Promise<void>;
+    initConversationIfNeeded: (channel: ChatSDKGroupChannel, params?: { initialUserMessage?: string }) => Promise<void>;
 
     /** @internal Live metric handler; bridged from {@link AIAgentClientHandlers.onLiveMetric}. */
     onLiveMetric?: LiveMetricDispatch;
@@ -797,6 +806,8 @@ declare interface AIAgentInterface {
     /** Disposes all resources held by this instance (WebSocket, desk auth, event handlers). */
     dispose: () => void;
 
+    /** Registers a handler for nudge message responses */
+    onNudgeMessageReceived: (handler: (response: NudgeMessageResponse) => void) => () => void;
     /** Registers a handler for messenger settings updates */
     onMessengerSettingsUpdated: (handler: (params: MessengerSettingsUpdatedParams) => void) => () => void;
     /** Registers a handler for active channel updates */
@@ -832,6 +843,7 @@ declare interface AIAgentMessengerSessionContextValue {
     createConversation: (params: ConversationCreateParams) => Promise<string>;
     searchConversation: (params: SearchConversationParams) => Promise<string[]>;
     refreshActiveChannel: () => Promise<string>;
+    submitCPAAuthorizationCodes: (authCodes: CPAAuthorizationCode[]) => Promise<SubmitCPAAuthorizationCodesResponse>;
 
     authenticate: () => Promise<MessengerSettingsResponse>;
     deauthenticate: () => Promise<void>;
@@ -844,6 +856,7 @@ declare interface AIAgentMessengerSessionRef {
     chatSDK: AIAgentContextValue['chatSDK'];
     authenticate: () => Promise<MessengerSettingsResponse>;
     deauthenticate: () => Promise<void>;
+    submitCPAAuthorizationCodes: (authCodes: CPAAuthorizationCode[]) => Promise<SubmitCPAAuthorizationCodesResponse>;
     getContextObject: () => Promise<ContextObject>;
     updateContext: {
         /** Updates the context of the active conversation initialized at session start. */
@@ -857,6 +870,8 @@ declare interface AIAgentMessengerSessionRef {
         /** Patches the context of a specific conversation by aiAgentId and channelUrl. */
         (aiAgentId: string, channelUrl: string, context: Record<string, string>): Promise<ContextObject>;
     };
+    /** Requests a nudge message to be shown above the launcher. Fire-and-forget: the response is not exposed. */
+    requestNudgeMessage: (params: RequestNudgeMessageParams) => Promise<void>;
 }
 
 export declare type AIAgentProps = PropsWithChildren<{
@@ -957,6 +972,11 @@ export declare type AIAgentProps = PropsWithChildren<{
      * @description Context object for the AI agent client. This is injected when the messenger is first loaded and can provide additional context that may influence how the AI responds to user conversations.
      * */
     context?: Record<string, string>;
+    /**
+     * @public
+     * @description Customer-provided authorization codes to submit after the messenger session connects.
+     * */
+    cpaAuthorizationCodes?: CPAAuthorizationCode[];
     /**
      * @public
      * @description AIAgent global default query parameters.
@@ -1163,6 +1183,7 @@ declare interface AIAgentStringSet {
         a11y_send_message: string;
         a11y_attach_file: string;
         a11y_close_messenger: string;
+        a11y_dismiss_nudge_message: string;
         a11y_expand_messenger: string;
         a11y_collapse_messenger: string;
         a11y_connect_agent: string;
@@ -1462,6 +1483,8 @@ declare type ChatSDKConversation = Conversation_2;
 
 declare type ChatSDKConversationStatus = ConversationStatus;
 
+declare type ChatSDKCPAAuthorizationErrorCode = CPAAuthorizationErrorCode;
+
 declare type ChatSDKDeskChannelFilter = DeskChannelFilter;
 
 declare type ChatSDKFileMessage = FileMessage;
@@ -1540,6 +1563,9 @@ declare interface ColorSet {
     csat: {
         background: string;
     };
+    conversation: {
+        headerProfileSkeleton: string;
+    };
     memoryDialog: {
         titleText: string;
         markdownBodyText: string;
@@ -1578,6 +1604,7 @@ declare interface CommandPayloads {
     [CommandType.ActiveChannelUpdated]: ActiveChannelUpdatedParams;
     [CommandType.AnonymousSessionTokenExpired]: undefined;
     [CommandType.AuthTokenRefreshed]: AuthTokenRefreshedParams;
+    [CommandType.NudgeMessageReceived]: NudgeMessageResponse;
 }
 
 export declare const Commands = {
@@ -1586,6 +1613,7 @@ export declare const Commands = {
     ActiveChannelUpdated: (params: ActiveChannelUpdatedParams) => new ActiveChannelUpdatedCommand(params),
     AnonymousSessionTokenExpired: () => new AnonymousSessionTokenExpiredCommand(),
     AuthTokenRefreshed: () => new AuthTokenRefreshedCommand(),
+    NudgeMessageReceived: (response: NudgeMessageResponse) => new NudgeMessageReceivedCommand(response),
 };
 
 declare enum CommandType {
@@ -1594,6 +1622,7 @@ declare enum CommandType {
     ActiveChannelUpdated = 'active.channel.updated',
     AnonymousSessionTokenExpired = 'anon.token.expired',
     AuthTokenRefreshed = 'auth.token.refreshed',
+    NudgeMessageReceived = 'nudge.message.received',
 }
 
 export declare interface ConnectionDelayDialogProps {
@@ -1639,7 +1668,7 @@ declare interface ContextObject {
     context: Record<string, string>;
 }
 
-export declare const Conversation: ({ children, onNavigateToConversationList, channelUrl, onClearChannelUrl, shouldMarkAsRead, shouldInitializeConversation, announcementsEnabled, conversationStatsEnabled, initialFocusTarget, style, closedChannelUrl, onClearClosedChannelUrl, }: ConversationProps) => JSX.Element;
+export declare const Conversation: ({ children, onNavigateToConversationList, channelUrl, onClearChannelUrl, shouldMarkAsRead, shouldInitializeConversation, initialUserMessage, announcementsEnabled, conversationStatsEnabled, initialFocusTarget, style, closedChannelUrl, onClearClosedChannelUrl, }: ConversationProps) => JSX.Element;
 
 export declare const ConversationContext: Context<ConversationContextValue | null>;
 
@@ -1651,6 +1680,7 @@ declare interface ConversationContextProps {
     conversationStatsEnabled?: boolean;
     /** @internal */
     shouldInitializeConversation?: boolean;
+    initialUserMessage?: string;
 }
 
 export declare const ConversationContextProvider: ({ children, ...props }: PropsWithChildren<ConversationContextProps>) => JSX.Element;
@@ -2709,6 +2739,12 @@ export declare type ConversationProps = PropsWithChildren<{
     shouldMarkAsRead?: boolean;
     /** @internal */
     shouldInitializeConversation?: boolean;
+    /**
+     * Message to send as the first user message when the conversation is initialized
+     * on the server (e.g., the callback user message of a clicked nudge message).
+     * Applied only when the channel has no conversation yet.
+     */
+    initialUserMessage?: string;
     announcementsEnabled?: boolean;
     /** @default true */
     conversationStatsEnabled?: boolean;
@@ -2774,6 +2810,19 @@ declare interface ConversationScrollContextValue {
 
 declare type ConversationScrollMode = 'auto' | 'fixed';
 
+declare interface CPAAuthorizationCode {
+    key: string;
+    code: string;
+    redirectURI?: string;
+}
+
+declare interface CPAAuthorizationResult {
+    key: string;
+    status: 'ok' | 'error';
+    errorCode?: ChatSDKCPAAuthorizationErrorCode;
+    errorMessage?: string;
+}
+
 declare type CSATSubmitParams = {
     csatType: string;
     csat?: number;
@@ -3015,6 +3064,7 @@ export declare interface ExtendedMessagePayload {
 declare type ExternalAuthTokenExpiredData = {
     channelUrl: string;
     aiAgentId: string;
+    cpaKey: string;
 };
 
 export declare interface FeedbackInfo {
@@ -3165,6 +3215,12 @@ BaseMessageProps<{
     onStreamAnimationStart?: () => void;
     onStreamAnimationProgress?: () => void;
     onStreamAnimationComplete?: () => void;
+    /**
+     * Fired (layout effect) when this row starts/stops holding its text — the stream animation is
+     * running but nothing is visible yet. The row renders nothing while holding, so the list draws its
+     * single typing row on the row's behalf and keeps the held row out of the accessibility tree.
+     */
+    onStreamAnimationHoldChange?: (holding: boolean) => void;
 
     // fallbacks
     messageTemplateErrorFallback?: ReactNode;
@@ -3255,6 +3311,7 @@ export declare const IncomingMessageLayout: {
                 onStreamAnimationStart?: () => void;
                 onStreamAnimationProgress?: () => void;
                 onStreamAnimationComplete?: () => void;
+                onStreamAnimationHoldChange?: (holding: boolean) => void;
                 messageTemplateErrorFallback?: ReactNode;
                 messageTemplateLoadingFallback?: ReactNode;
             } & {
@@ -3333,6 +3390,7 @@ export declare const IncomingMessageLayout: {
                 onStreamAnimationStart?: () => void;
                 onStreamAnimationProgress?: () => void;
                 onStreamAnimationComplete?: () => void;
+                onStreamAnimationHoldChange?: (holding: boolean) => void;
                 messageTemplateErrorFallback?: ReactNode;
                 messageTemplateLoadingFallback?: ReactNode;
             } & {
@@ -3411,6 +3469,7 @@ export declare const IncomingMessageLayout: {
                 onStreamAnimationStart?: () => void;
                 onStreamAnimationProgress?: () => void;
                 onStreamAnimationComplete?: () => void;
+                onStreamAnimationHoldChange?: (holding: boolean) => void;
                 messageTemplateErrorFallback?: ReactNode;
                 messageTemplateLoadingFallback?: ReactNode;
             } & {
@@ -3485,6 +3544,7 @@ export declare const IncomingMessageLayout: {
                 onStreamAnimationStart?: () => void;
                 onStreamAnimationProgress?: () => void;
                 onStreamAnimationComplete?: () => void;
+                onStreamAnimationHoldChange?: (holding: boolean) => void;
                 messageTemplateErrorFallback?: ReactNode;
                 messageTemplateLoadingFallback?: ReactNode;
             } & {
@@ -3563,6 +3623,7 @@ export declare const IncomingMessageLayout: {
                 onStreamAnimationStart?: () => void;
                 onStreamAnimationProgress?: () => void;
                 onStreamAnimationComplete?: () => void;
+                onStreamAnimationHoldChange?: (holding: boolean) => void;
                 messageTemplateErrorFallback?: ReactNode;
                 messageTemplateLoadingFallback?: ReactNode;
             } & {
@@ -3641,6 +3702,7 @@ export declare const IncomingMessageLayout: {
                 onStreamAnimationStart?: () => void;
                 onStreamAnimationProgress?: () => void;
                 onStreamAnimationComplete?: () => void;
+                onStreamAnimationHoldChange?: (holding: boolean) => void;
                 messageTemplateErrorFallback?: ReactNode;
                 messageTemplateLoadingFallback?: ReactNode;
             } & {
@@ -3747,6 +3809,7 @@ export declare const IncomingMessageLayout: {
     onStreamAnimationStart?: () => void;
     onStreamAnimationProgress?: () => void;
     onStreamAnimationComplete?: () => void;
+    onStreamAnimationHoldChange?: (holding: boolean) => void;
     messageTemplateErrorFallback?: ReactNode;
     messageTemplateLoadingFallback?: ReactNode;
     } & {
@@ -3825,6 +3888,7 @@ export declare const IncomingMessageLayout: {
     onStreamAnimationStart?: () => void;
     onStreamAnimationProgress?: () => void;
     onStreamAnimationComplete?: () => void;
+    onStreamAnimationHoldChange?: (holding: boolean) => void;
     messageTemplateErrorFallback?: ReactNode;
     messageTemplateLoadingFallback?: ReactNode;
     } & {
@@ -3903,6 +3967,7 @@ export declare const IncomingMessageLayout: {
     onStreamAnimationStart?: () => void;
     onStreamAnimationProgress?: () => void;
     onStreamAnimationComplete?: () => void;
+    onStreamAnimationHoldChange?: (holding: boolean) => void;
     messageTemplateErrorFallback?: ReactNode;
     messageTemplateLoadingFallback?: ReactNode;
     } & {
@@ -3977,6 +4042,7 @@ export declare const IncomingMessageLayout: {
     onStreamAnimationStart?: () => void;
     onStreamAnimationProgress?: () => void;
     onStreamAnimationComplete?: () => void;
+    onStreamAnimationHoldChange?: (holding: boolean) => void;
     messageTemplateErrorFallback?: ReactNode;
     messageTemplateLoadingFallback?: ReactNode;
     } & {
@@ -4055,6 +4121,7 @@ export declare const IncomingMessageLayout: {
     onStreamAnimationStart?: () => void;
     onStreamAnimationProgress?: () => void;
     onStreamAnimationComplete?: () => void;
+    onStreamAnimationHoldChange?: (holding: boolean) => void;
     messageTemplateErrorFallback?: ReactNode;
     messageTemplateLoadingFallback?: ReactNode;
     } & {
@@ -4133,6 +4200,7 @@ export declare const IncomingMessageLayout: {
     onStreamAnimationStart?: () => void;
     onStreamAnimationProgress?: () => void;
     onStreamAnimationComplete?: () => void;
+    onStreamAnimationHoldChange?: (holding: boolean) => void;
     messageTemplateErrorFallback?: ReactNode;
     messageTemplateLoadingFallback?: ReactNode;
     } & {
@@ -4234,6 +4302,7 @@ export declare const IncomingMessageLayout: {
     onStreamAnimationStart?: () => void;
     onStreamAnimationProgress?: () => void;
     onStreamAnimationComplete?: () => void;
+    onStreamAnimationHoldChange?: (holding: boolean) => void;
     messageTemplateErrorFallback?: ReactNode;
     messageTemplateLoadingFallback?: ReactNode;
     } & {
@@ -4312,6 +4381,7 @@ export declare const IncomingMessageLayout: {
     onStreamAnimationStart?: () => void;
     onStreamAnimationProgress?: () => void;
     onStreamAnimationComplete?: () => void;
+    onStreamAnimationHoldChange?: (holding: boolean) => void;
     messageTemplateErrorFallback?: ReactNode;
     messageTemplateLoadingFallback?: ReactNode;
     } & {
@@ -4390,6 +4460,7 @@ export declare const IncomingMessageLayout: {
     onStreamAnimationStart?: () => void;
     onStreamAnimationProgress?: () => void;
     onStreamAnimationComplete?: () => void;
+    onStreamAnimationHoldChange?: (holding: boolean) => void;
     messageTemplateErrorFallback?: ReactNode;
     messageTemplateLoadingFallback?: ReactNode;
     } & {
@@ -4464,6 +4535,7 @@ export declare const IncomingMessageLayout: {
     onStreamAnimationStart?: () => void;
     onStreamAnimationProgress?: () => void;
     onStreamAnimationComplete?: () => void;
+    onStreamAnimationHoldChange?: (holding: boolean) => void;
     messageTemplateErrorFallback?: ReactNode;
     messageTemplateLoadingFallback?: ReactNode;
     } & {
@@ -4542,6 +4614,7 @@ export declare const IncomingMessageLayout: {
     onStreamAnimationStart?: () => void;
     onStreamAnimationProgress?: () => void;
     onStreamAnimationComplete?: () => void;
+    onStreamAnimationHoldChange?: (holding: boolean) => void;
     messageTemplateErrorFallback?: ReactNode;
     messageTemplateLoadingFallback?: ReactNode;
     } & {
@@ -4620,6 +4693,7 @@ export declare const IncomingMessageLayout: {
     onStreamAnimationStart?: () => void;
     onStreamAnimationProgress?: () => void;
     onStreamAnimationComplete?: () => void;
+    onStreamAnimationHoldChange?: (holding: boolean) => void;
     messageTemplateErrorFallback?: ReactNode;
     messageTemplateLoadingFallback?: ReactNode;
     } & {
@@ -4744,6 +4818,7 @@ export declare const IncomingMessageLayout: {
             onStreamAnimationStart?: () => void;
             onStreamAnimationProgress?: () => void;
             onStreamAnimationComplete?: () => void;
+            onStreamAnimationHoldChange?: (holding: boolean) => void;
             messageTemplateErrorFallback?: ReactNode;
             messageTemplateLoadingFallback?: ReactNode;
         } & {
@@ -4822,6 +4897,7 @@ export declare const IncomingMessageLayout: {
             onStreamAnimationStart?: () => void;
             onStreamAnimationProgress?: () => void;
             onStreamAnimationComplete?: () => void;
+            onStreamAnimationHoldChange?: (holding: boolean) => void;
             messageTemplateErrorFallback?: ReactNode;
             messageTemplateLoadingFallback?: ReactNode;
         } & {
@@ -4900,6 +4976,7 @@ export declare const IncomingMessageLayout: {
             onStreamAnimationStart?: () => void;
             onStreamAnimationProgress?: () => void;
             onStreamAnimationComplete?: () => void;
+            onStreamAnimationHoldChange?: (holding: boolean) => void;
             messageTemplateErrorFallback?: ReactNode;
             messageTemplateLoadingFallback?: ReactNode;
         } & {
@@ -4976,6 +5053,7 @@ export declare const IncomingMessageLayout: {
             onStreamAnimationStart?: () => void;
             onStreamAnimationProgress?: () => void;
             onStreamAnimationComplete?: () => void;
+            onStreamAnimationHoldChange?: (holding: boolean) => void;
             messageTemplateErrorFallback?: ReactNode;
             messageTemplateLoadingFallback?: ReactNode;
         } & {
@@ -5054,6 +5132,7 @@ export declare const IncomingMessageLayout: {
             onStreamAnimationStart?: () => void;
             onStreamAnimationProgress?: () => void;
             onStreamAnimationComplete?: () => void;
+            onStreamAnimationHoldChange?: (holding: boolean) => void;
             messageTemplateErrorFallback?: ReactNode;
             messageTemplateLoadingFallback?: ReactNode;
         } & {
@@ -5132,6 +5211,7 @@ export declare const IncomingMessageLayout: {
             onStreamAnimationStart?: () => void;
             onStreamAnimationProgress?: () => void;
             onStreamAnimationComplete?: () => void;
+            onStreamAnimationHoldChange?: (holding: boolean) => void;
             messageTemplateErrorFallback?: ReactNode;
             messageTemplateLoadingFallback?: ReactNode;
         } & {
@@ -5613,6 +5693,9 @@ declare class MessagePendingStuckStatsTracker extends MultiStatsTrackerBase<Mess
     }
 }
 
+/** How a message's sender is drawn: the typing row's user and every message row's sender share this. */
+declare type MessageSenderInfo = { userId: string; nickname: string; profileUrl?: string };
+
 declare interface MessageTemplateCache {
     set(key: string, value: string): void;
     get(key: string): string | null;
@@ -5840,6 +5923,13 @@ declare interface NetworkStateAdapter {
     subscribe: (callback: (isOnline: boolean) => void) => () => void;
 }
 
+export declare interface NudgeMessageResponse {
+    /** Message to display above the launcher. */
+    message: string;
+    /** Message to send as the first user message when the nudge is clicked. */
+    callbackUserMessage?: string;
+}
+
 declare type NumberField = {
     key: string;
     type: 'number';
@@ -6421,6 +6511,13 @@ declare class RenderedContentUnusableStatsTracker extends StatsTrackerBase {
     }
 }
 
+export declare interface RequestNudgeMessageParams {
+    /** Event key that triggers the nudge message. */
+    key: string;
+    /** Additional context for the server to generate the message. */
+    context?: Record<string, string>;
+}
+
 declare interface ResolvedHandlers extends AgentClientHandlers {
     onClickLink: (params: {
         url: string;
@@ -6602,6 +6699,25 @@ declare enum StewardTaskStatus {
     CANCELED = 'CANCELED',
 }
 
+declare type StreamAnimation = {
+    isAnimating: boolean;
+    start: (id: string | number) => void;
+    stop: (id: string | number) => void;
+    isHolding: (id: string | number) => boolean;
+    /**
+     * Set while a row holds its streamed text. The list draws a single typing row, so it falls back to
+     * this when nobody is typing — a live typing signal always wins.
+     *
+     * Never carries a thinking message, deliberately: a row enters the hold only after its reply started
+     * streaming, so the agent's thinking phase is over by then — the frame is held back by our own start
+     * gate, not by the agent still thinking. Relaying the last thinking text here would report a state it
+     * has already left, so the typing row falls back to dots for this window.
+     */
+    heldTypingInfo?: TypingRowInfo;
+    holdStart: (id: string | number, info: TypingRowInfo) => void;
+    holdStop: (id: string | number) => void;
+};
+
 declare type StreamMeasure = {
     channelUrl?: string;
     deliveryTimer: TimeoutId | null;
@@ -7075,6 +7191,7 @@ export declare type StringSet = {
     A11Y_CONVERSATION_ITEM: (agent: string, status: string, time: string, count: number) => string;
     A11Y_CONNECT_AGENT: string;
     A11Y_CLOSE_MESSENGER: string;
+    A11Y_DISMISS_NUDGE_MESSAGE: string;
     A11Y_EXPAND_MESSENGER: string;
     A11Y_COLLAPSE_MESSENGER: string;
     A11Y_HINT_SEND_MESSAGE: string;
@@ -7131,6 +7248,10 @@ export declare type StringSet = {
     CHANNEL_FROZEN: string;
 };
 
+declare interface SubmitCPAAuthorizationCodesResponse {
+    cpaAuthorizations: CPAAuthorizationResult[];
+}
+
 declare type SystemBaseMessageProps<T> = T & BaseMessageProps<{}>;
 
 declare type SystemCSATMessageProps = SystemMessageProps & {
@@ -7478,6 +7599,16 @@ declare type TypingMeasure = {
     userMessageId?: number;
 };
 
+/**
+ * What the list's single typing row renders, whoever it is drawn for. `user.userId` identifies the row
+ * it stands in for, which is how the typing bridge tells the awaited reply from anyone else's.
+ */
+declare type TypingRowInfo = {
+    user: MessageSenderInfo;
+    isBot: boolean;
+    thinkingMessage?: string;
+};
+
 declare type TypingTurnEntry = {
     requestId: string;
     record: StatsRecord<TypingIndicatorAbsentTimeoutStats, TypingMeasure>;