Files
hermes-agent/tests/hermes_cli/test_process_dock.py
teknium1 caa2e2dd99 feat(cli): background processes show in the live-work dock and monitor
terminal(background=true) spawns were only a "⚙ N" count in the status bar
while subagents got a dock, a roster, tails and controls. The classic CLI
dock now paints a Processes block under the subagent rows (command,
elapsed, latest output line; exit verdict once finished, retained 60 s),
and the Ctrl+T/F6 monitor lists processes under the agents with Enter =
log tail and x = stop that process. Processes cannot be steered.
2026-09-20 13:55:03 -07:00

75 lines
3.7 KiB
Python

"""Background processes share the classic CLI live-work dock with subagents (Processes block)."""
import time
from types import SimpleNamespace
from prompt_toolkit.utils import get_cwidth
def _wait(predicate, timeout=5.0):
deadline = time.monotonic() + timeout
while not predicate():
assert time.monotonic() < deadline, "timed out"
time.sleep(0.05)
def test_dock_paints_processes_under_agents_and_retires_finished_rows(monkeypatch):
from hermes_cli import cli_process_dock
from hermes_cli.cli_subagent_monitor import SubagentMonitor
from tools import delegate_tool_registry as registry
from tools.process_registry import process_registry
monkeypatch.setattr(registry, '_active_subagents', {})
owner = SimpleNamespace(session_id='owner')
registry._register_subagent(dict(subagent_id='a1', owner_agent_session_id='owner',
goal='Check module', started_at=time.time() - 5, status='running', last_tool='read_file'))
quick = process_registry.spawn_local(command="echo hello-dock; exit 3", cwd='.', task_id='t', owner_task_id='t', session_key='')
slow = process_registry.spawn_local(command="sleep 30", cwd='.', task_id='t', owner_task_id='t', session_key='')
quick_id, slow_id = quick.id, slow.id
try:
_wait(lambda: process_registry.get(quick_id).exited)
process_registry.list_sessions() # observes the exit → exited_at stamped
dock = SubagentMonitor(SimpleNamespace(agent=owner))
assert dock.refresh()
text = dock.dock_text(columns=100, rows=30)
lines = text.splitlines()
assert 'Subagents · 1 live' in lines[0]
agents_at = next(i for i, line in enumerate(lines) if 'Check module' in line)
procs_at = next(i for i, line in enumerate(lines) if 'Processes · 1 running · 1 done' in line)
assert agents_at < procs_at
assert any('⚙ sleep 30' in line and 'starting' in line for line in lines)
assert any('✘ echo hello-dock; exit 3 · exit 3' in line for line in lines)
assert all(get_cwidth(line) <= 100 for line in lines)
# Every viewport keeps at least one row of each block.
narrow = dock.dock_text(columns=40, rows=14).splitlines()
assert any('Check module' in line for line in narrow) and any('Processes' in line for line in narrow)
assert all(get_cwidth(line) <= 40 for line in narrow)
dock.collapsed = True
assert dock.dock_text(columns=100, rows=30).count('\n') == 0
assert '1 live · 1 proc' in dock.dock_text(columns=100, rows=30)
# Finished rows leave after the retention window; running ones stay.
later = cli_process_dock.process_rows(time.time() + cli_process_dock.RETAIN_SECONDS + 1)
assert [r['id'] for r in later] == [slow_id]
finally:
process_registry.kill_process(slow_id)
def test_monitor_controls_stop_processes_and_never_steer_them():
from hermes_cli.cli_subagent_monitor import SubagentMonitor
from tools.process_registry import process_registry
slow = process_registry.spawn_local(command="sleep 30", cwd='.', task_id='t', owner_task_id='t', session_key='')
slow_id = slow.id
try:
dock = SubagentMonitor(SimpleNamespace(agent=None))
dock.refresh()
dock.selected_id = slow_id
assert dock.selected_process is not None
assert 'error' in dock.control('steer', 'nope')
assert process_registry.get(slow_id).exited is False
assert dock.control('stop')['status'] == 'killed'
_wait(lambda: process_registry.get(slow_id).exited)
dock.refresh()
assert any(r['id'] == slow_id and r['status'] == 'killed' for r in dock.processes)
finally:
process_registry.kill_process(slow_id)