Skip to main content

​
Changelog

Este changelog é mantido em CHANGELOG.md na raiz do repositório. Abaixo está a versão resumida.

​
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

exec (daemon local ou sandbox cloud), read, write, edit, glob, grep
account_info, send_token, link_account, setup_oauth, new_session, daemon_status
get_settings, set_settings — verbosity, model, daemon padrão
meta_ads_connect, meta_ads_disconnect, meta_ads_accounts, meta_ads_campaigns, meta_ads_adsets, meta_ads_ads, meta_ads_insights
environments — gerenciar ambientes sandbox persistentes (listar, criar, arquivar)
list_pending, approve_user, pre_register, block_user

​
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