@sendbird/ai-agent-messenger-react 1.24.0 → 1.26.0

package/dist/index.d.ts

@@ -1,43 +1,43 @@
 import { Action } from '@sendbird/uikit-message-template';
-import { AIAgentChannelFilter } from '@sendbird/chat/aiAgent';
-import { AIAgentGroupChannelListQuery } from '@sendbird/chat/aiAgent';
-import { AIAgentModule } from '@sendbird/chat/aiAgent';
-import { BaseChannel } from '@sendbird/chat';
-import { BaseMessage } from '@sendbird/chat/message';
+import type { AIAgentChannelFilter } from '@sendbird/chat/aiAgent';
+import type { AIAgentGroupChannelListQuery } from '@sendbird/chat/aiAgent';
+import type { AIAgentModule } from '@sendbird/chat/aiAgent';
+import type { BaseChannel } from '@sendbird/chat';
+import type { BaseMessage } from '@sendbird/chat/message';
 import type { CollectionEventSource } from '@sendbird/chat';
 import { ComponentType } from 'react';
-import { ConnectionHandler } from '@sendbird/chat';
+import type { ConnectionHandler } from '@sendbird/chat';
 import { Context } from 'react';
-import { Conversation as Conversation_2 } from '@sendbird/chat/aiAgent';
-import { ConversationStatus } from '@sendbird/chat/aiAgent';
+import type { Conversation as Conversation_2 } from '@sendbird/chat/aiAgent';
+import type { ConversationStatus } from '@sendbird/chat/aiAgent';
 import { CSSProperties } from 'react';
-import { DeskChannelFilter } from '@sendbird/chat/aiAgent';
-import { FileMessage } from '@sendbird/chat/message';
-import { FileMessageCreateParams } from '@sendbird/chat/message';
+import type { DeskChannelFilter } from '@sendbird/chat/aiAgent';
+import type { FileMessage } from '@sendbird/chat/message';
+import type { FileMessageCreateParams } from '@sendbird/chat/message';
 import { format } from 'date-fns';
 import { ForwardRefExoticComponent } from 'react';
-import { GroupChannel } from '@sendbird/chat/groupChannel';
-import { GroupChannelChangelogs } from '@sendbird/chat/aiAgent';
-import { GroupChannelHandler } from '@sendbird/chat/groupChannel';
-import { GroupChannelListOrder } from '@sendbird/chat/groupChannel';
-import { GroupChannelModule } from '@sendbird/chat/groupChannel';
+import type { GroupChannel } from '@sendbird/chat/groupChannel';
+import type { GroupChannelChangelogs } from '@sendbird/chat/aiAgent';
+import type { GroupChannelHandler } from '@sendbird/chat/groupChannel';
+import type { GroupChannelListOrder } from '@sendbird/chat/groupChannel';
+import type { GroupChannelModule } from '@sendbird/chat/groupChannel';
 import { JSX } from 'react/jsx-runtime';
 import type { Locale } from 'date-fns';
-import { LogLevel as LogLevel_2 } from '@sendbird/chat';
-import { MultipleFilesMessage } from '@sendbird/chat/message';
-import { MultipleFilesMessageCreateParams } from '@sendbird/chat/message';
+import type { LogLevel as LogLevel_2 } from '@sendbird/chat';
+import type { MultipleFilesMessage } from '@sendbird/chat/message';
+import type { MultipleFilesMessageCreateParams } from '@sendbird/chat/message';
 import { PropsWithChildren } from 'react';
 import { ReactNode } from 'react';
 import { RefAttributes } from 'react';
 import { RefObject } from 'react';
-import { SendbirdChatParams } from '@sendbird/chat';
-import { SendbirdChatWith } from '@sendbird/chat';
-import { SendbirdError } from '@sendbird/chat';
-import { SessionHandler } from '@sendbird/chat';
+import type { SendbirdChatParams } from '@sendbird/chat';
+import type { SendbirdChatWith } from '@sendbird/chat';
+import type { SendbirdError } from '@sendbird/chat';
+import type { SessionHandler } from '@sendbird/chat';
 import { UIEvent as UIEvent_2 } from 'react';
