@ancplua/qyl-api-schema 8.0.0 → 10.0.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.
@@ -1021,376 +1021,6 @@
1021
1021
  "maxLength": 256,
1022
1022
  "description": "User identifier (pseudonymized for privacy)"
1023
1023
  },
1024
- "Diagnostics.AgentDiagnosticCheckId": {
1025
- "type": "string",
1026
- "minLength": 1,
1027
- "maxLength": 128,
1028
- "pattern": "^[A-Za-z0-9_][A-Za-z0-9._:/\\[\\]-]{0,127}$",
1029
- "description": "Stable machine identifier of one diagnostic check. This identifier is a value and must never be promoted to a telemetry key."
1030
- },
1031
- "Diagnostics.AgentDiagnosticCheckOutcome": {
1032
- "type": "string",
1033
- "enum": [
1034
- "pass",
1035
- "fail",
1036
- "unknown"
1037
- ],
1038
- "description": "Machine-computed result of one diagnostic check. For exists, an absent or null actual variable produces fail. For every other operator, missing required operands produce unknown; incompatible operand types also produce unknown. not_evaluated is deliberately not a check outcome."
1039
- },
1040
- "Diagnostics.AgentDiagnosticCheckResult": {
1041
- "type": "object",
1042
- "required": [
1043
- "check_id",
1044
- "operator",
1045
- "actual",
1046
- "outcome"
1047
- ],
1048
- "properties": {
1049
- "check_id": {
1050
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticCheckId"
1051
- },
1052
- "operator": {
1053
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticOperator"
1054
- },
1055
- "actual": {
1056
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticVariableName"
1057
- },
1058
- "expected": {
1059
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticVariableName"
1060
- },
1061
- "expected_type": {
1062
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticValueType"
1063
- },
1064
- "outcome": {
1065
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticCheckOutcome"
1066
- }
1067
- },
1068
- "unevaluatedProperties": {
1069
- "not": {}
1070
- },
1071
- "description": "One structural, machine-computed check result. actual and expected reference variable names only. For equal, not_equal, contains, less_than, and greater_than, expected is required and expected_type is omitted. For exists, both are omitted and an absent or null actual variable produces fail. For type_is, expected is omitted and expected_type is required. For operators other than exists, missing required operands produce unknown; incompatible operand types also produce unknown. not_evaluated is reserved for the snapshot aggregate when checks is empty and is not emitted for an individual check."
1072
- },
1073
- "Diagnostics.AgentDiagnosticClassification": {
1074
- "type": "string",
1075
- "enum": [
1076
- "public",
1077
- "internal",
1078
- "sensitive",
1079
- "secret"
1080
- ],
1081
- "description": "Data-handling classification assigned before a diagnostic variable is captured."
1082
- },
1083
- "Diagnostics.AgentDiagnosticExtensionId": {
1084
- "type": "string",
1085
- "enum": [
1086
- "qyl.agent.diagnostic.snapshot"
1087
- ],
1088
- "description": "The versioned extension discriminator for a protected agent diagnostic snapshot."
1089
- },
1090
- "Diagnostics.AgentDiagnosticFormatVersion": {
1091
- "type": "integer",
1092
- "format": "int32",
1093
- "minimum": 1,
1094
- "maximum": 1,
1095
- "description": "Wire-format version of an agent diagnostic snapshot. Version 1 is the only accepted format."
1096
- },
1097
- "Diagnostics.AgentDiagnosticOperator": {
1098
- "type": "string",
1099
- "enum": [
1100
- "equal",
1101
- "not_equal",
1102
- "exists",
1103
- "type_is",
1104
- "contains",
1105
- "less_than",
1106
- "greater_than"
1107
- ],
1108
- "description": "Closed operation evaluated by a diagnostic check. Checks are structural and never carry expression strings."
1109
- },
1110
- "Diagnostics.AgentDiagnosticOutcome": {
1111
- "type": "string",
1112
- "enum": [
1113
- "pass",
1114
- "fail",
1115
- "unknown",
1116
- "not_evaluated"
1117
- ],
1118
- "description": "Machine-computed aggregate result of a diagnostic snapshot. unknown reports one or more unknown check outcomes. not_evaluated is reserved for a snapshot whose checks array is empty."
1119
- },
1120
- "Diagnostics.AgentDiagnosticPhase": {
1121
- "type": "string",
1122
- "enum": [
1123
- "input",
1124
- "output",
1125
- "error",
1126
- "checkpoint"
1127
- ],
1128
- "description": "Execution boundary at which the state frame was captured."
1129
- },
1130
- "Diagnostics.AgentDiagnosticProbeId": {
1131
- "type": "string",
1132
- "minLength": 1,
1133
- "maxLength": 128,
1134
- "pattern": "^[A-Za-z0-9_][A-Za-z0-9._:/\\[\\]-]{0,127}$",
1135
- "description": "Stable machine identifier of the probe that captured a diagnostic snapshot. This identifier is a value and must never be promoted to a telemetry key."
1136
- },
1137
- "Diagnostics.AgentDiagnosticSnapshot": {
1138
- "type": "object",
1139
- "required": [
1140
- "extension_id",
1141
- "format_version",
1142
- "snapshot_id",
1143
- "capture_nonce",
1144
- "probe_id",
1145
- "phase",
1146
- "variables",
1147
- "checks",
1148
- "outcome"
1149
- ],
1150
- "properties": {
1151
- "extension_id": {
1152
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticExtensionId"
1153
- },
1154
- "format_version": {
1155
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticFormatVersion"
1156
- },
1157
- "snapshot_id": {
1158
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticSnapshotId"
1159
- },
1160
- "capture_nonce": {
1161
- "type": "string",
1162
- "minLength": 32,
1163
- "maxLength": 32,
1164
- "pattern": "^[0-9a-f]{32}$",
1165
- "description": "Fresh 128-bit random nonce encoded as exactly 32 lowercase hexadecimal characters. It prevents equality inference across otherwise identical protected captures and must not be used as an identity key."
1166
- },
1167
- "probe_id": {
1168
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticProbeId"
1169
- },
1170
- "phase": {
1171
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticPhase"
1172
- },
1173
- "variables": {
1174
- "type": "array",
1175
- "items": {
1176
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticVariable"
1177
- },
1178
- "maxItems": 64
1179
- },
1180
- "checks": {
1181
- "type": "array",
1182
- "items": {
1183
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticCheckResult"
1184
- },
1185
- "maxItems": 64
1186
- },
1187
- "outcome": {
1188
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticOutcome"
1189
- }
1190
- },
1191
- "unevaluatedProperties": {
1192
- "not": {}
1193
- },
1194
- "description": "Version 1 protected JSON state frame captured for an artificial-intelligence agent. extension_id and format_version are its schema identity. capture_nonce is fresh entropy and is not a stable identifier. Variables and checks are bounded, dynamic names remain values, and no human-oriented message or expression text is part of the contract. Overall outcome is not_evaluated only when checks is empty. For a non-empty checks array it is fail if any check fails, otherwise unknown if any check is unknown, otherwise pass."
1195
- },
1196
- "Diagnostics.AgentDiagnosticSnapshotId": {
1197
- "type": "string",
1198
- "minLength": 1,
1199
- "maxLength": 128,
1200
- "pattern": "^[A-Za-z0-9_][A-Za-z0-9._:/\\[\\]-]{0,127}$",
1201
- "description": "Stable machine identifier of one diagnostic snapshot. This identifier is a value and must never be promoted to a telemetry key."
1202
- },
1203
- "Diagnostics.AgentDiagnosticSnapshotSummary": {
1204
- "type": "object",
1205
- "required": [
1206
- "extension_id",
1207
- "format_version",
1208
- "snapshot_id",
1209
- "probe_id",
1210
- "phase",
1211
- "outcome",
1212
- "variable_count",
1213
- "check_count",
1214
- "failed_check_count",
1215
- "content_ref"
1216
- ],
1217
- "properties": {
1218
- "extension_id": {
1219
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticExtensionId"
1220
- },
1221
- "format_version": {
1222
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticFormatVersion"
1223
- },
1224
- "snapshot_id": {
1225
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticSnapshotId"
1226
- },
1227
- "probe_id": {
1228
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticProbeId"
1229
- },
1230
- "phase": {
1231
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticPhase"
1232
- },
1233
- "outcome": {
1234
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticOutcome"
1235
- },
1236
- "variable_count": {
1237
- "type": "integer",
1238
- "format": "int32",
1239
- "minimum": 0,
1240
- "maximum": 64
1241
- },
1242
- "check_count": {
1243
- "type": "integer",
1244
- "format": "int32",
1245
- "minimum": 0,
1246
- "maximum": 64
1247
- },
1248
- "failed_check_count": {
1249
- "type": "integer",
1250
- "format": "int32",
1251
- "minimum": 0,
1252
- "maximum": 64
1253
- },
1254
- "content_ref": {
1255
- "$ref": "#/$defs/Workflow.WorkflowContentRef"
1256
- }
1257
- },
1258
- "unevaluatedProperties": {
1259
- "not": {}
1260
- },
1261
- "description": "Value-free event-data projection for a protected agent diagnostic snapshot. Encode this shape in WorkflowEventAppend.data on the existing content_captured event kind. content_ref must also occur in that event's content_refs and identifies UTF-8 JSON conforming to AgentDiagnosticSnapshot. Counts are computed from the referenced snapshot; failed_check_count counts checks whose outcome is fail. No variable names, values, human messages, expressions, nonce, or classifications may appear in this summary."
1262
- },
1263
- "Diagnostics.AgentDiagnosticValueType": {
1264
- "type": "string",
1265
- "enum": [
1266
- "null",
1267
- "boolean",
1268
- "integer",
1269
- "number",
1270
- "string",
1271
- "json"
1272
- ],
1273
- "description": "Declared JSON-level type of a diagnostic variable."
1274
- },
1275
- "Diagnostics.AgentDiagnosticVariable": {
1276
- "anyOf": [
1277
- {
1278
- "$ref": "#/$defs/Diagnostics.CapturedAgentDiagnosticVariable"
1279
- },
1280
- {
1281
- "$ref": "#/$defs/Diagnostics.RedactedAgentDiagnosticVariable"
1282
- },
1283
- {
1284
- "$ref": "#/$defs/Diagnostics.OmittedAgentDiagnosticVariable"
1285
- }
1286
- ],
1287
- "description": "One dynamically named variable in a protected diagnostic snapshot. Capture is the discriminator and makes value presence unambiguous."
1288
- },
1289
- "Diagnostics.AgentDiagnosticVariableBase": {
1290
- "type": "object",
1291
- "required": [
1292
- "name",
1293
- "type",
1294
- "classification"
1295
- ],
1296
- "properties": {
1297
- "name": {
1298
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticVariableName"
1299
- },
1300
- "type": {
1301
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticValueType"
1302
- },
1303
- "classification": {
1304
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticClassification"
1305
- }
1306
- },
1307
- "description": "Common identity and policy fields for one dynamic diagnostic variable."
1308
- },
1309
- "Diagnostics.AgentDiagnosticVariableName": {
1310
- "type": "string",
1311
- "minLength": 1,
1312
- "maxLength": 128,
1313
- "pattern": "^[A-Za-z0-9_][A-Za-z0-9._:/\\[\\]-]{0,127}$",
1314
- "description": "Stable machine name of one dynamically captured variable. Names are data values, never telemetry attribute keys, event names, or span names."
1315
- },
1316
- "Diagnostics.CapturedAgentDiagnosticVariable": {
1317
- "type": "object",
1318
- "required": [
1319
- "capture",
1320
- "value"
1321
- ],
1322
- "properties": {
1323
- "capture": {
1324
- "type": "string",
1325
- "enum": [
1326
- "value"
1327
- ]
1328
- },
1329
- "value": {
1330
- "anyOf": [
1331
- {},
1332
- {
1333
- "type": "null"
1334
- }
1335
- ]
1336
- }
1337
- },
1338
- "unevaluatedProperties": {
1339
- "not": {}
1340
- },
1341
- "allOf": [
1342
- {
1343
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticVariableBase"
1344
- }
1345
- ],
1346
- "description": "A variable whose typed JSON value is present in protected snapshot content. The value is required and must match type: null is JSON null; boolean is a JSON boolean; integer is a signed 64-bit JSON integer; number is a finite JSON number; string is a JSON string; json is a JSON object or array. The protected content boundary, not this model, controls access to all captured values."
1347
- },
1348
- "Diagnostics.OmittedAgentDiagnosticVariable": {
1349
- "type": "object",
1350
- "required": [
1351
- "capture"
1352
- ],
1353
- "properties": {
1354
- "capture": {
1355
- "type": "string",
1356
- "enum": [
1357
- "omitted"
1358
- ]
1359
- }
1360
- },
1361
- "unevaluatedProperties": {
1362
- "not": {}
1363
- },
1364
- "allOf": [
1365
- {
1366
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticVariableBase"
1367
- }
1368
- ],
1369
- "description": "A variable whose value was unavailable or deliberately not captured. A value field is forbidden."
1370
- },
1371
- "Diagnostics.RedactedAgentDiagnosticVariable": {
1372
- "type": "object",
1373
- "required": [
1374
- "capture"
1375
- ],
1376
- "properties": {
1377
- "capture": {
1378
- "type": "string",
1379
- "enum": [
1380
- "redacted"
1381
- ]
1382
- }
1383
- },
1384
- "unevaluatedProperties": {
1385
- "not": {}
1386
- },
1387
- "allOf": [
1388
- {
1389
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticVariableBase"
1390
- }
1391
- ],
1392
- "description": "A variable observed by the probe whose value was replaced by policy. A value field is forbidden."
1393
- },
1394
1024
  "Domains.Observe.Session.DeviceType": {
1395
1025
  "type": "string",
1396
1026
  "enum": [
@@ -1913,50 +1543,6 @@
1913
1543
  },
1914
1544
  "description": "One CI run, summarized from the session its telemetry is grouped under."
1915
1545
  },
