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

# Changelog

> Histórico de versões do BuildZero

# Changelog

<Note>
  Este changelog é mantido em [CHANGELOG.md](https://github.com/b0-ai/buildzero/blob/main/CHANGELOG.md) na raiz do repositório. Abaixo está a versão resumida.
</Note>

## v0.1.0 (2026-03-08)

Primeiro release — assistente AI pessoal via Telegram. Desenvolvido em 4 dias, 23 commits.

### Telegram Bot

* Conversar com Claude AI pelo Telegram com streaming em tempo real (edits a cada 1.5s)
* Enviar fotos e o bot analisa (multimodal via Vercel Blob → Claude)
* Histórico de sessão persistido — contexto carregado a cada mensagem
* Multi-step tool use — até 10 passos encadeados por resposta
* Rotação automática de mensagem ao atingir 4000 chars
* Cancelar operação com `/cancel` (cooperativo via Redis + AbortController)
* Backpressure — mensagens enfileiradas automaticamente durante processamento
* 4 níveis de verbosidade (silencioso, reações, preview, verbose YAML-like)
* Reações emoji por categoria de tool

### Tools — 26 no total

<AccordionGroup>
  <Accordion title="Código e terminal (6)" icon="terminal">
    `exec` (daemon local ou sandbox cloud), `read`, `write`, `edit`, `glob`, `grep`
  </Accordion>

  <Accordion title="Conta e sessão (6)" icon="user">
    `account_info`, `send_token`, `link_account`, `setup_oauth`, `new_session`, `daemon_status`
  </Accordion>

  <Accordion title="Configurações (2)" icon="gear">
    `get_settings`, `set_settings` — verbosity, model, daemon padrão
  </Accordion>

  <Accordion title="Meta Ads (7)" icon="chart-line">
    `meta_ads_connect`, `meta_ads_disconnect`, `meta_ads_accounts`, `meta_ads_campaigns`, `meta_ads_adsets`, `meta_ads_ads`, `meta_ads_insights`
  </Accordion>

  <Accordion title="Ambientes (1)" icon="server">
    `environments` — gerenciar ambientes sandbox persistentes (listar, criar, arquivar)
  </Accordion>

  <Accordion title="Admin (4)" icon="shield">
    `list_pending`, `approve_user`, `pre_register`, `block_user`
  </Accordion>
</AccordionGroup>

### Onboarding

* Fluxo: `/start` no Telegram → pairing code (8 chars) → signup com Google → conta vinculada
* Status lifecycle: new → pending → approved | blocked
* Pre-registro por admin: auto-aprova no signup

### Daemon

* Conexão local via WebSocket com API key (`b0_k_*`)
* Durable Object por usuário com hibernation
* Tool dispatch com callId + timeout 120s
* Múltiplos ambientes por usuário

### Sandbox Cloud

* JavaScript, Python, Bash — sempre disponível
* Fallback automático quando sem daemon
* Containers isolados via Cloudflare Containers
* Ambientes persistentes — até 3 por usuário, storage via R2
* Imagem com Python 3, pip, git, curl pré-instalados

### Meta Ads

* Integração Graph API v25.0 — 7 tools para gerenciar campanhas e métricas
* Token exchange automático para long-lived (60 dias)
* Rate limiting adaptativo (backoff a >75%, retry automático)
* App-agnostic — usuário traz suas credenciais

### Web (bot.buildzero.ai)

* Landing page: dark theme, verde mint (#00e87b), demo visual, IBM Plex Mono
* Signup com Google OAuth via Clerk (custom SSO flow)
* Auth-aware: detecta 5 estados de conta

### Segurança

* Token Vault: `b0_tok_*` e `EAA*` mascarados como `[TOKEN_REF_N]`
* API keys: `b0_k_*`, hash SHA-256, CRUD completo
* Session tokens JWT (5 min) — gate assina (jsonwebtoken), worker verifica (jose)
* OAuth PKCE com Claude (client\_id do Claude Code)
* QStash HMAC-JWT entre serviços
* Channel-based auth: auto-criação de usuários Telegram

### Infraestrutura

* 6 serviços: auth, ai, ai-worker, telegram, web, sandbox
* 3 packages: @b0/sdk, @b0/log, @b0/meta-ads
* Gate pattern: Vercel autentica (\~100ms), cliente conecta direto no Worker
* Vercel (gru1) + Cloudflare Workers + Neon Postgres + Drizzle ORM
* QStash event bus + Upstash Redis + Vercel Blob
* Bun workspaces monorepo (@b0/\* namespace) + E2E test suite com cleanup automático