Documentation Index
Fetch the complete documentation index at: https://docs.buildzero.ai/llms.txt
Use this file to discover all available pages before exploring further.
Arquitetura
BuildZero é um monorepo com 6 serviços e 3 packages compartilhados, conectados via event bus (QStash).
Fluxo de uma mensagem
Telegram recebe mensagem
O webhook do Telegram Worker recebe a mensagem do usuário.
Gate autentica
O Telegram Worker chama o AI gate (Vercel) que valida o canal, identifica o usuário, e retorna tokens de sessão.
Bus publica evento
O Telegram Worker publica message.received via QStash para o AI Worker.
AI Worker processa
O AI Worker carrega histórico da sessão, cria o contexto com tools, e chama o Claude com streaming.
Streaming para Telegram
As respostas são enviadas em tempo real via edits progressivos na mensagem do Telegram.
Callback de conclusão
Ao finalizar, o AI Worker publica message.response de volta pro Telegram Worker para limpar a fila.
Mapa de serviços
┌─────────────────────────────────────────────────┐
│ Telegram Bot │
│ (Cloudflare Worker) │
└──────────┬──────────────────┬───────────────────┘
│ gate │ QStash
▼ ▼
┌──────────────────┐ ┌──────────────────────────┐
│ AI Service │ │ AI Worker │
│ (Vercel) │ │ (Cloudflare Worker) │
│ auth + sessões │ │ Claude + tools + stream │
└──────────────────┘ └────────┬─────────────────┘
│
┌──────────┼──────────┐
▼ ▼ ▼
┌─────────┐ ┌────────┐ ┌────────┐
│ Daemon │ │Sandbox │ │Meta API│
│(WebSocket)│(Container)│(Graph) │
└─────────┘ └────────┘ └────────┘
