@sendbird/ai-agent-messenger-react 1.38.0 → 1.39.0

package/dist/index.d.ts

@@ -427,8 +427,8 @@ declare interface AIAgentClientHandlers {
     onClickLink?: (params: { url: string }) => void;
     /**
      * Called whenever the SDK emits a live metric — connection, conversation lifecycle,
-     * handoff, and message events. Use for real-time analytics. Implementations should be
-     * efficient and non-blocking, as this may be called frequently.
+     * handoff, message, and memory dialog events. Use for real-time analytics. Implementations
+     * should be efficient and non-blocking, as this may be called frequently.
      */
     onLiveMetric?: (metric: LiveMetric) => void;
 }
@@ -1707,7 +1707,7 @@ export declare const ConversationHeaderLayout: {
             TitleArea: () => ReactNode;
             EndArea: () => ReactNode;
             MenuButton: () => ReactNode;
-            Title: () => ReactNode;
+            Title: (props: HeaderTitleProps) => ReactNode;
             MemoryIndicator: () => ReactNode;
             HandoffButton: () => ReactNode;
             ConversationCloseButton: () => ReactNode;
@@ -1724,7 +1724,7 @@ export declare const ConversationHeaderLayout: {
     TitleArea: () => ReactNode;
     EndArea: () => ReactNode;
     MenuButton: () => ReactNode;
-    Title: () => ReactNode;
+    Title: (props: HeaderTitleProps) => ReactNode;
     MemoryIndicator: () => ReactNode;
     HandoffButton: () => ReactNode;
     ConversationCloseButton: () => ReactNode;
@@ -1736,7 +1736,7 @@ export declare const ConversationHeaderLayout: {
     TitleArea: () => ReactNode;
     EndArea: () => ReactNode;
     MenuButton: () => ReactNode;
-    Title: () => ReactNode;
+    Title: (props: HeaderTitleProps) => ReactNode;
     MemoryIndicator: () => ReactNode;
     HandoffButton: () => ReactNode;
     ConversationCloseButton: () => ReactNode;
@@ -1757,7 +1757,7 @@ export declare const ConversationHeaderLayout: {
         component: () => ReactNode;
     }) => null;
     Title: (props: {
-        component: () => ReactNode;
+        component: (props: HeaderTitleProps) => ReactNode;
     }) => null;
     MemoryIndicator: (props: {
         component: () => ReactNode;
@@ -3163,6 +3163,11 @@ export declare interface GroundednessInfo {
     preview_title: string;
 }
 
+declare interface HeaderTitleProps {
+    /** Overrides the default title, which is derived from the channel (AI agent nickname or channel name). */
+    title?: string;
+}
+
 /**
  * Hex color string type. Enforces '#' prefix at compile time.
  * Only validates the prefix — does not guarantee valid hex digits or length.
@@ -5390,8 +5395,9 @@ declare interface LiveMetricEmitter<S extends MetricSource = MetricSource> {
  *
  * Registers Sendbird SDK handlers, wraps raw callbacks into {@link MetricSource}s,
  * routes each source to its category emitter, and lets emitters dispatch public
- * metrics through the settable {@link LiveMetricManager.dispatch} sink. Outgoing message
- * and explicit conversation-initialized sources are injected via {@link LiveMetricManager.track}.
+ * metrics through the settable {@link LiveMetricManager.dispatch} sink. Outgoing message,
+ * explicit conversation-initialized, and memory dialog sources are injected via
+ * {@link LiveMetricManager.track}.
  */
 declare class LiveMetricManager {
     private readonly id = 'aiagent_livemetric';
@@ -5414,6 +5420,7 @@ declare class LiveMetricManager {
             handoff: new HandoffMetricEmitter(this.emit),
             incomingMessage: new IncomingMessageMetricEmitter(this.emit, getCurrentUserId),
             outgoingMessage: new OutgoingMessageMetricEmitter(this.emit, getCurrentUserId),
+            memory: new MemoryMetricEmitter(this.emit, getCurrentUserId),
         };
     }
 
@@ -5448,7 +5455,7 @@ declare class LiveMetricManager {
 
     /**
      * Routes a source to its emitter. Also the entry point for externally injected
-     * sources (outgoing message status, explicit conversation-initialized).
+     * sources (outgoing message status, explicit conversation-initialized, memory dialog).
      */
     track(source: MetricSource): void {
         try {
@@ -5508,6 +5515,14 @@ declare interface ManualSessionInfoParams {
     sessionHandler: AIAgentSessionHandler;
 }
 
+/**
+ * What happened on the memory dialog: it became visible, the user chose one of its two buttons,
+ * or the user closed it without choosing (backdrop, Escape, Android back).
+ */
+declare type MemoryDialogAction = 'shown' | 'confirm' | 'cancel' | 'dismiss';
+
+declare type MemoryDialogVariant = 'consent' | 'on' | 'off' | 'readonly';
+
 declare interface MemoryInfo {
     enabled: boolean;
     showIndicator: boolean;
@@ -5885,7 +5900,7 @@ declare type MessengerSettingsUpdatedParams =
 | { settings: MessengerSettingsResponse; source: 'server' }
 | { settings: CachedMessengerSettings; source: 'cache' };
 
-declare type MetricCategory = 'handoff' | 'conversation' | 'message' | 'connection';
+declare type MetricCategory = 'handoff' | 'conversation' | 'message' | 'connection' | 'memory';
 
 /**
  * An event + action represented as a single value. Input to the emitters.
@@ -5895,7 +5910,8 @@ declare type MetricSource =
 | { type: 'handoff'; channel: ChatSDKGroupChannel }
 | { type: 'conversation'; channel: ChatSDKGroupChannel }
 | { type: 'incomingMessage'; channel: ChatSDKGroupChannel; message: ChatSDKBaseMessage }
-| { type: 'outgoingMessage'; channel: ChatSDKGroupChannel; message: ChatSDKBaseMessage };
+| { type: 'outgoingMessage'; channel: ChatSDKGroupChannel; message: ChatSDKBaseMessage }
+| { type: 'memory'; variant: MemoryDialogVariant; action: MemoryDialogAction; deleteOnOff: boolean };
 
 declare type MultiSelectField = {
     key: string;