@sendbird/ai-agent-messenger-react-native 1.9.0 → 1.10.1

package/dist/index.d.ts

@@ -26,7 +26,7 @@ import { GroupChannelListOrder } from '@sendbird/chat/groupChannel';
 import { GroupChannelModule } from '@sendbird/chat/groupChannel';
 import { JSX } from 'react/jsx-runtime';
 import { LayoutChangeEvent } from 'react-native';
-import { LogLevel } from '@sendbird/chat';
+import { LogLevel as LogLevel_2 } from '@sendbird/chat';
 import { MMKV } from 'react-native-mmkv';
 import { MultipleFilesMessage } from '@sendbird/chat/message';
 import { MultipleFilesMessageCreateParams } from '@sendbird/chat/message';
@@ -420,6 +420,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;
@@ -447,6 +450,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;
 
@@ -543,7 +549,7 @@ userSessionInfo: ManualSessionInfo | AnonymousSessionInfo;
 * @public
 * @description logLevel for the ai agent client.
 * */
-logLevel?: LogLevel;
+logLevel?: LogLevel_2;
 /**
 * @public
 * @description Language for the ai agent client. Should follow the IETF BCP 47 format.
@@ -1692,6 +1698,9 @@ declare interface ConversationScrollContextValue {
         onLayout?: (event: LayoutChangeEvent) => void;
         onContentSizeChange?: (width: number, height: number) => void;
         onScroll?: (event: NativeSyntheticEvent<NativeScrollEvent>) => void;
+        onScrollBeginDrag?: () => void;
+        onScrollEndDrag?: () => void;
+        onMomentumScrollEnd?: () => void;
     };
     actions: {
         /**
@@ -1729,6 +1738,12 @@ declare interface ConversationScrollContextValue {
          * - When reopened or in auto mode: No change
          */
         onConversationClosed: (isClosed: boolean) => void;
+        /**
+         * Notify when typing indicator state changes
+         * - Auto mode: Scrolls to bottom when typing starts and user is near bottom
+         * - Fixed mode: No operation
+         */
+        onTypingIndicatorUpdate: (isTyping: boolean) => void;
     };
 }
 
@@ -1743,6 +1758,12 @@ declare type CSATSubmitParams = {
     resolutionScore?: number;
 };
 
