WebChat (Gateway WebSocket UI)

Trạng thái: Giao diện chat SwiftUI trên macOS/iOS kết nối trực tiếp với Gateway WebSocket.

WebChat là gì

  • Giao diện chat native cho gateway (không cần embedded browser hay local static server).
  • Dùng chung sessions và routing rules với các channels khác.
  • Deterministic routing: các phản hồi luôn quay về WebChat.

Bắt đầu nhanh

  1. Khởi động gateway.
  2. Mở WebChat UI (app macOS/iOS) hoặc tab chat trong Control UI.
  3. Đảm bảo gateway auth đã được cấu hình (mặc định bắt buộc, kể cả trên loopback).

Cách hoạt động

  • UI kết nối với Gateway WebSocket và sử dụng chat.history, chat.send, và chat.inject.
  • chat.inject thêm assistant note trực tiếp vào transcript và broadcast đến UI (không chạy agent).
  • History luôn được lấy từ gateway (không theo dõi file local).
  • Nếu gateway không kết nối được, WebChat sẽ ở chế độ chỉ đọc.

Sử dụng từ xa

  • Remote mode tạo tunnel cho Gateway WebSocket qua SSH/Tailscale.
  • Các bạn không cần chạy WebChat server riêng.

Tham khảo cấu hình (WebChat)

Cấu hình đầy đủ: Configuration

Tùy chọn channel:

  • Không có block webchat.* riêng. WebChat dùng gateway endpoint + các cài đặt auth bên dưới.

Các tùy chọn global liên quan:

  • gateway.port, gateway.bind: WebSocket host/port.
  • gateway.auth.mode, gateway.auth.token, gateway.auth.password: WebSocket auth.
  • gateway.remote.url, gateway.remote.token, gateway.remote.password: remote gateway target.
  • session.*: session storage và main key defaults.