Skip to content

HarnessRouter Community Edition: the self-hosted, Apache-2.0 edition of the unified interface for agent harnesses. Run Codex, Claude Code, Hermes, PI, DSH, and more through one API, with sessions, streaming, files, cancellation, and failure handling. Implements the Unified Harness Protocol (UHP), an open standard. Your keys, your infrastructure.

The loopback relay's base carries its API version (#86)

github-actions[bot]5827e4123d97
diff --git a/runner/server.py b/runner/server.py
index 2f75a473..119ac683 100644
--- a/runner/server.py
+++ b/runner/server.py
@@ -2465,6 +2465,14 @@ def _adapt_custom_auth(auth):
return auth.model_copy(update={"base_url": base, "api_key": tok})
+def _relay_base_with_version(base_url: str) -> str:
+ """A relay base ends with /v1 unless it is an AWS host or already names an API version."""
+ base = (base_url or "").rstrip("/")
+ if not base or ".amazonaws.com" in base or re.search(r"/v\d+[a-z]*(/|$)", base): # /v1, /v1beta/openai
+ return base
+ return base + "/v1"
+
+
def _hermes_relay_route(base_url: str, api_key: str) -> tuple[str, str]:
"""Register one turn's upstream; → (relay base_url, placeholder bearer for the CLI)."""
with _HERMES_RELAY["lock"]:
@@ -2473,7 +2481,13 @@ def _hermes_relay_route(base_url: str, api_key: str) -> tuple[str, str]:
threading.Thread(target=srv.serve_forever, daemon=True).start()
_HERMES_RELAY["server"], _HERMES_RELAY["port"] = srv, srv.server_address[1]
tok = "hr-relay-" + uuid.uuid4().hex
- _HERMES_RELAY["routes"][tok] = (base_url, api_key, {"rename_max_tokens": False})
+ # The relay joins the client's resource ("/chat/completions", "/messages") onto this base,
+ # so the base must carry its "/v1" the way every aggregator's does. A direct Anthropic key
+ # stored with the catalog's former default https://api.anthropic.com sent cline and qwen to
+ # https://api.anthropic.com/chat/completions, a 404 with no body (2026-09-06 support
+ # matrix; Anthropic's OpenAI-compatible surface lives under /v1). Bedrock keeps its host
+ # (its own path is built in _bedrock_anthropic).
+ _HERMES_RELAY["routes"][tok] = (_relay_base_with_version(base_url), api_key, {"rename_max_tokens": False})
return f"http://127.0.0.1:{_HERMES_RELAY['port']}/v1", tok
diff --git a/runner/tests/test_relay_base_version.py b/runner/tests/test_relay_base_version.py
new file mode 100644
index 00000000..a4091c3c
--- /dev/null
+++ b/runner/tests/test_relay_base_version.py
@@ -0,0 +1,24 @@
+"""The loopback relay joins the client's resource onto a base that carries its API version."""
+import pathlib
+import sys
+
+sys.path.insert(0, str(pathlib.Path(__file__).resolve().parents[1]))
+import server # noqa: E402
+
+
+def test_a_bare_anthropic_base_gets_v1():
+ assert server._relay_base_with_version("https://api.anthropic.com") == "https://api.anthropic.com/v1"
+
+
+def test_a_versioned_base_is_kept():
+ assert server._relay_base_with_version("https://api.tokenrouter.com/v1/") == "https://api.tokenrouter.com/v1"
+ assert server._relay_base_with_version("https://generativelanguage.googleapis.com/v1beta/openai") == "https://generativelanguage.googleapis.com/v1beta/openai"
+
+
+def test_an_aws_host_keeps_its_own_path():
+ assert server._relay_base_with_version("https://bedrock-runtime.us-east-1.amazonaws.com") == "https://bedrock-runtime.us-east-1.amazonaws.com"
+
+
+def test_the_route_stores_the_versioned_base():
+ base, tok = server._hermes_relay_route("https://api.anthropic.com", "k")
+ assert server._HERMES_RELAY["routes"][tok][0] == "https://api.anthropic.com/v1" and base.endswith("/v1")