@adea-ai/sdk 1.11.0 → 1.12.0

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 (10) hide show
  1. package/dist/client.d.ts +7 -0
  2. package/dist/client.d.ts.map +1 -1
  3. package/dist/client.js +18 -0
  4. package/dist/client.js.map +1 -1
  5. package/dist/operations.d.ts +515 -0
  6. package/dist/operations.d.ts.map +1 -1
  7. package/dist/operations.js +43 -0
  8. package/dist/operations.js.map +1 -1
  9. package/openapi/control-plane.v3.json +2073 -0
  10. package/package.json +2 -2
package/openapi/control-plane.v3.json CHANGED
@@ -12056,6 +12056,2079 @@
12056
12056
  "security": [{ "serviceBearer": [] }]
12057
12057
  }
12058
12058
  },
12059
+ "/v1/model-connections/create": {
12060
+ "post": {
12061
+ "operationId": "model-connections.create",
12062
+ "requestBody": {
12063
+ "content": {
12064
+ "application/json": {
12065
+ "schema": {
12066
+ "additionalProperties": false,
12067
+ "properties": {
12068
+ "caller": {
12069
+ "properties": {
12070
+ "servicePrincipalId": {
12071
+ "maxLength": 64,
12072
+ "minLength": 5,
12073
+ "pattern": "^svc_[a-z][a-z0-9-]*$",
12074
+ "type": "string"
12075
+ }
12076
+ },
12077
+ "required": ["servicePrincipalId"],
12078
+ "type": "object"
12079
+ },
12080
+ "commandId": { "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
12081
+ "contractVersion": {
12082
+ "additionalProperties": false,
12083
+ "properties": {
12084
+ "major": {
12085
+ "exclusiveMinimum": 0,
12086
+ "maximum": 9007199254740991,
12087
+ "type": "integer"
12088
+ },
12089
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
12090
+ },
12091
+ "required": ["major", "minor"],
12092
+ "type": "object"
12093
+ },
12094
+ "correlation": {
12095
+ "properties": {
12096
+ "causationCommandId": {
12097
+ "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$",
12098
+ "type": "string"
12099
+ },
12100
+ "parentEventId": {
12101
+ "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$",
12102
+ "type": "string"
12103
+ },
12104
+ "traceId": { "pattern": "^trc_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
12105
+ },
12106
+ "required": ["traceId"],
12107
+ "type": "object"
12108
+ },
12109
+ "idempotencyKey": {
12110
+ "maxLength": 128,
12111
+ "minLength": 16,
12112
+ "pattern": "^[A-Za-z0-9._:-]+$",
12113
+ "type": "string"
12114
+ },
12115
+ "issuedAt": {
12116
+ "format": "date-time",
12117
+ "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))$",
12118
+ "type": "string"
12119
+ },
12120
+ "operation": { "const": "model-connections.create", "type": "string" },
12121
+ "payload": {
12122
+ "additionalProperties": false,
12123
+ "properties": {
12124
+ "credentialRef": {
12125
+ "pattern": "^crd_[0-9A-HJKMNP-TV-Z]{26}$",
12126
+ "type": "string"
12127
+ },
12128
+ "credentialRevision": {
12129
+ "exclusiveMinimum": 0,
12130
+ "maximum": 9007199254740991,
12131
+ "type": "integer"
12132
+ }
12133
+ },
12134
+ "required": ["credentialRef", "credentialRevision"],
12135
+ "type": "object"
12136
+ },
12137
+ "payloadHash": { "pattern": "^[a-f0-9]{64}$", "type": "string" },
12138
+ "requestId": { "pattern": "^req_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
12139
+ "workspaceId": { "pattern": "^wsp_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
12140
+ },
12141
+ "required": [
12142
+ "caller",
12143
+ "contractVersion",
12144
+ "requestId",
12145
+ "workspaceId",
12146
+ "correlation",
12147
+ "commandId",
12148
+ "idempotencyKey",
12149
+ "payloadHash",
12150
+ "operation",
12151
+ "issuedAt",
12152
+ "payload"
12153
+ ],
12154
+ "type": "object"
12155
+ }
12156
+ }
12157
+ },
12158
+ "required": true
12159
+ },
12160
+ "responses": {
12161
+ "200": {
12162
+ "content": {
12163
+ "application/json": {
12164
+ "schema": {
12165
+ "additionalProperties": false,
12166
+ "properties": {
12167
+ "contractVersion": {
12168
+ "additionalProperties": false,
12169
+ "properties": {
12170
+ "major": {
12171
+ "exclusiveMinimum": 0,
12172
+ "maximum": 9007199254740991,
12173
+ "type": "integer"
12174
+ },
12175
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
12176
+ },
12177
+ "required": ["major", "minor"],
12178
+ "type": "object"
12179
+ },
12180
+ "correlation": {
12181
+ "additionalProperties": false,
12182
+ "properties": {
12183
+ "causationCommandId": {},
12184
+ "parentEventId": {},
12185
+ "traceId": {}
12186
+ },
12187
+ "required": ["traceId"],
12188
+ "type": "object"
12189
+ },
12190
+ "data": {
12191
+ "additionalProperties": false,
12192
+ "properties": {
12193
+ "connection": {
12194
+ "additionalProperties": false,
12195
+ "properties": {
12196
+ "accountRef": {
12197
+ "maxLength": 256,
12198
+ "minLength": 1,
12199
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
12200
+ "type": "string"
12201
+ },
12202
+ "authKind": {
12203
+ "enum": ["api_key", "provider_subscription", "local_runtime"],
12204
+ "type": "string"
12205
+ },
12206
+ "connectionRef": {
12207
+ "pattern": "^mconn_[a-f0-9]{32}$",
12208
+ "type": "string"
12209
+ },
12210
+ "credentialRef": {},
12211
+ "credentialRevision": {
12212
+ "exclusiveMinimum": 0,
12213
+ "maximum": 9007199254740991,
12214
+ "type": "integer"
12215
+ },
12216
+ "fundingSource": {
12217
+ "enum": ["hq_managed", "external_subscription", "byo_api"],
12218
+ "type": "string"
12219
+ },
12220
+ "models": {
12221
+ "items": {
12222
+ "maxLength": 256,
12223
+ "minLength": 1,
12224
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
12225
+ "type": "string"
12226
+ },
12227
+ "maxItems": 256,
12228
+ "minItems": 1,
12229
+ "type": "array"
12230
+ },
12231
+ "ownerRef": {
12232
+ "maxLength": 256,
12233
+ "minLength": 1,
12234
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
12235
+ "type": "string"
12236
+ },
12237
+ "provider": {
12238
+ "maxLength": 128,
12239
+ "minLength": 1,
12240
+ "pattern": "^[a-z][a-z0-9.-]*$",
12241
+ "type": "string"
12242
+ },
12243
+ "revision": {
12244
+ "exclusiveMinimum": 0,
12245
+ "maximum": 9007199254740991,
12246
+ "type": "integer"
12247
+ },
12248
+ "status": { "enum": ["active", "revoked"], "type": "string" },
12249
+ "workspaceGrant": {
12250
+ "additionalProperties": false,
12251
+ "properties": {
12252
+ "expiresAt": {
12253
+ "format": "date-time",
12254
+ "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))$",
12255
+ "type": "string"
12256
+ },
12257
+ "grantRef": {
12258
+ "maxLength": 256,
12259
+ "minLength": 1,
12260
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
12261
+ "type": "string"
12262
+ },
12263
+ "revision": {
12264
+ "exclusiveMinimum": 0,
12265
+ "maximum": 9007199254740991,
12266
+ "type": "integer"
12267
+ },
12268
+ "status": { "enum": ["active", "revoked"], "type": "string" }
12269
+ },
12270
+ "required": ["grantRef", "revision", "status", "expiresAt"],
12271
+ "type": "object"
12272
+ },
12273
+ "workspaceId": {}
12274
+ },
12275
+ "required": [
12276
+ "connectionRef",
12277
+ "revision",
12278
+ "workspaceId",
12279
+ "ownerRef",
12280
+ "credentialRef",
12281
+ "credentialRevision",
12282
+ "provider",
12283
+ "accountRef",
12284
+ "authKind",
12285
+ "fundingSource",
12286
+ "status",
12287
+ "models",
12288
+ "workspaceGrant"
12289
+ ],
12290
+ "type": "object"
12291
+ }
12292
+ },
12293
+ "required": ["connection"],
12294
+ "type": "object"
12295
+ },
12296
+ "requestId": {}
12297
+ },
12298
+ "required": ["contractVersion", "requestId", "correlation", "data"],
12299
+ "type": "object"
12300
+ }
12301
+ }
12302
+ },
12303
+ "description": "Successful response"
12304
+ },
12305
+ "default": {
12306
+ "content": {
12307
+ "application/json": {
12308
+ "schema": {
12309
+ "additionalProperties": false,
12310
+ "properties": {
12311
+ "contractVersion": {
12312
+ "additionalProperties": false,
12313
+ "properties": {
12314
+ "major": {
12315
+ "exclusiveMinimum": 0,
12316
+ "maximum": 9007199254740991,
12317
+ "type": "integer"
12318
+ },
12319
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
12320
+ },
12321
+ "required": ["major", "minor"],
12322
+ "type": "object"
12323
+ },
12324
+ "correlation": {
12325
+ "additionalProperties": false,
12326
+ "properties": {
12327
+ "causationCommandId": {},
12328
+ "parentEventId": {},
12329
+ "traceId": {}
12330
+ },
12331
+ "required": ["traceId"],
12332
+ "type": "object"
12333
+ },
12334
+ "error": {
12335
+ "additionalProperties": false,
12336
+ "properties": {
12337
+ "class": {
12338
+ "enum": [
12339
+ "validation",
12340
+ "authentication",
12341
+ "authorization",
12342
+ "conflict",
12343
+ "stale_reference",
12344
+ "capability_mismatch",
12345
+ "runtime_unavailable",
12346
+ "internal"
12347
+ ],
12348
+ "type": "string"
12349
+ },
12350
+ "code": {
12351
+ "maxLength": 96,
12352
+ "minLength": 1,
12353
+ "pattern": "^[A-Z][A-Z0-9_]*$",
12354
+ "type": "string"
12355
+ },
12356
+ "details": {
12357
+ "additionalProperties": {},
12358
+ "propertyNames": { "maxLength": 64, "type": "string" },
12359
+ "type": "object"
12360
+ },
12361
+ "message": { "maxLength": 512, "minLength": 1, "type": "string" },
12362
+ "remediation": { "maxLength": 256, "minLength": 1, "type": "string" },
12363
+ "retryable": { "type": "boolean" },
12364
+ "source": {
12365
+ "enum": [
12366
+ "client",
12367
+ "auth",
12368
+ "policy",
12369
+ "runtime",
12370
+ "provider",
12371
+ "persistence",
12372
+ "workflow",
12373
+ "system"
12374
+ ],
12375
+ "type": "string"
12376
+ }
12377
+ },
12378
+ "required": ["class", "code", "message", "retryable", "source"],
12379
+ "type": "object"
12380
+ },
12381
+ "requestId": {}
12382
+ },
12383
+ "required": ["contractVersion", "requestId", "correlation", "error"],
12384
+ "type": "object"
12385
+ }
12386
+ }
12387
+ },
12388
+ "description": "Normalized error response"
12389
+ }
12390
+ },
12391
+ "security": [{ "serviceBearer": [] }]
12392
+ }
12393
+ },
12394
+ "/v1/model-connections/defaults/get": {
12395
+ "post": {
12396
+ "operationId": "model-defaults.get",
12397
+ "requestBody": {
12398
+ "content": {
12399
+ "application/json": {
12400
+ "schema": {
12401
+ "additionalProperties": false,
12402
+ "properties": {
12403
+ "caller": {
12404
+ "properties": {
12405
+ "servicePrincipalId": {
12406
+ "maxLength": 64,
12407
+ "minLength": 5,
12408
+ "pattern": "^svc_[a-z][a-z0-9-]*$",
12409
+ "type": "string"
12410
+ }
12411
+ },
12412
+ "required": ["servicePrincipalId"],
12413
+ "type": "object"
12414
+ },
12415
+ "contractVersion": {
12416
+ "additionalProperties": false,
12417
+ "properties": {
12418
+ "major": {
12419
+ "exclusiveMinimum": 0,
12420
+ "maximum": 9007199254740991,
12421
+ "type": "integer"
12422
+ },
12423
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
12424
+ },
12425
+ "required": ["major", "minor"],
12426
+ "type": "object"
12427
+ },
12428
+ "correlation": {
12429
+ "properties": {
12430
+ "causationCommandId": {
12431
+ "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$",
12432
+ "type": "string"
12433
+ },
12434
+ "parentEventId": {
12435
+ "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$",
12436
+ "type": "string"
12437
+ },
12438
+ "traceId": { "pattern": "^trc_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
12439
+ },
12440
+ "required": ["traceId"],
12441
+ "type": "object"
12442
+ },
12443
+ "operation": { "const": "model-defaults.get", "type": "string" },
12444
+ "parameters": {
12445
+ "additionalProperties": false,
12446
+ "properties": {},
12447
+ "type": "object"
12448
+ },
12449
+ "requestId": { "pattern": "^req_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
12450
+ "requestedAt": {
12451
+ "format": "date-time",
12452
+ "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))$",
12453
+ "type": "string"
12454
+ },
12455
+ "workspaceId": { "pattern": "^wsp_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
12456
+ },
12457
+ "required": [
12458
+ "caller",
12459
+ "contractVersion",
12460
+ "requestId",
12461
+ "workspaceId",
12462
+ "correlation",
12463
+ "operation",
12464
+ "requestedAt",
12465
+ "parameters"
12466
+ ],
12467
+ "type": "object"
12468
+ }
12469
+ }
12470
+ },
12471
+ "required": true
12472
+ },
12473
+ "responses": {
12474
+ "200": {
12475
+ "content": {
12476
+ "application/json": {
12477
+ "schema": {
12478
+ "additionalProperties": false,
12479
+ "properties": {
12480
+ "contractVersion": {
12481
+ "additionalProperties": false,
12482
+ "properties": {
12483
+ "major": {
12484
+ "exclusiveMinimum": 0,
12485
+ "maximum": 9007199254740991,
12486
+ "type": "integer"
12487
+ },
12488
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
12489
+ },
12490
+ "required": ["major", "minor"],
12491
+ "type": "object"
12492
+ },
12493
+ "correlation": {
12494
+ "additionalProperties": false,
12495
+ "properties": {
12496
+ "causationCommandId": {},
12497
+ "parentEventId": {},
12498
+ "traceId": {}
12499
+ },
12500
+ "required": ["traceId"],
12501
+ "type": "object"
12502
+ },
12503
+ "data": {
12504
+ "additionalProperties": false,
12505
+ "properties": {
12506
+ "defaults": {
12507
+ "anyOf": [
12508
+ {
12509
+ "additionalProperties": false,
12510
+ "properties": {
12511
+ "child": {
12512
+ "additionalProperties": false,
12513
+ "properties": {
12514
+ "connectionRef": {
12515
+ "pattern": "^mconn_[a-f0-9]{32}$",
12516
+ "type": "string"
12517
+ },
12518
+ "providerModel": {
12519
+ "maxLength": 256,
12520
+ "minLength": 1,
12521
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
12522
+ "type": "string"
12523
+ }
12524
+ },
12525
+ "required": ["connectionRef", "providerModel"],
12526
+ "type": "object"
12527
+ },
12528
+ "direct": {
12529
+ "additionalProperties": false,
12530
+ "properties": {
12531
+ "connectionRef": {
12532
+ "pattern": "^mconn_[a-f0-9]{32}$",
12533
+ "type": "string"
12534
+ },
12535
+ "providerModel": {
12536
+ "maxLength": 256,
12537
+ "minLength": 1,
12538
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
12539
+ "type": "string"
12540
+ }
12541
+ },
12542
+ "required": ["connectionRef", "providerModel"],
12543
+ "type": "object"
12544
+ },
12545
+ "lead": {
12546
+ "additionalProperties": false,
12547
+ "properties": {
12548
+ "connectionRef": {
12549
+ "pattern": "^mconn_[a-f0-9]{32}$",
12550
+ "type": "string"
12551
+ },
12552
+ "providerModel": {
12553
+ "maxLength": 256,
12554
+ "minLength": 1,
12555
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
12556
+ "type": "string"
12557
+ }
12558
+ },
12559
+ "required": ["connectionRef", "providerModel"],
12560
+ "type": "object"
12561
+ },
12562
+ "revision": {
12563
+ "exclusiveMinimum": 0,
12564
+ "maximum": 9007199254740991,
12565
+ "type": "integer"
12566
+ },
12567
+ "workspaceId": {}
12568
+ },
12569
+ "required": ["workspaceId", "revision"],
12570
+ "type": "object"
12571
+ },
12572
+ { "type": "null" }
12573
+ ]
12574
+ }
12575
+ },
12576
+ "required": ["defaults"],
12577
+ "type": "object"
12578
+ },
12579
+ "requestId": {}
12580
+ },
12581
+ "required": ["contractVersion", "requestId", "correlation", "data"],
12582
+ "type": "object"
12583
+ }
12584
+ }
12585
+ },
12586
+ "description": "Successful response"
12587
+ },
12588
+ "default": {
12589
+ "content": {
12590
+ "application/json": {
12591
+ "schema": {
12592
+ "additionalProperties": false,
12593
+ "properties": {
12594
+ "contractVersion": {
12595
+ "additionalProperties": false,
12596
+ "properties": {
12597
+ "major": {
12598
+ "exclusiveMinimum": 0,
12599
+ "maximum": 9007199254740991,
12600
+ "type": "integer"
12601
+ },
12602
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
12603
+ },
12604
+ "required": ["major", "minor"],
12605
+ "type": "object"
12606
+ },
12607
+ "correlation": {
12608
+ "additionalProperties": false,
12609
+ "properties": {
12610
+ "causationCommandId": {},
12611
+ "parentEventId": {},
12612
+ "traceId": {}
12613
+ },
12614
+ "required": ["traceId"],
12615
+ "type": "object"
12616
+ },
12617
+ "error": {
12618
+ "additionalProperties": false,
12619
+ "properties": {
12620
+ "class": {
12621
+ "enum": [
12622
+ "validation",
12623
+ "authentication",
12624
+ "authorization",
12625
+ "conflict",
12626
+ "stale_reference",
12627
+ "capability_mismatch",
12628
+ "runtime_unavailable",
12629
+ "internal"
12630
+ ],
12631
+ "type": "string"
12632
+ },
12633
+ "code": {
12634
+ "maxLength": 96,
12635
+ "minLength": 1,
12636
+ "pattern": "^[A-Z][A-Z0-9_]*$",
12637
+ "type": "string"
12638
+ },
12639
+ "details": {
12640
+ "additionalProperties": {},
12641
+ "propertyNames": { "maxLength": 64, "type": "string" },
12642
+ "type": "object"
12643
+ },
12644
+ "message": { "maxLength": 512, "minLength": 1, "type": "string" },
12645
+ "remediation": { "maxLength": 256, "minLength": 1, "type": "string" },
12646
+ "retryable": { "type": "boolean" },
12647
+ "source": {
12648
+ "enum": [
12649
+ "client",
12650
+ "auth",
12651
+ "policy",
12652
+ "runtime",
12653
+ "provider",
12654
+ "persistence",
12655
+ "workflow",
12656
+ "system"
12657
+ ],
12658
+ "type": "string"
12659
+ }
12660
+ },
12661
+ "required": ["class", "code", "message", "retryable", "source"],
12662
+ "type": "object"
12663
+ },
12664
+ "requestId": {}
12665
+ },
12666
+ "required": ["contractVersion", "requestId", "correlation", "error"],
12667
+ "type": "object"
12668
+ }
12669
+ }
12670
+ },
12671
+ "description": "Normalized error response"
12672
+ }
12673
+ },
12674
+ "security": [{ "serviceBearer": [] }]
12675
+ }
12676
+ },
12677
+ "/v1/model-connections/defaults/set": {
12678
+ "post": {
12679
+ "operationId": "model-defaults.set",
12680
+ "requestBody": {
12681
+ "content": {
12682
+ "application/json": {
12683
+ "schema": {
12684
+ "additionalProperties": false,
12685
+ "properties": {
12686
+ "caller": {
12687
+ "properties": {
12688
+ "servicePrincipalId": {
12689
+ "maxLength": 64,
12690
+ "minLength": 5,
12691
+ "pattern": "^svc_[a-z][a-z0-9-]*$",
12692
+ "type": "string"
12693
+ }
12694
+ },
12695
+ "required": ["servicePrincipalId"],
12696
+ "type": "object"
12697
+ },
12698
+ "commandId": { "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
12699
+ "contractVersion": {
12700
+ "additionalProperties": false,
12701
+ "properties": {
12702
+ "major": {
12703
+ "exclusiveMinimum": 0,
12704
+ "maximum": 9007199254740991,
12705
+ "type": "integer"
12706
+ },
12707
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
12708
+ },
12709
+ "required": ["major", "minor"],
12710
+ "type": "object"
12711
+ },
12712
+ "correlation": {
12713
+ "properties": {
12714
+ "causationCommandId": {
12715
+ "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$",
12716
+ "type": "string"
12717
+ },
12718
+ "parentEventId": {
12719
+ "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$",
12720
+ "type": "string"
12721
+ },
12722
+ "traceId": { "pattern": "^trc_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
12723
+ },
12724
+ "required": ["traceId"],
12725
+ "type": "object"
12726
+ },
12727
+ "idempotencyKey": {
12728
+ "maxLength": 128,
12729
+ "minLength": 16,
12730
+ "pattern": "^[A-Za-z0-9._:-]+$",
12731
+ "type": "string"
12732
+ },
12733
+ "issuedAt": {
12734
+ "format": "date-time",
12735
+ "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))$",
12736
+ "type": "string"
12737
+ },
12738
+ "operation": { "const": "model-defaults.set", "type": "string" },
12739
+ "payload": {
12740
+ "additionalProperties": false,
12741
+ "properties": {
12742
+ "child": {
12743
+ "additionalProperties": false,
12744
+ "properties": {
12745
+ "connectionRef": { "pattern": "^mconn_[a-f0-9]{32}$", "type": "string" },
12746
+ "providerModel": {
12747
+ "maxLength": 256,
12748
+ "minLength": 1,
12749
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
12750
+ "type": "string"
12751
+ }
12752
+ },
12753
+ "required": ["connectionRef", "providerModel"],
12754
+ "type": "object"
12755
+ },
12756
+ "direct": {
12757
+ "additionalProperties": false,
12758
+ "properties": {
12759
+ "connectionRef": { "pattern": "^mconn_[a-f0-9]{32}$", "type": "string" },
12760
+ "providerModel": {
12761
+ "maxLength": 256,
12762
+ "minLength": 1,
12763
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
12764
+ "type": "string"
12765
+ }
12766
+ },
12767
+ "required": ["connectionRef", "providerModel"],
12768
+ "type": "object"
12769
+ },
12770
+ "expectedRevision": {
12771
+ "maximum": 9007199254740991,
12772
+ "minimum": 0,
12773
+ "type": "integer"
12774
+ },
12775
+ "lead": {
12776
+ "additionalProperties": false,
12777
+ "properties": {
12778
+ "connectionRef": { "pattern": "^mconn_[a-f0-9]{32}$", "type": "string" },
12779
+ "providerModel": {
12780
+ "maxLength": 256,
12781
+ "minLength": 1,
12782
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
12783
+ "type": "string"
12784
+ }
12785
+ },
12786
+ "required": ["connectionRef", "providerModel"],
12787
+ "type": "object"
12788
+ }
12789
+ },
12790
+ "required": ["expectedRevision"],
12791
+ "type": "object"
12792
+ },
12793
+ "payloadHash": { "pattern": "^[a-f0-9]{64}$", "type": "string" },
12794
+ "requestId": { "pattern": "^req_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
12795
+ "workspaceId": { "pattern": "^wsp_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
12796
+ },
12797
+ "required": [
12798
+ "caller",
12799
+ "contractVersion",
12800
+ "requestId",
12801
+ "workspaceId",
12802
+ "correlation",
12803
+ "commandId",
12804
+ "idempotencyKey",
12805
+ "payloadHash",
12806
+ "operation",
12807
+ "issuedAt",
12808
+ "payload"
12809
+ ],
12810
+ "type": "object"
12811
+ }
12812
+ }
12813
+ },
12814
+ "required": true
12815
+ },
12816
+ "responses": {
12817
+ "200": {
12818
+ "content": {
12819
+ "application/json": {
12820
+ "schema": {
12821
+ "additionalProperties": false,
12822
+ "properties": {
12823
+ "contractVersion": {
12824
+ "additionalProperties": false,
12825
+ "properties": {
12826
+ "major": {
12827
+ "exclusiveMinimum": 0,
12828
+ "maximum": 9007199254740991,
12829
+ "type": "integer"
12830
+ },
12831
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
12832
+ },
12833
+ "required": ["major", "minor"],
12834
+ "type": "object"
12835
+ },
12836
+ "correlation": {
12837
+ "additionalProperties": false,
12838
+ "properties": {
12839
+ "causationCommandId": {},
12840
+ "parentEventId": {},
12841
+ "traceId": {}
12842
+ },
12843
+ "required": ["traceId"],
12844
+ "type": "object"
12845
+ },
12846
+ "data": {
12847
+ "additionalProperties": false,
12848
+ "properties": {
12849
+ "defaults": {
12850
+ "anyOf": [
12851
+ {
12852
+ "additionalProperties": false,
12853
+ "properties": {
12854
+ "child": {
12855
+ "additionalProperties": false,
12856
+ "properties": {
12857
+ "connectionRef": {
12858
+ "pattern": "^mconn_[a-f0-9]{32}$",
12859
+ "type": "string"
12860
+ },
12861
+ "providerModel": {
12862
+ "maxLength": 256,
12863
+ "minLength": 1,
12864
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
12865
+ "type": "string"
12866
+ }
12867
+ },
12868
+ "required": ["connectionRef", "providerModel"],
12869
+ "type": "object"
12870
+ },
12871
+ "direct": {
12872
+ "additionalProperties": false,
12873
+ "properties": {
12874
+ "connectionRef": {
12875
+ "pattern": "^mconn_[a-f0-9]{32}$",
12876
+ "type": "string"
12877
+ },
12878
+ "providerModel": {
12879
+ "maxLength": 256,
12880
+ "minLength": 1,
12881
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
12882
+ "type": "string"
12883
+ }
12884
+ },
12885
+ "required": ["connectionRef", "providerModel"],
12886
+ "type": "object"
12887
+ },
12888
+ "lead": {
12889
+ "additionalProperties": false,
12890
+ "properties": {
12891
+ "connectionRef": {
12892
+ "pattern": "^mconn_[a-f0-9]{32}$",
12893
+ "type": "string"
12894
+ },
12895
+ "providerModel": {
12896
+ "maxLength": 256,
12897
+ "minLength": 1,
12898
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
12899
+ "type": "string"
12900
+ }
12901
+ },
12902
+ "required": ["connectionRef", "providerModel"],
12903
+ "type": "object"
12904
+ },
12905
+ "revision": {
12906
+ "exclusiveMinimum": 0,
12907
+ "maximum": 9007199254740991,
12908
+ "type": "integer"
12909
+ },
12910
+ "workspaceId": {}
12911
+ },
12912
+ "required": ["workspaceId", "revision"],
12913
+ "type": "object"
12914
+ },
12915
+ { "type": "null" }
12916
+ ]
12917
+ }
12918
+ },
12919
+ "required": ["defaults"],
12920
+ "type": "object"
12921
+ },
12922
+ "requestId": {}
12923
+ },
12924
+ "required": ["contractVersion", "requestId", "correlation", "data"],
12925
+ "type": "object"
12926
+ }
12927
+ }
12928
+ },
12929
+ "description": "Successful response"
12930
+ },
12931
+ "default": {
12932
+ "content": {
12933
+ "application/json": {
12934
+ "schema": {
12935
+ "additionalProperties": false,
12936
+ "properties": {
12937
+ "contractVersion": {
12938
+ "additionalProperties": false,
12939
+ "properties": {
12940
+ "major": {
12941
+ "exclusiveMinimum": 0,
12942
+ "maximum": 9007199254740991,
12943
+ "type": "integer"
12944
+ },
12945
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
12946
+ },
12947
+ "required": ["major", "minor"],
12948
+ "type": "object"
12949
+ },
12950
+ "correlation": {
12951
+ "additionalProperties": false,
12952
+ "properties": {
12953
+ "causationCommandId": {},
12954
+ "parentEventId": {},
12955
+ "traceId": {}
12956
+ },
12957
+ "required": ["traceId"],
12958
+ "type": "object"
12959
+ },
12960
+ "error": {
12961
+ "additionalProperties": false,
12962
+ "properties": {
12963
+ "class": {
12964
+ "enum": [
12965
+ "validation",
12966
+ "authentication",
12967
+ "authorization",
12968
+ "conflict",
12969
+ "stale_reference",
12970
+ "capability_mismatch",
12971
+ "runtime_unavailable",
12972
+ "internal"
12973
+ ],
12974
+ "type": "string"
12975
+ },
12976
+ "code": {
12977
+ "maxLength": 96,
12978
+ "minLength": 1,
12979
+ "pattern": "^[A-Z][A-Z0-9_]*$",
12980
+ "type": "string"
12981
+ },
12982
+ "details": {
12983
+ "additionalProperties": {},
12984
+ "propertyNames": { "maxLength": 64, "type": "string" },
12985
+ "type": "object"
12986
+ },
12987
+ "message": { "maxLength": 512, "minLength": 1, "type": "string" },
12988
+ "remediation": { "maxLength": 256, "minLength": 1, "type": "string" },
12989
+ "retryable": { "type": "boolean" },
12990
+ "source": {
12991
+ "enum": [
12992
+ "client",
12993
+ "auth",
12994
+ "policy",
12995
+ "runtime",
12996
+ "provider",
12997
+ "persistence",
12998
+ "workflow",
12999
+ "system"
13000
+ ],
13001
+ "type": "string"
13002
+ }
13003
+ },
13004
+ "required": ["class", "code", "message", "retryable", "source"],
13005
+ "type": "object"
13006
+ },
13007
+ "requestId": {}
13008
+ },
13009
+ "required": ["contractVersion", "requestId", "correlation", "error"],
13010
+ "type": "object"
13011
+ }
13012
+ }
13013
+ },
13014
+ "description": "Normalized error response"
13015
+ }
13016
+ },
13017
+ "security": [{ "serviceBearer": [] }]
13018
+ }
13019
+ },
13020
+ "/v1/model-connections/list": {
13021
+ "post": {
13022
+ "operationId": "model-connections.list",
13023
+ "requestBody": {
13024
+ "content": {
13025
+ "application/json": {
13026
+ "schema": {
13027
+ "additionalProperties": false,
13028
+ "properties": {
13029
+ "caller": {
13030
+ "properties": {
13031
+ "servicePrincipalId": {
13032
+ "maxLength": 64,
13033
+ "minLength": 5,
13034
+ "pattern": "^svc_[a-z][a-z0-9-]*$",
13035
+ "type": "string"
13036
+ }
13037
+ },
13038
+ "required": ["servicePrincipalId"],
13039
+ "type": "object"
13040
+ },
13041
+ "contractVersion": {
13042
+ "additionalProperties": false,
13043
+ "properties": {
13044
+ "major": {
13045
+ "exclusiveMinimum": 0,
13046
+ "maximum": 9007199254740991,
13047
+ "type": "integer"
13048
+ },
13049
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
13050
+ },
13051
+ "required": ["major", "minor"],
13052
+ "type": "object"
13053
+ },
13054
+ "correlation": {
13055
+ "properties": {
13056
+ "causationCommandId": {
13057
+ "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$",
13058
+ "type": "string"
13059
+ },
13060
+ "parentEventId": {
13061
+ "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$",
13062
+ "type": "string"
13063
+ },
13064
+ "traceId": { "pattern": "^trc_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
13065
+ },
13066
+ "required": ["traceId"],
13067
+ "type": "object"
13068
+ },
13069
+ "operation": { "const": "model-connections.list", "type": "string" },
13070
+ "parameters": {
13071
+ "additionalProperties": false,
13072
+ "properties": {
13073
+ "target": {
13074
+ "additionalProperties": false,
13075
+ "properties": {
13076
+ "harness": {
13077
+ "enum": ["pi", "pi_durable", "cloudflare_agents", "acp"],
13078
+ "type": "string"
13079
+ },
13080
+ "harnessVersion": {
13081
+ "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$",
13082
+ "type": "string"
13083
+ },
13084
+ "location": {
13085
+ "enum": ["local_device", "remote_host", "agent_hq_cloud"],
13086
+ "type": "string"
13087
+ },
13088
+ "providerBinding": {
13089
+ "enum": [
13090
+ "pi_model_runtime",
13091
+ "pi_durable_models",
13092
+ "cloudflare_binding",
13093
+ "native_harness"
13094
+ ],
13095
+ "type": "string"
13096
+ }
13097
+ },
13098
+ "required": ["location", "harness", "harnessVersion", "providerBinding"],
13099
+ "type": "object"
13100
+ }
13101
+ },
13102
+ "required": ["target"],
13103
+ "type": "object"
13104
+ },
13105
+ "requestId": { "pattern": "^req_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
13106
+ "requestedAt": {
13107
+ "format": "date-time",
13108
+ "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))$",
13109
+ "type": "string"
13110
+ },
13111
+ "workspaceId": { "pattern": "^wsp_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
13112
+ },
13113
+ "required": [
13114
+ "caller",
13115
+ "contractVersion",
13116
+ "requestId",
13117
+ "workspaceId",
13118
+ "correlation",
13119
+ "operation",
13120
+ "requestedAt",
13121
+ "parameters"
13122
+ ],
13123
+ "type": "object"
13124
+ }
13125
+ }
13126
+ },
13127
+ "required": true
13128
+ },
13129
+ "responses": {
13130
+ "200": {
13131
+ "content": {
13132
+ "application/json": {
13133
+ "schema": {
13134
+ "additionalProperties": false,
13135
+ "properties": {
13136
+ "contractVersion": {
13137
+ "additionalProperties": false,
13138
+ "properties": {
13139
+ "major": {
13140
+ "exclusiveMinimum": 0,
13141
+ "maximum": 9007199254740991,
13142
+ "type": "integer"
13143
+ },
13144
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
13145
+ },
13146
+ "required": ["major", "minor"],
13147
+ "type": "object"
13148
+ },
13149
+ "correlation": {
13150
+ "additionalProperties": false,
13151
+ "properties": {
13152
+ "causationCommandId": {},
13153
+ "parentEventId": {},
13154
+ "traceId": {}
13155
+ },
13156
+ "required": ["traceId"],
13157
+ "type": "object"
13158
+ },
13159
+ "data": {
13160
+ "additionalProperties": false,
13161
+ "properties": {
13162
+ "connections": {
13163
+ "items": {
13164
+ "additionalProperties": false,
13165
+ "properties": {
13166
+ "connection": {
13167
+ "additionalProperties": false,
13168
+ "properties": {
13169
+ "accountRef": {
13170
+ "maxLength": 256,
13171
+ "minLength": 1,
13172
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
13173
+ "type": "string"
13174
+ },
13175
+ "authKind": {
13176
+ "enum": ["api_key", "provider_subscription", "local_runtime"],
13177
+ "type": "string"
13178
+ },
13179
+ "connectionRef": {
13180
+ "pattern": "^mconn_[a-f0-9]{32}$",
13181
+ "type": "string"
13182
+ },
13183
+ "credentialRef": {},
13184
+ "credentialRevision": {
13185
+ "exclusiveMinimum": 0,
13186
+ "maximum": 9007199254740991,
13187
+ "type": "integer"
13188
+ },
13189
+ "fundingSource": {
13190
+ "enum": ["hq_managed", "external_subscription", "byo_api"],
13191
+ "type": "string"
13192
+ },
13193
+ "models": {
13194
+ "items": {
13195
+ "maxLength": 256,
13196
+ "minLength": 1,
13197
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
13198
+ "type": "string"
13199
+ },
13200
+ "maxItems": 256,
13201
+ "minItems": 1,
13202
+ "type": "array"
13203
+ },
13204
+ "ownerRef": {
13205
+ "maxLength": 256,
13206
+ "minLength": 1,
13207
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
13208
+ "type": "string"
13209
+ },
13210
+ "provider": {
13211
+ "maxLength": 128,
13212
+ "minLength": 1,
13213
+ "pattern": "^[a-z][a-z0-9.-]*$",
13214
+ "type": "string"
13215
+ },
13216
+ "revision": {
13217
+ "exclusiveMinimum": 0,
13218
+ "maximum": 9007199254740991,
13219
+ "type": "integer"
13220
+ },
13221
+ "status": { "enum": ["active", "revoked"], "type": "string" },
13222
+ "workspaceGrant": {
13223
+ "additionalProperties": false,
13224
+ "properties": {
13225
+ "expiresAt": {
13226
+ "format": "date-time",
13227
+ "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))$",
13228
+ "type": "string"
13229
+ },
13230
+ "grantRef": {
13231
+ "maxLength": 256,
13232
+ "minLength": 1,
13233
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
13234
+ "type": "string"
13235
+ },
13236
+ "revision": {
13237
+ "exclusiveMinimum": 0,
13238
+ "maximum": 9007199254740991,
13239
+ "type": "integer"
13240
+ },
13241
+ "status": { "enum": ["active", "revoked"], "type": "string" }
13242
+ },
13243
+ "required": ["grantRef", "revision", "status", "expiresAt"],
13244
+ "type": "object"
13245
+ },
13246
+ "workspaceId": {}
13247
+ },
13248
+ "required": [
13249
+ "connectionRef",
13250
+ "revision",
13251
+ "workspaceId",
13252
+ "ownerRef",
13253
+ "credentialRef",
13254
+ "credentialRevision",
13255
+ "provider",
13256
+ "accountRef",
13257
+ "authKind",
13258
+ "fundingSource",
13259
+ "status",
13260
+ "models",
13261
+ "workspaceGrant"
13262
+ ],
13263
+ "type": "object"
13264
+ },
13265
+ "models": {
13266
+ "items": {
13267
+ "additionalProperties": false,
13268
+ "properties": {
13269
+ "providerModel": {
13270
+ "maxLength": 256,
13271
+ "minLength": 1,
13272
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
13273
+ "type": "string"
13274
+ },
13275
+ "readiness": {
13276
+ "additionalProperties": false,
13277
+ "properties": {
13278
+ "ready": { "type": "boolean" },
13279
+ "reasonCode": {
13280
+ "enum": [
13281
+ "READY",
13282
+ "CONNECTION_MISSING",
13283
+ "CONNECTION_REVOKED",
13284
+ "CREDENTIAL_MISSING",
13285
+ "CREDENTIAL_EXPIRED",
13286
+ "CREDENTIAL_REVOKED",
13287
+ "CREDENTIAL_REVISION_CHANGED",
13288
+ "WORKSPACE_GRANT_EXPIRED",
13289
+ "WORKSPACE_GRANT_REVOKED",
13290
+ "SELECTION_CHANGED",
13291
+ "MODEL_UNAVAILABLE",
13292
+ "QUOTA_EXHAUSTED",
13293
+ "INCOMPATIBLE_HARNESS",
13294
+ "INCOMPATIBLE_LOCATION",
13295
+ "AUTH_MODE_UNSUPPORTED",
13296
+ "PROVIDER_POLICY_DENIED",
13297
+ "READINESS_UNAVAILABLE"
13298
+ ],
13299
+ "type": "string"
13300
+ }
13301
+ },
13302
+ "required": ["ready", "reasonCode"],
13303
+ "type": "object"
13304
+ }
13305
+ },
13306
+ "required": ["providerModel", "readiness"],
13307
+ "type": "object"
13308
+ },
13309
+ "maxItems": 256,
13310
+ "type": "array"
13311
+ }
13312
+ },
13313
+ "required": ["connection", "models"],
13314
+ "type": "object"
13315
+ },
13316
+ "maxItems": 128,
13317
+ "type": "array"
13318
+ }
13319
+ },
13320
+ "required": ["connections"],
13321
+ "type": "object"
13322
+ },
13323
+ "requestId": {}
13324
+ },
13325
+ "required": ["contractVersion", "requestId", "correlation", "data"],
13326
+ "type": "object"
13327
+ }
13328
+ }
13329
+ },
13330
+ "description": "Successful response"
13331
+ },
13332
+ "default": {
13333
+ "content": {
13334
+ "application/json": {
13335
+ "schema": {
13336
+ "additionalProperties": false,
13337
+ "properties": {
13338
+ "contractVersion": {
13339
+ "additionalProperties": false,
13340
+ "properties": {
13341
+ "major": {
13342
+ "exclusiveMinimum": 0,
13343
+ "maximum": 9007199254740991,
13344
+ "type": "integer"
13345
+ },
13346
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
13347
+ },
13348
+ "required": ["major", "minor"],
13349
+ "type": "object"
13350
+ },
13351
+ "correlation": {
13352
+ "additionalProperties": false,
13353
+ "properties": {
13354
+ "causationCommandId": {},
13355
+ "parentEventId": {},
13356
+ "traceId": {}
13357
+ },
13358
+ "required": ["traceId"],
13359
+ "type": "object"
13360
+ },
13361
+ "error": {
13362
+ "additionalProperties": false,
13363
+ "properties": {
13364
+ "class": {
13365
+ "enum": [
13366
+ "validation",
13367
+ "authentication",
13368
+ "authorization",
13369
+ "conflict",
13370
+ "stale_reference",
13371
+ "capability_mismatch",
13372
+ "runtime_unavailable",
13373
+ "internal"
13374
+ ],
13375
+ "type": "string"
13376
+ },
13377
+ "code": {
13378
+ "maxLength": 96,
13379
+ "minLength": 1,
13380
+ "pattern": "^[A-Z][A-Z0-9_]*$",
13381
+ "type": "string"
13382
+ },
13383
+ "details": {
13384
+ "additionalProperties": {},
13385
+ "propertyNames": { "maxLength": 64, "type": "string" },
13386
+ "type": "object"
13387
+ },
13388
+ "message": { "maxLength": 512, "minLength": 1, "type": "string" },
13389
+ "remediation": { "maxLength": 256, "minLength": 1, "type": "string" },
13390
+ "retryable": { "type": "boolean" },
13391
+ "source": {
13392
+ "enum": [
13393
+ "client",
13394
+ "auth",
13395
+ "policy",
13396
+ "runtime",
13397
+ "provider",
13398
+ "persistence",
13399
+ "workflow",
13400
+ "system"
13401
+ ],
13402
+ "type": "string"
13403
+ }
13404
+ },
13405
+ "required": ["class", "code", "message", "retryable", "source"],
13406
+ "type": "object"
13407
+ },
13408
+ "requestId": {}
13409
+ },
13410
+ "required": ["contractVersion", "requestId", "correlation", "error"],
13411
+ "type": "object"
13412
+ }
13413
+ }
13414
+ },
13415
+ "description": "Normalized error response"
13416
+ }
13417
+ },
13418
+ "security": [{ "serviceBearer": [] }]
13419
+ }
13420
+ },
13421
+ "/v1/model-connections/revoke": {
13422
+ "post": {
13423
+ "operationId": "model-connections.revoke",
13424
+ "requestBody": {
13425
+ "content": {
13426
+ "application/json": {
13427
+ "schema": {
13428
+ "additionalProperties": false,
13429
+ "properties": {
13430
+ "caller": {
13431
+ "properties": {
13432
+ "servicePrincipalId": {
13433
+ "maxLength": 64,
13434
+ "minLength": 5,
13435
+ "pattern": "^svc_[a-z][a-z0-9-]*$",
13436
+ "type": "string"
13437
+ }
13438
+ },
13439
+ "required": ["servicePrincipalId"],
13440
+ "type": "object"
13441
+ },
13442
+ "commandId": { "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
13443
+ "contractVersion": {
13444
+ "additionalProperties": false,
13445
+ "properties": {
13446
+ "major": {
13447
+ "exclusiveMinimum": 0,
13448
+ "maximum": 9007199254740991,
13449
+ "type": "integer"
13450
+ },
13451
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
13452
+ },
13453
+ "required": ["major", "minor"],
13454
+ "type": "object"
13455
+ },
13456
+ "correlation": {
13457
+ "properties": {
13458
+ "causationCommandId": {
13459
+ "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$",
13460
+ "type": "string"
13461
+ },
13462
+ "parentEventId": {
13463
+ "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$",
13464
+ "type": "string"
13465
+ },
13466
+ "traceId": { "pattern": "^trc_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
13467
+ },
13468
+ "required": ["traceId"],
13469
+ "type": "object"
13470
+ },
13471
+ "idempotencyKey": {
13472
+ "maxLength": 128,
13473
+ "minLength": 16,
13474
+ "pattern": "^[A-Za-z0-9._:-]+$",
13475
+ "type": "string"
13476
+ },
13477
+ "issuedAt": {
13478
+ "format": "date-time",
13479
+ "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))$",
13480
+ "type": "string"
13481
+ },
13482
+ "operation": { "const": "model-connections.revoke", "type": "string" },
13483
+ "payload": {
13484
+ "additionalProperties": false,
13485
+ "properties": {
13486
+ "connectionRef": { "pattern": "^mconn_[a-f0-9]{32}$", "type": "string" },
13487
+ "expectedRevision": {
13488
+ "exclusiveMinimum": 0,
13489
+ "maximum": 9007199254740991,
13490
+ "type": "integer"
13491
+ }
13492
+ },
13493
+ "required": ["connectionRef", "expectedRevision"],
13494
+ "type": "object"
13495
+ },
13496
+ "payloadHash": { "pattern": "^[a-f0-9]{64}$", "type": "string" },
13497
+ "requestId": { "pattern": "^req_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
13498
+ "workspaceId": { "pattern": "^wsp_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
13499
+ },
13500
+ "required": [
13501
+ "caller",
13502
+ "contractVersion",
13503
+ "requestId",
13504
+ "workspaceId",
13505
+ "correlation",
13506
+ "commandId",
13507
+ "idempotencyKey",
13508
+ "payloadHash",
13509
+ "operation",
13510
+ "issuedAt",
13511
+ "payload"
13512
+ ],
13513
+ "type": "object"
13514
+ }
13515
+ }
13516
+ },
13517
+ "required": true
13518
+ },
13519
+ "responses": {
13520
+ "200": {
13521
+ "content": {
13522
+ "application/json": {
13523
+ "schema": {
13524
+ "additionalProperties": false,
13525
+ "properties": {
13526
+ "contractVersion": {
13527
+ "additionalProperties": false,
13528
+ "properties": {
13529
+ "major": {
13530
+ "exclusiveMinimum": 0,
13531
+ "maximum": 9007199254740991,
13532
+ "type": "integer"
13533
+ },
13534
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
13535
+ },
13536
+ "required": ["major", "minor"],
13537
+ "type": "object"
13538
+ },
13539
+ "correlation": {
13540
+ "additionalProperties": false,
13541
+ "properties": {
13542
+ "causationCommandId": {},
13543
+ "parentEventId": {},
13544
+ "traceId": {}
13545
+ },
13546
+ "required": ["traceId"],
13547
+ "type": "object"
13548
+ },
13549
+ "data": {
13550
+ "additionalProperties": false,
13551
+ "properties": {
13552
+ "connection": {
13553
+ "additionalProperties": false,
13554
+ "properties": {
13555
+ "accountRef": {
13556
+ "maxLength": 256,
13557
+ "minLength": 1,
13558
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
13559
+ "type": "string"
13560
+ },
13561
+ "authKind": {
13562
+ "enum": ["api_key", "provider_subscription", "local_runtime"],
13563
+ "type": "string"
13564
+ },
13565
+ "connectionRef": {
13566
+ "pattern": "^mconn_[a-f0-9]{32}$",
13567
+ "type": "string"
13568
+ },
13569
+ "credentialRef": {},
13570
+ "credentialRevision": {
13571
+ "exclusiveMinimum": 0,
13572
+ "maximum": 9007199254740991,
13573
+ "type": "integer"
13574
+ },
13575
+ "fundingSource": {
13576
+ "enum": ["hq_managed", "external_subscription", "byo_api"],
13577
+ "type": "string"
13578
+ },
13579
+ "models": {
13580
+ "items": {
13581
+ "maxLength": 256,
13582
+ "minLength": 1,
13583
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
13584
+ "type": "string"
13585
+ },
13586
+ "maxItems": 256,
13587
+ "minItems": 1,
13588
+ "type": "array"
13589
+ },
13590
+ "ownerRef": {
13591
+ "maxLength": 256,
13592
+ "minLength": 1,
13593
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
13594
+ "type": "string"
13595
+ },
13596
+ "provider": {
13597
+ "maxLength": 128,
13598
+ "minLength": 1,
13599
+ "pattern": "^[a-z][a-z0-9.-]*$",
13600
+ "type": "string"
13601
+ },
13602
+ "revision": {
13603
+ "exclusiveMinimum": 0,
13604
+ "maximum": 9007199254740991,
13605
+ "type": "integer"
13606
+ },
13607
+ "status": { "enum": ["active", "revoked"], "type": "string" },
13608
+ "workspaceGrant": {
13609
+ "additionalProperties": false,
13610
+ "properties": {
13611
+ "expiresAt": {
13612
+ "format": "date-time",
13613
+ "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))$",
13614
+ "type": "string"
13615
+ },
13616
+ "grantRef": {
13617
+ "maxLength": 256,
13618
+ "minLength": 1,
13619
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
13620
+ "type": "string"
13621
+ },
13622
+ "revision": {
13623
+ "exclusiveMinimum": 0,
13624
+ "maximum": 9007199254740991,
13625
+ "type": "integer"
13626
+ },
13627
+ "status": { "enum": ["active", "revoked"], "type": "string" }
13628
+ },
13629
+ "required": ["grantRef", "revision", "status", "expiresAt"],
13630
+ "type": "object"
13631
+ },
13632
+ "workspaceId": {}
13633
+ },
13634
+ "required": [
13635
+ "connectionRef",
13636
+ "revision",
13637
+ "workspaceId",
13638
+ "ownerRef",
13639
+ "credentialRef",
13640
+ "credentialRevision",
13641
+ "provider",
13642
+ "accountRef",
13643
+ "authKind",
13644
+ "fundingSource",
13645
+ "status",
13646
+ "models",
13647
+ "workspaceGrant"
13648
+ ],
13649
+ "type": "object"
13650
+ }
13651
+ },
13652
+ "required": ["connection"],
13653
+ "type": "object"
13654
+ },
13655
+ "requestId": {}
13656
+ },
13657
+ "required": ["contractVersion", "requestId", "correlation", "data"],
13658
+ "type": "object"
13659
+ }
13660
+ }
13661
+ },
13662
+ "description": "Successful response"
13663
+ },
13664
+ "default": {
13665
+ "content": {
13666
+ "application/json": {
13667
+ "schema": {
13668
+ "additionalProperties": false,
13669
+ "properties": {
13670
+ "contractVersion": {
13671
+ "additionalProperties": false,
13672
+ "properties": {
13673
+ "major": {
13674
+ "exclusiveMinimum": 0,
13675
+ "maximum": 9007199254740991,
13676
+ "type": "integer"
13677
+ },
13678
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
13679
+ },
13680
+ "required": ["major", "minor"],
13681
+ "type": "object"
13682
+ },
13683
+ "correlation": {
13684
+ "additionalProperties": false,
13685
+ "properties": {
13686
+ "causationCommandId": {},
13687
+ "parentEventId": {},
13688
+ "traceId": {}
13689
+ },
13690
+ "required": ["traceId"],
13691
+ "type": "object"
13692
+ },
13693
+ "error": {
13694
+ "additionalProperties": false,
13695
+ "properties": {
13696
+ "class": {
13697
+ "enum": [
13698
+ "validation",
13699
+ "authentication",
13700
+ "authorization",
13701
+ "conflict",
13702
+ "stale_reference",
13703
+ "capability_mismatch",
13704
+ "runtime_unavailable",
13705
+ "internal"
13706
+ ],
13707
+ "type": "string"
13708
+ },
13709
+ "code": {
13710
+ "maxLength": 96,
13711
+ "minLength": 1,
13712
+ "pattern": "^[A-Z][A-Z0-9_]*$",
13713
+ "type": "string"
13714
+ },
13715
+ "details": {
13716
+ "additionalProperties": {},
13717
+ "propertyNames": { "maxLength": 64, "type": "string" },
13718
+ "type": "object"
13719
+ },
13720
+ "message": { "maxLength": 512, "minLength": 1, "type": "string" },
13721
+ "remediation": { "maxLength": 256, "minLength": 1, "type": "string" },
13722
+ "retryable": { "type": "boolean" },
13723
+ "source": {
13724
+ "enum": [
13725
+ "client",
13726
+ "auth",
13727
+ "policy",
13728
+ "runtime",
13729
+ "provider",
13730
+ "persistence",
13731
+ "workflow",
13732
+ "system"
13733
+ ],
13734
+ "type": "string"
13735
+ }
13736
+ },
13737
+ "required": ["class", "code", "message", "retryable", "source"],
13738
+ "type": "object"
13739
+ },
13740
+ "requestId": {}
13741
+ },
13742
+ "required": ["contractVersion", "requestId", "correlation", "error"],
13743
+ "type": "object"
13744
+ }
13745
+ }
13746
+ },
13747
+ "description": "Normalized error response"
13748
+ }
13749
+ },
13750
+ "security": [{ "serviceBearer": [] }]
13751
+ }
13752
+ },
13753
+ "/v1/model-connections/selection/resolve": {
13754
+ "post": {
13755
+ "operationId": "model-selection.resolve",
13756
+ "requestBody": {
13757
+ "content": {
13758
+ "application/json": {
13759
+ "schema": {
13760
+ "additionalProperties": false,
13761
+ "properties": {
13762
+ "caller": {
13763
+ "properties": {
13764
+ "servicePrincipalId": {
13765
+ "maxLength": 64,
13766
+ "minLength": 5,
13767
+ "pattern": "^svc_[a-z][a-z0-9-]*$",
13768
+ "type": "string"
13769
+ }
13770
+ },
13771
+ "required": ["servicePrincipalId"],
13772
+ "type": "object"
13773
+ },
13774
+ "contractVersion": {
13775
+ "additionalProperties": false,
13776
+ "properties": {
13777
+ "major": {
13778
+ "exclusiveMinimum": 0,
13779
+ "maximum": 9007199254740991,
13780
+ "type": "integer"
13781
+ },
13782
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
13783
+ },
13784
+ "required": ["major", "minor"],
13785
+ "type": "object"
13786
+ },
13787
+ "correlation": {
13788
+ "properties": {
13789
+ "causationCommandId": {
13790
+ "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$",
13791
+ "type": "string"
13792
+ },
13793
+ "parentEventId": {
13794
+ "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$",
13795
+ "type": "string"
13796
+ },
13797
+ "traceId": { "pattern": "^trc_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
13798
+ },
13799
+ "required": ["traceId"],
13800
+ "type": "object"
13801
+ },
13802
+ "operation": { "const": "model-selection.resolve", "type": "string" },
13803
+ "parameters": {
13804
+ "additionalProperties": false,
13805
+ "properties": {
13806
+ "override": {
13807
+ "additionalProperties": false,
13808
+ "properties": {
13809
+ "connectionRef": { "pattern": "^mconn_[a-f0-9]{32}$", "type": "string" },
13810
+ "providerModel": {
13811
+ "maxLength": 256,
13812
+ "minLength": 1,
13813
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
13814
+ "type": "string"
13815
+ }
13816
+ },
13817
+ "required": ["connectionRef", "providerModel"],
13818
+ "type": "object"
13819
+ },
13820
+ "role": { "enum": ["lead", "child", "direct"], "type": "string" },
13821
+ "target": {
13822
+ "additionalProperties": false,
13823
+ "properties": {
13824
+ "harness": {
13825
+ "enum": ["pi", "pi_durable", "cloudflare_agents", "acp"],
13826
+ "type": "string"
13827
+ },
13828
+ "harnessVersion": {
13829
+ "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$",
13830
+ "type": "string"
13831
+ },
13832
+ "location": {
13833
+ "enum": ["local_device", "remote_host", "agent_hq_cloud"],
13834
+ "type": "string"
13835
+ },
13836
+ "providerBinding": {
13837
+ "enum": [
13838
+ "pi_model_runtime",
13839
+ "pi_durable_models",
13840
+ "cloudflare_binding",
13841
+ "native_harness"
13842
+ ],
13843
+ "type": "string"
13844
+ }
13845
+ },
13846
+ "required": ["location", "harness", "harnessVersion", "providerBinding"],
13847
+ "type": "object"
13848
+ }
13849
+ },
13850
+ "required": ["role", "target"],
13851
+ "type": "object"
13852
+ },
13853
+ "requestId": { "pattern": "^req_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
13854
+ "requestedAt": {
13855
+ "format": "date-time",
13856
+ "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))$",
13857
+ "type": "string"
13858
+ },
13859
+ "workspaceId": { "pattern": "^wsp_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
13860
+ },
13861
+ "required": [
13862
+ "caller",
13863
+ "contractVersion",
13864
+ "requestId",
13865
+ "workspaceId",
13866
+ "correlation",
13867
+ "operation",
13868
+ "requestedAt",
13869
+ "parameters"
13870
+ ],
13871
+ "type": "object"
13872
+ }
13873
+ }
13874
+ },
13875
+ "required": true
13876
+ },
13877
+ "responses": {
13878
+ "200": {
13879
+ "content": {
13880
+ "application/json": {
13881
+ "schema": {
13882
+ "additionalProperties": false,
13883
+ "properties": {
13884
+ "contractVersion": {
13885
+ "additionalProperties": false,
13886
+ "properties": {
13887
+ "major": {
13888
+ "exclusiveMinimum": 0,
13889
+ "maximum": 9007199254740991,
13890
+ "type": "integer"
13891
+ },
13892
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
13893
+ },
13894
+ "required": ["major", "minor"],
13895
+ "type": "object"
13896
+ },
13897
+ "correlation": {
13898
+ "additionalProperties": false,
13899
+ "properties": {
13900
+ "causationCommandId": {},
13901
+ "parentEventId": {},
13902
+ "traceId": {}
13903
+ },
13904
+ "required": ["traceId"],
13905
+ "type": "object"
13906
+ },
13907
+ "data": {
13908
+ "additionalProperties": false,
13909
+ "properties": {
13910
+ "selection": {
13911
+ "additionalProperties": false,
13912
+ "properties": {
13913
+ "accountRef": {
13914
+ "maxLength": 256,
13915
+ "minLength": 1,
13916
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
13917
+ "type": "string"
13918
+ },
13919
+ "authKind": {
13920
+ "enum": ["api_key", "provider_subscription", "local_runtime"],
13921
+ "type": "string"
13922
+ },
13923
+ "configurationRevision": {
13924
+ "exclusiveMinimum": 0,
13925
+ "maximum": 9007199254740991,
13926
+ "type": "integer"
13927
+ },
13928
+ "connectionRef": {
13929
+ "pattern": "^mconn_[a-f0-9]{32}$",
13930
+ "type": "string"
13931
+ },
13932
+ "connectionRevision": {
13933
+ "exclusiveMinimum": 0,
13934
+ "maximum": 9007199254740991,
13935
+ "type": "integer"
13936
+ },
13937
+ "credentialRef": {},
13938
+ "credentialRevision": {
13939
+ "exclusiveMinimum": 0,
13940
+ "maximum": 9007199254740991,
13941
+ "type": "integer"
13942
+ },
13943
+ "fundingSource": {
13944
+ "enum": ["hq_managed", "external_subscription", "byo_api"],
13945
+ "type": "string"
13946
+ },
13947
+ "harness": {
13948
+ "enum": ["pi", "pi_durable", "cloudflare_agents", "acp"],
13949
+ "type": "string"
13950
+ },
13951
+ "harnessVersion": {
13952
+ "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$",
13953
+ "type": "string"
13954
+ },
13955
+ "location": {
13956
+ "enum": ["local_device", "remote_host", "agent_hq_cloud"],
13957
+ "type": "string"
13958
+ },
13959
+ "provider": {
13960
+ "maxLength": 128,
13961
+ "minLength": 1,
13962
+ "pattern": "^[a-z][a-z0-9.-]*$",
13963
+ "type": "string"
13964
+ },
13965
+ "providerBinding": {
13966
+ "enum": [
13967
+ "pi_model_runtime",
13968
+ "pi_durable_models",
13969
+ "cloudflare_binding",
13970
+ "native_harness"
13971
+ ],
13972
+ "type": "string"
13973
+ },
13974
+ "providerModel": {
13975
+ "maxLength": 256,
13976
+ "minLength": 1,
13977
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
13978
+ "type": "string"
13979
+ },
13980
+ "schemaVersion": { "const": "model-selection/v1", "type": "string" },
13981
+ "selectionRef": { "pattern": "^msel_[a-f0-9]{32}$", "type": "string" },
13982
+ "selectionRevision": {
13983
+ "exclusiveMinimum": 0,
13984
+ "maximum": 9007199254740991,
13985
+ "type": "integer"
13986
+ },
13987
+ "workspaceGrant": {
13988
+ "additionalProperties": false,
13989
+ "properties": {
13990
+ "grantRef": {
13991
+ "maxLength": 256,
13992
+ "minLength": 1,
13993
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
13994
+ "type": "string"
13995
+ },
13996
+ "revision": {
13997
+ "exclusiveMinimum": 0,
13998
+ "maximum": 9007199254740991,
13999
+ "type": "integer"
14000
+ }
14001
+ },
14002
+ "required": ["grantRef", "revision"],
14003
+ "type": "object"
14004
+ },
14005
+ "workspaceId": {}
14006
+ },
14007
+ "required": [
14008
+ "schemaVersion",
14009
+ "selectionRef",
14010
+ "selectionRevision",
14011
+ "workspaceId",
14012
+ "connectionRef",
14013
+ "connectionRevision",
14014
+ "credentialRef",
14015
+ "credentialRevision",
14016
+ "provider",
14017
+ "accountRef",
14018
+ "authKind",
14019
+ "fundingSource",
14020
+ "providerModel",
14021
+ "location",
14022
+ "harness",
14023
+ "harnessVersion",
14024
+ "providerBinding",
14025
+ "workspaceGrant",
14026
+ "configurationRevision"
14027
+ ],
14028
+ "type": "object"
14029
+ }
14030
+ },
14031
+ "required": ["selection"],
14032
+ "type": "object"
14033
+ },
14034
+ "requestId": {}
14035
+ },
14036
+ "required": ["contractVersion", "requestId", "correlation", "data"],
14037
+ "type": "object"
14038
+ }
14039
+ }
14040
+ },
14041
+ "description": "Successful response"
14042
+ },
14043
+ "default": {
14044
+ "content": {
14045
+ "application/json": {
14046
+ "schema": {
14047
+ "additionalProperties": false,
14048
+ "properties": {
14049
+ "contractVersion": {
14050
+ "additionalProperties": false,
14051
+ "properties": {
14052
+ "major": {
14053
+ "exclusiveMinimum": 0,
14054
+ "maximum": 9007199254740991,
14055
+ "type": "integer"
14056
+ },
14057
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
14058
+ },
14059
+ "required": ["major", "minor"],
14060
+ "type": "object"
14061
+ },
14062
+ "correlation": {
14063
+ "additionalProperties": false,
14064
+ "properties": {
14065
+ "causationCommandId": {},
14066
+ "parentEventId": {},
14067
+ "traceId": {}
14068
+ },
14069
+ "required": ["traceId"],
14070
+ "type": "object"
14071
+ },
14072
+ "error": {
14073
+ "additionalProperties": false,
14074
+ "properties": {
14075
+ "class": {
14076
+ "enum": [
14077
+ "validation",
14078
+ "authentication",
14079
+ "authorization",
14080
+ "conflict",
14081
+ "stale_reference",
14082
+ "capability_mismatch",
14083
+ "runtime_unavailable",
14084
+ "internal"
14085
+ ],
14086
+ "type": "string"
14087
+ },
14088
+ "code": {
14089
+ "maxLength": 96,
14090
+ "minLength": 1,
14091
+ "pattern": "^[A-Z][A-Z0-9_]*$",
14092
+ "type": "string"
14093
+ },
14094
+ "details": {
14095
+ "additionalProperties": {},
14096
+ "propertyNames": { "maxLength": 64, "type": "string" },
14097
+ "type": "object"
14098
+ },
14099
+ "message": { "maxLength": 512, "minLength": 1, "type": "string" },
14100
+ "remediation": { "maxLength": 256, "minLength": 1, "type": "string" },
14101
+ "retryable": { "type": "boolean" },
14102
+ "source": {
14103
+ "enum": [
14104
+ "client",
14105
+ "auth",
14106
+ "policy",
14107
+ "runtime",
14108
+ "provider",
14109
+ "persistence",
14110
+ "workflow",
14111
+ "system"
14112
+ ],
14113
+ "type": "string"
14114
+ }
14115
+ },
14116
+ "required": ["class", "code", "message", "retryable", "source"],
14117
+ "type": "object"
14118
+ },
14119
+ "requestId": {}
14120
+ },
14121
+ "required": ["contractVersion", "requestId", "correlation", "error"],
14122
+ "type": "object"
14123
+ }
14124
+ }
14125
+ },
14126
+ "description": "Normalized error response"
14127
+ }
14128
+ },
14129
+ "security": [{ "serviceBearer": [] }]
14130
+ }
14131
+ },
12059
14132
  "/v1/profiles/resolve": {
12060
14133
  "post": {
12061
14134
  "operationId": "profile.resolve",