The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
"""Entrypoint drivers for the parity matrix: CLI subprocess entrypoints.
Driver contract (every ``_drive_*.py`` module follows it)::
def drive(ph: ParityHome, srv: FakeLLMServer, prompt: str) -> DriveResult
* spawn the REAL entrypoint with ``ph.env()`` (hermetic fake HOME, no real
credentials) — cwd ``ph.project`` unless the surface documents another cwd
channel (then use that channel and say so in ``DriveResult.cwd_channel``);
* run exactly ONE user turn with ``prompt`` against ``srv`` (the scripted
responder makes the model call the MCP canary tool, then answer
``FINAL_ANSWER``);
* return what the surface delivered to ITS client in ``final_text``;
* stop the entrypoint through its NORMAL shutdown path (exit, stdin EOF,
SIGTERM, RPC) before returning; never SIGKILL except as a last resort after a
bounded graceful wait (and then report it via ``graceful_exit=False``).
``hermes -z`` and ``hermes chat -q`` are thin clients of the unified gateway
runtime: the turn runs in the profile's ``gateway run`` daemon (spawned on first
connect), which outlives the client by design. Their normal shutdown is therefore
client exit + ``hermes gateway stop`` (``stop_profile_gateway``).
"""
from __future__ import annotations
import subprocess
from tests.e2e.core.parity._helpers import (
TURN_TIMEOUT,
DriveResult,
ParityHome,
hermes_argv,
stop_profile_gateway,
)
from tests.fakes.fake_llm_provider import FakeLLMServer
def _run_cli(ph: ParityHome, *args: str) -> subprocess.CompletedProcess:
return subprocess.run(
hermes_argv(*args), cwd=ph.project, env=ph.env(), capture_output=True, text=True,
timeout=TURN_TIMEOUT, stdin=subprocess.DEVNULL,
check=False,
)
def _client_turn(ph: ParityHome, label: str, *args: str) -> DriveResult:
proc = _run_cli(ph, *args)
try:
assert proc.returncode == 0, f"{label} exited {proc.returncode}: {proc.stderr[-2000:]}"
finally:
# The daemon is the surface's process; a failed client still leaves it to stop.
stopped = stop_profile_gateway(ph)
return DriveResult(
final_text=proc.stdout.strip(), toolset="hermes-cli", graceful_exit=stopped,
extra={"exit_code": proc.returncode, "stderr_tail": proc.stderr[-2000:], "gateway_stopped": stopped},
)
def drive_oneshot(ph: ParityHome, srv: FakeLLMServer, prompt: str) -> DriveResult:
return _client_turn(ph, "hermes -z", "-z", prompt)
def drive_chat_q(ph: ParityHome, srv: FakeLLMServer, prompt: str) -> DriveResult:
return _client_turn(ph, "hermes chat -q", "chat", "-q", prompt, "-Q")