Cupcake

Haz que los agentes de IA sigan las reglas.

Capa de aplicación de políticas para agentes de IA; ofrece un mejor rendimiento y seguridad sin consumir contexto del modelo.

• Cumplimiento determinista de reglas para tus agentes. Ejemplos interactivos
• Mejor rendimiento al sacar las reglas del contexto y convertirlas en políticas como código.
• Activa alertas y aplica un tiempo de espera a los agentes problemáticos cuando violen las reglas repetidamente.

Cupcake intercepta los eventos de los agentes y los evalúa contra reglas definidas por el usuario escritas en Open Policy Agent (OPA) Rego. Las acciones de los agentes pueden bloquearse, modificarse y corregirse automáticamente proporcionando al agente comentarios útiles. Otros beneficios incluyen automatización reactiva para tareas que no necesitas que el agente realice (como ejecutar un linter después de editar un archivo).

Updates

2025-12-10: Lanzamiento oficial de código abierto. La hoja de ruta se publicará en el Q1 de 2026.

2025-04-04: Realizamos la solicitud de funcionalidad para Claude Code Hooks. La alineación en tiempo de ejecución requiere integración en los harnesses de los agentes, y nos alejamos de la monitorización a nivel de sistema de archivos y del sistema operativo del comportamiento de los agentes (prototipo inicial de cupcake).

Harnesses de agentes compatibles

Cupcake proporciona integraciones nativas ligeras para múltiples agentes de codificación de IA:

Harness	Status	Integration Guide
Claude Code	✅ Totalmente compatible	Guía de configuración
Cursor	✅ Totalmente compatible	Guía de configuración
Factory AI	✅ Totalmente compatible	Guía de configuración
OpenCode	✅ Totalmente compatible	Guía de configuración
AMP	Próximamente	Pendiente de lanzamiento
Gemini CLI	Próximamente	Pendiente de lanzamiento

Cada harness utiliza formatos de eventos nativos. Al igual que terraform, las políticas se separan por harness (policies/claude/, policies/cursor/, policies/factory/, policies/opencode/) para garantizar la claridad y el acceso completo a las capacidades específicas de cada harness. Si un harness concreto no es compatible, es porque no dispone de medios para la integración en tiempo de ejecución.

Bindings de Lenguaje

Cupcake puede integrarse en aplicaciones de agentes JavaScript mediante bindings nativos. Esto permite la integración con frameworks de agentes basados en web como LangChain, Google ADK, NVIDIA NIM, Vercel AI SDK y otros.

Lenguaje	Binding
TypeScript	./cupcake-ts

Cómo funciona

Cupcake actúa como una capa de aplicación de políticas entre tus agentes de codificación y su entorno de ejecución mediante hooks directamente en la ruta de acción del agente.

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

1. Intercepción: El agente se prepara para ejecutar una acción/llamada a herramienta (p. ej., git push, fs_write).
2. Enriquecimiento: Cupcake recopila Señales en tiempo real: hechos del entorno como la rama Git actual, el estado de la CI o metadatos de la base de datos.
3. Evaluación: La acción y las señales se empaquetan en una entrada JSON y se evalúan contra tus políticas Wasm en milisegundos.

Evaluación Determinista y No Determinista

Cupcake admite dos modelos de evaluación:

1. Políticas deterministas: Las políticas están escritas en OPA/Rego y compiladas a WebAssembly (Wasm) para una evaluación rápida y sandbox. Consulta la guía Escritura de políticas para conocer los detalles de implementación.
2. LLM‑as‑Judge: Para una supervisión más sencilla, aunque más avanzada, de tus reglas, Cupake puede interponerse mediante un LLM o agente secundario para evaluar cómo debe proceder una acción. Consulta la guía Cupcake Watchdog para conocer los detalles de implementación.

Decisiones y Retroalimentación

Según la evaluación, Cupcake devuelve una de cinco decisiones al runtime del agente, junto con un mensaje legible por humanos:

• Permitir: La acción continúa. Opcionalmente, Cupcake puede inyectar Contexto (p. ej., "Recuerda: estás en la rama main") para guiar el comportamiento posterior sin bloquear. Nota: La inyección de contexto es compatible con Claude Code y Factory AI, pero no con Cursor.
• Modificar: La acción continúa con la entrada transformada. Las políticas pueden sanitizar comandos, añadir flags de seguridad o imponer convenciones antes de la ejecución. Nota: Solo compatible con Claude Code y Factory AI.
• Bloquear: La acción se detiene. Cupcake envía Retroalimentación explicando por qué se bloqueó (p. ej., "Las pruebas deben pasar antes de hacer push"), lo que permite al agente autocorregirse.
• Advertir: La acción continúa, pero se registra o muestra una advertencia.
• Requerir revisión: La acción se pausa hasta que un humano la apruebe.

¿Por qué Cupcake?