@cometchat/skills 4.4.1 → 5.0.0

package/contracts.sdk-android-v5.json

@@ -0,0 +1,15 @@
+{
+  "generatedFrom": "cometchat.com/docs — sdk/android/v5 (setup, authentication-overview, send-message, receive-messages, real-time-listeners, additional-message-filtering) verified 2026-08-20; symbols cross-checked against test-suite/catalogs/sdk-android-v5.json (curated from the INSTALLED com.cometchat:chat-sdk-android:5.0.5 AAR). Android adaptation of the web-react contracts.json 'sdk-chat-surface' entry — same capability NAMES where the principle is shared, Android/Kotlin recipes.",
+  "family": "android-sdk",
+  "major": "v5",
+  "contracts": [
+    {
+      "for": "sdk-chat-surface",
+      "kind": "feature",
+      "consumption": "sdk",
+      "min_capabilities": ["init-before-anything", "init-then-login-ordering", "credentials-via-settings-file", "prod-auth-token-guidance", "send-message", "receive-via-listener", "listener-register-with-id", "listener-remove-on-teardown", "sdk-error-handling", "pagination-via-request-builder", "production-ready-design-system", "sized-shell-no-overflow", "conversations-users-groups-lists", "list-search", "delete-conversation", "message-actions-working", "thread-panel", "user-group-detail-with-actions", "optimistic-ui-mutations", "loading-empty-error-states"],
+      "docs_topic": "https://www.cometchat.com/docs/sdk/android/v5/overview",
+      "notes": "HEADLESS (build-your-own-UI) FLOOR for the Android Chat SDK v5 skill — the SDK analogue of core-chat-surface. Capabilities are behaviours the emitted code MUST include, mapped to the Android SDK (FETCH exact signatures from the sdk/android/v5 pages — bake the map, fetch the manual): init-before-anything = CometChat.initFromSettings(context, CallbackListener<String>) resolves (onSuccess) BEFORE any other SDK call — it reads the GITIGNORED app/src/main/assets/cometchat-settings.json (appId, region, credentials.authKey, chatSDK section) and persists integrationSource=\"ai-agent\" for telemetry (AUDIT-084; signature verified vs the installed 5.0.5 AAR — javap: initFromSettings(Context, CallbackListener<String>)). Do NOT use the classic CometChat.init(context, appId, AppSettings) as the default; it loses attribution. init-then-login-ordering = CometChat.login(uid, authKey/authToken, CallbackListener) runs AFTER init and BEFORE send/fetch/listeners; skip login if getLoggedInUser() != null (re-login of the same user throws). credentials-via-settings-file = appId/region/authKey live in the gitignored assets/cometchat-settings.json read by initFromSettings — never hardcoded in source; build-time extras go local.properties → buildConfigField → BuildConfig. prod-auth-token-guidance = server-minted auth token login for prod; Auth Key dev-only. send-message = build TextMessage(receiverId, text, receiverType) + CometChat.sendMessage(msg, CallbackListener<TextMessage>). receive-via-listener = a registered CometChat.MessageListener delivers incoming messages (onTextMessageReceived/onMediaMessageReceived), not polling. listener-register-with-id = CometChat.addMessageListener(UNIQUE_ID, listener). listener-remove-on-teardown = CometChat.removeMessageListener(UNIQUE_ID) in the lifecycle teardown (onDestroy / DisposableEffect onDispose / ViewModel onCleared) — register AND remove; a leaked listener FAILS this contract. sdk-error-handling = every CallbackListener implements onError(CometChatException) and surfaces e.message — never an empty catch. pagination-via-request-builder = MessagesRequest.MessagesRequestBuilder().setLimit(n).build() + fetchPrevious/fetchNext (same builder pattern for Users/Groups/Conversations/GroupMembers requests), not one unbounded call. BECAUSE THE SDK HAS NO UI, the emitted app must ALSO be production-ready UI, deterministically: production-ready-design-system = reuse the app's existing theme (Material3/Compose theme or XML styles) or establish a small token-based one — never ad-hoc one-off styling. sized-shell-no-overflow = the chat screen fills the viewport (match_parent / fillMaxSize), the message list scrolls internally (RecyclerView / LazyColumn with reverseLayout as appropriate), insets + IME handled (adjustResize / imePadding). conversations-users-groups-lists + list-search = all three lists, each searchable via the request builder's search-keyword setter — TWO real traps to emit correctly: (1) casing differs per builder — UsersRequestBuilder.setSearchKeyword / ConversationsRequestBuilder.setSearchKeyword are lowercase but GroupsRequestBuilder.setSearchKeyWord has a CAPITAL W (SDK inconsistency; setSearchKeyword on GroupsRequest = Unresolved reference); (2) Conversations search (and setUnread) is PLAN-GATED — requires the 'Conversation & Advanced Search' feature (Advanced/Custom plan + a dashboard toggle) and OFF-PLAN silently returns the FULL unfiltered list with no error, so gate the conversations-search UI behind an 'Advanced plan' hint or a labelled local filter — never present an unfiltered list as a search result. Users/Groups search are NOT plan-gated. presence-in-header = the header/users presence (onUserOnline/onUserOffline via addUserListener) only fires when the settings asset opts in with chatSDK.presenceSubscription (ALL_USERS/FRIENDS/ROLES; absent ⇒ no realtime presence — getUser().status is a snapshot only). delete-conversation = CometChat.deleteConversation per row. message-actions-working = reply-in-thread / react / edit / delete each wired to the SDK AND reflected in the UI (own-message gating for edit/delete via sender uid). thread-panel = setParentMessageId(...) scoped MessagesRequest + a thread composer. user-group-detail-with-actions = user detail (blockUsers/unblockUsers) + group detail (addMembersToGroup / kickGroupMember / banGroupMember / updateGroupMemberScope / leaveGroup), scope-gated. optimistic-ui-mutations = send/edit/delete/react update the UI immediately (temp 'sending' state, e.g. via the muid) then reconcile in onSuccess/onError (roll back + surface the error). loading-empty-error-states = loading/empty/error on every surface, never blank. This is the full default for a generic 'build chat with the Android SDK' prompt; bare bubbles UNDER-DELIVER. All symbols named here exist in the sdk-android-v5 catalog (curated+members, AUDIT-021 class)."
+    }
+  ]
+}

