agentcontract v0.0.1 : Une couche de permissions JSON portable pour les agents de codage IA

agentcontract v0.0.1 est une petite bibliothèque Python sous licence MIT qui définit une couche de permissions JSON portable pour les agents de codage IA. L'idée centrale est un contrat JSON simple spécifiant les outils, chemins et actions réseau autorisés pour un agent, indépendamment de tout environnement d'exécution spécifique.

Fonctionnalités principales

• Contrat de permissions : une structure JSON listant les outils autorisés/interdits, les chemins de fichiers autorisés/interdits, le contrôle d'accès réseau et les outils nécessitant une approbation humaine.
• agc gui : une nouvelle interface utilisateur locale pour écrire, valider et sauvegarder un contrat de manière interactive, ainsi que pour simuler un appel d'outil proposé.
• Portable : le contrat peut être versionné dans un dépôt, relu comme une configuration normale et réutilisé avec différents agents/environnements.

Exemple de contrat

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

Le contrat impose qu'un agent ne puisse lire/écrire que des fichiers sous ./src/, ne puisse exécuter de commandes shell (sauf approbation) et n'ait pas accès au réseau. Il bloque l'accès aux chemins sensibles comme ~/.ssh/ et ~/.env.

Au lieu de faire confiance au modèle de permissions interne de chaque outil, vous définissez une politique portable unique que tout environnement peut vérifier avant qu'une action touche aux fichiers, exécute des commandes, appelle des API ou dépense des tokens.

À qui cela s'adresse

Les développeurs qui construisent des outils pour agents ou exécutent des agents de codage sur des dépôts réels et souhaitent une couche de permissions fiable, portable et vérifiable.