AGENT SKILL

cometchat-android-v6-compose-components

The closed catalog of CometChat Android v6 UI Kit components for the Jetpack Compose cohort — what exists, the composable import for each, the param shape (onX lambdas, hideX booleans, @Composable slots), and how to pass custom UI into a slot instead of stacking on top. Triggers: 'cometchat compose components', 'is there a X composable', 'cometchat jetpack compose list', 'custom row compose cometchat', 'swap the message bubble compose'.

License 许可
MIT
最近更新
2026-11-14
Stars
★ 1.6k
Forks
491

01 前言 Front Matter

name
cometchat-android-v6-compose-components
license
MIT
metadata
{ "tags": "cometchat android components v6 compose jetpack catalog", "author": "CometChat", "version": "1.0.0" }
description
The closed catalog of CometChat Android v6 UI Kit components for the Jetpack Compose cohort — what exists, the composable import for each, the param shape (onX lambdas, hideX booleans, @Composable slots), and how to pass custom UI into a slot instead of stacking on top. Triggers: 'cometchat compose components', 'is there a X composable', 'cometchat jetpack compose list', 'custom row compose cometchat', 'swap the message bubble compose'.
compatibility
Android minSdk >=28; compileSdk >=36; Kotlin >=2.1; AGP >=8.9.1; JVM target 11; com.cometchat:chatuikit-compose-android ^6 (Jetpack Compose cohort) — 6.1.x, verified 6.1.1; com.cometchat:chat-sdk-android ^5

03 SKILL.md 正文

Ground truth: catalog android-v6.json (293 symbols, from the 6.1.1 source, cross-checked against the published AARs). Param shapes below were read from the Compose source. Fetch anything else from docs (core → references/docs-map.md); never trust memory.

⚠️ This is the Jetpack Compose cohort. Artifact chatuikit-compose-android, namespace com.cometchat.uikit.compose.presentation.*, components are composables configured by named params. The Views cohort (chatuikit-kotlin-android, setX(...) setters) is a separate skill — never install both.

Companion skills (read first)

  • cometchat-android-v6-core — install, credentials, initFromSettings → login → render, the fetch map. Assumed here, never repeated.
  • cometchat-android-v6-compose-placement — where these go · cometchat-android-v6-compose-customization — theming and slots.

Use this skill when

"which composables does the kit have?", "is there a <X> composable?", "what params does the conversations list take?", "can I replace a row / bubble region in Compose?".

Prerequisites & install

⚠️ Build setup (same for Compose): android.useAndroidX=true in gradle.properties. On 6.1.1 that's all: the POMs carry the annotations-java5 exclusion and chat-sdk 5.0.7 is all-AndroidX (verified: a clean Compose app builds with no exclude and Jetifier off). On 6.0.x you ALSO need configurations.all { exclude(group = "org.jetbrains", module = "annotations-java5") } + android.enableJetifier=true, or the FIRST build fails (~40 Duplicate class errors via chatuikit-core-android). Full block: cometchat-android-v6-core §Prerequisites & install. implementation("com.cometchat:chatuikit-compose-android:6.1.1") + buildFeatures { compose = true } + the Kotlin Compose plugin. Same init/login gate as core.

Component catalog (closed list)

The component NAMES are identical to the Views cohort — only the wiring differs. Import pattern: com.cometchat.uikit.compose.presentation.<area>.ui.<Component>. Not listed ⇒ not in the catalog ⇒ does not exist.

⚠️ Three exceptions to that path (verified vs 6.0.6): the calling trio DOES carry .ui in Compose — ...compose.presentation.callbuttons.ui.CometChatCallButtons — which is the OPPOSITE of the Views cohort, so do not carry the Views exception across. And the presentation.shared.* family drops .ui entirely: ...presentation.shared.searchbox.CometChatSearchBox, ...presentation.shared.baseelements.avatar.CometChatAvatar, ...presentation.shared.toolbar.CometChatToolbar. CometChatScopeChange ships in Views only — there is no Compose composable for it.

