@cometchat/skills 4.3.0 → 4.4.0

package/skills/cometchat-flutter-v6-calls/references/advanced-features.md

@@ -0,0 +1,89 @@
+# Flutter V6 — advanced in-call features (Recording, Virtual Background, Audio Modes, PiP, Screen-share)
+
+V6 folds calls into `cometchat_chat_uikit:^6.0` (depends transitively on `cometchat_calls_sdk >=5.0.2`). Every symbol below is verified against `cometchat_calls_sdk-5.0.2`'s `CallSession`. All controls hang off the active session singleton:
+
+```dart
+final session = CallSession.getInstance();   // active call session (after onSuccess)
+```
+
+State changes arrive on `MediaEventListeners` / `ParticipantEventListeners` (register the same way this skill already registers `SessionStatusListeners` — via the session after the join succeeds, and remove them in `dispose`).
+
+---
+
+## 1. Recording
+
+Server-gated — enable recording for the app in the CometChat dashboard first.
+
+```dart
+await CallSession.getInstance().startRecording();
+await CallSession.getInstance().stopRecording();
+```
+
+React to state via `MediaEventListeners.onRecordingStarted()` / `onRecordingStopped()`.
+
+Verified: `CallSession.startRecording()` / `stopRecording()`, `MediaEventListeners.onRecordingStarted()`.
+
+---
+
+## 2. Virtual Background
+
+Flutter DOES support virtual background (unlike native iOS/Android). The SDK opens the kit's built-in settings panel (blur / image / clear); you don't build the picker:
+
+```dart
+await CallSession.getInstance().openVirtualBackgroundSettingsPanel();
+```
+
+Verified: `CallSession.openVirtualBackgroundSettingsPanel()`.
+
+---
+
+## 3. Audio modes
+
+```dart
+await CallSession.getInstance().setAudioModeType(AudioMode.speaker);
+// AudioMode.speaker | AudioMode.earpiece | AudioMode.bluetooth  (no .headphones on Flutter)
+```
+
+React via `MediaEventListeners.onAudioModeChanged(...)`.
+
+Verified: `CallSession.setAudioModeType(AudioMode)`; `enum AudioMode { speaker, earpiece, bluetooth }`.
+
+---
+
+## 4. Picture-in-Picture
+
+- **In-call compact layout:** `enablePictureInPictureLayout()` / `disablePictureInPictureLayout()`.
+- **System PiP** (OS floats the call when the user leaves the app): gate it on `isPipSupported()` then `enterPipMode()`.
+
+```dart
+final session = CallSession.getInstance();
+await session.enablePictureInPictureLayout();
+// system PiP
+if (await session.isPipSupported()) {
+  await session.enterPipMode();
+}
+```
+
+Verified: `CallSession.enablePictureInPictureLayout()` / `disablePictureInPictureLayout()` / `enterPipMode()` / `isPipSupported()`.
+
+---
+
+## 5. Screen sharing — receive only
+
+Flutter (like iOS/Android) cannot locally INITIATE screen share — it renders a remote participant's shared screen inside the call grid automatically. Wire a listener only to react:
+
+```dart
+// ParticipantEventListeners
+@override
+void onParticipantStartedScreenShare(Participant participant) { /* e.g. switch layout */ }
+@override
+void onParticipantStoppedScreenShare(Participant participant) { }
+```
+
+Verified: `ParticipantEventListeners.onParticipantStartedScreenShare(Participant)` / `onParticipantStoppedScreenShare(Participant)`. No local-initiation symbol exists — do not author one.
+
+---
+
+## Camera (cross-reference)
+
+Front/back switch + on/off is in `references/device-management.md` (`CallSession.switchCamera()`). Custom Control Panel: the V6 kit owns the in-call control surface; per-button hiding is via the session/call settings, not a separate panel API.

package/skills/cometchat-flutter-v6-calls/references/call-layouts.md

@@ -11,26 +11,29 @@ Same SDK shape; Bloc-driven layout state.
 
 A layout switcher is a great fit for a Cubit since it has only one piece of state with simple updates.
 
+`setLayout` is an **instance method on the `CallSession` singleton** (`cometchat_calls_sdk-5.0.2` `src/call_session.dart:394`), and the layout enum is `LayoutType { tile, sidebar, spotlight }` (`src/enums/layout_type.dart`) — there is no `CallLayout` type and no static `CometChatCalls.setLayout`.
+
 ```dart
-class CallLayoutCubit extends Cubit<CallLayout> {
-  CallLayoutCubit() : super(CallLayout.tile);
+class CallLayoutCubit extends Cubit<LayoutType> {
+  CallLayoutCubit() : super(LayoutType.tile);
 
-  void set(CallLayout next) {
-    CometChatCalls.setLayout(next);
+  void set(LayoutType next) {
+    CallSession.getInstance()?.setLayout(next);
     emit(next);
   }
 
-  void onSDKChanged(CallLayout next) {
+  void onSDKChanged(LayoutType next) {
     emit(next);  // already changed by kit's switcher; just sync
   }
 }
 ```
 
