feat: Add presence heartbeat for Matrix online status

- matrix-gateway: POST /internal/matrix/presence/online endpoint - usePresenceHeartbeat hook with activity tracking - Auto away after 5 min inactivity - Offline on page close/visibility change - Integrated in MatrixChatRoom component
2025-11-27 00:19:40 -08:00
parent 5bed515852
commit 3de3c8cb36
6371 changed files with 1317450 additions and 932 deletions
--- a/XAI-SDK-INTEGRATION.md
+++ b/XAI-SDK-INTEGRATION.md
@@ -0,0 +1,128 @@
+# ✅ xAI SDK Integration - Готово
+
+**Дата:** 2025-11-22  
+**Статус:** ✅ xAI SDK інтегровано та відображається в моніторі
+
+---
+
+## ✅ Виконано
+
+1. ✅ **Встановлено xAI SDK:**
+   ```bash
+   pip install xai-sdk
+   ```
+
+2. ✅ **Додано підтримку xAI в DAGI Router:**
+   - Додано змінні оточення: `XAI_API_KEY`, `XAI_BASE_URL`, `XAI_MODEL`
+   - Додано провайдер `cloud_xai` з пріоритетом вище DeepSeek
+   - Використовується OpenAI-сумісний API з xAI endpoints
+
+3. ✅ **Оновлено requirements.txt:**
+   - Додано `xAI-sdk`
+
+4. ✅ **Додано відображення в моніторі:**
+   - Новий блок "API Providers Status" на дашборді
+   - Показує всі доступні провайдери (xAI, DeepSeek, Ollama, Echo)
+   - Real-time оновлення кожні 15 секунд
+   - Відображає capabilities та версію Router
+
+---
+
+## 🔧 Конфігурація
+
+### Змінні оточення:
+
+```bash
+# xAI Configuration
+XAI_API_KEY=your_xai_api_key_here
+XAI_BASE_URL=https://api.x.ai/v1
+XAI_MODEL=grok-beta
+
+# DeepSeek (existing)
+DEEPSEEK_API_KEY=your_deepseek_api_key
+DEEPSEEK_BASE_URL=https://api.deepseek.com
+DEEPSEEK_MODEL=deepseek-chat
+
+# Ollama (existing)
+OLLAMA_BASE_URL=http://localhost:11434
+OLLAMA_MODEL=qwen2.5:3b
+```
+
+### Пріоритет провайдерів:
+
+1. **xAI (Grok)** - якщо `XAI_API_KEY` встановлено
+2. **DeepSeek** - якщо `DEEPSEEK_API_KEY` встановлено
+3. **Ollama (Local)** - якщо доступний
+4. **Echo** - fallback
+
+---
+
+## 📊 Відображення в моніторі
+
+### API Providers Status Block:
+
+Показує:
+- ✅ xAI (Grok) - з іконкою sparkles, фіолетовий
+- ✅ DeepSeek - з іконкою brain, синій
+- ✅ Ollama (Local) - з іконкою cpu, зелений
+- ✅ Echo - з іконкою message-square, сірий
+
+Також показує:
+- Router URL
+- Версію Router
+- Capabilities (xai_integration, deepseek_integration, ollama_integration)
+
+---
+
+## 🔍 Перевірка
+
+### 1. Перевірити SDK:
+
+```bash
+python3 -c "from openai import OpenAI; from xai import Client; print('✅ SDK OK')"
+```
+
+### 2. Перевірити Router:
+
+```bash
+curl http://localhost:9102/health
+curl http://localhost:9102/v1/router/providers
+```
+
+### 3. Перевірити в моніторі:
+
+Відкрити: `http://localhost:8899/`
+
+На дашборді має відображатися блок "API Providers Status" з усіма доступними провайдерами.
+
+---
+
+## 🧪 Тестування
+
+### Тестовий запит через xAI:
+
+```bash
+curl -X POST http://localhost:9102/v1/router/route \
+  -H "Content-Type: application/json" \
+  -d '{
+    "message": "Привіт! Тест xAI",
+    "context": {},
+    "metadata": {"provider": "cloud_xai"}
+  }'
+```
+
+---
+
+## 📝 Примітки
+
+- xAI SDK сумісний з OpenAI SDK через OpenAI-сумісний API
+- Використовується `base_url=https://api.x.ai/v1`
+- Модель за замовчуванням: `grok-beta`
+- Логи API викликів відображаються в System Activity Log
+
+---
+
+**Last Updated:** 2025-11-22  
+**Status:** ✅ xAI SDK інтегровано та працює  
+**Monitor URL:** `http://localhost:8899/`
+