@sendbird/ai-agent-messenger-react 1.23.0 → 1.25.0

package/dist/index.d.ts

@@ -1,46 +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 { FC } from 'react';
-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 { LazyExoticComponent } from 'react';
 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 { SVGProps } from 'react';
+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;
@@ -61,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;
 }
 
@@ -154,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.
@@ -203,6 +199,11 @@ userSessionInfo?: ManualSessionInfo | AnonymousSessionInfo | UserSessionInfo;
 stringSet?: Partial<StringSet>;
 /**
 * @public
+* @description Custom icon registry for the ai agent client.
+* */
+icons?: IconRegistry;
+/**
+* @public
 * @description dir of the widget.
 * */
 dir?: "ltr" | "rtl";
@@ -210,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.
@@ -288,7 +289,7 @@ __internalVariables?: InternalMessageTemplateVariables;
 children?: ReactNode | undefined;
 } & RefAttributes<MessengerSessionRef>>;
 
-export declare function AgentUIProviderContainer({ appearance, rootElement, logger, language, languageCode, stringSet, children, messageTemplate, 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();
@@ -383,6 +384,47 @@ 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'
+| 'menu'
+| 'spinner'
+| 'chat'
+| 'message'
+| 'error'
+| 'refresh'
+| 'chevron-down'
+| 'done'
+| 'done-circle'
+| 'stop'
+| 'stop-circle'
+| 'user'
+| 'file-document'
+| 'agent'
+| 'radio-on'
+| 'radio-off'
+| 'source'
+| 'copy'
+| 'good'
+| 'bad'
+| 'good-filled'
+| 'bad-filled'
+| 'delight'
+| 'photo'
+| 'add'
+| 'document'
+| 'download';
+
 export declare interface AIAgentConfig {
     conversation?: {
         /**
@@ -438,7 +480,7 @@ export declare interface AIAgentConfig {
          * */
         messageAlertSoundEnabled?: boolean;
         /**
-         * (React only) File viewer configuration.
+         * File viewer configuration.
          * */
         fileViewer?: {
             /**
@@ -456,7 +498,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;
@@ -471,32 +513,34 @@ declare interface AIAgentContextValue {
 
     queryParams?: AIAgentQueryParams;
     config?: AIAgentConfig;
+
+    handlers?: AIAgentClientHandlers;
 }
 
 declare interface AIAgentConversationContextValue {
-    conversation: Conversation_2 | undefined;
+    conversation: ChatSDKConversation | undefined;
 
     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;
     };
 
@@ -513,8 +557,8 @@ declare interface AIAgentConversationContextValue {
 declare interface AIAgentConversationListContextValue {
     listSource: {
         initialized: boolean;
-        error: SendbirdError | undefined;
-        channels: GroupChannel[];
+        error: ChatSDKSendbirdError | undefined;
+        channels: ChatSDKGroupChannel[];
         loadMore: () => Promise<void>;
     };
 }
@@ -524,12 +568,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.
@@ -539,7 +583,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.
@@ -557,6 +601,22 @@ declare interface AIAgentGroupChannelFilter {
     copilotSupportChannelUrl?: string;
 }
 
+declare type AIAgentIconComponent = ComponentType<AIAgentIconComponentProps>;
+
+declare type AIAgentIconComponentProps = {
+    size?: number | string;
+    color?: string;
+    /**
+     * Metadata flag. When true, this icon is a direction-sensitive glyph and should be
+     * horizontally flipped by the implementation when rendered in an RTL layout.
+     * The value does not reflect the current layout direction — it only marks the icon
+     * as eligible for flipping.
+     */
+    flipInRtl?: boolean;
+};
+
+declare type AIAgentIconRegistry<T extends string = AIAgentCommonIconName> = Partial<Record<T, AIAgentIconComponent>>;
+
 declare interface AIAgentInfo {
     userId: string;
     nickname: string;
@@ -637,7 +697,7 @@ declare interface AIAgentInterface {
     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>;
+    initConversationIfNeeded: (channel: ChatSDKGroupChannel) => Promise<void>;
 
     /** Disposes all resources held by this instance (WebSocket, desk auth, event handlers). */
     dispose: () => void;
@@ -663,7 +723,7 @@ 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;
@@ -680,7 +740,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
      */
@@ -726,12 +786,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.
@@ -775,6 +835,11 @@ export declare type AIAgentProps = PropsWithChildren<{
      * @description Localization string set for the ai agent client.
      * */
     stringSet?: Partial<StringSet>;
+    /**
+     * @public
+     * @description Custom icon registry for the ai agent client.
+     * */
+    icons?: IconRegistry;
     /**
      * @public
      * @description dir of the widget.
@@ -784,7 +849,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.
@@ -868,7 +933,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;
@@ -883,7 +948,7 @@ declare class AIAgentSession {
     /**
      * The authenticated Sendbird user.
      */
-    get sdkUser(): User {
+    get sdkUser(): ChatSDKUser {
         return this._sdkUser;
     }
 
@@ -929,12 +994,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;
@@ -967,7 +1032,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;
@@ -1027,6 +1092,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: {
@@ -1094,6 +1167,11 @@ declare interface AIAgentStringSet {
         confirm_cancel: string;
         confirm_handoff: string;
     };
+
+    connection_delay: {
+        title: string;
+        description: (formattedTime: string) => string;
+    };
 }
 
 declare type AnonUserSessionData = { userId: string; authToken: string; expireAt: number };
@@ -1151,7 +1229,63 @@ declare type BaseMessageProps<T> = T & {
     children?: ReactNode;
 };
 
-declare type ChatSDKType = SendbirdChatWith<[GroupChannelModule, AIAgentModule]>;
+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;
@@ -1238,6 +1372,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;
@@ -1541,24 +1705,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.
@@ -1589,7 +1753,7 @@ declare class ConversationListCollection {
         this._isSyncing = false;
 
         this._throttledOnChannelChanged = throttle(
-        (channel: GroupChannel) => {
+        (channel: ChatSDKGroupChannel) => {
             if (this._query.belongsTo(channel)) {
                 this._addChannelsToView([channel], false);
             } else {
@@ -1631,7 +1795,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);
@@ -1653,13 +1817,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);
@@ -1690,16 +1854,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) {
@@ -1740,13 +1904,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)) {
@@ -1789,11 +1953,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)) {
@@ -1847,7 +2011,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];
     }
 
@@ -1863,7 +2027,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) {
@@ -1904,9 +2068,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;
 }
@@ -2004,7 +2168,7 @@ export declare const ConversationListItemLayout: {
 } & {};
 
 export declare interface ConversationListItemProps {
-    channel: GroupChannel;
+    channel: ChatSDKGroupChannel;
     channelUrl: string;
     onClick?: () => void;
     /** @deprecated **/
@@ -2054,18 +2218,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 {
@@ -2136,17 +2300,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;
 };
@@ -2409,64 +2576,13 @@ export declare interface GroundednessInfo {
  */
 declare type HexColor = `#${string}`;
 
-/**
- * frequently used icons are imported statically, and others are imported dynamically.
- * */
-declare const icons: {
-    readonly close: FC<SVGProps<SVGElement>>;
-    readonly send: FC<SVGProps<SVGElement>>;
-    readonly menu: FC<SVGProps<SVGElement>>;
-    readonly expand: FC<SVGProps<SVGElement>>;
-    readonly collapse: FC<SVGProps<SVGElement>>;
-    readonly spinner: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly chat: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly message: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly error: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly info: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly refresh: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly 'chevron-down': LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly 'chevron-right': LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly done: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly 'done-circle': LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly stop: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly 'stop-circle': LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly user: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly 'file-document': LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly download: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly attach: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly delete: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly 'close-filled': LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly agent: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly question: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly actionbook: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly function: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly 'radio-on': LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly 'radio-off': LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly confluence: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly zendesk: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly salesforce: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly sprinklr: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly website: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly snippet: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly template: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly source: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly bot: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly 'bot-filled': LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly copy: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly show: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly mute: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly good: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly bad: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly 'good-filled': LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly 'bad-filled': LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly delight: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly photo: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly 'arrow-left': LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly add: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-    readonly document: LazyExoticComponent<FC<SVGProps<SVGElement>>>;
-};
+export declare type IconComponent = AIAgentIconComponent;
 
-declare type IconType = keyof typeof icons;
+export declare type IconComponentProps = AIAgentIconComponentProps;
+
+export declare type IconRegistry = AIAgentIconRegistry<IconType>;
+
+export declare type IconType = AIAgentCommonIconName | ReactOnlyIconName;
 
 declare type IncomingBaseMessageProps<T> = T &
 BaseMessageProps<{
@@ -3574,22 +3690,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 = {
@@ -3611,7 +3718,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';
 
@@ -3625,8 +3732,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;
@@ -3945,7 +4051,7 @@ declare type NumberField = {
 };
 
 declare type OnJoinedProactiveConversation = (params: {
-    channel: GroupChannel;
+    channel: ChatSDKGroupChannel;
 }) => void;
 
 declare type OutgoingBaseMessageProps<T> = T &
@@ -4193,6 +4299,7 @@ declare type Props = {
     language?: string;
     /** @internal DO NOT USE THIS **/
     languageCode?: string;
+    icons?: IconRegistry;
     theme?: {
         palette?: Partial<PaletteShape>;
         typography?: Partial<{
@@ -4200,6 +4307,10 @@ declare type Props = {
         }>;
         colors?: ColorSetInput;
     };
+    /** @internal */
+    entryElement?: HTMLElement;
+    /** @internal */
+    modalRootElement?: HTMLElement;
     /** @internal DO NOT USE THIS **/
     messageTemplate?: {
         /** @internal DO NOT USE THIS **/
@@ -4252,12 +4363,24 @@ declare type Props_4 = PropsWithChildren<{
     style?: CSSProperties;
 }>;
 
+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<{
@@ -4470,11 +4593,13 @@ 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;
+    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 **/
@@ -4634,7 +4759,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>;