Quand la façade tient la conversation (LOKI_CHAT=rust), read, grep, glob, write, edit, bash et ask s'exécutent dans rust/loki-rs/src/tools au lieu de repartir au Go par /internal/v1/tool/exec : mêmes garde-fous dans le même ordre (commande catastrophique, « & » final en mode Code, bac à sable du mode Code, dossier mémoire interdit, lu avant d'écrire), même diff pour l'UI, même nettoyage de la sortie du shell. Le jeton de l'API interne est retiré de l'environnement du shell de l'agent. L'état partagé reste au Go, en un seul exemplaire (sous-agents et tâches le lisent aussi) : POST /internal/v1/tool/context (dossier de travail, dossier mémoire, cible distante), /tool/tracker (lecture notée, contrôle avant écriture), /tool/wrote (note après écriture, diagnostics LSP). Repli sur le Go pour une cible distante ou un contexte indisponible. Parité : internal/loki/parity_tools_test.go passe 58 appels à execTool sur une arborescence de test et range le journal dans tests/parity_tools ; tests/tools.rs le retrouve à l'identique avec exec_local. Écarts assumés consignés dans docs/superpowers/specs/2026-10-15-rust-migration-lot7-outils-design.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016tcGfJWefW5kUGoC2wL8cv
3.1 KiB
Lot 7 — outils de l'agent exécutés par la façade
Contexte
Lot 6 : quand la façade tient la conversation (LOKI_CHAT=rust), la boucle du
tour est en Rust mais chaque appel d'outil repart au Go
(/internal/v1/tool/exec). Lot 7 : porter les outils eux-mêmes, en retirant
les appels au Go un par un. Rien ne change sans LOKI_CHAT=rust : la boucle
Go exécute ses outils comme avant.
Étape 1 — fichiers et shell (fait)
Exécutés par la façade (rust/loki-rs/src/tools/) : read, grep, glob,
write, edit, bash, ask, avec les mêmes garde-fous dans le même ordre
(commande catastrophique, & final en mode Code, bac à sable du mode Code,
dossier mémoire interdit, « lu avant d'écrire »), le même diff pour l'UI et le
même nettoyage de la sortie du shell (| tail -N, ANSI, fin bornée).
L'état partagé reste au Go, en un seul exemplaire, derrière trois routes
internes (web_internal_toolstate.go) :
| Route | Rôle |
|---|---|
POST /internal/v1/tool/context |
dossier de travail (agentCwd), dossier mémoire, cible distante |
POST /internal/v1/tool/tracker |
read : lecture notée ; check : refus éventuel avant écriture |
POST /internal/v1/tool/wrote |
après une écriture : note du suivi, bloc des diagnostics LSP |
Le suivi reste au Go parce que les sous-agents et les tâches planifiées, qui y tournent, le lisent et l'écrivent aussi ; les serveurs LSP y vivent.
Repli sur le Go : outil non porté ; write/edit/bash quand l'agent vise
un poste distant (une commande catastrophique est refusée avant, ici) ;
contexte indisponible.
Le jeton de l'API interne est retiré de l'environnement du shell de l'agent.
Parité
internal/loki/parity_tools_test.go passe 58 appels à execTool sur une
arborescence de test et range le journal (libellés, résultats, diffs,
questions, arborescence finale) dans rust/loki-rs/tests/parity_tools/ ;
rust/loki-rs/tests/tools.rs rejoue les mêmes appels dans exec_local et
retrouve le même journal. Le test Go échoue si le comportement Go change
(LOKI_PARITY_UPDATE=1 pour régénérer, puis le test Rust dit si le port suit).
Écarts assumés
- Motif
grepinvalide : le message d'erreur est celui du moteur d'expressions de Rust (crateregex), pas celui de Go. - Classes
\w,\b,\s,\dd'un motifgrep: Unicode en Rust, ASCII en Go (un mot accentué y est un mot entier). - Octets hors UTF-8 dans un fichier lu ou cherché : remplacés par U+FFFD par
séquence invalide (Go : par octet, à l'encodage JSON).
edittravaille sur les octets et laisse intact ce qu'il ne remplace pas. mkdiren échec : le chemin cité est le dossier parent visé, pas le composant qui a échoué.
Étapes suivantes
- Web (
web_search,web_open,web_read,web_grep,web_images) : configuration seule, pas d'état partagé. - Shell d'arrière-plan (
bash_bg,bash_tail) et git (git_status,git_diff,git_clone) : jobs tenus par le Go aujourd'hui. - Mémoire (
mem_*,recall*) : avec le portage du chiffrement. - Tâches, navigateur (CDP), MCP, sous-agents, critères et mode Code.