ADR 0012: Correção de Bindings Hono e Tipagem do AI Gateway

Status

Aceito

Contexto

Durante a auditoria de limpeza do projeto OConnect, identificamos que o build do frontend (que depende de tipos do backend via Hono RPC) estava falhando. Os erros principais eram:

1. c.env sendo inferido como unknown em rotas como banners.ts.
2. O método generate do HubGateway exigindo o argumento ai (tipo Ai), mas sendo chamado sem ele em agentes como CopyMasterAgent, PriceWatchAgent e TrendSpotterAgent.

Estes erros eram pré-existentes e impediam a validação de integridade do sistema após a limpeza de arquivos.

Decisão

1. Tipagem Explicita de Contexto: Adicionamos o tipo Bindings (que contém AI, DB, R2, etc.) diretamente na definição dos routers Hono: new Hono<{ Bindings: Bindings }>().
2. Injeção de Worker AI: Atualizamos os construtores dos agentes de IA para aceitarem o objeto env e passarem env.AI explicitamente para o HubGateway.

Consequências

• Consistência de Build: O comando npm run build no frontend agora valida os tipos corretamente.
• Manutenibilidade: A infraestrutura de agentes agora segue o contrato estrito do Cloudflare Workers AI, facilitando a adição de novas personas.
• Segurança: Evita-se o uso de any em variáveis críticas de ambiente (salvo em casos de transição onde a interface Bindings ainda estava sendo propagada).