wrap, raw et filter

tokenade wrap exécute une commande shell et renvoie une version compactée de sa sortie, avec le même code de sortie. C'est ce qu'appelle le hook de votre agent pour chaque commande shell, et vous pouvez l'utiliser à la main avec n'importe quel agent. raw est l'échappatoire qui exécute une commande sans compaction ; filter compacte une sortie capturée plus tôt.

wrap

Alias : exec-compact. Passez la commande en un seul argument entre guillemets : tokenade wrap 'git log --stat -20'.

Sans --shell, le shell est déduit de l'environnement, avec posix en repli. Précisez-le quand vous enveloppez à la main une commande PowerShell ou cmd.

Ce que fait wrap, dans l'ordre :

1. Exécute la commande et capture stdout et stderr ensemble (plafonds : 16 Mo pour stdout, 4 Mo pour stderr).
2. Masque les secrets.
3. Compacte la sortie avec un compacteur qui connaît cette commande, ou qui reconnaît son format (JSON, logs, diffs, tableaux, etc.).
4. Si le résultat reste gros, range la sortie complète sur disque et renvoie un aperçu avec un hash que vous pouvez interroger. Voir Compaction des sorties et stash.
5. Sort avec le code de la commande interne (128 + signal si elle a été tuée par un signal).

Piège : stderr est fusionné

wrap fusionne stderr dans stdout avant de compacter. tokenade wrap 'cmd' 2>err.log écrit donc un err.log vide. Faites la redirection dans la commande enveloppée (tokenade wrap 'cmd 2>err.log') ou utilisez --split-streams.

raw

Alias : bypass, noproxy. Exécute la commande sans compaction et définit TOKENADE_HOOK_DISABLED=1 pour que les hooks de l'agent la laissent passer aussi. Les flux de sortie sont hérités, le code de sortie est celui de la commande, et rien n'est écrit dans le registre des économies.

Vous n'en avez généralement pas besoin. Si vous avez déjà lancé une commande via Tokenade et qu'il vous faut les octets exacts, tokenade expand-ref <hash> les rend depuis le stash, instantanément, sans rien relancer. raw sert à ce que le stash ne peut pas fournir : relancer sans compaction, exécuter en interactif, ou déboguer un compacteur.

Pour les commandes dont la sortie se replie bien (grep, rg, ag, find, ls, wc, head, tail, awk, sed, cat), raw refuse et sort en 2, car relancer dépenserait une seconde fois les tokens de l'appel d'origine :

Forcez avec TOKENADE_FORCE_BYPASS=1 tokenade raw … quand vous avez vraiment besoin du flux d'origine.

Si vous contournez souvent (raw, ou tout hook sauté via TOKENADE_HOOK_DISABLED=1), chaque contournement supplémentaire affiche un rappel d'une ligne sur stderr qui renvoie vers expand-ref. Ce rappel ne peut pas être désactivé.

filter

Compacte l'entrée standard comme si elle venait de la commande indiquée. Pratique quand la sortie est déjà capturée :

Sans --deliver, filter n'applique que le compacteur de la commande et ne range rien dans le stash. Sur une sortie que ce compacteur laisse telle quelle, il renvoie l'entrée inchangée là où wrap la replierait quand même. tokenade read - est encore différent : il détecte le format sans indication de commande.

Envelopper automatiquement dans votre shell

tokenade shell-init affiche un fragment de shell qui fait passer les commandes bavardes par tokenade wrap quand l'entrée standard n'est pas un terminal, autrement dit pour les agents, pas quand vous tapez vous-même. Elle couvre les commandes que Tokenade sait compacter, limitées à ce qui est réellement présent dans votre PATH.

Options : --shell sh|bash|zsh|fish|powershell|nushell|csh|cmd, --all (sans filtre sur le PATH). Sous csh/tcsh et cmd.exe, les alias passent par tokenade shellwrap, qui laisse passer dans un terminal et enveloppe sinon. tokenade install met cela en place pour vous ; il n'est utile à la main que pour un agent que Tokenade ne peut pas brancher par hooks.

Voir aussi

• Compaction des sorties et stash
• Récupérer une sortie repliée
• Comment les hooks interceptent les appels d'outils
• Lancer des scripts avec execute