@lunnoa/client 1.0.0 → 1.2.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.
package/dist/index.d.cts CHANGED
@@ -776,67 +776,7 @@ interface paths {
776
776
  patch?: never;
777
777
  trace?: never;
778
778
  };
779
- "/api/agents": {
780
- parameters: {
781
- query?: never;
782
- header?: never;
783
- path?: never;
784
- cookie?: never;
785
- };
786
- /**
787
- * List agents in current workspace
788
- * @description Lists every agent in the caller's active workspace, most recently updated first. By default each item carries only `id`, `name`, and `FK_aiConnectionId`; request additional fields with the `expansion` query parameter.
789
- */
790
- get: operations["AgentsController_findAllForWorkspace"];
791
- put?: never;
792
- post?: never;
793
- delete?: never;
794
- options?: never;
795
- head?: never;
796
- patch?: never;
797
- trace?: never;
798
- };
799
- "/api/agents/{agentId}": {
800
- parameters: {
801
- query?: never;
802
- header?: never;
803
- path?: never;
804
- cookie?: never;
805
- };
806
- /**
807
- * Get agent by ID
808
- * @description Returns a single agent. By default only `id`, `name`, and `FK_aiConnectionId` are returned; request additional fields with the `expansion` query parameter. Access is gated by the `agents:use` permission, so agents reachable via a share grant can also be fetched.
809
- */
810
- get: operations["AgentsController_findOne"];
811
- put?: never;
812
- post?: never;
813
- delete?: never;
814
- options?: never;
815
- head?: never;
816
- patch?: never;
817
- trace?: never;
818
- };
819
- "/api/projects/{projectId}/agents/upsert": {
820
- parameters: {
821
- query?: never;
822
- header?: never;
823
- path?: never;
824
- cookie?: never;
825
- };
826
- get?: never;
827
- put?: never;
828
- /**
829
- * Upsert an agent by slug
830
- * @description Creates or updates an agent identified by project-scoped `slug`. Accepts instructions, model, optional aiConnectionId / connectionIds / workflowIds, and catalogue action tools. Marks `managedByCode` by default. Prefer the CLI (`npx @lunnoa/client agents deploy`) over calling this from application code.
831
- */
832
- post: operations["ProjectAgentsController_upsertBySlug"];
833
- delete?: never;
834
- options?: never;
835
- head?: never;
836
- patch?: never;
837
- trace?: never;
838
- };
839
- "/api/workflow-apps": {
779
+ "/api/object-types": {
840
780
  parameters: {
841
781
  query?: never;
842
782
  header?: never;
@@ -844,10 +784,10 @@ interface paths {
844
784
  cookie?: never;
845
785
  };
846
786
  /**
847
- * List all workflow apps
848
- * @description Returns the full catalogue of app definitions, including their actions and triggers. Custom UIs use this catalogue to resolve executionPath step appId/actionId pairs to names and icons. Each action and trigger exposes declarative UI metadata (inputConfig) describing its configuration fields.
787
+ * Get all entity types for workspace
788
+ * @description Returns entity types in the workspace, sorted by name. Disabled types are excluded unless includeDisabled is true.
849
789
  */
850
- get: operations["WorkflowAppsController_findAll"];
790
+ get: operations["ObjectTypesController_findAll"];
851
791
  put?: never;
852
792
  post?: never;
853
793
  delete?: never;
@@ -856,7 +796,7 @@ interface paths {
856
796
  patch?: never;
857
797
  trace?: never;
858
798
  };
859
- "/api/workflow-apps/{appId}/connections/{connectionId}/connect": {
799
+ "/api/object-types/upsert": {
860
800
  parameters: {
861
801
  query?: never;
862
802
  header?: never;
@@ -866,30 +806,10 @@ interface paths {
866
806
  get?: never;
867
807
  put?: never;
868
808
  /**
869
- * Connect workflow app
870
- * @description Creates a connection for an app using non-interactive credentials such as an API key or basic auth username and password. OAuth2 connection types require the interactive browser flow and cannot be created through this endpoint with machine credentials.
871
- */
872
- post: operations["WorkflowAppsController_connectApp"];
873
- delete?: never;
874
- options?: never;
875
- head?: never;
876
- patch?: never;
877
- trace?: never;
878
- };
879
- "/api/object-types": {
880
- parameters: {
881
- query?: never;
882
- header?: never;
883
- path?: never;
884
- cookie?: never;
885
- };
886
- /**
887
- * Get all entity types for workspace
888
- * @description Returns entity types in the workspace, sorted by name. Disabled types are excluded unless includeDisabled is true.
809
+ * Upsert entity type by workspace-scoped slug
810
+ * @description Creates or updates an entity type identified by workspace-scoped `slug`. Marks `managedByCode` by default. Prefer the CLI (`npx @lunnoa/client entity-types deploy`) over calling this from application code. Unknown instance attributes are rejected unless `allowUnknownAttributes` is true; reserved key `extensions` is always allowed.
889
811
  */
890
- get: operations["ObjectTypesController_findAll"];
891
- put?: never;
892
- post?: never;
812
+ post: operations["ObjectTypesController_upsertBySlug"];
893
813
  delete?: never;
894
814
  options?: never;
895
815
  head?: never;
@@ -1096,7 +1016,7 @@ interface paths {
1096
1016
  patch?: never;
1097
1017
  trace?: never;
1098
1018
  };
1099
- "/api/knowledge": {
1019
+ "/api/workflow-apps": {
1100
1020
  parameters: {
1101
1021
  query?: never;
1102
1022
  header?: never;
@@ -1104,51 +1024,19 @@ interface paths {
1104
1024
  cookie?: never;
1105
1025
  };
1106
1026
  /**
1107
- * List knowledge bases in workspace
1108
- * @description Returns all knowledge bases in the current workspace, ordered by most recently updated.
1027
+ * List all workflow apps
1028
+ * @description Returns the full catalogue of app definitions, including their actions and triggers. Custom UIs use this catalogue to resolve executionPath step appId/actionId pairs to names and icons. Each action and trigger exposes declarative UI metadata (inputConfig) describing its configuration fields.
1109
1029
  */
1110
- get: operations["KnowledgeController_findAllForWorkspace"];
1030
+ get: operations["WorkflowAppsController_findAll"];
1111
1031
  put?: never;
1112
- /**
1113
- * Create knowledge base
1114
- * @description Creates a workspace-wide knowledge base with a dedicated vector index. Embedding model, provider and dimensions default to the platform configuration when omitted.
1115
- */
1116
- post: operations["KnowledgeController_create"];
1032
+ post?: never;
1117
1033
  delete?: never;
1118
1034
  options?: never;
1119
1035
  head?: never;
1120
1036
  patch?: never;
1121
1037
  trace?: never;
1122
1038
  };
1123
- "/api/knowledge/{knowledgeId}": {
1124
- parameters: {
1125
- query?: never;
1126
- header?: never;
1127
- path?: never;
1128
- cookie?: never;
1129
- };
1130
- /**
1131
- * Get knowledge base by ID
1132
- * @description Returns a single knowledge base.
1133
- */
1134
- get: operations["KnowledgeController_findOne"];
1135
- put?: never;
1136
- post?: never;
1137
- /**
1138
- * Delete knowledge base
1139
- * @description Deletes a knowledge base, its stored files and its vector index. This action cannot be undone.
1140
- */
1141
- delete: operations["KnowledgeController_delete"];
1142
- options?: never;
1143
- head?: never;
1144
- /**
1145
- * Update knowledge base
1146
- * @description Updates knowledge base properties. All body fields are optional; only provided fields are changed.
1147
- */
1148
- patch: operations["KnowledgeController_update"];
1149
- trace?: never;
1150
- };
1151
- "/api/knowledge/{knowledgeId}/saveUploadedText": {
1039
+ "/api/workflow-apps/{appId}/connections/{connectionId}/connect": {
1152
1040
  parameters: {
1153
1041
  query?: never;
1154
1042
  header?: never;
@@ -1158,17 +1046,17 @@ interface paths {
1158
1046
  get?: never;
1159
1047
  put?: never;
1160
1048
  /**
1161
- * Save uploaded text to knowledge base
1162
- * @description Chunks the provided text, generates embeddings and stores them in the knowledge base. Multi-chunk uploads are grouped into a single document.
1049
+ * Connect workflow app
1050
+ * @description Creates a connection for an app using non-interactive credentials such as an API key or basic auth username and password. OAuth2 connection types require the interactive browser flow and cannot be created through this endpoint with machine credentials.
1163
1051
  */
1164
- post: operations["KnowledgeController_saveUploadedTextToKnowledge"];
1052
+ post: operations["WorkflowAppsController_connectApp"];
1165
1053
  delete?: never;
1166
1054
  options?: never;
1167
1055
  head?: never;
1168
1056
  patch?: never;
1169
1057
  trace?: never;
1170
1058
  };
1171
- "/api/knowledge/{knowledgeId}/documents": {
1059
+ "/api/agents": {
1172
1060
  parameters: {
1173
1061
  query?: never;
1174
1062
  header?: never;
@@ -1176,10 +1064,10 @@ interface paths {
1176
1064
  cookie?: never;
1177
1065
  };
1178
1066
  /**
1179
- * List documents for knowledge base
1180
- * @description Returns a grouped document view of the knowledge base. Multi-part uploads appear as a single group document; single-part uploads appear as standalone documents.
1067
+ * List agents in current workspace
1068
+ * @description Lists every agent in the caller's active workspace, most recently updated first. By default each item carries only `id`, `name`, and `FK_aiConnectionId`; request additional fields with the `expansion` query parameter.
1181
1069
  */
1182
- get: operations["KnowledgeController_getDocuments"];
1070
+ get: operations["AgentsController_findAllForWorkspace"];
1183
1071
  put?: never;
1184
1072
  post?: never;
1185
1073
  delete?: never;
@@ -1188,7 +1076,7 @@ interface paths {
1188
1076
  patch?: never;
1189
1077
  trace?: never;
1190
1078
  };
1191
- "/api/knowledge/{knowledgeId}/documents/{groupId}": {
1079
+ "/api/agents/{agentId}": {
1192
1080
  parameters: {
1193
1081
  query?: never;
1194
1082
  header?: never;
@@ -1196,23 +1084,19 @@ interface paths {
1196
1084
  cookie?: never;
1197
1085
  };
1198
1086
  /**
1199
- * Get knowledge document group
1200
- * @description Returns a document group with all of its parts (vector references), ordered by part number.
1087
+ * Get agent by ID
1088
+ * @description Returns a single agent. By default only `id`, `name`, and `FK_aiConnectionId` are returned; request additional fields with the `expansion` query parameter. Access is gated by the `agents:use` permission, so agents reachable via a share grant can also be fetched.
1201
1089
  */
1202
- get: operations["KnowledgeController_getDocumentGroup"];
1090
+ get: operations["AgentsController_findOne"];
1203
1091
  put?: never;
1204
1092
  post?: never;
1205
- /**
1206
- * Delete knowledge document group
1207
- * @description Deletes a document group and all of its parts, including stored files and vector index entries. This action cannot be undone.
1208
- */
1209
- delete: operations["KnowledgeController_deleteDocumentGroup"];
1093
+ delete?: never;
1210
1094
  options?: never;
1211
1095
  head?: never;
1212
1096
  patch?: never;
1213
1097
  trace?: never;
1214
1098
  };
1215
- "/api/executions/workflows/{workflowId}/execute": {
1099
+ "/api/projects/{projectId}/agents/upsert": {
1216
1100
  parameters: {
1217
1101
  query?: never;
1218
1102
  header?: never;
@@ -1222,17 +1106,17 @@ interface paths {
1222
1106
  get?: never;
1223
1107
  put?: never;
1224
1108
  /**
1225
- * Manually execute workflow by ID
1226
- * @description Starts a new execution of the workflow immediately. The workflow must be active and use a manual or scheduled trigger strategy. The optional inputData object supplies values for the custom input fields configured on the workflow "Manually Run" trigger.
1109
+ * Upsert an agent by slug
1110
+ * @description Creates or updates an agent identified by project-scoped `slug`. Accepts instructions, model, optional aiConnectionId / connectionIds / workflowIds, and catalogue action tools. Marks `managedByCode` by default. Prefer the CLI (`npx @lunnoa/client agents deploy`) over calling this from application code.
1227
1111
  */
1228
- post: operations["ExecutionsController_manuallyExecuteWorkflow"];
1112
+ post: operations["ProjectAgentsController_upsertBySlug"];
1229
1113
  delete?: never;
1230
1114
  options?: never;
1231
1115
  head?: never;
1232
1116
  patch?: never;
1233
1117
  trace?: never;
1234
1118
  };
1235
- "/api/executions": {
1119
+ "/api/knowledge": {
1236
1120
  parameters: {
1237
1121
  query?: never;
1238
1122
  header?: never;
@@ -1240,19 +1124,23 @@ interface paths {
1240
1124
  cookie?: never;
1241
1125
  };
1242
1126
  /**
1243
- * List executions in current workspace
1244
- * @description Returns the executions in the current workspace, most recently started first. By default only the execution ID is returned per item; use the expansion query parameter to include further fields.
1127
+ * List knowledge bases in workspace
1128
+ * @description Returns all knowledge bases in the current workspace, ordered by most recently updated.
1245
1129
  */
1246
- get: operations["ExecutionsController_findAll"];
1130
+ get: operations["KnowledgeController_findAllForWorkspace"];
1247
1131
  put?: never;
1248
- post?: never;
1132
+ /**
1133
+ * Create knowledge base
1134
+ * @description Creates a workspace-wide knowledge base with a dedicated vector index. Embedding model, provider and dimensions default to the platform configuration when omitted.
1135
+ */
1136
+ post: operations["KnowledgeController_create"];
1249
1137
  delete?: never;
1250
1138
  options?: never;
1251
1139
  head?: never;
1252
1140
  patch?: never;
1253
1141
  trace?: never;
1254
1142
  };
1255
- "/api/executions/{executionId}": {
1143
+ "/api/knowledge/{knowledgeId}": {
1256
1144
  parameters: {
1257
1145
  query?: never;
1258
1146
  header?: never;
@@ -1260,73 +1148,85 @@ interface paths {
1260
1148
  cookie?: never;
1261
1149
  };
1262
1150
  /**
1263
- * Get execution by ID
1264
- * @description Returns a single execution. The ID and startedAt timestamp are always returned; use the expansion query parameter to include further fields. Request the executionPath expansion to receive the business-readable step list (step labels, per-step status including NEEDS_INPUT, timings, and loop iterations) that custom UIs render progress from. Request the pendingInput expansion to receive the field schemas for steps currently waiting for user input.
1151
+ * Get knowledge base by ID
1152
+ * @description Returns a single knowledge base.
1265
1153
  */
1266
- get: operations["ExecutionsController_findOne"];
1154
+ get: operations["KnowledgeController_findOne"];
1267
1155
  put?: never;
1268
1156
  post?: never;
1269
- delete?: never;
1157
+ /**
1158
+ * Delete knowledge base
1159
+ * @description Deletes a knowledge base, its stored files and its vector index. This action cannot be undone.
1160
+ */
1161
+ delete: operations["KnowledgeController_delete"];
1270
1162
  options?: never;
1271
1163
  head?: never;
1272
- patch?: never;
1164
+ /**
1165
+ * Update knowledge base
1166
+ * @description Updates knowledge base properties. All body fields are optional; only provided fields are changed.
1167
+ */
1168
+ patch: operations["KnowledgeController_update"];
1273
1169
  trace?: never;
1274
1170
  };
1275
- "/api/executions/{executionId}/stream": {
1171
+ "/api/knowledge/{knowledgeId}/saveUploadedText": {
1276
1172
  parameters: {
1277
1173
  query?: never;
1278
1174
  header?: never;
1279
1175
  path?: never;
1280
1176
  cookie?: never;
1281
1177
  };
1178
+ get?: never;
1179
+ put?: never;
1282
1180
  /**
1283
- * Stream execution updates (SSE)
1284
- * @description Server-Sent Events stream for real-time execution updates. Emits `execution.progress` snapshots (status + executionPath + pendingInput) as steps change, `loop.progress` while For Each / Repeat loops run, `execution.finished` on terminal status, and periodic heartbeats. Use fetch with Authorization header (EventSource cannot send Bearer tokens). Ideal for custom timeline / progress UIs.
1181
+ * Save uploaded text to knowledge base
1182
+ * @description Chunks the provided text, generates embeddings and stores them in the knowledge base. Multi-chunk uploads are grouped into a single document.
1285
1183
  */
1286
- get: operations["ExecutionsController_streamExecution"];
1287
- put?: never;
1288
- post?: never;
1184
+ post: operations["KnowledgeController_saveUploadedTextToKnowledge"];
1289
1185
  delete?: never;
1290
1186
  options?: never;
1291
1187
  head?: never;
1292
1188
  patch?: never;
1293
1189
  trace?: never;
1294
1190
  };
1295
- "/api/actions/run": {
1191
+ "/api/knowledge/{knowledgeId}/documents": {
1296
1192
  parameters: {
1297
1193
  query?: never;
1298
1194
  header?: never;
1299
1195
  path?: never;
1300
1196
  cookie?: never;
1301
1197
  };
1302
- get?: never;
1303
- put?: never;
1304
1198
  /**
1305
- * Run a single app action as an ad-hoc Execution
1306
- * @description Creates a one-step Execution with `source: SDK`, runs the catalogue action via the same prepareAndRunAction path used by workflows, then finalises the Execution. Discover `appId` / `actionId` / `inputConfig` via GET /workflow-apps. Pass `connectionId` (Connection instance UUID) when the action needs a connection and more than one exists for the app. Poll GET /executions/{id} with expansion=executionPath for the same record.
1199
+ * List documents for knowledge base
1200
+ * @description Returns a grouped document view of the knowledge base. Multi-part uploads appear as a single group document; single-part uploads appear as standalone documents.
1307
1201
  */
1308
- post: operations["ActionsController_run"];
1202
+ get: operations["KnowledgeController_getDocuments"];
1203
+ put?: never;
1204
+ post?: never;
1309
1205
  delete?: never;
1310
1206
  options?: never;
1311
1207
  head?: never;
1312
1208
  patch?: never;
1313
1209
  trace?: never;
1314
1210
  };
1315
- "/api/runs": {
1211
+ "/api/knowledge/{knowledgeId}/documents/{groupId}": {
1316
1212
  parameters: {
1317
1213
  query?: never;
1318
1214
  header?: never;
1319
1215
  path?: never;
1320
1216
  cookie?: never;
1321
1217
  };
1322
- get?: never;
1218
+ /**
1219
+ * Get knowledge document group
1220
+ * @description Returns a document group with all of its parts (vector references), ordered by part number.
1221
+ */
1222
+ get: operations["KnowledgeController_getDocumentGroup"];
1323
1223
  put?: never;
1224
+ post?: never;
1324
1225
  /**
1325
- * Start a multi-step ad-hoc Execution
1326
- * @description Creates one Execution with `source: SDK` and a linear multi-step `executionPath`. Each step is a catalogue action run via prepareAndRunAction (same path as workflows and POST /actions/run). Connection resolution per step: sole usable connection, else workspace default (`isDefault`), else 400 with candidates. Poll GET /executions/{id} with expansion=executionPath for the same record.
1226
+ * Delete knowledge document group
1227
+ * @description Deletes a document group and all of its parts, including stored files and vector index entries. This action cannot be undone.
1327
1228
  */
1328
- post: operations["RunsController_start"];
1329
- delete?: never;
1229
+ delete: operations["KnowledgeController_deleteDocumentGroup"];
1330
1230
  options?: never;
1331
1231
  head?: never;
1332
1232
  patch?: never;
@@ -1424,19 +1324,139 @@ interface paths {
1424
1324
  patch?: never;
1425
1325
  trace?: never;
1426
1326
  };
1427
- "/api/webhooks/workflows/{workflowId}": {
1327
+ "/api/executions/workflows/{workflowId}/execute": {
1428
1328
  parameters: {
1429
1329
  query?: never;
1430
1330
  header?: never;
1431
1331
  path?: never;
1432
1332
  cookie?: never;
1433
1333
  };
1334
+ get?: never;
1335
+ put?: never;
1434
1336
  /**
1435
- * Trigger workflow via custom webhook (GET)
1436
- * @description Unauthenticated workflow trigger. The workflow must have a webhook trigger configured. Query parameters and headers are forwarded to the trigger as the payload. When the workflow responds synchronously, the response body contains the output of the webhook trigger; otherwise the body is empty.
1337
+ * Manually execute workflow by ID
1338
+ * @description Starts a new execution of the workflow immediately. The workflow must be active and use a manual or scheduled trigger strategy. The optional inputData object supplies values for the custom input fields configured on the workflow "Manually Run" trigger.
1437
1339
  */
1438
- get: operations["WebhookController_workflowEventGet"];
1439
- /**
1340
+ post: operations["ExecutionsController_manuallyExecuteWorkflow"];
1341
+ delete?: never;
1342
+ options?: never;
1343
+ head?: never;
1344
+ patch?: never;
1345
+ trace?: never;
1346
+ };
1347
+ "/api/executions": {
1348
+ parameters: {
1349
+ query?: never;
1350
+ header?: never;
1351
+ path?: never;
1352
+ cookie?: never;
1353
+ };
1354
+ /**
1355
+ * List executions in current workspace
1356
+ * @description Returns the executions in the current workspace, most recently started first. By default only the execution ID is returned per item; use the expansion query parameter to include further fields.
1357
+ */
1358
+ get: operations["ExecutionsController_findAll"];
1359
+ put?: never;
1360
+ post?: never;
1361
+ delete?: never;
1362
+ options?: never;
1363
+ head?: never;
1364
+ patch?: never;
1365
+ trace?: never;
1366
+ };
1367
+ "/api/executions/{executionId}": {
1368
+ parameters: {
1369
+ query?: never;
1370
+ header?: never;
1371
+ path?: never;
1372
+ cookie?: never;
1373
+ };
1374
+ /**
1375
+ * Get execution by ID
1376
+ * @description Returns a single execution. The ID and startedAt timestamp are always returned; use the expansion query parameter to include further fields. Request the executionPath expansion to receive the business-readable step list (step labels, per-step status including NEEDS_INPUT, timings, and loop iterations) that custom UIs render progress from. Request the pendingInput expansion to receive the field schemas for steps currently waiting for user input.
1377
+ */
1378
+ get: operations["ExecutionsController_findOne"];
1379
+ put?: never;
1380
+ post?: never;
1381
+ delete?: never;
1382
+ options?: never;
1383
+ head?: never;
1384
+ patch?: never;
1385
+ trace?: never;
1386
+ };
1387
+ "/api/executions/{executionId}/stream": {
1388
+ parameters: {
1389
+ query?: never;
1390
+ header?: never;
1391
+ path?: never;
1392
+ cookie?: never;
1393
+ };
1394
+ /**
1395
+ * Stream execution updates (SSE)
1396
+ * @description Server-Sent Events stream for real-time execution updates. Emits `execution.progress` snapshots (status + executionPath + pendingInput) as steps change, `loop.progress` while For Each / Repeat loops run, `execution.finished` on terminal status, and periodic heartbeats. Use fetch with Authorization header (EventSource cannot send Bearer tokens). Ideal for custom timeline / progress UIs.
1397
+ */
1398
+ get: operations["ExecutionsController_streamExecution"];
1399
+ put?: never;
1400
+ post?: never;
1401
+ delete?: never;
1402
+ options?: never;
1403
+ head?: never;
1404
+ patch?: never;
1405
+ trace?: never;
1406
+ };
1407
+ "/api/actions/run": {
1408
+ parameters: {
1409
+ query?: never;
1410
+ header?: never;
1411
+ path?: never;
1412
+ cookie?: never;
1413
+ };
1414
+ get?: never;
1415
+ put?: never;
1416
+ /**
1417
+ * Run a single app action as an ad-hoc Execution
1418
+ * @description Creates a one-step Execution with `source: SDK`, runs the catalogue action via the same prepareAndRunAction path used by workflows, then finalises the Execution. Discover `appId` / `actionId` / `inputConfig` via GET /workflow-apps. Pass `connectionId` (Connection instance UUID) when the action needs a connection and more than one exists for the app. Poll GET /executions/{id} with expansion=executionPath for the same record.
1419
+ */
1420
+ post: operations["ActionsController_run"];
1421
+ delete?: never;
1422
+ options?: never;
1423
+ head?: never;
1424
+ patch?: never;
1425
+ trace?: never;
1426
+ };
1427
+ "/api/runs": {
1428
+ parameters: {
1429
+ query?: never;
1430
+ header?: never;
1431
+ path?: never;
1432
+ cookie?: never;
1433
+ };
1434
+ get?: never;
1435
+ put?: never;
1436
+ /**
1437
+ * Start a multi-step ad-hoc Execution
1438
+ * @description Creates one Execution with `source: SDK` and a linear multi-step `executionPath`. Each step is a catalogue action run via prepareAndRunAction (same path as workflows and POST /actions/run). Connection resolution per step: sole usable connection, else workspace default (`isDefault`), else 400 with candidates. Poll GET /executions/{id} with expansion=executionPath for the same record.
1439
+ */
1440
+ post: operations["RunsController_start"];
1441
+ delete?: never;
1442
+ options?: never;
1443
+ head?: never;
1444
+ patch?: never;
1445
+ trace?: never;
1446
+ };
1447
+ "/api/webhooks/workflows/{workflowId}": {
1448
+ parameters: {
1449
+ query?: never;
1450
+ header?: never;
1451
+ path?: never;
1452
+ cookie?: never;
1453
+ };
1454
+ /**
1455
+ * Trigger workflow via custom webhook (GET)
1456
+ * @description Unauthenticated workflow trigger. The workflow must have a webhook trigger configured. Query parameters and headers are forwarded to the trigger as the payload. When the workflow responds synchronously, the response body contains the output of the webhook trigger; otherwise the body is empty.
1457
+ */
1458
+ get: operations["WebhookController_workflowEventGet"];
1459
+ /**
1440
1460
  * Trigger workflow via custom webhook (PUT)
1441
1461
  * @description Unauthenticated workflow trigger. The workflow must have a webhook trigger configured. The JSON request body and headers are forwarded to the trigger. When the workflow responds synchronously, the response body contains the output of the webhook trigger; otherwise the body is empty.
1442
1462
  */
@@ -1640,6 +1660,8 @@ interface components {
1640
1660
  SKILLS: boolean;
1641
1661
  /** @description Whether the hexagonal agent builder canvas UI is enabled. */
1642
1662
  AGENT_BUILDER_CANVAS: boolean;
1663
+ /** @description Whether the Solution Designer UI is enabled. */
1664
+ SOLUTION_DESIGNER: boolean;
1643
1665
  /** @description Whether isolated code execution for agents is enabled. */
1644
1666
  CODE_EXECUTION: boolean;
1645
1667
  /** @description Whether SSO (OIDC) login is enabled. Requires at least one enabled SSO provider. */
@@ -2380,317 +2402,152 @@ interface components {
2380
2402
  /** @description Marks the row as managed by code (CLI / SDK). Defaults to true on this endpoint. */
2381
2403
  managedByCode?: boolean;
2382
2404
  };
2383
- AgentResponseDto: {
2405
+ UpsertObjectTypeBySlugDto: {
2406
+ /** @description Stable workspace-scoped slug (lowercase, digits, hyphens). Used as the upsert key. */
2407
+ slug: string;
2408
+ /** @description Singular display name. */
2409
+ name?: string;
2410
+ /** @description Plural display name. */
2411
+ namePlural?: string;
2412
+ /** @description Description. */
2413
+ description?: string;
2384
2414
  /**
2385
- * @description Agent ID (UUID)
2386
- * @example 4f7c9d2e-8a1b-4c3d-9e5f-6a7b8c9d0e1f
2415
+ * @description Icon identifier.
2416
+ * @default box
2387
2417
  */
2388
- id: string;
2418
+ icon: string;
2389
2419
  /**
2390
- * @description Agent name
2391
- * @example Invoice Triage Agent
2420
+ * @description Hex colour.
2421
+ * @default #3B82F6
2422
+ */
2423
+ color: string;
2424
+ /** @description Field definitions grouped into sections. */
2425
+ attributeSchema: {
2426
+ [key: string]: unknown;
2427
+ };
2428
+ /** @description Optional state machine definition. */
2429
+ stateSchema?: {
2430
+ [key: string]: unknown;
2431
+ } | null;
2432
+ /** @description Whether the type is enabled. */
2433
+ isEnabled?: boolean;
2434
+ /**
2435
+ * @description When false (default), reject unknown attribute keys on entity writes.
2436
+ * @default false
2437
+ */
2438
+ allowUnknownAttributes: boolean;
2439
+ /**
2440
+ * @description Marks the type as code-managed. Defaults to true on upsert.
2441
+ * @default true
2392
2442
  */
2443
+ managedByCode: boolean;
2444
+ };
2445
+ ObjectTypeUserSummaryDto: {
2446
+ /** @description User ID. */
2447
+ id: string;
2448
+ /** @description Email address of the user. */
2449
+ email: string;
2450
+ /** @description Display name of the user. */
2393
2451
  name: string;
2394
- /** @description Stable project-scoped slug for CLI / code deploy upserts. Included when `expansion=slug` is requested. */
2395
- slug?: string | null;
2396
- /** @description True when last written by code (CLI / SDK). Included when `expansion=managedByCode` is requested. */
2397
- managedByCode?: boolean;
2398
- /** @description ID of the AI provider connection assigned to the agent. Always included. Null when the agent falls back to the workspace default connection. */
2399
- FK_aiConnectionId: string | null;
2400
- /** @description Agent description. Included when `expansion=description` is requested. */
2452
+ };
2453
+ ObjectTypeCreatedByDto: {
2454
+ /** @description Workspace user ID. */
2455
+ id: string;
2456
+ user: components["schemas"]["ObjectTypeUserSummaryDto"];
2457
+ };
2458
+ ObjectTypeCountDto: {
2459
+ /** @description Number of non-deleted entities of this type. */
2460
+ objects: number;
2461
+ };
2462
+ ObjectTypeResponseDto: {
2463
+ /** @description Entity type ID. */
2464
+ id: string;
2465
+ /** @description Singular display name of the entity type. */
2466
+ name: string;
2467
+ /** @description Plural display name of the entity type. */
2468
+ namePlural: string;
2469
+ /** @description URL-safe slug, unique within the workspace. */
2470
+ slug: string;
2471
+ /** @description Icon identifier for the entity type. */
2472
+ icon: string;
2473
+ /** @description Hex colour of the entity type. */
2474
+ color: string;
2475
+ /** @description Whether the entity type is enabled. */
2476
+ isEnabled: boolean;
2477
+ /** @description When false, entity create/update rejects attribute keys not declared on the type. Reserved key `extensions` is always allowed. */
2478
+ allowUnknownAttributes: boolean;
2479
+ /** @description True when last written by code (CLI / SDK upsert). */
2480
+ managedByCode: boolean;
2481
+ /** @description Incremented when attributeSchema, stateSchema, or allowUnknownAttributes changes. */
2482
+ schemaRevision: number;
2483
+ /** @description Description of the entity type. Included when `expansion=description` is requested. */
2401
2484
  description?: string | null;
2402
- /** @description Public URL of the agent profile image. Included when `expansion=profileImageUrl` is requested. */
2403
- profileImageUrl?: string | null;
2485
+ /** @description Field definitions grouped into sections. Included when `expansion=attributeSchema` is requested. */
2486
+ attributeSchema?: {
2487
+ [key: string]: unknown;
2488
+ };
2489
+ /** @description State machine definition. Included when `expansion=stateSchema` is requested. */
2490
+ stateSchema?: {
2491
+ [key: string]: unknown;
2492
+ } | null;
2404
2493
  /**
2405
2494
  * Format: date-time
2406
- * @description Creation timestamp. Included when `expansion=createdAt` is requested.
2495
+ * @description Included when `expansion=createdAt` is requested.
2407
2496
  */
2408
2497
  createdAt?: string;
2409
2498
  /**
2410
2499
  * Format: date-time
2411
- * @description Last update timestamp. Included when `expansion=updatedAt` is requested.
2500
+ * @description Included when `expansion=updatedAt` is requested.
2412
2501
  */
2413
2502
  updatedAt?: string;
2414
- /** @description System instructions authored for the agent. Included when `expansion=instructions` is requested. */
2415
- instructions?: string | null;
2416
- /**
2417
- * @description Model temperature. Included when `expansion=temperature` is requested.
2418
- * @example 1
2419
- */
2420
- temperature?: number;
2421
- /** @description Maximum output tokens per turn. Included when `expansion=maxOutputTokens` is requested. */
2422
- maxOutputTokens?: number | null;
2423
- /**
2424
- * @description Top-p sampling. Included when `expansion=topP` is requested.
2425
- * @example 1
2426
- */
2427
- topP?: number;
2428
- /**
2429
- * @description Frequency penalty. Included when `expansion=frequencyPenalty` is requested.
2430
- * @example 0
2431
- */
2432
- frequencyPenalty?: number;
2433
- /**
2434
- * @description Presence penalty. Included when `expansion=presencePenalty` is requested.
2435
- * @example 0
2436
- */
2437
- presencePenalty?: number;
2438
- /**
2439
- * @description Maximum retries for a failed model call. Included when `expansion=maxRetries` is requested.
2440
- * @example 0
2441
- */
2442
- maxRetries?: number;
2443
- /** @description Fixed sampling seed. Included when `expansion=seed` is requested. */
2444
- seed?: number | null;
2503
+ /** @description Workspace member who created the entity type. Included when `expansion=createdBy` is requested. */
2504
+ createdBy?: components["schemas"]["ObjectTypeCreatedByDto"];
2505
+ /** @description Included when `expansion=countObjects` is requested. */
2506
+ _count?: components["schemas"]["ObjectTypeCountDto"];
2507
+ };
2508
+ CreateObjectDto: {
2509
+ /** @description Display name of the entity. */
2510
+ name: string;
2445
2511
  /**
2446
- * @description Maximum tool roundtrips per turn. Included when `expansion=maxToolRoundtrips` is requested.
2447
- * @example 5
2512
+ * Format: uuid
2513
+ * @description ID of the entity type to create the entity under.
2448
2514
  */
2449
- maxToolRoundtrips?: number;
2515
+ objectTypeId: string;
2516
+ /** @description Initial state ID. Must exist in the entity type state schema. Defaults to the schema initial state when omitted. */
2517
+ state?: string;
2518
+ /** @description Dynamic attribute values keyed by field ID. */
2519
+ attributes?: {
2520
+ [key: string]: unknown;
2521
+ };
2450
2522
  /**
2451
- * @description How many previous messages are sent to the model. Included when `expansion=messageLookbackLimit` is requested.
2452
- * @example 40
2523
+ * Format: uuid
2524
+ * @description Workspace user ID of the entity owner.
2453
2525
  */
2454
- messageLookbackLimit?: number;
2455
- /** @description Configured tool nodes (app actions) for the agent. Included when `expansion=tools` is requested. */
2456
- tools?: {
2457
- [key: string]: unknown;
2458
- }[] | null;
2459
- /** @description Action IDs of the configured tools. Included when `expansion=toolIds` is requested. */
2460
- toolIds?: string[];
2461
- /** @description Instructions used when auto-naming new tasks. Included when `expansion=taskNamingInstructions` is requested. */
2462
- taskNamingInstructions?: string | null;
2463
- /** @description IDs of enabled provider built-in tools. Included when `expansion=enabledBuiltInTools` is requested. */
2464
- enabledBuiltInTools?: string[];
2465
- /** @description IDs of enabled platform tools. Included when `expansion=enabledPlatformTools` is requested. */
2466
- enabledPlatformTools?: string[];
2467
- /** @description Whether dynamic workflow-app action discovery is enabled. Included when `expansion=dynamicActionDiscoveryEnabled` is requested. */
2468
- dynamicActionDiscoveryEnabled?: boolean;
2469
- /** @description Whether dynamic MCP server discovery is enabled. Included when `expansion=dynamicMcpDiscoveryEnabled` is requested. */
2470
- dynamicMcpDiscoveryEnabled?: boolean;
2471
- /** @description Whether the agent maintains its own instructions. Included when `expansion=dynamicSelfInstructionsEnabled` is requested. */
2472
- dynamicSelfInstructionsEnabled?: boolean;
2473
- /** @description Whether long-term memory is enabled. Included when `expansion=memoryEnabled` is requested. */
2474
- memoryEnabled?: boolean;
2475
- /**
2476
- * @description Memory partitioning scope. Included when `expansion=memoryScope` is requested.
2477
- * @enum {string}
2478
- */
2479
- memoryScope?: "PER_USER" | "PER_AGENT" | "PER_USER_PER_AGENT";
2480
- /**
2481
- * @description Days memories are retained. Included when `expansion=memoryRetentionDays` is requested.
2482
- * @example 90
2483
- */
2484
- memoryRetentionDays?: number;
2485
- /** @description Suggested prompts shown to users starting a conversation. Included when `expansion=suggestedPrompts` is requested. */
2486
- suggestedPrompts?: string[];
2487
- /**
2488
- * Format: date-time
2489
- * @description When the first-time builder setup wizard was completed. Included when `expansion=builderSetupCompletedAt` is requested.
2490
- */
2491
- builderSetupCompletedAt?: string | null;
2492
- /** @description Saved canvas node positions for the agent builder. Included when `expansion=builderCanvasPositions` is requested. */
2493
- builderCanvasPositions?: {
2494
- [key: string]: unknown;
2495
- } | null;
2496
- /** @description Selected model ID within the AI provider connection. Included when `expansion=selectedModelId` is requested. */
2497
- selectedModelId?: string | null;
2498
- /** @description Assigned AI provider connection. Included when `expansion=aiConnection` is requested. */
2499
- aiConnection?: {
2500
- id?: string;
2501
- name?: string;
2502
- providerConfig?: {
2503
- id?: string;
2504
- providerSlug?: string;
2505
- };
2506
- } | null;
2507
- /** @description Knowledge notebooks attached to the agent. Included when `expansion=knowledge` is requested. */
2508
- agentKnowledge?: {
2509
- id?: string;
2510
- knowledge?: {
2511
- id?: string;
2512
- name?: string;
2513
- };
2514
- }[];
2515
- /** @description Object types attached to the agent. Included when `expansion=objectTypes` is requested. */
2516
- agentObjectTypes?: {
2517
- id?: string;
2518
- scope?: string;
2519
- objectType?: {
2520
- id?: string;
2521
- name?: string;
2522
- slug?: string;
2523
- icon?: string | null;
2524
- color?: string | null;
2525
- };
2526
- }[];
2527
- /** @description Objects attached to the agent. Included when `expansion=objects` is requested. */
2528
- agentObjects?: {
2529
- id?: string;
2530
- scope?: string;
2531
- object?: {
2532
- id?: string;
2533
- name?: string;
2534
- state?: string;
2535
- objectType?: {
2536
- id?: string;
2537
- name?: string;
2538
- slug?: string;
2539
- icon?: string | null;
2540
- color?: string | null;
2541
- };
2542
- };
2543
- }[];
2544
- /** @description App connections available to the agent. Included when `expansion=connections` is requested. */
2545
- connections?: {
2546
- id?: string;
2547
- name?: string;
2548
- }[];
2549
- /** @description Variables attached to the agent. Included when `expansion=variables` is requested. */
2550
- agentVariables?: {
2551
- id?: string;
2552
- variable?: {
2553
- id?: string;
2554
- name?: string;
2555
- };
2556
- }[];
2557
- /** @description Workflows the agent can trigger. Included when `expansion=workflows` is requested. */
2558
- agentWorkflows?: {
2559
- id?: string;
2560
- workflow?: {
2561
- id?: string;
2562
- name?: string;
2563
- };
2564
- }[];
2565
- /** @description Sub-agent links for the agent. Included when `expansion=subAgents` is requested. */
2566
- agentSubAgents?: {
2567
- id?: string;
2568
- subagent?: {
2569
- id?: string;
2570
- name?: string;
2571
- };
2572
- parentAgent?: {
2573
- id?: string;
2574
- name?: string;
2575
- };
2576
- }[];
2577
- /** @description MCP servers attached to the agent, with per-tool overrides. Included when `expansion=mcpServers` is requested. */
2578
- agentMcpServers?: {
2579
- id?: string;
2580
- mcpServer?: {
2581
- id?: string;
2582
- slug?: string;
2583
- name?: string;
2584
- provider?: string;
2585
- logoUrl?: string | null;
2586
- description?: string | null;
2587
- };
2588
- toolOverrides?: {
2589
- id?: string;
2590
- toolName?: string;
2591
- enabled?: boolean;
2592
- requireApproval?: boolean;
2593
- }[];
2594
- }[];
2595
- /** @description A2A (agent-to-agent) endpoints attached to the agent. Included when `expansion=a2aAgents` is requested. */
2596
- agentA2aAgents?: {
2597
- id?: string;
2598
- a2aAgent?: {
2599
- id?: string;
2600
- slug?: string;
2601
- name?: string;
2602
- logoUrl?: string | null;
2603
- description?: string | null;
2604
- authType?: string;
2605
- };
2606
- }[];
2607
- /** @description Web access configuration. Included when `expansion=webAccess` is requested. */
2608
- agentWebAccess?: {
2609
- service?: string;
2610
- webSearchEnabled?: boolean;
2611
- websiteAccessEnabled?: boolean;
2612
- } | null;
2613
- /** @description Phone access configuration. Included when `expansion=phoneAccess` is requested. */
2614
- agentPhoneAccess?: {
2615
- service?: string;
2616
- outboundCallsEnabled?: boolean;
2617
- inboundCallsEnabled?: boolean;
2618
- } | null;
2619
- /** @description Project the agent belongs to. Included when `expansion=project` is requested. */
2620
- project?: {
2621
- id?: string;
2622
- name?: string;
2623
- };
2624
- };
2625
- UpsertAgentToolDto: {
2626
- /** @description Workflow app id (catalogue slug). */
2627
- appId: string;
2628
- /** @description Catalogue action id. */
2629
- actionId: string;
2630
- /** @description Connection instance UUID pre-bound on the tool. */
2631
- connectionId?: string;
2632
- /** @description Tool display name for the model. */
2633
- name?: string;
2634
- /** @description Tool description shown to the model. */
2635
- description?: string;
2636
- /** @description Pre-filled tool config (fields left empty are filled by the model). */
2637
- input?: {
2638
- [key: string]: unknown;
2639
- };
2640
- };
2641
- UpsertAgentBySlugDto: {
2642
- /**
2643
- * @description Stable project-scoped slug (lowercase, digits, hyphens). Used as the upsert key.
2644
- * @example support-triage
2645
- */
2646
- slug: string;
2647
- /** @description Display name. Defaults to the slug when omitted. */
2648
- name?: string;
2649
- description?: string;
2650
- /** @description System instructions / prompt for the agent. */
2651
- instructions: string;
2652
- /** @description Selected model id on the AI provider connection (e.g. `gpt-4o`). */
2653
- model: string;
2654
- /** @description AiProviderConnection UUID. When omitted, platform AI defaults apply. */
2655
- aiConnectionId?: string;
2656
- /** @description App Connection UUIDs the agent may use for tools. */
2657
- connectionIds?: string[];
2658
- /** @description Workflow UUIDs the agent may run (AgentWorkflow links). */
2659
- workflowIds?: string[];
2660
- /** @description Catalogue action tools (WorkflowNodeForRunner-shaped). */
2661
- tools?: components["schemas"]["UpsertAgentToolDto"][];
2662
- /** @description Marks the row as managed by code (CLI / SDK). Defaults to true on this endpoint. */
2663
- managedByCode?: boolean;
2526
+ ownerId?: string;
2664
2527
  };
2665
- WorkflowAppResponseDto: {
2666
- /** @description App ID, e.g. `gmail`. Matches the appId used in workflow execution steps. */
2528
+ ObjectTypeSummaryDto: {
2529
+ /** @description Entity type ID. */
2667
2530
  id: string;
2668
- /** @description Human-readable app name. */
2531
+ /** @description Singular display name of the entity type. */
2669
2532
  name: string;
2670
- /** @description App description. */
2671
- description: string;
2672
- /** @description URL of the app logo. */
2673
- logoUrl: string;
2674
- /** @description Whether the app is published and available for use. */
2675
- isPublished: boolean;
2676
- /** @description Whether the app requires a connection before its actions and triggers can run. */
2677
- needsConnection: boolean;
2678
- /** @description Whether the app can be used by agents. */
2679
- availableForAgent: boolean;
2680
- /** @description Action definitions, each with id, name, description, iconUrl, needsConnection, availableForAgent, viewOptions and the declarative inputConfig field metadata used to render action UIs. */
2681
- actions: {
2682
- [key: string]: unknown;
2683
- }[];
2684
- /** @description Trigger definitions, each with id, name, description, iconUrl, needsConnection and the declarative inputConfig field metadata used to render trigger UIs. */
2685
- triggers: {
2533
+ /** @description URL-safe slug of the entity type. */
2534
+ slug: string;
2535
+ /** @description Icon identifier for the entity type. */
2536
+ icon: string;
2537
+ /** @description Hex colour of the entity type. */
2538
+ color: string;
2539
+ /** @description Plural display name. Included when `expansion=objectType` is requested. */
2540
+ namePlural?: string;
2541
+ /** @description Field definitions grouped into sections. Included when `expansion=objectType` is requested on single-entity reads. */
2542
+ attributeSchema?: {
2686
2543
  [key: string]: unknown;
2687
- }[];
2688
- /** @description Connection type definitions supported by the app (e.g. oauth2, apiKey, basic), each with id, name, description, connectionType and any declarative inputConfig fields. */
2689
- connections: {
2544
+ };
2545
+ /** @description State machine definition. Included when `expansion=objectType` is requested. */
2546
+ stateSchema?: {
2690
2547
  [key: string]: unknown;
2691
- }[];
2548
+ } | null;
2692
2549
  };
2693
- ObjectTypeUserSummaryDto: {
2550
+ ObjectUserSummaryDto: {
2694
2551
  /** @description User ID. */
2695
2552
  id: string;
2696
2553
  /** @description Email address of the user. */
@@ -2698,109 +2555,10 @@ interface components {
2698
2555
  /** @description Display name of the user. */
2699
2556
  name: string;
2700
2557
  };
2701
- ObjectTypeCreatedByDto: {
2558
+ ObjectWorkspaceUserSummaryDto: {
2702
2559
  /** @description Workspace user ID. */
2703
2560
  id: string;
2704
- user: components["schemas"]["ObjectTypeUserSummaryDto"];
2705
- };
2706
- ObjectTypeCountDto: {
2707
- /** @description Number of non-deleted entities of this type. */
2708
- objects: number;
2709
- };
2710
- ObjectTypeResponseDto: {
2711
- /** @description Entity type ID. */
2712
- id: string;
2713
- /** @description Singular display name of the entity type. */
2714
- name: string;
2715
- /** @description Plural display name of the entity type. */
2716
- namePlural: string;
2717
- /** @description URL-safe slug, unique within the workspace. */
2718
- slug: string;
2719
- /** @description Icon identifier for the entity type. */
2720
- icon: string;
2721
- /** @description Hex colour of the entity type. */
2722
- color: string;
2723
- /** @description Whether the entity type is enabled. */
2724
- isEnabled: boolean;
2725
- /** @description Description of the entity type. Included when `expansion=description` is requested. */
2726
- description?: string | null;
2727
- /** @description Field definitions grouped into sections. Included when `expansion=attributeSchema` is requested. */
2728
- attributeSchema?: {
2729
- [key: string]: unknown;
2730
- };
2731
- /** @description State machine definition. Included when `expansion=stateSchema` is requested. */
2732
- stateSchema?: {
2733
- [key: string]: unknown;
2734
- } | null;
2735
- /**
2736
- * Format: date-time
2737
- * @description Included when `expansion=createdAt` is requested.
2738
- */
2739
- createdAt?: string;
2740
- /**
2741
- * Format: date-time
2742
- * @description Included when `expansion=updatedAt` is requested.
2743
- */
2744
- updatedAt?: string;
2745
- /** @description Workspace member who created the entity type. Included when `expansion=createdBy` is requested. */
2746
- createdBy?: components["schemas"]["ObjectTypeCreatedByDto"];
2747
- /** @description Included when `expansion=countObjects` is requested. */
2748
- _count?: components["schemas"]["ObjectTypeCountDto"];
2749
- };
2750
- CreateObjectDto: {
2751
- /** @description Display name of the entity. */
2752
- name: string;
2753
- /**
2754
- * Format: uuid
2755
- * @description ID of the entity type to create the entity under.
2756
- */
2757
- objectTypeId: string;
2758
- /** @description Initial state ID. Must exist in the entity type state schema. Defaults to the schema initial state when omitted. */
2759
- state?: string;
2760
- /** @description Dynamic attribute values keyed by field ID. */
2761
- attributes?: {
2762
- [key: string]: unknown;
2763
- };
2764
- /**
2765
- * Format: uuid
2766
- * @description Workspace user ID of the entity owner.
2767
- */
2768
- ownerId?: string;
2769
- };
2770
- ObjectTypeSummaryDto: {
2771
- /** @description Entity type ID. */
2772
- id: string;
2773
- /** @description Singular display name of the entity type. */
2774
- name: string;
2775
- /** @description URL-safe slug of the entity type. */
2776
- slug: string;
2777
- /** @description Icon identifier for the entity type. */
2778
- icon: string;
2779
- /** @description Hex colour of the entity type. */
2780
- color: string;
2781
- /** @description Plural display name. Included when `expansion=objectType` is requested. */
2782
- namePlural?: string;
2783
- /** @description Field definitions grouped into sections. Included when `expansion=objectType` is requested on single-entity reads. */
2784
- attributeSchema?: {
2785
- [key: string]: unknown;
2786
- };
2787
- /** @description State machine definition. Included when `expansion=objectType` is requested. */
2788
- stateSchema?: {
2789
- [key: string]: unknown;
2790
- } | null;
2791
- };
2792
- ObjectUserSummaryDto: {
2793
- /** @description User ID. */
2794
- id: string;
2795
- /** @description Email address of the user. */
2796
- email: string;
2797
- /** @description Display name of the user. */
2798
- name: string;
2799
- };
2800
- ObjectWorkspaceUserSummaryDto: {
2801
- /** @description Workspace user ID. */
2802
- id: string;
2803
- user: components["schemas"]["ObjectUserSummaryDto"];
2561
+ user: components["schemas"]["ObjectUserSummaryDto"];
2804
2562
  };
2805
2563
  ObjectStateHistoryUserSummaryDto: {
2806
2564
  /** @description User ID. */
@@ -2999,6 +2757,334 @@ interface components {
2999
2757
  [key: string]: string;
3000
2758
  };
3001
2759
  };
2760
+ WorkflowAppResponseDto: {
2761
+ /** @description App ID, e.g. `gmail`. Matches the appId used in workflow execution steps. */
2762
+ id: string;
2763
+ /** @description Human-readable app name. */
2764
+ name: string;
2765
+ /** @description App description. */
2766
+ description: string;
2767
+ /** @description URL of the app logo. */
2768
+ logoUrl: string;
2769
+ /** @description Whether the app is published and available for use. */
2770
+ isPublished: boolean;
2771
+ /** @description Whether the app requires a connection before its actions and triggers can run. */
2772
+ needsConnection: boolean;
2773
+ /** @description Whether the app can be used by agents. */
2774
+ availableForAgent: boolean;
2775
+ /** @description Action definitions, each with id, name, description, iconUrl, needsConnection, availableForAgent, viewOptions and the declarative inputConfig field metadata used to render action UIs. */
2776
+ actions: {
2777
+ [key: string]: unknown;
2778
+ }[];
2779
+ /** @description Trigger definitions, each with id, name, description, iconUrl, needsConnection and the declarative inputConfig field metadata used to render trigger UIs. */
2780
+ triggers: {
2781
+ [key: string]: unknown;
2782
+ }[];
2783
+ /** @description Connection type definitions supported by the app (e.g. oauth2, apiKey, basic), each with id, name, description, connectionType and any declarative inputConfig fields. */
2784
+ connections: {
2785
+ [key: string]: unknown;
2786
+ }[];
2787
+ };
2788
+ AgentResponseDto: {
2789
+ /**
2790
+ * @description Agent ID (UUID)
2791
+ * @example 4f7c9d2e-8a1b-4c3d-9e5f-6a7b8c9d0e1f
2792
+ */
2793
+ id: string;
2794
+ /**
2795
+ * @description Agent name
2796
+ * @example Invoice Triage Agent
2797
+ */
2798
+ name: string;
2799
+ /** @description Stable project-scoped slug for CLI / code deploy upserts. Included when `expansion=slug` is requested. */
2800
+ slug?: string | null;
2801
+ /** @description True when last written by code (CLI / SDK). Included when `expansion=managedByCode` is requested. */
2802
+ managedByCode?: boolean;
2803
+ /** @description ID of the AI provider connection assigned to the agent. Always included. Null when the agent falls back to the workspace default connection. */
2804
+ FK_aiConnectionId: string | null;
2805
+ /** @description Agent description. Included when `expansion=description` is requested. */
2806
+ description?: string | null;
2807
+ /** @description Public URL of the agent profile image. Included when `expansion=profileImageUrl` is requested. */
2808
+ profileImageUrl?: string | null;
2809
+ /**
2810
+ * Format: date-time
2811
+ * @description Creation timestamp. Included when `expansion=createdAt` is requested.
2812
+ */
2813
+ createdAt?: string;
2814
+ /**
2815
+ * Format: date-time
2816
+ * @description Last update timestamp. Included when `expansion=updatedAt` is requested.
2817
+ */
2818
+ updatedAt?: string;
2819
+ /** @description System instructions authored for the agent. Included when `expansion=instructions` is requested. */
2820
+ instructions?: string | null;
2821
+ /**
2822
+ * @description Model temperature. Included when `expansion=temperature` is requested.
2823
+ * @example 1
2824
+ */
2825
+ temperature?: number;
2826
+ /** @description Maximum output tokens per turn. Included when `expansion=maxOutputTokens` is requested. */
2827
+ maxOutputTokens?: number | null;
2828
+ /**
2829
+ * @description Top-p sampling. Included when `expansion=topP` is requested.
2830
+ * @example 1
2831
+ */
2832
+ topP?: number;
2833
+ /**
2834
+ * @description Frequency penalty. Included when `expansion=frequencyPenalty` is requested.
2835
+ * @example 0
2836
+ */
2837
+ frequencyPenalty?: number;
2838
+ /**
2839
+ * @description Presence penalty. Included when `expansion=presencePenalty` is requested.
2840
+ * @example 0
2841
+ */
2842
+ presencePenalty?: number;
2843
+ /**
2844
+ * @description Maximum retries for a failed model call. Included when `expansion=maxRetries` is requested.
2845
+ * @example 0
2846
+ */
2847
+ maxRetries?: number;
2848
+ /** @description Fixed sampling seed. Included when `expansion=seed` is requested. */
2849
+ seed?: number | null;
2850
+ /**
2851
+ * @description Maximum tool roundtrips per turn. Included when `expansion=maxToolRoundtrips` is requested.
2852
+ * @example 5
2853
+ */
2854
+ maxToolRoundtrips?: number;
2855
+ /**
2856
+ * @description How many previous messages are sent to the model. Included when `expansion=messageLookbackLimit` is requested.
2857
+ * @example 40
2858
+ */
2859
+ messageLookbackLimit?: number;
2860
+ /** @description Configured tool nodes (app actions) for the agent. Included when `expansion=tools` is requested. */
2861
+ tools?: {
2862
+ [key: string]: unknown;
2863
+ }[] | null;
2864
+ /** @description Action IDs of the configured tools. Included when `expansion=toolIds` is requested. */
2865
+ toolIds?: string[];
2866
+ /** @description Instructions used when auto-naming new tasks. Included when `expansion=taskNamingInstructions` is requested. */
2867
+ taskNamingInstructions?: string | null;
2868
+ /** @description IDs of enabled provider built-in tools. Included when `expansion=enabledBuiltInTools` is requested. */
2869
+ enabledBuiltInTools?: string[];
2870
+ /** @description IDs of enabled platform tools. Included when `expansion=enabledPlatformTools` is requested. */
2871
+ enabledPlatformTools?: string[];
2872
+ /** @description Whether dynamic workflow-app action discovery is enabled. Included when `expansion=dynamicActionDiscoveryEnabled` is requested. */
2873
+ dynamicActionDiscoveryEnabled?: boolean;
2874
+ /** @description Whether dynamic MCP server discovery is enabled. Included when `expansion=dynamicMcpDiscoveryEnabled` is requested. */
2875
+ dynamicMcpDiscoveryEnabled?: boolean;
2876
+ /** @description Whether the agent maintains its own instructions. Included when `expansion=dynamicSelfInstructionsEnabled` is requested. */
2877
+ dynamicSelfInstructionsEnabled?: boolean;
2878
+ /** @description Whether long-term memory is enabled. Included when `expansion=memoryEnabled` is requested. */
2879
+ memoryEnabled?: boolean;
2880
+ /** @description Whether runtime planning tools are enabled. Included when `expansion=enablePlanning` is requested. */
2881
+ enablePlanning?: boolean;
2882
+ /** @description Whether oversized tool-result offload is enabled. Included when `expansion=enableToolResultOffload` is requested. */
2883
+ enableToolResultOffload?: boolean;
2884
+ /** @description Byte threshold for tool-result offload. Included when `expansion=toolResultOffloadThresholdBytes` is requested. */
2885
+ toolResultOffloadThresholdBytes?: number;
2886
+ /** @description Whether long-horizon mode is enabled. Included when `expansion=longHorizonMode` is requested. */
2887
+ longHorizonMode?: boolean;
2888
+ /** @description prepareStep safety-net policy ids. Included when `expansion=enabledToolPolicies` is requested. */
2889
+ enabledToolPolicies?: string[];
2890
+ /** @description Per-tool force overrides. Included when `expansion=forcedTools` is requested. */
2891
+ forcedTools?: string[];
2892
+ /** @description When true with planning, gate heavy tools until plan approval. Included when `expansion=requirePlanApproval` is requested. */
2893
+ requirePlanApproval?: boolean;
2894
+ /** @description Optional elevated max steps for long-horizon mode. Included when `expansion=longHorizonMaxSteps` is requested. */
2895
+ longHorizonMaxSteps?: number | null;
2896
+ /** @description Optional max tokens per run hint for long-horizon mode. Included when `expansion=longHorizonMaxTokensPerRun` is requested. */
2897
+ longHorizonMaxTokensPerRun?: number | null;
2898
+ /**
2899
+ * @description Memory partitioning scope. Included when `expansion=memoryScope` is requested.
2900
+ * @enum {string}
2901
+ */
2902
+ memoryScope?: "PER_USER" | "PER_AGENT" | "PER_USER_PER_AGENT";
2903
+ /**
2904
+ * @description Days memories are retained. Included when `expansion=memoryRetentionDays` is requested.
2905
+ * @example 90
2906
+ */
2907
+ memoryRetentionDays?: number;
2908
+ /** @description Suggested prompts shown to users starting a conversation. Included when `expansion=suggestedPrompts` is requested. */
2909
+ suggestedPrompts?: string[];
2910
+ /**
2911
+ * Format: date-time
2912
+ * @description When the first-time builder setup wizard was completed. Included when `expansion=builderSetupCompletedAt` is requested.
2913
+ */
2914
+ builderSetupCompletedAt?: string | null;
2915
+ /** @description Saved canvas node positions for the agent builder. Included when `expansion=builderCanvasPositions` is requested. */
2916
+ builderCanvasPositions?: {
2917
+ [key: string]: unknown;
2918
+ } | null;
2919
+ /** @description Selected model ID within the AI provider connection. Included when `expansion=selectedModelId` is requested. */
2920
+ selectedModelId?: string | null;
2921
+ /** @description Assigned AI provider connection. Included when `expansion=aiConnection` is requested. */
2922
+ aiConnection?: {
2923
+ id?: string;
2924
+ name?: string;
2925
+ providerConfig?: {
2926
+ id?: string;
2927
+ providerSlug?: string;
2928
+ };
2929
+ } | null;
2930
+ /** @description Knowledge notebooks attached to the agent. Included when `expansion=knowledge` is requested. */
2931
+ agentKnowledge?: {
2932
+ id?: string;
2933
+ knowledge?: {
2934
+ id?: string;
2935
+ name?: string;
2936
+ };
2937
+ }[];
2938
+ /** @description Object types attached to the agent. Included when `expansion=objectTypes` is requested. */
2939
+ agentObjectTypes?: {
2940
+ id?: string;
2941
+ scope?: string;
2942
+ objectType?: {
2943
+ id?: string;
2944
+ name?: string;
2945
+ slug?: string;
2946
+ icon?: string | null;
2947
+ color?: string | null;
2948
+ };
2949
+ }[];
2950
+ /** @description Objects attached to the agent. Included when `expansion=objects` is requested. */
2951
+ agentObjects?: {
2952
+ id?: string;
2953
+ scope?: string;
2954
+ object?: {
2955
+ id?: string;
2956
+ name?: string;
2957
+ state?: string;
2958
+ objectType?: {
2959
+ id?: string;
2960
+ name?: string;
2961
+ slug?: string;
2962
+ icon?: string | null;
2963
+ color?: string | null;
2964
+ };
2965
+ };
2966
+ }[];
2967
+ /** @description App connections available to the agent. Included when `expansion=connections` is requested. */
2968
+ connections?: {
2969
+ id?: string;
2970
+ name?: string;
2971
+ }[];
2972
+ /** @description Variables attached to the agent. Included when `expansion=variables` is requested. */
2973
+ agentVariables?: {
2974
+ id?: string;
2975
+ variable?: {
2976
+ id?: string;
2977
+ name?: string;
2978
+ };
2979
+ }[];
2980
+ /** @description Workflows the agent can trigger. Included when `expansion=workflows` is requested. */
2981
+ agentWorkflows?: {
2982
+ id?: string;
2983
+ workflow?: {
2984
+ id?: string;
2985
+ name?: string;
2986
+ };
2987
+ }[];
2988
+ /** @description Sub-agent links for the agent. Included when `expansion=subAgents` is requested. */
2989
+ agentSubAgents?: {
2990
+ id?: string;
2991
+ subagent?: {
2992
+ id?: string;
2993
+ name?: string;
2994
+ };
2995
+ parentAgent?: {
2996
+ id?: string;
2997
+ name?: string;
2998
+ };
2999
+ }[];
3000
+ /** @description MCP servers attached to the agent, with per-tool overrides. Included when `expansion=mcpServers` is requested. */
3001
+ agentMcpServers?: {
3002
+ id?: string;
3003
+ mcpServer?: {
3004
+ id?: string;
3005
+ slug?: string;
3006
+ name?: string;
3007
+ provider?: string;
3008
+ logoUrl?: string | null;
3009
+ description?: string | null;
3010
+ };
3011
+ toolOverrides?: {
3012
+ id?: string;
3013
+ toolName?: string;
3014
+ enabled?: boolean;
3015
+ requireApproval?: boolean;
3016
+ }[];
3017
+ }[];
3018
+ /** @description A2A (agent-to-agent) endpoints attached to the agent. Included when `expansion=a2aAgents` is requested. */
3019
+ agentA2aAgents?: {
3020
+ id?: string;
3021
+ a2aAgent?: {
3022
+ id?: string;
3023
+ slug?: string;
3024
+ name?: string;
3025
+ logoUrl?: string | null;
3026
+ description?: string | null;
3027
+ authType?: string;
3028
+ };
3029
+ }[];
3030
+ /** @description Web access configuration. Included when `expansion=webAccess` is requested. */
3031
+ agentWebAccess?: {
3032
+ service?: string;
3033
+ webSearchEnabled?: boolean;
3034
+ websiteAccessEnabled?: boolean;
3035
+ } | null;
3036
+ /** @description Phone access configuration. Included when `expansion=phoneAccess` is requested. */
3037
+ agentPhoneAccess?: {
3038
+ service?: string;
3039
+ outboundCallsEnabled?: boolean;
3040
+ inboundCallsEnabled?: boolean;
3041
+ } | null;
3042
+ /** @description Project the agent belongs to. Included when `expansion=project` is requested. */
3043
+ project?: {
3044
+ id?: string;
3045
+ name?: string;
3046
+ };
3047
+ };
3048
+ UpsertAgentToolDto: {
3049
+ /** @description Workflow app id (catalogue slug). */
3050
+ appId: string;
3051
+ /** @description Catalogue action id. */
3052
+ actionId: string;
3053
+ /** @description Connection instance UUID pre-bound on the tool. */
3054
+ connectionId?: string;
3055
+ /** @description Tool display name for the model. */
3056
+ name?: string;
3057
+ /** @description Tool description shown to the model. */
3058
+ description?: string;
3059
+ /** @description Pre-filled tool config (fields left empty are filled by the model). */
3060
+ input?: {
3061
+ [key: string]: unknown;
3062
+ };
3063
+ };
3064
+ UpsertAgentBySlugDto: {
3065
+ /**
3066
+ * @description Stable project-scoped slug (lowercase, digits, hyphens). Used as the upsert key.
3067
+ * @example support-triage
3068
+ */
3069
+ slug: string;
3070
+ /** @description Display name. Defaults to the slug when omitted. */
3071
+ name?: string;
3072
+ description?: string;
3073
+ /** @description System instructions / prompt for the agent. */
3074
+ instructions: string;
3075
+ /** @description Selected model id on the AI provider connection (e.g. `gpt-4o`). */
3076
+ model: string;
3077
+ /** @description AiProviderConnection UUID. When omitted, platform AI defaults apply. */
3078
+ aiConnectionId?: string;
3079
+ /** @description App Connection UUIDs the agent may use for tools. */
3080
+ connectionIds?: string[];
3081
+ /** @description Workflow UUIDs the agent may run (AgentWorkflow links). */
3082
+ workflowIds?: string[];
3083
+ /** @description Catalogue action tools (WorkflowNodeForRunner-shaped). */
3084
+ tools?: components["schemas"]["UpsertAgentToolDto"][];
3085
+ /** @description Marks the row as managed by code (CLI / SDK). Defaults to true on this endpoint. */
3086
+ managedByCode?: boolean;
3087
+ };
3002
3088
  CreateKnowledgeDto: {
3003
3089
  /** @description Name of the knowledge base. */
3004
3090
  name: string;
@@ -3147,6 +3233,124 @@ interface components {
3147
3233
  /** @description Vector references (parts) in the group, ordered by part number. */
3148
3234
  vectorRefs: components["schemas"]["KnowledgeDocumentGroupVectorRefDto"][];
3149
3235
  };
3236
+ CreateVariableDto: {
3237
+ /** @description Name of the variable. */
3238
+ name: string;
3239
+ /** @description Description of the variable. */
3240
+ description?: string;
3241
+ /**
3242
+ * @description Scope of the variable (system, workspace or project).
3243
+ * @enum {string}
3244
+ */
3245
+ type: "system" | "workspace" | "project";
3246
+ /**
3247
+ * @description Data type of the variable value.
3248
+ * @enum {string}
3249
+ */
3250
+ dataType: "string" | "number" | "boolean" | "date" | "json";
3251
+ /** @description Project ID to scope the variable to. Must belong to the current workspace. */
3252
+ projectId?: string;
3253
+ /** @description Variable value, submitted as a string. Values with dataType `number` are converted to numbers on save. */
3254
+ value: string;
3255
+ };
3256
+ VariableWorkspaceDto: {
3257
+ /** @description Workspace ID. */
3258
+ id: string;
3259
+ /** @description Workspace name. */
3260
+ name: string;
3261
+ };
3262
+ VariableProjectDto: {
3263
+ /** @description Project ID. */
3264
+ id: string;
3265
+ /** @description Project name. */
3266
+ name: string;
3267
+ };
3268
+ VariableResponseDto: {
3269
+ /** @description Variable ID. */
3270
+ id: string;
3271
+ /** @description Variable name. */
3272
+ name: string;
3273
+ /**
3274
+ * @description Data type of the variable value.
3275
+ * @enum {string}
3276
+ */
3277
+ dataType: "string" | "number" | "boolean" | "date" | "json";
3278
+ /**
3279
+ * @description Scope of the variable (system, workspace or project).
3280
+ * @enum {string}
3281
+ */
3282
+ type: "system" | "workspace" | "project";
3283
+ /** @description Variable value. Included when `expansion=value` is requested. */
3284
+ value?: Record<string, never>;
3285
+ /** @description Variable description. Included when `expansion=description` is requested. */
3286
+ description?: string;
3287
+ /**
3288
+ * Format: date-time
3289
+ * @description Creation timestamp. Included when `expansion=createdAt` is requested.
3290
+ */
3291
+ createdAt?: string;
3292
+ /**
3293
+ * Format: date-time
3294
+ * @description Last update timestamp. Included when `expansion=updatedAt` is requested.
3295
+ */
3296
+ updatedAt?: string;
3297
+ /** @description Owning workspace. Included when `expansion=workspace` is requested. */
3298
+ workspace?: components["schemas"]["VariableWorkspaceDto"];
3299
+ /** @description Owning project for project-scoped variables. Included when `expansion=project` is requested. */
3300
+ project?: components["schemas"]["VariableProjectDto"];
3301
+ };
3302
+ UpdateVariableDto: {
3303
+ /** @description Name of the variable. */
3304
+ name?: string;
3305
+ /** @description Description of the variable. */
3306
+ description?: string;
3307
+ /**
3308
+ * @description Scope of the variable (system, workspace or project).
3309
+ * @enum {string}
3310
+ */
3311
+ type?: "system" | "workspace" | "project";
3312
+ /**
3313
+ * @description Data type of the variable value.
3314
+ * @enum {string}
3315
+ */
3316
+ dataType?: "string" | "number" | "boolean" | "date" | "json";
3317
+ /** @description Project ID to scope the variable to. Must belong to the current workspace. */
3318
+ projectId?: string;
3319
+ /** @description Variable value, submitted as a string. Values with dataType `number` are converted to numbers on save. */
3320
+ value?: string;
3321
+ };
3322
+ ConnectionWorkspaceDto: {
3323
+ /** @description Workspace ID. */
3324
+ id: string;
3325
+ /** @description Workspace name. */
3326
+ name: string;
3327
+ };
3328
+ ConnectionResponseDto: {
3329
+ /** @description Connection ID. */
3330
+ id: string;
3331
+ /** @description Connection name. */
3332
+ name: string;
3333
+ /**
3334
+ * Format: date-time
3335
+ * @description Creation timestamp. Included when `expansion=createdAt` is requested.
3336
+ */
3337
+ createdAt?: string;
3338
+ /**
3339
+ * Format: date-time
3340
+ * @description Last update timestamp. Included when `expansion=updatedAt` is requested.
3341
+ */
3342
+ updatedAt?: string;
3343
+ /** @description App connection type ID (e.g. the OAuth2 or API key connection definition of the app). Included when `expansion=connectionId` is requested. */
3344
+ connectionId?: string;
3345
+ /** @description ID of the workflow app this connection belongs to. Included when `expansion=workflowAppId` or `expansion=workflowApp` is requested. */
3346
+ workflowAppId?: string;
3347
+ /** @description Full workflow app definition for this connection. Included when `expansion=workflowApp` is requested on the list endpoint. */
3348
+ workflowApp?: {
3349
+ [key: string]: unknown;
3350
+ };
3351
+ /** @description Owning workspace. Included when `expansion=workspace` is requested. */
3352
+ workspace?: components["schemas"]["ConnectionWorkspaceDto"];
3353
+ };
3150
3354
  ManuallyRunWorkflowInputDataDto: {
3151
3355
  /**
3152
3356
  * @description Values for the custom input fields configured on the workflow "Manually Run" trigger, keyed by field ID. Pass an empty object when the trigger defines no custom input fields.
@@ -3367,135 +3571,17 @@ interface components {
3367
3571
  /** @description Action input fields (mirrors the action `inputConfig` keys). */
3368
3572
  input?: {
3369
3573
  [key: string]: unknown;
3370
- };
3371
- /** @description Optional display name for this step. */
3372
- name?: string;
3373
- };
3374
- StartRunDto: {
3375
- /** @description Linear catalogue-action steps. Executed as one multi-step Execution with `source: SDK` (not a soft batch / correlation id). */
3376
- steps: components["schemas"]["RunStepDto"][];
3377
- /** @description Project UUID for variable/project scoping. When omitted and the workspace has exactly one project, that project is used. */
3378
- projectId?: string;
3379
- /** @description Optional display name for the ad-hoc Execution. */
3380
- name?: string;
3381
- };
3382
- CreateVariableDto: {
3383
- /** @description Name of the variable. */
3384
- name: string;
3385
- /** @description Description of the variable. */
3386
- description?: string;
3387
- /**
3388
- * @description Scope of the variable (system, workspace or project).
3389
- * @enum {string}
3390
- */
3391
- type: "system" | "workspace" | "project";
3392
- /**
3393
- * @description Data type of the variable value.
3394
- * @enum {string}
3395
- */
3396
- dataType: "string" | "number" | "boolean" | "date" | "json";
3397
- /** @description Project ID to scope the variable to. Must belong to the current workspace. */
3398
- projectId?: string;
3399
- /** @description Variable value, submitted as a string. Values with dataType `number` are converted to numbers on save. */
3400
- value: string;
3401
- };
3402
- VariableWorkspaceDto: {
3403
- /** @description Workspace ID. */
3404
- id: string;
3405
- /** @description Workspace name. */
3406
- name: string;
3407
- };
3408
- VariableProjectDto: {
3409
- /** @description Project ID. */
3410
- id: string;
3411
- /** @description Project name. */
3412
- name: string;
3413
- };
3414
- VariableResponseDto: {
3415
- /** @description Variable ID. */
3416
- id: string;
3417
- /** @description Variable name. */
3418
- name: string;
3419
- /**
3420
- * @description Data type of the variable value.
3421
- * @enum {string}
3422
- */
3423
- dataType: "string" | "number" | "boolean" | "date" | "json";
3424
- /**
3425
- * @description Scope of the variable (system, workspace or project).
3426
- * @enum {string}
3427
- */
3428
- type: "system" | "workspace" | "project";
3429
- /** @description Variable value. Included when `expansion=value` is requested. */
3430
- value?: Record<string, never>;
3431
- /** @description Variable description. Included when `expansion=description` is requested. */
3432
- description?: string;
3433
- /**
3434
- * Format: date-time
3435
- * @description Creation timestamp. Included when `expansion=createdAt` is requested.
3436
- */
3437
- createdAt?: string;
3438
- /**
3439
- * Format: date-time
3440
- * @description Last update timestamp. Included when `expansion=updatedAt` is requested.
3441
- */
3442
- updatedAt?: string;
3443
- /** @description Owning workspace. Included when `expansion=workspace` is requested. */
3444
- workspace?: components["schemas"]["VariableWorkspaceDto"];
3445
- /** @description Owning project for project-scoped variables. Included when `expansion=project` is requested. */
3446
- project?: components["schemas"]["VariableProjectDto"];
3447
- };
3448
- UpdateVariableDto: {
3449
- /** @description Name of the variable. */
3450
- name?: string;
3451
- /** @description Description of the variable. */
3452
- description?: string;
3453
- /**
3454
- * @description Scope of the variable (system, workspace or project).
3455
- * @enum {string}
3456
- */
3457
- type?: "system" | "workspace" | "project";
3458
- /**
3459
- * @description Data type of the variable value.
3460
- * @enum {string}
3461
- */
3462
- dataType?: "string" | "number" | "boolean" | "date" | "json";
3463
- /** @description Project ID to scope the variable to. Must belong to the current workspace. */
3464
- projectId?: string;
3465
- /** @description Variable value, submitted as a string. Values with dataType `number` are converted to numbers on save. */
3466
- value?: string;
3467
- };
3468
- ConnectionWorkspaceDto: {
3469
- /** @description Workspace ID. */
3470
- id: string;
3471
- /** @description Workspace name. */
3472
- name: string;
3473
- };
3474
- ConnectionResponseDto: {
3475
- /** @description Connection ID. */
3476
- id: string;
3477
- /** @description Connection name. */
3478
- name: string;
3479
- /**
3480
- * Format: date-time
3481
- * @description Creation timestamp. Included when `expansion=createdAt` is requested.
3482
- */
3483
- createdAt?: string;
3484
- /**
3485
- * Format: date-time
3486
- * @description Last update timestamp. Included when `expansion=updatedAt` is requested.
3487
- */
3488
- updatedAt?: string;
3489
- /** @description App connection type ID (e.g. the OAuth2 or API key connection definition of the app). Included when `expansion=connectionId` is requested. */
3490
- connectionId?: string;
3491
- /** @description ID of the workflow app this connection belongs to. Included when `expansion=workflowAppId` or `expansion=workflowApp` is requested. */
3492
- workflowAppId?: string;
3493
- /** @description Full workflow app definition for this connection. Included when `expansion=workflowApp` is requested on the list endpoint. */
3494
- workflowApp?: {
3495
- [key: string]: unknown;
3496
- };
3497
- /** @description Owning workspace. Included when `expansion=workspace` is requested. */
3498
- workspace?: components["schemas"]["ConnectionWorkspaceDto"];
3574
+ };
3575
+ /** @description Optional display name for this step. */
3576
+ name?: string;
3577
+ };
3578
+ StartRunDto: {
3579
+ /** @description Linear catalogue-action steps. Executed as one multi-step Execution with `source: SDK` (not a soft batch / correlation id). */
3580
+ steps: components["schemas"]["RunStepDto"][];
3581
+ /** @description Project UUID for variable/project scoping. When omitted and the workspace has exactly one project, that project is used. */
3582
+ projectId?: string;
3583
+ /** @description Optional display name for the ad-hoc Execution. */
3584
+ name?: string;
3499
3585
  };
3500
3586
  TaskListItemResponseDto: {
3501
3587
  /**
@@ -3642,6 +3728,8 @@ interface components {
3642
3728
  * @example Conversation covering the Q3 regional sales report
3643
3729
  */
3644
3730
  description?: string;
3731
+ /** @description Approve (true) or clear (false) the current runtime plan for plan-before-execute gating. */
3732
+ approvePlan?: boolean;
3645
3733
  };
3646
3734
  DeletedTaskResponseDto: {
3647
3735
  /**
@@ -3715,6 +3803,10 @@ interface components {
3715
3803
  * }
3716
3804
  */
3717
3805
  data?: Record<string, never>;
3806
+ /** @description Solution Designer handoff */
3807
+ solutionId?: string;
3808
+ planStepId?: string;
3809
+ delegationId?: string;
3718
3810
  };
3719
3811
  StreamMessageStopDto: {
3720
3812
  /** @description Partial assistant message to persist when stopping a stream */
@@ -4665,14 +4757,12 @@ interface operations {
4665
4757
  };
4666
4758
  };
4667
4759
  };
4668
- AgentsController_findAllForWorkspace: {
4760
+ ObjectTypesController_findAll: {
4669
4761
  parameters: {
4670
4762
  query?: {
4671
- /** @description Comma-separated include flags, e.g. `includeType=all`. Available: all */
4672
- includeType?: string;
4673
- /** @description Filters in `key:value` format, comma-separated, e.g. `filterBy=projectId:<uuid>`. Available: projectId */
4674
- filterBy?: string;
4675
- /** @description Comma-separated fields to expand, e.g. `expansion=description,createdAt`. Available: createdAt, updatedAt, description, profileImageUrl, instructions, temperature, maxOutputTokens, topP, frequencyPenalty, presencePenalty, maxRetries, seed, maxToolRoundtrips, messageLookbackLimit, project, tools, toolIds, knowledge, objects, objectTypes, connections, variables, workflows, subAgents, webAccess, phoneAccess, aiConnection, selectedModelId, taskNamingInstructions, enabledBuiltInTools, enabledPlatformTools, mcpServers, a2aAgents, dynamicActionDiscoveryEnabled, dynamicMcpDiscoveryEnabled, dynamicSelfInstructionsEnabled, memoryEnabled, memoryScope, memoryRetentionDays, suggestedPrompts, builderSetupCompletedAt, builderCanvasPositions, slug, managedByCode */
4763
+ /** @description Set to true to include disabled entity types. */
4764
+ includeDisabled?: boolean;
4765
+ /** @description Comma-separated fields to expand. Available: description, attributeSchema, stateSchema, createdAt, updatedAt, createdBy, countObjects. */
4676
4766
  expansion?: string;
4677
4767
  };
4678
4768
  header?: never;
@@ -4681,140 +4771,40 @@ interface operations {
4681
4771
  };
4682
4772
  requestBody?: never;
4683
4773
  responses: {
4684
- /** @description Agents in the current workspace */
4774
+ /** @description Entity types in the workspace. */
4685
4775
  200: {
4686
4776
  headers: {
4687
4777
  [name: string]: unknown;
4688
4778
  };
4689
4779
  content: {
4690
- "application/json": components["schemas"]["AgentResponseDto"][];
4780
+ "application/json": components["schemas"]["ObjectTypeResponseDto"][];
4691
4781
  };
4692
4782
  };
4693
4783
  };
4694
4784
  };
4695
- AgentsController_findOne: {
4785
+ ObjectTypesController_upsertBySlug: {
4696
4786
  parameters: {
4697
4787
  query?: {
4698
- /** @description Comma-separated fields to expand, e.g. `expansion=description,createdAt`. Available: createdAt, updatedAt, description, profileImageUrl, instructions, temperature, maxOutputTokens, topP, frequencyPenalty, presencePenalty, maxRetries, seed, maxToolRoundtrips, messageLookbackLimit, project, tools, toolIds, knowledge, objects, objectTypes, connections, variables, workflows, subAgents, webAccess, phoneAccess, aiConnection, selectedModelId, taskNamingInstructions, enabledBuiltInTools, enabledPlatformTools, mcpServers, a2aAgents, dynamicActionDiscoveryEnabled, dynamicMcpDiscoveryEnabled, dynamicSelfInstructionsEnabled, memoryEnabled, memoryScope, memoryRetentionDays, suggestedPrompts, builderSetupCompletedAt, builderCanvasPositions, slug, managedByCode */
4788
+ /** @description Comma-separated fields to expand. Available: description, attributeSchema, stateSchema, createdAt, updatedAt, createdBy, countObjects. */
4699
4789
  expansion?: string;
4700
4790
  };
4701
4791
  header?: never;
4702
- path: {
4703
- agentId: string;
4704
- };
4705
- cookie?: never;
4706
- };
4707
- requestBody?: never;
4708
- responses: {
4709
- /** @description The requested agent */
4710
- 200: {
4711
- headers: {
4712
- [name: string]: unknown;
4713
- };
4714
- content: {
4715
- "application/json": components["schemas"]["AgentResponseDto"];
4716
- };
4717
- };
4718
- };
4719
- };
4720
- ProjectAgentsController_upsertBySlug: {
4721
- parameters: {
4722
- query?: never;
4723
- header?: never;
4724
- path: {
4725
- projectId: string;
4726
- };
4727
- cookie?: never;
4728
- };
4729
- requestBody: {
4730
- content: {
4731
- "application/json": components["schemas"]["UpsertAgentBySlugDto"];
4732
- };
4733
- };
4734
- responses: {
4735
- /** @description The created or updated agent. */
4736
- 200: {
4737
- headers: {
4738
- [name: string]: unknown;
4739
- };
4740
- content: {
4741
- "application/json": components["schemas"]["AgentResponseDto"];
4742
- };
4743
- };
4744
- };
4745
- };
4746
- WorkflowAppsController_findAll: {
4747
- parameters: {
4748
- query?: never;
4749
- header?: never;
4750
4792
  path?: never;
4751
4793
  cookie?: never;
4752
4794
  };
4753
- requestBody?: never;
4754
- responses: {
4755
- /** @description All workflow app definitions. */
4756
- 200: {
4757
- headers: {
4758
- [name: string]: unknown;
4759
- };
4760
- content: {
4761
- "application/json": components["schemas"]["WorkflowAppResponseDto"][];
4762
- };
4763
- };
4764
- };
4765
- };
4766
- WorkflowAppsController_connectApp: {
4767
- parameters: {
4768
- query?: never;
4769
- header?: never;
4770
- path: {
4771
- appId: string;
4772
- connectionId: string;
4773
- };
4774
- cookie?: never;
4775
- };
4776
4795
  requestBody: {
4777
4796
  content: {
4778
- "application/json": {
4779
- [key: string]: unknown;
4780
- };
4781
- };
4782
- };
4783
- responses: {
4784
- /** @description Result of the connection attempt, written by the app connection handler. */
4785
- 200: {
4786
- headers: {
4787
- [name: string]: unknown;
4788
- };
4789
- content: {
4790
- "application/json": {
4791
- [key: string]: unknown;
4792
- };
4793
- };
4794
- };
4795
- };
4796
- };
4797
- ObjectTypesController_findAll: {
4798
- parameters: {
4799
- query?: {
4800
- /** @description Set to true to include disabled entity types. */
4801
- includeDisabled?: boolean;
4802
- /** @description Comma-separated fields to expand. Available: description, attributeSchema, stateSchema, createdAt, updatedAt, createdBy, countObjects. */
4803
- expansion?: string;
4797
+ "application/json": components["schemas"]["UpsertObjectTypeBySlugDto"];
4804
4798
  };
4805
- header?: never;
4806
- path?: never;
4807
- cookie?: never;
4808
4799
  };
4809
- requestBody?: never;
4810
4800
  responses: {
4811
- /** @description Entity types in the workspace. */
4801
+ /** @description The created or updated entity type. */
4812
4802
  200: {
4813
4803
  headers: {
4814
4804
  [name: string]: unknown;
4815
4805
  };
4816
4806
  content: {
4817
- "application/json": components["schemas"]["ObjectTypeResponseDto"][];
4807
+ "application/json": components["schemas"]["ObjectTypeResponseDto"];
4818
4808
  };
4819
4809
  };
4820
4810
  };
@@ -5189,17 +5179,146 @@ interface operations {
5189
5179
  path: {
5190
5180
  entityTypeId: string;
5191
5181
  };
5192
- cookie?: never;
5182
+ cookie?: never;
5183
+ };
5184
+ requestBody?: never;
5185
+ responses: {
5186
+ /** @description Import template columns and sample row. */
5187
+ 200: {
5188
+ headers: {
5189
+ [name: string]: unknown;
5190
+ };
5191
+ content: {
5192
+ "application/json": components["schemas"]["ImportTemplateResponseDto"];
5193
+ };
5194
+ };
5195
+ };
5196
+ };
5197
+ WorkflowAppsController_findAll: {
5198
+ parameters: {
5199
+ query?: never;
5200
+ header?: never;
5201
+ path?: never;
5202
+ cookie?: never;
5203
+ };
5204
+ requestBody?: never;
5205
+ responses: {
5206
+ /** @description All workflow app definitions. */
5207
+ 200: {
5208
+ headers: {
5209
+ [name: string]: unknown;
5210
+ };
5211
+ content: {
5212
+ "application/json": components["schemas"]["WorkflowAppResponseDto"][];
5213
+ };
5214
+ };
5215
+ };
5216
+ };
5217
+ WorkflowAppsController_connectApp: {
5218
+ parameters: {
5219
+ query?: never;
5220
+ header?: never;
5221
+ path: {
5222
+ appId: string;
5223
+ connectionId: string;
5224
+ };
5225
+ cookie?: never;
5226
+ };
5227
+ requestBody: {
5228
+ content: {
5229
+ "application/json": {
5230
+ [key: string]: unknown;
5231
+ };
5232
+ };
5233
+ };
5234
+ responses: {
5235
+ /** @description Result of the connection attempt, written by the app connection handler. */
5236
+ 200: {
5237
+ headers: {
5238
+ [name: string]: unknown;
5239
+ };
5240
+ content: {
5241
+ "application/json": {
5242
+ [key: string]: unknown;
5243
+ };
5244
+ };
5245
+ };
5246
+ };
5247
+ };
5248
+ AgentsController_findAllForWorkspace: {
5249
+ parameters: {
5250
+ query?: {
5251
+ /** @description Comma-separated include flags, e.g. `includeType=all`. Available: all */
5252
+ includeType?: string;
5253
+ /** @description Filters in `key:value` format, comma-separated, e.g. `filterBy=projectId:<uuid>`. Available: projectId */
5254
+ filterBy?: string;
5255
+ /** @description Comma-separated fields to expand, e.g. `expansion=description,createdAt`. Available: createdAt, updatedAt, description, profileImageUrl, instructions, temperature, maxOutputTokens, topP, frequencyPenalty, presencePenalty, maxRetries, seed, maxToolRoundtrips, messageLookbackLimit, project, tools, toolIds, knowledge, objects, objectTypes, connections, variables, workflows, subAgents, webAccess, phoneAccess, aiConnection, selectedModelId, taskNamingInstructions, enabledBuiltInTools, enabledPlatformTools, mcpServers, a2aAgents, dynamicActionDiscoveryEnabled, dynamicMcpDiscoveryEnabled, dynamicSelfInstructionsEnabled, memoryEnabled, memoryScope, memoryRetentionDays, enablePlanning, enableToolResultOffload, toolResultOffloadThresholdBytes, longHorizonMode, longHorizonMaxSteps, longHorizonMaxTokensPerRun, enabledToolPolicies, forcedTools, requirePlanApproval, suggestedPrompts, builderSetupCompletedAt, builderCanvasPositions, slug, managedByCode */
5256
+ expansion?: string;
5257
+ };
5258
+ header?: never;
5259
+ path?: never;
5260
+ cookie?: never;
5261
+ };
5262
+ requestBody?: never;
5263
+ responses: {
5264
+ /** @description Agents in the current workspace */
5265
+ 200: {
5266
+ headers: {
5267
+ [name: string]: unknown;
5268
+ };
5269
+ content: {
5270
+ "application/json": components["schemas"]["AgentResponseDto"][];
5271
+ };
5272
+ };
5273
+ };
5274
+ };
5275
+ AgentsController_findOne: {
5276
+ parameters: {
5277
+ query?: {
5278
+ /** @description Comma-separated fields to expand, e.g. `expansion=description,createdAt`. Available: createdAt, updatedAt, description, profileImageUrl, instructions, temperature, maxOutputTokens, topP, frequencyPenalty, presencePenalty, maxRetries, seed, maxToolRoundtrips, messageLookbackLimit, project, tools, toolIds, knowledge, objects, objectTypes, connections, variables, workflows, subAgents, webAccess, phoneAccess, aiConnection, selectedModelId, taskNamingInstructions, enabledBuiltInTools, enabledPlatformTools, mcpServers, a2aAgents, dynamicActionDiscoveryEnabled, dynamicMcpDiscoveryEnabled, dynamicSelfInstructionsEnabled, memoryEnabled, memoryScope, memoryRetentionDays, enablePlanning, enableToolResultOffload, toolResultOffloadThresholdBytes, longHorizonMode, longHorizonMaxSteps, longHorizonMaxTokensPerRun, enabledToolPolicies, forcedTools, requirePlanApproval, suggestedPrompts, builderSetupCompletedAt, builderCanvasPositions, slug, managedByCode */
5279
+ expansion?: string;
5280
+ };
5281
+ header?: never;
5282
+ path: {
5283
+ agentId: string;
5284
+ };
5285
+ cookie?: never;
5286
+ };
5287
+ requestBody?: never;
5288
+ responses: {
5289
+ /** @description The requested agent */
5290
+ 200: {
5291
+ headers: {
5292
+ [name: string]: unknown;
5293
+ };
5294
+ content: {
5295
+ "application/json": components["schemas"]["AgentResponseDto"];
5296
+ };
5297
+ };
5298
+ };
5299
+ };
5300
+ ProjectAgentsController_upsertBySlug: {
5301
+ parameters: {
5302
+ query?: never;
5303
+ header?: never;
5304
+ path: {
5305
+ projectId: string;
5306
+ };
5307
+ cookie?: never;
5308
+ };
5309
+ requestBody: {
5310
+ content: {
5311
+ "application/json": components["schemas"]["UpsertAgentBySlugDto"];
5312
+ };
5193
5313
  };
5194
- requestBody?: never;
5195
5314
  responses: {
5196
- /** @description Import template columns and sample row. */
5315
+ /** @description The created or updated agent. */
5197
5316
  200: {
5198
5317
  headers: {
5199
5318
  [name: string]: unknown;
5200
5319
  };
5201
5320
  content: {
5202
- "application/json": components["schemas"]["ImportTemplateResponseDto"];
5321
+ "application/json": components["schemas"]["AgentResponseDto"];
5203
5322
  };
5204
5323
  };
5205
5324
  };
@@ -5423,332 +5542,332 @@ interface operations {
5423
5542
  };
5424
5543
  };
5425
5544
  };
5426
- ExecutionsController_manuallyExecuteWorkflow: {
5545
+ VariablesController_findAllForWorkspace: {
5427
5546
  parameters: {
5428
- query?: never;
5429
- header?: never;
5430
- path: {
5431
- workflowId: string;
5547
+ query?: {
5548
+ /** @description Comma-separated include flags. Available: all */
5549
+ includeType?: string;
5550
+ /** @description Comma-separated key:value filters. Available: projectId (variables owned by the project), projectAccessId (variables the project can access, including workspace-wide ones). Example: filterBy=projectId:abc123 */
5551
+ filterBy?: string;
5552
+ /** @description Comma-separated fields to expand. Available: description, createdAt, updatedAt, value, workspace, project */
5553
+ expansion?: string;
5432
5554
  };
5555
+ header?: never;
5556
+ path?: never;
5433
5557
  cookie?: never;
5434
5558
  };
5435
- requestBody: {
5436
- content: {
5437
- "application/json": components["schemas"]["ManuallyRunWorkflowInputDataDto"];
5438
- };
5439
- };
5559
+ requestBody?: never;
5440
5560
  responses: {
5441
- /** @description The newly created execution. Only the execution ID is returned; poll GET /executions/{executionId} to track progress. */
5442
- 201: {
5561
+ /** @description Variables in the workspace. */
5562
+ 200: {
5443
5563
  headers: {
5444
5564
  [name: string]: unknown;
5445
5565
  };
5446
5566
  content: {
5447
- "application/json": components["schemas"]["ExecuteWorkflowResponseDto"];
5567
+ "application/json": components["schemas"]["VariableResponseDto"][];
5448
5568
  };
5449
5569
  };
5450
5570
  };
5451
5571
  };
5452
- ExecutionsController_findAll: {
5572
+ VariablesController_create: {
5453
5573
  parameters: {
5454
5574
  query?: {
5455
- /** @description Comma-separated inclusion flags. Available: all, internal. Pass internal to include executions of internal workflows, which are excluded by default. */
5456
- includeType?: string;
5457
- /** @description Comma-separated key:value filters. Available: projectId, workflowId, source (WORKFLOW|SDK). Example: filterBy=workflowId:wf_123 or filterBy=source:SDK */
5458
- filterBy?: string;
5459
- /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, startedAt, stoppedAt, executionNumber, nodes, edges, status, statusMessage, continueExecutionAt, workflow, project, workspace, output, orientation, executionVariables, source, name. The executionPath expansion is only honoured on GET /executions/{executionId}. Example: expansion=status,startedAt,workflow,source */
5575
+ /** @description Comma-separated fields to expand. Available: description, createdAt, updatedAt, value, workspace, project */
5460
5576
  expansion?: string;
5461
5577
  };
5462
5578
  header?: never;
5463
5579
  path?: never;
5464
5580
  cookie?: never;
5465
5581
  };
5466
- requestBody?: never;
5582
+ requestBody: {
5583
+ content: {
5584
+ "application/json": components["schemas"]["CreateVariableDto"];
5585
+ };
5586
+ };
5467
5587
  responses: {
5468
- /** @description List of executions. Fields beyond the ID are included according to the expansion query parameter. */
5469
- 200: {
5588
+ /** @description The created variable. */
5589
+ 201: {
5470
5590
  headers: {
5471
5591
  [name: string]: unknown;
5472
5592
  };
5473
5593
  content: {
5474
- "application/json": components["schemas"]["ExecutionResponseDto"][];
5594
+ "application/json": components["schemas"]["VariableResponseDto"];
5475
5595
  };
5476
5596
  };
5477
5597
  };
5478
5598
  };
5479
- ExecutionsController_findOne: {
5599
+ VariablesController_findOne: {
5480
5600
  parameters: {
5481
5601
  query?: {
5482
- /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, startedAt, stoppedAt, executionNumber, nodes, edges, status, statusMessage, continueExecutionAt, workflow, project, workspace, output, orientation, executionVariables, executionPath, pendingInput, source, name. executionPath is the derived, ordered list of executed (or queued) steps with labels, per-step status, timings, and loop iteration metadata. pendingInput is the field schema for steps paused in NEEDS_INPUT. Example: expansion=status,executionPath,pendingInput,source */
5602
+ /** @description Comma-separated fields to expand. Available: description, createdAt, updatedAt, value, workspace, project */
5483
5603
  expansion?: string;
5484
5604
  };
5485
5605
  header?: never;
5486
5606
  path: {
5487
- executionId: string;
5607
+ variableId: string;
5488
5608
  };
5489
5609
  cookie?: never;
5490
5610
  };
5491
5611
  requestBody?: never;
5492
5612
  responses: {
5493
- /** @description The execution. Fields beyond the ID and startedAt are included according to the expansion query parameter. */
5613
+ /** @description The requested variable. */
5494
5614
  200: {
5495
5615
  headers: {
5496
5616
  [name: string]: unknown;
5497
5617
  };
5498
5618
  content: {
5499
- "application/json": components["schemas"]["ExecutionResponseDto"];
5619
+ "application/json": components["schemas"]["VariableResponseDto"];
5500
5620
  };
5501
5621
  };
5502
5622
  };
5503
5623
  };
5504
- ExecutionsController_streamExecution: {
5624
+ VariablesController_delete: {
5505
5625
  parameters: {
5506
5626
  query?: never;
5507
5627
  header?: never;
5508
5628
  path: {
5509
- executionId: string;
5629
+ variableId: string;
5510
5630
  };
5511
5631
  cookie?: never;
5512
5632
  };
5513
5633
  requestBody?: never;
5514
5634
  responses: {
5515
- /** @description SSE stream of execution progress, loop progress, finished, and heartbeat events */
5635
+ /** @description Returns true when the variable was deleted. */
5516
5636
  200: {
5517
5637
  headers: {
5518
5638
  [name: string]: unknown;
5519
5639
  };
5520
5640
  content: {
5521
- "text/event-stream": string;
5641
+ "application/json": boolean;
5522
5642
  };
5523
5643
  };
5524
5644
  };
5525
5645
  };
5526
- ActionsController_run: {
5646
+ VariablesController_update: {
5527
5647
  parameters: {
5528
- query?: never;
5648
+ query?: {
5649
+ /** @description Comma-separated fields to expand. Available: description, createdAt, updatedAt, value, workspace, project */
5650
+ expansion?: string;
5651
+ };
5529
5652
  header?: never;
5530
- path?: never;
5653
+ path: {
5654
+ variableId: string;
5655
+ };
5531
5656
  cookie?: never;
5532
5657
  };
5533
5658
  requestBody: {
5534
5659
  content: {
5535
- "application/json": components["schemas"]["RunActionDto"];
5660
+ "application/json": components["schemas"]["UpdateVariableDto"];
5536
5661
  };
5537
5662
  };
5538
5663
  responses: {
5539
- /** @description The ad-hoc Execution id plus the synchronous action result (status, output, single-step executionPath). */
5540
- 201: {
5664
+ /** @description The updated variable. */
5665
+ 200: {
5541
5666
  headers: {
5542
5667
  [name: string]: unknown;
5543
5668
  };
5544
5669
  content: {
5545
- "application/json": components["schemas"]["RunActionResponseDto"];
5670
+ "application/json": components["schemas"]["VariableResponseDto"];
5546
5671
  };
5547
5672
  };
5548
5673
  };
5549
5674
  };
5550
- RunsController_start: {
5675
+ ConnectionsController_findAllForWorkspace: {
5551
5676
  parameters: {
5552
- query?: never;
5677
+ query?: {
5678
+ /** @description Comma-separated include flags. Available: all */
5679
+ includeType?: string;
5680
+ /** @description Comma-separated key:value filters. Available: workflowAppId. Example: filterBy=workflowAppId:gmail */
5681
+ filterBy?: string;
5682
+ /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, connectionId, workflowAppId, workflowApp, workspace. Credentials are never returned. */
5683
+ expansion?: string;
5684
+ };
5553
5685
  header?: never;
5554
5686
  path?: never;
5555
5687
  cookie?: never;
5556
5688
  };
5557
- requestBody: {
5558
- content: {
5559
- "application/json": components["schemas"]["StartRunDto"];
5560
- };
5561
- };
5689
+ requestBody?: never;
5562
5690
  responses: {
5563
- /** @description The ad-hoc Execution id plus the synchronous multi-step result (status, last-step output, executionPath). */
5564
- 201: {
5691
+ /** @description Connections available in the workspace. */
5692
+ 200: {
5565
5693
  headers: {
5566
5694
  [name: string]: unknown;
5567
5695
  };
5568
5696
  content: {
5569
- "application/json": components["schemas"]["RunActionResponseDto"];
5697
+ "application/json": components["schemas"]["ConnectionResponseDto"][];
5570
5698
  };
5571
5699
  };
5572
5700
  };
5573
5701
  };
5574
- VariablesController_findAllForWorkspace: {
5702
+ ConnectionsController_findOne: {
5575
5703
  parameters: {
5576
5704
  query?: {
5577
- /** @description Comma-separated include flags. Available: all */
5578
- includeType?: string;
5579
- /** @description Comma-separated key:value filters. Available: projectId (variables owned by the project), projectAccessId (variables the project can access, including workspace-wide ones). Example: filterBy=projectId:abc123 */
5580
- filterBy?: string;
5581
- /** @description Comma-separated fields to expand. Available: description, createdAt, updatedAt, value, workspace, project */
5705
+ /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, connectionId, workflowAppId, workflowApp, workspace. Credentials are never returned. */
5582
5706
  expansion?: string;
5583
5707
  };
5584
5708
  header?: never;
5585
- path?: never;
5709
+ path: {
5710
+ connectionId: string;
5711
+ };
5586
5712
  cookie?: never;
5587
5713
  };
5588
5714
  requestBody?: never;
5589
5715
  responses: {
5590
- /** @description Variables in the workspace. */
5716
+ /** @description The requested connection. */
5591
5717
  200: {
5592
5718
  headers: {
5593
5719
  [name: string]: unknown;
5594
5720
  };
5595
5721
  content: {
5596
- "application/json": components["schemas"]["VariableResponseDto"][];
5722
+ "application/json": components["schemas"]["ConnectionResponseDto"];
5597
5723
  };
5598
5724
  };
5599
5725
  };
5600
5726
  };
5601
- VariablesController_create: {
5727
+ ExecutionsController_manuallyExecuteWorkflow: {
5602
5728
  parameters: {
5603
- query?: {
5604
- /** @description Comma-separated fields to expand. Available: description, createdAt, updatedAt, value, workspace, project */
5605
- expansion?: string;
5606
- };
5729
+ query?: never;
5607
5730
  header?: never;
5608
- path?: never;
5731
+ path: {
5732
+ workflowId: string;
5733
+ };
5609
5734
  cookie?: never;
5610
5735
  };
5611
5736
  requestBody: {
5612
5737
  content: {
5613
- "application/json": components["schemas"]["CreateVariableDto"];
5738
+ "application/json": components["schemas"]["ManuallyRunWorkflowInputDataDto"];
5614
5739
  };
5615
5740
  };
5616
5741
  responses: {
5617
- /** @description The created variable. */
5742
+ /** @description The newly created execution. Only the execution ID is returned; poll GET /executions/{executionId} to track progress. */
5618
5743
  201: {
5619
5744
  headers: {
5620
5745
  [name: string]: unknown;
5621
5746
  };
5622
5747
  content: {
5623
- "application/json": components["schemas"]["VariableResponseDto"];
5748
+ "application/json": components["schemas"]["ExecuteWorkflowResponseDto"];
5624
5749
  };
5625
5750
  };
5626
5751
  };
5627
5752
  };
5628
- VariablesController_findOne: {
5753
+ ExecutionsController_findAll: {
5629
5754
  parameters: {
5630
5755
  query?: {
5631
- /** @description Comma-separated fields to expand. Available: description, createdAt, updatedAt, value, workspace, project */
5756
+ /** @description Comma-separated inclusion flags. Available: all, internal. Pass internal to include executions of internal workflows, which are excluded by default. */
5757
+ includeType?: string;
5758
+ /** @description Comma-separated key:value filters. Available: projectId, workflowId, source (WORKFLOW|SDK). Example: filterBy=workflowId:wf_123 or filterBy=source:SDK */
5759
+ filterBy?: string;
5760
+ /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, startedAt, stoppedAt, executionNumber, nodes, edges, status, statusMessage, continueExecutionAt, workflow, project, workspace, output, orientation, executionVariables, source, name. The executionPath expansion is only honoured on GET /executions/{executionId}. Example: expansion=status,startedAt,workflow,source */
5632
5761
  expansion?: string;
5633
5762
  };
5634
5763
  header?: never;
5635
- path: {
5636
- variableId: string;
5637
- };
5764
+ path?: never;
5638
5765
  cookie?: never;
5639
5766
  };
5640
5767
  requestBody?: never;
5641
5768
  responses: {
5642
- /** @description The requested variable. */
5769
+ /** @description List of executions. Fields beyond the ID are included according to the expansion query parameter. */
5643
5770
  200: {
5644
5771
  headers: {
5645
5772
  [name: string]: unknown;
5646
5773
  };
5647
5774
  content: {
5648
- "application/json": components["schemas"]["VariableResponseDto"];
5775
+ "application/json": components["schemas"]["ExecutionResponseDto"][];
5649
5776
  };
5650
5777
  };
5651
5778
  };
5652
5779
  };
5653
- VariablesController_delete: {
5780
+ ExecutionsController_findOne: {
5654
5781
  parameters: {
5655
- query?: never;
5782
+ query?: {
5783
+ /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, startedAt, stoppedAt, executionNumber, nodes, edges, status, statusMessage, continueExecutionAt, workflow, project, workspace, output, orientation, executionVariables, executionPath, pendingInput, source, name. executionPath is the derived, ordered list of executed (or queued) steps with labels, per-step status, timings, and loop iteration metadata. pendingInput is the field schema for steps paused in NEEDS_INPUT. Example: expansion=status,executionPath,pendingInput,source */
5784
+ expansion?: string;
5785
+ };
5656
5786
  header?: never;
5657
5787
  path: {
5658
- variableId: string;
5788
+ executionId: string;
5659
5789
  };
5660
5790
  cookie?: never;
5661
5791
  };
5662
5792
  requestBody?: never;
5663
5793
  responses: {
5664
- /** @description Returns true when the variable was deleted. */
5794
+ /** @description The execution. Fields beyond the ID and startedAt are included according to the expansion query parameter. */
5665
5795
  200: {
5666
5796
  headers: {
5667
5797
  [name: string]: unknown;
5668
5798
  };
5669
5799
  content: {
5670
- "application/json": boolean;
5800
+ "application/json": components["schemas"]["ExecutionResponseDto"];
5671
5801
  };
5672
5802
  };
5673
5803
  };
5674
5804
  };
5675
- VariablesController_update: {
5805
+ ExecutionsController_streamExecution: {
5676
5806
  parameters: {
5677
- query?: {
5678
- /** @description Comma-separated fields to expand. Available: description, createdAt, updatedAt, value, workspace, project */
5679
- expansion?: string;
5680
- };
5807
+ query?: never;
5681
5808
  header?: never;
5682
5809
  path: {
5683
- variableId: string;
5810
+ executionId: string;
5684
5811
  };
5685
5812
  cookie?: never;
5686
5813
  };
5687
- requestBody: {
5688
- content: {
5689
- "application/json": components["schemas"]["UpdateVariableDto"];
5690
- };
5691
- };
5814
+ requestBody?: never;
5692
5815
  responses: {
5693
- /** @description The updated variable. */
5816
+ /** @description SSE stream of execution progress, loop progress, finished, and heartbeat events */
5694
5817
  200: {
5695
5818
  headers: {
5696
5819
  [name: string]: unknown;
5697
5820
  };
5698
5821
  content: {
5699
- "application/json": components["schemas"]["VariableResponseDto"];
5822
+ "text/event-stream": string;
5700
5823
  };
5701
5824
  };
5702
5825
  };
5703
5826
  };
5704
- ConnectionsController_findAllForWorkspace: {
5827
+ ActionsController_run: {
5705
5828
  parameters: {
5706
- query?: {
5707
- /** @description Comma-separated include flags. Available: all */
5708
- includeType?: string;
5709
- /** @description Comma-separated key:value filters. Available: workflowAppId. Example: filterBy=workflowAppId:gmail */
5710
- filterBy?: string;
5711
- /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, connectionId, workflowAppId, workflowApp, workspace. Credentials are never returned. */
5712
- expansion?: string;
5713
- };
5829
+ query?: never;
5714
5830
  header?: never;
5715
5831
  path?: never;
5716
5832
  cookie?: never;
5717
5833
  };
5718
- requestBody?: never;
5834
+ requestBody: {
5835
+ content: {
5836
+ "application/json": components["schemas"]["RunActionDto"];
5837
+ };
5838
+ };
5719
5839
  responses: {
5720
- /** @description Connections available in the workspace. */
5721
- 200: {
5840
+ /** @description The ad-hoc Execution id plus the synchronous action result (status, output, single-step executionPath). */
5841
+ 201: {
5722
5842
  headers: {
5723
5843
  [name: string]: unknown;
5724
5844
  };
5725
5845
  content: {
5726
- "application/json": components["schemas"]["ConnectionResponseDto"][];
5846
+ "application/json": components["schemas"]["RunActionResponseDto"];
5727
5847
  };
5728
5848
  };
5729
5849
  };
5730
5850
  };
5731
- ConnectionsController_findOne: {
5851
+ RunsController_start: {
5732
5852
  parameters: {
5733
- query?: {
5734
- /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, connectionId, workflowAppId, workflowApp, workspace. Credentials are never returned. */
5735
- expansion?: string;
5736
- };
5853
+ query?: never;
5737
5854
  header?: never;
5738
- path: {
5739
- connectionId: string;
5740
- };
5855
+ path?: never;
5741
5856
  cookie?: never;
5742
5857
  };
5743
- requestBody?: never;
5858
+ requestBody: {
5859
+ content: {
5860
+ "application/json": components["schemas"]["StartRunDto"];
5861
+ };
5862
+ };
5744
5863
  responses: {
5745
- /** @description The requested connection. */
5746
- 200: {
5864
+ /** @description The ad-hoc Execution id plus the synchronous multi-step result (status, last-step output, executionPath). */
5865
+ 201: {
5747
5866
  headers: {
5748
5867
  [name: string]: unknown;
5749
5868
  };
5750
5869
  content: {
5751
- "application/json": components["schemas"]["ConnectionResponseDto"];
5870
+ "application/json": components["schemas"]["RunActionResponseDto"];
5752
5871
  };
5753
5872
  };
5754
5873
  };
@@ -6432,6 +6551,7 @@ declare const DEFINE_KINDS: {
6432
6551
  readonly action: "action";
6433
6552
  readonly workflow: "workflow";
6434
6553
  readonly agent: "agent";
6554
+ readonly entityType: "entityType";
6435
6555
  };
6436
6556
  type DefineKind = (typeof DEFINE_KINDS)[keyof typeof DEFINE_KINDS];
6437
6557
  /** Ref to an existing app Connection (credentials stay on Lunnoa). */
@@ -6504,6 +6624,26 @@ declare function defineAiConnection(config?: Omit<AiConnectionDefinition, 'kind'
6504
6624
  declare function defineAction(config: Omit<ActionDefinition, 'kind'>): ActionDefinition;
6505
6625
  declare function defineWorkflow(config: Omit<WorkflowDefinition, 'kind'>): WorkflowDefinition;
6506
6626
  declare function defineAgent(config: Omit<AgentDefinition, 'kind'>): AgentDefinition;
6627
+ interface EntityTypeDefinition {
6628
+ kind: typeof DEFINE_KINDS.entityType;
6629
+ /** Stable workspace-scoped slug (upsert key). */
6630
+ slug: string;
6631
+ name?: string;
6632
+ namePlural?: string;
6633
+ description?: string;
6634
+ icon?: string;
6635
+ color?: string;
6636
+ /** Field definitions grouped into sections (same contract as Adminspace). */
6637
+ attributeSchema: Record<string, unknown>;
6638
+ stateSchema?: Record<string, unknown> | null;
6639
+ isEnabled?: boolean;
6640
+ /**
6641
+ * When false (default), entity writes reject undeclared attribute keys.
6642
+ * Reserved key `extensions` is always allowed as a JSON object.
6643
+ */
6644
+ allowUnknownAttributes?: boolean;
6645
+ }
6646
+ declare function defineEntityType(config: Omit<EntityTypeDefinition, 'kind'>): EntityTypeDefinition;
6507
6647
  /** Infer appId from catalogue action ids like `http_action_send-request`. */
6508
6648
  declare function resolveActionAppId(action: ActionDefinition): string;
6509
6649
  declare function resolveActionId(action: ActionDefinition): string;
@@ -6801,6 +6941,21 @@ interface EntityTypeReadOptions {
6801
6941
  /** Fields to expand, e.g. `['attributeSchema', 'stateSchema', 'description']`. */
6802
6942
  expansion?: string | string[];
6803
6943
  }
6944
+ /** Payload for `POST /api/object-types/upsert`. */
6945
+ interface UpsertEntityTypeBySlugInput {
6946
+ slug: string;
6947
+ name?: string;
6948
+ namePlural?: string;
6949
+ description?: string;
6950
+ icon?: string;
6951
+ color?: string;
6952
+ attributeSchema: Record<string, unknown>;
6953
+ stateSchema?: Record<string, unknown> | null;
6954
+ isEnabled?: boolean;
6955
+ allowUnknownAttributes?: boolean;
6956
+ managedByCode?: boolean;
6957
+ }
6958
+ declare function entityTypeDefinitionToUpsert(def: EntityTypeDefinition): UpsertEntityTypeBySlugInput;
6804
6959
  declare class EntityTypesResource {
6805
6960
  private readonly http;
6806
6961
  constructor(http: HttpClient);
@@ -6816,6 +6971,11 @@ declare class EntityTypesResource {
6816
6971
  get(id: string, options?: EntityTypeReadOptions): Promise<EntityType>;
6817
6972
  /** Returns a single entity type by its URL-safe slug. */
6818
6973
  getBySlug(slug: string, options?: EntityTypeReadOptions): Promise<EntityType>;
6974
+ /**
6975
+ * Creates or updates an entity type by workspace-scoped slug.
6976
+ * Prefer the CLI (`npx @lunnoa/client entity-types deploy`) for happy-path deploy.
6977
+ */
6978
+ upsertBySlug(definition: EntityTypeDefinition | UpsertEntityTypeBySlugInput): Promise<EntityType>;
6819
6979
  }
6820
6980
 
6821
6981
  type EligibleApprover = {
@@ -7326,4 +7486,4 @@ interface CreateServerClientOptions {
7326
7486
  */
7327
7487
  declare function createServerClient(options: CreateServerClientOptions): LunnoaClient;
7328
7488
 
7329
- export { API_KEY_PREFIX, type ActionDefinition, ActionsResource, type Agent, AgentChatClient, AgentChatStream, type AgentDefinition, type AgentToolDefinition, AgentsResource, type AiConnectionDefinition, type ApprovalInboxItem, ApprovalsResource, AuthResource, type AuthTokens, type BulkCreateQueueItemsInput, type BulkCreateQueueItemsResult, type ChangeEntityStateInput, type ChangeEntityStateResult, type ChatMode, type Connection, type ConnectionDefinition, ConnectionsResource, type CreateBrowserClientOptions, type CreateEntityInput, type CreateKnowledgeInput, type CreateProjectInput, type CreateQueueInput, type CreateQueueItemInput, type CreateServerClientOptions, type CreateTaskInput, type CreateVariableInput, type CurrentUser, DEFINE_KINDS, type DefineKind, type DeletedTask, DiscoveryResource, type EligibleApprover, type EnabledFeatures, EntitiesResource, type Entity, type EntityStateHistoryEntry, type EntityStateTransitions, type EntityType, type EntityTypeReadOptions, EntityTypesResource, type ExecuteWorkflowResult, type Execution, type ExecutionPathStep, type ExecutionProgress, type ExecutionProgressPayload, type ExecutionProgressStep, ExecutionProgressStream, type ExecutionStatus, type ExecutionStreamEvent, type ExecutionStreamEventType, ExecutionTimeoutError, ExecutionsResource, type ExportEntitiesInput, type FetchLike, HttpClient, type ImportEntitiesInput, type ImportEntitiesResult, type ImportTemplate, type Knowledge, type KnowledgeDocument, type KnowledgeDocumentGroup, KnowledgeResource, type ListEntitiesOptions, type ListQueryOptions, type ListQueueItemsByObjectOptions, type ListQueueItemsOptions, type LocalStorageTokenStoreOptions, type LoginRequires2FA, type LoginResult, type LoginSuccess, LunnoaApiError, LunnoaClient, type LunnoaClientOptions, type MessageTaskInput, type OffsetPagination, type PagePagination, type PaginatedEntities, type PendingInput, type PendingInputField, type Project, ProjectsResource, type QueryValue, type Queue, type QueueAllowedObjectType, type QueueItem, type QueueItemCreated, type QueueItemErrorEntry, type QueueItemFull, type QueueItemList, type QueueItemObjectSummary, type QueueItemStats, QueueItemsResource, type QueueStats, QueuesResource, type RequestOptions, type RunActionInput, type RunActionOptions, type RunActionResult, RunsResource, type SaveUploadedTextInput, type SseEvent, SsoAuthResource, type SsoProviderSummary, type SsoProvidersResponse, type StartRunInput, type StartRunInputDto, type StartRunOptions, type StartRunStep, type StopStreamOptions, type StreamMessageOptions, type Task, type TaskListItem, TasksResource, type TokenStore, type UpdateEntityInput, type UpdateKnowledgeInput, type UpdateQueueInput, type UpdateQueueItemInput, type UpdateTaskInput, type UpdateVariableInput, type UpsertAgentBySlugInput, type UpsertAgentBySlugInputDto, type UpsertAgentToolInput, type UpsertWorkflowBySlugInput, type UpsertWorkflowBySlugInputDto, type UpsertWorkflowStepInput, type Variable, VariablesResource, type WaitUntilFinishedOptions, type WatchProgressOptions, type Workflow, type WorkflowApp, WorkflowAppsResource, type WorkflowDefinition, type WorkflowStepDefinition, WorkflowsResource, assertApiKeyAllowedInEnvironment, type components, createBrowserClient, createLocalStorageTokenStore, createMemoryTokenStore, createServerClient, defineAction, defineAgent, defineAiConnection, defineConnection, defineWorkflow, isBrowserEnvironment, isLoginRequires2FA, iterateOffset, iteratePages, type operations, parseSseEvents, parseSseStream, type paths, resolveActionAppId, resolveActionId };
7489
+ export { API_KEY_PREFIX, type ActionDefinition, ActionsResource, type Agent, AgentChatClient, AgentChatStream, type AgentDefinition, type AgentToolDefinition, AgentsResource, type AiConnectionDefinition, type ApprovalInboxItem, ApprovalsResource, AuthResource, type AuthTokens, type BulkCreateQueueItemsInput, type BulkCreateQueueItemsResult, type ChangeEntityStateInput, type ChangeEntityStateResult, type ChatMode, type Connection, type ConnectionDefinition, ConnectionsResource, type CreateBrowserClientOptions, type CreateEntityInput, type CreateKnowledgeInput, type CreateProjectInput, type CreateQueueInput, type CreateQueueItemInput, type CreateServerClientOptions, type CreateTaskInput, type CreateVariableInput, type CurrentUser, DEFINE_KINDS, type DefineKind, type DeletedTask, DiscoveryResource, type EligibleApprover, type EnabledFeatures, EntitiesResource, type Entity, type EntityStateHistoryEntry, type EntityStateTransitions, type EntityType, type EntityTypeDefinition, type EntityTypeReadOptions, EntityTypesResource, type ExecuteWorkflowResult, type Execution, type ExecutionPathStep, type ExecutionProgress, type ExecutionProgressPayload, type ExecutionProgressStep, ExecutionProgressStream, type ExecutionStatus, type ExecutionStreamEvent, type ExecutionStreamEventType, ExecutionTimeoutError, ExecutionsResource, type ExportEntitiesInput, type FetchLike, HttpClient, type ImportEntitiesInput, type ImportEntitiesResult, type ImportTemplate, type Knowledge, type KnowledgeDocument, type KnowledgeDocumentGroup, KnowledgeResource, type ListEntitiesOptions, type ListQueryOptions, type ListQueueItemsByObjectOptions, type ListQueueItemsOptions, type LocalStorageTokenStoreOptions, type LoginRequires2FA, type LoginResult, type LoginSuccess, LunnoaApiError, LunnoaClient, type LunnoaClientOptions, type MessageTaskInput, type OffsetPagination, type PagePagination, type PaginatedEntities, type PendingInput, type PendingInputField, type Project, ProjectsResource, type QueryValue, type Queue, type QueueAllowedObjectType, type QueueItem, type QueueItemCreated, type QueueItemErrorEntry, type QueueItemFull, type QueueItemList, type QueueItemObjectSummary, type QueueItemStats, QueueItemsResource, type QueueStats, QueuesResource, type RequestOptions, type RunActionInput, type RunActionOptions, type RunActionResult, RunsResource, type SaveUploadedTextInput, type SseEvent, SsoAuthResource, type SsoProviderSummary, type SsoProvidersResponse, type StartRunInput, type StartRunInputDto, type StartRunOptions, type StartRunStep, type StopStreamOptions, type StreamMessageOptions, type Task, type TaskListItem, TasksResource, type TokenStore, type UpdateEntityInput, type UpdateKnowledgeInput, type UpdateQueueInput, type UpdateQueueItemInput, type UpdateTaskInput, type UpdateVariableInput, type UpsertAgentBySlugInput, type UpsertAgentBySlugInputDto, type UpsertAgentToolInput, type UpsertEntityTypeBySlugInput, type UpsertWorkflowBySlugInput, type UpsertWorkflowBySlugInputDto, type UpsertWorkflowStepInput, type Variable, VariablesResource, type WaitUntilFinishedOptions, type WatchProgressOptions, type Workflow, type WorkflowApp, WorkflowAppsResource, type WorkflowDefinition, type WorkflowStepDefinition, WorkflowsResource, assertApiKeyAllowedInEnvironment, type components, createBrowserClient, createLocalStorageTokenStore, createMemoryTokenStore, createServerClient, defineAction, defineAgent, defineAiConnection, defineConnection, defineEntityType, defineWorkflow, entityTypeDefinitionToUpsert, isBrowserEnvironment, isLoginRequires2FA, iterateOffset, iteratePages, type operations, parseSseEvents, parseSseStream, type paths, resolveActionAppId, resolveActionId };