-import { User } from '@sendbird/chat';
-import { UserMessage } from '@sendbird/chat/message';
-import { UserMessageCreateParams } from '@sendbird/chat/message';
+import type { User } from '@sendbird/chat';
+import type { UserMessage } from '@sendbird/chat/message';
+import type { UserMessageCreateParams } from '@sendbird/chat/message';
 
 export declare interface ActionbookInfo {
     key: string;
@@ -58,19 +58,18 @@ declare interface ActiveChannel {
      * @description Conversation status of the active channel.
      * If the conversation is not started, this will be undefined.
      * */
-    conversationStatus?: ConversationStatus;
+    conversationStatus?: ChatSDKConversationStatus;
 }
 
 declare interface ActiveChannelUpdatedParams {
     channelUrl: string;
     status: ActiveChannel['status'];
-    conversationStatus?: ConversationStatus;
+    conversationStatus?: ChatSDKConversationStatus;
 }
 
-export declare interface AgentClientHandlers {
+export declare interface AgentClientHandlers extends AIAgentClientHandlers {
     onMessageSend?: (message: string) => void;
     onFunctionCallDetailClick?: (func: FunctionCallsInfo) => void;
-    onCustomEvent?: (event: CustomEvent_2) => void;
     onInitializeFailed?: (error: Error) => void;
 }
 
@@ -151,12 +150,12 @@ customWebSocketHost?: string;
 * @public
 * @description Inject a custom Chat SDK. GroupChannelModule and AIAgentModule must be included in the initialization.
 * */
-customChatSDK?: SendbirdChatWith<[GroupChannelModule, AIAgentModule]>;
+customChatSDK?: AIAgentChatSDK;
 /**
 * @public
 * @description Custom parameters for initializing the chat SDK.
 * */
-chatParams?: Partial<SendbirdChatParams<[GroupChannelModule, AIAgentModule]>>;
+chatParams?: Partial<AIAgentChatSDKParams>;
 /**
 * @public
 * @description Custom state management for the ai agent client.
@@ -212,7 +211,7 @@ dir?: "ltr" | "rtl";
 * @public
 * @description logLevel for the ai agent client.
 * */
-logLevel?: LogLevel_2;
+logLevel?: ChatSDKLogLevel;
 /**
 * @public
 * @description Language for the ai agent client. Should follow the IETF BCP 47 format.
@@ -290,7 +289,7 @@ __internalVariables?: InternalMessageTemplateVariables;
 children?: ReactNode | undefined;
 } & RefAttributes<MessengerSessionRef>>;
 
-export declare function AgentUIProviderContainer({ appearance, rootElement, logger, language, languageCode, stringSet, children, messageTemplate, icons, theme, }: Props): JSX.Element;
+export declare function AgentUIProviderContainer({ appearance, rootElement, logger, language, languageCode, stringSet, children, messageTemplate, icons, theme, entryElement, modalRootElement, }: Props): JSX.Element;
 
 declare abstract class AIAgentBaseStats {
     protected timers: Map<string, TimerData> = new Map();
@@ -385,6 +384,16 @@ declare interface AIAgentCache {
     messenger: MessengerSessionCache;
 }
 
+declare type AIAgentChatSDK = ChatSDKSendbirdChatWith<[ChatSDKGroupChannelModule, ChatSDKAIAgentModule]>;
+
+declare type AIAgentChatSDK_2 = ChatSDKSendbirdChatWith<[ChatSDKGroupChannelModule, ChatSDKAIAgentModule]>;
+
+declare type AIAgentChatSDKParams = ChatSDKSendbirdChatParams<[ChatSDKGroupChannelModule, ChatSDKAIAgentModule]>;
+
+declare interface AIAgentClientHandlers {
+    onCustomEvent?: (event: CustomEvent_2) => void;
+}
+
 declare type AIAgentCommonIconName =
 | 'close'
 | 'send'
@@ -413,7 +422,9 @@ declare type AIAgentCommonIconName =
 | 'delight'
 | 'photo'
 | 'add'
-| 'document';
+| 'document'
+| 'download'
+| 'memory';
 
 export declare interface AIAgentConfig {
     conversation?: {
@@ -470,7 +481,7 @@ export declare interface AIAgentConfig {
          * */
         messageAlertSoundEnabled?: boolean;
         /**
-         * (React only) File viewer configuration.
+         * File viewer configuration.
          * */
         fileViewer?: {
             /**
@@ -488,7 +499,7 @@ declare interface AIAgentContextValue {
 
     /** @internal Do not use directly. This is an internal SDK instance. */
     _aiAgentSDK: AIAgentInterface;
-    chatSDK: SendbirdChatWith<[GroupChannelModule, AIAgentModule]>;
+    chatSDK: AIAgentChatSDK_2;
     deskClient: DeskClientInterface;
 
     language: string;
@@ -503,32 +514,38 @@ declare interface AIAgentContextValue {
 
     queryParams?: AIAgentQueryParams;
     config?: AIAgentConfig;
+
+    handlers?: AIAgentClientHandlers;
 }
 
 declare interface AIAgentConversationContextValue {
-    conversation: Conversation_2 | undefined;
+    conversation: ChatSDKConversation | undefined;
+
+    actions: {
+        setUserMemoryState: (params: { enabled: boolean }) => Promise<MemoryInfo>;
+    };
 
     channelSource: {
-        channel: GroupChannel | undefined;
-        error: SendbirdError | undefined;
+        channel: ChatSDKGroupChannel | undefined;
+        error: ChatSDKSendbirdError | undefined;
         refetch: () => Promise<void>;
         closeConversation: () => Promise<void>;
     };
 
     messageSource: {
-        messages: BaseMessage[];
-        newMessages: BaseMessage[];
+        messages: ChatSDKBaseMessage[];
+        newMessages: ChatSDKBaseMessage[];
         initialized: boolean;
         subscribeMessageEvents: (listener: (event: ConversationMessageEvent) => void) => () => void;
         loadPrevious: () => Promise<void>;
         loadNext: () => Promise<void>;
-        sendUserMessage: (params: UserMessageCreateParams) => Promise<UserMessage>;
-        sendFileMessage: (params: FileMessageCreateParams) => Promise<FileMessage>;
-        sendMultipleFilesMessage: (params: MultipleFilesMessageCreateParams) => Promise<MultipleFilesMessage>;
-        deleteMessage: (message: UserMessage | FileMessage | MultipleFilesMessage) => Promise<void>;
+        sendUserMessage: (params: ChatSDKUserMessageCreateParams) => Promise<ChatSDKUserMessage>;
+        sendFileMessage: (params: ChatSDKFileMessageCreateParams) => Promise<ChatSDKFileMessage>;
+        sendMultipleFilesMessage: (params: ChatSDKMultipleFilesMessageCreateParams) => Promise<ChatSDKMultipleFilesMessage>;
+        deleteMessage: (message: ChatSDKUserMessage | ChatSDKFileMessage | ChatSDKMultipleFilesMessage) => Promise<void>;
         resendMessage: (
-        message: UserMessage | FileMessage | MultipleFilesMessage,
-        ) => Promise<UserMessage | FileMessage | MultipleFilesMessage>;
+        message: ChatSDKUserMessage | ChatSDKFileMessage | ChatSDKMultipleFilesMessage,
+        ) => Promise<ChatSDKUserMessage | ChatSDKFileMessage | ChatSDKMultipleFilesMessage>;
         resetNewMessages: () => void;
     };
 
@@ -545,8 +562,8 @@ declare interface AIAgentConversationContextValue {
 declare interface AIAgentConversationListContextValue {
     listSource: {
         initialized: boolean;
-        error: SendbirdError | undefined;
-        channels: GroupChannel[];
+        error: ChatSDKSendbirdError | undefined;
+        channels: ChatSDKGroupChannel[];
         loadMore: () => Promise<void>;
     };
 }
@@ -556,12 +573,12 @@ declare interface AIAgentGroupChannelFilter {
      * The filter applied to AI agent channels.
      * It determines whether to include or exclude AI agent channels in the query results.
      */
-    aiAgentChannelFilter?: AIAgentChannelFilter;
+    aiAgentChannelFilter?: ChatSDKAIAgentChannelFilter;
     /**
      * The filter applied to AI agent conversation statuses.
      * It allows filtering channels based on the status of their conversations.
      */
-    aiAgentConversationStatusFilter?: ConversationStatus[];
+    aiAgentConversationStatusFilter?: ChatSDKConversationStatus[];
     /**
      * The list of AI agent IDs to filter the channels.
      * Only channels associated with these AI agents will be included in the results.
@@ -571,7 +588,7 @@ declare interface AIAgentGroupChannelFilter {
      * The filter applied to Desk channels.
      * It determines whether to include or exclude Desk channels in the query results.
      */
-    deskChannelFilter?: DeskChannelFilter;
+    deskChannelFilter?: ChatSDKDeskChannelFilter;
     /**
      * The list of pinned channel URLs.
      * These channels are prioritized in the query results.
@@ -680,12 +697,17 @@ 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>;
+    /** Clears memories saved for the current user */
+    clearUserMemories: (params?: ClearUserMemoriesParams) => Promise<void>;
 
     /** @internal Refreshes the active channel by re-requesting messenger settings */
     refreshActiveChannel: (options?: { useKnownActiveChannelUrl?: boolean }) => Promise<string>;
 
+    /** @internal Sets whether the current user uses memory */
+    setUserMemoryState: (params: SetUserMemoryStateParams) => Promise<MemoryInfo>;
+
     /** @internal Initializes a conversation on the channel if needed (AI Agent channel without conversation). */
-    initConversationIfNeeded: (channel: GroupChannel) => Promise<void>;
+    initConversationIfNeeded: (channel: ChatSDKGroupChannel) => Promise<void>;
 
     /** Disposes all resources held by this instance (WebSocket, desk auth, event handlers). */
     dispose: () => void;
@@ -711,10 +733,11 @@ declare interface AIAgentLanguageSet {
 declare interface AIAgentMessengerSessionContextValue {
     userSessionInfo?: UserSessionInfo | ManualSessionInfo | AnonymousSessionInfo;
 
-    sdkUser: null | User;
+    sdkUser: null | ChatSDKUser;
     userSession: null | UserSession;
     aiAgentInfo: null | AIAgentInfo;
     launcherInfo: null | LauncherInfo;
+    memoryInfo: null | MemoryInfo;
 
     connectionError?: Error;
 
@@ -728,7 +751,7 @@ declare interface AIAgentMessengerSessionContextValue {
     authenticate: () => Promise<MessengerSettingsResponse>;
     deauthenticate: () => Promise<void>;
 
-    createAttachmentRules: (params: { channel?: GroupChannel; uploadSizeLimit?: number }) => AttachmentRules;
+    createAttachmentRules: (params: { channel?: ChatSDKGroupChannel; uploadSizeLimit?: number }) => AttachmentRules;
     /**
      * @internal
      */
@@ -774,12 +797,12 @@ export declare type AIAgentProps = PropsWithChildren<{
      * @public
      * @description Inject a custom Chat SDK. GroupChannelModule and AIAgentModule must be included in the initialization.
      * */
-    customChatSDK?: SendbirdChatWith<[GroupChannelModule, AIAgentModule]>;
+    customChatSDK?: AIAgentChatSDK;
     /**
      * @public
      * @description Custom parameters for initializing the chat SDK.
      * */
-    chatParams?: Partial<SendbirdChatParams<[GroupChannelModule, AIAgentModule]>>;
+    chatParams?: Partial<AIAgentChatSDKParams>;
     /**
      * @public
      * @description Custom state management for the ai agent client.
@@ -837,7 +860,7 @@ export declare type AIAgentProps = PropsWithChildren<{
      * @public
      * @description logLevel for the ai agent client.
      * */
-    logLevel?: LogLevel_2;
+    logLevel?: ChatSDKLogLevel;
     /**
      * @public
      * @description Language for the ai agent client. Should follow the IETF BCP 47 format.
@@ -921,7 +944,7 @@ export declare interface AIAgentQueryParams {
  * @description Represents an authenticated session state. Created after successful authentication.
  */
 declare class AIAgentSession {
-    private readonly _sdkUser: User;
+    private readonly _sdkUser: ChatSDKUser;
     private readonly _userSession: UserSession;
     private readonly _dispatcher: Dispatcher;
     private _activeChannel: ActiveChannel;
@@ -936,7 +959,7 @@ declare class AIAgentSession {
     /**
      * The authenticated Sendbird user.
      */
-    get sdkUser(): User {
+    get sdkUser(): ChatSDKUser {
         return this._sdkUser;
     }
 
@@ -982,12 +1005,12 @@ declare class AIAgentSession {
 /**
  * AI Agent session handler.
  * */
-declare interface AIAgentSessionHandler extends SessionHandler {
+declare interface AIAgentSessionHandler extends ChatSDKSessionHandler {
     onExternalAuthTokenExpired?: (data: ExternalAuthTokenExpiredData) => void;
 }
 
 declare interface AIAgentSessionParams {
-    sdkUser: User;
+    sdkUser: ChatSDKUser;
     userSession: UserSession;
     activeChannel: ActiveChannel;
     dispatcher: Dispatcher;
@@ -1020,7 +1043,7 @@ declare interface AIAgentStringSet {
         powered_by: string;
         citation_title: string;
         start_new_conversation_label: string;
-        scroll_to_new_messages_label: (messages: BaseMessage[]) => string;
+        scroll_to_new_messages_label: (messages: ChatSDKBaseMessage[]) => string;
 
         failed_message_resend: string;
         failed_message_remove: string;
@@ -1060,6 +1083,10 @@ declare interface AIAgentStringSet {
         a11y_file_image: (name: string) => string;
         a11y_file_video: (name: string) => string;
         a11y_file_document: (name: string) => string;
+        a11y_received_file_image: string;
+        a11y_received_file_video: string;
+        a11y_received_file_pdf: (name: string) => string;
+        a11y_received_files_image_count: (count: number) => string;
         a11y_screen_conversation: string;
         a11y_screen_conversation_with_agent: (name: string) => string;
         a11y_screen_conversation_list_no_count: string;
@@ -1080,6 +1107,14 @@ declare interface AIAgentStringSet {
         a11y_hint_open_file: string;
         a11y_hint_open_image: string;
         a11y_hint_send_reply: string;
+
+        image_viewer_default_title: string;
+        a11y_image_viewer_close: string;
+        a11y_image_viewer_previous: string;
+        a11y_image_viewer_next: string;
+        a11y_image_viewer_download: string;
+
+        attachment_document: string;
     };
 
     conversation_list: {
@@ -1110,7 +1145,7 @@ declare interface AIAgentStringSet {
         question: string;
         submit_label: string;
         submission_expired: string;
-        a11y_rating_label: (score: number, label: string) => string;
+        a11y_csat_rating_label: (score: number, label: string) => string;
         a11y_hint_select_rating: string;
     };
 
@@ -1147,6 +1182,29 @@ declare interface AIAgentStringSet {
         confirm_cancel: string;
         confirm_handoff: string;
     };
+
+    memory: {
+        dialog_title: string;
+        desc_on: string;
+        desc_off: string;
+        button_use: string;
+        button_dont_use: string;
+        button_keep_using: string;
+        button_disable: string;
+        button_disable_and_delete: string;
+        button_keep_off: string;
+        button_enable: string;
+        button_cancel: string;
+        error_message: string;
+        a11y_indicator_manage: string;
+        a11y_indicator_on: string;
+        a11y_indicator_off: string;
+    };
+
+    connection_delay: {
+        title: string;
+        description: (formattedTime: string) => string;
+    };
 }
 
 declare type AnonUserSessionData = { userId: string; authToken: string; expireAt: number };
@@ -1204,7 +1262,71 @@ declare type BaseMessageProps<T> = T & {
     children?: ReactNode;
 };
 
-declare type ChatSDKType = SendbirdChatWith<[GroupChannelModule, AIAgentModule]>;
+/**
+ * Settings shape persisted in the cache layer. The server always returns `memory`,
+ * but caches written before the field was introduced may not have it.
+ */
+declare type CachedMessengerSettings = Omit<MessengerSettingsResponse, 'memory'> & {
+    memory?: MessengerSettingsResponse['memory'];
+};
+
+declare type ChatSDKAIAgentChannelFilter = AIAgentChannelFilter;
+
+declare type ChatSDKAIAgentGroupChannelListQuery = AIAgentGroupChannelListQuery;
+
+declare type ChatSDKAIAgentModule = AIAgentModule;
+
+declare type ChatSDKBaseChannel = BaseChannel;
+
+declare type ChatSDKBaseMessage = BaseMessage;
+
+declare type ChatSDKCollectionEventSource = CollectionEventSource;
+
+declare type ChatSDKConnectionHandler = ConnectionHandler;
+
+declare type ChatSDKConversation = Conversation_2;
+
+declare type ChatSDKConversationStatus = ConversationStatus;
+
+declare type ChatSDKDeskChannelFilter = DeskChannelFilter;
+
+declare type ChatSDKFileMessage = FileMessage;
+
+declare type ChatSDKFileMessageCreateParams = FileMessageCreateParams;
+
+declare type ChatSDKGroupChannel = GroupChannel;
+
+declare type ChatSDKGroupChannelChangelogs = GroupChannelChangelogs;
+
+declare type ChatSDKGroupChannelHandler = GroupChannelHandler;
+
+declare type ChatSDKGroupChannelListOrder = GroupChannelListOrder;
+
+declare type ChatSDKGroupChannelModule = GroupChannelModule;
+
+declare type ChatSDKLogLevel = LogLevel_2;
+
+declare type ChatSDKModule = ChatSDKGroupChannelModule | ChatSDKAIAgentModule;
+
+declare type ChatSDKMultipleFilesMessage = MultipleFilesMessage;
+
+declare type ChatSDKMultipleFilesMessageCreateParams = MultipleFilesMessageCreateParams;
+
+declare type ChatSDKSendbirdChatParams<Modules extends ChatSDKModule[]> = SendbirdChatParams<Modules>;
+
+declare type ChatSDKSendbirdChatWith<Modules extends ChatSDKModule[]> = SendbirdChatWith<Modules>;
+
+declare type ChatSDKSendbirdError = SendbirdError;
+
+declare type ChatSDKSessionHandler = SessionHandler;
+
+declare type ChatSDKType = ChatSDKSendbirdChatWith<[ChatSDKGroupChannelModule, ChatSDKAIAgentModule]>;
+
+declare type ChatSDKUser = User;
+
+declare type ChatSDKUserMessage = UserMessage;
+
+declare type ChatSDKUserMessageCreateParams = UserMessageCreateParams;
 
 export declare interface CitationInfo {
     embedding_id: number;
@@ -1214,6 +1336,10 @@ export declare interface CitationInfo {
     link: string;
 }
 
+declare interface ClearUserMemoriesParams {
+    contextAiAgentId?: string;
+}
+
 declare interface CloseConversationCommandParams {
     channelUrl: string;
 }
@@ -1246,6 +1372,17 @@ declare interface ColorSet {
     csat: {
         background: string;
     };
+    memoryDialog: {
+        titleText: string;
+        markdownBodyText: string;
+        markdownLinkText: string;
+        positiveBackground: string;
+        positiveText: string;
+        positiveBorderColor: string;
+        negativeBackground: string;
+        negativeText: string;
+        negativeBorderColor: string;
+    };
 }
 
 /**
@@ -1291,6 +1428,36 @@ declare enum CommandType {
     AuthTokenRefreshed = 'auth.token.refreshed',
 }
 
+export declare interface ConnectionDelayDialogProps {
+    title: string;
+    description: string;
+    highlightedText?: string;
+}
+
+export declare const ConnectionDelayLayout: {
+    (props: PropsWithChildren): ReactNode;
+    defaults: {
+        template: ComponentType<unknown>;
+        components: {
+            Dialog: ({ title, description, highlightedText }: ConnectionDelayDialogProps) => ReactNode;
+        };
+    };
+    Template: ({ template, children }: {
+        template?: ComponentType<unknown> | undefined;
+        children?: ReactNode;
+    }) => JSX.Element;
+    Context: Context<LayoutContextValue<unknown, {
+    Dialog: ({ title, description, highlightedText }: ConnectionDelayDialogProps) => ReactNode;
+    }>>;
+    useContext: () => LayoutContextValue<unknown, {
+    Dialog: ({ title, description, highlightedText }: ConnectionDelayDialogProps) => ReactNode;
+    }>;
+} & {
+    Dialog: (props: {
+        component: ({ title, description, highlightedText }: ConnectionDelayDialogProps) => ReactNode;
+    }) => null;
+};
+
 declare interface ContextObject {
     language?: string;
     country?: string;
@@ -1333,6 +1500,7 @@ export declare const ConversationHeaderLayout: {
             EndArea: () => ReactNode;
             MenuButton: () => ReactNode;
             Title: () => ReactNode;
+            MemoryIndicator: () => ReactNode;
             HandoffButton: () => ReactNode;
             ConversationCloseButton: () => ReactNode;
             ExpandButton: () => ReactNode;
@@ -1349,6 +1517,7 @@ export declare const ConversationHeaderLayout: {
     EndArea: () => ReactNode;
     MenuButton: () => ReactNode;
     Title: () => ReactNode;
+    MemoryIndicator: () => ReactNode;
     HandoffButton: () => ReactNode;
     ConversationCloseButton: () => ReactNode;
     ExpandButton: () => ReactNode;
@@ -1360,6 +1529,7 @@ export declare const ConversationHeaderLayout: {
     EndArea: () => ReactNode;
     MenuButton: () => ReactNode;
     Title: () => ReactNode;
+    MemoryIndicator: () => ReactNode;
     HandoffButton: () => ReactNode;
     ConversationCloseButton: () => ReactNode;
     ExpandButton: () => ReactNode;
@@ -1381,6 +1551,9 @@ export declare const ConversationHeaderLayout: {
     Title: (props: {
         component: () => ReactNode;
     }) => null;
+    MemoryIndicator: (props: {
+        component: () => ReactNode;
+    }) => null;
     HandoffButton: (props: {
         component: () => ReactNode;
     }) => null;
@@ -1594,24 +1767,24 @@ declare class ConversationListCollection {
     readonly filter?: AIAgentGroupChannelFilter;
 
     private _sdk: ChatSDKType;
-    private _pinnedChannels: GroupChannel[];
-    private _channels: GroupChannel[];
+    private _pinnedChannels: ChatSDKGroupChannel[];
+    private _channels: ChatSDKGroupChannel[];
 
     private _isDisposed = false;
     private _handlerId = `handler-id-${Date.now()}`;
-    private _order: GroupChannelListOrder = GroupChannelListOrder.LATEST_LAST_MESSAGE;
+    private _order: ChatSDKGroupChannelListOrder = GroupChannelListOrder.LATEST_LAST_MESSAGE;
 
     private _limit: number;
-    private _query: AIAgentGroupChannelListQuery;
+    private _query: ChatSDKAIAgentGroupChannelListQuery;
 
     private _token: string;
     private _timestamp: number;
     private _isSyncing: boolean;
 
-    private _channelHandler: GroupChannelHandler;
-    private _connectionHandler: ConnectionHandler;
+    private _channelHandler: ChatSDKGroupChannelHandler;
+    private _connectionHandler: ChatSDKConnectionHandler;
     private _collectionEventHandler?: ConversationListCollectionEventHandler;
-    private _throttledOnChannelChanged: ThrottledFunction<(channel: BaseChannel) => void>;
+    private _throttledOnChannelChanged: ThrottledFunction<(channel: ChatSDKBaseChannel) => void>;
 
     /**
      * Creates a new ConversationListCollection instance.
@@ -1642,7 +1815,7 @@ declare class ConversationListCollection {
         this._isSyncing = false;
 
         this._throttledOnChannelChanged = throttle(
-        (channel: GroupChannel) => {
+        (channel: ChatSDKGroupChannel) => {
             if (this._query.belongsTo(channel)) {
                 this._addChannelsToView([channel], false);
             } else {
@@ -1684,7 +1857,7 @@ declare class ConversationListCollection {
      * Sets the default changelog sync timestamp based on the first non-pinned channel.
      * @param channels - Array of channels to analyze
      */
-    private _setDefaultChangelogsSyncTimestamp(channels: GroupChannel[]) {
+    private _setDefaultChangelogsSyncTimestamp(channels: ChatSDKGroupChannel[]) {
         const pinnedUrlsSet = new Set(this.filter?.pinnedChannelUrls ?? []);
         const firstChannel = channels.find((it) => {
             return !pinnedUrlsSet.has(it.url);
@@ -1706,13 +1879,13 @@ declare class ConversationListCollection {
      * Synchronizes channel changelogs to keep the collection up-to-date.
      * @returns Promise that resolves to an empty array
      */
-    private async _syncChannelChangelogs(): Promise<GroupChannel[]> {
+    private async _syncChannelChangelogs(): Promise<ChatSDKGroupChannel[]> {
         if (this._isDisposed) return [];
         if (this._isSyncing) return [];
 
         try {
             this._isSyncing = true;
-            let response: GroupChannelChangelogs;
+            let response: ChatSDKGroupChannelChangelogs;
 
             if (this._token) {
                 response = await this._sdk.aiAgent.getMyGroupChannelChangeLogsByToken(this._token, this.filter);
@@ -1743,16 +1916,16 @@ declare class ConversationListCollection {
      * @param channels - Pinned channels to upsert
      * @returns Object containing added, updated channels and unmatched URLs
      */
-    private _upsertPinnedChannelsToArray(channels: GroupChannel[]): {
-        addedChannels: GroupChannel[];
-        updatedChannels: GroupChannel[];
+    private _upsertPinnedChannelsToArray(channels: ChatSDKGroupChannel[]): {
+        addedChannels: ChatSDKGroupChannel[];
+        updatedChannels: ChatSDKGroupChannel[];
         unmatchedChannelUrls: string[];
     } {
         const pinnedUrls = this.filter?.pinnedChannelUrls ?? [];
         const pinnedIndexMap = new Map(pinnedUrls.map((url, index) => [url, index]));
 
-        const addedChannels: GroupChannel[] = [];
-        const updatedChannels: GroupChannel[] = [];
+        const addedChannels: ChatSDKGroupChannel[] = [];
+        const updatedChannels: ChatSDKGroupChannel[] = [];
         const unmatchedChannelUrls: string[] = [];
 
         for (const channel of channels) {
@@ -1793,13 +1966,13 @@ declare class ConversationListCollection {
      * @returns Object containing added, updated channels and unmatched URLs
      */
     private _upsertRegularChannelsToArray(
-    channels: GroupChannel[],
+    channels: ChatSDKGroupChannel[],
     forceAppend = false,
-    ): { addedChannels: GroupChannel[]; updatedChannels: GroupChannel[]; unmatchedChannelUrls: string[] } {
+    ): { addedChannels: ChatSDKGroupChannel[]; updatedChannels: ChatSDKGroupChannel[]; unmatchedChannelUrls: string[] } {
         const unmatchedChannelUrls: string[] = [];
 
-        const addedChannels: GroupChannel[] = [];
-        const updatedChannels: GroupChannel[] = [];
+        const addedChannels: ChatSDKGroupChannel[] = [];
+        const updatedChannels: ChatSDKGroupChannel[] = [];
 
         for (const channel of channels) {
             if (!this._query.belongsTo(channel)) {
@@ -1842,11 +2015,11 @@ declare class ConversationListCollection {
      * @param channels - Channels to add or update
      * @param forceAppend - Whether to force append channels at the end
      */
-    private _addChannelsToView(channels: GroupChannel[], forceAppend = false): void {
+    private _addChannelsToView(channels: ChatSDKGroupChannel[], forceAppend = false): void {
         const pinnedUrlsSet = new Set(this.filter?.pinnedChannelUrls ?? []);
 
-        const pinnedChannels: GroupChannel[] = [];
-        const regularChannels: GroupChannel[] = [];
+        const pinnedChannels: ChatSDKGroupChannel[] = [];
+        const regularChannels: ChatSDKGroupChannel[] = [];
 
         for (const channel of channels) {
             if (pinnedUrlsSet.has(channel.url)) {
@@ -1900,7 +2073,7 @@ declare class ConversationListCollection {
      * Pinned channels are always returned first, followed by non-pinned channels.
      * @returns Array of GroupChannel objects
      */
-    public get channels(): GroupChannel[] {
+    public get channels(): ChatSDKGroupChannel[] {
         return this._isDisposed ? [] : [...this._pinnedChannels, ...this._channels];
     }
 
@@ -1916,7 +2089,7 @@ declare class ConversationListCollection {
      * Loads the next batch of channels from the server.
      * @returns Promise that resolves to an array of newly loaded channels
      */
-    public async loadMore(): Promise<GroupChannel[]> {
+    public async loadMore(): Promise<ChatSDKGroupChannel[]> {
         if (this._isDisposed) return [];
 
         if (this.hasMore) {
@@ -1957,9 +2130,9 @@ declare class ConversationListCollection {
 
 declare interface ConversationListCollectionEventHandler {
     /** Called when there are newly added {@link GroupChannel}s. */
-    onChannelsAdded?: (context: ConversationListContext_2, channels: GroupChannel[]) => void;
+    onChannelsAdded?: (context: ConversationListContext_2, channels: ChatSDKGroupChannel[]) => void;
     /** Called when there's an update in one or more of the {@link GroupChannel}s that `GroupChannelCollection` holds. */
-    onChannelsUpdated?: (context: ConversationListContext_2, channels: GroupChannel[]) => void;
+    onChannelsUpdated?: (context: ConversationListContext_2, channels: ChatSDKGroupChannel[]) => void;
     /** Called when one or more of the {@link GroupChannel}s that `GroupChannelCollection` holds has been deleted. */
     onChannelsDeleted?: (context: ConversationListContext_2, channelUrls: string[]) => void;
 }
@@ -2057,7 +2230,7 @@ export declare const ConversationListItemLayout: {
 } & {};
 
 export declare interface ConversationListItemProps {
-    channel: GroupChannel;
+    channel: ChatSDKGroupChannel;
     channelUrl: string;
     onClick?: () => void;
     /** @deprecated **/
@@ -2107,18 +2280,18 @@ declare type ConversationMessageEvent = ConversationMessageEventPayload & { id:
 declare type ConversationMessageEventPayload =
 | {
     kind: 'messagesAdded';
-    source: CollectionEventSource;
-    messages: BaseMessage[];
+    source: ChatSDKCollectionEventSource;
+    messages: ChatSDKBaseMessage[];
 }
 | {
     kind: 'messagesUpdated';
-    source: CollectionEventSource;
-    messages: BaseMessage[];
+    source: ChatSDKCollectionEventSource;
+    messages: ChatSDKBaseMessage[];
 }
 | {
     kind: 'initialized';
     source: 'cache' | 'api';
-    messages: BaseMessage[];
+    messages: ChatSDKBaseMessage[];
 };
 
 declare interface ConversationScrollContextValue {
@@ -2189,17 +2362,20 @@ export declare enum CSATType {
     HELPDESK_CSAT_5 = 'HELPDESK_CSAT_5',
 }
 
-declare type CustomEvent_2 = {
+declare type CustomEvent_2 =
+| {
     type: 'message-sent-pending' | 'message-sent-succeeded';
     data: {
-        message: BaseMessage;
+        message: ChatSDKBaseMessage;
     };
-} | {
+}
+| {
     type: 'bot-message-received';
     data: {
-        message: BaseMessage;
+        message: ChatSDKBaseMessage;
     };
-} | {
+}
+| {
     type: 'user-action-requested';
     data: UserActionRequestedData;
 };
@@ -3576,22 +3752,13 @@ declare type IncomingMessageUnion =
 
 declare function IncomingTextBody(props: IncomingMessageBodyProps): JSX.Element | null;
 
-declare type InputMode = 'enabled' | 'readOnly' | 'disabled';
-
-declare type InputState = {
-    _mode: InputMode;
-    disabled: boolean;
-    disabledBy:
-    | 'unavailable'
-    | 'form_active'
-    | 'ai_responding'
-    | 'conversation_closed'
-    | 'suggested_replies'
-    | 'steward'
-    | 'system'
-    | 'reconnecting'
-    | 'handoff_pending'
-    | (string & {});
+declare type InputState =
+| { disabled: false; disabledBy: ''; focusPolicy: 'auto' }
+| { disabled: true; disabledBy: 'ai_responding'; focusPolicy: 'preserve' }
+| {
+    disabled: true;
+    disabledBy: ReleaseDisabledByValue;
+    focusPolicy: 'release';
 };
 
 declare type InternalExtraProps = {
@@ -3613,7 +3780,7 @@ declare interface LanguageSet extends Omit<AIAgentLanguageSet, 'strings'> {
     stringSet: StringSet;
 }
 
-export declare function LauncherBase({ className, children, isOpened, onClick, ariaLabel, 'aria-label': ariaLabelProp, 'aria-describedby': ariaDescribedBy, type, imageUrl, dir, animated, backgroundColor, size, }: LauncherProps): JSX.Element;
+export declare function LauncherBase({ className, children, isOpened, onClick, 'aria-label': ariaLabel, 'aria-describedby': ariaDescribedBy, type, imageUrl, dir, animated, backgroundColor, size, }: LauncherProps): JSX.Element;
 
 declare type LauncherImageType = 'default_icon' | 'custom_image';
 
@@ -3627,8 +3794,7 @@ declare type LauncherProps = {
     children?: ReactNode;
     isOpened: boolean;
     onClick?: () => void;
-    ariaLabel?: string;
-    'aria-label'?: string;
+    'aria-label': string;
     'aria-describedby'?: string;
     type: LauncherImageType;
     imageUrl: string;
@@ -3685,6 +3851,14 @@ declare interface ManualSessionInfoParams {
     sessionHandler: AIAgentSessionHandler;
 }
 
+declare interface MemoryInfo {
+    enabled: boolean;
+    showIndicator: boolean;
+    toggleAllowed: boolean;
+    deleteOnOff: boolean;
+    consentDialog: MessengerSettingsResponse['memory']['consent_dialog'];
+}
+
 /**
  * @description
  * - single: The message is standalone (not grouped with adjacent messages).
@@ -3829,7 +4003,7 @@ declare interface MessengerProps extends AIAgentProps {
 }
 
 declare interface MessengerSessionCache {
-    getSettings(userId: string): MessengerSettingsResponse | null;
+    getSettings(userId: string): CachedMessengerSettings | null;
     setSettings(userId: string, value: MessengerSettingsResponse): void;
     getAnonUser(): AnonUserSessionData | null;
     setAnonUser(value: AnonUserSessionData): void;
@@ -3888,6 +4062,13 @@ declare interface MessengerSettingsResponse {
         image_url: string;
         auto_open: boolean;
     };
+    memory: {
+        enabled: boolean;
+        show_indicator: boolean;
+        toggle_allowed: boolean;
+        delete_on_off: boolean;
+        consent_dialog: { body: string } | null;
+    };
     auto_created_user?: {
         user_id: string;
         session_token: string;
@@ -3904,10 +4085,9 @@ declare interface MessengerSettingsResponse {
     country: string | null;
 }
 
-declare interface MessengerSettingsUpdatedParams {
-    settings: MessengerSettingsResponse;
-    source: 'cache' | 'server';
-}
+declare type MessengerSettingsUpdatedParams =
+| { settings: MessengerSettingsResponse; source: 'server' }
+| { settings: CachedMessengerSettings; source: 'cache' };
 
 declare type MultiSelectField = {
     key: string;
@@ -3947,7 +4127,7 @@ declare type NumberField = {
 };
 
 declare type OnJoinedProactiveConversation = (params: {
-    channel: GroupChannel;
+    channel: ChatSDKGroupChannel;
 }) => void;
 
 declare type OutgoingBaseMessageProps<T> = T &
@@ -4203,6 +4383,10 @@ declare type Props = {
         }>;
         colors?: ColorSetInput;
     };
+    /** @internal */
+    entryElement?: HTMLElement;
+    /** @internal */
+    modalRootElement?: HTMLElement;
     /** @internal DO NOT USE THIS **/
     messageTemplate?: {
         /** @internal DO NOT USE THIS **/
@@ -4255,14 +4439,24 @@ declare type Props_4 = PropsWithChildren<{
     style?: CSSProperties;
 }>;
 
-declare type ReactOnlyIconName = 'expand' | 'collapse' | 'chevron-right' | 'download' | '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';
+
+declare type ReleaseDisabledByValue =
+| 'unavailable'
+| 'form_active'
+| 'conversation_closed'
+| 'suggested_replies'
+| 'steward'
+| 'system'
+| 'reconnecting'
+| 'handoff_pending';
 
 declare type SBUFoundationProps<T = NonNullable<unknown>> = T & {
     className?: string;
     children?: ReactNode;
     testId?: string;
     style?: CSSProperties;
-    ariaLabel?: string;
+    'aria-label'?: string;
 };
 
 export declare type ScrollToBottomButtonProps = SBUFoundationProps<{
@@ -4274,6 +4468,11 @@ declare interface SearchConversationParams {
     context: Record<string, string>;
 }
 
+declare interface SetUserMemoryStateParams {
+    enabled: boolean;
+    contextAiAgentId?: string;
+}
+
 declare type SingleSelectField = {
     key: string;
     type: 'single-select';
@@ -4446,6 +4645,10 @@ declare type StringSet = {
     A11Y_FILE_IMAGE: (name: string) => string;
     A11Y_FILE_VIDEO: (name: string) => string;
     A11Y_FILE_DOCUMENT: (name: string) => string;
+    A11Y_RECEIVED_FILE_IMAGE: string;
+    A11Y_RECEIVED_FILE_VIDEO: string;
+    A11Y_RECEIVED_FILE_PDF: (name: string) => string;
+    A11Y_RECEIVED_FILES_IMAGE_COUNT: (count: number) => string;
     A11Y_FILE_SELECTED?: (label: string) => string;
     A11Y_FILE_REMOVE_BUTTON: (name: string) => string;
     A11Y_SCREEN_CONVERSATION: string;
@@ -4458,7 +4661,6 @@ declare type StringSet = {
     A11Y_FILE_SIZE_EXCEEDED: (maxSizeMB: number) => string;
     A11Y_CSAT_FORM_ERROR: string;
     A11Y_CONVERSATION_ITEM: (agent: string, status: string, time: string, count: number) => string;
-    A11Y_RATING_LABEL: (score: number, label: string) => string;
     A11Y_CONNECT_AGENT: string;
     A11Y_CLOSE_MESSENGER: string;
     A11Y_EXPAND_MESSENGER: string;
@@ -4475,11 +4677,28 @@ declare type StringSet = {
     A11Y_HINT_OPEN_IMAGE: string;
     A11Y_HINT_SEND_REPLY: string;
     A11Y_HINT_SELECT_RATING: string;
-    SCROLL_TO_NEW_MESSAGES_LABEL: (messages: BaseMessage[]) => string;
+    SCROLL_TO_NEW_MESSAGES_LABEL: (messages: ChatSDKBaseMessage[]) => string;
     HANDOFF_CONFIRM__TITLE: string;
     HANDOFF_CONFIRM__DESCRIPTION: string;
     HANDOFF_CONFIRM__CANCEL: string;
     HANDOFF_CONFIRM__HANDOFF: string;
+    MEMORY__DIALOG_TITLE: string;
+    MEMORY__DESC_ON: string;
+    MEMORY__DESC_OFF: string;
+    MEMORY__BUTTON_USE: string;
+    MEMORY__BUTTON_DONT_USE: string;
+    MEMORY__BUTTON_KEEP_USING: string;
+    MEMORY__BUTTON_DISABLE: string;
+    MEMORY__BUTTON_DISABLE_AND_DELETE: string;
+    MEMORY__BUTTON_KEEP_OFF: string;
+    MEMORY__BUTTON_ENABLE: string;
+    MEMORY__BUTTON_CANCEL: string;
+    MEMORY__ERROR_MESSAGE: string;
+    A11Y_MEMORY_INDICATOR_MANAGE: string;
+    A11Y_MEMORY_INDICATOR_ON: string;
+    A11Y_MEMORY_INDICATOR_OFF: string;
+    CONNECTION_DELAY__TITLE: string;
+    CONNECTION_DELAY__DESCRIPTION: (formattedTime: string) => string;
     /** @deprecated Please use DATE_FORMAT__DATE_SHORT instead. **/
     DATE_FORMAT__CONVERSATION_LIST__LIST_ITEM_TITLE: string;
     /** @deprecated Unused string **/
@@ -4639,7 +4858,15 @@ export declare interface UserActionRequestedData {
     }[];
 }
 
-export declare type UserActionStatus = 'action_requested' | 'action_started' | 'action_submitted' | 'action_processing' | 'action_succeeded' | 'action_failed' | 'action_canceled' | (string & {});
+export declare type UserActionStatus =
+| 'action_requested'
+| 'action_started'
+| 'action_submitted'
+| 'action_processing'
+| 'action_succeeded'
+| 'action_failed'
+| 'action_canceled'
+| (string & {});
 
 export declare const useRefreshActiveChannel: (updater: () => Promise<void>) => () => Promise<void>;