feat: add email inbox hook and dynamic API URLs for cloud deployment

- Update useLiveData.ts with dynamic API/WebSocket URL detection
- Add useEmailInbox hook for email polling
- Add email source type and endpoint mapping
- Point to new HuggingFace Space (widgettdc-api)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

apps/backend/src/index.ts

@@ -72,6 +72,7 @@ import { memoryRouter } from './services/memory/memoryController.js';
 import { sragRouter } from './services/srag/sragController.js';
 import { evolutionRouter } from './services/evolution/evolutionController.js';
 import { palRouter } from './services/pal/palController.js';
+import datasourcesRouter from './routes/datasources.js';
 import {
   cmaContextHandler,
   cmaIngestHandler,

apps/matrix-frontend/src/hooks/useLiveData.ts

@@ -11,7 +11,35 @@
 
 import { useState, useEffect, useCallback, useRef } from 'react';
 
-const API_BASE = 'http://localhost:3001/api';
+// Dynamic API base - use environment variable or HuggingFace Spaces URL in production
+const getApiBase = () => {
+    // Check for Vite environment variable first
+    if (typeof import.meta !== 'undefined' && import.meta.env?.VITE_API_URL) {
+        return `${import.meta.env.VITE_API_URL}/api`;
+    }
+    // Production default: HuggingFace Spaces backend
+    if (typeof window !== 'undefined' && window.location.hostname !== 'localhost') {
+        return 'https://kraft102-widgettdc-api.hf.space/api';
+    }
+    // Development default
+    return 'http://localhost:3001/api';
+};
+
+const getWsBase = () => {
+    // Check for Vite environment variable first
+    if (typeof import.meta !== 'undefined' && import.meta.env?.VITE_WS_URL) {
+        return import.meta.env.VITE_WS_URL;
+    }
+    // Production default: HuggingFace Spaces backend
+    if (typeof window !== 'undefined' && window.location.hostname !== 'localhost') {
+        return 'wss://kraft102-widgettdc-api.hf.space';
+    }
+    // Development default
+    return 'ws://localhost:3001';
+};
+
+const API_BASE = getApiBase();
+const WS_BASE = getWsBase();
 
 // Source types that widgets can request
 export type DataSourceType =
@@ -24,7 +52,8 @@ export type DataSourceType =
     | 'systemHealth'      // System services health
     | 'metrics'           // Platform metrics
     | 'osint'             // External OSINT feeds (future)
-    | 'threatIntel';      // Threat intelligence (future)
+    | 'threatIntel'       // Threat intelligence (future)
+    | 'email';            // Email inbox data
 
 // Recommended external sources that can be fetched on demand
 export interface RecommendedSource {
@@ -68,6 +97,7 @@ const sourceEndpoints: Record<DataSourceType, string> = {
     metrics: '/sys/metrics',
     osint: '/acquisition/osint',
     threatIntel: '/acquisition/threats',
+    email: '/email/inbox',
 };
 
 // Recommended sources per data type
@@ -100,6 +130,10 @@ const recommendedSourcesMap: Record<DataSourceType, RecommendedSource[]> = {
         { id: 'otx', name: 'AlienVault OTX', description: 'Open Threat Exchange IOCs', category: 'threatIntel', requiresApproval: true, isAvailable: false },
         { id: 'mitre', name: 'MITRE ATT&CK', description: 'Adversary tactics & techniques', category: 'threatIntel', requiresApproval: false, isAvailable: true },
     ],
+    email: [
+        { id: 'outlook', name: 'Outlook/Office365', description: 'Microsoft email via IMAP', category: 'internal', requiresApproval: false, isAvailable: true },
+        { id: 'gmail', name: 'Gmail', description: 'Google email via IMAP', category: 'internal', requiresApproval: false, isAvailable: true },
+    ],
 };
 
 export function useLiveData<T = any>(options: UseLiveDataOptions<T>): UseLiveDataResult<T> {
@@ -222,7 +256,7 @@ export function useLiveData<T = any>(options: UseLiveDataOptions<T>): UseLiveDat
     useEffect(() => {
         if (!enabled || wsEvents.length === 0) return;
 
-        const wsUrl = 'ws://localhost:3001/mcp/ws';
+        const wsUrl = `${WS_BASE}/mcp/ws`;
 
         try {
             wsRef.current = new WebSocket(wsUrl);
@@ -332,3 +366,17 @@ export function useDecisionHistory(pollInterval = 30000) {
         transform: (data) => data.decisions || [],
     });
 }
+
+export function useEmailInbox(pollInterval = 60000) {
+    return useLiveData({
+        sourceType: 'email',
+        pollInterval,
+        wsEvents: ['email:refresh'],
+        transform: (data) => ({
+            emails: data.emails || [],
+            unreadCount: data.unreadCount || 0,
+            source: data.source || 'unknown',
+            lastFetch: data.lastFetch || null,
+        }),
+    });
+}