The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
"""``/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: <exc>`` 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