Intensif Gratuit 21–22/11Intensif gratuit de 2 jours en Vibecoding (21–22 nov, 16h00 MSK) · Cohorte 3 le 23/11S'inscrire gratuitement →Cohorte 3 (23/11)
SortieAnalyse · Sur le radarHabr AI→ original

Un automate à états sur un hook empêche l'agent IA de bloquer Bash : les 122 tests passent

Si un agent IA perd un guillemet de fermeture, Bash attend la suite de la saisie et l'agent reste bloqué jusqu'à l'expiration du délai. Quote Guard remplace les expressions régulières par un automate à états finis (FSM) : il lit la commande caractère par caractère selon les règles du shell, directement dans le hook PreToolUse, avant l'exécution. En cas de désaccord entre Bash et PowerShell, l'agent reçoit une indication et corrige lui-même son appel. La protection contre les blocages doit rester dans l'infrastructure, et non dans le prompt.

Traité par IA depuis Habr AI ; édité par Hamidun News
Un automate à états sur un hook empêche l'agent IA de bloquer Bash : les 122 tests passent
Source : Habr AI. Collage: Hamidun News.
Écouter l'article
Fiche synthèse et chiffres clés
ParamètreDonnées
Source primaireHabr AI ↗
Rédacteur en chef
La chaîne dir "C\" est sûre dans PowerShell, mais bloque Bash
Chiffre clé #2La v3.0 laissait passer les heredocs en entier ; dans la v3.1, leur corps est masqué par des espaces
Chiffre clé #3Les 122 vérifications en Python et Node.js passent, y compris les tests adversariaux

Imaginez : un agent autonome construit une commande pour le terminal et perd un guillemet de fermeture. Pour un texte, c'est une coquille ; pour Bash, c'est une raison de s'arrêter et d'attendre. Le shell considère que la saisie va se poursuivre à la ligne suivante, affiche l'invite « >> » et reste silencieux.

Si l'agent lit le processus de manière synchrone, la fin de flux (EOF) n'arrive jamais, le processus ne se termine pas, la session expire par timeout et l'agent échoue. L'auteur du projet Quote Guard a décrit sur Habr comment fermer cette brèche sans recourir à des consignes dans le prompt. Il a placé un automate à états finis (FSM) avant l'exécution de la commande — un petit programme qui lit la chaîne caractère par caractère et connaît à chaque instant sa position : dans le texte ordinaire, à l'intérieur de guillemets ou après un caractère d'échappement.

Il est intégré au hook PreToolUse — un intercepteur qui se déclenche avant que l'agent ne transmette la commande au système d'exploitation. La fiabilité est confirmée par 122 vérifications automatiques, qui toutes réussissent.

Pourquoi les expressions régulières ne suffisent pas

La première idée consiste à vérifier la parité des guillemets, par exemple count % 2 == 0. Mais une même chaîne se lit différemment selon le shell. Prenons dir "C:\". Dans PowerShell, la barre oblique inverse est un simple séparateur de chemin : le guillemet s'ouvre, voit C:\, se ferme, et la commande est prête. Dans Bash, cette même barre échappe le guillemet suivant, qui cesse alors d'être un guillemet de fermeture, et le shell attend une suite qui ne viendra jamais.

Le second exemple suit la même logique : dans echo "a"b"`, l'accent grave est, en PowerShell, un caractère d'échappement, tandis qu'en Bash il déclenche une substitution de commande ; le shell cherche alors l'accent grave correspondant et repasse en mode multiligne. On ne peut pas deviner le shell d'après le système d'exploitation de l'hôte : dans les conteneurs Windows on trouve Bash, sous WSL on trouve PowerShell, et l'agent lance des scripts multiplateformes. Un validateur naïf laissera passer le blocage sous Linux, ou bloquera un chemin Windows légitime. Après le premier faux positif, l'ingénieur désactivera simplement la protection.

L'automate à états et le « double verrou »

L'auteur a remplacé les expressions régulières par un automate déterministe doté de trois grammaires isolées : posix, powershell et cmd. Il fait passer les états (texte ordinaire, guillemets doubles, guillemets simples, échappement) strictement selon les règles de l'environnement cible.

Pour les outils inconnus, comme un plugin tiers ou un agent sur mesure, un mode Strict Intersect entre en jeu. La commande est vérifiée simultanément selon deux grammaires, posix et powershell :

  • sûre dans les deux — on laisse passer ;
  • mène au blocage dans les deux — on bloque ;
  • les évaluations divergent, comme pour dir "C:\" — l'exécution est interrompue avec le code Exit 2.

Au lieu d'un blocage silencieux, le modèle reçoit un refus lisible par une machine : outil inconnu, la chaîne est sûre en PowerShell mais bloque POSIX, et une indication pour définir la variable QUOTE_GUARD_MAP=MyTool=powershell. L'agent lit l'instruction et, dès la deuxième étape, envoie un appel correct. Cela fait gagner du temps de session et des tokens qui seraient sinon dépensés en nouvelles tentatives après un timeout.

