Refactoring + Dokumentation: api.js komprimiert (745→267 Zeilen), SseHelper extrahiert, DatabaseService in Partial Classes aufgeteilt, unbenutztes CSS entfernt, ARCHITECTURE.md/ARCHITECTURE_QUICK.md/README.md aktualisiert (neue Features: Embedding, Remote, API-Keys, 16 Tools)

ARCHITECTURE_QUICK.md

@@ -6,7 +6,7 @@
 
 ## Tech-Stack
 
-**.NET 10** Minimal API · **SQLite** + Dapper · **Anthropic Claude API** (SSE Streaming) · **OpenAI-kompatible APIs** (Nvidia, Pollinations, Gemini) · **Vanilla JS** SPA · **KaTeX** (Math) · **Kestrel** auf Port 19000
+**.NET 10** Minimal API · **SQLite** + Dapper · **Anthropic Claude API** (SSE Streaming) · **OpenAI-kompatible APIs** (Nvidia, Pollinations, Gemini) · **ONNX Runtime** (Sentence-Embeddings) · **Vanilla JS** SPA · **KaTeX** (Math) · **Kestrel** auf Port 19000
 
 ---
 
@@ -16,8 +16,13 @@
 gott/
 ├── Program.cs                  # Startup, DI, Middleware, Routing
 ├── appsettings.json            # Tokens, API-Keys, Limits
-├── Models/                     # Records (reine Daten)
-├── Services/                   # Business-Logic (alle Singletons + WorkspaceHelper + OpenAiService)
+├── Models/                     # Records (reine Daten, inkl. ApiKeyRecord)
+├── Services/                   # Business-Logic (Singletons + Static Helpers)
+│   ├── DatabaseService*.cs     # Partial Classes (Core, Sessions, Agents, Users, Integrations)
+│   ├── SseHelper.cs            # Shared SSE-Utilities
+│   ├── EmbeddingService.cs     # Lokales Sentence-Embedding (ONNX)
+│   ├── VectorSearchService.cs  # Semantische Suche
+│   └── RemoteConnectionManager.cs # WebSocket Remote-Verbindungen
 ├── Endpoints/                  # HTTP API (Minimal API MapXxx-Pattern)
 ├── Middleware/                  # AuthMiddleware
 ├── Templates/                  # Vorlagen für neue Agents (IDENTITY, SOUL, USER)
@@ -38,7 +43,7 @@ gott/
 │   ├── js/archive.js           # Archiv-Loading
 │   ├── js/reply.js             # Reply/Quote-Handling
 │   ├── js/files.js             # File-Upload, Workspace-Refs
-│   ├── js/pages/               # Seiten-Komponenten (inkl. telegram-bot-page.js)
+│   ├── js/pages/               # Seiten-Komponenten (inkl. api-keys-page.js, telegram-bot-page.js)
 │   └── css/                    # Styles (theme.css = CSS Variables)
 ├── WindowsApp/                 # WPF + WebView2 Desktop Client
 └── Build/                      # ⛔ NICHT editieren!
@@ -80,6 +85,9 @@ User 1──* TelegramBot 1──* Session (via telegram_bot_id)
 | `agent_skills` | N:M Agent ↔ Skill |
 | `shared_messages` | Geteilte Nachrichten (öffentliche Links via Share-Token) |
 | `telegram_bots` | Telegram Bots (BotToken, WebhookSecret, Name, IsPublic) – eigenständige Entität, 1 Bot → N Sessions |
+| `api_keys` | API-Keys pro Provider (key_id, provider, name, api_key, is_active) – nur ein Key pro Provider aktiv |
+| `message_embeddings` | Sentence-Embeddings für semantische Suche (message_id, vector BLOB) |
+| `memory_file_embeddings` | Embeddings von Memory-Dateien (agent_id, file_path, chunk_index, vector BLOB) |
 
 ---
 