1916
- "Mcp.Tools.ControlWorkflowRunInput": {
1917
- "type": "object",
1918
- "required": [
1919
- "run_id",
1920
- "action",
1921
- "idempotency_key"
1922
- ],
1923
- "properties": {
1924
- "run_id": {
1925
- "$ref": "#/$defs/Workflow.WorkflowRunId"
1926
- },
1927
- "action": {
1928
- "$ref": "#/$defs/Workflow.WorkflowControlAction"
1929
- },
1930
- "idempotency_key": {
1931
- "type": "string",
1932
- "minLength": 1,
1933
- "maxLength": 160
1934
- },
1935
- "input": {
1936
- "type": "string",
1937
- "maxLength": 32768
1938
- }
1939
- },
1940
- "unevaluatedProperties": {
1941
- "not": {}
1942
- },
1943
- "description": "Input for control_workflow_run."
1944
- },
1945
- "Mcp.Tools.ControlWorkflowRunOutput": {
1946
- "type": "object",
1947
- "required": [
1948
- "command"
1949
- ],
1950
- "properties": {
1951
- "command": {
1952
- "$ref": "#/$defs/Workflow.WorkflowControlCommand"
1953
- }
1954
- },
1955
- "unevaluatedProperties": {
1956
- "not": {}
1957
- },
1958
- "description": "Structured output for control_workflow_run."
1959
- },
1960
1546
  "Mcp.Tools.DisplayMcpDashboardInput": {
1961
1547
  "type": "object",
1962
1548
  "properties": {
@@ -2035,83 +1621,26 @@
2035
1621
  },
2036
1622
  "description": "Structured output for display_traces."
2037
1623
  },
