Cupcake

Заставьте ИИ-агентов следовать правилам.

Слой принудительного применения политик для ИИ-агентов; обеспечивает лучшую производительность и безопасность без потребления контекста модели.

• Детерминированное соблюдение правил для ваших агентов. Интерактивные примеры
• Лучшая производительность за счет вынесения правил из контекста в политику как код.
• Запускайте оповещения и отправляйте плохих агентов в тайм-аут, когда они неоднократно нарушают правила.

Cupcake перехватывает события агента и оценивает их на основе пользовательских правил, написанных на Open Policy Agent (OPA) Rego. Действия агента могут быть заблокированы, изменены и автоматически исправлены путем предоставления агенту полезной обратной связи. Дополнительные преимущества включают реактивную автоматизацию для задач, которые не нужно полагаться на агента для выполнения (например, линтинг после редактирования файла).

Обновления

2025-12-10: Официальный выпуск с открытым исходным кодом. Дорожная карта будет подготовлена в Q1 2026.

2025-04-04: Мы создали запрос функции для Claude Code Hooks. Выравнивание во время выполнения требует интеграции в обвязки агента, и мы отходим от мониторинга поведения агента на уровне файловой системы и ОС (ранний PoC Cupcake).

Поддерживаемые обвязки агентов

Cupcake предоставляет легковесные нативные интеграции для нескольких ИИ-агентов кодирования:

Обвязка	Статус	Руководство по интеграции
Claude Code	✅ Полностью поддерживается	Руководство по настройке
Cursor	✅ Полностью поддерживается	Руководство по настройке
Factory AI	✅ Полностью поддерживается	Руководство по настройке
OpenCode	✅ Полностью поддерживается	Руководство по настройке
AMP	Скоро	Ожидание выхода
Gemini CLI	Скоро	Ожидание выхода

Каждая обвязка использует собственные форматы событий. Как и в Terraform, политики разделяются по обвязкам (policies/claude/, policies/cursor/, policies/factory/, policies/opencode/) для обеспечения ясности и полного доступа к специфическим возможностям обвязки. Если конкретная обвязка не поддерживается, это связано с отсутствием средств для интеграции во время выполнения.

Привязки языков

Cupcake может быть встроен в приложения JavaScript-агентов через нативные привязки. Это обеспечивает интеграцию с веб-фреймворками агентов, такими как LangChain, Google ADK, NVIDIA NIM, Vercel AI SDK и другими.

Язык	Привязка
TypeScript	./cupcake-ts

Как это работает

Cupcake выступает в качестве уровня принуждения между вашими агентами кодирования и их средой выполнения через хуки непосредственно в пути действий агента.

Агент → (предлагаемое действие) → Cupcake → (решение политики) → Среда выполнения агента

1. Перехват: Агент готовится выполнить действие/вызов инструмента (например, git push, fs_write).
2. Обогащение: Cupcake собирает в реальном времени Сигналы — факты из среды, такие как текущая ветка Git, статус CI или метаданные базы данных.
3. Оценка: Действие и сигналы упаковываются в JSON-входные данные и оцениваются на соответствие вашим политикам Wasm за миллисекунды.

Детерминированная и недетерминированная оценка

Cupcake поддерживает две модели оценки:

1. Детерминированные политики: Политики пишутся на OPA/Rego и компилируются в WebAssembly (Wasm) для быстрой, изолированной оценки. Руководство по реализации Writing Policies.
2. LLM‑как‑судья: Для более простого, но более продвинутого надзора за вашими правилами, Cupake может вмешиваться через вторичную LLM или агента для оценки того, как должно выполняться действие. Руководство по реализации Cupcake Watchdog.

Решения и обратная связь

На основе оценки Cupcake возвращает одно из пяти решений среде выполнения агента, а также понятное человеку сообщение:

• Разрешить: Действие выполняется. При необходимости Cupcake может внедрить Контекст (например, «Помните: вы находитесь в основной ветке») для управления последующим поведением без блокировки. Примечание: внедрение контекста поддерживается в Claude Code и Factory AI, но не в Cursor.
• Изменить: Действие выполняется с преобразованным вводом. Политики могут очищать команды, добавлять флаги безопасности или обеспечивать соблюдение соглашений перед выполнением. Примечание: поддерживается только в Claude Code и Factory AI.
• Заблокировать: Действие остановлено. Cupcake отправляет Обратную связь, объясняющую почему оно было заблокировано (например, «Тесты должны пройти перед отправкой»), что позволяет агенту самокорректироваться.
• Предупредить: Действие выполняется, но предупреждение регистрируется или отображается.
• Требовать проверки: Действие приостанавливается до одобрения человеком.

Зачем Cupcake?