@sendbird/ai-agent-messenger-react 1.39.1 → 1.40.1

package/dist/index.d.ts

@@ -799,6 +799,9 @@ declare interface AIAgentInterface {
     /** @internal Initializes a conversation on the channel if needed (AI Agent channel without conversation). */
     initConversationIfNeeded: (channel: ChatSDKGroupChannel, params?: { initialUserMessage?: string }) => Promise<void>;
 
+    /** @internal Records the end user's response to a Desk ticket closure inquiry. */
+    confirmEndOfChat: (params: ConfirmEndOfChatParams) => Promise<void>;
+
     /** @internal Live metric handler; bridged from {@link AIAgentClientHandlers.onLiveMetric}. */
     onLiveMetric?: LiveMetricDispatch;
 
@@ -1328,6 +1331,12 @@ declare interface AIAgentStringSet {
         title: string;
         description: (formattedTime: string) => string;
     };
+
+    desk: {
+        ticket_closure_confirm: string;
+        ticket_closure_decline: string;
+        ticket_closure_error_message: string;
+    };
 }
 
 /**
@@ -1629,6 +1638,12 @@ declare enum CommandType {
     NudgeMessageReceived = 'nudge.message.received',
 }
 
+declare interface ConfirmEndOfChatParams {
+    messageId: number;
+    ticketId: number;
+    confirmed: boolean;
+}
+
 export declare interface ConnectionDelayDialogProps {
     title: string;
     description: string;
@@ -3063,6 +3078,8 @@ export declare interface ExtendedMessagePayload {
     manual: ActionbookInfo;
     function_calls: FunctionCallsInfo[];
     agent_message_templates: AgentMessageTemplateInfo[];
+
+    prechecks?: PrecheckRecord[];
 }
 
 declare type ExternalAuthTokenExpiredData = {
@@ -3215,6 +3232,7 @@ BaseMessageProps<{
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
     onClickSuggestedReply?: (params: { reply: string }) => void;
+    onConfirmTicketClosure?: (params: { ticketId: number; confirmed: boolean }) => Promise<void>;
     onClickCTA?: (params: { url: string }) => void;
     onClickCitation?: (citation: CitationInfo) => void;
     onFeedbackUpdate?: (params: { rating: 'good' | 'bad'; comment?: string } | null) => void;
@@ -3271,8 +3289,8 @@ export declare const IncomingMessageLayout: {
                     bubbleBackgroundColor?: string;
                 };
             }) => ReactNode;
-            SuggestedReplies: ({ extendedMessagePayload, onClickSuggestedReply, suggestedRepliesDirection, }: IncomingMessageProps) => ReactNode;
-            MessageTemplate: (props: Pick<IncomingMessageProps, "onClickLink" | "onGetCachedMessageTemplate" | "onRequestMessageTemplate" | "onHandleTemplateInternalAction" | "messageTemplateErrorFallback" | "messageTemplateLoadingFallback" | "extendedMessagePayload"> & {
+            SuggestedReplies: ({ data, extendedMessagePayload, onClickSuggestedReply, onConfirmTicketClosure, suggestedRepliesDirection, }: IncomingMessageProps) => ReactNode;
+            MessageTemplate: (props: Pick<IncomingMessageProps, "extendedMessagePayload" | "onClickLink" | "onGetCachedMessageTemplate" | "onRequestMessageTemplate" | "onHandleTemplateInternalAction" | "messageTemplateErrorFallback" | "messageTemplateLoadingFallback"> & {
                 statsCallbacks?: Pick<IncomingMessageStatsCallbacks, "onMessageTemplateError">;
             }) => ReactNode;
             CustomMessageTemplate: (_: ({
@@ -3301,6 +3319,10 @@ export declare const IncomingMessageLayout: {
                 onClickSuggestedReply?: (params: {
                     reply: string;
                 }) => void;
+                onConfirmTicketClosure?: (params: {
+                    ticketId: number;
+                    confirmed: boolean;
+                }) => Promise<void>;
                 onClickCTA?: (params: {
                     url: string;
                 }) => void;
@@ -3380,6 +3402,10 @@ export declare const IncomingMessageLayout: {
                 onClickSuggestedReply?: (params: {
                     reply: string;
                 }) => void;
+                onConfirmTicketClosure?: (params: {
+                    ticketId: number;
+                    confirmed: boolean;
+                }) => Promise<void>;
                 onClickCTA?: (params: {
                     url: string;
                 }) => void;
@@ -3459,6 +3485,10 @@ export declare const IncomingMessageLayout: {
                 onClickSuggestedReply?: (params: {
                     reply: string;
                 }) => void;
+                onConfirmTicketClosure?: (params: {
+                    ticketId: number;
+                    confirmed: boolean;
+                }) => Promise<void>;
                 onClickCTA?: (params: {
                     url: string;
                 }) => void;
@@ -3534,6 +3564,10 @@ export declare const IncomingMessageLayout: {
                 onClickSuggestedReply?: (params: {
                     reply: string;
                 }) => void;
+                onConfirmTicketClosure?: (params: {
+                    ticketId: number;
+                    confirmed: boolean;
+                }) => Promise<void>;
                 onClickCTA?: (params: {
                     url: string;
                 }) => void;
@@ -3613,6 +3647,10 @@ export declare const IncomingMessageLayout: {
                 onClickSuggestedReply?: (params: {
                     reply: string;
                 }) => void;
+                onConfirmTicketClosure?: (params: {
+                    ticketId: number;
+                    confirmed: boolean;
+                }) => Promise<void>;
                 onClickCTA?: (params: {
                     url: string;
                 }) => void;
@@ -3692,6 +3730,10 @@ export declare const IncomingMessageLayout: {
                 onClickSuggestedReply?: (params: {
                     reply: string;
                 }) => void;
+                onConfirmTicketClosure?: (params: {
+                    ticketId: number;
+                    confirmed: boolean;
+                }) => Promise<void>;
                 onClickCTA?: (params: {
                     url: string;
                 }) => void;
@@ -3748,6 +3790,7 @@ export declare const IncomingMessageLayout: {
             }) => ReactNode;
             Feedback: ({ isBotMessage, isConversationClosed, isStreaming, isFeedbackEnabled, isFeedbackCommentEnabled, extendedMessagePayload, onFeedbackUpdate, }: IncomingMessageProps) => ReactNode;
             MessageLogs: (_: IncomingMessageProps) => ReactNode;
+            Prechecks: (_: IncomingMessageProps) => ReactNode;
         };
     };
     Template: ({ template, children }: {
@@ -3769,8 +3812,8 @@ export declare const IncomingMessageLayout: {
     bubbleBackgroundColor?: string;
     };
     }) => ReactNode;
-    SuggestedReplies: ({ extendedMessagePayload, onClickSuggestedReply, suggestedRepliesDirection, }: IncomingMessageProps) => ReactNode;
-    MessageTemplate: (props: Pick<IncomingMessageProps, "onClickLink" | "onGetCachedMessageTemplate" | "onRequestMessageTemplate" | "onHandleTemplateInternalAction" | "messageTemplateErrorFallback" | "messageTemplateLoadingFallback" | "extendedMessagePayload"> & {
+    SuggestedReplies: ({ data, extendedMessagePayload, onClickSuggestedReply, onConfirmTicketClosure, suggestedRepliesDirection, }: IncomingMessageProps) => ReactNode;
+    MessageTemplate: (props: Pick<IncomingMessageProps, "extendedMessagePayload" | "onClickLink" | "onGetCachedMessageTemplate" | "onRequestMessageTemplate" | "onHandleTemplateInternalAction" | "messageTemplateErrorFallback" | "messageTemplateLoadingFallback"> & {
     statsCallbacks?: Pick<IncomingMessageStatsCallbacks, "onMessageTemplateError">;
     }) => ReactNode;
     CustomMessageTemplate: (_: ({
@@ -3799,6 +3842,10 @@ export declare const IncomingMessageLayout: {
     onClickSuggestedReply?: (params: {
     reply: string;
     }) => void;
+    onConfirmTicketClosure?: (params: {
+    ticketId: number;
+    confirmed: boolean;
+    }) => Promise<void>;
     onClickCTA?: (params: {
     url: string;
     }) => void;
@@ -3878,6 +3925,10 @@ export declare const IncomingMessageLayout: {
     onClickSuggestedReply?: (params: {
     reply: string;
     }) => void;
+    onConfirmTicketClosure?: (params: {
+    ticketId: number;
+    confirmed: boolean;
+    }) => Promise<void>;
     onClickCTA?: (params: {
     url: string;
     }) => void;
@@ -3957,6 +4008,10 @@ export declare const IncomingMessageLayout: {
     onClickSuggestedReply?: (params: {
     reply: string;
     }) => void;
+    onConfirmTicketClosure?: (params: {
+    ticketId: number;
+    confirmed: boolean;
+    }) => Promise<void>;
     onClickCTA?: (params: {
     url: string;
     }) => void;
@@ -4032,6 +4087,10 @@ export declare const IncomingMessageLayout: {
     onClickSuggestedReply?: (params: {
     reply: string;
     }) => void;
+    onConfirmTicketClosure?: (params: {
+    ticketId: number;
+    confirmed: boolean;
+    }) => Promise<void>;
     onClickCTA?: (params: {
     url: string;
     }) => void;
@@ -4111,6 +4170,10 @@ export declare const IncomingMessageLayout: {
     onClickSuggestedReply?: (params: {
     reply: string;
     }) => void;
+    onConfirmTicketClosure?: (params: {
+    ticketId: number;
+    confirmed: boolean;
+    }) => Promise<void>;
     onClickCTA?: (params: {
     url: string;
     }) => void;
@@ -4190,6 +4253,10 @@ export declare const IncomingMessageLayout: {
     onClickSuggestedReply?: (params: {
     reply: string;
     }) => void;
+    onConfirmTicketClosure?: (params: {
+    ticketId: number;
+    confirmed: boolean;
+    }) => Promise<void>;
     onClickCTA?: (params: {
     url: string;
     }) => void;
@@ -4246,6 +4313,7 @@ export declare const IncomingMessageLayout: {
     }) => ReactNode;
     Feedback: ({ isBotMessage, isConversationClosed, isStreaming, isFeedbackEnabled, isFeedbackCommentEnabled, extendedMessagePayload, onFeedbackUpdate, }: IncomingMessageProps) => ReactNode;
     MessageLogs: (_: IncomingMessageProps) => ReactNode;
+    Prechecks: (_: IncomingMessageProps) => ReactNode;
     }>>;
     useContext: () => LayoutContextValue<IncomingMessageTemplateProps, {
     SenderName: ({ sender }: Pick<IncomingMessageProps, "sender">) => ReactNode;
@@ -4262,8 +4330,8 @@ export declare const IncomingMessageLayout: {
     bubbleBackgroundColor?: string;
     };
     }) => ReactNode;
-    SuggestedReplies: ({ extendedMessagePayload, onClickSuggestedReply, suggestedRepliesDirection, }: IncomingMessageProps) => ReactNode;
-    MessageTemplate: (props: Pick<IncomingMessageProps, "onClickLink" | "onGetCachedMessageTemplate" | "onRequestMessageTemplate" | "onHandleTemplateInternalAction" | "messageTemplateErrorFallback" | "messageTemplateLoadingFallback" | "extendedMessagePayload"> & {
+    SuggestedReplies: ({ data, extendedMessagePayload, onClickSuggestedReply, onConfirmTicketClosure, suggestedRepliesDirection, }: IncomingMessageProps) => ReactNode;
+    MessageTemplate: (props: Pick<IncomingMessageProps, "extendedMessagePayload" | "onClickLink" | "onGetCachedMessageTemplate" | "onRequestMessageTemplate" | "onHandleTemplateInternalAction" | "messageTemplateErrorFallback" | "messageTemplateLoadingFallback"> & {
     statsCallbacks?: Pick<IncomingMessageStatsCallbacks, "onMessageTemplateError">;
     }) => ReactNode;
     CustomMessageTemplate: (_: ({
@@ -4292,6 +4360,10 @@ export declare const IncomingMessageLayout: {
     onClickSuggestedReply?: (params: {
     reply: string;
     }) => void;
+    onConfirmTicketClosure?: (params: {
+    ticketId: number;
+    confirmed: boolean;
+    }) => Promise<void>;
     onClickCTA?: (params: {
     url: string;
     }) => void;
@@ -4371,6 +4443,10 @@ export declare const IncomingMessageLayout: {
     onClickSuggestedReply?: (params: {
     reply: string;
     }) => void;
+    onConfirmTicketClosure?: (params: {
+    ticketId: number;
+    confirmed: boolean;
+    }) => Promise<void>;
     onClickCTA?: (params: {
     url: string;
     }) => void;
@@ -4450,6 +4526,10 @@ export declare const IncomingMessageLayout: {
     onClickSuggestedReply?: (params: {
     reply: string;
     }) => void;
+    onConfirmTicketClosure?: (params: {
+    ticketId: number;
+    confirmed: boolean;
+    }) => Promise<void>;
     onClickCTA?: (params: {
     url: string;
     }) => void;
@@ -4525,6 +4605,10 @@ export declare const IncomingMessageLayout: {
     onClickSuggestedReply?: (params: {
     reply: string;
     }) => void;
+    onConfirmTicketClosure?: (params: {
+    ticketId: number;
+    confirmed: boolean;
+    }) => Promise<void>;
     onClickCTA?: (params: {
     url: string;
     }) => void;
@@ -4604,6 +4688,10 @@ export declare const IncomingMessageLayout: {
     onClickSuggestedReply?: (params: {
     reply: string;
     }) => void;
+    onConfirmTicketClosure?: (params: {
+    ticketId: number;
+    confirmed: boolean;
+    }) => Promise<void>;
     onClickCTA?: (params: {
     url: string;
     }) => void;
@@ -4683,6 +4771,10 @@ export declare const IncomingMessageLayout: {
     onClickSuggestedReply?: (params: {
     reply: string;
     }) => void;
+    onConfirmTicketClosure?: (params: {
+    ticketId: number;
+    confirmed: boolean;
+    }) => Promise<void>;
     onClickCTA?: (params: {
     url: string;
     }) => void;
@@ -4739,10 +4831,11 @@ export declare const IncomingMessageLayout: {
     }) => ReactNode;
     Feedback: ({ isBotMessage, isConversationClosed, isStreaming, isFeedbackEnabled, isFeedbackCommentEnabled, extendedMessagePayload, onFeedbackUpdate, }: IncomingMessageProps) => ReactNode;
     MessageLogs: (_: IncomingMessageProps) => ReactNode;
+    Prechecks: (_: IncomingMessageProps) => ReactNode;
     }>;
 } & {
     MessageTemplate: (props: {
-        component: (props: Pick<IncomingMessageProps, "onClickLink" | "onGetCachedMessageTemplate" | "onRequestMessageTemplate" | "onHandleTemplateInternalAction" | "messageTemplateErrorFallback" | "messageTemplateLoadingFallback" | "extendedMessagePayload"> & {
+        component: (props: Pick<IncomingMessageProps, "extendedMessagePayload" | "onClickLink" | "onGetCachedMessageTemplate" | "onRequestMessageTemplate" | "onHandleTemplateInternalAction" | "messageTemplateErrorFallback" | "messageTemplateLoadingFallback"> & {
             statsCallbacks?: Pick<IncomingMessageStatsCallbacks, "onMessageTemplateError">;
         }) => ReactNode;
     }) => null;
@@ -4779,7 +4872,7 @@ export declare const IncomingMessageLayout: {
         }) => ReactNode;
     }) => null;
     SuggestedReplies: (props: {
-        component: ({ extendedMessagePayload, onClickSuggestedReply, suggestedRepliesDirection, }: IncomingMessageProps) => ReactNode;
+        component: ({ data, extendedMessagePayload, onClickSuggestedReply, onConfirmTicketClosure, suggestedRepliesDirection, }: IncomingMessageProps) => ReactNode;
     }) => null;
     CustomMessageTemplate: (props: {
         component: (_: ({
@@ -4808,6 +4901,10 @@ export declare const IncomingMessageLayout: {
             onClickSuggestedReply?: (params: {
                 reply: string;
             }) => void;
+            onConfirmTicketClosure?: (params: {
+                ticketId: number;
+                confirmed: boolean;
+            }) => Promise<void>;
             onClickCTA?: (params: {
                 url: string;
             }) => void;
@@ -4887,6 +4984,10 @@ export declare const IncomingMessageLayout: {
             onClickSuggestedReply?: (params: {
                 reply: string;
             }) => void;
+            onConfirmTicketClosure?: (params: {
+                ticketId: number;
+                confirmed: boolean;
+            }) => Promise<void>;
             onClickCTA?: (params: {
                 url: string;
             }) => void;
@@ -4966,6 +5067,10 @@ export declare const IncomingMessageLayout: {
             onClickSuggestedReply?: (params: {
                 reply: string;
             }) => void;
+            onConfirmTicketClosure?: (params: {
+                ticketId: number;
+                confirmed: boolean;
+            }) => Promise<void>;
             onClickCTA?: (params: {
                 url: string;
             }) => void;
@@ -5043,6 +5148,10 @@ export declare const IncomingMessageLayout: {
             onClickSuggestedReply?: (params: {
                 reply: string;
             }) => void;
+            onConfirmTicketClosure?: (params: {
+                ticketId: number;
+                confirmed: boolean;
+            }) => Promise<void>;
             onClickCTA?: (params: {
                 url: string;
             }) => void;
@@ -5122,6 +5231,10 @@ export declare const IncomingMessageLayout: {
             onClickSuggestedReply?: (params: {
                 reply: string;
             }) => void;
+            onConfirmTicketClosure?: (params: {
+                ticketId: number;
+                confirmed: boolean;
+            }) => Promise<void>;
             onClickCTA?: (params: {
                 url: string;
             }) => void;
@@ -5201,6 +5314,10 @@ export declare const IncomingMessageLayout: {
             onClickSuggestedReply?: (params: {
                 reply: string;
             }) => void;
+            onConfirmTicketClosure?: (params: {
+                ticketId: number;
+                confirmed: boolean;
+            }) => Promise<void>;
             onClickCTA?: (params: {
                 url: string;
             }) => void;
@@ -5268,6 +5385,9 @@ export declare const IncomingMessageLayout: {
     MessageLogs: (props: {
         component: (_: IncomingMessageProps) => ReactNode;
     }) => null;
+    Prechecks: (props: {
+        component: (_: IncomingMessageProps) => ReactNode;
+    }) => null;
 };
 
 export declare type IncomingMessageProps<T extends IncomingMessageUnion['messageType'] = IncomingMessageUnion['messageType']> =
@@ -6239,6 +6359,18 @@ export declare type PositionHorizontal = 'start' | 'end';
 
 export declare type PositionVertical = 'top' | 'bottom';
 
+export declare interface PrecheckRecord {
+    key: string;
+}
+
+/**
+ * Consent prechecks status bar: a row of passed checks shown above a consent-gated
+ * bot bubble. Rendered only in the dashboard tester (via the DashboardTester layout
+ * override), so customers never see it.
+ * @see @contexts/_UNSAFE_INTERNAL_DashboardTesterContext.tsx
+ */
+export declare const Prechecks: ({ prechecks, maxBodyWidth }: Props_3) => ReactNode;
+
 declare type PresentMethod = 'launcher_toggle' | 'direct_present' | 'embedded';
 
 declare type Props = {
@@ -6294,6 +6426,11 @@ declare type Props_2 = {
     }) => ReactNode;
 };
 
+declare type Props_3 = {
+    prechecks: PrecheckRecord[];
+    maxBodyWidth?: number;
+};
+
 declare type ReactOnlyIconName = 'expand' | 'collapse' | 'chevron-right' | 'attach' | 'close-filled' | 'actionbook' | 'function' | 'confluence' | 'zendesk' | 'salesforce' | 'sprinklr' | 'website' | 'snippet' | 'template' | 'show' | 'mute' | 'activity';
 
 declare type RecoveryMeasure = {
@@ -7246,6 +7383,9 @@ export declare type StringSet = {
     A11Y_MEMORY_INDICATOR_MANAGE: string;
     A11Y_MEMORY_INDICATOR_ON: string;
     A11Y_MEMORY_INDICATOR_OFF: string;
+    DESK__TICKET_CLOSURE_CONFIRM: string;
+    DESK__TICKET_CLOSURE_DECLINE: string;
+    DESK__TICKET_CLOSURE_ERROR_MESSAGE: string;
     CONNECTION_DELAY__TITLE: string;
     CONNECTION_DELAY__DESCRIPTION: (formattedTime: string) => string;
     /** @deprecated Please use DATE_FORMAT__DATE_SHORT instead. **/