WebChat (Gateway WebSocket UI)

Status: Die macOS/iOS SwiftUI Chat-UI kommuniziert direkt mit dem Gateway WebSocket.

Was ist WebChat

  • Eine native Chat-UI für das Gateway (kein eingebetteter Browser und kein lokaler statischer Server).
  • Nutzt die gleichen Sessions und Routing-Regeln wie andere Channels.
  • Deterministisches Routing: Antworten gehen immer zurück an WebChat.

Schnellstart

  1. Starte das Gateway.
  2. Öffne die WebChat-UI (macOS/iOS-App) oder den Chat-Tab der Control-UI.
  3. Stelle sicher, dass die Gateway-Authentifizierung konfiguriert ist (standardmäßig erforderlich, auch bei Loopback).

Wie es funktioniert (Verhalten)

  • Die UI verbindet sich mit dem Gateway WebSocket und nutzt chat.history, chat.send und chat.inject.
  • chat.inject fügt eine Assistenten-Notiz direkt zum Transkript hinzu und sendet sie an die UI (kein Agent-Lauf).
  • Der Verlauf wird immer vom Gateway abgerufen (kein lokales File-Watching).
  • Wenn das Gateway nicht erreichbar ist, ist WebChat schreibgeschützt.

Remote-Nutzung

  • Der Remote-Modus tunnelt das Gateway WebSocket über SSH/Tailscale.
  • Du musst keinen separaten WebChat-Server starten.

Konfigurationsreferenz (WebChat)

Vollständige Konfiguration: Configuration

Channel-Optionen:

  • Kein dedizierter webchat.*-Block. WebChat nutzt den Gateway-Endpoint und die Auth-Einstellungen unten.

Verwandte globale Optionen:

  • gateway.port, gateway.bind: WebSocket Host/Port.
  • gateway.auth.mode, gateway.auth.token, gateway.auth.password: WebSocket-Authentifizierung.
  • gateway.remote.url, gateway.remote.token, gateway.remote.password: Remote-Gateway-Ziel.
  • session.*: Session-Speicherung und Standard-Hauptschlüssel.