agentcontract v0.0.1: Uma Camada de Permissão JSON Portátil para Agentes de Codificação de IA

agentcontract v0.0.1 é uma pequena biblioteca Python licenciada sob MIT que define uma camada de permissão JSON portátil para agentes de IA de codificação. A ideia central é um contrato JSON simples que especifica quais ferramentas, caminhos e ações de rede um agente pode realizar, independente de qualquer runtime específico de agente.

Principais Recursos

• Contrato de Permissão: Uma estrutura JSON que lista ferramentas permitidas/negadas, caminhos de arquivo permitidos/negados, controle de acesso à rede e ferramentas que exigem aprovação humana.
• agc gui: Uma nova interface de navegador local para escrever, validar e salvar um contrato interativamente, além de simular uma chamada de ferramenta proposta contra ele.
• Portátil: O contrato pode ser commitado em um repositório, revisado como configuração normal e reutilizado em diferentes agentes/runtimes.

Exemplo de Contrato

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

O contrato determina que um agente só pode ler/escrever arquivos em ./src/, não pode executar comandos de shell (a menos que aprovado) e não tem acesso à rede. Bloqueia acesso a caminhos sensíveis como ~/.ssh/ e ~/.env.

Em vez de confiar no modelo de permissão interno de cada ferramenta, você define uma única política portátil que qualquer runtime pode verificar antes que uma ação toque em arquivos, execute comandos, chame APIs ou consuma tokens.

Para Quem é

Desenvolvedores que constroem ferramentas de agente ou executam agentes de codificação em repositórios reais e desejam uma camada de permissão simples, portátil e auditável.