Add Documentation For CometChat Campaigns

.gitignore

@@ -20,3 +20,4 @@ __pycache__/
 /docs-comparison-tool
 /node_modules
 /legacy-docs
+AGENTS.md

ai-agents/ag-ui-actions.mdx

@@ -1,9 +1,9 @@
 ---
 title: "AI Agent Actions"
 sidebarTitle: "Actions"
-description: "Explore the various actions you can perform with your AI agent in CometChat."
+description: "Explore CometChat AI agent actions for frontend events, user interactions, and AG-UI compatible workflows."
 ---
 
 import Actions from '/snippets/ai-agents/actions.mdx';
 
-<Actions />
+<Actions />

ai-agents/ag-ui-tools.mdx

@@ -1,9 +1,9 @@
 ---
 title: "AI Agent Tools"
 sidebarTitle: "Tools"
-description: "Explore the various tools you can use with your AI agent in CometChat."
+description: "Explore CometChat AI agent tools for external APIs, frontend actions, and AG-UI compatible integrations."
 ---
 
 import Tools from '/snippets/ai-agents/tools.mdx';
 
-<Tools />
+<Tools />

ai-agents/agent-builder/overview.mdx

@@ -15,6 +15,10 @@ description: "Create, configure, and launch AI agents directly inside CometChat.
 
 Agent Builder provides the capability to create, configure, and customize AI agents directly within CometChat. It supports selecting models, integrating ready-to-use tools, APIs, and MCPs, and deploying agents without relying on any external management or orchestration platforms.
 
