Comment les économies sont mesurées

Tokenade mesure chaque économie là où elle se produit : la taille de la sortie avant son intervention, la taille après, et la différence. Il corrige ensuite ce chiffre selon ce que votre agent aurait réellement reçu, et range ce qu'il ne peut pas mesurer directement dans une estimation séparée et clairement étiquetée. Cette page détaille chaque étape, pour que vous puissiez juger les chiffres affichés par tokenade gain et le dashboard.

Le registre

Chaque fois que Tokenade modifie ce qui atteint le modèle, il ajoute une ligne à ~/.tokenade/gain.jsonl. Tous les projets écrivent dans ce même fichier. Chaque ligne note le moment, le canal (hook, wrap, proxy…), ce qui a agi, l'agent et le modèle quand ils sont connus, le répertoire de travail, le nom du programme, et les tokens avant, après et économisés.

Le fichier tourne à 10 Mio et conserve les 30 derniers jours de lignes. Vos totaux sur une période plus longue sont conservés dans un cumul.

Le comptage des tokens

Les tokens sont comptés localement, à quelques pour cent près. Le même compteur sert des deux côtés de chaque ligne : avant et après restent donc toujours comparables. Aucun texte n'est envoyé où que ce soit pour être compté.

Trois corrections appliquées à chaque ligne

1. Seules les vraies économies sont comptées

Si la sortie après Tokenade est plus grosse qu'avant, l'économie vaut zéro (et c'est la sortie brute qui a été renvoyée).
Les économies négligeables ne sont pas enregistrées : c'est du bruit de mesure, pas une économie.
Les lignes invraisemblables sont mises à zéro et journalisées.

2. Les propres limites de l'agent sont prises en compte

Les agents tronquent ou refusent déjà les très gros résultats d'outils. Compter toute la taille brute comme « économisée » surestimerait le gain : Tokenade plafonne donc chaque ligne à ce que l'agent aurait réellement transmis au modèle.

Quand la sortie brute aurait été tronquée, seule la partie que l'agent aurait vue compte, plus un crédit limité pour les lectures supplémentaires qu'entraîne généralement un résultat tronqué ou refusé. Ce crédit est signalé comme approximatif : tokenade gain l'affiche sur sa propre ligne, et un reçu le mentionne à part.

3. Ce que Tokenade ajoute est décompté

Tokenade ajoute un peu de texte à lui : la note de style, les consignes qu'il écrit dans le fichier d'instructions de votre agent. Ce coût est enregistré comme surcoût et déduit, à chaque requête qui le transporte, sur tous les agents.

Mesuré ou estimé

Certains bénéfices ne se mesurent pas après coup. Ils vont dans un registre séparé, ~/.tokenade/gain_estimated.jsonl, chaque ligne marquée "estimated": true, et ne sont jamais ajoutés à saved:.

Estimation	Pourquoi on ne peut pas la mesurer exactement
Intelligence de code (`skeleton`, `query`, `map`, `impact`, `semantic`)	L'entrée est mesurée, mais l'alternative (lire le fichier entier) est supposée
Relectures évitées	Un résultat replié continue d'économiser à chaque requête suivante qui l'aurait renvoyé ; compté prudemment
Regroupement et reprises	Moins d'allers-retours et moins de tentatives sont déduits, pas observés

tokenade gain les affiche sur des lignes est.: sous le total mesuré. Le dashboard les présente comme « estimated », à côté du chiffre mesuré, jamais dedans.

Le proxy LLM

Pour les agents servis par le proxy LLM, seuls les tours auxquels le fournisseur a répondu avec succès sont comptés. Chaque bloc replié est compté une fois, comme mesuré, à son premier envoi. Quand des requêtes suivantes le renvoient replié, elles sont comptées prudemment comme relectures estimées. La note de style ajoutée par le proxy est décomptée sur chaque requête qui la porte.

Montants en argent

Le dashboard valorise chaque ligne au tarif du modèle qui l'a réellement traitée, d'après le modèle noté sur la ligne ou, à défaut, celui de la session. Les tarifs d'entrée, de lecture de cache et de sortie s'appliquent aux tokens correspondants, et le surcoût est déduit.

Chiffres locaux et chiffres du compte

tokenade gain et le dashboard lisent votre registre local. Votre compte tokenade.net compte les économies à partir des événements d'usage que Tokenade transmet (des nombres et des noms de programmes uniquement ; voir ce que Tokenade envoie). Ce décompte serveur, affiché comme metered: dans tokenade gain, déduplique plus grossièrement et peut donc être légèrement inférieur au saved: local. Les lignes estimées ne comptent jamais dans le quota de votre offre. Les limites des offres sont sur la page tarifs.

Vérifiez vous-même

tokenade gain --history # one line per ledger row
tokenade gain --json # totals, by_op[], by_source[]
tokenade receipt --json # signed summary, verifiable with --verify