Added AI Integration references

sdk/javascript/ai-agents.mdx

@@ -3,6 +3,23 @@
 description: "Handle CometChat AI Agent events, tool calls, and agent messages in JavaScript apps."
 ---
 
+<Accordion title="AI Integration Quick Reference">
+
+| Field | Value |
+| --- | --- |
+| Package | `@cometchat/chat-sdk-javascript` |
+| Import | `import { CometChat } from "@cometchat/chat-sdk-javascript";` |
+| Key methods | `CometChat.addAIAssistantListener(listenerId, ...)` · `CometChat.removeAIAssistantListener(listenerId)` · `CometChat.addMessageListener(listenerId, ...)` · `CometChat.removeMessageListener(listenerId)` |
+| Key classes | `CometChat.AIAssistantBaseEvent` · `CometChat.AIAssistantMessage` · `CometChat.AIToolResultMessage` · `CometChat.AIToolArgumentMessage` · `CometChat.AIToolCall` |
+| Primary output | Real-time run events are delivered as `CometChat.AIAssistantBaseEvent` objects to the `onAIAssistantEventReceived` callback; after the run completes, persisted `AIAssistantMessage` / `AIToolResultMessage` / `AIToolArgumentMessage` objects arrive on the `MessageListener` |
+| Listeners registered | `AIAssistantListener` via `addAIAssistantListener` / `removeAIAssistantListener` (callback `onAIAssistantEventReceived`); `CometChat.MessageListener` via `addMessageListener` / `removeMessageListener` (callbacks `onAIAssistantMessageReceived`, `onAIToolResultReceived`, `onAIToolArgumentsReceived`) |
+| Prerequisites | SDK initialized via [`CometChat.init()`](/sdk/javascript/setup-sdk) and a logged-in user via [`CometChat.login()`](/sdk/javascript/authentication-overview) |
+| Constraints | Agents only respond to text messages. `Run Start` and `Run Finished` events are always emitted; Tool Call events only appear when tools are invoked |
+| Related | [AI Moderation](/sdk/javascript/ai-moderation) · [AI User Copilot](/sdk/javascript/ai-user-copilot-overview) · [Card Messages](/sdk/javascript/card-messages) · [Send a Message](/sdk/javascript/send-message) |
+| Full reference | [`AIAssistantBaseEvent`](/sdk/reference/messages#aiassistantbaseevent) · [`AIAssistantMessage`](/sdk/reference/messages#aiassistantmessage) · [`AIToolResultMessage`](/sdk/reference/messages#aitoolresultmessage) · [`AIToolArgumentMessage`](/sdk/reference/messages#aitoolargumentmessage) |
+
+</Accordion>
+
 ## AI Agents Overview
 
 AI Agents enable intelligent, automated interactions within your application. They can process user messages, trigger tools, and respond with contextually relevant information. For a broader introduction, see the [AI Agents section](/ai-agents).
@@ -14,7 +31,7 @@
 When a user sends a text message to an Agent:
 
 1. The platform starts a run and streams real-time events via `AIAssistantListener`
 2. After the run completes, persisted Agentic Messages arrive via `MessageListener`
 
 ### Real-time Events
 
@@ -67,7 +84,7 @@
 <Tabs>
 <Tab title="TypeScript">
 ```ts
         const listnerId: string = "unique_listener_id";
 
         // Adding the AIAssistantListener
         CometChat.addAIAssistantListener(listnerId, {
@@ -84,7 +101,7 @@
 
 <Tab title="JavaScript">
 ```ts
         const listnerId: string = "unique_listener_id";
 
         // Adding the AIAssistantListener
         CometChat.addAIAssistantListener(listnerId, {
@@ -113,7 +130,7 @@
 - Text Message End: The agent reply is complete.
 - Run Finished: The run is finalized; persisted messages will follow.
 
 ### Agentic Messages
 
 After the run completes, these messages arrive via `MessageListener`:
 
@@ -123,7 +140,7 @@
 | `AIToolResultMessage`   | The final output of a tool call |
 | `AIToolArgumentMessage` | The arguments passed to a tool  |
 
 Each message type extends [`BaseMessage`](/sdk/reference/messages#basemessage) and has a typed data accessor:
 
 | Message Type            | Data Getter                    | Data Properties                                               |
 | ----------------------- | ------------------------------ | ------------------------------------------------------------- |
@@ -198,7 +215,7 @@
 
 <Warning>
   Always remove listeners when they're no longer needed (e.g., on component
   unmount or page navigation). Failing to remove listeners can cause memory
   leaks and duplicate event handling.
 </Warning>
 
@@ -208,7 +225,7 @@
 
 <CardGroup cols={2}>
   <Card title="AI Chatbots" icon="robot" href="https://assets.cometchat.io/legacy-docs/ai-chatbots/ai-bots/overview.html">
     Set up AI-powered chatbots for automated conversations
   </Card>
   <Card
     title="AI Moderation"

sdk/javascript/all-real-time-listeners.mdx

@@ -3,6 +3,23 @@
 description: "Use CometChat real-time listeners for user presence, groups, messages, calls, AI assistant events, and ongoing calls."
 ---
 
+<Accordion title="AI Integration Quick Reference">
+
+| Field | Value |
+| --- | --- |
+| Package | `@cometchat/chat-sdk-javascript` |
+| Import | `import { CometChat } from "@cometchat/chat-sdk-javascript";` |
+| Key methods | `CometChat.addUserListener(id, new CometChat.UserListener({...}))` · `CometChat.addGroupListener(id, new CometChat.GroupListener({...}))` · `CometChat.addMessageListener(id, new CometChat.MessageListener({...}))` · `CometChat.addCallListener(id, new CometChat.CallListener({...}))` · `CometChat.addAIAssistantListener(id, new CometChat.AIAssistantListener({...}))` · `CometChat.addLoginListener(id, new CometChat.LoginListener({...}))` · `CometChat.addConnectionListener(id, new CometChat.ConnectionListener({...}))` |
+| Key classes | `CometChat.UserListener` · `CometChat.GroupListener` · `CometChat.MessageListener` · `CometChat.CallListener` · `CometChat.AIAssistantListener` · `CometChat.LoginListener` · `CometChat.ConnectionListener` |
+| Primary output | Each listener fires typed callbacks — e.g. `onUserOnline(user)`, `onGroupMemberJoined(action, user, group)`, `onTextMessageReceived(message)`, `onMessagesDelivered(receipt)`, `onIncomingCallReceived(call)`, `onAIAssistantEventReceived(event)`, `loginSuccess(user)`, `onConnected()` |
+| Listeners registered | `UserListener` (`onUserOnline` · `onUserOffline`); `GroupListener` (`onGroupMemberJoined` · `onGroupMemberLeft` · `onGroupMemberKicked` · `onGroupMemberBanned` · `onGroupMemberUnbanned` · `onGroupMemberScopeChanged` · `onMemberAddedToGroup`); `MessageListener` (`onTextMessageReceived` · `onMediaMessageReceived` · `onCustomMessageReceived` · `onTypingStarted` · `onTypingEnded` · `onMessagesDelivered` · `onMessagesRead` · `onMessageEdited` · `onMessageDeleted` · `onMessageReactionAdded` · `onCardMessageReceived` · `onAIAssistantMessageReceived`); `CallListener` (`onIncomingCallReceived` · `onOutgoingCallAccepted` · `onOutgoingCallRejected` · `onIncomingCallCancelled` · `onCallEndedMessageReceived`); `AIAssistantListener` (`onAIAssistantEventReceived`); `LoginListener` (`loginSuccess` · `loginFailure` · `logoutSuccess` · `logoutFailure`); `ConnectionListener` (`onConnected` · `inConnecting` · `onDisconnected` · `onFeatureThrottled`). Remove each with the matching `remove*Listener(id)` |
+| Prerequisites | SDK initialized via [`CometChat.init()`](/sdk/javascript/setup-sdk) and a logged-in user via [`CometChat.login()`](/sdk/javascript/authentication-overview) |
+| Constraints | Listener IDs must be unique per listener; use the same ID to remove it. Always call the matching `remove*Listener(id)` on unmount to avoid memory leaks and duplicate handling. `OngoingCallListener` belongs to the **Calls SDK** (not the Chat SDK) and is used via `CometChatCalls.addCallEventListener()` |
+| Related | [Receive a Message](/sdk/javascript/receive-message) · [Delivery & Read Receipts](/sdk/javascript/delivery-read-receipts) · [Typing Indicators](/sdk/javascript/typing-indicators) · [User Presence](/sdk/javascript/user-presence) |
+| Full reference | [`User`](/sdk/reference/entities#user) · [`MessageReceipt`](/sdk/reference/auxiliary#messagereceipt) · [`AIAssistantBaseEvent`](/sdk/reference/messages#aiassistantbaseevent) · [`CometChatException`](/sdk/reference/auxiliary#cometchatexception) |
+
+</Accordion>
+
 CometChat provides 4 listeners viz.
 
 1. [User Listener](/sdk/javascript/all-real-time-listeners#user-listener)
@@ -34,9 +51,9 @@
       /* when someuser/friend comes online, user will be received here */
       console.log("On User Online:", { onlineUser });
     },
     onUserOffline: (offlineUser: CometChat.User) => {
       /* when someuser/friend went offline, user will be received here */
       console.log("On User Offline:", { offlineUser });
     },
   })
 );
@@ -91,13 +108,13 @@
 
 | Method                                                                                                                                                  | Information                                                                                                                                    |
 | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
 | **onGroupMemberJoined(action: CometChat.Action, joinedUser: CometChat.User, joinedGroup: CometChat.Group)**                                             | This method is triggered when a user joins any group. All the members present in the group will receive this event.                            |
 | **onGroupMemberLeft(action: CometChat.Action, leftUser: CometChat.User, leftGroup: CometChat.Group)**                                                   | This method is triggered when a user who was a member of any group leaves the group. All the members of the group receive this event.          |
 | **onGroupMemberKicked(action: CometChat.Action, kickedUser: CometChat.User, kickedBy: CometChat.User, kickedFrom: CometChat.Group)**                    | This method is triggered when a user is kicked from a group. All the members including the user receive this event                             |
 | **onGroupMemberBanned(action: CometChat.Action, bannedUser: CometChat.User, bannedBy: CometChat.User, bannedFrom: CometChat.Group)**                    | This method is triggered when a user is banned from a group. All the members including the user receive this event                             |
 | **onGroupMemberUnbanned(action: CometChat.Action, unbannedUser: CometChat.User, unbannedBy: CometChat.User, unbannedFrom: CometChat.Group)**            | This method is triggered when a user is banned from a group. All the members of the group receive this event.                                  |
 | **onGroupMemberScopeChanged(action: CometChat.Action, changedUser: CometChat.User, newScope: string, oldScope: string, changedGroup: CometChat.Group)** | This method is triggered when the scope of any Group Member has been changed. All the members that are a part of that group receive this event |
 | **onMemberAddedToGroup(action: CometChat.Action, userAdded: CometChat.User, addedBy: CometChat.User, addedTo: CometChat.Group)**                        | This method is triggered when a user is added to any group. All the members including the user himself receive this event.                     |
 
 To add the `GroupListener`:
 
@@ -116,76 +133,76 @@
     },
     onGroupMemberLeft: (
       message: CometChat.Action,
       leftUser: CometChat.User,
       leftGroup: CometChat.Group
     ) => {
       console.log("onGroupMemberLeft", { message, leftUser, leftGroup });
     },
     onGroupMemberKicked: (
       message: CometChat.Action,
       kickedUser: CometChat.User,
       kickedBy: CometChat.User,
       kickedFrom: CometChat.Group
     ) => {
       console.log("onGroupMemberKicked", {
         message,
         kickedUser,
         kickedBy,
         kickedFrom,
       });
     },
     onGroupMemberBanned: (
       message: CometChat.Action,
       bannedUser: CometChat.User,
       bannedBy: CometChat.User,
       bannedFrom: CometChat.Group
     ) => {
       console.log("onGroupMemberBanned", {
         message,
         bannedUser,
         bannedBy,
         bannedFrom,
       });
     },
     onGroupMemberUnbanned: (
       message: CometChat.Action,
       unbannedUser: CometChat.User,
       unbannedBy: CometChat.User,
       unbannedFrom: CometChat.Group
     ) => {
       console.log("onGroupMemberUnbanned", {
         message,
         unbannedUser,
         unbannedBy,
         unbannedFrom,
       });
     },
     onGroupMemberScopeChanged: (
       message: CometChat.Action,
       changedUser: CometChat.User,
       newScope: string,
       oldScope: string,
       changedGroup: CometChat.Group
     ) => {
       console.log("onGroupMemberScopeChanged", {
         message,
         changedUser,
         newScope,
         oldScope,
         changedGroup,
       });
     },
     onMemberAddedToGroup: (
       message: CometChat.Action,
       userAdded: CometChat.User,
       addedby: CometChat.User,
       addedTo: CometChat.Group
     ) => {
       console.log("onMemberAddedToGroup", {
         message,
         userAdded,
         addedby,
         addedTo,
       });
     },
   })