@@ -104,7 +112,9 @@ User 1──* TelegramBot 1──* Session (via telegram_bot_id)
 | Backup | `/api/backup` | POST → tar.gz download (Admin) |
 | Shared | `/api/shared/`, `/api/messages/{id}/share` | Share erstellen, öffentlich abrufen, löschen |
 | Models | `/api/models/` | `GET nvidia`, `GET pollinations`, `GET gemini`, `POST refresh` |
-| Info | `/api/info` | GET → Build-Zeitstempel |
+| API Keys | `/api/admin/api-keys/` | CRUD + activate/deactivate, `POST check` (Anthropic Heartbeat) (Admin-only) |
+| Remote | `/api/remote` | WebSocket für Remote-Clients, `GET connections`, `POST assign/unassign` |
+| Info | `/api/info` | GET → Build-Zeitstempel + Embedding-Verfügbarkeit |
 | ServerSettings | `/api/admin/server-settings` | `GET`, `PUT` (Admin-only, liest/schreibt `appsettings.Production.json`) |
 
 ---
@@ -118,7 +128,8 @@ User 1──* TelegramBot 1──* Session (via telegram_bot_id)
 | **ChatService** | Chat-Kontext aufbauen, History aus DB laden |
 | **AnthropicService** | Claude API: SSE Streaming + Non-Streaming |
 | **OpenAiService** | OpenAI-kompatible Provider (Nvidia, Pollinations, Gemini) mit Tool-Calling, Streaming, Modell-Caching |
-| **ToolService** | Tool-Definitionen + Ausführung (13 Tools) |
+| **SseHelper** | Shared SSE-Utilities: WriteSseEvent, TryWriteSse, FinalizeChain, TruncateToolResult (static) |
+| **ToolService** | Tool-Definitionen + Ausführung (16 Tools) |
 | **WorkspaceHelper** | Workspace-Pfad-Auflösung (relativ → absolut), Path-Traversal-Schutz (static) |
 | **SystemPromptBuilder** | System-Prompt aus modularen Blöcken zusammenbauen + Reminder-Generierung (static) |
 | **MemoryService** | Agent-Gedächtnis auf Dateisystem |
@@ -127,6 +138,10 @@ User 1──* TelegramBot 1──* Session (via telegram_bot_id)
 | **CronjobService** | BackgroundService, minütlicher Cron-Check |
 | **KreaService** | Krea API Bildgenerierung + Job-Polling |
 | **ImageService** | Bild-Resize + WebP-Konvertierung (512px + 256px Thumbnail) |
+| **EmbeddingService** | Lokales Sentence-Embedding via all-MiniLM-L6-v2 (ONNX, 384 Dimensionen) |
+| **VectorSearchService** | Semantische Suche über Message-Embeddings + Memory-File-Embeddings |
+| **EmbeddingBackgroundService** | Backfill bestehender Messages + Live-Embedding neuer Messages/Memory-Files |
+| **RemoteConnectionManager** | WebSocket-basierte Remote-Verbindungen, Command-Execution auf Remote-Clients |
 | **StreamingTracker** | Tracking aktiver Streams + CancellationTokenSource pro Session für Stop |
 
 ---
@@ -176,13 +191,17 @@ User-Input → POST /api/chat (SSE)
 | `edit_file` | Exakten Textabschnitt ersetzen |
 | `list_files` | Verzeichnisinhalt auflisten |
 | `delete_file` | Datei/leeres Verzeichnis löschen |
-| `execute` | Shell-Befehl ausführen (bash, 180s Timeout) |
+| `execute` | Shell-Befehl ausführen (bash, konfigurierbares Timeout) |
+| `background_execute` | Shell-Befehl als Hintergrund-Prozess starten (gibt PID zurück) |
 | `glob` | Dateien per Glob-Pattern finden |
 | `grep` | Dateien per Regex/Text durchsuchen |
 | `todo_write` | Aufgabenliste schreiben (wird im Prompt angezeigt) |
 | `memory_read` | Memory-Datei lesen |
 | `memory_write` | Memory-Datei schreiben/appenden |
 | `memory_list` | Memory-Dateien auflisten |
