v6.0.4

Author: raj-cometchat

examples/ai_sample_app/pubspec.yaml

@@ -1,15 +1,15 @@
 name: ai_sample_app
 description: "CometChat Flutter AI Sample App - AI Agents Chat Experience"
 publish_to: 'none'
-version: 6.0.3
+version: 6.0.4
 
 environment:
   sdk: ^3.6.0
 
 dependencies:
   flutter:
     sdk: flutter
-  cometchat_chat_uikit: ^6.0.3
+  cometchat_chat_uikit: ^6.0.4
   http: ^1.2.0
   intl: ^0.20.2
   shared_preferences: ^2.2.0

examples/sample_app/pubspec.yaml

@@ -1,15 +1,15 @@
 name: sample_app
 description: "A sample app"
 publish_to: 'none'
-version: 6.0.3
+version: 6.0.4
 
 environment:
   sdk: ^3.6.0
 
 dependencies:
   flutter:
     sdk: flutter
-  cometchat_chat_uikit: ^6.0.3
+  cometchat_chat_uikit: ^6.0.4
 
 dev_dependencies:
   flutter_test:

packages/cometchat_uikit/CHANGELOG.md

@@ -1,3 +1,20 @@
+# 6.0.4
+
+## New
+- Added `CometChatCardBubble` for rendering developer card messages (category `card`).
+- Added support for rendering agent card messages within the AI Assistant bubble.
+- Added streaming support for cards that arrive during a streamed agent response.
+- Added the `ccCardActionClicked` event, which forwards raw card actions to the app layer for both developer and agent cards.
+- Added `MessageCategoryConstants.card` for card messages.
+
+## Enhancements
+- Enhanced the AI Assistant bubble to render ordered text and card blocks, falling back to `getText()` for older messages.
+- Enhanced conversation previews for developer card messages to show `getText()` when available, or `Card Message` otherwise.
+- Updated developer card options to exclude `edit` and `copy`.
+
+## Fixes
+- None
+
 # 6.0.3
 
 ## New

packages/cometchat_uikit/lib/chat_ui/src/message_list/bloc/message_list_bloc.dart

