Atualizações

2025-12-10: Lançamento oficial de código aberto. O roadmap será produzido no primeiro trimestre de 2026.

2025-04-04: Produzimos a solicitação de funcionalidade para Hooks do Claude Code. O alinhamento em tempo de execução requer integração nos harnesses dos agentes, e nos afastamos do monitoramento em nível de sistema de arquivos e SO do comportamento do agente (PoC inicial do cupcake).

Harnesses de Agentes Suportados

O Cupcake fornece integrações nativas leves para múltiplos agentes de codificação de IA:

Cada harness usa formatos de eventos nativos. Semelhante ao terraform, as políticas são separadas por harness (policies/claude/, policies/cursor/, policies/factory/, policies/opencode/) para garantir clareza e acesso total a capacidades específicas do harness. Se um harness específico não for suportado, é porque ele não possui meios para integração em tempo de execução.

Vinculações de Linguagem

O Cupcake pode ser incorporado em aplicações JavaScript de agentes através de vinculações nativas. Isso permite integração com frameworks de agentes baseados na web como LangChain, Google ADK, NVIDIA NIM, Vercel AI SDK e mais.

Como Funciona

O Cupcake atua como uma camada de aplicação entre seus agentes de codificação e seu ambiente de execução por meio de hooks diretamente no caminho de ação do agente.

Agent → (proposed action) → Cupcake → (policy decision) → Agent runtime

1. Interceptação: O agente se prepara para executar uma ação/chamada de ferramenta (por exemplo, git push, fs_write).
2. Enriquecimento: O Cupcake coleta Sinais em tempo real — fatos do ambiente como o branch Git atual, status de CI ou metadados de banco de dados.
3. Avaliação: A ação e os sinais são empacotados em uma entrada JSON e avaliados contra suas políticas Wasm em milissegundos.

Avaliação Determinística e Não Determinística

O Cupcake suporta dois modelos de avaliação:

1. Políticas Determinísticas: As políticas são escritas em OPA/Rego e compiladas para WebAssembly (Wasm) para avaliação rápida e em ambiente isolado. Guia de Escrita de Políticas para detalhes de implementação.
2. LLM‑as‑Judge (LLM como Juiz): Para uma supervisão mais simples, porém mais avançada, de suas regras, o Cupcake pode intervir por meio de um LLM ou agente secundário para avaliar como uma ação deve proceder. Guia Cupcake Watchdog para detalhes de implementação.

Decisões e Feedback

Com base na avaliação, o Cupcake retorna uma das cinco decisões para o runtime do agente, juntamente com uma mensagem legível por humanos:

• Permitir (Allow): A ação prossegue. Opcionalmente, o Cupcake pode injetar Contexto (por exemplo, "Lembre-se: você está no branch main") para guiar o comportamento subsequente sem bloquear. Nota: A injeção de contexto é suportada no Claude Code e Factory AI, mas não no Cursor.
• Modificar (Modify): A ação prossegue com entrada transformada. As políticas podem sanitizar comandos, adicionar flags de segurança ou impor convenções antes da execução. Nota: Suportado apenas no Claude Code e Factory AI.
• Bloquear (Block): A ação é interrompida. O Cupcake envia Feedback explicando por que foi bloqueada (por exemplo, "Os testes devem passar antes de enviar"), permitindo que o agente se autocorrija.
• Avisar (Warn): A ação prossegue, mas um aviso é registrado ou exibido.
• Exigir Revisão (Require Review): A ação pausa até que um humano a aprove.

Por que Cupcake?

Agentes modernos são poderosos, mas inconsistentes ao seguir regras operacionais e de segurança, especialmente à medida que o contexto cresce. O Cupcake transforma as regras que você já mantém (por exemplo, CLAUDE.md, AGENT.md, .cursor/rules) em barreiras aplicáveis que são executadas antes das ações.

• Suporte multi-harness com integrações de primeira classe para Claude Code, Cursor, Factory AI e OpenCode.
• Governança como código usando OPA/Rego compilado para WebAssembly para avaliação rápida e em ambiente isolado.
• Controles prontos para empresas: permitir/negar/revisar, trilhas de auditoria enriquecidas para SOCs de IA e avisos proativos.

Capacidades Principais

• Controle Granular de Ferramentas: Impedir ferramentas ou argumentos específicos (por exemplo, bloquear rm -rf /).
• Suporte MCP: Governança nativa para ferramentas do Protocolo de Contexto de Modelo (por exemplo, mcp__memory__*, mcp__github__*).
• LLM‑as‑Judge (LLM como Juiz): Use um LLM ou agente secundário para avaliar ações para supervisão mais dinâmica.
• Bibliotecas de Guardrail: Integrações de primeira classe com NeMo e Invariant para verificações de conteúdo e segurança.
• Observabilidade: Todas as entradas, sinais e decisões geram logs estruturados e rastros de avaliação para depuração.

Instalação e desenvolvimento com Nix

Se você estiver usando Nix, pode instalar e executar o Cupcake usando o flake fornecido:

Instalar CLI do Cupcake usando Nix

Instalar CLI do Cupcake no NixOS

Adicione o seguinte ao seu flake.nix:

E então o seguinte pacote ao seu environment.systemPackages ou home.packages:

Shell de Desenvolvimento

Para desenvolvimento, você também pode usar o dev shell fornecido que inclui ferramentas Rust, just e outras dependências:

Perguntas Frequentes (FAQ)

O Cupcake consome tokens de prompt/contexto? Não. As políticas são executadas fora do modelo e retornam decisões estruturadas.

O Cupcake está vinculado a um modelo específico? Não. O Cupcake suporta múltiplos agentes de codificação de IA com integrações específicas de harness.

Qual é a velocidade da avaliação? Sub‑milissegundo para políticas em cache em configurações típicas.

Contribuindo

Aceitamos contribuições! Veja CONTRIBUTING.md para diretrizes.

Licença

Apache 2.0

O Cupcake é desenvolvido pela EQTYLab, com suporte de pesquisa em segurança agêntica pela Trail of Bits.

Siga no X para atualizações regulares.