@sendbird/ai-agent-messenger-react 1.20.0 → 1.21.0

package/dist/index.d.ts

@@ -128,6 +128,7 @@ export declare interface AgentPreviewConfigs {
         imageUrl: string;
     };
     forceCreateChannel?: boolean;
+    agentVersion?: number;
     agentAttributes?: {
         ai?: Record<string, unknown>;
         safeguard?: Record<string, unknown>;
@@ -602,6 +603,9 @@ declare interface AIAgentInterface {
     /** The context object for AI Agent */
     context?: Record<string, string>;
 
+    /** @internal Agent version for conversation initialization */
+    agentVersion?: number;
+
     /** @internal Stats trackers for performance monitoring */
     readonly statsTrackers: {
         initialRender: ConversationInitialRenderStatsTracker;
@@ -629,6 +633,9 @@ declare interface AIAgentInterface {
     /** @internal Refreshes the active channel by re-requesting messenger settings */
     refreshActiveChannel: (options?: { useKnownActiveChannelUrl?: boolean }) => Promise<string>;
 
+    /** @internal Initializes a conversation on the channel if needed (AI Agent channel without conversation). */
+    initConversationIfNeeded: (channel: GroupChannel) => Promise<void>;
+
     /** Disposes all resources held by this instance (WebSocket, desk auth, event handlers). */
     dispose: () => void;
 
@@ -1928,15 +1935,9 @@ declare interface ConversationScrollContextValue {
     ref: RefObject<HTMLDivElement | null> | ((element: HTMLDivElement | null) => void);
     state: {
         bottomSpace: number;
-        /**
-         * Whether user has scrolled away from the latest messages.
-         * Use this to determine when to show floating action buttons (scroll to bottom, new messages, etc.)
-         */
         isAwayFromBottom: boolean;
-        /**
-         * Determines whether new messages should be counted.
-         * Returns true when user is not at bottom (browsing old messages).
-         */
+        /** Whether programmatic scroll has completed. False during optimistic updates, true after reconciliation. */
+        isScrollPositionReconciled: boolean;
         shouldCountNewMessages: () => boolean;
     };
     props: {
@@ -2325,6 +2326,7 @@ BaseMessageProps<{
         nickname: string;
         profileUrl?: string;
     };
+    thinkingMessage?: string;
 
     // flags
     suggestedRepliesVisible?: boolean;
@@ -2381,7 +2383,7 @@ export declare const IncomingMessageLayout: {
             MediaMessageBody: typeof IncomingMediaBody;
             FileMessageBody: typeof IncomingFileBody;
             MultipleFilesMessageBody: ({ files, children, onClickMedia, onClickMediaFiles, }: IncomingMessageBodyProps<"multipleFiles">) => JSX.Element;
-            TypingIndicator: ({ customStyle }: IncomingMessageProps & {
+            TypingIndicator: ({ thinkingMessage, customStyle }: IncomingMessageProps & {
                 customStyle?: {
                     bubbleContentColor?: string;
                     bubbleBackgroundColor?: string;
@@ -2404,6 +2406,7 @@ export declare const IncomingMessageLayout: {
                     nickname: string;
                     profileUrl?: string;
                 };
+                thinkingMessage?: string;
                 suggestedRepliesVisible?: boolean;
                 suggestedRepliesDirection?: "vertical" | "horizontal";
                 isBotMessage?: boolean;
@@ -2476,6 +2479,7 @@ export declare const IncomingMessageLayout: {
                     nickname: string;
                     profileUrl?: string;
                 };
+                thinkingMessage?: string;
                 suggestedRepliesVisible?: boolean;
                 suggestedRepliesDirection?: "vertical" | "horizontal";
                 isBotMessage?: boolean;
@@ -2548,6 +2552,7 @@ export declare const IncomingMessageLayout: {
                     nickname: string;
                     profileUrl?: string;
                 };
+                thinkingMessage?: string;
                 suggestedRepliesVisible?: boolean;
                 suggestedRepliesDirection?: "vertical" | "horizontal";
                 isBotMessage?: boolean;
@@ -2628,7 +2633,7 @@ export declare const IncomingMessageLayout: {
     MediaMessageBody: typeof IncomingMediaBody;
     FileMessageBody: typeof IncomingFileBody;
     MultipleFilesMessageBody: ({ files, children, onClickMedia, onClickMediaFiles, }: IncomingMessageBodyProps<"multipleFiles">) => JSX.Element;
-    TypingIndicator: ({ customStyle }: IncomingMessageProps & {
+    TypingIndicator: ({ thinkingMessage, customStyle }: IncomingMessageProps & {
     customStyle?: {
     bubbleContentColor?: string;
     bubbleBackgroundColor?: string;
@@ -2651,6 +2656,7 @@ export declare const IncomingMessageLayout: {
     nickname: string;
     profileUrl?: string;
     };
+    thinkingMessage?: string;
     suggestedRepliesVisible?: boolean;
     suggestedRepliesDirection?: "vertical" | "horizontal";
     isBotMessage?: boolean;
@@ -2723,6 +2729,7 @@ export declare const IncomingMessageLayout: {
     nickname: string;
     profileUrl?: string;
     };
+    thinkingMessage?: string;
     suggestedRepliesVisible?: boolean;
     suggestedRepliesDirection?: "vertical" | "horizontal";
     isBotMessage?: boolean;
@@ -2795,6 +2802,7 @@ export declare const IncomingMessageLayout: {
     nickname: string;
     profileUrl?: string;
     };
+    thinkingMessage?: string;
     suggestedRepliesVisible?: boolean;
     suggestedRepliesDirection?: "vertical" | "horizontal";
     isBotMessage?: boolean;
@@ -2870,7 +2878,7 @@ export declare const IncomingMessageLayout: {
     MediaMessageBody: typeof IncomingMediaBody;
     FileMessageBody: typeof IncomingFileBody;
     MultipleFilesMessageBody: ({ files, children, onClickMedia, onClickMediaFiles, }: IncomingMessageBodyProps<"multipleFiles">) => JSX.Element;
-    TypingIndicator: ({ customStyle }: IncomingMessageProps & {
+    TypingIndicator: ({ thinkingMessage, customStyle }: IncomingMessageProps & {
     customStyle?: {
     bubbleContentColor?: string;
     bubbleBackgroundColor?: string;
@@ -2893,6 +2901,7 @@ export declare const IncomingMessageLayout: {
     nickname: string;
     profileUrl?: string;
     };
+    thinkingMessage?: string;
     suggestedRepliesVisible?: boolean;
     suggestedRepliesDirection?: "vertical" | "horizontal";
     isBotMessage?: boolean;
@@ -2965,6 +2974,7 @@ export declare const IncomingMessageLayout: {
     nickname: string;
     profileUrl?: string;
     };
+    thinkingMessage?: string;
     suggestedRepliesVisible?: boolean;
     suggestedRepliesDirection?: "vertical" | "horizontal";
     isBotMessage?: boolean;
@@ -3037,6 +3047,7 @@ export declare const IncomingMessageLayout: {
     nickname: string;
     profileUrl?: string;
     };
+    thinkingMessage?: string;
     suggestedRepliesVisible?: boolean;
     suggestedRepliesDirection?: "vertical" | "horizontal";
     isBotMessage?: boolean;
@@ -3139,7 +3150,7 @@ export declare const IncomingMessageLayout: {
         component: ({ files, children, onClickMedia, onClickMediaFiles, }: IncomingMessageBodyProps<"multipleFiles">) => JSX.Element;
     }) => null;
     TypingIndicator: (props: {
-        component: ({ customStyle }: IncomingMessageProps & {
+        component: ({ thinkingMessage, customStyle }: IncomingMessageProps & {
             customStyle?: {
                 bubbleContentColor?: string;
                 bubbleBackgroundColor?: string;
@@ -3158,6 +3169,7 @@ export declare const IncomingMessageLayout: {
                 nickname: string;
                 profileUrl?: string;
             };
+            thinkingMessage?: string;
             suggestedRepliesVisible?: boolean;
             suggestedRepliesDirection?: "vertical" | "horizontal";
             isBotMessage?: boolean;
@@ -3230,6 +3242,7 @@ export declare const IncomingMessageLayout: {
                 nickname: string;
                 profileUrl?: string;
             };
+            thinkingMessage?: string;
             suggestedRepliesVisible?: boolean;
             suggestedRepliesDirection?: "vertical" | "horizontal";
             isBotMessage?: boolean;
@@ -3302,6 +3315,7 @@ export declare const IncomingMessageLayout: {
                 nickname: string;
                 profileUrl?: string;
             };
+            thinkingMessage?: string;
             suggestedRepliesVisible?: boolean;
             suggestedRepliesDirection?: "vertical" | "horizontal";
             isBotMessage?: boolean;
@@ -3418,6 +3432,7 @@ declare type InputState = {
     | 'conversation_closed'
     | 'suggested_replies'
     | 'reconnecting'
+    | 'handoff_pending'
     | (string & {});
 };