fix(nemo-agents): update fabric adapter compatibility

packages/nemo_platform/pyproject.toml

@@ -234,7 +234,6 @@ nemo-agents-plugin = [
   "boto3>=1.40.46,<1.40.62",
   "botocore>=1.40.46,<1.40.62",
   "httpx>=0.27",
-  "nemo-fabric>=0.1.0a20260717,<0.2.0",
   "pyyaml>=6.0",
   "anthropic>=0.88.0",
   "rich>=13.7.1",

plugins/nemo-agents/examples/nemo-agent-config/.gitignore

@@ -0,0 +1,2 @@
+artifacts/
+workspace/

plugins/nemo-agents/examples/nemo-agent-config/README.md

@@ -0,0 +1,49 @@
+# Fabric-Backed Agent Config
+
+This Platform-owned config invokes Codex or Hermes through NeMo Fabric. Run the
+commands below from the repository root.
+
+Fabric dependencies are currently optional so the default workspace does not
+force other Fabric consumers onto the `0.1.0a20260724` SDK API before they migrate.
+Install them explicitly before local Fabric smoke tests:
+
+```bash
+uv pip install -e "plugins/nemo-agents[fabric]"
+```
+
+## Codex
+
+Authenticate Codex, leave `default_harness: codex` in `agent.yaml`, and run:
+
+```bash
+npm install -g @openai/codex
+codex login
+
+nemo agents invoke \
+  --agent-config plugins/nemo-agents/examples/nemo-agent-config/agent.yaml \
+  --input "Reply with exactly: platform fabric works"
+```
+
+## Hermes
+
+Hermes Agent has dependencies that conflict with the Platform environment, so
+install it with the Fabric adapter in a separate Python 3.12 environment:
+
+```bash
+uvx uv@0.9.14 venv --python 3.12 .venv-hermes
+uvx uv@0.9.14 --no-config pip install \
+  --python .venv-hermes/bin/python \
+  "nemo-fabric-adapters-hermes>=0.1.0a20260724,<0.2.0" \
+  "hermes-agent==0.19.0"
+
+export HERMES_ADAPTER_PYTHON="$PWD/.venv-hermes/bin/python"
+export NVIDIA_API_KEY="<your NVIDIA API key>"
+```
+
+Temporarily set `default_harness: hermes` in `agent.yaml`, then run:
+
+```bash
+nemo agents invoke \
+  --agent-config plugins/nemo-agents/examples/nemo-agent-config/agent.yaml \
+  --input "Reply with exactly: platform hermes works"
+```

plugins/nemo-agents/examples/nemo-agent-config/agent.yaml

@@ -2,7 +2,7 @@ config_format: nemo-agents-spec-v1
 name: test-agent
 description: Test agent config
 
-default_harness: hermes
+default_harness: codex
 
 harnesses:
   hermes:
@@ -13,6 +13,7 @@ harnesses:
       api_key_env: NVIDIA_API_KEY
       temperature: 0.0
     settings:
+      python_env: HERMES_ADAPTER_PYTHON
       base_url: https://integrate.api.nvidia.com/v1
       max_iterations: 1
       max_tokens: 512
@@ -24,7 +25,6 @@ harnesses:
     kind: codex
     settings:
       sandbox: workspace-write
-      skip_git_repo_check: true
       config_overrides:
         model_reasoning_effort: high
 

plugins/nemo-agents/pyproject.toml

@@ -16,9 +16,6 @@ dependencies = [
     "boto3>=1.40.46,<1.40.62",
     "botocore>=1.40.46,<1.40.62",
     "httpx>=0.27",
-    # TODO(AIRCORE-897): Move this to a stable Fabric version before release once available.
-    # TODO(AIRCORE-897): Add the `relay` extra once nemo-evaluator-sdk's nemo-relay pin allows >=0.5.
-    "nemo-fabric>=0.1.0a20260717,<0.2.0",
     "pyyaml>=6.0",
     # improvement/ subpackage — agent-improvement workflow (POC).
     "anthropic>=0.88.0",
@@ -62,6 +59,15 @@ nat_hermes_agent_adapter = "nat_hermes_agent_adapter.register"
 nat_openclaw_agent_adapter = "nat_openclaw_agent_adapter.register"
 
 [project.optional-dependencies]
+fabric = [
+    # TODO(AIRCORE-932): Move Fabric into the default plugin dependencies once evaluator has migrated
+    # to the 0.1.0a20260724+ config-first SDK API and Fabric packaging is stable across Platform environments.
+    # TODO(AIRCORE-897): Move this to a stable Fabric version before release once available.
+    # TODO(AIRCORE-897): Add the `relay` extra once nemo-evaluator-sdk's nemo-relay pin allows >=0.5.
+    "nemo-fabric[runtime]>=0.1.0a20260724,<0.2.0",
+    "nemo-fabric-adapters-codex>=0.1.0a20260724,<0.2.0",
+    "nemo-fabric-adapters-hermes>=0.1.0a20260724,<0.2.0; python_version < '3.14'",
+]
 container = [
     "jinja2>=3.1",
     "python-on-whales>=0.60",

plugins/nemo-agents/src/nemo_agents_plugin/fabric/translator.py

@@ -13,7 +13,7 @@
 
 HARNESS_ADAPTER_IDS = {
     "claude": "nvidia.fabric.claude",
-    "codex": "nvidia.fabric.codex.cli",
+    "codex": "nvidia.fabric.codex",
     "deepagents": "nvidia.fabric.langchain.deepagents",
     "hermes": "nvidia.fabric.hermes",
 }

plugins/nemo-agents/tests/unit/test_agent_config.py

@@ -34,6 +34,7 @@ def _example_yaml_config() -> dict:
                     "temperature": 0.0,
                 },
                 "settings": {
+                    "python_env": "HERMES_ADAPTER_PYTHON",
                     "base_url": "https://integrate.api.nvidia.com/v1",
                     "max_iterations": 1,
                     "max_tokens": 512,
@@ -46,7 +47,6 @@ def _example_yaml_config() -> dict:
                 "kind": "codex",
                 "settings": {
                     "sandbox": "workspace-write",
-                    "skip_git_repo_check": True,
                     "config_overrides": {"model_reasoning_effort": "high"},
                 },
             },
@@ -92,6 +92,7 @@ def test_example_yaml_config_validates(self) -> None:
         assert config.default_harness == "hermes"
         assert config.harnesses["hermes"].model is not None
         assert config.harnesses["hermes"].model.provider == "nvidia"
+        assert config.harnesses["hermes"].settings["python_env"] == "HERMES_ADAPTER_PYTHON"
         assert config.harnesses["codex"].settings["sandbox"] == "workspace-write"
         assert config.models["default"].model == "openai/gpt-5.4"
         assert config.skills is None

plugins/nemo-agents/tests/unit/test_fabric_translator.py

@@ -6,10 +6,11 @@
 from __future__ import annotations
 
 import copy
+from pathlib import Path
 from typing import Any
 
 import pytest
-from nemo_agents_plugin.agent_config import AgentConfig
+from nemo_agents_plugin.agent_config import AgentConfig, load_agent_config
 from nemo_agents_plugin.fabric.translator import FabricTranslationError, translate_agent_config
 
 
@@ -29,6 +30,7 @@ def _example_yaml_config() -> dict[str, Any]:
                     "temperature": 0.0,
                 },
                 "settings": {
+                    "python_env": "HERMES_ADAPTER_PYTHON",
                     "base_url": "https://integrate.api.nvidia.com/v1",
                     "system_prompt": "You are a concise assistant.",
                 },
@@ -37,7 +39,6 @@ def _example_yaml_config() -> dict[str, Any]:
                 "kind": "codex",
                 "settings": {
                     "sandbox": "workspace-write",
-                    "skip_git_repo_check": True,
                 },
             },
         },