L'histoire du heredoc et les 122 vérifications

Le passage le plus utile du texte est l'analyse honnête d'une erreur. Un heredoc est un bloc de texte en Bash délimité par des marqueurs comme <<EOF et EOF. Dans la version v3.0, le hook voyait le marqueur <<EOF, considérait que le contenu était « brut » et laissait passer toute la commande. Un test a révélé la brèche : le modèle a généré cat <<EOF … EOF, puis echo "unclosed. Le hook a vu le marqueur et tout laissé passer, et le guillemet non fermé après le bloc a bloqué le shell.

Dans la v3.1, le masquage du corps du heredoc a été ajouté : le contenu est remplacé par des espaces tout en conservant les décalages, afin de ne pas perturber l'analyseur, et tout ce qui précède et suit est vérifié par l'automate. Si le terminateur EOF lui-même n'est pas fermé, le hook enregistre l'état HEREDOC et bloque le lancement. Désormais, cat <<EOF avec un script à l'intérieur passe, mais EOF suivi de echo "broken ne passe pas.

Le projet est testé sur un jeu commun multilingue cases.jsonl comportant 31 cas grammaticaux. Au total, 122 vérifications : 46 pour chacune des implémentations de l'analyseur lexical en Python et en Node.js (elles doivent se comporter exactement de la même façon octet par octet), 25 pour l'intégration du hook PreToolUse et 5 pour l'auto-contrôle du détecteur de duplication. Toutes réussissent. Les tests sont adversariaux : ils contiennent des tentatives de sortie des guillemets, des constructions imbriquées, des injections multilignes et des contournements du hook.

Ce que cela change en pratique

Pour ceux qui construisent des agents disposant d'un accès au shell, la conclusion est simple : une génération probabiliste doit être encadrée par une passerelle déterministe. Il est également appréciable que le refus soit renvoyé sous forme d'instruction au modèle, et non sous forme de silence.

L'auteur reconnaît lui-même les limites. La garantie ne vaut que si le hook est installé sur l'hôte et que les variables d'environnement n'ont pas été altérées. Trois grammaires sont couvertes ; d'autres shells, comme fish ou zsh avec ses extensions particulières, devront être décrits séparément. Les résultats des tests ne sont pour l'instant confirmés que dans le dépôt du projet, sans audit indépendant. Mais en tant que modèle pour le runtime des agents, l'approche fonctionne : un automate à la place des expressions régulières, un refus structuré à la place du blocage, et un test obligatoire pour chaque brèche découverte.

Dossier

Questions clés sur cet article

Pourquoi les expressions régulières ne suffisent pas?

La première idée consiste à vérifier la parité des guillemets, par exemple count % 2 == 0. Mais une même chaîne se lit différemment selon le shell. Prenons dir "C:\". Dans PowerShell, la barre oblique inverse est un simple séparateur de chemin : le guillemet s'ouvre, voit C:\, se ferme, et la commande est prête. Dans Bash, cette même barre échappe le guillemet suivant, qui cesse alors d'être un guillemet de fermeture, et le shell attend une suite qui ne viendra jamais.

Que sait-on sur L'automate à états et le « double verrou » ?

L'auteur a remplacé les expressions régulières par un automate déterministe doté de trois grammaires isolées : posix, powershell et cmd. Il fait passer les états (texte ordinaire, guillemets doubles, guillemets simples, échappement) strictement selon les règles de l'environnement cible. Pour les outils inconnus, comme un plugin tiers ou un agent sur mesure, un mode Strict Intersect entre en jeu.

Que sait-on sur L'histoire du heredoc et les 122 vérifications ?

Le passage le plus utile du texte est l'analyse honnête d'une erreur. Un heredoc est un bloc de texte en Bash délimité par des marqueurs comme <<EOF et EOF. Dans la version v3.0, le hook voyait le marqueur <<EOF, considérait que le contenu était « brut » et laissait passer toute la commande. Un test a révélé la brèche : le modèle a généré cat <<EOF … EOF, puis echo "unclosed. Le hook a vu le marqueur et tout laissé passer, et le guillemet non fermé après le bloc a bloqué le shell.

ZK
Zhemal Khamidun — CPO d'Alpina Digital, product manager d'AlpinaGPT. Conçoit des produits IA depuis 2019. Hamidun News est un projet personnel devenu un agrégateur en production avec plus de 6 000 lecteurs.
✦ Unified AI Workspace · Nomad

Test Frontier LLMs & Autonomous Agents in One Workspace

Run Claude Opus 5.5, GPT-6, Gemini 3.1, and DeepSeek side-by-side in Nomad AI (nomadnet.ai) — unified model routing, deep research, and multimodal workflows under one subscription.

Try Nomad AI →Launch Nomad Agent
Qu'en pensez-vous ?
Chargement des commentaires…