# API de Chat
SUMMARY: Chat assíncrono entre humanos e agentes LLM — poll, resposta, histórico, contagem de não lidas, envio de arquivos.

KEY CONTEXT:
Auth: Mind Key (agent side, ?role=agent) or JWT (human side, ?role=human)
Poll: GET /chat/poll (returns unread messages, marks them as read)
Reply: POST /chat/reply { content }
History: GET /chat/history?limit=50
Unread count: GET /chat/unread?role=agent (or ?role=human)
Upload: POST /chat/upload (multipart, file attachment)
Pattern: poll between tool calls, reply when human asks questions

API de Chat
A API de Chat permite mensagens assíncronas entre humanos e agentes LLM.
Diferente do chat síncrono (estilo ChatGPT), o humano pode deixar mensagens
enquanto o agente está trabalhando — o agente faz poll entre chamadas de
ferramenta.
Como funciona
[CODE BLOCK]
1. O humano envia uma mensagem pela interface web (usa JWT)
2. A mensagem é armazenada, marcada como não lida
3. O agente faz poll em  entre chamadas de ferramenta
4. O poll retorna todas as mensagens não lidas e as marca como lidas
5. O agente processa a mensagem e, opcionalmente, responde via 
Endpoints
GET /chat/poll
Faz poll por novas mensagens do humano. Retorna mensagens não lidas e as marca
como lidas. Use isto entre chamadas de ferramenta.
[CODE BLOCK]
Resposta:
[CODE BLOCK]
POST /chat/reply
Envia uma mensagem como agente.
[CODE BLOCK]
POST /chat/send
Envia uma mensagem como humano (requer JWT, não Mind Key).
[CODE BLOCK]
GET /chat/history
Obtém o histórico recente de chat (ambos os papéis).
[CODE BLOCK]
GET /chat/unread
Obtém a contagem de mensagens não lidas.
[CODE BLOCK]
GET /chat/status
Obtém o status da sessão de chat (timestamps da última mensagem, contagens de não lidas).
[CODE BLOCK]
POST /chat/upload
Faz upload de um anexo de arquivo para uma mensagem específica (form multipart).
[CODE BLOCK]
GET /chat/files/:messageid
Lista os anexos de uma mensagem.
[CODE BLOCK]
GET /chat/file/:fileid
Baixa um anexo de arquivo.
[CODE BLOCK]
Padrão de poll
> [!TIP]
> Faça poll a cada 30-60 segundos entre chamadas de ferramenta. Não faça poll
> com mais frequência — isso desperdiça cota da API e não traz benefício.
[CODE BLOCK]
Próximos passos
- API de Tarefas
- Padrão de poll de chat