Conversations & lists — CometChatConversations · CometChatUsers · CometChatGroups · CometChatGroupMembers (+ row composables CometChatConversationListItem, CometChatUsersListItem, CometChatGroupMemberListItem, CometChatGroupsItem). Messaging — CometChatMessageHeader · CometChatMessageList · CometChatMessageComposer · CometChatMessageBubble · CometChatThreadHeader · CometChatThreadScreen · CometChatMessageInformation · CometChatMessageOption · CometChatMessageComposerAction · CometChatReactionList · CometChatMessageReaction · CometChatFlagMessageDialog · CometChatTypingIndicator · CometChatReceipt/CometChatReceipts. Bubbles by type — CometChatTextBubble · CometChatImageBubble/CometChatImagesBubble · CometChatVideoBubble/CometChatVideosBubble · CometChatAudioBubble/CometChatAudiosBubble · CometChatVoiceNoteBubble · CometChatFileBubble/CometChatFilesBubble · CometChatPollBubble · CometChatStickerBubble · CometChatCardBubble · CometChatCollaborativeBubble · CometChatActionBubble · CometChatCallActionBubble · CometChatMeetCallBubble · CometChatDeleteBubble · CometChatAIAssistantBubble. Calling — CometChatCallButtons · CometChatIncomingCall · CometChatOutgoingCall · CometChatOngoingCall · CometChatCallLogs · CometChatCallLogsListItem. Search, AI & notifications — CometChatSearch · CometChatSearchBox · CometChatAIAssistantChatHistory · CometChatAIConversationStarterView · CometChatAISmartRepliesView · CometChatAIConversationSummaryView · CometChatNotificationFeed. Composer add-ons & media — CometChatStickerKeyboard · CometChatEmojiKeyboard · CometChatCreatePoll · CometChatAttachmentTray/CometChatAttachmentTile · CometChatMediaRecorder/CometChatInlineMediaRecorder/CometChatInlineAudioRecorder · CometChatAudioVisualizer/CometChatInlineAudioWaveform · CometChatRichTextToolbar · CometChatSuggestionList · CometChatImagePreview · CometChatImageViewerScreen · CometChatVideoViewerScreen. Building blocks — CometChatAvatar · CometChatBadgeCount · CometChatStatusIndicator · CometChatDate · CometChatToolbar · CometChatDialog/CometChatConfirmDialog · CometChatPopupMenu · CometChatSnackBar · state views CometChatLoadingState/CometChatEmptyState/CometChatErrorState · shimmer CometChatShimmerBox/CometChatShimmerContainer. Non-visual — CometChatUIKit · theming CometChatTheme/CometChatColorScheme/CometChatTypography · CometChatLocalize · CometChatSoundManager · events CometChatEvents + the *Event family · formatters CometChatTextFormatter/CometChatMentionsFormatter/CometChatRichTextFormatter.

⚠️ Emitting ANY calling component requires the calls artifact and "uiKit": { "enableCalling": true } in assets/cometchat-settings.json — otherwise it crashes on device while compiling fine (the compile gate cannot catch it). Full artifact/flag/result matrix: docs call-logs page. → cometchat-android-v6-calls.

Param shape — how a Compose component is configured

Three conventions, consistent across the cohort (verified vs 6.0.5):

  • onX lambdas for events — onItemClick: ((Conversation) -> Unit)?, onSearchClick: (() -> Unit)?, onBackPress: (() -> Unit)?, onItemLongClick, onError: ((CometChatException) -> Unit)?, onLoad, onEmpty, onSelection.
  • hideX booleans for affordances — hideSearchBox, hideToolbar, hideBackIcon, hideUserStatus, hideReceipts, hideDeleteOption, hideLoadingState, hideEmptyState, hideErrorState. (Views uses visibility setters; Compose hides.)
  • @Composable slots for custom UI — e.g. itemView, leadingView, subtitleView, trailingView, each (@Composable (Conversation, TypingIndicator?) -> Unit)?. Plus modifier: Modifier, style: CometChat<X>Style = ...default(), and request-builder params (conversationsRequestBuilder).
import com.cometchat.uikit.compose.presentation.conversations.ui.CometChatConversations

