Skip to content

The agent that grows with you

fix(groups): retry receipts, pre-submit file refusals and TUI missing-method copy

Tekniumfde421974566
diff --git a/gateway/hosted_room_policy_checkpoint.py b/gateway/hosted_room_policy_checkpoint.py
index 86d4e5f094e..0799bfa5f8b 100644
--- a/gateway/hosted_room_policy_checkpoint.py
+++ b/gateway/hosted_room_policy_checkpoint.py
@@ -19,6 +19,9 @@ from gateway.hosted_rooms_common import DbPath, compact_json, fenced_update
MAX_ACTIVE_POLICY_EVENTS = 64
+# ``turn.deferred`` receipts come from explicit user retries, not from the configured reply
+# budget, so they are bounded on their own: sizing the reply budget exactly must leave room.
+MAX_ACTIVE_RETRY_RECEIPTS = 64
MAX_THREAD_TRANSCRIPT_EVENTS = 24
_TRANSCRIPT_SCHEMA_VERSION = 4
MAX_TRANSCRIPT_POLICY_EVENTS = MAX_THREAD_TRANSCRIPT_EVENTS * (MAX_ACTIVE_POLICY_EVENTS + 2)
@@ -126,7 +129,7 @@ class HostedRoomPolicyCheckpoint:
self.max_active_events = int(conn.execute(
"SELECT max_active_events FROM hosted_room_policy_capacity WHERE singleton=1").fetchone()[0])
self.max_transcript_policy_events = min(
- 2**63 - 2, MAX_THREAD_TRANSCRIPT_EVENTS * (self.max_active_events + 2))
+ 2**63 - 2, MAX_THREAD_TRANSCRIPT_EVENTS * (self.max_active_events + MAX_ACTIVE_RETRY_RECEIPTS + 2))
def _connect(self) -> sqlite3.Connection:
# Late import: a gateway that outlives an on-disk upgrade has the OLD sqlite_util cached.
@@ -170,11 +173,16 @@ class HostedRoomPolicyCheckpoint:
self, conn: sqlite3.Connection, *, room_id: str, thread_id: str, discussion_event_id: str, bound_error: str
) -> list[dict[str, Any]]:
"""Merge the thread transcript with the active projection, ordered by seq."""
- active_rows = conn.execute("""SELECT event_json FROM hosted_room_policy_events
- WHERE room_id=? AND discussion_event_id=? ORDER BY seq LIMIT ?""",
- (room_id, discussion_event_id, self.max_active_events + 1)).fetchall()
- if len(active_rows) > self.max_active_events:
- raise RuntimeError(bound_error)
+ active_rows = []
+ for receipts, bound in ((0, self.max_active_events), (1, MAX_ACTIVE_RETRY_RECEIPTS)):
+ rows = conn.execute("""SELECT event_json FROM hosted_room_policy_events
+ WHERE room_id=? AND discussion_event_id=?
+ AND (json_extract(event_json, '$.kind') = 'turn.deferred') = ?
+ ORDER BY seq LIMIT ?""",
+ (room_id, discussion_event_id, receipts, bound + 1)).fetchall()
+ if len(rows) > bound:
+ raise RuntimeError(bound_error)
+ active_rows.extend(rows)
rows = conn.execute(_TRANSCRIPT_EVENTS_SQL,
(room_id, thread_id, room_id, thread_id, room_id,
self.max_transcript_policy_events + 1)).fetchall()
diff --git a/gateway/session_hosted_attachments.py b/gateway/session_hosted_attachments.py
index 71341fa05d2..15ebcb45450 100644
--- a/gateway/session_hosted_attachments.py
+++ b/gateway/session_hosted_attachments.py
@@ -76,6 +76,30 @@ def append_user_event(service, *, room_id, event_id, payload, gateway_id, epoch)
raise
+# A file the member can never take: over its media cap, not bound to it, expired or corrupt.
+_PERMANENT_FILE_REFUSALS = frozenset({'invalid_params', 'permission_denied'})
+
+
+def prepare_before_submit(prepare):
+ """Run a member turn's file preparation, which precedes its ``prompt.submit``/admission.
+
+ A failure here started no work, so neither route may let the driver book it as uncertain
+ execution: a refusal no retry can change settles the turn as failed (``refused_before_submit``)
+ and anything else is proven not admitted, so the driver requeues it with backoff."""
+ from gateway.hosted_room_attachments import AttachmentError
+ from gateway.hosted_room_driver import DriverValidationError
+ try:
+ return prepare()
+ except Exception as exc:
+ permanent = isinstance(exc, (AttachmentError, DriverValidationError)) or (
+ isinstance(exc, RuntimeStoreError) and exc.reason in _PERMANENT_FILE_REFUSALS)
+ if permanent:
+ exc.refused_before_submit = True
+ else:
+ exc.not_admitted = True
+ raise
+
+
def submission_payload(rpc, prompt, attachments=None):
"""Resolve only event-bound, member-authorized bytes, never a caller path."""
return bound_submission_payload(
diff --git a/gateway/session_hosted_rpc.py b/gateway/session_hosted_rpc.py
index dc1b0aee250..302f75e9e2a 100644
--- a/gateway/session_hosted_rpc.py
+++ b/gateway/session_hosted_rpc.py
@@ -157,14 +157,14 @@ class HostedRoomAuthorityRPC:
rows = self._rows()
if any(row['status'] == 'unknown' for row, _, _ in rows):
raise RuntimeStoreError('unknown_execution')
- from gateway.session_hosted_attachments import submission_payload
+ from gateway.session_hosted_attachments import prepare_before_submit, submission_payload
from gateway.session_ingress_media import capture_lease
# One lease from capture through the admission commit: documents ride in the prompt text,
# so submit's own lease does not hold them, and an older row's release could unlink a
# shared content-addressed capture in between.
with capture_lease():
- payload = await asyncio.to_thread(
- submission_payload, self, params['prompt'], params.get('attachments'))
+ payload = await asyncio.to_thread(prepare_before_submit, partial(
+ submission_payload, self, params['prompt'], params.get('attachments')))
authorize_write = self.authorize_write
receipt = await self.authority.submit(self.principal, Submission(
request_id, self.ref, payload, 'queue'),
diff --git a/locales/_keys.tui.json b/locales/_keys.tui.json
index 6e180887657..9536dcd0eb0 100644
--- a/locales/_keys.tui.json
+++ b/locales/_keys.tui.json
@@ -1315,6 +1315,7 @@
"userMessages.promptTimeout.vaultSaveLogin",
"userMessages.promptTimeout.vaultUnlockPrompt",
"userMessages.rpc.launchCredentialsChanged",
+ "userMessages.rpc.methodUnavailable",
"userMessages.rpc.notConnected",
"userMessages.rpc.sessionHasChildren",
"userMessages.rpc.sessionNotFound",
diff --git a/locales/af.tui.yaml b/locales/af.tui.yaml
index d540a3fa709..502cc7f46c6 100644
--- a/locales/af.tui.yaml
+++ b/locales/af.tui.yaml
@@ -1338,6 +1338,7 @@ userMessages.promptTimeout.vaultCode: "Verifikasiekode-prompt gesluit: geen antw
userMessages.promptTimeout.vaultSaveLogin: "Stoor-aanmelding-prompt gesluit: geen antwoord betyds nie, so niks is gestoor nie. Stuur jou versoek weer wanneer jy gereed is."
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.launchCredentialsChanged: "Hierdie klets kan nie meer die API-sleutel gebruik waarmee dit begin is nie (dit is verander of verwyder), daarom is dit nie gedoen nie. 'n Klets skakel nooit self na 'n ander sleutel oor nie. Tik /new om 'n nuwe klets met jou huidige sleutel te begin."
+userMessages.rpc.methodUnavailable: "Hierdie Hermes-agterkant bied nie {0} nie, dus is dit nie gedoen nie."
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.sessionHasChildren: "Hierdie klets het kindersessies (soos subagent-lopies) wat ook verwyder sou word as dit uitgevee word, daarom is dit nie uitgevee nie."
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."
diff --git a/locales/ar.tui.yaml b/locales/ar.tui.yaml
index f996b73b7cb..d3c7c213b69 100644
--- a/locales/ar.tui.yaml
+++ b/locales/ar.tui.yaml
@@ -1338,6 +1338,7 @@ userMessages.promptTimeout.vaultCode: "أُغلقت مطالبة رمز التح
userMessages.promptTimeout.vaultSaveLogin: "أُغلقت مطالبة حفظ بيانات تسجيل الدخول: لم يصل ردّ في الوقت المحدّد، لذا لم يُحفظ شيء. أرسل طلبك مجددًا عندما تكون مستعدًا."
userMessages.promptTimeout.vaultUnlockPrompt: "أُغلقت مطالبة فتح القفل: لم يصل ردّ في الوقت المحدّد، لذا بقي مدير كلمات المرور مقفلًا. أرسل طلبك مجددًا عندما تكون مستعدًا لفتح قفله."
userMessages.rpc.launchCredentialsChanged: "لم تعد هذه المحادثة قادرة على استخدام مفتاح API الذي بدأت به (تم تغييره أو حذفه)، لذلك لم يُنفَّذ ذلك. المحادثة لا تنتقل أبدًا إلى مفتاح مختلف من تلقاء نفسها. اكتب /new لبدء محادثة جديدة بمفتاحك الحالي."
+userMessages.rpc.methodUnavailable: "لا توفّر واجهة Hermes الخلفية هذه {0}، لذلك لم يتم تنفيذ ذلك."
userMessages.rpc.notConnected: "Hermes غير متصل حاليًا، لذا لم يُرسَل ذلك. يعيد الاتصال تلقائيًا؛ انتظر قليلًا وحاول مرة أخرى، أو اكتب /logs إن استمرّ الأمر."
userMessages.rpc.sessionHasChildren: "لهذه المحادثة جلسات فرعية (مثل تشغيلات الوكلاء الفرعيين) سيزيلها حذفها أيضًا، لذلك لم تُحذف."
userMessages.rpc.sessionNotFound: "لم تعد هذه المحادثة مرتبطة بالخادم الخلفي (كانت خاملة أو أُعيد تشغيل الخادم الخلفي). سجلّك محفوظ: اكتب /resume لإعادة فتحها."
diff --git a/locales/de.tui.yaml b/locales/de.tui.yaml
index a79c3123974..61dd99ff26f 100644
--- a/locales/de.tui.yaml
+++ b/locales/de.tui.yaml
@@ -1338,6 +1338,7 @@ userMessages.promptTimeout.vaultCode: "Abfrage des Bestätigungscodes geschlosse
userMessages.promptTimeout.vaultSaveLogin: "Abfrage zum Speichern der Anmeldung geschlossen: keine Antwort in der vorgegebenen Zeit, es wurde nichts gespeichert. Senden Sie Ihre Anfrage erneut, wenn Sie bereit sind."
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.launchCredentialsChanged: "Dieser Chat kann den API-Schlüssel, mit dem er gestartet wurde, nicht mehr verwenden (er wurde geändert oder entfernt), daher wurde das nicht ausgeführt. Ein Chat wechselt nie von selbst zu einem anderen Schlüssel. Geben Sie /new ein, um einen neuen Chat mit Ihrem aktuellen Schlüssel zu starten."
+userMessages.rpc.methodUnavailable: "Dieses Hermes-Backend stellt {0} nicht bereit, daher wurde das nicht ausgeführt."
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.sessionHasChildren: "Dieser Chat hat untergeordnete Sitzungen (etwa Subagent-Läufe), die beim Löschen ebenfalls entfernt würden, daher wurde er nicht gelöscht."
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."
diff --git a/locales/es.tui.yaml b/locales/es.tui.yaml
index 0535da3e59c..c67a9e1eec9 100644
--- a/locales/es.tui.yaml
+++ b/locales/es.tui.yaml
@@ -1338,6 +1338,7 @@ userMessages.promptTimeout.vaultCode: "El prompt del código de verificación se
userMessages.promptTimeout.vaultSaveLogin: "El prompt para guardar el inicio de sesión se cerró: no hubo respuesta a tiempo, así que no se guardó nada. Envía tu solicitud de nuevo cuando estés listo."
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.launchCredentialsChanged: "Este chat ya no puede usar la clave de API con la que se inició (cambió o se eliminó), así que no se hizo. Un chat nunca cambia por sí solo a otra clave. Escribe /new para empezar un chat nuevo con tu clave actual."
+userMessages.rpc.methodUnavailable: "Este backend de Hermes no ofrece {0}, así que no se hizo."
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.sessionHasChildren: "Este chat tiene sesiones hijas (como ejecuciones de subagentes) que también se eliminarían al borrarlo, así que no se borró."
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."
diff --git a/locales/fr.tui.yaml b/locales/fr.tui.yaml
index d77a2657177..f3ff0f8d4c1 100644
--- a/locales/fr.tui.yaml
+++ b/locales/fr.tui.yaml
@@ -1338,6 +1338,7 @@ userMessages.promptTimeout.vaultCode: "Invite de code de vérification fermée :
userMessages.promptTimeout.vaultSaveLogin: "Invite d'enregistrement des identifiants fermée : aucune réponse à temps, rien n'a donc été enregistré. Renvoyez votre demande quand vous serez prêt."
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.launchCredentialsChanged: "Cette conversation ne peut plus utiliser la clé API avec laquelle elle a démarré (elle a été modifiée ou supprimée), l'action n'a donc pas été effectuée. Une conversation ne passe jamais d'elle-même à une autre clé. Tapez /new pour démarrer une nouvelle conversation avec votre clé actuelle."
+userMessages.rpc.methodUnavailable: "Ce backend Hermes ne fournit pas {0}, donc cela n'a pas été fait."
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.sessionHasChildren: "Cette conversation a des sessions enfants (comme des exécutions de sous-agents) que sa suppression retirerait aussi, elle n'a donc pas été supprimée."
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."
diff --git a/locales/ga.tui.yaml b/locales/ga.tui.yaml
index 9cefad81f84..3bce3d263f4 100644
--- a/locales/ga.tui.yaml
+++ b/locales/ga.tui.yaml
@@ -1338,6 +1338,7 @@ userMessages.promptTimeout.vaultCode: "Dúnadh leid an chóid fhíoraithe: níor
userMessages.promptTimeout.vaultSaveLogin: "Dúnadh leid shábháil na logála isteach: níor tugadh freagra in am, mar sin níor sábháladh aon rud. Seol d'iarratas arís nuair a bheidh tú réidh."
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.launchCredentialsChanged: "Ní féidir leis an gcomhrá seo an eochair API ar tosaíodh leis a úsáid a thuilleadh (athraíodh nó baineadh í), mar sin ní dhearnadh é sin. Ní athraíonn comhrá go heochair eile as a stuaim féin. Clóscríobh /new chun comhrá nua a thosú le d'eochair reatha."
+userMessages.rpc.methodUnavailable: "Ní sholáthraíonn an t-inneall Hermes seo {0}, mar sin ní dhearnadh é sin."
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.sessionHasChildren: "Tá seisiúin linbh (mar ritheanna fo-ghníomhairí) ag an gcomhrá seo a bhainfí freisin dá scriosfaí é, mar sin níor scriosadh é."
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."
diff --git a/locales/hu.tui.yaml b/locales/hu.tui.yaml
index 1d12297f226..46831d807cf 100644
--- a/locales/hu.tui.yaml
+++ b/locales/hu.tui.yaml
@@ -1338,6 +1338,7 @@ userMessages.promptTimeout.vaultCode: "Az ellenőrző kód bekérése bezárult:
userMessages.promptTimeout.vaultSaveLogin: "A bejelentkezés mentésének bekérése bezárult: nem érkezett válasz időben, így semmi nem lett mentve. Küldd el újra a kérésedet, amikor készen állsz."
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.launchCredentialsChanged: "Ez a csevegés már nem tudja használni azt az API-kulcsot, amellyel elindult (megváltozott vagy törölték), ezért ez nem történt meg. Egy csevegés soha nem vált magától másik kulcsra. Írd be a /new parancsot, hogy új csevegést indíts a jelenlegi kulcsoddal."
+userMessages.rpc.methodUnavailable: "Ez a Hermes-háttérrendszer nem biztosítja ezt: {0}, ezért nem történt meg."
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.sessionHasChildren: "Ennek a csevegésnek gyermekmunkamenetei vannak (például alügynök-futtatások), amelyeket a törlése szintén eltávolítana, ezért nem lett törölve."
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."
diff --git a/locales/it.tui.yaml b/locales/it.tui.yaml
index 5af4351698f..b17d790d427 100644
--- a/locales/it.tui.yaml
+++ b/locales/it.tui.yaml
@@ -1338,6 +1338,7 @@ userMessages.promptTimeout.vaultCode: "Richiesta del codice di verifica chiusa:
userMessages.promptTimeout.vaultSaveLogin: "Richiesta di salvataggio dell'accesso chiusa: nessuna risposta in tempo, quindi non è stato salvato nulla. Invia di nuovo la richiesta quando sei pronto."
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.launchCredentialsChanged: "Questa chat non può più usare la chiave API con cui è stata avviata (è stata cambiata o rimossa), quindi l'operazione non è stata eseguita. Una chat non passa mai da sola a una chiave diversa. Digita /new per avviare una nuova chat con la tua chiave attuale."
+userMessages.rpc.methodUnavailable: "Questo backend Hermes non fornisce {0}, quindi l'operazione non è stata eseguita."
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.sessionHasChildren: "Questa chat ha sessioni figlie (come esecuzioni di subagenti) che eliminarla rimuoverebbe a loro volta, quindi non è stata eliminata."
userMessages.rpc.sessionNotFound: "Questa chat non è più collegata al backend (era inattiva o il backend si è riavviato). La cronologia è salvata: digita /resume per riaprirla."
diff --git a/locales/ja.tui.yaml b/locales/ja.tui.yaml
index 7c7ce7c851e..8d94ee6c9c9 100644
--- a/locales/ja.tui.yaml
+++ b/locales/ja.tui.yaml
@@ -1338,6 +1338,7 @@ userMessages.promptTimeout.vaultCode: "確認コード入力プロンプトを
userMessages.promptTimeout.vaultSaveLogin: "ログイン保存プロンプトを閉じました: 時間内に応答がなかったため、何も保存されていません。準備ができたら、もう一度リクエストを送ってください。"
userMessages.promptTimeout.vaultUnlockPrompt: "ロック解除プロンプトを閉じました: 時間内に入力がなかったため、パスワードマネージャーはロックされたままです。解除の準備ができたら、もう一度リクエストを送ってください。"
userMessages.rpc.launchCredentialsChanged: "このチャットは開始時の API キーをもう使えないため(変更または削除されました)、実行されませんでした。チャットが自動で別のキーに切り替わることはありません。/new と入力して、現在のキーで新しいチャットを始めてください。"
+userMessages.rpc.methodUnavailable: "この Hermes バックエンドは {0} を提供していないため、実行されませんでした。"
userMessages.rpc.notConnected: "Hermes に接続していないため送信されませんでした。自動的に再接続しますので、少し待ってから再度お試しください。続く場合は /logs と入力してください。"
userMessages.rpc.sessionHasChildren: "このチャットには、削除すると一緒に消えてしまう子セッション(サブエージェントの実行など)があるため、削除されませんでした。"
userMessages.rpc.sessionNotFound: "このチャットはバックエンドから切り離されています(アイドル状態が続いたか、バックエンドが再起動しました)。履歴は保存されています。/resume と入力すると再び開けます。"
diff --git a/locales/ko.tui.yaml b/locales/ko.tui.yaml
index 12ca1997455..e6e1e313d55 100644
--- a/locales/ko.tui.yaml
+++ b/locales/ko.tui.yaml
@@ -1338,6 +1338,7 @@ userMessages.promptTimeout.vaultCode: "인증 코드 프롬프트가 닫혔어
userMessages.promptTimeout.vaultSaveLogin: "로그인 저장 프롬프트가 닫혔어요: 제한 시간 안에 답이 없어서 아무것도 저장하지 않았어요. 준비되면 요청을 다시 보내세요."
userMessages.promptTimeout.vaultUnlockPrompt: "잠금 해제 프롬프트가 닫혔어요: 제한 시간 안에 답이 없어서 비밀번호 관리자가 잠긴 상태로 남았어요. 잠금을 해제할 준비가 되면 요청을 다시 보내세요."
userMessages.rpc.launchCredentialsChanged: "이 채팅은 시작할 때 사용한 API 키를 더 이상 사용할 수 없어서(변경되었거나 삭제됨) 실행되지 않았습니다. 채팅은 스스로 다른 키로 바뀌지 않습니다. /new를 입력해 현재 키로 새 채팅을 시작하세요."
+userMessages.rpc.methodUnavailable: "이 Hermes 백엔드는 {0}을(를) 제공하지 않으므로 실행되지 않았습니다."
userMessages.rpc.notConnected: "지금 Hermes가 연결되어 있지 않아서 전송되지 않았어요. 자동으로 다시 연결되니 잠시 후 다시 시도하고, 계속되면 /logs 를 입력하세요."
userMessages.rpc.sessionHasChildren: "이 채팅에는 삭제하면 함께 제거될 하위 세션(서브에이전트 실행 등)이 있어서 삭제되지 않았습니다."
userMessages.rpc.sessionNotFound: "이 채팅은 더 이상 백엔드에 연결되어 있지 않아요 (유휴 상태였거나 백엔드가 다시 시작됐어요). 기록은 저장되어 있으니 /resume 을 입력해 다시 열어 주세요."
diff --git a/locales/pt.tui.yaml b/locales/pt.tui.yaml
index 0b0ed4f2b6f..06ee17325ac 100644
--- a/locales/pt.tui.yaml
+++ b/locales/pt.tui.yaml
@@ -1338,6 +1338,7 @@ userMessages.promptTimeout.vaultCode: "Prompt de código de verificação fechad
userMessages.promptTimeout.vaultSaveLogin: "Prompt de salvar login fechado: sem resposta a tempo, então nada foi salvo. Envie sua solicitação novamente quando estiver pronto."
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.launchCredentialsChanged: "Este chat não pode mais usar a chave de API com que foi iniciado (ela foi alterada ou removida), então isso não foi feito. Um chat nunca muda sozinho para outra chave. Digite /new para começar um novo chat com sua chave atual."
+userMessages.rpc.methodUnavailable: "Este backend do Hermes não oferece {0}, por isso isso não foi feito."
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.sessionHasChildren: "Este chat tem sessões filhas (como execuções de subagentes) que excluí-lo também removeria, então ele não foi excluído."
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."
diff --git a/locales/ru.tui.yaml b/locales/ru.tui.yaml
index 0bca8614478..b823d9b931d 100644
--- a/locales/ru.tui.yaml
+++ b/locales/ru.tui.yaml
@@ -1338,6 +1338,7 @@ userMessages.promptTimeout.vaultCode: "Запрос кода подтвержд
userMessages.promptTimeout.vaultSaveLogin: "Запрос на сохранение логина закрыт: ответ не получен вовремя, поэтому ничего не сохранено. Отправьте запрос снова, когда будете готовы."
userMessages.promptTimeout.vaultUnlockPrompt: "Запрос разблокировки закрыт: ответ не получен вовремя, поэтому менеджер паролей остался заблокирован. Отправьте запрос снова, когда будете готовы его разблокировать."
userMessages.rpc.launchCredentialsChanged: "Этот чат больше не может использовать ключ API, с которым он был начат (ключ изменили или удалили), поэтому действие не выполнено. Чат никогда сам не переключается на другой ключ. Введите /new, чтобы начать новый чат с текущим ключом."
+userMessages.rpc.methodUnavailable: "Этот бэкенд Hermes не предоставляет {0}, поэтому действие не выполнено."
userMessages.rpc.notConnected: "Hermes сейчас не подключён, поэтому это не было отправлено. Он переподключается автоматически; подождите немного и повторите, а если проблема сохраняется — введите /logs."
userMessages.rpc.sessionHasChildren: "У этого чата есть дочерние сессии (например, запуски субагентов), которые удаление тоже удалило бы, поэтому он не удалён."
userMessages.rpc.sessionNotFound: "Этот чат больше не привязан к бэкенду (он простаивал или бэкенд перезапустился). История сохранена: введите /resume, чтобы открыть его снова."
diff --git a/locales/tr.tui.yaml b/locales/tr.tui.yaml
index 48200d3c899..1f8e9f86bc1 100644
--- a/locales/tr.tui.yaml
+++ b/locales/tr.tui.yaml
@@ -1338,6 +1338,7 @@ userMessages.promptTimeout.vaultCode: "Doğrulama kodu istemi kapandı: zamanın
userMessages.promptTimeout.vaultSaveLogin: "Giriş kaydetme istemi kapandı: zamanında yanıt gelmediği için hiçbir şey kaydedilmedi. Hazır olduğunuzda isteğinizi yeniden gönderin."
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.launchCredentialsChanged: "Bu sohbet, başlatıldığı API anahtarını artık kullanamıyor (değiştirildi veya kaldırıldı), bu yüzden işlem yapılmadı. Bir sohbet asla kendiliğinden başka bir anahtara geçmez. Mevcut anahtarınla yeni bir sohbet başlatmak için /new yaz."
+userMessages.rpc.methodUnavailable: "Bu Hermes arka ucu {0} sağlamıyor, bu yüzden işlem yapılmadı."
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.sessionHasChildren: "Bu sohbetin, silinirse onlar da kaldırılacak alt oturumları (alt ajan çalıştırmaları gibi) var, bu yüzden silinmedi."
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."
diff --git a/locales/uk.tui.yaml b/locales/uk.tui.yaml
index c0a2ce6b1aa..cc8aa46d883 100644
--- a/locales/uk.tui.yaml
+++ b/locales/uk.tui.yaml
@@ -1338,6 +1338,7 @@ userMessages.promptTimeout.vaultCode: "Запит коду підтвердже
userMessages.promptTimeout.vaultSaveLogin: "Запит на збереження логіна закрито: відповіді вчасно не було, тому нічого не збережено. Надішліть запит знову, коли будете готові."
userMessages.promptTimeout.vaultUnlockPrompt: "Запит на розблокування закрито: відповіді вчасно не було, тому менеджер паролів залишився заблокованим. Надішліть запит знову, коли будете готові його розблокувати."
userMessages.rpc.launchCredentialsChanged: "Цей чат більше не може використовувати ключ API, з яким його було розпочато (ключ змінили або видалили), тому дію не виконано. Чат ніколи сам не перемикається на інший ключ. Введіть /new, щоб почати новий чат із поточним ключем."
+userMessages.rpc.methodUnavailable: "Цей бекенд Hermes не надає {0}, тому дію не виконано."
userMessages.rpc.notConnected: "Hermes зараз не підключено, тому це не надіслано. Він перепідключається автоматично; зачекайте трохи та спробуйте ще раз або введіть /logs, якщо проблема не зникає."
userMessages.rpc.sessionHasChildren: "Цей чат має дочірні сесії (наприклад, запуски субагентів), які видалення теж прибрало б, тому його не видалено."
userMessages.rpc.sessionNotFound: "Цей чат більше не прив'язаний до бекенду (він простоював або бекенд перезапустився). Історію збережено: введіть /resume, щоб відкрити його знову."
diff --git a/locales/zh-hant.tui.yaml b/locales/zh-hant.tui.yaml
index b178b76d0df..b57ca41f308 100644
--- a/locales/zh-hant.tui.yaml
+++ b/locales/zh-hant.tui.yaml
@@ -1338,6 +1338,7 @@ userMessages.promptTimeout.vaultCode: "驗證碼提示已關閉:未及時回
userMessages.promptTimeout.vaultSaveLogin: "儲存登入資訊的提示已關閉:未及時回應,因此未儲存任何內容。準備好後請重新送出你的請求。"
userMessages.promptTimeout.vaultUnlockPrompt: "解鎖提示已關閉:未及時回應,密碼管理器仍保持鎖定。準備好解鎖時請重新送出你的請求。"
userMessages.rpc.launchCredentialsChanged: "此聊天無法再使用它開始時的 API 金鑰(已被變更或刪除),因此未執行該操作。聊天不會自行切換到其他金鑰。輸入 /new 以目前的金鑰開始新聊天。"
+userMessages.rpc.methodUnavailable: "此 Hermes 後端不提供 {0},因此未執行。"
userMessages.rpc.notConnected: "Hermes 目前未連線,所以剛才的內容沒有送出。它會自動重新連線;請稍候再試,如果問題持續,請輸入 /logs。"
userMessages.rpc.sessionHasChildren: "此聊天有子工作階段(例如子代理執行),刪除它會一併移除這些工作階段,因此未刪除。"
userMessages.rpc.sessionNotFound: "此聊天已不再連接到後端(長時間閒置或後端已重新啟動)。你的歷史記錄已儲存:輸入 /resume 重新開啟。"
diff --git a/locales/zh.tui.yaml b/locales/zh.tui.yaml
index 85681bc8375..f807e183d89 100644
--- a/locales/zh.tui.yaml
+++ b/locales/zh.tui.yaml
@@ -1338,6 +1338,7 @@ userMessages.promptTimeout.vaultCode: "验证码提示已关闭:未及时回
userMessages.promptTimeout.vaultSaveLogin: "保存登录信息的提示已关闭:未及时回应,因此未保存任何内容。准备好后请重新发送你的请求。"
userMessages.promptTimeout.vaultUnlockPrompt: "解锁提示已关闭:未及时回应,密码管理器仍保持锁定。准备好解锁时请重新发送你的请求。"
userMessages.rpc.launchCredentialsChanged: "此聊天无法再使用它开始时的 API 密钥(已被更改或删除),因此未执行该操作。聊天不会自行切换到其他密钥。输入 /new 以当前密钥开始新聊天。"
+userMessages.rpc.methodUnavailable: "此 Hermes 后端不提供 {0},因此未执行。"
userMessages.rpc.notConnected: "Hermes 目前未连接,所以刚才的内容没有发送。它会自动重连;请稍等片刻再试,如果问题持续,请输入 /logs。"
userMessages.rpc.sessionHasChildren: "此聊天有子会话(例如子代理运行),删除它会一并移除这些会话,因此未删除。"
userMessages.rpc.sessionNotFound: "此聊天已不再连接到后端(长时间空闲或后端已重启)。你的历史记录已保存:输入 /resume 重新打开。"
diff --git a/tests/gateway/test_hosted_room_file_refusal.py b/tests/gateway/test_hosted_room_file_refusal.py
new file mode 100644
index 00000000000..0c334501913
--- /dev/null
+++ b/tests/gateway/test_hosted_room_file_refusal.py
@@ -0,0 +1,118 @@
+"""A member's bound file is prepared before its turn is submitted, on both server routes.
+
+A file the member can never take (over its ``gateway.max_inbound_media_bytes``) is a refusal of
+work that never started: the turn fails at once instead of pausing the room for recovery as an
+uncertain execution. A transient preparation failure is proven not admitted and is requeued.
+"""
+
+from __future__ import annotations
+
+import time
+from pathlib import Path
+
+import pytest
+
+from gateway import hosted_room_driver as state
+from gateway import hosted_rooms
+from gateway.hosted_room_attachments import HostedRoomAttachmentStore
+from gateway.session_hosted_rpc import HostedRoomAuthorityRPC
+from tests.tui_gateway.test_hosted_room_attachment_routes import (
+ _admit, _legacy_runtime, _run_until_settled_or_error, _server_module)
+from tests.tui_gateway.test_hosted_room_driver_runtime import BINDING, PROFILE, ROOM_ID
+from tests.waiting import wait_until
+from tui_gateway.hosted_room_driver import HostedRoomBinding, HostedRoomRuntime
+from tui_gateway.hosted_room_server_rpc import HostedRoomServerRPC
+
+
+def _cap_member_media(monkeypatch, limit: int) -> None:
+ from gateway.platforms import base
+
+ monkeypatch.setattr(base, "get_inbound_media_max_bytes", lambda: limit)
+
+
+def _bind(db: Path, room_id: str, member_id: str) -> list[dict]:
+ store = HostedRoomAttachmentStore(db)
+ saved = store.put(room_id=room_id, upload_id="upload", kind="file", name="note.txt",
+ mime="text/plain", data=b"exact bytes")
+ manifest = [{k: saved[k] for k in ("attachment_id", "kind", "name", "size", "mime")}]
+ store.commit_message(room_id=room_id, event_id="event", manifest=manifest,
+ recipient_member_ids=[member_id])
+ return [{**manifest[0], "event_id": "event"}]
+
+
+def tui_db(tmp_path: Path, monkeypatch) -> Path:
+ monkeypatch.setenv("HERMES_HOME", str(tmp_path / "member-home"))
+ path = tmp_path / "rooms.db"
+ hosted_rooms.create_room(
+ path, room_id=ROOM_ID, name="Release room", members=[{"profile": PROFILE, "handle": PROFILE}],
+ authority_gateway_id=BINDING.gateway_id, now=time.time())
+ return path
+
+
+def _tui_run(db: Path):
+ identity = _admit(db, attachments=_bind(db, ROOM_ID, "member-ops"))
+ server, submits = _server_module()
+ server._profile_home = lambda _profile: None
+ runtime = _legacy_runtime(db, HostedRoomServerRPC(server, db_path=db))
+ task = _run_until_settled_or_error(runtime, db, identity)
+ return task, submits, runtime
+
+
+def test_tui_route_fails_a_turn_whose_file_exceeds_the_member_cap(tui_db, monkeypatch):
+ _cap_member_media(monkeypatch, 4)
+ task, submits, runtime = _tui_run(tui_db)
+ assert task["status"] == "failed", runtime.status()["last_error"]
+ assert submits == []
+ assert ROOM_ID not in runtime._ambiguous_rooms
+
+
+def test_tui_route_requeues_a_turn_whose_file_preparation_failed_transiently(tui_db, monkeypatch):
+ def unavailable(*_args, **_kwargs):
+ raise OSError("disk briefly unavailable")
+
+ monkeypatch.setattr(HostedRoomAttachmentStore, "read", unavailable)
+ task, submits, runtime = _tui_run(tui_db)
+ assert task["status"] == "queued", runtime.status()["last_error"]
+ assert "was not admitted" in runtime.status()["last_error"]
+ assert submits == []
+ assert ROOM_ID not in runtime._ambiguous_rooms
+
+
+class _NullLock:
+ def __enter__(self):
+ return self
+
+ def __exit__(self, *exc):
+ return False
+
+
+def test_authority_route_fails_a_turn_whose_file_exceeds_the_member_cap(hosted_owner, tmp_path, monkeypatch):
+ authority, loop, principal, _ = hosted_owner
+ binding = HostedRoomBinding(room_id="room", gateway_id="gateway-a", authority_epoch=1)
+ room_db = tmp_path / "rooms.db"
+ hosted_rooms.create_room(
+ room_db, room_id="room", name="Release room", members=[{"profile": "default", "handle": "default"}],
+ authority_gateway_id=binding.gateway_id, now=time.time())
+ identity = state.TaskIdentity("room", "task", "thread", "turn")
+ state.admit_task(room_db, identity, payload={
+ "target_profile": "default", "target_member_id": "member", "prompt": "read",
+ "source_event_seq": 1, "attachments": _bind(authority.db.db_path, "room", "member")},
+ clock=time.time)
+ rpc = HostedRoomAuthorityRPC(authority, loop, room_id="room", member_id="member",
+ profile="default", principal=principal, authorize=lambda *args: True)
+ runtime = HostedRoomRuntime(db_path=room_db, rooms=[binding], rpc=rpc,
+ turn_lock=lambda _profile: _NullLock(), poll_interval_seconds=0.01)
+ _cap_member_media(monkeypatch, 4)
+
+ runtime.start()
+ try:
+ wait_until(lambda: state.get_task(room_db, identity)["status"] in state.TERMINAL_STATUSES
+ or runtime.status()["last_error"] is not None, what="a settled refusal or an error")
+ status = state.get_task(room_db, identity)["status"]
+ finally:
+ assert runtime.stop(timeout=5.0)
+
+ assert status == "failed", runtime.status()["last_error"]
+ assert rpc.callbacks == {}
+ assert "room" not in runtime._ambiguous_rooms
diff --git a/tests/tui_gateway/test_hosted_room_discussion_retry_budget.py b/tests/tui_gateway/test_hosted_room_discussion_retry_budget.py
new file mode 100644
index 00000000000..de838b9c6d5
--- /dev/null
+++ b/tests/tui_gateway/test_hosted_room_discussion_retry_budget.py
@@ -0,0 +1,69 @@
+"""A retried deferred turn must not stall a discussion configured to its full reply budget."""
+
+from __future__ import annotations
+
+import threading
+import time
+from pathlib import Path
+from types import SimpleNamespace
+
+from gateway import hosted_room_driver as driver
+from tui_gateway.hosted_room_service import HostedRoomService
+
+
+PROFILES = ("research", "build", "review", "ops", "qa", "docs")
+ROOM_ID = "retry-budget-room"
+
+
+def _service(root: Path) -> HostedRoomService:
+ server = SimpleNamespace(_methods={}, _sessions={}, _sessions_lock=threading.Lock())
+ service = HostedRoomService(server, db_path=root / "state.db")
+ service.local_profiles = lambda: PROFILES
+ return service
+
+
+def test_retried_deferred_turns_do_not_stall_a_full_six_round_discussion(tmp_path):
+ (tmp_path / "config.yaml").write_text(
+ "hosted_rooms:\n discussion:\n max_rounds: 6\n max_messages: 40\n")
+ service = _service(tmp_path)
+ service.create_room(
+ room_id=ROOM_ID, name="Retry budget",
+ members=[{"member_id": p, "profile": p, "handle": p} for p in PROFILES])
+ service.send(room_id=ROOM_ID, event_id="kickoff",
+ payload={"text": "Discuss.", "thread_id": "thread-1"})
+ binding = service.bindings()[0]
+ now = [time.time()]
+ clock = lambda: now[0]
+ service.runtime.clock = clock
+
+ # The first turn's attempt is abandoned, fenced as deferred, then retried by the user while
+ # the rest of the discussion runs: 1 kickoff + 36 replies + 36 settles + 1 deferral = 74.
+ first = driver.list_tasks(service.db_path, room_id=ROOM_ID, status="queued")[0]
+ old = driver.acquire_lease(
+ service.db_path, room_id=ROOM_ID, gateway_id=binding.gateway_id,
+ authority_epoch=binding.authority_epoch, process_generation="old", ttl_seconds=1, clock=clock)
+ driver.start_task(service.db_path, first["identity"], old, expected_cancel_generation=0, clock=clock)
+ now[0] += 2
+ lease = service.runtime._ensure_lease(binding)
+ driver.recover_room(service.db_path, lease, clock=clock)
+ driver.defer_indeterminate_task(
+ service.db_path, first["identity"], lease, expected_execution_generation=1,
+ expected_cancel_generation=0, reason="member_unavailable", clock=clock)
+ service.prepare_room(binding) # publishes turn.deferred and admits the next member
+ service.retry_room_task(ROOM_ID, task_id=first["identity"].task_id)
+
+ for index in range(80):
+ queued = driver.list_tasks(service.db_path, room_id=ROOM_ID, status="queued")
+ if not queued:
+ break
+ attempt = driver.start_task(
+ service.db_path, queued[0]["identity"], lease, expected_cancel_generation=0, clock=clock)
+ driver.settle_task(service.db_path, attempt, settlement_id=f"reply-{index}", status="settled",
+ result={"text": "@everyone next"}, clock=clock)
+ service.prepare_room(binding)
+
+ events = service._events(ROOM_ID)
+ assert sum(event["kind"] == "turn.deferred" for event in events) == 1
+ assert sum(event["kind"] == "message.member" for event in events) == 36
+ assert events[-1]["kind"] == "room.activity"
+ assert events[-1]["payload"]["reason_code"] == "max_rounds"
diff --git a/tui_gateway/hosted_room_driver.py b/tui_gateway/hosted_room_driver.py
index 1a6aa7806a2..78867895728 100644
--- a/tui_gateway/hosted_room_driver.py
+++ b/tui_gateway/hosted_room_driver.py
@@ -637,7 +637,10 @@ class HostedRoomRuntime:
# reason, not the free-form messages retained in the in-memory status.
reason = 'request_too_large' if getattr(exc, 'reason', None) == 'request_too_large' else 'attempt_failed'
logger.warning('hosted room task %s: %s', attempt.identity.task_id, reason)
- if submit_attempted and bool(getattr(exc, "not_admitted", False)):
+ if getattr(exc, "refused_before_submit", False):
+ # File preparation refused work that never started; no retry can change it.
+ self._settle_failure_if_current(attempt, exc)
+ elif submit_attempted and bool(getattr(exc, "not_admitted", False)):
try:
state.requeue_not_admitted_task(self.db_path, attempt, clock=self.clock)
except (state.StaleLeaseError, state.StaleTaskError) as fence_exc:
diff --git a/tui_gateway/hosted_room_server_rpc.py b/tui_gateway/hosted_room_server_rpc.py
index 360e7912c05..f062a04d201 100644
--- a/tui_gateway/hosted_room_server_rpc.py
+++ b/tui_gateway/hosted_room_server_rpc.py
@@ -80,7 +80,7 @@ class HostedRoomServerRPC:
if not attachments:
return self._submit(profile, session_id, prompt, source, task, execution_generation,
on_terminal, member_id, images=())
- from gateway.session_hosted_attachments import bound_submission_payload
+ from gateway.session_hosted_attachments import bound_submission_payload, prepare_before_submit
from gateway.session_ingress_media import capture_lease
from hermes_constants import reset_hermes_home_override, set_hermes_home_override
home = self.server._profile_home(profile)
@@ -89,9 +89,9 @@ class HostedRoomServerRPC:
with capture_lease():
token = set_hermes_home_override(str(home)) if home is not None else None
try:
- inputs = bound_submission_payload(
+ inputs = prepare_before_submit(lambda: bound_submission_payload(
self.db_path, room_id=task.room_id, member_id=member_id, prompt=prompt,
- attachments=list(attachments))
+ attachments=list(attachments)))
finally:
if token is not None:
reset_hermes_home_override(token)
diff --git a/ui-tui/src/__tests__/userMessagesUnavailableMethod.test.ts b/ui-tui/src/__tests__/userMessagesUnavailableMethod.test.ts
new file mode 100644
index 00000000000..5bc12094c80
--- /dev/null
+++ b/ui-tui/src/__tests__/userMessagesUnavailableMethod.test.ts
@@ -0,0 +1,33 @@
+import { JsonRpcGatewayError } from '@hermes/shared/json-rpc-channel'
+import { describe, expect, it } from 'vitest'
+
+import { describeRpcError, isVersionSkewError } from '../app/userMessages.js'
+
+// Both server routes now answer a missing method with what the backend knows (it does not serve
+// the method); a JSON-RPC client sends no version, so the TUI must not turn that into a claim
+// that the versions differ, nor into update advice.
+describe('a method the backend says it does not provide', () => {
+ const unavailable = new JsonRpcGatewayError(
+ 'unknown method: groups.no_such_verb — not available on this Hermes backend',
+ { code: -32601 }
+ )
+
+ it('is not read as version skew and names the method without update advice', () => {
+ expect(isVersionSkewError(unavailable)).toBe(false)
+
+ const text = describeRpcError(unavailable)
+
+ expect(text).toContain('groups.no_such_verb')
+ expect(text).not.toMatch(/out of sync|different versions|\/update|hermes update/)
+ })
+
+ it('keeps the skew warning for a schema the backend rejects', () => {
+ const extra = new JsonRpcGatewayError(
+ 'invalid params for prompt.submit: turn_author: Extra inputs are not permitted',
+ { code: 4000 }
+ )
+
+ expect(isVersionSkewError(extra)).toBe(true)
+ expect(describeRpcError(extra)).toContain('/update')
+ })
+})
diff --git a/ui-tui/src/app/userMessages.ts b/ui-tui/src/app/userMessages.ts
index d7f4fc697c1..f63c7649162 100644
--- a/ui-tui/src/app/userMessages.ts
+++ b/ui-tui/src/app/userMessages.ts
@@ -104,11 +104,18 @@ export const stderrProblemActivity = (line: string): string => {
// ── RPC errors ────────────────────────────────────────────────────────────
const VERSION_SKEW_RE = /Extra inputs are not permitted|^unknown method:/
+// Both server routes' answer for a method they do not serve (tui_gateway/contracts/registry.py
+// unknown_method_message). A JSON-RPC client sends no version, so this is not proof of skew.
+const UNAVAILABLE_METHOD_RE = /^unknown method: (\S+) — not available on this Hermes backend$/
/** The Ink bundle and the Python backend disagree on the wire: stale dist or an older attached backend. */
export const isVersionSkewError = (err: unknown): boolean => {
const { code, message } = rpcShape(err)
+ if (UNAVAILABLE_METHOD_RE.test(message ?? '')) {
+ return false
+ }
+
return (
code === RPC_UNKNOWN_METHOD ||
(code === RPC_INVALID_PARAMS && VERSION_SKEW_RE.test(message ?? '')) ||
@@ -139,6 +146,7 @@ const RPC_ERROR_ROWS: RpcErrorRow[] = [
[(_code, text) => text === 'session_read_only', () => t('userMessages.rpc.sessionReadOnly')],
[(_code, text) => text === 'session_has_children', () => t('userMessages.rpc.sessionHasChildren')],
[(_code, text) => NOT_CONNECTED_RE.test(text), () => t('userMessages.rpc.notConnected')],
+ [(_code, text) => UNAVAILABLE_METHOD_RE.exec(text), m => t('userMessages.rpc.methodUnavailable', m?.[1] ?? '?')],
[(_code, text) => text.trim() === 'launch_credentials_unavailable', () => t('userMessages.rpc.launchCredentialsChanged')],
[(_code, text) => TIMED_OUT_RE.exec(text), m => t('userMessages.rpc.timedOut', m?.[1] ?? '?')]
]
diff --git a/ui-tui/src/i18n/en/userMessages.ts b/ui-tui/src/i18n/en/userMessages.ts
index 3c4d37667a2..06ae4774d26 100644
--- a/ui-tui/src/i18n/en/userMessages.ts
+++ b/ui-tui/src/i18n/en/userMessages.ts
@@ -43,6 +43,8 @@ export const userMessagesEn = {
/** shellBackendRefused when the gateway did not name the backend (older gateways). */
shellBackendRefusedUnnamed:
"!commands run on the gateway host, but this session's terminal backend isn't local, so the command was not run. Ask the agent to run it instead.",
+ /** `{0}` = the JSON-RPC method name the backend does not serve. Not a version claim. */
+ methodUnavailable: (method: string) => `This Hermes backend does not provide ${method}, so that was not done.`,
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: