Vous avez envoyé /steer pour changer de cap, et tout s'est figé : le clarify qui verrouillait le tour entier

Au milieu d’une longue tâche dans Slack, l’agent s’arrête et demande : « Faut-il que je continue à nettoyer les anciens artefacts de build ? » Vous ne voulez pas répondre à ça. Vous avez changé d’avis — vous le voulez sur le module d’authentification. Alors vous tapez /steer skip the artifacts, look at auth et vous validez.
Puis : le silence.
Pas d’accusé de réception, aucune sortie nouvelle, la question toujours là. Vous attendez trente secondes, vous demandez s’il est encore là, rien. Quelques minutes plus tard, la question disparaît d’elle-même et l’agent repart lourdement — sans le moindre signe qu’il ait jamais vu votre steer.
Ce n’est pas un réseau capricieux et ce n’est pas un modèle lent. C’est un vrai deadlock, et la raison est très précise.
Ce que /steer promet exactement
Commençons par la sémantique, parce que le malentendu loge ici.
/steer ne démarre pas un nouveau tour et n’interrompt rien. Il ajoute une note au run déjà en cours, pour que le modèle la voie après l’appel d’outil suivant — la doc le dit mot pour mot : elle arrive après l’appel d’outil suivant, sans interruption, sans nouveau tour utilisateur. La boucle d’appels d’outils n’est pas cassée ; elle gagne simplement du contexte.
C’est réellement utile. L’agent lance les tests, vous dites « concentre-toi sur le module d’authentification », et à l’itération suivante il ajuste au lieu de repartir de zéro.
Mais cela vient avec une hypothèse : il faut qu’il y ait un appel d’outil suivant.
Comment le deadlock se forme
Quand l’agent vous demande quelque chose en cours de tâche, l’outil qui pose la question est clarify. Il diffère des autres : il ne renvoie aucune donnée, il attend un humain. Côté gateway, c’est un prompt en attente — parfois une carte native persistante dans Slack ou Feishu.
Empilez maintenant deux faits :
- Le seul outil en vol dans ce run est ce
clarify, bloqué sur l’utilisateur. - L’utilisateur n’a pas répondu ; il a envoyé quelque chose de reconnu comme une commande (
/steer).
Le deuxième fait est le piège. Une slash command reconnue n’est délibérément pas traitée comme une réponse au prompt. Ce choix est juste — vous vouliez émettre une commande, pas répondre à la question. Donc le prompt reste armé et le clarify reste bloqué.
Autrement dit, le lot d’outils ne rend jamais la main. Pas de frontière d’appel d’outil suivante, pas d’endroit où /steer puisse atterrir. Pire : le steer est quand même accepté : agent.steer() exige seulement un tour vivant, et le tour est vivant — il est assis à l’intérieur du clarify. Vous obtenez donc une promesse (elle arrive après l’appel d’outil suivant) qui ne pourra jamais être tenue.
Avant le correctif, la seule sortie était l’expiration de agent.clarify_timeout.
Le correctif : libérer le prompt avant d’accepter le steer
Le premier commit (fix(gateway): a /steer releases the clarify that owns the turn) fait exactement ça : dans le handler de /steer, avant que le steer soit accepté, le prompt en attente est libéré.
La libération fonctionne comme le timeout : le prompt se résout en CANCELLED et une carte native persistante est retirée. Le prompt retiré, le blocage disparaît, le tour débloqué continue, et le steer s’écoule à la frontière suivante. La paire résolution-plus-retrait, jusque-là écrite en dur dans la branche prose, est devenue _release_pending_clarify, partagée par les deux sites d’appel.
Et si le modèle termine le tour juste après avoir été débloqué ? Le steer n’est pas perdu — le finalizer redélivre un steer restant comme tour utilisateur suivant, donc la note arrive finalement, peut-être un tour plus tard.
Le second piège : l’ordre compte
Une fois le premier correctif en place, il restait une course plus subtile, et elle mérite son propre paragraphe parce qu’elle explique pourquoi une inversion de deux lignes a valu un correctif séparé.
Libérer le prompt débloque le thread de l’agent immédiatement. Juste après, il attend une mise à jour de carte — un vrai aller-retour réseau sur Slack ou Feishu. L’ordre d’origine était : libérer le prompt, attendre la mise à jour de carte, puis accepter le steer. Pendant cette attente, l’agent fraîchement réveillé pouvait lancer sa requête suivante, ou terminer complètement le tour. Le moment où le steer était mis en file, il n’y avait plus de tour vivant où l’injecter, et la note disparaissait.
Le second commit (fix(gateway): /steer is queued before the clarify it releases wakes the agent) inverse l’ordre : mettre le steer en file d’abord, puis libérer le prompt. Aussi lente que soit la mise à jour de carte, le steer attend déjà dans la file.
En une phrase : libérer le prompt est ce qui débloque le tour, et la mise en file doit précéder le déblocage.
Ce qu’il faut faire aujourd’hui
En attendant que tout ça arrive dans une release (les deux sont sur main, pas dans la v0.23.0), il y a des contournements pratiques.
Mise à jour (10/11/2026) : ces changements sont sortis dans la v0.23.1 (9 novembre) : un
hermes updatesuffit. Le « pas dans la v0.23.0 » ci-dessus reste exact ; la v0.23.1 comble l’écart.
Ne répondez pas à un prompt avec une commande. Si l’agent demande quelque chose, répondez — même « laisse tomber pour l’instant » — laissez le tour se terminer, puis /steer. Ou ne faites rien et laissez expirer.
Connaissez votre timeout. La valeur par défaut est passée d’une heure à 90 secondes ; les vieilles configs peuvent encore porter 3600. Vérifiez la vôtre :
hermes config get agent.clarify_timeout
0 ou un nombre négatif signifie illimité (et un ancien clarify.timeout de premier niveau, s’il est défini explicitement, gagne toujours). Si vous avez un jour monté cette valeur pour laisser du temps aux utilisateurs, c’est exactement là que ce deadlock fait le plus mal : une question sans réponse cloue tout le tour sur place.
Envie d’intervenir sans prendre la main sur le tour ? Utilisez /btw. C’est le canal d’aparté : il répond à une question annexe sans interrompre le travail en cours, et il ne transforme pas votre message en commande qui dérange le prompt en attente. Voir poser une question annexe avec /btw.
Posez moins de questions en amont. Si vous avez cinq points à clarifier, demandez-les en un seul lot plutôt qu’en cinq allers-retours — le schéma est décrit dans clarify en questions groupées.
Ce que le bug vous dit vraiment
En surface, c’est un bug d’ordre de deux lignes. La partie intéressante, ce sont les trois hypothèses qu’il a cassées :
D’abord, /steer suppose qu’il y a toujours une frontière d’outil suivante. Ça tient tant que les outils rendent la main tout seuls — mais clarify est le seul outil dont la condition de retour est un humain, et il fait tomber l’hypothèse.
Ensuite, le routage des commandes suppose qu’une commande n’a pas besoin du tour. C’est souvent vrai : la plupart des slash commands lisent ou écrivent de la config et changent de mode. /steer est l’une des rares qui ont besoin du tour pour produire un effet.
Troisièmement, et c’est ce qu’il faut emporter dans votre propre code : débloquer est un acte à effet de bord. Séparez-le de la livraison et l’attente entre les deux devient une nouvelle fenêtre de course. Soit vous livrez avant de débloquer, soit vous rendez la paire atomique — ici l’option la moins chère était de réordonner, parce qu’inverser deux lignes coûte moins que construire une transaction.
Si vous orchestrez plusieurs agents, ou si vous utilisez /steer pour corriger un subagent, la même frontière commande-contre-réponse réapparaît ailleurs ; les notes sur les signaux de contrôle dans orchestration de subagents en direct et la référence hermes gateway du site couvrent le côté routage.
État des lieux
Les deux commits sont sur main (7 novembre) et dans aucun tag, v0.23.0 incluse. hermes update vous donne les releases, donc vous n’aurez pas ce correctif avant la suivante — ou suivez main.
En attendant, le conseil le plus court suffit : quand l’agent attend une réponse, ne répondez pas à sa question avec une commande.