[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6MF2T3HZ09403Q829RZBB1Z":3,"skill-same:01M6MF2T3HZ09403Q829RZBB1Z":85},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":41,"linkOnly":42,"markdownContent":43,"markdownBody":44,"frontMatter":45,"refName":51,"commitSha":52,"skillDirectory":53,"forksCount":54,"repositoryHtmlUrl":55,"repositoryHomepageUrl":56,"ownerHtmlUrl":57,"ownerBlogUrl":58,"ownerDescription":59,"updatedAt":60,"install":61,"resources":74},"01M6MF2T3HZ09403Q829RZBB1Z","cometchat-android-v5-sdk",null,"Build chat on Android with the headless CometChat Chat SDK v5 and your OWN UI — init\u002Flogin ordering, the method map, request-builder pagination, listener lifecycle, and a production-ready app surface (optimistic updates, error states, sized shell). Use when the app needs custom UI instead of the drop-in UI Kit. Triggers: 'cometchat android sdk', 'chat with my own ui android', 'headless cometchat android', 'send message with chat-sdk-android', 'cometchat message listener kotlin'.","hashgraph-online\u002Fawesome-codex-plugins","hashgraph-online","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F160371962?v=4","01M6CNB6NRJVNNGN14TR01Q6D3","HOL (Hashgraph Online)","01M6JT1HSKKG9V68KQAQGBA7XP",1575,"MIT","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcometchat\u002Fcometchat-skills\u002Fskills\u002Fcometchat-android-v5-sdk\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40],"android","sdk","cometchat android v5 sdk","cometchat","when","login","message","jvm","drop","updates","map","production-ready","kit","init","send","states","headless","ready","app","error","send message","builder","2026-11-10 10:12:30",false,"---\nname: cometchat-android-v5-sdk\ndescription: \"Build chat on Android with the headless CometChat Chat SDK v5 and your OWN UI — init\u002Flogin ordering, the method map, request-builder pagination, listener lifecycle, and a production-ready app surface (optimistic updates, error states, sized shell). Use when the app needs custom UI instead of the drop-in UI Kit. Triggers: 'cometchat android sdk', 'chat with my own ui android', 'headless cometchat android', 'send message with chat-sdk-android', 'cometchat message listener kotlin'.\"\nlicense: \"MIT\"\ncompatibility: \"Android minSdk >=24; Kotlin >=1.9 \u002F AGP >=8; JVM target 11; com.cometchat:chat-sdk-android ^5 (5.0.x, verified 5.0.7); optional com.cometchat:calls-sdk-android ^5\"\nmetadata:\n  author: \"CometChat\"\n  version: \"1.0.0\"\n  tags: \"cometchat android sdk v5 headless kotlin custom-ui chat-sdk\"\n---\n\n> **Ground truth:** catalog `sdk-android-v5.json` (curated from the INSTALLED `com.cometchat:chat-sdk-android:5.0.5` AAR — the existence oracle; all 248 entries re-checked present in the 5.0.7 AAR, which only ADDS pin\u002Fsave\u002Fthread-subscription APIs) + `features.sdk-android-v5.json` + `contracts.sdk-android-v5.json` (`sdk-chat-surface` — the completeness floor). Docs: `references\u002Fdocs-map.md`. ⚠️ **Android SDK v5 pages are VERSIONED** (`\u002Fsdk\u002Fandroid\u002Fv5\u002F...`); the unversioned tree is v4. Verify symbols against the catalog; fetch signatures from docs; never trust memory.\n\n## Companion skills (read first)\nThis skill is **self-contained** for headless builds — it does not depend on a UI Kit core. But: if the user wants ready-made chat UI, the **UI Kit is the better answer** — say so and route to `cometchat-android-v6-core` (drop-in components, far less code). Come here when they explicitly want their own UI, a non-chat surface, or backend-style usage.\n\n## Use this skill when\n\"use the CometChat SDK directly\", \"build chat with my own UI\u002Fdesign system\", \"I don't want the UI Kit\", \"send\u002Freceive messages programmatically\", \"custom chat screen in Compose backed by CometChat\".\n\n## Prerequisites & install\n```kotlin\n\u002F\u002F settings.gradle(.kts) → dependencyResolutionManagement.repositories\nmaven(\"https:\u002F\u002Fdl.cloudsmith.io\u002Fpublic\u002Fcometchat\u002Fcometchat\u002Fmaven\u002F\")\n\u002F\u002F app\u002Fbuild.gradle.kts\nimplementation(\"com.cometchat:chat-sdk-android:5.0.7\")     \u002F\u002F + calls-sdk-android:5.0.4 for calling\n```\n```properties\n# gradle.properties — REQUIRED\nandroid.useAndroidX=true\n```\n- **Jetifier: not needed on 5.0.7.** 5.0.7 depends on `androidx.lifecycle:lifecycle-process` instead of the old `android.arch.lifecycle:extensions:1.1.1`, so a clean AndroidX app builds with `android.enableJetifier=false` (verified 2026-10-15, `assembleDebug`). Pinned to 5.0.6 or older? Then Jetifier IS required: without it the build fails `checkDebugDuplicateClasses` (`Duplicate class android.support.v4.app.INotificationSideChannel ... com.android.support:support-compat:26.1.0`; verified 2026-09-07 on 5.0.5). Calling (`calls-sdk-android:5.0.4`) additionally needs `minSdk 26` + the SoLoader init + a manifest `\u003Cservice>` — `cometchat-android-v5-calls-sdk` Prerequisites.\nManifest needs `android.permission.INTERNET`. Credentials live in the **gitignored** `app\u002Fsrc\u002Fmain\u002Fassets\u002Fcometchat-settings.json` (`appId`, `region`, `credentials.authKey` dev-only). The optional `chatSDK` section carries SDK-level overrides; init succeeds without it, so omit it for a minimal build — **BUT one override is load-bearing for a required surface:**\n\n> ⚠️ **Presence is opt-in via `chatSDK.presenceSubscription` — omit it and realtime presence is silently dead.** The app-surface floor requires a presence-aware chat header + users list (`onUserOnline`\u002F`onUserOffline`). `initFromSettings` only subscribes to presence if the asset sets `chatSDK.presenceSubscription`; **if it's absent, `onUserListener` events NEVER fire** (docs `\u002Fsdk\u002Fandroid\u002Fv5\u002Fuser-presence`: \"If none of the above methods are set, no presence will be sent\"). Accepted values (verified against the AAR settings parser — bad values throw `ERR_SETTINGS_FILE_INVALID_PRESENCE_TYPE`): `ALL_USERS` · `FRIENDS` · `ROLES` (with a sibling `roles` list) · `NONE`. So whenever you wire the presence surface, ship:\n> ```json\n> { \"appId\": \"...\", \"region\": \"...\", \"credentials\": { \"authKey\": \"...\" },\n>   \"chatSDK\": { \"presenceSubscription\": \"ALL_USERS\" } }\n> ```\n> Distinguish the two presence paths: `getUser(uid).status` \u002F the `UsersRequest` list `status` field is a **one-time snapshot** (works without the subscription); the **realtime** `onUserOnline`\u002F`onUserOffline` transitions need the subscription above.\n\n> ⚠️ **Docs drift — `ConnectionListener`.** `\u002Fsdk\u002Fandroid\u002Fv5\u002Fconnection-status.md` shows\n> `override fun onError(e: CometChatException)`. That does not compile: the member is\n> **`onConnectionError(e: CometChatException?)`**, and `ConnectionListener` is an **interface** —\n> `object : CometChat.ConnectionListener` with **no parentheses**, unlike `CometChat.MessageListener()`.\n> Verified against `CometChat.java:10737`.\n\n## Init & login ordering (BAKED — invariant)\n`CometChat.initFromSettings(...)` resolves → `login(...)` resolves → everything else. Any SDK call before init fails; login before init **fails silently**.\n```kotlin\nimport com.cometchat.chat.core.CometChat\nimport com.cometchat.chat.exceptions.CometChatException\nimport com.cometchat.chat.models.User\n\nCometChat.initFromSettings(context, object : CometChat.CallbackListener\u003CString>() {\n    override fun onSuccess(p: String) {                       \u002F\u002F init resolved — telemetry source persisted\n        if (CometChat.getLoggedInUser() == null) {\n            \u002F\u002F ⚠️ TWO DIFFERENT overloads — they are not interchangeable:\n            \u002F\u002F   dev  : login(uid, authKey, listener)   ← 3 args, uid REQUIRED\n            \u002F\u002F   prod : login(authToken, listener)      ← 2 args, NO uid (the token identifies the user)\n            \u002F\u002F Passing a token in the 3-arg form sends it as an apiKey and fails.\n            \u002F\u002F WHERE `authKey` COMES FROM (headless has no UI-Kit shortcut): read it back out of the\n            \u002F\u002F same gitignored settings asset you already ship — never hardcode it, and never add a\n            \u002F\u002F second copy in source:\n            \u002F\u002F   val cfg = JSONObject(assets.open(\"cometchat-settings.json\").bufferedReader().readText())\n            \u002F\u002F   val authKey = cfg.getJSONObject(\"credentials\").getString(\"authKey\")\n            \u002F\u002F Guard the read: if the asset is missing this throws BEFORE the SDK can report its own\n            \u002F\u002F clean ERR_SETTINGS_FILE_NOT_FOUND, turning a clear error into a crash.\n            CometChat.login(uid, authKey, object : CometChat.CallbackListener\u003CUser>() {\n                override fun onSuccess(user: User) { \u002F* unlock the app *\u002F }\n                override fun onError(e: CometChatException) { \u002F* surface e.code + e.message *\u002F }\n            })\n        } else { \u002F* session already live *\u002F }\n    }\n    override fun onError(e: CometChatException?) { \u002F* surface — do NOT proceed *\u002F }\n})\n```\n`initFromSettings` reads the assets settings file and persists the integration source; the classic `CometChat.init(context, appId, AppSettings, callback)` still exists but is **not** the default (loses attribution). **Prod:** mint a per-user auth token server-side and log in with it; the Auth Key is dev-only. Re-logging a *different* user requires `logout` first.\n\n## SDK method map (BAKED closed list — catalog-verified)\n**Constants & models packages** — `com.cometchat.chat.core.*` (`CometChat`, `Call`, and the `*Request`\u002F`*RequestBuilder` types) · `com.cometchat.chat.models.*` (`User`, `Group`, `TextMessage`, `MediaMessage`, `BaseMessage`, `TypingIndicator`) · `com.cometchat.chat.constants.CometChatConstants` (**`RECEIVER_TYPE_USER`\u002F`RECEIVER_TYPE_GROUP` live HERE, not on `CometChat`**) · `com.cometchat.chat.exceptions.CometChatException`.\n**Auth overloads (do not conflate)** — `login(uid, authKey, listener)` for dev; `login(authToken, listener)` for production, which takes **no uid** because the server-minted token carries the identity. Getting this wrong is silent: the token goes through as an apiKey and auth fails.\n**Session** `initFromSettings` · `init` (legacy) · `login` · `logout` · `getLoggedInUser` · `getUserAuthToken` · `addLoginListener`\u002F`LoginListener`\u002F`removeLoginListener`\n**Messaging** `TextMessage` · `MediaMessage` · `CustomMessage` · `InteractiveMessage` · `sendMessage` · `sendMediaMessage` · `sendCustomMessage` · `sendInteractiveMessage` · `editMessage` · `deleteMessage` · `flagMessage`\u002F`getFlagReasons` · `sendTransientMessage`\u002F`TransientMessage` · `getMessageDetails` · `BaseMessage` · `Attachment` · `createUploadFileRequest`\u002F`UploadFileRequest`\u002F`UploadFileListener`\n**Fetching (always via a request builder + pagination)** `MessagesRequest.MessagesRequestBuilder` · `ConversationsRequest.ConversationsRequestBuilder` · `UsersRequest.UsersRequestBuilder` · `GroupsRequest.GroupsRequestBuilder` · `GroupMembersRequest.GroupMembersRequestBuilder` · `BannedGroupMembersRequest...` · `BlockedUsersRequest...` · `ReactionsRequest...` · `NotificationFeedRequest...`\n**Realtime listeners** `addMessageListener`\u002F`MessageListener`\u002F`removeMessageListener` · `addUserListener`\u002F`UserListener`\u002F... · `addGroupListener`\u002F`GroupListener`\u002F... · `addCallListener`\u002F`CallListener`\u002F... · `addConnectionListener`\u002F`ConnectionListener`\u002F... · `addAIAssistantListener`\u002F`AIAssistantListener`\u002F... · `addNotificationFeedListener`\u002F`NotificationFeedListener`\u002F...\n**Receipts & typing** `startTyping`\u002F`endTyping`\u002F`TypingIndicator` · `markAsDelivered`\u002F`markAsRead`\u002F`markAsUnread`\u002F`markConversationAsRead` · `MessageReceipt`\u002F`getMessageReceipts` · unread: `getUnreadMessageCount`\u002F`...ForUser`\u002F`...ForGroup`\n**Reactions** `addReaction`\u002F`removeReaction`\u002F`Reaction`\u002F`ReactionCount`\n**Users** `getUser` · `createUser`\u002F`updateUser`\u002F`updateCurrentUserDetails` · `blockUsers`\u002F`unblockUsers` · `User`\n**Groups** `createGroup`\u002F`createGroupWithMembers` · `joinGroup`\u002F`leaveGroup` · `updateGroup`\u002F`deleteGroup`\u002F`getGroup`\u002F`getJoinedGroups` · `addMembersToGroup`\u002F`kickGroupMember`\u002F`banGroupMember`\u002F`unbanGroupMember` · `updateGroupMemberScope`\u002F`transferGroupOwnership` · `Group`\u002F`GroupMember`\n**Conversations** `getConversation` · `deleteConversation` · `tagConversation` · `Conversation`\n**Calls** `initiateCall`\u002F`acceptCall`\u002F`rejectCall`\u002F`endCall`\u002F`startCall` · `getActiveCall`\u002F`clearActiveCall` · `Call`\u002F`CallSettings.CallSettingsBuilder`\n**AI** `getSmartReplies` · `getConversationStarter` · `getConversationSummary` · `askBot` · `isAIFeatureEnabled` · `AIAssistantMessage` + the `AIAssistant*Event` family\n**Push & feed** `registerTokenForPushNotification` · `CometChatNotifications` · `PushPlatforms` · `NotificationFeedItem`\u002F`getNotificationFeedUnreadCount`\n**Connection** `getConnectionStatus` · `connect`\u002F`disconnect`\u002F`ping`\nNot in this map and not in the catalog ⇒ does not exist: fetch the page via `references\u002Fdocs-map.md` before assuming.\n\n## Listener lifecycle (the #1 source of Android SDK bugs)\nEvery `add*Listener(UNIQUE_ID, ...)` **must** have a matching `remove*Listener(UNIQUE_ID)` on teardown — `onDestroy` (Activity\u002FFragment), `DisposableEffect`'s `onDispose` (Compose), or `onCleared` (ViewModel). Register with a stable, unique id (e.g. the screen's class name); registering the same id twice replaces silently, never removing leaks the callback and duplicates handling after rotation.\n```kotlin\nDisposableEffect(Unit) {\n    CometChat.addMessageListener(LISTENER_ID, object : CometChat.MessageListener() {\n        override fun onTextMessageReceived(message: TextMessage) { \u002F* append to state *\u002F }\n    })\n    onDispose { CometChat.removeMessageListener(LISTENER_ID) }\n}\n```\nRealtime arrives via listeners — **never poll**.\n\n## Least-code recipe — the production floor (contract `sdk-chat-surface`)\nBecause the SDK ships no UI, a generic \"build chat with the SDK\" must deliver a **complete, production-ready app**, not bare bubbles. The floor (full text in `contracts.sdk-android-v5.json`, UI spec in `references\u002Fapp-surface.md`):\n- **Data**: conversations + users + groups lists, each **searchable** (`setSearchKeyword` on the builder) and **paginated** via request builders (`setLimit` + fetch-next) — never one unbounded fetch. Scope the request to the product (1:1-only vs groups) instead of filtering client-side.\n- **Messaging**: send text\u002Fmedia, message history, **threads** via `setParentMessageId`, edit\u002Fdelete\u002Freact\u002Freport — each wired to the SDK **and** reflected in the UI, with own-message gating for edit\u002Fdelete.\n- **Realtime**: message\u002Fuser\u002Fgroup\u002Fconnection listeners registered and removed as above; typing indicators and receipts wired.\n- **Detail screens**: user (block\u002Funblock) and group (add\u002Fkick\u002Fban\u002Fscope\u002Fleave), role-gated.\n- **UX quality**: **optimistic updates** (show the message as sending immediately, reconcile in `onSuccess`, roll back + surface `CometChatException.message` in `onError`), **loading\u002Fempty\u002Ferror states everywhere** (never a blank screen or `[object Object]`), a **sized shell** (`fillMaxSize`\u002F`match_parent`, list scrolls internally, insets + IME handled), and your app's **existing design system** (Material3 theme or your tokens) — never ad-hoc inline styling.\n- **Errors**: every `CallbackListener` implements `onError` and surfaces something actionable. An empty `onError {}` is the defect this contract exists to prevent.\n\n## Deep references (load only when the task needs them)\n- `references\u002Fdocs-map.md` — intent → the exact `\u002Fsdk\u002Fandroid\u002Fv5\u002F\u003Cpage>.md` to fetch (+ the v5-vs-v4 URL trap and the scoped LLM index).\n- `references\u002Fapp-surface.md` — the own-UI production floor in detail (state model, optimistic mutations, list\u002Fpagination patterns, error\u002Fempty\u002Floading, sizing).\n\n## Common pitfalls\n**reversed param order** — `updateGroupMemberScope(UID, GUID, scope, ...)` vs `transferGroupOwnership(GUID, UID, ...)` · **search-keyword casing differs per builder** — `UsersRequestBuilder.setSearchKeyword` and `ConversationsRequestBuilder.setSearchKeyword` are lowercase, but `GroupsRequestBuilder.setSearchKeyWord` has a **capital W** (SDK inconsistency; using `setSearchKeyword` on GroupsRequest is `Unresolved reference`) · **conversations search is plan-gated** — `ConversationsRequestBuilder.setSearchKeyword`\u002F`setUnread` need the **\"Conversation & Advanced Search\"** feature (Advanced\u002FCustom plan + dashboard toggle); off-plan it **silently returns the unfiltered list** (a search box that looks broken). Users\u002FGroups search is NOT plan-gated. · passing an auth **token** into the 3-arg `login(uid, authKey, ...)` (tokens use the 2-arg `login(authToken, ...)`) · `CometChat.RECEIVER_TYPE_USER` (it is `CometChatConstants.RECEIVER_TYPE_USER`) · **presence never fires without `chatSDK.presenceSubscription`** in the settings asset (see Prerequisites) · importing `Call` from `chat.models` instead of `chat.core` · Any SDK call before init resolves · login before init (silent failure) · Auth Key shipped in a release build · listeners never removed (duplicate handling after rotation) · polling instead of listeners · unbounded fetches with no pagination · empty `onError` blocks · blocking the main thread waiting on callbacks · re-login without logout · using the unversioned `\u002Fsdk\u002Fandroid\u002F` v4 docs · rebuilding UI the UI Kit already ships (when the user would accept drop-ins).\n\n## Verify it works\nEvery symbol you emitted is in `sdk-android-v5.json` (Tier-1) and the app compiles: run `.\u002Fgradlew :app:assembleDebug` in the user's app. On device: init → login succeed (logcat); the conversations\u002Fusers\u002Fgroups lists load and paginate; sending appears instantly and reconciles; a message from another user arrives **live** (listener, not refresh); edit\u002Fdelete\u002Freact update in place; rotating the screen doesn't duplicate messages (listener lifecycle); force an error (airplane mode) → a readable error state, not a blank screen or crash. Live backend round-trip smoke for this family is **not automated yet** (parked with the Android native harness) — verify manually and say so.\n","> **Ground truth:** catalog `sdk-android-v5.json` (curated from the INSTALLED `com.cometchat:chat-sdk-android:5.0.5` AAR — the existence oracle; all 248 entries re-checked present in the 5.0.7 AAR, which only ADDS pin\u002Fsave\u002Fthread-subscription APIs) + `features.sdk-android-v5.json` + `contracts.sdk-android-v5.json` (`sdk-chat-surface` — the completeness floor). Docs: `references\u002Fdocs-map.md`. ⚠️ **Android SDK v5 pages are VERSIONED** (`\u002Fsdk\u002Fandroid\u002Fv5\u002F...`); the unversioned tree is v4. Verify symbols against the catalog; fetch signatures from docs; never trust memory.\n\n## Companion skills (read first)\nThis skill is **self-contained** for headless builds — it does not depend on a UI Kit core. But: if the user wants ready-made chat UI, the **UI Kit is the better answer** — say so and route to `cometchat-android-v6-core` (drop-in components, far less code). Come here when they explicitly want their own UI, a non-chat surface, or backend-style usage.\n\n## Use this skill when\n\"use the CometChat SDK directly\", \"build chat with my own UI\u002Fdesign system\", \"I don't want the UI Kit\", \"send\u002Freceive messages programmatically\", \"custom chat screen in Compose backed by CometChat\".\n\n## Prerequisites & install\n```kotlin\n\u002F\u002F settings.gradle(.kts) → dependencyResolutionManagement.repositories\nmaven(\"https:\u002F\u002Fdl.cloudsmith.io\u002Fpublic\u002Fcometchat\u002Fcometchat\u002Fmaven\u002F\")\n\u002F\u002F app\u002Fbuild.gradle.kts\nimplementation(\"com.cometchat:chat-sdk-android:5.0.7\")     \u002F\u002F + calls-sdk-android:5.0.4 for calling\n```\n```properties\n# gradle.properties — REQUIRED\nandroid.useAndroidX=true\n```\n- **Jetifier: not needed on 5.0.7.** 5.0.7 depends on `androidx.lifecycle:lifecycle-process` instead of the old `android.arch.lifecycle:extensions:1.1.1`, so a clean AndroidX app builds with `android.enableJetifier=false` (verified 2026-10-15, `assembleDebug`). Pinned to 5.0.6 or older? Then Jetifier IS required: without it the build fails `checkDebugDuplicateClasses` (`Duplicate class android.support.v4.app.INotificationSideChannel ... com.android.support:support-compat:26.1.0`; verified 2026-09-07 on 5.0.5). Calling (`calls-sdk-android:5.0.4`) additionally needs `minSdk 26` + the SoLoader init + a manifest `\u003Cservice>` — `cometchat-android-v5-calls-sdk` Prerequisites.\nManifest needs `android.permission.INTERNET`. Credentials live in the **gitignored** `app\u002Fsrc\u002Fmain\u002Fassets\u002Fcometchat-settings.json` (`appId`, `region`, `credentials.authKey` dev-only). The optional `chatSDK` section carries SDK-level overrides; init succeeds without it, so omit it for a minimal build — **BUT one override is load-bearing for a required surface:**\n\n> ⚠️ **Presence is opt-in via `chatSDK.presenceSubscription` — omit it and realtime presence is silently dead.** The app-surface floor requires a presence-aware chat header + users list (`onUserOnline`\u002F`onUserOffline`). `initFromSettings` only subscribes to presence if the asset sets `chatSDK.presenceSubscription`; **if it's absent, `onUserListener` events NEVER fire** (docs `\u002Fsdk\u002Fandroid\u002Fv5\u002Fuser-presence`: \"If none of the above methods are set, no presence will be sent\"). Accepted values (verified against the AAR settings parser — bad values throw `ERR_SETTINGS_FILE_INVALID_PRESENCE_TYPE`): `ALL_USERS` · `FRIENDS` · `ROLES` (with a sibling `roles` list) · `NONE`. So whenever you wire the presence surface, ship:\n> ```json\n> { \"appId\": \"...\", \"region\": \"...\", \"credentials\": { \"authKey\": \"...\" },\n>   \"chatSDK\": { \"presenceSubscription\": \"ALL_USERS\" } }\n> ```\n> Distinguish the two presence paths: `getUser(uid).status` \u002F the `UsersRequest` list `status` field is a **one-time snapshot** (works without the subscription); the **realtime** `onUserOnline`\u002F`onUserOffline` transitions need the subscription above.\n\n> ⚠️ **Docs drift — `ConnectionListener`.** `\u002Fsdk\u002Fandroid\u002Fv5\u002Fconnection-status.md` shows\n> `override fun onError(e: CometChatException)`. That does not compile: the member is\n> **`onConnectionError(e: CometChatException?)`**, and `ConnectionListener` is an **interface** —\n> `object : CometChat.ConnectionListener` with **no parentheses**, unlike `CometChat.MessageListener()`.\n> Verified against `CometChat.java:10737`.\n\n## Init & login ordering (BAKED — invariant)\n`CometChat.initFromSettings(...)` resolves → `login(...)` resolves → everything else. Any SDK call before init fails; login before init **fails silently**.\n```kotlin\nimport com.cometchat.chat.core.CometChat\nimport com.cometchat.chat.exceptions.CometChatException\nimport com.cometchat.chat.models.User\n\nCometChat.initFromSettings(context, object : CometChat.CallbackListener\u003CString>() {\n    override fun onSuccess(p: String) {                       \u002F\u002F init resolved — telemetry source persisted\n        if (CometChat.getLoggedInUser() == null) {\n            \u002F\u002F ⚠️ TWO DIFFERENT overloads — they are not interchangeable:\n            \u002F\u002F   dev  : login(uid, authKey, listener)   ← 3 args, uid REQUIRED\n            \u002F\u002F   prod : login(authToken, listener)      ← 2 args, NO uid (the token identifies the user)\n            \u002F\u002F Passing a token in the 3-arg form sends it as an apiKey and fails.\n            \u002F\u002F WHERE `authKey` COMES FROM (headless has no UI-Kit shortcut): read it back out of the\n            \u002F\u002F same gitignored settings asset you already ship — never hardcode it, and never add a\n            \u002F\u002F second copy in source:\n            \u002F\u002F   val cfg = JSONObject(assets.open(\"cometchat-settings.json\").bufferedReader().readText())\n            \u002F\u002F   val authKey = cfg.getJSONObject(\"credentials\").getString(\"authKey\")\n            \u002F\u002F Guard the read: if the asset is missing this throws BEFORE the SDK can report its own\n            \u002F\u002F clean ERR_SETTINGS_FILE_NOT_FOUND, turning a clear error into a crash.\n            CometChat.login(uid, authKey, object : CometChat.CallbackListener\u003CUser>() {\n                override fun onSuccess(user: User) { \u002F* unlock the app *\u002F }\n                override fun onError(e: CometChatException) { \u002F* surface e.code + e.message *\u002F }\n            })\n        } else { \u002F* session already live *\u002F }\n    }\n    override fun onError(e: CometChatException?) { \u002F* surface — do NOT proceed *\u002F }\n})\n```\n`initFromSettings` reads the assets settings file and persists the integration source; the classic `CometChat.init(context, appId, AppSettings, callback)` still exists but is **not** the default (loses attribution). **Prod:** mint a per-user auth token server-side and log in with it; the Auth Key is dev-only. Re-logging a *different* user requires `logout` first.\n\n## SDK method map (BAKED closed list — catalog-verified)\n**Constants & models packages** — `com.cometchat.chat.core.*` (`CometChat`, `Call`, and the `*Request`\u002F`*RequestBuilder` types) · `com.cometchat.chat.models.*` (`User`, `Group`, `TextMessage`, `MediaMessage`, `BaseMessage`, `TypingIndicator`) · `com.cometchat.chat.constants.CometChatConstants` (**`RECEIVER_TYPE_USER`\u002F`RECEIVER_TYPE_GROUP` live HERE, not on `CometChat`**) · `com.cometchat.chat.exceptions.CometChatException`.\n**Auth overloads (do not conflate)** — `login(uid, authKey, listener)` for dev; `login(authToken, listener)` for production, which takes **no uid** because the server-minted token carries the identity. Getting this wrong is silent: the token goes through as an apiKey and auth fails.\n**Session** `initFromSettings` · `init` (legacy) · `login` · `logout` · `getLoggedInUser` · `getUserAuthToken` · `addLoginListener`\u002F`LoginListener`\u002F`removeLoginListener`\n**Messaging** `TextMessage` · `MediaMessage` · `CustomMessage` · `InteractiveMessage` · `sendMessage` · `sendMediaMessage` · `sendCustomMessage` · `sendInteractiveMessage` · `editMessage` · `deleteMessage` · `flagMessage`\u002F`getFlagReasons` · `sendTransientMessage`\u002F`TransientMessage` · `getMessageDetails` · `BaseMessage` · `Attachment` · `createUploadFileRequest`\u002F`UploadFileRequest`\u002F`UploadFileListener`\n**Fetching (always via a request builder + pagination)** `MessagesRequest.MessagesRequestBuilder` · `ConversationsRequest.ConversationsRequestBuilder` · `UsersRequest.UsersRequestBuilder` · `GroupsRequest.GroupsRequestBuilder` · `GroupMembersRequest.GroupMembersRequestBuilder` · `BannedGroupMembersRequest...` · `BlockedUsersRequest...` · `ReactionsRequest...` · `NotificationFeedRequest...`\n**Realtime listeners** `addMessageListener`\u002F`MessageListener`\u002F`removeMessageListener` · `addUserListener`\u002F`UserListener`\u002F... · `addGroupListener`\u002F`GroupListener`\u002F... · `addCallListener`\u002F`CallListener`\u002F... · `addConnectionListener`\u002F`ConnectionListener`\u002F... · `addAIAssistantListener`\u002F`AIAssistantListener`\u002F... · `addNotificationFeedListener`\u002F`NotificationFeedListener`\u002F...\n**Receipts & typing** `startTyping`\u002F`endTyping`\u002F`TypingIndicator` · `markAsDelivered`\u002F`markAsRead`\u002F`markAsUnread`\u002F`markConversationAsRead` · `MessageReceipt`\u002F`getMessageReceipts` · unread: `getUnreadMessageCount`\u002F`...ForUser`\u002F`...ForGroup`\n**Reactions** `addReaction`\u002F`removeReaction`\u002F`Reaction`\u002F`ReactionCount`\n**Users** `getUser` · `createUser`\u002F`updateUser`\u002F`updateCurrentUserDetails` · `blockUsers`\u002F`unblockUsers` · `User`\n**Groups** `createGroup`\u002F`createGroupWithMembers` · `joinGroup`\u002F`leaveGroup` · `updateGroup`\u002F`deleteGroup`\u002F`getGroup`\u002F`getJoinedGroups` · `addMembersToGroup`\u002F`kickGroupMember`\u002F`banGroupMember`\u002F`unbanGroupMember` · `updateGroupMemberScope`\u002F`transferGroupOwnership` · `Group`\u002F`GroupMember`\n**Conversations** `getConversation` · `deleteConversation` · `tagConversation` · `Conversation`\n**Calls** `initiateCall`\u002F`acceptCall`\u002F`rejectCall`\u002F`endCall`\u002F`startCall` · `getActiveCall`\u002F`clearActiveCall` · `Call`\u002F`CallSettings.CallSettingsBuilder`\n**AI** `getSmartReplies` · `getConversationStarter` · `getConversationSummary` · `askBot` · `isAIFeatureEnabled` · `AIAssistantMessage` + the `AIAssistant*Event` family\n**Push & feed** `registerTokenForPushNotification` · `CometChatNotifications` · `PushPlatforms` · `NotificationFeedItem`\u002F`getNotificationFeedUnreadCount`\n**Connection** `getConnectionStatus` · `connect`\u002F`disconnect`\u002F`ping`\nNot in this map and not in the catalog ⇒ does not exist: fetch the page via `references\u002Fdocs-map.md` before assuming.\n\n## Listener lifecycle (the #1 source of Android SDK bugs)\nEvery `add*Listener(UNIQUE_ID, ...)` **must** have a matching `remove*Listener(UNIQUE_ID)` on teardown — `onDestroy` (Activity\u002FFragment), `DisposableEffect`'s `onDispose` (Compose), or `onCleared` (ViewModel). Register with a stable, unique id (e.g. the screen's class name); registering the same id twice replaces silently, never removing leaks the callback and duplicates handling after rotation.\n```kotlin\nDisposableEffect(Unit) {\n    CometChat.addMessageListener(LISTENER_ID, object : CometChat.MessageListener() {\n        override fun onTextMessageReceived(message: TextMessage) { \u002F* append to state *\u002F }\n    })\n    onDispose { CometChat.removeMessageListener(LISTENER_ID) }\n}\n```\nRealtime arrives via listeners — **never poll**.\n\n## Least-code recipe — the production floor (contract `sdk-chat-surface`)\nBecause the SDK ships no UI, a generic \"build chat with the SDK\" must deliver a **complete, production-ready app**, not bare bubbles. The floor (full text in `contracts.sdk-android-v5.json`, UI spec in `references\u002Fapp-surface.md`):\n- **Data**: conversations + users + groups lists, each **searchable** (`setSearchKeyword` on the builder) and **paginated** via request builders (`setLimit` + fetch-next) — never one unbounded fetch. Scope the request to the product (1:1-only vs groups) instead of filtering client-side.\n- **Messaging**: send text\u002Fmedia, message history, **threads** via `setParentMessageId`, edit\u002Fdelete\u002Freact\u002Freport — each wired to the SDK **and** reflected in the UI, with own-message gating for edit\u002Fdelete.\n- **Realtime**: message\u002Fuser\u002Fgroup\u002Fconnection listeners registered and removed as above; typing indicators and receipts wired.\n- **Detail screens**: user (block\u002Funblock) and group (add\u002Fkick\u002Fban\u002Fscope\u002Fleave), role-gated.\n- **UX quality**: **optimistic updates** (show the message as sending immediately, reconcile in `onSuccess`, roll back + surface `CometChatException.message` in `onError`), **loading\u002Fempty\u002Ferror states everywhere** (never a blank screen or `[object Object]`), a **sized shell** (`fillMaxSize`\u002F`match_parent`, list scrolls internally, insets + IME handled), and your app's **existing design system** (Material3 theme or your tokens) — never ad-hoc inline styling.\n- **Errors**: every `CallbackListener` implements `onError` and surfaces something actionable. An empty `onError {}` is the defect this contract exists to prevent.\n\n## Deep references (load only when the task needs them)\n- `references\u002Fdocs-map.md` — intent → the exact `\u002Fsdk\u002Fandroid\u002Fv5\u002F\u003Cpage>.md` to fetch (+ the v5-vs-v4 URL trap and the scoped LLM index).\n- `references\u002Fapp-surface.md` — the own-UI production floor in detail (state model, optimistic mutations, list\u002Fpagination patterns, error\u002Fempty\u002Floading, sizing).\n\n## Common pitfalls\n**reversed param order** — `updateGroupMemberScope(UID, GUID, scope, ...)` vs `transferGroupOwnership(GUID, UID, ...)` · **search-keyword casing differs per builder** — `UsersRequestBuilder.setSearchKeyword` and `ConversationsRequestBuilder.setSearchKeyword` are lowercase, but `GroupsRequestBuilder.setSearchKeyWord` has a **capital W** (SDK inconsistency; using `setSearchKeyword` on GroupsRequest is `Unresolved reference`) · **conversations search is plan-gated** — `ConversationsRequestBuilder.setSearchKeyword`\u002F`setUnread` need the **\"Conversation & Advanced Search\"** feature (Advanced\u002FCustom plan + dashboard toggle); off-plan it **silently returns the unfiltered list** (a search box that looks broken). Users\u002FGroups search is NOT plan-gated. · passing an auth **token** into the 3-arg `login(uid, authKey, ...)` (tokens use the 2-arg `login(authToken, ...)`) · `CometChat.RECEIVER_TYPE_USER` (it is `CometChatConstants.RECEIVER_TYPE_USER`) · **presence never fires without `chatSDK.presenceSubscription`** in the settings asset (see Prerequisites) · importing `Call` from `chat.models` instead of `chat.core` · Any SDK call before init resolves · login before init (silent failure) · Auth Key shipped in a release build · listeners never removed (duplicate handling after rotation) · polling instead of listeners · unbounded fetches with no pagination · empty `onError` blocks · blocking the main thread waiting on callbacks · re-login without logout · using the unversioned `\u002Fsdk\u002Fandroid\u002F` v4 docs · rebuilding UI the UI Kit already ships (when the user would accept drop-ins).\n\n## Verify it works\nEvery symbol you emitted is in `sdk-android-v5.json` (Tier-1) and the app compiles: run `.\u002Fgradlew :app:assembleDebug` in the user's app. On device: init → login succeed (logcat); the conversations\u002Fusers\u002Fgroups lists load and paginate; sending appears instantly and reconciles; a message from another user arrives **live** (listener, not refresh); edit\u002Fdelete\u002Freact update in place; rotating the screen doesn't duplicate messages (listener lifecycle); force an error (airplane mode) → a readable error state, not a blank screen or crash. Live backend round-trip smoke for this family is **not automated yet** (parked with the Android native harness) — verify manually and say so.\n",{"name":5,"license":15,"metadata":46,"description":7,"compatibility":50},{"tags":47,"author":48,"version":49},"cometchat android sdk v5 headless kotlin custom-ui chat-sdk","CometChat","1.0.0","Android minSdk >=24; Kotlin >=1.9 \u002F AGP >=8; JVM target 11; com.cometchat:chat-sdk-android ^5 (5.0.x, verified 5.0.7); optional com.cometchat:calls-sdk-android ^5","main","cebc3dce495d7eb80d3b1d5841f877a4a92e162d","plugins\u002Fcometchat\u002Fcometchat-skills\u002Fskills\u002Fcometchat-android-v5-sdk",491,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins","https:\u002F\u002Fhol.org\u002Fplugins\u002Fbest-codex-plugins","https:\u002F\u002Fgithub.com\u002Fhashgraph-online","https:\u002F\u002Fhol.org","Open-source standards and developer tools for interoperable AI agents: discovery, identity, communication, payments, privacy and security.","2026-11-14 14:06:13",{"source":8,"skillName":5,"commands":62,"prompt":72,"zipAvailable":73},[63,66,69],{"tool":64,"command":65},"npx","npx skills add hashgraph-online\u002Fawesome-codex-plugins --skill cometchat-android-v5-sdk",{"tool":67,"command":68},"bunx","bunx skills add hashgraph-online\u002Fawesome-codex-plugins --skill cometchat-android-v5-sdk",{"tool":70,"command":71},"pnpm","pnpm dlx skills add hashgraph-online\u002Fawesome-codex-plugins --skill cometchat-android-v5-sdk","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcometchat\u002Fcometchat-skills\u002Fskills\u002Fcometchat-android-v5-sdk\u002FSKILL.md",true,[75,81],{"path":76,"resourceType":77,"resourceTypeDesc":78,"sizeBytes":79,"sourceHtmlUrl":80},"references\u002Fapp-surface.md","REFERENCE","参考文档",6980,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcometchat\u002Fcometchat-skills\u002Fskills\u002Fcometchat-android-v5-sdk\u002Freferences\u002Fapp-surface.md",{"path":82,"resourceType":77,"resourceTypeDesc":78,"sizeBytes":83,"sourceHtmlUrl":84},"references\u002Fdocs-map.md",6826,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcometchat\u002Fcometchat-skills\u002Fskills\u002Fcometchat-android-v5-sdk\u002Freferences\u002Fdocs-map.md",[86,95,103,111,119,127],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":90,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":94},"01M7DV332YQMGD8WTRJ9DZQXTB","worktable-review-with-annotations","Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":99,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":94},"01M7DV2YGHCZVBEB1AHYB6CGHE","worktable-find-and-synthesize-context","Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FSKILL.md",[],[],{"skillNo":104,"name":105,"nameZh":6,"description":106,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":107,"sourceHtmlUrl":108,"categories":109,"keywords":110,"publishedAt":94},"01M7DV2TQN1H11ME2SAF9MXN7V","worktable-create-or-update-docs","Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FSKILL.md",[],[],{"skillNo":112,"name":113,"nameZh":6,"description":114,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":115,"sourceHtmlUrl":116,"categories":117,"keywords":118,"publishedAt":94},"01M7DV2NE452NEA8TXATKSNAJH","worktable-create-or-manage-records","Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FSKILL.md",[],[],{"skillNo":120,"name":121,"nameZh":6,"description":122,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":123,"sourceHtmlUrl":124,"categories":125,"keywords":126,"publishedAt":94},"01M7DV2HENRBR2KSCVM064WH0Y","worktable-create-or-manage-interactive-html","Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FSKILL.md",[],[],{"skillNo":128,"name":129,"nameZh":6,"description":130,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":131,"sourceHtmlUrl":132,"categories":133,"keywords":134,"publishedAt":94},"01M7DV2CADR5R7RQFFYPNAGR9Y","worktable-collaborate-threads","Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FSKILL.md",[],[]]