package/contracts.web-calls-v5.json

@@ -0,0 +1,45 @@
+{
+  "generatedFrom": "@cometchat/calls-sdk-javascript@5.0.5 (.d.ts) + /calls/javascript docs (v5, preview)",
+  "family": "web-calls-v5",
+  "major": "v5",
+  "capabilityDetectors": {},
+  "contracts": [
+    {
+      "for": "calls-session-surface",
+      "kind": "feature",
+      "consumption": "sdk",
+      "min_capabilities": [
+        "init-before-anything",
+        "init-then-login-ordering",
+        "prod-auth-token-guidance",
+        "generate-token-before-join",
+        "join-session-into-sized-container",
+        "listener-registered-before-join",
+        "listener-unsub-on-teardown",
+        "leave-session-on-teardown",
+        "in-call-actions-wired",
+        "sdk-error-handling",
+        "https-getusermedia-note"
+      ],
+      "docs_topic": "/calls/javascript/join-session",
+      "notes": "HEADLESS meet-style FLOOR for the Calls SDK v5 skill (cometchat-js-v5-sdk) — the calling analogue of sdk-chat-surface. Capabilities are SDK behaviours the emitted code MUST include, mapped to @cometchat/calls-sdk-javascript@5 (FETCH exact signatures from /calls/javascript via references/docs-map.md — bake the map, fetch the manual): init-before-anything = the emit inits via the ai-agent/telemetry-attributed CometChatCalls.initFromSettings(settings) (persists integrationSource='ai-agent', parallels the chat sdk-chat-surface floor, RULES §5 / AUDIT-084/175) — passed the settings object INLINE (the shape is baked in the skill's references/docs-map.md; initFromSettings is intentionally undocumented/ai-agent-only, @nodoc, per DOCS-BACKLOG F4/C1) — and it resolves BEFORE any other calls SDK call. The publicly-documented CometChatCalls.init({appId,region}) is the FALLBACK ONLY (a non-skills/doc-following context). init-then-login-ordering = CometChatCalls.login(uid, authKey) | loginWithAuthToken(token) runs AFTER init and BEFORE generateToken/joinSession/listeners. prod-auth-token-guidance = loginWithAuthToken / server-side token; Auth Key dev-only. generate-token-before-join = const {token} = await CometChatCalls.generateToken(sessionId) precedes joinSession. join-session-into-sized-container = CometChatCalls.joinSession(token, sessionSettings, containerEl) where containerEl has REAL dimensions (zero-height renders the call invisibly). listener-registered-before-join = CometChatCalls.addEventListener(name, cb) registered BEFORE joinSession. listener-unsub-on-teardown = every addEventListener return value (an unsubscribe fn) is called on teardown; a leaked listener FAILS. leave-session-on-teardown = CometChatCalls.leaveSession() on unmount. in-call-actions-wired = mute/unmute + video pause/resume + leave are wired to real controls (muteAudio/unmuteAudio/pauseVideo/resumeVideo/leaveSession), never dead buttons. sdk-error-handling = joinSession's Result.error path and awaited-call rejections are handled. https-getusermedia-note = the emit/README states HTTPS-or-localhost is required for getUserMedia. Least-code = use the SDK's own methods (HOW); never drop teardown or the error path (WHAT). Meet-style needs ONLY the Calls SDK — no Chat SDK. Every CometChatCalls.* symbol named here is in the web-calls-v5 catalog."
+    },
+    {
+      "for": "calls-oneonone-ringing",
+      "kind": "feature",
+      "consumption": "sdk",
+      "min_capabilities": [
+        "chat-sdk-init-login",
+        "initiate-call-signaling",
+        "incoming-call-listener-with-id",
+        "accept-or-reject-call",
+        "generate-token-from-accepted-session",
+        "join-session-after-accept",
+        "call-listener-remove-on-teardown",
+        "sdk-error-handling"
+      ],
+      "docs_topic": "/calls/javascript/overview",
+      "notes": "1:1 RINGING FLOOR — adds the Chat SDK signaling layer on top of calls-session-surface. Ringing = a specific user is called, gets an incoming prompt, accepts/rejects; the Chat SDK (@cometchat/chat-sdk-javascript@4) does the signaling and the Calls SDK carries media (FETCH the Chat-SDK calling signatures via references/docs-map.md § '1:1 RINGING' — do NOT bake them): chat-sdk-init-login = the Chat SDK is init'd + logged in (shared session with the Calls SDK). initiate-call-signaling = CometChat.initiateCall(new CometChat.Call(receiverId, receiverType, callType)) starts the ring. incoming-call-listener-with-id = CometChat.addCallListener(UNIQUE_ID, new CometChat.CallListener({ onIncomingCallReceived, onOutgoingCallAccepted, onOutgoingCallRejected, onIncomingCallCancelled })). accept-or-reject-call = CometChat.acceptCall(sessionId) / CometChat.rejectCall(sessionId, status). generate-token-from-accepted-session = CometChatCalls.generateToken(acceptedCall.getSessionId()). join-session-after-accept = CometChatCalls.joinSession(token, sessionSettings, containerEl) once accepted. call-listener-remove-on-teardown = CometChat.removeCallListener(UNIQUE_ID) on teardown. sdk-error-handling = every awaited call handles the CometChatException path. This contract INHERITS the calls-session-surface floor for the media half (container sizing, event-listener teardown, leaveSession)."
+    }
+  ]
+}