@@ -70,6 +71,18 @@ def _example_yaml_config() -> dict[str, Any]:
 
 
 class TestTranslateAgentConfig:
+    def test_repository_example_uses_current_codex_and_isolated_hermes_adapters(self) -> None:
+        example_path = Path(__file__).parents[2] / "examples/nemo-agent-config/agent.yaml"
+        config = load_agent_config(example_path)
+
+        codex_config = translate_agent_config(config, harness_name="codex")
+        hermes_config = translate_agent_config(config, harness_name="hermes")
+
+        assert codex_config.harness.adapter_id == "nvidia.fabric.codex"
+        assert "skip_git_repo_check" not in codex_config.harness.settings
+        assert hermes_config.harness.adapter_id == "nvidia.fabric.hermes"
+        assert hermes_config.harness.settings["python_env"] == "HERMES_ADAPTER_PYTHON"
+
     def test_translates_default_harness(self) -> None:
         config = AgentConfig.model_validate(_example_yaml_config())
 
@@ -79,6 +92,7 @@ def test_translates_default_harness(self) -> None:
         assert fabric_config.metadata.description == "Example Agent"
         assert fabric_config.harness.adapter_id == "nvidia.fabric.hermes"
         assert fabric_config.harness.resolution == "preinstalled"
+        assert fabric_config.harness.settings["python_env"] == "HERMES_ADAPTER_PYTHON"
         assert fabric_config.harness.settings["system_prompt"] == "You are a concise assistant."
         assert fabric_config.models["default"].provider == "nvidia"
         assert fabric_config.models["default"].model == "nvidia/nemotron-3-nano-30b-a3b"
