nemo-fabric-adapter-contract 0.2.0 → 0.3.0-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -68,12 +68,11 @@ import type {
68
68
  } from "nemo-fabric-adapter-contract";
69
69
  ```
70
70
 
71
- These types remain documented as preview because the current local-host
72
- transport does not yet enforce them. Keep request and result translation at the
73
- adapter edge until the typed invocation boundary is negotiated. In particular,
74
- token counts originate from JSON Schema `uint64` values but are represented as
75
- JavaScript `number`; values greater than `Number.MAX_SAFE_INTEGER` cannot be
76
- represented exactly.
71
+ The local-host transport validates requests against the typed invocation
72
+ boundary and requires adapters to return a valid `AgentRunResult` before NeMo
73
+ Fabric normalizes the result. Token counts originate from JSON Schema `uint64`
74
+ values but are represented as JavaScript `number`; values greater than
75
+ `Number.MAX_SAFE_INTEGER` cannot be represented exactly.
77
76
 
78
77
  ## JSON Schemas
79
78
 
@@ -7,6 +7,10 @@ export type TelemetryProvider = "relay" | "native";
7
7
  * Adapter-translated normalized NVIDIA NeMo Fabric configuration fields.
8
8
  */
9
9
  export type AdapterConfigField = "models" | "models.base_url" | "models.temperature" | "instructions.system" | "runtime.max_turns" | "tools.enabled" | "tools.definitions" | "tools.blocked" | "mcp" | "mcp.auth.oauth2" | "mcp.auth.service_account" | "mcp.tool_filters" | "skills";
10
+ /**
11
+ * How an instruction value is applied to the selected harness.
12
+ */
13
+ export type InstructionMode = "replace" | "append";
10
14
  /**
11
15
  * Adapter target categories understood by this Adapter Contract version.
12
16
  */
@@ -93,6 +97,15 @@ export type AdapterConfigSupport = {
93
97
  * Harness-native files generated by this adapter.
94
98
  */
95
99
  generates?: string[];
100
+ /**
101
+ * Exact system-instruction modes supported by this adapter.
102
+ *
103
+ * An omitted value preserves compatibility with descriptors that predate
104
+ * mode discovery and means `replace` when `instructions.system` is accepted.
105
+ *
106
+ * @minItems 1
107
+ */
108
+ system_instruction_modes?: [InstructionMode, ...InstructionMode[]] | null;
96
109
  } & JsonObject;
97
110
  /**
98
111
  * Runtime requirements.
@@ -151,7 +151,7 @@ export interface AgentInstructionConfig {
151
151
  /**
152
152
  * How the instruction is applied.
153
153
  */
154
- mode?: "replace";
154
+ mode?: "replace" | "append";
155
155
  }
156
156
  /**
157
157
  * Named MCP servers routed to an adapter target.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "nemo-fabric-adapter-contract",
3
- "version": "0.2.0",
3
+ "version": "0.3.0-beta.2",
4
4
  "description": "Dependency-free TypeScript types for the NVIDIA NeMo Fabric adapter contract.",
5
5
  "license": "Apache-2.0",
6
6
  "type": "module",
@@ -87,6 +87,18 @@
87
87
  "type": "string"
88
88
  },
89
89
  "type": "array"
90
+ },
91
+ "system_instruction_modes": {
92
+ "description": "Exact system-instruction modes supported by this adapter.\n\nAn omitted value preserves compatibility with descriptors that predate\nmode discovery and means `replace` when `instructions.system` is accepted.",
93
+ "items": {
94
+ "$ref": "#/$defs/InstructionMode"
95
+ },
96
+ "minItems": 1,
97
+ "type": [
98
+ "array",
99
+ "null"
100
+ ],
101
+ "uniqueItems": true
90
102
  }
91
103
  },
92
104
  "type": "object"
@@ -209,6 +221,21 @@
209
221
  },
210
222
  "type": "object"
211
223
  },
224
+ "InstructionMode": {
225
+ "description": "How an instruction value is applied to the selected harness.",
226
+ "oneOf": [
227
+ {
228
+ "const": "replace",
229
+ "description": "Replace the harness default instruction value.",
230
+ "type": "string"
231
+ },
232
+ {
233
+ "const": "append",
234
+ "description": "Preserve the harness default and append this instruction after it.",
235
+ "type": "string"
236
+ }
237
+ ]
238
+ },
212
239
  "RuntimeCapabilities": {
213
240
  "description": "Lifecycle behavior implemented by a resolved runtime path.",
214
241
  "properties": {
@@ -386,6 +386,11 @@
386
386
  "const": "replace",
387
387
  "description": "Replace the harness default instruction value.",
388
388
  "type": "string"
389
+ },
390
+ {
391
+ "const": "append",
392
+ "description": "Preserve the harness default and append this instruction after it.",
393
+ "type": "string"
389
394
  }
390
395
  ]
391
396
  },