@@ -323,23 +340,23 @@
     onTextMessageReceived: (textMessage: CometChat.TextMessage) => {
       console.log("Text message received successfully", textMessage);
     },
     onMediaMessageReceived: (mediaMessage: CometChat.MediaMessage) => {
       console.log("Media message received successfully", mediaMessage);
     },
     onCustomMessageReceived: (customMessage: CometChat.CustomMessage) => {
       console.log("Custom message received successfully", customMessage);
     },
     onMessagesDelivered: (messageReceipt: CometChat.MessageReceipt) => {
       console.log("Message Delivered", messageReceipt);
     },
     onMessagesRead: (messageReceipt: CometChat.MessageReceipt) => {
       console.log("Message Read", messageReceipt);
     },
     onTypingStarted: (typingIndicator: CometChat.TypingIndicator) => {
       console.log("Typing Started", typingIndicator);
     },
     onTypingEnded: (typingIndicator: CometChat.TypingIndicator) => {
       console.log("Typing Ended", typingIndicator);
     },
     onMessageDeleted: (message: CometChat.BaseMessage) => {
       console.log("Message Delted", message);
@@ -360,10 +377,10 @@
       console.log("Message Moderated", message);
     },
     onMessagesDeliveredToAll: (messageReceipt: CometChat.MessageReceipt) => {
       console.log("Message Delivered to All", messageReceipt);
     },
     onMessagesReadByAll: (messageReceipt: CometChat.MessageReceipt) => {
       console.log("Message Read by All", messageReceipt);
     },
     onAIAssistantMessageReceived: (message: CometChat.AIAssistantMessage) => {
       console.log("AI Assistant message received", message);
@@ -695,7 +712,7 @@
 | `event.user.name` | `string` | Name of the user who started recording |
 | `event.user.uid`  | `string` | UID of the user who started recording  |
 
 **`onRecordingStopped()`**, **`onCallEnded()`**, **`onSessionTimeout()`**, **`onCallEndButtonPressed()`**, **`onScreenShareStarted()`**, **`onScreenShareStopped()`** — receive no arguments.
 
 <Tabs>
 <Tab title="TypeScript">
@@ -707,7 +724,7 @@
 console.log("User joined:", user);
 },
 onUserLeft: (user: any) => {
 console.log("User left:", user);
 },
 onCallEnded: () => {
 console.log("Call ended");
@@ -773,15 +790,15 @@
 const listenerID: string = "UNIQUE_LISTENER_ID";
 CometChat.addLoginListener(
   listenerID,
   new CometChat.LoginListener({
     loginSuccess: (user: CometChat.User) => {
       console.log("LoginListener :: loginSuccess", user);
     },
     loginFailure: (error: CometChat.CometChatException) => {
       console.log("LoginListener :: loginFailure", error);
     },
     logoutSuccess: () => {
       console.log("LoginListener :: logoutSuccess");
     },
     logoutFailure: (error: CometChat.CometChatException) => {
       console.log("LoginListener :: logoutFailure", error);
@@ -836,10 +853,10 @@
 ```typescript
 const listenerID: string = "UNIQUE_LISTENER_ID";
 CometChat.addConnectionListener(
   listenerID,
   new CometChat.ConnectionListener({
     onConnected: () => {
       console.log("ConnectionListener :: connected");
     },
     inConnecting: () => {
       console.log("ConnectionListener :: connecting");
@@ -858,10 +875,10 @@
 ```javascript
 const listenerID = "UNIQUE_LISTENER_ID";
 CometChat.addConnectionListener(
   listenerID,
   new CometChat.ConnectionListener({
     onConnected: () => {
       console.log("ConnectionListener :: connected");
     },
     inConnecting: () => {
       console.log("ConnectionListener :: connecting");

sdk/javascript/authentication-overview.mdx

@@ -4,6 +4,23 @@
 description: "Create users and authenticate them securely with the CometChat JavaScript SDK."
 ---
 
+<Accordion title="AI Integration Quick Reference">
+
+| Field | Value |
+| --- | --- |
+| Package | `@cometchat/chat-sdk-javascript` |
+| Import | `import { CometChat } from "@cometchat/chat-sdk-javascript";` |
+| Key methods | `CometChat.login(UID, authKey)` · `CometChat.login(authToken)` · `CometChat.getLoggedinUser()` · `CometChat.logout()` · `CometChat.createUser(user, authKey)` |
+| Key classes | `CometChat.User` · `CometChat.CometChatException` |
+| Primary output | `login()` resolves to a `CometChat.User`; `getLoggedinUser()` resolves to the `CometChat.User` or `null` when no session exists; `logout()` resolves on success; all reject with `CometChat.CometChatException` |
+| Listeners registered | `CometChat.LoginListener` via `CometChat.addLoginListener(listenerID, ...)` / `CometChat.removeLoginListener(listenerID)`; key callbacks `loginSuccess`, `loginFailure`, `logoutSuccess`, `logoutFailure` |
+| Prerequisites | SDK initialized via [`CometChat.init()`](/sdk/javascript/setup-sdk), and the user must already exist (create via the [Dashboard](https://app.cometchat.com) or the [Create User API](https://api-explorer.cometchat.com/reference/creates-user)) |
+| Constraints | Auth Key login and `createUser()` with an Auth Key are for development/testing only — never ship an Auth Key in client code. For production, generate an [Auth Token](https://api-explorer.cometchat.com/reference/create-authtoken) server-side and pass it to `login(authToken)` |
+| Related | [User Management](/sdk/javascript/user-management) · [Connection Status](/sdk/javascript/connection-status) · [All Real-Time Listeners](/sdk/javascript/all-real-time-listeners) · [Send a Message](/sdk/javascript/send-message) |
+| Full reference | [`User`](/sdk/reference/entities#user) · [`CometChatException`](/sdk/reference/auxiliary#cometchatexception) |
+
+</Accordion>
+
 ## Create User
 
 Before you log in a user, you must add the user to CometChat.
@@ -13,7 +30,7 @@
 
 <Note>
 
 We have setup 5 users for testing having UIDs: `cometchat-uid-1`, `cometchat-uid-2`, `cometchat-uid-3`, `cometchat-uid-4` and `cometchat-uid-5`.
 
 </Note>
 
@@ -34,8 +51,8 @@
 <Tabs>
 <Tab title="TypeScript">
 ```typescript
 let authKey: string = "AUTH_KEY";
 let uid: string = "user1";
 let name: string = "Kevin";
 
 let user: CometChat.User = new CometChat.User(uid);
@@ -108,12 +125,12 @@
 <Tab title="TypeScript">
 ```typescript
 const UID: string = "cometchat-uid-1";
 const authKey: string = "AUTH_KEY";
 
 CometChat.getLoggedinUser().then(
 (user: CometChat.User) => {
 if (!user) {
 CometChat.login(UID, authKey).then(
 (user: CometChat.User) => {
 console.log("Login Successful:", { user });
 },
@@ -212,12 +229,12 @@
 <Tabs>
 <Tab title="TypeScript">
 ```typescript
 const authToken: string = "AUTH_TOKEN";
 
 CometChat.getLoggedinUser().then(
 (user: CometChat.User) => {
 if (!user) {
 CometChat.login(authToken).then(
 (user: CometChat.User) => {
 console.log("Login Successful:", { user });
 },
@@ -292,7 +309,7 @@
 <Tab title="TypeScript">
 ```typescript
 CometChat.logout().then(
   (loggedOut: Object) => {
     console.log("Logout completed successfully");
   },
   (error: CometChat.CometChatException) => {
@@ -354,14 +371,14 @@
         loginSuccess: (user: CometChat.User) => {
             console.log("LoginListener :: loginSuccess", user);
         },
         loginFailure: (error: CometChat.CometChatException) => {
             console.log("LoginListener :: loginFailure", error);
         },
         logoutSuccess: () => {
             console.log("LoginListener :: logoutSuccess");
         },
         logoutFailure: (error: CometChat.CometChatException) => {
             console.log("LoginListener :: logoutFailure", error);
         }
     })
 );
@@ -400,7 +417,7 @@
 
 <Warning>
   Always remove login listeners when they're no longer needed (e.g., on
   component unmount or page navigation). Failing to remove listeners can cause
   memory leaks and duplicate event handling.
 </Warning>
 

sdk/javascript/block-users.mdx

@@ -3,14 +3,31 @@
 description: "Block and unblock users in chat apps with the CometChat JavaScript SDK."
 ---
 
+<Accordion title="AI Integration Quick Reference">
+
+| Field | Value |
+| --- | --- |
+| Package | `@cometchat/chat-sdk-javascript` |
+| Import | `import { CometChat } from "@cometchat/chat-sdk-javascript";` |
+| Key methods | `CometChat.blockUsers(usersList)` · `CometChat.unblockUsers(usersList)` · `blockedUsersRequest.fetchNext()` (build via `BlockedUsersRequestBuilder`) |
+| Request builder | `CometChat.BlockedUsersRequestBuilder` — configure with `.setLimit()` · `.setSearchKeyword()` · `.setDirection()`; then `.build()` → `.fetchNext()` |
+| Key classes | `CometChat.User` (access via `getBlockedByMe()`, `getHasBlockedMe()`); direction via `CometChat.BlockedUsersRequest.directions.BLOCKED_BY_ME` / `.HAS_BLOCKED_ME` / `.BOTH` |
+| Primary output | `blockUsers()` / `unblockUsers()` resolve to a `{ uid: "success" \| "fail" }` object (each UID processed independently); `fetchNext()` resolves to `Promise<CometChat.User[]>`; all reject with `CometChat.CometChatException` |
+| Prerequisites | SDK initialized via [`CometChat.init()`](/sdk/javascript/setup-sdk) and a logged-in user via [`CometChat.login()`](/sdk/javascript/authentication-overview) |
+| Constraints | `setDirection()` default is `BOTH`; `blockUsers()` / `unblockUsers()` take an array of UIDs |
+| Related | [Retrieve Users](/sdk/javascript/retrieve-users) · [User Presence](/sdk/javascript/user-presence) · [User Management](/sdk/javascript/user-management) · [Flag a Message](/sdk/javascript/flag-message) |
+| Full reference | [`User`](/sdk/reference/entities#user) |
+
+</Accordion>
+
 ## Block Users
 
 Block users to prevent all communication with them. Use `blockUsers()` with an array of UIDs.
 
 <Tabs>
 <Tab title="TypeScript">
 ```typescript
 const usersList: String[] = ["UID1", "UID2", "UID3"];
 
 CometChat.blockUsers(usersList).then(
 (list: Object) => {
@@ -42,7 +59,7 @@
 const usersList = ["UID1", "UID2", "UID3"];
 
 try {
   const list = await CometChat.blockUsers(usersList);
   console.log("users list blocked", { list });
 } catch (error) {
   console.log("Blocking user fails with error", error);
@@ -53,11 +70,11 @@
 
 </Tabs>
 
 Returns an object with UIDs as keys and `"success"` or `"fail"` as values. Each [`User`](/sdk/reference/entities#user) in the request is processed independently.
 
 ## Unblock Users
 
 Unblock previously blocked users using `unblockUsers()` with an array of UIDs.
 
 <Tabs>
 <Tab title="TypeScript">
@@ -105,7 +122,7 @@
 
 </Tabs>
 
 Returns an object with UIDs as keys and `"success"` or `"fail"` as values. Each [`User`](/sdk/reference/entities#user) in the request is processed independently.
 
 ## Get List of Blocked Users
 
@@ -146,7 +163,7 @@
 <Tab title="TypeScript">
 ```typescript
 let limit: number = 30;
 let searchKeyword: string = "super";
 let blockedUsersRequest: CometChat.BlockedUsersRequest = new CometChat.BlockedUsersRequestBuilder()
   .setLimit(limit)
   .setSearchKeyword(searchKeyword)
@@ -158,7 +175,7 @@
 <Tab title="JavaScript">
 ```javascript
 let limit = 30;
 let searchKeyword = "super";
 let blockedUsersRequest = new CometChat.BlockedUsersRequestBuilder()
                   				.setLimit(limit)
                   				.setSearchKeyword(searchKeyword)
@@ -232,7 +249,7 @@
   .build();
 
 blockedUsersRequest.fetchNext().then(
 (userList: CometChat.User[]) => {
 console.log("Blocked user list received:", userList);
 }, (error: CometChat.CometChatException) => {
 console.log("Blocked user list fetching failed with error:", error);

sdk/javascript/campaigns.mdx

@@ -3,6 +3,23 @@
 description: "Fetch notification feed items, listen for real-time delivery, mark items as read/delivered, report engagement, and track push notifications using the CometChat JavaScript SDK."
 ---
 
+<Accordion title="AI Integration Quick Reference">
+
+| Field | Value |
+| --- | --- |
+| Package | `@cometchat/chat-sdk-javascript` |
+| Import | `import { CometChat } from "@cometchat/chat-sdk-javascript";` |
+| Key methods | `CometChat.markFeedItemAsRead(feedItem)` · `CometChat.markFeedItemAsDelivered(feedItem)` · `CometChat.markFeedItemsAsDelivered(feedItems)` · `CometChat.reportFeedEngagement(feedItem, interactionString)` · `CometChat.getNotificationFeedUnreadCount()` · `CometChat.getNotificationFeedItem(id)` · `CometChat.markPushNotificationDelivered(pushNotification)` · `CometChat.markPushNotificationClicked(pushNotification)` |
+| Request builder | `new CometChat.NotificationFeedRequestBuilder().setLimit(limit).setReadState(state).setCategory(category).setChannelId(channelId).setTags(tags).build()` → `.fetchNext()` · also `NotificationCategoriesRequestBuilder().setLimit(limit).build()` → `.fetchNext()` |
+| Key classes | `CometChat.NotificationFeedItem` · `CometChat.NotificationCategory` · `CometChat.PushNotification` · `CometChat.CardMessage` |
+| Primary output | `NotificationFeedRequest.fetchNext()` resolves to `CometChat.NotificationFeedItem[]` (empty array when exhausted); `getNotificationFeedUnreadCount()` resolves to `{ count: number }`; mark/report methods resolve on success; all reject with `CometChat.CometChatException` |
+| Listeners registered | Notification feed listener via `CometChat.addNotificationFeedListener("feedListener", ...)` / `CometChat.removeNotificationFeedListener("feedListener")`; key callback `onFeedItemReceived`. Card chat messages arrive on `CometChat.MessageListener`'s `onCardMessageReceived` callback |
+| Prerequisites | SDK initialized via [`CometChat.init()`](/sdk/javascript/setup-sdk) and a logged-in user via [`CometChat.login()`](/sdk/javascript/authentication-overview); channels, categories, templates, and campaigns configured in the [Dashboard](/campaigns#setup-flow). Render cards with `@cometchat/cards-react` |
+| Constraints | Card messages are **receive-only** — created and sent exclusively via the Platform (REST) API or Dashboard Bubble Builder; the SDK exposes the raw Card Schema JSON via `getCard()`. The Cards library is a pure renderer and does not execute card actions — your app must handle action callbacks |
+| Related | [Card Messages](/sdk/javascript/card-messages) · [Receive a Message](/sdk/javascript/receive-message) · [All Real-Time Listeners](/sdk/javascript/all-real-time-listeners) · [Send a Message](/sdk/javascript/send-message) |
+
+</Accordion>
+
 CometChat Campaigns lets you deliver targeted, rich notifications to users via an in-app notification feed. Each notification is a **Card Schema JSON** — a structured layout rendered natively by the CometChat Cards library.
 
 The SDK provides APIs to fetch feed items, listen for real-time delivery, mark items as read/delivered, report engagement, and retrieve unread counts.
@@ -73,12 +90,12 @@
             "light": "transparent",
             "dark": "transparent"
           },
           "textColor": {
             "light": "#6C5CE7",
             "dark": "#6C5CE7"
           },
           "size": 40,
           "fontSize": 13,
           "borderRadius": 6,
           "padding": {
             "top": 0,
@@ -96,14 +113,14 @@
       "id": "col_98fed9bd-1a95-4cee-aa81-84a9016e41f2"
     }
   ],
   "fallbackText": "",
   "style": {
     "background": {
       "light": "#E8E8E8",
       "dark": "#E8E8E8"
     },
     "borderRadius": 16,
     "borderColor": {
       "light": "#DFE6E9",
       "dark": "#DFE6E9"
     },
@@ -214,7 +231,7 @@
 <Tabs>
 <Tab title="JavaScript">
 ```javascript
 const categoriesRequest = new CometChat.NotificationCategoriesRequestBuilder()
   .setLimit(50)
   .build();
 
@@ -450,7 +467,7 @@
 <Tabs>
 <Tab title="JavaScript">
 ```javascript
 const pushNotification = new CometChat.PushNotification(pushPayloadJson);
 
 CometChat.markPushNotificationDelivered(pushNotification).then(
   () => { /* Success */ },
@@ -548,10 +565,10 @@
             window.open(action.url, "_blank");
             break;
           case "chatWithUser":
             // Navigate to chat with action.uid
             break;
           case "chatWithGroup":
             // Navigate to group chat with action.guid
             break;
         }
       }}
@@ -572,15 +589,15 @@
 
 | Action Type | Parameters | Description |
 | --- | --- | --- |
 | `openUrl` | url, openIn | Open a URL in browser or webview |
 | `chatWithUser` | uid | Navigate to 1:1 chat |
 | `chatWithGroup` | guid | Navigate to group chat |
 | `sendMessage` | text, receiverUid, receiverGuid | Send a text message |
 | `copyToClipboard` | value | Copy text to clipboard |
 | `downloadFile` | url, filename | Download a file |
 | `initiateCall` | callType (audio/video), uid, guid | Start a call |
 | `apiCall` | url, method, headers, body | Make an HTTP request |
 | `customCallback` | callbackId, payload | App-specific logic |
 
 ---
 

sdk/javascript/card-messages.mdx

@@ -3,7 +3,24 @@
 description: "Receive and render rich card messages with the CometChat JavaScript SDK."
 ---
 
+<Accordion title="AI Integration Quick Reference">
+
+| Field | Value |
+| --- | --- |
+| Package | `@cometchat/chat-sdk-javascript` |
+| Import | `import { CometChat } from "@cometchat/chat-sdk-javascript";` |
+| Key methods | `CometChat.addMessageListener(listenerID, new CometChat.MessageListener({...}))` · `CometChat.addAIAssistantListener(listenerID, new CometChat.AIAssistantListener({...}))` · `cardMessage.getCard()` · `message.getElements()` · `element.getType()` / `element.getData()` |
+| Key classes | `CometChat.CardMessage` · `CometChat.MessageListener` · `CometChat.AIAssistantMessage` · `CometChat.AIAssistantElement` · `CometChat.AIAssistantListener` · `CometChat.AIAssistantBaseEvent` (`AIAssistantCardStartedEvent` · `AIAssistantCardReceivedEvent` · `AIAssistantCardEndedEvent`) |
+| Primary output | Cards are receive-only. Standalone cards arrive as a `CardMessage` (`getCard()` returns the raw Card Schema JSON, or `undefined`); inline cards arrive as elements on an `AIAssistantMessage` (`getElements()` returns `AIAssistantElement[]`); streaming cards arrive as `card_start` / `card` / `card_end` events (`getCard()` on the `card` event) |
+| Listeners registered | `MessageListener` — `onCardMessageReceived(cardMessage: CometChat.CardMessage)` and `onAIAssistantMessageReceived(message: CometChat.AIAssistantMessage)`; `AIAssistantListener` — `onAIAssistantEventReceived(event: CometChat.AIAssistantBaseEvent)` for `card_start` / `card` / `card_end`. Remove with `CometChat.removeMessageListener(id)` / `CometChat.removeAIAssistantListener(id)` |
+| Prerequisites | SDK initialized via [`CometChat.init()`](/sdk/javascript/setup-sdk) and a logged-in user via [`CometChat.login()`](/sdk/javascript/authentication-overview) |
+| Constraints | Card support is **receive-only** — cards cannot be composed or sent from the SDK (they are authored server-side via the Platform REST API or Dashboard). Branch on `getCategory() === "card"` (a card's `getType()` returns `"text"`). The SDK never interprets the card body; rendering is your app's responsibility. Streaming and persisted cards for the same card share a `cardId` — correlate to avoid rendering twice. Always remove listeners on unmount |
+| Related | [Receive a Message](/sdk/javascript/receive-message) · [AI Agents](/sdk/javascript/ai-agents) · [All Real Time Listeners](/sdk/javascript/all-real-time-listeners) · [Send a Message](/sdk/javascript/send-message) |
+| Full reference | [`CardMessage`](/sdk/reference/messages#cardmessage) · [`AIAssistantMessage`](/sdk/reference/messages#aiassistantmessage) · [`AIAssistantElement`](/sdk/reference/messages#aiassistantelement) · [`AIAssistantBaseEvent`](/sdk/reference/messages#aiassistantbaseevent) |
+
+</Accordion>
+
 Card messages let your app display rich, structured content — such as product cards, confirmations, or AI-generated summaries — inside a conversation. In the JavaScript SDK, card support is **receive-only**: the SDK deserializes incoming cards and hands you their raw payload through typed accessors, and your app is responsible for turning that payload into UI.
 
 The body of a card is **Card Schema JSON** — the same structured layout used by [Campaigns notification feeds](/sdk/javascript/campaigns). Cards are authored server-side (they cannot be composed or sent from the SDK) via the [Platform (REST) API](/rest-api/messages/send-message) or the **Dashboard Bubble Builder**, and delivered to clients like any other message.
 
@@ -12,7 +29,7 @@
 </Tip>
 
 <Note>
   The SDK never interprets the body of a card — every accessor returns the raw
   Card Schema JSON exactly as it was sent. Drawing it is your app's
   responsibility: pass that JSON to the **CometChat Cards** renderer for your
   framework.
@@ -37,14 +54,14 @@
 
 ## Standalone Card Messages
 
 A standalone card arrives as a message whose category is `card` (its type is `text`). The SDK deserializes it into a [`CardMessage`](/sdk/reference/messages#cardmessage) and delivers it through the **`onCardMessageReceived`** callback of the [`MessageListener`](/sdk/javascript/all-real-time-listeners#message-listener).
 
 <Note>
   Branch on `getCategory() === "card"` to identify a card message —
   `getType()` returns `"text"`, the same as a plain text message.
 </Note>
 
 `CardMessage` extends [`BaseMessage`](/sdk/reference/messages#basemessage), so all the usual metadata (`getSender()`, `getReceiver()`, `getSentAt()`, `getConversationId()`, …) is available. It adds these card-specific accessors:
 
 | Getter              | Return Type          | Description                                                                        |
 | ------------------- | -------------------- | --------------------------------------------------------------------------------- |
@@ -292,7 +309,7 @@
         // Pass cardPayload to your card renderer.
         break;
       }
       case "card_end":
         console.log("Card generation ended:", event.getCardId());
         break;
       default:

sdk/javascript/delivery-read-receipts.mdx

@@ -3,6 +3,23 @@
 description: "Mark messages as delivered or read and handle receipts with the CometChat JavaScript SDK."
 ---
 
+<Accordion title="AI Integration Quick Reference">
+
+| Field | Value |
+| --- | --- |
+| Package | `@cometchat/chat-sdk-javascript` |
+| Import | `import { CometChat } from "@cometchat/chat-sdk-javascript";` |
+| Key methods | `CometChat.markAsDelivered(message)` · `CometChat.markAsRead(message)` · `CometChat.markConversationAsDelivered(conversationWith, conversationType)` · `CometChat.markConversationAsRead(conversationWith, conversationType)` · `CometChat.markAsUnread(message)` · `CometChat.getMessageReceipts(messageId)` |
+| Key classes | `CometChat.MessageListener` · `CometChat.MessageReceipt` · `CometChat.BaseMessage` |
+| Primary output | `markAsDelivered()` / `markAsRead()` are fire-and-forget (they resolve but do **not** return a `MessageReceipt`); `markConversationAsDelivered()` / `markConversationAsRead()` resolve with a `string`; `markAsUnread()` resolves with a `string`; `getMessageReceipts()` resolves to `Promise<CometChat.MessageReceipt[]>`; all reject with `CometChat.CometChatException` |
+| Listeners registered | `MessageListener` via `CometChat.addMessageListener(listenerID, ...)` / `CometChat.removeMessageListener(listenerID)` — receipt callbacks: `onMessagesDelivered`, `onMessagesRead`, `onMessagesDeliveredToAll` (groups), `onMessagesReadByAll` (groups), each receiving a `CometChat.MessageReceipt` |
+| Prerequisites | SDK initialized via [`CometChat.init()`](/sdk/javascript/setup-sdk) and a logged-in user via [`CometChat.login()`](/sdk/javascript/authentication-overview) |
+| Constraints | `onMessagesDeliveredToAll`, `onMessagesReadByAll`, group `deliveredAt` / `readAt`, and `markAsUnread()` require the **Enhanced Messaging Status** feature. Always remove listeners on unmount to avoid memory leaks |
+| Related | [Receive a Message](/sdk/javascript/receive-message) · [Typing Indicators](/sdk/javascript/typing-indicators) · [Retrieve Conversations](/sdk/javascript/retrieve-conversations) · [All Real Time Listeners](/sdk/javascript/all-real-time-listeners) |
+| Full reference | [`MessageReceipt`](/sdk/reference/auxiliary#messagereceipt) · [`User`](/sdk/reference/entities#user) · [`BaseMessage`](/sdk/reference/messages#basemessage) |
+
+</Accordion>
+
 ## Mark Messages as Delivered
 
 _In other words, as a recipient, how do I inform the sender that I've received a message?_
@@ -93,12 +110,12 @@
 <Tabs>
 <Tab title="TypeScript (User)">
 ```typescript
 let messageId: string = "MESSAGE_ID";
 let receiverId: string = "MESSAGE_SENDER_UID";
 let receiverType: string = "user";
 let senderId: string = "MESSAGE_SENDER_UID";
 
 CometChat.markAsDelivered(messageId, receiverId, receiverType, senderId).then(
 () => {
 console.log("Marked as delivered successfully");
 },
@@ -131,12 +148,12 @@
 
 <Tab title="TypeScript (Group)">
 ```typescript
 let messageId: string = "MESSAGE_ID";
 let receiverId: string = "GROUP_GUID";
 let receiverType: string = "group";
 let senderId: string = "MESSAGE_SENDER_UID";
 
 CometChat.markAsDelivered(messageId, receiverId, receiverType, senderId).then(
 () => {
 console.log("Marked as delivered successfully");
 },
@@ -178,8 +195,8 @@
 <Tabs>
 <Tab title="TypeScript (User)">
 ```typescript
 let conversationWith: string = "USER_UID";
 let conversationType: string = "user";
 
 CometChat.markConversationAsDelivered(conversationWith, conversationType).then(
 (response: string) => {
@@ -212,8 +229,8 @@
 
 <Tab title="TypeScript (Group)">
 ```typescript
 let conversationWith: string = "GROUP_GUID";
 let conversationType: string = "group";
 
 CometChat.markConversationAsDelivered(conversationWith, conversationType).then(
 (response: string) => {
@@ -284,12 +301,12 @@
 <Tabs>
 <Tab title="TypeScript (User)">
 ```typescript
 let messageId: string = "MESSAGE_ID";
 let receiverId: string = "MESSAGE_SENDER_UID";
 let receiverType: string = "user";
 let senderId: string = "MESSAGE_SENDER_UID";
 
 CometChat.markAsRead(messageId, receiverId, receiverType, senderId).then(
 () => {
 console.log("Marked as read successfully");
 },
@@ -322,12 +339,12 @@
 
 <Tab title="TypeScript (Group)">
 ```typescript
 let messageId: string = "MESSAGE_ID";
 let receiverId: string = "GROUP_GUID";
 let receiverType: string = "group";
 let senderId: string = "MESSAGE_SENDER_UID";
 
 CometChat.markAsRead(messageId, receiverId, receiverType, senderId).then(
 () => {
 console.log("Marked as read successfully");
 },
@@ -367,8 +384,8 @@
 <Tabs>
 <Tab title="TypeScript (User)">
 ```typescript
 let conversationWith: string = "USER_UID";
 let conversationType: string = "user";
 
 CometChat.markConversationAsRead(conversationWith, conversationType).then(
 (response: string) => {
@@ -401,8 +418,8 @@
 
 <Tab title="TypeScript (Group)">
 ```typescript
 let conversationWith: string = "GROUP_GUID";
 let conversationType: string = "group";
 
 CometChat.markConversationAsRead(conversationWith, conversationType).then(
 (response: string) => {
@@ -454,10 +471,10 @@
 CometChat.addMessageListener(
 listenerID,
 new CometChat.MessageListener({
 onMessagesDelivered: (messageReceipt: CometChat.MessageReceipt) => {
 console.log("Message delivered:", messageReceipt);
 },
 onMessagesRead: (messageReceipt: CometChat.MessageReceipt) => {
 console.log("Message read:", messageReceipt);
 },
 onMessagesDeliveredToAll: (messageReceipt: CometChat.MessageReceipt) => {
@@ -508,8 +525,8 @@
 | `receiverId`   | Id of the receiver whose conversation has been marked as read.                                                                            |
 | `receiverType` | type of the receiver (user/group)                                                                                                         |
 | `receiptType`  | Type of the receipt (read/delivered)                                                                                                      |
 | `deliveredAt`  | The timestamp of the time when the message was delivered. This will only be present if the receiptType is delivered.                      |
 | `readAt`       | The timestamp of the time when the message was read. This will only be present when the receiptType is read.                              |
 
 The `markAsDelivered()` and `markAsRead()` methods are fire-and-forget — they do not return a [`MessageReceipt`](/sdk/reference/auxiliary#messagereceipt) object. Use the listener callbacks above to receive delivery and read confirmations.
 
@@ -542,13 +559,13 @@
 
 | Field        | Getter              | Return Type                            | Description                    |
 | ------------ | ------------------- | -------------------------------------- | ------------------------------ |
 | messageId    | `getMessageId()`    | `string`                               | ID of the message              |
 | sender       | `getSender()`       | [`User`](/sdk/reference/entities#user) | User who triggered the receipt |
 | receiverId   | `getReceiverId()`   | `string`                               | ID of the receiver             |
 | receiverType | `getReceiverType()` | `string`                               | `"user"` or `"group"`          |
 | receiptType  | `getReceiptType()`  | `string`                               | `"delivery"` or `"read"`       |
 | deliveredAt  | `getDeliveredAt()`  | `number`                               | Timestamp when delivered       |
 | readAt       | `getReadAt()`       | `number`                               | Timestamp when read            |
 
 ## Get Receipt History
 
@@ -557,7 +574,7 @@
 <Tabs>
 <Tab title="TypeScript">
 ```typescript
 let messageId: number = 123;
 
 CometChat.getMessageReceipts(messageId).then(
 (receipts: CometChat.MessageReceipt[]) => {