@sendbird/ai-agent-messenger-react-native 0.0.1-beta.0

package/dist/index.d.ts

@@ -0,0 +1,952 @@
+import { AIAgentChannelFilter } from '@sendbird/chat/aiAgent';
+import { AIAgentModule } from '@sendbird/chat/aiAgent';
+import { BaseMessage } from '@sendbird/chat/message';
+import type * as CommunityDocumentPicker from '@react-native-documents/picker';
+import type * as CommunityImagePicker from 'react-native-image-picker';
+import { ComponentType } from 'react';
+import { Context } from 'react';
+import { Conversation as Conversation_2 } from '@sendbird/chat/aiAgent';
+import { ConversationStatus } from '@sendbird/chat/aiAgent';
+import { DeskChannelFilter } from '@sendbird/chat/aiAgent';
+import type * as ExpoDocumentPicker from 'expo-document-picker';
+import type * as ExpoImagePicker from 'expo-image-picker';
+import { FileMessage } from '@sendbird/chat/message';
+import { FileMessageCreateParams } from '@sendbird/chat/message';
+import { FlatList } from 'react-native';
+import { FlatListProps } from 'react-native';
+import { ForwardRefExoticComponent } from 'react';
+import { GroupChannel } 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 { MMKV } from 'react-native-mmkv';
+import { NativeScrollEvent } from 'react-native';
+import { NativeSyntheticEvent } from 'react-native';
+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 { User } from '@sendbird/chat';
+import { UserMessage } from '@sendbird/chat/message';
+import { UserMessageCreateParams } from '@sendbird/chat/message';
+
+declare interface AIAgentCache {
+    template: MessageTemplateCache;
+    messenger: MessengerSessionCache;
+}
+
+declare interface AIAgentConfig {
+    conversation?: {
+        isTalkToAgentViewEnabled?: boolean;
+    };
+}
+
+declare interface AIAgentContextValue {
+    appId: string;
+    aiAgentId: string;
+    chatSDK: SendbirdChatWith<[GroupChannelModule, AIAgentModule]>;
+
+    language: string;
+    countryCode?: string;
+    context?: Record<string, string>;
+
+    logger: Loggable;
+    dispatcher: Dispatcher;
+
+    cache: AIAgentCache;
+
+    queryParams?: AIAgentQueryParams;
+    config?: AIAgentConfig;
+}
+
+declare interface AIAgentConversationContextValue {
+    conversation: Conversation_2 | undefined;
+
+    channelSource: {
+        channel: GroupChannel | undefined;
+        error: SendbirdError | undefined;
+        refetch: () => Promise<void>;
+    };
+
+    messageSource: {
+        messages: BaseMessage[];
+        initialized: boolean;
+        loadPrevious: () => Promise<void>;
+        loadNext: () => Promise<void>;
+        sendUserMessage: (params: UserMessageCreateParams) => Promise<UserMessage>;
+        sendFileMessage: (params: FileMessageCreateParams) => Promise<FileMessage>;
+        deleteMessage: (message: UserMessage | FileMessage) => Promise<void>;
+    };
+
+    state: {
+        input: InputState;
+    };
+}
+
+declare interface AIAgentConversationListContextValue {
+    listSource: {
+        initialized: boolean;
+        error: SendbirdError | undefined;
+        channels: GroupChannel[];
+        loadMore: () => Promise<void>;
+    };
+}
+
+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;
+    /**
+     * The filter applied to AI agent conversation statuses.
+     * It allows filtering channels based on the status of their conversations.
+     */
+    aiAgentConversationStatusFilter?: ConversationStatus[];
+    /**
+     * The list of AI agent IDs to filter the channels.
+     * Only channels associated with these AI agents will be included in the results.
+     */
+    aiAgentIds?: string[];
+    /**
+     * The filter applied to Desk channels.
+     * It determines whether to include or exclude Desk channels in the query results.
+     */
+    deskChannelFilter?: DeskChannelFilter;
+    /**
+     * The list of pinned channel URLs.
+     * These channels are prioritized in the query results.
+     */
+    pinnedChannelUrls?: string[];
+    /**
+     * The filter applied to copilot conversation only channels.
+     * It determines whether to include only copilot conversation channels.
+     */
+    copilotConversationOnly?: boolean;
+    /**
+     * The copilot support channel URL.
+     * This channel is used for copilot support conversations.
+     */
+    copilotSupportChannelUrl?: string;
+}
+
+declare interface AIAgentInfo {
+    userId: string;
+    nickname: string;
+    profileUrl: string;
+    replyToFile: boolean;
+    showHandoffButton: boolean;
+    specialNotice: string;
+    specialNoticeEnabled: boolean;
+    isMultipleActiveConversationsEnabled: boolean;
+}
+
+declare interface AIAgentMessengerSessionContextValue {
+    userSessionInfo?: UserSessionInfo | ManualSessionInfo | AnonymousSessionInfo;
+
+    sdkUser: null | User;
+    userSession: null | UserSession;
+    aiAgentInfo: null | AIAgentInfo;
+    launcherInfo: null | LauncherInfo;
+    attachmentMode: AttachmentMode;
+
+    connectionError?: Error;
+
+    activeChannel?: { url: string; status: ConversationStatus };
+    setActiveChannel: (param: { url: string; status: ConversationStatus }) => void;
+
+    createConversation: (params: ConversationCreateParams) => Promise<string>;
+    refreshActiveChannel: () => Promise<string>;
+
+    authenticate: () => Promise<MessengerSettingsResponse>;
+    deauthenticate: () => Promise<void>;
+}
+
+declare interface AIAgentMessengerSessionRef {
+    activeChannel?: { url: string; status: ConversationStatus };
+    chatSDK: AIAgentContextValue['chatSDK'];
+    authenticate: () => Promise<MessengerSettingsResponse>;
+    deauthenticate: () => Promise<void>;
+    updateContext: (context: Record<string, string>) => Promise<ContextObject>;
+    patchContext: (context: Record<string, string>) => Promise<ContextObject>;
+    getContextObject: () => Promise<ContextObject>;
+}
+
+export declare const AIAgentProviderContainer: ForwardRefExoticComponent<    {
+appId: string;
+aiAgentId: string;
+/**
+* @public
+* @description Native modules configuration (includes imagePicker, documentPicker, and mmkv)
+* */
+nativeModules: NativeAdapterConfig;
+/**
+* @public
+* @description Inject a custom Chat SDK. GroupChannelModule and AIAgentModule must be included in the initialization.
+* */
+customChatSDK?: SendbirdChatWith<[GroupChannelModule, AIAgentModule]>;
+/**
+* @public
+* @description Custom parameters for initializing the chat SDK.
+* */
+chatParams?: Partial<SendbirdChatParams<[GroupChannelModule, AIAgentModule]>>;
+/**
+* @public
+* @description AIAgent Messenger theme
+* */
+theme?: {
+mode?: "light" | "dark";
+palette?: Partial<PaletteShape>;
+typography?: Partial<{ [K in keyof TypographyShape]: Partial<TypographyShape[K]>; }>;
+};
+/**
+* @public
+* @description Custom User session information to be used in connecting to the agent.
+* */
+userSessionInfo: ManualSessionInfo | AnonymousSessionInfo;
+/**
+* @public
+* @description logLevel for the ai agent client.
+* */
+logLevel?: LogLevel;
+/**
+* @public
+* @description Language for the ai agent client. Should follow the IETF BCP 47 format.
+* For example, "ko-KR" for Korean in South Korea or "en-US" for English in the United States.
+* */
+language?: string;
+/**
+* @public
+* @description Localization string set for the ai agent client.
+* */
+strings?: PartialDeep<StringSet>;
+/**
+* @public
+* @description Country code for the ai agent client. Should follow the ISO 3166 format.
+* For example, "KR" for South Korea or "US" for the United States.
+* */
+countryCode?: string;
+/**
+* @public
+* @description Context object for the AI agent client. This is injected when the messenger is first loaded and can provide additional context that may influence how the AI responds to user conversations.
+* */
+context?: Record<string, string>;
+/**
+* @public
+* @description AIAgent global default query parameters.
+* */
+queryParams?: AIAgentQueryParams;
+/**
+* @public
+* @description AIAgent global default config.
+* */
+config?: AIAgentConfig;
+} & {
+children?: ReactNode | undefined;
+} & RefAttributes<AIAgentMessengerSessionRef>>;
+
+declare interface AIAgentQueryParams {
+    conversationListParams?: ConversationListCollectionParams;
+}
+
+/**
+ * Common string set interface shared between react and react-native packages
+ * These are the base strings that both packages use
+ * Structure follows the react-native nested format
+ */
+declare interface AIAgentStringSet {
+    conversation: {
+        input_placeholder: string;
+        input_placeholder_disabled: string;
+        input_placeholder_wait_ai_agent_response: string;
+        input_placeholder_active_form: string;
+
+        unknown_message_type: string;
+        powered_by: string;
+        citation_title: string;
+        start_new_conversation_label: string;
+    };
+
+    conversation_list: {
+        header_title: string;
+        ended: string;
+    };
+
+    date_format: {
+        just_now: string;
+        minutes_ago: (minutes: number) => string;
+        hours_ago: (hours: number) => string;
+        date_short: string;
+        date_separator: string;
+        message_timestamp: string;
+    };
+
+    csat: {
+        title: string;
+        submitted_label: string;
+        cre_question: string;
+        cre_positive_label: string;
+        cre_negative_label: string;
+        reason_placeholder: string;
+        question: string;
+        submit_label: string;
+        submission_expired: string;
+    };
+
+    form: {
+        optional_label: string;
+        validation_required: string;
+    };
+
+    common: {
+        placeholder_something_went_wrong: string;
+        placeholder_no_messages: string;
+        placeholder_no_conversations: string;
+        placeholder_something_went_wrong_retry_label: string;
+    };
+}
+
+declare type AnonUserSessionData = { userId: string; authToken: string; expireAt: number };
+
+export declare class AnonymousSessionInfo {
+    userId?: never;
+    authToken?: never;
+    sessionHandler?: never;
+}
+
+declare enum AttachmentMode {
+    OFF = 'off',
+    ALWAYS = 'always',
+    HANDED_OFF_ONLY = 'handed_off_only',
+}
+
+declare abstract class BaseCommand {
+    abstract type: CommandType;
+    payload: any;
+
+    constructor(payload: any = {}) {
+        this.payload = payload;
+    }
+
+    toJSON(): string {
+        return JSON.stringify({ type: this.type, payload: this.payload });
+    }
+}
+
+export declare const BottomSheet: {
+    (props: BottomSheetTemplateProps): JSX.Element;
+    ActionItem(props: BottomSheetActionItemProps): ReactNode;
+};
+
+declare interface BottomSheetActionItemProps extends BottomSheetTemplateProps {
+    icon?: IconType;
+    label?: string;
+    destructive?: boolean;
+    onPress?: () => void;
+}
+
+export declare const BottomSheetLayout: {
+    (props: PropsWithChildren): ReactNode;
+    defaults: {
+        template: ComponentType<BottomSheetTemplateProps>;
+        components: {
+            ActionItem: ({ icon, label, destructive, onPress, }: BottomSheetActionItemProps) => ReactNode;
+        };
+    };
+    Template: ({ template, children }: {
+        template?: ComponentType<BottomSheetTemplateProps> | undefined;
+        children?: ReactNode;
+    }) => JSX.Element;
+    Context: Context<LayoutContextValue<    {
+    ActionItem: ({ icon, label, destructive, onPress, }: BottomSheetActionItemProps) => ReactNode;
+    }, BottomSheetTemplateProps>>;
+    useContext: () => LayoutContextValue<    {
+    ActionItem: ({ icon, label, destructive, onPress, }: BottomSheetActionItemProps) => ReactNode;
+    }, BottomSheetTemplateProps>;
+} & {
+    ActionItem: (props: {
+        component: ({ icon, label, destructive, onPress, }: BottomSheetActionItemProps) => ReactNode;
+    }) => null;
+};
+
+declare interface BottomSheetTemplateProps {
+    onClose?: () => void;
+    children?: ReactNode;
+}
+
+declare interface CloseConversationCommandParams {
+    channelUrl: string;
+}
+
+declare interface CommandPayloads {
+    [CommandType.ConversationClose]: undefined | CloseConversationCommandParams;
+}
+
+declare enum CommandType {
+    ConversationClose = 'conv.close',
+}
+
+declare type CommunityDocumentPickerModule = typeof CommunityDocumentPicker;
+
+declare type CommunityImagePickerModule = typeof CommunityImagePicker;
+
+declare interface ContextObject {
+    language?: string;
+    country?: string;
+    context: Record<string, string>;
+}
+
+export declare const Conversation: ({ children, ...props }: ConversationContextProps) => JSX.Element;
+
+export declare const ConversationContext: Context<ConversationContextValue | null>;
+
+declare interface ConversationContextProps extends PropsWithChildren {
+    channelUrl?: string;
+    onClearChannelUrl?: () => void;
+    onNavigateToConversationList?: () => void;
+    onClose?: () => void;
+}
+
+export declare const ConversationContextProvider: ({ channelUrl, onClearChannelUrl, onClose, onNavigateToConversationList, children, }: ConversationContextProps) => JSX.Element;
+
+declare interface ConversationContextValue extends AIAgentConversationContextValue {
+    scrollSource: ConversationScrollContextValue;
+    updateActiveChannel: () => Promise<void>;
+    onNavigateToConversationList?: () => void;
+    onClose?: () => void;
+}
+
+declare interface ConversationCreateParams {
+    aiAgentId: string;
+    language?: string;
+    country?: string;
+    context?: Record<string, string>;
+}
+
+export declare const ConversationLayout: {
+    (props: PropsWithChildren): ReactNode;
+    defaults: {
+        template: ComponentType<    {}>;
+        components: {
+            Header: () => ReactNode;
+            Body: ({ messageStackDirection, }: {
+                messageStackDirection?: "top" | "bottom";
+            }) => ReactNode;
+            Footer: () => ReactNode;
+        };
+    };
+    Template: ({ template, children }: {
+        template?: ComponentType<    {}> | undefined;
+        children?: ReactNode;
+    }) => JSX.Element;
+    Context: Context<LayoutContextValue<    {
+    Header: () => ReactNode;
+    Body: ({ messageStackDirection, }: {
+    messageStackDirection?: "top" | "bottom";
+    }) => ReactNode;
+    Footer: () => ReactNode;
+    }, {}>>;
+    useContext: () => LayoutContextValue<    {
+    Header: () => ReactNode;
+    Body: ({ messageStackDirection, }: {
+    messageStackDirection?: "top" | "bottom";
+    }) => ReactNode;
+    Footer: () => ReactNode;
+    }, {}>;
+} & {
+    Header: (props: {
+        component: () => ReactNode;
+    }) => null;
+    Body: (props: {
+        component: ({ messageStackDirection, }: {
+            messageStackDirection?: "top" | "bottom";
+        }) => ReactNode;
+    }) => null;
+    Footer: (props: {
+        component: () => ReactNode;
+    }) => null;
+};
+
+export declare const ConversationList: ({ children, ...props }: ConversationListContextProps) => JSX.Element;
+
+/**
+ * Parameters for creating a ConversationListCollection instance.
+ */
+declare interface ConversationListCollectionParams {
+    /** Filter options for AI agent group channels */
+    filter?: AIAgentGroupChannelFilter;
+    /** Maximum number of channels to load per request (default: 20) */
+    limit?: number;
+}
+
+export declare const ConversationListContext: Context<ConversationListContextValue | null>;
+
+declare interface ConversationListContextProps extends PropsWithChildren {
+    conversationListLimit?: number;
+    conversationListFilter?: Partial<AIAgentGroupChannelFilter>;
+    onNavigateToConversation?: (channelUrl: string, status: 'open' | 'closed') => void;
+    onClose?: () => void;
+}
+
+export declare const ConversationListContextProvider: ({ conversationListLimit, conversationListFilter, onNavigateToConversation, onClose, children, }: ConversationListContextProps) => JSX.Element;
+
+declare interface ConversationListContextValue extends AIAgentConversationListContextValue {
+    onNavigateToConversation?: (channelUrl: string, status: 'open' | 'closed') => void;
+    onClose?: () => void;
+}
+
+export declare const ConversationListLayout: {
+    (props: PropsWithChildren): ReactNode;
+    defaults: {
+        template: ComponentType<unknown>;
+        components: {
+            Header: () => ReactNode;
+            Body: () => ReactNode;
+            Footer: () => ReactNode;
+        };
+    };
+    Template: ({ template, children }: {
+        template?: ComponentType<unknown> | undefined;
+        children?: ReactNode;
+    }) => JSX.Element;
+    Context: Context<LayoutContextValue<    {
+    Header: () => ReactNode;
+    Body: () => ReactNode;
+    Footer: () => ReactNode;
+    }, unknown>>;
+    useContext: () => LayoutContextValue<    {
+    Header: () => ReactNode;
+    Body: () => ReactNode;
+    Footer: () => ReactNode;
+    }, unknown>;
+} & {
+    Header: (props: {
+        component: () => ReactNode;
+    }) => null;
+    Body: (props: {
+        component: () => ReactNode;
+    }) => null;
+    Footer: (props: {
+        component: () => ReactNode;
+    }) => null;
+};
+
+declare interface ConversationScrollContextValue {
+    ref: RefObject<FlatList | null>;
+    state: {
+        distanceFromBottom: number;
+        isAtBottom: boolean;
+        bottomSpace?: number;
+    };
+    props: {
+        maintainVisibleContentPosition: MaintainVisibleContentPosition | undefined;
+        onLayout?: (event: LayoutChangeEvent) => void;
+        onContentSizeChange?: (width: number, height: number) => void;
+        onScroll?: (event: NativeSyntheticEvent<NativeScrollEvent>) => void;
+    };
+    actions: {
+        /**
+         * Scrolls to the bottom of the list (latest messages in inverted list)
+         * @param animated - Whether to animate the scroll. Defaults to true
+         */
+        scrollToBottom: (animated?: boolean) => void;
+        /**
+         * Scrolls to a specific item by index with the item positioned at the top of viewport
+         * @param index - The index of the item to scroll to
+         * @param animated - Whether to animate the scroll. Defaults to true
+         */
+        scrollToIndex: (index: number, animated?: boolean) => void;
+        /**
+         * Call before sending a message
+         * - Fixed mode: Captures current content height as baseline for padding calculation
+         * - Auto mode: No operation
+         */
+        onBeforeMessageSend: () => void;
+        /**
+         * Call after a message is sent and rendered
+         * - Fixed mode: Scrolls to index 0 to position the new message at viewport top
+         * - Auto mode: Scrolls to bottom to show the latest message
+         */
+        onAfterMessageSend: () => void;
+        /**
+         * Call when receiving streaming message updates
+         * - Fixed mode: No operation (position maintained automatically via maintainVisibleContentPosition)
+         * - Auto mode: Continuously scrolls to bottom to track real-time updates
+         */
+        onStreamingUpdate: () => void;
+    };
+}
+
+declare interface Dispatcher {
+    send(command: BaseCommand): Promise<void>;
+    subscribe<E extends CommandType>(eventType: E, callback: (payload: CommandPayloads[E]) => void | Promise<void>): void;
+    unsubscribe<E extends CommandType>(
+    eventType: E,
+    callback: (payload: CommandPayloads[E]) => void | Promise<void>,
+    ): void;
+}
+
+declare type ExpoDocumentPickerModule = typeof ExpoDocumentPicker;
+
+declare type ExpoImagePickerModule = typeof ExpoImagePicker;
+
+declare const icons: {
+    send: any;
+    close: any;
+    menu: any;
+    chat: any;
+    message: any;
+    spinner: any;
+    error: any;
+    refresh: any;
+    'chevron-down': any;
+    done: any;
+    'done-all': any;
+    user: any;
+    'file-document': any;
+    remove: any;
+    add: any;
+    agent: any;
+    camera: any;
+    photo: any;
+    document: any;
+    'bot-filled': any;
+    copy: any;
+    source: any;
+    'radio-on': any;
+    'radio-off': any;
+};
+
+declare type IconType = keyof typeof icons;
+
+declare type InputState = {
+    disabled: boolean;
+    disabledBy:
+    | 'unavailable'
+    | 'form_active'
+    | 'ai_responding'
+    | 'conversation_closed'
+    | 'suggested_replies'
+    | (string & {});
+};
+
+declare interface KeyValueStorage {
+    get(key: string): null | string;
+    set(key: string, value: string): void;
+    delete(key: string): void;
+    getKeys(startsWith: string): string[];
+}
+
+declare type LauncherImageType = 'default_icon' | 'custom_image';
+
+declare interface LauncherInfo {
+    type: LauncherImageType;
+    imageUrl: string;
+}
+
+declare interface LayoutContextValue<Components extends Record<string, ComponentType<Props>>, Props> {
+    Template: ComponentType<Props>;
+    updateTemplate: (template: ComponentType<Props>) => void;
+    components: Components;
+    updateComponent: (key: keyof Components, component: Components[keyof Components]) => void;
+}
+
+declare interface Loggable {
+    verbose(...args: any[]): void;
+    debug(...args: any[]): void;
+    info(...args: any[]): void;
+    warn(...args: any[]): void;
+    error(...args: any[]): void;
+}
+
+declare type MaintainVisibleContentPosition = FlatListProps<any>['maintainVisibleContentPosition'];
+
+export declare class ManualSessionInfo {
+    userId: string;
+    authToken: string;
+    sessionHandler: SessionHandler;
+
+    constructor({ userId, authToken, sessionHandler }: ManualSessionInfoParams) {
+        this.userId = userId;
+        this.authToken = authToken;
+        this.sessionHandler = sessionHandler;
+    }
+}
+
+declare interface ManualSessionInfoParams {
+    userId: string;
+    authToken: string;
+    sessionHandler: SessionHandler;
+}
+
+/** File metadata returned from picker methods */
+declare interface MediaFile {
+    uri: string;
+    type: string;
+    size: number;
+    name: string;
+    width?: number;
+    height?: number;
+}
+
+/** Picker options */
+declare interface MediaPickerOptions {
+    /** Allow multiple file selection */
+    multiple?: boolean;
+    /** Filter by MIME types (e.g., ['image/jpeg', 'image/png', 'application/pdf']) */
+    mimeTypes?: string[];
+}
+
+declare interface MessageTemplateCache {
+    set(key: string, value: string): void;
+    get(key: string): string | null;
+    setCachedToken(token: string): void;
+    getCachedToken(): string | null;
+    clear(): void;
+}
+
+declare interface MessengerSessionCache {
+    getSettings(userId: string): MessengerSettingsResponse | null;
+    setSettings(userId: string, value: MessengerSettingsResponse): void;
+    getAnonUser(): AnonUserSessionData | null;
+    setAnonUser(value: AnonUserSessionData): void;
+    clear(userId: string): void;
+}
+
+declare interface MessengerSessionContextValue extends AIAgentMessengerSessionContextValue {
+}
+
+declare interface MessengerSettingsResponse {
+    active_channel: {
+        channel_url: string;
+        attachment_mode: 'always' | 'handed_off_only' | 'off';
+    };
+    bot: {
+        bot_userid: string;
+        reply_to_file: boolean;
+        bot_profile_url: string;
+        bot_nickname: string;
+        special_notice: string;
+        is_special_notice_enabled: boolean;
+        show_handoff_button: boolean;
+        is_multiple_active_conversations_enabled: boolean;
+    };
+    appearance: {
+        selected_theme: 'light' | 'dark';
+        themes: {
+            light: {
+                primary_color: string;
+                bot_message_bg_color: string;
+                primary_contrast_color: string;
+                bot_message_bg_contrast_color: string;
+            };
+            dark: {
+                primary_color: string;
+                bot_message_bg_color: string;
+                primary_contrast_color: string;
+                bot_message_bg_contrast_color: string;
+            };
+        };
+    };
+    launcher: {
+        image_type: LauncherImageType;
+        image_url: string;
+        auto_open: boolean;
+    };
+    auto_created_user?: {
+        user_id: string;
+        session_token: string;
+        expire_at: number;
+    };
+}
+
+declare type MMKVModule = MMKV;
+
+declare interface ModalContextProps {
+    children: ReactNode;
+}
+
+export declare interface ModalContextValue {
+    openModal: <T = any>(render: (close: (value?: T) => void) => ReactNode) => Promise<T | null>;
+    currentModal: ModalItem | null;
+}
+
+declare interface ModalItem<T = any> {
+    id: string;
+    render: (close: (value?: T) => void) => ReactNode;
+    resolve: (value: T) => void;
+}
+
+export declare function ModalProvider({ children }: ModalContextProps): JSX.Element;
+
+/** Configuration for NativeAdapter */
+declare interface NativeAdapterConfig {
+    mmkv: MMKVModule;
+    imagePicker: ExpoImagePickerModule | CommunityImagePickerModule;
+    documentPicker: ExpoDocumentPickerModule | CommunityDocumentPickerModule;
+}
+
+/** Methods available from useNativeAdapterContext() */
+declare interface NativeAdapterContextValue {
+    /**
+     * Launch camera to capture a photo
+     * @returns Array with single MediaFile, or null if cancelled
+     */
+    captureCamera: (options?: MediaPickerOptions) => Promise<MediaFile[] | null>;
+    /**
+     * Select photos from gallery
+     * @returns Array of MediaFiles, or null if cancelled
+     */
+    selectFromGallery: (options?: MediaPickerOptions) => Promise<MediaFile[] | null>;
+    /**
+     * Select files from file picker
+     * @returns Array of MediaFiles, or null if cancelled
+     */
+    selectFile: (options?: MediaPickerOptions) => Promise<MediaFile[] | null>;
+    /**
+     * Key-value storage interface
+     */
+    keyValueStorage: KeyValueStorage;
+}
+
+/**
+ * Provider for native adapter context.
+ * Requires native modules configuration.
+ */
+export declare const NativeAdapterProvider: ({ config, children }: NativeAdapterProviderProps) => JSX.Element;
+
+declare interface NativeAdapterProviderProps {
+    config: NativeAdapterConfig;
+    children: ReactNode | ((context: NativeAdapterContextValue) => ReactNode);
+}
+
+declare interface PaletteColor {
+    extraDark: string;
+    dark: string;
+    main: string;
+    light: string;
+    extraLight: string;
+}
+
+declare interface PaletteShape {
+    primary: PaletteColor;
+    secondary: PaletteColor;
+    error: PaletteColor;
+    information: PaletteColor;
+    background700: string;
+    background600: string;
+    background500: string;
+    background400: string;
+    background300: string;
+    background200: string;
+    background100: string;
+    background50: string;
+    onlight: PaletteTextEmphasis;
+    ondark: PaletteTextEmphasis;
+    overlay: {
+        dark: string;
+        light: string;
+    };
+}
+
+declare interface PaletteTextEmphasis {
+    textHighEmphasis: string;
+    textMidEmphasis: string;
+    textLowEmphasis: string;
+    textDisabled: string;
+}
+
+/**
+ * Type utility for making all properties optional recursively
+ * Functions and Sets are preserved as-is without being made partial
+ */
+declare type PartialDeep<T> = T extends object ? T extends Set<unknown> ? T : T extends Function ? T : {
+    [P in keyof T]?: PartialDeep<T[P]>;
+} : T;
+
+/**
+ * Strings type for React Native components
+ * Uses nested structure with lowercase keys
+ */
+declare type StringSet = {
+    conversation: AIAgentStringSet['conversation'] & {
+        attachment_camera: string;
+        attachment_photo: string;
+        attachment_document: string;
+    };
+    conversation_list: AIAgentStringSet['conversation_list'] & {
+        footer_title: string;
+    };
+    date_format: AIAgentStringSet['date_format'] & {};
+    csat: AIAgentStringSet['csat'] & {};
+    form: AIAgentStringSet['form'] & {};
+    common: AIAgentStringSet['common'] & {};
+};
+
+declare interface TypographyShape {
+    h1: TypographyVariant;
+    h2: TypographyVariant;
+    subtitle1: TypographyVariant;
+    subtitle2: TypographyVariant;
+    body1: TypographyVariant;
+    body2: TypographyVariant;
+    body3: TypographyVariant;
+    button: TypographyVariant;
+    caption1: TypographyVariant;
+    caption2: TypographyVariant;
+    caption3: TypographyVariant;
+    caption4: TypographyVariant;
+}
+
+declare interface TypographyVariant {
+    fontSize: number | string;
+    fontWeight: number | string;
+    fontFamily?: string;
+    lineHeight?: number | string;
+}
+
+export declare const useConversationContext: {
+    (): ConversationContextValue;
+    displayName: string;
+};
+
+export declare const useConversationListContext: {
+    (): ConversationListContextValue;
+    displayName: string;
+};
+
+export declare const useMessengerSessionContext: {
+    (): MessengerSessionContextValue;
+    displayName: string;
+};
+
+export declare const useModalContext: {
+    (): ModalContextValue;
+    displayName: string;
+};
+
+export declare const useNativeAdapterContext: {
+    (): NativeAdapterContextValue;
+    displayName: string;
+};
+
+declare type UserSession = {
+    userId: string;
+    authToken: string;
+};
+
+/**
+ * @deprecated Please use `ManualSessionInfo` or `AnonymousSessionInfo` instead.
+ * */
+declare interface UserSessionInfo {
+    userId: string;
+    authToken: string;
+    sessionHandler: SessionHandler;
+}
+
+export { }