@sendbird/ai-agent-messenger-react 1.29.0 → 1.30.0

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import { Action } from '@sendbird/uikit-message-template';
 import type { AIAgentChannelFilter } from '@sendbird/chat/aiAgent';
 import type { AIAgentModule } from '@sendbird/chat/aiAgent';
+import { AriaRole } from 'react';
 import type { BaseChannelCollectionEventHandler } from '@sendbird/chat/groupChannel';
 import type { BaseMessage } from '@sendbird/chat/message';
 import type { CollectionEventSource } from '@sendbird/chat';
@@ -481,6 +482,13 @@ declare interface AIAgentConfig_2 {
              * @default 'default'
              * */
             markdownImageRenderMode: MarkdownImageRenderMode;
+            /**
+             * Controls how markdown links are displayed while a message is streaming.
+             * - `default`: Renders partial markdown as-is.
+             * - `complete-only`: Hides incomplete link markdown until the link token is complete.
+             * @default 'default'
+             * */
+            markdownLinkRenderMode: MarkdownLinkRenderMode;
         };
         header: {
             /**
@@ -1511,7 +1519,7 @@ declare interface ContextObject {
     context: Record<string, string>;
 }
 
-export declare const Conversation: ({ children, onNavigateToConversationList, channelUrl, onClearChannelUrl, shouldMarkAsRead, announcementsEnabled, style, closedChannelUrl, onClearClosedChannelUrl, }: Props_3) => JSX.Element;
+export declare const Conversation: ({ children, onNavigateToConversationList, channelUrl, onClearChannelUrl, shouldMarkAsRead, announcementsEnabled, initialFocusTarget, style, closedChannelUrl, onClearClosedChannelUrl, }: Props_3) => JSX.Element;
 
 export declare const ConversationContext: Context<ConversationContextValue | null>;
 
@@ -1619,6 +1627,8 @@ declare interface ConversationHeaderTemplateProps {
     titleAlign?: 'start' | 'center' | 'end';
 }
 
+declare type ConversationInitialFocusTarget = 'messageInput';
+
 declare class ConversationInitialRenderStats extends AIAgentBaseStats {
     private presentMethod: PresentMethod = 'direct_present';
 
@@ -1832,13 +1842,13 @@ export declare const ConversationListContext: Context<ConversationListContextVal
 declare interface ConversationListContextProps {
     conversationListLimit?: number;
     conversationListFilter?: Partial<AIAgentGroupChannelFilter>;
-    onOpenConversationView?: (channelUrl: string, status: 'open' | 'closed') => void;
+    onOpenConversationView?: (channelUrl: string, status: 'open' | 'closed', options?: ConversationListOpenOptions) => void;
 }
 
 export declare function ConversationListContextProvider({ conversationListLimit, conversationListFilter, onOpenConversationView, children, }: PropsWithChildren<ConversationListContextProps>): JSX.Element;
 
 declare interface ConversationListContextValue extends AIAgentConversationListContextValue {
-    onOpenConversationView: (channelUrl: string, status: 'open' | 'closed') => void;
+    onOpenConversationView: (channelUrl: string, status: 'open' | 'closed', options?: ConversationListOpenOptions) => void;
 }
 
 export declare const ConversationListHeaderLayout: {
@@ -1953,6 +1963,10 @@ export declare const ConversationListLayout: {
     }) => null;
 };
 
+declare interface ConversationListOpenOptions {
+    initialFocusTarget?: 'messageInput';
+}
+
 declare type ConversationMessageEvent = ConversationMessageEventPayload & { id: number };
 
 declare type ConversationMessageEventPayload =
@@ -2071,6 +2085,7 @@ export declare interface CustomMessageTemplateData {
 export declare type DateSeparatorProps = SBUFoundationProps<{
     /** date or timestamp */
     date?: Date | number;
+    role?: AriaRole;
 }>;
 
 /**
@@ -2350,6 +2365,7 @@ BaseMessageProps<{
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
     markdownImageRenderMode?: MarkdownImageRenderMode;
+    markdownLinkRenderMode?: MarkdownLinkRenderMode;
 
     // handlers
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
@@ -2431,6 +2447,7 @@ export declare const IncomingMessageLayout: {
                 isFeedbackCommentEnabled?: boolean;
                 isSenderAvatarVisible?: boolean;
                 markdownImageRenderMode?: MarkdownImageRenderMode;
+                markdownLinkRenderMode?: MarkdownLinkRenderMode;
                 onGetCachedMessageTemplate?: (templateKey: string) => string | null;
                 onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
                 onHandleTemplateInternalAction?: (action: Action) => void;
@@ -2509,6 +2526,7 @@ export declare const IncomingMessageLayout: {
                 isFeedbackCommentEnabled?: boolean;
                 isSenderAvatarVisible?: boolean;
                 markdownImageRenderMode?: MarkdownImageRenderMode;
+                markdownLinkRenderMode?: MarkdownLinkRenderMode;
                 onGetCachedMessageTemplate?: (templateKey: string) => string | null;
                 onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
                 onHandleTemplateInternalAction?: (action: Action) => void;
@@ -2587,6 +2605,7 @@ export declare const IncomingMessageLayout: {
                 isFeedbackCommentEnabled?: boolean;
                 isSenderAvatarVisible?: boolean;
                 markdownImageRenderMode?: MarkdownImageRenderMode;
+                markdownLinkRenderMode?: MarkdownLinkRenderMode;
                 onGetCachedMessageTemplate?: (templateKey: string) => string | null;
                 onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
                 onHandleTemplateInternalAction?: (action: Action) => void;
@@ -2661,6 +2680,7 @@ export declare const IncomingMessageLayout: {
                 isFeedbackCommentEnabled?: boolean;
                 isSenderAvatarVisible?: boolean;
                 markdownImageRenderMode?: MarkdownImageRenderMode;
+                markdownLinkRenderMode?: MarkdownLinkRenderMode;
                 onGetCachedMessageTemplate?: (templateKey: string) => string | null;
                 onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
                 onHandleTemplateInternalAction?: (action: Action) => void;
@@ -2739,6 +2759,7 @@ export declare const IncomingMessageLayout: {
                 isFeedbackCommentEnabled?: boolean;
                 isSenderAvatarVisible?: boolean;
                 markdownImageRenderMode?: MarkdownImageRenderMode;
+                markdownLinkRenderMode?: MarkdownLinkRenderMode;
                 onGetCachedMessageTemplate?: (templateKey: string) => string | null;
                 onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
                 onHandleTemplateInternalAction?: (action: Action) => void;
@@ -2817,6 +2838,7 @@ export declare const IncomingMessageLayout: {
                 isFeedbackCommentEnabled?: boolean;
                 isSenderAvatarVisible?: boolean;
                 markdownImageRenderMode?: MarkdownImageRenderMode;
+                markdownLinkRenderMode?: MarkdownLinkRenderMode;
                 onGetCachedMessageTemplate?: (templateKey: string) => string | null;
                 onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
                 onHandleTemplateInternalAction?: (action: Action) => void;
@@ -2926,6 +2948,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
     markdownImageRenderMode?: MarkdownImageRenderMode;
+    markdownLinkRenderMode?: MarkdownLinkRenderMode;
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3004,6 +3027,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
     markdownImageRenderMode?: MarkdownImageRenderMode;
+    markdownLinkRenderMode?: MarkdownLinkRenderMode;
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3082,6 +3106,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
     markdownImageRenderMode?: MarkdownImageRenderMode;
+    markdownLinkRenderMode?: MarkdownLinkRenderMode;
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3156,6 +3181,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
     markdownImageRenderMode?: MarkdownImageRenderMode;
+    markdownLinkRenderMode?: MarkdownLinkRenderMode;
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3234,6 +3260,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
     markdownImageRenderMode?: MarkdownImageRenderMode;
+    markdownLinkRenderMode?: MarkdownLinkRenderMode;
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3312,6 +3339,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
     markdownImageRenderMode?: MarkdownImageRenderMode;
+    markdownLinkRenderMode?: MarkdownLinkRenderMode;
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3416,6 +3444,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
     markdownImageRenderMode?: MarkdownImageRenderMode;
+    markdownLinkRenderMode?: MarkdownLinkRenderMode;
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3494,6 +3523,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
     markdownImageRenderMode?: MarkdownImageRenderMode;
+    markdownLinkRenderMode?: MarkdownLinkRenderMode;
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3572,6 +3602,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
     markdownImageRenderMode?: MarkdownImageRenderMode;
+    markdownLinkRenderMode?: MarkdownLinkRenderMode;
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3646,6 +3677,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
     markdownImageRenderMode?: MarkdownImageRenderMode;
+    markdownLinkRenderMode?: MarkdownLinkRenderMode;
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3724,6 +3756,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
     markdownImageRenderMode?: MarkdownImageRenderMode;
+    markdownLinkRenderMode?: MarkdownLinkRenderMode;
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3802,6 +3835,7 @@ export declare const IncomingMessageLayout: {
     isFeedbackCommentEnabled?: boolean;
     isSenderAvatarVisible?: boolean;
     markdownImageRenderMode?: MarkdownImageRenderMode;
+    markdownLinkRenderMode?: MarkdownLinkRenderMode;
     onGetCachedMessageTemplate?: (templateKey: string) => string | null;
     onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
     onHandleTemplateInternalAction?: (action: Action) => void;
@@ -3929,6 +3963,7 @@ export declare const IncomingMessageLayout: {
             isFeedbackCommentEnabled?: boolean;
             isSenderAvatarVisible?: boolean;
             markdownImageRenderMode?: MarkdownImageRenderMode;
+            markdownLinkRenderMode?: MarkdownLinkRenderMode;
             onGetCachedMessageTemplate?: (templateKey: string) => string | null;
             onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
             onHandleTemplateInternalAction?: (action: Action) => void;
@@ -4007,6 +4042,7 @@ export declare const IncomingMessageLayout: {
             isFeedbackCommentEnabled?: boolean;
             isSenderAvatarVisible?: boolean;
             markdownImageRenderMode?: MarkdownImageRenderMode;
+            markdownLinkRenderMode?: MarkdownLinkRenderMode;
             onGetCachedMessageTemplate?: (templateKey: string) => string | null;
             onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
             onHandleTemplateInternalAction?: (action: Action) => void;
@@ -4085,6 +4121,7 @@ export declare const IncomingMessageLayout: {
             isFeedbackCommentEnabled?: boolean;
             isSenderAvatarVisible?: boolean;
             markdownImageRenderMode?: MarkdownImageRenderMode;
+            markdownLinkRenderMode?: MarkdownLinkRenderMode;
             onGetCachedMessageTemplate?: (templateKey: string) => string | null;
             onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
             onHandleTemplateInternalAction?: (action: Action) => void;
@@ -4161,6 +4198,7 @@ export declare const IncomingMessageLayout: {
             isFeedbackCommentEnabled?: boolean;
             isSenderAvatarVisible?: boolean;
             markdownImageRenderMode?: MarkdownImageRenderMode;
+            markdownLinkRenderMode?: MarkdownLinkRenderMode;
             onGetCachedMessageTemplate?: (templateKey: string) => string | null;
             onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
             onHandleTemplateInternalAction?: (action: Action) => void;
@@ -4239,6 +4277,7 @@ export declare const IncomingMessageLayout: {
             isFeedbackCommentEnabled?: boolean;
             isSenderAvatarVisible?: boolean;
             markdownImageRenderMode?: MarkdownImageRenderMode;
+            markdownLinkRenderMode?: MarkdownLinkRenderMode;
             onGetCachedMessageTemplate?: (templateKey: string) => string | null;
             onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
             onHandleTemplateInternalAction?: (action: Action) => void;
@@ -4317,6 +4356,7 @@ export declare const IncomingMessageLayout: {
             isFeedbackCommentEnabled?: boolean;
             isSenderAvatarVisible?: boolean;
             markdownImageRenderMode?: MarkdownImageRenderMode;
+            markdownLinkRenderMode?: MarkdownLinkRenderMode;
             onGetCachedMessageTemplate?: (templateKey: string) => string | null;
             onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
             onHandleTemplateInternalAction?: (action: Action) => void;
@@ -4522,6 +4562,8 @@ declare interface ManualSessionInfoParams {
 
 declare type MarkdownImageRenderMode = 'default' | 'complete-only';
 
+declare type MarkdownLinkRenderMode = 'default' | 'complete-only';
+
 declare interface MemoryInfo {
     enabled: boolean;
     showIndicator: boolean;
@@ -4544,7 +4586,7 @@ export declare const MessageListUILayout: {
     defaults: {
         template: ComponentType<unknown>;
         components: {
-            DateSeparator: ({ className, date, style }: DateSeparatorProps) => ReactNode;
+            DateSeparator: ({ className, date, role, style }: DateSeparatorProps) => ReactNode;
             ScrollToBottomButton: ({ className, style, onClick }: ScrollToBottomButtonProps) => ReactNode;
         };
     };
@@ -4553,23 +4595,23 @@ export declare const MessageListUILayout: {
         children?: ReactNode;
     }) => JSX.Element;
     Context: Context<LayoutContextValue<unknown, {
-    DateSeparator: ({ className, date, style }: DateSeparatorProps) => ReactNode;
+    DateSeparator: ({ className, date, role, style }: DateSeparatorProps) => ReactNode;
     ScrollToBottomButton: ({ className, style, onClick }: ScrollToBottomButtonProps) => ReactNode;
     }>>;
     useContext: () => LayoutContextValue<unknown, {
-    DateSeparator: ({ className, date, style }: DateSeparatorProps) => ReactNode;
+    DateSeparator: ({ className, date, role, style }: DateSeparatorProps) => ReactNode;
     ScrollToBottomButton: ({ className, style, onClick }: ScrollToBottomButtonProps) => ReactNode;
     }>;
 } & {
     DateSeparator: (props: {
-        component: ({ className, date, style }: DateSeparatorProps) => ReactNode;
+        component: ({ className, date, role, style }: DateSeparatorProps) => ReactNode;
     }) => null;
     ScrollToBottomButton: (props: {
         component: ({ className, style, onClick }: ScrollToBottomButtonProps) => ReactNode;
     }) => null;
 };
 
-export declare const MessageLogs: ({ actionbook, functionCalls, groundedness, agentMessageTemplates, onClickActionbook, onClickFunctionCall, onClickFunctionCallDetail, onClickGroundedness, onClickAgentMessageTemplate, bottomContent, renderCustomGroundednessIcon, style, }: Props_2) => JSX.Element;
+export declare const MessageLogs: ({ actionbook, functionCalls, groundedness, agentMessageTemplates, onClickActionbook, onClickFunctionCall, onClickFunctionCallDetail, onClickGroundedness, onClickAgentMessageTemplate, topContent, bottomContent, renderCustomGroundednessIcon, style, }: Props_2) => JSX.Element;
 
 declare interface MessageTemplateCache {
     set(key: string, value: string): void;
@@ -5081,6 +5123,7 @@ declare type Props_2 = {
         barColor?: string;
         highlightColor?: string;
     };
+    topContent?: ReactNode;
     bottomContent?: ReactNode;
     renderCustomGroundednessIcon?: (props: {
         default: ReactNode;
@@ -5094,6 +5137,7 @@ declare type Props_3 = PropsWithChildren<{
     onNavigateToConversationList?: () => void;
     shouldMarkAsRead?: boolean;
     announcementsEnabled?: boolean;
+    initialFocusTarget?: ConversationInitialFocusTarget;
     /** Custom styles for the conversation container. */
     style?: CSSProperties;
     /** @deprecated Please use `channelUrl` instead. **/
@@ -5105,7 +5149,7 @@ declare type Props_3 = PropsWithChildren<{
 declare type Props_4 = PropsWithChildren<{
     conversationListLimit?: number;
     conversationListFilter?: Partial<AIAgentGroupChannelFilter>;
-    onOpenConversationView?: (channelUrl: string, status: 'open' | 'closed') => void;
+    onOpenConversationView?: (channelUrl: string, status: 'open' | 'closed', options?: ConversationListOpenOptions) => void;
     announcementsEnabled?: boolean;
     /** Custom styles for the conversation list container. */
     style?: CSSProperties;