feat: complete Matrix session collaboration backend implementation

- Add Matrix session services (MatrixInviteStateService, MatrixSessionService, UnifiedSessionService)
- Implement Matrix chat components and session management
- Add comprehensive Matrix integration across UI components
- Update session handling and message streaming for Matrix compatibility
- Enhance chat input and base chat components for Matrix collaboration
- Add Matrix notification and session list view support
- Integrate Matrix services with existing Goose chat infrastructure

This completes the huge backend change that allows Matrix sessions to be written to the backend as a session.

Author: spencrmartin

ui/desktop/src/App.tsx

@@ -364,14 +364,25 @@ export function AppInner() {
   const handleOpenChat = useCallback((roomId: string, senderId: string) => {
     console.log('📱 Opening chat for room:', roomId, 'sender:', senderId);
 
-    // Navigate to peers view with chat parameters
-    navigate('/peers', { 
-      state: { 
-        openChat: true, 
-        roomId, 
-        senderId 
-      } 
-    });
+    // For Matrix rooms (starting with !), navigate directly to pair view with Matrix parameters
+    if (roomId.startsWith('!')) {
+      console.log('📱 Opening Matrix shared session for room:', roomId);
+      const searchParams = new URLSearchParams({
+        matrixMode: 'true',
+        matrixRoomId: roomId,
+        matrixRecipientId: senderId
+      });
+      navigate(`/pair?${searchParams.toString()}`);
+    } else {
+      // For non-Matrix rooms, navigate to peers view
+      navigate('/peers', { 
+        state: { 
+          openChat: true, 
+          roomId, 
+          senderId 
+        } 
+      });
+    }
   }, [navigate]);
 
   useEffect(() => {

ui/desktop/src/components/BaseChat.tsx

@@ -557,7 +557,7 @@ function BaseChatContent({
             </div>
 
             <ChatInput
-              sessionId={chat.sessionId}
+              sessionId={(customChatInputProps as any)?.sessionId || chat.sessionId} // Allow override from customChatInputProps
               handleSubmit={handleSubmit}
               chatState={chatState}
               onStop={onStopGoose}

ui/desktop/src/components/ChatInput.tsx

@@ -366,15 +366,32 @@ export default function ChatInput({
     sessionTitle: isMatrixRoom && sessionId ? `Matrix Room ${sessionId.substring(0, 8)}` : `Chat Session ${sessionId?.substring(0, 8) || 'default'}`,
     messages: messages, // Always sync messages
     onMessageSync: (message) => {
-      console.log('💬 ChatInput: Received message from useSessionSharing:', message);
+      console.log('💬 ChatInput: *** RECEIVED MESSAGE FROM useSessionSharing ***', message);
+      console.log('💬 ChatInput: Message details:', {
+        id: message.id,
+        role: message.role,
+        content: Array.isArray(message.content) ? message.content[0]?.text?.substring(0, 50) + '...' : 'N/A',
+        sender: message.sender?.displayName || message.sender?.userId || 'unknown',
+        hasAppendFunction: !!append,
+        appendFunctionType: typeof append,
+        sessionId: sessionId,
+        isMatrixRoom: isMatrixRoom
+      });
 
       // For Matrix rooms, messages from Matrix should appear normally
       // For regular sessions, messages should also appear normally
       // The key is that useSessionSharing handles both cases the same way
       if (append) {
-        append(message);
+        console.log('💬 ChatInput: *** CALLING APPEND FUNCTION WITH MESSAGE ***');
+        try {
+          const result = append(message);
+          console.log('💬 ChatInput: *** APPEND FUNCTION RETURNED ***:', result);
+          console.log('💬 ChatInput: *** APPEND SUCCESSFUL - MESSAGE SHOULD APPEAR IN CHAT ***');
+        } catch (error) {
+          console.error('💬 ChatInput: *** APPEND FUNCTION FAILED ***:', error);
+        }
       } else {
-        console.warn('⚠️ ChatInput: append function is not available!');
+        console.warn('⚠️ ChatInput: *** APPEND FUNCTION IS NOT AVAILABLE! ***');
       }
     },
     initialRoomId: isMatrixRoom ? sessionId : null, // Pass Matrix room ID if it's a Matrix room

ui/desktop/src/components/GooseChat.tsx

@@ -1,10 +1,11 @@
 import React, { useState, useEffect } from 'react';
-import { useNavigate } from 'react-router-dom';
+import { useNavigate, useLocation } from 'react-router-dom';
 import { useMatrix } from '../contexts/MatrixContext';
 import { GooseChatMessage } from '../services/MatrixService';
 
 const GooseChat: React.FC = () => {
   const navigate = useNavigate();
+  const location = useLocation();
   const { 
     isConnected, 
     gooseInstances, 
@@ -26,15 +27,36 @@ const GooseChat: React.FC = () => {
   const [taskDescription, setTaskDescription] = useState('');
   const [collaborationProject, setCollaborationProject] = useState('');
 
-  // Listen for incoming Goose messages
+  // Check if we're in a Matrix shared session context
+  const isInMatrixSharedSession = () => {
+    // Check URL parameters for Matrix mode
+    const searchParams = new URLSearchParams(location.search);
+    const matrixMode = searchParams.get('matrixMode') === 'true';
+    const matrixRoomId = searchParams.get('matrixRoomId');
+    
+    // Check if we're on a route that uses Matrix shared sessions
+    const isMatrixRoute = (location.pathname === '/' || location.pathname === '/pair') && (matrixMode || matrixRoomId);
+    
+    return isMatrixRoute;
+  };
+
+  // Listen for incoming Goose messages - but only when not in Matrix shared session
   useEffect(() => {
+    // Don't process Goose messages if we're in a Matrix shared session context
+    // to prevent interference with the main chat
+    if (isInMatrixSharedSession()) {
+      console.log('🚫 GooseChat: Disabling message processing - Matrix shared session is active');
+      return;
+    }
+
+    console.log('✅ GooseChat: Setting up Goose message listener');
     const unsubscribe = onGooseMessage((message: GooseChatMessage) => {
-      console.log('🦆 Received Goose message:', message);
+      console.log('🦆 GooseChat: Received Goose message:', message);
       setMessages(prev => [...prev, message]);
     });
 
     return unsubscribe;
-  }, [onGooseMessage]);
+  }, [onGooseMessage, location.search, location.pathname]);
 
   const handleSendMessage = async () => {
     if (!messageText.trim() || !selectedRoom) return;

ui/desktop/src/components/MatrixChat.tsx

@@ -10,6 +10,7 @@ interface MatrixChatProps {
   recipientId?: string;
   onBack?: () => void;
   className?: string;
+  disableMessageHandling?: boolean; // Add prop to disable message handling when used alongside useSessionSharing
 }
 
 interface ChatMessage {
@@ -28,6 +29,7 @@ const MatrixChat: React.FC<MatrixChatProps> = ({
   recipientId,
   onBack,
   className = '',
+  disableMessageHandling = false,
 }) => {
   const {
     currentUser,
@@ -58,7 +60,12 @@ const MatrixChat: React.FC<MatrixChatProps> = ({
 
   // Listen for messages in this room
   useEffect(() => {
-    if (!roomId || !currentUser) return;
+    if (!roomId || !currentUser || disableMessageHandling) {
+      if (disableMessageHandling) {
+        console.log('🚫 MatrixChat message handling disabled - useSessionSharing is handling messages');
+      }
+      return;
+    }
 
     const handleRegularMessage = (messageData: any) => {
       const { content, sender, roomId: msgRoomId, timestamp, senderInfo } = messageData;
@@ -131,7 +138,7 @@ const MatrixChat: React.FC<MatrixChatProps> = ({
       unsubscribeRegular();
       unsubscribeGoose();
     };
-  }, [roomId, currentUser, onMessage, onGooseMessage]);
+  }, [roomId, currentUser, onMessage, onGooseMessage, disableMessageHandling]);
 
   // Auto-scroll to bottom when new messages arrive
   useEffect(() => {

ui/desktop/src/components/MessageNotification.tsx

@@ -2,6 +2,7 @@ import React, { useState, useEffect } from 'react';
 import { motion, AnimatePresence } from 'framer-motion';
 import { MessageCircle, X, User, Clock } from 'lucide-react';
 import { useMatrix } from '../contexts/MatrixContext';
+import { useLocation } from 'react-router-dom';
 import AvatarImage from './AvatarImage';
 
 interface MessageNotificationData {
@@ -31,9 +32,20 @@ const MessageNotification: React.FC<MessageNotificationProps> = ({
     currentUser,
   } = useMatrix();
 
+  const location = useLocation();
+  
   const [notifications, setNotifications] = useState<MessageNotificationData[]>([]);
   const [dismissedIds, setDismissedIds] = useState<Set<string>>(new Set());
 
+  // Helper function to get current active Matrix room ID if in shared session mode
+  const getCurrentActiveMatrixRoom = () => {
+    const searchParams = new URLSearchParams(location.search);
+    const isMatrixMode = searchParams.get('matrixMode') === 'true';
+    const matrixRoomId = searchParams.get('matrixRoomId');
+    
+    return isMatrixMode && matrixRoomId ? matrixRoomId : null;
+  };
+
   // Listen for incoming messages
   useEffect(() => {
     if (!isConnected || !currentUser) return;
@@ -45,6 +57,13 @@ const MessageNotification: React.FC<MessageNotificationProps> = ({
       // Only show notifications for messages from others
       if (sender === currentUser.userId) return;
 
+      // Skip notifications for messages from the currently active Matrix room (shared session)
+      const activeMatrixRoom = getCurrentActiveMatrixRoom();
+      if (activeMatrixRoom && roomId === activeMatrixRoom) {
+        console.log('📱 Skipping notification for message from active Matrix room:', roomId);
+        return;
+      }
+      
       // Filter out very old messages (more than 2 minutes old) to prevent spam on startup
       const messageAge = Date.now() - new Date(timestamp).getTime();
       const twoMinutesInMs = 2 * 60 * 1000;
@@ -86,6 +105,13 @@ const MessageNotification: React.FC<MessageNotificationProps> = ({
       // Only show notifications for messages from others
       if (metadata?.isFromSelf) return;
 
+      // Skip notifications for messages from the currently active Matrix room (shared session)
+      const activeMatrixRoom = getCurrentActiveMatrixRoom();
+      if (activeMatrixRoom && roomId === activeMatrixRoom) {
+        console.log('🦆 Skipping Goose notification for message from active Matrix room:', roomId);
+        return;
+      }
+      
       // Filter out old messages
       const messageAge = Date.now() - new Date(timestamp).getTime();
       const twoMinutesInMs = 2 * 60 * 1000;