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