nemo-fabric-adapter-contract 0.6.1 → 0.7.0-rc.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/dist/generated/adapter-check-result.d.ts +1 -1
- package/dist/generated/adapter-descriptor.d.ts +153 -1
- package/dist/generated/agent-config.d.ts +57 -1
- package/dist/generated/agent-run-request.d.ts +4 -0
- package/dist/generated/agent-run-result.d.ts +4 -0
- package/dist/generated/runtime-context.d.ts +28 -1
- package/dist/index.d.ts +2 -0
- package/package.json +2 -2
- package/schemas/adapter-check-result.schema.json +10 -0
- package/schemas/adapter-descriptor.schema.json +432 -0
- package/schemas/agent-config.schema.json +207 -1
- package/schemas/agent-run-request.schema.json +4 -0
- package/schemas/agent-run-result.schema.json +7 -0
- package/schemas/runtime-context.schema.json +48 -1
|
@@ -53,4 +53,4 @@ export type AdapterCheckResult = {
|
|
|
53
53
|
/**
|
|
54
54
|
* Diagnostic codes for health observations.
|
|
55
55
|
*/
|
|
56
|
-
export type CheckReason = "server_stopping" | "capabilities_unverified" | "runtime_unavailable" | "service_unavailable" | "agent_exited" | "session_closed" | "endpoint_unavailable" | "health_failed" | "probe_timeout" | "probe_error" | "observation_changed" | "unsupported_adapter" | "unsupported_level" | "unsupported_scope";
|
|
56
|
+
export type CheckReason = "server_stopping" | "capabilities_unverified" | "runtime_busy" | "cleanup_unconfirmed" | "runtime_unavailable" | "service_unavailable" | "agent_exited" | "session_closed" | "endpoint_unavailable" | "health_failed" | "probe_timeout" | "probe_error" | "observation_changed" | "unsupported_adapter" | "unsupported_level" | "unsupported_scope";
|
|
@@ -6,11 +6,23 @@ export type TelemetryProvider = "relay" | "native";
|
|
|
6
6
|
/**
|
|
7
7
|
* Adapter-translated normalized NVIDIA NeMo Fabric configuration fields.
|
|
8
8
|
*/
|
|
9
|
-
export type AdapterConfigField = "models" | "models.base_url" | "models.temperature" | "models.top_p" | "models.max_tokens" | "instructions.system" | "runtime.max_turns" | "tools.enabled" | "tools.definitions" | "tools.blocked" | "mcp" | "mcp.auth.oauth2" | "mcp.auth.service_account" | "mcp.tool_filters" | "skills";
|
|
9
|
+
export type AdapterConfigField = "models" | "models.base_url" | "models.temperature" | "models.top_p" | "models.max_tokens" | "instructions.system" | "runtime.max_turns" | "runtime.keep_state" | "tools.enabled" | "tools.definitions" | "tools.blocked" | "mcp" | "mcp.auth.oauth2" | "mcp.auth.service_account" | "mcp.tool_filters" | "skills";
|
|
10
10
|
/**
|
|
11
11
|
* How an instruction value is applied to the selected harness.
|
|
12
12
|
*/
|
|
13
13
|
export type InstructionMode = "replace" | "append";
|
|
14
|
+
/**
|
|
15
|
+
* Kind of one structured external-skill entry.
|
|
16
|
+
*/
|
|
17
|
+
export type SkillDirectoryKind = "skill" | "folder";
|
|
18
|
+
/**
|
|
19
|
+
* Source of the name compared for duplicate detection.
|
|
20
|
+
*/
|
|
21
|
+
export type SkillNameSource = "frontmatter" | "directory";
|
|
22
|
+
/**
|
|
23
|
+
* How two `skills.directories` entries that provide the same skill name resolve.
|
|
24
|
+
*/
|
|
25
|
+
export type SkillDuplicatePolicy = "reject" | "last_wins" | "first_wins";
|
|
14
26
|
/**
|
|
15
27
|
* Adapter target categories understood by this Adapter Contract version.
|
|
16
28
|
*/
|
|
@@ -29,6 +41,10 @@ export type AdapterDescriptor = {
|
|
|
29
41
|
adapter_kind: "process" | "http" | "python" | "native_plugin";
|
|
30
42
|
capabilities?: RuntimeCapabilities;
|
|
31
43
|
config?: AdapterConfigSupport;
|
|
44
|
+
/**
|
|
45
|
+
* JSON Schema for static cross-field constraints on the serialized `FabricConfig`.
|
|
46
|
+
*/
|
|
47
|
+
config_schema?: JsonObject | null;
|
|
32
48
|
/**
|
|
33
49
|
* Adapter descriptor contract version.
|
|
34
50
|
*/
|
|
@@ -50,6 +66,11 @@ export type AdapterDescriptor = {
|
|
|
50
66
|
* JSON Schema for adapter-owned `harness.settings`.
|
|
51
67
|
*/
|
|
52
68
|
settings_schema?: JsonObject | null;
|
|
69
|
+
/**
|
|
70
|
+
* Structured skill capabilities. `None` means only `skills.paths` (when
|
|
71
|
+
* `config.accepts` includes `skills`).
|
|
72
|
+
*/
|
|
73
|
+
skills?: AdapterSkillsSupport | null;
|
|
53
74
|
/**
|
|
54
75
|
* Registered target categories this adapter can execute.
|
|
55
76
|
*/
|
|
@@ -76,6 +97,10 @@ export type RuntimeCapabilities = {
|
|
|
76
97
|
* Whether the selected runtime supports service lifecycle operations.
|
|
77
98
|
*/
|
|
78
99
|
service?: boolean;
|
|
100
|
+
/**
|
|
101
|
+
* Whether the adapter implements durable native session creation and resume.
|
|
102
|
+
*/
|
|
103
|
+
session_resume?: boolean;
|
|
79
104
|
/**
|
|
80
105
|
* Whether invocations can emit progressive output.
|
|
81
106
|
*/
|
|
@@ -132,6 +157,133 @@ export type AdapterRequirements = {
|
|
|
132
157
|
*/
|
|
133
158
|
services?: string[];
|
|
134
159
|
} & JsonObject;
|
|
160
|
+
/**
|
|
161
|
+
* Structured skill capabilities implemented by an adapter.
|
|
162
|
+
*
|
|
163
|
+
* Each sub-block is optional; an omitted block means the adapter does not
|
|
164
|
+
* implement that capability; `null` reads as omitted. A non-null `duplicates`
|
|
165
|
+
* requires a non-null `directory_loading`. The adapter must also accept the
|
|
166
|
+
* `skills` config field in `config.accepts`.
|
|
167
|
+
*/
|
|
168
|
+
export type AdapterSkillsSupport = {
|
|
169
|
+
/**
|
|
170
|
+
* Bundled-skill selection through `skills.bundled`.
|
|
171
|
+
*/
|
|
172
|
+
bundled?: BundledSkillsSupport | null;
|
|
173
|
+
/**
|
|
174
|
+
* Structured `skills.directories` loading.
|
|
175
|
+
*/
|
|
176
|
+
directory_loading?: SkillDirectoryLoadingSupport | null;
|
|
177
|
+
/**
|
|
178
|
+
* Duplicate-name policies for `skills.duplicates`.
|
|
179
|
+
*/
|
|
180
|
+
duplicates?: SkillDuplicatesSupport | null;
|
|
181
|
+
} & JsonObject;
|
|
182
|
+
/**
|
|
183
|
+
* Bundled-skill operations implemented by an adapter. Every field is required.
|
|
184
|
+
*/
|
|
185
|
+
export type BundledSkillsSupport = {
|
|
186
|
+
/**
|
|
187
|
+
* What loads when `skills.bundled` is omitted.
|
|
188
|
+
*/
|
|
189
|
+
default: "enabled" | "disabled" | "none";
|
|
190
|
+
/**
|
|
191
|
+
* Whether `enabled: false` is implemented.
|
|
192
|
+
*/
|
|
193
|
+
supports_disable: boolean;
|
|
194
|
+
/**
|
|
195
|
+
* Whether `BundledSkills()` (enabled, no lists) is implemented.
|
|
196
|
+
*/
|
|
197
|
+
supports_enable: boolean;
|
|
198
|
+
/**
|
|
199
|
+
* Whether `exclude` (including `[]`) is implemented.
|
|
200
|
+
*/
|
|
201
|
+
supports_exclude: boolean;
|
|
202
|
+
/**
|
|
203
|
+
* Whether `include` (including `[]`) is implemented.
|
|
204
|
+
*/
|
|
205
|
+
supports_include: boolean;
|
|
206
|
+
} & JsonObject;
|
|
207
|
+
/**
|
|
208
|
+
* How an adapter loads `skills.directories` entries. Every field is required.
|
|
209
|
+
*/
|
|
210
|
+
export type SkillDirectoryLoadingSupport = {
|
|
211
|
+
discovery: SkillDiscoverySupport;
|
|
212
|
+
parsing: SkillParsingSupport;
|
|
213
|
+
/**
|
|
214
|
+
* File that marks a skill folder. Must be `SKILL.md`.
|
|
215
|
+
*/
|
|
216
|
+
skill_file: "SKILL.md";
|
|
217
|
+
/**
|
|
218
|
+
* Entry kinds the adapter implements. Non-empty and unique.
|
|
219
|
+
*
|
|
220
|
+
* @minItems 1
|
|
221
|
+
*/
|
|
222
|
+
supported_entries: [SkillDirectoryKind, ...SkillDirectoryKind[]];
|
|
223
|
+
} & JsonObject;
|
|
224
|
+
/**
|
|
225
|
+
* How the adapter discovers skills inside a `folder` entry.
|
|
226
|
+
*/
|
|
227
|
+
export type SkillDiscoverySupport = {
|
|
228
|
+
/**
|
|
229
|
+
* Depth bound for discovery. Required: there is no implicit unlimited default.
|
|
230
|
+
*/
|
|
231
|
+
depth_limit: {
|
|
232
|
+
kind: "fixed";
|
|
233
|
+
/**
|
|
234
|
+
* Maximum discovery depth, at least one.
|
|
235
|
+
*/
|
|
236
|
+
levels: number;
|
|
237
|
+
} | {
|
|
238
|
+
kind: "no_fixed_limit";
|
|
239
|
+
} | {
|
|
240
|
+
kind: "adapter_defined";
|
|
241
|
+
};
|
|
242
|
+
/**
|
|
243
|
+
* Whether discovery continues below a discovered skill folder.
|
|
244
|
+
*/
|
|
245
|
+
nested_skills: "include" | "stop_at_skill";
|
|
246
|
+
/**
|
|
247
|
+
* Whether only immediate children or the whole tree is searched.
|
|
248
|
+
*/
|
|
249
|
+
traversal: "immediate_children" | "recursive";
|
|
250
|
+
} & JsonObject;
|
|
251
|
+
/**
|
|
252
|
+
* How the adapter parses each candidate's `SKILL.md`.
|
|
253
|
+
*/
|
|
254
|
+
export type SkillParsingSupport = {
|
|
255
|
+
/**
|
|
256
|
+
* How front-matter parse errors are handled.
|
|
257
|
+
*/
|
|
258
|
+
frontmatter_errors: "recover_key_value" | "reject" | "adapter_defined";
|
|
259
|
+
/**
|
|
260
|
+
* Whether a missing name falls back to the skill folder name.
|
|
261
|
+
*/
|
|
262
|
+
name_fallback: "directory_name" | "none";
|
|
263
|
+
/**
|
|
264
|
+
* Front-matter fields the loading path requires. May be empty; unique.
|
|
265
|
+
*/
|
|
266
|
+
required_frontmatter_fields: string[];
|
|
267
|
+
} & JsonObject;
|
|
268
|
+
/**
|
|
269
|
+
* Duplicate-name policies implemented by an adapter.
|
|
270
|
+
*/
|
|
271
|
+
export type SkillDuplicatesSupport = {
|
|
272
|
+
/**
|
|
273
|
+
* Whether skill names are compared by front matter or by folder name.
|
|
274
|
+
*/
|
|
275
|
+
name_source?: SkillNameSource | null;
|
|
276
|
+
/**
|
|
277
|
+
* Short description of the harness's own handling when `duplicates` is omitted.
|
|
278
|
+
*/
|
|
279
|
+
native?: string | null;
|
|
280
|
+
/**
|
|
281
|
+
* Policies accepted in `skills.duplicates`. Non-empty and unique.
|
|
282
|
+
*
|
|
283
|
+
* @minItems 1
|
|
284
|
+
*/
|
|
285
|
+
supported_policies: [SkillDuplicatePolicy, ...SkillDuplicatePolicy[]];
|
|
286
|
+
} & JsonObject;
|
|
135
287
|
/**
|
|
136
288
|
* Telemetry support declared by this adapter.
|
|
137
289
|
*/
|
|
@@ -67,6 +67,22 @@ export type McpAuthenticationConfig = {
|
|
|
67
67
|
* OAuth client authentication method used at the token endpoint.
|
|
68
68
|
*/
|
|
69
69
|
export type OAuthTokenEndpointAuthMethod = "none" | "client_secret_post" | "client_secret_basic";
|
|
70
|
+
/**
|
|
71
|
+
* One structured external-skill entry: exactly one of `{"skill": path}` or
|
|
72
|
+
* `{"folder": path}`. The other key may be present only as `null`, which
|
|
73
|
+
* reads as absent.
|
|
74
|
+
*/
|
|
75
|
+
export type SkillDirectory = {
|
|
76
|
+
folder?: null;
|
|
77
|
+
skill: string;
|
|
78
|
+
} | {
|
|
79
|
+
folder: string;
|
|
80
|
+
skill?: null;
|
|
81
|
+
};
|
|
82
|
+
/**
|
|
83
|
+
* How two `skills.directories` entries that provide the same skill name resolve.
|
|
84
|
+
*/
|
|
85
|
+
export type SkillDuplicatePolicy = "reject" | "last_wins" | "first_wins";
|
|
70
86
|
/**
|
|
71
87
|
* Configuration projected southbound to one adapter target.
|
|
72
88
|
*/
|
|
@@ -268,9 +284,28 @@ export interface AgentRuntimeConfig {
|
|
|
268
284
|
max_turns?: number | null;
|
|
269
285
|
}
|
|
270
286
|
/**
|
|
271
|
-
*
|
|
287
|
+
* Skills made available to an adapter target.
|
|
288
|
+
*
|
|
289
|
+
* A non-null `directories` requires an empty `paths`, and a non-null
|
|
290
|
+
* `duplicates` requires a non-null `directories`; `null` reads as omitted.
|
|
272
291
|
*/
|
|
273
292
|
export interface AgentSkillConfig {
|
|
293
|
+
/**
|
|
294
|
+
* Bundled-skill selection. Sent only to adapters that declare the
|
|
295
|
+
* requested `skills.bundled` operation.
|
|
296
|
+
*/
|
|
297
|
+
bundled?: BundledSkills | null;
|
|
298
|
+
/**
|
|
299
|
+
* Structured skill entries with paths resolved by NeMo Fabric. Sent only
|
|
300
|
+
* to adapters that declare `skills.directory_loading`; an empty list
|
|
301
|
+
* loads no external skills.
|
|
302
|
+
*/
|
|
303
|
+
directories?: SkillDirectory[] | null;
|
|
304
|
+
/**
|
|
305
|
+
* Duplicate-name policy between `directories` entries. Sent only to
|
|
306
|
+
* adapters that declare the policy in `skills.duplicates`.
|
|
307
|
+
*/
|
|
308
|
+
duplicates?: SkillDuplicatePolicy | null;
|
|
274
309
|
/**
|
|
275
310
|
* Adapter-owned skill fields.
|
|
276
311
|
*/
|
|
@@ -280,6 +315,27 @@ export interface AgentSkillConfig {
|
|
|
280
315
|
*/
|
|
281
316
|
paths?: string[];
|
|
282
317
|
}
|
|
318
|
+
/**
|
|
319
|
+
* Bundled-skill selection.
|
|
320
|
+
*
|
|
321
|
+
* `include` and `exclude` are mutually exclusive, and neither may be combined
|
|
322
|
+
* with `enabled: false`; a `null` list reads as omitted. An empty `include`
|
|
323
|
+
* selects no bundled skills; an empty `exclude` selects all of them.
|
|
324
|
+
*/
|
|
325
|
+
export interface BundledSkills {
|
|
326
|
+
/**
|
|
327
|
+
* Whether bundled skills load at all.
|
|
328
|
+
*/
|
|
329
|
+
enabled?: boolean;
|
|
330
|
+
/**
|
|
331
|
+
* Load every bundled skill except these. `None` and `[]` differ.
|
|
332
|
+
*/
|
|
333
|
+
exclude?: string[] | null;
|
|
334
|
+
/**
|
|
335
|
+
* Load only these bundled skills. `None` and `[]` differ.
|
|
336
|
+
*/
|
|
337
|
+
include?: string[] | null;
|
|
338
|
+
}
|
|
283
339
|
/**
|
|
284
340
|
* Named tool definitions and effective adapter-target tool policy.
|
|
285
341
|
*/
|
|
@@ -3,6 +3,10 @@ import type { JsonObject, JsonValue } from "../json.js";
|
|
|
3
3
|
* Southbound invocation request passed to an adapter target.
|
|
4
4
|
*/
|
|
5
5
|
export interface AgentRunRequest {
|
|
6
|
+
/**
|
|
7
|
+
* Acknowledge uncertain earlier completion before starting this new request.
|
|
8
|
+
*/
|
|
9
|
+
acknowledge_recovery?: boolean;
|
|
6
10
|
/**
|
|
7
11
|
* Caller-provided task, rollout, workflow, or application context.
|
|
8
12
|
*/
|
|
@@ -32,6 +32,10 @@ export interface AgentRunResultCommon {
|
|
|
32
32
|
* Primary adapter-target output.
|
|
33
33
|
*/
|
|
34
34
|
output: JsonValue;
|
|
35
|
+
/**
|
|
36
|
+
* Confirmed adapter-issued identity of the durable native session.
|
|
37
|
+
*/
|
|
38
|
+
session_id?: string | null;
|
|
35
39
|
/**
|
|
36
40
|
* Normalized model usage when reported by the adapter target.
|
|
37
41
|
*/
|
|
@@ -6,7 +6,7 @@ export interface RuntimeContext {
|
|
|
6
6
|
artifacts: ArtifactManifest;
|
|
7
7
|
/**
|
|
8
8
|
* Unix time in milliseconds by which the adapter should return its result.
|
|
9
|
-
* Present
|
|
9
|
+
* Present when runtime.timeout_seconds is set, shortly before Fabric's invocation timeout.
|
|
10
10
|
*/
|
|
11
11
|
deadline_millis?: number | null;
|
|
12
12
|
environment: EnvironmentHandle;
|
|
@@ -22,6 +22,16 @@ export interface RuntimeContext {
|
|
|
22
22
|
* Runtime handle id.
|
|
23
23
|
*/
|
|
24
24
|
runtime_id: string;
|
|
25
|
+
/**
|
|
26
|
+
* Explicit durable session selection, supplied only to opted-in adapters.
|
|
27
|
+
*/
|
|
28
|
+
session_ref?: SessionRef | null;
|
|
29
|
+
/**
|
|
30
|
+
* Absolute folder for the adapter's native state, present when
|
|
31
|
+
* `runtime.keep_state` is set. Every runtime of the agent gets the same
|
|
32
|
+
* folder, and Fabric lets only one running runtime use it at a time.
|
|
33
|
+
*/
|
|
34
|
+
state_dir?: string | null;
|
|
25
35
|
/**
|
|
26
36
|
* Runtime telemetry context generated for this invocation.
|
|
27
37
|
*/
|
|
@@ -110,6 +120,23 @@ export interface EnvironmentHandle {
|
|
|
110
120
|
*/
|
|
111
121
|
workspace?: string | null;
|
|
112
122
|
}
|
|
123
|
+
/**
|
|
124
|
+
* Adapter-issued native identity, resolved only within caller-supplied storage.
|
|
125
|
+
*/
|
|
126
|
+
export interface SessionRef {
|
|
127
|
+
/**
|
|
128
|
+
* Adapter responsible for interpreting the opaque identifier.
|
|
129
|
+
*/
|
|
130
|
+
adapter_id: string;
|
|
131
|
+
/**
|
|
132
|
+
* Supported envelope version.
|
|
133
|
+
*/
|
|
134
|
+
schema_version: "fabric.session_ref/v1alpha1";
|
|
135
|
+
/**
|
|
136
|
+
* Opaque adapter-issued identifier interpreted by the adapter.
|
|
137
|
+
*/
|
|
138
|
+
session_id: string;
|
|
139
|
+
}
|
|
113
140
|
/**
|
|
114
141
|
* Runtime telemetry config passed to adapters.
|
|
115
142
|
*/
|
package/dist/index.d.ts
CHANGED
|
@@ -18,6 +18,8 @@ export type AdapterContractVersion = typeof ADAPTER_CONTRACT_VERSION;
|
|
|
18
18
|
export type AdapterKind = AdapterDescriptor["adapter_kind"];
|
|
19
19
|
/** How an instruction value is applied to the selected harness. */
|
|
20
20
|
export type InstructionMode = NonNullable<AgentInstructionConfig["mode"]>;
|
|
21
|
+
/** How two `skills.directories` entries that provide the same skill name resolve. */
|
|
22
|
+
export type { SkillDuplicatePolicy } from "./generated/agent-config.js";
|
|
21
23
|
/** Where NeMo Fabric control code runs relative to the environment. */
|
|
22
24
|
export type ControlLocation = EnvironmentHandle["control_location"];
|
|
23
25
|
/** Whether NeMo Fabric owns the underlying environment resource. */
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "nemo-fabric-adapter-contract",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.7.0-rc.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",
|
|
@@ -26,7 +26,7 @@
|
|
|
26
26
|
"build": "node scripts/clean.mjs && tsc -p tsconfig.build.json",
|
|
27
27
|
"test:generator": "node --test test/*.test.mjs",
|
|
28
28
|
"test:types": "tsc -p test/tsconfig.json --noEmit",
|
|
29
|
-
"test:dependencies": "node scripts/check-dependencies.mjs && npm ls --all &&
|
|
29
|
+
"test:dependencies": "node scripts/check-dependencies.mjs && npm ls --all && node scripts/audit-dependencies.mjs",
|
|
30
30
|
"pack:check": "npm run build && node scripts/check-package.mjs",
|
|
31
31
|
"test": "npm run generate:check && npm run test:generator && npm run test:types && npm run test:dependencies && npm run pack:check",
|
|
32
32
|
"prepack": "npm run generate:check && npm run build"
|
|
@@ -38,6 +38,16 @@
|
|
|
38
38
|
"description": "Advertised capability evidence is unavailable.",
|
|
39
39
|
"type": "string"
|
|
40
40
|
},
|
|
41
|
+
{
|
|
42
|
+
"const": "runtime_busy",
|
|
43
|
+
"description": "Runtime cleanup is in progress.",
|
|
44
|
+
"type": "string"
|
|
45
|
+
},
|
|
46
|
+
{
|
|
47
|
+
"const": "cleanup_unconfirmed",
|
|
48
|
+
"description": "Owned runtime cleanup could not be confirmed.",
|
|
49
|
+
"type": "string"
|
|
50
|
+
},
|
|
41
51
|
{
|
|
42
52
|
"const": "runtime_unavailable",
|
|
43
53
|
"description": "No matching runtime binding exists.",
|
|
@@ -38,6 +38,11 @@
|
|
|
38
38
|
"description": "Per-invocation harness turn limit.",
|
|
39
39
|
"type": "string"
|
|
40
40
|
},
|
|
41
|
+
{
|
|
42
|
+
"const": "runtime.keep_state",
|
|
43
|
+
"description": "Agent-named state folder kept across runtimes.",
|
|
44
|
+
"type": "string"
|
|
45
|
+
},
|
|
41
46
|
{
|
|
42
47
|
"const": "tools.enabled",
|
|
43
48
|
"description": "Adapter-native tool names to expose.",
|
|
@@ -180,6 +185,59 @@
|
|
|
180
185
|
},
|
|
181
186
|
"type": "object"
|
|
182
187
|
},
|
|
188
|
+
"AdapterSkillsSupport": {
|
|
189
|
+
"additionalProperties": true,
|
|
190
|
+
"description": "Structured skill capabilities implemented by an adapter.\n\nEach sub-block is optional; an omitted block means the adapter does not\nimplement that capability; `null` reads as omitted. A non-null `duplicates`\nrequires a non-null `directory_loading`. The adapter must also accept the\n`skills` config field in `config.accepts`.",
|
|
191
|
+
"not": {
|
|
192
|
+
"properties": {
|
|
193
|
+
"directory_loading": {
|
|
194
|
+
"type": "null"
|
|
195
|
+
},
|
|
196
|
+
"duplicates": {
|
|
197
|
+
"type": "object"
|
|
198
|
+
}
|
|
199
|
+
},
|
|
200
|
+
"required": [
|
|
201
|
+
"duplicates"
|
|
202
|
+
]
|
|
203
|
+
},
|
|
204
|
+
"properties": {
|
|
205
|
+
"bundled": {
|
|
206
|
+
"anyOf": [
|
|
207
|
+
{
|
|
208
|
+
"$ref": "#/$defs/BundledSkillsSupport"
|
|
209
|
+
},
|
|
210
|
+
{
|
|
211
|
+
"type": "null"
|
|
212
|
+
}
|
|
213
|
+
],
|
|
214
|
+
"description": "Bundled-skill selection through `skills.bundled`."
|
|
215
|
+
},
|
|
216
|
+
"directory_loading": {
|
|
217
|
+
"anyOf": [
|
|
218
|
+
{
|
|
219
|
+
"$ref": "#/$defs/SkillDirectoryLoadingSupport"
|
|
220
|
+
},
|
|
221
|
+
{
|
|
222
|
+
"type": "null"
|
|
223
|
+
}
|
|
224
|
+
],
|
|
225
|
+
"description": "Structured `skills.directories` loading."
|
|
226
|
+
},
|
|
227
|
+
"duplicates": {
|
|
228
|
+
"anyOf": [
|
|
229
|
+
{
|
|
230
|
+
"$ref": "#/$defs/SkillDuplicatesSupport"
|
|
231
|
+
},
|
|
232
|
+
{
|
|
233
|
+
"type": "null"
|
|
234
|
+
}
|
|
235
|
+
],
|
|
236
|
+
"description": "Duplicate-name policies for `skills.duplicates`."
|
|
237
|
+
}
|
|
238
|
+
},
|
|
239
|
+
"type": "object"
|
|
240
|
+
},
|
|
183
241
|
"AdapterTargetType": {
|
|
184
242
|
"description": "Adapter target categories understood by this Adapter Contract version.",
|
|
185
243
|
"oneOf": [
|
|
@@ -231,6 +289,60 @@
|
|
|
231
289
|
},
|
|
232
290
|
"type": "object"
|
|
233
291
|
},
|
|
292
|
+
"BundledSkillsDefault": {
|
|
293
|
+
"description": "What loads when `skills.bundled` is omitted.",
|
|
294
|
+
"oneOf": [
|
|
295
|
+
{
|
|
296
|
+
"const": "enabled",
|
|
297
|
+
"description": "Bundled skills load by default.",
|
|
298
|
+
"type": "string"
|
|
299
|
+
},
|
|
300
|
+
{
|
|
301
|
+
"const": "disabled",
|
|
302
|
+
"description": "Bundled skills do not load by default.",
|
|
303
|
+
"type": "string"
|
|
304
|
+
},
|
|
305
|
+
{
|
|
306
|
+
"const": "none",
|
|
307
|
+
"description": "The harness ships no bundled skills.",
|
|
308
|
+
"type": "string"
|
|
309
|
+
}
|
|
310
|
+
]
|
|
311
|
+
},
|
|
312
|
+
"BundledSkillsSupport": {
|
|
313
|
+
"additionalProperties": true,
|
|
314
|
+
"description": "Bundled-skill operations implemented by an adapter. Every field is required.",
|
|
315
|
+
"properties": {
|
|
316
|
+
"default": {
|
|
317
|
+
"$ref": "#/$defs/BundledSkillsDefault",
|
|
318
|
+
"description": "What loads when `skills.bundled` is omitted."
|
|
319
|
+
},
|
|
320
|
+
"supports_disable": {
|
|
321
|
+
"description": "Whether `enabled: false` is implemented.",
|
|
322
|
+
"type": "boolean"
|
|
323
|
+
},
|
|
324
|
+
"supports_enable": {
|
|
325
|
+
"description": "Whether `BundledSkills()` (enabled, no lists) is implemented.",
|
|
326
|
+
"type": "boolean"
|
|
327
|
+
},
|
|
328
|
+
"supports_exclude": {
|
|
329
|
+
"description": "Whether `exclude` (including `[]`) is implemented.",
|
|
330
|
+
"type": "boolean"
|
|
331
|
+
},
|
|
332
|
+
"supports_include": {
|
|
333
|
+
"description": "Whether `include` (including `[]`) is implemented.",
|
|
334
|
+
"type": "boolean"
|
|
335
|
+
}
|
|
336
|
+
},
|
|
337
|
+
"required": [
|
|
338
|
+
"default",
|
|
339
|
+
"supports_enable",
|
|
340
|
+
"supports_disable",
|
|
341
|
+
"supports_include",
|
|
342
|
+
"supports_exclude"
|
|
343
|
+
],
|
|
344
|
+
"type": "object"
|
|
345
|
+
},
|
|
234
346
|
"InstructionMode": {
|
|
235
347
|
"description": "How an instruction value is applied to the selected harness.",
|
|
236
348
|
"oneOf": [
|
|
@@ -246,6 +358,21 @@
|
|
|
246
358
|
}
|
|
247
359
|
]
|
|
248
360
|
},
|
|
361
|
+
"NestedSkills": {
|
|
362
|
+
"description": "Discovery behavior below a discovered skill folder.",
|
|
363
|
+
"oneOf": [
|
|
364
|
+
{
|
|
365
|
+
"const": "include",
|
|
366
|
+
"description": "Further skills below a discovered skill folder are discovered too.",
|
|
367
|
+
"type": "string"
|
|
368
|
+
},
|
|
369
|
+
{
|
|
370
|
+
"const": "stop_at_skill",
|
|
371
|
+
"description": "Discovery stops at a skill folder.",
|
|
372
|
+
"type": "string"
|
|
373
|
+
}
|
|
374
|
+
]
|
|
375
|
+
},
|
|
249
376
|
"RuntimeCapabilities": {
|
|
250
377
|
"description": "Lifecycle behavior implemented by a resolved runtime path.",
|
|
251
378
|
"properties": {
|
|
@@ -264,6 +391,10 @@
|
|
|
264
391
|
"description": "Whether the selected runtime supports service lifecycle operations.",
|
|
265
392
|
"type": "boolean"
|
|
266
393
|
},
|
|
394
|
+
"session_resume": {
|
|
395
|
+
"description": "Whether the adapter implements durable native session creation and resume.",
|
|
396
|
+
"type": "boolean"
|
|
397
|
+
},
|
|
267
398
|
"streaming": {
|
|
268
399
|
"default": false,
|
|
269
400
|
"description": "Whether invocations can emit progressive output.",
|
|
@@ -276,6 +407,288 @@
|
|
|
276
407
|
}
|
|
277
408
|
},
|
|
278
409
|
"type": "object"
|
|
410
|
+
},
|
|
411
|
+
"SkillDepthLimit": {
|
|
412
|
+
"description": "Depth bound for skill discovery. The supplied folder is depth zero.",
|
|
413
|
+
"oneOf": [
|
|
414
|
+
{
|
|
415
|
+
"additionalProperties": false,
|
|
416
|
+
"description": "One numeric bound; immediate children are depth one.",
|
|
417
|
+
"properties": {
|
|
418
|
+
"kind": {
|
|
419
|
+
"const": "fixed",
|
|
420
|
+
"type": "string"
|
|
421
|
+
},
|
|
422
|
+
"levels": {
|
|
423
|
+
"description": "Maximum discovery depth, at least one.",
|
|
424
|
+
"format": "uint32",
|
|
425
|
+
"minimum": 1,
|
|
426
|
+
"type": "integer"
|
|
427
|
+
}
|
|
428
|
+
},
|
|
429
|
+
"required": [
|
|
430
|
+
"kind",
|
|
431
|
+
"levels"
|
|
432
|
+
],
|
|
433
|
+
"type": "object"
|
|
434
|
+
},
|
|
435
|
+
{
|
|
436
|
+
"additionalProperties": false,
|
|
437
|
+
"description": "No explicit depth cap; exclusions and other constraints still apply.",
|
|
438
|
+
"properties": {
|
|
439
|
+
"kind": {
|
|
440
|
+
"const": "no_fixed_limit",
|
|
441
|
+
"type": "string"
|
|
442
|
+
}
|
|
443
|
+
},
|
|
444
|
+
"required": [
|
|
445
|
+
"kind"
|
|
446
|
+
],
|
|
447
|
+
"type": "object"
|
|
448
|
+
},
|
|
449
|
+
{
|
|
450
|
+
"additionalProperties": false,
|
|
451
|
+
"description": "Context-dependent bounds documented and implemented by the adapter.",
|
|
452
|
+
"properties": {
|
|
453
|
+
"kind": {
|
|
454
|
+
"const": "adapter_defined",
|
|
455
|
+
"type": "string"
|
|
456
|
+
}
|
|
457
|
+
},
|
|
458
|
+
"required": [
|
|
459
|
+
"kind"
|
|
460
|
+
],
|
|
461
|
+
"type": "object"
|
|
462
|
+
}
|
|
463
|
+
]
|
|
464
|
+
},
|
|
465
|
+
"SkillDirectoryKind": {
|
|
466
|
+
"description": "Kind of one structured external-skill entry.",
|
|
467
|
+
"oneOf": [
|
|
468
|
+
{
|
|
469
|
+
"const": "skill",
|
|
470
|
+
"description": "One skill's folder, which contains `SKILL.md`.",
|
|
471
|
+
"type": "string"
|
|
472
|
+
},
|
|
473
|
+
{
|
|
474
|
+
"const": "folder",
|
|
475
|
+
"description": "A folder whose skills the adapter discovers.",
|
|
476
|
+
"type": "string"
|
|
477
|
+
}
|
|
478
|
+
]
|
|
479
|
+
},
|
|
480
|
+
"SkillDirectoryLoadingSupport": {
|
|
481
|
+
"additionalProperties": true,
|
|
482
|
+
"description": "How an adapter loads `skills.directories` entries. Every field is required.",
|
|
483
|
+
"properties": {
|
|
484
|
+
"discovery": {
|
|
485
|
+
"$ref": "#/$defs/SkillDiscoverySupport",
|
|
486
|
+
"description": "How the adapter discovers skills inside a `folder` entry."
|
|
487
|
+
},
|
|
488
|
+
"parsing": {
|
|
489
|
+
"$ref": "#/$defs/SkillParsingSupport",
|
|
490
|
+
"description": "How the adapter parses each candidate's `SKILL.md`."
|
|
491
|
+
},
|
|
492
|
+
"skill_file": {
|
|
493
|
+
"const": "SKILL.md",
|
|
494
|
+
"description": "File that marks a skill folder. Must be `SKILL.md`.",
|
|
495
|
+
"type": "string"
|
|
496
|
+
},
|
|
497
|
+
"supported_entries": {
|
|
498
|
+
"description": "Entry kinds the adapter implements. Non-empty and unique.",
|
|
499
|
+
"items": {
|
|
500
|
+
"$ref": "#/$defs/SkillDirectoryKind"
|
|
501
|
+
},
|
|
502
|
+
"minItems": 1,
|
|
503
|
+
"type": "array",
|
|
504
|
+
"uniqueItems": true
|
|
505
|
+
}
|
|
506
|
+
},
|
|
507
|
+
"required": [
|
|
508
|
+
"supported_entries",
|
|
509
|
+
"skill_file",
|
|
510
|
+
"discovery",
|
|
511
|
+
"parsing"
|
|
512
|
+
],
|
|
513
|
+
"type": "object"
|
|
514
|
+
},
|
|
515
|
+
"SkillDiscoverySupport": {
|
|
516
|
+
"additionalProperties": true,
|
|
517
|
+
"description": "How an adapter traverses a `folder` entry.",
|
|
518
|
+
"properties": {
|
|
519
|
+
"depth_limit": {
|
|
520
|
+
"$ref": "#/$defs/SkillDepthLimit",
|
|
521
|
+
"description": "Depth bound for discovery. Required: there is no implicit unlimited default."
|
|
522
|
+
},
|
|
523
|
+
"nested_skills": {
|
|
524
|
+
"$ref": "#/$defs/NestedSkills",
|
|
525
|
+
"description": "Whether discovery continues below a discovered skill folder."
|
|
526
|
+
},
|
|
527
|
+
"traversal": {
|
|
528
|
+
"$ref": "#/$defs/SkillTraversal",
|
|
529
|
+
"description": "Whether only immediate children or the whole tree is searched."
|
|
530
|
+
}
|
|
531
|
+
},
|
|
532
|
+
"required": [
|
|
533
|
+
"traversal",
|
|
534
|
+
"nested_skills",
|
|
535
|
+
"depth_limit"
|
|
536
|
+
],
|
|
537
|
+
"type": "object"
|
|
538
|
+
},
|
|
539
|
+
"SkillDuplicatePolicy": {
|
|
540
|
+
"description": "How two `skills.directories` entries that provide the same skill name resolve.",
|
|
541
|
+
"oneOf": [
|
|
542
|
+
{
|
|
543
|
+
"const": "reject",
|
|
544
|
+
"description": "Start fails, naming both entries.",
|
|
545
|
+
"type": "string"
|
|
546
|
+
},
|
|
547
|
+
{
|
|
548
|
+
"const": "last_wins",
|
|
549
|
+
"description": "The later entry's skill loads.",
|
|
550
|
+
"type": "string"
|
|
551
|
+
},
|
|
552
|
+
{
|
|
553
|
+
"const": "first_wins",
|
|
554
|
+
"description": "The earlier entry's skill loads.",
|
|
555
|
+
"type": "string"
|
|
556
|
+
}
|
|
557
|
+
]
|
|
558
|
+
},
|
|
559
|
+
"SkillDuplicatesSupport": {
|
|
560
|
+
"additionalProperties": true,
|
|
561
|
+
"description": "Duplicate-name policies implemented by an adapter.",
|
|
562
|
+
"properties": {
|
|
563
|
+
"name_source": {
|
|
564
|
+
"anyOf": [
|
|
565
|
+
{
|
|
566
|
+
"$ref": "#/$defs/SkillNameSource"
|
|
567
|
+
},
|
|
568
|
+
{
|
|
569
|
+
"type": "null"
|
|
570
|
+
}
|
|
571
|
+
],
|
|
572
|
+
"description": "Whether skill names are compared by front matter or by folder name."
|
|
573
|
+
},
|
|
574
|
+
"native": {
|
|
575
|
+
"description": "Short description of the harness's own handling when `duplicates` is omitted.",
|
|
576
|
+
"minLength": 1,
|
|
577
|
+
"pattern": "\\S",
|
|
578
|
+
"type": [
|
|
579
|
+
"string",
|
|
580
|
+
"null"
|
|
581
|
+
]
|
|
582
|
+
},
|
|
583
|
+
"supported_policies": {
|
|
584
|
+
"description": "Policies accepted in `skills.duplicates`. Non-empty and unique.",
|
|
585
|
+
"items": {
|
|
586
|
+
"$ref": "#/$defs/SkillDuplicatePolicy"
|
|
587
|
+
},
|
|
588
|
+
"minItems": 1,
|
|
589
|
+
"type": "array",
|
|
590
|
+
"uniqueItems": true
|
|
591
|
+
}
|
|
592
|
+
},
|
|
593
|
+
"required": [
|
|
594
|
+
"supported_policies"
|
|
595
|
+
],
|
|
596
|
+
"type": "object"
|
|
597
|
+
},
|
|
598
|
+
"SkillFrontmatterErrors": {
|
|
599
|
+
"description": "Handling of front-matter parse errors in a candidate skill.",
|
|
600
|
+
"oneOf": [
|
|
601
|
+
{
|
|
602
|
+
"const": "recover_key_value",
|
|
603
|
+
"description": "Recover simple `key: value` lines.",
|
|
604
|
+
"type": "string"
|
|
605
|
+
},
|
|
606
|
+
{
|
|
607
|
+
"const": "reject",
|
|
608
|
+
"description": "A parser-reported failure rejects that candidate.",
|
|
609
|
+
"type": "string"
|
|
610
|
+
},
|
|
611
|
+
{
|
|
612
|
+
"const": "adapter_defined",
|
|
613
|
+
"description": "Documented and implemented by the adapter.",
|
|
614
|
+
"type": "string"
|
|
615
|
+
}
|
|
616
|
+
]
|
|
617
|
+
},
|
|
618
|
+
"SkillNameFallback": {
|
|
619
|
+
"description": "Name used when a skill's front matter has no `name`.",
|
|
620
|
+
"oneOf": [
|
|
621
|
+
{
|
|
622
|
+
"const": "directory_name",
|
|
623
|
+
"description": "The skill folder name.",
|
|
624
|
+
"type": "string"
|
|
625
|
+
},
|
|
626
|
+
{
|
|
627
|
+
"const": "none",
|
|
628
|
+
"description": "No fallback.",
|
|
629
|
+
"type": "string"
|
|
630
|
+
}
|
|
631
|
+
]
|
|
632
|
+
},
|
|
633
|
+
"SkillNameSource": {
|
|
634
|
+
"description": "Source of the name compared for duplicate detection.",
|
|
635
|
+
"oneOf": [
|
|
636
|
+
{
|
|
637
|
+
"const": "frontmatter",
|
|
638
|
+
"description": "The front-matter `name`.",
|
|
639
|
+
"type": "string"
|
|
640
|
+
},
|
|
641
|
+
{
|
|
642
|
+
"const": "directory",
|
|
643
|
+
"description": "The skill folder name.",
|
|
644
|
+
"type": "string"
|
|
645
|
+
}
|
|
646
|
+
]
|
|
647
|
+
},
|
|
648
|
+
"SkillParsingSupport": {
|
|
649
|
+
"additionalProperties": true,
|
|
650
|
+
"description": "How an adapter parses each candidate skill's `SKILL.md`.",
|
|
651
|
+
"properties": {
|
|
652
|
+
"frontmatter_errors": {
|
|
653
|
+
"$ref": "#/$defs/SkillFrontmatterErrors",
|
|
654
|
+
"description": "How front-matter parse errors are handled."
|
|
655
|
+
},
|
|
656
|
+
"name_fallback": {
|
|
657
|
+
"$ref": "#/$defs/SkillNameFallback",
|
|
658
|
+
"description": "Whether a missing name falls back to the skill folder name."
|
|
659
|
+
},
|
|
660
|
+
"required_frontmatter_fields": {
|
|
661
|
+
"description": "Front-matter fields the loading path requires. May be empty; unique.",
|
|
662
|
+
"items": {
|
|
663
|
+
"minLength": 1,
|
|
664
|
+
"pattern": "\\S",
|
|
665
|
+
"type": "string"
|
|
666
|
+
},
|
|
667
|
+
"type": "array",
|
|
668
|
+
"uniqueItems": true
|
|
669
|
+
}
|
|
670
|
+
},
|
|
671
|
+
"required": [
|
|
672
|
+
"required_frontmatter_fields",
|
|
673
|
+
"name_fallback",
|
|
674
|
+
"frontmatter_errors"
|
|
675
|
+
],
|
|
676
|
+
"type": "object"
|
|
677
|
+
},
|
|
678
|
+
"SkillTraversal": {
|
|
679
|
+
"description": "Folder traversal used for skill discovery.",
|
|
680
|
+
"oneOf": [
|
|
681
|
+
{
|
|
682
|
+
"const": "immediate_children",
|
|
683
|
+
"description": "Search only the folder's immediate children.",
|
|
684
|
+
"type": "string"
|
|
685
|
+
},
|
|
686
|
+
{
|
|
687
|
+
"const": "recursive",
|
|
688
|
+
"description": "Search the folder recursively.",
|
|
689
|
+
"type": "string"
|
|
690
|
+
}
|
|
691
|
+
]
|
|
279
692
|
}
|
|
280
693
|
},
|
|
281
694
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
@@ -307,6 +720,14 @@
|
|
|
307
720
|
"default": {},
|
|
308
721
|
"description": "NeMo Fabric config areas this adapter consumes or generates."
|
|
309
722
|
},
|
|
723
|
+
"config_schema": {
|
|
724
|
+
"additionalProperties": true,
|
|
725
|
+
"description": "JSON Schema for static cross-field constraints on the serialized `FabricConfig`.",
|
|
726
|
+
"type": [
|
|
727
|
+
"object",
|
|
728
|
+
"null"
|
|
729
|
+
]
|
|
730
|
+
},
|
|
310
731
|
"contract_version": {
|
|
311
732
|
"const": "fabric.adapter/v1alpha2",
|
|
312
733
|
"description": "Adapter descriptor contract version.",
|
|
@@ -369,6 +790,17 @@
|
|
|
369
790
|
"null"
|
|
370
791
|
]
|
|
371
792
|
},
|
|
793
|
+
"skills": {
|
|
794
|
+
"anyOf": [
|
|
795
|
+
{
|
|
796
|
+
"$ref": "#/$defs/AdapterSkillsSupport"
|
|
797
|
+
},
|
|
798
|
+
{
|
|
799
|
+
"type": "null"
|
|
800
|
+
}
|
|
801
|
+
],
|
|
802
|
+
"description": "Structured skill capabilities. `None` means only `skills.paths` (when\n`config.accepts` includes `skills`)."
|
|
803
|
+
},
|
|
372
804
|
"target_types": {
|
|
373
805
|
"description": "Registered target categories this adapter can execute.",
|
|
374
806
|
"items": {
|
|
@@ -261,8 +261,71 @@
|
|
|
261
261
|
},
|
|
262
262
|
"AgentSkillConfig": {
|
|
263
263
|
"additionalProperties": false,
|
|
264
|
-
"description": "
|
|
264
|
+
"description": "Skills made available to an adapter target.\n\nA non-null `directories` requires an empty `paths`, and a non-null\n`duplicates` requires a non-null `directories`; `null` reads as omitted.",
|
|
265
|
+
"not": {
|
|
266
|
+
"anyOf": [
|
|
267
|
+
{
|
|
268
|
+
"properties": {
|
|
269
|
+
"directories": {
|
|
270
|
+
"type": "array"
|
|
271
|
+
},
|
|
272
|
+
"paths": {
|
|
273
|
+
"minItems": 1
|
|
274
|
+
}
|
|
275
|
+
},
|
|
276
|
+
"required": [
|
|
277
|
+
"directories",
|
|
278
|
+
"paths"
|
|
279
|
+
]
|
|
280
|
+
},
|
|
281
|
+
{
|
|
282
|
+
"properties": {
|
|
283
|
+
"directories": {
|
|
284
|
+
"type": "null"
|
|
285
|
+
},
|
|
286
|
+
"duplicates": {
|
|
287
|
+
"type": "string"
|
|
288
|
+
}
|
|
289
|
+
},
|
|
290
|
+
"required": [
|
|
291
|
+
"duplicates"
|
|
292
|
+
]
|
|
293
|
+
}
|
|
294
|
+
]
|
|
295
|
+
},
|
|
265
296
|
"properties": {
|
|
297
|
+
"bundled": {
|
|
298
|
+
"anyOf": [
|
|
299
|
+
{
|
|
300
|
+
"$ref": "#/$defs/BundledSkills"
|
|
301
|
+
},
|
|
302
|
+
{
|
|
303
|
+
"type": "null"
|
|
304
|
+
}
|
|
305
|
+
],
|
|
306
|
+
"description": "Bundled-skill selection. Sent only to adapters that declare the\nrequested `skills.bundled` operation."
|
|
307
|
+
},
|
|
308
|
+
"directories": {
|
|
309
|
+
"description": "Structured skill entries with paths resolved by NeMo Fabric. Sent only\nto adapters that declare `skills.directory_loading`; an empty list\nloads no external skills.",
|
|
310
|
+
"items": {
|
|
311
|
+
"$ref": "#/$defs/SkillDirectory"
|
|
312
|
+
},
|
|
313
|
+
"type": [
|
|
314
|
+
"array",
|
|
315
|
+
"null"
|
|
316
|
+
]
|
|
317
|
+
},
|
|
318
|
+
"duplicates": {
|
|
319
|
+
"anyOf": [
|
|
320
|
+
{
|
|
321
|
+
"$ref": "#/$defs/SkillDuplicatePolicy"
|
|
322
|
+
},
|
|
323
|
+
{
|
|
324
|
+
"type": "null"
|
|
325
|
+
}
|
|
326
|
+
],
|
|
327
|
+
"description": "Duplicate-name policy between `directories` entries. Sent only to\nadapters that declare the policy in `skills.duplicates`."
|
|
328
|
+
},
|
|
266
329
|
"extensions": {
|
|
267
330
|
"additionalProperties": true,
|
|
268
331
|
"description": "Adapter-owned skill fields.",
|
|
@@ -399,6 +462,88 @@
|
|
|
399
462
|
],
|
|
400
463
|
"type": "object"
|
|
401
464
|
},
|
|
465
|
+
"BundledSkills": {
|
|
466
|
+
"additionalProperties": false,
|
|
467
|
+
"description": "Bundled-skill selection.\n\n`include` and `exclude` are mutually exclusive, and neither may be combined\nwith `enabled: false`; a `null` list reads as omitted. An empty `include`\nselects no bundled skills; an empty `exclude` selects all of them.",
|
|
468
|
+
"not": {
|
|
469
|
+
"anyOf": [
|
|
470
|
+
{
|
|
471
|
+
"properties": {
|
|
472
|
+
"exclude": {
|
|
473
|
+
"type": "array"
|
|
474
|
+
},
|
|
475
|
+
"include": {
|
|
476
|
+
"type": "array"
|
|
477
|
+
}
|
|
478
|
+
},
|
|
479
|
+
"required": [
|
|
480
|
+
"include",
|
|
481
|
+
"exclude"
|
|
482
|
+
]
|
|
483
|
+
},
|
|
484
|
+
{
|
|
485
|
+
"properties": {
|
|
486
|
+
"enabled": {
|
|
487
|
+
"const": false
|
|
488
|
+
},
|
|
489
|
+
"include": {
|
|
490
|
+
"type": "array"
|
|
491
|
+
}
|
|
492
|
+
},
|
|
493
|
+
"required": [
|
|
494
|
+
"enabled",
|
|
495
|
+
"include"
|
|
496
|
+
]
|
|
497
|
+
},
|
|
498
|
+
{
|
|
499
|
+
"properties": {
|
|
500
|
+
"enabled": {
|
|
501
|
+
"const": false
|
|
502
|
+
},
|
|
503
|
+
"exclude": {
|
|
504
|
+
"type": "array"
|
|
505
|
+
}
|
|
506
|
+
},
|
|
507
|
+
"required": [
|
|
508
|
+
"enabled",
|
|
509
|
+
"exclude"
|
|
510
|
+
]
|
|
511
|
+
}
|
|
512
|
+
]
|
|
513
|
+
},
|
|
514
|
+
"properties": {
|
|
515
|
+
"enabled": {
|
|
516
|
+
"default": true,
|
|
517
|
+
"description": "Whether bundled skills load at all.",
|
|
518
|
+
"type": "boolean"
|
|
519
|
+
},
|
|
520
|
+
"exclude": {
|
|
521
|
+
"description": "Load every bundled skill except these. `None` and `[]` differ.",
|
|
522
|
+
"items": {
|
|
523
|
+
"minLength": 1,
|
|
524
|
+
"pattern": "\\S",
|
|
525
|
+
"type": "string"
|
|
526
|
+
},
|
|
527
|
+
"type": [
|
|
528
|
+
"array",
|
|
529
|
+
"null"
|
|
530
|
+
]
|
|
531
|
+
},
|
|
532
|
+
"include": {
|
|
533
|
+
"description": "Load only these bundled skills. `None` and `[]` differ.",
|
|
534
|
+
"items": {
|
|
535
|
+
"minLength": 1,
|
|
536
|
+
"pattern": "\\S",
|
|
537
|
+
"type": "string"
|
|
538
|
+
},
|
|
539
|
+
"type": [
|
|
540
|
+
"array",
|
|
541
|
+
"null"
|
|
542
|
+
]
|
|
543
|
+
}
|
|
544
|
+
},
|
|
545
|
+
"type": "object"
|
|
546
|
+
},
|
|
402
547
|
"InstructionMode": {
|
|
403
548
|
"description": "How an instruction value is applied to the selected harness.",
|
|
404
549
|
"oneOf": [
|
|
@@ -561,6 +706,67 @@
|
|
|
561
706
|
"type": "string"
|
|
562
707
|
}
|
|
563
708
|
]
|
|
709
|
+
},
|
|
710
|
+
"SkillDirectory": {
|
|
711
|
+
"description": "One structured external-skill entry: exactly one of `{\"skill\": path}` or\n`{\"folder\": path}`. The other key may be present only as `null`, which\nreads as absent.",
|
|
712
|
+
"oneOf": [
|
|
713
|
+
{
|
|
714
|
+
"additionalProperties": false,
|
|
715
|
+
"description": "One skill's folder; it must contain `SKILL.md`.",
|
|
716
|
+
"properties": {
|
|
717
|
+
"folder": {
|
|
718
|
+
"type": "null"
|
|
719
|
+
},
|
|
720
|
+
"skill": {
|
|
721
|
+
"minLength": 1,
|
|
722
|
+
"pattern": "\\S",
|
|
723
|
+
"type": "string"
|
|
724
|
+
}
|
|
725
|
+
},
|
|
726
|
+
"required": [
|
|
727
|
+
"skill"
|
|
728
|
+
],
|
|
729
|
+
"type": "object"
|
|
730
|
+
},
|
|
731
|
+
{
|
|
732
|
+
"additionalProperties": false,
|
|
733
|
+
"description": "A folder of skills discovered by the selected adapter.",
|
|
734
|
+
"properties": {
|
|
735
|
+
"folder": {
|
|
736
|
+
"minLength": 1,
|
|
737
|
+
"pattern": "\\S",
|
|
738
|
+
"type": "string"
|
|
739
|
+
},
|
|
740
|
+
"skill": {
|
|
741
|
+
"type": "null"
|
|
742
|
+
}
|
|
743
|
+
},
|
|
744
|
+
"required": [
|
|
745
|
+
"folder"
|
|
746
|
+
],
|
|
747
|
+
"type": "object"
|
|
748
|
+
}
|
|
749
|
+
]
|
|
750
|
+
},
|
|
751
|
+
"SkillDuplicatePolicy": {
|
|
752
|
+
"description": "How two `skills.directories` entries that provide the same skill name resolve.",
|
|
753
|
+
"oneOf": [
|
|
754
|
+
{
|
|
755
|
+
"const": "reject",
|
|
756
|
+
"description": "Start fails, naming both entries.",
|
|
757
|
+
"type": "string"
|
|
758
|
+
},
|
|
759
|
+
{
|
|
760
|
+
"const": "last_wins",
|
|
761
|
+
"description": "The later entry's skill loads.",
|
|
762
|
+
"type": "string"
|
|
763
|
+
},
|
|
764
|
+
{
|
|
765
|
+
"const": "first_wins",
|
|
766
|
+
"description": "The earlier entry's skill loads.",
|
|
767
|
+
"type": "string"
|
|
768
|
+
}
|
|
769
|
+
]
|
|
564
770
|
}
|
|
565
771
|
},
|
|
566
772
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
@@ -3,6 +3,10 @@
|
|
|
3
3
|
"additionalProperties": false,
|
|
4
4
|
"description": "Southbound invocation request passed to an adapter target.",
|
|
5
5
|
"properties": {
|
|
6
|
+
"acknowledge_recovery": {
|
|
7
|
+
"description": "Acknowledge uncertain earlier completion before starting this new request.",
|
|
8
|
+
"type": "boolean"
|
|
9
|
+
},
|
|
6
10
|
"context": {
|
|
7
11
|
"additionalProperties": true,
|
|
8
12
|
"description": "Caller-provided task, rollout, workflow, or application context.",
|
|
@@ -252,6 +252,13 @@
|
|
|
252
252
|
"output": {
|
|
253
253
|
"description": "Primary adapter-target output."
|
|
254
254
|
},
|
|
255
|
+
"session_id": {
|
|
256
|
+
"description": "Confirmed adapter-issued identity of the durable native session.",
|
|
257
|
+
"type": [
|
|
258
|
+
"string",
|
|
259
|
+
"null"
|
|
260
|
+
]
|
|
261
|
+
},
|
|
255
262
|
"status": {
|
|
256
263
|
"$ref": "#/$defs/AgentRunStatus",
|
|
257
264
|
"description": "Adapter-target completion status."
|
|
@@ -179,6 +179,35 @@
|
|
|
179
179
|
"relay_enabled"
|
|
180
180
|
],
|
|
181
181
|
"type": "object"
|
|
182
|
+
},
|
|
183
|
+
"SessionRef": {
|
|
184
|
+
"additionalProperties": false,
|
|
185
|
+
"description": "Adapter-issued native identity, resolved only within caller-supplied storage.",
|
|
186
|
+
"properties": {
|
|
187
|
+
"adapter_id": {
|
|
188
|
+
"description": "Adapter responsible for interpreting the opaque identifier.",
|
|
189
|
+
"minLength": 1,
|
|
190
|
+
"pattern": "\\S",
|
|
191
|
+
"type": "string"
|
|
192
|
+
},
|
|
193
|
+
"schema_version": {
|
|
194
|
+
"const": "fabric.session_ref/v1alpha1",
|
|
195
|
+
"description": "Supported envelope version.",
|
|
196
|
+
"type": "string"
|
|
197
|
+
},
|
|
198
|
+
"session_id": {
|
|
199
|
+
"description": "Opaque adapter-issued identifier interpreted by the adapter.",
|
|
200
|
+
"minLength": 1,
|
|
201
|
+
"pattern": "\\S",
|
|
202
|
+
"type": "string"
|
|
203
|
+
}
|
|
204
|
+
},
|
|
205
|
+
"required": [
|
|
206
|
+
"schema_version",
|
|
207
|
+
"adapter_id",
|
|
208
|
+
"session_id"
|
|
209
|
+
],
|
|
210
|
+
"type": "object"
|
|
182
211
|
}
|
|
183
212
|
},
|
|
184
213
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
@@ -190,7 +219,7 @@
|
|
|
190
219
|
"description": "Artifact manifest visible to the adapter at invocation start."
|
|
191
220
|
},
|
|
192
221
|
"deadline_millis": {
|
|
193
|
-
"description": "Unix time in milliseconds by which the adapter should return its result.\nPresent
|
|
222
|
+
"description": "Unix time in milliseconds by which the adapter should return its result.\nPresent when runtime.timeout_seconds is set, shortly before Fabric's invocation timeout.",
|
|
194
223
|
"format": "uint64",
|
|
195
224
|
"minimum": 0,
|
|
196
225
|
"type": [
|
|
@@ -214,6 +243,24 @@
|
|
|
214
243
|
"description": "Runtime handle id.",
|
|
215
244
|
"type": "string"
|
|
216
245
|
},
|
|
246
|
+
"session_ref": {
|
|
247
|
+
"anyOf": [
|
|
248
|
+
{
|
|
249
|
+
"$ref": "#/$defs/SessionRef"
|
|
250
|
+
},
|
|
251
|
+
{
|
|
252
|
+
"type": "null"
|
|
253
|
+
}
|
|
254
|
+
],
|
|
255
|
+
"description": "Explicit durable session selection, supplied only to opted-in adapters."
|
|
256
|
+
},
|
|
257
|
+
"state_dir": {
|
|
258
|
+
"description": "Absolute folder for the adapter's native state, present when\n`runtime.keep_state` is set. Every runtime of the agent gets the same\nfolder, and Fabric lets only one running runtime use it at a time.",
|
|
259
|
+
"type": [
|
|
260
|
+
"string",
|
|
261
|
+
"null"
|
|
262
|
+
]
|
|
263
|
+
},
|
|
217
264
|
"telemetry": {
|
|
218
265
|
"anyOf": [
|
|
219
266
|
{
|