Documentation
TokenEconomizer
Comment nous avons intégré TokenEconomizer au Brain de VibeiDE
L’Economizer de VibeiDE est notre propre implémentation de la conception publiée de TokenEconomizer par Microsoft Research, Microsoft Security et UC Berkeley, et non le plugin lui-même. Il ne fait aucun appel de modèle, n’écrit rien dans votre dépôt et ne charge rien lorsque le Brain est désactivé pour un projet. Cette page explique ce que nous avons conservé, modifié et laissé de côté.
Une implémentation de la conception, distincte du plugin
TokenEconomizer est distribué sous forme de plugin Python qui écrit dans le dépôt et sollicite un modèle pour certaines de ses décisions. Le Brain de VibeiDE respecte des contraintes plus strictes : aucun appel de modèle, aucune clé, aucun recours à Python, aucun fichier écrit dans votre dépôt et aucun chargement lorsque le Brain est désactivé pour un projet. Nous avons donc réécrit les trois mécanismes dans VibeiDE en nous appuyant sur la conception publiée et ses constantes, et conservé uniquement ce qui respecte ces contraintes. Aucun élément du plugin n’est inclus, installé ou exécuté.
Deux façons de lire un appel d’outil
L’Economizer doit voir ce qu’un agent a exécuté et le résultat obtenu. Pour Claude Code dans un terminal, il lit les hooks de Claude Code et y répond avant que Claude ne lise le résultat de l’outil. Pour Codex, ainsi que pour Claude Code lorsqu’il fonctionne sans hooks, il lit le flux d’événements que VibeiDE conserve déjà pour l’activité des tâches. Les deux sources sont ramenées à un même format : l’outil, la commande, les chemins, la sortie et l’indication d’un éventuel échec. La sortie est tronquée, lue une seule fois et jamais stockée.
Les informations utilisent des phrases prédéfinies, car les commandes ne sont pas fiables
Une information est transmise à toutes les tâches suivantes et provient de commandes saisies par un agent et de sorties produites par un dépôt. L’Economizer ne conserve donc jamais de texte libre. Chaque information prend la forme de l’une de quatre phrases prédéfinies, avec des paramètres vérifiés : une forme courte de commande exprimée en langage courant, un nom d’outil, un nom d’hôte ou un nom de variable. La valeur d’une variable n’est mentionnée que si elle est courte et simple, et si le nom de la variable ne semble pas sensible. Dans tous les autres cas, aucune information n’est créée.
Quand une information est conservée, transmise et retirée
Nous utilisons le cycle de vie de TokenEconomizer. Une information candidate est retenue après confirmation par trois tâches. Elle n’est transmise que si le gaspillage qu’elle évite apparaît dans au moins 40 pour cent d’un ensemble d’au moins quatre tâches concernées. Un score qui privilégie les tâches récentes entraîne son retrait, par exemple lorsque l’ancienne graphie d’une commande fonctionne à nouveau dans deux tâches consécutives.
Une protection contre les boucles sans modèle arbitre
Le plugin demande à un modèle si un tour signalé est réellement bloqué. Le Brain n’a aucun modèle à solliciter ; la protection utilise donc le réglage prudent prévu par la conception : elle attend que sept tours se soient bien terminés dans le projet et n’intervient jamais pendant la durée habituelle d’un tour qui se déroule bien. Un tour n’est considéré comme bloqué que s’il dure longtemps, continue à modifier les mêmes fichiers, présente une forte concentration d’erreurs et répète le même échec.
La réorientation passe par la réponse au hook de Claude Code
La note parvient à Claude Code sous forme de contexte supplémentaire dans la réponse à son propre hook d’outil, jointe au résultat de cet outil et lue pendant le même tour. Elle reprend les propres compteurs de l’agent, indique qu’elle est automatisée et n’apporte aucune connaissance extérieure. Codex ne dispose pas de ce canal dans VibeiDE : le seul moyen d’intervenir dans un tour Codex en cours est un message de réorientation, qui serait interprété comme vos propres mots. Un tour Codex bloqué n’affiche donc que la ligne qui vous est destinée.
Ce que nous avons laissé de côté et comment nous l’avons vérifié
Nous n’avons pas mis en œuvre l’élagage des outils intégrés à Claude Code ni des ensembles de capacités de Codex, et il ne nous appartient pas de retirer les outils que vous avez installés vous-même. Seuls les deux serveurs d’outils ajoutés par VibeiDE peuvent être concernés. Nous avons vérifié tout le parcours avec Claude Code et Codex réels sur une copie isolée de l’application : une information s’est constituée au fil de quatre tâches, puis la tâche suivante l’a reçue et a directement exécuté la commande qui fonctionne. Nous ne chiffrons aucune économie.
Sources : TokenEconomizer sur GitHub, article de recherche sur TokenEconomizer.