Cupcake

Fai in modo che gli agenti AI seguano le regole.

Layer di policy enforcement per agenti AI; offre prestazioni e sicurezza migliori senza consumare il contesto del modello.

• Rispetto deterministico delle regole per i tuoi agenti. Esempi interattivi
• Prestazioni migliori spostando le regole fuori dal contesto e nella policy-as-code.
• Attiva avvisi e metti in timeout gli agenti cattivi quando violano ripetutamente le regole.

Cupcake intercetta gli eventi degli agenti e li valuta rispetto a regole definite dall'utente scritte in Open Policy Agent (OPA) Rego. Le azioni degli agenti possono essere bloccate, modificate e corrette automaticamente fornendo un feedback utile all'agente. Ulteriori vantaggi includono l'automazione reattiva per attività che non devono essere svolte dall'agente (come il linting dopo una modifica a un file).

Aggiornamenti

2025-12-10: Rilascio open source ufficiale. La roadmap sarà pubblicata nel primo trimestre del 2026.

2025-04-04: Abbiamo inoltrato la richiesta di funzionalità per Claude Code Hooks. L'allineamento in runtime richiede l'integrazione negli harness degli agenti, e ci siamo allontanati dal monitoraggio a livello di filesystem e di sistema operativo del comportamento degli agenti (primo PoC di Cupcake).

Harness per agenti supportati

Cupcake fornisce integrazioni native leggere per diversi agenti di codifica AI:

Harness	Stato	Guida all'integrazione
Claude Code	✅ Supporto completo	Guida di configurazione
Cursor	✅ Supporto completo	Guida di configurazione
Factory AI	✅ Supporto completo	Guida di configurazione
OpenCode	✅ Supporto completo	Guida di configurazione
AMP	In arrivo	In attesa del rilascio
Gemini CLI	In arrivo	In attesa del rilascio

Ogni harness utilizza formati di eventi nativi. Analogamente a terraform, le policy sono separate per harness (policies/claude/, policies/cursor/, policies/factory/, policies/opencode/) per garantire chiarezza e pieno accesso alle funzionalità specifiche dell'harness. Se un determinato harness non è supportato, è perché non dispone di strumenti per l'integrazione runtime.

Binding di linguaggio

Cupcake può essere incorporato in applicazioni agente JavaScript tramite binding nativi. Ciò consente l'integrazione con framework agente basati sul web come LangChain, Google ADK, NVIDIA NIM, Vercel AI SDK e altri.

Linguaggio	Binding
TypeScript	./cupcake-ts

Come funziona

Cupcake agisce come layer di enforcement tra i tuoi agenti di codifica e il loro ambiente runtime tramite hook direttamente nel percorso delle azioni dell'agente.

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

1. Intercettazione: l'agente si prepara a eseguire un'azione/chiamata di strumento (ad es., git push, fs_write).
2. Arricchimento: Cupcake raccoglie segnali in tempo reale — fatti dell'ambiente come il branch Git corrente, lo stato della CI o i metadati del database.
3. Valutazione: l'azione e i segnali vengono impacchettati in un input JSON e valutati rispetto alle tue policy Wasm in pochi millisecondi.

Valutazione deterministica e non deterministica

Cupcake supporta due modelli di valutazione:

1. Policy deterministiche: le policy sono scritte in OPA/Rego e compilate in WebAssembly (Wasm) per una valutazione rapida e in sandbox. Consulta la guida Scrivere policy per i dettagli di implementazione.
2. LLM‑as‑Judge: per una supervisione più semplice ma più avanzata delle tue regole, Cupcake può intervenire tramite un LLM o un agente secondario per valutare come dovrebbe procedere un'azione. Consulta la guida Cupcake Watchdog per i dettagli di implementazione.

Decisioni e feedback

In base alla valutazione, Cupcake restituisce una delle cinque decisioni all'ambiente runtime dell'agente, insieme a un messaggio leggibile dall'uomo:

• Consenti: l'azione procede. Opzionalmente, Cupcake può iniettare Contesto (es. "Ricorda: sei sul branch main") per guidare il comportamento successivo senza bloccare. Nota: l'iniezione del contesto è supportata in Claude Code e Factory AI, ma non in Cursor.
• Modifica: l'azione procede con input trasformato. Le policy possono sanificare i comandi, aggiungere flag di sicurezza o imporre convenzioni prima dell'esecuzione. Nota: supportata solo in Claude Code e Factory AI.
• Blocca: l'azione viene interrotta. Cupcake invia un Feedback che spiega perché è stata bloccata (es. "I test devono passare prima del push"), consentendo all'agente di autocorreggersi.
• Avvisa: l'azione procede, ma viene registrato o mostrato un avviso.
• Richiedi revisione: l'azione viene sospesa fino all'approvazione di un essere umano.

Perché Cupcake?