Du schickst /steer, um die Richtung zu ändern – und alles friert ein: Die clarify, die den ganzen Turn blockierte


Mitten in einer langen Aufgabe in Slack hält der Agent inne und fragt: „Soll ich weiter die alten Build-Artefakte aufräumen?“ Du willst das nicht beantworten. Du hast deine Meinung geändert – du willst ihn lieber am Auth-Modul. Also tippst du /steer skip the artifacts, look at auth und drückst Enter.

Danach: Stille.

Kein Acknowledgement, keine neue Ausgabe, die Frage steht weiter da. Du wartest dreißig Sekunden, schickst „bist du da?“, nichts. Ein paar Minuten später verschwindet die Frage von selbst und der Agent schleppt sich weiter – ohne jedes Zeichen, dass er deinen Steer je gesehen hat.

Das ist kein wackeliges Netzwerk und kein langsames Modell. Es ist ein echter Deadlock, und der Grund ist sehr konkret.

Was /steer wirklich verspricht

Fangen wir mit der Semantik an, denn hier liegt das Missverständnis.

/steer startet keinen neuen Turn und unterbricht nicht. Es hängt eine Notiz an den bereits laufenden Run, sodass das Modell sie nach dem nächsten Tool-Call sieht – die Doku sagt genau das: sie kommt nach dem nächsten Tool-Call, kein Interrupt, kein neuer User-Turn. Die Tool-Calling-Schleife wird nicht durchbrochen, sie bekommt nur Kontext.

Das ist wirklich nützlich. Der Agent lässt Tests laufen, du sagst „konzentrier dich auf das Auth-Modul“, und in der nächsten Iteration justiert er, statt neu anzufangen.

Aber es kommt mit einer Annahme: es muss einen nächsten Tool-Call geben.

Wie der Deadlock entsteht

Wenn der Agent dich mitten in der Aufgabe etwas fragt, ist das fragende Tool clarify. Es ist anders als andere Tools: Es liefert keine Daten, es wartet einfach auf einen Menschen. Auf der Gateway-Seite ist es ein Pending-Prompt – womöglich eine persistente native Karte in Slack oder Feishu.

Jetzt addiere zwei Fakten:

  1. Das einzige Tool in Flight in diesem Run ist diese clarify, blockiert am User.
  2. Der User hat nicht geantwortet; er hat etwas geschickt, das als Kommando erkannt wird (/steer).

Der zweite Fakt ist die Falle. Ein erkanntes Slash-Kommando wird bewusst nicht als Antwort auf den Prompt behandelt. Das Design ist richtig – du wolltest ein Kommando absetzen, nicht die Frage beantworten. Also bleibt der Prompt scharf und die clarify blockiert.

Was bedeutet: Der Tool-Batch kehrt nie zurück. Keine nächste Tool-Call-Grenze, kein Ort, an dem /steer landen könnte. Schlimmer noch, der Steer wird trotzdem akzeptiert: agent.steer() verlangt nur einen lebenden Turn, und der Turn lebt – er sitzt in der clarify. Du bekommst also ein Versprechen („kommt nach dem nächsten Tool-Call“), das nie eingelöst werden kann.

Vor dem Fix gab es nur einen Ausweg: agent.clarify_timeout läuft ab.

Der Fix: Prompt freigeben, bevor der Steer angenommen wird

Der erste Commit (fix(gateway): a /steer releases the clarify that owns the turn) macht genau das: Im /steer-Handler wird vor dem Annehmen des Steers der Pending-Prompt freigegeben.

Die Freigabe funktioniert wie der Timeout: Der Prompt löst sich als CANCELLED auf, und eine persistente native Karte wird zurückgezogen. Mit zurückgezogenem Prompt ist der Block weg, der entblockierte Turn läuft weiter, und der Steer läuft an der nächsten Grenze ab. Das Paar aus Resolve und Retire, das vorher im Prose-Zweig inline stand, wurde zu _release_pending_clarify und wird von beiden Call-Sites geteilt.

Und wenn das Modell den Turn direkt nach dem Entblocken beendet? Der Steer geht nicht verloren – der Finalizer liefert einen übrig gebliebenen Steer als nächsten User-Turn erneut aus, die Notiz kommt also irgendwann an, möglicherweise einen Turn später.

Die zweite Falle: die Reihenfolge zählt

Als der erste Fix drin war, blieb eine subtilere Race übrig, und sie verdient einen eigenen Absatz, weil sie erklärt, warum „einfach zwei Zeilen tauschen“ einen separaten Fix wert war.

