Documentatie
TokenEconomizer
Hoe we TokenEconomizer in de VibeiDE Brain hebben ingebouwd
De Economizer in VibeiDE is onze eigen implementatie van het gepubliceerde TokenEconomizer-ontwerp van Microsoft Research, Microsoft Security en UC Berkeley, niet de plug-in zelf. De Economizer doet geen modelaanroepen, schrijft niets naar je repository en laadt niets zolang de Brain voor een project uitstaat. Deze pagina legt uit wat we hebben behouden, wat we hebben aangepast en wat we hebben weggelaten.
Een implementatie van het ontwerp, niet de plug-in
TokenEconomizer wordt geleverd als een Python-plug-in die naar de repository schrijft en voor sommige beslissingen een model raadpleegt. De Brain in VibeiDE hanteert strengere voorwaarden: geen modelaanroep, geen sleutel, geen Python, geen bestanden naar je repository schrijven en niets laden zolang de Brain voor een project uitstaat. Daarom hebben we de drie mechanismen opnieuw binnen VibeiDE geschreven, op basis van het gepubliceerde ontwerp en de bijbehorende constanten, en alleen behouden wat aan die voorwaarden voldoet. Niets uit de plug-in wordt meegeleverd, geïnstalleerd of uitgevoerd.
Twee manieren om een toolaanroep te lezen
De Economizer moet kunnen zien wat een agent heeft uitgevoerd en wat het resultaat was. Voor Claude Code in een terminal leest de Economizer de eigen hooks van Claude Code, die worden beantwoord voordat Claude het toolresultaat leest. Voor Codex, en voor Claude Code zonder hooks, leest de Economizer de gebeurtenissenstroom die VibeiDE al voor Taakactiviteit bijhoudt. Beide worden omgezet naar dezelfde structuur: de tool, het commando, de paden, de uitvoer en of de aanroep is mislukt. De uitvoer wordt ingekort, één keer gelezen en nooit opgeslagen.
Feiten zijn vaste zinnen, omdat commando's niet vertrouwd worden
Een feit wordt aan elke latere taak meegegeven en is afkomstig uit commando's die een agent heeft ingevoerd en uitvoer die een repository heeft geproduceerd. Daarom bewaart de Economizer nooit vrije tekst. Een feit is een van vier vaste zinnen met gecontroleerde parameters: een korte commandovorm in gewone woorden, een toolnaam, een hostnaam of een variabelenaam. De waarde van een variabele wordt alleen vermeld als die kort en eenvoudig is en de naam niet op gevoelige informatie duidt. Al het andere levert geen feit op.
Wanneer een feit wordt bewaard, meegegeven en afgevoerd
We gebruiken de levenscyclus van TokenEconomizer. Een kandidaat wordt een feit nadat drie taken het bevestigen. Het wordt alleen meegegeven zolang de verspilling die het voorkomt, voorkomt in ten minste 40 procent van minimaal vier taken die ermee te maken hadden. Een score die recente taken zwaarder laat wegen, zorgt ervoor dat het feit vervalt, bijvoorbeeld wanneer de oude schrijfwijze van een commando in twee opeenvolgende taken weer werkt.
Beveiliging tegen herhaallussen zonder beoordelend model
De plug-in vraagt een model of een gemarkeerde beurt echt vastloopt. De Brain heeft geen model om dat te vragen, dus gebruikt de beveiliging de voorzichtige standaardinstelling uit het ontwerp: ze wacht tot zeven beurten in het project goed zijn afgelopen en grijpt nooit in binnen de gebruikelijke duur van een goed verlopende beurt. Een beurt geldt alleen als vastgelopen als die lang duurt, dezelfde bestanden blijft bewerken, veel fouten oplevert en dezelfde fout zich blijft herhalen.
De bijsturing komt mee in het antwoord op de eigen hook van Claude Code
Het bericht bereikt Claude Code als extra context in het antwoord op zijn eigen toolhook, gekoppeld aan dat toolresultaat en gelezen in dezelfde beurt. Het geeft de tellingen van de agent zelf terug, vermeldt dat het automatisch is gegenereerd en bevat geen kennis van buitenaf. Codex heeft in VibeiDE geen vergelijkbaar kanaal: de enige manier om een lopende Codex-beurt te bereiken is een bijsturingsbericht, dat als jouw woorden zou worden gelezen. Daarom krijgt een vastgelopen Codex-beurt alleen de regel voor jou.
Wat we hebben weggelaten en hoe we het hebben gecontroleerd
We hebben geen functie gebouwd om de ingebouwde tools van Claude Code of de capability-pakketten van Codex weg te laten, en het is niet aan ons om tools te verwijderen die je zelf hebt geïnstalleerd. Alleen de twee toolservers die VibeiDE toevoegt, komen daarvoor in aanmerking. We hebben het volledige traject gecontroleerd met echte Claude Code en Codex in een geïsoleerde kopie van de app: gedurende vier taken ontstond een feit, waarna de volgende taak dat feit meekreeg en meteen het werkende commando uitvoerde. We noemen geen omvang van de besparing.
Bronnen: TokenEconomizer op GitHub, wetenschappelijk artikel over TokenEconomizer.