CometChatConversations(
    modifier = Modifier.fillMaxSize(),
    title = "Chats",
    onItemClick = { conversation -> /* navigate */ },
    onSearchClick = { /* open search route */ },
)

Size it to fill. The kit fills the box you give it — a wrap_content-equivalent (unbounded height, or a Column without weight) renders a sliver (core/references/layout.md).

Key param differences from the Views cohort

Concern Views Compose
thread scope setParentMessageId(Long) parentMessageId: Long = -1 param on list AND composer
thread header setParentMessage(BaseMessage) parentMessage: BaseMessage (required param)
search scope setSearchIn(List<SearchScope>) searchScopes: List<SearchScope>
search target setUid / setGuid uid: String? / guid: String?
affordances visibility setters hideX: Boolean
slots ViewHolder listeners @Composable lambdas
Everything else (user, group, onThreadRepliesClick: ((BaseMessage) -> Unit)?) matches by name.

Custom UI goes IN a slot, not on top

Pass a @Composable to the component's slot param (itemView, leadingView, subtitleView, trailingView), use options/addOptions for the long-press menu, and setBubbleFactories-equivalent factories for custom message TYPES. Never stack your own composable over a kit component, and never re-implement a list the kit ships. Detail: cometchat-android-v6-compose-customization.

⚠️ A slot with a DEFAULT implementation REPLACES it — CometChatMessageHeader auxiliaryView vs trailingView (verified vs installed 6.0.5 source + on device). The header's auxiliaryView substitutes the built-in DefaultAuxiliaryView, which is what HOSTS the voice/video call buttons — so putting a custom icon there silently removes them. Extra header icons belong in trailingView, a separate slot that keeps the auxiliary area (and its call buttons) intact. Use auxiliaryView only when you intend to REPLACE the call-button area (and re-render CometChatCallButtons yourself if you still want calling).

Group member permissions — the kit enforces them, don't re-implement

CometChatGroupMembers gates its own long-press menu (verified vs 6.0.5 and 6.1.1 GroupMembersPermissionUtils). Rely on it:

Logged-in user Menu opens on Cannot act on
Owner (uid == group.owner) anyone but themselves —
Admin (group.scope) participants, moderators other admins, owner
Moderator participants only moderators, admins, owner
Participant nobody everyone

Per item on 6.1.1: kick and ban follow the table (a moderator can kick, not ban); change scope is owner (anyone but self) and admin (moderators, participants) only. 6.0.x gave admins kick/ban but no scope change. Scope strings: CometChatConstants.SCOPE_ADMIN / SCOPE_MODERATOR / SCOPE_PARTICIPANT. Never hand-roll these checks or hide the component behind your own role logic — you will drift from the kit.

⚠️ Reversed parameter order between the two ownership APIs: CometChat.updateGroupMemberScope(UID, GUID, scope, listener) but CometChat.transferGroupOwnership(GUID, UID, listener).

Components that do NOT exist in v6

No combined shell — CometChatConversationsWithMessages, CometChatUsersWithMessages, CometChatGroupsWithMessages, CometChatUI are v4-era. ⚠️ CometChatMessageTemplate is absent from the shipped 6.0.5 and 6.1.1 artifacts (logged internally) — use bubble factories.

Common pitfalls

Mixing cohorts (Views artifact in a Compose app) · using a setX(...) setter on a composable · unbounded height (sliver) · showSearchBar-style thinking (Compose uses hideSearchBox) · overlaying instead of slotting · a custom header icon in CometChatMessageHeader auxiliaryView (replaces the call-button host — use trailingView) · emitting CometChatMessageTemplate · guessing a param instead of fetching the page's Compose tab.

Verify it works

Every composable you emitted is in the list above (Tier-1) and it compiles — ./gradlew :app:assembleDebug # in YOUR app (native-fence.mjs is a pack-repo gate, not installed by the CLI). On device: full-size render with the kit's own loading/empty state, slotted composables INSIDE the component.

04 同仓库更多 Skills

hashgraph-online
hashgraph-online/awesome-codex-plugins

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.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

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.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

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.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

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.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

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.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

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.

★ 1.6k