package/features.android-calls-v5.json

@@ -0,0 +1,246 @@
+{
+  "_doc": "Headless capability enumeration for the Android Calls SDK v5 skill (cometchat-android-v5-calls-sdk) — standalone voice/video FROM SCRATCH, no UI Kit. Native fork of features.web-calls-v5.json: the deliverable is a calls-session-surface (meet-style join into a RelativeLayout) and a calls-oneonone-ringing flow (Chat SDK v5 signaling + Calls SDK media). surface=headless gives every feature the sdk-surface predicate profile (done = G0 ∧ G5 ∧ G6); families.json routes the family through the NATIVE ladder (gate-emit → native-fence gradle build vs the pinned calls-sdk-android 5.0.4 → CallsSmokeTests on a real emulator: init→login→attach→generateToken→joinSession→session-active→leaveSession). Symbols verified against test-suite/catalogs/android-calls-v5.json (curated+members from the INSTALLED 5.0.4 AAR via javap, cross-checked with the live /calls/android docs, 2026-09-07). Android CANNOT initiate screen share (receive-only) and has no virtual-background page — neither is claimed here.",
+  "family": "android-calls-v5",
+  "major": "v5",
+  "surface": "headless",
+  "pack": "cometchat-android-v5-calls-sdk",
+  "features": [
+    {
+      "id": "calls-session-meet",
+      "name": "Meet-style call session (join a room by session id)",
+      "category": "core",
+      "enablement": "auto",
+      "docs_topic": "/calls/android/join-session",
+      "sdk_symbols": [
+        "initFromSettings",
+        "init",
+        "login",
+        "generateToken",
+        "joinSession",
+        "SessionSettingsBuilder",
+        "CallSession",
+        "leaveSession",
+        "addSessionStatusListener"
+      ],
+      "notes": "The primary headless surface: everyone who joins the same sessionId lands in the same call. Calls SDK ONLY. joinSession renders the SDK's full call UI (controls included) into a sized RelativeLayout. Gated by the calls-session-surface contract; G6 = the device round-trip (session active + SDK view rendered)."
+    },
+    {
+      "id": "calls-oneonone-ringing",
+      "name": "One-on-one ringing call (Chat SDK signaling + Calls SDK media)",
+      "category": "core",
+      "enablement": "auto",
+      "docs_topic": "/calls/android/ringing",
+      "sdk_symbols": [
+        "initiateCall",
+        "addCallListener",
+        "CallListener",
+        "acceptCall",
+        "rejectCall",
+        "endCall",
+        "removeCallListener",
+        "generateToken",
+        "joinSession",
+        "leaveSession"
+      ],
+      "notes": "Ring a specific user (incoming prompt, accept/reject) via the Chat SDK's initiateCall/CallListener/acceptCall, then generateToken(call.sessionId) + joinSession for media; CometChat.endCall on hang-up so the peer's onCallEndedMessageReceived fires. Requires com.cometchat:chat-sdk-android ^5 (init + login) alongside the Calls SDK. Needs TWO devices/users to prove live — G6 grades the mounted surface (smoke.roundtrip=surface)."
+    },
+    {
+      "id": "call-events",
+      "name": "Call events (session / participant / media / button / layout listeners)",
+      "category": "core",
+      "enablement": "auto",
+      "docs_topic": "/calls/android/events",
+      "sdk_symbols": [
+        "CallSession",
+        "addSessionStatusListener",
+        "addParticipantEventListener",
+        "addMediaEventsListener",
+        "addButtonClickListener",
+        "addLayoutListener",
+        "SessionStatusListener",
+        "ParticipantEventListener",
+        "MediaEventsListener",
+        "ButtonClickListener",
+        "LayoutListener"
+      ],
+      "notes": "Every listener is LIFECYCLE-BOUND: CallSession.getInstance().add*Listener(lifecycleOwner, listener) is removed with the owner. Register from the joinSession onSuccess (or right after). Exact callback names verified vs the 5.0.4 AAR — the docs list onScreenShareStarted/Stopped on MediaEventsListener, which does NOT exist (screen-share events are on ParticipantEventListener)."
+    },
+    {
+      "id": "call-layouts",
+      "name": "Call layouts (Tile / Sidebar / Spotlight)",
+      "category": "default",
+      "enablement": "auto",
+      "docs_topic": "/calls/android/call-layouts",
+      "sdk_symbols": [
+        "SessionSettingsBuilder",
+        "setLayout",
+        "LayoutType",
+        "addLayoutListener",
+        "hideChangeLayoutButton"
+      ],
+      "notes": "Set the layout at join (SessionSettingsBuilder.setLayout) or live via CallSession.setLayout(LayoutType.*); LayoutListener.onCallLayoutChanged reflects it. The built-in surface already has a change-layout button — hideChangeLayoutButton(true) only when fixing the layout."
+    },
+    {
+      "id": "call-audio-modes",
+      "name": "Audio output modes (speaker / earpiece / Bluetooth / headphones)",
+      "category": "default",
+      "enablement": "auto",
+      "docs_topic": "/calls/android/audio-modes",
+      "sdk_symbols": [
+        "setAudioMode",
+        "AudioMode",
+        "onAudioModeChanged",
+        "hideAudioModeButton"
+      ],
+      "notes": "SessionSettingsBuilder.setAudioMode at join or CallSession.setAudioMode(AudioMode.*) live; MediaEventsListener.onAudioModeChanged reflects the device switch. Needs MODIFY_AUDIO_SETTINGS + BLUETOOTH permissions (the AAR manifest declares them)."
+    },
+    {
+      "id": "call-recording",
+      "name": "Call recording",
+      "category": "default",
+      "enablement": "dashboard",
+      "docs_topic": "/calls/android/recording",
+      "sdk_symbols": [
+        "startRecording",
+        "stopRecording",
+        "enableAutoStartRecording",
+        "onRecordingStarted",
+        "onRecordingStopped",
+        "onParticipantStartedRecording"
+      ],
+      "notes": "CallSession.startRecording/stopRecording (or auto-start via SessionSettingsBuilder.enableAutoStartRecording); MediaEventsListener.onRecordingStarted/Stopped for your own recording, ParticipantEventListener.onParticipantStartedRecording for others. Recordings surface later on CallLog.getRecordings(). Recording may require enabling on the CometChat Dashboard — flag honestly."
+    },
+    {
+      "id": "call-raise-hand",
+      "name": "Raise hand",
+      "category": "default",
+      "enablement": "auto",
+      "docs_topic": "/calls/android/raise-hand",
+      "sdk_symbols": [
+        "raiseHand",
+        "lowerHand",
+        "onParticipantHandRaised",
+        "onParticipantHandLowered",
+        "getRaisedHandTimestamp",
+        "hideRaiseHandButton"
+      ],
+      "notes": "CallSession.raiseHand/lowerHand; ParticipantEventListener.onParticipantHandRaised/Lowered; Participant.raisedHandTimestamp > 0 lists who has a hand up, in order."
+    },
+    {
+      "id": "call-participant-management",
+      "name": "Participant management (mute / pause video / pin)",
+      "category": "default",
+      "enablement": "auto",
+      "docs_topic": "/calls/android/participant-management",
+      "sdk_symbols": [
+        "muteParticipant",
+        "pauseParticipantVideo",
+        "pinParticipant",
+        "unpinParticipant",
+        "onParticipantListChanged",
+        "onParticipantJoined",
+        "onParticipantLeft",
+        "onDominantSpeakerChanged",
+        "Participant"
+      ],
+      "notes": "Every participant is a moderator by default (role gating is the app's job). Verified vs the AAR: pinParticipant takes TWO String args and unpin is `unpinParticipant()` — the docs show pinParticipant(uid) / unPinParticipant(), which do not compile."
+    },
+    {
+      "id": "call-logs",
+      "name": "Call logs (history + recordings)",
+      "category": "default",
+      "enablement": "auto",
+      "docs_topic": "/calls/android/call-logs",
+      "sdk_symbols": [
+        "CallLogRequest",
+        "CallLogRequestBuilder",
+        "setLimit",
+        "fetchNext",
+        "fetchPrevious",
+        "CallLog",
+        "getRecordings",
+        "Recording"
+      ],
+      "notes": "Paginated history via CallLogRequest.CallLogRequestBuilder().setLimit(n)…build() then fetchNext(CallbackListener<List<CallLog>>) — build ONE request and page it; filters: setSessionType/setCallStatus/setCallDirection/setHasRecording/setUid/setGuid. Needs an initialized + logged-in Calls SDK. G6 = surface (backend data)."
+    },
+    {
+      "id": "call-screen-sharing",
+      "name": "Screen sharing (receive-only on Android)",
+      "category": "default",
+      "enablement": "auto",
+      "docs_topic": "/calls/android/screen-sharing",
+      "sdk_symbols": [
+        "addParticipantEventListener",
+        "onParticipantStartedScreenShare",
+        "onParticipantStoppedScreenShare"
+      ],
+      "notes": "Android CANNOT initiate screen share — only web clients can; Android participants view it (the layout adjusts automatically). The deliverable is the ParticipantEventListener wiring + honest guidance; a skill that emits a 'start screen share' button on Android is wrong."
+    },
+    {
+      "id": "call-idle-timeout",
+      "name": "Idle timeout (auto-end when alone)",
+      "category": "default",
+      "enablement": "auto",
+      "docs_topic": "/calls/android/idle-timeout",
+      "sdk_symbols": [
+        "setIdleTimeoutPeriod",
+        "onSessionTimedOut",
+        "SessionStatusListener"
+      ],
+      "notes": "SessionSettingsBuilder.setIdleTimeoutPeriod(seconds; default 300; 0 disables) + SessionStatusListener.onSessionTimedOut to leave the screen."
+    },
+    {
+      "id": "call-picture-in-picture",
+      "name": "Picture-in-picture (call continues while using other apps)",
+      "category": "default",
+      "enablement": "auto",
+      "docs_topic": "/calls/android/picture-in-picture",
+      "sdk_symbols": [
+        "enablePictureInPictureLayout",
+        "disablePictureInPictureLayout",
+        "onPictureInPictureLayoutEnabled",
+        "onPictureInPictureLayoutDisabled",
+        "LayoutListener"
+      ],
+      "notes": "Android PiP = the Activity enters PiP (supportsPictureInPicture + enterPictureInPictureMode on onUserLeaveHint) and the SDK switches its layout via CallSession.enablePictureInPictureLayout/disablePictureInPictureLayout; LayoutListener.onPictureInPictureLayoutEnabled/Disabled reflect it. Fetch the manifest/Activity wiring from the docs page."
+    },
+    {
+      "id": "call-custom-controls",
+      "name": "Custom control panel (explicit request only — hide the defaults first)",
+      "category": "default",
+      "enablement": "auto",
+      "docs_topic": "/calls/android/custom-control-panel",
+      "sdk_symbols": [
+        "hideControlPanel",
+        "muteAudio",
+        "unmuteAudio",
+        "pauseVideo",
+        "resumeVideo",
+        "switchCamera",
+        "leaveSession",
+        "onAudioMuted",
+        "onAudioUnMuted",
+        "onVideoPaused",
+        "onVideoResumed"
+      ],
+      "notes": "ONLY when the user explicitly asks to replace the built-in controls: SessionSettingsBuilder.hideControlPanel(true) FIRST, then wire your own buttons to CallSession.muteAudio/unmuteAudio/pauseVideo/resumeVideo/switchCamera/leaveSession and keep them in sync via MediaEventsListener. Default builds add NO external buttons (AUDIT-170)."
+    },
+    {
+      "id": "call-background-handling",
+      "name": "Background handling (keep the call alive on Home / app switch)",
+      "category": "default",
+      "enablement": "auto",
+      "docs_topic": "/calls/android/background-handling",
+      "sdk_symbols": [
+        "CometChatOngoingCallService",
+        "launch",
+        "abort",
+        "OngoingNotification",
+        "buildOngoingConferenceNotification",
+        "onSessionJoined",
+        "onSessionLeft"
+      ],
+      "notes": "REQUIRES a manifest declaration in the APP — the 5.0.4 AAR declares NO <service>: <service android:name=\"com.cometchat.calls.services.CometChatOngoingCallService\" android:exported=\"false\" android:foregroundServiceType=\"camera|microphone|mediaPlayback\"/> inside <application>; without it launch() fails silently (ActivityManager: Unable to start service … not found — no exception, no callback; AUDIT-184, DOCS-BACKLOG C12). Then: CometChatOngoingCallService.launch(context) in SessionStatusListener.onSessionJoined and .abort(context) in onSessionLeft/onConnectionClosed/onDestroy — a foreground service + ongoing notification (channel id CometChat_Call_Ongoing_Conference; brand it via OngoingNotification.buildOngoingConferenceNotification(notification)). Needs FOREGROUND_SERVICE_* + POST_NOTIFICATIONS (the AAR declares them; POST_NOTIFICATIONS is a runtime grant on 33+). Distinct from VoIP (receiving calls when killed — /calls/android/voip-calling, push-based, docs-first)."
+    }
+  ]
+}