+<Note>
+**Where AI Agents respond.** Agents created in Agent Builder respond only in one-on-one conversations between an end user and the agent user. They do not respond when added to a group, even as a member or owner. If your use case requires an agent in group conversations, share your requirements on [feedback.cometchat.com](https://feedback.cometchat.com).
+</Note>
+
 ## Getting Started
 
 ### How to create an agent – step-by-step guide

ai-agents/cometchat-ag-ui-express.mdx

@@ -1,7 +1,7 @@
 ---
 title: "AG-UI Express.js Implementation"
 sidebarTitle: "Express.js"
-description: "Implementation guide for building an AG-UI agent with Express.js."
+description: "Build an AG-UI compatible CometChat AI agent with Express.js, TypeScript, OpenAI, streaming events, and tools."
 ---
 
 ### Prerequisites

ai-agents/cometchat-ag-ui-nestjs.mdx

@@ -1,7 +1,7 @@
 ---
 title: "AG-UI NestJS Implementation"
 sidebarTitle: "NestJS"
-description: "Implementation guide for building an AG-UI agent with NestJS."
+description: "Build an AG-UI compatible CometChat AI agent with NestJS, OpenAI, streaming events, and tool execution."
 ---
 
 ### Prerequisites

ai-agents/mastra-actions.mdx

@@ -1,9 +1,9 @@
 ---
 title: "AI Agent Actions"
 sidebarTitle: "Actions"
-description: "Explore the various actions you can perform with your AI agent in CometChat."
+description: "Explore CometChat Mastra AI agent actions for frontend events, user interactions, and custom workflows."
 ---
 
 import Actions from '/snippets/ai-agents/actions.mdx';
 
-<Actions />
+<Actions />

ai-agents/mastra-backend-tools-agent.mdx

@@ -65,7 +65,7 @@ Core files and folders for the Backend Tools Agent (browse source on GitHub):
 - Server
   - [src/mastra/index.ts](https://github.com/cometchat/ai-agent-mastra-examples/blob/main/mastra-backend-tools-agent/src/mastra/index.ts)
 - Workflows
-  - [src/mastra/workflows/index.ts](https://github.com/cometchat/ai-agent-mastra-examples/blob/main/mastra-backend-tools-agent/src/mastra/workflows/index.ts)
+  - [src/mastra/workflows/orchestrator-workflow.ts](https://github.com/cometchat/ai-agent-mastra-examples/blob/main/mastra-orchestrator-agent/src/mastra/workflows/orchestrator-workflow.ts)
 
 ***
 
@@ -191,4 +191,4 @@ curl -X POST http://localhost:4111/api/agents/deals/generate \
 
 * Add more backend tools (e.g., get-order, create-ticket) and guard with RBAC.  
 * Stream responses or add partial updates for long-running actions.  
-* Instrument and log tool invocations for tuning and observability.  
+* Instrument and log tool invocations for tuning and observability.  

ai-agents/mastra-frontend-actions-agent.mdx

@@ -50,9 +50,6 @@ Give your chats superpowers: let an agent trigger visual effects and UI actions
  Frontend sample
   - [widget/index.html](https://github.com/cometchat/ai-agent-mastra-examples/blob/main/mastra-frontend-actions-agent/widget/index.html)
 - This keeps sensitive work on the server and visual effects on the client.
- Workflows
-  - [src/mastra/workflows/index.ts](https://github.com/cometchat/ai-agent-mastra-examples/blob/main/mastra-frontend-actions-agent/src/mastra/workflows/index.ts)
-
 Key components (source-linked below): the agent, the `confetti` tool, server entry, and a sample widget page.
 
 ***
@@ -76,9 +73,6 @@ Key components (source-linked below): the agent, the `confetti` tool, server ent
   - [src/mastra/index.ts](https://github.com/cometchat/ai-agent-mastra-examples/blob/main/mastra-frontend-actions-agent/src/mastra/index.ts)
  - Frontend sample
   - [widget/index.html](https://github.com/cometchat/ai-agent-mastra-examples/blob/main/mastra-frontend-actions-agent/widget/index.html)
- - Workflows
-  - [src/mastra/workflows/index.ts](https://github.com/cometchat/ai-agent-mastra-examples/blob/main/mastra-frontend-actions-agent/src/mastra/workflows/index.ts)
-
 ***
 
 ## Step 1 - Create the Agent

ai-agents/mastra-tools.mdx

@@ -1,9 +1,9 @@
 ---
 title: "AI Agent Tools"
 sidebarTitle: "Tools"
-description: "Explore the various tools you can use with your AI agent in CometChat."
+description: "Explore CometChat Mastra AI agent tools for external APIs, frontend actions, and connected workflows."
 ---
 
 import Tools from '/snippets/ai-agents/tools.mdx';
 
-<Tools />
+<Tools />

articles/properties-and-constraints.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Properties and Constraints"
-description: "Properties and Constraints — CometChat documentation."
+description: "Review CometChat properties and constraints for API keys, users, groups, metadata, tags, limits, and supported values."
 ---
 
 This page lists the properties and constraints applicable to various CometChat systems.

assets/consent.js

@@ -0,0 +1,192 @@
+/* ------------------------------------------------------------------ */
+/* Consent gating for analytics                                       */
+/*                                                                    */
+/* Strict mode: zero requests to any analytics provider until the     */
+/* user clicks Accept All on the cookie banner. GTM (and everything   */
+/* it loads — GA4 G-M5KZ2NFCYL, HubSpot tracking, etc.) is NOT loaded */
+/* on page load; it is loaded inline only after an explicit Accept.   */
+/*                                                                    */
+/* Pairs with the removal of `integrations.gtm` from docs.json so     */
+/* this file is the sole loader of GTM-59ZJRV2 on docs.cometchat.com. */
+/* ------------------------------------------------------------------ */
+(function initConsentGate() {
+    try {
+        if (window.__ccConsentGateInitialized__) return;
+        window.__ccConsentGateInitialized__ = true;
+    } catch (_) { return; }
+
+    var GTM_ID = 'GTM-59ZJRV2';
+    var STORAGE_KEY = 'cc_consent';
+    var PRIVACY_URL = 'https://www.cometchat.com/privacy-policy';
+
+    window.dataLayer = window.dataLayer || [];
+    function gtag() { window.dataLayer.push(arguments); }
+
+    // 1) Default-deny. Sets Google Consent Mode v2 defaults so that
+    //    any downstream Google tag respects the user's not-yet-given
+    //    consent. This is belt-and-suspenders — GTM is also not loaded
+    //    at all until Accept, so in practice no Google script ever sees
+    //    a denied state, it simply never runs.
+    gtag('consent', 'default', {
+        ad_storage:         'denied',
+        ad_user_data:       'denied',
+        ad_personalization: 'denied',
+        analytics_storage:  'denied',
+        wait_for_update:    500
+    });
+
+    function applyConsent(granted) {
+        var v = granted ? 'granted' : 'denied';
+        gtag('consent', 'update', {
+            ad_storage:         v,
+            ad_user_data:       v,
+            ad_personalization: v,
+            analytics_storage:  v
+        });
+        try { window.localStorage.setItem(STORAGE_KEY, v); } catch (_) {}
+        try { document.documentElement.setAttribute('data-cc-consent', v); } catch (_) {}
+    }
+
+    var gtmLoaded = false;
+    function loadGTM() {
+        if (gtmLoaded) return;
+        gtmLoaded = true;
+        (function (w, d, s, l, i) {
+            w[l] = w[l] || [];
+            w[l].push({ 'gtm.start': new Date().getTime(), event: 'gtm.js' });
+            var f = d.getElementsByTagName(s)[0];
+            var j = d.createElement(s);
+            var dl = l !== 'dataLayer' ? '&l=' + l : '';
+            j.async = true;
+            j.src = 'https://www.googletagmanager.com/gtm.js?id=' + i + dl;
+            if (f && f.parentNode) {
+                f.parentNode.insertBefore(j, f);
+            } else {
+                (d.head || d.documentElement).appendChild(j);
+            }
+        })(window, document, 'script', 'dataLayer', GTM_ID);
+    }
+
+    function injectStyles() {
+        if (document.getElementById('cc-consent-styles')) return;
+        var style = document.createElement('style');
+        style.id = 'cc-consent-styles';
+        // Once the user has chosen, suppress HubSpot's own banner so it
+        // doesn't appear after GTM loads and HubSpot's tracking initializes.
+        style.textContent =
+            '#cc-consent-banner{position:fixed;bottom:0;left:0;right:0;z-index:2147483646;' +
+            'background:#fff;color:#111827;border-top:1px solid rgba(0,0,0,0.08);' +
+            'box-shadow:0 -4px 20px rgba(0,0,0,0.06);' +
+            'padding:24px clamp(16px,5vw,64px);' +
+            'font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;' +
+            'font-size:14px;line-height:1.5;display:flex;flex-direction:column;gap:16px}' +
+            '@media(min-width:880px){#cc-consent-banner{flex-direction:row;align-items:center;' +
+            'justify-content:space-between;gap:32px}}' +
+            '#cc-consent-banner__copy{flex:1;min-width:0}' +
+            '#cc-consent-banner__copy p{margin:0 0 8px 0;color:inherit}' +
+            '#cc-consent-banner__copy p:last-child{margin-bottom:0}' +
+            '#cc-consent-banner__copy a{color:inherit;text-decoration:underline}' +
+            '#cc-consent-banner__actions{display:flex;gap:8px;flex-shrink:0;' +
+            'align-self:stretch;justify-content:flex-end}' +
+            '@media(min-width:880px){#cc-consent-banner__actions{align-self:auto}}' +
+            '#cc-consent-banner button{font:inherit;cursor:pointer;padding:10px 20px;' +
+            'border-radius:8px;border:1px solid transparent;transition:background .15s ease;' +
+            'white-space:nowrap}' +
+            '#cc-consent-banner__decline{background:#fff;color:#111827;border-color:#d1d5db}' +
+            '#cc-consent-banner__decline:hover{background:#f9fafb}' +
+            '#cc-consent-banner__accept{background:#111827;color:#fff}' +
+            '#cc-consent-banner__accept:hover{background:#1f2937}' +
+            '@media(prefers-color-scheme:dark){' +
+            '#cc-consent-banner{background:#0b0d10;color:#f3f4f6;' +
+            'border-top-color:rgba(255,255,255,0.08)}' +
+            '#cc-consent-banner__decline{background:transparent;color:#f3f4f6;' +
+            'border-color:rgba(255,255,255,0.18)}' +
+            '#cc-consent-banner__decline:hover{background:rgba(255,255,255,0.06)}' +
+            '#cc-consent-banner__accept{background:#f3f4f6;color:#0b0d10}' +
+            '#cc-consent-banner__accept:hover{background:#e5e7eb}}' +
+            'html[data-cc-consent] #hs-banner-parent,' +
+            'html[data-cc-consent] [data-hs-banner-host],' +
+            'html[data-cc-consent] .hs-banner-wrapper,' +
+            'html[data-cc-consent] #hs-eu-cookie-confirmation{display:none!important}';
+        (document.head || document.documentElement).appendChild(style);
+    }
+
+    function renderBanner() {
+        if (document.getElementById('cc-consent-banner')) return;
+        if (!document.body) return;
+
+        injectStyles();
+
+        var banner = document.createElement('div');
+        banner.id = 'cc-consent-banner';
+        banner.setAttribute('role', 'dialog');
+        banner.setAttribute('aria-live', 'polite');
+        banner.setAttribute('aria-label', 'Cookie consent');
+
+        var copy = document.createElement('div');
+        copy.id = 'cc-consent-banner__copy';
+        var p1 = document.createElement('p');
+        p1.appendChild(document.createTextNode(
+            'This website stores cookies on your computer. These cookies are used to collect ' +
+            'information about how you interact with our website and allow us to remember you. ' +
+            'We use this information to improve and customize your browsing experience and for ' +
+            'analytics and metrics about our visitors both on this website and other media. ' +
+            'To find out more about the cookies we use, see our '
+        ));
+        var link = document.createElement('a');
+        link.href = PRIVACY_URL;
+        link.target = '_blank';
+        link.rel = 'noopener';
+        link.textContent = 'Privacy Policy';
+        p1.appendChild(link);
+        p1.appendChild(document.createTextNode('.'));
+        var p2 = document.createElement('p');
+        p2.textContent =
+            'If you decline, your information won’t be tracked when you visit this website. ' +
+            'A single cookie will be used in your browser to remember your preference not to be tracked.';
+        copy.appendChild(p1);
+        copy.appendChild(p2);
+
+        var actions = document.createElement('div');
+        actions.id = 'cc-consent-banner__actions';
+        var decline = document.createElement('button');
+        decline.id = 'cc-consent-banner__decline';
+        decline.type = 'button';
+        decline.textContent = 'Decline All';
+        var accept = document.createElement('button');
+        accept.id = 'cc-consent-banner__accept';
+        accept.type = 'button';
+        accept.textContent = 'Accept All';
+        actions.appendChild(decline);
+        actions.appendChild(accept);
+
+        banner.appendChild(copy);
+        banner.appendChild(actions);
+        document.body.appendChild(banner);
+
+        accept.addEventListener('click', function () {
+            applyConsent(true);
+            loadGTM();
+            banner.remove();
+        });
+        decline.addEventListener('click', function () {
+            applyConsent(false);
+            banner.remove();
+        });
+    }
+
+    // 2) Apply saved choice, or show banner.
+    var saved = null;
+    try { saved = window.localStorage.getItem(STORAGE_KEY); } catch (_) {}
+
+    if (saved === 'granted') {
+        applyConsent(true);
+        loadGTM();
+    } else if (saved === 'denied') {
+        applyConsent(false);
+    } else if (document.body) {
+        renderBanner();
+    } else {
+        document.addEventListener('DOMContentLoaded', renderBanner);
+    }
+})();

calls/android/actions.mdx

@@ -1,8 +1,8 @@
 ---
 title: "Actions"
 sidebarTitle: "Actions"
-sdk_version: "5.x (Beta)"
-description: "CometChat Calling SDK v5 - Beta Release - Actions for Android"
+sdk_version: "5.x"
+description: "Use CometChat Calls SDK v5 actions on Android to control calls, manage audio/video state, share screens, and handle in-call behavior."
 ---
 
 Use call actions to create your own custom controls or trigger call functionality dynamically based on your use case. All actions are called on the `CallSession` singleton instance during an active call session.

calls/android/audio-modes.mdx

@@ -1,8 +1,8 @@
 ---
 title: "Audio Modes"
 sidebarTitle: "Audio Modes"
-sdk_version: "5.x (Beta)"
-description: "CometChat Calling SDK v5 - Beta Release - Audio Modes for Android"
+sdk_version: "5.x"
+description: "Configure CometChat Calls SDK v5 audio modes on Android for speakers, earpiece, Bluetooth, routing, and call audio behavior."
 ---
 
 Control audio output routing during calls. Switch between speaker, earpiece, Bluetooth, and wired headphones based on user preference or device availability.

calls/android/authentication.mdx

@@ -1,8 +1,8 @@
 ---
 title: "Authentication"
 sidebarTitle: "Authentication"
-sdk_version: "5.x (Beta)"
-description: "CometChat Calling SDK v5 - Beta Release - Authentication for Android"
+sdk_version: "5.x"
+description: "Configure authentication for CometChat Calls SDK v5 on Android with app credentials, logged-in users, and secure call access."
 ---
 
 Before users can make or receive calls, they must be authenticated with the CometChat Calls SDK. This guide covers the login and logout methods.

calls/android/background-handling.mdx

@@ -1,8 +1,8 @@
 ---
 title: "Background Handling"
 sidebarTitle: "Background Handling"
-sdk_version: "5.x (Beta)"
-description: "CometChat Calling SDK v5 - Beta Release - Background Handling for Android"
+sdk_version: "5.x"
+description: "Handle background calling with CometChat Calls SDK v5 on Android for app lifecycle, call continuity, and notifications."
 ---
 
 Keep calls alive when users navigate away from your app. Background handling ensures the call continues running when users press the home button, switch to another app, or lock their device.

calls/android/call-layouts.mdx

@@ -1,8 +1,8 @@
 ---
 title: "Call Layouts"
 sidebarTitle: "Call Layouts"
-sdk_version: "5.x (Beta)"
-description: "CometChat Calling SDK v5 - Beta Release - Call Layouts for Android"
+sdk_version: "5.x"
+description: "Customize CometChat Calls SDK v5 call layouts on Android with tile, spotlight, sidebar views, layout changes, and layout events."
 ---
 
 Choose how participants are displayed during a call. The SDK provides multiple layout options to suit different use cases like team meetings, presentations, or one-on-one calls.

calls/android/call-logs.mdx

@@ -1,8 +1,8 @@
 ---
 title: "Call Logs"
 sidebarTitle: "Call Logs"
-sdk_version: "5.x (Beta)"
-description: "CometChat Calling SDK v5 - Beta Release - Call Logs for Android"
+sdk_version: "5.x"
+description: "Display CometChat Calls SDK v5 call logs on Android with call history, participants, call type, duration, and status details."
 ---
 
 Retrieve call history for your application. Call logs provide detailed information about past calls including duration, participants, recordings, and status.

calls/android/custom-control-panel.mdx

@@ -1,8 +1,8 @@
 ---
 title: "Custom Control Panel"
 sidebarTitle: "Custom Control Panel"
-sdk_version: "5.x (Beta)"
-description: "CometChat Calling SDK v5 - Beta Release - Custom Control Panel for Android"
+sdk_version: "5.x"
+description: "Customize the CometChat Calls SDK v5 control panel on Android with call buttons, actions, layout, and user controls."
 ---
 
 Build a fully customized control panel for your call interface by hiding the default controls and implementing your own UI with call actions. This guide walks you through creating a custom control panel with essential call controls.