aura-contracts

Modèles Pydantic v2 du contrat d'API AURA, générés depuis openapi.yaml.

Ce paquet est la seule définition des payloads échangés entre la plateforme AURA et l'agent auraagent. L'agent les importe ; il ne redéfinit aucun dictionnaire à la main.

Installation

pip install aura-contracts

Chaîne de génération

serializers de la plateforme
  → manage.py spectacular          → openapi.yaml
  → python contracts/generate.py   → aura_contracts/models.py

Chaque maillon est vérifié en CI : modifier un endpoint sans propager le contrat fait échouer le build.

Régénérer

Depuis la racine du dépôt aura :

python manage.py spectacular --file openapi.yaml --fail-on-warn
python contracts/generate.py

aura_contracts/models.py est versionné mais ne doit jamais être édité à la main. Toute évolution passe par les serializers de la plateforme.

Publication

aura-contracts doit être publié avant auraagent, qui en dépend.