+export declare enum CSATType {
+    AI_AGENT_CSAT_5 = 'AI_AGENT_CSAT_5',
+    AI_AGENT_CSAT_5_WITH_CRE = 'AI_AGENT_CSAT_5_WITH_CRE',
+    HELPDESK_CSAT_5 = 'HELPDESK_CSAT_5',
+}
+
 export declare interface CustomMessageTemplateData {
     id: string;
     response: {
@@ -2092,6 +2113,7 @@ BaseMessageProps<{
         nickname: string;
         profileUrl?: string;
     };
+    thinkingMessage?: string;
 
     // flags
     suggestedRepliesVisible?: boolean;
@@ -2144,7 +2166,7 @@ export declare const IncomingMessageLayout: {
                 containerStyle?: ViewStyle;
             }) => JSX.Element | null;
             MessageBody: (props: IncomingMessageBodyProps) => JSX.Element;
-            TypingIndicator: ({ customStyle, containerStyle }: IncomingMessageProps & {
+            TypingIndicator: ({ thinkingMessage, customStyle, containerStyle }: IncomingMessageProps & {
                 containerStyle?: ViewStyle;
                 customStyle?: {
                     bubbleContentColor?: string;
@@ -2168,6 +2190,7 @@ export declare const IncomingMessageLayout: {
                     nickname: string;
                     profileUrl?: string;
                 };
+                thinkingMessage?: string;
                 suggestedRepliesVisible?: boolean;
                 suggestedRepliesDirection?: "vertical" | "horizontal";
                 isBotMessage?: boolean;
@@ -2240,6 +2263,7 @@ export declare const IncomingMessageLayout: {
                     nickname: string;
                     profileUrl?: string;
                 };
+                thinkingMessage?: string;
                 suggestedRepliesVisible?: boolean;
                 suggestedRepliesDirection?: "vertical" | "horizontal";
                 isBotMessage?: boolean;
@@ -2312,6 +2336,7 @@ export declare const IncomingMessageLayout: {
                     nickname: string;
                     profileUrl?: string;
                 };
+                thinkingMessage?: string;
                 suggestedRepliesVisible?: boolean;
                 suggestedRepliesDirection?: "vertical" | "horizontal";
                 isBotMessage?: boolean;
@@ -2393,7 +2418,7 @@ export declare const IncomingMessageLayout: {
     containerStyle?: ViewStyle;
     }) => JSX.Element | null;
     MessageBody: (props: IncomingMessageBodyProps) => JSX.Element;
-    TypingIndicator: ({ customStyle, containerStyle }: IncomingMessageProps & {
+    TypingIndicator: ({ thinkingMessage, customStyle, containerStyle }: IncomingMessageProps & {
     containerStyle?: ViewStyle;
     customStyle?: {
     bubbleContentColor?: string;
@@ -2417,6 +2442,7 @@ export declare const IncomingMessageLayout: {
     nickname: string;
     profileUrl?: string;
     };
+    thinkingMessage?: string;
     suggestedRepliesVisible?: boolean;
     suggestedRepliesDirection?: "vertical" | "horizontal";
     isBotMessage?: boolean;
@@ -2489,6 +2515,7 @@ export declare const IncomingMessageLayout: {
     nickname: string;
     profileUrl?: string;
     };
+    thinkingMessage?: string;
     suggestedRepliesVisible?: boolean;
     suggestedRepliesDirection?: "vertical" | "horizontal";
     isBotMessage?: boolean;
@@ -2561,6 +2588,7 @@ export declare const IncomingMessageLayout: {
     nickname: string;
     profileUrl?: string;
     };
+    thinkingMessage?: string;
     suggestedRepliesVisible?: boolean;
     suggestedRepliesDirection?: "vertical" | "horizontal";
     isBotMessage?: boolean;
@@ -2637,7 +2665,7 @@ export declare const IncomingMessageLayout: {
     containerStyle?: ViewStyle;
     }) => JSX.Element | null;
     MessageBody: (props: IncomingMessageBodyProps) => JSX.Element;
-    TypingIndicator: ({ customStyle, containerStyle }: IncomingMessageProps & {
+    TypingIndicator: ({ thinkingMessage, customStyle, containerStyle }: IncomingMessageProps & {
     containerStyle?: ViewStyle;
     customStyle?: {
     bubbleContentColor?: string;
@@ -2661,6 +2689,7 @@ export declare const IncomingMessageLayout: {
     nickname: string;
     profileUrl?: string;
     };
+    thinkingMessage?: string;
     suggestedRepliesVisible?: boolean;
     suggestedRepliesDirection?: "vertical" | "horizontal";
     isBotMessage?: boolean;
@@ -2733,6 +2762,7 @@ export declare const IncomingMessageLayout: {
     nickname: string;
     profileUrl?: string;
     };
+    thinkingMessage?: string;
     suggestedRepliesVisible?: boolean;
     suggestedRepliesDirection?: "vertical" | "horizontal";
     isBotMessage?: boolean;
@@ -2805,6 +2835,7 @@ export declare const IncomingMessageLayout: {
     nickname: string;
     profileUrl?: string;
     };
+    thinkingMessage?: string;
     suggestedRepliesVisible?: boolean;
     suggestedRepliesDirection?: "vertical" | "horizontal";
     isBotMessage?: boolean;
@@ -2890,7 +2921,7 @@ export declare const IncomingMessageLayout: {
         component: (props: IncomingMessageBodyProps) => JSX.Element;
     }) => null;
     TypingIndicator: (props: {
-        component: ({ customStyle, containerStyle }: IncomingMessageProps & {
+        component: ({ thinkingMessage, customStyle, containerStyle }: IncomingMessageProps & {
             containerStyle?: ViewStyle;
             customStyle?: {
                 bubbleContentColor?: string;
@@ -2920,6 +2951,7 @@ export declare const IncomingMessageLayout: {
                 nickname: string;
                 profileUrl?: string;
             };
+            thinkingMessage?: string;
             suggestedRepliesVisible?: boolean;
             suggestedRepliesDirection?: "vertical" | "horizontal";
             isBotMessage?: boolean;
@@ -2992,6 +3024,7 @@ export declare const IncomingMessageLayout: {
                 nickname: string;
                 profileUrl?: string;
             };
+            thinkingMessage?: string;
             suggestedRepliesVisible?: boolean;
             suggestedRepliesDirection?: "vertical" | "horizontal";
             isBotMessage?: boolean;
@@ -3064,6 +3097,7 @@ export declare const IncomingMessageLayout: {
                 nickname: string;
                 profileUrl?: string;
             };
+            thinkingMessage?: string;
             suggestedRepliesVisible?: boolean;
             suggestedRepliesDirection?: "vertical" | "horizontal";
             isBotMessage?: boolean;
@@ -3179,6 +3213,7 @@ declare type InputState = {
     | 'conversation_closed'
     | 'suggested_replies'
     | 'reconnecting'
+    | 'handoff_pending'
     | (string & {});
 };
 
@@ -3211,6 +3246,15 @@ declare interface Loggable {
     error(...args: any[]): void;
 }
 
+export declare enum LogLevel {
+    VERBOSE,
+    DEBUG,
+    INFO,
+    WARN,
+    ERROR,
+    NONE,
+}
+
 declare type MaintainVisibleContentPosition = FlatListProps<any>['maintainVisibleContentPosition'];
 
 export declare class ManualSessionInfo {
@@ -3852,6 +3896,8 @@ declare interface TypographyVariant {
     lineHeight?: number | string;
 }
 
+export declare const useAIAgentContext = ctx.useContext;
+
 export declare const useConversationContext: {
     (): ConversationContextValue;
     displayName: string;