agentcontract v0.0.1: Una Capa de Permisos JSON Portátil para Agentes de Codificación de IA

agentcontract v0.0.1 es una pequeña biblioteca de Python con licencia MIT que define una capa de permisos JSON portátil para agentes de IA de codificación. La idea central es un contrato JSON simple que especifica qué herramientas, rutas y acciones de red puede realizar un agente, independientemente del tiempo de ejecución específico del agente.

Características principales

• Contrato de permisos: Una estructura JSON que enumera herramientas permitidas/denegadas, rutas de archivo permitidas/denegadas, control de acceso a la red y herramientas que requieren aprobación humana.
• agc gui: Una nueva interfaz de navegador local para escribir, validar y guardar un contrato de forma interactiva, además de simular una llamada a herramienta propuesta contra él.
• Portátil: El contrato puede incluirse en un repositorio, revisarse como configuración normal y reutilizarse en diferentes agentes/tiempos de ejecución.

Ejemplo de contrato

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

El contrato exige que un agente solo pueda leer/escribir archivos en ./src/, no pueda ejecutar comandos de shell (a menos que sean aprobados) y no tenga acceso a la red. Bloquea el acceso a rutas sensibles como ~/.ssh/ y ~/.env.

En lugar de confiar en el modelo de permisos interno de cada herramienta, defines una única política portátil que cualquier tiempo de ejecución puede verificar antes de que una acción toque archivos, ejecute comandos, llame a APIs o queme tokens.

Para quién es

Desarrolladores que construyen herramientas para agentes o ejecutan agentes de codificación en repositorios reales y desean una capa de permisos aburrida, portátil y auditable.