@@ -1318,6 +1318,7 @@ class MessageListBloc extends Bloc<MessageListEvent, MessageListState>
   /// The CometChatStreamBubble widget handles word-by-word rendering.
   void _handleAIAssistantEvent(AIAssistantBaseEvent event) {
     if (isClosed) return;
+    debugPrint('[MessageListBloc] AI event received: type=${event.type}, id=${event.id}');
     final runId = event.id;
     if (runId == null) return;
 
@@ -2468,6 +2469,11 @@ class MessageListBloc extends Bloc<MessageListEvent, MessageListState>
   ) async {
     final message = event.message;
 
+    debugPrint('[MessageListBloc] Message received: id=${message.id}, '
+        'category=${message.category}, type=${message.type}, '
+        'sender=${message.sender?.uid}, '
+        'class=${message.runtimeType}');
+
     // For AI assistant messages, replace the thinking/stream bubble
     if (message is AIAssistantMessage && message.runId != null) {
       final thinkingId = -(message.runId!);
@@ -2496,6 +2502,8 @@ class MessageListBloc extends Bloc<MessageListEvent, MessageListState>
 
     // Check if message belongs to current conversation
     if (!_isMessageForCurrentConversation(message)) {
+      debugPrint('[MessageListBloc] Message FILTERED: not for current conversation. '
+          'message.conversationId=${message.conversationId}');
       return;
     }
 
@@ -2526,6 +2534,9 @@ class MessageListBloc extends Bloc<MessageListEvent, MessageListState>
 
     // Check message type/category filters
     if (!_passesTypeAndCategoryFilters(message)) {
+      debugPrint('[MessageListBloc] Message FILTERED: type/category filter failed. '
+          'category=${message.category}, type=${message.type}, '
+          'allowedCategories=$categories');
       return;
     }
 
@@ -2569,6 +2580,7 @@ class MessageListBloc extends Bloc<MessageListEvent, MessageListState>
     // If user has scrolled up (hasMoreNewer = true), don't append new messages
     // This prevents messages from appearing while user is viewing older messages
     if (state.hasMoreNewer) {
+      debugPrint('[MessageListBloc] Message FILTERED: hasMoreNewer=true (user scrolled up)');
       return;
     }
 
@@ -2580,6 +2592,10 @@ class MessageListBloc extends Bloc<MessageListEvent, MessageListState>
     final insertIndex = state.messages.length;
     final updatedMessages = [...state.messages, intercepted];
 
+    debugPrint('[MessageListBloc] Adding message to list: id=${intercepted.id}, '
+        'category=${intercepted.category}, type=${intercepted.type}, '
+        'insertIndex=$insertIndex');
+
     // Update index maps incrementally
     _addToIndexMaps(intercepted, insertIndex);
 
@@ -4115,26 +4131,44 @@ class _MessageListMessageListener with MessageListener {
 
   @override
   void onTextMessageReceived(TextMessage textMessage) {
+    debugPrint('[MessageListener] onTextMessageReceived: id=${textMessage.id}, sender=${textMessage.sender?.uid}');
     onTextMessageReceivedCallback(textMessage);
   }
 
   @override
   void onMediaMessageReceived(MediaMessage mediaMessage) {
+    debugPrint('[MessageListener] onMediaMessageReceived: id=${mediaMessage.id}, type=${mediaMessage.type}, sender=${mediaMessage.sender?.uid}');
     onMediaMessageReceivedCallback(mediaMessage);
   }
 
   @override
   void onCustomMessageReceived(CustomMessage customMessage) {
+    debugPrint('[MessageListener] onCustomMessageReceived: id=${customMessage.id}, type=${customMessage.type}, sender=${customMessage.sender?.uid}');
     onCustomMessageReceivedCallback(customMessage);
   }
 
   @override
   void onInteractiveMessageReceived(InteractiveMessage interactiveMessage) {
+    debugPrint('[MessageListener] onInteractiveMessageReceived: id=${interactiveMessage.id}, type=${interactiveMessage.type}, sender=${interactiveMessage.sender?.uid}');
     onInteractiveMessageReceivedCallback(interactiveMessage);
   }
 
+  @override
+  void onCardMessageReceived(CardMessage cardMessage) {
+    debugPrint('[MessageListener] onCardMessageReceived: id=${cardMessage.id}, '
+        'category=${cardMessage.category}, type=${cardMessage.type}, '
+        'hasCard=${cardMessage.getCard() != null}, '
+        'text=${cardMessage.getText()}');
+    // Route card messages through the same path as other messages
+    onTextMessageReceivedCallback(cardMessage);
+  }
+
   @override
   void onAIAssistantMessageReceived(AIAssistantMessage aiAssistantMessage) {
+    debugPrint('[MessageListener] onAIAssistantMessageReceived: id=${aiAssistantMessage.id}, '
+        'runId=${aiAssistantMessage.runId}, '
+        'hasElements=${aiAssistantMessage.getElements()?.isNotEmpty ?? false}, '
+        'elementsCount=${aiAssistantMessage.getElements()?.length ?? 0}');
     onAIAssistantMessageReceivedCallback(aiAssistantMessage);
   }
 

packages/cometchat_uikit/lib/chat_ui/src/message_list/utils/message_template_utils.dart

@@ -13,6 +13,7 @@ import '../../extensions/polls/cometchat_polls_bubble.dart';
 import '../../extensions/stickers/cometchat_sticker_bubble.dart';
 import '../../extensions/collaborative/cometchat_collaborative_bubble.dart';
 import '../../extensions/link_preview/cometchat_link_preview_bubble.dart';
+import '../widgets/cometchat_card_bubble.dart';
 import '../../extensions/extension_moderator.dart';
 import 'package:url_launcher/url_launcher.dart';
 
@@ -755,6 +756,7 @@ class MessageTemplateUtils {
       MessageTemplateUtils.getGroupActionTemplate(),
       MessageTemplateUtils.getFormMessageTemplate(),
       MessageTemplateUtils.getCardMessageTemplate(),
+      MessageTemplateUtils.getCardBubbleTemplate(),
       MessageTemplateUtils.getSchedulerMessageTemplate(),
       MessageTemplateUtils.getPollMessageTemplate(),
       MessageTemplateUtils.getStickerMessageTemplate(),
@@ -1090,6 +1092,7 @@ class MessageTemplateUtils {
       CometChatMessageCategory.action,
       CometChatMessageCategory.interactive,
       MessageCategoryConstants.custom,
+      MessageCategoryConstants.card,
       CometChatMessageCategory.categoryAgentic,
       CometChatMessageCategory.streamMessage,
     ];
@@ -1262,14 +1265,49 @@ class MessageTemplateUtils {
   }
 
 
-  static Widget getCardMessageBubble(
-      {CardBubbleStyle? cardBubbleStyle, required CardMessage message}) {
-    return CometChatCardBubble(
-      cardMessage: message,
-      loggedInUser: CometChatUIKit.loggedInUser,
+  /// Returns the template for developer card messages (category: "card").
+  ///
+  /// This is the NEW first-party card bubble (§2.9.7-A).
+  /// DO NOT confuse with [getCardMessageTemplate] below which is the
+  /// legacy interactive/card NOT_SUPPORTED stub (category: "interactive").
+  static CometChatMessageTemplate getCardBubbleTemplate() {
+    return CometChatMessageTemplate(
+      type: MessageTypeConstants.card,
+      category: MessageCategoryConstants.card,
+      contentView:
+          (BaseMessage message, BuildContext context, BubbleAlignment alignment,
+              {AdditionalConfigurations? additionalConfigurations}) {
+        if (message.deletedAt != null) {
+          return getDeleteMessageBubble(
+              message, context, additionalConfigurations?.deletedBubbleStyle);
+        }
+
+        final cardMessage = message as CardMessage;
+        return CometChatCardBubble(
+          message: cardMessage,
+        );
+      },
+      options: getCardBubbleOptions,
     );
   }
 
+  /// Options for developer card messages: text options minus edit and copy.
+  /// Preserves all conditional visibility logic (delete-only-for-own/admin, etc.)
+  static List<CometChatMessageOption> getCardBubbleOptions(
+      User loggedInUser,
+      BaseMessage messageObject,
+      BuildContext context,
+      Group? group,
+      AdditionalConfigurations? additionalConfigurations) {
+    // Get the full text options, then remove edit and copy
+    final textOptions = getTextMessageOptions(
+        loggedInUser, messageObject, context, group, additionalConfigurations);
+    textOptions.removeWhere((option) =>
+        option.id == MessageOptionConstants.editMessage ||
+        option.id == MessageOptionConstants.copyMessage);
+    return textOptions;
+  }
+
 
   static CometChatMessageTemplate getCardMessageTemplate() {
     return CometChatMessageTemplate(

packages/cometchat_uikit/lib/chat_ui/src/message_list/widgets/cometchat_card_bubble.dart

@@ -0,0 +1,107 @@
+import 'dart:convert';
+
+import 'package:flutter/material.dart';
+import 'package:cometchat_cards/cometchat_cards.dart';
+
+import '../../../../shared_ui/cometchat_uikit_shared.dart';
+import '../../../../shared_ui/src/views/no_intrinsic_card_wrapper.dart';
+
+/// Content view widget for developer card messages (category: "card").
+///
+/// Renders the raw card schema via [CometChatCardView] from the
+/// `cometchat_cards` renderer package. Mirrors the notification-feed
+/// card rendering pattern.
+///
+/// Handles:
+/// - Normal render: getCard() → jsonEncode → CometChatCardView
+/// - Null/empty card: shows getFallbackText() → getText() → "Card Message"
+/// - Deleted message: handled at the template level (not here)
+class CometChatCardBubble extends StatelessWidget {
+  const CometChatCardBubble({
+    super.key,
+    required this.message,
+    this.onCardAction,
+    this.themeMode,
+    this.themeOverride,
+  });
+
+  /// The [CardMessage] from the SDK (category: "card").
+  final CardMessage message;
+
+  /// Callback when the user taps an action within the card.
+  /// Fires alongside the [CometChatUIEvents.ccCardActionClicked] event.
+  final void Function(CardMessage message, CometChatCardActionEvent action)?
+      onCardAction;
+
+  /// Theme mode for the card renderer.
+  /// If null, auto-detected from the current [Brightness].
+  final CometChatCardThemeMode? themeMode;
+
+  /// Theme override for the card renderer.
+  final CometChatCardThemeOverride? themeOverride;
+
+  @override
+  Widget build(BuildContext context) {
+    final cardData = message.getCard();
+
+    // If card payload is null/empty, show fallback text
+    if (cardData == null || cardData.isEmpty) {
+      return _buildFallbackView(context);
+    }
+
+    // Resolve theme mode from platform brightness if not provided
+    final resolvedThemeMode = themeMode ?? _resolveThemeMode(context);
+
+    final String cardJson = jsonEncode(cardData);
+
+    final cardWidth = MediaQuery.sizeOf(context).width * 0.65;
+
+    return NoIntrinsicCardWrapper(
+      width: cardWidth,
+      child: CometChatCardView(
+        cardJson: cardJson,
+        themeMode: resolvedThemeMode,
+        themeOverride: themeOverride,
+        onAction: (CometChatCardActionEvent action) {
+          // Fire the callback prop (for apps using the bubble directly)
+          onCardAction?.call(message, action);
+
+          // Emit the UI event (for global subscription — covers nested agent cards too)
+          CometChatUIEvents.ccCardActionClicked(message, action);
+        },
+      ),
+    );
+  }
+
+  /// Fallback view when getCard() is null/empty.
+  /// Shows getFallbackText() → getText() → "Card Message".
+  Widget _buildFallbackView(BuildContext context) {
+    final colorPalette = CometChatThemeHelper.getColorPalette(context);
+    final typography = CometChatThemeHelper.getTypography(context);
+
+    final fallbackText = message.getFallbackText() ??
+        message.getText() ??
+        Translations.of(context).cardMessage;
+
+    return Padding(
+      padding: const EdgeInsets.all(8.0),
+      child: Text(
+        fallbackText,
+        style: TextStyle(
+          color: colorPalette.textPrimary,
+          fontWeight: typography.body?.regular?.fontWeight,
+          fontSize: typography.body?.regular?.fontSize,
+          fontFamily: typography.body?.regular?.fontFamily,
+        ),
+      ),
+    );
+  }
+
+  /// Resolves theme mode from the platform brightness.
+  CometChatCardThemeMode _resolveThemeMode(BuildContext context) {
+    final brightness = Theme.of(context).brightness;
+    return brightness == Brightness.dark
+        ? CometChatCardThemeMode.dark
+        : CometChatCardThemeMode.light;
+  }
+}