"""``/bg`` and ``/btw`` on the shared gateway session (``prompt.background`` / ``prompt.btw``). On main the classic CLI built a second ``AIAgent`` (``/bg``) or made a one-shot auxiliary call (``/btw``) in its own process. Rewired, the side work runs in the gateway, like Ink's: the verb replies ``{task_id}`` at once and the answer arrives later on the session's event stream as ``background.complete`` / ``btw.complete`` ``{task_id, text}`` (``error: `` on failure, ``gateway/session_tui_side.py``). The connection's pump hands those frames to the waiter registered here, so neither the turn pump nor the idle notification tick can drop them. """ from __future__ import annotations import queue SIDE_EVENTS = frozenset({"background.complete", "btw.complete"}) _POLL_SECONDS = 1.0 def connection_for(cli): """The CLI's gateway connection when its session is open, else None (not rewired). A hung-up connection is returned (its next call redials); only a final one is None.""" from hermes_cli.gateway_tools_notify import gateway_store store = gateway_store(cli) if store is None or not getattr(cli, "_gateway_session_open", False) or store.connection.final: return None return store.connection def start(connection, session_id, verb, text): """Admit the side task on the owner: ``(task_id, wait)``; ``wait()`` -> the answer (raises on failure).""" # The epoch of the socket that admitted it: a redial before the waiter exists must still end it. result, epoch = connection.call_tagged(f"prompt.{verb}", session_id=session_id, text=text) task_id = (result or {}).get("task_id") if not task_id: raise RuntimeError(f"prompt.{verb} returned no task id") inbox = connection.side_waiter(task_id) def wait(): try: while True: try: payload = inbox.get(timeout=_POLL_SECONDS) except queue.Empty: # The task lived on the socket that admitted it: hung up, or already redialed. if connection.closed or connection.epoch != epoch: from hermes_cli.gateway_connection import DISCONNECTED raise RuntimeError(DISCONNECTED) from None continue answer = str((payload or {}).get("text") or "") if answer.startswith("error: "): raise RuntimeError(answer[len("error: "):]) return answer finally: connection.drop_side_waiter(task_id) return task_id, wait