hermes - 💡(How to fix) Fix Add agent-wake UDS transport: external processes inject user-turn messages into the active CLI session without keyboard/TTY automation [1 participants]

Use case

Smith Crafts runs multiple local agent runtimes that need to wake each other when long-running work completes. For OpenClaw we added a local Unix-domain socket wake path so an orchestrator can inject a normal user-turn message into the active CLI session without GUI typing, tmux chunking, or brittle TTY automation. Hermes has the same need for the Stitch seat.

OpenClaw reference issue for the cross-runtime context: openclaw/openclaw#83809.

Relevant Hermes code paths

• cli.py owns the active interactive HermesCLI object and initializes _pending_input / _interrupt_queue.
• HermesCLI.run() reinitializes those queues for the TUI and then starts the background process_loop().
• process_loop() consumes _pending_input and routes normal user turns through chat().
• tools/code_execution_tool.py already provides a Hermes-native precedent for local UDS IPC with newline-delimited JSON and 0600 socket permissions.

Proposed surface

Add a small public helper on HermesCLI:

def enqueue_external_user_message(self, text: str, source: str = "agent_wake") -> None:
    self._pending_input.put(text)

Add a focused tools/agent_wake_socket.py module that owns:

• UDS listener lifecycle and cleanup
• sidecar ownership metadata (pid, session_id, wake_session_id)
• newline-JSON framing
• payload validation for agent-wake.v1
• durable wake-inbox idempotency (consumed_at, consumed_by_run_id, consumed_delivery_mode)
• active CLI resolution by wake session id

Default delivery should enqueue to _pending_input as the next normal user turn. A future explicit delivery_mode:"steer" can be added later, but the default should not interrupt an in-flight agent turn.

Interim local patch

We are running a local patch in the Smith Crafts Hermes install while this is discussed upstream. The patch is intentionally small: one helper in cli.py, one ensure_agent_wake_socket(self) call after the plugin manager receives the CLI ref, one cleanup hook, and the new tool module. A content-anchored reapply hook keeps the local patch restorable after Hermes updates.