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.
Python agent-apiagent-frameworkagent-harnessai-agentsai-infrastructurecoding-agentconformance-testingdeepseek-harnessharness-engineeringhermesllmopen-protocolopen-sourceopen-standardpi-coding-agentself-hosteduhpunified-apiunified-harness-protocolunified-interface
CheetahClaws: streamable HTTP through the bridge, the mark from its logo, the column measured here (#287)
github-actions[bot]c8457627ed1e
diff --git a/NOTICE b/NOTICEindex 8d981409..0b62927f 100644--- a/NOTICE+++ b/NOTICE@@ -41,9 +41,9 @@ run, by you, under their own licenses:hermes-agent MIT (License-Expression declared by the publisher since 0.19.0)cheetahclaws Apache-2.0 — "CheetahClaws, Copyright 2026 SAIL Lab at UC Berkeley"(SAIL-Research-Lab/cheetahclaws; its NOTICE ships in the wheel). The- console's CheetahClaws mark, ui/public/logos/cheetahclaws.png, is that- project's app icon (cheetahclaws/web/static/favicon.png), included- unmodified under the same license.+ console's CheetahClaws mark, ui/public/logos/cheetahclaws.png, is the+ head of that project's logo (docs/media/logos/logo-5.png in its+ repository), cropped to a square, under the same license.Claude Code is distributed under Anthropic's terms and may not be redistributed inside apublic image; hermes-agent's publisher declared no license before 0.19.0. Installing thediff --git a/docs/support-matrix-notes.md b/docs/support-matrix-notes.mdindex 4f7164bc..a2282145 100644--- a/docs/support-matrix-notes.md+++ b/docs/support-matrix-notes.md@@ -1420,32 +1420,33 @@ driven in process and every event is re-emitted as it is yielded, `__hr_init` fi### Versions and the column-Measured on a self-hosted instance built from this branch (main at d54ebf8 plus the change,-default build arguments), one container, `HR_BACKENDS=cheetahclaws`, a fresh volume; CheetahClaws-3.5.88 installed by the entrypoint (wheel digest verified, import check passed, `pip check` clean).-One `custom` connection in the OpenAI format to an OpenAI-compatible gateway whose model ids are-pool aliases, each routed over several upstream models with fallbacks between pools; the three-aliases it serves are the column's models. The instance has no egress beyond that gateway, so the-public MCP probe was not reachable.--- **Conformance** (`uhp-conformance` 2026.9.12.post2 from this tree, `--class full`, tools-pool):- 75/75, CONFORMANT (full).-- **Console column** `cheetahclaws-custom`, two passes of the five scenarios on each alias; the table- keeps the second and the first try in its notes. tools-pool 5/5 (the first pass missed the recall- by answering "Thought process"). fast-pool and coder-pool answer the recall with `M-<alias>` or- the previous turn's `DONE`: their histories were intact (same session file before and after the- recycle, and the same scenario through the API recalled M1 on tools-pool), so this is the- recall of the small models behind those aliases. coder-pool's artifact turn wrote no file in one- of two passes. The rows marked "served as" are the gateway's fallback between its own pools,- which rule 2 rightly counts as a substitution.-- **Custom harness** (`custom-harness.mjs`, `MCP_URL=off`, the base's default id mapped to- tools-pool on the connection): the stamp skill read, its script run from the workspace,- `stamp.txt` produced, WebSearch withheld and unused, 15 s. One earlier run had no settled turn in- the script's 420 s window; not reproduced, cause not established.-- **Plugin matrix** (`plugins/run-matrix.py`, tools-pool): skills 1/1, stdio MCP 1/1- (`PLUGIN_MCP_OK`, through the CLI's own MCP client). The SSE and streamable-HTTP columns need the- public probe and were not run.-- **Not measured here:** the hosted provider columns (OpenRouter, TokenRouter, Vercel, the hosted- HarnessRouter API), so `_MODEL_CATALOG["cheetahclaws"]` is offered, not measured; and a benchmark- column.+The column in `docs/support-matrix.md` is `cheetahclaws-tokenrouter`, measured on hr-test+(harnessrouter/harnessrouter:0.25.0, the release that carries this base; one container, the default+`HR_BACKENDS`, the live data volume) on 2026-09-27, after the author's own measurements on a lab+gateway (kept in the PR, #264). CheetahClaws 3.5.88 was installed by the entrypoint at boot (wheel+digest verified, import check passed). The instance's own connections served the turns: TokenRouter+for gpt-5.4 and claude-sonnet-5, and gpt-5.4-mini through the Custom OpenAI Chat connection with+TokenRouter behind the switch, as `fill-connection.py` stamped them.++- **Conformance** (`uhp-conformance` 2026.9.12.post2 from this tree, `--class full`, a harness on+ the base with `--model gpt-5.4`): 75/75, CONFORMANT (full).+- **Console column** (`run.mjs`, `HARNESSES=cheetahclaws`, three models): 3 pairs, 15 of 15+ scenario runs passed, first turn to recycle. Two rows are served as the provider's dated alias of+ the id asked for (`gpt-5.4-2026-03-05`, `gpt-5.4-mini-2026-03-17`), which the table notes and+ rule 2 does not count against the pair.+- **Custom harness** (`custom-harness.mjs`, `BASES=cheetahclaws`, the public MCP probe reachable+ from hr-test): the stamp skill read, its script run from the workspace, `stamp.txt` produced,+ WebSearch withheld and unused, MCP reached, 28 s.+- **Plugin matrix** (`plugins/run-matrix.py --bases cheetahclaws --mode all`): skills 1/1, stdio+ MCP 1/1, SSE 1/1 through the CLI's own client. Streamable HTTP 0/1 on 0.25.0: the CLI's own+ streamable-HTTP client (`mcp_client/client.py`, `HttpTransport`) is answered 400 on `initialize`+ by the probe, the same server its SSE end and the runner's bridge reach, so the turn ran without+ the server and said so. Since 0.25.1 a streamable-HTTP server reaches this base through the+ runner's stdio bridge (`_BRIDGED_TRANSPORTS`, the mechanism codex, dsh and goose use for SSE),+ the way every other base reaches it; the CLI's client keeps SSE and stdio.+- **In the browser** (the console on hr-test, the system harness, gpt-5.4): a task that writes a+ file and runs a command completed in 15 s with the file card and the byte count in the answer.+- **Not measured here:** the other provider columns (OpenRouter, Vercel, the hosted HarnessRouter+ API) beyond the three pairs above, so `_MODEL_CATALOG["cheetahclaws"]` stays offered, not+ measured, for the rest of its list; and a benchmark column.diff --git a/docs/support-matrix.md b/docs/support-matrix.mdindex 52461805..e308b7b4 100644--- a/docs/support-matrix.md+++ b/docs/support-matrix.md@@ -216,20 +216,60 @@ Not run in this column, 8 pairs the provider serves that the harness did not run- pi x gpt-6-astra: not run, not run in this column- qwen x gpt-6-astra: not run, the model answers on the Responses API only and this harness speaks chat/completions only-## Provider: cheetahclaws-custom+## Provider: cheetahclaws-tokenrouter| Harness | Model | First | Follow-up | Switch | Artifact | Recycle | Served by | Notes ||---|---|---|---|---|---|---|---|---|-| cheetahclaws | coder-pool | pass | pass | pass (tools-pool) | FAIL | FAIL | lab-chat | served as fast-pool, local-floor (finding below) ; artifact: no file card (files: none); Create a file named hello-cheetahclaws.txt containing exactly the word HELLO, then reply DONE. CHEETAHCLAWS ; recycle: answered without M1-coder-pool: What exact word did I ask you to reply with in my very first message of this task? Reply with just that word ; retested once; first try: recycle answered without M1-coder-pool: What exact word did I ask you to reply with in m |-| cheetahclaws | fast-pool | pass | pass | pass (tools-pool) | pass | FAIL | lab-chat | served as local-floor (finding below) ; recycle: answered without M1-fast-pool: What exact word did I ask you to reply with in my very first message of this task? Reply with just that word. ; retested once; first try: artifact no file card (files: none); Create a file named hello-cheetahclaws.txt containin; recycle answered without M1-fast-pool: What exact word did I ask you to reply with in my |-| cheetahclaws | tools-pool | pass | pass | pass (fast-pool) | pass | pass | lab-chat | retested once; first try: recycle answered without M1-tools-pool: What exact word did I ask you to reply with in m |--3 pairs, 5 of 5 scenario runs passed; 2 pairs served by another connection or as another model are findings, not counted.--Findings, pairs served by a connection other than the one under test or as a model other than the id asked for:--- cheetahclaws x coder-pool: served as fast-pool, local-floor (the CLI reports the model it ran)-- cheetahclaws x fast-pool: served as local-floor (the CLI reports the model it ran)+| cheetahclaws | claude-sonnet-5 | pass | pass | pass (gpt-5.6-sol) | pass | pass | My TokenRouter | |+| cheetahclaws | gpt-5.4 | pass | pass | pass (gpt-5.6-sol) | pass | pass | My TokenRouter | served as gpt-5.4-2026-03-05 (the provider's alias of the same model) |+| cheetahclaws | gpt-5.4-mini | pass | pass | pass (gpt-5.6-sol) | pass | pass | Custom OpenAI Chat, My TokenRouter | served as gpt-5.4-mini-2026-03-17 (the provider's alias of the same model) |++3 pairs, 15 of 15 scenario runs passed.++Not run in this column, 42 pairs the provider serves that the harness did not run, with the reason:++- cheetahclaws x claude-fable-5: not run, not run in this column+- cheetahclaws x claude-fable-5-1: not run, not run in this column+- cheetahclaws x claude-haiku-4.5: not run, not run in this column+- cheetahclaws x claude-opus-4.7: not run, not run in this column+- cheetahclaws x claude-opus-4.8: not run, not run in this column+- cheetahclaws x claude-opus-5: not run, not run in this column+- cheetahclaws x claude-sonnet-4.6: not run, not run in this column+- cheetahclaws x deepseek-v4-flash: not run, not run in this column+- cheetahclaws x deepseek-v4-pro: not run, not run in this column+- cheetahclaws x deepseek-v4.1-flash: not run, not run in this column+- cheetahclaws x gemini-3-flash-preview: not run, not run in this column+- cheetahclaws x gemini-3.1-pro-preview: not run, not run in this column+- cheetahclaws x gemini-3.5-flash: not run, not run in this column+- cheetahclaws x gemini-3.5-flash-lite: not run, not run in this column+- cheetahclaws x gemini-3.6-flash: not run, not run in this column+- cheetahclaws x gemini-3.7-flash: not run, not run in this column+- cheetahclaws x gemini-3.8-flash: not run, not run in this column+- cheetahclaws x glm-5.3: not run, not run in this column+- cheetahclaws x glm-5.3-flash: not run, not run in this column+- cheetahclaws x gpt-5.2: not run, not run in this column+- cheetahclaws x gpt-5.3-codex: not run, the model answers on the Responses API only and this harness speaks chat/completions only+- cheetahclaws x gpt-5.5: not run, not run in this column+- cheetahclaws x gpt-5.6-luna: not run, not run in this column+- cheetahclaws x gpt-5.6-sol: not run, not run in this column+- cheetahclaws x gpt-5.6-terra: not run, not run in this column+- cheetahclaws x gpt-6-astra: not run, the model answers on the Responses API only and this harness speaks chat/completions only+- cheetahclaws x grok-4.20: not run, not run in this column+- cheetahclaws x grok-4.3: not run, not run in this column+- cheetahclaws x grok-4.5: not run, not run in this column+- cheetahclaws x grok-4.6: not run, not run in this column+- cheetahclaws x grok-build-0.1: not run, not run in this column+- cheetahclaws x hunyuan-4-preview: not run, not run in this column+- cheetahclaws x kimi-k2.7-code: not run, not run in this column+- cheetahclaws x kimi-k3: not run, not run in this column+- cheetahclaws x mistral-medium-3.5: not run, not run in this column+- cheetahclaws x nemotron-3-super: not run, not run in this column+- cheetahclaws x nemotron-3.5-lightning: not run, not run in this column+- cheetahclaws x qwen3.7-max: not run, not run in this column+- cheetahclaws x qwen3.7-plus: not run, not run in this column+- cheetahclaws x qwen3.8-flash: not run, not run in this column+- cheetahclaws x qwen3.8-max: not run, not run in this column+- cheetahclaws x step-3.7-flash: not run, not run in this column## Provider: codex-azure-e2diff --git a/runner/server.py b/runner/server.pyindex de46eebe..fc6a9b1b 100644--- a/runner/server.py+++ b/runner/server.py@@ -1161,26 +1161,32 @@ _PLUGIN_PLACEHOLDER = re.compile(r"\$\{PLUGIN_(ROOT|DATA)\}")_ENV_NAME = re.compile(r"^[A-Za-z_][A-Za-z0-9_]*$")-# Clients without a remote transport of their own: goose 1.50.0's ExtensionConfig has no sse-# variant, dsh-mcp-client's config is a union of stdio and streamable-http, and codex's client-# takes streamable HTTP and stdio. Every one of them launches a stdio server, so the runner hands-# them the bridge (mcp_bridge.py) as one, and the bridge speaks SSE to the remote end. The server-# reaches the agent on every base the same way; nothing is declared unsupported.-_NO_SSE_BACKENDS = {"codex", "dsh", "goose"}+# Remote transports a client cannot reach on its own, by backend: goose 1.50.0's ExtensionConfig+# has no sse variant, dsh-mcp-client's config is a union of stdio and streamable-http, codex's+# client takes streamable HTTP and stdio, and CheetahClaws 3.5.88's own streamable-HTTP client is+# answered 400 on initialize by a standard server (the public probe; its SSE and stdio work).+# Every one of them launches a stdio server, so the runner hands them the bridge (mcp_bridge.py)+# as one, and the bridge speaks the remote transport with the reference SDK. The server reaches+# the agent on every base the same way; nothing is declared unsupported.+_BRIDGED_TRANSPORTS = {"codex": ("sse",), "dsh": ("sse",), "goose": ("sse",), "cheetahclaws": ("http",)}_MCP_BRIDGE = os.path.join(os.path.dirname(os.path.abspath(__file__)), "mcp_bridge.py")def _sse_bridges(cwd: str, servers: list[dict] | None, backend: str) -> list[dict]:- """Each SSE server, for a backend whose client cannot speak SSE, becomes a stdio launcher that- runs the bridge with the url and headers in its environment (never on the command line, where- a ps listing would show an Authorization header). Other servers and backends pass untouched."""- if backend not in _NO_SSE_BACKENDS:+ """Each remote server whose transport this backend's client cannot reach becomes a stdio+ launcher that runs the bridge with the url, the transport and the headers in its environment+ (never on the command line, where a ps listing would show an Authorization header). A url+ without a transport is streamable HTTP, as everywhere else in this file. Other servers and+ backends pass untouched."""+ bridged = _BRIDGED_TRANSPORTS.get(backend)+ if not bridged:return list(servers or [])out: list[dict] = []for s in servers or []:s = s or {}url = str(s.get("url") or "").strip()- if not url or str(s.get("transport") or "").lower() != "sse":+ transport = str(s.get("transport") or "http").lower()+ if not url or transport not in bridged:out.append(s)continuename = _mcp_name(str(s.get("name") or s.get("id") or "mcp"))@@ -1193,8 +1199,8 @@ def _sse_bridges(cwd: str, servers: list[dict] | None, backend: str) -> list[dicbdir = pathlib.Path(_safe_join(cwd, ".harness/mcp-bridge"))bdir.mkdir(parents=True, exist_ok=True)launcher = bdir / f"{name}.sh"- lines = ["#!/bin/sh", "# written by the harness runner: this client has no SSE transport, so the bridge speaks it over stdio",- f"export HR_MCP_URL={shlex.quote(url)}", "export HR_MCP_TRANSPORT=sse",+ lines = ["#!/bin/sh", f"# written by the harness runner: this client cannot reach a {transport} server, so the bridge speaks it over stdio",+ f"export HR_MCP_URL={shlex.quote(url)}", f"export HR_MCP_TRANSPORT={transport}",f"export HR_MCP_HEADERS={shlex.quote(json.dumps(headers))}",f"exec python3 {shlex.quote(_MCP_BRIDGE)}", ""]if launcher.is_symlink() or (launcher.exists() and not launcher.is_file()):diff --git a/runner/tests/test_uhp_plugins.py b/runner/tests/test_uhp_plugins.pyindex f4d3d84d..1db01557 100644--- a/runner/tests/test_uhp_plugins.py+++ b/runner/tests/test_uhp_plugins.py@@ -210,6 +210,17 @@ def test_a_client_without_sse_gets_the_server_through_the_stdio_bridge(tmp_path)# the writers then see a stdio entry, as for any plugin serverext = rn._goose_extensions(rn._sse_bridges(str(tmp_path), [sse, http], "goose"), None)assert ext["probe_sse"]["type"] == "stdio" and ext["probe_http"]["type"] == "streamable_http"+ # the other way round for CheetahClaws 3.5.88: its client speaks SSE and stdio, and its own+ # streamable-HTTP client is answered 400 on initialize by a standard server (the public probe,+ # 2026-09-27), so the streamable-HTTP server is the one that rides the bridge; a url with no+ # transport is streamable HTTP too+ bare = {"name": "probe_bare", "url": "https://probe.example.invalid/mcp"}+ out = rn._sse_bridges(str(tmp_path), [sse, http, bare], "cheetahclaws")+ assert out[0] == sse+ for b, u in ((out[1], "https://probe.example.invalid/mcp"), (out[2], "https://probe.example.invalid/mcp")):+ assert "url" not in b and b["args"] == []+ text = pathlib.Path(b["command"]).read_text()+ assert f"HR_MCP_URL={u}" in text and "HR_MCP_TRANSPORT=http" in textdef test_dsh_job_keeps_a_stdio_server(tmp_path):"""_build_dsh hands the driver a job whose server list kept only urls, from before plugins:diff --git a/ui/public/logos/cheetahclaws.png b/ui/public/logos/cheetahclaws.pngindex 2df7e52c..1b47cf3f 100644Binary files a/ui/public/logos/cheetahclaws.png and b/ui/public/logos/cheetahclaws.png differdiff --git a/ui/src/components/HarnessLogo.tsx b/ui/src/components/HarnessLogo.tsxindex 6d166d74..6f4495cd 100644--- a/ui/src/components/HarnessLogo.tsx+++ b/ui/src/components/HarnessLogo.tsx@@ -19,7 +19,7 @@ const LOGO: Record<string, string> = {kimi: '/logos/kimi.png', // the official Kimi mark (the K app icon from kimi.ai/code), supplied by Richard 2026-09-17aider: '/logos/aider.png', // aider's own app icon (aider.chat/assets/icons/apple-touch-icon.png, from the Apache-2.0 repo's website assets)openhands: '/logos/openhands.png', // OpenHands' own app icon (public/apple-touch-icon.png in the MIT OpenHands/OpenHands repository)- cheetahclaws: '/logos/cheetahclaws.png', // CheetahClaws' own app icon (cheetahclaws/web/static/favicon.png in the Apache-2.0 SAIL-Research-Lab/cheetahclaws repository, shipped in the 3.5.88 wheel)+ cheetahclaws: '/logos/cheetahclaws.png', // the head and shoulders of CheetahClaws' own logo (docs/media/logos/logo-5.png in the Apache-2.0 SAIL-Research-Lab/cheetahclaws repository), cut square so it reads at 26 px; the app icon drew the whole running cheetah as a thin band and rendered as a sliver (Richard, 2026-09-27)systemone: '/logos/systemone.png', // the System One Harness's own mark (the project has no vendor logo; Jev is TypeSafe's model, not the harness)};