> ## 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.

# Serviços

> Detalhes de cada serviço e package

# Serviços

## services/

<AccordionGroup>
  <Accordion title="auth (Vercel)" icon="lock">
    Autenticação e gerenciamento de usuários.

    * Signup/login com JWT
    * API keys (`b0_k_*`) com hash SHA-256
    * Channel links (Telegram → usuário)
    * Onboarding com pairing codes
    * Google OAuth via Clerk (complete-signup)
    * Admin CRUD (aprovar, bloquear, pre-registrar)
    * Credenciais Meta Ads por usuário
    * Região: `gru1` (São Paulo)
  </Accordion>

  <Accordion title="ai (Vercel)" icon="brain">
    Gate de autenticação e gerenciamento de sessões.

    * OAuth com Claude (PKCE flow)
    * Validate: aceita JWT ou API key
    * Sessões e histórico de mensagens (Neon/Drizzle)
    * Região: `gru1` (São Paulo)
  </Accordion>

  <Accordion title="ai-worker (Cloudflare Worker)" icon="robot">
    Motor de processamento de mensagens.

    * Geração de respostas via Claude (streaming)
    * Tool use com dispatch para daemon ou sandbox
    * Commit messages automáticos a partir de diffs
    * Verbosidade e reações no Telegram
    * Token vault (mascaramento de tokens sensíveis)
    * Durable Objects para WebSocket com daemon
  </Accordion>

  <Accordion title="telegram (Cloudflare Worker)" icon="paper-plane">
    Bot Telegram.

    * Webhook handler
    * Parsing de updates (texto, fotos, comandos)
    * Upload de imagens para Vercel Blob
    * Backpressure queue (Redis)
    * Cancelamento cooperativo (/cancel)
    * Message splitting (4096 chars)
  </Accordion>

  <Accordion title="web (Next.js / Vercel)" icon="globe">
    Landing page e signup.

    * Marca BuildZero (dark, verde mint)
    * Signup com Google OAuth (Clerk)
    * Pairing flow (Telegram → web → vinculado)
    * Status da conta (ativa, pendente, bloqueada)
  </Accordion>

  <Accordion title="sandbox (Cloudflare Containers)" icon="cube">
    Execução de código na cloud.

    * JavaScript, Python, Bash
    * Containers isolados via `@cloudflare/sandbox`
    * Fallback automático quando sem daemon
  </Accordion>
</AccordionGroup>

## packages/

| Package        | Descrição                                                                      |
| -------------- | ------------------------------------------------------------------------------ |
| `@b0/sdk`      | Bus (QStash), gate client, Redis client, `formatResponse` (md → Telegram HTML) |
| `@b0/log`      | Structured JSON logger compartilhado                                           |
| `@b0/meta-ads` | Client Meta Graph API v25.0 com rate limiting adaptativo                       |