​

WebChat (Gateway(게이트웨이) WebSocket UI)

상태: macOS/iOS SwiftUI 채팅 UI 는 Gateway(게이트웨이) WebSocket 과 직접 통신합니다.

​

무엇인가요

• gateway 를 위한 네이티브 채팅 UI 입니다 (임베디드 브라우저 없음, 로컬 정적 서버 없음).
• 다른 채널과 동일한 세션 및 라우팅 규칙을 사용합니다.
• 결정적 라우팅: 응답은 항상 WebChat 으로 되돌아옵니다.

​

빠른 시작

1. gateway 를 시작합니다.
2. WebChat UI (macOS/iOS 앱) 또는 Control UI 의 채팅 탭을 엽니다.
3. gateway 인증이 구성되어 있는지 확인합니다 (loopback 에서도 기본적으로 필요합니다).

​

동작 방식 (행동)

• UI 는 Gateway(게이트웨이) WebSocket 에 연결하며 chat.history, chat.send, chat.inject 를 사용합니다.
• chat.inject 는 에이전트 실행 없이 어시스턴트 노트를 대화 기록에 직접 추가하고 UI 로 브로드캐스트합니다.
• 기록은 항상 gateway 에서 가져옵니다 (로컬 파일 감시 없음).
• gateway 에 접근할 수 없으면 WebChat 은 읽기 전용입니다.

​

원격 사용

• 원격 모드는 SSH/Tailscale 을 통해 gateway WebSocket 을 터널링합니다.
• 별도의 WebChat 서버를 실행할 필요가 없습니다.

​

구성 참조 (WebChat)

전체 구성: Configuration 채널 옵션:

• 전용 webchat.* 블록은 없습니다. WebChat 은 아래의 gateway 엔드포인트 + 인증 설정을 사용합니다.

관련 전역 옵션:

• gateway.port, gateway.bind: WebSocket 호스트/포트.
• gateway.auth.mode, gateway.auth.token, gateway.auth.password: WebSocket 인증.
• gateway.auth.mode: "trusted-proxy": 브라우저 클라이언트를 위한 reverse-proxy 인증 (참고: Trusted Proxy Auth).
• gateway.remote.url, gateway.remote.token, gateway.remote.password: 원격 gateway 대상.
• session.*: 세션 스토리지 및 기본 메인 키.