Skip to content

The agent that grows with you

fix(tui): the !cmd refusal on a docker/ssh session names the backend

Teknium7b6fc2f8ac04
diff --git a/gateway/session_shell.py b/gateway/session_shell.py
index ee57e787fdd..645dde9d9f7 100644
--- a/gateway/session_shell.py
+++ b/gateway/session_shell.py
@@ -44,8 +44,10 @@ async def shell_exec(connection, ref, params):
raise RuntimeStoreError('permission_denied')
# The frozen terminal policy chose a sandbox (docker, ssh, ...): the owner's host shell is not
# that backend, so refuse rather than run on the host behind the session's back.
- if str(json.loads(policy.terminal_json).get('TERMINAL_ENV') or '').strip().lower() not in _LOCAL_BACKENDS:
- raise RuntimeStoreError('unsupported_terminal_backend')
+ # The refusal names the backend so the client can say where the command would have run.
+ backend = str(json.loads(policy.terminal_json).get('TERMINAL_ENV') or '').strip().lower()
+ if backend not in _LOCAL_BACKENDS:
+ raise RuntimeStoreError('unsupported_terminal_backend', field='terminal.backend', detail=backend)
from tools.approval_detection import detect_dangerous_command, detect_hardline_command
if detect_hardline_command(command)[0] or detect_dangerous_command(command)[0]:
raise RuntimeStoreError('dangerous_command')
diff --git a/locales/_keys.tui.json b/locales/_keys.tui.json
index 80f2553dd35..682da42522a 100644
--- a/locales/_keys.tui.json
+++ b/locales/_keys.tui.json
@@ -1287,6 +1287,7 @@
"userMessages.promptTimeout.vaultUnlockPrompt",
"userMessages.rpc.notConnected",
"userMessages.rpc.sessionNotFound",
+ "userMessages.rpc.shellBackendRefused",
"userMessages.rpc.slashCrashed",
"userMessages.rpc.slashTimedOut",
"userMessages.rpc.timedOut",
diff --git a/locales/af.tui.yaml b/locales/af.tui.yaml
index d62e1476408..8dae65a2e32 100644
--- a/locales/af.tui.yaml
+++ b/locales/af.tui.yaml
@@ -1310,6 +1310,7 @@ userMessages.promptTimeout.vaultSaveLogin: "Stoor-aanmelding-prompt gesluit: gee
userMessages.promptTimeout.vaultUnlockPrompt: "Ontsluit-prompt gesluit: geen antwoord betyds nie, so die wagwoordbestuurder het gesluit gebly. Stuur jou versoek weer wanneer jy gereed is om dit te ontsluit."
userMessages.rpc.notConnected: "Hermes is nie op die oomblik verbind nie, so dit is nie gestuur nie. Dit herverbind outomaties; wag 'n oomblik en probeer weer, of tik /logs as dit aanhou."
userMessages.rpc.sessionNotFound: "Hierdie klets is nie meer aan die agterkant gekoppel nie (dit was onaktief, of die agterkant het herbegin). Jou geskiedenis is gestoor: tik /resume om dit weer oop te maak."
+userMessages.rpc.shellBackendRefused: "!-opdragte loop op die gateway-gasheer, maar hierdie sessie se terminaal-backend is {0}, so die opdrag is nie uitgevoer nie. Vra eerder die agent om dit uit te voer; die agent se terminaal loop binne {0}."
userMessages.rpc.slashCrashed: "/{0} is nie voltooi nie: die opdraghelper het omgeval. Probeer weer; tik /logs vir die spoor."
userMessages.rpc.slashTimedOut: "/{0} is nie voltooi nie: die opdraghelper het uitgetel. Probeer weer; as dit aanhou gebeur, tik /logs en rapporteer die laaste reëls."
userMessages.rpc.timedOut: "Hermes het nie binne {0}s geantwoord nie. Probeer weer; as dit aanhou gebeur, tik /logs en rapporteer die laaste reëls."
diff --git a/locales/ar.tui.yaml b/locales/ar.tui.yaml
index aff53517f08..45b4545162a 100644
--- a/locales/ar.tui.yaml
+++ b/locales/ar.tui.yaml
@@ -1310,6 +1310,7 @@ userMessages.promptTimeout.vaultSaveLogin: "أُغلقت مطالبة حفظ ب
userMessages.promptTimeout.vaultUnlockPrompt: "أُغلقت مطالبة فتح القفل: لم يصل ردّ في الوقت المحدّد، لذا بقي مدير كلمات المرور مقفلًا. أرسل طلبك مجددًا عندما تكون مستعدًا لفتح قفله."
userMessages.rpc.notConnected: "Hermes غير متصل حاليًا، لذا لم يُرسَل ذلك. يعيد الاتصال تلقائيًا؛ انتظر قليلًا وحاول مرة أخرى، أو اكتب /logs إن استمرّ الأمر."
userMessages.rpc.sessionNotFound: "لم تعد هذه المحادثة مرتبطة بالخادم الخلفي (كانت خاملة أو أُعيد تشغيل الخادم الخلفي). سجلّك محفوظ: اكتب /resume لإعادة فتحها."
+userMessages.rpc.shellBackendRefused: "تعمل أوامر ! على مضيف البوابة، لكن واجهة الطرفية لهذه الجلسة هي {0}، لذلك لم يُنفَّذ الأمر. اطلب من الوكيل تنفيذه بدلاً من ذلك؛ طرفية الوكيل تعمل داخل {0}."
userMessages.rpc.slashCrashed: "لم يكتمل /{0}: تعطّل مساعد الأوامر. حاول مرة أخرى؛ اكتب /logs لعرض التتبّع."
userMessages.rpc.slashTimedOut: "لم يكتمل /{0}: انتهت مهلة مساعد الأوامر. حاول مرة أخرى؛ وإن تكرّر الأمر، اكتب /logs وأبلغ عن الأسطر الأخيرة."
userMessages.rpc.timedOut: "لم يردّ Hermes خلال {0} ث. حاول مرة أخرى؛ وإن تكرّر الأمر، اكتب /logs وأبلغ عن الأسطر الأخيرة."
diff --git a/locales/de.tui.yaml b/locales/de.tui.yaml
index 3ce09ced9ca..d54a33fc224 100644
--- a/locales/de.tui.yaml
+++ b/locales/de.tui.yaml
@@ -1310,6 +1310,7 @@ userMessages.promptTimeout.vaultSaveLogin: "Abfrage zum Speichern der Anmeldung
userMessages.promptTimeout.vaultUnlockPrompt: "Entsperr-Abfrage geschlossen: keine Antwort in der vorgegebenen Zeit, der Passwort-Manager blieb gesperrt. Senden Sie Ihre Anfrage erneut, wenn Sie ihn entsperren möchten."
userMessages.rpc.notConnected: "Hermes ist gerade nicht verbunden, daher wurde das nicht gesendet. Die Verbindung wird automatisch wiederhergestellt; warten Sie einen Moment und versuchen Sie es erneut, oder geben Sie /logs ein, falls das Problem bestehen bleibt."
userMessages.rpc.sessionNotFound: "Dieser Chat ist nicht mehr mit dem Backend verbunden (er war inaktiv oder das Backend wurde neu gestartet). Ihr Verlauf ist gespeichert: Geben Sie /resume ein, um ihn wieder zu öffnen."
+userMessages.rpc.shellBackendRefused: "!-Befehle laufen auf dem Gateway-Host, aber das Terminal-Backend dieser Sitzung ist {0}, daher wurde der Befehl nicht ausgeführt. Bitten Sie stattdessen den Agenten, ihn auszuführen; das Terminal des Agenten läuft in {0}."
userMessages.rpc.slashCrashed: "/{0} wurde nicht abgeschlossen: Der Befehls-Helfer ist abgestürzt. Versuchen Sie es erneut; /logs zeigt den Trace."
userMessages.rpc.slashTimedOut: "/{0} wurde nicht abgeschlossen: Zeitüberschreitung beim Befehls-Helfer. Versuchen Sie es erneut; falls es wiederholt passiert, geben Sie /logs ein und melden Sie die letzten Zeilen."
userMessages.rpc.timedOut: "Hermes hat nicht innerhalb von {0}s geantwortet. Versuchen Sie es erneut; falls es wiederholt passiert, geben Sie /logs ein und melden Sie die letzten Zeilen."
diff --git a/locales/es.tui.yaml b/locales/es.tui.yaml
index 9534faaae5f..50e2af22959 100644
--- a/locales/es.tui.yaml
+++ b/locales/es.tui.yaml
@@ -1310,6 +1310,7 @@ userMessages.promptTimeout.vaultSaveLogin: "El prompt para guardar el inicio de
userMessages.promptTimeout.vaultUnlockPrompt: "El prompt de desbloqueo se cerró: no hubo respuesta a tiempo, así que el gestor de contraseñas siguió bloqueado. Envía tu solicitud de nuevo cuando estés listo para desbloquearlo."
userMessages.rpc.notConnected: "Hermes no está conectado ahora mismo, así que eso no se envió. Se reconecta automáticamente; espera un momento e inténtalo de nuevo, o escribe /logs si el problema persiste."
userMessages.rpc.sessionNotFound: "Este chat ya no está conectado al backend (estuvo inactivo o el backend se reinició). Tu historial está guardado: escribe /resume para reabrirlo."
+userMessages.rpc.shellBackendRefused: "Los comandos ! se ejecutan en el host del gateway, pero el backend de terminal de esta sesión es {0}, así que el comando no se ejecutó. Pide al agente que lo ejecute; la terminal del agente se ejecuta dentro de {0}."
userMessages.rpc.slashCrashed: "/{0} no terminó: el ayudante del comando falló. Inténtalo de nuevo; escribe /logs para ver la traza."
userMessages.rpc.slashTimedOut: "/{0} no terminó: el ayudante del comando agotó el tiempo de espera. Inténtalo de nuevo; si sigue ocurriendo, escribe /logs e informa de las últimas líneas."
userMessages.rpc.timedOut: "Hermes no respondió en {0}s. Inténtalo de nuevo; si sigue ocurriendo, escribe /logs e informa de las últimas líneas."
diff --git a/locales/fr.tui.yaml b/locales/fr.tui.yaml
index d228e160851..1c79a5b2830 100644
--- a/locales/fr.tui.yaml
+++ b/locales/fr.tui.yaml
@@ -1310,6 +1310,7 @@ userMessages.promptTimeout.vaultSaveLogin: "Invite d'enregistrement des identifi
userMessages.promptTimeout.vaultUnlockPrompt: "Invite de déverrouillage fermée : aucune réponse à temps, le gestionnaire de mots de passe est donc resté verrouillé. Renvoyez votre demande quand vous serez prêt à le déverrouiller."
userMessages.rpc.notConnected: "Hermes n'est pas connecté pour le moment, le message n'a donc pas été envoyé. La reconnexion est automatique ; patientez un instant et réessayez, ou tapez /logs si le problème persiste."
userMessages.rpc.sessionNotFound: "Ce chat n'est plus rattaché au backend (il était inactif ou le backend a redémarré). Votre historique est sauvegardé : tapez /resume pour le rouvrir."
+userMessages.rpc.shellBackendRefused: "Les commandes ! s'exécutent sur l'hôte du gateway, mais le backend de terminal de cette session est {0} : la commande n'a donc pas été exécutée. Demandez plutôt à l'agent de l'exécuter ; le terminal de l'agent tourne dans {0}."
userMessages.rpc.slashCrashed: "/{0} n'a pas abouti : l'assistant de commande a planté. Réessayez ; tapez /logs pour la trace."
userMessages.rpc.slashTimedOut: "/{0} n'a pas abouti : le délai de l'assistant de commande a expiré. Réessayez ; si cela se reproduit, tapez /logs et signalez les dernières lignes."
userMessages.rpc.timedOut: "Hermes n'a pas répondu en {0}s. Réessayez ; si cela se reproduit, tapez /logs et signalez les dernières lignes."
diff --git a/locales/ga.tui.yaml b/locales/ga.tui.yaml
index 3508d02e2ff..9903a12c5fa 100644
--- a/locales/ga.tui.yaml
+++ b/locales/ga.tui.yaml
@@ -1310,6 +1310,7 @@ userMessages.promptTimeout.vaultSaveLogin: "Dúnadh leid shábháil na logála i
userMessages.promptTimeout.vaultUnlockPrompt: "Dúnadh leid na díghlasála: níor tugadh freagra in am, mar sin d'fhan an bainisteoir pasfhocal faoi ghlas. Seol d'iarratas arís nuair a bheidh tú réidh lena dhíghlasáil."
userMessages.rpc.notConnected: "Níl Hermes ceangailte faoi láthair, mar sin níor seoladh é sin. Athcheanglaíonn sé go huathoibríoch; fan nóiméad agus bain triail eile as, nó clóscríobh /logs má leanann sé seo ar aghaidh."
userMessages.rpc.sessionNotFound: "Níl an comhrá seo ceangailte leis an gcúlchóras a thuilleadh (bhí sé díomhaoin nó atosaíodh an cúlchóras). Tá do stair sábháilte: clóscríobh /resume chun é a athoscailt."
+userMessages.rpc.shellBackendRefused: "Ritheann orduithe ! ar óstríomhaire an gateway, ach is é {0} inneall teirminéil an tseisiúin seo, mar sin níor ritheadh an t-ordú. Iarr ar an ngníomhaire é a rith ina ionad; ritheann teirminéal an ghníomhaire laistigh de {0}."
userMessages.rpc.slashCrashed: "Níor chríochnaigh /{0}: thuairteáil cúntóir na n-orduithe. Bain triail eile as; clóscríobh /logs don rian."
userMessages.rpc.slashTimedOut: "Níor chríochnaigh /{0}: chuaigh cúntóir na n-orduithe thar am. Bain triail eile as; má leanann sé ag tarlú, clóscríobh /logs agus tuairiscigh na línte deiridh."
userMessages.rpc.timedOut: "Níor fhreagair Hermes laistigh de {0}s. Bain triail eile as; má leanann sé ag tarlú, clóscríobh /logs agus tuairiscigh na línte deiridh."
diff --git a/locales/hu.tui.yaml b/locales/hu.tui.yaml
index 6b86562ed69..e31c02aaba4 100644
--- a/locales/hu.tui.yaml
+++ b/locales/hu.tui.yaml
@@ -1310,6 +1310,7 @@ userMessages.promptTimeout.vaultSaveLogin: "A bejelentkezés mentésének bekér
userMessages.promptTimeout.vaultUnlockPrompt: "A feloldás bekérése bezárult: nem érkezett válasz időben, így a jelszókezelő zárolva maradt. Küldd el újra a kérésedet, amikor készen állsz a feloldására."
userMessages.rpc.notConnected: "A Hermes most nincs csatlakozva, így ez nem lett elküldve. Automatikusan újracsatlakozik; várj egy kicsit, és próbáld újra, vagy ha a hiba nem múlik, írd be: /logs."
userMessages.rpc.sessionNotFound: "Ez a beszélgetés már nem kapcsolódik a backendhez (tétlen volt, vagy a backend újraindult). Az előzményeid mentve vannak: a /resume paranccsal nyithatod újra."
+userMessages.rpc.shellBackendRefused: "A !-parancsok a gateway gépén futnak, de ennek a munkamenetnek a terminál-backendje {0}, ezért a parancs nem futott le. Kérd meg inkább az ügynököt, hogy futtassa; az ügynök terminálja a(z) {0} belsejében fut."
userMessages.rpc.slashCrashed: "A /{0} nem fejeződött be: a parancssegítő összeomlott. Próbáld újra; a nyomkövetéshez írd be: /logs."
userMessages.rpc.slashTimedOut: "A /{0} nem fejeződött be: a parancssegítő túllépte az időkeretet. Próbáld újra; ha ismétlődik, írd be a /logs parancsot, és jelentsd az utolsó sorokat."
userMessages.rpc.timedOut: "A Hermes nem válaszolt {0} mp-en belül. Próbáld újra; ha ismétlődik, írd be a /logs parancsot, és jelentsd az utolsó sorokat."
diff --git a/locales/it.tui.yaml b/locales/it.tui.yaml
index d4ad6ff5338..0abb139e716 100644
--- a/locales/it.tui.yaml
+++ b/locales/it.tui.yaml
@@ -1310,6 +1310,7 @@ userMessages.promptTimeout.vaultSaveLogin: "Richiesta di salvataggio dell'access
userMessages.promptTimeout.vaultUnlockPrompt: "Richiesta di sblocco chiusa: nessuna risposta in tempo, quindi il gestore di password è rimasto bloccato. Invia di nuovo la richiesta quando sei pronto a sbloccarlo."
userMessages.rpc.notConnected: "Hermes al momento non è connesso, quindi il messaggio non è stato inviato. Si riconnette da solo; attendi un istante e riprova, oppure digita /logs se il problema persiste."
userMessages.rpc.sessionNotFound: "Questa chat non è più collegata al backend (era inattiva o il backend si è riavviato). La cronologia è salvata: digita /resume per riaprirla."
+userMessages.rpc.shellBackendRefused: "I comandi ! vengono eseguiti sull'host del gateway, ma il backend di terminale di questa sessione è {0}, quindi il comando non è stato eseguito. Chiedi invece all'agente di eseguirlo; il terminale dell'agente gira dentro {0}."
userMessages.rpc.slashCrashed: "/{0} non è terminato: l'helper del comando si è bloccato. Riprova; digita /logs per la traccia."
userMessages.rpc.slashTimedOut: "/{0} non è terminato: l'helper del comando è andato in timeout. Riprova; se continua a succedere, digita /logs e segnala le ultime righe."
userMessages.rpc.timedOut: "Hermes non ha risposto entro {0}s. Riprova; se continua a succedere, digita /logs e segnala le ultime righe."
diff --git a/locales/ja.tui.yaml b/locales/ja.tui.yaml
index ef45de1ab95..578afe75439 100644
--- a/locales/ja.tui.yaml
+++ b/locales/ja.tui.yaml
@@ -1310,6 +1310,7 @@ userMessages.promptTimeout.vaultSaveLogin: "ログイン保存プロンプトを
userMessages.promptTimeout.vaultUnlockPrompt: "ロック解除プロンプトを閉じました: 時間内に入力がなかったため、パスワードマネージャーはロックされたままです。解除の準備ができたら、もう一度リクエストを送ってください。"
userMessages.rpc.notConnected: "Hermes に接続していないため送信されませんでした。自動的に再接続しますので、少し待ってから再度お試しください。続く場合は /logs と入力してください。"
userMessages.rpc.sessionNotFound: "このチャットはバックエンドから切り離されています(アイドル状態が続いたか、バックエンドが再起動しました)。履歴は保存されています。/resume と入力すると再び開けます。"
+userMessages.rpc.shellBackendRefused: "! コマンドはゲートウェイのホストで実行されますが、このセッションのターミナルバックエンドは {0} のため、コマンドは実行されませんでした。代わりにエージェントに実行を依頼してください。エージェントのターミナルは {0} 内で動作します。"
userMessages.rpc.slashCrashed: "/{0} が完了しませんでした: コマンドヘルパーがクラッシュしました。再度お試しください。トレースは /logs で確認できます。"
userMessages.rpc.slashTimedOut: "/{0} が完了しませんでした: コマンドヘルパーがタイムアウトしました。再度お試しください。繰り返す場合は /logs と入力し、末尾の行を報告してください。"
userMessages.rpc.timedOut: "Hermes が {0} 秒以内に応答しませんでした。再度お試しください。繰り返す場合は /logs と入力し、末尾の行を報告してください。"
diff --git a/locales/ko.tui.yaml b/locales/ko.tui.yaml
index 03f7b28d437..5b2267d5500 100644
--- a/locales/ko.tui.yaml
+++ b/locales/ko.tui.yaml
@@ -1310,6 +1310,7 @@ userMessages.promptTimeout.vaultSaveLogin: "로그인 저장 프롬프트가 닫
userMessages.promptTimeout.vaultUnlockPrompt: "잠금 해제 프롬프트가 닫혔어요: 제한 시간 안에 답이 없어서 비밀번호 관리자가 잠긴 상태로 남았어요. 잠금을 해제할 준비가 되면 요청을 다시 보내세요."
userMessages.rpc.notConnected: "지금 Hermes가 연결되어 있지 않아서 전송되지 않았어요. 자동으로 다시 연결되니 잠시 후 다시 시도하고, 계속되면 /logs 를 입력하세요."
userMessages.rpc.sessionNotFound: "이 채팅은 더 이상 백엔드에 연결되어 있지 않아요 (유휴 상태였거나 백엔드가 다시 시작됐어요). 기록은 저장되어 있으니 /resume 을 입력해 다시 열어 주세요."
+userMessages.rpc.shellBackendRefused: "! 명령은 게이트웨이 호스트에서 실행되지만 이 세션의 터미널 백엔드는 {0}이므로 명령을 실행하지 않았습니다. 대신 에이전트에게 실행을 요청하세요. 에이전트의 터미널은 {0} 안에서 실행됩니다."
userMessages.rpc.slashCrashed: "/{0} 이(가) 완료되지 않았어요: 명령 도우미가 크래시했어요. 다시 시도하고, 트레이스는 /logs 로 확인하세요."
userMessages.rpc.slashTimedOut: "/{0} 이(가) 완료되지 않았어요: 명령 도우미가 시간 초과됐어요. 다시 시도하고, 계속되면 /logs 를 입력해 마지막 줄들을 보고해 주세요."
userMessages.rpc.timedOut: "Hermes가 {0}초 안에 응답하지 않았어요. 다시 시도하고, 계속되면 /logs 를 입력해 마지막 줄들을 보고해 주세요."
diff --git a/locales/pt.tui.yaml b/locales/pt.tui.yaml
index d8a3a8db081..377be130a61 100644
--- a/locales/pt.tui.yaml
+++ b/locales/pt.tui.yaml
@@ -1310,6 +1310,7 @@ userMessages.promptTimeout.vaultSaveLogin: "Prompt de salvar login fechado: sem
userMessages.promptTimeout.vaultUnlockPrompt: "Prompt de desbloqueio fechado: sem resposta a tempo, então o gerenciador de senhas continuou bloqueado. Envie sua solicitação novamente quando estiver pronto para desbloqueá-lo."
userMessages.rpc.notConnected: "O Hermes não está conectado agora, então isso não foi enviado. Ele reconecta automaticamente; aguarde um momento e tente novamente, ou digite /logs se persistir."
userMessages.rpc.sessionNotFound: "Este chat não está mais vinculado ao backend (ficou ocioso ou o backend reiniciou). Seu histórico está salvo: digite /resume para reabri-lo."
+userMessages.rpc.shellBackendRefused: "Os comandos ! são executados no host do gateway, mas o backend de terminal desta sessão é {0}, então o comando não foi executado. Peça ao agente para executá-lo; o terminal do agente roda dentro de {0}."
userMessages.rpc.slashCrashed: "/{0} não foi concluído: o auxiliar de comandos travou. Tente novamente; digite /logs para ver o rastreamento."
userMessages.rpc.slashTimedOut: "/{0} não foi concluído: o auxiliar de comandos excedeu o tempo limite. Tente novamente; se continuar acontecendo, digite /logs e informe as últimas linhas."
userMessages.rpc.timedOut: "O Hermes não respondeu em {0}s. Tente novamente; se continuar acontecendo, digite /logs e informe as últimas linhas."
diff --git a/locales/ru.tui.yaml b/locales/ru.tui.yaml
index dcd667d101c..4b4b3d1ed66 100644
--- a/locales/ru.tui.yaml
+++ b/locales/ru.tui.yaml
@@ -1310,6 +1310,7 @@ userMessages.promptTimeout.vaultSaveLogin: "Запрос на сохранени
userMessages.promptTimeout.vaultUnlockPrompt: "Запрос разблокировки закрыт: ответ не получен вовремя, поэтому менеджер паролей остался заблокирован. Отправьте запрос снова, когда будете готовы его разблокировать."
userMessages.rpc.notConnected: "Hermes сейчас не подключён, поэтому это не было отправлено. Он переподключается автоматически; подождите немного и повторите, а если проблема сохраняется — введите /logs."
userMessages.rpc.sessionNotFound: "Этот чат больше не привязан к бэкенду (он простаивал или бэкенд перезапустился). История сохранена: введите /resume, чтобы открыть его снова."
+userMessages.rpc.shellBackendRefused: "Команды ! выполняются на хосте шлюза, но терминальный бэкенд этой сессии — {0}, поэтому команда не выполнена. Попросите агента выполнить её; терминал агента работает внутри {0}."
userMessages.rpc.slashCrashed: "/{0} не завершилась: обработчик команды упал. Повторите; трассировка — в /logs."
userMessages.rpc.slashTimedOut: "/{0} не завершилась: обработчик команды не ответил вовремя. Повторите; если повторяется, введите /logs и сообщите последние строки."
userMessages.rpc.timedOut: "Hermes не ответил за {0} с. Повторите; если повторяется, введите /logs и сообщите последние строки."
diff --git a/locales/tr.tui.yaml b/locales/tr.tui.yaml
index 9532ac61915..369bc7d737f 100644
--- a/locales/tr.tui.yaml
+++ b/locales/tr.tui.yaml
@@ -1310,6 +1310,7 @@ userMessages.promptTimeout.vaultSaveLogin: "Giriş kaydetme istemi kapandı: zam
userMessages.promptTimeout.vaultUnlockPrompt: "Kilit açma istemi kapandı: zamanında yanıt gelmediği için parola yöneticisi kilitli kaldı. Kilidi açmaya hazır olduğunuzda isteğinizi yeniden gönderin."
userMessages.rpc.notConnected: "Hermes şu anda bağlı değil, bu yüzden mesaj gönderilmedi. Otomatik olarak yeniden bağlanır; biraz bekleyip yeniden deneyin ya da sorun sürerse /logs yazın."
userMessages.rpc.sessionNotFound: "Bu sohbet artık arka uca bağlı değil (boşta kaldı veya arka uç yeniden başlatıldı). Geçmişiniz kaydedildi: yeniden açmak için /resume yazın."
+userMessages.rpc.shellBackendRefused: "! komutları gateway ana makinesinde çalışır, ancak bu oturumun terminal arka ucu {0} olduğundan komut çalıştırılmadı. Bunun yerine ajandan çalıştırmasını isteyin; ajanın terminali {0} içinde çalışır."
userMessages.rpc.slashCrashed: "/{0} tamamlanamadı: komut yardımcısı çöktü. Yeniden deneyin; iz kaydı için /logs yazın."
userMessages.rpc.slashTimedOut: "/{0} tamamlanamadı: komut yardımcısı zaman aşımına uğradı. Yeniden deneyin; tekrarlanırsa /logs yazıp son satırları bildirin."
userMessages.rpc.timedOut: "Hermes {0} sn içinde yanıt vermedi. Yeniden deneyin; tekrarlanırsa /logs yazıp son satırları bildirin."
diff --git a/locales/uk.tui.yaml b/locales/uk.tui.yaml
index eea0250fe4e..21f96d4c299 100644
--- a/locales/uk.tui.yaml
+++ b/locales/uk.tui.yaml
@@ -1310,6 +1310,7 @@ userMessages.promptTimeout.vaultSaveLogin: "Запит на збереження
userMessages.promptTimeout.vaultUnlockPrompt: "Запит на розблокування закрито: відповіді вчасно не було, тому менеджер паролів залишився заблокованим. Надішліть запит знову, коли будете готові його розблокувати."
userMessages.rpc.notConnected: "Hermes зараз не підключено, тому це не надіслано. Він перепідключається автоматично; зачекайте трохи та спробуйте ще раз або введіть /logs, якщо проблема не зникає."
userMessages.rpc.sessionNotFound: "Цей чат більше не прив'язаний до бекенду (він простоював або бекенд перезапустився). Історію збережено: введіть /resume, щоб відкрити його знову."
+userMessages.rpc.shellBackendRefused: "Команди ! виконуються на хості шлюзу, але термінальний бекенд цієї сесії — {0}, тому команду не виконано. Попросіть агента виконати її; термінал агента працює всередині {0}."
userMessages.rpc.slashCrashed: "/{0} не завершилася: помічник команд аварійно завершив роботу. Спробуйте ще раз; введіть /logs, щоб побачити трасування."
userMessages.rpc.slashTimedOut: "/{0} не завершилася: час очікування помічника команд минув. Спробуйте ще раз; якщо повторюється, введіть /logs і повідомте про останні рядки."
userMessages.rpc.timedOut: "Hermes не відповів протягом {0} с. Спробуйте ще раз; якщо повторюється, введіть /logs і повідомте про останні рядки."
diff --git a/locales/zh-hant.tui.yaml b/locales/zh-hant.tui.yaml
index 363d2a06cb2..1d62de1bd88 100644
--- a/locales/zh-hant.tui.yaml
+++ b/locales/zh-hant.tui.yaml
@@ -1310,6 +1310,7 @@ userMessages.promptTimeout.vaultSaveLogin: "儲存登入資訊的提示已關閉
userMessages.promptTimeout.vaultUnlockPrompt: "解鎖提示已關閉:未及時回應,密碼管理器仍保持鎖定。準備好解鎖時請重新送出你的請求。"
userMessages.rpc.notConnected: "Hermes 目前未連線,所以剛才的內容沒有送出。它會自動重新連線;請稍候再試,如果問題持續,請輸入 /logs。"
userMessages.rpc.sessionNotFound: "此聊天已不再連接到後端(長時間閒置或後端已重新啟動)。你的歷史記錄已儲存:輸入 /resume 重新開啟。"
+userMessages.rpc.shellBackendRefused: "! 指令在閘道主機上執行,但此工作階段的終端後端是 {0},因此未執行該指令。請改請代理執行;代理的終端在 {0} 內執行。"
userMessages.rpc.slashCrashed: "/{0} 未能完成:指令輔助程式當機。請再試一次;輸入 /logs 檢視堆疊追蹤。"
userMessages.rpc.slashTimedOut: "/{0} 未能完成:指令輔助程式逾時。請再試一次;如果反覆發生,請輸入 /logs 並回報最後幾行。"
userMessages.rpc.timedOut: "Hermes 在 {0} 秒內沒有回應。請再試一次;如果反覆發生,請輸入 /logs 並回報最後幾行。"
diff --git a/locales/zh.tui.yaml b/locales/zh.tui.yaml
index 917f6e61347..3bee8c72d32 100644
--- a/locales/zh.tui.yaml
+++ b/locales/zh.tui.yaml
@@ -1310,6 +1310,7 @@ userMessages.promptTimeout.vaultSaveLogin: "保存登录信息的提示已关闭
userMessages.promptTimeout.vaultUnlockPrompt: "解锁提示已关闭:未及时回应,密码管理器仍保持锁定。准备好解锁时请重新发送你的请求。"
userMessages.rpc.notConnected: "Hermes 目前未连接,所以刚才的内容没有发送。它会自动重连;请稍等片刻再试,如果问题持续,请输入 /logs。"
userMessages.rpc.sessionNotFound: "此聊天已不再连接到后端(长时间空闲或后端已重启)。你的历史记录已保存:输入 /resume 重新打开。"
+userMessages.rpc.shellBackendRefused: "! 命令在网关主机上运行,但此会话的终端后端是 {0},因此未执行该命令。请改为让代理运行;代理的终端在 {0} 内运行。"
userMessages.rpc.slashCrashed: "/{0} 未能完成:命令助手崩溃。请重试;输入 /logs 查看堆栈跟踪。"
userMessages.rpc.slashTimedOut: "/{0} 未能完成:命令助手超时。请重试;如果反复出现,请输入 /logs 并报告最后几行。"
userMessages.rpc.timedOut: "Hermes 在 {0} 秒内没有响应。请重试;如果反复出现,请输入 /logs 并报告最后几行。"
diff --git a/tests/gateway/test_session_shell.py b/tests/gateway/test_session_shell.py
index af84249b336..1e13f82532a 100644
--- a/tests/gateway/test_session_shell.py
+++ b/tests/gateway/test_session_shell.py
@@ -33,3 +33,43 @@ def test_shell_exec_runs_in_the_session_cwd_behind_the_safety_gates(tmp_path):
assert ran['stderr'] == 'key=', receipt
assert receipt['dangerous'].get('message') == 'dangerous_command', receipt
assert receipt['sessionless'] == 4001, receipt
+
+
[email protected]('backend', ['docker', 'ssh'])
+async def test_shell_exec_refusal_names_a_sandboxed_terminal_backend(tmp_path, monkeypatch, backend):
+ """``shell.exec`` runs on the gateway host, so a session whose frozen terminal policy is a
+ sandbox is refused (#134889 TUI-16) and the refusal names that backend for the client. A local
+ session still runs. Monkeypatched: the session's policy lookup and local-source check."""
+ from types import SimpleNamespace
+
+ from gateway import session_local, session_policy
+ from gateway.session_authority import LiveSession, SessionAuthority
+ from gateway.session_controls import AuthorityConnection
+ from hermes_state import SessionDB
+ from hermes_state_runtime import begin_runtime_epoch
+
+ work = tmp_path / 'work'
+ work.mkdir()
+ terminal = {'TERMINAL_ENV': backend}
+ monkeypatch.setattr(session_local, 'authorize_local_source', lambda runner, source: True)
+ monkeypatch.setattr(session_policy, 'policy_for_source', lambda runner, source: SimpleNamespace(
+ cwd=str(work), terminal_json=json.dumps(terminal)))
+ with SessionDB(db_path=tmp_path / 'state.db') as db:
+ db.create_session('s', source='test')
+ epoch = begin_runtime_epoch(db, instance_id='current')
+ authority = SessionAuthority(SimpleNamespace(_draining=False), profile_id=str(tmp_path / 'home'),
+ instance_id='current', db=db, epoch=epoch)
+ authority.sessions['s'] = LiveSession(None, 'route')
+ connection = AuthorityConnection(authority, object(), {'user_id': 'owner'})
+
+ async def call():
+ return await connection.dispatch({'id': 1, 'method': 'shell.exec',
+ 'params': {'session_id': 's', 'command': 'echo ran'}})
+
+ refused = await call()
+ assert refused['error']['data'] == {'reason': 'unsupported_terminal_backend',
+ 'field': 'terminal.backend', 'detail': backend}, refused
+ terminal['TERMINAL_ENV'] = 'local'
+ ran = await call()
+ assert ran.get('result', {}).get('stdout', '').strip() == 'ran', ran
diff --git a/ui-tui/src/__tests__/userMessages.test.ts b/ui-tui/src/__tests__/userMessages.test.ts
index c4901ce6fa9..043312c465a 100644
--- a/ui-tui/src/__tests__/userMessages.test.ts
+++ b/ui-tui/src/__tests__/userMessages.test.ts
@@ -6,6 +6,7 @@ import {
backendRestarting,
describeCredentialWarning,
describeRpcError,
+ describeShellExecError,
describeSlashExecError,
describeTurnFailure,
isVersionSkewError,
@@ -286,3 +287,28 @@ describe('locale-aware resolution', () => {
expect(describeTurnFailure({ error_surface: { code: 'auth', layer: 'auth' } }).split('\n')[0]).toBe('AUTH-XX // XX')
})
})
+
+describe('describeShellExecError', () => {
+ it.each(['docker', 'ssh'])('names the %s backend and points at the agent (#134889 TUI-16)', backend => {
+ const err = new JsonRpcGatewayError('unsupported_terminal_backend', {
+ code: 4001,
+ data: { reason: 'unsupported_terminal_backend', field: 'terminal.backend', detail: backend }
+ })
+
+ const text = describeShellExecError(err)
+
+ expect(text).toContain(`terminal backend is ${backend}`)
+ expect(text).toContain('Ask the agent to run it instead')
+ expect(text).not.toContain('unsupported_terminal_backend')
+ })
+
+ it('still names the refusal when an older gateway sends no backend, and passes other errors through', () => {
+ const bare = new JsonRpcGatewayError('unsupported_terminal_backend', {
+ code: 4001,
+ data: { reason: 'unsupported_terminal_backend' }
+ })
+
+ expect(describeShellExecError(bare)).toContain('Ask the agent to run it instead')
+ expect(describeShellExecError(new JsonRpcGatewayError('dangerous_command', { code: 4001 }))).toBe('dangerous_command')
+ })
+})
diff --git a/ui-tui/src/app/useSubmission.ts b/ui-tui/src/app/useSubmission.ts
index a2c74edbc49..ef37f5e0495 100644
--- a/ui-tui/src/app/useSubmission.ts
+++ b/ui-tui/src/app/useSubmission.ts
@@ -8,7 +8,7 @@ import type { GatewayClient } from '../gatewayClient.js'
import type { ShellExecResponse } from '../gatewayTypes.js'
import { queueItem, type QueueItem } from '../hooks/useQueue.js'
import { t } from '../i18n/runtime.js'
-import { asRpcResult, rpcErrorMessage } from '../lib/rpc.js'
+import { asRpcResult } from '../lib/rpc.js'
import { hasInterpolation, INTERPOLATION_RE } from '../protocol/interpolation.js'
import type { Msg } from '../types.js'
@@ -19,6 +19,7 @@ import { submitPrompt } from './submissionCore.js'
import { captureDestination, isCurrentDestination, type SubmissionDestination } from './submissionDestination.js'
import { turnController } from './turnController.js'
import { getUiState, patchUiState } from './uiStore.js'
+import { describeShellExecError } from './userMessages.js'
const DOUBLE_ENTER_MS = 450
@@ -188,7 +189,7 @@ export function useSubmission(opts: UseSubmissionOptions) {
item?.settle?.(false)
if (focused()) {
- sys(`error: ${e.message}`)
+ sys(`error: ${describeShellExecError(e)}`)
}
})
.finally(() => {
@@ -228,7 +229,7 @@ export function useSubmission(opts: UseSubmissionOptions) {
item?.settle?.(false)
if (isCurrentDestination(destination)) {
- sys(t('session.common.interpolationFailed', rpcErrorMessage(error)))
+ sys(t('session.common.interpolationFailed', describeShellExecError(error)))
patchUiState({ busy: false, status: 'ready' })
}
}
diff --git a/ui-tui/src/app/userMessages.ts b/ui-tui/src/app/userMessages.ts
index 94beaa5afd6..2a6fa2662e0 100644
--- a/ui-tui/src/app/userMessages.ts
+++ b/ui-tui/src/app/userMessages.ts
@@ -179,6 +179,21 @@ export const describeRpcError = (err: unknown): string => {
export const isUnsupportedCommand = (err: unknown): boolean =>
(err as { data?: { reason?: string } } | null)?.data?.reason === 'unsupported_command'
+/** The shared owner refuses `!cmd` / `{!cmd}` for a session whose terminal backend is not local
+ * (gateway/session_shell.py): the command would run on the gateway host, outside the session's
+ * sandbox. Name the backend and point at the agent; other errors read as describeRpcError. */
+export const describeShellExecError = (err: unknown): string => {
+ const data = (err as { data?: { detail?: unknown; reason?: unknown } } | null)?.data
+
+ if (data?.reason === 'unsupported_terminal_backend') {
+ const backend = typeof data.detail === 'string' && data.detail.trim() ? data.detail.trim() : 'not local'
+
+ return t('userMessages.rpc.shellBackendRefused', backend)
+ }
+
+ return describeRpcError(err)
+}
+
/** The slash worker (built-in command helper) failed; name the command, not the helper. */
export const describeSlashExecError = (command: string, err: unknown): string => {
const { message } = rpcShape(err)
diff --git a/ui-tui/src/i18n/en/userMessages.ts b/ui-tui/src/i18n/en/userMessages.ts
index 64a313e14fa..887573b1fef 100644
--- a/ui-tui/src/i18n/en/userMessages.ts
+++ b/ui-tui/src/i18n/en/userMessages.ts
@@ -37,6 +37,9 @@ export const userMessagesEn = {
},
rpc: {
+ /** `{0}` = the session's terminal backend (docker, ssh, ...). shell.exec runs on the gateway host. */
+ shellBackendRefused: (backend: string) =>
+ `!commands run on the gateway host, but this session's terminal backend is ${backend}, so the command was not run. Ask the agent to run it instead; the agent's terminal runs inside ${backend}.`,
versionSkew:
'The terminal UI and the Hermes backend are out of sync (different versions). Run /update, or exit and run `hermes update`, then start the TUI again.',
sessionNotFound: