From e3eb9bde0a35cdfe5453ea257a19596848fe5bc3 Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Sun, 1 Nov 2026 04:45:49 -0700 Subject: [PATCH 01/34] fix: stop agents where group signals are denied OpenShell's sandbox denies signals to a process group with EPERM. The OpenClaw adapter let that error escape its stop and left the Gateway running until the sandbox went away, and the ACP runner left the agent process running the same way. Both now signal the child itself when the group signal is denied. The Python adapters share `common.utils.signal_process_group` for this. Not covered here: the Codex adapter's SIGKILL of its app server, which has the same pattern. Signed-off-by: Carlos Villela --- .../src/nemo_fabric_adapters/common/utils.py | 17 +++++++++ .../nemo_fabric_adapters/openclaw/adapter.py | 17 +++------ adapters/typescript/common/src/acp-runner.ts | 10 ++++- .../common/test/acp-runner.test.mjs | 37 +++++++++++++++++-- .../strands/test/strands-acp.test.mjs | 7 ++-- tests/adapters/test_openclaw.py | 25 +++++++++++++ 6 files changed, 94 insertions(+), 19 deletions(-) diff --git a/adapters/python/common/src/nemo_fabric_adapters/common/utils.py b/adapters/python/common/src/nemo_fabric_adapters/common/utils.py index 9878b63e5..c45b6c10f 100644 --- a/adapters/python/common/src/nemo_fabric_adapters/common/utils.py +++ b/adapters/python/common/src/nemo_fabric_adapters/common/utils.py @@ -9,6 +9,7 @@ import json import os import re +import signal import sys import uuid from contextlib import nullcontext @@ -790,3 +791,19 @@ def write_relay_configs( def relay_model_name(payload: dict[str, Any]) -> str: return selected_model_config(payload).get("model") or "unknown" + + +def signal_process_group(pid: int, signum: signal.Signals) -> None: + """Signal a child's process group, or only the child where that's denied. + + OpenShell's sandbox denies signals to a process group with EPERM. + """ + try: + os.killpg(pid, signum) + except ProcessLookupError: + pass + except PermissionError: + try: + os.kill(pid, signum) + except ProcessLookupError: + pass diff --git a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py index 7c616642b..7e082eead 100644 --- a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py +++ b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py @@ -1583,10 +1583,7 @@ def _forward_gateway_signal(self, signum: int) -> None: process = self._process if process is None or process.returncode is not None: return - try: - os.killpg(process.pid, signum) - except ProcessLookupError: - pass + common_utils.signal_process_group(process.pid, signum) async def _wait_started(self, port: int, token: str, timeout: float) -> None: deadline = asyncio.get_running_loop().time() + timeout @@ -1735,10 +1732,7 @@ async def stop(self) -> None: if os.name == "nt": process.terminate() else: - try: - os.killpg(process.pid, signal.SIGTERM) - except ProcessLookupError: - pass + common_utils.signal_process_group(process.pid, signal.SIGTERM) try: await asyncio.wait_for( process.wait(), timeout=self._shutdown_timeout @@ -1749,10 +1743,9 @@ async def stop(self) -> None: if os.name == "nt": process.kill() else: - try: - os.killpg(process.pid, signal.SIGKILL) - except ProcessLookupError: - pass + common_utils.signal_process_group( + process.pid, signal.SIGKILL + ) try: await process.wait() except asyncio.CancelledError as error: diff --git a/adapters/typescript/common/src/acp-runner.ts b/adapters/typescript/common/src/acp-runner.ts index d2dd97a2d..fdfac458c 100644 --- a/adapters/typescript/common/src/acp-runner.ts +++ b/adapters/typescript/common/src/acp-runner.ts @@ -141,7 +141,15 @@ async function terminateProcessTree(child: ChildProcessWithoutNullStreams, timeo try { process.kill(-pid, signal); } catch (error) { - if ((error as NodeJS.ErrnoException).code !== "ESRCH") throw error; + const code = (error as NodeJS.ErrnoException).code; + if (code === "ESRCH") return; + // OpenShell's sandbox denies signals to a process group; signal the agent itself. + if (code !== "EPERM") throw error; + try { + process.kill(pid, signal); + } catch (fallbackError) { + if ((fallbackError as NodeJS.ErrnoException).code !== "ESRCH") throw fallbackError; + } } }; // Each agent has its own process group, including tool and MCP children. diff --git a/adapters/typescript/common/test/acp-runner.test.mjs b/adapters/typescript/common/test/acp-runner.test.mjs index db8da8019..8474c14ed 100644 --- a/adapters/typescript/common/test/acp-runner.test.mjs +++ b/adapters/typescript/common/test/acp-runner.test.mjs @@ -213,10 +213,11 @@ test("retries process-group termination after a failed stop", { skip: process.pl }); const pids = JSON.parse(await readFile(marker, "utf8")); const originalKill = process.kill.bind(process); - let failTermination = true; + // Deny the first stop's group signal and its fallback to the agent itself. + let deniedTerminations = 2; const kill = t.mock.method(process, "kill", (pid, signal) => { - if (pid === -pids.parent && signal === "SIGTERM" && failTermination) { - failTermination = false; + if (Math.abs(pid) === pids.parent && signal === "SIGTERM" && deniedTerminations > 0) { + deniedTerminations -= 1; throw Object.assign(new Error("termination denied"), { code: "EPERM" }); } return originalKill(pid, signal); @@ -252,3 +253,33 @@ test("retries process-group termination after a failed stop", { skip: process.pl } if (cleanupError !== undefined) throw cleanupError; }); + +test("stops the agent where process-group signals are denied", { skip: process.platform === "win32" }, async (t) => { + const directory = await mkdtemp(join(tmpdir(), "fabric-acp-denied-")); + const marker = join(directory, "pids.json"); + const session = await startAcpSession({ + command: process.execPath, + args: [fixture], + cwd: process.cwd(), + env: { ...process.env, TEST_DESCENDANT_MARKER: marker }, + shutdownTimeoutMs: 1_000, + }); + const pids = JSON.parse(await readFile(marker, "utf8")); + const originalKill = process.kill.bind(process); + // OpenShell's sandbox denies every signal to a process group. + const kill = t.mock.method(process, "kill", (pid, signal) => { + if (pid < 0) throw Object.assign(new Error("group signals denied"), { code: "EPERM" }); + return originalKill(pid, signal); + }); + try { + await session.stop(); + await waitForProcessToStop(pids.parent); + } finally { + kill.mock.restore(); + for (const pid of [pids.parent, pids.child]) { + try { originalKill(pid, "SIGKILL"); } catch (error) { + if (error.code !== "ESRCH") throw error; + } + } + } +}); diff --git a/adapters/typescript/strands/test/strands-acp.test.mjs b/adapters/typescript/strands/test/strands-acp.test.mjs index dbdc1f051..36d6d9f80 100644 --- a/adapters/typescript/strands/test/strands-acp.test.mjs +++ b/adapters/typescript/strands/test/strands-acp.test.mjs @@ -212,10 +212,11 @@ test("retains a timed-out runtime session until process cleanup succeeds", { ski const { pid: parent } = JSON.parse(await readFile(input.runtimeContext.environment.env.TEST_STRANDS_STATE, "utf8")); const { pid: child } = JSON.parse(await readFile(descendantState, "utf8")); const originalKill = process.kill.bind(process); - let failTermination = true; + // Deny the first stop's group signal and its fallback to the agent itself. + let deniedTerminations = 2; const kill = t.mock.method(process, "kill", (pid, signal) => { - if (pid === -parent && signal === "SIGTERM" && failTermination) { - failTermination = false; + if (Math.abs(pid) === parent && signal === "SIGTERM" && deniedTerminations > 0) { + deniedTerminations -= 1; throw Object.assign(new Error("termination denied"), { code: "EPERM" }); } return originalKill(pid, signal); diff --git a/tests/adapters/test_openclaw.py b/tests/adapters/test_openclaw.py index ffb1d7c67..f6f344fce 100644 --- a/tests/adapters/test_openclaw.py +++ b/tests/adapters/test_openclaw.py @@ -1323,6 +1323,31 @@ async def test_openclaw_stop_continues_after_cleanup_failures( assert runtime._temp_dir is None +@pytest.mark.skipif(os.name == "nt", reason="Requires POSIX process groups") +async def test_openclaw_stop_ends_the_gateway_where_group_signals_are_denied( + mock_openclaw: Path, tmp_path: Path, monkeypatch: pytest.MonkeyPatch +): + os.environ["FAKE_OPENCLAW_CAPTURE"] = str(tmp_path / "config.json") + runtime = adapter.OpenClawRuntime() + await runtime.start( + { + "config": _config(mock_openclaw), + "runtime_context": _context(tmp_path).to_mapping(), + "base_dir": str(tmp_path), + } + ) + gateway = runtime._process + + # OpenShell's sandbox denies signals to a process group with EPERM. + def deny_group_signals(_pgid: int, _signum: int) -> None: + raise PermissionError(1, "Operation not permitted") + + monkeypatch.setattr(os, "killpg", deny_group_signals) + await runtime.stop() + + assert gateway.returncode is not None + + @pytest.mark.parametrize("phase", ["client", "process", "logs"]) async def test_openclaw_stop_completes_cleanup_before_propagating_cancellation( monkeypatch: pytest.MonkeyPatch, phase: str From 7bb12a1cbb7d43b5c229ee19e9278bf621391254 Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Sun, 1 Nov 2026 04:47:10 -0700 Subject: [PATCH 02/34] fix: bound OpenClaw's whole start by one deadline On busy hosts, such as CI runners starting three agents at once on four vCPUs, the Gateway took close to 40 s to become ready. Each startup step had its own 30 s timeout, so start failed at random and could also run past NeMo Fabric's 90 s start limit. `startup_timeout_seconds` now bounds all of start, from checking the `openclaw` command to the Gateway becoming ready, with a 60 s default. The descriptor caps it at 75 s so start stays within Fabric's limit. OpenClaw 2026.9.34 also starts a background lookup of catalog.openclaw.ai once the Gateway is ready. The adapter already turns off update checks and telemetry, and now sets `models.catalogRefresh.enabled` to false too. Signed-off-by: Carlos Villela --- adapters/python/openclaw/README.md | 2 +- .../openclaw/openclaw.fabric-adapter.json | 5 ++-- .../nemo_fabric_adapters/openclaw/adapter.py | 19 +++++++++----- docs/integrations/harness/openclaw.mdx | 2 +- .../nemo_fabric_adapter_catalog/catalog.json | 7 ++--- tests/_utils/mock_openclaw.py | 3 +++ tests/adapters/test_openclaw.py | 26 +++++++++++++++++++ 7 files changed, 51 insertions(+), 13 deletions(-) diff --git a/adapters/python/openclaw/README.md b/adapters/python/openclaw/README.md index ebdb1f2a3..a8447ddde 100644 --- a/adapters/python/openclaw/README.md +++ b/adapters/python/openclaw/README.md @@ -107,7 +107,7 @@ The following settings are specific to the OpenClaw adapter: | `agent_id` | `default` | OpenClaw agent for NeMo Fabric-originated invocations. | | `channel_config` | None | OpenClaw-native `channels` and `bindings` for a prepared service. Every binding must target `agent_id`. Managed runtimes reject this setting. | | `port_range` | Random available range | Inclusive consumer-allocated range with `start` and `end` fields; it must span at least 111 ports. | -| `startup_timeout_seconds` | `30` | Gateway startup timeout. | +| `startup_timeout_seconds` | `60` | One deadline for all of start, from checking the `openclaw` command to the Gateway becoming ready; at most 75 seconds. | | `shutdown_timeout_seconds` | `5` | Graceful shutdown timeout. | | `connect_timeout_seconds` | `10` | Local HTTP connection timeout. | | `read_timeout_seconds` | None | Local HTTP response timeout. When unset, the invocation timeout bounds the response. | diff --git a/adapters/python/openclaw/openclaw.fabric-adapter.json b/adapters/python/openclaw/openclaw.fabric-adapter.json index 862c01b2d..5d00b0240 100644 --- a/adapters/python/openclaw/openclaw.fabric-adapter.json +++ b/adapters/python/openclaw/openclaw.fabric-adapter.json @@ -67,8 +67,9 @@ "startup_timeout_seconds": { "type": "number", "exclusiveMinimum": 0, - "default": 30, - "description": "Maximum time to wait for the OpenClaw Gateway to become ready." + "maximum": 75, + "default": 60, + "description": "One deadline for all of start, from checking the OpenClaw command to the Gateway becoming ready, within NeMo Fabric's 90-second start limit." }, "shutdown_timeout_seconds": { "type": "number", diff --git a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py index 7e082eead..3b5034248 100644 --- a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py +++ b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py @@ -38,7 +38,7 @@ from nemo_fabric_adapters.openclaw import _windows_job -DEFAULT_STARTUP_TIMEOUT_SECONDS = 30.0 +DEFAULT_STARTUP_TIMEOUT_SECONDS = 60.0 # Fabric gives the adapter host 10 s to stop, including this wait. DEFAULT_SHUTDOWN_TIMEOUT_SECONDS = 5.0 DEFAULT_CONNECT_TIMEOUT_SECONDS = 10.0 @@ -511,6 +511,7 @@ def _openclaw_config( }, "telemetry": {"enabled": False}, "update": {"checkOnStart": False}, + "models": {"catalogRefresh": {"enabled": False}}, "discovery": {"mdns": {"mode": "off"}}, } agent_id = _agent_id(config.harness.settings if config.harness else {}) @@ -556,7 +557,7 @@ def _openclaw_config( "id": model.api_key_env, } if provider: - result["models"] = {"providers": {model.provider: provider}} + result["models"]["providers"] = {model.provider: provider} channel_config = _channel_config( config.harness.settings if config.harness else {}, agent_id=agent_id ) @@ -1084,8 +1085,14 @@ async def start(self, payload: dict[str, Any]) -> dict[str, Any] | None: startup_timeout = _positive_setting( settings, "startup_timeout_seconds", DEFAULT_STARTUP_TIMEOUT_SECONDS ) + # One deadline covers every startup step, so start ends within it. + startup_deadline = asyncio.get_running_loop().time() + startup_timeout + + def startup_remaining() -> float: + return max(startup_deadline - asyncio.get_running_loop().time(), 0.0) + version_output = await _command_output( - command, "--version", env=child_env, timeout=startup_timeout + command, "--version", env=child_env, timeout=startup_remaining() ) version = _validate_openclaw_version(version_output) from nemo_fabric_adapters.common.provenance import record_version @@ -1139,7 +1146,7 @@ async def start(self, payload: dict[str, Any]) -> dict[str, Any] | None: "validate", "--json", env=child_env, - timeout=startup_timeout, + timeout=startup_remaining(), ) if os.name == "nt": try: @@ -1152,7 +1159,7 @@ async def start(self, payload: dict[str, Any]) -> dict[str, Any] | None: gateway_command = _gateway_command( command, port=port, - prefix=await _parent_death_prefix(timeout=startup_timeout), + prefix=await _parent_death_prefix(timeout=startup_remaining()), ) self._process = await asyncio.create_subprocess_exec( *gateway_command, @@ -1179,7 +1186,7 @@ async def start(self, payload: dict[str, Any]) -> dict[str, Any] | None: ), ] self._install_signal_handlers() - await self._wait_started(port, token, startup_timeout) + await self._wait_started(port, token, startup_remaining()) self._client = httpx.AsyncClient( headers={"authorization": f"Bearer {token}"}, http2=True, diff --git a/docs/integrations/harness/openclaw.mdx b/docs/integrations/harness/openclaw.mdx index e33020a46..05add4484 100644 --- a/docs/integrations/harness/openclaw.mdx +++ b/docs/integrations/harness/openclaw.mdx @@ -71,7 +71,7 @@ harness = HarnessConfig( adapter_id="nvidia.fabric.openclaw", settings={ "openclaw_command": "/opt/openclaw/bin/openclaw", - "startup_timeout_seconds": 30, + "startup_timeout_seconds": 60, }, ) ``` diff --git a/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json b/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json index 2d6fc6b90..29b4508fe 100644 --- a/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json +++ b/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json @@ -2091,9 +2091,10 @@ "type": "number" }, "startup_timeout_seconds": { - "default": 30, - "description": "Maximum time to wait for the OpenClaw Gateway to become ready.", + "default": 60, + "description": "One deadline for all of start, from checking the OpenClaw command to the Gateway becoming ready, within NeMo Fabric's 90-second start limit.", "exclusiveMinimum": 0, + "maximum": 75, "type": "number" } }, @@ -2105,7 +2106,7 @@ "name": "nemo-fabric-adapters-openclaw", "version": "0.7.0" }, - "sha256": "bc95c4dfeee7638a490df68073543d8632b1eb7d9957c4874d72dd8522e99c56", + "sha256": "27af873589f481bd85f2e8e5fd32826879d5d1ba1dbdd1ff0c1e1d1298bb5be0", "source": "adapters/python/openclaw/openclaw.fabric-adapter.json" }, "nvidia.fabric.opencode": { diff --git a/tests/_utils/mock_openclaw.py b/tests/_utils/mock_openclaw.py index 7316d9d45..1c8fdeb29 100755 --- a/tests/_utils/mock_openclaw.py +++ b/tests/_utils/mock_openclaw.py @@ -8,10 +8,13 @@ import os import signal import sys +import time from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer args = sys.argv[1:] +if args[:1] != ["gateway"] and (delay := os.environ.get("FAKE_OPENCLAW_COMMAND_DELAY")): + time.sleep(float(delay)) if args == ["--version"]: print("OpenClaw 2026.9.34 (fabric test)") raise SystemExit(0) diff --git a/tests/adapters/test_openclaw.py b/tests/adapters/test_openclaw.py index f6f344fce..427cd0cd0 100644 --- a/tests/adapters/test_openclaw.py +++ b/tests/adapters/test_openclaw.py @@ -481,6 +481,8 @@ async def test_openclaw_runtime_generates_config_invokes_and_cleans_up( assert generated["mcp"]["servers"]["local"]["command"] == "python" assert generated["mcp"]["servers"]["remote"]["transport"] == ("streamable-http") assert "auth" not in generated["mcp"]["servers"]["remote"] + # The sandbox would deny OpenClaw's model catalog lookup anyway. + assert generated["models"]["catalogRefresh"] == {"enabled": False} assert not state_root.exists() @@ -1323,6 +1325,30 @@ async def test_openclaw_stop_continues_after_cleanup_failures( assert runtime._temp_dir is None +async def test_openclaw_startup_timeout_bounds_all_of_start( + mock_openclaw: Path, tmp_path: Path, monkeypatch: pytest.MonkeyPatch +): + # Each command finishes within the timeout, but the two together don't. + monkeypatch.setenv("FAKE_OPENCLAW_COMMAND_DELAY", "0.6") + monkeypatch.setenv("FAKE_OPENCLAW_CAPTURE", str(tmp_path / "config.json")) + config = _config(mock_openclaw) + assert config.harness is not None + config.harness.settings["startup_timeout_seconds"] = 1 + runtime = adapter.OpenClawRuntime() + + with pytest.raises(adapter.lifecycle.LifecycleError) as caught: + await runtime.start( + { + "config": config, + "runtime_context": _context(tmp_path).to_mapping(), + "base_dir": str(tmp_path), + } + ) + + assert caught.value.code == "openclaw_command_timeout" + assert runtime._process is None + + @pytest.mark.skipif(os.name == "nt", reason="Requires POSIX process groups") async def test_openclaw_stop_ends_the_gateway_where_group_signals_are_denied( mock_openclaw: Path, tmp_path: Path, monkeypatch: pytest.MonkeyPatch From f638e4422e72a475f2a7611c2aacd5dcb1512918 Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Sun, 1 Nov 2026 04:50:17 -0700 Subject: [PATCH 03/34] feat: serve OpenClaw's Control UI from managed runtimes OpenClaw's Control UI is its browser dashboard and chat. With `harness.settings.interfaces.dashboard.port`, a managed runtime runs the Gateway on that exact loopback port with the Control UI on, accepting the loopback origins for it. After the Gateway starts, the adapter writes the per-start sign-in token to `/.fabric/openclaw/runtimes//interfaces/dashboard.token` with mode 0600, and `stop` removes it. Prepared and attached services reject interfaces. The descriptor's schema validates the settings, including that a dashboard port can't be combined with `port_range`; the adapter doesn't repeat those checks. The atomic owner-only file write that the service connection file already used moves to `common.local_interfaces` so the token file can share it. Left for later: extra browser origins beyond loopback, and checking on Linux that the Gateway itself owns the port. Signed-off-by: Carlos Villela --- .../common/local_interfaces.py | 35 +++++ adapters/python/openclaw/README.md | 1 + .../openclaw/openclaw.fabric-adapter.json | 29 ++++ .../nemo_fabric_adapters/openclaw/adapter.py | 92 ++++++++--- docs/integrations/harness/openclaw.mdx | 37 +++++ .../nemo_fabric_adapter_catalog/catalog.json | 41 ++++- tests/adapters/test_openclaw.py | 148 ++++++++++++++++++ 7 files changed, 359 insertions(+), 24 deletions(-) create mode 100644 adapters/python/common/src/nemo_fabric_adapters/common/local_interfaces.py diff --git a/adapters/python/common/src/nemo_fabric_adapters/common/local_interfaces.py b/adapters/python/common/src/nemo_fabric_adapters/common/local_interfaces.py new file mode 100644 index 000000000..a8e30575d --- /dev/null +++ b/adapters/python/common/src/nemo_fabric_adapters/common/local_interfaces.py @@ -0,0 +1,35 @@ +# SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved. +# SPDX-License-Identifier: Apache-2.0 + +"""Helpers for native interfaces that an adapter serves on loopback.""" + +from __future__ import annotations + +import os +import tempfile +from pathlib import Path + + +def write_private_file(path: Path, payload: str) -> None: + """Atomically write an owner-only file in an owner-only directory.""" + path.parent.mkdir(parents=True, exist_ok=True, mode=0o700) + os.chmod(path.parent, 0o700) + descriptor, temporary_name = tempfile.mkstemp( + dir=path.parent, + prefix=f".{path.name}.", + ) + try: + if hasattr(os, "fchmod"): + os.fchmod(descriptor, 0o600) + with os.fdopen(descriptor, "w", encoding="utf-8") as stream: + descriptor = -1 + stream.write(payload) + os.replace(temporary_name, path) + except BaseException: + if descriptor >= 0: + os.close(descriptor) + try: + os.unlink(temporary_name) + except FileNotFoundError: + pass + raise diff --git a/adapters/python/openclaw/README.md b/adapters/python/openclaw/README.md index a8447ddde..b7df6522c 100644 --- a/adapters/python/openclaw/README.md +++ b/adapters/python/openclaw/README.md @@ -107,6 +107,7 @@ The following settings are specific to the OpenClaw adapter: | `agent_id` | `default` | OpenClaw agent for NeMo Fabric-originated invocations. | | `channel_config` | None | OpenClaw-native `channels` and `bindings` for a prepared service. Every binding must target `agent_id`. Managed runtimes reject this setting. | | `port_range` | Random available range | Inclusive consumer-allocated range with `start` and `end` fields; it must span at least 111 ports. | +| `interfaces.dashboard` | None | Serve the Control UI on a managed runtime, with an exact `port` and optional `enabled`; see [Serve the Control UI](../../../docs/integrations/harness/openclaw.mdx#serve-the-control-ui). | | `startup_timeout_seconds` | `60` | One deadline for all of start, from checking the `openclaw` command to the Gateway becoming ready; at most 75 seconds. | | `shutdown_timeout_seconds` | `5` | Graceful shutdown timeout. | | `connect_timeout_seconds` | `10` | Local HTTP connection timeout. | diff --git a/adapters/python/openclaw/openclaw.fabric-adapter.json b/adapters/python/openclaw/openclaw.fabric-adapter.json index 5d00b0240..cfc9419f4 100644 --- a/adapters/python/openclaw/openclaw.fabric-adapter.json +++ b/adapters/python/openclaw/openclaw.fabric-adapter.json @@ -64,6 +64,32 @@ "additionalProperties": false, "description": "Inclusive consumer-allocated port range. The adapter selects a Gateway base port whose complete derived footprint through base + 110 fits within the range. When omitted, the adapter selects an available local range." }, + "interfaces": { + "type": "object", + "properties": { + "dashboard": { + "type": "object", + "properties": { + "enabled": { + "type": "boolean", + "default": true, + "description": "Serve the Control UI. A present dashboard is on unless this is false." + }, + "port": { + "type": "integer", + "minimum": 1, + "maximum": 65425, + "description": "Exact loopback Gateway base port, which serves the Control UI. Start fails if it or port + 2 is in use, and OpenClaw reserves ports through port + 110. Can't be combined with port_range." + } + }, + "required": ["port"], + "additionalProperties": false, + "description": "OpenClaw's Control UI. After the Gateway starts, the adapter writes its sign-in token to /.fabric/openclaw/runtimes//interfaces/dashboard.token." + } + }, + "additionalProperties": false, + "description": "Native interfaces served by a managed runtime. Services reject interfaces." + }, "startup_timeout_seconds": { "type": "number", "exclusiveMinimum": 0, @@ -89,6 +115,9 @@ "description": "Timeout between response bytes from the local OpenClaw Gateway. When unset, the invocation timeout bounds the response." } }, + "dependentSchemas": { + "port_range": {"properties": {"interfaces": {"properties": {"dashboard": false}}}} + }, "additionalProperties": false }, "model_schema": { diff --git a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py index 3b5034248..908652262 100644 --- a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py +++ b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py @@ -7,6 +7,7 @@ from __future__ import annotations import asyncio +import contextlib import copy import ipaddress import json @@ -33,6 +34,7 @@ from nemo_fabric_adapter_contract import models as contract from nemo_fabric_adapters.common import instructions as common_instructions from nemo_fabric_adapters.common import lifecycle +from nemo_fabric_adapters.common import local_interfaces from nemo_fabric_adapters.common import openai_chat from nemo_fabric_adapters.common import utils as common_utils from nemo_fabric_adapters.openclaw import _windows_job @@ -160,6 +162,31 @@ def _positive_setting(settings: dict[str, Any], name: str, default: float) -> fl return float(value) +def _dashboard_port(settings: dict[str, Any]) -> int | None: + """Return the Control UI's port when the settings enable it. + + The descriptor's schema has already checked the settings. + """ + dashboard = settings.get("interfaces", {}).get("dashboard") + if dashboard is None or not dashboard.get("enabled", True): + return None + return dashboard["port"] + + +def _dashboard_token_path(context: contract.RuntimeContext, base_dir: Path) -> Path: + root = context.artifacts.root + artifact_root = (base_dir / str(root)).resolve() if root else base_dir / "artifacts" + return ( + artifact_root + / ".fabric" + / "openclaw" + / "runtimes" + / context.runtime_id + / "interfaces" + / "dashboard.token" + ) + + def _agent_id(settings: dict[str, Any]) -> str: value = settings.get("agent_id", "default") if not isinstance(value, str) or not value.strip(): @@ -461,6 +488,7 @@ def _openclaw_config( port: int, token_env: str, service_mode: bool = False, + dashboard: bool = False, ) -> dict[str, Any]: model = _selected_model(config) model_id = _model_id(model) @@ -493,7 +521,15 @@ def _openclaw_config( "mode": "token", "token": {"source": "env", "provider": "default", "id": token_env}, }, - "controlUi": {"enabled": False}, + "controlUi": { + "enabled": True, + "allowedOrigins": [ + f"http://127.0.0.1:{port}", + f"http://localhost:{port}", + ], + } + if dashboard + else {"enabled": False}, "http": {"endpoints": {"chatCompletions": {"enabled": True}}}, }, "agents": { @@ -782,8 +818,6 @@ def _write_service_connection( token: str, agent_id: str, ) -> None: - path.parent.mkdir(parents=True, exist_ok=True, mode=0o700) - os.chmod(path.parent, 0o700) payload = ( json.dumps( { @@ -794,25 +828,7 @@ def _write_service_connection( ) + "\n" ) - descriptor, temporary_name = tempfile.mkstemp( - dir=path.parent, - prefix=f".{path.name}.", - ) - try: - if hasattr(os, "fchmod"): - os.fchmod(descriptor, 0o600) - with os.fdopen(descriptor, "w", encoding="utf-8") as stream: - descriptor = -1 - stream.write(payload) - os.replace(temporary_name, path) - except BaseException: - if descriptor >= 0: - os.close(descriptor) - try: - os.unlink(temporary_name) - except FileNotFoundError: - pass - raise + local_interfaces.write_private_file(path, payload) def _read_service_connection(path: Path) -> tuple[str, str, str]: @@ -857,6 +873,7 @@ def __init__(self) -> None: self._temp_dir: tempfile.TemporaryDirectory[str] | None = None self._port: int | None = None self._token: str | None = None + self._dashboard_token_path: Path | None = None self._gateway_url: str | None = None self._agent_id = "default" self._shutdown_timeout = DEFAULT_SHUTDOWN_TIMEOUT_SECONDS @@ -1050,6 +1067,13 @@ async def start(self, payload: dict[str, Any]) -> dict[str, Any] | None: "openclaw_invalid_service_context", "OpenClaw service context must be an object", ) + if service is not None and "interfaces" in settings: + raise lifecycle.LifecycleError( + "openclaw_interfaces_require_managed_runtime", + "OpenClaw interfaces require a managed runtime", + metadata={"field": "harness.settings.interfaces"}, + ) + dashboard_port = _dashboard_port(settings) self._service_host = service is not None and service.get("operation") in { "prepare", "attach", @@ -1106,7 +1130,20 @@ def startup_remaining() -> float: kind="component", ) - port = _select_port(settings) + if dashboard_port is None: + port = _select_port(settings) + else: + port = dashboard_port + for candidate in (port, port + 2): + if not _port_available(candidate): + raise lifecycle.LifecycleError( + "openclaw_interface_port_unavailable", + f"OpenClaw dashboard port {candidate} is already in use", + metadata={ + "field": "harness.settings.interfaces.dashboard.port", + "port": candidate, + }, + ) # Generate a one-time use token for the OpenClaw gateway token = secrets.token_urlsafe(48) @@ -1123,6 +1160,7 @@ def startup_remaining() -> float: port=port, token_env=token_env, service_mode=service is not None and service.get("operation") == "prepare", + dashboard=dashboard_port is not None, ) config_path.write_text(json.dumps(generated, indent=2) + "\n", encoding="utf-8") config_path.chmod(0o600) @@ -1187,6 +1225,10 @@ def startup_remaining() -> float: ] self._install_signal_handlers() await self._wait_started(port, token, startup_remaining()) + if dashboard_port is not None: + token_path = _dashboard_token_path(context, base_dir) + local_interfaces.write_private_file(token_path, token) + self._dashboard_token_path = token_path self._client = httpx.AsyncClient( headers={"authorization": f"Bearer {token}"}, http2=True, @@ -1708,6 +1750,10 @@ async def invoke( async def stop(self) -> None: cancellation: asyncio.CancelledError | None = None self._stopping = True + token_path, self._dashboard_token_path = self._dashboard_token_path, None + if token_path is not None: + with contextlib.suppress(OSError): + token_path.unlink(missing_ok=True) try: self._restore_signal_handlers() except Exception: diff --git a/docs/integrations/harness/openclaw.mdx b/docs/integrations/harness/openclaw.mdx index 05add4484..ce21a3f11 100644 --- a/docs/integrations/harness/openclaw.mdx +++ b/docs/integrations/harness/openclaw.mdx @@ -115,6 +115,43 @@ By default, the adapter chooses an available local port range. Set `port_range` to an inclusive consumer-allocated range with `start` and `end` fields. The range must span at least 111 ports. OpenClaw's [derived-port mapping](https://docs.openclaw.ai/gateway/multiple-gateways#port-mapping-derived) uses `base_port + 2` for browser control and allocates browser CDP ports from `base_port + 11` through `base_port + 110`. The adapter verifies only that `base_port` and `base_port + 2` are available before startup. OpenClaw allocates the CDP ports on demand instead of reserving the complete range, so the adapter cannot guarantee that those ports will still be available when OpenClaw needs them. Keep the configured range reserved for the lifetime of the runtime or service when using OpenClaw browser features. +## Serve the Control UI + +OpenClaw's Control UI is its browser dashboard and chat. A managed runtime +serves it when `harness.settings.interfaces.dashboard` is present: + +```python +from nemo_fabric import HarnessConfig + +harness = HarnessConfig( + adapter_id="nvidia.fabric.openclaw", + settings={"interfaces": {"dashboard": {"port": 18789}}}, +) +``` + +- The Gateway listens on `127.0.0.1` at the dashboard `port`, which serves the + Control UI. `start` fails with `openclaw_interface_port_unavailable` if + `port` or `port + 2` is in use. OpenClaw also uses `port + 10` for its + browser relay and allocates browser CDP ports from `port + 11` through + `port + 110`, so reserve the whole range from `port` through `port + 110`. + `port` can't be combined with `port_range`; set `enabled` to `false` to keep + a configured dashboard off. +- After the Gateway starts, the adapter writes the sign-in token, generated at + each start, to + `/.fabric/openclaw/runtimes//interfaces/dashboard.token` + with mode `0600`. `stop` removes it; if the adapter host is killed, the file + can remain. +- Open `http://127.0.0.1:/#token=` through a forward to that + port to sign in. The Control UI removes the token from the address bar. + OpenClaw 2026.9.34 accepts any loopback origin, such as a forward to a + different local port; the token is still required. +- Processes that run as the runtime's user, including the agent's own tools, + can read the token and reach the port. +- The adapter regenerates OpenClaw's configuration at each start and marks it + read-only, so changes made through the Control UI don't survive a restart. +- Prepared and attached services reject `interfaces` with + `openclaw_interfaces_require_managed_runtime`. + ## Use a Shared Service Call `prepare_service()` to map the normalized `FabricConfig` to diff --git a/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json b/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json index 29b4508fe..ba0937b1e 100644 --- a/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json +++ b/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json @@ -2001,6 +2001,17 @@ "settings_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, + "dependentSchemas": { + "port_range": { + "properties": { + "interfaces": { + "properties": { + "dashboard": false + } + } + } + } + }, "properties": { "agent_id": { "default": "default", @@ -2053,6 +2064,34 @@ "exclusiveMinimum": 0, "type": "number" }, + "interfaces": { + "additionalProperties": false, + "description": "Native interfaces served by a managed runtime. Services reject interfaces.", + "properties": { + "dashboard": { + "additionalProperties": false, + "description": "OpenClaw's Control UI. After the Gateway starts, the adapter writes its sign-in token to /.fabric/openclaw/runtimes//interfaces/dashboard.token.", + "properties": { + "enabled": { + "default": true, + "description": "Serve the Control UI. A present dashboard is on unless this is false.", + "type": "boolean" + }, + "port": { + "description": "Exact loopback Gateway base port, which serves the Control UI. Start fails if it or port + 2 is in use, and OpenClaw reserves ports through port + 110. Can't be combined with port_range.", + "maximum": 65425, + "minimum": 1, + "type": "integer" + } + }, + "required": [ + "port" + ], + "type": "object" + } + }, + "type": "object" + }, "openclaw_command": { "description": "OpenClaw executable name or path. Relative paths containing a directory are resolved from the NeMo Fabric base directory.", "minLength": 1, @@ -2106,7 +2145,7 @@ "name": "nemo-fabric-adapters-openclaw", "version": "0.7.0" }, - "sha256": "27af873589f481bd85f2e8e5fd32826879d5d1ba1dbdd1ff0c1e1d1298bb5be0", + "sha256": "5a90fc71ffd726f09d952162d0fa49e5fcc153a2398c37467815ffafd1ecfd93", "source": "adapters/python/openclaw/openclaw.fabric-adapter.json" }, "nvidia.fabric.opencode": { diff --git a/tests/adapters/test_openclaw.py b/tests/adapters/test_openclaw.py index 427cd0cd0..1a48e6ce2 100644 --- a/tests/adapters/test_openclaw.py +++ b/tests/adapters/test_openclaw.py @@ -11,6 +11,7 @@ import os import shutil import signal +import socket import subprocess import sys import time @@ -98,11 +99,30 @@ def _config(command: Path, *, with_skills: bool = False) -> AgentConfig: ) +def _dashboard_config(command: Path, dashboard: dict[str, object]) -> AgentConfig: + config = _config(command) + assert config.harness is not None + config.harness.settings["interfaces"] = {"dashboard": dashboard} + return config + + +def _dashboard_token(base_dir: Path) -> Path: + return ( + base_dir + / "artifacts/.fabric/openclaw/runtimes/openclaw-runtime/interfaces/dashboard.token" + ) + + @pytest.fixture(name="mock_openclaw") def mock_openclaw_fixture(repo_root: Path) -> Path: return repo_root / "tests/_utils/mock_openclaw.py" +@pytest.fixture(name="dashboard_port") +def dashboard_port_fixture() -> int: + return adapter._select_port({}) + + def test_openclaw_port_availability_checks_one_port( monkeypatch: pytest.MonkeyPatch, ): @@ -183,6 +203,46 @@ def test_openclaw_rejects_invalid_port_range(settings: dict[str, object]): assert caught.value.metadata == {"field": "harness.settings.port_range"} +@pytest.mark.parametrize( + "settings", + [ + pytest.param({"interfaces": {"terminal": {}}}, id="unsupported-interface"), + pytest.param( + {"interfaces": {"dashboard": {"port": 20_000, "token": "x"}}}, + id="unknown-field", + ), + pytest.param({"interfaces": {"dashboard": {}}}, id="missing-port"), + pytest.param({"interfaces": {"dashboard": {"port": 65_426}}}, id="port-too-high"), + pytest.param( + { + "interfaces": {"dashboard": {"port": 20_000}}, + "port_range": {"start": 20_000, "end": 20_200}, + }, + id="port-range-with-dashboard", + ), + pytest.param({"startup_timeout_seconds": 76}, id="startup-timeout-too-long"), + ], +) +def test_openclaw_plan_rejects_invalid_settings( + tmp_path: Path, settings: dict[str, object] +): + config = FabricConfig.from_mapping( + { + "metadata": {"name": "openclaw-interfaces"}, + "harness": { + "adapter_id": "nvidia.fabric.openclaw", + "resolution": "preinstalled", + "settings": settings, + }, + "models": {"default": {"provider": "test", "model": "fabric-echo"}}, + "environment": {"provider": "local", "workspace": "."}, + } + ) + + with pytest.raises(FabricConfigError): + Fabric().plan(config, base_dir=tmp_path) + + @pytest.mark.parametrize("raw", ["2026.9.34 extra", "2026.9.34\nuntrusted suffix"]) async def test_gateway_records_the_same_version_it_validates(monkeypatch, raw): from nemo_fabric_adapters.common import provenance @@ -481,6 +541,8 @@ async def test_openclaw_runtime_generates_config_invokes_and_cleans_up( assert generated["mcp"]["servers"]["local"]["command"] == "python" assert generated["mcp"]["servers"]["remote"]["transport"] == ("streamable-http") assert "auth" not in generated["mcp"]["servers"]["remote"] + assert generated["gateway"]["controlUi"] == {"enabled": False} + assert not (tmp_path / "artifacts").exists() # The sandbox would deny OpenClaw's model catalog lookup anyway. assert generated["models"]["catalogRefresh"] == {"enabled": False} assert not state_root.exists() @@ -1325,6 +1387,92 @@ async def test_openclaw_stop_continues_after_cleanup_failures( assert runtime._temp_dir is None +@pytest.mark.skipif(sys.platform == "win32", reason="Requires POSIX file permissions") +async def test_openclaw_dashboard_serves_control_ui_with_a_token_file( + mock_openclaw: Path, tmp_path: Path, dashboard_port: int +): + capture = tmp_path / "config.json" + os.environ["FAKE_OPENCLAW_CAPTURE"] = str(capture) + token_path = _dashboard_token(tmp_path) + runtime = adapter.OpenClawRuntime() + + await runtime.start( + { + "config": _dashboard_config(mock_openclaw, {"port": dashboard_port}), + "runtime_context": _context(tmp_path).to_mapping(), + "base_dir": str(tmp_path), + } + ) + try: + gateway_token = runtime._token + stored_token = token_path.read_text(encoding="utf-8") + token_mode = token_path.stat().st_mode & 0o777 + directory_mode = token_path.parent.stat().st_mode & 0o777 + finally: + await runtime.stop() + + generated = json.loads(capture.read_text(encoding="utf-8")) + assert generated["gateway"]["port"] == dashboard_port + assert generated["gateway"]["controlUi"] == { + "enabled": True, + "allowedOrigins": [ + f"http://127.0.0.1:{dashboard_port}", + f"http://localhost:{dashboard_port}", + ], + } + assert stored_token == gateway_token + assert token_mode == 0o600 + assert directory_mode == 0o700 + assert not token_path.exists() + + +@pytest.mark.parametrize("offset", [0, 2]) +async def test_openclaw_dashboard_port_in_use_fails_start( + mock_openclaw: Path, tmp_path: Path, dashboard_port: int, offset: int +): + runtime = adapter.OpenClawRuntime() + + with socket.create_server(("127.0.0.1", dashboard_port + offset)): + with pytest.raises(adapter.lifecycle.LifecycleError) as caught: + await runtime.start( + { + "config": _dashboard_config( + mock_openclaw, {"port": dashboard_port} + ), + "runtime_context": _context(tmp_path).to_mapping(), + "base_dir": str(tmp_path), + } + ) + + assert caught.value.code == "openclaw_interface_port_unavailable" + assert caught.value.metadata == { + "field": "harness.settings.interfaces.dashboard.port", + "port": dashboard_port + offset, + } + assert runtime._process is None + assert not (tmp_path / "artifacts").exists() + + +@pytest.mark.parametrize("operation", ["prepare", "attach", "connect"]) +async def test_openclaw_services_reject_interfaces( + mock_openclaw: Path, tmp_path: Path, operation: str +): + runtime = adapter.OpenClawRuntime() + + with pytest.raises(adapter.lifecycle.LifecycleError) as caught: + await runtime.start( + { + "config": _dashboard_config(mock_openclaw, {"port": 20_000}), + "runtime_context": _context(tmp_path).to_mapping(), + "base_dir": str(tmp_path), + "service": {"operation": operation}, + } + ) + + assert caught.value.code == "openclaw_interfaces_require_managed_runtime" + assert runtime._process is None + + async def test_openclaw_startup_timeout_bounds_all_of_start( mock_openclaw: Path, tmp_path: Path, monkeypatch: pytest.MonkeyPatch ): From 7ed10cea02bbf1d8504b3ea56cffb4268094157c Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Sun, 1 Nov 2026 04:56:09 -0700 Subject: [PATCH 04/34] feat: serve Hermes's API server and dashboard from a runtime With `harness.settings.interfaces.api` or `.dashboard`, a runtime starts Hermes's gateway, with only its API server, or its dashboard, as child processes on exact loopback ports, alongside the embedded agent and on the same Hermes home. Start waits for each child's health check within `startup_timeout_seconds` (60 s by default, at most 75 s). Then the adapter writes the API server's per-start bearer token to `/.fabric/hermes/runtimes//interfaces/api.token` with mode 0600. `stop` removes the token and stops each child's process group, signalling the child itself where group signals are denied. With interfaces on, `config.yaml` names the model's endpoint as Hermes's `custom` provider, with the key as a reference to `api_key_env`, so the children call the configured endpoint. The gateway drains in-flight runs for 3 s so it exits within the stop grace. The API server needs `aiohttp`, so `install-hermes-agent` installs it from Hermes's `messaging` extra without the platform SDKs. The descriptor's schema validates the settings; the adapter doesn't repeat those checks. OpenClaw's loopback port check moves to `common.local_interfaces` so both adapters use it. The two descriptor copies and the catalog are mechanical. Left for later: checking on Linux that each child itself owns its port. Signed-off-by: Carlos Villela --- .../common/local_interfaces.py | 14 + adapters/python/hermes/README.md | 2 + .../python/hermes/hermes.fabric-adapter.json | 52 ++++ .../nemo_fabric_adapters/hermes/adapter.py | 24 ++ .../hermes/configuration.py | 36 +++ .../nemo_fabric_adapters/hermes/interfaces.py | 225 ++++++++++++++ .../nemo_fabric_adapters/openclaw/adapter.py | 16 +- .../hermes/hermes.fabric-adapter.json | 52 ++++ docs/integrations/harness/hermes.mdx | 47 +++ .../hermes/hermes.fabric-adapter.json | 52 ++++ justfile | 8 +- .../nemo_fabric_adapter_catalog/catalog.json | 58 +++- tests/_utils/mock_api_server.py | 16 +- tests/adapters/test_hermes_interfaces.py | 288 ++++++++++++++++++ 14 files changed, 873 insertions(+), 17 deletions(-) create mode 100644 adapters/python/hermes/src/nemo_fabric_adapters/hermes/interfaces.py create mode 100644 tests/adapters/test_hermes_interfaces.py diff --git a/adapters/python/common/src/nemo_fabric_adapters/common/local_interfaces.py b/adapters/python/common/src/nemo_fabric_adapters/common/local_interfaces.py index a8e30575d..70eaf5e3a 100644 --- a/adapters/python/common/src/nemo_fabric_adapters/common/local_interfaces.py +++ b/adapters/python/common/src/nemo_fabric_adapters/common/local_interfaces.py @@ -6,10 +6,24 @@ from __future__ import annotations import os +import socket import tempfile from pathlib import Path +def port_available(port: int) -> bool: + """Return whether one loopback TCP port is available.""" + sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM) + try: + sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1) + sock.bind(("127.0.0.1", port)) + return True + except (OSError, OverflowError): + return False + finally: + sock.close() + + def write_private_file(path: Path, payload: str) -> None: """Atomically write an owner-only file in an owner-only directory.""" path.parent.mkdir(parents=True, exist_ok=True, mode=0o700) diff --git a/adapters/python/hermes/README.md b/adapters/python/hermes/README.md index 2ee52da7a..828da6982 100644 --- a/adapters/python/hermes/README.md +++ b/adapters/python/hermes/README.md @@ -86,6 +86,8 @@ The descriptor validates the following `harness.settings` fields: | `save_trajectories` | boolean | `false` | Enables Hermes-native JSONL conversation trajectory saving. This is separate from normalized NeMo Fabric telemetry. | | `max_tokens` | positive integer | `512` | Limits the number of tokens in each Hermes model response. | | `terminal_timeout` | positive number | `60` | Limits a Hermes terminal operation in seconds. | +| `interfaces.api`, `interfaces.dashboard` | object | None | Serve Hermes's API server or dashboard from a runtime, each with an exact `port` and optional `enabled`; see [Serve the API Server and Dashboard](../../../docs/integrations/harness/hermes.mdx#serve-the-api-server-and-dashboard). | +| `startup_timeout_seconds` | number, at most 75 | `60` | Time for every enabled interface to pass its health check. | For example: diff --git a/adapters/python/hermes/hermes.fabric-adapter.json b/adapters/python/hermes/hermes.fabric-adapter.json index 84af8a6e8..bee24bf18 100644 --- a/adapters/python/hermes/hermes.fabric-adapter.json +++ b/adapters/python/hermes/hermes.fabric-adapter.json @@ -55,6 +55,58 @@ "exclusiveMinimum": 0, "default": 60, "description": "Maximum number of seconds for a Hermes terminal operation." + }, + "interfaces": { + "type": "object", + "properties": { + "api": { + "type": "object", + "properties": { + "enabled": { + "type": "boolean", + "default": true, + "description": "Serve Hermes's OpenAI-compatible API server. A present api interface is on unless this is false." + }, + "port": { + "type": "integer", + "minimum": 1, + "maximum": 65535, + "description": "Exact loopback port for the API server. Start fails if it is in use." + } + }, + "required": ["port"], + "additionalProperties": false, + "description": "Hermes's API server, run by a gateway child. After every enabled interface starts, the adapter writes its bearer token to /.fabric/hermes/runtimes//interfaces/api.token." + }, + "dashboard": { + "type": "object", + "properties": { + "enabled": { + "type": "boolean", + "default": true, + "description": "Serve Hermes's dashboard and browser chat. A present dashboard is on unless this is false." + }, + "port": { + "type": "integer", + "minimum": 1, + "maximum": 65535, + "description": "Exact loopback port for the dashboard. Start fails if it is in use." + } + }, + "required": ["port"], + "additionalProperties": false, + "description": "Hermes's dashboard, which has no sign-in when bound to loopback. It needs a built frontend at HERMES_WEB_DIST." + } + }, + "additionalProperties": false, + "description": "Native interfaces served by the runtime as child processes." + }, + "startup_timeout_seconds": { + "type": "number", + "exclusiveMinimum": 0, + "maximum": 75, + "default": 60, + "description": "Time for every enabled interface to pass its health check, within NeMo Fabric's 90-second start limit." } }, "required": [], diff --git a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/adapter.py b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/adapter.py index c43a5088d..bc12cf9d9 100755 --- a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/adapter.py +++ b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/adapter.py @@ -32,6 +32,7 @@ from nemo_fabric_adapters.common import instructions as common_instructions from nemo_fabric_adapters.common import lifecycle from nemo_fabric_adapters.hermes import configuration +from nemo_fabric_adapters.hermes import interfaces from nemo_fabric_adapters.hermes import telemetry # Default agent loop budget when FabricConfig.runtime.max_turns is unset. @@ -70,6 +71,7 @@ def __init__(self) -> None: self._relay_plugin_config: dict[str, Any] | None = None self._relay_plugin_config_path: Path | None = None self._active_invoke_task: asyncio.Task[tuple[dict[str, Any], str]] | None = None + self._interfaces = interfaces.InterfaceChildren() async def start(self, payload: dict[str, Any]) -> None: if self._started: @@ -102,6 +104,7 @@ async def start(self, payload: dict[str, Any]) -> None: telemetry.validate_hermes_relay_compatibility() self._agent_config = agent_config self._settings = configuration._settings(agent_config) + interface_ports = interfaces.interface_ports(self._settings) model_config = configuration._selected_model(agent_config) self._model_config = model_config self._runtime_id = runtime_context.runtime_id @@ -145,6 +148,7 @@ async def start(self, payload: dict[str, Any]) -> None: # Workspace belongs to the per-runtime context, not AgentConfig. workspace=str(runtime_context.environment.workspace or "."), relay_enabled=relay_enabled, + interfaces=interface_ports, ) api_key_env = configuration._api_key_env(model_config) api_key = os.environ.get(api_key_env) @@ -222,6 +226,22 @@ async def start(self, payload: dict[str, Any]) -> None: session_db=self._session_db, ) ) + if interface_ports: + environment = dict(os.environ) + provider_key_env = configuration.PROVIDER_DEFAULT_API_KEY_ENV.get( + str(model_config.provider or "").lower() + ) + if provider_key_env: + # Hermes's own processes read a provider's key from its + # default variable, not from api_key_env. + environment[provider_key_env] = api_key + await self._interfaces.start( + interface_ports, + hermes_home=self._hermes_home, + token_path=self._hermes_home / "interfaces" / "api.token", + timeout=interfaces.startup_timeout(self._settings), + environment=environment, + ) self._agent_config = agent_config self._started = True except BaseException: @@ -596,6 +616,10 @@ async def stop(self) -> None: self._stopping = True active_invoke_task = self._active_invoke_task errors: list[BaseException] = [] + try: + await self._interfaces.stop() + except BaseException as error: + errors.append(error) if active_invoke_task is not None: try: await asyncio.shield(active_invoke_task) diff --git a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/configuration.py b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/configuration.py index 39a0244c8..3ab44e97d 100644 --- a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/configuration.py +++ b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/configuration.py @@ -6,6 +6,7 @@ from __future__ import annotations import os +from collections.abc import Collection from pathlib import Path from typing import Any @@ -15,6 +16,7 @@ from nemo_fabric_adapter_contract.models import McpOAuth2Config from nemo_fabric_adapter_contract.models import McpServiceAccountConfig import nemo_fabric_adapters.common.utils as common_utils +from nemo_fabric_adapters.hermes.interfaces import GATEWAY_DRAIN_TIMEOUT_SECONDS PROVIDER_DEFAULT_API_KEY_ENV = { @@ -74,11 +76,37 @@ def disabled_toolsets(config: AgentConfig) -> list[str]: return config.tools.blocked if config.tools is not None else [] +def _interface_model(model_config: AgentModelConfig) -> dict[str, Any]: + """Return the model section Hermes's own processes read from config.yaml. + + Fabric's embedded agent receives the endpoint and key as arguments; the + gateway and dashboard read them from config.yaml, where Hermes's ``openai`` + provider ignores ``base_url``. The key stays in the environment. + """ + + provider = str(model_config.provider or "").lower() + if model_config.base_url and provider in {"openai", "custom"}: + return { + "provider": "custom", + "default": model_config.model, + "base_url": model_config.base_url, + "api_key": f"${{{_api_key_env(model_config)}}}", + } + return common_utils.without_none( + { + "provider": model_config.provider, + "default": model_config.model, + "base_url": model_config.base_url, + } + ) + + def build_hermes_config( agent_config: AgentConfig, *, workspace: str, relay_enabled: bool = False, + interfaces: Collection[str] = (), ) -> dict[str, Any]: settings = _settings(agent_config) model_config = _selected_model(agent_config) @@ -110,6 +138,12 @@ def build_hermes_config( ), } + if interfaces: + config["model"] = _interface_model(model_config) + if "api" in interfaces: + config["agent"]["cron_drain_timeout"] = GATEWAY_DRAIN_TIMEOUT_SECONDS + config["agent"]["restart_drain_timeout"] = 0 + if relay_enabled: # Hermes makes an extra model call for titles, which skews Relay telemetry. config["auxiliary"] = {"title_generation": {"enabled": False}} @@ -145,12 +179,14 @@ def write_hermes_config( *, workspace: str, relay_enabled: bool = False, + interfaces: Collection[str] = (), ) -> tuple[Path, dict[str, Any]]: hermes_home.mkdir(parents=True, exist_ok=True) config = build_hermes_config( agent_config, workspace=workspace, relay_enabled=relay_enabled, + interfaces=interfaces, ) config_path = hermes_home / "config.yaml" config_path.write_text(common_utils.dump_yaml(config), encoding="utf-8") diff --git a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/interfaces.py b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/interfaces.py new file mode 100644 index 000000000..923c21435 --- /dev/null +++ b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/interfaces.py @@ -0,0 +1,225 @@ +# SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved. +# SPDX-License-Identifier: Apache-2.0 + +"""Serve Hermes's API server and dashboard as children of a managed runtime.""" + +from __future__ import annotations + +import asyncio +import http.client +import os +import secrets +import signal +import sys +from dataclasses import dataclass +from pathlib import Path +from typing import Any + +from nemo_fabric_adapters.common import lifecycle +from nemo_fabric_adapters.common import local_interfaces +from nemo_fabric_adapters.common import utils as common_utils + +HEALTH_PATHS = {"api": "/health", "dashboard": "/api/status"} +DEFAULT_STARTUP_TIMEOUT_SECONDS = 60.0 +# Fabric gives the adapter host 10 s to stop, including this wait. +STOP_GRACE_SECONDS = 5.0 +# Hermes's gateway waits this long for in-flight API runs and cron jobs on +# SIGTERM, so it exits within STOP_GRACE_SECONDS. +GATEWAY_DRAIN_TIMEOUT_SECONDS = 3 + + +def interface_ports(settings: dict[str, Any]) -> dict[str, int]: + """Return the enabled interfaces' loopback ports, keyed by interface name. + + The descriptor's schema has already checked the settings. + """ + return { + name: interface["port"] + for name, interface in settings.get("interfaces", {}).items() + if interface.get("enabled", True) + } + + +def startup_timeout(settings: dict[str, Any]) -> float: + """Return the deadline for every enabled interface to pass its health check.""" + return float( + settings.get("startup_timeout_seconds", DEFAULT_STARTUP_TIMEOUT_SECONDS) + ) + + +@dataclass +class _Child: + name: str + port: int + process: asyncio.subprocess.Process + + +class InterfaceChildren: + """Start, track and stop one runtime's interface processes.""" + + def __init__(self) -> None: + self._children: list[_Child] = [] + self._token_path: Path | None = None + + async def start( + self, + ports: dict[str, int], + *, + hermes_home: Path, + token_path: Path, + timeout: float, + environment: dict[str, str], + ) -> None: + """Start the enabled interfaces and write the API token once all pass health.""" + for name, port in ports.items(): + if not local_interfaces.port_available(port): + raise lifecycle.LifecycleError( + "hermes_interface_port_unavailable", + f"Hermes {name} port {port} is already in use", + metadata={ + "field": f"harness.settings.interfaces.{name}.port", + "port": port, + }, + ) + web_dist = _web_dist() if "dashboard" in ports else None + token = secrets.token_urlsafe(32) + log_dir = hermes_home / "logs" + log_dir.mkdir(parents=True, exist_ok=True) + deadline = asyncio.get_running_loop().time() + timeout + try: + for name, port in ports.items(): + arguments, child_environment = _child_command( + name, port, token=token, web_dist=web_dist, environment=environment + ) + with open(log_dir / f"fabric-interface-{name}.log", "ab") as log: + process = await asyncio.create_subprocess_exec( + sys.executable, + "-m", + "hermes_cli.main", + *arguments, + env=child_environment, + stdin=asyncio.subprocess.DEVNULL, + stdout=log, + stderr=asyncio.subprocess.STDOUT, + start_new_session=True, + ) + self._children.append(_Child(name, port, process)) + for child in self._children: + await _wait_healthy(child, deadline) + if "api" in ports: + local_interfaces.write_private_file(token_path, token) + self._token_path = token_path + except BaseException: + await self.stop() + raise + + async def stop(self) -> None: + """Remove the API token, then stop every interface process group.""" + token_path, self._token_path = self._token_path, None + if token_path is not None: + token_path.unlink(missing_ok=True) + children, self._children = self._children, [] + running = [child for child in children if child.process.returncode is None] + for child in running: + common_utils.signal_process_group(child.process.pid, signal.SIGTERM) + if running: + waits = [asyncio.ensure_future(child.process.wait()) for child in running] + _, pending = await asyncio.wait(waits, timeout=STOP_GRACE_SECONDS) + for child in running: + common_utils.signal_process_group(child.process.pid, signal.SIGKILL) + if pending: + await asyncio.wait(pending) + + +def _web_dist() -> Path: + configured = os.environ.get("HERMES_WEB_DIST") + if configured: + dist = Path(configured) + else: + import hermes_cli + + dist = Path(hermes_cli.__file__).parent / "web_dist" + if not (dist / "index.html").is_file(): + raise lifecycle.LifecycleError( + "hermes_dashboard_frontend_missing", + f"Hermes's dashboard needs a built frontend at {dist}; set " + "HERMES_WEB_DIST to one", + metadata={"field": "harness.settings.interfaces.dashboard"}, + ) + return dist + + +async def _wait_healthy(child: _Child, deadline: float) -> None: + loop = asyncio.get_running_loop() + while loop.time() < deadline: + if child.process.returncode is not None: + raise lifecycle.LifecycleError( + "hermes_interface_start_failed", + f"Hermes {child.name} exited before passing its health check", + metadata={"interface": child.name}, + ) + if await _http_status(child.port, HEALTH_PATHS[child.name]) == 200: + return + await asyncio.sleep(0.1) + raise lifecycle.LifecycleError( + "hermes_interface_start_timeout", + f"Hermes {child.name} didn't pass its health check before the startup timeout", + retryable=True, + metadata={"interface": child.name}, + ) + + +def _child_command( + name: str, + port: int, + *, + token: str, + web_dist: Path | None, + environment: dict[str, str], +) -> tuple[list[str], dict[str, str]]: + """Return one interface's Hermes CLI arguments and environment.""" + child_environment = { + key: value + for key, value in environment.items() + if not key.startswith("API_SERVER_") + } + if name == "api": + child_environment.update( + API_SERVER_KEY=token, + API_SERVER_HOST="127.0.0.1", + API_SERVER_PORT=str(port), + ) + return ["gateway", "run"], child_environment + child_environment["HERMES_WEB_DIST"] = str(web_dist) + # --isolated keeps one dashboard per runtime instead of attaching to another + # runtime's dashboard on this host. + return [ + "dashboard", + "--host", + "127.0.0.1", + "--port", + str(port), + "--no-open", + "--skip-build", + "--isolated", + ], child_environment + + +async def _http_status(port: int, path: str) -> int | None: + """Return a loopback GET's status, or None when nothing answers. + + ``http.client`` neither follows redirects nor uses a proxy, which can't + reach this process's loopback anyway. + """ + + def get() -> int | None: + connection = http.client.HTTPConnection("127.0.0.1", port, timeout=1.0) + try: + connection.request("GET", path) + return connection.getresponse().status + except (OSError, http.client.HTTPException): + return None + finally: + connection.close() + + return await asyncio.to_thread(get) diff --git a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py index 908652262..8691260e7 100644 --- a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py +++ b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py @@ -35,6 +35,9 @@ from nemo_fabric_adapters.common import instructions as common_instructions from nemo_fabric_adapters.common import lifecycle from nemo_fabric_adapters.common import local_interfaces +from nemo_fabric_adapters.common.local_interfaces import ( + port_available as _port_available, +) from nemo_fabric_adapters.common import openai_chat from nemo_fabric_adapters.common import utils as common_utils from nemo_fabric_adapters.openclaw import _windows_job @@ -360,19 +363,6 @@ def _resolve_command(settings: dict[str, Any], base_dir: Path) -> Path: return candidate.resolve() -def _port_available(port: int) -> bool: - """Return whether one loopback TCP port is available.""" - sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM) - try: - sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1) - sock.bind(("127.0.0.1", port)) - return True - except (OSError, OverflowError): - return False - finally: - sock.close() - - def _select_port(settings: dict[str, Any]) -> int: """Select a base port with available Gateway and browser control ports. diff --git a/crates/fabric-cli/assets/adapters/hermes/hermes.fabric-adapter.json b/crates/fabric-cli/assets/adapters/hermes/hermes.fabric-adapter.json index 84af8a6e8..bee24bf18 100644 --- a/crates/fabric-cli/assets/adapters/hermes/hermes.fabric-adapter.json +++ b/crates/fabric-cli/assets/adapters/hermes/hermes.fabric-adapter.json @@ -55,6 +55,58 @@ "exclusiveMinimum": 0, "default": 60, "description": "Maximum number of seconds for a Hermes terminal operation." + }, + "interfaces": { + "type": "object", + "properties": { + "api": { + "type": "object", + "properties": { + "enabled": { + "type": "boolean", + "default": true, + "description": "Serve Hermes's OpenAI-compatible API server. A present api interface is on unless this is false." + }, + "port": { + "type": "integer", + "minimum": 1, + "maximum": 65535, + "description": "Exact loopback port for the API server. Start fails if it is in use." + } + }, + "required": ["port"], + "additionalProperties": false, + "description": "Hermes's API server, run by a gateway child. After every enabled interface starts, the adapter writes its bearer token to /.fabric/hermes/runtimes//interfaces/api.token." + }, + "dashboard": { + "type": "object", + "properties": { + "enabled": { + "type": "boolean", + "default": true, + "description": "Serve Hermes's dashboard and browser chat. A present dashboard is on unless this is false." + }, + "port": { + "type": "integer", + "minimum": 1, + "maximum": 65535, + "description": "Exact loopback port for the dashboard. Start fails if it is in use." + } + }, + "required": ["port"], + "additionalProperties": false, + "description": "Hermes's dashboard, which has no sign-in when bound to loopback. It needs a built frontend at HERMES_WEB_DIST." + } + }, + "additionalProperties": false, + "description": "Native interfaces served by the runtime as child processes." + }, + "startup_timeout_seconds": { + "type": "number", + "exclusiveMinimum": 0, + "maximum": 75, + "default": 60, + "description": "Time for every enabled interface to pass its health check, within NeMo Fabric's 90-second start limit." } }, "required": [], diff --git a/docs/integrations/harness/hermes.mdx b/docs/integrations/harness/hermes.mdx index e0eef5556..ab3e2506e 100644 --- a/docs/integrations/harness/hermes.mdx +++ b/docs/integrations/harness/hermes.mdx @@ -108,6 +108,53 @@ attempt is blocked, skipped, fails, or aborts without a rewrite. For the complete configuration and lifecycle reference, refer to the [Hermes Agent adapter guide](https://github.com/NVIDIA/NeMo-Fabric/tree/main/adapters/python/hermes). +## Serve the API Server and Dashboard + +A runtime can serve Hermes's API server and dashboard as child processes +alongside its embedded agent: + +```python +from nemo_fabric import HarnessConfig + +harness = HarnessConfig( + adapter_id="nvidia.fabric.hermes", + settings={"interfaces": {"api": {"port": 8642}, "dashboard": {"port": 9119}}}, +) +``` + +- The adapter starts `python -m hermes_cli.main gateway run`, with only the API + server enabled, and `python -m hermes_cli.main dashboard --skip-build + --isolated`, on the adapter's interpreter and the runtime's Hermes home, each + on `127.0.0.1` at its port. Each must pass its health check, `GET /health` or + `GET /api/status`, within `startup_timeout_seconds` (60 by default, at most + 75). `start` fails if a port is in use or a child exits first; a failed + start stops the children it started and leaves no token. Set `enabled` to + `false` to keep a configured interface off. +- Once every enabled interface passes, the adapter writes the API server's + bearer token, generated at each start, to + `/.fabric/hermes/runtimes//interfaces/api.token` + with mode `0600`. Send it as `Authorization: Bearer `. Only the + gateway child receives it. Processes that run as the runtime's user, + including the agent's own tools, can read it. +- The dashboard has no sign-in. On loopback, Hermes embeds its session token in + the page, so anyone who can reach the port can use the dashboard and its + browser chat, which runs the agent. The adapter turns off none of its pages. + Browser chat needs Hermes's built terminal UI bundle. +- With interfaces enabled, the adapter writes an `openai` or `custom` model + that has a `base_url` to `config.yaml` as Hermes's `custom` provider, with + its key as a reference to `api_key_env`, so the API server and browser chat + use the configured endpoint and key. +- `stop` removes the token, sends SIGTERM to each child's process group, and + SIGKILL to what remains after 5 seconds. The gateway drains in-flight API + runs and cron jobs for 3 seconds. After start, a child that exits doesn't fail + the runtime check, and NeMo Fabric doesn't restart it. +- The embedded agent, the gateway, the dashboard and browser chat share the + Hermes home, and Hermes coordinates their writes. The dashboard's gateway + actions, such as restart, start Hermes processes outside the runtime. +- The API server needs `aiohttp`, from Hermes's `messaging` extra. The dashboard + needs a built frontend at `HERMES_WEB_DIST` or Hermes's own + `hermes_cli/web_dist`; the adapter never builds it. + ## Runtime Health `Fabric.check()` supports `live`, `active`, and `ready`. The adapter checks native agent and database ownership, the initialized invocation interface, and a fresh `get_activity_summary()` diagnostic response. diff --git a/examples/harbor/swebench/adapters/hermes/hermes.fabric-adapter.json b/examples/harbor/swebench/adapters/hermes/hermes.fabric-adapter.json index 84af8a6e8..bee24bf18 100644 --- a/examples/harbor/swebench/adapters/hermes/hermes.fabric-adapter.json +++ b/examples/harbor/swebench/adapters/hermes/hermes.fabric-adapter.json @@ -55,6 +55,58 @@ "exclusiveMinimum": 0, "default": 60, "description": "Maximum number of seconds for a Hermes terminal operation." + }, + "interfaces": { + "type": "object", + "properties": { + "api": { + "type": "object", + "properties": { + "enabled": { + "type": "boolean", + "default": true, + "description": "Serve Hermes's OpenAI-compatible API server. A present api interface is on unless this is false." + }, + "port": { + "type": "integer", + "minimum": 1, + "maximum": 65535, + "description": "Exact loopback port for the API server. Start fails if it is in use." + } + }, + "required": ["port"], + "additionalProperties": false, + "description": "Hermes's API server, run by a gateway child. After every enabled interface starts, the adapter writes its bearer token to /.fabric/hermes/runtimes//interfaces/api.token." + }, + "dashboard": { + "type": "object", + "properties": { + "enabled": { + "type": "boolean", + "default": true, + "description": "Serve Hermes's dashboard and browser chat. A present dashboard is on unless this is false." + }, + "port": { + "type": "integer", + "minimum": 1, + "maximum": 65535, + "description": "Exact loopback port for the dashboard. Start fails if it is in use." + } + }, + "required": ["port"], + "additionalProperties": false, + "description": "Hermes's dashboard, which has no sign-in when bound to loopback. It needs a built frontend at HERMES_WEB_DIST." + } + }, + "additionalProperties": false, + "description": "Native interfaces served by the runtime as child processes." + }, + "startup_timeout_seconds": { + "type": "number", + "exclusiveMinimum": 0, + "maximum": 75, + "default": 60, + "description": "Time for every enabled interface to pass its health check, within NeMo Fabric's 90-second start limit." } }, "required": [], diff --git a/justfile b/justfile index c68730115..e6643c46c 100644 --- a/justfile +++ b/justfile @@ -439,8 +439,12 @@ install-hermes-agent: uv venv --python 3.14 --clear "$REPO_ROOT/.venv-hermes" fi # Use the release lockfile, including upstream's security dependency overrides. + # From the messaging extra, install only aiohttp, which Hermes's API server needs. UV_PROJECT_ENVIRONMENT="$REPO_ROOT/.venv-hermes" uv sync \ - --project "$hermes_checkout" --frozen --no-default-groups --extra mcp \ + --project "$hermes_checkout" --frozen --no-default-groups --extra mcp --extra messaging \ + --no-install-package discord-py --no-install-package python-telegram-bot \ + --no-install-package slack-bolt --no-install-package slack-sdk \ + --no-install-package qrcode --no-install-package brotlicffi \ --config-settings-package hermes-agent:editable_mode=compat uv pip install --python "$REPO_ROOT/.venv-hermes/bin/python" \ --editable "$REPO_ROOT/sdk/python/nemo-fabric-evidence" \ @@ -453,7 +457,7 @@ install-hermes-agent: pytest pytest-asyncio pyyaml test-hermes: install-hermes-agent - .venv-hermes/bin/python -m pytest tests/adapters/test_hermes_adapter.py tests/adapters/test_hermes_config_builder.py tests/adapters/test_hermes_streaming.py tests/adapters/test_hermes_health.py tests/e2e/test_hermes_e2e.py tests/e2e/test_hermes_checks.py -q + .venv-hermes/bin/python -m pytest tests/adapters/test_hermes_adapter.py tests/adapters/test_hermes_config_builder.py tests/adapters/test_hermes_interfaces.py tests/adapters/test_hermes_streaming.py tests/adapters/test_hermes_health.py tests/e2e/test_hermes_e2e.py tests/e2e/test_hermes_checks.py -q # Build the TypeScript contract and adapter packages using their locked dependencies. build-typescript: install-typescript diff --git a/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json b/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json index ba0937b1e..7d07e98d8 100644 --- a/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json +++ b/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json @@ -843,6 +843,55 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { + "interfaces": { + "additionalProperties": false, + "description": "Native interfaces served by the runtime as child processes.", + "properties": { + "api": { + "additionalProperties": false, + "description": "Hermes's API server, run by a gateway child. After every enabled interface starts, the adapter writes its bearer token to /.fabric/hermes/runtimes//interfaces/api.token.", + "properties": { + "enabled": { + "default": true, + "description": "Serve Hermes's OpenAI-compatible API server. A present api interface is on unless this is false.", + "type": "boolean" + }, + "port": { + "description": "Exact loopback port for the API server. Start fails if it is in use.", + "maximum": 65535, + "minimum": 1, + "type": "integer" + } + }, + "required": [ + "port" + ], + "type": "object" + }, + "dashboard": { + "additionalProperties": false, + "description": "Hermes's dashboard, which has no sign-in when bound to loopback. It needs a built frontend at HERMES_WEB_DIST.", + "properties": { + "enabled": { + "default": true, + "description": "Serve Hermes's dashboard and browser chat. A present dashboard is on unless this is false.", + "type": "boolean" + }, + "port": { + "description": "Exact loopback port for the dashboard. Start fails if it is in use.", + "maximum": 65535, + "minimum": 1, + "type": "integer" + } + }, + "required": [ + "port" + ], + "type": "object" + } + }, + "type": "object" + }, "max_tokens": { "default": 512, "description": "Maximum number of tokens in each Hermes model response.", @@ -890,6 +939,13 @@ "description": "Whether Hermes saves its native conversation trajectories as JSONL.", "type": "boolean" }, + "startup_timeout_seconds": { + "default": 60, + "description": "Time for every enabled interface to pass its health check, within NeMo Fabric's 90-second start limit.", + "exclusiveMinimum": 0, + "maximum": 75, + "type": "number" + }, "terminal_timeout": { "default": 60, "description": "Maximum number of seconds for a Hermes terminal operation.", @@ -917,7 +973,7 @@ "name": "nemo-fabric-adapters-hermes", "version": "0.7.0" }, - "sha256": "6539b80cd3dbc76f2db58640bb957dcbe5f9e45421a2d7f9a45785325f354f38", + "sha256": "8ed091b3214e34c21757fd0e2fbd24d843006ebb596490f4924a81207a896099", "source": "adapters/python/hermes/hermes.fabric-adapter.json" }, "nvidia.fabric.kilo": { diff --git a/tests/_utils/mock_api_server.py b/tests/_utils/mock_api_server.py index 020f2a341..6e06ebc36 100644 --- a/tests/_utils/mock_api_server.py +++ b/tests/_utils/mock_api_server.py @@ -1,6 +1,7 @@ # SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved. # SPDX-License-Identifier: Apache-2.0 +import asyncio import json import threading import time @@ -18,7 +19,8 @@ def mock_api_server(port: int) -> Iterator[str]: Context manager for a mock API server. Use the /_requests endpoint to inspect captured chat-completion payloads after a test action. - Use the /_scenario endpoint to configure a status code or ordered tool calls for subsequent requests. + Use the /_scenario endpoint to configure a status code, a response delay, or ordered tool calls for subsequent requests. + Use the /_chat_authorization_headers endpoint to inspect the Authorization header of each chat-completion request. Use the /_reset endpoint to clear all retained request and scenario state. Args: @@ -33,6 +35,8 @@ def mock_api_server(port: int) -> Iterator[str]: def reset_state() -> None: app.state.requests = [] app.state.status_code = 200 + app.state.delay_seconds = 0.0 + app.state.chat_authorization_headers = [] app.state.tool_calls = [] app.state.tool_call_index = 0 app.state.mcp_authorization_headers = [] @@ -69,6 +73,7 @@ async def scenario(request: Request) -> dict[str, object]: payload = await request.json() app.state.status_code = int(payload.get("status_code", 200)) + app.state.delay_seconds = float(payload.get("delay_seconds", 0.0)) tool_call = payload.get("tool_call") app.state.tool_calls = payload.get("tool_calls") or ( [tool_call] if tool_call is not None else [] @@ -97,6 +102,10 @@ def reset() -> dict[str, str]: reset_state() return {"status": "ok"} + @app.get("/_chat_authorization_headers") + def chat_authorization_headers() -> list[str | None]: + return list(app.state.chat_authorization_headers) + @app.get("/_mcp_authorization_headers") def mcp_authorization_headers() -> list[str | None]: return list(app.state.mcp_authorization_headers) @@ -149,6 +158,11 @@ async def mcp(request: Request): async def chat_completions(request: Request): payload = await request.json() app.state.requests.append(payload) + app.state.chat_authorization_headers.append( + request.headers.get("authorization") + ) + if app.state.delay_seconds: + await asyncio.sleep(app.state.delay_seconds) if app.state.status_code != 200: return JSONResponse( status_code=app.state.status_code, diff --git a/tests/adapters/test_hermes_interfaces.py b/tests/adapters/test_hermes_interfaces.py new file mode 100644 index 000000000..f99a17236 --- /dev/null +++ b/tests/adapters/test_hermes_interfaces.py @@ -0,0 +1,288 @@ +# SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved. +# SPDX-License-Identifier: Apache-2.0 + +"""Tests for Hermes's API server and dashboard served by a managed runtime.""" + +from __future__ import annotations + +import asyncio +import importlib.util +import os +import socket +import sys +import time +from pathlib import Path + +import pytest +import requests +from nemo_fabric import Fabric +from nemo_fabric import FabricConfig +from nemo_fabric.errors import FabricConfigError +from nemo_fabric_adapter_contract.models import AgentConfig +from nemo_fabric_adapter_contract.models import RuntimeContext + +pytestmark = pytest.mark.usefixtures("requires_hermes_agent") + +if importlib.util.find_spec("run_agent") is not None: + from nemo_fabric_adapters.hermes import adapter + from nemo_fabric_adapters.hermes import configuration + from nemo_fabric_adapters.hermes import interfaces + +MODEL_KEY = "fabric-test-model-key" + + +def _free_port() -> int: + with socket.create_server(("127.0.0.1", 0)) as server: + return server.getsockname()[1] + + +def _agent_config( + settings: dict[str, object], *, base_url: str | None = None +) -> AgentConfig: + model: dict[str, object] = { + "provider": "openai", + "model": "fabric-echo", + "api_key_env": "FABRIC_TEST_MODEL_KEY", + } + if base_url is not None: + model["base_url"] = base_url + return AgentConfig.from_mapping( + {"harness": {"settings": settings}, "models": {"default": model}} + ) + + +def _payload( + tmp_path: Path, settings: dict[str, object], *, base_url: str | None = None +) -> dict[str, object]: + os.environ["FABRIC_TEST_MODEL_KEY"] = MODEL_KEY + context = RuntimeContext.from_mapping( + { + "runtime_id": "runtime-interfaces", + "invocation_id": "invocation-1", + "request_id": "request-1", + "environment": { + "environment_id": "environment-1", + "provider": "test", + "control_location": "in_env_control", + "ownership": "caller_owned", + "workspace": str(tmp_path), + }, + "artifacts": {}, + } + ) + return { + "base_dir": str(tmp_path), + "runtime_context": context.to_mapping(), + "config": _agent_config(settings, base_url=base_url), + } + + +def _token_path(tmp_path: Path) -> Path: + return ( + tmp_path + / "artifacts/.fabric/hermes/runtimes/runtime-interfaces/interfaces/api.token" + ) + + +@pytest.fixture(name="web_dist") +def web_dist_fixture(tmp_path: Path) -> Path: + dist = tmp_path / "web_dist" + dist.mkdir() + (dist / "index.html").write_text( + "fabric-test-dashboard", + encoding="utf-8", + ) + os.environ["HERMES_WEB_DIST"] = str(dist) + return dist + + +def _interface(name: str, **fields: object) -> dict[str, object]: + return {"interfaces": {name: fields}} + + +# Settings that the descriptor's schema rejects during planning. +INVALID_SETTINGS = [ + pytest.param(_interface("terminal"), id="unsupported"), + pytest.param(_interface("api", port=8642, key="x"), id="unknown-field"), + pytest.param(_interface("api"), id="missing-port"), + pytest.param(_interface("dashboard", port=65_536), id="port-too-high"), + pytest.param({"startup_timeout_seconds": 75.5}, id="timeout-too-long"), +] + + +@pytest.mark.parametrize("settings", INVALID_SETTINGS) +def test_hermes_plan_rejects_invalid_settings( + tmp_path: Path, settings: dict[str, object] +): + config = FabricConfig.from_mapping( + { + "metadata": {"name": "hermes-interfaces"}, + "harness": { + "adapter_id": "nvidia.fabric.hermes", + "resolution": "preinstalled", + "settings": settings, + }, + "models": {"default": {"provider": "nvidia", "model": "test-model"}}, + "environment": {"provider": "local", "workspace": "."}, + } + ) + + with pytest.raises(FabricConfigError): + Fabric().plan(config, base_dir=tmp_path) + + +def test_hermes_interfaces_read_the_model_endpoint_and_key_from_config(): + config = configuration.build_hermes_config( + _agent_config({}, base_url="http://127.0.0.1:9/v1"), + workspace=".", + interfaces={"api": 8642}, + ) + + assert config["model"] == { + "provider": "custom", + "default": "fabric-echo", + "base_url": "http://127.0.0.1:9/v1", + "api_key": "${FABRIC_TEST_MODEL_KEY}", + } + assert config["agent"]["cron_drain_timeout"] == 3 + assert config["agent"]["restart_drain_timeout"] == 0 + + +@pytest.mark.skipif(sys.platform != "linux", reason="Reads Linux procfs") +async def test_hermes_serves_api_and_dashboard_with_the_configured_model( + tmp_path: Path, api_server: str, web_dist: Path +): + api_port, dashboard_port = _free_port(), _free_port() + runtime = adapter.HermesRuntime() + await runtime.start( + _payload( + tmp_path, + { + "interfaces": { + "api": {"port": api_port}, + "dashboard": {"port": dashboard_port}, + } + }, + base_url=f"{api_server}/v1", + ) + ) + token_path = _token_path(tmp_path) + try: + token = token_path.read_text(encoding="utf-8") + token_mode = token_path.stat().st_mode & 0o777 + api = f"http://127.0.0.1:{api_port}" + unauthorized = await asyncio.to_thread( + requests.get, f"{api}/v1/models", timeout=10 + ) + reply = await asyncio.to_thread( + requests.post, + f"{api}/v1/chat/completions", + headers={"Authorization": f"Bearer {token}"}, + json={ + "model": "hermes-agent", + "messages": [{"role": "user", "content": "ping"}], + }, + timeout=60, + ) + dashboard = await asyncio.to_thread( + requests.get, f"http://127.0.0.1:{dashboard_port}/", timeout=10 + ) + dashboard_environment = next( + Path(f"/proc/{child.process.pid}/environ").read_bytes() + for child in runtime._interfaces._children + if child.name == "dashboard" + ) + finally: + await runtime.stop() + model_keys = requests.get(f"{api_server}/_chat_authorization_headers", timeout=5) + + assert token_mode == 0o600 + assert unauthorized.status_code == 401 + assert reply.status_code == 200, reply.text + assert "latest=ping" in reply.json()["choices"][0]["message"]["content"] + assert model_keys.json() + assert set(model_keys.json()) == {f"Bearer {MODEL_KEY}"} + assert "fabric-test-dashboard" in dashboard.text + # On loopback, Hermes embeds its session token: the dashboard has no sign-in. + assert "window.__HERMES_SESSION_TOKEN__" in dashboard.text + assert b"API_SERVER_KEY=" not in dashboard_environment + assert not token_path.exists() + + +async def test_hermes_stop_cuts_off_an_in_flight_api_request( + tmp_path: Path, api_server: str +): + requests.post(f"{api_server}/_scenario", json={"delay_seconds": 60}, timeout=5) + api_port = _free_port() + runtime = adapter.HermesRuntime() + await runtime.start( + _payload( + tmp_path, + {"interfaces": {"api": {"port": api_port}}}, + base_url=f"{api_server}/v1", + ) + ) + token = _token_path(tmp_path).read_text(encoding="utf-8") + in_flight = asyncio.create_task( + asyncio.to_thread( + requests.post, + f"http://127.0.0.1:{api_port}/v1/chat/completions", + headers={"Authorization": f"Bearer {token}"}, + json={ + "model": "hermes-agent", + "messages": [{"role": "user", "content": "slow"}], + }, + timeout=90, + ) + ) + while not requests.get(f"{api_server}/_requests", timeout=5).json(): + await asyncio.sleep(0.1) + + started = time.monotonic() + await runtime.stop() + elapsed = time.monotonic() - started + in_flight.cancel() + + assert elapsed < 8 + assert not _token_path(tmp_path).exists() + + +async def test_hermes_interface_port_in_use_fails_start( + tmp_path: Path, api_server: str +): + runtime = adapter.HermesRuntime() + with socket.create_server(("127.0.0.1", 0)) as server: + port = server.getsockname()[1] + with pytest.raises(adapter.lifecycle.LifecycleError) as caught: + await runtime.start( + _payload( + tmp_path, + {"interfaces": {"api": {"port": port}}}, + base_url=f"{api_server}/v1", + ) + ) + + assert caught.value.code == "hermes_interface_port_unavailable" + assert caught.value.metadata == { + "field": "harness.settings.interfaces.api.port", + "port": port, + } + assert not _token_path(tmp_path).exists() + + +async def test_hermes_dashboard_without_a_built_frontend_fails_start( + tmp_path: Path, api_server: str +): + os.environ["HERMES_WEB_DIST"] = str(tmp_path / "missing") + runtime = adapter.HermesRuntime() + + with pytest.raises(adapter.lifecycle.LifecycleError) as caught: + await runtime.start( + _payload( + tmp_path, + {"interfaces": {"dashboard": {"port": _free_port()}}}, + base_url=f"{api_server}/v1", + ) + ) + + assert caught.value.code == "hermes_dashboard_frontend_missing" From dde1815c7bbec98f247246d48e89a44ba6bf6547 Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Sun, 1 Nov 2026 12:55:45 -0700 Subject: [PATCH 05/34] test: skip the OpenClaw tests that run the mock script where CI can't Signed-off-by: Carlos Villela --- tests/adapters/test_openclaw.py | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/tests/adapters/test_openclaw.py b/tests/adapters/test_openclaw.py index 1a48e6ce2..5d9f0afb0 100644 --- a/tests/adapters/test_openclaw.py +++ b/tests/adapters/test_openclaw.py @@ -1426,6 +1426,7 @@ async def test_openclaw_dashboard_serves_control_ui_with_a_token_file( assert not token_path.exists() +@pytest.mark.skipif(sys.platform == "win32", reason="Runs the mock openclaw script directly") @pytest.mark.parametrize("offset", [0, 2]) async def test_openclaw_dashboard_port_in_use_fails_start( mock_openclaw: Path, tmp_path: Path, dashboard_port: int, offset: int @@ -1473,6 +1474,7 @@ async def test_openclaw_services_reject_interfaces( assert runtime._process is None +@pytest.mark.skipif(sys.platform == "win32", reason="Runs the mock openclaw script directly") async def test_openclaw_startup_timeout_bounds_all_of_start( mock_openclaw: Path, tmp_path: Path, monkeypatch: pytest.MonkeyPatch ): @@ -1497,7 +1499,10 @@ async def test_openclaw_startup_timeout_bounds_all_of_start( assert runtime._process is None -@pytest.mark.skipif(os.name == "nt", reason="Requires POSIX process groups") +@pytest.mark.skipif( + sys.platform in {"darwin", "win32"}, + reason="Starts the mock Gateway, which CI runs only on Linux", +) async def test_openclaw_stop_ends_the_gateway_where_group_signals_are_denied( mock_openclaw: Path, tmp_path: Path, monkeypatch: pytest.MonkeyPatch ): From 20118ba53a15c82843b2d98edd334f08297b491a Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Sun, 1 Nov 2026 17:03:41 -0700 Subject: [PATCH 06/34] fix: probe loopback ports exclusively on Windows On Windows, SO_REUSEADDR lets a bind succeed on a port that another socket holds, so port_available could report a busy port as free and Hermes and OpenClaw would skip their port-in-use errors. Use SO_EXCLUSIVEADDRUSE where the platform has it. Signed-off-by: Carlos Villela --- .../src/nemo_fabric_adapters/common/local_interfaces.py | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/adapters/python/common/src/nemo_fabric_adapters/common/local_interfaces.py b/adapters/python/common/src/nemo_fabric_adapters/common/local_interfaces.py index 70eaf5e3a..69d581faa 100644 --- a/adapters/python/common/src/nemo_fabric_adapters/common/local_interfaces.py +++ b/adapters/python/common/src/nemo_fabric_adapters/common/local_interfaces.py @@ -15,7 +15,11 @@ def port_available(port: int) -> bool: """Return whether one loopback TCP port is available.""" sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM) try: - sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1) + if hasattr(socket, "SO_EXCLUSIVEADDRUSE"): + # On Windows, SO_REUSEADDR lets a bind succeed on a port in use. + sock.setsockopt(socket.SOL_SOCKET, socket.SO_EXCLUSIVEADDRUSE, 1) + else: + sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1) sock.bind(("127.0.0.1", port)) return True except (OSError, OverflowError): From 005aa7ebeb204e1efd650cd245abecda664308cb Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Sun, 1 Nov 2026 17:03:41 -0700 Subject: [PATCH 07/34] fix: keep Hermes interface start and stop within their limits - startup_timeout_seconds now counts from the start of the runtime's start, not from the launch of the interface children, so Hermes's own setup can't push start past NeMo Fabric's 90-second limit. - stop sends SIGKILL to the children even when it's cancelled while it waits for them, so a child that ignores SIGTERM can't keep its port. - The docs say that the gateway also starts other Hermes platforms that its inherited environment configures, such as Telegram. - Tests cover a start that times out after launching a child, a disabled interface, and a cancelled stop. The in-flight request test bounds its wait, and the mock model server reads its scenario before the configured delay. Signed-off-by: Carlos Villela --- adapters/python/hermes/README.md | 2 +- .../python/hermes/hermes.fabric-adapter.json | 2 +- .../nemo_fabric_adapters/hermes/adapter.py | 9 +- .../nemo_fabric_adapters/hermes/interfaces.py | 26 ++-- .../hermes/hermes.fabric-adapter.json | 2 +- docs/integrations/harness/hermes.mdx | 14 ++- .../hermes/hermes.fabric-adapter.json | 2 +- .../nemo_fabric_adapter_catalog/catalog.json | 4 +- tests/_utils/mock_api_server.py | 11 +- tests/adapters/test_hermes_interfaces.py | 116 +++++++++++++++++- 10 files changed, 161 insertions(+), 27 deletions(-) diff --git a/adapters/python/hermes/README.md b/adapters/python/hermes/README.md index 828da6982..d02e72400 100644 --- a/adapters/python/hermes/README.md +++ b/adapters/python/hermes/README.md @@ -87,7 +87,7 @@ The descriptor validates the following `harness.settings` fields: | `max_tokens` | positive integer | `512` | Limits the number of tokens in each Hermes model response. | | `terminal_timeout` | positive number | `60` | Limits a Hermes terminal operation in seconds. | | `interfaces.api`, `interfaces.dashboard` | object | None | Serve Hermes's API server or dashboard from a runtime, each with an exact `port` and optional `enabled`; see [Serve the API Server and Dashboard](../../../docs/integrations/harness/hermes.mdx#serve-the-api-server-and-dashboard). | -| `startup_timeout_seconds` | number, at most 75 | `60` | Time for every enabled interface to pass its health check. | +| `startup_timeout_seconds` | number, at most 75 | `60` | Time from the start of the runtime for every enabled interface to pass its health check. | For example: diff --git a/adapters/python/hermes/hermes.fabric-adapter.json b/adapters/python/hermes/hermes.fabric-adapter.json index bee24bf18..b47657f0e 100644 --- a/adapters/python/hermes/hermes.fabric-adapter.json +++ b/adapters/python/hermes/hermes.fabric-adapter.json @@ -106,7 +106,7 @@ "exclusiveMinimum": 0, "maximum": 75, "default": 60, - "description": "Time for every enabled interface to pass its health check, within NeMo Fabric's 90-second start limit." + "description": "Time from the start of the runtime for every enabled interface to pass its health check, within NeMo Fabric's 90-second start limit." } }, "required": [], diff --git a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/adapter.py b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/adapter.py index bc12cf9d9..b95f0058e 100755 --- a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/adapter.py +++ b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/adapter.py @@ -81,6 +81,9 @@ async def start(self, payload: dict[str, Any]) -> None: ) self._stopping = False + # startup_timeout_seconds bounds all of start, so Fabric's start limit + # can't expire first. + started_at = asyncio.get_running_loop().time() try: agent_config = payload.get("config") if not isinstance(agent_config, AgentConfig): @@ -239,7 +242,11 @@ async def start(self, payload: dict[str, Any]) -> None: interface_ports, hermes_home=self._hermes_home, token_path=self._hermes_home / "interfaces" / "api.token", - timeout=interfaces.startup_timeout(self._settings), + timeout=max( + interfaces.startup_timeout(self._settings) + - (asyncio.get_running_loop().time() - started_at), + 0.0, + ), environment=environment, ) self._agent_config = agent_config diff --git a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/interfaces.py b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/interfaces.py index 923c21435..96658a5a7 100644 --- a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/interfaces.py +++ b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/interfaces.py @@ -118,17 +118,25 @@ async def stop(self) -> None: token_path, self._token_path = self._token_path, None if token_path is not None: token_path.unlink(missing_ok=True) - children, self._children = self._children, [] - running = [child for child in children if child.process.returncode is None] - for child in running: - common_utils.signal_process_group(child.process.pid, signal.SIGTERM) - if running: - waits = [asyncio.ensure_future(child.process.wait()) for child in running] - _, pending = await asyncio.wait(waits, timeout=STOP_GRACE_SECONDS) + running = [ + child for child in self._children if child.process.returncode is None + ] + pending: set[asyncio.Future[int]] = set() + try: + for child in running: + common_utils.signal_process_group(child.process.pid, signal.SIGTERM) + if running: + waits = [ + asyncio.ensure_future(child.process.wait()) for child in running + ] + _, pending = await asyncio.wait(waits, timeout=STOP_GRACE_SECONDS) + finally: + # Runs even when stop is cancelled, so no child outlives the runtime. for child in running: common_utils.signal_process_group(child.process.pid, signal.SIGKILL) - if pending: - await asyncio.wait(pending) + self._children = [] + if pending: + await asyncio.wait(pending) def _web_dist() -> Path: diff --git a/crates/fabric-cli/assets/adapters/hermes/hermes.fabric-adapter.json b/crates/fabric-cli/assets/adapters/hermes/hermes.fabric-adapter.json index bee24bf18..b47657f0e 100644 --- a/crates/fabric-cli/assets/adapters/hermes/hermes.fabric-adapter.json +++ b/crates/fabric-cli/assets/adapters/hermes/hermes.fabric-adapter.json @@ -106,7 +106,7 @@ "exclusiveMinimum": 0, "maximum": 75, "default": 60, - "description": "Time for every enabled interface to pass its health check, within NeMo Fabric's 90-second start limit." + "description": "Time from the start of the runtime for every enabled interface to pass its health check, within NeMo Fabric's 90-second start limit." } }, "required": [], diff --git a/docs/integrations/harness/hermes.mdx b/docs/integrations/harness/hermes.mdx index ab3e2506e..6b377efe5 100644 --- a/docs/integrations/harness/hermes.mdx +++ b/docs/integrations/harness/hermes.mdx @@ -122,14 +122,18 @@ harness = HarnessConfig( ) ``` -- The adapter starts `python -m hermes_cli.main gateway run`, with only the API - server enabled, and `python -m hermes_cli.main dashboard --skip-build - --isolated`, on the adapter's interpreter and the runtime's Hermes home, each - on `127.0.0.1` at its port. Each must pass its health check, `GET /health` or +- The adapter starts `python -m hermes_cli.main gateway run` for the API server + and `python -m hermes_cli.main dashboard --skip-build --isolated`, on the + adapter's interpreter and the runtime's Hermes home, each on `127.0.0.1` at + its port. Each must pass its health check, `GET /health` or `GET /api/status`, within `startup_timeout_seconds` (60 by default, at most - 75). `start` fails if a port is in use or a child exits first; a failed + 75) of the runtime's start. `start` fails if a port is in use or a child exits first; a failed start stops the children it started and leaves no token. Set `enabled` to `false` to keep a configured interface off. +- The children inherit the adapter host's environment without its + `API_SERVER_*` variables. The gateway also starts any other Hermes platform + that this environment configures, such as Telegram with `TELEGRAM_BOT_TOKEN` + or webhooks with `WEBHOOK_ENABLED`. - Once every enabled interface passes, the adapter writes the API server's bearer token, generated at each start, to `/.fabric/hermes/runtimes//interfaces/api.token` diff --git a/examples/harbor/swebench/adapters/hermes/hermes.fabric-adapter.json b/examples/harbor/swebench/adapters/hermes/hermes.fabric-adapter.json index bee24bf18..b47657f0e 100644 --- a/examples/harbor/swebench/adapters/hermes/hermes.fabric-adapter.json +++ b/examples/harbor/swebench/adapters/hermes/hermes.fabric-adapter.json @@ -106,7 +106,7 @@ "exclusiveMinimum": 0, "maximum": 75, "default": 60, - "description": "Time for every enabled interface to pass its health check, within NeMo Fabric's 90-second start limit." + "description": "Time from the start of the runtime for every enabled interface to pass its health check, within NeMo Fabric's 90-second start limit." } }, "required": [], diff --git a/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json b/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json index 7d07e98d8..ec6afab21 100644 --- a/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json +++ b/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json @@ -941,7 +941,7 @@ }, "startup_timeout_seconds": { "default": 60, - "description": "Time for every enabled interface to pass its health check, within NeMo Fabric's 90-second start limit.", + "description": "Time from the start of the runtime for every enabled interface to pass its health check, within NeMo Fabric's 90-second start limit.", "exclusiveMinimum": 0, "maximum": 75, "type": "number" @@ -973,7 +973,7 @@ "name": "nemo-fabric-adapters-hermes", "version": "0.7.0" }, - "sha256": "8ed091b3214e34c21757fd0e2fbd24d843006ebb596490f4924a81207a896099", + "sha256": "d69ab9ae7ccc76f30f70f94a924fd2796bcdffcc05560b1ac2c89dc49bf77ab2", "source": "adapters/python/hermes/hermes.fabric-adapter.json" }, "nvidia.fabric.kilo": { diff --git a/tests/_utils/mock_api_server.py b/tests/_utils/mock_api_server.py index 6e06ebc36..65dbb82ea 100644 --- a/tests/_utils/mock_api_server.py +++ b/tests/_utils/mock_api_server.py @@ -161,20 +161,23 @@ async def chat_completions(request: Request): app.state.chat_authorization_headers.append( request.headers.get("authorization") ) + # Read the scenario before the delay, so a later /_scenario or /_reset + # doesn't change this response. + status_code = app.state.status_code + tool_call = next_tool_call(payload) if status_code == 200 else None if app.state.delay_seconds: await asyncio.sleep(app.state.delay_seconds) - if app.state.status_code != 200: + if status_code != 200: return JSONResponse( - status_code=app.state.status_code, + status_code=status_code, content={ "error": { - "message": f"configured status {app.state.status_code}", + "message": f"configured status {status_code}", "type": "api_error", } }, ) - tool_call = next_tool_call(payload) if tool_call is not None: if payload.get("stream") is True: return StreamingResponse( diff --git a/tests/adapters/test_hermes_interfaces.py b/tests/adapters/test_hermes_interfaces.py index f99a17236..244949333 100644 --- a/tests/adapters/test_hermes_interfaces.py +++ b/tests/adapters/test_hermes_interfaces.py @@ -235,8 +235,17 @@ async def test_hermes_stop_cuts_off_an_in_flight_api_request( timeout=90, ) ) - while not requests.get(f"{api_server}/_requests", timeout=5).json(): - await asyncio.sleep(0.1) + try: + deadline = time.monotonic() + 30 + while not requests.get(f"{api_server}/_requests", timeout=5).json(): + assert time.monotonic() < deadline, ( + "the API request never reached the model" + ) + await asyncio.sleep(0.1) + except BaseException: + await runtime.stop() + in_flight.cancel() + raise started = time.monotonic() await runtime.stop() @@ -270,6 +279,109 @@ async def test_hermes_interface_port_in_use_fails_start( assert not _token_path(tmp_path).exists() +def test_hermes_disabled_interface_is_not_started(): + settings = { + "interfaces": { + "api": {"port": 8642, "enabled": False}, + "dashboard": {"port": 9119}, + } + } + + assert interfaces.interface_ports(settings) == {"dashboard": 9119} + + +async def test_hermes_interface_startup_timeout_counts_from_the_start_of_start( + tmp_path: Path, api_server: str, monkeypatch: pytest.MonkeyPatch +): + write_hermes_config = configuration.write_hermes_config + timeouts: list[float] = [] + + def slow_write_hermes_config(*args, **kwargs): + time.sleep(0.5) + return write_hermes_config(*args, **kwargs) + + async def record_start(self, ports, *, timeout, **kwargs): + timeouts.append(timeout) + + monkeypatch.setattr(configuration, "write_hermes_config", slow_write_hermes_config) + monkeypatch.setattr(interfaces.InterfaceChildren, "start", record_start) + runtime = adapter.HermesRuntime() + await runtime.start( + _payload( + tmp_path, + {"startup_timeout_seconds": 5, "interfaces": {"api": {"port": 8642}}}, + base_url=f"{api_server}/v1", + ) + ) + await runtime.stop() + + assert len(timeouts) == 1 + assert timeouts[0] <= 4.5 + + +async def test_hermes_interface_start_timeout_stops_the_started_child( + tmp_path: Path, api_server: str, monkeypatch: pytest.MonkeyPatch +): + create_subprocess_exec = asyncio.create_subprocess_exec + processes: list[asyncio.subprocess.Process] = [] + + async def record_process(*args, **kwargs): + process = await create_subprocess_exec(*args, **kwargs) + processes.append(process) + return process + + monkeypatch.setattr(interfaces.asyncio, "create_subprocess_exec", record_process) + runtime = adapter.HermesRuntime() + + with pytest.raises(adapter.lifecycle.LifecycleError) as caught: + await runtime.start( + _payload( + tmp_path, + { + "startup_timeout_seconds": 0.001, + "interfaces": {"api": {"port": _free_port()}}, + }, + base_url=f"{api_server}/v1", + ) + ) + + assert caught.value.code == "hermes_interface_start_timeout" + assert len(processes) == 1 + assert processes[0].returncode is not None + assert not runtime._interfaces._children + assert not _token_path(tmp_path).exists() + + +@pytest.mark.skipif(sys.platform == "win32", reason="Uses POSIX process groups") +async def test_hermes_cancelled_interface_stop_still_kills_a_child_that_ignores_sigterm(): + process = await asyncio.create_subprocess_exec( + sys.executable, + "-c", + "import signal, time\n" + "signal.signal(signal.SIGTERM, signal.SIG_IGN)\n" + "print('ready', flush=True)\n" + "time.sleep(60)\n", + stdout=asyncio.subprocess.PIPE, + start_new_session=True, + ) + try: + assert await process.stdout.readline() == b"ready\n" + children = interfaces.InterfaceChildren() + children._children.append(interfaces._Child("api", 0, process)) + + stopping = asyncio.create_task(children.stop()) + await asyncio.sleep(0.5) + stopping.cancel() + with pytest.raises(asyncio.CancelledError): + await stopping + + assert await asyncio.wait_for(process.wait(), timeout=2) is not None + finally: + if process.returncode is None: + process.kill() + await process.wait() + + async def test_hermes_dashboard_without_a_built_frontend_fails_start( tmp_path: Path, api_server: str ): From 075f8c4455b7631a12ff0ea2e736d28cc554fa11 Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Sun, 1 Nov 2026 17:05:22 -0700 Subject: [PATCH 08/34] docs: correct OpenClaw's dashboard port and token file claims OpenClaw allocates browser CDP ports through port + 110 on demand; it doesn't reserve them. The dashboard port description now says to keep that range free. The token file is owner-only only on POSIX hosts. On Windows, chmod sets only the read-only flag, so the file inherits the artifact root's permissions. The guide now says so. Signed-off-by: Carlos Villela --- .../src/nemo_fabric_adapters/common/local_interfaces.py | 6 +++++- adapters/python/openclaw/openclaw.fabric-adapter.json | 2 +- docs/integrations/harness/openclaw.mdx | 3 ++- .../src/nemo_fabric_adapter_catalog/catalog.json | 4 ++-- 4 files changed, 10 insertions(+), 5 deletions(-) diff --git a/adapters/python/common/src/nemo_fabric_adapters/common/local_interfaces.py b/adapters/python/common/src/nemo_fabric_adapters/common/local_interfaces.py index a8e30575d..51f3c1bd6 100644 --- a/adapters/python/common/src/nemo_fabric_adapters/common/local_interfaces.py +++ b/adapters/python/common/src/nemo_fabric_adapters/common/local_interfaces.py @@ -11,7 +11,11 @@ def write_private_file(path: Path, payload: str) -> None: - """Atomically write an owner-only file in an owner-only directory.""" + """Atomically write an owner-only file in an owner-only directory. + + On Windows, chmod sets only the read-only flag, so the file inherits the + directory's permissions. + """ path.parent.mkdir(parents=True, exist_ok=True, mode=0o700) os.chmod(path.parent, 0o700) descriptor, temporary_name = tempfile.mkstemp( diff --git a/adapters/python/openclaw/openclaw.fabric-adapter.json b/adapters/python/openclaw/openclaw.fabric-adapter.json index cfc9419f4..602cda7b5 100644 --- a/adapters/python/openclaw/openclaw.fabric-adapter.json +++ b/adapters/python/openclaw/openclaw.fabric-adapter.json @@ -79,7 +79,7 @@ "type": "integer", "minimum": 1, "maximum": 65425, - "description": "Exact loopback Gateway base port, which serves the Control UI. Start fails if it or port + 2 is in use, and OpenClaw reserves ports through port + 110. Can't be combined with port_range." + "description": "Exact loopback Gateway base port, which serves the Control UI. Start fails if it or port + 2 is in use. OpenClaw allocates browser ports through port + 110 on demand, so keep that range free. Can't be combined with port_range." } }, "required": ["port"], diff --git a/docs/integrations/harness/openclaw.mdx b/docs/integrations/harness/openclaw.mdx index ce21a3f11..8ec365a8e 100644 --- a/docs/integrations/harness/openclaw.mdx +++ b/docs/integrations/harness/openclaw.mdx @@ -139,7 +139,8 @@ harness = HarnessConfig( - After the Gateway starts, the adapter writes the sign-in token, generated at each start, to `/.fabric/openclaw/runtimes//interfaces/dashboard.token` - with mode `0600`. `stop` removes it; if the adapter host is killed, the file + with mode `0600` on POSIX hosts; on Windows, the file inherits the artifact + root's permissions. `stop` removes it; if the adapter host is killed, the file can remain. - Open `http://127.0.0.1:/#token=` through a forward to that port to sign in. The Control UI removes the token from the address bar. diff --git a/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json b/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json index ba0937b1e..fe59187af 100644 --- a/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json +++ b/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json @@ -2078,7 +2078,7 @@ "type": "boolean" }, "port": { - "description": "Exact loopback Gateway base port, which serves the Control UI. Start fails if it or port + 2 is in use, and OpenClaw reserves ports through port + 110. Can't be combined with port_range.", + "description": "Exact loopback Gateway base port, which serves the Control UI. Start fails if it or port + 2 is in use. OpenClaw allocates browser ports through port + 110 on demand, so keep that range free. Can't be combined with port_range.", "maximum": 65425, "minimum": 1, "type": "integer" @@ -2145,7 +2145,7 @@ "name": "nemo-fabric-adapters-openclaw", "version": "0.7.0" }, - "sha256": "5a90fc71ffd726f09d952162d0fa49e5fcc153a2398c37467815ffafd1ecfd93", + "sha256": "f2420e753b7efff19d6c56a8ff00f428f07f2f0761d77f49a031e90aa7f3a057", "source": "adapters/python/openclaw/openclaw.fabric-adapter.json" }, "nvidia.fabric.opencode": { From e9d33365001e652fe96eba5640bb747017235188 Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Sun, 1 Nov 2026 17:05:23 -0700 Subject: [PATCH 09/34] test: cover a disabled OpenClaw dashboard and token cleanup after failed starts A dashboard with enabled false serves no Control UI and writes no token. A start that fails after writing the token removes it, and a start that times out with a dashboard configured leaves no artifacts. Signed-off-by: Carlos Villela --- tests/adapters/test_openclaw.py | 76 ++++++++++++++++++++++++++++++++- 1 file changed, 74 insertions(+), 2 deletions(-) diff --git a/tests/adapters/test_openclaw.py b/tests/adapters/test_openclaw.py index 5d9f0afb0..21e19f123 100644 --- a/tests/adapters/test_openclaw.py +++ b/tests/adapters/test_openclaw.py @@ -1426,6 +1426,74 @@ async def test_openclaw_dashboard_serves_control_ui_with_a_token_file( assert not token_path.exists() +@pytest.mark.skipif( + sys.platform in {"darwin", "win32"}, + reason="Starts the mock Gateway, which CI runs only on Linux", +) +async def test_openclaw_dashboard_disabled_serves_no_control_ui( + mock_openclaw: Path, tmp_path: Path, dashboard_port: int +): + capture = tmp_path / "config.json" + os.environ["FAKE_OPENCLAW_CAPTURE"] = str(capture) + runtime = adapter.OpenClawRuntime() + + await runtime.start( + { + "config": _dashboard_config( + mock_openclaw, {"port": dashboard_port, "enabled": False} + ), + "runtime_context": _context(tmp_path).to_mapping(), + "base_dir": str(tmp_path), + } + ) + try: + gateway_port = runtime._port + token_exists = _dashboard_token(tmp_path).exists() + finally: + await runtime.stop() + + generated = json.loads(capture.read_text(encoding="utf-8")) + assert generated["gateway"]["controlUi"] == {"enabled": False} + assert gateway_port != dashboard_port + assert not token_exists + + +@pytest.mark.skipif( + sys.platform in {"darwin", "win32"}, + reason="Starts the mock Gateway, which CI runs only on Linux", +) +async def test_openclaw_dashboard_removes_the_token_when_start_fails_after_writing_it( + mock_openclaw: Path, + tmp_path: Path, + dashboard_port: int, + monkeypatch: pytest.MonkeyPatch, +): + os.environ["FAKE_OPENCLAW_CAPTURE"] = str(tmp_path / "config.json") + token_path = _dashboard_token(tmp_path) + token_written: list[bool] = [] + + # Start reads the HTTP read timeout only after it writes the token. + def fail_after_token_write(_settings): + token_written.append(token_path.exists()) + raise RuntimeError("start failed after writing the token") + + monkeypatch.setattr(adapter, "_read_timeout", fail_after_token_write) + runtime = adapter.OpenClawRuntime() + + with pytest.raises(RuntimeError, match="after writing the token"): + await runtime.start( + { + "config": _dashboard_config(mock_openclaw, {"port": dashboard_port}), + "runtime_context": _context(tmp_path).to_mapping(), + "base_dir": str(tmp_path), + } + ) + + assert token_written == [True] + assert not token_path.exists() + assert runtime._process is None + + @pytest.mark.skipif(sys.platform == "win32", reason="Runs the mock openclaw script directly") @pytest.mark.parametrize("offset", [0, 2]) async def test_openclaw_dashboard_port_in_use_fails_start( @@ -1476,12 +1544,15 @@ async def test_openclaw_services_reject_interfaces( @pytest.mark.skipif(sys.platform == "win32", reason="Runs the mock openclaw script directly") async def test_openclaw_startup_timeout_bounds_all_of_start( - mock_openclaw: Path, tmp_path: Path, monkeypatch: pytest.MonkeyPatch + mock_openclaw: Path, + tmp_path: Path, + dashboard_port: int, + monkeypatch: pytest.MonkeyPatch, ): # Each command finishes within the timeout, but the two together don't. monkeypatch.setenv("FAKE_OPENCLAW_COMMAND_DELAY", "0.6") monkeypatch.setenv("FAKE_OPENCLAW_CAPTURE", str(tmp_path / "config.json")) - config = _config(mock_openclaw) + config = _dashboard_config(mock_openclaw, {"port": dashboard_port}) assert config.harness is not None config.harness.settings["startup_timeout_seconds"] = 1 runtime = adapter.OpenClawRuntime() @@ -1497,6 +1568,7 @@ async def test_openclaw_startup_timeout_bounds_all_of_start( assert caught.value.code == "openclaw_command_timeout" assert runtime._process is None + assert not (tmp_path / "artifacts").exists() @pytest.mark.skipif( From 427a3e3a92dd96ec6804e59c41e08a2082fc3579 Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Sun, 1 Nov 2026 17:02:24 -0700 Subject: [PATCH 10/34] fix: don't signal a child's PID after it exits Where group signals are denied, stop falls back to signaling the child's own PID. Once the child is reaped, that PID can belong to another process. The ACP runner now skips the fallback after the agent exits, and OpenClaw rechecks the Gateway's return code before it escalates to SIGKILL. The tests now cover an agent that ignores SIGTERM, a Gateway that needs SIGKILL, and signal forwarding, each where group signals are denied. Signed-off-by: Carlos Villela --- .../nemo_fabric_adapters/openclaw/adapter.py | 14 +-- adapters/typescript/common/src/acp-runner.ts | 2 + .../common/test/acp-runner.test.mjs | 60 ++++++------ tests/adapters/test_openclaw.py | 97 ++++++++++++++++++- 4 files changed, 139 insertions(+), 34 deletions(-) diff --git a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py index 908652262..044325cb2 100644 --- a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py +++ b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py @@ -1793,12 +1793,14 @@ async def stop(self) -> None: except (TimeoutError, asyncio.CancelledError) as error: if isinstance(error, asyncio.CancelledError): cancellation = cancellation or error - if os.name == "nt": - process.kill() - else: - common_utils.signal_process_group( - process.pid, signal.SIGKILL - ) + # A reaped Gateway's PID can belong to another process. + if process.returncode is None: + if os.name == "nt": + process.kill() + else: + common_utils.signal_process_group( + process.pid, signal.SIGKILL + ) try: await process.wait() except asyncio.CancelledError as error: diff --git a/adapters/typescript/common/src/acp-runner.ts b/adapters/typescript/common/src/acp-runner.ts index fdfac458c..067bbe298 100644 --- a/adapters/typescript/common/src/acp-runner.ts +++ b/adapters/typescript/common/src/acp-runner.ts @@ -145,6 +145,8 @@ async function terminateProcessTree(child: ChildProcessWithoutNullStreams, timeo if (code === "ESRCH") return; // OpenShell's sandbox denies signals to a process group; signal the agent itself. if (code !== "EPERM") throw error; + // Node reaps an exited agent, so its PID can belong to another process. + if (child.exitCode !== null || child.signalCode !== null) return; try { process.kill(pid, signal); } catch (fallbackError) { diff --git a/adapters/typescript/common/test/acp-runner.test.mjs b/adapters/typescript/common/test/acp-runner.test.mjs index 8474c14ed..e772e6270 100644 --- a/adapters/typescript/common/test/acp-runner.test.mjs +++ b/adapters/typescript/common/test/acp-runner.test.mjs @@ -254,32 +254,38 @@ test("retries process-group termination after a failed stop", { skip: process.pl if (cleanupError !== undefined) throw cleanupError; }); -test("stops the agent where process-group signals are denied", { skip: process.platform === "win32" }, async (t) => { - const directory = await mkdtemp(join(tmpdir(), "fabric-acp-denied-")); - const marker = join(directory, "pids.json"); - const session = await startAcpSession({ - command: process.execPath, - args: [fixture], - cwd: process.cwd(), - env: { ...process.env, TEST_DESCENDANT_MARKER: marker }, - shutdownTimeoutMs: 1_000, - }); - const pids = JSON.parse(await readFile(marker, "utf8")); - const originalKill = process.kill.bind(process); - // OpenShell's sandbox denies every signal to a process group. - const kill = t.mock.method(process, "kill", (pid, signal) => { - if (pid < 0) throw Object.assign(new Error("group signals denied"), { code: "EPERM" }); - return originalKill(pid, signal); - }); - try { - await session.stop(); - await waitForProcessToStop(pids.parent); - } finally { - kill.mock.restore(); - for (const pid of [pids.parent, pids.child]) { - try { originalKill(pid, "SIGKILL"); } catch (error) { - if (error.code !== "ESRCH") throw error; +for (const ignoresSigterm of [false, true]) { + test(`stops an agent that ${ignoresSigterm ? "ignores" : "exits on"} SIGTERM where process-group signals are denied`, { skip: process.platform === "win32" }, async (t) => { + const directory = await mkdtemp(join(tmpdir(), "fabric-acp-denied-")); + const marker = join(directory, "pids.json"); + const session = await startAcpSession({ + command: process.execPath, + args: [fixture], + cwd: process.cwd(), + env: { ...process.env, TEST_DESCENDANT_MARKER: marker, TEST_IGNORE_SIGTERM: ignoresSigterm ? "1" : "0" }, + shutdownTimeoutMs: 1_000, + }); + const pids = JSON.parse(await readFile(marker, "utf8")); + const originalKill = process.kill.bind(process); + const agentSignals = []; + // OpenShell's sandbox denies every signal to a process group. + const kill = t.mock.method(process, "kill", (pid, signal) => { + if (pid < 0) throw Object.assign(new Error("group signals denied"), { code: "EPERM" }); + if (pid === pids.parent && signal !== 0) agentSignals.push(signal); + return originalKill(pid, signal); + }); + try { + await session.stop(); + await waitForProcessToStop(pids.parent); + // Once the agent exits, its PID can belong to another process. + assert.deepEqual(agentSignals, ignoresSigterm ? ["SIGTERM", "SIGKILL"] : ["SIGTERM"]); + } finally { + kill.mock.restore(); + for (const pid of [pids.parent, pids.child]) { + try { originalKill(pid, "SIGKILL"); } catch (error) { + if (error.code !== "ESRCH") throw error; + } } } - } -}); + }); +} diff --git a/tests/adapters/test_openclaw.py b/tests/adapters/test_openclaw.py index 21e19f123..c88e19ad7 100644 --- a/tests/adapters/test_openclaw.py +++ b/tests/adapters/test_openclaw.py @@ -1594,9 +1594,75 @@ def deny_group_signals(_pgid: int, _signum: int) -> None: raise PermissionError(1, "Operation not permitted") monkeypatch.setattr(os, "killpg", deny_group_signals) + try: + await runtime.stop() + + assert gateway.returncode is not None + finally: + if gateway.returncode is None: + gateway.kill() + await gateway.wait() + + +@pytest.mark.skipif(os.name == "nt", reason="POSIX process groups") +async def test_openclaw_stop_kills_a_gateway_that_ignores_sigterm_where_group_signals_are_denied( + monkeypatch: pytest.MonkeyPatch, +): + runtime = adapter.OpenClawRuntime() + runtime._shutdown_timeout = 0.01 + mock_process = MagicMock(spec=asyncio.subprocess.Process) + mock_process.pid = 1234 + mock_process.returncode = None + wait_calls = 0 + + async def wait_for_process(): + nonlocal wait_calls + wait_calls += 1 + if wait_calls == 1: + await asyncio.Event().wait() + + mock_process.wait = AsyncMock(side_effect=wait_for_process) + runtime._process = mock_process + signals: list[tuple[int, int]] = [] + + def deny_group_signals(_pgid: int, _signum: int) -> None: + raise PermissionError(1, "Operation not permitted") + + monkeypatch.setattr(adapter.os, "killpg", deny_group_signals) + monkeypatch.setattr( + adapter.os, "kill", lambda pid, signum: signals.append((pid, signum)) + ) + await runtime.stop() - assert gateway.returncode is not None + assert signals == [(1234, signal.SIGTERM), (1234, signal.SIGKILL)] + + +@pytest.mark.skipif(os.name == "nt", reason="POSIX process groups") +async def test_openclaw_stop_does_not_kill_a_gateway_that_exited_during_cancellation( + monkeypatch: pytest.MonkeyPatch, +): + runtime = adapter.OpenClawRuntime() + mock_process = MagicMock(spec=asyncio.subprocess.Process) + mock_process.pid = 1234 + mock_process.returncode = None + + async def exit_then_cancel(): + mock_process.returncode = 0 + raise asyncio.CancelledError + + mock_process.wait = AsyncMock(side_effect=exit_then_cancel) + runtime._process = mock_process + signals: list[tuple[int, int]] = [] + monkeypatch.setattr( + adapter.os, "killpg", lambda pid, signum: signals.append((pid, signum)) + ) + + with pytest.raises(asyncio.CancelledError): + await runtime.stop() + + # Once the Gateway is reaped, its PID can belong to another process. + assert signals == [(1234, signal.SIGTERM)] @pytest.mark.parametrize("phase", ["client", "process", "logs"]) @@ -1849,6 +1915,35 @@ def test_openclaw_signal_handler_forwards_to_gateway_process_group( assert forwarded == [(1234, signal.SIGTERM)] +@pytest.mark.skipif(os.name == "nt", reason="POSIX signal forwarding") +def test_openclaw_signal_handler_forwards_to_gateway_where_group_signals_are_denied( + monkeypatch: pytest.MonkeyPatch, +): + runtime = adapter.OpenClawRuntime() + mock_process = MagicMock(spec=asyncio.subprocess.Process) + mock_process.pid = 1234 + mock_process.returncode = None + runtime._process = mock_process + forwarded: list[tuple[int, int]] = [] + + def deny_group_signals(_pgid: int, _signum: int) -> None: + raise PermissionError(1, "Operation not permitted") + + monkeypatch.setattr(adapter.os, "killpg", deny_group_signals) + monkeypatch.setattr( + adapter.os, "kill", lambda pid, signum: forwarded.append((pid, signum)) + ) + + runtime._install_signal_handlers() + try: + with pytest.raises(SystemExit): + runtime._signal_handler(signal.SIGTERM, None) + finally: + runtime._restore_signal_handlers() + + assert forwarded == [(1234, signal.SIGTERM)] + + def test_windows_job_assigns_process_and_enables_kill_on_close( monkeypatch: pytest.MonkeyPatch, ): From 532424e143e6d9c85fb96ade01ce9c7b0ee94223 Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Sun, 1 Nov 2026 17:03:19 -0700 Subject: [PATCH 11/34] fix: end OpenClaw's readiness check at the startup deadline The readiness loop checked the deadline only between requests, and each /startupz request could wait up to 1 second per phase. A request that began just before the deadline could run past it. Each request is now bounded by the time left. Signed-off-by: Carlos Villela --- .../nemo_fabric_adapters/openclaw/adapter.py | 8 +++++-- tests/adapters/test_openclaw.py | 23 +++++++++++++++++++ 2 files changed, 29 insertions(+), 2 deletions(-) diff --git a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py index 044325cb2..09ad5d4f4 100644 --- a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py +++ b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py @@ -1649,10 +1649,14 @@ async def _wait_started(self, port: int, token: str, timeout: float) -> None: metadata={"detail": detail[-2000:]}, ) try: - response = await client.get(f"http://127.0.0.1:{port}/startupz") + # A request can't outlast the startup deadline. + response = await asyncio.wait_for( + client.get(f"http://127.0.0.1:{port}/startupz"), + timeout=deadline - asyncio.get_running_loop().time(), + ) if response.status_code == 200: return - except httpx.RequestError: + except (httpx.RequestError, TimeoutError): pass await asyncio.sleep(0.05) raise lifecycle.LifecycleError( diff --git a/tests/adapters/test_openclaw.py b/tests/adapters/test_openclaw.py index c88e19ad7..cdb6617f3 100644 --- a/tests/adapters/test_openclaw.py +++ b/tests/adapters/test_openclaw.py @@ -1665,6 +1665,29 @@ async def exit_then_cancel(): assert signals == [(1234, signal.SIGTERM)] +async def test_openclaw_startup_deadline_bounds_a_pending_readiness_request(): + async def never_respond(reader, _writer): + await reader.read() + + server = await asyncio.start_server(never_respond, "127.0.0.1", 0) + port = server.sockets[0].getsockname()[1] + runtime = adapter.OpenClawRuntime() + mock_process = MagicMock(spec=asyncio.subprocess.Process) + mock_process.returncode = None + runtime._process = mock_process + loop = asyncio.get_running_loop() + started = loop.time() + try: + with pytest.raises(adapter.lifecycle.LifecycleError) as caught: + await runtime._wait_started(port, "token", 0.2) + finally: + server.close() + + assert caught.value.code == "openclaw_gateway_start_timeout" + # Each readiness request otherwise waits up to 1 second for a response. + assert loop.time() - started < 0.8 + + @pytest.mark.parametrize("phase", ["client", "process", "logs"]) async def test_openclaw_stop_completes_cleanup_before_propagating_cancellation( monkeypatch: pytest.MonkeyPatch, phase: str From 4a6009ae18e954bbabf4eb576491390876859d12 Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Sun, 1 Nov 2026 17:03:19 -0700 Subject: [PATCH 12/34] docs: describe OpenClaw's startup deadline The guide's example sets startup_timeout_seconds without saying what it covers or that the descriptor caps it at 75 seconds. Signed-off-by: Carlos Villela --- docs/integrations/harness/openclaw.mdx | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/integrations/harness/openclaw.mdx b/docs/integrations/harness/openclaw.mdx index 8ec365a8e..4821372fb 100644 --- a/docs/integrations/harness/openclaw.mdx +++ b/docs/integrations/harness/openclaw.mdx @@ -81,6 +81,11 @@ contains a directory is resolved from the NeMo Fabric base directory. The adapte uses the resolved executable for its version check, configuration validation, and Gateway startup. +`startup_timeout_seconds` sets one deadline for all of start, from checking the +`openclaw` command to the Gateway becoming ready. It defaults to 60 seconds and +can be at most 75 seconds, which keeps start within NeMo Fabric's 90-second +start limit. + The adapter supports only OpenClaw's default `openclaw` agent runtime. The adapter accepts normalized model provider, model, base URL, temperature, From f48e7935a97787d374b6568e23ebcd8eb1f51788 Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Tue, 3 Nov 2026 02:12:59 -0700 Subject: [PATCH 13/34] fix: refuse Hermes interfaces on Windows before any child starts The children run in their own sessions and stop by process group, which Windows doesn't have; start failed there with an unclear error after launching a child. Signed-off-by: Carlos Villela --- .../nemo_fabric_adapters/hermes/interfaces.py | 8 ++++++++ docs/integrations/harness/hermes.mdx | 4 +++- tests/adapters/test_hermes_interfaces.py | 20 +++++++++++++++++++ 3 files changed, 31 insertions(+), 1 deletion(-) diff --git a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/interfaces.py b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/interfaces.py index 96658a5a7..89a717752 100644 --- a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/interfaces.py +++ b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/interfaces.py @@ -20,6 +20,8 @@ from nemo_fabric_adapters.common import utils as common_utils HEALTH_PATHS = {"api": "/health", "dashboard": "/api/status"} +# Children run in their own sessions and stop by process group. +POSIX = os.name != "nt" DEFAULT_STARTUP_TIMEOUT_SECONDS = 60.0 # Fabric gives the adapter host 10 s to stop, including this wait. STOP_GRACE_SECONDS = 5.0 @@ -71,6 +73,12 @@ async def start( environment: dict[str, str], ) -> None: """Start the enabled interfaces and write the API token once all pass health.""" + if not POSIX: + raise lifecycle.LifecycleError( + "hermes_interfaces_unsupported_platform", + "Hermes interfaces require a POSIX host", + metadata={"field": "harness.settings.interfaces"}, + ) for name, port in ports.items(): if not local_interfaces.port_available(port): raise lifecycle.LifecycleError( diff --git a/docs/integrations/harness/hermes.mdx b/docs/integrations/harness/hermes.mdx index 6b377efe5..4c9b45e43 100644 --- a/docs/integrations/harness/hermes.mdx +++ b/docs/integrations/harness/hermes.mdx @@ -157,7 +157,9 @@ harness = HarnessConfig( actions, such as restart, start Hermes processes outside the runtime. - The API server needs `aiohttp`, from Hermes's `messaging` extra. The dashboard needs a built frontend at `HERMES_WEB_DIST` or Hermes's own - `hermes_cli/web_dist`; the adapter never builds it. + `hermes_cli/web_dist`; the adapter never builds it. Interfaces need a POSIX + host: on Windows, `start` fails with `hermes_interfaces_unsupported_platform` + before any child starts. ## Runtime Health diff --git a/tests/adapters/test_hermes_interfaces.py b/tests/adapters/test_hermes_interfaces.py index 244949333..496fce992 100644 --- a/tests/adapters/test_hermes_interfaces.py +++ b/tests/adapters/test_hermes_interfaces.py @@ -256,6 +256,26 @@ async def test_hermes_stop_cuts_off_an_in_flight_api_request( assert not _token_path(tmp_path).exists() +async def test_hermes_interfaces_fail_start_on_windows_before_any_child_starts( + tmp_path: Path, api_server: str, monkeypatch: pytest.MonkeyPatch +): + monkeypatch.setattr(interfaces, "POSIX", False) + runtime = adapter.HermesRuntime() + + with pytest.raises(adapter.lifecycle.LifecycleError) as caught: + await runtime.start( + _payload( + tmp_path, + {"interfaces": {"api": {"port": _free_port()}}}, + base_url=f"{api_server}/v1", + ) + ) + + assert caught.value.code == "hermes_interfaces_unsupported_platform" + assert runtime._interfaces._children == [] + assert not _token_path(tmp_path).exists() + + async def test_hermes_interface_port_in_use_fails_start( tmp_path: Path, api_server: str ): From 838f0bc0ed3bc99eb342be6641e53ea1a0ab1b7e Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Thu, 5 Nov 2026 10:08:08 -0700 Subject: [PATCH 14/34] fix: retry removing the OpenClaw dashboard token after a failed stop stop() suppressed OSError when unlinking the dashboard token and cleared the path, so a later stop() could not retry. Log the failure, keep the path, and continue Gateway cleanup. Signed-off-by: Carlos Villela --- .../nemo_fabric_adapters/openclaw/adapter.py | 14 +++++-- tests/adapters/test_openclaw.py | 41 +++++++++++++++++++ 2 files changed, 52 insertions(+), 3 deletions(-) diff --git a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py index 44f32f814..f120ddf64 100644 --- a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py +++ b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py @@ -7,7 +7,6 @@ from __future__ import annotations import asyncio -import contextlib import copy import ipaddress import json @@ -1754,10 +1753,19 @@ async def invoke( async def stop(self) -> None: cancellation: asyncio.CancelledError | None = None self._stopping = True - token_path, self._dashboard_token_path = self._dashboard_token_path, None + token_path = self._dashboard_token_path if token_path is not None: - with contextlib.suppress(OSError): + try: token_path.unlink(missing_ok=True) + except OSError: + # Keep the path so a later stop can retry. + logger.error( + "OpenClaw could not remove its dashboard token at %s", + token_path, + exc_info=True, + ) + else: + self._dashboard_token_path = None try: self._restore_signal_handlers() except Exception: diff --git a/tests/adapters/test_openclaw.py b/tests/adapters/test_openclaw.py index 3b13a814c..c7be809cb 100644 --- a/tests/adapters/test_openclaw.py +++ b/tests/adapters/test_openclaw.py @@ -1494,6 +1494,47 @@ def fail_after_token_write(_settings): assert runtime._process is None +@pytest.mark.skipif( + sys.platform in {"darwin", "win32"}, + reason="Starts the mock Gateway, which CI runs only on Linux", +) +async def test_openclaw_dashboard_stop_retries_a_token_it_could_not_remove( + mock_openclaw: Path, + tmp_path: Path, + dashboard_port: int, + monkeypatch: pytest.MonkeyPatch, + caplog: pytest.LogCaptureFixture, +): + os.environ["FAKE_OPENCLAW_CAPTURE"] = str(tmp_path / "config.json") + token_path = _dashboard_token(tmp_path) + runtime = adapter.OpenClawRuntime() + await runtime.start( + { + "config": _dashboard_config(mock_openclaw, {"port": dashboard_port}), + "runtime_context": _context(tmp_path).to_mapping(), + "base_dir": str(tmp_path), + } + ) + unlink = Path.unlink + + def fail_token_unlink(path: Path, missing_ok: bool = False) -> None: + if path == token_path: + raise PermissionError("token is locked") + unlink(path, missing_ok=missing_ok) + + with monkeypatch.context() as patch: + patch.setattr(Path, "unlink", fail_token_unlink) + await runtime.stop() + + assert runtime._process is None + assert token_path.exists() + assert "could not remove its dashboard token" in caplog.text + + await runtime.stop() + + assert not token_path.exists() + + @pytest.mark.skipif(sys.platform == "win32", reason="Runs the mock openclaw script directly") @pytest.mark.parametrize("offset", [0, 2]) async def test_openclaw_dashboard_port_in_use_fails_start( From 7b70972d0cf49af87ec3fc71d291e95c8635200d Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Thu, 5 Nov 2026 10:10:12 -0700 Subject: [PATCH 15/34] test: check Hermes's Windows refusal never spawns an interface Signed-off-by: Carlos Villela --- tests/adapters/test_hermes_interfaces.py | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/tests/adapters/test_hermes_interfaces.py b/tests/adapters/test_hermes_interfaces.py index 496fce992..8faaddc59 100644 --- a/tests/adapters/test_hermes_interfaces.py +++ b/tests/adapters/test_hermes_interfaces.py @@ -12,6 +12,7 @@ import sys import time from pathlib import Path +from unittest.mock import AsyncMock import pytest import requests @@ -260,6 +261,10 @@ async def test_hermes_interfaces_fail_start_on_windows_before_any_child_starts( tmp_path: Path, api_server: str, monkeypatch: pytest.MonkeyPatch ): monkeypatch.setattr(interfaces, "POSIX", False) + # start() stops whatever it started when it fails, so check the spawn + # itself rather than the children left afterwards. + spawn = AsyncMock() + monkeypatch.setattr(interfaces.asyncio, "create_subprocess_exec", spawn) runtime = adapter.HermesRuntime() with pytest.raises(adapter.lifecycle.LifecycleError) as caught: @@ -272,7 +277,7 @@ async def test_hermes_interfaces_fail_start_on_windows_before_any_child_starts( ) assert caught.value.code == "hermes_interfaces_unsupported_platform" - assert runtime._interfaces._children == [] + spawn.assert_not_called() assert not _token_path(tmp_path).exists() From 9e867d84776cc35f202b5b7e3bd080c66e127af6 Mon Sep 17 00:00:00 2001 From: Carlos Villela Date: Thu, 5 Nov 2026 10:11:13 -0700 Subject: [PATCH 16/34] fix: refuse Hermes interfaces on Windows before MCP discovery Signed-off-by: Carlos Villela --- .../src/nemo_fabric_adapters/hermes/adapter.py | 4 ++++ .../nemo_fabric_adapters/hermes/interfaces.py | 17 +++++++++++------ tests/adapters/test_hermes_interfaces.py | 6 ++++++ 3 files changed, 21 insertions(+), 6 deletions(-) diff --git a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/adapter.py b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/adapter.py index b95f0058e..b0507d5a5 100755 --- a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/adapter.py +++ b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/adapter.py @@ -108,6 +108,10 @@ async def start(self, payload: dict[str, Any]) -> None: self._agent_config = agent_config self._settings = configuration._settings(agent_config) interface_ports = interfaces.interface_ports(self._settings) + if interface_ports: + # Refuse before Hermes's setup, whose MCP discovery can take + # minutes and outlast the caller's start deadline. + interfaces.require_supported_platform() model_config = configuration._selected_model(agent_config) self._model_config = model_config self._runtime_id = runtime_context.runtime_id diff --git a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/interfaces.py b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/interfaces.py index 89a717752..c554d3036 100644 --- a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/interfaces.py +++ b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/interfaces.py @@ -49,6 +49,16 @@ def startup_timeout(settings: dict[str, Any]) -> float: ) +def require_supported_platform() -> None: + """Refuse interfaces on a host without POSIX process groups.""" + if not POSIX: + raise lifecycle.LifecycleError( + "hermes_interfaces_unsupported_platform", + "Hermes interfaces require a POSIX host", + metadata={"field": "harness.settings.interfaces"}, + ) + + @dataclass class _Child: name: str @@ -73,12 +83,7 @@ async def start( environment: dict[str, str], ) -> None: """Start the enabled interfaces and write the API token once all pass health.""" - if not POSIX: - raise lifecycle.LifecycleError( - "hermes_interfaces_unsupported_platform", - "Hermes interfaces require a POSIX host", - metadata={"field": "harness.settings.interfaces"}, - ) + require_supported_platform() for name, port in ports.items(): if not local_interfaces.port_available(port): raise lifecycle.LifecycleError( diff --git a/tests/adapters/test_hermes_interfaces.py b/tests/adapters/test_hermes_interfaces.py index 8faaddc59..408d8b159 100644 --- a/tests/adapters/test_hermes_interfaces.py +++ b/tests/adapters/test_hermes_interfaces.py @@ -13,6 +13,7 @@ import time from pathlib import Path from unittest.mock import AsyncMock +from unittest.mock import MagicMock import pytest import requests @@ -265,6 +266,10 @@ async def test_hermes_interfaces_fail_start_on_windows_before_any_child_starts( # itself rather than the children left afterwards. spawn = AsyncMock() monkeypatch.setattr(interfaces.asyncio, "create_subprocess_exec", spawn) + # Refusing before Hermes's setup keeps MCP discovery, which can take + # minutes, from outlasting a caller's start deadline. + write_config = MagicMock(wraps=configuration.write_hermes_config) + monkeypatch.setattr(configuration, "write_hermes_config", write_config) runtime = adapter.HermesRuntime() with pytest.raises(adapter.lifecycle.LifecycleError) as caught: @@ -278,6 +283,7 @@ async def test_hermes_interfaces_fail_start_on_windows_before_any_child_starts( assert caught.value.code == "hermes_interfaces_unsupported_platform" spawn.assert_not_called() + write_config.assert_not_called() assert not _token_path(tmp_path).exists() From 9855259ccc6ed0059e30bf02693677cba38a8e00 Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Thu, 5 Nov 2026 11:34:37 -0800 Subject: [PATCH 17/34] chore: separate Hermes interfaces from OpenClaw PR scope Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- adapters/python/openclaw/README.md | 1 - .../openclaw/openclaw.fabric-adapter.json | 29 -- .../nemo_fabric_adapters/openclaw/adapter.py | 116 ++----- docs/integrations/harness/openclaw.mdx | 38 --- .../nemo_fabric_adapter_catalog/catalog.json | 41 +-- tests/adapters/test_openclaw.py | 314 ++---------------- 6 files changed, 64 insertions(+), 475 deletions(-) diff --git a/adapters/python/openclaw/README.md b/adapters/python/openclaw/README.md index b7df6522c..a8447ddde 100644 --- a/adapters/python/openclaw/README.md +++ b/adapters/python/openclaw/README.md @@ -107,7 +107,6 @@ The following settings are specific to the OpenClaw adapter: | `agent_id` | `default` | OpenClaw agent for NeMo Fabric-originated invocations. | | `channel_config` | None | OpenClaw-native `channels` and `bindings` for a prepared service. Every binding must target `agent_id`. Managed runtimes reject this setting. | | `port_range` | Random available range | Inclusive consumer-allocated range with `start` and `end` fields; it must span at least 111 ports. | -| `interfaces.dashboard` | None | Serve the Control UI on a managed runtime, with an exact `port` and optional `enabled`; see [Serve the Control UI](../../../docs/integrations/harness/openclaw.mdx#serve-the-control-ui). | | `startup_timeout_seconds` | `60` | One deadline for all of start, from checking the `openclaw` command to the Gateway becoming ready; at most 75 seconds. | | `shutdown_timeout_seconds` | `5` | Graceful shutdown timeout. | | `connect_timeout_seconds` | `10` | Local HTTP connection timeout. | diff --git a/adapters/python/openclaw/openclaw.fabric-adapter.json b/adapters/python/openclaw/openclaw.fabric-adapter.json index 602cda7b5..5d00b0240 100644 --- a/adapters/python/openclaw/openclaw.fabric-adapter.json +++ b/adapters/python/openclaw/openclaw.fabric-adapter.json @@ -64,32 +64,6 @@ "additionalProperties": false, "description": "Inclusive consumer-allocated port range. The adapter selects a Gateway base port whose complete derived footprint through base + 110 fits within the range. When omitted, the adapter selects an available local range." }, - "interfaces": { - "type": "object", - "properties": { - "dashboard": { - "type": "object", - "properties": { - "enabled": { - "type": "boolean", - "default": true, - "description": "Serve the Control UI. A present dashboard is on unless this is false." - }, - "port": { - "type": "integer", - "minimum": 1, - "maximum": 65425, - "description": "Exact loopback Gateway base port, which serves the Control UI. Start fails if it or port + 2 is in use. OpenClaw allocates browser ports through port + 110 on demand, so keep that range free. Can't be combined with port_range." - } - }, - "required": ["port"], - "additionalProperties": false, - "description": "OpenClaw's Control UI. After the Gateway starts, the adapter writes its sign-in token to /.fabric/openclaw/runtimes//interfaces/dashboard.token." - } - }, - "additionalProperties": false, - "description": "Native interfaces served by a managed runtime. Services reject interfaces." - }, "startup_timeout_seconds": { "type": "number", "exclusiveMinimum": 0, @@ -115,9 +89,6 @@ "description": "Timeout between response bytes from the local OpenClaw Gateway. When unset, the invocation timeout bounds the response." } }, - "dependentSchemas": { - "port_range": {"properties": {"interfaces": {"properties": {"dashboard": false}}}} - }, "additionalProperties": false }, "model_schema": { diff --git a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py index 78adf2ddf..fa450672f 100644 --- a/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py +++ b/adapters/python/openclaw/src/nemo_fabric_adapters/openclaw/adapter.py @@ -33,10 +33,6 @@ from nemo_fabric_adapter_contract import models as contract from nemo_fabric_adapters.common import instructions as common_instructions from nemo_fabric_adapters.common import lifecycle -from nemo_fabric_adapters.common import local_interfaces -from nemo_fabric_adapters.common.local_interfaces import ( - port_available as _port_available, -) from nemo_fabric_adapters.common import openai_chat from nemo_fabric_adapters.common import utils as common_utils from nemo_fabric_adapters.openclaw import _windows_job @@ -164,31 +160,6 @@ def _positive_setting(settings: dict[str, Any], name: str, default: float) -> fl return float(value) -def _dashboard_port(settings: dict[str, Any]) -> int | None: - """Return the Control UI's port when the settings enable it. - - The descriptor's schema has already checked the settings. - """ - dashboard = settings.get("interfaces", {}).get("dashboard") - if dashboard is None or not dashboard.get("enabled", True): - return None - return dashboard["port"] - - -def _dashboard_token_path(context: contract.RuntimeContext, base_dir: Path) -> Path: - root = context.artifacts.root - artifact_root = (base_dir / str(root)).resolve() if root else base_dir / "artifacts" - return ( - artifact_root - / ".fabric" - / "openclaw" - / "runtimes" - / context.runtime_id - / "interfaces" - / "dashboard.token" - ) - - def _agent_id(settings: dict[str, Any]) -> str: value = settings.get("agent_id", "default") if not isinstance(value, str) or not value.strip(): @@ -362,6 +333,19 @@ def _resolve_command(settings: dict[str, Any], base_dir: Path) -> Path: return candidate.resolve() +def _port_available(port: int) -> bool: + """Return whether one loopback TCP port is available.""" + sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM) + try: + sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1) + sock.bind(("127.0.0.1", port)) + return True + except (OSError, OverflowError): + return False + finally: + sock.close() + + def _select_port(settings: dict[str, Any]) -> int: """Select a base port with available Gateway and browser control ports. @@ -477,7 +461,6 @@ def _openclaw_config( port: int, token_env: str, service_mode: bool = False, - dashboard: bool = False, ) -> dict[str, Any]: model = _selected_model(config) model_id = _model_id(model) @@ -510,15 +493,7 @@ def _openclaw_config( "mode": "token", "token": {"source": "env", "provider": "default", "id": token_env}, }, - "controlUi": { - "enabled": True, - "allowedOrigins": [ - f"http://127.0.0.1:{port}", - f"http://localhost:{port}", - ], - } - if dashboard - else {"enabled": False}, + "controlUi": {"enabled": False}, "http": {"endpoints": {"chatCompletions": {"enabled": True}}}, }, "agents": { @@ -807,6 +782,8 @@ def _write_service_connection( token: str, agent_id: str, ) -> None: + path.parent.mkdir(parents=True, exist_ok=True, mode=0o700) + os.chmod(path.parent, 0o700) payload = ( json.dumps( { @@ -817,7 +794,25 @@ def _write_service_connection( ) + "\n" ) - local_interfaces.write_private_file(path, payload) + descriptor, temporary_name = tempfile.mkstemp( + dir=path.parent, + prefix=f".{path.name}.", + ) + try: + if hasattr(os, "fchmod"): + os.fchmod(descriptor, 0o600) + with os.fdopen(descriptor, "w", encoding="utf-8") as stream: + descriptor = -1 + stream.write(payload) + os.replace(temporary_name, path) + except BaseException: + if descriptor >= 0: + os.close(descriptor) + try: + os.unlink(temporary_name) + except FileNotFoundError: + pass + raise def _read_service_connection(path: Path) -> tuple[str, str, str]: @@ -862,7 +857,6 @@ def __init__(self) -> None: self._temp_dir: tempfile.TemporaryDirectory[str] | None = None self._port: int | None = None self._token: str | None = None - self._dashboard_token_path: Path | None = None self._gateway_url: str | None = None self._agent_id = "default" self._shutdown_timeout = DEFAULT_SHUTDOWN_TIMEOUT_SECONDS @@ -1056,13 +1050,6 @@ async def start(self, payload: dict[str, Any]) -> dict[str, Any] | None: "openclaw_invalid_service_context", "OpenClaw service context must be an object", ) - if service is not None and "interfaces" in settings: - raise lifecycle.LifecycleError( - "openclaw_interfaces_require_managed_runtime", - "OpenClaw interfaces require a managed runtime", - metadata={"field": "harness.settings.interfaces"}, - ) - dashboard_port = _dashboard_port(settings) self._service_host = service is not None and service.get("operation") in { "prepare", "attach", @@ -1119,20 +1106,7 @@ def startup_remaining() -> float: kind="component", ) - if dashboard_port is None: - port = _select_port(settings) - else: - port = dashboard_port - for candidate in (port, port + 2): - if not _port_available(candidate): - raise lifecycle.LifecycleError( - "openclaw_interface_port_unavailable", - f"OpenClaw dashboard port {candidate} is already in use", - metadata={ - "field": "harness.settings.interfaces.dashboard.port", - "port": candidate, - }, - ) + port = _select_port(settings) # Generate a one-time use token for the OpenClaw gateway token = secrets.token_urlsafe(48) @@ -1149,7 +1123,6 @@ def startup_remaining() -> float: port=port, token_env=token_env, service_mode=service is not None and service.get("operation") == "prepare", - dashboard=dashboard_port is not None, ) config_path.write_text(json.dumps(generated, indent=2) + "\n", encoding="utf-8") config_path.chmod(0o600) @@ -1214,10 +1187,6 @@ def startup_remaining() -> float: ] self._install_signal_handlers() await self._wait_started(port, token, startup_remaining()) - if dashboard_port is not None: - token_path = _dashboard_token_path(context, base_dir) - local_interfaces.write_private_file(token_path, token) - self._dashboard_token_path = token_path self._client = httpx.AsyncClient( headers={"authorization": f"Bearer {token}"}, http2=True, @@ -1743,19 +1712,6 @@ async def invoke( async def stop(self) -> None: cancellation: asyncio.CancelledError | None = None self._stopping = True - token_path = self._dashboard_token_path - if token_path is not None: - try: - token_path.unlink(missing_ok=True) - except OSError: - # Keep the path so a later stop can retry. - logger.error( - "OpenClaw could not remove its dashboard token at %s", - token_path, - exc_info=True, - ) - else: - self._dashboard_token_path = None try: self._restore_signal_handlers() except Exception: diff --git a/docs/integrations/harness/openclaw.mdx b/docs/integrations/harness/openclaw.mdx index 4821372fb..5f5589eed 100644 --- a/docs/integrations/harness/openclaw.mdx +++ b/docs/integrations/harness/openclaw.mdx @@ -120,44 +120,6 @@ By default, the adapter chooses an available local port range. Set `port_range` to an inclusive consumer-allocated range with `start` and `end` fields. The range must span at least 111 ports. OpenClaw's [derived-port mapping](https://docs.openclaw.ai/gateway/multiple-gateways#port-mapping-derived) uses `base_port + 2` for browser control and allocates browser CDP ports from `base_port + 11` through `base_port + 110`. The adapter verifies only that `base_port` and `base_port + 2` are available before startup. OpenClaw allocates the CDP ports on demand instead of reserving the complete range, so the adapter cannot guarantee that those ports will still be available when OpenClaw needs them. Keep the configured range reserved for the lifetime of the runtime or service when using OpenClaw browser features. -## Serve the Control UI - -OpenClaw's Control UI is its browser dashboard and chat. A managed runtime -serves it when `harness.settings.interfaces.dashboard` is present: - -```python -from nemo_fabric import HarnessConfig - -harness = HarnessConfig( - adapter_id="nvidia.fabric.openclaw", - settings={"interfaces": {"dashboard": {"port": 18789}}}, -) -``` - -- The Gateway listens on `127.0.0.1` at the dashboard `port`, which serves the - Control UI. `start` fails with `openclaw_interface_port_unavailable` if - `port` or `port + 2` is in use. OpenClaw also uses `port + 10` for its - browser relay and allocates browser CDP ports from `port + 11` through - `port + 110`, so reserve the whole range from `port` through `port + 110`. - `port` can't be combined with `port_range`; set `enabled` to `false` to keep - a configured dashboard off. -- After the Gateway starts, the adapter writes the sign-in token, generated at - each start, to - `/.fabric/openclaw/runtimes//interfaces/dashboard.token` - with mode `0600` on POSIX hosts; on Windows, the file inherits the artifact - root's permissions. `stop` removes it; if the adapter host is killed, the file - can remain. -- Open `http://127.0.0.1:/#token=` through a forward to that - port to sign in. The Control UI removes the token from the address bar. - OpenClaw 2026.9.34 accepts any loopback origin, such as a forward to a - different local port; the token is still required. -- Processes that run as the runtime's user, including the agent's own tools, - can read the token and reach the port. -- The adapter regenerates OpenClaw's configuration at each start and marks it - read-only, so changes made through the Control UI don't survive a restart. -- Prepared and attached services reject `interfaces` with - `openclaw_interfaces_require_managed_runtime`. - ## Use a Shared Service Call `prepare_service()` to map the normalized `FabricConfig` to diff --git a/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json b/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json index 474adc732..cc44c9096 100644 --- a/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json +++ b/sdk/python/nemo-fabric-adapter-catalog/src/nemo_fabric_adapter_catalog/catalog.json @@ -2057,17 +2057,6 @@ "settings_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, - "dependentSchemas": { - "port_range": { - "properties": { - "interfaces": { - "properties": { - "dashboard": false - } - } - } - } - }, "properties": { "agent_id": { "default": "default", @@ -2120,34 +2109,6 @@ "exclusiveMinimum": 0, "type": "number" }, - "interfaces": { - "additionalProperties": false, - "description": "Native interfaces served by a managed runtime. Services reject interfaces.", - "properties": { - "dashboard": { - "additionalProperties": false, - "description": "OpenClaw's Control UI. After the Gateway starts, the adapter writes its sign-in token to /.fabric/openclaw/runtimes//interfaces/dashboard.token.", - "properties": { - "enabled": { - "default": true, - "description": "Serve the Control UI. A present dashboard is on unless this is false.", - "type": "boolean" - }, - "port": { - "description": "Exact loopback Gateway base port, which serves the Control UI. Start fails if it or port + 2 is in use. OpenClaw allocates browser ports through port + 110 on demand, so keep that range free. Can't be combined with port_range.", - "maximum": 65425, - "minimum": 1, - "type": "integer" - } - }, - "required": [ - "port" - ], - "type": "object" - } - }, - "type": "object" - }, "openclaw_command": { "description": "OpenClaw executable name or path. Relative paths containing a directory are resolved from the NeMo Fabric base directory.", "minLength": 1, @@ -2201,7 +2162,7 @@ "name": "nemo-fabric-adapters-openclaw", "version": "0.7.0" }, - "sha256": "f2420e753b7efff19d6c56a8ff00f428f07f2f0761d77f49a031e90aa7f3a057", + "sha256": "27af873589f481bd85f2e8e5fd32826879d5d1ba1dbdd1ff0c1e1d1298bb5be0", "source": "adapters/python/openclaw/openclaw.fabric-adapter.json" }, "nvidia.fabric.opencode": { diff --git a/tests/adapters/test_openclaw.py b/tests/adapters/test_openclaw.py index c7be809cb..9aebfc320 100644 --- a/tests/adapters/test_openclaw.py +++ b/tests/adapters/test_openclaw.py @@ -11,7 +11,6 @@ import os import shutil import signal -import socket import subprocess import sys import time @@ -99,30 +98,11 @@ def _config(command: Path, *, with_skills: bool = False) -> AgentConfig: ) -def _dashboard_config(command: Path, dashboard: dict[str, object]) -> AgentConfig: - config = _config(command) - assert config.harness is not None - config.harness.settings["interfaces"] = {"dashboard": dashboard} - return config - - -def _dashboard_token(base_dir: Path) -> Path: - return ( - base_dir - / "artifacts/.fabric/openclaw/runtimes/openclaw-runtime/interfaces/dashboard.token" - ) - - @pytest.fixture(name="mock_openclaw") def mock_openclaw_fixture(repo_root: Path) -> Path: return repo_root / "tests/_utils/mock_openclaw.py" -@pytest.fixture(name="dashboard_port") -def dashboard_port_fixture() -> int: - return adapter._select_port({}) - - def test_openclaw_port_availability_checks_one_port( monkeypatch: pytest.MonkeyPatch, ): @@ -203,46 +183,6 @@ def test_openclaw_rejects_invalid_port_range(settings: dict[str, object]): assert caught.value.metadata == {"field": "harness.settings.port_range"} -@pytest.mark.parametrize( - "settings", - [ - pytest.param({"interfaces": {"terminal": {}}}, id="unsupported-interface"), - pytest.param( - {"interfaces": {"dashboard": {"port": 20_000, "token": "x"}}}, - id="unknown-field", - ), - pytest.param({"interfaces": {"dashboard": {}}}, id="missing-port"), - pytest.param({"interfaces": {"dashboard": {"port": 65_426}}}, id="port-too-high"), - pytest.param( - { - "interfaces": {"dashboard": {"port": 20_000}}, - "port_range": {"start": 20_000, "end": 20_200}, - }, - id="port-range-with-dashboard", - ), - pytest.param({"startup_timeout_seconds": 76}, id="startup-timeout-too-long"), - ], -) -def test_openclaw_plan_rejects_invalid_settings( - tmp_path: Path, settings: dict[str, object] -): - config = FabricConfig.from_mapping( - { - "metadata": {"name": "openclaw-interfaces"}, - "harness": { - "adapter_id": "nvidia.fabric.openclaw", - "resolution": "preinstalled", - "settings": settings, - }, - "models": {"default": {"provider": "test", "model": "fabric-echo"}}, - "environment": {"provider": "local", "workspace": "."}, - } - ) - - with pytest.raises(FabricConfigError): - Fabric().plan(config, base_dir=tmp_path) - - @pytest.mark.parametrize("raw", ["2026.9.34 extra", "2026.9.34\nuntrusted suffix"]) async def test_gateway_records_the_same_version_it_validates(monkeypatch, raw): from nemo_fabric_adapters.common import provenance @@ -541,8 +481,6 @@ async def test_openclaw_runtime_generates_config_invokes_and_cleans_up( assert generated["mcp"]["servers"]["local"]["command"] == "python" assert generated["mcp"]["servers"]["remote"]["transport"] == ("streamable-http") assert "auth" not in generated["mcp"]["servers"]["remote"] - assert generated["gateway"]["controlUi"] == {"enabled": False} - assert not (tmp_path / "artifacts").exists() # The sandbox would deny OpenClaw's model catalog lookup anyway. assert generated["models"]["catalogRefresh"] == {"enabled": False} assert not state_root.exists() @@ -1387,231 +1325,6 @@ async def test_openclaw_stop_continues_after_cleanup_failures( assert runtime._temp_dir is None -@pytest.mark.skipif(sys.platform == "win32", reason="Requires POSIX file permissions") -async def test_openclaw_dashboard_serves_control_ui_with_a_token_file( - mock_openclaw: Path, tmp_path: Path, dashboard_port: int -): - capture = tmp_path / "config.json" - os.environ["FAKE_OPENCLAW_CAPTURE"] = str(capture) - token_path = _dashboard_token(tmp_path) - runtime = adapter.OpenClawRuntime() - - await runtime.start( - { - "config": _dashboard_config(mock_openclaw, {"port": dashboard_port}), - "runtime_context": _context(tmp_path).to_mapping(), - "base_dir": str(tmp_path), - } - ) - try: - gateway_token = runtime._token - stored_token = token_path.read_text(encoding="utf-8") - token_mode = token_path.stat().st_mode & 0o777 - directory_mode = token_path.parent.stat().st_mode & 0o777 - finally: - await runtime.stop() - - generated = json.loads(capture.read_text(encoding="utf-8")) - assert generated["gateway"]["port"] == dashboard_port - assert generated["gateway"]["controlUi"] == { - "enabled": True, - "allowedOrigins": [ - f"http://127.0.0.1:{dashboard_port}", - f"http://localhost:{dashboard_port}", - ], - } - assert stored_token == gateway_token - assert token_mode == 0o600 - assert directory_mode == 0o700 - assert not token_path.exists() - - -@pytest.mark.skipif( - sys.platform in {"darwin", "win32"}, - reason="Starts the mock Gateway, which CI runs only on Linux", -) -async def test_openclaw_dashboard_disabled_serves_no_control_ui( - mock_openclaw: Path, tmp_path: Path, dashboard_port: int -): - capture = tmp_path / "config.json" - os.environ["FAKE_OPENCLAW_CAPTURE"] = str(capture) - runtime = adapter.OpenClawRuntime() - - await runtime.start( - { - "config": _dashboard_config( - mock_openclaw, {"port": dashboard_port, "enabled": False} - ), - "runtime_context": _context(tmp_path).to_mapping(), - "base_dir": str(tmp_path), - } - ) - try: - gateway_port = runtime._port - token_exists = _dashboard_token(tmp_path).exists() - finally: - await runtime.stop() - - generated = json.loads(capture.read_text(encoding="utf-8")) - assert generated["gateway"]["controlUi"] == {"enabled": False} - assert gateway_port != dashboard_port - assert not token_exists - - -@pytest.mark.skipif( - sys.platform in {"darwin", "win32"}, - reason="Starts the mock Gateway, which CI runs only on Linux", -) -async def test_openclaw_dashboard_removes_the_token_when_start_fails_after_writing_it( - mock_openclaw: Path, - tmp_path: Path, - dashboard_port: int, - monkeypatch: pytest.MonkeyPatch, -): - os.environ["FAKE_OPENCLAW_CAPTURE"] = str(tmp_path / "config.json") - token_path = _dashboard_token(tmp_path) - token_written: list[bool] = [] - - # Start reads the HTTP read timeout only after it writes the token. - def fail_after_token_write(_settings): - token_written.append(token_path.exists()) - raise RuntimeError("start failed after writing the token") - - monkeypatch.setattr(adapter, "_read_timeout", fail_after_token_write) - runtime = adapter.OpenClawRuntime() - - with pytest.raises(RuntimeError, match="after writing the token"): - await runtime.start( - { - "config": _dashboard_config(mock_openclaw, {"port": dashboard_port}), - "runtime_context": _context(tmp_path).to_mapping(), - "base_dir": str(tmp_path), - } - ) - - assert token_written == [True] - assert not token_path.exists() - assert runtime._process is None - - -@pytest.mark.skipif( - sys.platform in {"darwin", "win32"}, - reason="Starts the mock Gateway, which CI runs only on Linux", -) -async def test_openclaw_dashboard_stop_retries_a_token_it_could_not_remove( - mock_openclaw: Path, - tmp_path: Path, - dashboard_port: int, - monkeypatch: pytest.MonkeyPatch, - caplog: pytest.LogCaptureFixture, -): - os.environ["FAKE_OPENCLAW_CAPTURE"] = str(tmp_path / "config.json") - token_path = _dashboard_token(tmp_path) - runtime = adapter.OpenClawRuntime() - await runtime.start( - { - "config": _dashboard_config(mock_openclaw, {"port": dashboard_port}), - "runtime_context": _context(tmp_path).to_mapping(), - "base_dir": str(tmp_path), - } - ) - unlink = Path.unlink - - def fail_token_unlink(path: Path, missing_ok: bool = False) -> None: - if path == token_path: - raise PermissionError("token is locked") - unlink(path, missing_ok=missing_ok) - - with monkeypatch.context() as patch: - patch.setattr(Path, "unlink", fail_token_unlink) - await runtime.stop() - - assert runtime._process is None - assert token_path.exists() - assert "could not remove its dashboard token" in caplog.text - - await runtime.stop() - - assert not token_path.exists() - - -@pytest.mark.skipif(sys.platform == "win32", reason="Runs the mock openclaw script directly") -@pytest.mark.parametrize("offset", [0, 2]) -async def test_openclaw_dashboard_port_in_use_fails_start( - mock_openclaw: Path, tmp_path: Path, dashboard_port: int, offset: int -): - runtime = adapter.OpenClawRuntime() - - with socket.create_server(("127.0.0.1", dashboard_port + offset)): - with pytest.raises(adapter.lifecycle.LifecycleError) as caught: - await runtime.start( - { - "config": _dashboard_config( - mock_openclaw, {"port": dashboard_port} - ), - "runtime_context": _context(tmp_path).to_mapping(), - "base_dir": str(tmp_path), - } - ) - - assert caught.value.code == "openclaw_interface_port_unavailable" - assert caught.value.metadata == { - "field": "harness.settings.interfaces.dashboard.port", - "port": dashboard_port + offset, - } - assert runtime._process is None - assert not (tmp_path / "artifacts").exists() - - -@pytest.mark.parametrize("operation", ["prepare", "attach", "connect"]) -async def test_openclaw_services_reject_interfaces( - mock_openclaw: Path, tmp_path: Path, operation: str -): - runtime = adapter.OpenClawRuntime() - - with pytest.raises(adapter.lifecycle.LifecycleError) as caught: - await runtime.start( - { - "config": _dashboard_config(mock_openclaw, {"port": 20_000}), - "runtime_context": _context(tmp_path).to_mapping(), - "base_dir": str(tmp_path), - "service": {"operation": operation}, - } - ) - - assert caught.value.code == "openclaw_interfaces_require_managed_runtime" - assert runtime._process is None - - -@pytest.mark.skipif(sys.platform == "win32", reason="Runs the mock openclaw script directly") -async def test_openclaw_startup_timeout_bounds_all_of_start( - mock_openclaw: Path, - tmp_path: Path, - dashboard_port: int, - monkeypatch: pytest.MonkeyPatch, -): - # Each command finishes within the timeout, but the two together don't. - monkeypatch.setenv("FAKE_OPENCLAW_COMMAND_DELAY", "0.6") - monkeypatch.setenv("FAKE_OPENCLAW_CAPTURE", str(tmp_path / "config.json")) - config = _dashboard_config(mock_openclaw, {"port": dashboard_port}) - assert config.harness is not None - config.harness.settings["startup_timeout_seconds"] = 1 - runtime = adapter.OpenClawRuntime() - - with pytest.raises(adapter.lifecycle.LifecycleError) as caught: - await runtime.start( - { - "config": config, - "runtime_context": _context(tmp_path).to_mapping(), - "base_dir": str(tmp_path), - } - ) - - assert caught.value.code == "openclaw_command_timeout" - assert runtime._process is None - assert not (tmp_path / "artifacts").exists() - - @pytest.mark.skipif( sys.platform in {"darwin", "win32"}, reason="Starts the mock Gateway, which CI runs only on Linux", @@ -1790,6 +1503,33 @@ def signal_group(pid: int, signum: int) -> None: assert pid_signals == ([(1234, signal.SIGTERM)] if group_signals_denied else []) +@pytest.mark.skipif( + sys.platform == "win32", reason="Runs the mock openclaw script directly" +) +async def test_openclaw_startup_timeout_bounds_all_of_start( + mock_openclaw: Path, tmp_path: Path, monkeypatch: pytest.MonkeyPatch +): + # Each command finishes within the timeout, but the two together don't. + monkeypatch.setenv("FAKE_OPENCLAW_COMMAND_DELAY", "0.6") + monkeypatch.setenv("FAKE_OPENCLAW_CAPTURE", str(tmp_path / "config.json")) + config = _config(mock_openclaw) + assert config.harness is not None + config.harness.settings["startup_timeout_seconds"] = 1 + runtime = adapter.OpenClawRuntime() + + with pytest.raises(adapter.lifecycle.LifecycleError) as caught: + await runtime.start( + { + "config": config, + "runtime_context": _context(tmp_path).to_mapping(), + "base_dir": str(tmp_path), + } + ) + + assert caught.value.code == "openclaw_command_timeout" + assert runtime._process is None + + async def test_openclaw_startup_deadline_bounds_a_pending_readiness_request(): async def never_respond(reader, _writer): await reader.read() From db99029d33c3fe9c9d42f38d16920fd5dd3cb466 Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Thu, 5 Nov 2026 12:39:16 -0800 Subject: [PATCH 18/34] fix: apply Fabric behavior to native Hermes agents Share behavioral mapping with the embedded path and install a process-local native agent constructor in managed children. Preserve native routing and session identity while applying instructions, generation settings and tool policy. Validate with native API regressions and live Nemotron turns. Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- adapters/python/hermes/README.md | 2 + .../nemo_fabric_adapters/hermes/adapter.py | 33 ++------ .../hermes/configuration.py | 21 +++++ .../nemo_fabric_adapters/hermes/interfaces.py | 16 +++- .../src/nemo_fabric_adapters/hermes/native.py | 67 ++++++++++++++++ docs/integrations/harness/hermes.mdx | 1 + justfile | 2 +- tests/adapters/test_hermes_interfaces.py | 57 +++++++++++++ tests/adapters/test_hermes_native_config.py | 79 +++++++++++++++++++ 9 files changed, 248 insertions(+), 30 deletions(-) create mode 100644 adapters/python/hermes/src/nemo_fabric_adapters/hermes/native.py create mode 100644 tests/adapters/test_hermes_native_config.py diff --git a/adapters/python/hermes/README.md b/adapters/python/hermes/README.md index d02e72400..52b99e036 100644 --- a/adapters/python/hermes/README.md +++ b/adapters/python/hermes/README.md @@ -7,6 +7,8 @@ SPDX-License-Identifier: Apache-2.0 This adapter runs Hermes Agent through its Python SDK. +Managed API and dashboard children launch through an adapter-owned bootstrap that applies the same behavioral mapping when Hermes constructs native agent instances. Fabric-configured instructions, tool policy, turn limits, generation settings, and trajectory settings take precedence over native constructor defaults. The bootstrap retains native routing, session identity, execution, and transport; it does not modify the installed Hermes source. A mode-`0600` configuration snapshot under the runtime's `interfaces` directory supplies the mapping and is removed on stop. Gateway processes independently started outside this launcher do not receive this guarantee. + ## Runtime Health `Fabric.check()` supports `live`, `active`, and `ready` for a started runtime. diff --git a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/adapter.py b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/adapter.py index b0507d5a5..29443e2d1 100755 --- a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/adapter.py +++ b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/adapter.py @@ -37,7 +37,7 @@ # Default agent loop budget when FabricConfig.runtime.max_turns is unset. # The actual internal hermes default as of v0.21 is `sys.maxsize` -DEFAULT_MAX_ITERATIONS: int = 90 +DEFAULT_MAX_ITERATIONS: int = configuration.DEFAULT_MAX_ITERATIONS LOGGER = logging.getLogger(__name__) hermes_mcp_server_config = configuration.hermes_mcp_server_config @@ -192,19 +192,6 @@ async def start(self, payload: dict[str, Any]) -> None: ) self._session_db = SessionDB() self._conversation_history = None - max_iterations = configuration._max_turns(agent_config) - if max_iterations is None: - max_iterations = DEFAULT_MAX_ITERATIONS - temperature = model_config.temperature - top_p = model_config.top_p - request_overrides = { - name: value - for name, value in ( - ("temperature", temperature), - ("top_p", top_p), - ) - if value is not None - } self._agent = AIAgent( **filter_supported_kwargs( AIAgent, @@ -212,22 +199,12 @@ async def start(self, payload: dict[str, Any]) -> None: api_key=api_key, provider=model_config.provider, model=model_config.model, - max_iterations=int(max_iterations), - enabled_toolsets=self._enabled_toolsets, - disabled_toolsets=configuration.disabled_toolsets(agent_config) - or None, + **configuration.agent_behavior_kwargs( + agent_config, self._enabled_toolsets + ), quiet_mode=True, skip_context_files=True, skip_memory=True, - save_trajectories=bool( - self._settings.get("save_trajectories", False) - ), - max_tokens=model_config.max_tokens - or self._settings.get("max_tokens", 512), - request_overrides=request_overrides or None, - reasoning_config=self._settings.get( - "reasoning_config", {"effort": "none"} - ), platform="fabric", session_id=self._runtime_id, session_db=self._session_db, @@ -252,6 +229,7 @@ async def start(self, payload: dict[str, Any]) -> None: 0.0, ), environment=environment, + agent_config=agent_config, ) self._agent_config = agent_config self._started = True @@ -749,7 +727,6 @@ def filter_supported_call_kwargs(func: Any, **kwargs: Any) -> dict[str, Any]: return {key: value for key, value in kwargs.items() if key in supported} - # Selected software reported by the shared lifecycle host; no dependency scan. PROVENANCE_PACKAGES = ( ("adapter", "nemo-fabric-adapters-hermes", "nemo_fabric_adapters.hermes.adapter"), diff --git a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/configuration.py b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/configuration.py index 3ab44e97d..929c10b14 100644 --- a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/configuration.py +++ b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/configuration.py @@ -25,6 +25,27 @@ "openai": "OPENAI_API_KEY", "openrouter": "OPENROUTER_API_KEY", } +DEFAULT_MAX_ITERATIONS = 90 + + +def agent_behavior_kwargs( + config: AgentConfig, enabled_toolsets: list[str] | None +) -> dict[str, Any]: + """Map behavioral settings for embedded and native Hermes agent instances.""" + model = _selected_model(config) + settings = _settings(config) + overrides = common_utils.without_none( + {"temperature": model.temperature, "top_p": model.top_p} + ) + return { + "max_iterations": _max_turns(config) or DEFAULT_MAX_ITERATIONS, + "enabled_toolsets": enabled_toolsets, + "disabled_toolsets": disabled_toolsets(config) or None, + "save_trajectories": bool(settings.get("save_trajectories", False)), + "max_tokens": model.max_tokens or settings.get("max_tokens", 512), + "request_overrides": overrides or None, + "reasoning_config": settings.get("reasoning_config", {"effort": "none"}), + } def _validate_client_secret( diff --git a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/interfaces.py b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/interfaces.py index c554d3036..b5172c5bd 100644 --- a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/interfaces.py +++ b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/interfaces.py @@ -7,6 +7,7 @@ import asyncio import http.client +import json import os import secrets import signal @@ -15,6 +16,7 @@ from pathlib import Path from typing import Any +from nemo_fabric_adapter_contract.models import AgentConfig from nemo_fabric_adapters.common import lifecycle from nemo_fabric_adapters.common import local_interfaces from nemo_fabric_adapters.common import utils as common_utils @@ -72,6 +74,7 @@ class InterfaceChildren: def __init__(self) -> None: self._children: list[_Child] = [] self._token_path: Path | None = None + self._agent_config_path: Path | None = None async def start( self, @@ -81,6 +84,7 @@ async def start( token_path: Path, timeout: float, environment: dict[str, str], + agent_config: AgentConfig, ) -> None: """Start the enabled interfaces and write the API token once all pass health.""" require_supported_platform() @@ -100,6 +104,11 @@ async def start( log_dir.mkdir(parents=True, exist_ok=True) deadline = asyncio.get_running_loop().time() + timeout try: + config_path = hermes_home / "interfaces" / "agent-config.json" + local_interfaces.write_private_file( + config_path, json.dumps(agent_config.to_mapping()) + ) + self._agent_config_path = config_path for name, port in ports.items(): arguments, child_environment = _child_command( name, port, token=token, web_dist=web_dist, environment=environment @@ -108,7 +117,9 @@ async def start( process = await asyncio.create_subprocess_exec( sys.executable, "-m", - "hermes_cli.main", + "nemo_fabric_adapters.hermes.native", + "--fabric-config", + str(config_path), *arguments, env=child_environment, stdin=asyncio.subprocess.DEVNULL, @@ -148,6 +159,9 @@ async def stop(self) -> None: for child in running: common_utils.signal_process_group(child.process.pid, signal.SIGKILL) self._children = [] + if self._agent_config_path is not None: + self._agent_config_path.unlink(missing_ok=True) + self._agent_config_path = None if pending: await asyncio.wait(pending) diff --git a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/native.py b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/native.py new file mode 100644 index 000000000..d1e1ada29 --- /dev/null +++ b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/native.py @@ -0,0 +1,67 @@ +# SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved. +# SPDX-License-Identifier: Apache-2.0 + +"""Launch a native Hermes child with Fabric's agent-construction settings. + +Hermes v0.22.5's API path does not read all behavioral config from config.yaml. +Install the mapping before loading the CLI; execution and transport stay native. +The replacement is local to this adapter-owned child process. +""" + +from __future__ import annotations + +import argparse +import inspect +import json +import sys +from pathlib import Path +from typing import Any + +from nemo_fabric_adapter_contract.models import AgentConfig +from nemo_fabric_adapters.hermes import configuration + + +def configured_kwargs( + config: AgentConfig, native_kwargs: dict[str, Any], native_config: dict[str, Any] +) -> dict[str, Any]: + """Apply Fabric-owned behavior while retaining native routing and identity.""" + enabled = configuration.resolve_hermes_toolsets(config, native_config) + behavior = configuration.agent_behavior_kwargs(config, enabled) + overrides = { + **(native_kwargs.get("request_overrides") or {}), + **(behavior["request_overrides"] or {}), + } + result = {**native_kwargs, **behavior, "request_overrides": overrides or None} + if config.instructions and config.instructions.system: + result["ephemeral_system_prompt"] = config.instructions.system.content + return result + + +def main() -> None: + parser = argparse.ArgumentParser(add_help=False) + parser.add_argument("--fabric-config", type=Path, required=True) + options, arguments = parser.parse_known_args() + config = AgentConfig.from_mapping(json.loads(options.fabric_config.read_text())) + + import run_agent + from hermes_cli.config import load_config + + native_agent = run_agent.AIAgent + signature = inspect.signature(native_agent) + + class ConfiguredAIAgent(native_agent): + def __init__(self, *args: Any, **kwargs: Any) -> None: + bound = signature.bind(*args, **kwargs) + super().__init__( + **configured_kwargs(config, bound.arguments, load_config()) + ) + + run_agent.AIAgent = ConfiguredAIAgent + from hermes_cli.main import main as hermes_main + + sys.argv = ["hermes", *arguments] + hermes_main() + + +if __name__ == "__main__": + main() diff --git a/docs/integrations/harness/hermes.mdx b/docs/integrations/harness/hermes.mdx index 4c9b45e43..dc7044238 100644 --- a/docs/integrations/harness/hermes.mdx +++ b/docs/integrations/harness/hermes.mdx @@ -148,6 +148,7 @@ harness = HarnessConfig( that has a `base_url` to `config.yaml` as Hermes's `custom` provider, with its key as a reference to `api_key_env`, so the API server and browser chat use the configured endpoint and key. +- Managed children launch through an adapter-owned bootstrap that applies Fabric's instructions, enabled/blocked toolsets, turn limit, generation settings, and trajectory setting when native Hermes agent instances are constructed. Fabric-owned settings take precedence over native constructor defaults and instruction overrides. Native provider routing and session identity remain unchanged. The bootstrap reads an owner-only `interfaces/agent-config.json` snapshot, removed on stop, because Hermes v0.22.5's API constructor does not read all these settings from `config.yaml`. Independently started gateways bypass the bootstrap. - `stop` removes the token, sends SIGTERM to each child's process group, and SIGKILL to what remains after 5 seconds. The gateway drains in-flight API runs and cron jobs for 3 seconds. After start, a child that exits doesn't fail diff --git a/justfile b/justfile index e6643c46c..ccc0993c0 100644 --- a/justfile +++ b/justfile @@ -457,7 +457,7 @@ install-hermes-agent: pytest pytest-asyncio pyyaml test-hermes: install-hermes-agent - .venv-hermes/bin/python -m pytest tests/adapters/test_hermes_adapter.py tests/adapters/test_hermes_config_builder.py tests/adapters/test_hermes_interfaces.py tests/adapters/test_hermes_streaming.py tests/adapters/test_hermes_health.py tests/e2e/test_hermes_e2e.py tests/e2e/test_hermes_checks.py -q + .venv-hermes/bin/python -m pytest tests/adapters/test_hermes_adapter.py tests/adapters/test_hermes_config_builder.py tests/adapters/test_hermes_native_config.py tests/adapters/test_hermes_interfaces.py tests/adapters/test_hermes_streaming.py tests/adapters/test_hermes_health.py tests/e2e/test_hermes_e2e.py tests/e2e/test_hermes_checks.py -q # Build the TypeScript contract and adapter packages using their locked dependencies. build-typescript: install-typescript diff --git a/tests/adapters/test_hermes_interfaces.py b/tests/adapters/test_hermes_interfaces.py index 408d8b159..e4b456a76 100644 --- a/tests/adapters/test_hermes_interfaces.py +++ b/tests/adapters/test_hermes_interfaces.py @@ -7,6 +7,7 @@ import asyncio import importlib.util +import json import os import socket import sys @@ -150,6 +151,62 @@ def test_hermes_interfaces_read_the_model_endpoint_and_key_from_config(): assert config["agent"]["restart_drain_timeout"] == 0 +async def test_hermes_gateway_agents_receive_fabric_behavior( + tmp_path: Path, api_server: str +): + port = _free_port() + payload = _payload( + tmp_path, _interface("api", port=port), base_url=f"{api_server}/v1" + ) + config = payload["config"].to_mapping() + config["models"]["default"].update(temperature=0.0, top_p=0.41, max_tokens=128) + config["instructions"] = { + "system": {"mode": "replace", "content": "FABRIC_PARITY_MARKER"} + } + config["tools"] = {"enabled": ["file"], "blocked": ["terminal"]} + payload["config"] = AgentConfig.from_mapping(config) + runtime = adapter.HermesRuntime() + try: + await runtime.start(payload) + config_path = _token_path(tmp_path).with_name("agent-config.json") + assert config_path.stat().st_mode & 0o777 == 0o600 + token = _token_path(tmp_path).read_text() + for number in range(2): + reply = await asyncio.to_thread( + requests.post, + f"http://127.0.0.1:{port}/v1/chat/completions", + headers={"Authorization": f"Bearer {token}"}, + json={ + "model": "hermes-agent", + "messages": [ + {"role": "user", "content": f"fresh conversation {number}"} + ], + }, + timeout=60, + ) + assert reply.status_code == 200, reply.text + captured = await asyncio.to_thread( + requests.get, f"{api_server}/_requests", timeout=5 + ) + # Native session titling may make separate tool-free auxiliary calls. + requests_seen = [request for request in captured.json() if request.get("tools")] + assert len(requests_seen) == 2 + for request in requests_seen: + assert "FABRIC_PARITY_MARKER" in json.dumps(request["messages"]) + assert request["temperature"] == 0.0 + assert request["top_p"] == 0.41 + assert request["max_tokens"] == 128 + assert {tool["function"]["name"] for tool in request["tools"]} == { + "read_file", + "write_file", + "patch", + "search_files", + } + finally: + await runtime.stop() + assert not config_path.exists() + + @pytest.mark.skipif(sys.platform != "linux", reason="Reads Linux procfs") async def test_hermes_serves_api_and_dashboard_with_the_configured_model( tmp_path: Path, api_server: str, web_dist: Path diff --git a/tests/adapters/test_hermes_native_config.py b/tests/adapters/test_hermes_native_config.py new file mode 100644 index 000000000..21be92a36 --- /dev/null +++ b/tests/adapters/test_hermes_native_config.py @@ -0,0 +1,79 @@ +# SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved. +# SPDX-License-Identifier: Apache-2.0 + +"""Fabric behavior survives creation of additional native Hermes agents.""" + +import pytest +from nemo_fabric_adapter_contract.models import AgentConfig +from nemo_fabric_adapters.hermes import configuration +from nemo_fabric_adapters.hermes.native import configured_kwargs + + +@pytest.mark.parametrize("model_limit", [None, 128]) +def test_native_agents_apply_behavior_without_losing_routing_or_identity(model_limit): + model = { + "provider": "openai", + "model": "configured", + "temperature": 0.0, + "top_p": 0.41, + } + if model_limit is not None: + model["max_tokens"] = model_limit + config = AgentConfig.from_mapping( + { + "models": {"default": model}, + "harness": { + "settings": {"max_tokens": 96, "reasoning_config": {"effort": "none"}} + }, + "runtime": {"max_turns": 2}, + "tools": {"enabled": ["file"], "blocked": ["terminal"]}, + "instructions": { + "system": {"mode": "replace", "content": "Fabric instruction"} + }, + } + ) + native = { + "model": "configured", + "provider": "custom", + "base_url": "http://127.0.0.1:8642/v1", + "session_id": "native-session", + "platform": "api_server", + "enabled_toolsets": ["file", "web"], + "ephemeral_system_prompt": "native override", + "request_overrides": {"temperature": 0.9, "extra_body": {"test": True}}, + } + + result = configured_kwargs(config, native, {}) + + assert result["enabled_toolsets"] == ["file"] + assert result["disabled_toolsets"] == ["terminal"] + assert result["ephemeral_system_prompt"] == "Fabric instruction" + assert result["max_tokens"] == (model_limit or 96) + assert result["max_iterations"] == 2 + assert result["request_overrides"] == { + "temperature": 0.0, + "top_p": 0.41, + "extra_body": {"test": True}, + } + assert result["reasoning_config"] == {"effort": "none"} + for key in ("model", "provider", "base_url", "session_id", "platform"): + assert result[key] == native[key] + assert native["enabled_toolsets"] == ["file", "web"] + assert native["request_overrides"]["temperature"] == 0.9 + + +def test_native_behavior_preserves_native_prompt_when_fabric_has_none(): + config = AgentConfig.from_mapping( + { + "models": {"default": {"provider": "openai", "model": "configured"}}, + "tools": {"enabled": []}, + } + ) + + result = configured_kwargs(config, {"ephemeral_system_prompt": "native"}, {}) + + assert result["ephemeral_system_prompt"] == "native" + assert result["enabled_toolsets"] == [] + assert result["request_overrides"] is None + assert result["max_tokens"] == 512 + assert result["max_iterations"] == configuration.DEFAULT_MAX_ITERATIONS From 2f6be67782adf370ad2618d95d6dc27b01b662c2 Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Thu, 5 Nov 2026 13:20:07 -0800 Subject: [PATCH 19/34] docs: separate Hermes native interface guidance Explain invocation and normalization boundaries, shared configuration delivery, testing and limitations in a linked interface guide. Add the editable runtime diagram and PNG, and validate the live SDK/API smoke example. Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- adapters/python/hermes/README.md | 2 +- assets/hermes-runtime-invocation.excalidraw | 1569 +++++++++++++++++ assets/hermes-runtime-invocation.png | Bin 0 -> 97349 bytes docs/index.yml | 2 + .../harness/hermes-interfaces.mdx | 206 +++ docs/integrations/harness/hermes.mdx | 182 +- 6 files changed, 1834 insertions(+), 127 deletions(-) create mode 100644 assets/hermes-runtime-invocation.excalidraw create mode 100644 assets/hermes-runtime-invocation.png create mode 100644 docs/integrations/harness/hermes-interfaces.mdx diff --git a/adapters/python/hermes/README.md b/adapters/python/hermes/README.md index 52b99e036..27fcfc725 100644 --- a/adapters/python/hermes/README.md +++ b/adapters/python/hermes/README.md @@ -88,7 +88,7 @@ The descriptor validates the following `harness.settings` fields: | `save_trajectories` | boolean | `false` | Enables Hermes-native JSONL conversation trajectory saving. This is separate from normalized NeMo Fabric telemetry. | | `max_tokens` | positive integer | `512` | Limits the number of tokens in each Hermes model response. | | `terminal_timeout` | positive number | `60` | Limits a Hermes terminal operation in seconds. | -| `interfaces.api`, `interfaces.dashboard` | object | None | Serve Hermes's API server or dashboard from a runtime, each with an exact `port` and optional `enabled`; see [Serve the API Server and Dashboard](../../../docs/integrations/harness/hermes.mdx#serve-the-api-server-and-dashboard). | +| `interfaces.api`, `interfaces.dashboard` | object | None | Serve Hermes's API server or dashboard from a runtime, each with an exact `port` and optional `enabled`; see [Serve the API Server and Dashboard](../../../docs/integrations/harness/hermes-interfaces.mdx#serve-the-api-server-and-dashboard). | | `startup_timeout_seconds` | number, at most 75 | `60` | Time from the start of the runtime for every enabled interface to pass its health check. | For example: diff --git a/assets/hermes-runtime-invocation.excalidraw b/assets/hermes-runtime-invocation.excalidraw new file mode 100644 index 000000000..85aad0ebc --- /dev/null +++ b/assets/hermes-runtime-invocation.excalidraw @@ -0,0 +1,1569 @@ +{ + "type": "excalidraw", + "version": 2, + "source": "https://excalidraw.com", + "elements": [ + { + "id": "hermes-0", + "type": "text", + "x": 60, + "y": 8, + "width": 1200, + "height": 45, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1000, + "version": 1, + "versionNonce": 2000, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "text": "Hermes invocation paths: one Fabric runtime", + "originalText": "Hermes invocation paths: one Fabric runtime", + "fontSize": 30, + "fontFamily": 2, + "textAlign": "left", + "verticalAlign": "middle", + "containerId": null, + "autoResize": false, + "lineHeight": 1.25 + }, + { + "id": "hermes-1", + "type": "rectangle", + "x": 60, + "y": 180, + "width": 1220, + "height": 740, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "white", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": { + "type": 3 + }, + "seed": 1001, + "version": 1, + "versionNonce": 2001, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false + }, + { + "id": "hermes-2", + "type": "rectangle", + "x": 80, + "y": 158, + "width": 780, + "height": 45, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "#3b424b", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": { + "type": 3 + }, + "seed": 1002, + "version": 1, + "versionNonce": 2002, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false + }, + { + "id": "hermes-3", + "type": "text", + "x": 90, + "y": 166, + "width": 760, + "height": 29, + "angle": 0, + "strokeColor": "#ffffff", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1003, + "version": 1, + "versionNonce": 2003, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "text": "One Fabric runtime \u2014 shared lifecycle ownership", + "originalText": "One Fabric runtime \u2014 shared lifecycle ownership", + "fontSize": 23, + "fontFamily": 2, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": null, + "autoResize": false, + "lineHeight": 1.25 + }, + { + "id": "hermes-4", + "type": "rectangle", + "x": 110, + "y": 290, + "width": 490, + "height": 380, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "white", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": { + "type": 3 + }, + "seed": 1004, + "version": 1, + "versionNonce": 2004, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false + }, + { + "id": "hermes-5", + "type": "text", + "x": 130, + "y": 303, + "width": 450, + "height": 45, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1005, + "version": 1, + "versionNonce": 2005, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "text": "NeMo Fabric adapter host", + "originalText": "NeMo Fabric adapter host", + "fontSize": 24, + "fontFamily": 2, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": null, + "autoResize": false, + "lineHeight": 1.25 + }, + { + "id": "hermes-6", + "type": "rectangle", + "x": 150, + "y": 385, + "width": 410, + "height": 70, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "#e3f8e3", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": { + "type": 3 + }, + "seed": 1006, + "version": 1, + "versionNonce": 2006, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false + }, + { + "id": "hermes-7", + "type": "text", + "x": 160, + "y": 393, + "width": 390, + "height": 54, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1007, + "version": 1, + "versionNonce": 2007, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "text": "Hermes adapter", + "originalText": "Hermes adapter", + "fontSize": 23, + "fontFamily": 2, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": null, + "autoResize": false, + "lineHeight": 1.25 + }, + { + "id": "hermes-8", + "type": "rectangle", + "x": 150, + "y": 525, + "width": 410, + "height": 100, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "#e3f8e3", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": { + "type": 3 + }, + "seed": 1008, + "version": 1, + "versionNonce": 2008, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false + }, + { + "id": "hermes-9", + "type": "text", + "x": 160, + "y": 533, + "width": 390, + "height": 84, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1009, + "version": 1, + "versionNonce": 2009, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "text": "Embedded Hermes AIAgent\nFabric conversation", + "originalText": "Embedded Hermes AIAgent\nFabric conversation", + "fontSize": 23, + "fontFamily": 2, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": null, + "autoResize": false, + "lineHeight": 1.25 + }, + { + "id": "hermes-10", + "type": "rectangle", + "x": 730, + "y": 290, + "width": 490, + "height": 380, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "white", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": { + "type": 3 + }, + "seed": 1010, + "version": 1, + "versionNonce": 2010, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false + }, + { + "id": "hermes-11", + "type": "text", + "x": 750, + "y": 303, + "width": 450, + "height": 45, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1011, + "version": 1, + "versionNonce": 2011, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "text": "Managed Hermes Gateway", + "originalText": "Managed Hermes Gateway", + "fontSize": 24, + "fontFamily": 2, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": null, + "autoResize": false, + "lineHeight": 1.25 + }, + { + "id": "hermes-12", + "type": "rectangle", + "x": 770, + "y": 385, + "width": 410, + "height": 70, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "white", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": { + "type": 3 + }, + "seed": 1012, + "version": 1, + "versionNonce": 2012, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false + }, + { + "id": "hermes-13", + "type": "text", + "x": 780, + "y": 393, + "width": 390, + "height": 54, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1013, + "version": 1, + "versionNonce": 2013, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "text": "Native API / chat entry points", + "originalText": "Native API / chat entry points", + "fontSize": 23, + "fontFamily": 2, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": null, + "autoResize": false, + "lineHeight": 1.25 + }, + { + "id": "hermes-14", + "type": "rectangle", + "x": 770, + "y": 525, + "width": 410, + "height": 100, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "#e3f8e3", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": { + "type": 3 + }, + "seed": 1014, + "version": 1, + "versionNonce": 2014, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false + }, + { + "id": "hermes-15", + "type": "text", + "x": 780, + "y": 533, + "width": 390, + "height": 84, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1015, + "version": 1, + "versionNonce": 2015, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "text": "Gateway-side Hermes AIAgent\nNative conversation(s)", + "originalText": "Gateway-side Hermes AIAgent\nNative conversation(s)", + "fontSize": 23, + "fontFamily": 2, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": null, + "autoResize": false, + "lineHeight": 1.25 + }, + { + "id": "hermes-16", + "type": "rectangle", + "x": 140, + "y": 80, + "width": 430, + "height": 65, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "white", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": { + "type": 3 + }, + "seed": 1016, + "version": 1, + "versionNonce": 2016, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false + }, + { + "id": "hermes-17", + "type": "text", + "x": 150, + "y": 88, + "width": 410, + "height": 49, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1017, + "version": 1, + "versionNonce": 2017, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "text": "Application / Fabric SDK", + "originalText": "Application / Fabric SDK", + "fontSize": 23, + "fontFamily": 2, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": null, + "autoResize": false, + "lineHeight": 1.25 + }, + { + "id": "hermes-18", + "type": "arrow", + "x": 355, + "y": 145, + "width": 0, + "height": 240, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1018, + "version": 1, + "versionNonce": 2018, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "points": [ + [ + 0, + 0 + ], + [ + 0, + 240 + ] + ], + "lastCommittedPoint": null, + "startBinding": null, + "endBinding": null, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false + }, + { + "id": "hermes-19", + "type": "text", + "x": 255, + "y": 225, + "width": 200, + "height": 35, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1019, + "version": 1, + "versionNonce": 2019, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "text": "Runtime.invoke()", + "originalText": "Runtime.invoke()", + "fontSize": 19, + "fontFamily": 2, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": null, + "autoResize": false, + "lineHeight": 1.25 + }, + { + "id": "hermes-20", + "type": "arrow", + "x": 355, + "y": 455, + "width": 0, + "height": 70, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1020, + "version": 1, + "versionNonce": 2020, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "points": [ + [ + 0, + 0 + ], + [ + 0, + 70 + ] + ], + "lastCommittedPoint": null, + "startBinding": null, + "endBinding": null, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false + }, + { + "id": "hermes-21", + "type": "arrow", + "x": 600, + "y": 362, + "width": 130, + "height": 0, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1021, + "version": 1, + "versionNonce": 2021, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "points": [ + [ + 0, + 0 + ], + [ + 130, + 0 + ] + ], + "lastCommittedPoint": null, + "startBinding": null, + "endBinding": null, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false + }, + { + "id": "hermes-22", + "type": "text", + "x": 598, + "y": 322, + "width": 135, + "height": 30, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1022, + "version": 1, + "versionNonce": 2022, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "text": "owns child", + "originalText": "owns child", + "fontSize": 19, + "fontFamily": 2, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": null, + "autoResize": false, + "lineHeight": 1.25 + }, + { + "id": "hermes-23", + "type": "arrow", + "x": 975, + "y": 455, + "width": 0, + "height": 70, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1023, + "version": 1, + "versionNonce": 2023, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "points": [ + [ + 0, + 0 + ], + [ + 0, + 70 + ] + ], + "lastCommittedPoint": null, + "startBinding": null, + "endBinding": null, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false + }, + { + "id": "hermes-24", + "type": "rectangle", + "x": 1380, + "y": 370, + "width": 310, + "height": 90, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "white", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": { + "type": 3 + }, + "seed": 1024, + "version": 1, + "versionNonce": 2024, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false + }, + { + "id": "hermes-25", + "type": "text", + "x": 1390, + "y": 378, + "width": 290, + "height": 74, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1025, + "version": 1, + "versionNonce": 2025, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "text": "Native API client", + "originalText": "Native API client", + "fontSize": 23, + "fontFamily": 2, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": null, + "autoResize": false, + "lineHeight": 1.25 + }, + { + "id": "hermes-26", + "type": "arrow", + "x": 1380, + "y": 415, + "width": 200, + "height": 0, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1026, + "version": 1, + "versionNonce": 2026, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "points": [ + [ + 0, + 0 + ], + [ + -200, + 0 + ] + ], + "lastCommittedPoint": null, + "startBinding": null, + "endBinding": null, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false + }, + { + "id": "hermes-27", + "type": "rectangle", + "x": 1380, + "y": 560, + "width": 310, + "height": 90, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "#f4f4f4", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "dashed", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": { + "type": 3 + }, + "seed": 1027, + "version": 1, + "versionNonce": 2027, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false + }, + { + "id": "hermes-28", + "type": "text", + "x": 1390, + "y": 568, + "width": 290, + "height": 74, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1028, + "version": 1, + "versionNonce": 2028, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "text": "Stock Hermes TUI\nProposed terminal path", + "originalText": "Stock Hermes TUI\nProposed terminal path", + "fontSize": 21, + "fontFamily": 2, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": null, + "autoResize": false, + "lineHeight": 1.25 + }, + { + "id": "hermes-29", + "type": "arrow", + "x": 1380, + "y": 605, + "width": 220, + "height": 150, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "dashed", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1029, + "version": 1, + "versionNonce": 2029, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "points": [ + [ + 0, + 0 + ], + [ + -70, + 0 + ], + [ + -70, + -120 + ], + [ + -220, + -120 + ], + [ + -220, + -150 + ] + ], + "lastCommittedPoint": null, + "startBinding": null, + "endBinding": null, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false + }, + { + "id": "hermes-30", + "type": "rectangle", + "x": 300, + "y": 765, + "width": 740, + "height": 110, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "#f4f4f4", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": { + "type": 3 + }, + "seed": 1030, + "version": 1, + "versionNonce": 2030, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false + }, + { + "id": "hermes-31", + "type": "text", + "x": 310, + "y": 773, + "width": 720, + "height": 94, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1031, + "version": 1, + "versionNonce": 2031, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "text": "Shared Fabric-managed Hermes home\nNative config / workspace / persisted state", + "originalText": "Shared Fabric-managed Hermes home\nNative config / workspace / persisted state", + "fontSize": 23, + "fontFamily": 2, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": null, + "autoResize": false, + "lineHeight": 1.25 + }, + { + "id": "hermes-32", + "type": "arrow", + "x": 490, + "y": 625, + "width": 0, + "height": 140, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "dashed", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1032, + "version": 1, + "versionNonce": 2032, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "points": [ + [ + 0, + 0 + ], + [ + 0, + 140 + ] + ], + "lastCommittedPoint": null, + "startBinding": null, + "endBinding": null, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false + }, + { + "id": "hermes-33", + "type": "text", + "x": 410, + "y": 699, + "width": 160, + "height": 30, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1033, + "version": 1, + "versionNonce": 2033, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "text": "reads / writes", + "originalText": "reads / writes", + "fontSize": 19, + "fontFamily": 2, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": null, + "autoResize": false, + "lineHeight": 1.25 + }, + { + "id": "hermes-34", + "type": "arrow", + "x": 890, + "y": 625, + "width": 0, + "height": 140, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "dashed", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1034, + "version": 1, + "versionNonce": 2034, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "points": [ + [ + 0, + 0 + ], + [ + 0, + 140 + ] + ], + "lastCommittedPoint": null, + "startBinding": null, + "endBinding": null, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false + }, + { + "id": "hermes-35", + "type": "text", + "x": 810, + "y": 699, + "width": 160, + "height": 30, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1035, + "version": 1, + "versionNonce": 2035, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "text": "reads / writes", + "originalText": "reads / writes", + "fontSize": 19, + "fontFamily": 2, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": null, + "autoResize": false, + "lineHeight": 1.25 + }, + { + "id": "hermes-36", + "type": "text", + "x": 170, + "y": 938, + "width": 1020, + "height": 40, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1036, + "version": 1, + "versionNonce": 2036, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "text": "Same Hermes loop implementation; separate agent instances and conversations.", + "originalText": "Same Hermes loop implementation; separate agent instances and conversations.", + "fontSize": 22, + "fontFamily": 2, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": null, + "autoResize": false, + "lineHeight": 1.25 + }, + { + "id": "hermes-37", + "type": "text", + "x": 170, + "y": 981, + "width": 1020, + "height": 35, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1037, + "version": 1, + "versionNonce": 2037, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "text": "Stopping the Fabric runtime must stop both paths and their owned work.", + "originalText": "Stopping the Fabric runtime must stop both paths and their owned work.", + "fontSize": 21, + "fontFamily": 2, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": null, + "autoResize": false, + "lineHeight": 1.25 + }, + { + "id": "hermes-38", + "type": "rectangle", + "x": 580, + "y": 1090, + "width": 500, + "height": 65, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "white", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": { + "type": 3 + }, + "seed": 1038, + "version": 1, + "versionNonce": 2038, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false + }, + { + "id": "hermes-39", + "type": "text", + "x": 590, + "y": 1098, + "width": 480, + "height": 49, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1039, + "version": 1, + "versionNonce": 2039, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "text": "Configured model endpoint", + "originalText": "Configured model endpoint", + "fontSize": 23, + "fontFamily": 2, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": null, + "autoResize": false, + "lineHeight": 1.25 + }, + { + "id": "hermes-40", + "type": "arrow", + "x": 200, + "y": 625, + "width": 450, + "height": 465, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1040, + "version": 1, + "versionNonce": 2040, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "points": [ + [ + 0, + 0 + ], + [ + 0, + 425 + ], + [ + 450, + 425 + ], + [ + 450, + 465 + ] + ], + "lastCommittedPoint": null, + "startBinding": null, + "endBinding": null, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false + }, + { + "id": "hermes-41", + "type": "arrow", + "x": 1135, + "y": 625, + "width": 125, + "height": 465, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1041, + "version": 1, + "versionNonce": 2041, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "points": [ + [ + 0, + 0 + ], + [ + 0, + 425 + ], + [ + -125, + 425 + ], + [ + -125, + 465 + ] + ], + "lastCommittedPoint": null, + "startBinding": null, + "endBinding": null, + "startArrowhead": null, + "endArrowhead": "arrow", + "elbowed": false + }, + { + "id": "hermes-42", + "type": "text", + "x": 1360, + "y": 695, + "width": 340, + "height": 100, + "angle": 0, + "strokeColor": "#3b424b", + "backgroundColor": "transparent", + "fillStyle": "solid", + "strokeWidth": 2, + "strokeStyle": "solid", + "roughness": 0, + "opacity": 100, + "groupIds": [], + "frameId": null, + "roundness": null, + "seed": 1042, + "version": 1, + "versionNonce": 2042, + "isDeleted": false, + "boundElements": [], + "updated": 1793908800000, + "link": null, + "locked": false, + "text": "Native requests bypass\nFabric Runtime.invoke()", + "originalText": "Native requests bypass\nFabric Runtime.invoke()", + "fontSize": 20, + "fontFamily": 2, + "textAlign": "center", + "verticalAlign": "middle", + "containerId": null, + "autoResize": false, + "lineHeight": 1.25 + } + ], + "appState": { + "viewBackgroundColor": "#ffffff", + "exportBackground": true, + "exportEmbedScene": true, + "gridSize": null + }, + "files": {} +} diff --git a/assets/hermes-runtime-invocation.png b/assets/hermes-runtime-invocation.png new file mode 100644 index 0000000000000000000000000000000000000000..ef35128a814e8cd4d98bdc4039d8157c42c49ed0 GIT binary patch literal 97349 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 S#u?#{ugpWm2SvyyFaHNn`~*q> literal 0 HcmV?d00001 diff --git a/docs/index.yml b/docs/index.yml index a54dbeca5..97c5d7d05 100644 --- a/docs/index.yml +++ b/docs/index.yml @@ -76,6 +76,8 @@ navigation: path: ./integrations/harness/droid.mdx - page: Hermes Agent path: ./integrations/harness/hermes.mdx + - page: Hermes Native Interfaces + path: ./integrations/harness/hermes-interfaces.mdx - page: LangChain Deep Agents path: ./integrations/harness/deepagents.mdx - page: Kilo Code diff --git a/docs/integrations/harness/hermes-interfaces.mdx b/docs/integrations/harness/hermes-interfaces.mdx new file mode 100644 index 000000000..cc2cd224b --- /dev/null +++ b/docs/integrations/harness/hermes-interfaces.mdx @@ -0,0 +1,206 @@ +--- +title: "Hermes Native Interfaces" +description: "Run Hermes native interfaces alongside SDK invocations, with shared configuration and distinct conversations." +--- +{/* SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved. +SPDX-License-Identifier: Apache-2.0 */} + +NVIDIA NeMo Fabric can start Hermes's native API server and dashboard alongside its embedded SDK agent. One Fabric runtime owns these execution paths, while each retains its own agent instances and conversations. Start with the [Hermes adapter guide](./hermes.mdx) for installation and normalized SDK configuration. + +## Invocation Paths + +![One Fabric runtime owns an embedded Hermes agent and a managed Hermes Gateway. SDK calls use the embedded agent; native clients use gateway agents with separate conversations. The dashed TUI path is proposed.](../../../assets/hermes-runtime-invocation.png) + +The [editable Excalidraw diagram](../../../assets/hermes-runtime-invocation.excalidraw) shows the intended ownership model. The TUI path is proposed; the adapter currently exposes API and dashboard settings only. + +| Path | Execution | Conversation and result | +| --- | --- | --- | +| `Runtime.invoke()` or `Runtime.invoke_stream()` | The embedded Hermes `AIAgent` in the adapter host | Reuses the Fabric conversation and produces a normalized Fabric `RunResult`; for streaming, retrieve it through `stream.result()`. | +| Native API | Hermes creates gateway-side agent instances | Uses native conversations and returns native API responses. | +| Browser chat | Hermes's dashboard and native gateway facilities | Uses native conversation behavior and browser responses. | + +These agents run the same Hermes agent-loop implementation. Sharing a Hermes home gives them access to persisted resources; it does not combine their live state or attach a native conversation to Fabric's embedded conversation. + +### What NeMo Fabric Normalizes + +| Surface | SDK invocation | Native interfaces | +| --- | --- | --- | +| Configuration | Mapped from `FabricConfig` | Managed child processes receive the same behavioral mapping and generated native configuration. | +| Lifecycle | Managed by the runtime | The adapter starts and stops its child processes. Descendant cleanup and independently started gateways have limits described below. | +| Results | Normalized `RunResult`, including available usage and artifact references | Native responses are not converted into Fabric `RunResult` objects. | +| Relay evidence | Standard Relay artifacts and invocation telemetry references | Supported native events use Relay's standard formats and native session identities. Emitting those records does not create a normalized invocation result. | +| Session artifacts | Collected through the SDK invocation path | Native session storage is shared, but session-scoped collection into Fabric's artifact model remains separate work. | + +## Enable Native Interfaces + +Select interfaces through the Hermes adapter's `harness.settings`: + +```python +from nemo_fabric import HarnessConfig + +harness = HarnessConfig( + adapter_id="nvidia.fabric.hermes", + settings={ + "interfaces": { + "api": {"port": 8642}, + "dashboard": {"port": 9119}, + }, + "startup_timeout_seconds": 60, + }, +) +``` + +Use this harness selection with the rest of your `FabricConfig`. The model, instructions, tools, MCP, skills, workspace, and telemetry remain in their existing normalized configuration fields; do not duplicate them under `interfaces`. + +| Setting | Default | Behavior | +| --- | --- | --- | +| `interfaces.api` | Absent | API settings: required integer `port` from 1 through 65535, optional `enabled` boolean defaulting to `true`. | +| `interfaces.dashboard` | Absent | Dashboard settings with the same `port` and `enabled` requirements. | +| `startup_timeout_seconds` | `60` | Positive budget of at most 75 seconds, counted from the beginning of runtime startup. | + +An absent interface is off. A present interface is on unless `enabled` is `false`; its closed schema currently requires a port even when disabled. Choose distinct, available ports for enabled interfaces. Ports bind to loopback in the adapter environment. No terminal interface setting is implemented yet. + +## How Shared Configuration Reaches Native Agents + +NeMo Fabric resolves `FabricConfig` into a validated `AgentConfig`. The Hermes adapter uses that configuration for its embedded agent and prepares three configuration surfaces for managed native children: + +| Surface | Contents | Delivery | +| --- | --- | --- | +| Hermes `config.yaml` | Native model routing, workspace, MCP servers, skills, plugins, and toolset configuration | Written in the runtime's Hermes home, selected through `HERMES_HOME`. | +| `interfaces/agent-config.json` | The validated agent configuration, including instructions and behavioral settings | Owner-only snapshot passed by path to the adapter-owned native launcher. Removed on stop. | +| Relay plugin configuration | Resolved Relay components and output configuration | Generated by the adapter; its path is passed through `HERMES_NEMO_RELAY_PLUGINS_TOML`. | + +The model credential value is supplied through the child's environment; the native model configuration references `api_key_env`. + +### Apply Settings When Agents Are Created + +Hermes v0.22.5's API constructor does not read every behavioral setting from `config.yaml`. The adapter therefore launches managed children through `nemo_fabric_adapters.hermes.native`, which installs a process-local subclass of Hermes's `AIAgent` before entering the native CLI. + +Each native agent constructed in that process receives the same behavioral mapping as the embedded agent: enabled and blocked toolsets, turn limit, token limit, temperature, top-p, reasoning configuration, and trajectory setting. Configured system instructions take precedence over the native instruction argument. Native routing, session identity, agent execution, and protocol remain Hermes behavior; the installed Hermes source is unchanged. + +This mapping applies within adapter-launched processes. A gateway independently spawned by Hermes does not automatically inherit the constructor mapping, even if it uses the same home. Sharing a configuration directory alone does not establish configuration parity. + +### Relay and Artifacts + +Enable Relay through the normal NeMo Fabric telemetry configuration. The embedded and managed native paths receive the generated Relay plugin configuration. Native sessions retain their own trace roots rather than being assigned to the embedded Fabric invocation. + +For SDK invocations, the adapter finalizes the Hermes Relay session and flushes subscribers before returning, so available ATOF/ATIF artifacts are complete at the invocation boundary. With a live Relay runtime, Hermes emits `compaction` when tracked compaction rewrites history or provider state; `compaction.attempt` describes an attempt that is blocked, skipped, fails, or aborts without a rewrite. + +Native API responses remain native responses. Relay's standard artifact format provides common execution evidence, but does not by itself provide Fabric result normalization, complete usage accounting, or session-scoped collection of native transcripts and generated files. + +## Serve the API Server and Dashboard + +Both interfaces are optional and require a POSIX host. The API server needs `aiohttp` from Hermes's `messaging` extra. The dashboard needs a built frontend at `HERMES_WEB_DIST` or `hermes_cli/web_dist`; browser chat also needs Hermes's built terminal UI bundle. The adapter does not build these frontends. Windows startup fails with `hermes_interfaces_unsupported_platform` before native setup. + +### API Access + +The API server binds to `127.0.0.1` at its configured port. After every enabled interface passes readiness, the adapter writes a per-start bearer token with mode `0600` to: + +```text +/.fabric/hermes/runtimes//interfaces/api.token +``` + +Send the token as `Authorization: Bearer `. Only the API gateway child receives it in its environment. Processes running as the runtime's user, including agent tools, can read the token file. + +### Dashboard Access + +Open the configured loopback port in a browser. The dashboard has no sign-in: Hermes embeds its session token in the page, so anyone who can reach that port can use its pages and browser chat. The adapter does not disable individual dashboard pages. + +Children inherit the adapter host's environment after ambient `API_SERVER_*` variables are removed. The API gateway can also activate other Hermes platforms configured by that environment, such as Telegram through `TELEGRAM_BOT_TOKEN` or webhooks through `WEBHOOK_ENABLED`. + +## Understand the Runtime Lifecycle + +Each runtime owns one embedded `AIAgent` and `SessionDB`. Ordered SDK invocations reuse these objects and their conversation history. The adapter stores the Hermes home under `/.fabric/hermes/runtimes/`. Sharing this home with native interfaces does not make their conversations the same conversation or establish cross-runtime resume. + +### Startup and Shutdown + +Startup launches enabled interfaces as child processes on the adapter's interpreter. The API server must pass `GET /health`, and the dashboard must pass `GET /api/status`, within the remaining startup budget. An occupied port, early child exit, or readiness timeout fails startup. Failed startup attempts clean up the children they started. + +Stop removes the API token, sends SIGTERM to running interface process groups, and escalates to SIGKILL after a five-second grace. The API gateway is configured with a three-second drain for API work and cron jobs. The agent configuration snapshot is removed during cleanup, and the adapter closes the embedded agent and session database. + +## How to Test + +### Run Automated Regressions + +Prepare the repository's Hermes environment as described in [Install the Adapter](./hermes.mdx#install-the-adapter), then run these commands from the repository root: + +```bash +export ADAPTER_PYTHON="$PWD/.venv-hermes/bin/python" +.venv-hermes/bin/python -m pytest \ + tests/adapters/test_hermes_native_config.py \ + tests/adapters/test_hermes_config_builder.py \ + tests/adapters/test_hermes_interfaces.py -q +``` + +These tests exercise the installed native Hermes processes against a local mock model endpoint. They check configuration mapping, two fresh API conversations, private configuration files, authentication, readiness failures, and cleanup. They do not establish compatibility with your hosted model or qualify browser interaction. + +### Check a Live Model Endpoint + +Reuse the `config` example from the [adapter guide](./hermes.mdx#configure-the-adapter), replacing its endpoint, model, and credential reference with your own values. With the Hermes interpreter selected through `ADAPTER_PYTHON`, run the following code in the same script: + +```python +import asyncio +import json +from pathlib import Path +from urllib.request import Request, urlopen + +from nemo_fabric import Fabric + +marker = "FABRIC_CONFIG_CHECK" +config.harness.settings["interfaces"] = {"api": {"port": 8642}} +config.instructions.system.content = f"Reply exactly {marker} to every user message. Do not call tools." +config.models["default"].temperature = 0.0 +config.models["default"].top_p = 0.41 +config.models["default"].max_tokens = 128 +config.environment.artifacts = Path("artifacts/hermes-interface-check").resolve() + +def native_turn(token, number): + request = Request( + "http://127.0.0.1:8642/v1/chat/completions", + data=json.dumps({ + "model": "hermes-agent", + "messages": [{"role": "user", "content": f"Hello, conversation {number}."}], + }).encode(), + headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"}, + ) + with urlopen(request, timeout=120) as response: + return json.load(response)["choices"][0]["message"]["content"] + +async def main(): + async with await Fabric().start_runtime(config) as runtime: + result = await runtime.invoke(input="Please respond to this simple greeting without using tools.") + assert result.output.response == marker + token_path = ( + config.environment.artifacts / ".fabric/hermes/runtimes" + / runtime.runtime_id / "interfaces/api.token" + ) + token = token_path.read_text() + for number in range(2): + assert await asyncio.to_thread(native_turn, token, number) == marker + assert not token_path.exists() + +asyncio.run(main()) +``` + +This is an instruction and access smoke test. To establish configuration parity, also inspect actual model requests using your endpoint's request capture or a test-owned forwarding recorder. Do not infer parity from matching answers or generated files alone. + +| Check | Required evidence | +| --- | --- | +| Model and credentials | Both paths call the configured endpoint/model with the intended credential; do not record credential values. | +| Instructions and generation | Captured requests contain the marker instruction, temperature `0`, top-p `0.41`, and token limit `128`. | +| Tool policy | The file-only configuration exposes `read_file`, `write_file`, `patch`, and `search_files`, without unrelated tools. Test blocked-tool behavior separately. | +| Conversation isolation | Two fresh native conversations remain distinct from each other and the embedded Fabric conversation. | +| Relay | With Relay enabled, actual turns emit supported records with distinct native session roots. Check artifact contents and attribution, not just file existence. | +| Cleanup | Runtime stop removes the API token and configuration snapshot and terminates the managed child. Descendant termination needs its own evidence where group signals are denied. | + +An SDK call returns a normalized `RunResult`; the native call returns an API response. Successful Relay capture does not change that result boundary. + +## Limitations + +- Denied process-group signals fall back to the direct child. This does not guarantee that all descendants have stopped. +- The adapter does not restart an interface child after a crash. Dashboard gateway actions can start processes outside the adapter launcher and its configuration mapping. +- Readiness currently checks the HTTP response without verifying that the child owns the listening port. +- Browser interaction, TUI, explicit resume, and gateway replacement have not been qualified by the API configuration-parity tests. The TUI remains proposed functionality. +- Native responses, complete usage accounting, and session-scoped collection of native transcripts and generated files are not normalized into Fabric invocation results by these interfaces. +- Child processes inherit the embedded adapter's `HERMES_YOLO_MODE` environment setting. Interactive approval behavior requires separate review and validation. + diff --git a/docs/integrations/harness/hermes.mdx b/docs/integrations/harness/hermes.mdx index dc7044238..03e9dfaed 100644 --- a/docs/integrations/harness/hermes.mdx +++ b/docs/integrations/harness/hermes.mdx @@ -1,169 +1,99 @@ --- title: "Use the Hermes Agent Adapter" -description: "Install and configure the NeMo Fabric harness integration for Hermes Agent." +description: "Configure Hermes Agent, understand its invocation paths, and serve native interfaces with NeMo Fabric." --- {/* SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved. SPDX-License-Identifier: Apache-2.0 */} -The NVIDIA NeMo Fabric `nvidia.fabric.hermes` adapter runs Hermes Agent through -its Python SDK. The adapter maps normalized NeMo Fabric configuration into -Hermes Agent models, tools, skills, Model Context Protocol (MCP) servers, -sessions, and Relay telemetry. +The NVIDIA NeMo Fabric `nvidia.fabric.hermes` adapter runs Hermes Agent through its Python SDK. It maps normalized configuration into an embedded agent, reuses its conversation across ordered invocations, and returns normalized results and telemetry references. + +For native API and browser access, invocation-path diagrams, and shared configuration behavior, see [Hermes native interfaces](./hermes-interfaces.mdx). ## Install the Adapter -The adapter package supports Python 3.11 through 3.14. Use [Hermes Agent v0.22.5](https://github.com/NousResearch/hermes-agent/releases/tag/v0.22.5) with Python 3.14. This release includes dependency security fixes absent from v2026.9.24 and supports Relay telemetry and streaming. Hermes Agent 0.20 and later is not installable from PyPI. Follow the [Hermes Agent installation guide](https://hermes-agent.nousresearch.com/docs/installation) and select v0.22.5. +Use [Hermes Agent v0.22.5](https://github.com/NousResearch/hermes-agent/releases/tag/v0.22.5) with Python 3.14. The adapter package supports Python 3.11 through 3.14, but Hermes Agent must be installed separately from source; versions 0.20 and later are not available from PyPI. Follow the [Hermes Agent installation guide](https://hermes-agent.nousresearch.com/docs/installation) and select v0.22.5. -Install the NeMo Fabric runtime and bare Hermes adapter into the Python -environment that runs Hermes Agent: +Install the runtime and adapter in the environment that runs Hermes: ```bash -pip install "nemo-fabric[hermes-agent]" +python -m pip install "nemo-fabric[hermes-agent]" ``` -These packages do not install Hermes Agent. If a different environment runs -NeMo Fabric, install only the bare adapter in the Hermes Agent environment: +If the application runs NeMo Fabric in a separate environment, install `nemo-fabric-adapters-hermes` in the Hermes environment and set `ADAPTER_PYTHON` in the application's environment to that interpreter. Use matching runtime and adapter release versions unless a different pairing has been validated. -```bash -python -m pip install nemo-fabric-adapters-hermes -``` +For Relay, install the adapter's `relay` extra in the Hermes environment. It requires `nemo-relay>=0.10,<0.11`; keep this environment separate from applications using Relay 0.11 for other adapters. Startup rejects unsupported Hermes/Relay combinations. -The adapter's `relay` and `full` extras install `nemo-relay>=0.10,<0.11`. Install Hermes Agent separately in the same environment. Keep that environment separate from applications that use Relay 0.11 for other NeMo Fabric adapters. The adapter reports a compatibility error at startup if Relay telemetry is enabled with an unsupported Hermes or Relay installation. - -For local NeMo Fabric development, run the following command from the repository root. The recipe checks out Hermes Agent v0.22.5 at commit `bf0203a794a07aac3ff764972ab9087baa4e4f4e` and creates an isolated Python 3.14 environment with the adapter's `relay` extra. Hermes declares its Python package version as `0.0.0`; use the Git tag and commit to identify the release when reviewing scanner results. +For repository development, the following recipe checks out v0.22.5 at `bf0203a794a07aac3ff764972ab9087baa4e4f4e` and prepares an isolated Python 3.14 environment with Relay support: ```bash just install-hermes-agent export ADAPTER_PYTHON="$PWD/.venv-hermes/bin/python" ``` -For separate environments, set `ADAPTER_PYTHON` in the runtime environment to -the adapter environment's Python interpreter. Use -matching NeMo Fabric release versions for the runtime and adapter package -unless a different pairing has been explicitly validated. +Hermes reports its Python package version as `0.0.0`, so use its Git tag and commit to identify the installed release. The pinned release includes dependency security fixes absent from v2026.9.24. ## Configure the Adapter -Select the Hermes Agent harness integration in `HarnessConfig`: - -```python -from nemo_fabric import HarnessConfig - -harness = HarnessConfig(adapter_id="nvidia.fabric.hermes") -``` - -Use normalized `FabricConfig` fields to configure the model, workspace, skills, -MCP servers, replacement system instructions, turn limit, and native tool -selectors, and telemetry. The adapter rejects `append` system instructions. +Use normalized `FabricConfig` fields for the model, instructions, tools, skills, MCP servers, workspace, turn limit, and telemetry. Use `harness.settings` for Hermes-specific options and native interface selection. -During run-plan resolution, NeMo Fabric Core validates the -`models..top_p` (from 0 through 1) and positive -`models..max_tokens` fields against the Hermes descriptor before -runtime startup. Hermes reads these prevalidated values from `AgentConfig`. A -model-level `max_tokens` overrides the harness-level default for the selected -model role. - -The Hermes descriptor validates the following `harness.settings` fields: - -| Setting | Type | Default | Description | -| --- | --- | --- | --- | -| `reasoning_config` | object | `{"effort": "none"}` | Configures Hermes model reasoning. The closed object accepts an optional `enabled` boolean and an optional `effort` value of `none`, `minimal`, `low`, `medium`, `high`, or `xhigh`. | -| `plugins_enabled` | array of nonempty strings | `[]` | Enables Hermes plugins by identifier. Relay telemetry uses the generated `plugins.toml`; do not list the removed `observability/nemo_relay` plugin. | -| `save_trajectories` | boolean | `false` | Enables Hermes-native JSONL conversation trajectory saving. This is separate from normalized NeMo Fabric telemetry. | -| `max_tokens` | positive integer | `512` | Limits the number of tokens in each Hermes model response. | -| `terminal_timeout` | positive number | `60` | Limits a Hermes terminal operation in seconds. | - -For example: +The following example configures an embedded SDK agent with file tools: ```python -from nemo_fabric import HarnessConfig - -harness = HarnessConfig( - adapter_id="nvidia.fabric.hermes", - settings={ - "reasoning_config": {"enabled": True, "effort": "medium"}, - "plugins_enabled": ["disk-cleanup"], - "save_trajectories": True, - "max_tokens": 1024, - "terminal_timeout": 90, - }, +from nemo_fabric import FabricConfig + +config = FabricConfig.from_mapping( + { + "metadata": {"name": "hermes-agent"}, + "harness": { + "adapter_id": "nvidia.fabric.hermes", + }, + "models": { + "default": { + "provider": "openai", + "model": "your-model", + "base_url": "http://MODEL_HOST:8000/v1", + "api_key_env": "MODEL_API_KEY", + "temperature": 0.0, + "top_p": 0.9, + "max_tokens": 1024, + } + }, + "instructions": { + "system": {"mode": "replace", "content": "Help with files in the workspace."} + }, + "tools": {"enabled": ["file"], "blocked": ["terminal"]}, + "runtime": {"max_turns": 8}, + "environment": {"provider": "local", "workspace": "."}, + } ) ``` -Use `runtime.max_turns` to set the Hermes agent-loop budget. The adapter maps -that normalized field to `AIAgent.max_iterations`; `max_iterations` is not a -Hermes harness setting. - -## Understand the Runtime Lifecycle +Replace the endpoint and model, and provide `MODEL_API_KEY` in the adapter environment before starting. To add native API or browser access, follow the [Hermes native interfaces guide](./hermes-interfaces.mdx). -Each NeMo Fabric runtime creates one Hermes Agent `AIAgent` and one `SessionDB`. -Ordered invocations reuse those objects and the conversation history until the -runtime stops. The adapter finalizes and flushes Relay subscriber output after -each invocation so ATOF and ATIF artifacts are complete when it returns. +The adapter supports `instructions.system.mode: replace` and rejects `append`. Tool selectors are Hermes toolset names. `models..top_p` must be between 0 and 1, and `max_tokens` must be positive. A model-level token limit takes precedence over the harness-level default. Use `runtime.max_turns`, not a `max_iterations` harness setting, to control the agent loop. -With a live Relay runtime, Hermes emits `compaction` when a tracked compaction -rewrites history or provider state. It emits `compaction.attempt` when the -attempt is blocked, skipped, fails, or aborts without a rewrite. +### Hermes Settings -For the complete configuration and lifecycle reference, refer to the -[Hermes Agent adapter guide](https://github.com/NVIDIA/NeMo-Fabric/tree/main/adapters/python/hermes). +The descriptor uses closed schemas, so unknown settings are rejected. -## Serve the API Server and Dashboard +| Setting | Default | Behavior | +| --- | --- | --- | +| `reasoning_config` | `{"effort": "none"}` | Optional `enabled` boolean and `effort`: `none`, `minimal`, `low`, `medium`, `high`, or `xhigh`. | +| `plugins_enabled` | `[]` | List of nonempty native plugin identifiers. Relay uses its generated plugin configuration; do not list the removed `observability/nemo_relay` plugin. | +| `save_trajectories` | `false` | Save native JSONL trajectories; separate from normalized telemetry. | +| `max_tokens` | `512` | Positive response-token limit when the selected model has no limit. | +| `terminal_timeout` | `60` | Positive timeout in seconds for a Hermes terminal tool operation; this does not enable a TUI. | -A runtime can serve Hermes's API server and dashboard as child processes -alongside its embedded agent: +Native interface settings are documented in the [Hermes native interfaces guide](./hermes-interfaces.mdx#enable-native-interfaces). -```python -from nemo_fabric import HarnessConfig +## Understand the Runtime Lifecycle -harness = HarnessConfig( - adapter_id="nvidia.fabric.hermes", - settings={"interfaces": {"api": {"port": 8642}, "dashboard": {"port": 9119}}}, -) -``` +Each runtime creates one embedded Hermes `AIAgent` and one `SessionDB`. Ordered SDK invocations reuse these objects and their conversation history until stop closes them. The Hermes home is stored under `/.fabric/hermes/runtimes/`; retaining files does not by itself establish cross-runtime conversation resume. -- The adapter starts `python -m hermes_cli.main gateway run` for the API server - and `python -m hermes_cli.main dashboard --skip-build --isolated`, on the - adapter's interpreter and the runtime's Hermes home, each on `127.0.0.1` at - its port. Each must pass its health check, `GET /health` or - `GET /api/status`, within `startup_timeout_seconds` (60 by default, at most - 75) of the runtime's start. `start` fails if a port is in use or a child exits first; a failed - start stops the children it started and leaves no token. Set `enabled` to - `false` to keep a configured interface off. -- The children inherit the adapter host's environment without its - `API_SERVER_*` variables. The gateway also starts any other Hermes platform - that this environment configures, such as Telegram with `TELEGRAM_BOT_TOKEN` - or webhooks with `WEBHOOK_ENABLED`. -- Once every enabled interface passes, the adapter writes the API server's - bearer token, generated at each start, to - `/.fabric/hermes/runtimes//interfaces/api.token` - with mode `0600`. Send it as `Authorization: Bearer `. Only the - gateway child receives it. Processes that run as the runtime's user, - including the agent's own tools, can read it. -- The dashboard has no sign-in. On loopback, Hermes embeds its session token in - the page, so anyone who can reach the port can use the dashboard and its - browser chat, which runs the agent. The adapter turns off none of its pages. - Browser chat needs Hermes's built terminal UI bundle. -- With interfaces enabled, the adapter writes an `openai` or `custom` model - that has a `base_url` to `config.yaml` as Hermes's `custom` provider, with - its key as a reference to `api_key_env`, so the API server and browser chat - use the configured endpoint and key. -- Managed children launch through an adapter-owned bootstrap that applies Fabric's instructions, enabled/blocked toolsets, turn limit, generation settings, and trajectory setting when native Hermes agent instances are constructed. Fabric-owned settings take precedence over native constructor defaults and instruction overrides. Native provider routing and session identity remain unchanged. The bootstrap reads an owner-only `interfaces/agent-config.json` snapshot, removed on stop, because Hermes v0.22.5's API constructor does not read all these settings from `config.yaml`. Independently started gateways bypass the bootstrap. -- `stop` removes the token, sends SIGTERM to each child's process group, and - SIGKILL to what remains after 5 seconds. The gateway drains in-flight API - runs and cron jobs for 3 seconds. After start, a child that exits doesn't fail - the runtime check, and NeMo Fabric doesn't restart it. -- The embedded agent, the gateway, the dashboard and browser chat share the - Hermes home, and Hermes coordinates their writes. The dashboard's gateway - actions, such as restart, start Hermes processes outside the runtime. -- The API server needs `aiohttp`, from Hermes's `messaging` extra. The dashboard - needs a built frontend at `HERMES_WEB_DIST` or Hermes's own - `hermes_cli/web_dist`; the adapter never builds it. Interfaces need a POSIX - host: on Windows, `start` fails with `hermes_interfaces_unsupported_platform` - before any child starts. +SDK invocations return normalized Fabric `RunResult` objects. The adapter finalizes the Hermes Relay session and flushes subscribers before returning, so available ATOF/ATIF artifacts are complete at that invocation boundary. Native interface responses follow a different path, described in [What NeMo Fabric Normalizes](./hermes-interfaces.mdx#what-nemo-fabric-normalizes). ## Runtime Health -`Fabric.check()` supports `live`, `active`, and `ready`. The adapter checks native agent and database ownership, the initialized invocation interface, and a fresh `get_activity_summary()` diagnostic response. +`Fabric.check()` supports `live`, `active`, and `ready`. It checks the embedded agent's session/database ownership, invocation interface, and a fresh `get_activity_summary()` diagnostic response. These checks do not establish native interface-child health after startup. -Refer to the [SDK health-check overview](../../sdk/health-checks.mdx) for shared behavior and a comparison of native evidence across adapters. +Refer to the [SDK health-check overview](../../sdk/health-checks.mdx) and the [Hermes adapter reference](https://github.com/NVIDIA/NeMo-Fabric/tree/main/adapters/python/hermes) for additional details. From 8d441bee3259e4db07afc6a367574480c1297cfd Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Thu, 5 Nov 2026 13:28:01 -0800 Subject: [PATCH 20/34] docs: update Hermes invocation diagram Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- assets/hermes-runtime-invocation.excalidraw | 513 ++++++++++++-------- assets/hermes-runtime-invocation.png | Bin 97349 -> 220162 bytes 2 files changed, 320 insertions(+), 193 deletions(-) diff --git a/assets/hermes-runtime-invocation.excalidraw b/assets/hermes-runtime-invocation.excalidraw index 85aad0ebc..0559c4441 100644 --- a/assets/hermes-runtime-invocation.excalidraw +++ b/assets/hermes-runtime-invocation.excalidraw @@ -1,7 +1,7 @@ { "type": "excalidraw", "version": 2, - "source": "https://excalidraw.com", + "source": "https://app.excalidraw.com", "elements": [ { "id": "hermes-0", @@ -22,11 +22,11 @@ "frameId": null, "roundness": null, "seed": 1000, - "version": 1, - "versionNonce": 2000, + "version": 2, + "versionNonce": 970466068, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, "locked": false, "text": "Hermes invocation paths: one Fabric runtime", @@ -37,7 +37,11 @@ "verticalAlign": "middle", "containerId": null, "autoResize": false, - "lineHeight": 1.25 + "lineHeight": 1.25, + "index": "a0", + "created": null, + "labelPosition": null, + "baseFontSize": null }, { "id": "hermes-1", @@ -60,13 +64,15 @@ "type": 3 }, "seed": 1001, - "version": 1, - "versionNonce": 2001, + "version": 2, + "versionNonce": 159270956, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, - "locked": false + "locked": false, + "index": "a1", + "created": null }, { "id": "hermes-2", @@ -89,13 +95,15 @@ "type": 3 }, "seed": 1002, - "version": 1, - "versionNonce": 2002, + "version": 2, + "versionNonce": 176857236, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, - "locked": false + "locked": false, + "index": "a2", + "created": null }, { "id": "hermes-3", @@ -116,22 +124,26 @@ "frameId": null, "roundness": null, "seed": 1003, - "version": 1, - "versionNonce": 2003, + "version": 2, + "versionNonce": 828138156, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, "locked": false, - "text": "One Fabric runtime \u2014 shared lifecycle ownership", - "originalText": "One Fabric runtime \u2014 shared lifecycle ownership", + "text": "One Fabric runtime — shared lifecycle ownership", + "originalText": "One Fabric runtime — shared lifecycle ownership", "fontSize": 23, "fontFamily": 2, "textAlign": "center", "verticalAlign": "middle", "containerId": null, "autoResize": false, - "lineHeight": 1.25 + "lineHeight": 1.25, + "index": "a3", + "created": null, + "labelPosition": null, + "baseFontSize": null }, { "id": "hermes-4", @@ -154,13 +166,15 @@ "type": 3 }, "seed": 1004, - "version": 1, - "versionNonce": 2004, + "version": 2, + "versionNonce": 1796304404, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, - "locked": false + "locked": false, + "index": "a4", + "created": null }, { "id": "hermes-5", @@ -181,11 +195,11 @@ "frameId": null, "roundness": null, "seed": 1005, - "version": 1, - "versionNonce": 2005, + "version": 2, + "versionNonce": 462630188, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, "locked": false, "text": "NeMo Fabric adapter host", @@ -196,7 +210,11 @@ "verticalAlign": "middle", "containerId": null, "autoResize": false, - "lineHeight": 1.25 + "lineHeight": 1.25, + "index": "a5", + "created": null, + "labelPosition": null, + "baseFontSize": null }, { "id": "hermes-6", @@ -219,13 +237,15 @@ "type": 3 }, "seed": 1006, - "version": 1, - "versionNonce": 2006, + "version": 2, + "versionNonce": 2086833044, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, - "locked": false + "locked": false, + "index": "a6", + "created": null }, { "id": "hermes-7", @@ -246,11 +266,11 @@ "frameId": null, "roundness": null, "seed": 1007, - "version": 1, - "versionNonce": 2007, + "version": 2, + "versionNonce": 1502390188, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, "locked": false, "text": "Hermes adapter", @@ -261,7 +281,11 @@ "verticalAlign": "middle", "containerId": null, "autoResize": false, - "lineHeight": 1.25 + "lineHeight": 1.25, + "index": "a7", + "created": null, + "labelPosition": null, + "baseFontSize": null }, { "id": "hermes-8", @@ -284,13 +308,15 @@ "type": 3 }, "seed": 1008, - "version": 1, - "versionNonce": 2008, + "version": 2, + "versionNonce": 1353971988, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, - "locked": false + "locked": false, + "index": "a8", + "created": null }, { "id": "hermes-9", @@ -311,11 +337,11 @@ "frameId": null, "roundness": null, "seed": 1009, - "version": 1, - "versionNonce": 2009, + "version": 2, + "versionNonce": 1064489516, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, "locked": false, "text": "Embedded Hermes AIAgent\nFabric conversation", @@ -326,7 +352,11 @@ "verticalAlign": "middle", "containerId": null, "autoResize": false, - "lineHeight": 1.25 + "lineHeight": 1.25, + "index": "a9", + "created": null, + "labelPosition": null, + "baseFontSize": null }, { "id": "hermes-10", @@ -349,13 +379,15 @@ "type": 3 }, "seed": 1010, - "version": 1, - "versionNonce": 2010, + "version": 2, + "versionNonce": 1132181140, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, - "locked": false + "locked": false, + "index": "aA", + "created": null }, { "id": "hermes-11", @@ -376,11 +408,11 @@ "frameId": null, "roundness": null, "seed": 1011, - "version": 1, - "versionNonce": 2011, + "version": 2, + "versionNonce": 204450988, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, "locked": false, "text": "Managed Hermes Gateway", @@ -391,7 +423,11 @@ "verticalAlign": "middle", "containerId": null, "autoResize": false, - "lineHeight": 1.25 + "lineHeight": 1.25, + "index": "aB", + "created": null, + "labelPosition": null, + "baseFontSize": null }, { "id": "hermes-12", @@ -414,13 +450,15 @@ "type": 3 }, "seed": 1012, - "version": 1, - "versionNonce": 2012, + "version": 2, + "versionNonce": 1366279188, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, - "locked": false + "locked": false, + "index": "aC", + "created": null }, { "id": "hermes-13", @@ -441,11 +479,11 @@ "frameId": null, "roundness": null, "seed": 1013, - "version": 1, - "versionNonce": 2013, + "version": 2, + "versionNonce": 292370220, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, "locked": false, "text": "Native API / chat entry points", @@ -456,7 +494,11 @@ "verticalAlign": "middle", "containerId": null, "autoResize": false, - "lineHeight": 1.25 + "lineHeight": 1.25, + "index": "aD", + "created": null, + "labelPosition": null, + "baseFontSize": null }, { "id": "hermes-14", @@ -479,13 +521,15 @@ "type": 3 }, "seed": 1014, - "version": 1, - "versionNonce": 2014, + "version": 2, + "versionNonce": 1887838612, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, - "locked": false + "locked": false, + "index": "aE", + "created": null }, { "id": "hermes-15", @@ -506,11 +550,11 @@ "frameId": null, "roundness": null, "seed": 1015, - "version": 1, - "versionNonce": 2015, + "version": 2, + "versionNonce": 1536520620, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, "locked": false, "text": "Gateway-side Hermes AIAgent\nNative conversation(s)", @@ -521,7 +565,11 @@ "verticalAlign": "middle", "containerId": null, "autoResize": false, - "lineHeight": 1.25 + "lineHeight": 1.25, + "index": "aF", + "created": null, + "labelPosition": null, + "baseFontSize": null }, { "id": "hermes-16", @@ -544,13 +592,15 @@ "type": 3 }, "seed": 1016, - "version": 1, - "versionNonce": 2016, + "version": 2, + "versionNonce": 1744097044, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, - "locked": false + "locked": false, + "index": "aG", + "created": null }, { "id": "hermes-17", @@ -571,11 +621,11 @@ "frameId": null, "roundness": null, "seed": 1017, - "version": 1, - "versionNonce": 2017, + "version": 2, + "versionNonce": 1506958380, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, "locked": false, "text": "Application / Fabric SDK", @@ -586,7 +636,11 @@ "verticalAlign": "middle", "containerId": null, "autoResize": false, - "lineHeight": 1.25 + "lineHeight": 1.25, + "index": "aH", + "created": null, + "labelPosition": null, + "baseFontSize": null }, { "id": "hermes-18", @@ -607,11 +661,11 @@ "frameId": null, "roundness": null, "seed": 1018, - "version": 1, - "versionNonce": 2018, + "version": 2, + "versionNonce": 674352276, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, "locked": false, "points": [ @@ -629,13 +683,15 @@ "endBinding": null, "startArrowhead": null, "endArrowhead": "arrow", - "elbowed": false + "elbowed": false, + "index": "aI", + "created": null }, { "id": "hermes-19", "type": "text", - "x": 255, - "y": 225, + "x": 170, + "y": 221, "width": 200, "height": 35, "angle": 0, @@ -650,11 +706,11 @@ "frameId": null, "roundness": null, "seed": 1019, - "version": 1, - "versionNonce": 2019, + "version": 70, + "versionNonce": 893971628, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793913757174, "link": null, "locked": false, "text": "Runtime.invoke()", @@ -665,7 +721,11 @@ "verticalAlign": "middle", "containerId": null, "autoResize": false, - "lineHeight": 1.25 + "lineHeight": 1.25, + "index": "aJ", + "created": null, + "labelPosition": null, + "baseFontSize": null }, { "id": "hermes-20", @@ -686,11 +746,11 @@ "frameId": null, "roundness": null, "seed": 1020, - "version": 1, - "versionNonce": 2020, + "version": 2, + "versionNonce": 586357268, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, "locked": false, "points": [ @@ -708,7 +768,9 @@ "endBinding": null, "startArrowhead": null, "endArrowhead": "arrow", - "elbowed": false + "elbowed": false, + "index": "aK", + "created": null }, { "id": "hermes-21", @@ -729,11 +791,11 @@ "frameId": null, "roundness": null, "seed": 1021, - "version": 1, - "versionNonce": 2021, + "version": 2, + "versionNonce": 217202988, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, "locked": false, "points": [ @@ -751,15 +813,17 @@ "endBinding": null, "startArrowhead": null, "endArrowhead": "arrow", - "elbowed": false + "elbowed": false, + "index": "aL", + "created": null }, { "id": "hermes-22", "type": "text", "x": 598, - "y": 322, + "y": 313.25, "width": 135, - "height": 30, + "height": 47.5, "angle": 0, "strokeColor": "#3b424b", "backgroundColor": "transparent", @@ -772,22 +836,26 @@ "frameId": null, "roundness": null, "seed": 1022, - "version": 1, - "versionNonce": 2022, + "version": 4, + "versionNonce": 1620828692, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793913767364, "link": null, "locked": false, - "text": "owns child", - "originalText": "owns child", + "text": "owns\n child", + "originalText": "owns\n child", "fontSize": 19, "fontFamily": 2, "textAlign": "center", "verticalAlign": "middle", "containerId": null, "autoResize": false, - "lineHeight": 1.25 + "lineHeight": 1.25, + "index": "aM", + "created": null, + "labelPosition": null, + "baseFontSize": null }, { "id": "hermes-23", @@ -808,11 +876,11 @@ "frameId": null, "roundness": null, "seed": 1023, - "version": 1, - "versionNonce": 2023, + "version": 2, + "versionNonce": 1978219436, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, "locked": false, "points": [ @@ -830,7 +898,9 @@ "endBinding": null, "startArrowhead": null, "endArrowhead": "arrow", - "elbowed": false + "elbowed": false, + "index": "aN", + "created": null }, { "id": "hermes-24", @@ -853,13 +923,15 @@ "type": 3 }, "seed": 1024, - "version": 1, - "versionNonce": 2024, + "version": 2, + "versionNonce": 622503188, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, - "locked": false + "locked": false, + "index": "aO", + "created": null }, { "id": "hermes-25", @@ -880,11 +952,11 @@ "frameId": null, "roundness": null, "seed": 1025, - "version": 1, - "versionNonce": 2025, + "version": 2, + "versionNonce": 1260185132, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, "locked": false, "text": "Native API client", @@ -895,7 +967,11 @@ "verticalAlign": "middle", "containerId": null, "autoResize": false, - "lineHeight": 1.25 + "lineHeight": 1.25, + "index": "aP", + "created": null, + "labelPosition": null, + "baseFontSize": null }, { "id": "hermes-26", @@ -916,11 +992,11 @@ "frameId": null, "roundness": null, "seed": 1026, - "version": 1, - "versionNonce": 2026, + "version": 2, + "versionNonce": 774693524, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, "locked": false, "points": [ @@ -938,7 +1014,9 @@ "endBinding": null, "startArrowhead": null, "endArrowhead": "arrow", - "elbowed": false + "elbowed": false, + "index": "aQ", + "created": null }, { "id": "hermes-27", @@ -961,13 +1039,15 @@ "type": 3 }, "seed": 1027, - "version": 1, - "versionNonce": 2027, + "version": 2, + "versionNonce": 1098334380, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, - "locked": false + "locked": false, + "index": "aR", + "created": null }, { "id": "hermes-28", @@ -988,11 +1068,11 @@ "frameId": null, "roundness": null, "seed": 1028, - "version": 1, - "versionNonce": 2028, + "version": 2, + "versionNonce": 622555156, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, "locked": false, "text": "Stock Hermes TUI\nProposed terminal path", @@ -1003,7 +1083,11 @@ "verticalAlign": "middle", "containerId": null, "autoResize": false, - "lineHeight": 1.25 + "lineHeight": 1.25, + "index": "aS", + "created": null, + "labelPosition": null, + "baseFontSize": null }, { "id": "hermes-29", @@ -1024,11 +1108,11 @@ "frameId": null, "roundness": null, "seed": 1029, - "version": 1, - "versionNonce": 2029, + "version": 2, + "versionNonce": 1621248812, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, "locked": false, "points": [ @@ -1058,7 +1142,9 @@ "endBinding": null, "startArrowhead": null, "endArrowhead": "arrow", - "elbowed": false + "elbowed": false, + "index": "aT", + "created": null }, { "id": "hermes-30", @@ -1081,13 +1167,15 @@ "type": 3 }, "seed": 1030, - "version": 1, - "versionNonce": 2030, + "version": 2, + "versionNonce": 702303636, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, - "locked": false + "locked": false, + "index": "aU", + "created": null }, { "id": "hermes-31", @@ -1108,11 +1196,11 @@ "frameId": null, "roundness": null, "seed": 1031, - "version": 1, - "versionNonce": 2031, + "version": 2, + "versionNonce": 721946028, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, "locked": false, "text": "Shared Fabric-managed Hermes home\nNative config / workspace / persisted state", @@ -1123,7 +1211,11 @@ "verticalAlign": "middle", "containerId": null, "autoResize": false, - "lineHeight": 1.25 + "lineHeight": 1.25, + "index": "aV", + "created": null, + "labelPosition": null, + "baseFontSize": null }, { "id": "hermes-32", @@ -1144,11 +1236,11 @@ "frameId": null, "roundness": null, "seed": 1032, - "version": 1, - "versionNonce": 2032, + "version": 2, + "versionNonce": 1839561492, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, "locked": false, "points": [ @@ -1166,13 +1258,15 @@ "endBinding": null, "startArrowhead": null, "endArrowhead": "arrow", - "elbowed": false + "elbowed": false, + "index": "aW", + "created": null }, { "id": "hermes-33", "type": "text", - "x": 410, - "y": 699, + "x": 326, + "y": 693, "width": 160, "height": 30, "angle": 0, @@ -1187,11 +1281,11 @@ "frameId": null, "roundness": null, "seed": 1033, - "version": 1, - "versionNonce": 2033, + "version": 56, + "versionNonce": 58619436, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793913760391, "link": null, "locked": false, "text": "reads / writes", @@ -1202,7 +1296,11 @@ "verticalAlign": "middle", "containerId": null, "autoResize": false, - "lineHeight": 1.25 + "lineHeight": 1.25, + "index": "aX", + "created": null, + "labelPosition": null, + "baseFontSize": null }, { "id": "hermes-34", @@ -1223,11 +1321,11 @@ "frameId": null, "roundness": null, "seed": 1034, - "version": 1, - "versionNonce": 2034, + "version": 2, + "versionNonce": 183302292, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, "locked": false, "points": [ @@ -1245,13 +1343,15 @@ "endBinding": null, "startArrowhead": null, "endArrowhead": "arrow", - "elbowed": false + "elbowed": false, + "index": "aY", + "created": null }, { "id": "hermes-35", "type": "text", - "x": 810, - "y": 699, + "x": 725, + "y": 698, "width": 160, "height": 30, "angle": 0, @@ -1266,11 +1366,11 @@ "frameId": null, "roundness": null, "seed": 1035, - "version": 1, - "versionNonce": 2035, + "version": 25, + "versionNonce": 1899032364, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793913761974, "link": null, "locked": false, "text": "reads / writes", @@ -1281,7 +1381,11 @@ "verticalAlign": "middle", "containerId": null, "autoResize": false, - "lineHeight": 1.25 + "lineHeight": 1.25, + "index": "aZ", + "created": null, + "labelPosition": null, + "baseFontSize": null }, { "id": "hermes-36", @@ -1302,11 +1406,11 @@ "frameId": null, "roundness": null, "seed": 1036, - "version": 1, - "versionNonce": 2036, + "version": 2, + "versionNonce": 1567147540, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, "locked": false, "text": "Same Hermes loop implementation; separate agent instances and conversations.", @@ -1317,15 +1421,19 @@ "verticalAlign": "middle", "containerId": null, "autoResize": false, - "lineHeight": 1.25 + "lineHeight": 1.25, + "index": "aa", + "created": null, + "labelPosition": null, + "baseFontSize": null }, { "id": "hermes-37", "type": "text", "x": 170, - "y": 981, + "y": 985.375, "width": 1020, - "height": 35, + "height": 26.25, "angle": 0, "strokeColor": "#3b424b", "backgroundColor": "transparent", @@ -1338,22 +1446,26 @@ "frameId": null, "roundness": null, "seed": 1037, - "version": 1, - "versionNonce": 2037, + "version": 11, + "versionNonce": 441814188, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793913780979, "link": null, "locked": false, - "text": "Stopping the Fabric runtime must stop both paths and their owned work.", - "originalText": "Stopping the Fabric runtime must stop both paths and their owned work.", + "text": "Stopping the Fabric runtime stops both paths and their owned work.", + "originalText": "Stopping the Fabric runtime stops both paths and their owned work.", "fontSize": 21, "fontFamily": 2, "textAlign": "center", "verticalAlign": "middle", "containerId": null, "autoResize": false, - "lineHeight": 1.25 + "lineHeight": 1.25, + "index": "ab", + "created": null, + "labelPosition": null, + "baseFontSize": null }, { "id": "hermes-38", @@ -1376,13 +1488,15 @@ "type": 3 }, "seed": 1038, - "version": 1, - "versionNonce": 2038, + "version": 2, + "versionNonce": 1510925204, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, - "locked": false + "locked": false, + "index": "ac", + "created": null }, { "id": "hermes-39", @@ -1403,11 +1517,11 @@ "frameId": null, "roundness": null, "seed": 1039, - "version": 1, - "versionNonce": 2039, + "version": 2, + "versionNonce": 1030868908, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, "locked": false, "text": "Configured model endpoint", @@ -1418,7 +1532,11 @@ "verticalAlign": "middle", "containerId": null, "autoResize": false, - "lineHeight": 1.25 + "lineHeight": 1.25, + "index": "ad", + "created": null, + "labelPosition": null, + "baseFontSize": null }, { "id": "hermes-40", @@ -1439,11 +1557,11 @@ "frameId": null, "roundness": null, "seed": 1040, - "version": 1, - "versionNonce": 2040, + "version": 2, + "versionNonce": 1729450260, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, "locked": false, "points": [ @@ -1469,7 +1587,9 @@ "endBinding": null, "startArrowhead": null, "endArrowhead": "arrow", - "elbowed": false + "elbowed": false, + "index": "ae", + "created": null }, { "id": "hermes-41", @@ -1490,11 +1610,11 @@ "frameId": null, "roundness": null, "seed": 1041, - "version": 1, - "versionNonce": 2041, + "version": 2, + "versionNonce": 1014168108, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, "locked": false, "points": [ @@ -1520,7 +1640,9 @@ "endBinding": null, "startArrowhead": null, "endArrowhead": "arrow", - "elbowed": false + "elbowed": false, + "index": "af", + "created": null }, { "id": "hermes-42", @@ -1541,11 +1663,11 @@ "frameId": null, "roundness": null, "seed": 1042, - "version": 1, - "versionNonce": 2042, + "version": 2, + "versionNonce": 871501460, "isDeleted": false, "boundElements": [], - "updated": 1793908800000, + "updated": 1793909002299, "link": null, "locked": false, "text": "Native requests bypass\nFabric Runtime.invoke()", @@ -1556,14 +1678,19 @@ "verticalAlign": "middle", "containerId": null, "autoResize": false, - "lineHeight": 1.25 + "lineHeight": 1.25, + "index": "ag", + "created": null, + "labelPosition": null, + "baseFontSize": null } ], "appState": { + "gridSize": 20, + "gridStep": 5, + "gridModeEnabled": false, "viewBackgroundColor": "#ffffff", - "exportBackground": true, - "exportEmbedScene": true, - "gridSize": null + "lockedMultiSelections": {} }, "files": {} -} +} \ No newline at end of file diff --git a/assets/hermes-runtime-invocation.png b/assets/hermes-runtime-invocation.png index ef35128a814e8cd4d98bdc4039d8157c42c49ed0..7b932b7a985a50f32a5f44e2a3a6d2532ca8c9fe 100644 GIT binary patch literal 220162 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 S#u?#{ugpWm2SvyyFaHNn`~*q> From 597e6b36eb52ab3b70d71718b529a95dbb0fa3ad Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Thu, 5 Nov 2026 13:43:58 -0800 Subject: [PATCH 21/34] docs: clarify native Hermes API client authentication Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- docs/integrations/harness/hermes-interfaces.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/integrations/harness/hermes-interfaces.mdx b/docs/integrations/harness/hermes-interfaces.mdx index cc2cd224b..3da32237e 100644 --- a/docs/integrations/harness/hermes-interfaces.mdx +++ b/docs/integrations/harness/hermes-interfaces.mdx @@ -100,7 +100,7 @@ The API server binds to `127.0.0.1` at its configured port. After every enabled /.fabric/hermes/runtimes//interfaces/api.token ``` -Send the token as `Authorization: Bearer `. Only the API gateway child receives it in its environment. Processes running as the runtime's user, including agent tools, can read the token file. +Clients calling the native API must read the generated token file and include `Authorization: Bearer ` in each HTTP request. Only the API gateway child receives it in its environment. Processes running as the runtime's user, including agent tools, can read the token file. ### Dashboard Access From 6b9e12f7e140fafac53e44a4aea48925ccccd844 Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Thu, 5 Nov 2026 13:50:56 -0800 Subject: [PATCH 22/34] docs: organize Hermes interfaces around user tasks Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- adapters/python/hermes/README.md | 2 +- .../harness/hermes-interfaces.mdx | 119 ++++++++++++------ 2 files changed, 79 insertions(+), 42 deletions(-) diff --git a/adapters/python/hermes/README.md b/adapters/python/hermes/README.md index 27fcfc725..31e2bf0ab 100644 --- a/adapters/python/hermes/README.md +++ b/adapters/python/hermes/README.md @@ -88,7 +88,7 @@ The descriptor validates the following `harness.settings` fields: | `save_trajectories` | boolean | `false` | Enables Hermes-native JSONL conversation trajectory saving. This is separate from normalized NeMo Fabric telemetry. | | `max_tokens` | positive integer | `512` | Limits the number of tokens in each Hermes model response. | | `terminal_timeout` | positive number | `60` | Limits a Hermes terminal operation in seconds. | -| `interfaces.api`, `interfaces.dashboard` | object | None | Serve Hermes's API server or dashboard from a runtime, each with an exact `port` and optional `enabled`; see [Serve the API Server and Dashboard](../../../docs/integrations/harness/hermes-interfaces.mdx#serve-the-api-server-and-dashboard). | +| `interfaces.api`, `interfaces.dashboard` | object | None | Serve Hermes's API server or dashboard from a runtime, each with an exact `port` and optional `enabled`; see [Access and Use](../../../docs/integrations/harness/hermes-interfaces.mdx#3-access-and-use). | | `startup_timeout_seconds` | number, at most 75 | `60` | Time from the start of the runtime for every enabled interface to pass its health check. | For example: diff --git a/docs/integrations/harness/hermes-interfaces.mdx b/docs/integrations/harness/hermes-interfaces.mdx index 3da32237e..599728e99 100644 --- a/docs/integrations/harness/hermes-interfaces.mdx +++ b/docs/integrations/harness/hermes-interfaces.mdx @@ -7,7 +7,19 @@ SPDX-License-Identifier: Apache-2.0 */} NVIDIA NeMo Fabric can start Hermes's native API server and dashboard alongside its embedded SDK agent. One Fabric runtime owns these execution paths, while each retains its own agent instances and conversations. Start with the [Hermes adapter guide](./hermes.mdx) for installation and normalized SDK configuration. -## Invocation Paths +Use the following sections to configure, access, and validate the interfaces: + +1. [Overview](#1-overview) +2. [Configuration](#2-configuration) +3. [Access and Use](#3-access-and-use) +4. [What Fabric Manages](#4-what-fabric-manages) +5. [Testing](#5-testing) +6. [Limitations and Planned Work](#6-limitations-and-planned-work) +7. [Implementation Details](#7-implementation-details) + +## 1. Overview + +The following diagram shows the two invocation paths within one runtime. ![One Fabric runtime owns an embedded Hermes agent and a managed Hermes Gateway. SDK calls use the embedded agent; native clients use gateway agents with separate conversations. The dashed TUI path is proposed.](../../../assets/hermes-runtime-invocation.png) @@ -31,7 +43,13 @@ These agents run the same Hermes agent-loop implementation. Sharing a Hermes hom | Relay evidence | Standard Relay artifacts and invocation telemetry references | Supported native events use Relay's standard formats and native session identities. Emitting those records does not create a normalized invocation result. | | Session artifacts | Collected through the SDK invocation path | Native session storage is shared, but session-scoped collection into Fabric's artifact model remains separate work. | -## Enable Native Interfaces +## 2. Configuration + +### Prerequisites + +Both interfaces are optional and require a POSIX host. The API server needs `aiohttp` from Hermes's `messaging` extra. The dashboard needs a built frontend at `HERMES_WEB_DIST` or `hermes_cli/web_dist`; browser chat also needs Hermes's built terminal UI bundle. The adapter does not build these frontends. Windows startup fails with `hermes_interfaces_unsupported_platform` before native setup. + +### Enable Native Interfaces Select interfaces through the Hermes adapter's `harness.settings`: @@ -60,37 +78,7 @@ Use this harness selection with the rest of your `FabricConfig`. The model, inst An absent interface is off. A present interface is on unless `enabled` is `false`; its closed schema currently requires a port even when disabled. Choose distinct, available ports for enabled interfaces. Ports bind to loopback in the adapter environment. No terminal interface setting is implemented yet. -## How Shared Configuration Reaches Native Agents - -NeMo Fabric resolves `FabricConfig` into a validated `AgentConfig`. The Hermes adapter uses that configuration for its embedded agent and prepares three configuration surfaces for managed native children: - -| Surface | Contents | Delivery | -| --- | --- | --- | -| Hermes `config.yaml` | Native model routing, workspace, MCP servers, skills, plugins, and toolset configuration | Written in the runtime's Hermes home, selected through `HERMES_HOME`. | -| `interfaces/agent-config.json` | The validated agent configuration, including instructions and behavioral settings | Owner-only snapshot passed by path to the adapter-owned native launcher. Removed on stop. | -| Relay plugin configuration | Resolved Relay components and output configuration | Generated by the adapter; its path is passed through `HERMES_NEMO_RELAY_PLUGINS_TOML`. | - -The model credential value is supplied through the child's environment; the native model configuration references `api_key_env`. - -### Apply Settings When Agents Are Created - -Hermes v0.22.5's API constructor does not read every behavioral setting from `config.yaml`. The adapter therefore launches managed children through `nemo_fabric_adapters.hermes.native`, which installs a process-local subclass of Hermes's `AIAgent` before entering the native CLI. - -Each native agent constructed in that process receives the same behavioral mapping as the embedded agent: enabled and blocked toolsets, turn limit, token limit, temperature, top-p, reasoning configuration, and trajectory setting. Configured system instructions take precedence over the native instruction argument. Native routing, session identity, agent execution, and protocol remain Hermes behavior; the installed Hermes source is unchanged. - -This mapping applies within adapter-launched processes. A gateway independently spawned by Hermes does not automatically inherit the constructor mapping, even if it uses the same home. Sharing a configuration directory alone does not establish configuration parity. - -### Relay and Artifacts - -Enable Relay through the normal NeMo Fabric telemetry configuration. The embedded and managed native paths receive the generated Relay plugin configuration. Native sessions retain their own trace roots rather than being assigned to the embedded Fabric invocation. - -For SDK invocations, the adapter finalizes the Hermes Relay session and flushes subscribers before returning, so available ATOF/ATIF artifacts are complete at the invocation boundary. With a live Relay runtime, Hermes emits `compaction` when tracked compaction rewrites history or provider state; `compaction.attempt` describes an attempt that is blocked, skipped, fails, or aborts without a rewrite. - -Native API responses remain native responses. Relay's standard artifact format provides common execution evidence, but does not by itself provide Fabric result normalization, complete usage accounting, or session-scoped collection of native transcripts and generated files. - -## Serve the API Server and Dashboard - -Both interfaces are optional and require a POSIX host. The API server needs `aiohttp` from Hermes's `messaging` extra. The dashboard needs a built frontend at `HERMES_WEB_DIST` or `hermes_cli/web_dist`; browser chat also needs Hermes's built terminal UI bundle. The adapter does not build these frontends. Windows startup fails with `hermes_interfaces_unsupported_platform` before native setup. +## 3. Access and Use ### API Access @@ -106,19 +94,35 @@ Clients calling the native API must read the generated token file and include `A Open the configured loopback port in a browser. The dashboard has no sign-in: Hermes embeds its session token in the page, so anyone who can reach that port can use its pages and browser chat. The adapter does not disable individual dashboard pages. -Children inherit the adapter host's environment after ambient `API_SERVER_*` variables are removed. The API gateway can also activate other Hermes platforms configured by that environment, such as Telegram through `TELEGRAM_BOT_TOKEN` or webhooks through `WEBHOOK_ENABLED`. +### Conversations and Responses + +Ordered SDK invocations reuse the embedded agent's conversation. Native clients use Hermes's native session mechanisms and receive native responses; these do not pass through `Runtime.invoke()` or become Fabric `RunResult` objects. -## Understand the Runtime Lifecycle +The runtime's Hermes home is stored under `/.fabric/hermes/runtimes/`. Sharing that home gives access to persisted resources, but does not select a shared live conversation or establish cross-runtime resume. -Each runtime owns one embedded `AIAgent` and `SessionDB`. Ordered SDK invocations reuse these objects and their conversation history. The adapter stores the Hermes home under `/.fabric/hermes/runtimes/`. Sharing this home with native interfaces does not make their conversations the same conversation or establish cross-runtime resume. +## 4. What Fabric Manages -### Startup and Shutdown +### Configuration Mapping and Precedence + +NeMo Fabric resolves `FabricConfig` into a validated `AgentConfig`. The adapter uses it for the embedded agent and for agent instances created inside managed native processes. Instructions, enabled and blocked toolsets, turn limit, token limit, temperature, top-p, reasoning configuration, and trajectory settings use the same behavioral mapping. + +Fabric-configured instructions and behavioral values take precedence over native constructor defaults. Native routing, conversation identity, execution, and protocol remain Hermes behavior. The model credential is supplied through the child's environment. Refer to [Implementation Details](#7-implementation-details) for the generated files and launcher mechanism. + +### Startup, Readiness, and Shutdown Startup launches enabled interfaces as child processes on the adapter's interpreter. The API server must pass `GET /health`, and the dashboard must pass `GET /api/status`, within the remaining startup budget. An occupied port, early child exit, or readiness timeout fails startup. Failed startup attempts clean up the children they started. Stop removes the API token, sends SIGTERM to running interface process groups, and escalates to SIGKILL after a five-second grace. The API gateway is configured with a three-second drain for API work and cron jobs. The agent configuration snapshot is removed during cleanup, and the adapter closes the embedded agent and session database. -## How to Test +### Relay Evidence and Artifact Boundaries + +Enable Relay through the normal NeMo Fabric telemetry configuration. The embedded and managed native paths receive the generated Relay plugin configuration. Native sessions retain their own trace roots rather than being assigned to the embedded Fabric invocation. + +For SDK invocations, the adapter finalizes the Hermes Relay session and flushes subscribers before returning, so available ATOF/ATIF artifacts are complete at the invocation boundary. With a live Relay runtime, Hermes emits `compaction` when tracked compaction rewrites history or provider state; `compaction.attempt` describes an attempt that is blocked, skipped, fails, or aborts without a rewrite. + +Native API responses remain native responses. Relay's standard artifact format provides common execution evidence, but does not by itself provide Fabric result normalization, complete usage accounting, or session-scoped collection of native transcripts and generated files. + +## 5. Testing ### Run Automated Regressions @@ -195,12 +199,45 @@ This is an instruction and access smoke test. To establish configuration parity, An SDK call returns a normalized `RunResult`; the native call returns an API response. Successful Relay capture does not change that result boundary. -## Limitations +## 6. Limitations and Planned Work + +### Operational Limits - Denied process-group signals fall back to the direct child. This does not guarantee that all descendants have stopped. - The adapter does not restart an interface child after a crash. Dashboard gateway actions can start processes outside the adapter launcher and its configuration mapping. - Readiness currently checks the HTTP response without verifying that the child owns the listening port. -- Browser interaction, TUI, explicit resume, and gateway replacement have not been qualified by the API configuration-parity tests. The TUI remains proposed functionality. -- Native responses, complete usage accounting, and session-scoped collection of native transcripts and generated files are not normalized into Fabric invocation results by these interfaces. - Child processes inherit the embedded adapter's `HERMES_YOLO_MODE` environment setting. Interactive approval behavior requires separate review and validation. +- Native responses and complete usage accounting are not normalized into Fabric invocation results by these interfaces. + +### Unqualified Paths + +The API configuration-parity tests do not qualify browser interaction, explicit resume, or gateway replacement. Each needs its own behavioral and lifecycle evidence. + +### Planned Work + +Native TUI support remains proposed and is shown as a dashed path in the diagram. Session-scoped collection of native transcripts and generated files into Fabric's artifact model remains separate work; standard Relay formatting alone does not provide it. + +## 7. Implementation Details + +### Generated Files and Environment + +The adapter prepares three configuration surfaces from the resolved `AgentConfig` for managed native children: + +| Surface | Contents | Delivery | +| --- | --- | --- | +| Hermes `config.yaml` | Native model routing, workspace, MCP servers, skills, plugins, and toolset configuration | Written in the runtime's Hermes home, selected through `HERMES_HOME`. | +| `interfaces/agent-config.json` | The validated agent configuration, including instructions and behavioral settings | Owner-only snapshot passed by path to the adapter-owned native launcher. Removed on stop. | +| Relay plugin configuration | Resolved Relay components and output configuration | Generated by the adapter; its path is passed through `HERMES_NEMO_RELAY_PLUGINS_TOML`. | + +The model credential value is supplied through the child's environment; the native model configuration references `api_key_env`. + +Children inherit the adapter host's environment after ambient `API_SERVER_*` variables are removed. The API gateway can also activate other Hermes platforms configured by that environment, such as Telegram through `TELEGRAM_BOT_TOKEN` or webhooks through `WEBHOOK_ENABLED`. + +### Native Launcher and Constructor Mapping + +Hermes v0.22.5's API constructor does not read every behavioral setting from `config.yaml`. The adapter therefore launches managed children through `nemo_fabric_adapters.hermes.native`, which installs a process-local subclass of Hermes's `AIAgent` before entering the native CLI. + +The subclass applies the shared behavioral mapping before calling the native constructor. It preserves native routing and session identity and does not modify the installed Hermes source. + +This mapping applies within adapter-launched processes. A gateway independently spawned by Hermes does not automatically inherit the constructor mapping, even if it uses the same home. Sharing a configuration directory alone does not establish configuration parity. From bee37b4ce8ced1830e170b816e7c058bdb577545 Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Thu, 5 Nov 2026 13:52:25 -0800 Subject: [PATCH 23/34] docs: remove inline Hermes interfaces table of contents Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- docs/integrations/harness/hermes-interfaces.mdx | 10 ---------- 1 file changed, 10 deletions(-) diff --git a/docs/integrations/harness/hermes-interfaces.mdx b/docs/integrations/harness/hermes-interfaces.mdx index 599728e99..0cf7fb25b 100644 --- a/docs/integrations/harness/hermes-interfaces.mdx +++ b/docs/integrations/harness/hermes-interfaces.mdx @@ -7,16 +7,6 @@ SPDX-License-Identifier: Apache-2.0 */} NVIDIA NeMo Fabric can start Hermes's native API server and dashboard alongside its embedded SDK agent. One Fabric runtime owns these execution paths, while each retains its own agent instances and conversations. Start with the [Hermes adapter guide](./hermes.mdx) for installation and normalized SDK configuration. -Use the following sections to configure, access, and validate the interfaces: - -1. [Overview](#1-overview) -2. [Configuration](#2-configuration) -3. [Access and Use](#3-access-and-use) -4. [What Fabric Manages](#4-what-fabric-manages) -5. [Testing](#5-testing) -6. [Limitations and Planned Work](#6-limitations-and-planned-work) -7. [Implementation Details](#7-implementation-details) - ## 1. Overview The following diagram shows the two invocation paths within one runtime. From aef811f6b89b7b8d7c87d605cd8936a689ec5ee2 Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Thu, 5 Nov 2026 13:53:09 -0800 Subject: [PATCH 24/34] docs: remove editable diagram sentence Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- docs/integrations/harness/hermes-interfaces.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/integrations/harness/hermes-interfaces.mdx b/docs/integrations/harness/hermes-interfaces.mdx index 0cf7fb25b..d654b6ea8 100644 --- a/docs/integrations/harness/hermes-interfaces.mdx +++ b/docs/integrations/harness/hermes-interfaces.mdx @@ -13,7 +13,7 @@ The following diagram shows the two invocation paths within one runtime. ![One Fabric runtime owns an embedded Hermes agent and a managed Hermes Gateway. SDK calls use the embedded agent; native clients use gateway agents with separate conversations. The dashed TUI path is proposed.](../../../assets/hermes-runtime-invocation.png) -The [editable Excalidraw diagram](../../../assets/hermes-runtime-invocation.excalidraw) shows the intended ownership model. The TUI path is proposed; the adapter currently exposes API and dashboard settings only. +The TUI path is proposed; the adapter currently exposes API and dashboard settings only. | Path | Execution | Conversation and result | | --- | --- | --- | From a4149cee262169c2edd90399c17952f8b2dcf9db Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Thu, 5 Nov 2026 14:39:33 -0800 Subject: [PATCH 25/34] fix: finalize Relay segments for native Hermes API turns ATOF events were emitted while the native Relay conversation scope stayed open, preventing ATIF export. Close and flush only the API turn Relay segment without firing conversation-end plugin hooks or resetting native session state. Cover export before shutdown and continuation across two turns. Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- .../src/nemo_fabric_adapters/hermes/native.py | 24 ++++++ .../nemo_fabric_adapters/hermes/telemetry.py | 11 +++ tests/adapters/test_hermes_adapter.py | 22 ++++++ tests/adapters/test_hermes_interfaces.py | 75 +++++++++++++++++++ tests/adapters/test_hermes_native_config.py | 41 ++++++++++ 5 files changed, 173 insertions(+) diff --git a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/native.py b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/native.py index d1e1ada29..a573af63c 100644 --- a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/native.py +++ b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/native.py @@ -13,12 +13,30 @@ import argparse import inspect import json +import logging +import os import sys from pathlib import Path from typing import Any from nemo_fabric_adapter_contract.models import AgentConfig from nemo_fabric_adapters.hermes import configuration +from nemo_fabric_adapters.hermes import telemetry + +LOGGER = logging.getLogger(__name__) + + +def finalize_api_turn(agent: Any) -> None: + """Close the API turn's Relay segment without deleting native conversation state.""" + if agent.platform != "api_server" or not os.environ.get( + "HERMES_NEMO_RELAY_PLUGINS_TOML" + ): + return + try: + telemetry.finalize_native_relay_segment(agent.session_id) + except Exception: + # A telemetry failure must not replace an execution result or its error. + LOGGER.exception("Hermes API turn Relay finalization failed") def configured_kwargs( @@ -56,6 +74,12 @@ def __init__(self, *args: Any, **kwargs: Any) -> None: **configured_kwargs(config, bound.arguments, load_config()) ) + def run_conversation(self, *args: Any, **kwargs: Any) -> Any: + try: + return super().run_conversation(*args, **kwargs) + finally: + finalize_api_turn(self) + run_agent.AIAgent = ConfiguredAIAgent from hermes_cli.main import main as hermes_main diff --git a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/telemetry.py b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/telemetry.py index 594a047b6..e3a1a67e9 100644 --- a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/telemetry.py +++ b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/telemetry.py @@ -43,6 +43,17 @@ def finalize_hermes_relay_session(session_id: str) -> None: subscribers.flush() +def finalize_native_relay_segment(session_id: str) -> None: + """Export a native API turn without firing conversation-end plugin hooks.""" + from agent import relay_runtime + from nemo_relay import subscribers + + relay_runtime.SESSION_COORDINATOR.finalize_conversation( + profile_key=relay_runtime.current_profile_key(), session_id=session_id + ) + subscribers.flush() + + def validate_hermes_telemetry_provider(runtime_context: RuntimeContext) -> None: telemetry = runtime_context.telemetry providers = telemetry.metadata.get("telemetry_providers", []) if telemetry else [] diff --git a/tests/adapters/test_hermes_adapter.py b/tests/adapters/test_hermes_adapter.py index 964de3c56..f5041a48c 100644 --- a/tests/adapters/test_hermes_adapter.py +++ b/tests/adapters/test_hermes_adapter.py @@ -106,6 +106,28 @@ def test_validate_hermes_telemetry_provider_rejects_native(): ) +def test_native_relay_segment_does_not_fire_session_end_hooks(monkeypatch): + from agent import relay_runtime + from hermes_cli import lifecycle as hermes_lifecycle + from nemo_relay import subscribers + + coordinator = MagicMock() + finalize_session = MagicMock() + flush = MagicMock() + monkeypatch.setattr(relay_runtime, "SESSION_COORDINATOR", coordinator) + monkeypatch.setattr(relay_runtime, "current_profile_key", lambda: "test-profile") + monkeypatch.setattr(hermes_lifecycle, "finalize_session", finalize_session) + monkeypatch.setattr(subscribers, "flush", flush) + + telemetry.finalize_native_relay_segment("native-session") + + coordinator.finalize_conversation.assert_called_once_with( + profile_key="test-profile", session_id="native-session" + ) + flush.assert_called_once_with() + finalize_session.assert_not_called() + + def test_validate_hermes_telemetry_provider_rejects_mixed_native_and_relay(): with pytest.raises( ValueError, match="only relay telemetry is supported for Hermes" diff --git a/tests/adapters/test_hermes_interfaces.py b/tests/adapters/test_hermes_interfaces.py index e4b456a76..ffa5e9844 100644 --- a/tests/adapters/test_hermes_interfaces.py +++ b/tests/adapters/test_hermes_interfaces.py @@ -10,6 +10,7 @@ import json import os import socket +import sqlite3 import sys import time from pathlib import Path @@ -207,6 +208,80 @@ async def test_hermes_gateway_agents_receive_fabric_behavior( assert not config_path.exists() +async def test_api_turns_export_atif_without_resetting_native_conversation( + tmp_path: Path, api_server: str +): + port = _free_port() + payload = _payload( + tmp_path, _interface("api", port=port), base_url=f"{api_server}/v1" + ) + payload["runtime_context"]["telemetry"] = { + "relay_enabled": True, + "metadata": {"telemetry_providers": ["relay"]}, + } + relay_dir = tmp_path / "relay" + wrapper = tmp_path / "relay.json" + wrapper.write_text( + json.dumps( + { + "relay": { + "config": { + "version": 4, + "atof": { + "enabled": True, + "sinks": [ + { + "type": "file", + "output_directory": str(relay_dir / "atof"), + "filename": "events.atof.jsonl", + } + ], + }, + "atif": { + "enabled": True, + "output_directory": str(relay_dir / "atif"), + }, + } + } + } + ) + ) + os.environ["FABRIC_RELAY_CONFIG_PATH"] = str(wrapper) + runtime = adapter.HermesRuntime() + messages = [{"role": "user", "content": "first native turn"}] + try: + await runtime.start(payload) + token = _token_path(tmp_path).read_text() + for turn in range(2): + reply = await asyncio.to_thread( + requests.post, + f"http://127.0.0.1:{port}/v1/chat/completions", + headers={"Authorization": f"Bearer {token}"}, + json={"model": "hermes-agent", "messages": messages}, + timeout=60, + ) + assert reply.status_code == 200, reply.text + trajectories = list((relay_dir / "atif").rglob("*.json")) + assert len(trajectories) == turn + 1 + assert all(json.loads(path.read_text())["steps"] for path in trajectories) + messages.extend( + [ + reply.json()["choices"][0]["message"], + {"role": "user", "content": "second native turn"}, + ] + ) + connection = sqlite3.connect(runtime._hermes_home / "state.db") + try: + sessions = connection.execute( + "SELECT id FROM sessions WHERE source = 'api_server'" + ).fetchall() + finally: + connection.close() + assert len(sessions) == 1 + finally: + await runtime.stop() + + @pytest.mark.skipif(sys.platform != "linux", reason="Reads Linux procfs") async def test_hermes_serves_api_and_dashboard_with_the_configured_model( tmp_path: Path, api_server: str, web_dist: Path diff --git a/tests/adapters/test_hermes_native_config.py b/tests/adapters/test_hermes_native_config.py index 21be92a36..4e4a5e7e0 100644 --- a/tests/adapters/test_hermes_native_config.py +++ b/tests/adapters/test_hermes_native_config.py @@ -3,9 +3,13 @@ """Fabric behavior survives creation of additional native Hermes agents.""" +import os +from unittest.mock import MagicMock + import pytest from nemo_fabric_adapter_contract.models import AgentConfig from nemo_fabric_adapters.hermes import configuration +from nemo_fabric_adapters.hermes import native from nemo_fabric_adapters.hermes.native import configured_kwargs @@ -77,3 +81,40 @@ def test_native_behavior_preserves_native_prompt_when_fabric_has_none(): assert result["request_overrides"] is None assert result["max_tokens"] == 512 assert result["max_iterations"] == configuration.DEFAULT_MAX_ITERATIONS + + +@pytest.mark.parametrize( + "platform,relay_enabled,expected", + [("api_server", True, True), ("api_server", False, False), ("cli", True, False)], +) +def test_only_relay_enabled_api_turns_finalize( + monkeypatch, platform, relay_enabled, expected +): + if relay_enabled: + os.environ["HERMES_NEMO_RELAY_PLUGINS_TOML"] = "/test/plugins.toml" + else: + os.environ.pop("HERMES_NEMO_RELAY_PLUGINS_TOML", None) + finalize = MagicMock() + monkeypatch.setattr(native.telemetry, "finalize_native_relay_segment", finalize) + agent = MagicMock(platform=platform, session_id="native-session") + + native.finalize_api_turn(agent) + + if expected: + finalize.assert_called_once_with("native-session") + else: + finalize.assert_not_called() + + +def test_api_relay_finalization_failure_is_reported_without_raising( + monkeypatch, caplog +): + os.environ["HERMES_NEMO_RELAY_PLUGINS_TOML"] = "/test/plugins.toml" + finalize = MagicMock(side_effect=RuntimeError("test export failure")) + monkeypatch.setattr(native.telemetry, "finalize_native_relay_segment", finalize) + + native.finalize_api_turn( + MagicMock(platform="api_server", session_id="native-session") + ) + + assert "Hermes API turn Relay finalization failed" in caplog.text From 8c1bfb70b4f68e351b54304fb6c1e9c3f44366c5 Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Thu, 5 Nov 2026 14:39:33 -0800 Subject: [PATCH 26/34] feat: add native interface example with Relay trajectories Start one managed Hermes API, send a real file task, verify its output and both ATOF and populated ATIF tool steps, and stop the runtime. Accept endpoint, model, credentials reference and paths through arguments or environment. Replace the inline guide script with the runnable example. Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- .../harness/hermes-interfaces.mdx | 71 ++---- examples/README.md | 4 + examples/interfaces/README.md | 94 ++++++++ examples/interfaces/hermes.py | 222 ++++++++++++++++++ 4 files changed, 334 insertions(+), 57 deletions(-) create mode 100644 examples/interfaces/README.md create mode 100644 examples/interfaces/hermes.py diff --git a/docs/integrations/harness/hermes-interfaces.mdx b/docs/integrations/harness/hermes-interfaces.mdx index d654b6ea8..dfa6b77ea 100644 --- a/docs/integrations/harness/hermes-interfaces.mdx +++ b/docs/integrations/harness/hermes-interfaces.mdx @@ -108,7 +108,7 @@ Stop removes the API token, sends SIGTERM to running interface process groups, a Enable Relay through the normal NeMo Fabric telemetry configuration. The embedded and managed native paths receive the generated Relay plugin configuration. Native sessions retain their own trace roots rather than being assigned to the embedded Fabric invocation. -For SDK invocations, the adapter finalizes the Hermes Relay session and flushes subscribers before returning, so available ATOF/ATIF artifacts are complete at the invocation boundary. With a live Relay runtime, Hermes emits `compaction` when tracked compaction rewrites history or provider state; `compaction.attempt` describes an attempt that is blocked, skipped, fails, or aborts without a rewrite. +For SDK invocations, the adapter finalizes the Hermes Relay session and flushes subscribers before returning, so available ATOF/ATIF artifacts are complete at the invocation boundary. Managed native API turns also finalize and flush a Relay segment when execution returns. This makes ATIF available per turn without deleting the native conversation; subsequent turns can continue it and produce separate segments. Export failures are logged, so consumers must verify artifact contents. With a live Relay runtime, Hermes emits `compaction` when tracked compaction rewrites history or provider state; `compaction.attempt` describes an attempt that is blocked, skipped, fails, or aborts without a rewrite. Native API responses remain native responses. Relay's standard artifact format provides common execution evidence, but does not by itself provide Fabric result normalization, complete usage accounting, or session-scoped collection of native transcripts and generated files. @@ -126,68 +126,25 @@ export ADAPTER_PYTHON="$PWD/.venv-hermes/bin/python" tests/adapters/test_hermes_interfaces.py -q ``` -These tests exercise the installed native Hermes processes against a local mock model endpoint. They check configuration mapping, two fresh API conversations, private configuration files, authentication, readiness failures, and cleanup. They do not establish compatibility with your hosted model or qualify browser interaction. +These tests exercise the installed native Hermes processes against a local mock model endpoint. They check configuration mapping, fresh conversations, ATIF export at turn completion, continued native conversation state, private configuration files, authentication, readiness failures, and cleanup. They do not establish compatibility with your hosted model or qualify browser interaction. -### Check a Live Model Endpoint +### Run a Live File Task and Inspect Relay -Reuse the `config` example from the [adapter guide](./hermes.mdx#configure-the-adapter), replacing its endpoint, model, and credential reference with your own values. With the Hermes interpreter selected through `ADAPTER_PYTHON`, run the following code in the same script: +Use the [native interfaces example](../../../examples/interfaces/README.md) to submit real input through the Hermes API, verify its file effects, and inspect Relay evidence. It starts one runtime with ATOF and ATIF enabled and checks both formats separately. -```python -import asyncio -import json -from pathlib import Path -from urllib.request import Request, urlopen - -from nemo_fabric import Fabric - -marker = "FABRIC_CONFIG_CHECK" -config.harness.settings["interfaces"] = {"api": {"port": 8642}} -config.instructions.system.content = f"Reply exactly {marker} to every user message. Do not call tools." -config.models["default"].temperature = 0.0 -config.models["default"].top_p = 0.41 -config.models["default"].max_tokens = 128 -config.environment.artifacts = Path("artifacts/hermes-interface-check").resolve() - -def native_turn(token, number): - request = Request( - "http://127.0.0.1:8642/v1/chat/completions", - data=json.dumps({ - "model": "hermes-agent", - "messages": [{"role": "user", "content": f"Hello, conversation {number}."}], - }).encode(), - headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"}, - ) - with urlopen(request, timeout=120) as response: - return json.load(response)["choices"][0]["message"]["content"] - -async def main(): - async with await Fabric().start_runtime(config) as runtime: - result = await runtime.invoke(input="Please respond to this simple greeting without using tools.") - assert result.output.response == marker - token_path = ( - config.environment.artifacts / ".fabric/hermes/runtimes" - / runtime.runtime_id / "interfaces/api.token" - ) - token = token_path.read_text() - for number in range(2): - assert await asyncio.to_thread(native_turn, token, number) == marker - assert not token_path.exists() - -asyncio.run(main()) -``` +From the repository root, with your prepared Hermes environment and model credentials: -This is an instruction and access smoke test. To establish configuration parity, also inspect actual model requests using your endpoint's request capture or a test-owned forwarding recorder. Do not infer parity from matching answers or generated files alone. +```bash +export ADAPTER_PYTHON="$PWD/.venv-hermes/bin/python" +.venv-hermes/bin/python examples/interfaces/hermes.py \ + --base-url "$MODEL_BASE_URL" \ + --model "$MODEL_NAME" \ + --port 8642 +``` -| Check | Required evidence | -| --- | --- | -| Model and credentials | Both paths call the configured endpoint/model with the intended credential; do not record credential values. | -| Instructions and generation | Captured requests contain the marker instruction, temperature `0`, top-p `0.41`, and token limit `128`. | -| Tool policy | The file-only configuration exposes `read_file`, `write_file`, `patch`, and `search_files`, without unrelated tools. Test blocked-tool behavior separately. | -| Conversation isolation | Two fresh native conversations remain distinct from each other and the embedded Fabric conversation. | -| Relay | With Relay enabled, actual turns emit supported records with distinct native session roots. Check artifact contents and attribution, not just file existence. | -| Cleanup | Runtime stop removes the API token and configuration snapshot and terminates the managed child. Descendant termination needs its own evidence where group signals are denied. | +The example uses sample release notes by default. Add `--input-file /path/to/release-notes.md` for your own input. Its README includes setup, output verification, and commands to inspect ATIF tool steps and raw ATOF events. The example exits unsuccessfully if the generated file, tool observations, populated ATIF trajectory, or token cleanup is missing. -An SDK call returns a normalized `RunResult`; the native call returns an API response. Successful Relay capture does not change that result boundary. +Matching answers or generated configuration files do not establish configuration parity. Inspect actual model requests for the configured model, credential, instructions, generation settings, and tool policy. Verify session attribution in the trace; the native API response remains distinct from a normalized Fabric `RunResult`. ## 6. Limitations and Planned Work diff --git a/examples/README.md b/examples/README.md index 1165d5868..265d780ba 100644 --- a/examples/README.md +++ b/examples/README.md @@ -48,6 +48,10 @@ Pi's startup `model_redirect` marks are not included in `atof_records`. The [OpenShell Code Review example](code_review_agent/README.md#run-hermes-in-openshell) packages Hermes Agent inside the sandbox and uses the normal SDK/provider lifecycle from the host. It runs two review turns and can collect NeMo Relay evidence. +## Native Interfaces + +[`interfaces`](interfaces/README.md) demonstrates native harness interfaces alongside a Fabric-managed runtime. Start with the Hermes API example: submit a file task through the native API, verify the generated file, and inspect Relay ATOF events and ATIF tool steps. + ## LangGraph Custom Agent [`langgraph_custom_agent`](langgraph_custom_agent/README.md) demonstrates how diff --git a/examples/interfaces/README.md b/examples/interfaces/README.md new file mode 100644 index 000000000..769c7c8a7 --- /dev/null +++ b/examples/interfaces/README.md @@ -0,0 +1,94 @@ + + +# NVIDIA NeMo Fabric Native Interface Examples + +Use native harness interfaces alongside a Fabric-managed runtime. Each harness example uses the public Python SDK for configuration and lifecycle, then sends input through the harness's native interface. + +## Hermes API and Relay + +[`hermes.py`](hermes.py) starts one managed Hermes API server, submits a real file task, verifies the generated file, and checks Relay ATOF events and ATIF tool steps. Its API response remains native; the SDK manages the runtime but does not convert this response into a Fabric `RunResult`. + +### Prepare the Environment + +Follow the [Hermes adapter installation guide](../../docs/integrations/harness/hermes.mdx#install-the-adapter). For source development, run from the repository root: + +```bash +just install-hermes-agent +export ADAPTER_PYTHON="$PWD/.venv-hermes/bin/python" +``` + +This prepares pinned Hermes v0.22.5, the adapter, and Relay 0.10. The application interpreter also needs the NeMo Fabric SDK. The command below uses the prepared Hermes environment for both application and adapter. + +Set your OpenAI-compatible model endpoint, served model name, and credential: + +```bash +export MODEL_BASE_URL="http://MODEL_HOST:8000/v1" +export MODEL_NAME="YOUR_SERVED_MODEL_NAME" +export MODEL_API_KEY="YOUR_MODEL_API_KEY" +``` + +Use the value required by your endpoint. An endpoint without authentication can use a nonempty placeholder credential. To reference an existing credential variable instead, pass its name with `--api-key-env`. + +### Run a Real Task + +Run the example from the repository root: + +```bash +.venv-hermes/bin/python examples/interfaces/hermes.py \ + --base-url "$MODEL_BASE_URL" \ + --model "$MODEL_NAME" \ + --port 8642 +``` + +The example copies sample release notes into a new workspace, asks the native API to read them and write a rollout checklist, and stops the runtime. To use your own notes, add `--input-file /path/to/release-notes.md`. `--output-dir` selects a new evidence directory; the example refuses to overwrite an existing directory. `--keep-running` leaves the API available for additional requests until you press Enter. + +The model and port must be reachable from the adapter environment. The native API binds to loopback and uses a generated bearer token; the example reads the token file and sends the header without printing the token. + +The example prints its evidence directory and checks that: + +- The output file exists and is nonempty. +- ATOF records show `read_file` and `write_file` execution. +- A populated ATIF trajectory contains those tool steps. +- Stop removes the API token. + +It exits unsuccessfully if any check fails. An ATOF file alone does not establish ATIF export. + +### Inspect the Result and Trajectory + +Set `RUN_DIR` to the evidence directory printed by the example: + +```bash +RUN_DIR="outputs/interfaces/" +cat "$RUN_DIR/workspace/rollout-checklist.md" +jq . "$RUN_DIR/summary.json" + +ATIF=$(jq -r '.atif_files[0]' "$RUN_DIR/summary.json") +jq -r '.steps[] | + [.step_id, .source, ((.tool_calls // []) | map(.function_name) | join(","))] | + @tsv' "$ATIF" +``` + +For this task, expect user input, an agent `read_file` step with its observation, an agent `write_file` step with its observation, and a final response. Inspect complete tool arguments and observations with: + +```bash +jq '.steps[] | select(.tool_calls != null) | + {tool_calls, observation}' "$ATIF" +``` + +To inspect the raw event sequence: + +```bash +ATOF=$(jq -r '.atof_files[0]' "$RUN_DIR/summary.json") +jq -r 'select(.kind == "scope" and + (.category == "llm" or .category == "tool")) | + [.timestamp, .scope_category, .category, .name] | @tsv' "$ATOF" +``` + +### ATIF Finalization and Limits + +The pinned Hermes API path leaves its Relay conversation scope open after a turn. ATOF events can therefore exist without ATIF export. The managed native launcher finalizes and flushes an API turn's Relay segment when execution returns, including failed turns. It does not fire native conversation-end plugin hooks or delete conversation state. The conversation can continue; subsequent turns create new Relay segments and ATIF files. Finalization errors are logged without replacing the execution outcome, so consumers should check their artifacts explicitly. + +This example exercises the managed API path. It does not qualify browser chat, TUI, independently restarted gateways, approvals, or complete native-result and artifact normalization. Refer to [Hermes Native Interfaces](../../docs/integrations/harness/hermes-interfaces.mdx) for the configuration and ownership boundaries. diff --git a/examples/interfaces/hermes.py b/examples/interfaces/hermes.py new file mode 100644 index 000000000..63109e003 --- /dev/null +++ b/examples/interfaces/hermes.py @@ -0,0 +1,222 @@ +# SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved. +# SPDX-License-Identifier: Apache-2.0 + +"""Run a file task through a managed Hermes API and inspect Relay evidence.""" + +from __future__ import annotations + +import argparse +import asyncio +import json +import os +import sys +import uuid +from datetime import datetime, timezone +from pathlib import Path +from urllib.error import URLError +from urllib.request import Request, urlopen + +from nemo_fabric import Fabric +from nemo_fabric import FabricConfig +from nemo_fabric import RelayAtifConfig +from nemo_fabric import RelayAtofConfig +from nemo_fabric import RelayAtofFileSinkConfig +from nemo_fabric import RelayObservabilityConfig + +SAMPLE_NOTES = """Release changes: +- API authentication requires a bearer token. +- Dashboard binds to loopback. +- Runtime restart creates a new API token. +- File tools remain enabled; shell execution is disabled. +""" + + +def parse_args() -> argparse.Namespace: + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument("--base-url", default=os.environ.get("MODEL_BASE_URL")) + parser.add_argument("--model", default=os.environ.get("MODEL_NAME")) + parser.add_argument("--api-key-env", default="MODEL_API_KEY") + parser.add_argument("--port", type=int, default=8642) + parser.add_argument( + "--input-file", type=Path, help="Release notes; defaults to a bundled sample" + ) + parser.add_argument( + "--output-dir", type=Path, help="New directory for workspace and evidence" + ) + parser.add_argument( + "--keep-running", + action="store_true", + help="Keep the API open for manual requests until Enter", + ) + args = parser.parse_args() + if not args.base_url or not args.model: + parser.error("set --base-url and --model, or MODEL_BASE_URL and MODEL_NAME") + if not os.environ.get(args.api_key_env): + parser.error( + f"set the model credential environment variable {args.api_key_env}" + ) + if not 1 <= args.port <= 65535: + parser.error("--port must be between 1 and 65535") + return args + + +def call_api(url: str, token: str, prompt: str) -> dict: + request = Request( + url + "/v1/chat/completions", + data=json.dumps( + {"model": "hermes-agent", "messages": [{"role": "user", "content": prompt}]} + ).encode(), + headers={ + "Authorization": f"Bearer {token}", + "Content-Type": "application/json", + }, + ) + with urlopen(request, timeout=180) as response: + return json.load(response) + + +async def run(args: argparse.Namespace) -> None: + run_name = ( + datetime.now(timezone.utc).strftime("%Y%m%d-%H%M%S") + + "-" + + uuid.uuid4().hex[:8] + ) + output = (args.output_dir or Path("outputs/interfaces") / run_name).resolve() + output.mkdir(parents=True, exist_ok=False) + workspace = output / "workspace" + workspace.mkdir() + source = workspace / "release-notes.md" + source.write_text(args.input_file.read_text() if args.input_file else SAMPLE_NOTES) + checklist = workspace / "rollout-checklist.md" + relay = output / "relay" + config = FabricConfig.from_mapping( + { + "metadata": {"name": "hermes-interfaces-example"}, + "harness": { + "adapter_id": "nvidia.fabric.hermes", + "settings": {"interfaces": {"api": {"port": args.port}}}, + }, + "models": { + "default": { + "provider": "openai", + "model": args.model, + "base_url": args.base_url, + "api_key_env": args.api_key_env, + "temperature": 0.0, + "max_tokens": 2048, + } + }, + "instructions": { + "system": { + "mode": "replace", + "content": "Complete the requested workspace file task using file tools. Read source files before writing the answer file. Do not use shell or web tools. Summarize the actual result briefly.", + } + }, + "tools": {"enabled": ["file"], "blocked": ["terminal"]}, + "runtime": {"max_turns": 8}, + "environment": { + "provider": "local", + "workspace": str(workspace), + "artifacts": str(output / "artifacts"), + }, + } + ) + config.enable_relay( + output_dir=str(relay), + observability=RelayObservabilityConfig( + atof=RelayAtofConfig( + enabled=True, + sinks=[ + RelayAtofFileSinkConfig( + output_directory=str(relay / "atof"), + filename="events.atof.jsonl", + mode="append", + ) + ], + ), + atif=RelayAtifConfig(enabled=True, output_directory=str(relay / "atif")), + ), + ) + prompt = f"Read {source} and create {checklist} containing a concise five-item rollout validation checklist based on the release notes. Use file tools to read and write. Then report the created file path." + api = f"http://127.0.0.1:{args.port}" + print(f"Evidence directory: {output}", flush=True) + async with await Fabric().start_runtime(config, base_dir=output) as runtime: + token_path = ( + output + / "artifacts/.fabric/hermes/runtimes" + / runtime.runtime_id + / "interfaces/api.token" + ) + print(f"API: {api}\nToken file: {token_path}", flush=True) + response = await asyncio.to_thread( + call_api, api, token_path.read_text(), prompt + ) + (output / "response.json").write_text(json.dumps(response, indent=2) + "\n") + print(response["choices"][0]["message"]["content"], flush=True) + if args.keep_running: + await asyncio.to_thread( + input, "API remains available. Press Enter to stop: " + ) + + atof_files = sorted(relay.rglob("*.atof.jsonl")) + atif_files = sorted((relay / "atif").rglob("*.json")) + events = [ + json.loads(line) + for path in atof_files + for line in path.read_text().splitlines() + if line.strip() + ] + tools = sorted( + { + event["name"] + for event in events + if event.get("category") == "tool" + and event.get("scope_category") == "start" + } + ) + populated_atif = [ + path for path in atif_files if json.loads(path.read_text()).get("steps") + ] + atif_tools = { + call["function_name"] + for path in populated_atif + for step in json.loads(path.read_text())["steps"] + for call in step.get("tool_calls", []) + } + checks = { + "output_file_written": checklist.is_file() + and bool(checklist.read_text().strip()), + "file_tools_observed": {"read_file", "write_file"}.issubset(tools), + "atof_events_written": bool(events), + "atif_trajectory_written": bool(populated_atif), + "atif_tool_steps_written": {"read_file", "write_file"}.issubset(atif_tools), + "api_token_removed": not token_path.exists(), + } + summary = { + "runtime_id": runtime.runtime_id, + "output_file": str(checklist), + "atof_files": [str(p) for p in atof_files], + "atif_files": [str(p) for p in populated_atif], + "tools": tools, + "checks": checks, + } + (output / "summary.json").write_text(json.dumps(summary, indent=2) + "\n") + print(json.dumps(summary, indent=2), flush=True) + if not all(checks.values()): + raise RuntimeError( + "Example checks failed; inspect summary.json. ATOF alone does not establish ATIF export." + ) + + +def main() -> int: + args = parse_args() + try: + asyncio.run(run(args)) + except (RuntimeError, OSError, URLError) as error: + print(f"Error: {error}", file=sys.stderr) + return 1 + return 0 + + +if __name__ == "__main__": + raise SystemExit(main()) From 731b312fa12c96faddc3b7fd5bfee12b790a5dd1 Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Thu, 5 Nov 2026 14:41:23 -0800 Subject: [PATCH 27/34] fix: preserve native conversation wrapper signature Retain native callable metadata and verify that a second API turn receives prior conversation history after ATIF segment export. Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- .../hermes/src/nemo_fabric_adapters/hermes/native.py | 2 ++ tests/adapters/test_hermes_interfaces.py | 8 ++++++++ 2 files changed, 10 insertions(+) diff --git a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/native.py b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/native.py index a573af63c..b26099f5f 100644 --- a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/native.py +++ b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/native.py @@ -18,6 +18,7 @@ import sys from pathlib import Path from typing import Any +from functools import wraps from nemo_fabric_adapter_contract.models import AgentConfig from nemo_fabric_adapters.hermes import configuration @@ -74,6 +75,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None: **configured_kwargs(config, bound.arguments, load_config()) ) + @wraps(native_agent.run_conversation) def run_conversation(self, *args: Any, **kwargs: Any) -> Any: try: return super().run_conversation(*args, **kwargs) diff --git a/tests/adapters/test_hermes_interfaces.py b/tests/adapters/test_hermes_interfaces.py index ffa5e9844..f4aa73943 100644 --- a/tests/adapters/test_hermes_interfaces.py +++ b/tests/adapters/test_hermes_interfaces.py @@ -270,6 +270,14 @@ async def test_api_turns_export_atif_without_resetting_native_conversation( {"role": "user", "content": "second native turn"}, ] ) + captured = await asyncio.to_thread( + requests.get, f"{api_server}/_requests", timeout=5 + ) + model_turns = [request for request in captured.json() if request.get("tools")] + assert len(model_turns) == 2 + history = json.dumps(model_turns[-1]["messages"]) + assert "first native turn" in history + assert "second native turn" in history connection = sqlite3.connect(runtime._hermes_home / "state.db") try: sessions = connection.execute( From b9f300b87ee18ba4916b271822df8e339dd2cc51 Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Thu, 5 Nov 2026 15:56:04 -0800 Subject: [PATCH 28/34] docs: record native health and instance discovery gaps Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- docs/integrations/harness/hermes-interfaces.mdx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/integrations/harness/hermes-interfaces.mdx b/docs/integrations/harness/hermes-interfaces.mdx index dfa6b77ea..6e4bf4fdd 100644 --- a/docs/integrations/harness/hermes-interfaces.mdx +++ b/docs/integrations/harness/hermes-interfaces.mdx @@ -153,6 +153,8 @@ Matching answers or generated configuration files do not establish configuration - Denied process-group signals fall back to the direct child. This does not guarantee that all descendants have stopped. - The adapter does not restart an interface child after a crash. Dashboard gateway actions can start processes outside the adapter launcher and its configuration mapping. - Readiness currently checks the HTTP response without verifying that the child owns the listening port. +- NeMo Fabric's `check()` reports embedded SDK agent health and activity only. It does not aggregate native interface health or active native turns. Startup probes check API `/health` and dashboard `/api/status`; the adapter does not monitor child health continuously. +- There is no unified inventory of all agent instances in a runtime. SDK invocation tracking covers SDK requests; native API run status and persisted sessions are exposed through Hermes endpoints. Persisted sessions do not identify all live agent objects, which can exist only for a turn. - Child processes inherit the embedded adapter's `HERMES_YOLO_MODE` environment setting. Interactive approval behavior requires separate review and validation. - Native responses and complete usage accounting are not normalized into Fabric invocation results by these interfaces. @@ -164,6 +166,8 @@ The API configuration-parity tests do not qualify browser interaction, explicit Native TUI support remains proposed and is shown as a dashed path in the diagram. Session-scoped collection of native transcripts and generated files into Fabric's artifact model remains separate work; standard Relay formatting alone does not provide it. +Add runtime-wide health and discovery that covers the embedded agent and managed native interfaces. Report process health and readiness separately from active runs and persisted sessions, include child failures and native activity in aggregate status, and provide a way to discover native runs and sessions alongside SDK invocations. Hermes's authenticated `/health/detailed`, `/v1/runs/{run_id}`, and `/api/sessions` endpoints provide native diagnostics today; they do not provide a unified NeMo Fabric inventory. + ## 7. Implementation Details ### Generated Files and Environment From d288e1446f374665a6e1cf812e45cc3aeb127961 Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Thu, 5 Nov 2026 19:17:37 -0800 Subject: [PATCH 29/34] fix: harden Hermes native interface cleanup and configuration Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- adapters/python/hermes/README.md | 4 +- .../nemo_fabric_adapters/hermes/adapter.py | 6 ++ .../nemo_fabric_adapters/hermes/interfaces.py | 21 ++++-- .../src/nemo_fabric_adapters/hermes/native.py | 10 ++- .../harness/hermes-interfaces.mdx | 44 +++++++----- docs/integrations/harness/hermes.mdx | 4 +- examples/interfaces/README.md | 8 +-- tests/adapters/test_hermes_interfaces.py | 70 +++++++++++++++++++ tests/adapters/test_hermes_native_config.py | 24 +++++++ 9 files changed, 159 insertions(+), 32 deletions(-) diff --git a/adapters/python/hermes/README.md b/adapters/python/hermes/README.md index 31e2bf0ab..c8a0a200b 100644 --- a/adapters/python/hermes/README.md +++ b/adapters/python/hermes/README.md @@ -7,7 +7,7 @@ SPDX-License-Identifier: Apache-2.0 This adapter runs Hermes Agent through its Python SDK. -Managed API and dashboard children launch through an adapter-owned bootstrap that applies the same behavioral mapping when Hermes constructs native agent instances. Fabric-configured instructions, tool policy, turn limits, generation settings, and trajectory settings take precedence over native constructor defaults. The bootstrap retains native routing, session identity, execution, and transport; it does not modify the installed Hermes source. A mode-`0600` configuration snapshot under the runtime's `interfaces` directory supplies the mapping and is removed on stop. Gateway processes independently started outside this launcher do not receive this guarantee. +Managed API and dashboard children launch through an adapter-owned bootstrap that applies the same behavioral mapping when Hermes constructs native agent instances. Instructions and behavioral settings configured by NeMo Fabric take precedence over native constructor defaults. Explicit tool selection and nonempty blocked-tool policies override native defaults; unspecified tool policies retain native interface defaults. The bootstrap retains native routing, session identity, execution, and transport; it does not modify the installed Hermes source. A mode-`0600` configuration snapshot under the runtime's `interfaces` directory supplies the mapping and is removed on stop. Gateway processes independently started outside this launcher do not receive this guarantee. ## Runtime Health @@ -89,7 +89,7 @@ The descriptor validates the following `harness.settings` fields: | `max_tokens` | positive integer | `512` | Limits the number of tokens in each Hermes model response. | | `terminal_timeout` | positive number | `60` | Limits a Hermes terminal operation in seconds. | | `interfaces.api`, `interfaces.dashboard` | object | None | Serve Hermes's API server or dashboard from a runtime, each with an exact `port` and optional `enabled`; see [Access and Use](../../../docs/integrations/harness/hermes-interfaces.mdx#3-access-and-use). | -| `startup_timeout_seconds` | number, at most 75 | `60` | Time from the start of the runtime for every enabled interface to pass its health check. | +| `startup_timeout_seconds` | number, greater than 0 and at most 75 | `60` | Time from the start of the runtime for every enabled interface to pass its health check. | For example: diff --git a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/adapter.py b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/adapter.py index 29443e2d1..de82084fc 100755 --- a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/adapter.py +++ b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/adapter.py @@ -212,6 +212,12 @@ async def start(self, payload: dict[str, Any]) -> None: ) if interface_ports: environment = dict(os.environ) + if ( + str(model_config.provider or "").lower() == "openai" + and not model_config.base_url + ): + # An ambient endpoint must not redirect the configured key. + environment.pop("OPENAI_BASE_URL", None) provider_key_env = configuration.PROVIDER_DEFAULT_API_KEY_ENV.get( str(model_config.provider or "").lower() ) diff --git a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/interfaces.py b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/interfaces.py index b5172c5bd..36f25f52a 100644 --- a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/interfaces.py +++ b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/interfaces.py @@ -8,6 +8,7 @@ import asyncio import http.client import json +import logging import os import secrets import signal @@ -22,6 +23,7 @@ from nemo_fabric_adapters.common import utils as common_utils HEALTH_PATHS = {"api": "/health", "dashboard": "/api/status"} +LOGGER = logging.getLogger(__name__) # Children run in their own sessions and stop by process group. POSIX = os.name != "nt" DEFAULT_STARTUP_TIMEOUT_SECONDS = 60.0 @@ -139,9 +141,7 @@ async def start( async def stop(self) -> None: """Remove the API token, then stop every interface process group.""" - token_path, self._token_path = self._token_path, None - if token_path is not None: - token_path.unlink(missing_ok=True) + self._remove_private_file("_token_path") running = [ child for child in self._children if child.process.returncode is None ] @@ -159,12 +159,21 @@ async def stop(self) -> None: for child in running: common_utils.signal_process_group(child.process.pid, signal.SIGKILL) self._children = [] - if self._agent_config_path is not None: - self._agent_config_path.unlink(missing_ok=True) - self._agent_config_path = None + self._remove_private_file("_agent_config_path") if pending: await asyncio.wait(pending) + def _remove_private_file(self, attribute: str) -> None: + path = getattr(self, attribute) + if path is not None: + try: + path.unlink(missing_ok=True) + except OSError: + # Retain the path for retry; cleanup must not prevent child stop. + LOGGER.exception("Could not remove Hermes interface file %s", path) + else: + setattr(self, attribute, None) + def _web_dist() -> Path: configured = os.environ.get("HERMES_WEB_DIST") diff --git a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/native.py b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/native.py index b26099f5f..ff30eabdc 100644 --- a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/native.py +++ b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/native.py @@ -44,8 +44,16 @@ def configured_kwargs( config: AgentConfig, native_kwargs: dict[str, Any], native_config: dict[str, Any] ) -> dict[str, Any]: """Apply Fabric-owned behavior while retaining native routing and identity.""" - enabled = configuration.resolve_hermes_toolsets(config, native_config) + enabled = ( + configuration.resolve_hermes_toolsets(config, native_config) + if config.tools is not None and config.tools.enabled is not None + else None + ) behavior = configuration.agent_behavior_kwargs(config, enabled) + if config.tools is None or config.tools.enabled is None: + behavior.pop("enabled_toolsets") + if config.tools is None or not config.tools.blocked: + behavior.pop("disabled_toolsets") overrides = { **(native_kwargs.get("request_overrides") or {}), **(behavior["request_overrides"] or {}), diff --git a/docs/integrations/harness/hermes-interfaces.mdx b/docs/integrations/harness/hermes-interfaces.mdx index 6e4bf4fdd..5a01c7e0f 100644 --- a/docs/integrations/harness/hermes-interfaces.mdx +++ b/docs/integrations/harness/hermes-interfaces.mdx @@ -5,23 +5,23 @@ description: "Run Hermes native interfaces alongside SDK invocations, with share {/* SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved. SPDX-License-Identifier: Apache-2.0 */} -NVIDIA NeMo Fabric can start Hermes's native API server and dashboard alongside its embedded SDK agent. One Fabric runtime owns these execution paths, while each retains its own agent instances and conversations. Start with the [Hermes adapter guide](./hermes.mdx) for installation and normalized SDK configuration. +NVIDIA NeMo Fabric can start Hermes's native API server and dashboard alongside its embedded SDK agent. One NeMo Fabric runtime owns these execution paths, while each retains its own agent instances and conversations. Start with the [Hermes adapter guide](./hermes.mdx) for installation and normalized SDK configuration. ## 1. Overview The following diagram shows the two invocation paths within one runtime. -![One Fabric runtime owns an embedded Hermes agent and a managed Hermes Gateway. SDK calls use the embedded agent; native clients use gateway agents with separate conversations. The dashed TUI path is proposed.](../../../assets/hermes-runtime-invocation.png) +![One NeMo Fabric runtime owns an embedded Hermes agent and a managed Hermes Gateway. SDK calls use the embedded agent; native clients use gateway agents with separate conversations. The dashed TUI path is proposed.](../../../assets/hermes-runtime-invocation.png) The TUI path is proposed; the adapter currently exposes API and dashboard settings only. | Path | Execution | Conversation and result | | --- | --- | --- | -| `Runtime.invoke()` or `Runtime.invoke_stream()` | The embedded Hermes `AIAgent` in the adapter host | Reuses the Fabric conversation and produces a normalized Fabric `RunResult`; for streaming, retrieve it through `stream.result()`. | +| `Runtime.invoke()` or `Runtime.invoke_stream()` | The embedded Hermes `AIAgent` in the adapter host | Reuses the NeMo Fabric conversation and produces a normalized NeMo Fabric `RunResult`; for streaming, retrieve it through `stream.result()`. | | Native API | Hermes creates gateway-side agent instances | Uses native conversations and returns native API responses. | | Browser chat | Hermes's dashboard and native gateway facilities | Uses native conversation behavior and browser responses. | -These agents run the same Hermes agent-loop implementation. Sharing a Hermes home gives them access to persisted resources; it does not combine their live state or attach a native conversation to Fabric's embedded conversation. +These agents run the same Hermes agent-loop implementation. Sharing a Hermes home gives them access to persisted resources; it does not combine their live state or attach a native conversation to NeMo Fabric's embedded conversation. ### What NeMo Fabric Normalizes @@ -29,9 +29,9 @@ These agents run the same Hermes agent-loop implementation. Sharing a Hermes hom | --- | --- | --- | | Configuration | Mapped from `FabricConfig` | Managed child processes receive the same behavioral mapping and generated native configuration. | | Lifecycle | Managed by the runtime | The adapter starts and stops its child processes. Descendant cleanup and independently started gateways have limits described below. | -| Results | Normalized `RunResult`, including available usage and artifact references | Native responses are not converted into Fabric `RunResult` objects. | +| Results | Normalized `RunResult`, including available usage and artifact references | Native responses are not converted into NeMo Fabric `RunResult` objects. | | Relay evidence | Standard Relay artifacts and invocation telemetry references | Supported native events use Relay's standard formats and native session identities. Emitting those records does not create a normalized invocation result. | -| Session artifacts | Collected through the SDK invocation path | Native session storage is shared, but session-scoped collection into Fabric's artifact model remains separate work. | +| Session artifacts | Collected through the SDK invocation path | Native session storage is shared, but session-scoped collection into NeMo Fabric's artifact model remains separate work. | ## 2. Configuration @@ -86,31 +86,31 @@ Open the configured loopback port in a browser. The dashboard has no sign-in: He ### Conversations and Responses -Ordered SDK invocations reuse the embedded agent's conversation. Native clients use Hermes's native session mechanisms and receive native responses; these do not pass through `Runtime.invoke()` or become Fabric `RunResult` objects. +Ordered SDK invocations reuse the embedded agent's conversation. Native clients use Hermes's native session mechanisms and receive native responses; these do not pass through `Runtime.invoke()` or become NeMo Fabric `RunResult` objects. The runtime's Hermes home is stored under `/.fabric/hermes/runtimes/`. Sharing that home gives access to persisted resources, but does not select a shared live conversation or establish cross-runtime resume. -## 4. What Fabric Manages +## 4. What NeMo Fabric Manages ### Configuration Mapping and Precedence NeMo Fabric resolves `FabricConfig` into a validated `AgentConfig`. The adapter uses it for the embedded agent and for agent instances created inside managed native processes. Instructions, enabled and blocked toolsets, turn limit, token limit, temperature, top-p, reasoning configuration, and trajectory settings use the same behavioral mapping. -Fabric-configured instructions and behavioral values take precedence over native constructor defaults. Native routing, conversation identity, execution, and protocol remain Hermes behavior. The model credential is supplied through the child's environment. Refer to [Implementation Details](#7-implementation-details) for the generated files and launcher mechanism. +Instructions and behavioral values configured by NeMo Fabric take precedence over native constructor defaults. Explicit `tools.enabled` (including an empty list) overrides native tool selection; a nonempty `tools.blocked` overrides native exclusions. When these policies are unspecified, native interface tool defaults remain in effect; the embedded SDK path retains its existing CLI defaults. Set both policies explicitly when comparing tool parity. Native routing, conversation identity, execution, and protocol remain Hermes behavior. The model credential is supplied through the child's environment. For OpenAI without an explicit `base_url`, managed children discard inherited `OPENAI_BASE_URL` so it cannot redirect the configured credential. An explicit endpoint uses the generated native model routing. Refer to [Implementation Details](#7-implementation-details) for the generated files and launcher mechanism. ### Startup, Readiness, and Shutdown Startup launches enabled interfaces as child processes on the adapter's interpreter. The API server must pass `GET /health`, and the dashboard must pass `GET /api/status`, within the remaining startup budget. An occupied port, early child exit, or readiness timeout fails startup. Failed startup attempts clean up the children they started. -Stop removes the API token, sends SIGTERM to running interface process groups, and escalates to SIGKILL after a five-second grace. The API gateway is configured with a three-second drain for API work and cron jobs. The agent configuration snapshot is removed during cleanup, and the adapter closes the embedded agent and session database. +Stop removes the API token, sends SIGTERM to running interface process groups, and escalates to SIGKILL after a five-second grace. The API gateway is configured with a three-second drain for API work and cron jobs. The agent configuration snapshot is removed during cleanup, and the adapter closes the embedded agent and session database. If token or snapshot deletion fails, the adapter logs the error and continues stopping children; a later stop retries removal. ### Relay Evidence and Artifact Boundaries -Enable Relay through the normal NeMo Fabric telemetry configuration. The embedded and managed native paths receive the generated Relay plugin configuration. Native sessions retain their own trace roots rather than being assigned to the embedded Fabric invocation. +Enable Relay through the normal NeMo Fabric telemetry configuration. The embedded and managed native paths receive the generated Relay plugin configuration. Native sessions retain their own trace roots rather than being assigned to the embedded NeMo Fabric invocation. For SDK invocations, the adapter finalizes the Hermes Relay session and flushes subscribers before returning, so available ATOF/ATIF artifacts are complete at the invocation boundary. Managed native API turns also finalize and flush a Relay segment when execution returns. This makes ATIF available per turn without deleting the native conversation; subsequent turns can continue it and produce separate segments. Export failures are logged, so consumers must verify artifact contents. With a live Relay runtime, Hermes emits `compaction` when tracked compaction rewrites history or provider state; `compaction.attempt` describes an attempt that is blocked, skipped, fails, or aborts without a rewrite. -Native API responses remain native responses. Relay's standard artifact format provides common execution evidence, but does not by itself provide Fabric result normalization, complete usage accounting, or session-scoped collection of native transcripts and generated files. +Native API responses remain native responses. Relay's standard artifact format provides common execution evidence, but does not by itself provide NeMo Fabric result normalization, complete usage accounting, or session-scoped collection of native transcripts and generated files. ## 5. Testing @@ -121,12 +121,17 @@ Prepare the repository's Hermes environment as described in [Install the Adapter ```bash export ADAPTER_PYTHON="$PWD/.venv-hermes/bin/python" .venv-hermes/bin/python -m pytest \ + tests/adapters/test_hermes_adapter.py \ tests/adapters/test_hermes_native_config.py \ tests/adapters/test_hermes_config_builder.py \ - tests/adapters/test_hermes_interfaces.py -q + tests/adapters/test_hermes_interfaces.py \ + tests/adapters/test_hermes_streaming.py \ + tests/adapters/test_hermes_health.py \ + tests/e2e/test_hermes_e2e.py \ + tests/e2e/test_hermes_checks.py -q ``` -These tests exercise the installed native Hermes processes against a local mock model endpoint. They check configuration mapping, fresh conversations, ATIF export at turn completion, continued native conversation state, private configuration files, authentication, readiness failures, and cleanup. They do not establish compatibility with your hosted model or qualify browser interaction. +These tests exercise the installed Hermes processes against a local mock model endpoint. They check the existing SDK invocation and streaming paths, warm-session reuse, normalized results and Relay artifacts, health checks, native configuration mapping, fresh conversations, ATIF export at turn completion, continued native conversation state, private configuration files, authentication, readiness failures, and cleanup. They do not establish compatibility with your hosted model or qualify browser interaction. ### Run a Live File Task and Inspect Relay @@ -144,7 +149,7 @@ export ADAPTER_PYTHON="$PWD/.venv-hermes/bin/python" The example uses sample release notes by default. Add `--input-file /path/to/release-notes.md` for your own input. Its README includes setup, output verification, and commands to inspect ATIF tool steps and raw ATOF events. The example exits unsuccessfully if the generated file, tool observations, populated ATIF trajectory, or token cleanup is missing. -Matching answers or generated configuration files do not establish configuration parity. Inspect actual model requests for the configured model, credential, instructions, generation settings, and tool policy. Verify session attribution in the trace; the native API response remains distinct from a normalized Fabric `RunResult`. +Matching answers or generated configuration files do not establish configuration parity. Inspect actual model requests for the configured model, credential, instructions, generation settings, and tool policy. Verify session attribution in the trace; the native API response remains distinct from a normalized NeMo Fabric `RunResult`. ## 6. Limitations and Planned Work @@ -152,22 +157,27 @@ Matching answers or generated configuration files do not establish configuration - Denied process-group signals fall back to the direct child. This does not guarantee that all descendants have stopped. - The adapter does not restart an interface child after a crash. Dashboard gateway actions can start processes outside the adapter launcher and its configuration mapping. +- Filesystem permission errors can leave the token or configuration snapshot on disk after stop. Child shutdown continues, and removal is retried on a later stop; inspect cleanup errors and remove retained files after correcting permissions. - Readiness currently checks the HTTP response without verifying that the child owns the listening port. - NeMo Fabric's `check()` reports embedded SDK agent health and activity only. It does not aggregate native interface health or active native turns. Startup probes check API `/health` and dashboard `/api/status`; the adapter does not monitor child health continuously. - There is no unified inventory of all agent instances in a runtime. SDK invocation tracking covers SDK requests; native API run status and persisted sessions are exposed through Hermes endpoints. Persisted sessions do not identify all live agent objects, which can exist only for a turn. - Child processes inherit the embedded adapter's `HERMES_YOLO_MODE` environment setting. Interactive approval behavior requires separate review and validation. -- Native responses and complete usage accounting are not normalized into Fabric invocation results by these interfaces. +- Native responses and complete usage accounting are not normalized into NeMo Fabric invocation results by these interfaces. ### Unqualified Paths The API configuration-parity tests do not qualify browser interaction, explicit resume, or gateway replacement. Each needs its own behavioral and lifecycle evidence. +The no-URL OpenAI regression checks child environment isolation with a mocked embedded constructor, not provider authentication or a live request to OpenAI. Hosted-model tests use an explicit OpenAI-compatible endpoint; provider login and fallback routing without an explicit endpoint require separate qualification. + ### Planned Work -Native TUI support remains proposed and is shown as a dashed path in the diagram. Session-scoped collection of native transcripts and generated files into Fabric's artifact model remains separate work; standard Relay formatting alone does not provide it. +Native TUI support remains proposed and is shown as a dashed path in the diagram. Session-scoped collection of native transcripts and generated files into NeMo Fabric's artifact model remains separate work; standard Relay formatting alone does not provide it. Add runtime-wide health and discovery that covers the embedded agent and managed native interfaces. Report process health and readiness separately from active runs and persisted sessions, include child failures and native activity in aggregate status, and provide a way to discover native runs and sessions alongside SDK invocations. Hermes's authenticated `/health/detailed`, `/v1/runs/{run_id}`, and `/api/sessions` endpoints provide native diagnostics today; they do not provide a unified NeMo Fabric inventory. +Follow-up lifecycle work should verify listener ownership during readiness, strengthen descendant cleanup when process-group signals are denied, and define ownership and configuration guarantees for gateway replacement. Qualify interactive approvals and browser chat separately before extending their support claims. Cross-runtime resume and SDK/native conversation handoff remain deferred. + ## 7. Implementation Details ### Generated Files and Environment diff --git a/docs/integrations/harness/hermes.mdx b/docs/integrations/harness/hermes.mdx index 03e9dfaed..d297e2c2e 100644 --- a/docs/integrations/harness/hermes.mdx +++ b/docs/integrations/harness/hermes.mdx @@ -51,7 +51,7 @@ config = FabricConfig.from_mapping( "default": { "provider": "openai", "model": "your-model", - "base_url": "http://MODEL_HOST:8000/v1", + "base_url": "https://MODEL_HOST/v1", "api_key_env": "MODEL_API_KEY", "temperature": 0.0, "top_p": 0.9, @@ -90,7 +90,7 @@ Native interface settings are documented in the [Hermes native interfaces guide] Each runtime creates one embedded Hermes `AIAgent` and one `SessionDB`. Ordered SDK invocations reuse these objects and their conversation history until stop closes them. The Hermes home is stored under `/.fabric/hermes/runtimes/`; retaining files does not by itself establish cross-runtime conversation resume. -SDK invocations return normalized Fabric `RunResult` objects. The adapter finalizes the Hermes Relay session and flushes subscribers before returning, so available ATOF/ATIF artifacts are complete at that invocation boundary. Native interface responses follow a different path, described in [What NeMo Fabric Normalizes](./hermes-interfaces.mdx#what-nemo-fabric-normalizes). +SDK invocations return normalized NeMo Fabric `RunResult` objects. The adapter finalizes the Hermes Relay session and flushes subscribers before returning, so available ATOF/ATIF artifacts are complete at that invocation boundary. Native interface responses follow a different path, described in [What NeMo Fabric Normalizes](./hermes-interfaces.mdx#what-nemo-fabric-normalizes). ## Runtime Health diff --git a/examples/interfaces/README.md b/examples/interfaces/README.md index 769c7c8a7..390eda4ef 100644 --- a/examples/interfaces/README.md +++ b/examples/interfaces/README.md @@ -5,11 +5,11 @@ SPDX-License-Identifier: Apache-2.0 # NVIDIA NeMo Fabric Native Interface Examples -Use native harness interfaces alongside a Fabric-managed runtime. Each harness example uses the public Python SDK for configuration and lifecycle, then sends input through the harness's native interface. +Use native harness interfaces alongside a NeMo Fabric-managed runtime. Each harness example uses the public Python SDK for configuration and lifecycle, then sends input through the harness's native interface. ## Hermes API and Relay -[`hermes.py`](hermes.py) starts one managed Hermes API server, submits a real file task, verifies the generated file, and checks Relay ATOF events and ATIF tool steps. Its API response remains native; the SDK manages the runtime but does not convert this response into a Fabric `RunResult`. +[`hermes.py`](hermes.py) starts one managed Hermes API server, submits a real file task, verifies the generated file, and checks Relay ATOF events and ATIF tool steps. Its API response remains native; the SDK manages the runtime but does not convert this response into a NeMo Fabric `RunResult`. ### Prepare the Environment @@ -25,12 +25,12 @@ This prepares pinned Hermes v0.22.5, the adapter, and Relay 0.10. The applicatio Set your OpenAI-compatible model endpoint, served model name, and credential: ```bash -export MODEL_BASE_URL="http://MODEL_HOST:8000/v1" +export MODEL_BASE_URL="https://MODEL_HOST/v1" export MODEL_NAME="YOUR_SERVED_MODEL_NAME" export MODEL_API_KEY="YOUR_MODEL_API_KEY" ``` -Use the value required by your endpoint. An endpoint without authentication can use a nonempty placeholder credential. To reference an existing credential variable instead, pass its name with `--api-key-env`. +Use HTTPS for remote endpoints that receive credentials. For a local server, use a loopback URL such as `http://127.0.0.1:8000/v1`; an authenticated encrypted tunnel is another option. Use the credential value required by your endpoint. An endpoint without authentication can use a nonempty placeholder credential. To reference an existing credential variable instead, pass its name with `--api-key-env`. ### Run a Real Task diff --git a/tests/adapters/test_hermes_interfaces.py b/tests/adapters/test_hermes_interfaces.py index f4aa73943..cf2f15bfc 100644 --- a/tests/adapters/test_hermes_interfaces.py +++ b/tests/adapters/test_hermes_interfaces.py @@ -490,6 +490,76 @@ async def record_start(self, ports, *, timeout, **kwargs): assert timeouts[0] <= 4.5 +@pytest.mark.parametrize("explicit_endpoint", [False, True]) +async def test_native_openai_endpoint_does_not_use_ambient_fallback( + tmp_path, api_server, monkeypatch, explicit_endpoint +): + os.environ["OPENAI_BASE_URL"] = "http://ambient.invalid/v1" + import run_agent + + # This test observes child environment construction, not provider login. + monkeypatch.setattr(run_agent, "AIAgent", MagicMock()) + environments = [] + + async def record_start(self, ports, *, environment, **kwargs): + environments.append(environment) + + monkeypatch.setattr(interfaces.InterfaceChildren, "start", record_start) + runtime = adapter.HermesRuntime() + try: + await runtime.start( + _payload( + tmp_path, + {"interfaces": {"api": {"port": 8642}}}, + base_url=f"{api_server}/v1" if explicit_endpoint else None, + ) + ) + assert environments[0]["OPENAI_API_KEY"] == MODEL_KEY + if explicit_endpoint: + assert runtime._hermes_config["model"]["base_url"] == f"{api_server}/v1" + else: + assert "OPENAI_BASE_URL" not in environments[0] + assert os.environ["OPENAI_BASE_URL"] == "http://ambient.invalid/v1" + finally: + await runtime.stop() + + +@pytest.mark.parametrize("failed_attribute", ["_token_path", "_agent_config_path"]) +async def test_private_file_removal_failure_still_stops_children_and_retries( + tmp_path, monkeypatch, caplog, failed_attribute +): + children = interfaces.InterfaceChildren() + for attribute in ("_token_path", "_agent_config_path"): + path = tmp_path / attribute + path.write_text("private") + setattr(children, attribute, path) + failed_path = getattr(children, failed_attribute) + process = MagicMock(pid=1234, returncode=None, wait=AsyncMock(return_value=0)) + children._children.append(interfaces._Child("api", 0, process)) + signal_group = MagicMock() + monkeypatch.setattr(interfaces.common_utils, "signal_process_group", signal_group) + unlink = Path.unlink + + def deny_private_file(path, *args, **kwargs): + if path == failed_path: + raise PermissionError("test removal denied") + return unlink(path, *args, **kwargs) + + with monkeypatch.context() as patch: + patch.setattr(Path, "unlink", deny_private_file) + await children.stop() + + assert process.wait.await_count == 1 + assert signal_group.call_count == 2 + assert not children._children + assert getattr(children, failed_attribute) == failed_path + assert "Could not remove Hermes interface file" in caplog.text + await children.stop() + assert not failed_path.exists() + assert children._token_path is None + assert children._agent_config_path is None + + async def test_hermes_interface_start_timeout_stops_the_started_child( tmp_path: Path, api_server: str, monkeypatch: pytest.MonkeyPatch ): diff --git a/tests/adapters/test_hermes_native_config.py b/tests/adapters/test_hermes_native_config.py index 4e4a5e7e0..efb55cac0 100644 --- a/tests/adapters/test_hermes_native_config.py +++ b/tests/adapters/test_hermes_native_config.py @@ -83,6 +83,30 @@ def test_native_behavior_preserves_native_prompt_when_fabric_has_none(): assert result["max_iterations"] == configuration.DEFAULT_MAX_ITERATIONS +@pytest.mark.parametrize( + "tools,enabled,blocked", + [ + (None, ["native"], ["terminal"]), + ({}, ["native"], ["terminal"]), + ({"enabled": []}, [], ["terminal"]), + ({"blocked": ["web"]}, ["native"], ["web"]), + ], +) +def test_native_tool_defaults_survive_without_explicit_policy(tools, enabled, blocked): + mapping = {"models": {"default": {"provider": "openai", "model": "test"}}} + if tools is not None: + mapping["tools"] = tools + config = AgentConfig.from_mapping(mapping) + result = configured_kwargs( + config, + {"enabled_toolsets": ["native"], "disabled_toolsets": ["terminal"]}, + {}, + ) + + assert result["enabled_toolsets"] == enabled + assert result["disabled_toolsets"] == blocked + + @pytest.mark.parametrize( "platform,relay_enabled,expected", [("api_server", True, True), ("api_server", False, False), ("cli", True, False)], From 9974c019c34d0a5ab1844feaa9b3155f04223ec7 Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Thu, 5 Nov 2026 21:50:25 -0800 Subject: [PATCH 30/34] docs: link Hermes testing guidance to interfaces example Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- .../harness/hermes-interfaces.mdx | 37 +------------------ 1 file changed, 1 insertion(+), 36 deletions(-) diff --git a/docs/integrations/harness/hermes-interfaces.mdx b/docs/integrations/harness/hermes-interfaces.mdx index 5a01c7e0f..4c1513469 100644 --- a/docs/integrations/harness/hermes-interfaces.mdx +++ b/docs/integrations/harness/hermes-interfaces.mdx @@ -114,42 +114,7 @@ Native API responses remain native responses. Relay's standard artifact format p ## 5. Testing -### Run Automated Regressions - -Prepare the repository's Hermes environment as described in [Install the Adapter](./hermes.mdx#install-the-adapter), then run these commands from the repository root: - -```bash -export ADAPTER_PYTHON="$PWD/.venv-hermes/bin/python" -.venv-hermes/bin/python -m pytest \ - tests/adapters/test_hermes_adapter.py \ - tests/adapters/test_hermes_native_config.py \ - tests/adapters/test_hermes_config_builder.py \ - tests/adapters/test_hermes_interfaces.py \ - tests/adapters/test_hermes_streaming.py \ - tests/adapters/test_hermes_health.py \ - tests/e2e/test_hermes_e2e.py \ - tests/e2e/test_hermes_checks.py -q -``` - -These tests exercise the installed Hermes processes against a local mock model endpoint. They check the existing SDK invocation and streaming paths, warm-session reuse, normalized results and Relay artifacts, health checks, native configuration mapping, fresh conversations, ATIF export at turn completion, continued native conversation state, private configuration files, authentication, readiness failures, and cleanup. They do not establish compatibility with your hosted model or qualify browser interaction. - -### Run a Live File Task and Inspect Relay - -Use the [native interfaces example](../../../examples/interfaces/README.md) to submit real input through the Hermes API, verify its file effects, and inspect Relay evidence. It starts one runtime with ATOF and ATIF enabled and checks both formats separately. - -From the repository root, with your prepared Hermes environment and model credentials: - -```bash -export ADAPTER_PYTHON="$PWD/.venv-hermes/bin/python" -.venv-hermes/bin/python examples/interfaces/hermes.py \ - --base-url "$MODEL_BASE_URL" \ - --model "$MODEL_NAME" \ - --port 8642 -``` - -The example uses sample release notes by default. Add `--input-file /path/to/release-notes.md` for your own input. Its README includes setup, output verification, and commands to inspect ATIF tool steps and raw ATOF events. The example exits unsuccessfully if the generated file, tool observations, populated ATIF trajectory, or token cleanup is missing. - -Matching answers or generated configuration files do not establish configuration parity. Inspect actual model requests for the configured model, credential, instructions, generation settings, and tool policy. Verify session attribution in the trace; the native API response remains distinct from a normalized NeMo Fabric `RunResult`. +See the [Hermes interfaces example](../../../examples/interfaces/README.md) for setup, manual testing, output verification, and Relay trajectory inspection. ## 6. Limitations and Planned Work From 612ad0dfc70eab4edc42a6745feed2fafd39bb97 Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Thu, 5 Nov 2026 21:55:20 -0800 Subject: [PATCH 31/34] fix: allow a separate Hermes checkout for installation Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- docs/integrations/harness/hermes.mdx | 2 ++ examples/interfaces/README.md | 7 +++++++ justfile | 10 +++++----- 3 files changed, 14 insertions(+), 5 deletions(-) diff --git a/docs/integrations/harness/hermes.mdx b/docs/integrations/harness/hermes.mdx index d297e2c2e..ac5306062 100644 --- a/docs/integrations/harness/hermes.mdx +++ b/docs/integrations/harness/hermes.mdx @@ -30,6 +30,8 @@ just install-hermes-agent export ADAPTER_PYTHON="$PWD/.venv-hermes/bin/python" ``` +The installer preserves local checkout changes and stops rather than overwriting them. Set `HERMES_AGENT_CHECKOUT` to a separate clean checkout or a new directory to install without changing `external/hermes-agent`; the target environment remains `.venv-hermes`. + Hermes reports its Python package version as `0.0.0`, so use its Git tag and commit to identify the installed release. The pinned release includes dependency security fixes absent from v2026.9.24. ## Configure the Adapter diff --git a/examples/interfaces/README.md b/examples/interfaces/README.md index 390eda4ef..65b067c4c 100644 --- a/examples/interfaces/README.md +++ b/examples/interfaces/README.md @@ -22,6 +22,13 @@ export ADAPTER_PYTHON="$PWD/.venv-hermes/bin/python" This prepares pinned Hermes v0.22.5, the adapter, and Relay 0.10. The application interpreter also needs the NeMo Fabric SDK. The command below uses the prepared Hermes environment for both application and adapter. +If `external/hermes-agent` contains local changes, preserve them and select a separate checkout instead. The installer creates the selected checkout if needed and still prepares `.venv-hermes`: + +```bash +HERMES_AGENT_CHECKOUT="$PWD/.tmp/hermes-agent-v0.22.5" just install-hermes-agent +export ADAPTER_PYTHON="$PWD/.venv-hermes/bin/python" +``` + Set your OpenAI-compatible model endpoint, served model name, and credential: ```bash diff --git a/justfile b/justfile index ccc0993c0..95eac0d96 100644 --- a/justfile +++ b/justfile @@ -398,7 +398,7 @@ install-hermes-agent: #!/usr/bin/env bash set -euo pipefail hermes_commit="bf0203a794a07aac3ff764972ab9087baa4e4f4e" - hermes_checkout="$REPO_ROOT/external/hermes-agent" + hermes_checkout="${HERMES_AGENT_CHECKOUT:-$REPO_ROOT/external/hermes-agent}" hermes_diff_pathspec=() if [[ -e "$hermes_checkout" && ! -d "$hermes_checkout/.git" ]]; then @@ -419,8 +419,8 @@ install-hermes-agent: if [[ "$hermes_head" != "$hermes_commit" ]]; then if [[ -n "$hermes_head" ]] && { ! git -C "$hermes_checkout" diff --quiet "${hermes_diff_pathspec[@]}" || ! git -C "$hermes_checkout" diff --cached --quiet; }; then echo "ERROR: Hermes Agent checkout has tracked changes at an unpinned revision: $hermes_checkout" >&2 - echo "If these are disposable changes from the old metadata-propagate.patch, run:" >&2 - echo " git -C \"$hermes_checkout\" restore --source=HEAD --staged --worktree -- ." >&2 + echo "Preserve local changes and select a separate checkout:" >&2 + echo ' HERMES_AGENT_CHECKOUT=/path/to/clean/hermes-agent just install-hermes-agent' >&2 exit 1 fi if ! git -C "$hermes_checkout" cat-file -e "$hermes_commit^{commit}" 2>/dev/null; then @@ -430,8 +430,8 @@ install-hermes-agent: fi if ! git -C "$hermes_checkout" diff --cached --quiet || ! git -C "$hermes_checkout" diff --quiet "${hermes_diff_pathspec[@]}"; then echo "ERROR: Hermes Agent checkout has tracked changes: $hermes_checkout" >&2 - echo "To discard only tracked changes that you do not need, run:" >&2 - echo " git -C \"$hermes_checkout\" restore --source=HEAD --staged --worktree -- ." >&2 + echo "Preserve local changes and select a separate checkout:" >&2 + echo ' HERMES_AGENT_CHECKOUT=/path/to/clean/hermes-agent just install-hermes-agent' >&2 exit 1 fi if [[ ! -x "$REPO_ROOT/.venv-hermes/bin/python" ]] || From b424e2fe9f811a6f4247fcc56641163833759c40 Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Thu, 5 Nov 2026 21:58:30 -0800 Subject: [PATCH 32/34] docs: keep Hermes example setup focused Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- examples/interfaces/README.md | 7 ------- 1 file changed, 7 deletions(-) diff --git a/examples/interfaces/README.md b/examples/interfaces/README.md index 65b067c4c..390eda4ef 100644 --- a/examples/interfaces/README.md +++ b/examples/interfaces/README.md @@ -22,13 +22,6 @@ export ADAPTER_PYTHON="$PWD/.venv-hermes/bin/python" This prepares pinned Hermes v0.22.5, the adapter, and Relay 0.10. The application interpreter also needs the NeMo Fabric SDK. The command below uses the prepared Hermes environment for both application and adapter. -If `external/hermes-agent` contains local changes, preserve them and select a separate checkout instead. The installer creates the selected checkout if needed and still prepares `.venv-hermes`: - -```bash -HERMES_AGENT_CHECKOUT="$PWD/.tmp/hermes-agent-v0.22.5" just install-hermes-agent -export ADAPTER_PYTHON="$PWD/.venv-hermes/bin/python" -``` - Set your OpenAI-compatible model endpoint, served model name, and credential: ```bash From 1907d1f62e0f80fbe4ee1cf6b812dd99ee9fbcd7 Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Thu, 5 Nov 2026 22:08:00 -0800 Subject: [PATCH 33/34] fix: isolate managed Hermes API from messaging platforms Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- .../nemo_fabric_adapters/hermes/adapter.py | 14 ++++++++ .../harness/hermes-interfaces.mdx | 2 +- examples/interfaces/hermes.py | 2 ++ tests/adapters/test_hermes_interfaces.py | 33 +++++++++++++++++++ 4 files changed, 50 insertions(+), 1 deletion(-) diff --git a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/adapter.py b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/adapter.py index de82084fc..3fa9935f1 100755 --- a/adapters/python/hermes/src/nemo_fabric_adapters/hermes/adapter.py +++ b/adapters/python/hermes/src/nemo_fabric_adapters/hermes/adapter.py @@ -211,6 +211,20 @@ async def start(self, payload: dict[str, Any]) -> None: ) ) if interface_ports: + if "api" in interface_ports: + from hermes_cli.profile_channels import platform_ids + + # This gateway serves the managed API, not ambient chat bots. + # Explicit disables beat Hermes's credential-based enablement. + self._hermes_config["platforms"] = { + name: {"enabled": False} + for name in platform_ids(self._hermes_home) + if name != "api_server" + } + self._hermes_config["gateway"] = {"multiplex_profiles": False} + self._hermes_config_path.write_text( + common_utils.dump_yaml(self._hermes_config), encoding="utf-8" + ) environment = dict(os.environ) if ( str(model_config.provider or "").lower() == "openai" diff --git a/docs/integrations/harness/hermes-interfaces.mdx b/docs/integrations/harness/hermes-interfaces.mdx index 4c1513469..1fe7c0bfc 100644 --- a/docs/integrations/harness/hermes-interfaces.mdx +++ b/docs/integrations/harness/hermes-interfaces.mdx @@ -157,7 +157,7 @@ The adapter prepares three configuration surfaces from the resolved `AgentConfig The model credential value is supplied through the child's environment; the native model configuration references `api_key_env`. -Children inherit the adapter host's environment after ambient `API_SERVER_*` variables are removed. The API gateway can also activate other Hermes platforms configured by that environment, such as Telegram through `TELEGRAM_BOT_TOKEN` or webhooks through `WEBHOOK_ENABLED`. +Children inherit the adapter host's environment after ambient `API_SERVER_*` variables are removed. When the API interface is enabled, the generated configuration explicitly disables other known gateway platforms and profile multiplexing. Inherited settings such as `TELEGRAM_BOT_TOKEN` or `WEBHOOK_ENABLED` therefore do not start messaging adapters or their dependency installers. This restriction applies to the managed runtime home; independently launched gateways outside that home retain their own configuration. ### Native Launcher and Constructor Mapping diff --git a/examples/interfaces/hermes.py b/examples/interfaces/hermes.py index 63109e003..8f8a6c8a7 100644 --- a/examples/interfaces/hermes.py +++ b/examples/interfaces/hermes.py @@ -140,6 +140,7 @@ async def run(args: argparse.Namespace) -> None: prompt = f"Read {source} and create {checklist} containing a concise five-item rollout validation checklist based on the release notes. Use file tools to read and write. Then report the created file path." api = f"http://127.0.0.1:{args.port}" print(f"Evidence directory: {output}", flush=True) + print("Starting managed Hermes API (startup budget: 60 seconds)...", flush=True) async with await Fabric().start_runtime(config, base_dir=output) as runtime: token_path = ( output @@ -148,6 +149,7 @@ async def run(args: argparse.Namespace) -> None: / "interfaces/api.token" ) print(f"API: {api}\nToken file: {token_path}", flush=True) + print("Running the file task (API request timeout: 180 seconds)...", flush=True) response = await asyncio.to_thread( call_api, api, token_path.read_text(), prompt ) diff --git a/tests/adapters/test_hermes_interfaces.py b/tests/adapters/test_hermes_interfaces.py index cf2f15bfc..67be36680 100644 --- a/tests/adapters/test_hermes_interfaces.py +++ b/tests/adapters/test_hermes_interfaces.py @@ -208,6 +208,39 @@ async def test_hermes_gateway_agents_receive_fabric_behavior( assert not config_path.exists() +async def test_managed_api_does_not_enable_inherited_messaging_platforms( + tmp_path, api_server +): + os.environ["TELEGRAM_BOT_TOKEN"] = "123456789:ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghi" + os.environ["WEBHOOK_ENABLED"] = "true" + os.environ["HERMES_DISABLE_LAZY_INSTALLS"] = "1" + port = _free_port() + runtime = adapter.HermesRuntime() + try: + await runtime.start( + _payload( + tmp_path, _interface("api", port=port), base_url=f"{api_server}/v1" + ) + ) + from gateway.config import Platform, load_gateway_config + + config = load_gateway_config() + assert config.platforms[Platform.TELEGRAM].enabled is False + assert config.platforms[Platform.WEBHOOK].enabled is False + assert config.multiplex_profiles is False + # Only the child receives API_SERVER_KEY; no other platform may connect. + assert set(config.get_connected_platforms()) <= {Platform.API_SERVER} + reply = await asyncio.to_thread( + requests.get, f"http://127.0.0.1:{port}/health", timeout=5 + ) + assert reply.status_code == 200 + log = (runtime._hermes_home / "logs/fabric-interface-api.log").read_text() + assert "attempting install" not in log + assert os.environ["TELEGRAM_BOT_TOKEN"].startswith("123456789:") + finally: + await runtime.stop() + + async def test_api_turns_export_atif_without_resetting_native_conversation( tmp_path: Path, api_server: str ): From 3ca1de8a7217345b61ffa16e0c5f850b5a5fa680 Mon Sep 17 00:00:00 2001 From: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> Date: Thu, 5 Nov 2026 22:26:45 -0800 Subject: [PATCH 34/34] docs: mark interfaces example as work in progress Signed-off-by: Anuradha Karuppiah <26330987+AnuradhaKaruppiah@users.noreply.github.com> --- examples/interfaces/README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/examples/interfaces/README.md b/examples/interfaces/README.md index 390eda4ef..31dea54b8 100644 --- a/examples/interfaces/README.md +++ b/examples/interfaces/README.md @@ -5,6 +5,8 @@ SPDX-License-Identifier: Apache-2.0 # NVIDIA NeMo Fabric Native Interface Examples +This example is a work in progress. Its structure and user experience will be reworked as part of OpenClaw TUI support. + Use native harness interfaces alongside a NeMo Fabric-managed runtime. Each harness example uses the public Python SDK for configuration and lifecycle, then sends input through the harness's native interface. ## Hermes API and Relay

Wv6u=7H1Q5f`kTm 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