Gleam.br Wiki

GBR: EARS-0007 Requisito de Flexibilidade e Testabilidade de Provedores e Ferramentas | Wiki

Documentação de engenharia e especificações técnicas da Gleam-BR.

GBR: EARS-0007 Requisito de Flexibilidade e Testabilidade de Provedores e Ferramentas

  • *Status:* Proposto
  • *Data:* 2026-06-09

*Requisito de Interface Abstrata e Segurança baseada em Capacidades (Ocap):*

  • *Se* o orquestrador precisar interagir com um provedor LLM ou executar uma ferramenta local,
  • *então* o sistema deverá utilizar uma estrutura de registro de função (Vtable) contendo apenas as capacidades permitidas,
  • *de forma que* seja possível substituir a implementação física em tempo de execução sem alterar a lógica interna do orquestrador, e garantindo que o componente não consiga acessar recursos fora do seu escopo funcional.

Critérios de Aceitação:

  1. *Abstração Tipada:* O compilador Gleam deve forçar que todas as implementações de provedores LLM assinem exatamente o mesmo contrato de tipos.
  2. *Isolamento de Teste:* Deve ser possível rodar os testes unitários do orquestrador com um provedor de LLM mockado localmente, sem disparar conexões HTTP reais.
  3. *Confinamento de I/O:* As ferramentas seguras devem receber apenas as funções higienizadas de I/O que foram liberadas pelo perfil de ambiente.