​

WebChat (UI WebSocket do Gateway)

​

O que é

• Uma UI de chat nativa para o gateway (sem navegador embutido e sem servidor estático local).
• Usa as mesmas sessões e regras de roteamento que outros canais.
• Roteamento determinístico: as respostas sempre retornam para o WebChat.

​

Início rápido

1. Inicie o gateway.
2. Abra a UI do WebChat (app macOS/iOS) ou a aba de chat da UI de Controle.
3. Garanta que a autenticação do gateway esteja configurada (obrigatória por padrão, mesmo em loopback).

​

Como funciona (comportamento)

• A UI se conecta ao WebSocket do Gateway e usa chat.history, chat.send e chat.inject.
• chat.inject adiciona uma nota do assistente diretamente à transcrição e a transmite para a UI (sem execução de agente).
• O histórico é sempre buscado no gateway (sem monitoramento de arquivos locais).
• Se o gateway estiver inacessível, o WebChat fica somente leitura.

​

Uso remoto

• O modo remoto encapsula o WebSocket do gateway via SSH/Tailscale.
• Você não precisa executar um servidor WebChat separado.

​

Referência de configuração (WebChat)

• Não há um bloco dedicado webchat.*. O WebChat usa o endpoint do gateway + as configurações de autenticação abaixo.

• gateway.port, gateway.bind: host/porta do WebSocket.
• gateway.auth.mode, gateway.auth.token, gateway.auth.password: autenticação do WebSocket.
• gateway.auth.mode: "trusted-proxy": autenticação por reverse-proxy para clientes de navegador (consulte Trusted Proxy Auth).
• gateway.remote.url, gateway.remote.token, gateway.remote.password: destino do gateway remoto.
• session.*: armazenamento de sessão e padrões da chave principal.