@adea-ai/sdk 1.3.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.
Files changed (22) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +35 -0
  3. package/dist/client.d.ts +53 -0
  4. package/dist/client.d.ts.map +1 -0
  5. package/dist/client.js +183 -0
  6. package/dist/client.js.map +1 -0
  7. package/dist/index.d.ts +5 -0
  8. package/dist/index.d.ts.map +1 -0
  9. package/dist/index.js +5 -0
  10. package/dist/index.js.map +1 -0
  11. package/dist/operations.d.ts +1154 -0
  12. package/dist/operations.d.ts.map +1 -0
  13. package/dist/operations.js +95 -0
  14. package/dist/operations.js.map +1 -0
  15. package/dist/testing.d.ts +16 -0
  16. package/dist/testing.d.ts.map +1 -0
  17. package/dist/testing.js +142 -0
  18. package/dist/testing.js.map +1 -0
  19. package/openapi/control-plane.v1.json +3845 -0
  20. package/openapi/control-plane.v2.json +4585 -0
  21. package/openapi/control-plane.v3.json +4585 -0
  22. package/package.json +61 -0
package/openapi/control-plane.v3.json ADDED
@@ -0,0 +1,4585 @@
1
+ {
2
+ "openapi": "3.1.0",
3
+ "info": { "title": "Agent HQ Control Plane API", "version": "3.0.0" },
4
+ "paths": {
5
+ "/v1/authentication/verify": {
6
+ "post": {
7
+ "operationId": "authentication.verify",
8
+ "requestBody": {
9
+ "content": {
10
+ "application/json": {
11
+ "schema": {
12
+ "properties": {
13
+ "caller": {
14
+ "properties": {
15
+ "servicePrincipalId": {
16
+ "maxLength": 64,
17
+ "minLength": 5,
18
+ "pattern": "^svc_[a-z][a-z0-9-]*$",
19
+ "type": "string"
20
+ }
21
+ },
22
+ "required": ["servicePrincipalId"],
23
+ "type": "object"
24
+ },
25
+ "contractVersion": {
26
+ "additionalProperties": false,
27
+ "properties": {
28
+ "major": {
29
+ "exclusiveMinimum": 0,
30
+ "maximum": 9007199254740991,
31
+ "type": "integer"
32
+ },
33
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
34
+ },
35
+ "required": ["major", "minor"],
36
+ "type": "object"
37
+ },
38
+ "correlation": {
39
+ "properties": {
40
+ "causationCommandId": {
41
+ "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$",
42
+ "type": "string"
43
+ },
44
+ "parentEventId": {
45
+ "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$",
46
+ "type": "string"
47
+ },
48
+ "traceId": { "pattern": "^trc_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
49
+ },
50
+ "required": ["traceId"],
51
+ "type": "object"
52
+ },
53
+ "operation": { "const": "authentication.verify", "type": "string" },
54
+ "projectId": { "pattern": "^prj_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
55
+ "requestedAt": {
56
+ "format": "date-time",
57
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
58
+ "type": "string"
59
+ },
60
+ "requestId": { "pattern": "^req_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
61
+ "workspaceId": { "pattern": "^wsp_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
62
+ },
63
+ "required": [
64
+ "caller",
65
+ "contractVersion",
66
+ "requestId",
67
+ "workspaceId",
68
+ "correlation",
69
+ "operation",
70
+ "requestedAt"
71
+ ],
72
+ "type": "object"
73
+ }
74
+ }
75
+ },
76
+ "required": true
77
+ },
78
+ "responses": {
79
+ "200": {
80
+ "content": {
81
+ "application/json": {
82
+ "schema": {
83
+ "additionalProperties": false,
84
+ "properties": {
85
+ "contractVersion": {
86
+ "additionalProperties": false,
87
+ "properties": {
88
+ "major": {
89
+ "exclusiveMinimum": 0,
90
+ "maximum": 9007199254740991,
91
+ "type": "integer"
92
+ },
93
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
94
+ },
95
+ "required": ["major", "minor"],
96
+ "type": "object"
97
+ },
98
+ "correlation": {
99
+ "additionalProperties": false,
100
+ "properties": {
101
+ "causationCommandId": {},
102
+ "parentEventId": {},
103
+ "traceId": {}
104
+ },
105
+ "required": ["traceId"],
106
+ "type": "object"
107
+ },
108
+ "data": {
109
+ "additionalProperties": false,
110
+ "properties": {
111
+ "authenticated": { "const": true, "type": "boolean" },
112
+ "principal": {
113
+ "additionalProperties": false,
114
+ "properties": {
115
+ "kind": { "const": "agent_hq_service", "type": "string" },
116
+ "principalId": { "pattern": "^svc_[a-z][a-z0-9-]*$", "type": "string" },
117
+ "projectIds": { "items": {}, "maxItems": 256, "type": "array" },
118
+ "scopes": {
119
+ "items": {
120
+ "maxLength": 96,
121
+ "minLength": 3,
122
+ "pattern": "^[a-z][a-z0-9.-]*:[a-z][a-z0-9.-]*$",
123
+ "type": "string"
124
+ },
125
+ "maxItems": 64,
126
+ "type": "array"
127
+ },
128
+ "workspaceIds": { "items": {}, "maxItems": 256, "type": "array" }
129
+ },
130
+ "required": [
131
+ "kind",
132
+ "principalId",
133
+ "scopes",
134
+ "workspaceIds",
135
+ "projectIds"
136
+ ],
137
+ "type": "object"
138
+ }
139
+ },
140
+ "required": ["authenticated", "principal"],
141
+ "type": "object"
142
+ },
143
+ "requestId": {}
144
+ },
145
+ "required": ["contractVersion", "requestId", "correlation", "data"],
146
+ "type": "object"
147
+ }
148
+ }
149
+ },
150
+ "description": "Successful response"
151
+ },
152
+ "default": {
153
+ "content": {
154
+ "application/json": {
155
+ "schema": {
156
+ "additionalProperties": false,
157
+ "properties": {
158
+ "contractVersion": {
159
+ "additionalProperties": false,
160
+ "properties": {
161
+ "major": {
162
+ "exclusiveMinimum": 0,
163
+ "maximum": 9007199254740991,
164
+ "type": "integer"
165
+ },
166
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
167
+ },
168
+ "required": ["major", "minor"],
169
+ "type": "object"
170
+ },
171
+ "correlation": {
172
+ "additionalProperties": false,
173
+ "properties": {
174
+ "causationCommandId": {},
175
+ "parentEventId": {},
176
+ "traceId": {}
177
+ },
178
+ "required": ["traceId"],
179
+ "type": "object"
180
+ },
181
+ "error": {
182
+ "additionalProperties": false,
183
+ "properties": {
184
+ "class": {
185
+ "enum": [
186
+ "validation",
187
+ "authentication",
188
+ "authorization",
189
+ "conflict",
190
+ "stale_reference",
191
+ "capability_mismatch",
192
+ "runtime_unavailable",
193
+ "internal"
194
+ ],
195
+ "type": "string"
196
+ },
197
+ "code": {
198
+ "maxLength": 96,
199
+ "minLength": 1,
200
+ "pattern": "^[A-Z][A-Z0-9_]*$",
201
+ "type": "string"
202
+ },
203
+ "details": {
204
+ "additionalProperties": {},
205
+ "propertyNames": { "maxLength": 64, "type": "string" },
206
+ "type": "object"
207
+ },
208
+ "message": { "maxLength": 512, "minLength": 1, "type": "string" },
209
+ "remediation": { "maxLength": 256, "minLength": 1, "type": "string" },
210
+ "retryable": { "type": "boolean" },
211
+ "source": {
212
+ "enum": [
213
+ "client",
214
+ "auth",
215
+ "policy",
216
+ "runtime",
217
+ "provider",
218
+ "persistence",
219
+ "workflow",
220
+ "system"
221
+ ],
222
+ "type": "string"
223
+ }
224
+ },
225
+ "required": ["class", "code", "message", "retryable", "source"],
226
+ "type": "object"
227
+ },
228
+ "requestId": {}
229
+ },
230
+ "required": ["contractVersion", "requestId", "correlation", "error"],
231
+ "type": "object"
232
+ }
233
+ }
234
+ },
235
+ "description": "Normalized error response"
236
+ }
237
+ },
238
+ "security": [{ "serviceBearer": [] }]
239
+ }
240
+ },
241
+ "/v1/context-packages/resolve": {
242
+ "post": {
243
+ "operationId": "context-package.resolve",
244
+ "requestBody": {
245
+ "content": {
246
+ "application/json": {
247
+ "schema": {
248
+ "properties": {
249
+ "caller": {
250
+ "properties": {
251
+ "servicePrincipalId": {
252
+ "maxLength": 64,
253
+ "minLength": 5,
254
+ "pattern": "^svc_[a-z][a-z0-9-]*$",
255
+ "type": "string"
256
+ }
257
+ },
258
+ "required": ["servicePrincipalId"],
259
+ "type": "object"
260
+ },
261
+ "contractVersion": {
262
+ "additionalProperties": false,
263
+ "properties": {
264
+ "major": {
265
+ "exclusiveMinimum": 0,
266
+ "maximum": 9007199254740991,
267
+ "type": "integer"
268
+ },
269
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
270
+ },
271
+ "required": ["major", "minor"],
272
+ "type": "object"
273
+ },
274
+ "correlation": {
275
+ "properties": {
276
+ "causationCommandId": {
277
+ "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$",
278
+ "type": "string"
279
+ },
280
+ "parentEventId": {
281
+ "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$",
282
+ "type": "string"
283
+ },
284
+ "traceId": { "pattern": "^trc_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
285
+ },
286
+ "required": ["traceId"],
287
+ "type": "object"
288
+ },
289
+ "operation": { "const": "context-package.resolve", "type": "string" },
290
+ "parameters": {
291
+ "properties": {
292
+ "contextPackageId": {
293
+ "pattern": "^ctx_[0-9A-HJKMNP-TV-Z]{26}$",
294
+ "type": "string"
295
+ }
296
+ },
297
+ "required": ["contextPackageId"],
298
+ "type": "object"
299
+ },
300
+ "projectId": { "pattern": "^prj_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
301
+ "requestedAt": {
302
+ "format": "date-time",
303
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
304
+ "type": "string"
305
+ },
306
+ "requestId": { "pattern": "^req_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
307
+ "workspaceId": { "pattern": "^wsp_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
308
+ },
309
+ "required": [
310
+ "caller",
311
+ "contractVersion",
312
+ "requestId",
313
+ "workspaceId",
314
+ "correlation",
315
+ "operation",
316
+ "requestedAt",
317
+ "parameters"
318
+ ],
319
+ "type": "object"
320
+ }
321
+ }
322
+ },
323
+ "required": true
324
+ },
325
+ "responses": {
326
+ "200": {
327
+ "content": {
328
+ "application/json": {
329
+ "schema": {
330
+ "additionalProperties": false,
331
+ "properties": {
332
+ "contractVersion": {
333
+ "additionalProperties": false,
334
+ "properties": {
335
+ "major": {
336
+ "exclusiveMinimum": 0,
337
+ "maximum": 9007199254740991,
338
+ "type": "integer"
339
+ },
340
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
341
+ },
342
+ "required": ["major", "minor"],
343
+ "type": "object"
344
+ },
345
+ "correlation": {
346
+ "additionalProperties": false,
347
+ "properties": {
348
+ "causationCommandId": {},
349
+ "parentEventId": {},
350
+ "traceId": {}
351
+ },
352
+ "required": ["traceId"],
353
+ "type": "object"
354
+ },
355
+ "data": {
356
+ "additionalProperties": false,
357
+ "properties": {
358
+ "contextPackage": {
359
+ "additionalProperties": false,
360
+ "properties": {
361
+ "compilerVersion": {
362
+ "maxLength": 64,
363
+ "minLength": 1,
364
+ "type": "string"
365
+ },
366
+ "contentDigest": {
367
+ "pattern": "^sha256:[a-f0-9]{64}$",
368
+ "type": "string"
369
+ },
370
+ "contextPackageId": {},
371
+ "schemaVersion": {
372
+ "exclusiveMinimum": 0,
373
+ "maximum": 9007199254740991,
374
+ "type": "integer"
375
+ }
376
+ },
377
+ "required": [
378
+ "contextPackageId",
379
+ "contentDigest",
380
+ "schemaVersion",
381
+ "compilerVersion"
382
+ ],
383
+ "type": "object"
384
+ }
385
+ },
386
+ "required": ["contextPackage"],
387
+ "type": "object"
388
+ },
389
+ "requestId": {}
390
+ },
391
+ "required": ["contractVersion", "requestId", "correlation", "data"],
392
+ "type": "object"
393
+ }
394
+ }
395
+ },
396
+ "description": "Successful response"
397
+ },
398
+ "default": {
399
+ "content": {
400
+ "application/json": {
401
+ "schema": {
402
+ "additionalProperties": false,
403
+ "properties": {
404
+ "contractVersion": {
405
+ "additionalProperties": false,
406
+ "properties": {
407
+ "major": {
408
+ "exclusiveMinimum": 0,
409
+ "maximum": 9007199254740991,
410
+ "type": "integer"
411
+ },
412
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
413
+ },
414
+ "required": ["major", "minor"],
415
+ "type": "object"
416
+ },
417
+ "correlation": {
418
+ "additionalProperties": false,
419
+ "properties": {
420
+ "causationCommandId": {},
421
+ "parentEventId": {},
422
+ "traceId": {}
423
+ },
424
+ "required": ["traceId"],
425
+ "type": "object"
426
+ },
427
+ "error": {
428
+ "additionalProperties": false,
429
+ "properties": {
430
+ "class": {
431
+ "enum": [
432
+ "validation",
433
+ "authentication",
434
+ "authorization",
435
+ "conflict",
436
+ "stale_reference",
437
+ "capability_mismatch",
438
+ "runtime_unavailable",
439
+ "internal"
440
+ ],
441
+ "type": "string"
442
+ },
443
+ "code": {
444
+ "maxLength": 96,
445
+ "minLength": 1,
446
+ "pattern": "^[A-Z][A-Z0-9_]*$",
447
+ "type": "string"
448
+ },
449
+ "details": {
450
+ "additionalProperties": {},
451
+ "propertyNames": { "maxLength": 64, "type": "string" },
452
+ "type": "object"
453
+ },
454
+ "message": { "maxLength": 512, "minLength": 1, "type": "string" },
455
+ "remediation": { "maxLength": 256, "minLength": 1, "type": "string" },
456
+ "retryable": { "type": "boolean" },
457
+ "source": {
458
+ "enum": [
459
+ "client",
460
+ "auth",
461
+ "policy",
462
+ "runtime",
463
+ "provider",
464
+ "persistence",
465
+ "workflow",
466
+ "system"
467
+ ],
468
+ "type": "string"
469
+ }
470
+ },
471
+ "required": ["class", "code", "message", "retryable", "source"],
472
+ "type": "object"
473
+ },
474
+ "requestId": {}
475
+ },
476
+ "required": ["contractVersion", "requestId", "correlation", "error"],
477
+ "type": "object"
478
+ }
479
+ }
480
+ },
481
+ "description": "Normalized error response"
482
+ }
483
+ },
484
+ "security": [{ "serviceBearer": [] }]
485
+ }
486
+ },
487
+ "/v1/executions/accept": {
488
+ "post": {
489
+ "operationId": "execution.accept",
490
+ "requestBody": {
491
+ "content": {
492
+ "application/json": {
493
+ "schema": {
494
+ "properties": {
495
+ "caller": {
496
+ "properties": {
497
+ "servicePrincipalId": {
498
+ "maxLength": 64,
499
+ "minLength": 5,
500
+ "pattern": "^svc_[a-z][a-z0-9-]*$",
501
+ "type": "string"
502
+ }
503
+ },
504
+ "required": ["servicePrincipalId"],
505
+ "type": "object"
506
+ },
507
+ "commandId": { "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
508
+ "contractVersion": {
509
+ "additionalProperties": false,
510
+ "properties": {
511
+ "major": {
512
+ "exclusiveMinimum": 0,
513
+ "maximum": 9007199254740991,
514
+ "type": "integer"
515
+ },
516
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
517
+ },
518
+ "required": ["major", "minor"],
519
+ "type": "object"
520
+ },
521
+ "correlation": {
522
+ "properties": {
523
+ "causationCommandId": {
524
+ "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$",
525
+ "type": "string"
526
+ },
527
+ "parentEventId": {
528
+ "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$",
529
+ "type": "string"
530
+ },
531
+ "traceId": { "pattern": "^trc_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
532
+ },
533
+ "required": ["traceId"],
534
+ "type": "object"
535
+ },
536
+ "idempotencyKey": {
537
+ "maxLength": 128,
538
+ "minLength": 16,
539
+ "pattern": "^[A-Za-z0-9._:-]+$",
540
+ "type": "string"
541
+ },
542
+ "issuedAt": {
543
+ "format": "date-time",
544
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
545
+ "type": "string"
546
+ },
547
+ "operation": { "const": "execution.accept", "type": "string" },
548
+ "payload": {
549
+ "properties": {
550
+ "agentId": { "pattern": "^agt_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
551
+ "deadlineAt": {
552
+ "format": "date-time",
553
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
554
+ "type": "string"
555
+ },
556
+ "executionPlan": {
557
+ "properties": {
558
+ "contentDigest": { "pattern": "^sha256:[a-f0-9]{64}$", "type": "string" },
559
+ "executionPlanId": {
560
+ "pattern": "^pln_[0-9A-HJKMNP-TV-Z]{26}$",
561
+ "type": "string"
562
+ },
563
+ "schemaVersion": {
564
+ "exclusiveMinimum": 0,
565
+ "maximum": 9007199254740991,
566
+ "type": "integer"
567
+ }
568
+ },
569
+ "required": ["executionPlanId", "contentDigest", "schemaVersion"],
570
+ "type": "object"
571
+ },
572
+ "marketplacePluginReferences": {
573
+ "items": {
574
+ "additionalProperties": false,
575
+ "properties": {
576
+ "canonicalContentDigest": {
577
+ "pattern": "^sha256:[a-f0-9]{64}$",
578
+ "type": "string"
579
+ },
580
+ "pluginId": {
581
+ "pattern": "^plugin:[a-z0-9-]+:[a-z0-9][a-z0-9-]{1,127}$",
582
+ "type": "string"
583
+ },
584
+ "releaseId": { "pattern": "^release:[a-f0-9]{64}$", "type": "string" }
585
+ },
586
+ "required": ["canonicalContentDigest", "pluginId", "releaseId"],
587
+ "type": "object"
588
+ },
589
+ "maxItems": 128,
590
+ "type": "array"
591
+ },
592
+ "parentExecutionId": {
593
+ "pattern": "^exe_[0-9A-HJKMNP-TV-Z]{26}$",
594
+ "type": "string"
595
+ },
596
+ "retentionExpiresAt": {
597
+ "format": "date-time",
598
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
599
+ "type": "string"
600
+ },
601
+ "taskId": { "pattern": "^tsk_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
602
+ },
603
+ "required": ["taskId", "agentId", "executionPlan", "retentionExpiresAt"],
604
+ "type": "object"
605
+ },
606
+ "payloadHash": { "pattern": "^[a-f0-9]{64}$", "type": "string" },
607
+ "projectId": { "pattern": "^prj_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
608
+ "requestId": { "pattern": "^req_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
609
+ "workspaceId": { "pattern": "^wsp_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
610
+ },
611
+ "required": [
612
+ "caller",
613
+ "contractVersion",
614
+ "requestId",
615
+ "workspaceId",
616
+ "projectId",
617
+ "correlation",
618
+ "commandId",
619
+ "idempotencyKey",
620
+ "payloadHash",
621
+ "operation",
622
+ "issuedAt",
623
+ "payload"
624
+ ],
625
+ "type": "object"
626
+ }
627
+ }
628
+ },
629
+ "required": true
630
+ },
631
+ "responses": {
632
+ "200": {
633
+ "content": {
634
+ "application/json": {
635
+ "schema": {
636
+ "additionalProperties": false,
637
+ "properties": {
638
+ "contractVersion": {
639
+ "additionalProperties": false,
640
+ "properties": {
641
+ "major": {
642
+ "exclusiveMinimum": 0,
643
+ "maximum": 9007199254740991,
644
+ "type": "integer"
645
+ },
646
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
647
+ },
648
+ "required": ["major", "minor"],
649
+ "type": "object"
650
+ },
651
+ "correlation": {
652
+ "additionalProperties": false,
653
+ "properties": {
654
+ "causationCommandId": {},
655
+ "parentEventId": {},
656
+ "traceId": {}
657
+ },
658
+ "required": ["traceId"],
659
+ "type": "object"
660
+ },
661
+ "data": {
662
+ "additionalProperties": false,
663
+ "properties": {
664
+ "commandId": {},
665
+ "errorReference": {
666
+ "maxLength": 512,
667
+ "minLength": 1,
668
+ "pattern": "^[a-z][a-z0-9+.-]*:\\/\\/\\S+$",
669
+ "type": "string"
670
+ },
671
+ "executionId": {},
672
+ "executionPlan": {
673
+ "additionalProperties": false,
674
+ "properties": {
675
+ "contentDigest": {
676
+ "pattern": "^sha256:[a-f0-9]{64}$",
677
+ "type": "string"
678
+ },
679
+ "executionPlanId": {},
680
+ "schemaVersion": {
681
+ "exclusiveMinimum": 0,
682
+ "maximum": 9007199254740991,
683
+ "type": "integer"
684
+ }
685
+ },
686
+ "required": ["executionPlanId", "contentDigest", "schemaVersion"],
687
+ "type": "object"
688
+ },
689
+ "replayed": { "type": "boolean" },
690
+ "resultReference": {},
691
+ "status": {
692
+ "enum": [
693
+ "accepted",
694
+ "processing",
695
+ "completed",
696
+ "failed",
697
+ "reconciliation_required"
698
+ ],
699
+ "type": "string"
700
+ }
701
+ },
702
+ "required": [
703
+ "commandId",
704
+ "executionId",
705
+ "executionPlan",
706
+ "status",
707
+ "replayed"
708
+ ],
709
+ "type": "object"
710
+ },
711
+ "requestId": {}
712
+ },
713
+ "required": ["contractVersion", "requestId", "correlation", "data"],
714
+ "type": "object"
715
+ }
716
+ }
717
+ },
718
+ "description": "Successful response"
719
+ },
720
+ "default": {
721
+ "content": {
722
+ "application/json": {
723
+ "schema": {
724
+ "additionalProperties": false,
725
+ "properties": {
726
+ "contractVersion": {
727
+ "additionalProperties": false,
728
+ "properties": {
729
+ "major": {
730
+ "exclusiveMinimum": 0,
731
+ "maximum": 9007199254740991,
732
+ "type": "integer"
733
+ },
734
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
735
+ },
736
+ "required": ["major", "minor"],
737
+ "type": "object"
738
+ },
739
+ "correlation": {
740
+ "additionalProperties": false,
741
+ "properties": {
742
+ "causationCommandId": {},
743
+ "parentEventId": {},
744
+ "traceId": {}
745
+ },
746
+ "required": ["traceId"],
747
+ "type": "object"
748
+ },
749
+ "error": {
750
+ "additionalProperties": false,
751
+ "properties": {
752
+ "class": {
753
+ "enum": [
754
+ "validation",
755
+ "authentication",
756
+ "authorization",
757
+ "conflict",
758
+ "stale_reference",
759
+ "capability_mismatch",
760
+ "runtime_unavailable",
761
+ "internal"
762
+ ],
763
+ "type": "string"
764
+ },
765
+ "code": {
766
+ "maxLength": 96,
767
+ "minLength": 1,
768
+ "pattern": "^[A-Z][A-Z0-9_]*$",
769
+ "type": "string"
770
+ },
771
+ "details": {
772
+ "additionalProperties": {},
773
+ "propertyNames": { "maxLength": 64, "type": "string" },
774
+ "type": "object"
775
+ },
776
+ "message": { "maxLength": 512, "minLength": 1, "type": "string" },
777
+ "remediation": { "maxLength": 256, "minLength": 1, "type": "string" },
778
+ "retryable": { "type": "boolean" },
779
+ "source": {
780
+ "enum": [
781
+ "client",
782
+ "auth",
783
+ "policy",
784
+ "runtime",
785
+ "provider",
786
+ "persistence",
787
+ "workflow",
788
+ "system"
789
+ ],
790
+ "type": "string"
791
+ }
792
+ },
793
+ "required": ["class", "code", "message", "retryable", "source"],
794
+ "type": "object"
795
+ },
796
+ "requestId": {}
797
+ },
798
+ "required": ["contractVersion", "requestId", "correlation", "error"],
799
+ "type": "object"
800
+ }
801
+ }
802
+ },
803
+ "description": "Normalized error response"
804
+ }
805
+ },
806
+ "security": [{ "serviceBearer": [] }]
807
+ }
808
+ },
809
+ "/v1/executions/validate": {
810
+ "post": {
811
+ "operationId": "execution.validate",
812
+ "requestBody": {
813
+ "content": {
814
+ "application/json": {
815
+ "schema": {
816
+ "properties": {
817
+ "caller": {
818
+ "properties": {
819
+ "servicePrincipalId": {
820
+ "maxLength": 64,
821
+ "minLength": 5,
822
+ "pattern": "^svc_[a-z][a-z0-9-]*$",
823
+ "type": "string"
824
+ }
825
+ },
826
+ "required": ["servicePrincipalId"],
827
+ "type": "object"
828
+ },
829
+ "commandId": { "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
830
+ "contractVersion": {
831
+ "additionalProperties": false,
832
+ "properties": {
833
+ "major": {
834
+ "exclusiveMinimum": 0,
835
+ "maximum": 9007199254740991,
836
+ "type": "integer"
837
+ },
838
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
839
+ },
840
+ "required": ["major", "minor"],
841
+ "type": "object"
842
+ },
843
+ "correlation": {
844
+ "properties": {
845
+ "causationCommandId": {
846
+ "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$",
847
+ "type": "string"
848
+ },
849
+ "parentEventId": {
850
+ "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$",
851
+ "type": "string"
852
+ },
853
+ "traceId": { "pattern": "^trc_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
854
+ },
855
+ "required": ["traceId"],
856
+ "type": "object"
857
+ },
858
+ "idempotencyKey": {
859
+ "maxLength": 128,
860
+ "minLength": 16,
861
+ "pattern": "^[A-Za-z0-9._:-]+$",
862
+ "type": "string"
863
+ },
864
+ "issuedAt": {
865
+ "format": "date-time",
866
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
867
+ "type": "string"
868
+ },
869
+ "operation": { "const": "execution.validate", "type": "string" },
870
+ "payload": {
871
+ "properties": {
872
+ "agentId": { "pattern": "^agt_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
873
+ "contextPackage": {
874
+ "properties": {
875
+ "compilerVersion": { "maxLength": 64, "minLength": 1, "type": "string" },
876
+ "contentDigest": { "pattern": "^sha256:[a-f0-9]{64}$", "type": "string" },
877
+ "contextPackageId": {
878
+ "pattern": "^ctx_[0-9A-HJKMNP-TV-Z]{26}$",
879
+ "type": "string"
880
+ },
881
+ "schemaVersion": {
882
+ "exclusiveMinimum": 0,
883
+ "maximum": 9007199254740991,
884
+ "type": "integer"
885
+ }
886
+ },
887
+ "required": [
888
+ "contextPackageId",
889
+ "contentDigest",
890
+ "schemaVersion",
891
+ "compilerVersion"
892
+ ],
893
+ "type": "object"
894
+ },
895
+ "outputContractRef": { "maxLength": 512, "minLength": 1, "type": "string" },
896
+ "policySnapshot": {
897
+ "properties": {
898
+ "contentDigest": { "pattern": "^sha256:[a-f0-9]{64}$", "type": "string" },
899
+ "policySnapshotId": {
900
+ "maxLength": 256,
901
+ "minLength": 1,
902
+ "type": "string"
903
+ },
904
+ "revision": {
905
+ "exclusiveMinimum": 0,
906
+ "maximum": 9007199254740991,
907
+ "type": "integer"
908
+ }
909
+ },
910
+ "required": ["policySnapshotId", "revision", "contentDigest"],
911
+ "type": "object"
912
+ },
913
+ "profileVersionId": {
914
+ "pattern": "^pfv_[0-9A-HJKMNP-TV-Z]{26}$",
915
+ "type": "string"
916
+ },
917
+ "projectState": {
918
+ "properties": {
919
+ "projectId": {
920
+ "pattern": "^prj_[0-9A-HJKMNP-TV-Z]{26}$",
921
+ "type": "string"
922
+ },
923
+ "revision": {
924
+ "maximum": 9007199254740991,
925
+ "minimum": 0,
926
+ "type": "integer"
927
+ },
928
+ "workspaceId": {
929
+ "pattern": "^wsp_[0-9A-HJKMNP-TV-Z]{26}$",
930
+ "type": "string"
931
+ }
932
+ },
933
+ "required": ["workspaceId", "projectId", "revision"],
934
+ "type": "object"
935
+ },
936
+ "runtimeRequirements": {
937
+ "items": {
938
+ "maxLength": 128,
939
+ "minLength": 1,
940
+ "pattern": "^[a-z][a-z0-9.-]*$",
941
+ "type": "string"
942
+ },
943
+ "maxItems": 128,
944
+ "type": "array"
945
+ },
946
+ "skillVersionIds": {
947
+ "items": { "pattern": "^skv_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
948
+ "maxItems": 128,
949
+ "type": "array"
950
+ },
951
+ "taskId": { "pattern": "^tsk_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
952
+ },
953
+ "required": [
954
+ "taskId",
955
+ "agentId",
956
+ "profileVersionId",
957
+ "skillVersionIds",
958
+ "projectState",
959
+ "contextPackage",
960
+ "policySnapshot",
961
+ "runtimeRequirements",
962
+ "outputContractRef"
963
+ ],
964
+ "type": "object"
965
+ },
966
+ "payloadHash": { "pattern": "^[a-f0-9]{64}$", "type": "string" },
967
+ "projectId": { "pattern": "^prj_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
968
+ "requestId": { "pattern": "^req_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
969
+ "workspaceId": { "pattern": "^wsp_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
970
+ },
971
+ "required": [
972
+ "caller",
973
+ "contractVersion",
974
+ "requestId",
975
+ "workspaceId",
976
+ "correlation",
977
+ "commandId",
978
+ "idempotencyKey",
979
+ "payloadHash",
980
+ "operation",
981
+ "issuedAt",
982
+ "payload"
983
+ ],
984
+ "type": "object"
985
+ }
986
+ }
987
+ },
988
+ "required": true
989
+ },
990
+ "responses": {
991
+ "200": {
992
+ "content": {
993
+ "application/json": {
994
+ "schema": {
995
+ "additionalProperties": false,
996
+ "properties": {
997
+ "contractVersion": {
998
+ "additionalProperties": false,
999
+ "properties": {
1000
+ "major": {
1001
+ "exclusiveMinimum": 0,
1002
+ "maximum": 9007199254740991,
1003
+ "type": "integer"
1004
+ },
1005
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
1006
+ },
1007
+ "required": ["major", "minor"],
1008
+ "type": "object"
1009
+ },
1010
+ "correlation": {
1011
+ "additionalProperties": false,
1012
+ "properties": {
1013
+ "causationCommandId": {},
1014
+ "parentEventId": {},
1015
+ "traceId": {}
1016
+ },
1017
+ "required": ["traceId"],
1018
+ "type": "object"
1019
+ },
1020
+ "data": {
1021
+ "additionalProperties": false,
1022
+ "properties": {
1023
+ "executionPlan": {
1024
+ "additionalProperties": false,
1025
+ "properties": {
1026
+ "contentDigest": {
1027
+ "pattern": "^sha256:[a-f0-9]{64}$",
1028
+ "type": "string"
1029
+ },
1030
+ "executionPlanId": {}
1031
+ },
1032
+ "required": ["executionPlanId", "contentDigest"],
1033
+ "type": "object"
1034
+ },
1035
+ "valid": { "const": true, "type": "boolean" }
1036
+ },
1037
+ "required": ["valid", "executionPlan"],
1038
+ "type": "object"
1039
+ },
1040
+ "requestId": {}
1041
+ },
1042
+ "required": ["contractVersion", "requestId", "correlation", "data"],
1043
+ "type": "object"
1044
+ }
1045
+ }
1046
+ },
1047
+ "description": "Successful response"
1048
+ },
1049
+ "default": {
1050
+ "content": {
1051
+ "application/json": {
1052
+ "schema": {
1053
+ "additionalProperties": false,
1054
+ "properties": {
1055
+ "contractVersion": {
1056
+ "additionalProperties": false,
1057
+ "properties": {
1058
+ "major": {
1059
+ "exclusiveMinimum": 0,
1060
+ "maximum": 9007199254740991,
1061
+ "type": "integer"
1062
+ },
1063
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
1064
+ },
1065
+ "required": ["major", "minor"],
1066
+ "type": "object"
1067
+ },
1068
+ "correlation": {
1069
+ "additionalProperties": false,
1070
+ "properties": {
1071
+ "causationCommandId": {},
1072
+ "parentEventId": {},
1073
+ "traceId": {}
1074
+ },
1075
+ "required": ["traceId"],
1076
+ "type": "object"
1077
+ },
1078
+ "error": {
1079
+ "additionalProperties": false,
1080
+ "properties": {
1081
+ "class": {
1082
+ "enum": [
1083
+ "validation",
1084
+ "authentication",
1085
+ "authorization",
1086
+ "conflict",
1087
+ "stale_reference",
1088
+ "capability_mismatch",
1089
+ "runtime_unavailable",
1090
+ "internal"
1091
+ ],
1092
+ "type": "string"
1093
+ },
1094
+ "code": {
1095
+ "maxLength": 96,
1096
+ "minLength": 1,
1097
+ "pattern": "^[A-Z][A-Z0-9_]*$",
1098
+ "type": "string"
1099
+ },
1100
+ "details": {
1101
+ "additionalProperties": {},
1102
+ "propertyNames": { "maxLength": 64, "type": "string" },
1103
+ "type": "object"
1104
+ },
1105
+ "message": { "maxLength": 512, "minLength": 1, "type": "string" },
1106
+ "remediation": { "maxLength": 256, "minLength": 1, "type": "string" },
1107
+ "retryable": { "type": "boolean" },
1108
+ "source": {
1109
+ "enum": [
1110
+ "client",
1111
+ "auth",
1112
+ "policy",
1113
+ "runtime",
1114
+ "provider",
1115
+ "persistence",
1116
+ "workflow",
1117
+ "system"
1118
+ ],
1119
+ "type": "string"
1120
+ }
1121
+ },
1122
+ "required": ["class", "code", "message", "retryable", "source"],
1123
+ "type": "object"
1124
+ },
1125
+ "requestId": {}
1126
+ },
1127
+ "required": ["contractVersion", "requestId", "correlation", "error"],
1128
+ "type": "object"
1129
+ }
1130
+ }
1131
+ },
1132
+ "description": "Normalized error response"
1133
+ }
1134
+ },
1135
+ "security": [{ "serviceBearer": [] }]
1136
+ }
1137
+ },
1138
+ "/v1/external-sessions/get": {
1139
+ "post": {
1140
+ "operationId": "external-session.get",
1141
+ "requestBody": {
1142
+ "content": {
1143
+ "application/json": {
1144
+ "schema": {
1145
+ "properties": {
1146
+ "caller": {
1147
+ "properties": {
1148
+ "servicePrincipalId": {
1149
+ "maxLength": 64,
1150
+ "minLength": 5,
1151
+ "pattern": "^svc_[a-z][a-z0-9-]*$",
1152
+ "type": "string"
1153
+ }
1154
+ },
1155
+ "required": ["servicePrincipalId"],
1156
+ "type": "object"
1157
+ },
1158
+ "contractVersion": {
1159
+ "additionalProperties": false,
1160
+ "properties": {
1161
+ "major": {
1162
+ "exclusiveMinimum": 0,
1163
+ "maximum": 9007199254740991,
1164
+ "type": "integer"
1165
+ },
1166
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
1167
+ },
1168
+ "required": ["major", "minor"],
1169
+ "type": "object"
1170
+ },
1171
+ "correlation": {
1172
+ "properties": {
1173
+ "causationCommandId": {
1174
+ "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$",
1175
+ "type": "string"
1176
+ },
1177
+ "parentEventId": {
1178
+ "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$",
1179
+ "type": "string"
1180
+ },
1181
+ "traceId": { "pattern": "^trc_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
1182
+ },
1183
+ "required": ["traceId"],
1184
+ "type": "object"
1185
+ },
1186
+ "operation": { "const": "external-session.get", "type": "string" },
1187
+ "parameters": {
1188
+ "properties": {
1189
+ "externalSessionId": {
1190
+ "pattern": "^ses_[0-9A-HJKMNP-TV-Z]{26}$",
1191
+ "type": "string"
1192
+ },
1193
+ "runtimeNodeRefId": {
1194
+ "pattern": "^rnr_[0-9A-HJKMNP-TV-Z]{26}$",
1195
+ "type": "string"
1196
+ }
1197
+ },
1198
+ "required": ["externalSessionId"],
1199
+ "type": "object"
1200
+ },
1201
+ "projectId": { "pattern": "^prj_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
1202
+ "requestedAt": {
1203
+ "format": "date-time",
1204
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
1205
+ "type": "string"
1206
+ },
1207
+ "requestId": { "pattern": "^req_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
1208
+ "workspaceId": { "pattern": "^wsp_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
1209
+ },
1210
+ "required": [
1211
+ "caller",
1212
+ "contractVersion",
1213
+ "requestId",
1214
+ "workspaceId",
1215
+ "correlation",
1216
+ "requestedAt",
1217
+ "operation",
1218
+ "parameters"
1219
+ ],
1220
+ "type": "object"
1221
+ }
1222
+ }
1223
+ },
1224
+ "required": true
1225
+ },
1226
+ "responses": {
1227
+ "200": {
1228
+ "content": {
1229
+ "application/json": {
1230
+ "schema": {
1231
+ "additionalProperties": false,
1232
+ "properties": {
1233
+ "contractVersion": {
1234
+ "additionalProperties": false,
1235
+ "properties": {
1236
+ "major": {
1237
+ "exclusiveMinimum": 0,
1238
+ "maximum": 9007199254740991,
1239
+ "type": "integer"
1240
+ },
1241
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
1242
+ },
1243
+ "required": ["major", "minor"],
1244
+ "type": "object"
1245
+ },
1246
+ "correlation": {
1247
+ "additionalProperties": false,
1248
+ "properties": {
1249
+ "causationCommandId": {},
1250
+ "parentEventId": {},
1251
+ "traceId": {}
1252
+ },
1253
+ "required": ["traceId"],
1254
+ "type": "object"
1255
+ },
1256
+ "data": {
1257
+ "additionalProperties": false,
1258
+ "properties": {
1259
+ "externalSession": {
1260
+ "additionalProperties": false,
1261
+ "properties": {
1262
+ "capabilitySummary": {
1263
+ "additionalProperties": false,
1264
+ "properties": {
1265
+ "controls": {
1266
+ "additionalProperties": false,
1267
+ "properties": {
1268
+ "close": {
1269
+ "anyOf": [
1270
+ {
1271
+ "additionalProperties": false,
1272
+ "properties": {
1273
+ "available": { "const": true, "type": "boolean" }
1274
+ },
1275
+ "required": ["available"],
1276
+ "type": "object"
1277
+ },
1278
+ {
1279
+ "additionalProperties": false,
1280
+ "properties": {
1281
+ "available": { "const": false, "type": "boolean" },
1282
+ "reason": {
1283
+ "maxLength": 128,
1284
+ "minLength": 1,
1285
+ "pattern": "^[A-Z][A-Z0-9_]*$",
1286
+ "type": "string"
1287
+ }
1288
+ },
1289
+ "required": ["available", "reason"],
1290
+ "type": "object"
1291
+ }
1292
+ ]
1293
+ },
1294
+ "history": {
1295
+ "anyOf": [
1296
+ {
1297
+ "additionalProperties": false,
1298
+ "properties": {
1299
+ "available": { "const": true, "type": "boolean" }
1300
+ },
1301
+ "required": ["available"],
1302
+ "type": "object"
1303
+ },
1304
+ {
1305
+ "additionalProperties": false,
1306
+ "properties": {
1307
+ "available": { "const": false, "type": "boolean" },
1308
+ "reason": {
1309
+ "maxLength": 128,
1310
+ "minLength": 1,
1311
+ "pattern": "^[A-Z][A-Z0-9_]*$",
1312
+ "type": "string"
1313
+ }
1314
+ },
1315
+ "required": ["available", "reason"],
1316
+ "type": "object"
1317
+ }
1318
+ ]
1319
+ },
1320
+ "load": {
1321
+ "anyOf": [
1322
+ {
1323
+ "additionalProperties": false,
1324
+ "properties": {
1325
+ "available": { "const": true, "type": "boolean" }
1326
+ },
1327
+ "required": ["available"],
1328
+ "type": "object"
1329
+ },
1330
+ {
1331
+ "additionalProperties": false,
1332
+ "properties": {
1333
+ "available": { "const": false, "type": "boolean" },
1334
+ "reason": {
1335
+ "maxLength": 128,
1336
+ "minLength": 1,
1337
+ "pattern": "^[A-Z][A-Z0-9_]*$",
1338
+ "type": "string"
1339
+ }
1340
+ },
1341
+ "required": ["available", "reason"],
1342
+ "type": "object"
1343
+ }
1344
+ ]
1345
+ },
1346
+ "reference": {
1347
+ "anyOf": [
1348
+ {
1349
+ "additionalProperties": false,
1350
+ "properties": {
1351
+ "available": { "const": true, "type": "boolean" }
1352
+ },
1353
+ "required": ["available"],
1354
+ "type": "object"
1355
+ },
1356
+ {
1357
+ "additionalProperties": false,
1358
+ "properties": {
1359
+ "available": { "const": false, "type": "boolean" },
1360
+ "reason": {
1361
+ "maxLength": 128,
1362
+ "minLength": 1,
1363
+ "pattern": "^[A-Z][A-Z0-9_]*$",
1364
+ "type": "string"
1365
+ }
1366
+ },
1367
+ "required": ["available", "reason"],
1368
+ "type": "object"
1369
+ }
1370
+ ]
1371
+ },
1372
+ "resume": {
1373
+ "anyOf": [
1374
+ {
1375
+ "additionalProperties": false,
1376
+ "properties": {
1377
+ "available": { "const": true, "type": "boolean" }
1378
+ },
1379
+ "required": ["available"],
1380
+ "type": "object"
1381
+ },
1382
+ {
1383
+ "additionalProperties": false,
1384
+ "properties": {
1385
+ "available": { "const": false, "type": "boolean" },
1386
+ "reason": {
1387
+ "maxLength": 128,
1388
+ "minLength": 1,
1389
+ "pattern": "^[A-Z][A-Z0-9_]*$",
1390
+ "type": "string"
1391
+ }
1392
+ },
1393
+ "required": ["available", "reason"],
1394
+ "type": "object"
1395
+ }
1396
+ ]
1397
+ }
1398
+ },
1399
+ "required": ["reference", "resume", "load", "close", "history"],
1400
+ "type": "object"
1401
+ },
1402
+ "operations": {
1403
+ "items": {
1404
+ "maxLength": 128,
1405
+ "minLength": 1,
1406
+ "pattern": "^[a-z][a-z0-9.-]*$",
1407
+ "type": "string"
1408
+ },
1409
+ "maxItems": 16,
1410
+ "type": "array"
1411
+ },
1412
+ "version": {
1413
+ "exclusiveMinimum": 0,
1414
+ "maximum": 9007199254740991,
1415
+ "type": "integer"
1416
+ }
1417
+ },
1418
+ "required": ["version", "operations", "controls"],
1419
+ "type": "object"
1420
+ },
1421
+ "display": {
1422
+ "additionalProperties": false,
1423
+ "properties": {
1424
+ "displayName": {
1425
+ "maxLength": 128,
1426
+ "minLength": 1,
1427
+ "type": "string"
1428
+ },
1429
+ "origin": {
1430
+ "enum": ["native_discovery", "created_through_control_plane"],
1431
+ "type": "string"
1432
+ }
1433
+ },
1434
+ "required": ["origin"],
1435
+ "type": "object"
1436
+ },
1437
+ "externalSessionId": {},
1438
+ "freshness": {
1439
+ "additionalProperties": false,
1440
+ "properties": {
1441
+ "expiresAt": {
1442
+ "format": "date-time",
1443
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
1444
+ "type": "string"
1445
+ },
1446
+ "observedAt": {
1447
+ "format": "date-time",
1448
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
1449
+ "type": "string"
1450
+ },
1451
+ "state": {
1452
+ "enum": ["fresh", "stale", "expired", "unknown"],
1453
+ "type": "string"
1454
+ }
1455
+ },
1456
+ "required": ["state", "observedAt"],
1457
+ "type": "object"
1458
+ },
1459
+ "limitations": {
1460
+ "items": {
1461
+ "maxLength": 128,
1462
+ "minLength": 1,
1463
+ "pattern": "^[A-Z][A-Z0-9_]*$",
1464
+ "type": "string"
1465
+ },
1466
+ "maxItems": 64,
1467
+ "type": "array"
1468
+ },
1469
+ "projectId": {},
1470
+ "recoverable": { "type": "boolean" },
1471
+ "runtimeConnectionId": {},
1472
+ "state": {
1473
+ "enum": [
1474
+ "active",
1475
+ "closed",
1476
+ "stale",
1477
+ "offline",
1478
+ "runtime_missing",
1479
+ "capability_changed",
1480
+ "removed",
1481
+ "revoked"
1482
+ ],
1483
+ "type": "string"
1484
+ }
1485
+ },
1486
+ "required": [
1487
+ "externalSessionId",
1488
+ "runtimeConnectionId",
1489
+ "state",
1490
+ "recoverable",
1491
+ "display",
1492
+ "freshness",
1493
+ "capabilitySummary",
1494
+ "limitations"
1495
+ ],
1496
+ "type": "object"
1497
+ }
1498
+ },
1499
+ "required": ["externalSession"],
1500
+ "type": "object"
1501
+ },
1502
+ "requestId": {}
1503
+ },
1504
+ "required": ["contractVersion", "requestId", "correlation", "data"],
1505
+ "type": "object"
1506
+ }
1507
+ }
1508
+ },
1509
+ "description": "Successful response"
1510
+ },
1511
+ "default": {
1512
+ "content": {
1513
+ "application/json": {
1514
+ "schema": {
1515
+ "additionalProperties": false,
1516
+ "properties": {
1517
+ "contractVersion": {
1518
+ "additionalProperties": false,
1519
+ "properties": {
1520
+ "major": {
1521
+ "exclusiveMinimum": 0,
1522
+ "maximum": 9007199254740991,
1523
+ "type": "integer"
1524
+ },
1525
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
1526
+ },
1527
+ "required": ["major", "minor"],
1528
+ "type": "object"
1529
+ },
1530
+ "correlation": {
1531
+ "additionalProperties": false,
1532
+ "properties": {
1533
+ "causationCommandId": {},
1534
+ "parentEventId": {},
1535
+ "traceId": {}
1536
+ },
1537
+ "required": ["traceId"],
1538
+ "type": "object"
1539
+ },
1540
+ "error": {
1541
+ "additionalProperties": false,
1542
+ "properties": {
1543
+ "class": {
1544
+ "enum": [
1545
+ "validation",
1546
+ "authentication",
1547
+ "authorization",
1548
+ "conflict",
1549
+ "stale_reference",
1550
+ "capability_mismatch",
1551
+ "runtime_unavailable",
1552
+ "internal"
1553
+ ],
1554
+ "type": "string"
1555
+ },
1556
+ "code": {
1557
+ "maxLength": 96,
1558
+ "minLength": 1,
1559
+ "pattern": "^[A-Z][A-Z0-9_]*$",
1560
+ "type": "string"
1561
+ },
1562
+ "details": {
1563
+ "additionalProperties": {},
1564
+ "propertyNames": { "maxLength": 64, "type": "string" },
1565
+ "type": "object"
1566
+ },
1567
+ "message": { "maxLength": 512, "minLength": 1, "type": "string" },
1568
+ "remediation": { "maxLength": 256, "minLength": 1, "type": "string" },
1569
+ "retryable": { "type": "boolean" },
1570
+ "source": {
1571
+ "enum": [
1572
+ "client",
1573
+ "auth",
1574
+ "policy",
1575
+ "runtime",
1576
+ "provider",
1577
+ "persistence",
1578
+ "workflow",
1579
+ "system"
1580
+ ],
1581
+ "type": "string"
1582
+ }
1583
+ },
1584
+ "required": ["class", "code", "message", "retryable", "source"],
1585
+ "type": "object"
1586
+ },
1587
+ "requestId": {}
1588
+ },
1589
+ "required": ["contractVersion", "requestId", "correlation", "error"],
1590
+ "type": "object"
1591
+ }
1592
+ }
1593
+ },
1594
+ "description": "Normalized error response"
1595
+ }
1596
+ },
1597
+ "security": [{ "serviceBearer": [] }]
1598
+ }
1599
+ },
1600
+ "/v1/external-sessions/list": {
1601
+ "post": {
1602
+ "operationId": "external-session.list",
1603
+ "requestBody": {
1604
+ "content": {
1605
+ "application/json": {
1606
+ "schema": {
1607
+ "properties": {
1608
+ "caller": {
1609
+ "properties": {
1610
+ "servicePrincipalId": {
1611
+ "maxLength": 64,
1612
+ "minLength": 5,
1613
+ "pattern": "^svc_[a-z][a-z0-9-]*$",
1614
+ "type": "string"
1615
+ }
1616
+ },
1617
+ "required": ["servicePrincipalId"],
1618
+ "type": "object"
1619
+ },
1620
+ "contractVersion": {
1621
+ "additionalProperties": false,
1622
+ "properties": {
1623
+ "major": {
1624
+ "exclusiveMinimum": 0,
1625
+ "maximum": 9007199254740991,
1626
+ "type": "integer"
1627
+ },
1628
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
1629
+ },
1630
+ "required": ["major", "minor"],
1631
+ "type": "object"
1632
+ },
1633
+ "correlation": {
1634
+ "properties": {
1635
+ "causationCommandId": {
1636
+ "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$",
1637
+ "type": "string"
1638
+ },
1639
+ "parentEventId": {
1640
+ "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$",
1641
+ "type": "string"
1642
+ },
1643
+ "traceId": { "pattern": "^trc_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
1644
+ },
1645
+ "required": ["traceId"],
1646
+ "type": "object"
1647
+ },
1648
+ "operation": { "const": "external-session.list", "type": "string" },
1649
+ "parameters": {
1650
+ "properties": {
1651
+ "cursor": {
1652
+ "maxLength": 512,
1653
+ "minLength": 8,
1654
+ "pattern": "^cur_[A-Za-z0-9_-]+$",
1655
+ "type": "string"
1656
+ },
1657
+ "limit": { "default": 50, "maximum": 100, "minimum": 1, "type": "integer" },
1658
+ "runtimeConnectionId": {
1659
+ "pattern": "^rtc_[0-9A-HJKMNP-TV-Z]{26}$",
1660
+ "type": "string"
1661
+ },
1662
+ "runtimeNodeRefId": {
1663
+ "pattern": "^rnr_[0-9A-HJKMNP-TV-Z]{26}$",
1664
+ "type": "string"
1665
+ },
1666
+ "states": {
1667
+ "default": [],
1668
+ "items": {
1669
+ "enum": [
1670
+ "active",
1671
+ "closed",
1672
+ "stale",
1673
+ "offline",
1674
+ "runtime_missing",
1675
+ "capability_changed",
1676
+ "removed",
1677
+ "revoked"
1678
+ ],
1679
+ "type": "string"
1680
+ },
1681
+ "maxItems": 8,
1682
+ "type": "array"
1683
+ }
1684
+ },
1685
+ "type": "object"
1686
+ },
1687
+ "projectId": { "pattern": "^prj_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
1688
+ "requestedAt": {
1689
+ "format": "date-time",
1690
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
1691
+ "type": "string"
1692
+ },
1693
+ "requestId": { "pattern": "^req_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
1694
+ "workspaceId": { "pattern": "^wsp_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
1695
+ },
1696
+ "required": [
1697
+ "caller",
1698
+ "contractVersion",
1699
+ "requestId",
1700
+ "workspaceId",
1701
+ "correlation",
1702
+ "requestedAt",
1703
+ "operation",
1704
+ "parameters"
1705
+ ],
1706
+ "type": "object"
1707
+ }
1708
+ }
1709
+ },
1710
+ "required": true
1711
+ },
1712
+ "responses": {
1713
+ "200": {
1714
+ "content": {
1715
+ "application/json": {
1716
+ "schema": {
1717
+ "additionalProperties": false,
1718
+ "properties": {
1719
+ "contractVersion": {
1720
+ "additionalProperties": false,
1721
+ "properties": {
1722
+ "major": {
1723
+ "exclusiveMinimum": 0,
1724
+ "maximum": 9007199254740991,
1725
+ "type": "integer"
1726
+ },
1727
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
1728
+ },
1729
+ "required": ["major", "minor"],
1730
+ "type": "object"
1731
+ },
1732
+ "correlation": {
1733
+ "additionalProperties": false,
1734
+ "properties": {
1735
+ "causationCommandId": {},
1736
+ "parentEventId": {},
1737
+ "traceId": {}
1738
+ },
1739
+ "required": ["traceId"],
1740
+ "type": "object"
1741
+ },
1742
+ "data": {
1743
+ "additionalProperties": false,
1744
+ "properties": {
1745
+ "externalSessions": {
1746
+ "items": {
1747
+ "additionalProperties": false,
1748
+ "properties": {
1749
+ "capabilitySummary": {
1750
+ "additionalProperties": false,
1751
+ "properties": {
1752
+ "controls": {
1753
+ "additionalProperties": false,
1754
+ "properties": {
1755
+ "close": {
1756
+ "anyOf": [
1757
+ {
1758
+ "additionalProperties": false,
1759
+ "properties": {
1760
+ "available": { "const": true, "type": "boolean" }
1761
+ },
1762
+ "required": ["available"],
1763
+ "type": "object"
1764
+ },
1765
+ {
1766
+ "additionalProperties": false,
1767
+ "properties": {
1768
+ "available": { "const": false, "type": "boolean" },
1769
+ "reason": {
1770
+ "maxLength": 128,
1771
+ "minLength": 1,
1772
+ "pattern": "^[A-Z][A-Z0-9_]*$",
1773
+ "type": "string"
1774
+ }
1775
+ },
1776
+ "required": ["available", "reason"],
1777
+ "type": "object"
1778
+ }
1779
+ ]
1780
+ },
1781
+ "history": {
1782
+ "anyOf": [
1783
+ {
1784
+ "additionalProperties": false,
1785
+ "properties": {
1786
+ "available": { "const": true, "type": "boolean" }
1787
+ },
1788
+ "required": ["available"],
1789
+ "type": "object"
1790
+ },
1791
+ {
1792
+ "additionalProperties": false,
1793
+ "properties": {
1794
+ "available": { "const": false, "type": "boolean" },
1795
+ "reason": {
1796
+ "maxLength": 128,
1797
+ "minLength": 1,
1798
+ "pattern": "^[A-Z][A-Z0-9_]*$",
1799
+ "type": "string"
1800
+ }
1801
+ },
1802
+ "required": ["available", "reason"],
1803
+ "type": "object"
1804
+ }
1805
+ ]
1806
+ },
1807
+ "load": {
1808
+ "anyOf": [
1809
+ {
1810
+ "additionalProperties": false,
1811
+ "properties": {
1812
+ "available": { "const": true, "type": "boolean" }
1813
+ },
1814
+ "required": ["available"],
1815
+ "type": "object"
1816
+ },
1817
+ {
1818
+ "additionalProperties": false,
1819
+ "properties": {
1820
+ "available": { "const": false, "type": "boolean" },
1821
+ "reason": {
1822
+ "maxLength": 128,
1823
+ "minLength": 1,
1824
+ "pattern": "^[A-Z][A-Z0-9_]*$",
1825
+ "type": "string"
1826
+ }
1827
+ },
1828
+ "required": ["available", "reason"],
1829
+ "type": "object"
1830
+ }
1831
+ ]
1832
+ },
1833
+ "reference": {
1834
+ "anyOf": [
1835
+ {
1836
+ "additionalProperties": false,
1837
+ "properties": {
1838
+ "available": { "const": true, "type": "boolean" }
1839
+ },
1840
+ "required": ["available"],
1841
+ "type": "object"
1842
+ },
1843
+ {
1844
+ "additionalProperties": false,
1845
+ "properties": {
1846
+ "available": { "const": false, "type": "boolean" },
1847
+ "reason": {
1848
+ "maxLength": 128,
1849
+ "minLength": 1,
1850
+ "pattern": "^[A-Z][A-Z0-9_]*$",
1851
+ "type": "string"
1852
+ }
1853
+ },
1854
+ "required": ["available", "reason"],
1855
+ "type": "object"
1856
+ }
1857
+ ]
1858
+ },
1859
+ "resume": {
1860
+ "anyOf": [
1861
+ {
1862
+ "additionalProperties": false,
1863
+ "properties": {
1864
+ "available": { "const": true, "type": "boolean" }
1865
+ },
1866
+ "required": ["available"],
1867
+ "type": "object"
1868
+ },
1869
+ {
1870
+ "additionalProperties": false,
1871
+ "properties": {
1872
+ "available": { "const": false, "type": "boolean" },
1873
+ "reason": {
1874
+ "maxLength": 128,
1875
+ "minLength": 1,
1876
+ "pattern": "^[A-Z][A-Z0-9_]*$",
1877
+ "type": "string"
1878
+ }
1879
+ },
1880
+ "required": ["available", "reason"],
1881
+ "type": "object"
1882
+ }
1883
+ ]
1884
+ }
1885
+ },
1886
+ "required": ["reference", "resume", "load", "close", "history"],
1887
+ "type": "object"
1888
+ },
1889
+ "operations": {
1890
+ "items": {
1891
+ "maxLength": 128,
1892
+ "minLength": 1,
1893
+ "pattern": "^[a-z][a-z0-9.-]*$",
1894
+ "type": "string"
1895
+ },
1896
+ "maxItems": 16,
1897
+ "type": "array"
1898
+ },
1899
+ "version": {
1900
+ "exclusiveMinimum": 0,
1901
+ "maximum": 9007199254740991,
1902
+ "type": "integer"
1903
+ }
1904
+ },
1905
+ "required": ["version", "operations", "controls"],
1906
+ "type": "object"
1907
+ },
1908
+ "display": {
1909
+ "additionalProperties": false,
1910
+ "properties": {
1911
+ "displayName": {
1912
+ "maxLength": 128,
1913
+ "minLength": 1,
1914
+ "type": "string"
1915
+ },
1916
+ "origin": {
1917
+ "enum": ["native_discovery", "created_through_control_plane"],
1918
+ "type": "string"
1919
+ }
1920
+ },
1921
+ "required": ["origin"],
1922
+ "type": "object"
1923
+ },
1924
+ "externalSessionId": {},
1925
+ "freshness": {
1926
+ "additionalProperties": false,
1927
+ "properties": {
1928
+ "expiresAt": {
1929
+ "format": "date-time",
1930
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
1931
+ "type": "string"
1932
+ },
1933
+ "observedAt": {
1934
+ "format": "date-time",
1935
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
1936
+ "type": "string"
1937
+ },
1938
+ "state": {
1939
+ "enum": ["fresh", "stale", "expired", "unknown"],
1940
+ "type": "string"
1941
+ }
1942
+ },
1943
+ "required": ["state", "observedAt"],
1944
+ "type": "object"
1945
+ },
1946
+ "limitations": {
1947
+ "items": {
1948
+ "maxLength": 128,
1949
+ "minLength": 1,
1950
+ "pattern": "^[A-Z][A-Z0-9_]*$",
1951
+ "type": "string"
1952
+ },
1953
+ "maxItems": 64,
1954
+ "type": "array"
1955
+ },
1956
+ "projectId": {},
1957
+ "recoverable": { "type": "boolean" },
1958
+ "runtimeConnectionId": {},
1959
+ "state": {
1960
+ "enum": [
1961
+ "active",
1962
+ "closed",
1963
+ "stale",
1964
+ "offline",
1965
+ "runtime_missing",
1966
+ "capability_changed",
1967
+ "removed",
1968
+ "revoked"
1969
+ ],
1970
+ "type": "string"
1971
+ }
1972
+ },
1973
+ "required": [
1974
+ "externalSessionId",
1975
+ "runtimeConnectionId",
1976
+ "state",
1977
+ "recoverable",
1978
+ "display",
1979
+ "freshness",
1980
+ "capabilitySummary",
1981
+ "limitations"
1982
+ ],
1983
+ "type": "object"
1984
+ },
1985
+ "maxItems": 100,
1986
+ "type": "array"
1987
+ },
1988
+ "page": {
1989
+ "additionalProperties": false,
1990
+ "properties": {
1991
+ "nextCursor": {
1992
+ "maxLength": 512,
1993
+ "minLength": 8,
1994
+ "pattern": "^cur_[A-Za-z0-9_-]+$",
1995
+ "type": "string"
1996
+ }
1997
+ },
1998
+ "type": "object"
1999
+ }
2000
+ },
2001
+ "required": ["externalSessions", "page"],
2002
+ "type": "object"
2003
+ },
2004
+ "requestId": {}
2005
+ },
2006
+ "required": ["contractVersion", "requestId", "correlation", "data"],
2007
+ "type": "object"
2008
+ }
2009
+ }
2010
+ },
2011
+ "description": "Successful response"
2012
+ },
2013
+ "default": {
2014
+ "content": {
2015
+ "application/json": {
2016
+ "schema": {
2017
+ "additionalProperties": false,
2018
+ "properties": {
2019
+ "contractVersion": {
2020
+ "additionalProperties": false,
2021
+ "properties": {
2022
+ "major": {
2023
+ "exclusiveMinimum": 0,
2024
+ "maximum": 9007199254740991,
2025
+ "type": "integer"
2026
+ },
2027
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
2028
+ },
2029
+ "required": ["major", "minor"],
2030
+ "type": "object"
2031
+ },
2032
+ "correlation": {
2033
+ "additionalProperties": false,
2034
+ "properties": {
2035
+ "causationCommandId": {},
2036
+ "parentEventId": {},
2037
+ "traceId": {}
2038
+ },
2039
+ "required": ["traceId"],
2040
+ "type": "object"
2041
+ },
2042
+ "error": {
2043
+ "additionalProperties": false,
2044
+ "properties": {
2045
+ "class": {
2046
+ "enum": [
2047
+ "validation",
2048
+ "authentication",
2049
+ "authorization",
2050
+ "conflict",
2051
+ "stale_reference",
2052
+ "capability_mismatch",
2053
+ "runtime_unavailable",
2054
+ "internal"
2055
+ ],
2056
+ "type": "string"
2057
+ },
2058
+ "code": {
2059
+ "maxLength": 96,
2060
+ "minLength": 1,
2061
+ "pattern": "^[A-Z][A-Z0-9_]*$",
2062
+ "type": "string"
2063
+ },
2064
+ "details": {
2065
+ "additionalProperties": {},
2066
+ "propertyNames": { "maxLength": 64, "type": "string" },
2067
+ "type": "object"
2068
+ },
2069
+ "message": { "maxLength": 512, "minLength": 1, "type": "string" },
2070
+ "remediation": { "maxLength": 256, "minLength": 1, "type": "string" },
2071
+ "retryable": { "type": "boolean" },
2072
+ "source": {
2073
+ "enum": [
2074
+ "client",
2075
+ "auth",
2076
+ "policy",
2077
+ "runtime",
2078
+ "provider",
2079
+ "persistence",
2080
+ "workflow",
2081
+ "system"
2082
+ ],
2083
+ "type": "string"
2084
+ }
2085
+ },
2086
+ "required": ["class", "code", "message", "retryable", "source"],
2087
+ "type": "object"
2088
+ },
2089
+ "requestId": {}
2090
+ },
2091
+ "required": ["contractVersion", "requestId", "correlation", "error"],
2092
+ "type": "object"
2093
+ }
2094
+ }
2095
+ },
2096
+ "description": "Normalized error response"
2097
+ }
2098
+ },
2099
+ "security": [{ "serviceBearer": [] }]
2100
+ }
2101
+ },
2102
+ "/v1/marketplace/catalog": {
2103
+ "post": {
2104
+ "operationId": "marketplace.catalog.read",
2105
+ "requestBody": {
2106
+ "content": {
2107
+ "application/json": {
2108
+ "schema": {
2109
+ "properties": {
2110
+ "caller": {
2111
+ "properties": {
2112
+ "servicePrincipalId": {
2113
+ "maxLength": 64,
2114
+ "minLength": 5,
2115
+ "pattern": "^svc_[a-z][a-z0-9-]*$",
2116
+ "type": "string"
2117
+ }
2118
+ },
2119
+ "required": ["servicePrincipalId"],
2120
+ "type": "object"
2121
+ },
2122
+ "contractVersion": {
2123
+ "additionalProperties": false,
2124
+ "properties": {
2125
+ "major": {
2126
+ "exclusiveMinimum": 0,
2127
+ "maximum": 9007199254740991,
2128
+ "type": "integer"
2129
+ },
2130
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
2131
+ },
2132
+ "required": ["major", "minor"],
2133
+ "type": "object"
2134
+ },
2135
+ "correlation": {
2136
+ "properties": {
2137
+ "causationCommandId": {
2138
+ "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$",
2139
+ "type": "string"
2140
+ },
2141
+ "parentEventId": {
2142
+ "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$",
2143
+ "type": "string"
2144
+ },
2145
+ "traceId": { "pattern": "^trc_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
2146
+ },
2147
+ "required": ["traceId"],
2148
+ "type": "object"
2149
+ },
2150
+ "operation": { "const": "marketplace.catalog.read", "type": "string" },
2151
+ "parameters": {
2152
+ "properties": {
2153
+ "workspaceIdentity": {
2154
+ "properties": {
2155
+ "userId": { "maxLength": 128, "minLength": 1, "type": "string" },
2156
+ "workspaceId": { "maxLength": 128, "minLength": 1, "type": "string" }
2157
+ },
2158
+ "required": ["workspaceId", "userId"],
2159
+ "type": "object"
2160
+ }
2161
+ },
2162
+ "required": ["workspaceIdentity"],
2163
+ "type": "object"
2164
+ },
2165
+ "projectId": { "pattern": "^prj_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
2166
+ "requestedAt": {
2167
+ "format": "date-time",
2168
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
2169
+ "type": "string"
2170
+ },
2171
+ "requestId": { "pattern": "^req_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
2172
+ "workspaceId": { "pattern": "^wsp_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
2173
+ },
2174
+ "required": [
2175
+ "caller",
2176
+ "contractVersion",
2177
+ "requestId",
2178
+ "workspaceId",
2179
+ "correlation",
2180
+ "operation",
2181
+ "requestedAt",
2182
+ "parameters"
2183
+ ],
2184
+ "type": "object"
2185
+ }
2186
+ }
2187
+ },
2188
+ "required": true
2189
+ },
2190
+ "responses": {
2191
+ "200": {
2192
+ "content": {
2193
+ "application/json": {
2194
+ "schema": {
2195
+ "additionalProperties": false,
2196
+ "properties": {
2197
+ "contractVersion": {
2198
+ "additionalProperties": false,
2199
+ "properties": {
2200
+ "major": {
2201
+ "exclusiveMinimum": 0,
2202
+ "maximum": 9007199254740991,
2203
+ "type": "integer"
2204
+ },
2205
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
2206
+ },
2207
+ "required": ["major", "minor"],
2208
+ "type": "object"
2209
+ },
2210
+ "correlation": {
2211
+ "additionalProperties": false,
2212
+ "properties": {
2213
+ "causationCommandId": {},
2214
+ "parentEventId": {},
2215
+ "traceId": {}
2216
+ },
2217
+ "required": ["traceId"],
2218
+ "type": "object"
2219
+ },
2220
+ "data": {
2221
+ "additionalProperties": false,
2222
+ "properties": {
2223
+ "artifacts": {
2224
+ "additionalProperties": false,
2225
+ "properties": {
2226
+ "catalog-latest.v1.json": { "type": "string" },
2227
+ "catalog-summary.v1.json": { "type": "string" },
2228
+ "catalog.v1.json": { "type": "string" },
2229
+ "categories.v1.json": { "type": "string" },
2230
+ "compatibility.v1.json": { "type": "string" },
2231
+ "integrity.json": { "type": "string" },
2232
+ "sources.lock.json": { "type": "string" }
2233
+ },
2234
+ "required": [
2235
+ "catalog.v1.json",
2236
+ "catalog-latest.v1.json",
2237
+ "catalog-summary.v1.json",
2238
+ "categories.v1.json",
2239
+ "compatibility.v1.json",
2240
+ "integrity.json",
2241
+ "sources.lock.json"
2242
+ ],
2243
+ "type": "object"
2244
+ },
2245
+ "catalogId": { "pattern": "^catalog:[a-f0-9]{64}$", "type": "string" },
2246
+ "installations": {
2247
+ "items": {
2248
+ "additionalProperties": false,
2249
+ "properties": {
2250
+ "canonicalContentDigest": {
2251
+ "pattern": "^sha256:[a-f0-9]{64}$",
2252
+ "type": "string"
2253
+ },
2254
+ "pluginId": {
2255
+ "pattern": "^plugin:[a-z0-9-]+:[a-z0-9][a-z0-9-]{1,127}$",
2256
+ "type": "string"
2257
+ },
2258
+ "releaseId": {
2259
+ "pattern": "^release:[a-f0-9]{64}$",
2260
+ "type": "string"
2261
+ },
2262
+ "state": {
2263
+ "enum": [
2264
+ "pending-authorization",
2265
+ "unavailable",
2266
+ "rejected-by-policy",
2267
+ "installed",
2268
+ "superseded"
2269
+ ],
2270
+ "type": "string"
2271
+ }
2272
+ },
2273
+ "required": [
2274
+ "pluginId",
2275
+ "releaseId",
2276
+ "canonicalContentDigest",
2277
+ "state"
2278
+ ],
2279
+ "type": "object"
2280
+ },
2281
+ "type": "array"
2282
+ },
2283
+ "releaseId": { "pattern": "^catalog:[a-f0-9]{64}$", "type": "string" },
2284
+ "state": { "enum": ["ready", "stale"], "type": "string" }
2285
+ },
2286
+ "required": ["catalogId", "releaseId", "state", "artifacts", "installations"],
2287
+ "type": "object"
2288
+ },
2289
+ "requestId": {}
2290
+ },
2291
+ "required": ["contractVersion", "requestId", "correlation", "data"],
2292
+ "type": "object"
2293
+ }
2294
+ }
2295
+ },
2296
+ "description": "Successful response"
2297
+ },
2298
+ "default": {
2299
+ "content": {
2300
+ "application/json": {
2301
+ "schema": {
2302
+ "additionalProperties": false,
2303
+ "properties": {
2304
+ "contractVersion": {
2305
+ "additionalProperties": false,
2306
+ "properties": {
2307
+ "major": {
2308
+ "exclusiveMinimum": 0,
2309
+ "maximum": 9007199254740991,
2310
+ "type": "integer"
2311
+ },
2312
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
2313
+ },
2314
+ "required": ["major", "minor"],
2315
+ "type": "object"
2316
+ },
2317
+ "correlation": {
2318
+ "additionalProperties": false,
2319
+ "properties": {
2320
+ "causationCommandId": {},
2321
+ "parentEventId": {},
2322
+ "traceId": {}
2323
+ },
2324
+ "required": ["traceId"],
2325
+ "type": "object"
2326
+ },
2327
+ "error": {
2328
+ "additionalProperties": false,
2329
+ "properties": {
2330
+ "class": {
2331
+ "enum": [
2332
+ "validation",
2333
+ "authentication",
2334
+ "authorization",
2335
+ "conflict",
2336
+ "stale_reference",
2337
+ "capability_mismatch",
2338
+ "runtime_unavailable",
2339
+ "internal"
2340
+ ],
2341
+ "type": "string"
2342
+ },
2343
+ "code": {
2344
+ "maxLength": 96,
2345
+ "minLength": 1,
2346
+ "pattern": "^[A-Z][A-Z0-9_]*$",
2347
+ "type": "string"
2348
+ },
2349
+ "details": {
2350
+ "additionalProperties": {},
2351
+ "propertyNames": { "maxLength": 64, "type": "string" },
2352
+ "type": "object"
2353
+ },
2354
+ "message": { "maxLength": 512, "minLength": 1, "type": "string" },
2355
+ "remediation": { "maxLength": 256, "minLength": 1, "type": "string" },
2356
+ "retryable": { "type": "boolean" },
2357
+ "source": {
2358
+ "enum": [
2359
+ "client",
2360
+ "auth",
2361
+ "policy",
2362
+ "runtime",
2363
+ "provider",
2364
+ "persistence",
2365
+ "workflow",
2366
+ "system"
2367
+ ],
2368
+ "type": "string"
2369
+ }
2370
+ },
2371
+ "required": ["class", "code", "message", "retryable", "source"],
2372
+ "type": "object"
2373
+ },
2374
+ "requestId": {}
2375
+ },
2376
+ "required": ["contractVersion", "requestId", "correlation", "error"],
2377
+ "type": "object"
2378
+ }
2379
+ }
2380
+ },
2381
+ "description": "Normalized error response"
2382
+ }
2383
+ },
2384
+ "security": [{ "serviceBearer": [] }]
2385
+ }
2386
+ },
2387
+ "/v1/marketplace/install": {
2388
+ "post": {
2389
+ "operationId": "marketplace.install.request",
2390
+ "requestBody": {
2391
+ "content": {
2392
+ "application/json": {
2393
+ "schema": {
2394
+ "properties": {
2395
+ "caller": {
2396
+ "properties": {
2397
+ "servicePrincipalId": {
2398
+ "maxLength": 64,
2399
+ "minLength": 5,
2400
+ "pattern": "^svc_[a-z][a-z0-9-]*$",
2401
+ "type": "string"
2402
+ }
2403
+ },
2404
+ "required": ["servicePrincipalId"],
2405
+ "type": "object"
2406
+ },
2407
+ "commandId": { "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
2408
+ "contractVersion": {
2409
+ "additionalProperties": false,
2410
+ "properties": {
2411
+ "major": {
2412
+ "exclusiveMinimum": 0,
2413
+ "maximum": 9007199254740991,
2414
+ "type": "integer"
2415
+ },
2416
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
2417
+ },
2418
+ "required": ["major", "minor"],
2419
+ "type": "object"
2420
+ },
2421
+ "correlation": {
2422
+ "properties": {
2423
+ "causationCommandId": {
2424
+ "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$",
2425
+ "type": "string"
2426
+ },
2427
+ "parentEventId": {
2428
+ "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$",
2429
+ "type": "string"
2430
+ },
2431
+ "traceId": { "pattern": "^trc_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
2432
+ },
2433
+ "required": ["traceId"],
2434
+ "type": "object"
2435
+ },
2436
+ "idempotencyKey": {
2437
+ "maxLength": 128,
2438
+ "minLength": 16,
2439
+ "pattern": "^[A-Za-z0-9._:-]+$",
2440
+ "type": "string"
2441
+ },
2442
+ "issuedAt": {
2443
+ "format": "date-time",
2444
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
2445
+ "type": "string"
2446
+ },
2447
+ "operation": { "const": "marketplace.install.request", "type": "string" },
2448
+ "payload": {
2449
+ "additionalProperties": false,
2450
+ "properties": {
2451
+ "canonicalContentDigest": {
2452
+ "pattern": "^sha256:[a-f0-9]{64}$",
2453
+ "type": "string"
2454
+ },
2455
+ "pluginId": {
2456
+ "pattern": "^plugin:[a-z0-9-]+:[a-z0-9][a-z0-9-]{1,127}$",
2457
+ "type": "string"
2458
+ },
2459
+ "releaseId": { "pattern": "^release:[a-f0-9]{64}$", "type": "string" },
2460
+ "requestedHarness": { "maxLength": 128, "minLength": 1, "type": "string" },
2461
+ "workspaceIdentity": {
2462
+ "properties": {
2463
+ "userId": { "maxLength": 128, "minLength": 1, "type": "string" },
2464
+ "workspaceId": { "maxLength": 128, "minLength": 1, "type": "string" }
2465
+ },
2466
+ "required": ["workspaceId", "userId"],
2467
+ "type": "object"
2468
+ }
2469
+ },
2470
+ "required": [
2471
+ "pluginId",
2472
+ "releaseId",
2473
+ "canonicalContentDigest",
2474
+ "requestedHarness",
2475
+ "workspaceIdentity"
2476
+ ],
2477
+ "type": "object"
2478
+ },
2479
+ "payloadHash": { "pattern": "^[a-f0-9]{64}$", "type": "string" },
2480
+ "projectId": { "pattern": "^prj_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
2481
+ "requestId": { "pattern": "^req_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
2482
+ "workspaceId": { "pattern": "^wsp_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
2483
+ },
2484
+ "required": [
2485
+ "caller",
2486
+ "contractVersion",
2487
+ "requestId",
2488
+ "workspaceId",
2489
+ "correlation",
2490
+ "commandId",
2491
+ "idempotencyKey",
2492
+ "payloadHash",
2493
+ "operation",
2494
+ "issuedAt",
2495
+ "payload"
2496
+ ],
2497
+ "type": "object"
2498
+ }
2499
+ }
2500
+ },
2501
+ "required": true
2502
+ },
2503
+ "responses": {
2504
+ "200": {
2505
+ "content": {
2506
+ "application/json": {
2507
+ "schema": {
2508
+ "additionalProperties": false,
2509
+ "properties": {
2510
+ "contractVersion": {
2511
+ "additionalProperties": false,
2512
+ "properties": {
2513
+ "major": {
2514
+ "exclusiveMinimum": 0,
2515
+ "maximum": 9007199254740991,
2516
+ "type": "integer"
2517
+ },
2518
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
2519
+ },
2520
+ "required": ["major", "minor"],
2521
+ "type": "object"
2522
+ },
2523
+ "correlation": {
2524
+ "additionalProperties": false,
2525
+ "properties": {
2526
+ "causationCommandId": {},
2527
+ "parentEventId": {},
2528
+ "traceId": {}
2529
+ },
2530
+ "required": ["traceId"],
2531
+ "type": "object"
2532
+ },
2533
+ "data": {
2534
+ "additionalProperties": false,
2535
+ "properties": {
2536
+ "canonicalContentDigest": {
2537
+ "pattern": "^sha256:[a-f0-9]{64}$",
2538
+ "type": "string"
2539
+ },
2540
+ "catalogId": { "pattern": "^catalog:[a-f0-9]{64}$", "type": "string" },
2541
+ "installationId": { "maxLength": 128, "minLength": 1, "type": "string" },
2542
+ "pluginId": {
2543
+ "pattern": "^plugin:[a-z0-9-]+:[a-z0-9][a-z0-9-]{1,127}$",
2544
+ "type": "string"
2545
+ },
2546
+ "releaseId": { "pattern": "^release:[a-f0-9]{64}$", "type": "string" },
2547
+ "requestedHarness": { "maxLength": 128, "minLength": 1, "type": "string" },
2548
+ "state": {
2549
+ "enum": [
2550
+ "pending-authorization",
2551
+ "unavailable",
2552
+ "rejected-by-policy",
2553
+ "installed",
2554
+ "superseded"
2555
+ ],
2556
+ "type": "string"
2557
+ }
2558
+ },
2559
+ "required": [
2560
+ "pluginId",
2561
+ "releaseId",
2562
+ "canonicalContentDigest",
2563
+ "installationId",
2564
+ "catalogId",
2565
+ "requestedHarness",
2566
+ "state"
2567
+ ],
2568
+ "type": "object"
2569
+ },
2570
+ "requestId": {}
2571
+ },
2572
+ "required": ["contractVersion", "requestId", "correlation", "data"],
2573
+ "type": "object"
2574
+ }
2575
+ }
2576
+ },
2577
+ "description": "Successful response"
2578
+ },
2579
+ "default": {
2580
+ "content": {
2581
+ "application/json": {
2582
+ "schema": {
2583
+ "additionalProperties": false,
2584
+ "properties": {
2585
+ "contractVersion": {
2586
+ "additionalProperties": false,
2587
+ "properties": {
2588
+ "major": {
2589
+ "exclusiveMinimum": 0,
2590
+ "maximum": 9007199254740991,
2591
+ "type": "integer"
2592
+ },
2593
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
2594
+ },
2595
+ "required": ["major", "minor"],
2596
+ "type": "object"
2597
+ },
2598
+ "correlation": {
2599
+ "additionalProperties": false,
2600
+ "properties": {
2601
+ "causationCommandId": {},
2602
+ "parentEventId": {},
2603
+ "traceId": {}
2604
+ },
2605
+ "required": ["traceId"],
2606
+ "type": "object"
2607
+ },
2608
+ "error": {
2609
+ "additionalProperties": false,
2610
+ "properties": {
2611
+ "class": {
2612
+ "enum": [
2613
+ "validation",
2614
+ "authentication",
2615
+ "authorization",
2616
+ "conflict",
2617
+ "stale_reference",
2618
+ "capability_mismatch",
2619
+ "runtime_unavailable",
2620
+ "internal"
2621
+ ],
2622
+ "type": "string"
2623
+ },
2624
+ "code": {
2625
+ "maxLength": 96,
2626
+ "minLength": 1,
2627
+ "pattern": "^[A-Z][A-Z0-9_]*$",
2628
+ "type": "string"
2629
+ },
2630
+ "details": {
2631
+ "additionalProperties": {},
2632
+ "propertyNames": { "maxLength": 64, "type": "string" },
2633
+ "type": "object"
2634
+ },
2635
+ "message": { "maxLength": 512, "minLength": 1, "type": "string" },
2636
+ "remediation": { "maxLength": 256, "minLength": 1, "type": "string" },
2637
+ "retryable": { "type": "boolean" },
2638
+ "source": {
2639
+ "enum": [
2640
+ "client",
2641
+ "auth",
2642
+ "policy",
2643
+ "runtime",
2644
+ "provider",
2645
+ "persistence",
2646
+ "workflow",
2647
+ "system"
2648
+ ],
2649
+ "type": "string"
2650
+ }
2651
+ },
2652
+ "required": ["class", "code", "message", "retryable", "source"],
2653
+ "type": "object"
2654
+ },
2655
+ "requestId": {}
2656
+ },
2657
+ "required": ["contractVersion", "requestId", "correlation", "error"],
2658
+ "type": "object"
2659
+ }
2660
+ }
2661
+ },
2662
+ "description": "Normalized error response"
2663
+ }
2664
+ },
2665
+ "security": [{ "serviceBearer": [] }]
2666
+ }
2667
+ },
2668
+ "/v1/profiles/resolve": {
2669
+ "post": {
2670
+ "operationId": "profile.resolve",
2671
+ "requestBody": {
2672
+ "content": {
2673
+ "application/json": {
2674
+ "schema": {
2675
+ "properties": {
2676
+ "caller": {
2677
+ "properties": {
2678
+ "servicePrincipalId": {
2679
+ "maxLength": 64,
2680
+ "minLength": 5,
2681
+ "pattern": "^svc_[a-z][a-z0-9-]*$",
2682
+ "type": "string"
2683
+ }
2684
+ },
2685
+ "required": ["servicePrincipalId"],
2686
+ "type": "object"
2687
+ },
2688
+ "contractVersion": {
2689
+ "additionalProperties": false,
2690
+ "properties": {
2691
+ "major": {
2692
+ "exclusiveMinimum": 0,
2693
+ "maximum": 9007199254740991,
2694
+ "type": "integer"
2695
+ },
2696
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
2697
+ },
2698
+ "required": ["major", "minor"],
2699
+ "type": "object"
2700
+ },
2701
+ "correlation": {
2702
+ "properties": {
2703
+ "causationCommandId": {
2704
+ "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$",
2705
+ "type": "string"
2706
+ },
2707
+ "parentEventId": {
2708
+ "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$",
2709
+ "type": "string"
2710
+ },
2711
+ "traceId": { "pattern": "^trc_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
2712
+ },
2713
+ "required": ["traceId"],
2714
+ "type": "object"
2715
+ },
2716
+ "operation": { "const": "profile.resolve", "type": "string" },
2717
+ "parameters": {
2718
+ "properties": {
2719
+ "profileId": { "pattern": "^prf_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
2720
+ "profileVersionId": {
2721
+ "pattern": "^pfv_[0-9A-HJKMNP-TV-Z]{26}$",
2722
+ "type": "string"
2723
+ }
2724
+ },
2725
+ "required": ["profileId"],
2726
+ "type": "object"
2727
+ },
2728
+ "projectId": { "pattern": "^prj_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
2729
+ "requestedAt": {
2730
+ "format": "date-time",
2731
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
2732
+ "type": "string"
2733
+ },
2734
+ "requestId": { "pattern": "^req_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
2735
+ "workspaceId": { "pattern": "^wsp_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
2736
+ },
2737
+ "required": [
2738
+ "caller",
2739
+ "contractVersion",
2740
+ "requestId",
2741
+ "workspaceId",
2742
+ "correlation",
2743
+ "operation",
2744
+ "requestedAt",
2745
+ "parameters"
2746
+ ],
2747
+ "type": "object"
2748
+ }
2749
+ }
2750
+ },
2751
+ "required": true
2752
+ },
2753
+ "responses": {
2754
+ "200": {
2755
+ "content": {
2756
+ "application/json": {
2757
+ "schema": {
2758
+ "additionalProperties": false,
2759
+ "properties": {
2760
+ "contractVersion": {
2761
+ "additionalProperties": false,
2762
+ "properties": {
2763
+ "major": {
2764
+ "exclusiveMinimum": 0,
2765
+ "maximum": 9007199254740991,
2766
+ "type": "integer"
2767
+ },
2768
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
2769
+ },
2770
+ "required": ["major", "minor"],
2771
+ "type": "object"
2772
+ },
2773
+ "correlation": {
2774
+ "additionalProperties": false,
2775
+ "properties": {
2776
+ "causationCommandId": {},
2777
+ "parentEventId": {},
2778
+ "traceId": {}
2779
+ },
2780
+ "required": ["traceId"],
2781
+ "type": "object"
2782
+ },
2783
+ "data": {
2784
+ "additionalProperties": false,
2785
+ "properties": {
2786
+ "profile": {
2787
+ "additionalProperties": false,
2788
+ "properties": {
2789
+ "contentDigest": {
2790
+ "pattern": "^sha256:[a-f0-9]{64}$",
2791
+ "type": "string"
2792
+ },
2793
+ "lifecycle": { "const": "published", "type": "string" },
2794
+ "profileId": {},
2795
+ "profileVersionId": {},
2796
+ "revision": {
2797
+ "exclusiveMinimum": 0,
2798
+ "maximum": 9007199254740991,
2799
+ "type": "integer"
2800
+ },
2801
+ "schemaVersion": {
2802
+ "exclusiveMinimum": 0,
2803
+ "maximum": 9007199254740991,
2804
+ "type": "integer"
2805
+ },
2806
+ "version": {
2807
+ "exclusiveMinimum": 0,
2808
+ "maximum": 9007199254740991,
2809
+ "type": "integer"
2810
+ }
2811
+ },
2812
+ "required": [
2813
+ "profileId",
2814
+ "profileVersionId",
2815
+ "version",
2816
+ "revision",
2817
+ "schemaVersion",
2818
+ "contentDigest",
2819
+ "lifecycle"
2820
+ ],
2821
+ "type": "object"
2822
+ },
2823
+ "skillVersionIds": { "items": {}, "maxItems": 128, "type": "array" }
2824
+ },
2825
+ "required": ["profile", "skillVersionIds"],
2826
+ "type": "object"
2827
+ },
2828
+ "requestId": {}
2829
+ },
2830
+ "required": ["contractVersion", "requestId", "correlation", "data"],
2831
+ "type": "object"
2832
+ }
2833
+ }
2834
+ },
2835
+ "description": "Successful response"
2836
+ },
2837
+ "default": {
2838
+ "content": {
2839
+ "application/json": {
2840
+ "schema": {
2841
+ "additionalProperties": false,
2842
+ "properties": {
2843
+ "contractVersion": {
2844
+ "additionalProperties": false,
2845
+ "properties": {
2846
+ "major": {
2847
+ "exclusiveMinimum": 0,
2848
+ "maximum": 9007199254740991,
2849
+ "type": "integer"
2850
+ },
2851
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
2852
+ },
2853
+ "required": ["major", "minor"],
2854
+ "type": "object"
2855
+ },
2856
+ "correlation": {
2857
+ "additionalProperties": false,
2858
+ "properties": {
2859
+ "causationCommandId": {},
2860
+ "parentEventId": {},
2861
+ "traceId": {}
2862
+ },
2863
+ "required": ["traceId"],
2864
+ "type": "object"
2865
+ },
2866
+ "error": {
2867
+ "additionalProperties": false,
2868
+ "properties": {
2869
+ "class": {
2870
+ "enum": [
2871
+ "validation",
2872
+ "authentication",
2873
+ "authorization",
2874
+ "conflict",
2875
+ "stale_reference",
2876
+ "capability_mismatch",
2877
+ "runtime_unavailable",
2878
+ "internal"
2879
+ ],
2880
+ "type": "string"
2881
+ },
2882
+ "code": {
2883
+ "maxLength": 96,
2884
+ "minLength": 1,
2885
+ "pattern": "^[A-Z][A-Z0-9_]*$",
2886
+ "type": "string"
2887
+ },
2888
+ "details": {
2889
+ "additionalProperties": {},
2890
+ "propertyNames": { "maxLength": 64, "type": "string" },
2891
+ "type": "object"
2892
+ },
2893
+ "message": { "maxLength": 512, "minLength": 1, "type": "string" },
2894
+ "remediation": { "maxLength": 256, "minLength": 1, "type": "string" },
2895
+ "retryable": { "type": "boolean" },
2896
+ "source": {
2897
+ "enum": [
2898
+ "client",
2899
+ "auth",
2900
+ "policy",
2901
+ "runtime",
2902
+ "provider",
2903
+ "persistence",
2904
+ "workflow",
2905
+ "system"
2906
+ ],
2907
+ "type": "string"
2908
+ }
2909
+ },
2910
+ "required": ["class", "code", "message", "retryable", "source"],
2911
+ "type": "object"
2912
+ },
2913
+ "requestId": {}
2914
+ },
2915
+ "required": ["contractVersion", "requestId", "correlation", "error"],
2916
+ "type": "object"
2917
+ }
2918
+ }
2919
+ },
2920
+ "description": "Normalized error response"
2921
+ }
2922
+ },
2923
+ "security": [{ "serviceBearer": [] }]
2924
+ }
2925
+ },
2926
+ "/v1/project-states/resolve": {
2927
+ "post": {
2928
+ "operationId": "project-state.resolve",
2929
+ "requestBody": {
2930
+ "content": {
2931
+ "application/json": {
2932
+ "schema": {
2933
+ "properties": {
2934
+ "caller": {
2935
+ "properties": {
2936
+ "servicePrincipalId": {
2937
+ "maxLength": 64,
2938
+ "minLength": 5,
2939
+ "pattern": "^svc_[a-z][a-z0-9-]*$",
2940
+ "type": "string"
2941
+ }
2942
+ },
2943
+ "required": ["servicePrincipalId"],
2944
+ "type": "object"
2945
+ },
2946
+ "contractVersion": {
2947
+ "additionalProperties": false,
2948
+ "properties": {
2949
+ "major": {
2950
+ "exclusiveMinimum": 0,
2951
+ "maximum": 9007199254740991,
2952
+ "type": "integer"
2953
+ },
2954
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
2955
+ },
2956
+ "required": ["major", "minor"],
2957
+ "type": "object"
2958
+ },
2959
+ "correlation": {
2960
+ "properties": {
2961
+ "causationCommandId": {
2962
+ "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$",
2963
+ "type": "string"
2964
+ },
2965
+ "parentEventId": {
2966
+ "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$",
2967
+ "type": "string"
2968
+ },
2969
+ "traceId": { "pattern": "^trc_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
2970
+ },
2971
+ "required": ["traceId"],
2972
+ "type": "object"
2973
+ },
2974
+ "operation": { "const": "project-state.resolve", "type": "string" },
2975
+ "parameters": {
2976
+ "properties": {
2977
+ "revision": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
2978
+ },
2979
+ "type": "object"
2980
+ },
2981
+ "projectId": { "pattern": "^prj_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
2982
+ "requestedAt": {
2983
+ "format": "date-time",
2984
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
2985
+ "type": "string"
2986
+ },
2987
+ "requestId": { "pattern": "^req_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
2988
+ "workspaceId": { "pattern": "^wsp_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
2989
+ },
2990
+ "required": [
2991
+ "caller",
2992
+ "contractVersion",
2993
+ "requestId",
2994
+ "workspaceId",
2995
+ "correlation",
2996
+ "operation",
2997
+ "requestedAt",
2998
+ "parameters"
2999
+ ],
3000
+ "type": "object"
3001
+ }
3002
+ }
3003
+ },
3004
+ "required": true
3005
+ },
3006
+ "responses": {
3007
+ "200": {
3008
+ "content": {
3009
+ "application/json": {
3010
+ "schema": {
3011
+ "additionalProperties": false,
3012
+ "properties": {
3013
+ "contractVersion": {
3014
+ "additionalProperties": false,
3015
+ "properties": {
3016
+ "major": {
3017
+ "exclusiveMinimum": 0,
3018
+ "maximum": 9007199254740991,
3019
+ "type": "integer"
3020
+ },
3021
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
3022
+ },
3023
+ "required": ["major", "minor"],
3024
+ "type": "object"
3025
+ },
3026
+ "correlation": {
3027
+ "additionalProperties": false,
3028
+ "properties": {
3029
+ "causationCommandId": {},
3030
+ "parentEventId": {},
3031
+ "traceId": {}
3032
+ },
3033
+ "required": ["traceId"],
3034
+ "type": "object"
3035
+ },
3036
+ "data": {
3037
+ "additionalProperties": false,
3038
+ "properties": {
3039
+ "projectState": {
3040
+ "additionalProperties": false,
3041
+ "properties": {
3042
+ "projectId": {},
3043
+ "revision": {
3044
+ "maximum": 9007199254740991,
3045
+ "minimum": 0,
3046
+ "type": "integer"
3047
+ },
3048
+ "workspaceId": {}
3049
+ },
3050
+ "required": ["workspaceId", "projectId", "revision"],
3051
+ "type": "object"
3052
+ }
3053
+ },
3054
+ "required": ["projectState"],
3055
+ "type": "object"
3056
+ },
3057
+ "requestId": {}
3058
+ },
3059
+ "required": ["contractVersion", "requestId", "correlation", "data"],
3060
+ "type": "object"
3061
+ }
3062
+ }
3063
+ },
3064
+ "description": "Successful response"
3065
+ },
3066
+ "default": {
3067
+ "content": {
3068
+ "application/json": {
3069
+ "schema": {
3070
+ "additionalProperties": false,
3071
+ "properties": {
3072
+ "contractVersion": {
3073
+ "additionalProperties": false,
3074
+ "properties": {
3075
+ "major": {
3076
+ "exclusiveMinimum": 0,
3077
+ "maximum": 9007199254740991,
3078
+ "type": "integer"
3079
+ },
3080
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
3081
+ },
3082
+ "required": ["major", "minor"],
3083
+ "type": "object"
3084
+ },
3085
+ "correlation": {
3086
+ "additionalProperties": false,
3087
+ "properties": {
3088
+ "causationCommandId": {},
3089
+ "parentEventId": {},
3090
+ "traceId": {}
3091
+ },
3092
+ "required": ["traceId"],
3093
+ "type": "object"
3094
+ },
3095
+ "error": {
3096
+ "additionalProperties": false,
3097
+ "properties": {
3098
+ "class": {
3099
+ "enum": [
3100
+ "validation",
3101
+ "authentication",
3102
+ "authorization",
3103
+ "conflict",
3104
+ "stale_reference",
3105
+ "capability_mismatch",
3106
+ "runtime_unavailable",
3107
+ "internal"
3108
+ ],
3109
+ "type": "string"
3110
+ },
3111
+ "code": {
3112
+ "maxLength": 96,
3113
+ "minLength": 1,
3114
+ "pattern": "^[A-Z][A-Z0-9_]*$",
3115
+ "type": "string"
3116
+ },
3117
+ "details": {
3118
+ "additionalProperties": {},
3119
+ "propertyNames": { "maxLength": 64, "type": "string" },
3120
+ "type": "object"
3121
+ },
3122
+ "message": { "maxLength": 512, "minLength": 1, "type": "string" },
3123
+ "remediation": { "maxLength": 256, "minLength": 1, "type": "string" },
3124
+ "retryable": { "type": "boolean" },
3125
+ "source": {
3126
+ "enum": [
3127
+ "client",
3128
+ "auth",
3129
+ "policy",
3130
+ "runtime",
3131
+ "provider",
3132
+ "persistence",
3133
+ "workflow",
3134
+ "system"
3135
+ ],
3136
+ "type": "string"
3137
+ }
3138
+ },
3139
+ "required": ["class", "code", "message", "retryable", "source"],
3140
+ "type": "object"
3141
+ },
3142
+ "requestId": {}
3143
+ },
3144
+ "required": ["contractVersion", "requestId", "correlation", "error"],
3145
+ "type": "object"
3146
+ }
3147
+ }
3148
+ },
3149
+ "description": "Normalized error response"
3150
+ }
3151
+ },
3152
+ "security": [{ "serviceBearer": [] }]
3153
+ }
3154
+ },
3155
+ "/v1/runtime-connections/get": {
3156
+ "post": {
3157
+ "operationId": "runtime-connection.get",
3158
+ "requestBody": {
3159
+ "content": {
3160
+ "application/json": {
3161
+ "schema": {
3162
+ "properties": {
3163
+ "caller": {
3164
+ "properties": {
3165
+ "servicePrincipalId": {
3166
+ "maxLength": 64,
3167
+ "minLength": 5,
3168
+ "pattern": "^svc_[a-z][a-z0-9-]*$",
3169
+ "type": "string"
3170
+ }
3171
+ },
3172
+ "required": ["servicePrincipalId"],
3173
+ "type": "object"
3174
+ },
3175
+ "contractVersion": {
3176
+ "additionalProperties": false,
3177
+ "properties": {
3178
+ "major": {
3179
+ "exclusiveMinimum": 0,
3180
+ "maximum": 9007199254740991,
3181
+ "type": "integer"
3182
+ },
3183
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
3184
+ },
3185
+ "required": ["major", "minor"],
3186
+ "type": "object"
3187
+ },
3188
+ "correlation": {
3189
+ "properties": {
3190
+ "causationCommandId": {
3191
+ "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$",
3192
+ "type": "string"
3193
+ },
3194
+ "parentEventId": {
3195
+ "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$",
3196
+ "type": "string"
3197
+ },
3198
+ "traceId": { "pattern": "^trc_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
3199
+ },
3200
+ "required": ["traceId"],
3201
+ "type": "object"
3202
+ },
3203
+ "operation": { "const": "runtime-connection.get", "type": "string" },
3204
+ "parameters": {
3205
+ "properties": {
3206
+ "runtimeConnectionId": {
3207
+ "pattern": "^rtc_[0-9A-HJKMNP-TV-Z]{26}$",
3208
+ "type": "string"
3209
+ },
3210
+ "runtimeNodeRefId": {
3211
+ "pattern": "^rnr_[0-9A-HJKMNP-TV-Z]{26}$",
3212
+ "type": "string"
3213
+ }
3214
+ },
3215
+ "required": ["runtimeConnectionId"],
3216
+ "type": "object"
3217
+ },
3218
+ "projectId": { "pattern": "^prj_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
3219
+ "requestedAt": {
3220
+ "format": "date-time",
3221
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
3222
+ "type": "string"
3223
+ },
3224
+ "requestId": { "pattern": "^req_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
3225
+ "workspaceId": { "pattern": "^wsp_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
3226
+ },
3227
+ "required": [
3228
+ "caller",
3229
+ "contractVersion",
3230
+ "requestId",
3231
+ "workspaceId",
3232
+ "correlation",
3233
+ "requestedAt",
3234
+ "operation",
3235
+ "parameters"
3236
+ ],
3237
+ "type": "object"
3238
+ }
3239
+ }
3240
+ },
3241
+ "required": true
3242
+ },
3243
+ "responses": {
3244
+ "200": {
3245
+ "content": {
3246
+ "application/json": {
3247
+ "schema": {
3248
+ "additionalProperties": false,
3249
+ "properties": {
3250
+ "contractVersion": {
3251
+ "additionalProperties": false,
3252
+ "properties": {
3253
+ "major": {
3254
+ "exclusiveMinimum": 0,
3255
+ "maximum": 9007199254740991,
3256
+ "type": "integer"
3257
+ },
3258
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
3259
+ },
3260
+ "required": ["major", "minor"],
3261
+ "type": "object"
3262
+ },
3263
+ "correlation": {
3264
+ "additionalProperties": false,
3265
+ "properties": {
3266
+ "causationCommandId": {},
3267
+ "parentEventId": {},
3268
+ "traceId": {}
3269
+ },
3270
+ "required": ["traceId"],
3271
+ "type": "object"
3272
+ },
3273
+ "data": {
3274
+ "additionalProperties": false,
3275
+ "properties": {
3276
+ "runtimeConnection": {
3277
+ "additionalProperties": false,
3278
+ "properties": {
3279
+ "access": {
3280
+ "additionalProperties": false,
3281
+ "properties": {
3282
+ "entitlement": {
3283
+ "additionalProperties": false,
3284
+ "properties": {
3285
+ "class": { "maxLength": 64, "minLength": 1, "type": "string" },
3286
+ "state": {
3287
+ "enum": ["allowed", "denied", "unknown"],
3288
+ "type": "string"
3289
+ }
3290
+ },
3291
+ "required": ["state"],
3292
+ "type": "object"
3293
+ },
3294
+ "localProjectGrant": {
3295
+ "additionalProperties": false,
3296
+ "properties": {
3297
+ "required": { "type": "boolean" },
3298
+ "state": {
3299
+ "enum": ["not_required", "granted", "missing", "revoked"],
3300
+ "type": "string"
3301
+ }
3302
+ },
3303
+ "required": ["required", "state"],
3304
+ "type": "object"
3305
+ }
3306
+ },
3307
+ "required": ["localProjectGrant", "entitlement"],
3308
+ "type": "object"
3309
+ },
3310
+ "capabilities": {
3311
+ "items": {
3312
+ "maxLength": 128,
3313
+ "minLength": 1,
3314
+ "pattern": "^[a-z][a-z0-9.-]*$",
3315
+ "type": "string"
3316
+ },
3317
+ "maxItems": 64,
3318
+ "type": "array"
3319
+ },
3320
+ "capabilityDetails": {
3321
+ "items": {
3322
+ "additionalProperties": false,
3323
+ "properties": {
3324
+ "limitations": {
3325
+ "items": {
3326
+ "maxLength": 128,
3327
+ "minLength": 1,
3328
+ "pattern": "^[A-Z][A-Z0-9_]*$",
3329
+ "type": "string"
3330
+ },
3331
+ "maxItems": 32,
3332
+ "type": "array"
3333
+ },
3334
+ "name": {
3335
+ "maxLength": 128,
3336
+ "minLength": 1,
3337
+ "pattern": "^[a-z][a-z0-9.-]*$",
3338
+ "type": "string"
3339
+ },
3340
+ "support": {
3341
+ "enum": ["supported", "degraded", "unsupported"],
3342
+ "type": "string"
3343
+ }
3344
+ },
3345
+ "required": ["name", "support"],
3346
+ "type": "object"
3347
+ },
3348
+ "maxItems": 64,
3349
+ "type": "array"
3350
+ },
3351
+ "compatibility": {
3352
+ "additionalProperties": false,
3353
+ "properties": {
3354
+ "limitations": {
3355
+ "items": {
3356
+ "maxLength": 128,
3357
+ "minLength": 1,
3358
+ "pattern": "^[A-Z][A-Z0-9_]*$",
3359
+ "type": "string"
3360
+ },
3361
+ "maxItems": 64,
3362
+ "type": "array"
3363
+ },
3364
+ "state": {
3365
+ "enum": [
3366
+ "compatible",
3367
+ "degraded",
3368
+ "untested",
3369
+ "incompatible",
3370
+ "deprecated",
3371
+ "revoked",
3372
+ "unavailable",
3373
+ "capability_missing"
3374
+ ],
3375
+ "type": "string"
3376
+ }
3377
+ },
3378
+ "required": ["state", "limitations"],
3379
+ "type": "object"
3380
+ },
3381
+ "connection": {
3382
+ "additionalProperties": false,
3383
+ "properties": {
3384
+ "availability": {
3385
+ "enum": [
3386
+ "healthy",
3387
+ "degraded",
3388
+ "reconnecting",
3389
+ "offline",
3390
+ "incompatible",
3391
+ "revoked",
3392
+ "stale",
3393
+ "unknown"
3394
+ ],
3395
+ "type": "string"
3396
+ },
3397
+ "health": {
3398
+ "enum": ["healthy", "degraded", "unavailable"],
3399
+ "type": "string"
3400
+ },
3401
+ "status": {
3402
+ "enum": [
3403
+ "connected",
3404
+ "degraded",
3405
+ "unavailable",
3406
+ "disconnected",
3407
+ "expired",
3408
+ "revoked"
3409
+ ],
3410
+ "type": "string"
3411
+ }
3412
+ },
3413
+ "required": ["status", "health", "availability"],
3414
+ "type": "object"
3415
+ },
3416
+ "connectionType": {
3417
+ "enum": ["managed_cloud", "managed_local", "external_local"],
3418
+ "type": "string"
3419
+ },
3420
+ "eligibility": {
3421
+ "additionalProperties": false,
3422
+ "properties": {
3423
+ "degradations": {
3424
+ "items": {
3425
+ "maxLength": 128,
3426
+ "minLength": 1,
3427
+ "pattern": "^[A-Z][A-Z0-9_]*$",
3428
+ "type": "string"
3429
+ },
3430
+ "maxItems": 128,
3431
+ "type": "array"
3432
+ },
3433
+ "reasons": {
3434
+ "items": {
3435
+ "maxLength": 128,
3436
+ "minLength": 1,
3437
+ "pattern": "^[A-Z][A-Z0-9_]*$",
3438
+ "type": "string"
3439
+ },
3440
+ "maxItems": 128,
3441
+ "type": "array"
3442
+ },
3443
+ "remediation": {
3444
+ "items": {
3445
+ "additionalProperties": false,
3446
+ "properties": {
3447
+ "code": {
3448
+ "maxLength": 128,
3449
+ "minLength": 1,
3450
+ "pattern": "^[A-Z][A-Z0-9_]*$",
3451
+ "type": "string"
3452
+ },
3453
+ "label": {
3454
+ "maxLength": 160,
3455
+ "minLength": 1,
3456
+ "type": "string"
3457
+ }
3458
+ },
3459
+ "required": ["code", "label"],
3460
+ "type": "object"
3461
+ },
3462
+ "maxItems": 32,
3463
+ "type": "array"
3464
+ },
3465
+ "state": {
3466
+ "enum": ["eligible", "degraded", "ineligible"],
3467
+ "type": "string"
3468
+ }
3469
+ },
3470
+ "required": ["state", "reasons", "degradations", "remediation"],
3471
+ "type": "object"
3472
+ },
3473
+ "family": {
3474
+ "maxLength": 64,
3475
+ "minLength": 1,
3476
+ "pattern": "^[a-z][a-z0-9-]*$",
3477
+ "type": "string"
3478
+ },
3479
+ "freshness": {
3480
+ "additionalProperties": false,
3481
+ "properties": {
3482
+ "expiresAt": {
3483
+ "format": "date-time",
3484
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
3485
+ "type": "string"
3486
+ },
3487
+ "observedAt": {
3488
+ "format": "date-time",
3489
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
3490
+ "type": "string"
3491
+ },
3492
+ "state": {
3493
+ "enum": ["fresh", "stale", "expired", "unknown"],
3494
+ "type": "string"
3495
+ }
3496
+ },
3497
+ "required": ["state", "observedAt"],
3498
+ "type": "object"
3499
+ },
3500
+ "limitations": {
3501
+ "items": {
3502
+ "maxLength": 128,
3503
+ "minLength": 1,
3504
+ "pattern": "^[A-Z][A-Z0-9_]*$",
3505
+ "type": "string"
3506
+ },
3507
+ "maxItems": 64,
3508
+ "type": "array"
3509
+ },
3510
+ "location": {
3511
+ "enum": ["local_device", "agent_hq_cloud"],
3512
+ "type": "string"
3513
+ },
3514
+ "node": {
3515
+ "additionalProperties": false,
3516
+ "properties": {
3517
+ "health": {
3518
+ "enum": ["online", "offline", "unknown", "revoked"],
3519
+ "type": "string"
3520
+ },
3521
+ "location": {
3522
+ "enum": ["local_device", "remote_host", "agent_hq_cloud"],
3523
+ "type": "string"
3524
+ },
3525
+ "observedAt": {
3526
+ "format": "date-time",
3527
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
3528
+ "type": "string"
3529
+ },
3530
+ "runtimeNodeRefId": {},
3531
+ "status": {
3532
+ "enum": ["online", "offline", "revoked"],
3533
+ "type": "string"
3534
+ }
3535
+ },
3536
+ "required": [
3537
+ "runtimeNodeRefId",
3538
+ "location",
3539
+ "status",
3540
+ "health",
3541
+ "observedAt"
3542
+ ],
3543
+ "type": "object"
3544
+ },
3545
+ "observedAt": {
3546
+ "format": "date-time",
3547
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
3548
+ "type": "string"
3549
+ },
3550
+ "runtimeConnectionId": {},
3551
+ "runtimeDefinitionId": {},
3552
+ "status": {
3553
+ "enum": ["available", "degraded", "unavailable", "revoked"],
3554
+ "type": "string"
3555
+ },
3556
+ "versions": {
3557
+ "additionalProperties": false,
3558
+ "properties": {
3559
+ "adapter": {
3560
+ "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$",
3561
+ "type": "string"
3562
+ },
3563
+ "driver": {
3564
+ "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$",
3565
+ "type": "string"
3566
+ },
3567
+ "harness": {
3568
+ "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$",
3569
+ "type": "string"
3570
+ },
3571
+ "protocol": {
3572
+ "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$",
3573
+ "type": "string"
3574
+ }
3575
+ },
3576
+ "required": ["adapter", "driver", "harness"],
3577
+ "type": "object"
3578
+ }
3579
+ },
3580
+ "required": [
3581
+ "runtimeConnectionId",
3582
+ "runtimeDefinitionId",
3583
+ "family",
3584
+ "connectionType",
3585
+ "location",
3586
+ "status",
3587
+ "connection",
3588
+ "freshness",
3589
+ "versions",
3590
+ "capabilities",
3591
+ "capabilityDetails",
3592
+ "compatibility",
3593
+ "access",
3594
+ "eligibility",
3595
+ "observedAt",
3596
+ "limitations"
3597
+ ],
3598
+ "type": "object"
3599
+ }
3600
+ },
3601
+ "required": ["runtimeConnection"],
3602
+ "type": "object"
3603
+ },
3604
+ "requestId": {}
3605
+ },
3606
+ "required": ["contractVersion", "requestId", "correlation", "data"],
3607
+ "type": "object"
3608
+ }
3609
+ }
3610
+ },
3611
+ "description": "Successful response"
3612
+ },
3613
+ "default": {
3614
+ "content": {
3615
+ "application/json": {
3616
+ "schema": {
3617
+ "additionalProperties": false,
3618
+ "properties": {
3619
+ "contractVersion": {
3620
+ "additionalProperties": false,
3621
+ "properties": {
3622
+ "major": {
3623
+ "exclusiveMinimum": 0,
3624
+ "maximum": 9007199254740991,
3625
+ "type": "integer"
3626
+ },
3627
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
3628
+ },
3629
+ "required": ["major", "minor"],
3630
+ "type": "object"
3631
+ },
3632
+ "correlation": {
3633
+ "additionalProperties": false,
3634
+ "properties": {
3635
+ "causationCommandId": {},
3636
+ "parentEventId": {},
3637
+ "traceId": {}
3638
+ },
3639
+ "required": ["traceId"],
3640
+ "type": "object"
3641
+ },
3642
+ "error": {
3643
+ "additionalProperties": false,
3644
+ "properties": {
3645
+ "class": {
3646
+ "enum": [
3647
+ "validation",
3648
+ "authentication",
3649
+ "authorization",
3650
+ "conflict",
3651
+ "stale_reference",
3652
+ "capability_mismatch",
3653
+ "runtime_unavailable",
3654
+ "internal"
3655
+ ],
3656
+ "type": "string"
3657
+ },
3658
+ "code": {
3659
+ "maxLength": 96,
3660
+ "minLength": 1,
3661
+ "pattern": "^[A-Z][A-Z0-9_]*$",
3662
+ "type": "string"
3663
+ },
3664
+ "details": {
3665
+ "additionalProperties": {},
3666
+ "propertyNames": { "maxLength": 64, "type": "string" },
3667
+ "type": "object"
3668
+ },
3669
+ "message": { "maxLength": 512, "minLength": 1, "type": "string" },
3670
+ "remediation": { "maxLength": 256, "minLength": 1, "type": "string" },
3671
+ "retryable": { "type": "boolean" },
3672
+ "source": {
3673
+ "enum": [
3674
+ "client",
3675
+ "auth",
3676
+ "policy",
3677
+ "runtime",
3678
+ "provider",
3679
+ "persistence",
3680
+ "workflow",
3681
+ "system"
3682
+ ],
3683
+ "type": "string"
3684
+ }
3685
+ },
3686
+ "required": ["class", "code", "message", "retryable", "source"],
3687
+ "type": "object"
3688
+ },
3689
+ "requestId": {}
3690
+ },
3691
+ "required": ["contractVersion", "requestId", "correlation", "error"],
3692
+ "type": "object"
3693
+ }
3694
+ }
3695
+ },
3696
+ "description": "Normalized error response"
3697
+ }
3698
+ },
3699
+ "security": [{ "serviceBearer": [] }]
3700
+ }
3701
+ },
3702
+ "/v1/runtime-connections/list": {
3703
+ "post": {
3704
+ "operationId": "runtime-connection.list",
3705
+ "requestBody": {
3706
+ "content": {
3707
+ "application/json": {
3708
+ "schema": {
3709
+ "properties": {
3710
+ "caller": {
3711
+ "properties": {
3712
+ "servicePrincipalId": {
3713
+ "maxLength": 64,
3714
+ "minLength": 5,
3715
+ "pattern": "^svc_[a-z][a-z0-9-]*$",
3716
+ "type": "string"
3717
+ }
3718
+ },
3719
+ "required": ["servicePrincipalId"],
3720
+ "type": "object"
3721
+ },
3722
+ "contractVersion": {
3723
+ "additionalProperties": false,
3724
+ "properties": {
3725
+ "major": {
3726
+ "exclusiveMinimum": 0,
3727
+ "maximum": 9007199254740991,
3728
+ "type": "integer"
3729
+ },
3730
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
3731
+ },
3732
+ "required": ["major", "minor"],
3733
+ "type": "object"
3734
+ },
3735
+ "correlation": {
3736
+ "properties": {
3737
+ "causationCommandId": {
3738
+ "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$",
3739
+ "type": "string"
3740
+ },
3741
+ "parentEventId": {
3742
+ "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$",
3743
+ "type": "string"
3744
+ },
3745
+ "traceId": { "pattern": "^trc_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
3746
+ },
3747
+ "required": ["traceId"],
3748
+ "type": "object"
3749
+ },
3750
+ "operation": { "const": "runtime-connection.list", "type": "string" },
3751
+ "parameters": {
3752
+ "properties": {
3753
+ "cursor": {
3754
+ "maxLength": 512,
3755
+ "minLength": 8,
3756
+ "pattern": "^cur_[A-Za-z0-9_-]+$",
3757
+ "type": "string"
3758
+ },
3759
+ "limit": { "default": 50, "maximum": 100, "minimum": 1, "type": "integer" },
3760
+ "requiredCapabilities": {
3761
+ "default": [],
3762
+ "items": {
3763
+ "maxLength": 128,
3764
+ "minLength": 1,
3765
+ "pattern": "^[a-z][a-z0-9.-]*$",
3766
+ "type": "string"
3767
+ },
3768
+ "maxItems": 64,
3769
+ "type": "array"
3770
+ },
3771
+ "runtimeNodeRefId": {
3772
+ "pattern": "^rnr_[0-9A-HJKMNP-TV-Z]{26}$",
3773
+ "type": "string"
3774
+ },
3775
+ "states": {
3776
+ "default": [],
3777
+ "items": {
3778
+ "enum": [
3779
+ "available",
3780
+ "degraded",
3781
+ "stale",
3782
+ "incompatible",
3783
+ "offline",
3784
+ "revoked"
3785
+ ],
3786
+ "type": "string"
3787
+ },
3788
+ "maxItems": 6,
3789
+ "type": "array"
3790
+ }
3791
+ },
3792
+ "type": "object"
3793
+ },
3794
+ "projectId": { "pattern": "^prj_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
3795
+ "requestedAt": {
3796
+ "format": "date-time",
3797
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
3798
+ "type": "string"
3799
+ },
3800
+ "requestId": { "pattern": "^req_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
3801
+ "workspaceId": { "pattern": "^wsp_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
3802
+ },
3803
+ "required": [
3804
+ "caller",
3805
+ "contractVersion",
3806
+ "requestId",
3807
+ "workspaceId",
3808
+ "correlation",
3809
+ "requestedAt",
3810
+ "operation",
3811
+ "parameters"
3812
+ ],
3813
+ "type": "object"
3814
+ }
3815
+ }
3816
+ },
3817
+ "required": true
3818
+ },
3819
+ "responses": {
3820
+ "200": {
3821
+ "content": {
3822
+ "application/json": {
3823
+ "schema": {
3824
+ "additionalProperties": false,
3825
+ "properties": {
3826
+ "contractVersion": {
3827
+ "additionalProperties": false,
3828
+ "properties": {
3829
+ "major": {
3830
+ "exclusiveMinimum": 0,
3831
+ "maximum": 9007199254740991,
3832
+ "type": "integer"
3833
+ },
3834
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
3835
+ },
3836
+ "required": ["major", "minor"],
3837
+ "type": "object"
3838
+ },
3839
+ "correlation": {
3840
+ "additionalProperties": false,
3841
+ "properties": {
3842
+ "causationCommandId": {},
3843
+ "parentEventId": {},
3844
+ "traceId": {}
3845
+ },
3846
+ "required": ["traceId"],
3847
+ "type": "object"
3848
+ },
3849
+ "data": {
3850
+ "additionalProperties": false,
3851
+ "properties": {
3852
+ "page": {
3853
+ "additionalProperties": false,
3854
+ "properties": {
3855
+ "nextCursor": {
3856
+ "maxLength": 512,
3857
+ "minLength": 8,
3858
+ "pattern": "^cur_[A-Za-z0-9_-]+$",
3859
+ "type": "string"
3860
+ }
3861
+ },
3862
+ "type": "object"
3863
+ },
3864
+ "runtimeConnections": {
3865
+ "items": {
3866
+ "additionalProperties": false,
3867
+ "properties": {
3868
+ "access": {
3869
+ "additionalProperties": false,
3870
+ "properties": {
3871
+ "entitlement": {
3872
+ "additionalProperties": false,
3873
+ "properties": {
3874
+ "class": {
3875
+ "maxLength": 64,
3876
+ "minLength": 1,
3877
+ "type": "string"
3878
+ },
3879
+ "state": {
3880
+ "enum": ["allowed", "denied", "unknown"],
3881
+ "type": "string"
3882
+ }
3883
+ },
3884
+ "required": ["state"],
3885
+ "type": "object"
3886
+ },
3887
+ "localProjectGrant": {
3888
+ "additionalProperties": false,
3889
+ "properties": {
3890
+ "required": { "type": "boolean" },
3891
+ "state": {
3892
+ "enum": ["not_required", "granted", "missing", "revoked"],
3893
+ "type": "string"
3894
+ }
3895
+ },
3896
+ "required": ["required", "state"],
3897
+ "type": "object"
3898
+ }
3899
+ },
3900
+ "required": ["localProjectGrant", "entitlement"],
3901
+ "type": "object"
3902
+ },
3903
+ "capabilities": {
3904
+ "items": {
3905
+ "maxLength": 128,
3906
+ "minLength": 1,
3907
+ "pattern": "^[a-z][a-z0-9.-]*$",
3908
+ "type": "string"
3909
+ },
3910
+ "maxItems": 64,
3911
+ "type": "array"
3912
+ },
3913
+ "capabilityDetails": {
3914
+ "items": {
3915
+ "additionalProperties": false,
3916
+ "properties": {
3917
+ "limitations": {
3918
+ "items": {
3919
+ "maxLength": 128,
3920
+ "minLength": 1,
3921
+ "pattern": "^[A-Z][A-Z0-9_]*$",
3922
+ "type": "string"
3923
+ },
3924
+ "maxItems": 32,
3925
+ "type": "array"
3926
+ },
3927
+ "name": {
3928
+ "maxLength": 128,
3929
+ "minLength": 1,
3930
+ "pattern": "^[a-z][a-z0-9.-]*$",
3931
+ "type": "string"
3932
+ },
3933
+ "support": {
3934
+ "enum": ["supported", "degraded", "unsupported"],
3935
+ "type": "string"
3936
+ }
3937
+ },
3938
+ "required": ["name", "support"],
3939
+ "type": "object"
3940
+ },
3941
+ "maxItems": 64,
3942
+ "type": "array"
3943
+ },
3944
+ "compatibility": {
3945
+ "additionalProperties": false,
3946
+ "properties": {
3947
+ "limitations": {
3948
+ "items": {
3949
+ "maxLength": 128,
3950
+ "minLength": 1,
3951
+ "pattern": "^[A-Z][A-Z0-9_]*$",
3952
+ "type": "string"
3953
+ },
3954
+ "maxItems": 64,
3955
+ "type": "array"
3956
+ },
3957
+ "state": {
3958
+ "enum": [
3959
+ "compatible",
3960
+ "degraded",
3961
+ "untested",
3962
+ "incompatible",
3963
+ "deprecated",
3964
+ "revoked",
3965
+ "unavailable",
3966
+ "capability_missing"
3967
+ ],
3968
+ "type": "string"
3969
+ }
3970
+ },
3971
+ "required": ["state", "limitations"],
3972
+ "type": "object"
3973
+ },
3974
+ "connection": {
3975
+ "additionalProperties": false,
3976
+ "properties": {
3977
+ "availability": {
3978
+ "enum": [
3979
+ "healthy",
3980
+ "degraded",
3981
+ "reconnecting",
3982
+ "offline",
3983
+ "incompatible",
3984
+ "revoked",
3985
+ "stale",
3986
+ "unknown"
3987
+ ],
3988
+ "type": "string"
3989
+ },
3990
+ "health": {
3991
+ "enum": ["healthy", "degraded", "unavailable"],
3992
+ "type": "string"
3993
+ },
3994
+ "status": {
3995
+ "enum": [
3996
+ "connected",
3997
+ "degraded",
3998
+ "unavailable",
3999
+ "disconnected",
4000
+ "expired",
4001
+ "revoked"
4002
+ ],
4003
+ "type": "string"
4004
+ }
4005
+ },
4006
+ "required": ["status", "health", "availability"],
4007
+ "type": "object"
4008
+ },
4009
+ "connectionType": {
4010
+ "enum": ["managed_cloud", "managed_local", "external_local"],
4011
+ "type": "string"
4012
+ },
4013
+ "eligibility": {
4014
+ "additionalProperties": false,
4015
+ "properties": {
4016
+ "degradations": {
4017
+ "items": {
4018
+ "maxLength": 128,
4019
+ "minLength": 1,
4020
+ "pattern": "^[A-Z][A-Z0-9_]*$",
4021
+ "type": "string"
4022
+ },
4023
+ "maxItems": 128,
4024
+ "type": "array"
4025
+ },
4026
+ "reasons": {
4027
+ "items": {
4028
+ "maxLength": 128,
4029
+ "minLength": 1,
4030
+ "pattern": "^[A-Z][A-Z0-9_]*$",
4031
+ "type": "string"
4032
+ },
4033
+ "maxItems": 128,
4034
+ "type": "array"
4035
+ },
4036
+ "remediation": {
4037
+ "items": {
4038
+ "additionalProperties": false,
4039
+ "properties": {
4040
+ "code": {
4041
+ "maxLength": 128,
4042
+ "minLength": 1,
4043
+ "pattern": "^[A-Z][A-Z0-9_]*$",
4044
+ "type": "string"
4045
+ },
4046
+ "label": {
4047
+ "maxLength": 160,
4048
+ "minLength": 1,
4049
+ "type": "string"
4050
+ }
4051
+ },
4052
+ "required": ["code", "label"],
4053
+ "type": "object"
4054
+ },
4055
+ "maxItems": 32,
4056
+ "type": "array"
4057
+ },
4058
+ "state": {
4059
+ "enum": ["eligible", "degraded", "ineligible"],
4060
+ "type": "string"
4061
+ }
4062
+ },
4063
+ "required": ["state", "reasons", "degradations", "remediation"],
4064
+ "type": "object"
4065
+ },
4066
+ "family": {
4067
+ "maxLength": 64,
4068
+ "minLength": 1,
4069
+ "pattern": "^[a-z][a-z0-9-]*$",
4070
+ "type": "string"
4071
+ },
4072
+ "freshness": {
4073
+ "additionalProperties": false,
4074
+ "properties": {
4075
+ "expiresAt": {
4076
+ "format": "date-time",
4077
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
4078
+ "type": "string"
4079
+ },
4080
+ "observedAt": {
4081
+ "format": "date-time",
4082
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
4083
+ "type": "string"
4084
+ },
4085
+ "state": {
4086
+ "enum": ["fresh", "stale", "expired", "unknown"],
4087
+ "type": "string"
4088
+ }
4089
+ },
4090
+ "required": ["state", "observedAt"],
4091
+ "type": "object"
4092
+ },
4093
+ "limitations": {
4094
+ "items": {
4095
+ "maxLength": 128,
4096
+ "minLength": 1,
4097
+ "pattern": "^[A-Z][A-Z0-9_]*$",
4098
+ "type": "string"
4099
+ },
4100
+ "maxItems": 64,
4101
+ "type": "array"
4102
+ },
4103
+ "location": {
4104
+ "enum": ["local_device", "agent_hq_cloud"],
4105
+ "type": "string"
4106
+ },
4107
+ "node": {
4108
+ "additionalProperties": false,
4109
+ "properties": {
4110
+ "health": {
4111
+ "enum": ["online", "offline", "unknown", "revoked"],
4112
+ "type": "string"
4113
+ },
4114
+ "location": {
4115
+ "enum": ["local_device", "remote_host", "agent_hq_cloud"],
4116
+ "type": "string"
4117
+ },
4118
+ "observedAt": {
4119
+ "format": "date-time",
4120
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
4121
+ "type": "string"
4122
+ },
4123
+ "runtimeNodeRefId": {},
4124
+ "status": {
4125
+ "enum": ["online", "offline", "revoked"],
4126
+ "type": "string"
4127
+ }
4128
+ },
4129
+ "required": [
4130
+ "runtimeNodeRefId",
4131
+ "location",
4132
+ "status",
4133
+ "health",
4134
+ "observedAt"
4135
+ ],
4136
+ "type": "object"
4137
+ },
4138
+ "observedAt": {
4139
+ "format": "date-time",
4140
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
4141
+ "type": "string"
4142
+ },
4143
+ "runtimeConnectionId": {},
4144
+ "runtimeDefinitionId": {},
4145
+ "status": {
4146
+ "enum": ["available", "degraded", "unavailable", "revoked"],
4147
+ "type": "string"
4148
+ },
4149
+ "versions": {
4150
+ "additionalProperties": false,
4151
+ "properties": {
4152
+ "adapter": {
4153
+ "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$",
4154
+ "type": "string"
4155
+ },
4156
+ "driver": {
4157
+ "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$",
4158
+ "type": "string"
4159
+ },
4160
+ "harness": {
4161
+ "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$",
4162
+ "type": "string"
4163
+ },
4164
+ "protocol": {
4165
+ "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$",
4166
+ "type": "string"
4167
+ }
4168
+ },
4169
+ "required": ["adapter", "driver", "harness"],
4170
+ "type": "object"
4171
+ }
4172
+ },
4173
+ "required": [
4174
+ "runtimeConnectionId",
4175
+ "runtimeDefinitionId",
4176
+ "family",
4177
+ "connectionType",
4178
+ "location",
4179
+ "status",
4180
+ "connection",
4181
+ "freshness",
4182
+ "versions",
4183
+ "capabilities",
4184
+ "capabilityDetails",
4185
+ "compatibility",
4186
+ "access",
4187
+ "eligibility",
4188
+ "observedAt",
4189
+ "limitations"
4190
+ ],
4191
+ "type": "object"
4192
+ },
4193
+ "maxItems": 100,
4194
+ "type": "array"
4195
+ }
4196
+ },
4197
+ "required": ["runtimeConnections", "page"],
4198
+ "type": "object"
4199
+ },
4200
+ "requestId": {}
4201
+ },
4202
+ "required": ["contractVersion", "requestId", "correlation", "data"],
4203
+ "type": "object"
4204
+ }
4205
+ }
4206
+ },
4207
+ "description": "Successful response"
4208
+ },
4209
+ "default": {
4210
+ "content": {
4211
+ "application/json": {
4212
+ "schema": {
4213
+ "additionalProperties": false,
4214
+ "properties": {
4215
+ "contractVersion": {
4216
+ "additionalProperties": false,
4217
+ "properties": {
4218
+ "major": {
4219
+ "exclusiveMinimum": 0,
4220
+ "maximum": 9007199254740991,
4221
+ "type": "integer"
4222
+ },
4223
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
4224
+ },
4225
+ "required": ["major", "minor"],
4226
+ "type": "object"
4227
+ },
4228
+ "correlation": {
4229
+ "additionalProperties": false,
4230
+ "properties": {
4231
+ "causationCommandId": {},
4232
+ "parentEventId": {},
4233
+ "traceId": {}
4234
+ },
4235
+ "required": ["traceId"],
4236
+ "type": "object"
4237
+ },
4238
+ "error": {
4239
+ "additionalProperties": false,
4240
+ "properties": {
4241
+ "class": {
4242
+ "enum": [
4243
+ "validation",
4244
+ "authentication",
4245
+ "authorization",
4246
+ "conflict",
4247
+ "stale_reference",
4248
+ "capability_mismatch",
4249
+ "runtime_unavailable",
4250
+ "internal"
4251
+ ],
4252
+ "type": "string"
4253
+ },
4254
+ "code": {
4255
+ "maxLength": 96,
4256
+ "minLength": 1,
4257
+ "pattern": "^[A-Z][A-Z0-9_]*$",
4258
+ "type": "string"
4259
+ },
4260
+ "details": {
4261
+ "additionalProperties": {},
4262
+ "propertyNames": { "maxLength": 64, "type": "string" },
4263
+ "type": "object"
4264
+ },
4265
+ "message": { "maxLength": 512, "minLength": 1, "type": "string" },
4266
+ "remediation": { "maxLength": 256, "minLength": 1, "type": "string" },
4267
+ "retryable": { "type": "boolean" },
4268
+ "source": {
4269
+ "enum": [
4270
+ "client",
4271
+ "auth",
4272
+ "policy",
4273
+ "runtime",
4274
+ "provider",
4275
+ "persistence",
4276
+ "workflow",
4277
+ "system"
4278
+ ],
4279
+ "type": "string"
4280
+ }
4281
+ },
4282
+ "required": ["class", "code", "message", "retryable", "source"],
4283
+ "type": "object"
4284
+ },
4285
+ "requestId": {}
4286
+ },
4287
+ "required": ["contractVersion", "requestId", "correlation", "error"],
4288
+ "type": "object"
4289
+ }
4290
+ }
4291
+ },
4292
+ "description": "Normalized error response"
4293
+ }
4294
+ },
4295
+ "security": [{ "serviceBearer": [] }]
4296
+ }
4297
+ },
4298
+ "/v1/runtimes/list": {
4299
+ "post": {
4300
+ "operationId": "runtime.list",
4301
+ "requestBody": {
4302
+ "content": {
4303
+ "application/json": {
4304
+ "schema": {
4305
+ "properties": {
4306
+ "caller": {
4307
+ "properties": {
4308
+ "servicePrincipalId": {
4309
+ "maxLength": 64,
4310
+ "minLength": 5,
4311
+ "pattern": "^svc_[a-z][a-z0-9-]*$",
4312
+ "type": "string"
4313
+ }
4314
+ },
4315
+ "required": ["servicePrincipalId"],
4316
+ "type": "object"
4317
+ },
4318
+ "contractVersion": {
4319
+ "additionalProperties": false,
4320
+ "properties": {
4321
+ "major": {
4322
+ "exclusiveMinimum": 0,
4323
+ "maximum": 9007199254740991,
4324
+ "type": "integer"
4325
+ },
4326
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
4327
+ },
4328
+ "required": ["major", "minor"],
4329
+ "type": "object"
4330
+ },
4331
+ "correlation": {
4332
+ "properties": {
4333
+ "causationCommandId": {
4334
+ "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$",
4335
+ "type": "string"
4336
+ },
4337
+ "parentEventId": {
4338
+ "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$",
4339
+ "type": "string"
4340
+ },
4341
+ "traceId": { "pattern": "^trc_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
4342
+ },
4343
+ "required": ["traceId"],
4344
+ "type": "object"
4345
+ },
4346
+ "operation": { "const": "runtime.list", "type": "string" },
4347
+ "parameters": {
4348
+ "properties": {
4349
+ "requiredCapabilities": {
4350
+ "items": {
4351
+ "maxLength": 128,
4352
+ "minLength": 1,
4353
+ "pattern": "^[a-z][a-z0-9.-]*$",
4354
+ "type": "string"
4355
+ },
4356
+ "maxItems": 128,
4357
+ "type": "array"
4358
+ },
4359
+ "status": {
4360
+ "enum": ["available", "degraded", "unavailable", "revoked"],
4361
+ "type": "string"
4362
+ }
4363
+ },
4364
+ "required": ["requiredCapabilities"],
4365
+ "type": "object"
4366
+ },
4367
+ "projectId": { "pattern": "^prj_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
4368
+ "requestedAt": {
4369
+ "format": "date-time",
4370
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
4371
+ "type": "string"
4372
+ },
4373
+ "requestId": { "pattern": "^req_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
4374
+ "workspaceId": { "pattern": "^wsp_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
4375
+ },
4376
+ "required": [
4377
+ "caller",
4378
+ "contractVersion",
4379
+ "requestId",
4380
+ "workspaceId",
4381
+ "correlation",
4382
+ "operation",
4383
+ "requestedAt",
4384
+ "parameters"
4385
+ ],
4386
+ "type": "object"
4387
+ }
4388
+ }
4389
+ },
4390
+ "required": true
4391
+ },
4392
+ "responses": {
4393
+ "200": {
4394
+ "content": {
4395
+ "application/json": {
4396
+ "schema": {
4397
+ "additionalProperties": false,
4398
+ "properties": {
4399
+ "contractVersion": {
4400
+ "additionalProperties": false,
4401
+ "properties": {
4402
+ "major": {
4403
+ "exclusiveMinimum": 0,
4404
+ "maximum": 9007199254740991,
4405
+ "type": "integer"
4406
+ },
4407
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
4408
+ },
4409
+ "required": ["major", "minor"],
4410
+ "type": "object"
4411
+ },
4412
+ "correlation": {
4413
+ "additionalProperties": false,
4414
+ "properties": {
4415
+ "causationCommandId": {},
4416
+ "parentEventId": {},
4417
+ "traceId": {}
4418
+ },
4419
+ "required": ["traceId"],
4420
+ "type": "object"
4421
+ },
4422
+ "data": {
4423
+ "additionalProperties": false,
4424
+ "properties": {
4425
+ "runtimes": {
4426
+ "items": {
4427
+ "additionalProperties": false,
4428
+ "properties": {
4429
+ "capabilities": {
4430
+ "items": {
4431
+ "maxLength": 128,
4432
+ "minLength": 1,
4433
+ "pattern": "^[a-z][a-z0-9.-]*$",
4434
+ "type": "string"
4435
+ },
4436
+ "maxItems": 128,
4437
+ "type": "array"
4438
+ },
4439
+ "family": { "maxLength": 64, "minLength": 1, "type": "string" },
4440
+ "limitations": {
4441
+ "items": { "maxLength": 512, "minLength": 1, "type": "string" },
4442
+ "maxItems": 64,
4443
+ "type": "array"
4444
+ },
4445
+ "location": {
4446
+ "enum": ["local_device", "remote_host", "agent_hq_cloud"],
4447
+ "type": "string"
4448
+ },
4449
+ "observedAt": {
4450
+ "format": "date-time",
4451
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
4452
+ "type": "string"
4453
+ },
4454
+ "runtimeConnectionId": {},
4455
+ "runtimeDefinitionId": {},
4456
+ "runtimeNodeRefId": {},
4457
+ "status": {
4458
+ "enum": ["available", "degraded", "unavailable", "revoked"],
4459
+ "type": "string"
4460
+ }
4461
+ },
4462
+ "required": [
4463
+ "runtimeNodeRefId",
4464
+ "runtimeDefinitionId",
4465
+ "family",
4466
+ "location",
4467
+ "status",
4468
+ "observedAt",
4469
+ "capabilities",
4470
+ "limitations"
4471
+ ],
4472
+ "type": "object"
4473
+ },
4474
+ "maxItems": 1000,
4475
+ "type": "array"
4476
+ }
4477
+ },
4478
+ "required": ["runtimes"],
4479
+ "type": "object"
4480
+ },
4481
+ "requestId": {}
4482
+ },
4483
+ "required": ["contractVersion", "requestId", "correlation", "data"],
4484
+ "type": "object"
4485
+ }
4486
+ }
4487
+ },
4488
+ "description": "Successful response"
4489
+ },
4490
+ "default": {
4491
+ "content": {
4492
+ "application/json": {
4493
+ "schema": {
4494
+ "additionalProperties": false,
4495
+ "properties": {
4496
+ "contractVersion": {
4497
+ "additionalProperties": false,
4498
+ "properties": {
4499
+ "major": {
4500
+ "exclusiveMinimum": 0,
4501
+ "maximum": 9007199254740991,
4502
+ "type": "integer"
4503
+ },
4504
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
4505
+ },
4506
+ "required": ["major", "minor"],
4507
+ "type": "object"
4508
+ },
4509
+ "correlation": {
4510
+ "additionalProperties": false,
4511
+ "properties": {
4512
+ "causationCommandId": {},
4513
+ "parentEventId": {},
4514
+ "traceId": {}
4515
+ },
4516
+ "required": ["traceId"],
4517
+ "type": "object"
4518
+ },
4519
+ "error": {
4520
+ "additionalProperties": false,
4521
+ "properties": {
4522
+ "class": {
4523
+ "enum": [
4524
+ "validation",
4525
+ "authentication",
4526
+ "authorization",
4527
+ "conflict",
4528
+ "stale_reference",
4529
+ "capability_mismatch",
4530
+ "runtime_unavailable",
4531
+ "internal"
4532
+ ],
4533
+ "type": "string"
4534
+ },
4535
+ "code": {
4536
+ "maxLength": 96,
4537
+ "minLength": 1,
4538
+ "pattern": "^[A-Z][A-Z0-9_]*$",
4539
+ "type": "string"
4540
+ },
4541
+ "details": {
4542
+ "additionalProperties": {},
4543
+ "propertyNames": { "maxLength": 64, "type": "string" },
4544
+ "type": "object"
4545
+ },
4546
+ "message": { "maxLength": 512, "minLength": 1, "type": "string" },
4547
+ "remediation": { "maxLength": 256, "minLength": 1, "type": "string" },
4548
+ "retryable": { "type": "boolean" },
4549
+ "source": {
4550
+ "enum": [
4551
+ "client",
4552
+ "auth",
4553
+ "policy",
4554
+ "runtime",
4555
+ "provider",
4556
+ "persistence",
4557
+ "workflow",
4558
+ "system"
4559
+ ],
4560
+ "type": "string"
4561
+ }
4562
+ },
4563
+ "required": ["class", "code", "message", "retryable", "source"],
4564
+ "type": "object"
4565
+ },
4566
+ "requestId": {}
4567
+ },
4568
+ "required": ["contractVersion", "requestId", "correlation", "error"],
4569
+ "type": "object"
4570
+ }
4571
+ }
4572
+ },
4573
+ "description": "Normalized error response"
4574
+ }
4575
+ },
4576
+ "security": [{ "serviceBearer": [] }]
4577
+ }
4578
+ }
4579
+ },
4580
+ "components": {
4581
+ "securitySchemes": {
4582
+ "serviceBearer": { "type": "http", "scheme": "bearer", "bearerFormat": "service-credential" }
4583
+ }
4584
+ }
4585
+ }