Cupcake

Faites en sorte que les agents IA respectent les règles.

Couche d'application des politiques pour les agents IA ; offrant de meilleures performances et une meilleure sécurité sans consommer de contexte du modèle.

• Respect déterministe des règles pour vos agents. Exemples interactifs
• De meilleures performances en sortant les règles du contexte et en les plaçant dans du policy-as-code.
• Déclenchez des alertes et mettez les agents fautifs en timeout lorsqu'ils enfreignent les règles à plusieurs reprises.

Cupcake intercepte les événements des agents et les évalue par rapport à des règles définies par l'utilisateur écrites en Open Policy Agent (OPA) Rego. Les actions des agents peuvent être bloquées, modifiées et auto-corrigées en fournissant à l'agent des retours utiles. Les avantages supplémentaires incluent l'automatisation réactive de tâches que vous n'avez pas besoin de confier à l'agent (comme le linting après une modification de fichier).

Mises à jour

2025-12-10: Publication officielle en open source. La feuille de route sera produite au premier trimestre 2026.

2025-04-04: Nous avons produit la demande de fonctionnalité pour les hooks Claude Code. L'alignement au runtime nécessite une intégration dans les harness d'agents, et nous nous éloignons de la surveillance du comportement des agents au niveau du système de fichiers et de l'OS (premier PoC de Cupcake).

Harnesses d'agents pris en charge

Cupcake fournit des intégrations natives légères pour plusieurs agents de codage IA :

Harness	Statut	Guide d'intégration
Claude Code	✅ Pleinement pris en charge	Guide de configuration
Cursor	✅ Pleinement pris en charge	Guide de configuration
Factory AI	✅ Pleinement pris en charge	Guide de configuration
OpenCode	✅ Pleinement pris en charge	Guide de configuration
AMP	Bientôt disponible	En attente de publication
Gemini CLI	Bientôt disponible	En attente de publication

Chaque harness utilise des formats d'événements natifs. À l'instar de terraform, les politiques sont séparées par harness (policies/claude/, policies/cursor/, policies/factory/, policies/opencode/) pour garantir la clarté et un accès complet aux capacités spécifiques à chaque harness. Si un harness particulier n'est pas pris en charge, c'est parce qu'il ne dispose d'aucun moyen d'intégration au runtime.

Bindings de langage

Cupcake peut être intégré dans des applications d'agents JavaScript via des bindings natifs. Cela permet l'intégration avec des frameworks d'agents web comme LangChain, Google ADK, NVIDIA NIM, Vercel AI SDK, et plus encore.

Langage	Binding
TypeScript	./cupcake-ts

Comment ça fonctionne

Cupcake agit comme une couche d'application des règles entre vos agents de codage et leur environnement d'exécution via des hooks directement dans le chemin d'action de l'agent.

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

1. Interception : L'agent s'apprête à exécuter une action/un appel d'outil (par exemple, git push, fs_write).
2. Enrichissement : Cupcake recueille des Signaux—des faits provenant de l'environnement, tels que la branche Git actuelle, le statut CI ou les métadonnées de la base de données.
3. Évaluation : L'action et les signaux sont regroupés dans une entrée JSON et évalués par rapport à vos politiques Wasm en quelques millisecondes.

Évaluation déterministe et non déterministe

Cupcake prend en charge deux modèles d'évaluation :

1. Politiques déterministes : Les politiques sont écrites en OPA/Rego et compilées en WebAssembly (Wasm) pour une évaluation rapide et sandboxée. Consultez le guide Écriture de politiques pour les détails d'implémentation.
2. LLM‑as‑Judge : Pour une supervision plus simple, mais plus avancée, de vos règles, Cupake peut intervenir via un LLM ou un agent secondaire pour évaluer comment une action doit se dérouler. Consultez le guide Cupcake Watchdog pour les détails d'implémentation.

Décisions et retours

En fonction de l'évaluation, Cupcake renvoie l'une des cinq décisions suivantes à l'environnement d'exécution de l'agent, accompagnée d'un message lisible par un humain :