package/features.android-v6.json

@@ -0,0 +1,65 @@
+{
+  "generatedFrom": "cometchat.com/docs — ui-kit/android v6 (root tree): core-features, extensions, ai-features, call-features, components/*, guide-*, campaigns. Curated 2026-08-20 against the LIVE Android v6 docs (docs repo @ origin/main 3cdd17cd) and the android-v6 catalog built from the INSTALLED kit source (chatuikit-core/-kotlin/-compose 6.0.5). Android-first: entries reflect what the ANDROID docs claim, not a copy of the React list. PENDING (docs branch feature/android-pin_save_thread, not yet on main): pinned-messages, saved-messages, guide-thread-subscription — add pin-message/save-message/thread-subscription entries when that branch merges (tracked in DOCS-BACKLOG.md).",
+  "schemaNotes": "Same schema as features.json (react v7). needs_stitching:true = a default-ON affordance is inert/partial until the host wires a callback + companion screen/navigation (or hides it). needs_dashboard = feature also requires a Dashboard/plan toggle ('VERIFY' = unconfirmed). deprecated:true = live docs are titled '(Legacy)'/'(Deprecated)' or point at legacy-docs — NEVER offer it as an 'add a feature' suggestion (AUDIT-077 rule). ui_components MUST exist in test-suite/catalogs/android-v6.json. COHORTS: one kit, two UI flavors — com.cometchat:chatuikit-kotlin-android (XML Views) and com.cometchat:chatuikit-compose-android (Jetpack Compose); the SAME CometChat* component names exist in both cohorts (docs pages carry a tab per cohort), so entries are cohort-neutral.",
+  "family": "android",
+  "major": "v6",
+  "cohorts": ["views", "compose"],
+  "categories": ["default", "extension", "ai", "package-install", "component-swap", "dashboard-only"],
+  "enablement": ["auto", "dashboard-toggle", "dashboard-extension", "gradle-package", "code-prop"],
+  "features": [
+    {
+      "id": "core-chat-surface",
+      "name": "Production-ready core chat surface",
+      "category": "default",
+      "enablement": "auto",
+      "needs_stitching": true,
+      "ui_components": ["CometChatConversations", "CometChatMessageHeader", "CometChatMessageList", "CometChatMessageComposer", "CometChatThreadHeader", "CometChatSearch"],
+      "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/getting-started",
+      "notes": "COMPOSITE / app-level feature — the DEFAULT for an unscoped 'add chat' on Android. A production-ready CORE surface, lean but complete: init→login gate (CometChatUIKit.initFromSettings → CometChatUIKit.login; initFromSettings reads the gitignored assets/cometchat-settings.json and persists integrationSource=\"ai-agent\") BEFORE any UI; a Conversations screen navigating to a Message screen (MessageHeader + MessageList + MessageComposer) via native navigation (Activity/Fragment intent or Compose Navigation, correct back stack); THREADED REPLIES included by default (thread affordance → a thread screen with CometChatThreadHeader + thread-scoped list/composer); search default-on (conversation search + in-chat message search via CometChatSearch) wired-or-hidden; every default-on affordance wired to a destination or hidden; SIZED mobile-natively (match_parent fill, edge-to-edge insets handled, ime/keyboard-aware resize so the composer stays visible); init/login failures surfaced (onError), not crashed through; credentials via the gitignored assets/cometchat-settings.json (never hardcoded; prod omits the authKey); prod auth-token guidance (login(uid, authToken); Auth Key dev-only). Docs recipes: one-to-one-chat + conversation flow in getting-started-kotlin / getting-started-jetpack. Grows on request to tab-based selector / users / groups / calls → chat-experience. Gated extensions/AI stay OFF unless asked. Minimum encoded in contracts.android-v6.json ('core-chat-surface')."
+    },
+    {
+      "id": "chat-experience",
+      "name": "Complete chat experience (combined app)",
+      "category": "default",
+      "enablement": "auto",
+      "needs_stitching": true,
+      "ui_components": ["CometChatConversations", "CometChatUsers", "CometChatGroups", "CometChatCallLogs", "CometChatMessageHeader", "CometChatMessageList", "CometChatMessageComposer", "CometChatThreadHeader", "CometChatSearch", "CometChatGroupMembers", "CometChatIncomingCall"],
+      "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/tab-based-chat",
+      "notes": "COMPOSITE / app-level feature — the GROW target, emitted when the user asks for the WHOLE app (NOT the default for a plain 'add chat' — that is core-chat-surface). The docs' tab-based layout: a bottom-nav/tab selector (Chats + Users + Groups + Calls) → message screen → detail screens (user/group details with CometChatGroupMembers actions), thread screen, search screen, plus CometChatIncomingCall handling at the app level. needs_stitching: screens are wired by native navigation + item-click callbacks. Recipes: tab-based-chat (both cohorts), one-to-one-chat, conversation-message-view component. Minimum encoded in contracts.android-v6.json ('chat-experience')."
+    },
+    { "id": "text-messaging", "name": "Text messaging (instant messaging)", "category": "default", "enablement": "auto", "ui_components": ["CometChatMessageList", "CometChatMessageComposer"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/core-features", "notes": "Built-in; core chat (core-features §Instant Messaging)." },
+    { "id": "media-file-attachments", "name": "Media & file sharing", "category": "default", "enablement": "auto", "ui_components": ["CometChatMessageComposer", "CometChatMessageList"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/core-features", "notes": "Built-in composer attachments (images/videos/audio/files) + typed bubbles in the list (core-features §Media Sharing)." },
+    { "id": "delivery-read-receipts", "name": "Delivery & read receipts", "category": "default", "enablement": "auto", "ui_components": ["CometChatMessageList", "CometChatReceipts", "CometChatConversations"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/core-features", "notes": "Built-in (core-features §Read Receipts). Toggle via component props/attrs — FETCH exact names from the component pages." },
+    { "id": "mark-as-unread", "name": "Mark as unread", "category": "default", "enablement": "auto", "ui_components": ["CometChatConversations"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/core-features", "notes": "Built-in conversation option (core-features §Mark as Unread)." },
+    { "id": "typing-indicators", "name": "Typing indicators", "category": "default", "enablement": "auto", "ui_components": ["CometChatMessageList", "CometChatConversations"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/core-features", "notes": "Built-in (core-features §Typing Indicators)." },
+    { "id": "user-presence", "name": "User presence (online/offline)", "category": "default", "enablement": "auto", "ui_components": ["CometChatConversations", "CometChatMessageHeader", "CometChatStatusIndicator"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/core-features", "notes": "Built-in (core-features §User Presence)." },
+    { "id": "reactions", "name": "Message reactions", "category": "default", "enablement": "auto", "ui_components": ["CometChatMessageList"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/core-features", "notes": "ON BY DEFAULT in v6 (core-features §Reactions) — NOT a dashboard extension (AUDIT-077 class). Long-press reaction UI built into the message list." },
+    { "id": "mentions", "name": "@ Mentions", "category": "default", "enablement": "auto", "ui_components": ["CometChatMessageComposer", "CometChatMessageList", "CometChatMentionsFormatter"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/core-features", "notes": "ON BY DEFAULT in v6 (core-features §Mentions) — NOT a dashboard extension (AUDIT-077 class). Customize via CometChatMentionsFormatter (mentions-formatter-guide)." },
+    { "id": "rich-text-formatting", "name": "Rich text formatting", "category": "default", "enablement": "auto", "ui_components": ["CometChatMessageComposer", "CometChatRichTextFormatter"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/core-features", "notes": "Built-in (core-features §Rich Text Formatting); CometChatRichTextFormatter in the catalog." },
+    { "id": "threaded-replies", "name": "Threaded conversations", "category": "default", "enablement": "code-prop", "needs_stitching": true, "ui_components": ["CometChatMessageList", "CometChatThreadHeader", "CometChatMessageComposer"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/guide-threaded-messages", "notes": "The list renders the thread affordance by default, but the HOST wires navigation to a thread screen (CometChatThreadHeader + parent-scoped MessageList/MessageComposer). Recipe: guide-threaded-messages. Part of the core-chat-surface default." },
+    { "id": "quoted-replies", "name": "Quoted replies", "category": "default", "enablement": "auto", "ui_components": ["CometChatMessageList", "CometChatMessageComposer"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/core-features", "notes": "Built-in message option (core-features §Quoted Replies)." },
+    { "id": "users-groups", "name": "Users & group chats", "category": "default", "enablement": "auto", "ui_components": ["CometChatUsers", "CometChatGroups", "CometChatGroupMembers"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/core-features", "notes": "Built-in list components + group management (create/join/leave/members) — core-features §Group Chats. Recipes: guide-group-chat, guide-new-chat, guide-message-privately." },
+    { "id": "report-message", "name": "Report / flag a message", "category": "default", "enablement": "auto", "needs_dashboard": "VERIFY", "ui_components": ["CometChatMessageList"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/core-features", "notes": "Built-in message option (core-features §Report Message); reports land in the Moderation dashboard." },
+    { "id": "message-search", "name": "Conversation & advanced search", "category": "default", "enablement": "code-prop", "needs_stitching": true, "needs_dashboard": "VERIFY", "ui_components": ["CometChatSearch"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/guide-search-messages", "notes": "CometChatSearch component (conversation + message search). Host wires the entry point (search icon/screen navigation). Recipe: guide-search-messages; component page components/search. Advanced message search may need a dashboard/plan enable — VERIFY." },
+    { "id": "custom-message-types", "name": "Custom message types / templates", "category": "default", "enablement": "code-prop", "ui_components": ["CometChatMessageList"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/message-template", "notes": "DOCS-GAP (tracked in DOCS-BACKLOG.md): the message-template page's code uses CometChatMessageTemplate(), but the INSTALLED 6.0.5 kit source exposes NO public template class (only UIKitConstants.MessageTemplateId; catalog verified 2026-08-20). Do NOT emit CometChatMessageTemplate from memory — FETCH the live page and verify the symbol compiles before using; fall back to customization-view-slots for custom rendering." },
+    { "id": "text-formatters", "name": "Custom text formatters (mentions/shortcuts/custom)", "category": "default", "enablement": "code-prop", "ui_components": ["CometChatTextFormatter", "CometChatMentionsFormatter", "CometChatRichTextFormatter"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/customization-text-formatters", "notes": "Extend CometChatTextFormatter for custom patterns. Recipes: custom-text-formatter-guide, mentions-formatter-guide, shortcut-formatter-guide." },
+    { "id": "message-shortcuts", "name": "Message shortcuts", "category": "extension", "enablement": "dashboard-extension", "needs_stitching": true, "ui_components": ["CometChatTextFormatter"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/shortcut-formatter-guide", "notes": "Dashboard Message Shortcuts extension + a host-built ShortcutFormatter (extends CometChatTextFormatter) per the shortcut-formatter-guide recipe — not auto-rendered." },
+    { "id": "stickers", "name": "Stickers", "category": "extension", "enablement": "dashboard-extension", "ui_components": ["CometChatMessageComposer", "CometChatStickerBubble", "CometChatStickerKeyboard"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/extensions", "notes": "Enable in Dashboard → auto-appears in the composer (extensions §Stickers). No extra code." },
+    { "id": "polls", "name": "Polls", "category": "extension", "enablement": "dashboard-extension", "ui_components": ["CometChatMessageComposer", "CometChatCreatePoll", "CometChatPollBubble"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/extensions", "notes": "Enable in Dashboard → auto-appears in the composer action sheet (extensions §Polls). No extra code." },
+    { "id": "collaborative-whiteboard", "name": "Collaborative whiteboard", "category": "extension", "enablement": "dashboard-extension", "ui_components": ["CometChatMessageComposer", "CometChatMessageList"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/extensions", "notes": "Enable in Dashboard → composer action sheet + collaborative bubble in the list (extensions §Collaborative Whiteboard)." },
+    { "id": "collaborative-document", "name": "Collaborative document", "category": "extension", "enablement": "dashboard-extension", "ui_components": ["CometChatMessageComposer", "CometChatMessageList"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/extensions", "notes": "Enable in Dashboard → composer action sheet + collaborative bubble in the list (extensions §Collaborative Document)." },
+    { "id": "message-translation", "name": "Message translation", "category": "extension", "enablement": "dashboard-extension", "ui_components": ["CometChatMessageList"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/extensions", "notes": "Enable in Dashboard → message action sheet in the list (extensions §Message Translation)." },
+    { "id": "link-preview", "name": "Link preview", "category": "extension", "enablement": "dashboard-extension", "ui_components": ["CometChatMessageList"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/extensions", "notes": "Enable in Dashboard → URL previews render in message bubbles (extensions §Link Preview)." },
+    { "id": "thumbnail-generation", "name": "Thumbnail generation", "category": "extension", "enablement": "dashboard-extension", "ui_components": ["CometChatMessageList"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/extensions", "notes": "Enable in Dashboard → media bubbles use generated thumbnails (extensions §Thumbnail Generation)." },
+    { "id": "profanity-filter", "name": "Profanity filter", "category": "extension", "enablement": "dashboard-extension", "deprecated": true, "ui_components": ["CometChatMessageList"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/extensions", "notes": "LEGACY: the extensions page still lists it but its guide points at legacy-docs; superseded by the Moderation product (see 'moderation'). Do NOT suggest as a new-feature add — steer to Moderation (FEATURE-TAXONOMY rules 11–12)." },
+    { "id": "moderation", "name": "Moderation", "category": "dashboard-only", "enablement": "dashboard-toggle", "ui_components": [], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/core-features", "notes": "Dashboard-configured (rules/keywords/AI moderation); no client code — core-features §Moderation. Client-visible effect: blocked/flagged messages. SDK view: sdk/android/v5/ai-moderation." },
+    { "id": "smart-reply", "name": "Smart replies (AI)", "category": "ai", "enablement": "dashboard-toggle", "ui_components": ["CometChatMessageComposer"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/ai-features", "notes": "Enable in Dashboard → auto-appears in the composer action sheet (ai-features §Smart Replies). No extra code." },
+    { "id": "conversation-starter", "name": "Conversation starter (AI)", "category": "ai", "enablement": "dashboard-toggle", "ui_components": ["CometChatMessageList"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/ai-features", "notes": "Enable in Dashboard → shown in the message list for new chats (ai-features §Conversation Starter). No extra code." },
+    { "id": "conversation-summary", "name": "Conversation summary (AI)", "category": "ai", "enablement": "dashboard-toggle", "ui_components": ["CometChatMessageComposer"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/ai-features", "notes": "Enable in Dashboard → composer action sheet (ai-features §Conversation Summary). No extra code." },
+    { "id": "ai-assistant", "name": "AI agent / assistant chat", "category": "ai", "enablement": "dashboard-toggle", "needs_stitching": true, "ui_components": ["CometChatAIAssistantChatHistory", "CometChatAIAssistantBubble", "CometChatMessageList", "CometChatMessageComposer"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/guide-ai-agent", "notes": "Chat with a dashboard-configured AI Agent: message screen scoped to the agent + CometChatAIAssistantChatHistory for past sessions. Recipe: guide-ai-agent; component page ai-assistant-chat-history. Requires an Agent configured in Dashboard." },
+    { "id": "voice-video-calls", "name": "Voice & video calls", "category": "package-install", "enablement": "gradle-package", "needs_stitching": true, "ui_components": ["CometChatCallButtons", "CometChatIncomingCall", "CometChatOutgoingCall", "CometChatCallLogs", "CometChatCallActivity"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/calling-integration", "notes": "Add com.cometchat:calls-sdk-android — call buttons in MessageHeader then auto-appear; host wires an incoming-call listener/screen (calling-integration steps 1–3). Pages: call-features, components/call-buttons, incoming-call, outgoing-call, call-logs; recipe guide-call-log-details. Dashboard: calling enabled on the app." },
+    { "id": "push-notifications", "name": "Push notifications (FCM)", "category": "package-install", "enablement": "gradle-package", "needs_stitching": true, "needs_dashboard": true, "ui_components": [], "docs_topic": "https://www.cometchat.com/docs/notifications/push-overview", "notes": "com.cometchat:push-notifications-android + Firebase Cloud Messaging + Dashboard provider setup (FCM credentials). Register token after login (CometChatNotifications.registerPushToken — SDK surface); notification payload handling is host code. Product docs: notifications/push-overview + android integration pages." },
+    { "id": "notification-feed", "name": "In-app notification feed", "category": "default", "enablement": "code-prop", "needs_dashboard": "VERIFY", "ui_components": ["CometChatNotificationFeed"], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/notification-feed", "notes": "Drop-in CometChatNotificationFeed component (components/notification-feed). Feed configuration lives in the Dashboard notifications product — VERIFY plan gating." },
+    { "id": "campaigns", "name": "Campaigns", "category": "dashboard-only", "enablement": "dashboard-toggle", "ui_components": [], "docs_topic": "https://www.cometchat.com/docs/ui-kit/android/campaigns", "notes": "Authored/sent from the Dashboard; messages arrive through normal channels. No client code (ui-kit/android/campaigns)." }
+  ]
+}