agentcontract v0.0.1: Портативный уровень разрешений в формате JSON для ИИ-агентов программирования

agentcontract v0.0.1 — это крошечная Python-библиотека с лицензией MIT, определяющая портативный JSON-слой разрешений для ИИ-агентов кодирования. Основная идея — простой JSON-контракт, который указывает, какие инструменты, пути и сетевые действия разрешены агенту, независимо от конкретной среды выполнения агента.

Ключевые особенности

• Контракт разрешений: JSON-структура, перечисляющая разрешённые/запрещённые инструменты, разрешённые/запрещённые пути к файлам, управление сетевым доступом и инструменты, требующие одобрения человека.
• agc gui: Новый локальный браузерный интерфейс для интерактивного написания, проверки и сохранения контракта, а также пробного запуска предполагаемого вызова инструмента.
• Портативность: Контракт можно закоммитить в репозиторий, подвергнуть код-ревью как обычную конфигурацию и повторно использовать в разных агентах/средах выполнения.

Пример контракта

{
  "allow_tools": ["read_file", "write_file"],
  "deny_tools": ["shell"],
  "allow_paths": ["./src/"],
  "deny_paths": ["~/.ssh/", "~/.env"],
  "allow_network": false,
  "require_approval": ["shell"]
}

Контракт гарантирует, что агент может только читать/записывать файлы в каталоге ./src/, не может выполнять команды оболочки (если не одобрено) и не имеет сетевого доступа. Блокируется доступ к конфиденциальным путям, таким как ~/.ssh/ и ~/.env.

Вместо того чтобы доверять внутренней модели разрешений каждого инструмента, вы определяете единую портативную политику, которую любая среда выполнения может проверить до того, как действие затронет файлы, выполнит команды, вызовет API или потратит токены.

Для кого это

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