@@ -92,7 +106,7 @@ def test_selected_harness_uses_default_model(self) -> None:
 
         fabric_config = translate_agent_config(config, harness_name="codex")
 
-        assert fabric_config.harness.adapter_id == "nvidia.fabric.codex.cli"
+        assert fabric_config.harness.adapter_id == "nvidia.fabric.codex"
         assert fabric_config.harness.settings["sandbox"] == "workspace-write"
         assert fabric_config.models["default"].provider == "openai"
         assert fabric_config.models["default"].model == "openai/gpt-5.4"
@@ -101,7 +115,7 @@ def test_selected_harness_uses_default_model(self) -> None:
         ("kind", "adapter_id"),
         [
             ("claude", "nvidia.fabric.claude"),
-            ("codex", "nvidia.fabric.codex.cli"),
+            ("codex", "nvidia.fabric.codex"),
             ("deepagents", "nvidia.fabric.langchain.deepagents"),
             ("hermes", "nvidia.fabric.hermes"),
         ],

plugins/nemo-agents/tests/unit/test_fabric_validation.py

@@ -228,7 +228,7 @@ async def test_selected_harness_is_translated(self, fake_fabric_stack: None) ->
             fabric=_FakeFabric(),
         )
 
-        assert result.fabric_config.harness.adapter_id == "nvidia.fabric.codex.cli"
+        assert result.fabric_config.harness.adapter_id == "nvidia.fabric.codex"
         assert result.fabric_config.models["default"].model == "openai/gpt-5.4"
 
     async def test_invalid_platform_config_is_reported(self, fake_fabric_stack: None) -> None:

third_party/licenses.jsonl

@@ -152,7 +152,6 @@
 {"name": "multiprocess", "license": "BSD-3-CLAUSE", "compatible": true}
 {"name": "mypy-extensions", "license": "MIT", "compatible": true}
 {"name": "nemo-anonymizer", "license": "APACHE-2.0", "compatible": true}
-{"name": "nemo-fabric", "license": "APACHE-2.0", "compatible": true}
 {"name": "nemo-relay", "license": "APACHE-2.0", "compatible": true}
 {"name": "nemo-safe-synthesizer", "license": "APACHE-2.0", "compatible": true}
 {"name": "nemoguardrails", "license": "APACHE-2.0", "compatible": true}