Die Freigabe des Prompts entblockt den Agent-Thread sofort. Direkt danach awaitet er ein Karten-Update – ein echter Netzwerk-Roundtrip auf Slack oder Feishu. Die ursprüngliche Reihenfolge war: Prompt freigeben, Karten-Update awaiten, dann den Steer annehmen. Während dieses Awaits konnte der frisch geweckte Agent seine nächste Anfrage starten oder den Turn komplett beenden. Als der Steer eingereiht wurde, gab es keinen lebenden Turn mehr, in den man ihn hätte injizieren können, und die Notiz war weg.

Der zweite Commit (fix(gateway): /steer is queued before the clarify it releases wakes the agent) dreht die Reihenfolge um: erst den Steer einreihen, dann den Prompt freigeben. So langsam das Karten-Update auch ist, der Steer wartet schon in der Queue.

In einem Satz: Die Prompt-Freigabe entsperrt den Turn, und das Einreihen muss vor dem Entsperren passieren.

Was du heute tun kannst

Bis das in einem Release landet (beides ist auf main, nicht in v0.23.0), gibt es praktische Workarounds.

Update (10.11.2026): Diese Änderungen sind mit v0.23.1 (9. November) erschienen – ein hermes update genügt. Die Aussage „nicht in v0.23.0“ oben stimmt weiterhin; v0.23.1 schließt die Lücke.

Beantworte einen Prompt nicht mit einem Kommando. Wenn der Agent etwas fragt, beantworte es – auch mit „warte erst mal“ –, lass den Turn enden, dann /steer. Oder tu nichts und lass ihn auslaufen.

Kenne deinen Timeout. Der Default ist von einer Stunde auf 90 Sekunden gesunken; ältere Configs mögen noch 3600 tragen. Prüfe deinen eigenen Wert:

hermes config get agent.clarify_timeout

0 oder eine negative Zahl bedeutet unbegrenzt (und ein legacy clarify.timeout auf oberster Ebene gewinnt weiterhin, wenn es explizit gesetzt ist). Wenn du das mal hochgesetzt hast, um „Nutzern reichlich Zeit zu geben“, ist das genau die Stelle, an der dieser Deadlock am meisten schmerzt: Eine unbeantwortete Frage nagelt den ganzen Turn am Schreibtisch fest.

Willst du dich einmischen, ohne den Turn zu übernehmen? Nimm /btw. Es ist der Nebenchannel: Es beantwortet eine Nebenfrage, ohne die laufende Arbeit zu unterbrechen, und macht aus deiner Nachricht kein Kommando, das den Pending-Prompt stört. Siehe eine Nebenfrage mit /btw stellen.

Frage vorab weniger. Wenn du fünf Dinge geklärt brauchst, frag sie in einem Batch statt in fünf Roundtrips – das Muster steht in clarify Batch-Fragen.

Was dir der Bug wirklich sagt

An der Oberfläche ist es ein Ordering-Bug über zwei Zeilen. Interessant sind die drei Annahmen, die er gebrochen hat:

Erstens: /steer nimmt an, dass es immer eine nächste Tool-Grenze gibt. Das hält, solange Tools von selbst zurückkehren – aber clarify ist das eine Tool, dessen Rückkehrbedingung ein Mensch ist, und es bricht die Annahme.

Zweitens: Command-Routing nimmt an, dass ein Kommando den Turn nicht braucht. Meistens stimmt das: Die meisten Slash-Commands lesen oder schreiben Config und schalten Modi um. /steer ist eines der wenigen, das den Turn braucht, um zu wirken.

Drittens, und das ist der Punkt für deinen eigenen Code: Entblocken ist ein side-effect-behafteter Akt. Trenne es von der Auslieferung, und das Await dazwischen wird ein neues Race-Fenster. Entweder liefere vor dem Entblocken aus, oder mach das Paar atomar – hier war die billigere Option das Umsortieren, weil zwei Zeilen tauschen weniger kostet, als eine Transaktion zu bauen.

Wenn du mehrere Agenten orchestrierst oder /steer benutzt, um einen Subagenten zu korrigieren, taucht dieselbe Grenze zwischen Kommando und Antwort woanders wieder auf; die Notizen zu Kontrollsignalen in Subagenten live orchestrieren und die hermes gateway-Referenz der Seite decken die Routing-Seite ab.

Status

Beide Commits sind auf main (7. November) und in keinem Tag, v0.23.0 eingeschlossen. hermes update liefert dir Releases, du hast diesen Fix also erst mit dem nächsten – oder du folgst main.

Bis dahin reicht der kürzestmögliche Rat: Wenn der Agent auf eine Antwort wartet, beantworte seine Frage nicht mit einem Kommando.