2038
- "Mcp.Tools.DisplayWorkflowGraphInput": {
1624
+ "Mcp.Tools.FetchTelemetryInput": {
2039
1625
  "type": "object",
1626
+ "required": [
1627
+ "view"
1628
+ ],
2040
1629
  "properties": {
2041
- "run_id": {
2042
- "$ref": "#/$defs/Workflow.WorkflowRunId"
1630
+ "view": {
1631
+ "$ref": "#/$defs/Mcp.Tools.FetchTelemetryView"
1632
+ },
1633
+ "trace_id": {
1634
+ "$ref": "#/$defs/Common.TraceId"
2043
1635
  },
2044
- "node_cursor": {
2045
- "$ref": "#/$defs/Workflow.WorkflowNodeCursor",
2046
- "description": "Opaque node continuation. Reuse it unchanged from the preceding snapshot's next_node_cursor; do not parse, construct, or modify it."
1636
+ "service_name": {
1637
+ "type": "string"
2047
1638
  },
2048
- "node_limit": {
1639
+ "severity_min": {
2049
1640
  "type": "integer",
2050
1641
  "format": "int32",
2051
1642
  "minimum": 1,
2052
- "maximum": 1000,
2053
- "default": 250
2054
- },
2055
- "edge_cursor": {
2056
- "$ref": "#/$defs/Workflow.WorkflowEdgeCursor",
2057
- "description": "Opaque edge continuation. Reuse it unchanged from the preceding snapshot's next_edge_cursor; do not parse, construct, or modify it."
2058
- },
2059
- "edge_limit": {
2060
- "type": "integer",
2061
- "format": "int32",
2062
- "minimum": 1,
2063
- "maximum": 2000,
2064
- "default": 500
2065
- }
2066
- },
2067
- "unevaluatedProperties": {
2068
- "not": {}
2069
- },
2070
- "description": "Input for display_workflow_graph. Omit run_id to select the most recent run."
2071
- },
2072
- "Mcp.Tools.DisplayWorkflowGraphOutput": {
2073
- "type": "object",
2074
- "required": [
2075
- "graph",
2076
- "live_controls_available",
2077
- "mode"
2078
- ],
2079
- "properties": {
2080
- "graph": {
2081
- "$ref": "#/$defs/Workflow.WorkflowGraphSnapshot"
2082
- },
2083
- "live_controls_available": {
2084
- "type": "boolean"
2085
- },
2086
- "mode": {
2087
- "$ref": "#/$defs/Mcp.Tools.McpDataMode"
2088
- }
2089
- },
2090
- "unevaluatedProperties": {
2091
- "not": {}
2092
- },
2093
- "description": "Structured output for display_workflow_graph."
2094
- },
2095
- "Mcp.Tools.FetchTelemetryInput": {
2096
- "type": "object",
2097
- "required": [
2098
- "view"
2099
- ],
2100
- "properties": {
2101
- "view": {
2102
- "$ref": "#/$defs/Mcp.Tools.FetchTelemetryView"
2103
- },
2104
- "trace_id": {
2105
- "$ref": "#/$defs/Common.TraceId"
2106
- },
2107
- "service_name": {
2108
- "type": "string"
2109
- },
2110
- "severity_min": {
2111
- "type": "integer",
2112
- "format": "int32",
2113
- "minimum": 1,
2114
- "maximum": 24
1643
+ "maximum": 24
2115
1644
  },
2116
1645
  "query": {
2117
1646
  "type": "string"
@@ -2177,126 +1706,6 @@
2177
1706
  ],
2178
1707
  "description": "Data projection requested by the app-only fetch_telemetry tool."
2179
1708
  },
2180
- "Mcp.Tools.FetchWorkflowGraphUpdatesInput": {
2181
- "type": "object",
2182
- "required": [
2183
- "run_id",
2184
- "after_sequence"
2185
- ],
2186
- "properties": {
2187
- "run_id": {
2188
- "$ref": "#/$defs/Workflow.WorkflowRunId"
2189
- },
2190
- "after_sequence": {
2191
- "$ref": "#/$defs/Workflow.WorkflowJournalPosition"
2192
- },
2193
- "limit": {
2194
- "type": "integer",
2195
- "format": "int32",
2196
- "minimum": 1,
2197
- "maximum": 1000,
2198
- "default": 250
2199
- },
2200
- "wait_ms": {
2201
- "type": "integer",
2202
- "format": "int32",
2203
- "minimum": 0,
2204
- "maximum": 30000,
2205
- "default": 20000
2206
- },
2207
- "node_cursor": {
2208
- "$ref": "#/$defs/Workflow.WorkflowNodeCursor",
2209
- "description": "Opaque node continuation. Reuse it unchanged from the preceding snapshot's next_node_cursor; do not parse, construct, or modify it."
2210
- },
2211
- "node_limit": {
2212
- "type": "integer",
2213
- "format": "int32",
2214
- "minimum": 1,
2215
- "maximum": 1000,
2216
- "default": 250
2217
- },
2218
- "edge_cursor": {
2219
- "$ref": "#/$defs/Workflow.WorkflowEdgeCursor",
2220
- "description": "Opaque edge continuation. Reuse it unchanged from the preceding snapshot's next_edge_cursor; do not parse, construct, or modify it."
2221
- },
2222
- "edge_limit": {
2223
- "type": "integer",
2224
- "format": "int32",
2225
- "minimum": 1,
2226
- "maximum": 2000,
2227
- "default": 500
2228
- },
2229
- "content_ref": {
2230
- "$ref": "#/$defs/Workflow.WorkflowContentRef",
2231
- "description": "Optional captured payload to retrieve lazily for the selected run."
2232
- }
2233
- },
2234
- "unevaluatedProperties": {
2235
- "not": {}
2236
- },
2237
- "description": "Input for the app-only fetch_workflow_graph_updates tool."
2238
- },
2239
- "Mcp.Tools.FetchWorkflowGraphUpdatesOutput": {
2240
- "type": "object",
2241
- "required": [
2242
- "page",
2243
- "mode"
2244
- ],
2245
- "properties": {
2246
- "page": {
2247
- "$ref": "#/$defs/Workflow.WorkflowEventPage"
2248
- },
2249
- "graph": {
2250
- "$ref": "#/$defs/Workflow.WorkflowGraphSnapshot"
2251
- },
2252
- "content": {
2253
- "$ref": "#/$defs/Workflow.WorkflowContent"
2254
- },
2255
- "mode": {
2256
- "$ref": "#/$defs/Mcp.Tools.McpDataMode"
2257
- }
2258
- },
2259
- "unevaluatedProperties": {
2260
- "not": {}
2261
- },
2262
- "description": "Structured output for the app-only fetch_workflow_graph_updates tool."
2263
- },
2264
- "Mcp.Tools.GetActiveWorkflowRunInput": {
2265
- "type": "object",
2266
- "unevaluatedProperties": {
2267
- "not": {}
2268
- },
2269
- "description": "Input for get_active_workflow_run."
2270
- },
2271
- "Mcp.Tools.GetActiveWorkflowRunOutput": {
2272
- "type": "object",
2273
- "required": [
2274
- "active",
2275
- "live_controls_available"
2276
- ],
2277
- "properties": {
2278
- "active": {
2279
- "type": "boolean"
2280
- },
2281
- "live_controls_available": {
2282
- "type": "boolean"
2283
- },
2284
- "run_id": {
2285
- "$ref": "#/$defs/Workflow.WorkflowRunId"
2286
- },
2287
- "thread_id": {
2288
- "type": "string"
2289
- },
2290
- "started_at": {
2291
- "type": "string",
2292
- "format": "date-time"
2293
- }
2294
- },
2295
- "unevaluatedProperties": {
2296
- "not": {}
2297
- },
2298
- "description": "Structured output for get_active_workflow_run."
2299
- },
2300
1709
  "Mcp.Tools.GetTraceInput": {
2301
1710
  "type": "object",
2302
1711
  "required": [
@@ -2331,114 +1740,6 @@
2331
1740
  },
2332
1741
  "description": "Structured output for get_trace."
2333
1742
  },
2334
- "Mcp.Tools.GetWorkflowGraphInput": {
2335
- "type": "object",
2336
- "required": [
2337
- "run_id"
2338
- ],
2339
- "properties": {
2340
- "run_id": {
2341
- "$ref": "#/$defs/Workflow.WorkflowRunId"
2342
- },
2343
- "node_cursor": {
2344
- "$ref": "#/$defs/Workflow.WorkflowNodeCursor",
2345
- "description": "Opaque node continuation. Reuse it unchanged from the preceding snapshot's next_node_cursor; do not parse, construct, or modify it."
2346
- },
2347
- "node_limit": {
2348
- "type": "integer",
2349
- "format": "int32",
2350
- "minimum": 1,
2351
- "maximum": 1000,
2352
- "default": 250
2353
- },
2354
- "edge_cursor": {
2355
- "$ref": "#/$defs/Workflow.WorkflowEdgeCursor",
2356
- "description": "Opaque edge continuation. Reuse it unchanged from the preceding snapshot's next_edge_cursor; do not parse, construct, or modify it."
2357
- },
2358
- "edge_limit": {
2359
- "type": "integer",
2360
- "format": "int32",
2361
- "minimum": 1,
2362
- "maximum": 2000,
2363
- "default": 500
2364
- }
2365
- },
2366
- "unevaluatedProperties": {
2367
- "not": {}
2368
- },
2369
- "description": "Input for get_workflow_graph."
2370
- },
2371
- "Mcp.Tools.GetWorkflowGraphOutput": {
2372
- "type": "object",
2373
- "required": [
2374
- "graph",
2375
- "mode"
2376
- ],
2377
- "properties": {
2378
- "graph": {
2379
- "$ref": "#/$defs/Workflow.WorkflowGraphSnapshot"
2380
- },
2381
- "mode": {
2382
- "$ref": "#/$defs/Mcp.Tools.McpDataMode"
2383
- }
2384
- },
2385
- "unevaluatedProperties": {
2386
- "not": {}
2387
- },
2388
- "description": "Structured output for get_workflow_graph."
2389
- },
2390
- "Mcp.Tools.InspectWorkflowEventsInput": {
2391
- "type": "object",
2392
- "required": [
2393
- "run_id",
2394
- "after_sequence"
2395
- ],
2396
- "properties": {
2397
- "run_id": {
2398
- "$ref": "#/$defs/Workflow.WorkflowRunId"
2399
- },
2400
- "after_sequence": {
2401
- "$ref": "#/$defs/Workflow.WorkflowJournalPosition"
2402
- },
2403
- "limit": {
2404
- "type": "integer",
2405
- "format": "int32",
2406
- "minimum": 1,
2407
- "maximum": 1000,
2408
- "default": 250
2409
- },
2410
- "content_ref": {
2411
- "$ref": "#/$defs/Workflow.WorkflowContentRef",
2412
- "description": "Optional captured payload to retrieve lazily for the selected run."
2413
- }
2414
- },
2415
- "unevaluatedProperties": {
2416
- "not": {}
2417
- },
2418
- "description": "Input for inspect_workflow_events."
2419
- },
2420
- "Mcp.Tools.InspectWorkflowEventsOutput": {
2421
- "type": "object",
2422
- "required": [
2423
- "page",
2424
- "mode"
2425
- ],
2426
- "properties": {
2427
- "page": {
2428
- "$ref": "#/$defs/Workflow.WorkflowEventPage"
2429
- },
2430
- "content": {
2431
- "$ref": "#/$defs/Workflow.WorkflowContent"
2432
- },
2433
- "mode": {
2434
- "$ref": "#/$defs/Mcp.Tools.McpDataMode"
2435
- }
2436
- },
2437
- "unevaluatedProperties": {
2438
- "not": {}
2439
- },
2440
- "description": "Structured output for inspect_workflow_events."
2441
- },
2442
1743
  "Mcp.Tools.ListSessionsInput": {
2443
1744
  "type": "object",
2444
1745
  "properties": {
@@ -2518,57 +1819,6 @@
2518
1819
  },
2519
1820
  "description": "Structured output for list_traces."
2520
1821
  },
2521
- "Mcp.Tools.ListWorkflowRunsInput": {
2522
- "type": "object",
2523
- "properties": {
2524
- "status": {
2525
- "$ref": "#/$defs/Workflow.WorkflowRunStatus"
2526
- },
2527
- "cursor": {
2528
- "$ref": "#/$defs/Workflow.WorkflowRunCursor"
2529
- },
2530
- "limit": {
2531
- "type": "integer",
2532
- "format": "int32",
2533
- "minimum": 1,
2534
- "maximum": 100,
2535
- "default": 20
2536
- }
2537
- },
2538
- "unevaluatedProperties": {
2539
- "not": {}
2540
- },
2541
- "description": "Input for list_workflow_runs."
2542
- },
2543
- "Mcp.Tools.ListWorkflowRunsOutput": {
2544
- "type": "object",
2545
- "required": [
2546
- "runs",
2547
- "has_more",
2548
- "mode"
2549
- ],
2550
- "properties": {
2551
- "runs": {
2552
- "type": "array",
2553
- "items": {
2554
- "$ref": "#/$defs/Workflow.WorkflowRun"
2555
- }
2556
- },
2557
- "next_cursor": {
2558
- "$ref": "#/$defs/Workflow.WorkflowRunCursor"
2559
- },
2560
- "has_more": {
2561
- "type": "boolean"
2562
- },
2563
- "mode": {
2564
- "$ref": "#/$defs/Mcp.Tools.McpDataMode"
2565
- }
2566
- },
2567
- "unevaluatedProperties": {
2568
- "not": {}
2569
- },
2570
- "description": "Structured output for list_workflow_runs."
2571
- },
2572
1822
  "Mcp.Tools.McpDashboardBucket": {
2573
1823
  "type": "object",
2574
1824
  "required": [
@@ -2792,148 +2042,23 @@
2792
2042
  "not": {}
2793
2043
  }
2794
2044
  },
2795
- "Mcp.Tools.RecordDiagnosticSnapshotCheckInput": {
2045
+ "Mcp.Tools.SearchLogsInput": {
2796
2046
  "type": "object",
2797
- "required": [
2798
- "check_id",
2799
- "operator",
2800
- "actual"
2801
- ],
2802
2047
  "properties": {
2803
- "check_id": {
2804
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticCheckId"
2048
+ "trace_id": {
2049
+ "$ref": "#/$defs/Common.TraceId"
2805
2050
  },
2806
- "operator": {
2807
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticOperator"
2051
+ "service_name": {
2052
+ "type": "string"
2808
2053
  },
2809
- "actual": {
2810
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticVariableName"
2054
+ "severity_min": {
2055
+ "type": "integer",
2056
+ "format": "int32",
2057
+ "minimum": 1,
2058
+ "maximum": 24
2811
2059
  },
2812
- "expected": {
2813
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticVariableName"
2814
- },
2815
- "expected_type": {
2816
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticValueType"
2817
- }
2818
- },
2819
- "unevaluatedProperties": {
2820
- "not": {}
2821
- },
2822
- "description": "One structural diagnostic check submitted for evaluation. equal, not_equal, contains, less_than, and greater_than require expected and forbid expected_type; type_is requires expected_type and forbids expected; exists forbids both."
2823
- },
2824
- "Mcp.Tools.RecordDiagnosticSnapshotInput": {
2825
- "type": "object",
2826
- "required": [
2827
- "snapshot_id",
2828
- "probe_id",
2829
- "phase",
2830
- "variables"
2831
- ],
2832
- "properties": {
2833
- "snapshot_id": {
2834
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticSnapshotId"
2835
- },
2836
- "probe_id": {
2837
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticProbeId"
2838
- },
2839
- "phase": {
2840
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticPhase"
2841
- },
2842
- "variables": {
2843
- "type": "array",
2844
- "items": {
2845
- "$ref": "#/$defs/Mcp.Tools.RecordDiagnosticSnapshotVariableInput"
2846
- },
2847
- "maxItems": 64
2848
- },
2849
- "checks": {
2850
- "type": "array",
2851
- "items": {
2852
- "$ref": "#/$defs/Mcp.Tools.RecordDiagnosticSnapshotCheckInput"
2853
- },
2854
- "maxItems": 64,
2855
- "default": []
2856
- }
2857
- },
2858
- "unevaluatedProperties": {
2859
- "not": {}
2860
- },
2861
- "description": "Input for record_diagnostic_snapshot. Reuse the same snapshot_id and semantic payload when retrying; changing the payload under an existing snapshot_id is a conflict."
2862
- },
2863
- "Mcp.Tools.RecordDiagnosticSnapshotOutput": {
2864
- "type": "object",
2865
- "required": [
2866
- "recorded",
2867
- "code",
2868
- "snapshot_id"
2869
- ],
2870
- "properties": {
2871
- "recorded": {
2872
- "type": "boolean"
2873
- },
2874
- "code": {
2875
- "type": "string"
2876
- },
2877
- "snapshot_id": {
2878
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticSnapshotId"
2879
- },
2880
- "event_id": {
2881
- "$ref": "#/$defs/Workflow.WorkflowEventId"
2882
- },
2883
- "field": {
2884
- "type": "string"
2885
- }
2886
- },
2887
- "unevaluatedProperties": {
2888
- "not": {}
2889
- },
2890
- "description": "Structured output for record_diagnostic_snapshot."
2891
- },
2892
- "Mcp.Tools.RecordDiagnosticSnapshotVariableInput": {
2893
- "type": "object",
2894
- "required": [
2895
- "name",
2896
- "classification",
2897
- "value"
2898
- ],
2899
- "properties": {
2900
- "name": {
2901
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticVariableName"
2902
- },
2903
- "classification": {
2904
- "$ref": "#/$defs/Diagnostics.AgentDiagnosticClassification"
2905
- },
2906
- "value": {
2907
- "anyOf": [
2908
- {},
2909
- {
2910
- "type": "null"
2911
- }
2912
- ]
2913
- }
2914
- },
2915
- "unevaluatedProperties": {
2916
- "not": {}
2917
- },
2918
- "description": "One dynamically named JSON value submitted for protected diagnostic capture. Classification is applied before the frame leaves the observer bridge."
2919
- },
2920
- "Mcp.Tools.SearchLogsInput": {
2921
- "type": "object",
2922
- "properties": {
2923
- "trace_id": {
2924
- "$ref": "#/$defs/Common.TraceId"
2925
- },
2926
- "service_name": {
2927
- "type": "string"
2928
- },
2929
- "severity_min": {
2930
- "type": "integer",
2931
- "format": "int32",
2932
- "minimum": 1,
2933
- "maximum": 24
2934
- },
2935
- "query": {
2936
- "type": "string"
2060
+ "query": {
2061
+ "type": "string"
2937
2062
  },
2938
2063
  "limit": {
2939
2064
  "type": "integer",
@@ -6886,1399 +6011,97 @@
6886
6011
  "workspaces": {
6887
6012
  "type": "array",
6888
6013
  "items": {
6889
- "$ref": "#/$defs/Workbench.WorkbenchWorkspace"
6890
- }
6891
- }
6892
- },
6893
- "unevaluatedProperties": {
6894
- "not": {}
6895
- },
6896
- "description": "Workspaces visible to the authenticated local session."
6897
- },
6898
- "Workbench.WorkbenchWorkspacePreferences": {
6899
- "type": "object",
6900
- "required": [
6901
- "workspace_id",
6902
- "input_mode",
6903
- "compact_mode",
6904
- "updated_at"
6905
- ],
6906
- "properties": {
6907
- "workspace_id": {
6908
- "$ref": "#/$defs/Workbench.WorkbenchWorkspaceId"
6909
- },
6910
- "selected_server_id": {
6911
- "$ref": "#/$defs/Workbench.WorkbenchServerId"
6912
- },
6913
- "selected_tool_name": {
6914
- "type": "string",
6915
- "maxLength": 1024
6916
- },
6917
- "input_mode": {
6918
- "$ref": "#/$defs/Workbench.WorkbenchToolInputMode"
6919
- },
6920
- "active_panel": {
6921
- "type": "string",
6922
- "maxLength": 128
6923
- },
6924
- "compact_mode": {
6925
- "type": "boolean"
6926
- },
6927
- "updated_at": {
6928
- "type": "string",
6929
- "format": "date-time"
6930
- }
6931
- },
6932
- "unevaluatedProperties": {
6933
- "not": {}
6934
- },
6935
- "description": "Saved presentation preferences isolated to one authenticated MCP workspace."
6936
- },
6937
- "Workbench.WorkbenchWorkspacePreferencesUpdateRequest": {
6938
- "type": "object",
6939
- "properties": {
6940
- "selected_server_id": {
6941
- "$ref": "#/$defs/Workbench.WorkbenchServerId"
6942
- },
6943
- "selected_tool_name": {
6944
- "type": "string",
6945
- "maxLength": 1024
6946
- },
6947
- "input_mode": {
6948
- "$ref": "#/$defs/Workbench.WorkbenchToolInputMode"
6949
- },
6950
- "active_panel": {
6951
- "type": "string",
6952
- "maxLength": 128
6953
- },
6954
- "compact_mode": {
6955
- "type": "boolean"
6956
- }
6957
- },
6958
- "unevaluatedProperties": {
6959
- "not": {}
6960
- },
6961
- "description": "Request to replace saved presentation preferences for one authenticated MCP workspace."
6962
- },
6963
- "Workbench.WorkbenchWorkspaceUpdateRequest": {
6964
- "type": "object",
6965
- "properties": {
6966
- "name": {
6967
- "type": "string",
6968
- "minLength": 1,
6969
- "maxLength": 120
6970
- },
6971
- "description": {
6972
- "type": "string",
6973
- "maxLength": 2000
6974
- }
6975
- },
6976
- "unevaluatedProperties": {
6977
- "not": {}
6978
- },
6979
- "description": "Request to update mutable MCP workbench workspace metadata."
6980
- },
6981
- "Workflow.CommittedWorkflowProjectionStatus": {
6982
- "type": "object",
6983
- "required": [
6984
- "state",
6985
- "generation",
6986
- "journal_position"
6987
- ],
6988
- "properties": {
6989
- "state": {
6990
- "type": "string",
6991
- "enum": [
6992
- "committed"
6993
- ]
6994
- },
6995
- "generation": {
6996
- "$ref": "#/$defs/Workflow.WorkflowGeneration"
6997
- },
6998
- "journal_position": {
6999
- "$ref": "#/$defs/Workflow.WorkflowJournalPosition"
7000
- }
7001
- },
7002
- "unevaluatedProperties": {
7003
- "not": {}
7004
- },
7005
- "description": "A valid committed projection that can be served to readers."
7006
- },
7007
- "Workflow.CorruptWorkflowProjectionStatus": {
7008
- "type": "object",
7009
- "required": [
7010
- "state",
7011
- "reason"
7012
- ],
7013
- "properties": {
7014
- "state": {
7015
- "type": "string",
7016
- "enum": [
7017
- "corrupt"
7018
- ]
7019
- },
7020
- "generation": {
7021
- "$ref": "#/$defs/Workflow.WorkflowGeneration"
7022
- },
7023
- "reason": {
7024
- "type": "string",
7025
- "enum": [
7026
- "corrupt_derived_state",
7027
- "incompatible_derived_state"
7028
- ]
7029
- }
7030
- },
7031
- "unevaluatedProperties": {
7032
- "not": {}
7033
- },
7034
- "description": "Derived projection state is corrupt or incompatible and cannot currently be served."
7035
- },
7036
- "Workflow.DerivedWorkflowEdgeProvenance": {
7037
- "type": "object",
7038
- "required": [
7039
- "type",
7040
- "event_ids",
7041
- "evidence",
7042
- "confidence"
7043
- ],
7044
- "properties": {
7045
- "type": {
7046
- "type": "string",
7047
- "enum": [
7048
- "derived"
7049
- ]
7050
- },
7051
- "event_ids": {
7052
- "type": "array",
7053
- "items": {
7054
- "$ref": "#/$defs/Workflow.WorkflowEventId"
7055
- },
7056
- "minItems": 1
7057
- },
7058
- "evidence": {
7059
- "type": "string"
7060
- },
7061
- "confidence": {
7062
- "$ref": "#/$defs/Common.Ratio"
7063
- }
7064
- },
7065
- "unevaluatedProperties": {
7066
- "not": {}
7067
- },
7068
- "description": "Derived edge provenance with explicit evidence and confidence."
7069
- },
7070
- "Workflow.RebuildingWorkflowProjectionStatus": {
7071
- "type": "object",
7072
- "required": [
7073
- "state",
7074
- "generation",
7075
- "target_journal_position",
7076
- "retry_after_ms"
7077
- ],
7078
- "properties": {
7079
- "state": {
7080
- "type": "string",
7081
- "enum": [
7082
- "rebuilding"
7083
- ]
7084
- },
7085
- "generation": {
7086
- "$ref": "#/$defs/Workflow.WorkflowGeneration"
7087
- },
7088
- "target_journal_position": {
7089
- "$ref": "#/$defs/Workflow.WorkflowJournalPosition"
7090
- },
7091
- "retry_after_ms": {
7092
- "type": "integer",
7093
- "format": "int32",
7094
- "minimum": 1
7095
- }
7096
- },
7097
- "unevaluatedProperties": {
7098
- "not": {}
7099
- },
7100
- "description": "The requested generation is being reconstructed from its authoritative journal."
7101
- },
7102
- "Workflow.RecordedWorkflowEdgeProvenance": {
7103
- "type": "object",
7104
- "required": [
7105
- "type",
7106
- "event_ids"
7107
- ],
7108
- "properties": {
7109
- "type": {
7110
- "type": "string",
7111
- "enum": [
7112
- "recorded"
7113
- ]
7114
- },
7115
- "event_ids": {
7116
- "type": "array",
7117
- "items": {
7118
- "$ref": "#/$defs/Workflow.WorkflowEventId"
7119
- },
7120
- "minItems": 1
7121
- }
7122
- },
7123
- "unevaluatedProperties": {
7124
- "not": {}
7125
- },
7126
- "description": "Recorded edge provenance directly observed from Codex."
7127
- },
7128
- "Workflow.UnavailableWorkflowProjectionStatus": {
7129
- "type": "object",
7130
- "required": [
7131
- "state",
7132
- "retry_after_ms"
7133
- ],
7134
- "properties": {
7135
- "state": {
7136
- "type": "string",
7137
- "enum": [
7138
- "unavailable"
7139
- ]
7140
- },
7141
- "generation": {
7142
- "$ref": "#/$defs/Workflow.WorkflowGeneration"
7143
- },
7144
- "retry_after_ms": {
7145
- "type": "integer",
7146
- "format": "int32",
7147
- "minimum": 1
7148
- }
7149
- },
7150
- "unevaluatedProperties": {
7151
- "not": {}
7152
- },
7153
- "description": "Projection work is temporarily unavailable after a retryable storage failure."
7154
- },
7155
- "Workflow.WorkflowAgentId": {
7156
- "type": "string",
7157
- "minLength": 1,
7158
- "maxLength": 128,
7159
- "description": "Stable identifier of one agent within a workflow run."
7160
- },
7161
- "Workflow.WorkflowAgentStatus": {
7162
- "type": "string",
7163
- "enum": [
7164
- "pending",
7165
- "running",
7166
- "waiting",
7167
- "succeeded",
7168
- "failed",
7169
- "interrupted"
7170
- ],
7171
- "description": "Current lifecycle of an observed workflow agent."
7172
- },
7173
- "Workflow.WorkflowAttemptId": {
7174
- "type": "string",
7175
- "minLength": 1,
7176
- "maxLength": 128,
7177
- "description": "Stable identifier of one workflow attempt."
7178
- },
7179
- "Workflow.WorkflowAttemptStatus": {
7180
- "type": "string",
7181
- "enum": [
7182
- "pending",
7183
- "running",
7184
- "succeeded",
7185
- "failed",
7186
- "interrupted"
7187
- ],
7188
- "description": "Current lifecycle of one workflow attempt."
7189
- },
7190
- "Workflow.WorkflowCommandId": {
7191
- "type": "string",
7192
- "minLength": 1,
7193
- "maxLength": 128,
7194
- "description": "Stable identifier of one run-level control command."
7195
- },
7196
- "Workflow.WorkflowContent": {
7197
- "type": "object",
7198
- "required": [
7199
- "content_ref",
7200
- "content_type",
7201
- "encoding",
7202
- "content",
7203
- "size_bytes"
7204
- ],
7205
- "properties": {
7206
- "content_ref": {
7207
- "$ref": "#/$defs/Workflow.WorkflowContentRef"
7208
- },
7209
- "content_type": {
7210
- "$ref": "#/$defs/Common.ContentType"
7211
- },
7212
- "encoding": {
7213
- "$ref": "#/$defs/Workflow.WorkflowContentEncoding"
7214
- },
7215
- "content": {
7216
- "type": "string"
7217
- },
7218
- "size_bytes": {
7219
- "$ref": "#/$defs/Common.ByteSize"
7220
- }
7221
- },
7222
- "unevaluatedProperties": {
7223
- "not": {}
7224
- },
7225
- "description": "Lazily retrieved captured workflow content."
7226
- },
7227
- "Workflow.WorkflowContentChunk": {
7228
- "type": "object",
7229
- "required": [
7230
- "content_ref",
7231
- "content_type",
7232
- "encoding",
7233
- "content"
7234
- ],
7235
- "properties": {
7236
- "content_ref": {
7237
- "$ref": "#/$defs/Workflow.WorkflowContentRef"
7238
- },
7239
- "content_type": {
7240
- "$ref": "#/$defs/Common.ContentType"
7241
- },
7242
- "encoding": {
7243
- "$ref": "#/$defs/Workflow.WorkflowContentEncoding"
7244
- },
7245
- "content": {
7246
- "type": "string",
7247
- "maxLength": 1398104,
7248
- "description": "UTF-8 text or base64 bytes, according to encoding."
7249
- }
7250
- },
7251
- "unevaluatedProperties": {
7252
- "not": {}
7253
- },
7254
- "description": "One captured payload supplied with an append batch."
7255
- },
7256
- "Workflow.WorkflowContentEncoding": {
7257
- "type": "string",
7258
- "enum": [
7259
- "utf8",
7260
- "base64"
7261
- ],
7262
- "description": "Encoding used when lazily returning captured workflow content."
7263
- },
7264
- "Workflow.WorkflowContentRef": {
7265
- "type": "string",
7266
- "minLength": 71,
7267
- "maxLength": 71,
7268
- "pattern": "^sha256:[a-f0-9]{64}$",
7269
- "description": "Content-addressed reference to a captured workflow payload."
7270
- },
7271
- "Workflow.WorkflowControlAction": {
7272
- "type": "string",
7273
- "enum": [
7274
- "steer",
7275
- "interrupt",
7276
- "resume"
7277
- ],
7278
- "description": "Control operation supported by the Codex app-server boundary."
7279
- },
7280
- "Workflow.WorkflowControlCommand": {
7281
- "type": "object",
7282
- "required": [
7283
- "command_id",
7284
- "run_id",
7285
- "action",
7286
- "status",
7287
- "idempotency_key",
7288
- "requested_at",
7289
- "updated_at",
7290
- "command_sequence"
7291
- ],
7292
- "properties": {
7293
- "command_id": {
7294
- "$ref": "#/$defs/Workflow.WorkflowCommandId"
7295
- },
7296
- "run_id": {
7297
- "$ref": "#/$defs/Workflow.WorkflowRunId"
7298
- },
7299
- "action": {
7300
- "$ref": "#/$defs/Workflow.WorkflowControlAction"
7301
- },
7302
- "status": {
7303
- "$ref": "#/$defs/Workflow.WorkflowControlStatus"
7304
- },
7305
- "idempotency_key": {
7306
- "type": "string"
7307
- },
7308
- "input": {
7309
- "type": "string"
7310
- },
7311
- "requested_at": {
7312
- "type": "string",
7313
- "format": "date-time"
7314
- },
7315
- "updated_at": {
7316
- "type": "string",
7317
- "format": "date-time"
7318
- },
7319
- "command_sequence": {
7320
- "$ref": "#/$defs/Workflow.WorkflowSequence"
7321
- },
7322
- "error": {
7323
- "type": "string"
7324
- }
7325
- },
7326
- "unevaluatedProperties": {
7327
- "not": {}
7328
- },
7329
- "description": "Durable run-level control command."
7330
- },
7331
- "Workflow.WorkflowControlCommandPage": {
7332
- "type": "object",
7333
- "required": [
7334
- "commands",
7335
- "next_sequence"
7336
- ],
7337
- "properties": {
7338
- "commands": {
7339
- "type": "array",
7340
- "items": {
7341
- "$ref": "#/$defs/Workflow.WorkflowControlCommand"
7342
- }
7343
- },
7344
- "next_sequence": {
7345
- "$ref": "#/$defs/Workflow.WorkflowSequence"
7346
- }
7347
- },
7348
- "unevaluatedProperties": {
7349
- "not": {}
7350
- },
7351
- "description": "Page of control commands polled by the launcher-owned outbound adapter."
7352
- },
7353
- "Workflow.WorkflowControlRequest": {
7354
- "type": "object",
7355
- "required": [
7356
- "action",
7357
- "idempotency_key"
7358
- ],
7359
- "properties": {
7360
- "action": {
7361
- "$ref": "#/$defs/Workflow.WorkflowControlAction"
7362
- },
7363
- "idempotency_key": {
7364
- "type": "string",
7365
- "minLength": 1,
7366
- "maxLength": 160
7367
- },
7368
- "input": {
7369
- "type": "string",
7370
- "maxLength": 32768,
7371
- "description": "Text appended by steer or resume. Omit for interrupt."
7372
- }
7373
- },
7374
- "unevaluatedProperties": {
7375
- "not": {}
7376
- },
7377
- "description": "Request to enqueue one idempotent run-level control command."
7378
- },
7379
- "Workflow.WorkflowControlStatus": {
7380
- "type": "string",
7381
- "enum": [
7382
- "requested",
7383
- "accepted",
7384
- "applied",
7385
- "rejected",
7386
- "failed"
7387
- ],
7388
- "description": "Durable lifecycle of a workflow control command."
7389
- },
7390
- "Workflow.WorkflowControlStatusUpdateRequest": {
7391
- "type": "object",
7392
- "required": [
7393
- "status"
7394
- ],
7395
- "properties": {
7396
- "status": {
7397
- "$ref": "#/$defs/Workflow.WorkflowControlStatus"
7398
- },
7399
- "error": {
7400
- "type": "string"
7401
- },
7402
- "occurred_at": {
7403
- "type": "string",
7404
- "format": "date-time",
7405
- "description": "When the reported transition actually occurred at the adapter that executed\nit. The journal event minted for this transition carries this clock — the\noriginating agent's — so control events order and measure consistently with\nthe agent-clocked events around them; omitted, the collector's receipt time\nis the fallback."
7406
- }
7407
- },
7408
- "unevaluatedProperties": {
7409
- "not": {}
7410
- },
7411
- "description": "Adapter acknowledgement or terminal result for one control command."
7412
- },
7413
- "Workflow.WorkflowCursorError": {
7414
- "type": "object",
7415
- "required": [
7416
- "title",
7417
- "cursor_kind",
7418
- "reason"
7419
- ],
7420
- "properties": {
7421
- "title": {
7422
- "type": "string",
7423
- "enum": [
7424
- "Invalid Workflow Cursor"
7425
- ]
7426
- },
7427
- "cursor_kind": {
7428
- "$ref": "#/$defs/Workflow.WorkflowCursorKind"
7429
- },
7430
- "reason": {
7431
- "$ref": "#/$defs/Workflow.WorkflowCursorFailureReason"
7432
- },
7433
- "current_generation": {
7434
- "$ref": "#/$defs/Workflow.WorkflowGeneration"
7435
- }
7436
- },
7437
- "unevaluatedProperties": {
7438
- "not": {}
7439
- },
7440
- "allOf": [
7441
- {
7442
- "$ref": "#/$defs/Common.Errors.ProblemDetails"
7443
- }
7444
- ],
7445
- "description": "Opaque graph cursor is malformed, belongs to another run, or targets a stale generation."
7446
- },
7447
- "Workflow.WorkflowCursorFailureReason": {
7448
- "type": "string",
7449
- "enum": [
7450
- "invalid",
7451
- "wrong_run",
7452
- "wrong_generation",
7453
- "stale"
7454
- ],
7455
- "description": "Why an opaque graph cursor cannot be reused for this request."
7456
- },
7457
- "Workflow.WorkflowCursorGapEvent": {
7458
- "type": "object",
7459
- "required": [
7460
- "type",
7461
- "oldest_available_sequence",
7462
- "high_water_mark",
7463
- "timestamp"
7464
- ],
7465
- "properties": {
7466
- "type": {
7467
- "type": "string",
7468
- "enum": [
7469
- "cursor_gap"
7470
- ]
7471
- },
7472
- "oldest_available_sequence": {
7473
- "$ref": "#/$defs/Workflow.WorkflowJournalPosition"
7474
- },
7475
- "high_water_mark": {
7476
- "$ref": "#/$defs/Workflow.WorkflowJournalPosition"
7477
- },
7478
- "timestamp": {
7479
- "type": "string",
7480
- "format": "date-time"
7481
- }
7482
- },
7483
- "unevaluatedProperties": {
7484
- "not": {}
7485
- },
7486
- "description": "Signals that the requested cursor predates retained workflow history."
7487
- },
7488
- "Workflow.WorkflowCursorKind": {
7489
- "type": "string",
7490
- "enum": [
7491
- "node",
7492
- "edge"
7493
- ],
7494
- "description": "Which opaque graph cursor was rejected."
7495
- },
7496
- "Workflow.WorkflowEdgeCursor": {
7497
- "type": "string",
7498
- "minLength": 1,
7499
- "maxLength": 1536,
7500
- "description": "Opaque edge-page continuation scoped to one workflow run and generation. Reuse it unchanged; clients must not parse or construct it."
7501
- },
7502
- "Workflow.WorkflowEdgeId": {
7503
- "type": "string",
7504
- "minLength": 1,
7505
- "maxLength": 192,
7506
- "description": "Stable identifier of one graph edge. Endpoint tuples preserve the nodes' structural run-versus-attempt scope and ordinal component boundaries, escape colon as \\c and backslash as \\\\, and never infer scope from a literal component value. A canonical identifier over 192 Unicode scalar values is replaced by its edge kind, a tilde, and the full lowercase 64-hex SHA-256 of the length-prefixed canonical tuple."
7507
- },
7508
- "Workflow.WorkflowEdgeKind": {
7509
- "type": "string",
7510
- "enum": [
7511
- "data",
7512
- "control",
7513
- "conflict",
7514
- "resource",
7515
- "gate",
7516
- "temporal"
7517
- ],
7518
- "description": "Semantic relationship represented by a workflow graph edge."
7519
- },
7520
- "Workflow.WorkflowEdgeProvenance": {
7521
- "anyOf": [
7522
- {
7523
- "$ref": "#/$defs/Workflow.RecordedWorkflowEdgeProvenance"
7524
- },
7525
- {
7526
- "$ref": "#/$defs/Workflow.DerivedWorkflowEdgeProvenance"
7527
- }
7528
- ],
7529
- "description": "Provenance for one workflow graph edge."
7530
- },
7531
- "Workflow.WorkflowEventAppend": {
7532
- "type": "object",
7533
- "required": [
7534
- "event_id",
7535
- "source_sequence",
7536
- "timestamp",
7537
- "kind"
7538
- ],
7539
- "properties": {
7540
- "event_id": {
7541
- "$ref": "#/$defs/Workflow.WorkflowEventId"
7542
- },
7543
- "source_sequence": {
7544
- "$ref": "#/$defs/Workflow.WorkflowSequence"
7545
- },
7546
- "timestamp": {
7547
- "type": "string",
7548
- "format": "date-time"
7549
- },
7550
- "kind": {
7551
- "$ref": "#/$defs/Workflow.WorkflowJournalEventKind"
7552
- },
7553
- "thread_id": {
7554
- "type": "string"
7555
- },
7556
- "turn_id": {
7557
- "type": "string"
7558
- },
7559
- "attempt_id": {
7560
- "$ref": "#/$defs/Workflow.WorkflowAttemptId"
7561
- },
7562
- "agent_id": {
7563
- "$ref": "#/$defs/Workflow.WorkflowAgentId"
7564
- },
7565
- "parent_agent_id": {
7566
- "$ref": "#/$defs/Workflow.WorkflowAgentId"
7567
- },
7568
- "receiver_agent_id": {
7569
- "$ref": "#/$defs/Workflow.WorkflowAgentId"
7570
- },
7571
- "tool_call_id": {
7572
- "$ref": "#/$defs/Workflow.WorkflowToolCallId"
7573
- },
7574
- "content_refs": {
7575
- "type": "array",
7576
- "items": {
7577
- "$ref": "#/$defs/Workflow.WorkflowContentRef"
7578
- },
7579
- "maxItems": 64
7580
- },
7581
- "data": {
7582
- "type": "object",
7583
- "unevaluatedProperties": {}
7584
- }
7585
- },
7586
- "description": "One source-ordered immutable journal event awaiting collector sequence assignment."
7587
- },
7588
- "Workflow.WorkflowEventBatchAppendRequest": {
7589
- "type": "object",
7590
- "required": [
7591
- "client_id",
7592
- "events"
7593
- ],
7594
- "properties": {
7595
- "client_id": {
7596
- "type": "string",
7597
- "minLength": 1,
7598
- "maxLength": 128
7599
- },
7600
- "events": {
7601
- "type": "array",
7602
- "items": {
7603
- "$ref": "#/$defs/Workflow.WorkflowEventAppend"
7604
- },
7605
- "minItems": 1,
7606
- "maxItems": 500
7607
- },
7608
- "content": {
7609
- "type": "array",
7610
- "items": {
7611
- "$ref": "#/$defs/Workflow.WorkflowContentChunk"
7612
- },
7613
- "maxItems": 500
7614
- }
7615
- },
7616
- "unevaluatedProperties": {
7617
- "not": {}
7618
- },
7619
- "description": "Idempotent append batch from one observer client."
7620
- },
7621
- "Workflow.WorkflowEventBatchAppendResponse": {
7622
- "type": "object",
7623
- "required": [
7624
- "accepted_count",
7625
- "duplicate_count",
7626
- "acknowledged_source_sequence"
7627
- ],
7628
- "properties": {
7629
- "accepted_count": {
7630
- "type": "integer",
7631
- "format": "int32",
7632
- "minimum": 0
7633
- },
7634
- "duplicate_count": {
7635
- "type": "integer",
7636
- "format": "int32",
7637
- "minimum": 0
7638
- },
7639
- "acknowledged_source_sequence": {
7640
- "$ref": "#/$defs/Workflow.WorkflowSequence"
7641
- },
7642
- "first_journal_sequence": {
7643
- "$ref": "#/$defs/Workflow.WorkflowJournalPosition"
7644
- },
7645
- "last_journal_sequence": {
7646
- "$ref": "#/$defs/Workflow.WorkflowJournalPosition"
7647
- }
7648
- },
7649
- "unevaluatedProperties": {
7650
- "not": {}
7651
- },
7652
- "description": "Collector acknowledgement for an idempotent workflow-event append."
7653
- },
7654
- "Workflow.WorkflowEventId": {
7655
- "type": "string",
7656
- "minLength": 1,
7657
- "maxLength": 160,
7658
- "description": "Stable identifier of one immutable journal event."
7659
- },
7660
- "Workflow.WorkflowEventPage": {
7661
- "type": "object",
7662
- "required": [
7663
- "events",
7664
- "next_sequence",
7665
- "high_water_mark",
7666
- "cursor_gap"
7667
- ],
7668
- "properties": {
7669
- "events": {
7670
- "type": "array",
7671
- "items": {
7672
- "$ref": "#/$defs/Workflow.WorkflowJournalEvent"
7673
- }
7674
- },
7675
- "next_sequence": {
7676
- "$ref": "#/$defs/Workflow.WorkflowJournalPosition"
7677
- },
7678
- "high_water_mark": {
7679
- "$ref": "#/$defs/Workflow.WorkflowJournalPosition"
7680
- },
7681
- "cursor_gap": {
7682
- "type": "boolean"
7683
- }
7684
- },
7685
- "unevaluatedProperties": {
7686
- "not": {}
7687
- },
7688
- "description": "A bounded page of workflow journal events."
7689
- },
7690
- "Workflow.WorkflowGeneration": {
7691
- "type": "string",
7692
- "minLength": 32,
7693
- "maxLength": 32,
7694
- "pattern": "^[0-9a-f]{12}4[0-9a-f]{3}[89ab][0-9a-f]{15}$",
7695
- "description": "Opaque incarnation identifier for one workflow run's projected state."
7696
- },
7697
- "Workflow.WorkflowGraphEdge": {
7698
- "type": "object",
7699
- "required": [
7700
- "edge_id",
7701
- "source_node_id",
7702
- "target_node_id",
7703
- "kind",
7704
- "provenance"
7705
- ],
7706
- "properties": {
7707
- "edge_id": {
7708
- "$ref": "#/$defs/Workflow.WorkflowEdgeId"
7709
- },
7710
- "source_node_id": {
7711
- "$ref": "#/$defs/Workflow.WorkflowNodeId"
7712
- },
7713
- "target_node_id": {
7714
- "$ref": "#/$defs/Workflow.WorkflowNodeId"
7715
- },
7716
- "kind": {
7717
- "$ref": "#/$defs/Workflow.WorkflowEdgeKind"
7718
- },
7719
- "provenance": {
7720
- "$ref": "#/$defs/Workflow.WorkflowEdgeProvenance"
7721
- }
7722
- },
7723
- "unevaluatedProperties": {
7724
- "not": {}
7725
- },
7726
- "description": "One typed edge in the deterministic workflow graph projection. Data, Control, and Gate edges are causal dependencies. Temporal edges describe observed order, Resource edges describe resource use, and Conflict edges describe contention; Temporal, Resource, and Conflict edges are excluded from critical-path causality."
7727
- },
7728
- "Workflow.WorkflowGraphNode": {
7729
- "type": "object",
7730
- "required": [
7731
- "node_id",
7732
- "kind",
7733
- "label",
7734
- "status"
7735
- ],
7736
- "properties": {
7737
- "node_id": {
7738
- "$ref": "#/$defs/Workflow.WorkflowNodeId"
7739
- },
7740
- "kind": {
7741
- "$ref": "#/$defs/Workflow.WorkflowNodeKind"
7742
- },
7743
- "label": {
7744
- "type": "string"
7745
- },
7746
- "status": {
7747
- "type": "string"
7748
- },
7749
- "attempt_id": {
7750
- "$ref": "#/$defs/Workflow.WorkflowAttemptId"
7751
- },
7752
- "agent_id": {
7753
- "$ref": "#/$defs/Workflow.WorkflowAgentId"
7754
- },
7755
- "started_at": {
7756
- "type": "string",
7757
- "format": "date-time"
7758
- },
7759
- "ended_at": {
7760
- "type": "string",
7761
- "format": "date-time"
7762
- },
7763
- "duration_ms": {
7764
- "$ref": "#/$defs/Common.DurationMs"
7765
- },
7766
- "content_refs": {
7767
- "type": "array",
7768
- "items": {
7769
- "$ref": "#/$defs/Workflow.WorkflowContentRef"
7770
- }
7771
- },
7772
- "attributes": {
7773
- "type": "object",
7774
- "unevaluatedProperties": {}
7775
- }
7776
- },
7777
- "unevaluatedProperties": {
7778
- "not": {}
7779
- },
7780
- "description": "One node in the deterministic workflow graph projection."
7781
- },
7782
- "Workflow.WorkflowGraphSnapshot": {
7783
- "type": "object",
7784
- "required": [
7785
- "run",
7786
- "projection_status",
7787
- "nodes",
7788
- "edges",
7789
- "statistics",
7790
- "journal_sequence",
7791
- "has_more_nodes",
7792
- "has_more_edges",
7793
- "total_node_count",
7794
- "total_edge_count"
7795
- ],
7796
- "properties": {
7797
- "run": {
7798
- "$ref": "#/$defs/Workflow.WorkflowRun"
7799
- },
7800
- "projection_status": {
7801
- "$ref": "#/$defs/Workflow.WorkflowProjectionStatus"
7802
- },
7803
- "nodes": {
7804
- "type": "array",
7805
- "items": {
7806
- "$ref": "#/$defs/Workflow.WorkflowGraphNode"
7807
- }
7808
- },
7809
- "edges": {
7810
- "type": "array",
7811
- "items": {
7812
- "$ref": "#/$defs/Workflow.WorkflowGraphEdge"
7813
- }
7814
- },
7815
- "statistics": {
7816
- "$ref": "#/$defs/Workflow.WorkflowGraphStatistics"
7817
- },
7818
- "journal_sequence": {
7819
- "$ref": "#/$defs/Workflow.WorkflowJournalPosition"
7820
- },
7821
- "next_node_cursor": {
7822
- "$ref": "#/$defs/Workflow.WorkflowNodeCursor",
7823
- "description": "Opaque node continuation for the next page. Reuse it unchanged as node_cursor on the next graph request; do not parse, construct, or modify it."
7824
- },
7825
- "next_edge_cursor": {
7826
- "$ref": "#/$defs/Workflow.WorkflowEdgeCursor",
7827
- "description": "Opaque edge continuation for the next page. Reuse it unchanged as edge_cursor on the next graph request; do not parse, construct, or modify it."
7828
- },
7829
- "has_more_nodes": {
7830
- "type": "boolean"
7831
- },
7832
- "has_more_edges": {
7833
- "type": "boolean"
7834
- },
7835
- "total_node_count": {
7836
- "type": "integer",
7837
- "format": "int32",
7838
- "minimum": 0
7839
- },
7840
- "total_edge_count": {
7841
- "type": "integer",
7842
- "format": "int32",
7843
- "minimum": 0
7844
- }
7845
- },
7846
- "unevaluatedProperties": {
7847
- "not": {}
7848
- },
7849
- "description": "Deterministic graph projection at one journal cursor."
7850
- },
7851
- "Workflow.WorkflowGraphStatistics": {
7852
- "type": "object",
7853
- "required": [
7854
- "t1_ms",
7855
- "t_infinity_ms",
7856
- "wall_time_ms",
7857
- "peak_concurrency",
7858
- "worker_count",
7859
- "parallel_lower_bound_ms",
7860
- "critical_path_node_ids"
7861
- ],
7862
- "properties": {
7863
- "t1_ms": {
7864
- "$ref": "#/$defs/Common.DurationMs"
7865
- },
7866
- "t_infinity_ms": {
7867
- "$ref": "#/$defs/Common.DurationMs"
7868
- },
7869
- "wall_time_ms": {
7870
- "$ref": "#/$defs/Common.DurationMs"
7871
- },
7872
- "peak_concurrency": {
7873
- "type": "integer",
7874
- "format": "int32",
7875
- "minimum": 0
7876
- },
7877
- "worker_count": {
7878
- "type": "integer",
7879
- "format": "int32",
7880
- "minimum": 1
7881
- },
7882
- "parallel_lower_bound_ms": {
7883
- "$ref": "#/$defs/Common.DurationMs"
7884
- },
7885
- "critical_path_node_ids": {
7886
- "type": "array",
7887
- "items": {
7888
- "$ref": "#/$defs/Workflow.WorkflowNodeId"
7889
- }
7890
- }
7891
- },
7892
- "unevaluatedProperties": {
7893
- "not": {}
7894
- },
7895
- "description": "Work and critical-path statistics for a workflow graph. Every ToolCall, Wait, Gate, and duration-bearing Message or Item contributes an independently weighted interval even when it has no Agent owner. An Agent contributes its own-work fragments: its interval minus the union of precisely owned child intervals clipped to the Agent interval. Precisely owned children are Control-linked Agent and ToolCall nodes, Temporal-linked Wait nodes, Gate-linked Gate nodes, and Data-linked duration-bearing Message or Item nodes. Peak concurrency sweeps every positive independently weighted or Agent own-work fragment. Critical-path analysis uses only Data, Control, and Gate edges, condenses each causal strongly connected component, charges every component member exactly once, and expands selected component members in ordinal node-id order."
7896
- },
7897
- "Workflow.WorkflowHeartbeatEvent": {
7898
- "type": "object",
7899
- "required": [
7900
- "type",
7901
- "high_water_mark",
7902
- "timestamp"
7903
- ],
7904
- "properties": {
7905
- "type": {
7906
- "type": "string",
7907
- "enum": [
7908
- "heartbeat"
7909
- ]
7910
- },
7911
- "high_water_mark": {
7912
- "$ref": "#/$defs/Workflow.WorkflowJournalPosition"
7913
- },
7914
- "timestamp": {
7915
- "type": "string",
7916
- "format": "date-time"
7917
- }
7918
- },
7919
- "unevaluatedProperties": {
7920
- "not": {}
7921
- },
7922
- "description": "Keep-alive emitted while a workflow event stream has no new event."
7923
- },
7924
- "Workflow.WorkflowJournalEvent": {
7925
- "type": "object",
7926
- "required": [
7927
- "run_id",
7928
- "client_id",
7929
- "journal_sequence"
7930
- ],
7931
- "properties": {
7932
- "run_id": {
7933
- "$ref": "#/$defs/Workflow.WorkflowRunId"
7934
- },
7935
- "client_id": {
7936
- "type": "string"
7937
- },
7938
- "journal_sequence": {
7939
- "$ref": "#/$defs/Workflow.WorkflowJournalPosition"
7940
- }
7941
- },
7942
- "unevaluatedProperties": {
7943
- "not": {}
7944
- },
7945
- "allOf": [
7946
- {
7947
- "$ref": "#/$defs/Workflow.WorkflowEventAppend"
7948
- }
7949
- ],
7950
- "description": "One immutable event after collector journal sequence assignment."
7951
- },
7952
- "Workflow.WorkflowJournalEventKind": {
7953
- "type": "string",
7954
- "enum": [
7955
- "run_created",
7956
- "run_completed",
7957
- "thread_started",
7958
- "thread_resumed",
7959
- "turn_started",
7960
- "turn_completed",
7961
- "turn_interrupted",
7962
- "attempt_started",
7963
- "attempt_completed",
7964
- "agent_spawned",
7965
- "agent_started",
7966
- "agent_completed",
7967
- "message_sent",
7968
- "message_received",
7969
- "wait_started",
7970
- "wait_completed",
7971
- "joined",
7972
- "item_started",
7973
- "item_completed",
7974
- "tool_started",
7975
- "tool_completed",
7976
- "approval_requested",
7977
- "approval_resolved",
7978
- "content_captured",
7979
- "file_written",
7980
- "control_requested",
7981
- "control_accepted",
7982
- "control_applied",
7983
- "control_rejected",
7984
- "control_failed"
7985
- ],
7986
- "description": "Immutable journal event kinds accepted from a Codex observer."
7987
- },
7988
- "Workflow.WorkflowJournalPosition": {
7989
- "type": "string",
7990
- "format": "uint64",
7991
- "description": "Collector-assigned position in the authoritative workflow journal, encoded without JavaScript precision loss.",
7992
- "pattern": "^(0|[1-9][0-9]*)$",
7993
- "maxLength": 20
7994
- },
7995
- "Workflow.WorkflowNodeCursor": {
7996
- "type": "string",
7997
- "minLength": 1,
7998
- "maxLength": 1536,
7999
- "description": "Opaque node-page continuation scoped to one workflow run and generation. Reuse it unchanged; clients must not parse or construct it."
8000
- },
8001
- "Workflow.WorkflowNodeId": {
8002
- "type": "string",
8003
- "minLength": 1,
8004
- "maxLength": 192,
8005
- "description": "Stable identifier of one graph node. Canonical tuples structurally distinguish run scope from attempt scope, escape colon as \\c and backslash as \\\\, and never infer scope from a literal component value. A canonical identifier over 192 Unicode scalar values is replaced by its kind, a tilde, and the full lowercase 64-hex SHA-256 of the length-prefixed canonical tuple."
8006
- },
8007
- "Workflow.WorkflowNodeKind": {
8008
- "type": "string",
8009
- "enum": [
8010
- "run",
8011
- "attempt",
8012
- "turn",
8013
- "agent",
8014
- "tool_call",
8015
- "message",
8016
- "wait",
8017
- "gate",
8018
- "resource"
8019
- ],
8020
- "description": "Kinds of execution node in the deterministic workflow graph."
8021
- },
8022
- "Workflow.WorkflowProjectionCorruptError": {
8023
- "type": "object",
8024
- "required": [
8025
- "title",
8026
- "projection_status"
8027
- ],
8028
- "properties": {
8029
- "title": {
8030
- "type": "string",
8031
- "enum": [
8032
- "Workflow Projection Corrupt"
8033
- ]
8034
- },
8035
- "projection_status": {
8036
- "$ref": "#/$defs/Workflow.WorkflowProjectionStatus"
8037
- }
8038
- },
8039
- "unevaluatedProperties": {
8040
- "not": {}
8041
- },
8042
- "allOf": [
8043
- {
8044
- "$ref": "#/$defs/Common.Errors.ProblemDetails"
8045
- }
8046
- ],
8047
- "description": "Workflow projection is non-retryably corrupt or incompatible. Internal storage details are intentionally omitted."
8048
- },
8049
- "Workflow.WorkflowProjectionStatus": {
8050
- "anyOf": [
8051
- {
8052
- "$ref": "#/$defs/Workflow.CommittedWorkflowProjectionStatus"
8053
- },
8054
- {
8055
- "$ref": "#/$defs/Workflow.RebuildingWorkflowProjectionStatus"
8056
- },
8057
- {
8058
- "$ref": "#/$defs/Workflow.UnavailableWorkflowProjectionStatus"
8059
- },
8060
- {
8061
- "$ref": "#/$defs/Workflow.CorruptWorkflowProjectionStatus"
8062
- }
8063
- ],
8064
- "description": "Closed public availability state for one workflow projection. Storage paths, hashes, fingerprints, and database errors remain private."
8065
- },
8066
- "Workflow.WorkflowProjectionUnavailableError": {
8067
- "type": "object",
8068
- "required": [
8069
- "title",
8070
- "projection_status"
8071
- ],
8072
- "properties": {
8073
- "title": {
8074
- "type": "string",
8075
- "enum": [
8076
- "Workflow Projection Unavailable"
8077
- ]
8078
- },
8079
- "projection_status": {
8080
- "$ref": "#/$defs/Workflow.WorkflowProjectionStatus"
8081
- }
8082
- },
8083
- "unevaluatedProperties": {
8084
- "not": {}
8085
- },
8086
- "allOf": [
8087
- {
8088
- "$ref": "#/$defs/Common.Errors.ProblemDetails"
8089
- }
8090
- ],
8091
- "description": "Workflow projection is rebuilding or temporarily unavailable after a retryable storage failure."
8092
- },
8093
- "Workflow.WorkflowRun": {
8094
- "type": "object",
8095
- "required": [
8096
- "run_id",
8097
- "generation",
8098
- "status",
8099
- "started_at",
8100
- "latest_journal_sequence"
8101
- ],
8102
- "properties": {
8103
- "run_id": {
8104
- "$ref": "#/$defs/Workflow.WorkflowRunId"
8105
- },
8106
- "generation": {
8107
- "$ref": "#/$defs/Workflow.WorkflowGeneration"
8108
- },
8109
- "thread_id": {
8110
- "type": "string"
8111
- },
8112
- "title": {
8113
- "type": "string"
8114
- },
8115
- "status": {
8116
- "$ref": "#/$defs/Workflow.WorkflowRunStatus"
8117
- },
8118
- "started_at": {
8119
- "type": "string",
8120
- "format": "date-time"
8121
- },
8122
- "ended_at": {
8123
- "type": "string",
8124
- "format": "date-time"
8125
- },
8126
- "latest_journal_sequence": {
8127
- "$ref": "#/$defs/Workflow.WorkflowJournalPosition"
8128
- },
8129
- "active_attempt_id": {
8130
- "$ref": "#/$defs/Workflow.WorkflowAttemptId"
8131
- },
8132
- "metadata": {
8133
- "type": "object",
8134
- "unevaluatedProperties": {}
6014
+ "$ref": "#/$defs/Workbench.WorkbenchWorkspace"
6015
+ }
8135
6016
  }
8136
6017
  },
8137
6018
  "unevaluatedProperties": {
8138
6019
  "not": {}
8139
6020
  },
8140
- "description": "One immutable workflow run."
6021
+ "description": "Workspaces visible to the authenticated local session."
8141
6022
  },
8142
- "Workflow.WorkflowRunCreateRequest": {
6023
+ "Workbench.WorkbenchWorkspacePreferences": {
8143
6024
  "type": "object",
8144
6025
  "required": [
8145
- "run_id",
8146
- "started_at"
6026
+ "workspace_id",
6027
+ "input_mode",
6028
+ "compact_mode",
6029
+ "updated_at"
8147
6030
  ],
8148
6031
  "properties": {
8149
- "run_id": {
8150
- "$ref": "#/$defs/Workflow.WorkflowRunId"
6032
+ "workspace_id": {
6033
+ "$ref": "#/$defs/Workbench.WorkbenchWorkspaceId"
8151
6034
  },
8152
- "thread_id": {
8153
- "type": "string"
6035
+ "selected_server_id": {
6036
+ "$ref": "#/$defs/Workbench.WorkbenchServerId"
8154
6037
  },
8155
- "title": {
8156
- "type": "string"
6038
+ "selected_tool_name": {
6039
+ "type": "string",
6040
+ "maxLength": 1024
8157
6041
  },
8158
- "started_at": {
6042
+ "input_mode": {
6043
+ "$ref": "#/$defs/Workbench.WorkbenchToolInputMode"
6044
+ },
6045
+ "active_panel": {
8159
6046
  "type": "string",
8160
- "format": "date-time"
6047
+ "maxLength": 128
8161
6048
  },
8162
- "metadata": {
8163
- "type": "object",
8164
- "unevaluatedProperties": {}
6049
+ "compact_mode": {
6050
+ "type": "boolean"
6051
+ },
6052
+ "updated_at": {
6053
+ "type": "string",
6054
+ "format": "date-time"
8165
6055
  }
8166
6056
  },
8167
6057
  "unevaluatedProperties": {
8168
6058
  "not": {}
8169
6059
  },
8170
- "description": "Request to create an observed workflow run before appending journal events."
8171
- },
8172
- "Workflow.WorkflowRunCursor": {
8173
- "type": "string",
8174
- "minLength": 1,
8175
- "maxLength": 512,
8176
- "description": "Opaque workflow-run list continuation scoped to the project and status filter. Reuse it unchanged; clients must not parse or construct it."
6060
+ "description": "Saved presentation preferences isolated to one authenticated MCP workspace."
8177
6061
  },
8178
- "Workflow.WorkflowRunDeletedError": {
6062
+ "Workbench.WorkbenchWorkspacePreferencesUpdateRequest": {
8179
6063
  "type": "object",
8180
- "required": [
8181
- "title",
8182
- "run_id"
8183
- ],
8184
6064
  "properties": {
8185
- "title": {
6065
+ "selected_server_id": {
6066
+ "$ref": "#/$defs/Workbench.WorkbenchServerId"
6067
+ },
6068
+ "selected_tool_name": {
8186
6069
  "type": "string",
8187
- "enum": [
8188
- "Workflow Run Deleted"
8189
- ]
6070
+ "maxLength": 1024
8190
6071
  },
8191
- "run_id": {
8192
- "$ref": "#/$defs/Workflow.WorkflowRunId"
6072
+ "input_mode": {
6073
+ "$ref": "#/$defs/Workbench.WorkbenchToolInputMode"
6074
+ },
6075
+ "active_panel": {
6076
+ "type": "string",
6077
+ "maxLength": 128
6078
+ },
6079
+ "compact_mode": {
6080
+ "type": "boolean"
8193
6081
  }
8194
6082
  },
8195
6083
  "unevaluatedProperties": {
8196
6084
  "not": {}
8197
6085
  },
8198
- "allOf": [
8199
- {
8200
- "$ref": "#/$defs/Common.Errors.ProblemDetails"
8201
- }
8202
- ],
8203
- "description": "Workflow run was durably deleted and can no longer accept events or publish projections."
8204
- },
8205
- "Workflow.WorkflowRunId": {
8206
- "type": "string",
8207
- "minLength": 1,
8208
- "maxLength": 128,
8209
- "description": "Stable identifier of one observed Codex workflow run."
6086
+ "description": "Request to replace saved presentation preferences for one authenticated MCP workspace."
8210
6087
  },
8211
- "Workflow.WorkflowRunPage": {
6088
+ "Workbench.WorkbenchWorkspaceUpdateRequest": {
8212
6089
  "type": "object",
8213
- "required": [
8214
- "items",
8215
- "has_more"
8216
- ],
8217
6090
  "properties": {
8218
- "items": {
8219
- "type": "array",
8220
- "items": {
8221
- "$ref": "#/$defs/Workflow.WorkflowRun"
8222
- }
8223
- },
8224
- "next_cursor": {
8225
- "$ref": "#/$defs/Workflow.WorkflowRunCursor"
6091
+ "name": {
6092
+ "type": "string",
6093
+ "minLength": 1,
6094
+ "maxLength": 120
8226
6095
  },
8227
- "has_more": {
8228
- "type": "boolean"
6096
+ "description": {
6097
+ "type": "string",
6098
+ "maxLength": 2000
8229
6099
  }
8230
6100
  },
8231
6101
  "unevaluatedProperties": {
8232
6102
  "not": {}
8233
6103
  },
8234
- "description": "Cursor page of workflow runs."
8235
- },
8236
- "Workflow.WorkflowRunStatus": {
8237
- "type": "string",
8238
- "enum": [
8239
- "active",
8240
- "completed",
8241
- "failed",
8242
- "interrupted"
8243
- ],
8244
- "description": "Current lifecycle of a workflow run."
8245
- },
8246
- "Workflow.WorkflowSequence": {
8247
- "type": "string",
8248
- "format": "uint64",
8249
- "description": "Unsigned source or collector journal sequence encoded without JavaScript precision loss.",
8250
- "pattern": "^(0|[1-9][0-9]*)$",
8251
- "maxLength": 20
8252
- },
8253
- "Workflow.WorkflowStreamEvents": {
8254
- "anyOf": [
8255
- {
8256
- "$ref": "#/$defs/Workflow.WorkflowJournalEvent"
8257
- },
8258
- {
8259
- "$ref": "#/$defs/Workflow.WorkflowHeartbeatEvent"
8260
- },
8261
- {
8262
- "$ref": "#/$defs/Workflow.WorkflowCursorGapEvent"
8263
- }
8264
- ]
8265
- },
8266
- "Workflow.WorkflowToolCallId": {
8267
- "type": "string",
8268
- "minLength": 1,
8269
- "maxLength": 128,
8270
- "description": "Stable identifier of one tool call within a workflow run."
8271
- },
8272
- "Workflow.WorkflowToolCallStatus": {
8273
- "type": "string",
8274
- "enum": [
8275
- "requested",
8276
- "running",
8277
- "succeeded",
8278
- "failed",
8279
- "rejected"
8280
- ],
8281
- "description": "Current lifecycle of an observed tool call."
6104
+ "description": "Request to update mutable MCP workbench workspace metadata."
8282
6105
  },
8283
6106
  "Operations.LogsApi_list.Response.200": {
8284
6107
  "type": "object",
@@ -9692,246 +7515,6 @@
9692
7515
  "Operations.WorkbenchWorkspacesApi_updatePreferences.Response.503": {
9693
7516
  "$ref": "#/$defs/Common.Errors.ServiceUnavailableError"
9694
7517
  },
9695
- "Operations.WorkflowRunsApi_appendEvents.Request": {
9696
- "$ref": "#/$defs/Workflow.WorkflowEventBatchAppendRequest"
9697
- },
9698
- "Operations.WorkflowRunsApi_appendEvents.Response.200": {
9699
- "$ref": "#/$defs/Workflow.WorkflowEventBatchAppendResponse"
9700
- },
9701
- "Operations.WorkflowRunsApi_appendEvents.Response.400": {
9702
- "$ref": "#/$defs/Common.Errors.ValidationError"
9703
- },
9704
- "Operations.WorkflowRunsApi_appendEvents.Response.401": {
9705
- "$ref": "#/$defs/Common.Errors.UnauthorizedError"
9706
- },
9707
- "Operations.WorkflowRunsApi_appendEvents.Response.404": {
9708
- "$ref": "#/$defs/Common.Errors.NotFoundError"
9709
- },
9710
- "Operations.WorkflowRunsApi_appendEvents.Response.409": {
9711
- "$ref": "#/$defs/Common.Errors.ConflictError"
9712
- },
9713
- "Operations.WorkflowRunsApi_appendEvents.Response.410": {
9714
- "$ref": "#/$defs/Workflow.WorkflowRunDeletedError"
9715
- },
9716
- "Operations.WorkflowRunsApi_appendEvents.Response.500": {
9717
- "$ref": "#/$defs/Common.Errors.InternalServerError"
9718
- },
9719
- "Operations.WorkflowRunsApi_appendEvents.Response.503": {
9720
- "$ref": "#/$defs/Common.Errors.ServiceUnavailableError"
9721
- },
9722
- "Operations.WorkflowRunsApi_create.Request": {
9723
- "$ref": "#/$defs/Workflow.WorkflowRunCreateRequest"
9724
- },
9725
- "Operations.WorkflowRunsApi_create.Response.200": {
9726
- "$ref": "#/$defs/Workflow.WorkflowRun"
9727
- },
9728
- "Operations.WorkflowRunsApi_create.Response.400": {
9729
- "$ref": "#/$defs/Common.Errors.ValidationError"
9730
- },
9731
- "Operations.WorkflowRunsApi_create.Response.401": {
9732
- "$ref": "#/$defs/Common.Errors.UnauthorizedError"
9733
- },
9734
- "Operations.WorkflowRunsApi_create.Response.409": {
9735
- "$ref": "#/$defs/Common.Errors.ConflictError"
9736
- },
9737
- "Operations.WorkflowRunsApi_create.Response.410": {
9738
- "$ref": "#/$defs/Workflow.WorkflowRunDeletedError"
9739
- },
9740
- "Operations.WorkflowRunsApi_create.Response.500": {
9741
- "$ref": "#/$defs/Common.Errors.InternalServerError"
9742
- },
9743
- "Operations.WorkflowRunsApi_create.Response.503": {
9744
- "$ref": "#/$defs/Common.Errors.ServiceUnavailableError"
9745
- },
9746
- "Operations.WorkflowRunsApi_get.Response.200": {
9747
- "$ref": "#/$defs/Workflow.WorkflowRun"
9748
- },
9749
- "Operations.WorkflowRunsApi_get.Response.401": {
9750
- "$ref": "#/$defs/Common.Errors.UnauthorizedError"
9751
- },
9752
- "Operations.WorkflowRunsApi_get.Response.404": {
9753
- "$ref": "#/$defs/Common.Errors.NotFoundError"
9754
- },
9755
- "Operations.WorkflowRunsApi_get.Response.410": {
9756
- "$ref": "#/$defs/Workflow.WorkflowRunDeletedError"
9757
- },
9758
- "Operations.WorkflowRunsApi_get.Response.500": {
9759
- "$ref": "#/$defs/Common.Errors.InternalServerError"
9760
- },
9761
- "Operations.WorkflowRunsApi_get.Response.503": {
9762
- "$ref": "#/$defs/Common.Errors.ServiceUnavailableError"
9763
- },
9764
- "Operations.WorkflowRunsApi_getContent.Response.200": {
9765
- "$ref": "#/$defs/Workflow.WorkflowContent"
9766
- },
9767
- "Operations.WorkflowRunsApi_getContent.Response.401": {
9768
- "$ref": "#/$defs/Common.Errors.UnauthorizedError"
9769
- },
9770
- "Operations.WorkflowRunsApi_getContent.Response.404": {
9771
- "$ref": "#/$defs/Common.Errors.NotFoundError"
9772
- },
9773
- "Operations.WorkflowRunsApi_getContent.Response.410": {
9774
- "$ref": "#/$defs/Workflow.WorkflowRunDeletedError"
9775
- },
9776
- "Operations.WorkflowRunsApi_getContent.Response.500": {
9777
- "$ref": "#/$defs/Common.Errors.InternalServerError"
9778
- },
9779
- "Operations.WorkflowRunsApi_getContent.Response.503": {
9780
- "$ref": "#/$defs/Common.Errors.ServiceUnavailableError"
9781
- },
9782
- "Operations.WorkflowRunsApi_getGraph.Response.200": {
9783
- "$ref": "#/$defs/Workflow.WorkflowGraphSnapshot"
9784
- },
9785
- "Operations.WorkflowRunsApi_getGraph.Response.400": {
9786
- "$ref": "#/$defs/Common.Errors.ValidationError"
9787
- },
9788
- "Operations.WorkflowRunsApi_getGraph.Response.401": {
9789
- "$ref": "#/$defs/Common.Errors.UnauthorizedError"
9790
- },
9791
- "Operations.WorkflowRunsApi_getGraph.Response.404": {
9792
- "$ref": "#/$defs/Common.Errors.NotFoundError"
9793
- },
9794
- "Operations.WorkflowRunsApi_getGraph.Response.409": {
9795
- "$ref": "#/$defs/Workflow.WorkflowCursorError"
9796
- },
9797
- "Operations.WorkflowRunsApi_getGraph.Response.410": {
9798
- "$ref": "#/$defs/Workflow.WorkflowRunDeletedError"
9799
- },
9800
- "Operations.WorkflowRunsApi_getGraph.Response.500": {
9801
- "$ref": "#/$defs/Workflow.WorkflowProjectionCorruptError"
9802
- },
9803
- "Operations.WorkflowRunsApi_getGraph.Response.503": {
9804
- "$ref": "#/$defs/Workflow.WorkflowProjectionUnavailableError"
9805
- },
9806
- "Operations.WorkflowRunsApi_list.Response.200": {
9807
- "$ref": "#/$defs/Workflow.WorkflowRunPage"
9808
- },
9809
- "Operations.WorkflowRunsApi_list.Response.400": {
9810
- "$ref": "#/$defs/Common.Errors.ValidationError"
9811
- },
9812
- "Operations.WorkflowRunsApi_list.Response.401": {
9813
- "$ref": "#/$defs/Common.Errors.UnauthorizedError"
9814
- },
9815
- "Operations.WorkflowRunsApi_list.Response.500": {
9816
- "$ref": "#/$defs/Common.Errors.InternalServerError"
9817
- },
9818
- "Operations.WorkflowRunsApi_list.Response.503": {
9819
- "$ref": "#/$defs/Common.Errors.ServiceUnavailableError"
9820
- },
9821
- "Operations.WorkflowRunsApi_pollControls.Response.200": {
9822
- "$ref": "#/$defs/Workflow.WorkflowControlCommandPage"
9823
- },
9824
- "Operations.WorkflowRunsApi_pollControls.Response.400": {
9825
- "$ref": "#/$defs/Common.Errors.ValidationError"
9826
- },
9827
- "Operations.WorkflowRunsApi_pollControls.Response.401": {
9828
- "$ref": "#/$defs/Common.Errors.UnauthorizedError"
9829
- },
9830
- "Operations.WorkflowRunsApi_pollControls.Response.404": {
9831
- "$ref": "#/$defs/Common.Errors.NotFoundError"
9832
- },
9833
- "Operations.WorkflowRunsApi_pollControls.Response.410": {
9834
- "$ref": "#/$defs/Workflow.WorkflowRunDeletedError"
9835
- },
9836
- "Operations.WorkflowRunsApi_pollControls.Response.500": {
9837
- "$ref": "#/$defs/Common.Errors.InternalServerError"
9838
- },
9839
- "Operations.WorkflowRunsApi_pollControls.Response.503": {
9840
- "$ref": "#/$defs/Common.Errors.ServiceUnavailableError"
9841
- },
9842
- "Operations.WorkflowRunsApi_readEvents.Response.200": {
9843
- "$ref": "#/$defs/Workflow.WorkflowEventPage"
9844
- },
9845
- "Operations.WorkflowRunsApi_readEvents.Response.400": {
9846
- "$ref": "#/$defs/Common.Errors.ValidationError"
9847
- },
9848
- "Operations.WorkflowRunsApi_readEvents.Response.401": {
9849
- "$ref": "#/$defs/Common.Errors.UnauthorizedError"
9850
- },
9851
- "Operations.WorkflowRunsApi_readEvents.Response.404": {
9852
- "$ref": "#/$defs/Common.Errors.NotFoundError"
9853
- },
9854
- "Operations.WorkflowRunsApi_readEvents.Response.410": {
9855
- "$ref": "#/$defs/Workflow.WorkflowRunDeletedError"
9856
- },
9857
- "Operations.WorkflowRunsApi_readEvents.Response.500": {
9858
- "$ref": "#/$defs/Common.Errors.InternalServerError"
9859
- },
9860
- "Operations.WorkflowRunsApi_readEvents.Response.503": {
9861
- "$ref": "#/$defs/Common.Errors.ServiceUnavailableError"
9862
- },
9863
- "Operations.WorkflowRunsApi_stream.Response.400": {
9864
- "$ref": "#/$defs/Common.Errors.ValidationError"
9865
- },
9866
- "Operations.WorkflowRunsApi_stream.Response.401": {
9867
- "$ref": "#/$defs/Common.Errors.UnauthorizedError"
9868
- },
9869
- "Operations.WorkflowRunsApi_stream.Response.404": {
9870
- "$ref": "#/$defs/Common.Errors.NotFoundError"
9871
- },
9872
- "Operations.WorkflowRunsApi_stream.Response.410": {
9873
- "$ref": "#/$defs/Workflow.WorkflowRunDeletedError"
9874
- },
9875
- "Operations.WorkflowRunsApi_stream.Response.500": {
9876
- "$ref": "#/$defs/Common.Errors.InternalServerError"
9877
- },
9878
- "Operations.WorkflowRunsApi_stream.Response.503": {
9879
- "$ref": "#/$defs/Common.Errors.ServiceUnavailableError"
9880
- },
9881
- "Operations.WorkflowRunsApi_submitControl.Request": {
9882
- "$ref": "#/$defs/Workflow.WorkflowControlRequest"
9883
- },
9884
- "Operations.WorkflowRunsApi_submitControl.Response.200": {
9885
- "$ref": "#/$defs/Workflow.WorkflowControlCommand"
9886
- },
9887
- "Operations.WorkflowRunsApi_submitControl.Response.400": {
9888
- "$ref": "#/$defs/Common.Errors.ValidationError"
9889
- },
9890
- "Operations.WorkflowRunsApi_submitControl.Response.401": {
9891
- "$ref": "#/$defs/Common.Errors.UnauthorizedError"
9892
- },
9893
- "Operations.WorkflowRunsApi_submitControl.Response.404": {
9894
- "$ref": "#/$defs/Common.Errors.NotFoundError"
9895
- },
9896
- "Operations.WorkflowRunsApi_submitControl.Response.409": {
9897
- "$ref": "#/$defs/Common.Errors.ConflictError"
9898
- },
9899
- "Operations.WorkflowRunsApi_submitControl.Response.410": {
9900
- "$ref": "#/$defs/Workflow.WorkflowRunDeletedError"
9901
- },
9902
- "Operations.WorkflowRunsApi_submitControl.Response.500": {
9903
- "$ref": "#/$defs/Common.Errors.InternalServerError"
9904
- },
9905
- "Operations.WorkflowRunsApi_submitControl.Response.503": {
9906
- "$ref": "#/$defs/Common.Errors.ServiceUnavailableError"
9907
- },
9908
- "Operations.WorkflowRunsApi_updateControl.Request": {
9909
- "$ref": "#/$defs/Workflow.WorkflowControlStatusUpdateRequest"
9910
- },
9911
- "Operations.WorkflowRunsApi_updateControl.Response.200": {
9912
- "$ref": "#/$defs/Workflow.WorkflowControlCommand"
9913
- },
9914
- "Operations.WorkflowRunsApi_updateControl.Response.400": {
9915
- "$ref": "#/$defs/Common.Errors.ValidationError"
9916
- },
9917
- "Operations.WorkflowRunsApi_updateControl.Response.401": {
9918
- "$ref": "#/$defs/Common.Errors.UnauthorizedError"
9919
- },
9920
- "Operations.WorkflowRunsApi_updateControl.Response.404": {
9921
- "$ref": "#/$defs/Common.Errors.NotFoundError"
9922
- },
9923
- "Operations.WorkflowRunsApi_updateControl.Response.409": {
9924
- "$ref": "#/$defs/Common.Errors.ConflictError"
9925
- },
9926
- "Operations.WorkflowRunsApi_updateControl.Response.410": {
9927
- "$ref": "#/$defs/Workflow.WorkflowRunDeletedError"
9928
- },
9929
- "Operations.WorkflowRunsApi_updateControl.Response.500": {
9930
- "$ref": "#/$defs/Common.Errors.InternalServerError"
9931
- },
9932
- "Operations.WorkflowRunsApi_updateControl.Response.503": {
9933
- "$ref": "#/$defs/Common.Errors.ServiceUnavailableError"
9934
- },
9935
7518
  "Operations.health_alive.Response.200": {
9936
7519
  "$ref": "#/$defs/Health.HealthReport"
9937
7520
  },