+| `memory_search` | Semantische Suche über vergangene Chat-Nachrichten und Memory-Dateien |
+| `remote_execute` | Shell-Befehl auf verbundenem Remote-Client ausführen (via WebSocket) |
+| `send_to_session` | Nachricht an eine andere Session senden und Agent-Antwort auslösen |
 | `ask_user_choice` | Interaktive Rückfrage mit 2-5 Auswahlmöglichkeiten (wenn AllowUserChoice aktiv) |
 
 **Sicherheit:** Alle Pfade werden auf das Workspace-Verzeichnis beschränkt (`..` wird blockiert). Tools sind pro Agent konfigurierbar (Feld `tools` als komma-separierte Liste).
@@ -226,6 +245,7 @@ User-Input → POST /api/chat (SSE)
 | `#/profile` | `profile-page.js` | Profil |
 | `#/settings` | `settings-page.js` | Einstellungen |
 | `#/admin` | `admin-page.js` | Benutzerverwaltung (Admin) |
+| `#/api-keys` | `api-keys-page.js` | API-Key-Verwaltung (Admin) |
 | `#/server-settings` | `server-settings-page.js` | Servereinstellungen (Admin) |
 | `#/login` | `login-page.js` | Login |
 | `#/shared/{token}` | `shared-page.js` | Geteilte Nachricht (öffentlich, kein Auth) |
@@ -236,7 +256,7 @@ User-Input → POST /api/chat (SSE)
 
 1. `POST /api/auth/login` → Token generiert, als `gott_token` HttpOnly Cookie gesetzt
 2. Jeder `/api/`-Request → `AuthMiddleware` prüft Cookie → setzt `UserId` + `IsAdmin`
-3. Ausnahmen: Login, Autologin, Telegram-Webhook (`/api/telegram/webhook/{botId}`), `GET /api/shared/{token}`, `GET /api/images/file/*` brauchen kein Auth
+3. Ausnahmen: Login, Autologin, Telegram-Webhook (`/api/telegram/webhook/{botId}`), `GET /api/shared/{token}`, `GET /api/images/file/*`, `/api/remote` (WebSocket) brauchen kein Auth
 4. **Krea API-Key**: `/api/images/`-Routen akzeptieren `X-Api-Key`-Header (Config: `KreaApiKey`) für Automation ohne User-Kontext
 5. **Impersonate**: Admin kann via `POST /api/admin/users/{id}/impersonate` als anderer User einloggen
 6. **Login-Link**: Admin generiert via `POST /api/admin/users/{id}/login-link` einen Autologin-Link (Token-basiert, `GET /api/auth/autologin?token=xxx`)
@@ -249,15 +269,20 @@ User-Input → POST /api/chat (SSE)
 ```json
 {
   "Port": 19000,                // Server-Port (erfordert Neustart)
-  "AnthropicToken": "",         // Anthropic API Key (REQUIRED)
   "MaxIterations": 100,         // Max Tool-Loop Iterationen pro Chat
+  "MaxHistory": 120,            // Max Messages in Chat-History
+  "ReminderInterval": 30,      // System-Prompt-Reminder alle N Messages
+  "ExecuteTimeout": 180,       // Timeout für Shell-Befehle in Sekunden
   "PayloadLogging": false,      // API-Payloads loggen (Debug)
   "PayloadLoggingGzip": false,  // Payload-Logs als .gz komprimieren
   "KreaToken": "",               // Krea API Token (optional)
-  "KreaApiKey": ""               // API-Key für Krea-Endpoints ohne User-Auth (optional)
+  "KreaApiKey": "",              // API-Key für Krea-Endpoints ohne User-Auth (optional)
+  "GeminiApiKey": ""             // Google Gemini API Key (optional, kostenlos)
 }
 ```
 
+> **Hinweis:** `AnthropicToken` wird über die **API-Key-Verwaltung** im Admin-Bereich verwaltet (DB-Tabelle `api_keys`), nicht mehr über `appsettings.json`.
+
 Verwaltung über **Admin-UI** (`#/server-settings`): Liest `appsettings.Production.json` (Fallback: `appsettings.json` → Default). Schreibt immer in `appsettings.Production.json`.
 
 ---