@adea-ai/sdk 1.3.3 → 1.5.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.
@@ -806,6 +806,240 @@
806
806
  "security": [{ "serviceBearer": [] }]
807
807
  }
808
808
  },
809
+ "/v1/executions/cancel": {
810
+ "post": {
811
+ "operationId": "execution.cancel",
812
+ "requestBody": {
813
+ "content": {
814
+ "application/json": {
815
+ "schema": {
816
+ "additionalProperties": false,
817
+ "properties": {
818
+ "caller": {
819
+ "properties": {
820
+ "servicePrincipalId": {
821
+ "maxLength": 64,
822
+ "minLength": 5,
823
+ "pattern": "^svc_[a-z][a-z0-9-]*$",
824
+ "type": "string"
825
+ }
826
+ },
827
+ "required": ["servicePrincipalId"],
828
+ "type": "object"
829
+ },
830
+ "commandId": { "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
831
+ "contractVersion": {
832
+ "additionalProperties": false,
833
+ "properties": {
834
+ "major": {
835
+ "exclusiveMinimum": 0,
836
+ "maximum": 9007199254740991,
837
+ "type": "integer"
838
+ },
839
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
840
+ },
841
+ "required": ["major", "minor"],
842
+ "type": "object"
843
+ },
844
+ "correlation": {
845
+ "properties": {
846
+ "causationCommandId": {
847
+ "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$",
848
+ "type": "string"
849
+ },
850
+ "parentEventId": {
851
+ "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$",
852
+ "type": "string"
853
+ },
854
+ "traceId": { "pattern": "^trc_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
855
+ },
856
+ "required": ["traceId"],
857
+ "type": "object"
858
+ },
859
+ "idempotencyKey": {
860
+ "maxLength": 128,
861
+ "minLength": 16,
862
+ "pattern": "^[A-Za-z0-9._:-]+$",
863
+ "type": "string"
864
+ },
865
+ "issuedAt": {
866
+ "format": "date-time",
867
+ "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))$",
868
+ "type": "string"
869
+ },
870
+ "operation": { "const": "execution.cancel", "type": "string" },
871
+ "payload": {
872
+ "additionalProperties": false,
873
+ "properties": {
874
+ "executionId": { "pattern": "^exe_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
875
+ },
876
+ "required": ["executionId"],
877
+ "type": "object"
878
+ },
879
+ "payloadHash": { "pattern": "^[a-f0-9]{64}$", "type": "string" },
880
+ "projectId": { "pattern": "^prj_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
881
+ "requestId": { "pattern": "^req_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
882
+ "workspaceId": { "pattern": "^wsp_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
883
+ },
884
+ "required": [
885
+ "caller",
886
+ "contractVersion",
887
+ "requestId",
888
+ "workspaceId",
889
+ "projectId",
890
+ "correlation",
891
+ "commandId",
892
+ "idempotencyKey",
893
+ "payloadHash",
894
+ "operation",
895
+ "issuedAt",
896
+ "payload"
897
+ ],
898
+ "type": "object"
899
+ }
900
+ }
901
+ },
902
+ "required": true
903
+ },
904
+ "responses": {
905
+ "202": {
906
+ "content": {
907
+ "application/json": {
908
+ "schema": {
909
+ "additionalProperties": false,
910
+ "properties": {
911
+ "contractVersion": {
912
+ "additionalProperties": false,
913
+ "properties": {
914
+ "major": {
915
+ "exclusiveMinimum": 0,
916
+ "maximum": 9007199254740991,
917
+ "type": "integer"
918
+ },
919
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
920
+ },
921
+ "required": ["major", "minor"],
922
+ "type": "object"
923
+ },
924
+ "correlation": {
925
+ "additionalProperties": false,
926
+ "properties": {
927
+ "causationCommandId": {},
928
+ "parentEventId": {},
929
+ "traceId": {}
930
+ },
931
+ "required": ["traceId"],
932
+ "type": "object"
933
+ },
934
+ "data": {
935
+ "additionalProperties": false,
936
+ "properties": {
937
+ "commandId": {},
938
+ "executionId": {},
939
+ "replayed": { "type": "boolean" },
940
+ "status": { "const": "accepted", "type": "string" }
941
+ },
942
+ "required": ["commandId", "executionId", "status", "replayed"],
943
+ "type": "object"
944
+ },
945
+ "requestId": {}
946
+ },
947
+ "required": ["contractVersion", "requestId", "correlation", "data"],
948
+ "type": "object"
949
+ }
950
+ }
951
+ },
952
+ "description": "Successful response"
953
+ },
954
+ "default": {
955
+ "content": {
956
+ "application/json": {
957
+ "schema": {
958
+ "additionalProperties": false,
959
+ "properties": {
960
+ "contractVersion": {
961
+ "additionalProperties": false,
962
+ "properties": {
963
+ "major": {
964
+ "exclusiveMinimum": 0,
965
+ "maximum": 9007199254740991,
966
+ "type": "integer"
967
+ },
968
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
969
+ },
970
+ "required": ["major", "minor"],
971
+ "type": "object"
972
+ },
973
+ "correlation": {
974
+ "additionalProperties": false,
975
+ "properties": {
976
+ "causationCommandId": {},
977
+ "parentEventId": {},
978
+ "traceId": {}
979
+ },
980
+ "required": ["traceId"],
981
+ "type": "object"
982
+ },
983
+ "error": {
984
+ "additionalProperties": false,
985
+ "properties": {
986
+ "class": {
987
+ "enum": [
988
+ "validation",
989
+ "authentication",
990
+ "authorization",
991
+ "conflict",
992
+ "stale_reference",
993
+ "capability_mismatch",
994
+ "runtime_unavailable",
995
+ "internal"
996
+ ],
997
+ "type": "string"
998
+ },
999
+ "code": {
1000
+ "maxLength": 96,
1001
+ "minLength": 1,
1002
+ "pattern": "^[A-Z][A-Z0-9_]*$",
1003
+ "type": "string"
1004
+ },
1005
+ "details": {
1006
+ "additionalProperties": {},
1007
+ "propertyNames": { "maxLength": 64, "type": "string" },
1008
+ "type": "object"
1009
+ },
1010
+ "message": { "maxLength": 512, "minLength": 1, "type": "string" },
1011
+ "remediation": { "maxLength": 256, "minLength": 1, "type": "string" },
1012
+ "retryable": { "type": "boolean" },
1013
+ "source": {
1014
+ "enum": [
1015
+ "client",
1016
+ "auth",
1017
+ "policy",
1018
+ "runtime",
1019
+ "provider",
1020
+ "persistence",
1021
+ "workflow",
1022
+ "system"
1023
+ ],
1024
+ "type": "string"
1025
+ }
1026
+ },
1027
+ "required": ["class", "code", "message", "retryable", "source"],
1028
+ "type": "object"
1029
+ },
1030
+ "requestId": {}
1031
+ },
1032
+ "required": ["contractVersion", "requestId", "correlation", "error"],
1033
+ "type": "object"
1034
+ }
1035
+ }
1036
+ },
1037
+ "description": "Normalized error response"
1038
+ }
1039
+ },
1040
+ "security": [{ "serviceBearer": [] }]
1041
+ }
1042
+ },
809
1043
  "/v1/executions/validate": {
810
1044
  "post": {
811
1045
  "operationId": "execution.validate",
@@ -868,100 +1102,288 @@
868
1102
  },
869
1103
  "operation": { "const": "execution.validate", "type": "string" },
870
1104
  "payload": {
871
- "properties": {
872
- "agentId": { "pattern": "^agt_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
873
- "contextPackage": {
1105
+ "anyOf": [
1106
+ {
874
1107
  "properties": {
875
- "compilerVersion": { "maxLength": 64, "minLength": 1, "type": "string" },
876
- "contentDigest": { "pattern": "^sha256:[a-f0-9]{64}$", "type": "string" },
877
- "contextPackageId": {
878
- "pattern": "^ctx_[0-9A-HJKMNP-TV-Z]{26}$",
1108
+ "agentId": {
1109
+ "pattern": "^agt_[0-9A-HJKMNP-TV-Z]{26}$",
879
1110
  "type": "string"
880
1111
  },
881
- "schemaVersion": {
882
- "exclusiveMinimum": 0,
883
- "maximum": 9007199254740991,
884
- "type": "integer"
885
- }
1112
+ "contextInputs": { "not": {} },
1113
+ "contextPackage": {
1114
+ "properties": {
1115
+ "compilerVersion": {
1116
+ "maxLength": 64,
1117
+ "minLength": 1,
1118
+ "type": "string"
1119
+ },
1120
+ "contentDigest": {
1121
+ "pattern": "^sha256:[a-f0-9]{64}$",
1122
+ "type": "string"
1123
+ },
1124
+ "contextPackageId": {
1125
+ "pattern": "^ctx_[0-9A-HJKMNP-TV-Z]{26}$",
1126
+ "type": "string"
1127
+ },
1128
+ "schemaVersion": {
1129
+ "exclusiveMinimum": 0,
1130
+ "maximum": 9007199254740991,
1131
+ "type": "integer"
1132
+ }
1133
+ },
1134
+ "required": [
1135
+ "contextPackageId",
1136
+ "contentDigest",
1137
+ "schemaVersion",
1138
+ "compilerVersion"
1139
+ ],
1140
+ "type": "object"
1141
+ },
1142
+ "outputContractRef": {
1143
+ "maxLength": 512,
1144
+ "minLength": 1,
1145
+ "type": "string"
1146
+ },
1147
+ "policySnapshot": {
1148
+ "properties": {
1149
+ "contentDigest": {
1150
+ "pattern": "^sha256:[a-f0-9]{64}$",
1151
+ "type": "string"
1152
+ },
1153
+ "policySnapshotId": {
1154
+ "maxLength": 256,
1155
+ "minLength": 1,
1156
+ "type": "string"
1157
+ },
1158
+ "revision": {
1159
+ "exclusiveMinimum": 0,
1160
+ "maximum": 9007199254740991,
1161
+ "type": "integer"
1162
+ }
1163
+ },
1164
+ "required": ["policySnapshotId", "revision", "contentDigest"],
1165
+ "type": "object"
1166
+ },
1167
+ "profileVersionId": {
1168
+ "pattern": "^pfv_[0-9A-HJKMNP-TV-Z]{26}$",
1169
+ "type": "string"
1170
+ },
1171
+ "projectState": {
1172
+ "properties": {
1173
+ "projectId": {
1174
+ "pattern": "^prj_[0-9A-HJKMNP-TV-Z]{26}$",
1175
+ "type": "string"
1176
+ },
1177
+ "revision": {
1178
+ "maximum": 9007199254740991,
1179
+ "minimum": 0,
1180
+ "type": "integer"
1181
+ },
1182
+ "workspaceId": {
1183
+ "pattern": "^wsp_[0-9A-HJKMNP-TV-Z]{26}$",
1184
+ "type": "string"
1185
+ }
1186
+ },
1187
+ "required": ["workspaceId", "projectId", "revision"],
1188
+ "type": "object"
1189
+ },
1190
+ "runtimeRequirements": {
1191
+ "items": {
1192
+ "maxLength": 128,
1193
+ "minLength": 1,
1194
+ "pattern": "^[a-z][a-z0-9.-]*$",
1195
+ "type": "string"
1196
+ },
1197
+ "maxItems": 128,
1198
+ "type": "array"
1199
+ },
1200
+ "skillVersionIds": {
1201
+ "items": {
1202
+ "pattern": "^skv_[0-9A-HJKMNP-TV-Z]{26}$",
1203
+ "type": "string"
1204
+ },
1205
+ "maxItems": 128,
1206
+ "type": "array"
1207
+ },
1208
+ "taskId": { "pattern": "^tsk_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
886
1209
  },
887
1210
  "required": [
888
- "contextPackageId",
889
- "contentDigest",
890
- "schemaVersion",
891
- "compilerVersion"
1211
+ "taskId",
1212
+ "agentId",
1213
+ "profileVersionId",
1214
+ "skillVersionIds",
1215
+ "projectState",
1216
+ "policySnapshot",
1217
+ "runtimeRequirements",
1218
+ "outputContractRef",
1219
+ "contextPackage"
892
1220
  ],
893
1221
  "type": "object"
894
1222
  },
895
- "outputContractRef": { "maxLength": 512, "minLength": 1, "type": "string" },
896
- "policySnapshot": {
1223
+ {
897
1224
  "properties": {
898
- "contentDigest": { "pattern": "^sha256:[a-f0-9]{64}$", "type": "string" },
899
- "policySnapshotId": {
900
- "maxLength": 256,
901
- "minLength": 1,
1225
+ "agentId": {
1226
+ "pattern": "^agt_[0-9A-HJKMNP-TV-Z]{26}$",
902
1227
  "type": "string"
903
1228
  },
904
- "revision": {
905
- "exclusiveMinimum": 0,
906
- "maximum": 9007199254740991,
907
- "type": "integer"
908
- }
909
- },
910
- "required": ["policySnapshotId", "revision", "contentDigest"],
911
- "type": "object"
912
- },
913
- "profileVersionId": {
914
- "pattern": "^pfv_[0-9A-HJKMNP-TV-Z]{26}$",
915
- "type": "string"
916
- },
917
- "projectState": {
918
- "properties": {
919
- "projectId": {
920
- "pattern": "^prj_[0-9A-HJKMNP-TV-Z]{26}$",
1229
+ "contextInputs": {
1230
+ "additionalProperties": false,
1231
+ "properties": {
1232
+ "budgets": {
1233
+ "additionalProperties": false,
1234
+ "properties": {
1235
+ "maximumBytes": {
1236
+ "exclusiveMinimum": 0,
1237
+ "maximum": 9007199254740991,
1238
+ "type": "integer"
1239
+ },
1240
+ "maximumTokens": {
1241
+ "exclusiveMinimum": 0,
1242
+ "maximum": 9007199254740991,
1243
+ "type": "integer"
1244
+ }
1245
+ },
1246
+ "required": ["maximumBytes", "maximumTokens"],
1247
+ "type": "object"
1248
+ },
1249
+ "candidates": {
1250
+ "items": {
1251
+ "additionalProperties": false,
1252
+ "properties": {
1253
+ "itemId": {
1254
+ "pattern": "^psi_[0-9A-HJKMNP-TV-Z]{26}$",
1255
+ "type": "string"
1256
+ },
1257
+ "itemRevision": {
1258
+ "exclusiveMinimum": 0,
1259
+ "maximum": 9007199254740991,
1260
+ "type": "integer"
1261
+ },
1262
+ "priority": {
1263
+ "maximum": 9007199254740991,
1264
+ "minimum": -9007199254740991,
1265
+ "type": "integer"
1266
+ },
1267
+ "required": { "type": "boolean" }
1268
+ },
1269
+ "required": ["itemId", "itemRevision", "required", "priority"],
1270
+ "type": "object"
1271
+ },
1272
+ "maxItems": 10000,
1273
+ "type": "array"
1274
+ },
1275
+ "objective": { "maxLength": 16384, "minLength": 1, "type": "string" },
1276
+ "returnContract": {
1277
+ "additionalProperties": false,
1278
+ "properties": {
1279
+ "contractRef": {
1280
+ "maxLength": 512,
1281
+ "minLength": 1,
1282
+ "type": "string"
1283
+ }
1284
+ },
1285
+ "required": ["contractRef"],
1286
+ "type": "object"
1287
+ },
1288
+ "successCriteria": {
1289
+ "items": { "maxLength": 4096, "minLength": 1, "type": "string" },
1290
+ "maxItems": 128,
1291
+ "minItems": 1,
1292
+ "type": "array"
1293
+ }
1294
+ },
1295
+ "required": [
1296
+ "objective",
1297
+ "candidates",
1298
+ "successCriteria",
1299
+ "returnContract",
1300
+ "budgets"
1301
+ ],
1302
+ "type": "object"
1303
+ },
1304
+ "contextPackage": { "not": {} },
1305
+ "outputContractRef": {
1306
+ "maxLength": 512,
1307
+ "minLength": 1,
921
1308
  "type": "string"
922
1309
  },
923
- "revision": {
924
- "maximum": 9007199254740991,
925
- "minimum": 0,
926
- "type": "integer"
1310
+ "policySnapshot": {
1311
+ "properties": {
1312
+ "contentDigest": {
1313
+ "pattern": "^sha256:[a-f0-9]{64}$",
1314
+ "type": "string"
1315
+ },
1316
+ "policySnapshotId": {
1317
+ "maxLength": 256,
1318
+ "minLength": 1,
1319
+ "type": "string"
1320
+ },
1321
+ "revision": {
1322
+ "exclusiveMinimum": 0,
1323
+ "maximum": 9007199254740991,
1324
+ "type": "integer"
1325
+ }
1326
+ },
1327
+ "required": ["policySnapshotId", "revision", "contentDigest"],
1328
+ "type": "object"
927
1329
  },
928
- "workspaceId": {
929
- "pattern": "^wsp_[0-9A-HJKMNP-TV-Z]{26}$",
1330
+ "profileVersionId": {
1331
+ "pattern": "^pfv_[0-9A-HJKMNP-TV-Z]{26}$",
930
1332
  "type": "string"
931
- }
932
- },
933
- "required": ["workspaceId", "projectId", "revision"],
934
- "type": "object"
935
- },
936
- "runtimeRequirements": {
937
- "items": {
938
- "maxLength": 128,
939
- "minLength": 1,
940
- "pattern": "^[a-z][a-z0-9.-]*$",
941
- "type": "string"
942
- },
943
- "maxItems": 128,
944
- "type": "array"
945
- },
946
- "skillVersionIds": {
947
- "items": { "pattern": "^skv_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
948
- "maxItems": 128,
949
- "type": "array"
950
- },
951
- "taskId": { "pattern": "^tsk_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
952
- },
953
- "required": [
954
- "taskId",
955
- "agentId",
956
- "profileVersionId",
957
- "skillVersionIds",
958
- "projectState",
959
- "contextPackage",
960
- "policySnapshot",
961
- "runtimeRequirements",
962
- "outputContractRef"
963
- ],
964
- "type": "object"
1333
+ },
1334
+ "projectState": {
1335
+ "properties": {
1336
+ "projectId": {
1337
+ "pattern": "^prj_[0-9A-HJKMNP-TV-Z]{26}$",
1338
+ "type": "string"
1339
+ },
1340
+ "revision": {
1341
+ "maximum": 9007199254740991,
1342
+ "minimum": 0,
1343
+ "type": "integer"
1344
+ },
1345
+ "workspaceId": {
1346
+ "pattern": "^wsp_[0-9A-HJKMNP-TV-Z]{26}$",
1347
+ "type": "string"
1348
+ }
1349
+ },
1350
+ "required": ["workspaceId", "projectId", "revision"],
1351
+ "type": "object"
1352
+ },
1353
+ "runtimeRequirements": {
1354
+ "items": {
1355
+ "maxLength": 128,
1356
+ "minLength": 1,
1357
+ "pattern": "^[a-z][a-z0-9.-]*$",
1358
+ "type": "string"
1359
+ },
1360
+ "maxItems": 128,
1361
+ "type": "array"
1362
+ },
1363
+ "skillVersionIds": {
1364
+ "items": {
1365
+ "pattern": "^skv_[0-9A-HJKMNP-TV-Z]{26}$",
1366
+ "type": "string"
1367
+ },
1368
+ "maxItems": 128,
1369
+ "type": "array"
1370
+ },
1371
+ "taskId": { "pattern": "^tsk_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
1372
+ },
1373
+ "required": [
1374
+ "taskId",
1375
+ "agentId",
1376
+ "profileVersionId",
1377
+ "skillVersionIds",
1378
+ "projectState",
1379
+ "policySnapshot",
1380
+ "runtimeRequirements",
1381
+ "outputContractRef",
1382
+ "contextInputs"
1383
+ ],
1384
+ "type": "object"
1385
+ }
1386
+ ]
965
1387
  },
966
1388
  "payloadHash": { "pattern": "^[a-f0-9]{64}$", "type": "string" },
967
1389
  "projectId": { "pattern": "^prj_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
@@ -2099,6 +2521,291 @@
2099
2521
  "security": [{ "serviceBearer": [] }]
2100
2522
  }
2101
2523
  },
2524
+ "/v1/interactions/respond": {
2525
+ "post": {
2526
+ "operationId": "interaction.respond",
2527
+ "requestBody": {
2528
+ "content": {
2529
+ "application/json": {
2530
+ "schema": {
2531
+ "$defs": {
2532
+ "__schema0": {
2533
+ "anyOf": [
2534
+ { "type": "string" },
2535
+ { "type": "number" },
2536
+ { "type": "boolean" },
2537
+ { "type": "null" },
2538
+ { "items": { "$ref": "#/$defs/__schema0" }, "type": "array" },
2539
+ {
2540
+ "additionalProperties": { "$ref": "#/$defs/__schema0" },
2541
+ "propertyNames": { "type": "string" },
2542
+ "type": "object"
2543
+ }
2544
+ ]
2545
+ }
2546
+ },
2547
+ "additionalProperties": false,
2548
+ "properties": {
2549
+ "caller": {
2550
+ "properties": {
2551
+ "servicePrincipalId": {
2552
+ "maxLength": 64,
2553
+ "minLength": 5,
2554
+ "pattern": "^svc_[a-z][a-z0-9-]*$",
2555
+ "type": "string"
2556
+ }
2557
+ },
2558
+ "required": ["servicePrincipalId"],
2559
+ "type": "object"
2560
+ },
2561
+ "commandId": { "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
2562
+ "contractVersion": {
2563
+ "additionalProperties": false,
2564
+ "properties": {
2565
+ "major": {
2566
+ "exclusiveMinimum": 0,
2567
+ "maximum": 9007199254740991,
2568
+ "type": "integer"
2569
+ },
2570
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
2571
+ },
2572
+ "required": ["major", "minor"],
2573
+ "type": "object"
2574
+ },
2575
+ "correlation": {
2576
+ "properties": {
2577
+ "causationCommandId": {
2578
+ "pattern": "^cmd_[0-9A-HJKMNP-TV-Z]{26}$",
2579
+ "type": "string"
2580
+ },
2581
+ "parentEventId": {
2582
+ "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$",
2583
+ "type": "string"
2584
+ },
2585
+ "traceId": { "pattern": "^trc_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
2586
+ },
2587
+ "required": ["traceId"],
2588
+ "type": "object"
2589
+ },
2590
+ "idempotencyKey": {
2591
+ "maxLength": 128,
2592
+ "minLength": 16,
2593
+ "pattern": "^[A-Za-z0-9._:-]+$",
2594
+ "type": "string"
2595
+ },
2596
+ "issuedAt": {
2597
+ "format": "date-time",
2598
+ "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))$",
2599
+ "type": "string"
2600
+ },
2601
+ "operation": { "const": "interaction.respond", "type": "string" },
2602
+ "payload": {
2603
+ "additionalProperties": false,
2604
+ "properties": {
2605
+ "action": {
2606
+ "enum": ["approve", "deny", "input", "grant", "resume", "cancel"],
2607
+ "type": "string"
2608
+ },
2609
+ "attemptId": { "pattern": "^att_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
2610
+ "executionId": {
2611
+ "pattern": "^exe_[0-9A-HJKMNP-TV-Z]{26}$",
2612
+ "type": "string"
2613
+ },
2614
+ "expectedVersion": {
2615
+ "exclusiveMinimum": 0,
2616
+ "maximum": 9007199254740991,
2617
+ "type": "integer"
2618
+ },
2619
+ "interactionId": {
2620
+ "pattern": "^int_[0-9A-HJKMNP-TV-Z]{26}$",
2621
+ "type": "string"
2622
+ },
2623
+ "value": { "$ref": "#/$defs/__schema0" }
2624
+ },
2625
+ "required": [
2626
+ "executionId",
2627
+ "attemptId",
2628
+ "interactionId",
2629
+ "expectedVersion",
2630
+ "action"
2631
+ ],
2632
+ "type": "object"
2633
+ },
2634
+ "payloadHash": { "pattern": "^[a-f0-9]{64}$", "type": "string" },
2635
+ "projectId": { "pattern": "^prj_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
2636
+ "requestId": { "pattern": "^req_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" },
2637
+ "workspaceId": { "pattern": "^wsp_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }
2638
+ },
2639
+ "required": [
2640
+ "caller",
2641
+ "contractVersion",
2642
+ "requestId",
2643
+ "workspaceId",
2644
+ "projectId",
2645
+ "correlation",
2646
+ "commandId",
2647
+ "idempotencyKey",
2648
+ "payloadHash",
2649
+ "operation",
2650
+ "issuedAt",
2651
+ "payload"
2652
+ ],
2653
+ "type": "object"
2654
+ }
2655
+ }
2656
+ },
2657
+ "required": true
2658
+ },
2659
+ "responses": {
2660
+ "202": {
2661
+ "content": {
2662
+ "application/json": {
2663
+ "schema": {
2664
+ "additionalProperties": false,
2665
+ "properties": {
2666
+ "contractVersion": {
2667
+ "additionalProperties": false,
2668
+ "properties": {
2669
+ "major": {
2670
+ "exclusiveMinimum": 0,
2671
+ "maximum": 9007199254740991,
2672
+ "type": "integer"
2673
+ },
2674
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
2675
+ },
2676
+ "required": ["major", "minor"],
2677
+ "type": "object"
2678
+ },
2679
+ "correlation": {
2680
+ "additionalProperties": false,
2681
+ "properties": {
2682
+ "causationCommandId": {},
2683
+ "parentEventId": {},
2684
+ "traceId": {}
2685
+ },
2686
+ "required": ["traceId"],
2687
+ "type": "object"
2688
+ },
2689
+ "data": {
2690
+ "additionalProperties": false,
2691
+ "properties": {
2692
+ "attemptId": {},
2693
+ "commandId": {},
2694
+ "executionId": {},
2695
+ "interactionId": {},
2696
+ "replayed": { "type": "boolean" },
2697
+ "responseId": {},
2698
+ "status": { "const": "accepted", "type": "string" }
2699
+ },
2700
+ "required": [
2701
+ "commandId",
2702
+ "responseId",
2703
+ "executionId",
2704
+ "attemptId",
2705
+ "interactionId",
2706
+ "status",
2707
+ "replayed"
2708
+ ],
2709
+ "type": "object"
2710
+ },
2711
+ "requestId": {}
2712
+ },
2713
+ "required": ["contractVersion", "requestId", "correlation", "data"],
2714
+ "type": "object"
2715
+ }
2716
+ }
2717
+ },
2718
+ "description": "Successful response"
2719
+ },
2720
+ "default": {
2721
+ "content": {
2722
+ "application/json": {
2723
+ "schema": {
2724
+ "additionalProperties": false,
2725
+ "properties": {
2726
+ "contractVersion": {
2727
+ "additionalProperties": false,
2728
+ "properties": {
2729
+ "major": {
2730
+ "exclusiveMinimum": 0,
2731
+ "maximum": 9007199254740991,
2732
+ "type": "integer"
2733
+ },
2734
+ "minor": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }
2735
+ },
2736
+ "required": ["major", "minor"],
2737
+ "type": "object"
2738
+ },
2739
+ "correlation": {
2740
+ "additionalProperties": false,
2741
+ "properties": {
2742
+ "causationCommandId": {},
2743
+ "parentEventId": {},
2744
+ "traceId": {}
2745
+ },
2746
+ "required": ["traceId"],
2747
+ "type": "object"
2748
+ },
2749
+ "error": {
2750
+ "additionalProperties": false,
2751
+ "properties": {
2752
+ "class": {
2753
+ "enum": [
2754
+ "validation",
2755
+ "authentication",
2756
+ "authorization",
2757
+ "conflict",
2758
+ "stale_reference",
2759
+ "capability_mismatch",
2760
+ "runtime_unavailable",
2761
+ "internal"
2762
+ ],
2763
+ "type": "string"
2764
+ },
2765
+ "code": {
2766
+ "maxLength": 96,
2767
+ "minLength": 1,
2768
+ "pattern": "^[A-Z][A-Z0-9_]*$",
2769
+ "type": "string"
2770
+ },
2771
+ "details": {
2772
+ "additionalProperties": {},
2773
+ "propertyNames": { "maxLength": 64, "type": "string" },
2774
+ "type": "object"
2775
+ },
2776
+ "message": { "maxLength": 512, "minLength": 1, "type": "string" },
2777
+ "remediation": { "maxLength": 256, "minLength": 1, "type": "string" },
2778
+ "retryable": { "type": "boolean" },
2779
+ "source": {
2780
+ "enum": [
2781
+ "client",
2782
+ "auth",
2783
+ "policy",
2784
+ "runtime",
2785
+ "provider",
2786
+ "persistence",
2787
+ "workflow",
2788
+ "system"
2789
+ ],
2790
+ "type": "string"
2791
+ }
2792
+ },
2793
+ "required": ["class", "code", "message", "retryable", "source"],
2794
+ "type": "object"
2795
+ },
2796
+ "requestId": {}
2797
+ },
2798
+ "required": ["contractVersion", "requestId", "correlation", "error"],
2799
+ "type": "object"
2800
+ }
2801
+ }
2802
+ },
2803
+ "description": "Normalized error response"
2804
+ }
2805
+ },
2806
+ "security": [{ "serviceBearer": [] }]
2807
+ }
2808
+ },
2102
2809
  "/v1/marketplace/catalog": {
2103
2810
  "post": {
2104
2811
  "operationId": "marketplace.catalog.read",