-Hook the SDK event:
+Hook the SDK event — `onCallLayoutChanged` is on `LayoutListeners`, attached via the `layoutListener` setter (`src/call_session.dart:98`):
 
 ```dart
+// e.g. CallSession.getInstance()?.layoutListener = myLayoutListener;
 @override
-void onCallLayoutChanged(CallLayout layout) {
+void onCallLayoutChanged(LayoutType layout) {
   context.read<CallLayoutCubit>().onSDKChanged(layout);
 }
 ```
@@ -45,12 +48,12 @@ class LayoutSwitcher extends StatelessWidget {
 
   @override
   Widget build(BuildContext context) {
-    return BlocBuilder<CallLayoutCubit, CallLayout>(
-      builder: (context, layout) => SegmentedButton<CallLayout>(
+    return BlocBuilder<CallLayoutCubit, LayoutType>(
+      builder: (context, layout) => SegmentedButton<LayoutType>(
         segments: const [
-          ButtonSegment(value: CallLayout.tile, label: Text('Tile')),
-          ButtonSegment(value: CallLayout.sidebar, label: Text('Sidebar')),
-          ButtonSegment(value: CallLayout.spotlight, label: Text('Spotlight')),
+          ButtonSegment(value: LayoutType.tile, label: Text('Tile')),
+          ButtonSegment(value: LayoutType.sidebar, label: Text('Sidebar')),
+          ButtonSegment(value: LayoutType.spotlight, label: Text('Spotlight')),
         ],
         selected: {layout},
         onSelectionChanged: (set) {

package/skills/cometchat-flutter-v6-calls/references/call-session.md

@@ -6,7 +6,7 @@ Bloc-driven adaptation of the upstream sample. Same SDK underneath as V5 (`comet
 - `cometchat-flutter-v5-calls/references/call-session.md` — V5 sister, canonical SDK API surface (callback shape, `SessionSettingsBuilder`, `SessionStatusListeners`)
 - `cometchat-react-calls/references/call-session.md` — full cross-platform architecture
 
-**Source of truth:** `~/Downloads/calls-sdk/calls-sdk-flutter-5/sample-apps/cometchat-calls-sample-app-flutter/lib/screens/call_screen.dart` (the SDK version is the same; only the state-management primitive differs between v5 GetX and v6 Bloc).
+**Source of truth:** `calls-sdk-flutter-5/sample-apps/cometchat-calls-sample-app-flutter/lib/screens/call_screen.dart` (the SDK version is the same; only the state-management primitive differs between v5 GetX and v6 Bloc).
 
 ---
 
@@ -225,5 +225,5 @@ V5 sister rules apply, plus V6-specific:
 - `cometchat-flutter-v5-calls/references/call-session.md` — V5 sister + canonical SDK API
 - `cometchat-flutter-v6-calls/SKILL.md` — V6 Bloc patterns
 - `cometchat-flutter-v6-calls/references/share-invite.md` — deep-link config
-- Upstream sample — `~/Downloads/calls-sdk/calls-sdk-flutter-5/sample-apps/cometchat-calls-sample-app-flutter/lib/screens/call_screen.dart` (SDK is the same)
+- Upstream sample — `calls-sdk-flutter-5/sample-apps/cometchat-calls-sample-app-flutter/lib/screens/call_screen.dart` (SDK is the same)
 - Canonical docs: https://www.cometchat.com/docs/calls/flutter/join-session

package/skills/cometchat-flutter-v6-calls/references/device-management.md

@@ -9,7 +9,10 @@ Same SDK API as V5; Bloc-based state.
 
 ## SDK API
 
-Same as V5. `CometChatCalls.switchCamera()` and `CometChatCalls.setSpeakerEnabled(bool)`.
+These are **instance methods on the `CallSession` singleton**, not static on `CometChatCalls` (verified `cometchat_calls_sdk-5.0.2`):
+
+- `CallSession.getInstance()?.switchCamera()` — front/back flip (`src/call_session.dart:205`).
+- Audio output is **not** a `setSpeakerEnabled(bool)` toggle (no such method exists). Use `CallSession.getInstance()?.setAudioModeType(AudioMode)` (`src/call_session.dart:381`), where `AudioMode` is the enum `{ speaker, earpiece, bluetooth }` (`src/enums/audio_mode.dart`).
 
 ---
 
@@ -36,11 +39,14 @@ class DeviceBloc extends Bloc<DeviceEvent, DeviceState> {
   DeviceBloc() : super(const DeviceState()) {
     on<ToggleSpeaker>((event, emit) {
       final next = !state.speakerOn;
-      CometChatCalls.setSpeakerEnabled(next);
+      // No setSpeakerEnabled(bool); route audio via the AudioMode enum.
+      CallSession.getInstance()?.setAudioModeType(
+        next ? AudioMode.speaker : AudioMode.earpiece,
+      );
       emit(state.copyWith(speakerOn: next));
     });
     on<FlipCamera>((event, emit) {
-      CometChatCalls.switchCamera();
+      CallSession.getInstance()?.switchCamera();
       emit(state.copyWith(cameraIsBack: !state.cameraIsBack));
     });
   }

package/skills/cometchat-flutter-v6-calls/references/group-calls.md

@@ -6,7 +6,7 @@ By-design kit behavior — same semantic across all CometChat kits.
 
 **Canonical docs:** https://www.cometchat.com/docs/calls/flutter/group-calls
 
-V6 specifics: Flutter V6 folds calls into `cometchat_chat_uikit ^6.0.0-beta2` (no separate calls package). Bloc-based state. **At v6.0.0-beta2, the outgoing-call → in-call transition is broken for 1:1 calls** (vendor bug — see SKILL.md §1.7); this affects group meetings too if customers use the kit's outgoing-call UI. The custom-UI approach is more reliable on V6 today.
+V6 specifics: Flutter V6 folds calls into `cometchat_chat_uikit ^6.0.1` (no separate calls package). Bloc-based state. The outgoing→in-call transition bug that existed in `6.0.0-beta2` is **FIXED in 6.0.1 GA** (see SKILL.md §1.7) — the kit-driven path now works for groups too, **provided `navigatorKey: CallNavigationContext.navigatorKey` is wired on your MaterialApp**. The custom-UI path below remains a valid alternative (and is required if you render your own call surface).
 
 ---
 
@@ -39,7 +39,7 @@ Caller (uidA, member of groupX)        CometChat                Receivers (membe
 
 1. **Group calls broadcast a custom message; they do NOT use the call listener.** Custom UI must add a `MessageListener`.
 2. **Session ID = group GUID.** Persistent.
-3. **V6 vendor bug applies to groups too** (SKILL.md §1.7) — kit's outgoing-call screen does not reliably transition to ongoing-call surface. Prefer custom UI for groups on v6.0.0-beta2.
+3. **`navigatorKey` is mandatory for the kit's group call screen** (SKILL.md §1.7). With it wired, the kit's outgoing→ongoing transition works on 6.0.1 (the beta2 bug is fixed). Without it, the outgoing-call screen never renders — this is the one remaining requirement, not a reason to avoid the kit path.
 4. **`navigatorKey: CallNavigationContext.navigatorKey` required on MaterialApp** if using ANY kit-driven call UI path (group or 1:1) — same as the SKILL rule.
 5. **No `CometChat.endCall` for groups.** Use `CometChatUIKitCalls.endSession()` only.
 
@@ -57,9 +57,9 @@ CometChatCallButtons(
 
 Tap → kit sends meeting `CustomMessage` + opens outgoing-call screen.
 
-> **⚠️ At v6.0.0-beta2, the outgoing→in-call transition is broken** (vendor — SKILL §1.7). Caller may see "Calling..." indefinitely after kit-driven group call. **Workaround**: use the custom-UI path below until vendor fix lands.
+> **✅ On 6.0.1 the outgoing→in-call transition works** once `navigatorKey: CallNavigationContext.navigatorKey` is wired on MaterialApp (SKILL §1.7). Without that wiring the caller sees "Calling..." indefinitely — so wire it. The custom-UI path below is an alternative for apps that render their own call surface.
 
-## Caller side — custom UI (RECOMMENDED on v6.0.0-beta2)
+## Caller side — custom UI (alternative to the kit path)
 
 ```dart
 import 'package:flutter_chat_sdk/flutter_chat_sdk.dart';
@@ -95,7 +95,7 @@ Future<void> startGroupCall(BuildContext context, String groupGuid, String callT
 }
 ```
 
-Then in your custom `/ongoing-call` screen, call `CometChatUIKitCalls.startSession(callToken, callSettings, ...)` against your own RTC view — same primitives the kit uses internally, but you control the navigation.
+Then in your custom `/ongoing-call` screen, join the session against your own RTC view — same primitives the kit uses internally, but you control the navigation. On the raw Calls SDK the current API is the **named-parameter** `CometChatCalls.joinSession(callToken:` (or `sessionId:`)`, sessionSettings:, onSuccess:, onError:)` (`cometchat_calls_sdk-5.0.2` `src/plugin/cometchatcalls.dart:735`). The old positional `CometChatCalls.startSession(...)` is `@Deprecated` — do not use it. (If you stay on the kit wrapper `CometChatUIKitCalls`, use its kit-side join API — that is kit-side, not the raw SDK.)
 
 ---
 
@@ -103,9 +103,9 @@ Then in your custom `/ongoing-call` screen, call `CometChatUIKitCalls.startSessi
 
 `CometChatMessageList(group: group)` (or whichever message-list widget V6 ships) auto-renders the meeting message as a "Join meeting" card. Tap → kit calls `generateToken` + pushes the ongoing-call screen.
 
-> Same v6.0.0-beta2 caveat applies — if the kit's ongoing-call transition is broken, receivers may also see "Connecting…" indefinitely. Prefer custom join flow.
+> Same `navigatorKey` requirement applies on the receiver side for the kit-driven join flow on 6.0.1. With it wired, the join→ongoing transition works; the custom join flow below is the alternative.
 
-## Receiver side — custom UI (RECOMMENDED)
+## Receiver side — custom UI (alternative)
 
 ```dart
 import 'package:flutter_chat_sdk/flutter_chat_sdk.dart';
@@ -145,9 +145,9 @@ Register AFTER `CometChatUIKit.login` succeeds (e.g. in the auth Bloc's `_onLogi
 
 ## Edge cases
 
-### V6 vendor blocker context
+### V6 calls status (resolved)
 
-This SKILL.md notes that V6 calling is partially-blocked at v6.0.0-beta2 — specifically the outgoing-call → in-call screen transition. **Production Flutter customers should stay on V5** for both 1:1 and group calls until the vendor fixes the V6 BLoC handler. Group calls on V6 inherit the same blocker.
+The beta2 outgoing-call → in-call transition bug is **FIXED in 6.0.1 GA** (validated 2026-05-27 on Pixel 3 — see SKILL.md §1.7). Production Flutter customers can use V6 for both 1:1 and group calls; the only requirement is the `navigatorKey: CallNavigationContext.navigatorKey` MaterialApp wiring.
 
 ### Late joining
 
@@ -162,7 +162,7 @@ Meeting `CustomMessage.metadata.pushNotification = "meeting"` — delivered as r
 ## Anti-patterns
 
 1. **Only `CometChat.addCallListener` registered.** Won't fire for groups.
-2. **Relying on V6 kit's outgoing-call screen for groups on v6.0.0-beta2.** Vendor blocker. Use custom navigation.
+2. **Using the kit's group call screen WITHOUT wiring `navigatorKey`.** The screen never renders. Wire `CallNavigationContext.navigatorKey` (the beta2 transition bug itself is fixed in 6.0.1).
 3. **`CometChat.endCall(sessionId)` after group hangup.** No call entity.
 4. **`MessageListener` registered before login.** Silently dropped.
 5. **Skipping `navigatorKey` setup** for any kit-driven call path.

package/skills/cometchat-flutter-v6-calls/references/idle-timeout.md

@@ -8,16 +8,21 @@ Same SDK API as V5; Bloc-based wiring. Read `cometchat-flutter-v5-calls/referenc
 
 ## SDK API + listener bridge
 
-Same `CallSettingsBuilder` setters as V5. Listener via Bloc bridge (cf. `cometchat-flutter-v6-calls/references/raise-hand.md`):
+Set the idle period on `SessionSettingsBuilder().setIdleTimeoutPeriod(int)` (seconds — `cometchat_calls_sdk-5.0.2` `src/builder/session_settings.dart:185`). The monolithic `CometChatCallsEventsListener` is `@Deprecated` in 5.0.2 (`src/listener/cometchat_calls_events_listener.dart:16`) — use the v5 split listeners instead. `onSessionTimedOut()` lives on `SessionStatusListeners` (`src/listener/session_status_listeners.dart`), registered via `CallSession.getInstance()?.addSessionStatusListener(...)` (`src/call_session.dart:66`). There is no `CometChatCalls.addCallEventListener`.
+
+Listener via Bloc bridge (cf. `cometchat-flutter-v6-calls/references/raise-hand.md`):
 
 ```dart
+// Apply the idle timeout when building session settings:
+final settings = SessionSettingsBuilder().setIdleTimeoutPeriod(180).build();
+
 abstract class CallEvent {}
 class _SessionTimedOut extends CallEvent {}
 
-class CallBloc extends Bloc<CallEvent, CallState> implements CometChatCallsEventsListener {
+class CallBloc extends Bloc<CallEvent, CallState> implements SessionStatusListeners {
   CallBloc() : super(const CallState()) {
     on<_SessionTimedOut>(_onTimedOut);
-    CometChatCalls.addCallEventListener('call-bloc', this);
+    CallSession.getInstance()?.addSessionStatusListener(this);
   }
 
   @override
@@ -29,9 +34,11 @@ class CallBloc extends Bloc<CallEvent, CallState> implements CometChatCallsEvent
     emit(state.copyWith(timedOut: true));
   }
 
+  // ... other SessionStatusListeners callbacks (onSessionJoined/onSessionLeft/...) as no-ops
+
   @override
   Future<void> close() {
-    CometChatCalls.removeCallEventListener('call-bloc');
+    CallSession.getInstance()?.removeSessionStatusListener(this);
     return super.close();
   }
 }
@@ -64,10 +71,11 @@ Identical code; cite V5 sister reference.
 
 ## Verification checklist
 
-- [ ] CallSettingsBuilder sets both idle periods
-- [ ] CallBloc bridges `onSessionTimedOut` to `_SessionTimedOut` event
+- [ ] `SessionSettingsBuilder().setIdleTimeoutPeriod(seconds)` sets the idle period
+- [ ] CallBloc implements `SessionStatusListeners` and bridges `onSessionTimedOut` to `_SessionTimedOut`
+- [ ] Listener registered via `CallSession.getInstance()?.addSessionStatusListener(this)`
 - [ ] BlocListener with `listenWhen` triggers nav + snackbar
-- [ ] Bloc `close()` removes the listener
+- [ ] Bloc `close()` removes the listener via `removeSessionStatusListener(this)`
 - [ ] Real-device smoke: same as V5
 
 ---

package/skills/cometchat-flutter-v6-calls/references/in-call-chat.md

@@ -41,7 +41,9 @@ class InCallChatBloc extends Bloc<InCallChatEvent, InCallChatState> {
 
   void _onOpen(OpenChat event, Emitter<InCallChatState> emit) {
     emit(state.copyWith(open: true, unread: 0));
-    CometChatCalls.setChatButtonUnreadCount(0);
+    // setChatButtonUnreadCount is an instance method on CallSession
+    // (cometchat_calls_sdk-5.0.2 src/call_session.dart:489), not static.
+    CallSession.getInstance()?.setChatButtonUnreadCount(0);
   }
 
   void _onClose(OpenChat event, Emitter<InCallChatState> emit) {
@@ -52,7 +54,7 @@ class InCallChatBloc extends Bloc<InCallChatEvent, InCallChatState> {
     if (state.open) return;
     final next = state.unread + 1;
     emit(state.copyWith(unread: next));
-    CometChatCalls.setChatButtonUnreadCount(next);
+    CallSession.getInstance()?.setChatButtonUnreadCount(next);
   }
 }
 ```
@@ -61,9 +63,10 @@ class InCallChatBloc extends Bloc<InCallChatEvent, InCallChatState> {
 
 ## Triggering open from SDK event
 
-In your `CometChatCallsEventsListener` impl:
+`onChatButtonClicked()` is on `ButtonClickListeners` (v5 split listener), registered via `CallSession.getInstance()?.addButtonClickListener(...)` — NOT the deprecated `CometChatCallsEventsListener`:
 
 ```dart
+// class ... implements ButtonClickListeners
 @override
 void onChatButtonClicked() {
   context.read<InCallChatBloc>().add(OpenChat());

package/skills/cometchat-flutter-v6-calls/references/raise-hand.md

@@ -9,20 +9,27 @@ Same SDK conceptual API as V5; the difference is state management — V6 uses `f
 
 ## SDK API (same as V5)
 
+Raise/lower hand are **instance methods on the `CallSession` singleton**, NOT static on `CometChatCalls` (verified `cometchat_calls_sdk-5.0.2` `src/call_session.dart:292,306`; the static `CometChatCalls` class has no `raiseHand`/`lowerHand`). Participant hand events arrive via `ParticipantEventListeners`, registered through `CallSession.getInstance()?.addParticipantEventListener(...)` (`src/call_session.dart:78`) — there is no `CometChatCalls.addCallEventListener`.
+
 ```dart
 import 'package:cometchat_chat_uikit/cometchat_chat_uikit.dart';
 import 'package:cometchat_chat_uikit/cometchat_calls_uikit.dart';
 
-CometChatCalls.raiseHand();
-CometChatCalls.lowerHand();
+CallSession.getInstance()?.raiseHand();
+CallSession.getInstance()?.lowerHand();
+
+// Register a ParticipantEventListeners implementation:
+CallSession.getInstance()?.addParticipantEventListener(myListener);
 
-// In a CometChatCallsEventsListener implementation:
+// In your ParticipantEventListeners implementation:
 @override
 void onParticipantHandRaised(Participant p) { /* ... */ }
 @override
 void onParticipantHandLowered(Participant p) { /* ... */ }
 
-final settings = CallSettingsBuilder()..hideRaiseHandButton = true;
+// hideRaiseHandButton is a METHOD on the (non-deprecated) SessionSettingsBuilder.
+// `CallSettingsBuilder` is @Deprecated in 5.0.2 (src/builder/call_settings.dart:208).
+final settings = SessionSettingsBuilder().hideRaiseHandButton(true).build();
 ```
 
 ---
@@ -78,22 +85,22 @@ class _ParticipantLowered extends RaiseHandEvent {
 
 ```dart
 class RaiseHandBloc extends Bloc<RaiseHandEvent, RaiseHandState>
-    implements CometChatCallsEventsListener {
+    implements ParticipantEventListeners {
 
   RaiseHandBloc() : super(const RaiseHandState()) {
     on<ToggleHand>(_onToggle);
     on<_ParticipantRaised>(_onParticipantRaised);
     on<_ParticipantLowered>(_onParticipantLowered);
 
-    // Self-register as the call event listener
-    CometChatCalls.addCallEventListener('raise-hand-bloc', this);
+    // Self-register as the participant event listener (v5 split listener).
+    CallSession.getInstance()?.addParticipantEventListener(this);
   }
 
   void _onToggle(ToggleHand event, Emitter<RaiseHandState> emit) {
     if (state.localRaised) {
-      CometChatCalls.lowerHand();
+      CallSession.getInstance()?.lowerHand();
     } else {
-      CometChatCalls.raiseHand();
+      CallSession.getInstance()?.raiseHand();
     }
     emit(state.copyWith(localRaised: !state.localRaised));
   }
@@ -114,7 +121,7 @@ class RaiseHandBloc extends Bloc<RaiseHandEvent, RaiseHandState>
     emit(state.copyWith(raised: next));
   }
 
-  // CometChatCallsEventsListener — bridge to Bloc events
+  // ParticipantEventListeners — bridge to Bloc events
   @override
   void onParticipantHandRaised(Participant p) {
     add(_ParticipantRaised(p));
@@ -125,11 +132,11 @@ class RaiseHandBloc extends Bloc<RaiseHandEvent, RaiseHandState>
     add(_ParticipantLowered(p));
   }
 
-  // ... implement other CometChatCallsEventsListener methods (no-ops or pass-through)
+  // ... implement other ParticipantEventListeners methods (no-ops or pass-through)
 
   @override
   Future<void> close() {
-    CometChatCalls.removeCallEventListener('raise-hand-bloc');
+    CallSession.getInstance()?.removeParticipantEventListener(this);
     return super.close();
   }
 }
@@ -239,7 +246,7 @@ Web sister reference rules apply, plus V6-specific:
 
 1. **`buildWhen` omitted.** Every state change rebuilds every BlocBuilder — lots of unnecessary work during a call. Add `buildWhen` for narrow rebuilds.
 2. **Mutating `state.raised` directly** instead of creating a new list. `Equatable` props compare via `==`; mutation doesn't trigger rebuild.
-3. **Calling `CometChatCalls.raiseHand()` outside the bloc.** Bypasses the state machine; UI doesn't update. Always go through `add(ToggleHand())`.
+3. **Calling `CallSession.getInstance()?.raiseHand()` outside the bloc.** Bypasses the state machine; UI doesn't update. Always go through `add(ToggleHand())`.
 4. **Adding the SDK listener in `initState`** instead of the bloc constructor. Component-level lifecycle ≠ Bloc lifecycle. Bloc `close()` is the canonical place to clean up.
 
 ---
@@ -248,12 +255,12 @@ Web sister reference rules apply, plus V6-specific:
 
 - [ ] `RaiseHandBloc` extends `Bloc<RaiseHandEvent, RaiseHandState>`
 - [ ] `RaiseHandState` extends `Equatable` with proper `props`
-- [ ] Bloc registers itself as `CometChatCallsEventsListener` in constructor
-- [ ] Bloc `close()` removes the listener
+- [ ] Bloc registers itself as `ParticipantEventListeners` via `CallSession.getInstance()?.addParticipantEventListener(this)` in constructor
+- [ ] Bloc `close()` removes the listener via `removeParticipantEventListener(this)`
 - [ ] `BlocProvider(create:)` scopes the bloc to the call screen
 - [ ] `buildWhen` on every BlocBuilder narrows rebuilds
 - [ ] `Semantics` + `SemanticsService.announce` for a11y
-- [ ] `hideRaiseHandButton: true` in CallSettings if custom UI
+- [ ] `SessionSettingsBuilder().hideRaiseHandButton(true)` if custom UI
 - [ ] Real-device smoke: 3 devices (iOS + Android), 2 raise hands, host sees both
 - [ ] Hot-reload smoke: trigger raise → save code → bloc state survives (bloc is created via `create:`, persists across hot reload)
 

package/skills/cometchat-flutter-v6-components/SKILL.md

@@ -7,14 +7,15 @@ description: >
   outgoing, ongoing, call logs), and shared views (avatar, badge, receipt, reactions,
   bubbles, list base, search, status indicator).
 license: "MIT"
-compatibility: "cometchat_chat_uikit ^6.0.0-beta2; flutter >=2.5.0"
-allowed-tools: "shell, file-read, file-search, file-list, grep"
+compatibility: "cometchat_chat_uikit ^6.0.1; flutter >=2.5.0"
 metadata:
   author: "CometChat"
   version: "3.0.0"
   tags: "cometchat flutter components widgets catalog props"
 ---
 
+> **Ground truth:** `cometchat_chat_uikit: ^6.0` component catalog (pub-cache source) + `docs/ui-kit/flutter`. **Official docs:** https://www.cometchat.com/docs/ui-kit/flutter/components-overview · **Docs MCP:** `claude mcp add --transport http cometchat-docs https://www.cometchat.com/docs/mcp` (or fetch the URL directly without MCP). Verify symbols against the installed package/source before relying on them.
+
 # CometChat Flutter UIKit v6 — Widget Catalog
 
 Canonical reference for every public widget in `cometchat_chat_uikit`. Look up names, props, view slots, and style classes here before writing code.
@@ -23,7 +24,9 @@ Canonical reference for every public widget in `cometchat_chat_uikit`. Look up n
 
 ## Rule: NEVER_INVENT_NAMES
 
-Always use exact widget names from this catalog. Do not invent names like `CometChatChat`, `CometChatMessenger`, `CometChatChatList`, `CometChatContactList`, `CometChatMessageView`, or `CometChatUserList` — they don't exist.
+> ⛔ **Only the widgets in THIS catalog exist — do not invent or recall names from v4/older memory.** Before emitting any `CometChat*` widget, confirm it's listed below; if it's not here, it doesn't exist (→ "isn't a function/class" / undefined-name compile error). Do not invent names like `CometChatChat`, `CometChatMessenger`, `CometChatChatList`, `CometChatContactList`, `CometChatMessageView`, or `CometChatUserList` — they don't exist.
+>
+> **There is no all-in-one widget.** The v4-era composites `CometChatConversationsWithMessages` / `CometChatUsersWithMessages` / `CometChatGroupsWithMessages` / `CometChatMessages` and the `CometChatUI` god-widget were **removed in v6 and do NOT exist in `cometchat_chat_uikit` ^6.0** (verified against the v6 kit source — these names survive only in the CHANGELOG's removal history). Compose a two-pane experience yourself: `CometChatConversations` (list) → on `onItemTap`, push a messages screen hosting `CometChatMessageHeader` + `CometChatMessageList` + `CometChatMessageComposer` for the selected `User`/`Group` (each takes `user:` **or** `group:`, never both). See the Golden Path in `cometchat-flutter-v6-core`.
 
 ---
 
@@ -54,10 +57,10 @@ Displays messages for a 1:1 or group conversation with real-time updates, reacti
 Text input with attachments, voice recording, rich text toolbar, mentions, and AI features.
 
 - **Location:** `chat_ui/src/message_composer/widgets/cometchat_message_composer.dart`
-- **Key props:** `user`, `group`, `parentMessageId`, `placeholderText`, `disableTypingEvents`, `text`, `onChange`, `onSendButtonTap`, `textFormatters`, `disableMentions`, `hideVoiceRecordingButton`, `richTextConfiguration`
+- **Key props:** `user`, `group`, `parentMessageId`, `placeholderText`, `disableTypingEvents`, `text`, `onChange`, `onSendButtonTap`, `textFormatters`, `disableMentions`, `hideVoiceRecordingButton`, `enableRichTextFormatting`, `richTextToolbarView` (there is NO `richTextConfiguration` prop)
 - **View slots:** `auxiliaryButtonView`, `secondaryButtonView`, `sendButtonView`, `headerView`, `footerView`, `richTextToolbarView`
 - **Style:** `CometChatMessageComposerStyle`
-- **Note:** Scaffold must set `resizeToAvoidBottomInset: false` — composer handles keyboard internally.
+- **Note:** On `^6.0.1`, the hosting Scaffold should use `resizeToAvoidBottomInset: true` (or omit it — `true` is the default). The composer clamps the keyboard height to `viewInsets` (kit fix ENG-34434), so `true` does not double-compensate. `false` was only the pre-6.0.1 workaround; if you see a double keyboard gap, upgrade the kit.
 
 ### CometChatMessageHeader
 
@@ -108,6 +111,16 @@ Full-screen search across conversations and messages with filter chips and dual-
 - **View slots:** `conversationItemView(ctx, Conversation)`, `conversationSubtitleView(ctx, Conversation)`, `conversationLeadingView(ctx, Conversation)`, `conversationTailView(ctx, Conversation)`, `searchTextMessageView(ctx, TextMessage)`, `searchImageMessageView(ctx, MediaMessage)`, `emptyStateView`, `errorStateView`, `loadingStateView`, `initialStateView`
 - **Style:** `CometChatSearchStyle`
 
+### CometChatNotificationFeed
+
+Full-screen in-app notification feed — a scrollable list of campaign/promotional notifications rendered as cards, with category filter chips, timestamp grouping, real-time updates, and engagement reporting. Distinct from push notifications: this is the in-app feed UI, not the OS-level push delivery.
+
+- **Location:** `chat_ui/src/notification_feed/widgets/cometchat_notification_feed.dart`
+- **Key props:** `title`, `showHeader`, `showBackButton`, `showFilterChips`, `headerView`, `scrollToItemId`, `notificationFeedRequestBuilder`, `notificationCategoriesRequestBuilder`, `onItemClick(NotificationFeedItem)`, `onActionClick(NotificationFeedItem, CometChatCardActionEvent)`, `onError(String)`, `onBackPress`, `cardThemeMode`, `cardThemeOverride`
+- **View slots:** `emptyStateView`, `errorStateView`, `loadingStateView`
+- **Style:** `CometChatNotificationFeedStyle`
+- **Request builder:** `NotificationFeedRequestBuilder` (pass without `.build()`; component builds internally)
+
 ### CometChatThreadedHeader
 
 Displays a parent message with reply count in a threaded conversation view. Listens for real-time reply count updates.
@@ -206,7 +219,7 @@ Unread count badge (red circle with number).
 Message delivery receipt icons (sent, delivered, read).
 
 - **Location:** `shared_ui/src/clean_architecture/presentation/views/misc/receipt/cometchat_receipt.dart`
-- **Style:** `CometChatReceiptStyle`
+- **Style:** `CometChatMessageReceiptStyle`
 
 ### CometChatReactions
 
@@ -263,7 +276,7 @@ Content widgets rendered inside `CometChatMessageBubble`. All accept optional `c
 ### CometChatImageBubble
 
 - **Location:** `shared_ui/src/clean_architecture/presentation/views/bubbles/image_bubble/cometchat_image_bubble.dart`
-- **Key props:** `imageUrl`, `caption`, `colorPalette`, `spacing`
+- **Key props:** `imageUrl`, `placeholderImage`, `placeHolderImagePackageName`, `onClick`, `height`, `width`, `margin`, `padding`, `metadata`
 - **Style:** `CometChatImageBubbleStyle`
 
 ### CometChatVideoBubble
@@ -319,18 +332,26 @@ Modal confirmation dialog with title, message, confirm/cancel buttons. Call `.sh
 - **Key props:** `context` (required), `title`, `messageText`, `confirmButtonText`, `cancelButtonText`, `onConfirm`, `onCancel`
 - **Style:** `CometChatConfirmDialogStyle`
 
-### CometChatActionSheet
+### CometchatMessageOptionSheet / CometChatAttachmentOptionSheet
 
-Bottom sheet for message actions (copy, reply, delete, etc.) and attachment options.
+Bottom sheets used internally by the kit. `CometchatMessageOptionSheet` (note the lowercase "c" in "chat") shows message actions (copy, reply, delete, etc.); `CometChatAttachmentOptionSheet` shows attachment options. There is no widget named `CometChatActionSheet`.
 
-- **Location:** `shared_ui/src/clean_architecture/presentation/views/misc/action_sheet/cometchat_action_sheet.dart`
+- **Location:** `CometchatMessageOptionSheet` → `chat_ui/src/message_list/cometchat_message_option_sheet.dart`; `CometChatAttachmentOptionSheet` → `shared_ui/src/clean_architecture/presentation/views/misc/action_sheet/cometchat_action_sheet.dart`
 - **Style:** `CometChatMessageOptionSheetStyle`, `CometChatAttachmentOptionSheetStyle`
 
 ---
 
 ## 6. AI Views
 
-AI widget availability is in flux during the V6 beta cycle. As of `6.0.0-beta2`, the AI assistant chat history (`CometChatAIAssistantChatHistory`) and conversation summary (`CometChatAIConversationSummary`) views are exported via the chat barrel. Other AI widgets (`CometChatAISmartReplies`, `CometChatAIConversationStarter`, `CometChatAIAssistantBubble`) may or may not be exported depending on the beta — if your import errors with "undefined name", the symbol isn't in that beta. Verify against your installed version before relying on a specific class.
+As of `6.0.1`, the following AI widgets are exported via the chat barrel (`shared_ui/cometchat_uikit_shared.dart`):
+
+- `CometChatAIAssistantChatHistory` — chat_ui/src/ai_assistant_chat_history/widgets/cometchat_ai_assistant_chat_history.dart
+- `CometChatAIConversationSummaryView` — shared_ui/src/views/ai_conversation_summary/cometchat_ai_conversation_summary_view.dart
+- `CometChatAIAssistantBubble` — shared_ui/src/.../cometchat_ai_assistant_bubble.dart
+- `CometChatAISmartRepliesView` — shared_ui/src/.../cometchat_ai_smart_replies_view.dart
+- `CometChatAIConversationStarterView` — shared_ui/src/.../cometchat_ai_conversation_starter_view.dart
+
+Note the `View` suffix on the summary, smart-replies, and conversation-starter classes — `CometChatAIConversationSummary`, `CometChatAISmartReplies`, and `CometChatAIConversationStarter` (without suffix) do NOT exist.
 
 For AI behavior more broadly, the kit surfaces AI replies / summaries / starters inside the existing message list and composer when the matching dashboard extensions are enabled. Drive AI through extensions for the most stable path.