NVIDIA · rapids-bot · Aug 18, 2026 · Aug 16, 2026 · Aug 16, 2026 · Aug 16, 2026
@@ -9,7 +9,7 @@ SPDX-License-Identifier: Apache-2.0
 [![GitHub](https://img.shields.io/badge/github-repo-blue?logo=github)](https://github.com/NVIDIA/NeMo-Fabric/)
 [![Release](https://img.shields.io/github/v/release/NVIDIA/NeMo-Fabric?color=green)](https://github.com/NVIDIA/NeMo-Fabric/releases)
 
-![Diagram showing NeMo Fabric connecting applications, evaluations, and reinforcement learning rollouts to Hermes, Codex, Claude, and Deep Agents, with results, artifacts, and telemetry as outputs.](https://raw.githubusercontent.com/NVIDIA/NeMo-Fabric/refs/heads/main/assets/fabric-hero-option2.png)
+![Diagram showing NeMo Fabric connecting applications, evaluation systems, and reinforcement learning rollouts to harnesses and custom agents, with results, artifacts, and telemetry as outputs.](https://raw.githubusercontent.com/NVIDIA/NeMo-Fabric/refs/heads/main/assets/fabric-hero.png)
 
 `nemo-fabric-adapter-contract` provides the typed Python configuration and
 execution contract implemented by NeMo Fabric adapters. It does not include a
@@ -30,9 +30,9 @@ Import `AgentConfig` from the contract models module:
 from nemo_fabric_adapter_contract.models import AgentConfig
 ```
 
-An adapter descriptor opts into the southbound configuration with
-`config.input=agent_config`. Python adapters using the optional common
-lifecycle host pass `AgentConfig.from_mapping` as the `config_loader`.
+NeMo Fabric delivers `AgentConfig` as the southbound configuration. Python
+adapters using the optional common lifecycle host pass
+`AgentConfig.from_mapping` as the `config_loader`.
 
 ## Install
 
@@ -48,6 +48,8 @@ Install the optional `pydantic` extra to enable Pydantic interoperability.
 pip install "nemo-fabric-adapter-contract[pydantic]"
 ```
 
-Refer to the [NeMo Fabric documentation](https://docs.nvidia.com/nemo/fabric)
-for adapter and configuration guidance. Source code is available in the
+Use the maintained
+[adapter contract documentation](https://github.com/NVIDIA/NeMo-Fabric/tree/main/docs/adapter-contract)
+and [canonical JSON Schemas](https://github.com/NVIDIA/NeMo-Fabric/tree/main/schemas/adapter-contract)
+as the implementation source of truth. Source code is available in the
 [NVIDIA NeMo Fabric repository](https://github.com/NVIDIA/NeMo-Fabric).
@@ -423,7 +423,7 @@ class AgentConfig(AgentContractBlock):
 
 @dataclass(slots=True, kw_only=True)
 class AgentRunRequest(AgentContractBlock):
-    """Preview southbound request for the future typed invoke transport."""
+    """Southbound invocation request passed to an adapter target."""
 
     input: JsonValue = _json_value_field()
     context: dict[str, JsonValue] = _json_dict()
@@ -506,7 +506,7 @@ def _validate(self) -> None:
 
 @dataclass(slots=True, kw_only=True)
 class AgentRunResult(AgentContractBlock):
-    """Preview southbound result for the future typed invoke transport."""
+    """Southbound terminal result returned by an adapter target."""
 
     status: AgentRunStatus
     output: JsonValue = _json_value_field()

@@ -51,16 +51,20 @@ import type {
 
 const descriptor: AdapterDescriptor = {
   contract_version: ADAPTER_CONTRACT_VERSION,
-  adapter_id: "pi",
-  harness: "pi",
-  adapter_kind: "process",
+  adapter_id: "com.acme.fabric.example",
+  adapter_kind: "http",
 };
 ```
 
 Property names intentionally match the JSON wire format and remain
 `snake_case`. Optional properties are distinct from properties whose value may
 be `null`.
 
+Use the maintained
+[adapter contract documentation](https://github.com/NVIDIA/NeMo-Fabric/tree/main/docs/adapter-contract)
+for the implementation sequence and the bundled schemas for runtime
+validation.
+
 ## Invocation Types
 
 The package root also exports the same request and result models as the Python

@@ -70,16 +70,6 @@
         }
       ]
     },
-    "AdapterConfigInput": {
-      "description": "Configuration object delivered to an adapter lifecycle host.",
-      "oneOf": [
-        {
-          "const": "agent_config",
-          "description": "Deliver the resolved southbound `AgentConfig` contract.",
-          "type": "string"
-        }
-      ]
-    },
     "AdapterConfigSupport": {
       "additionalProperties": true,
       "description": "Adapter config support.",
@@ -97,11 +87,6 @@
             "type": "string"
           },
           "type": "array"
-        },
-        "input": {
-          "$ref": "#/$defs/AdapterConfigInput",
-          "default": "agent_config",
-          "description": "Configuration object delivered to the adapter lifecycle host."
         }
       },
       "type": "object"
@@ -282,9 +267,7 @@
     },
     "config": {
       "$ref": "#/$defs/AdapterConfigSupport",
-      "default": {
-        "input": "agent_config"
-      },
+      "default": {},
       "description": "NeMo Fabric config areas this adapter consumes or generates."
     },
     "contract_version": {

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "additionalProperties": false,
-  "description": "Preview southbound invocation request.\n\nThe current local-host transport does not enforce this type. It will join\nthe negotiated adapter contract when typed invoke transport is implemented.",
+  "description": "Southbound invocation request passed to an adapter target.",
   "properties": {
     "context": {
       "additionalProperties": true,

@@ -207,7 +207,7 @@
       }
     }
   ],
-  "description": "Preview southbound terminal result.\n\nThe current local-host transport does not decode this type. It will join\nthe negotiated adapter contract when typed invoke transport is implemented.",
+  "description": "Southbound terminal result returned by an adapter target.",
   "properties": {
     "artifacts": {
       "description": "Artifacts produced by the adapter target.",

@@ -136,10 +136,6 @@ export type AdapterConfigSupport = {
    * Harness-native files generated by this adapter.
    */
   generates?: string[];
-  /**
-   * Configuration object delivered to the adapter lifecycle host.
-   */
-  input?: "agent_config";
 } & JsonObject;
 /**
  * Runtime requirements.

@@ -7,10 +7,7 @@
 import type { JsonObject, JsonValue } from "../json.js";
 
 /**
- * Preview southbound invocation request.
- *
- * The current local-host transport does not enforce this type. It will join
- * the negotiated adapter contract when typed invoke transport is implemented.
+ * Southbound invocation request passed to an adapter target.
  */
 export interface AgentRunRequest {
   /**

@@ -1,10 +1,7 @@
 // SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
 // SPDX-License-Identifier: Apache-2.0
 
-import type {
-  AdapterConfigSupport,
-  AdapterDescriptor,
-} from "./generated/adapter-descriptor.js";
+import type { AdapterDescriptor } from "./generated/adapter-descriptor.js";
 import type { AgentInstructionConfig } from "./generated/agent-config.js";
 import type { AgentRunResult } from "./generated/agent-run-result.js";
 import type { EnvironmentHandle } from "./generated/runtime-context.js";
@@ -29,9 +26,6 @@ export type AdapterContractVersion = typeof ADAPTER_CONTRACT_VERSION;
 /** Adapter implementation kind. */
 export type AdapterKind = AdapterDescriptor["adapter_kind"];
 
-/** Configuration object delivered to an adapter lifecycle host. */
-export type AdapterConfigInput = NonNullable<AdapterConfigSupport["input"]>;
-
 /** How an instruction value is applied to the selected harness. */
 export type InstructionMode = NonNullable<AgentInstructionConfig["mode"]>;
 

@@ -3,7 +3,6 @@
 
 import { ADAPTER_CONTRACT_VERSION } from "../src/index.js";
 import type {
-  AdapterConfigInput,
   AdapterContractVersion,
   AdapterDescriptor,
   AdapterKind,
@@ -98,7 +97,6 @@ const jsonValues: JsonValue[] = [
 ];
 
 const supportTypes: [
-  AdapterConfigInput,
   AdapterContractVersion,
   AdapterKind,
   ControlLocation,
@@ -107,7 +105,6 @@ const supportTypes: [
   TelemetryProvider,
   AdapterTelemetryProviderSupport,
 ] = [
-  "agent_config",
   ADAPTER_CONTRACT_VERSION,
   "process",
   "external_control",

@@ -3,12 +3,13 @@ SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All
 SPDX-License-Identifier: Apache-2.0
 -->
 
-# NVIDIA NeMo Fabric Agent Harness Adapters
+# NVIDIA NeMo Fabric Adapters
 
-NeMo Fabric adapters translate the normalized NeMo Fabric contract into
-harness-native models, tools, sessions, and telemetry. Use this reference to
-compare the bundled adapters and then open the linked package guide for
-installation, authentication, and configuration details.
+NeMo Fabric adapters translate the normalized NeMo Fabric contract into the
+native models, tools, sessions, and telemetry of an agent harness or custom
+agent. Use this reference to compare the bundled harness adapters, then refer
+to the custom-agent examples when building a shared framework adapter or a
+dedicated adapter.
 
 The adapter descriptor selected in `RunPlan` is authoritative for normalized
 configuration, its adapter-owned settings schema, and telemetry support.
@@ -40,6 +41,20 @@ schemas come from independently registered Adapter Target Descriptors.
 | [Hermes Agent](hermes/README.md) | `nvidia.fabric.hermes` | `nemo-fabric-adapters-hermes` | 3.11-3.13 |
 | [mini-SWE-agent](mini-swe-agent/README.md) | `nvidia.fabric.mini-swe-agent` | `nemo-fabric-adapters-mini-swe-agent` | 3.11+ |
 
+## Custom-Agent Adapter References
+
+Custom-agent support uses the same adapter contract as the bundled harnesses:
+
+- The [NeMo Agent Toolkit reference adapter](../external/nat/README.md) shows
+  one shared framework adapter with separately registered calculator and
+  email-phishing targets.
+- The [LangGraph custom-agent example](../examples/langgraph_custom_agent/README.md)
+  shows a dedicated adapter beside an application-owned graph.
+
+Start with the
+[adapter contract overview](../docs/adapter-contract/README.md) to choose an
+integration shape and implement the minimum lifecycle.
+
 ## Configuration Compatibility
 
 | Agent Harness | Models | Tool Policy | MCP | Skills | Subagents |

@@ -64,8 +64,20 @@
     "required": [],
     "additionalProperties": false
   },
+  "extension_schemas": {
+    "run_error": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "type": "object",
+      "properties": {
+        "subtype": {"type": "string"},
+        "api_error_status": {"type": "integer"},
+        "exit_code": {"type": "integer"},
+        "timeout_seconds": {"type": "number", "minimum": 0}
+      },
+      "additionalProperties": false
+    }
+  },
   "config": {
-    "input": "agent_config",
     "accepts": [
       "models",
       "models.base_url",

@@ -9,7 +9,7 @@ SPDX-License-Identifier: Apache-2.0
 [![GitHub](https://img.shields.io/badge/github-repo-blue?logo=github)](https://github.com/NVIDIA/NeMo-Fabric/)
 [![Release](https://img.shields.io/github/v/release/NVIDIA/NeMo-Fabric?color=green)](https://github.com/NVIDIA/NeMo-Fabric/releases)
 
-![Diagram showing NeMo Fabric connecting applications, evaluations, and reinforcement learning rollouts to Hermes, Codex, Claude, and Deep Agents, with results, artifacts, and telemetry as outputs.](https://raw.githubusercontent.com/NVIDIA/NeMo-Fabric/refs/heads/main/assets/fabric-hero-option2.png)
+![Diagram showing NeMo Fabric connecting applications, evaluation systems, and reinforcement learning rollouts to harnesses and custom agents, with results, artifacts, and telemetry as outputs.](https://raw.githubusercontent.com/NVIDIA/NeMo-Fabric/refs/heads/main/assets/fabric-hero.png)
 
 `nemo-fabric-adapters-claude` provides a NeMo Fabric adapter for [Claude Code](https://claude.com/product/claude-code).