feat: Add Architectural Interfaces for AI and Federation POCs

Author: vivekyadav1207vy-sudo

packages/react/src/lib/ai/AiAdapter.js

@@ -0,0 +1,32 @@
+/**
+ * IAiAdapter Interface Definition
+ * Defines the contract that any AI provider must adhere to before being plugged into EmbeddedChat.
+ */
+
+export class AiAdapter {
+  /**
+   * @param {string} name - The readable name of the AI service (e.g. "Gemini", "Ollama").
+   */
+  constructor(name) {
+    this.name = name;
+    this.enabled = true;
+  }
+
+  /**
+   * Given the context of the room history, suggest auto-replies.
+   * @param {Array<Object>} messageContext - The last N messages in the room.
+   * @returns {Promise<Array<string>>} - An array of suggested replies.
+   */
+  async getSmartReplies(messageContext) {
+    throw new Error('Not implemented');
+  }
+
+  /**
+   * Summarize the current view for quick catch-up.
+   * @param {Array<Object>} messages - The raw message payloads.
+   * @returns {Promise<string>} - The summary text.
+   */
+  async getSummary(messages) {
+    throw new Error('Not implemented');
+  }
+}

packages/react/src/lib/ai/GeminiAiAdapter.js

@@ -0,0 +1,43 @@
+import { AiAdapter } from './AiAdapter';
+
+/**
+ * Proof of Concept: Integrating Google's Gemini LLM as an EmbeddedChat Plugin.
+ */
+export class GeminiAiAdapter extends AiAdapter {
+  constructor(apiKey) {
+    super('Gemini Pro');
+    this.apiKey = apiKey;
+    // Mocking the GoogleGenerativeAI initialization for POC purposes
+    this.client = {
+      getGenerativeModel: () => ({
+        generateContent: async (prompt) => {
+          console.log(`Sending to Gemini: ${prompt}`);
+          return {
+            response: { text: () => 'Sounds great!\nI agree.\nLet me check.' }
+          };
+        }
+      })
+    };
+  }
+
+  async getSmartReplies(messageContext) {
+    if (!this.apiKey) throw new Error('API Key required');
+    const model = this.client.getGenerativeModel({ model: 'gemini-pro' });
+    
+    // Simplistic prompt engineering for POC
+    const textContext = messageContext.map(m => `${m.u?.username || 'user'}: ${m.msg}`).join('\n');
+    const prompt = `Based on this chat context:\n${textContext}\nProvide 3 very short replies. Return them separated by newlines.`;
+    
+    const result = await model.generateContent(prompt);
+    return result.response.text().split('\n').filter(Boolean);
+  }
+
+  async getSummary(messages) {
+    const model = this.client.getGenerativeModel({ model: 'gemini-pro' });
+    const textContext = messages.map(m => `${m.u?.username || 'user'}: ${m.msg}`).join('\n');
+    const prompt = `Summarize this chat context in 2 sentences:\n${textContext}`;
+    
+    const result = await model.generateContent(prompt);
+    return result.response.text();
+  }
+}

packages/react/src/lib/federation/matrixUtils.js

@@ -0,0 +1,52 @@
+/**
+ * POC: Matrix Federation Identification Utilities
+ * This utility safely parses and normalizes standard Rocket.Chat user/room IDs 
+ * versus complex Matrix-federated identifiers.
+ */
+
+/**
+ * Standardizes displaying a username, detecting if it has a Matrix homeserver attached.
+ * @param {string} username - Original username from the backend payload
+ * @returns {Object} - Parsed identity parts
+ */
+export const parseFederatedIdentity = (username) => {
+  if (!username) return { name: 'Unknown', isFederated: false, server: null };
+
+  // Matrix pattern: @username:homeserver.org
+  const matrixRegex = /^@([^:]+):(.+)$/;
+  const match = username.match(matrixRegex);
+
+  if (match) {
+    return {
+      name: match[1],
+      isFederated: true,
+      server: match[2],
+      original: username
+    };
+  }
+
+  return {
+    name: username,
+    isFederated: false,
+    server: null,
+    original: username
+  };
+};
+
+/**
+ * Decorates a message object with normalized federated IDs for the UI to consume securely.
+ * @param {Object} message - Raw message payload
+ * @returns {Object} - Decorated message
+ */
+export const decorateFederatedMessage = (message) => {
+  if (!message || !message.u) return message;
+  
+  const parsedIdentity = parseFederatedIdentity(message.u.username);
+  
+  return {
+    ...message,
+    federationMeta: {
+      ...parsedIdentity
+    }
+  };
+};