@agent-os-sdk/client 0.9.14 → 0.9.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. package/dist/client/AgentOsClient.d.ts +8 -4
  2. package/dist/client/AgentOsClient.d.ts.map +1 -1
  3. package/dist/client/AgentOsClient.js +12 -6
  4. package/dist/errors/factory.d.ts +2 -0
  5. package/dist/errors/factory.d.ts.map +1 -1
  6. package/dist/errors/factory.js +5 -1
  7. package/dist/generated/openapi.d.ts +544 -744
  8. package/dist/generated/openapi.d.ts.map +1 -1
  9. package/dist/index.d.ts +8 -2
  10. package/dist/index.d.ts.map +1 -1
  11. package/dist/index.js +8 -2
  12. package/dist/modules/agents.d.ts +25 -7
  13. package/dist/modules/agents.d.ts.map +1 -1
  14. package/dist/modules/agents.js +36 -7
  15. package/dist/modules/contracts.d.ts +48 -0
  16. package/dist/modules/contracts.d.ts.map +1 -0
  17. package/dist/modules/contracts.js +25 -0
  18. package/dist/modules/evaluation.d.ts +64 -0
  19. package/dist/modules/evaluation.d.ts.map +1 -1
  20. package/dist/modules/evaluation.js +12 -0
  21. package/dist/modules/improvements.d.ts +52 -0
  22. package/dist/modules/improvements.d.ts.map +1 -0
  23. package/dist/modules/improvements.js +27 -0
  24. package/dist/modules/metaAgent.d.ts +62 -0
  25. package/dist/modules/metaAgent.d.ts.map +1 -0
  26. package/dist/modules/metaAgent.js +25 -0
  27. package/dist/modules/presets.d.ts.map +1 -1
  28. package/dist/modules/presets.js +113 -44
  29. package/dist/modules/runs.d.ts +9 -0
  30. package/dist/modules/runs.d.ts.map +1 -1
  31. package/dist/modules/runs.js +14 -1
  32. package/dist/modules/templates.d.ts +28 -0
  33. package/dist/modules/templates.d.ts.map +1 -0
  34. package/dist/modules/templates.js +19 -0
  35. package/package.json +2 -2
  36. package/src/client/AgentOsClient.ts +12 -6
  37. package/src/errors/factory.ts +7 -2
  38. package/src/generated/openapi.ts +544 -744
  39. package/src/generated/swagger.json +551 -924
  40. package/src/index.ts +22 -2
  41. package/src/modules/agents.ts +62 -8
  42. package/src/modules/contracts.ts +80 -0
  43. package/src/modules/evaluation.ts +80 -0
  44. package/src/modules/improvements.ts +71 -0
  45. package/src/modules/metaAgent.ts +87 -0
  46. package/src/modules/presets.ts +118 -50
  47. package/src/modules/runs.ts +20 -1
  48. package/src/modules/templates.ts +40 -0
  49. package/src/modules/builder.ts +0 -456
  50. package/src/modules/graphs.ts +0 -188
@@ -146,6 +146,103 @@ export interface paths {
146
146
  patch?: never;
147
147
  trace?: never;
148
148
  };
149
+ "/v1/api/agents/{agentId}/runtime-contexts": {
150
+ parameters: {
151
+ query?: never;
152
+ header?: never;
153
+ path?: never;
154
+ cookie?: never;
155
+ };
156
+ get: {
157
+ parameters: {
158
+ query?: never;
159
+ header?: never;
160
+ path: {
161
+ agentId: string;
162
+ };
163
+ cookie?: never;
164
+ };
165
+ requestBody?: never;
166
+ responses: {
167
+ /** @description OK */
168
+ 200: {
169
+ headers: {
170
+ [name: string]: unknown;
171
+ };
172
+ content?: never;
173
+ };
174
+ };
175
+ };
176
+ put?: never;
177
+ post?: never;
178
+ delete?: never;
179
+ options?: never;
180
+ head?: never;
181
+ patch?: never;
182
+ trace?: never;
183
+ };
184
+ "/v1/api/agents/{agentId}/runtime-contexts/{contextKey}": {
185
+ parameters: {
186
+ query?: never;
187
+ header?: never;
188
+ path?: never;
189
+ cookie?: never;
190
+ };
191
+ get: {
192
+ parameters: {
193
+ query?: never;
194
+ header?: never;
195
+ path: {
196
+ agentId: string;
197
+ contextKey: string;
198
+ };
199
+ cookie?: never;
200
+ };
201
+ requestBody?: never;
202
+ responses: {
203
+ /** @description OK */
204
+ 200: {
205
+ headers: {
206
+ [name: string]: unknown;
207
+ };
208
+ content?: never;
209
+ };
210
+ };
211
+ };
212
+ put: {
213
+ parameters: {
214
+ query?: never;
215
+ header?: never;
216
+ path: {
217
+ agentId: string;
218
+ contextKey: string;
219
+ };
220
+ cookie?: never;
221
+ };
222
+ requestBody?: {
223
+ content: {
224
+ "application/json": components["schemas"]["UpsertAgentRuntimeContextRequest"];
225
+ "text/json": components["schemas"]["UpsertAgentRuntimeContextRequest"];
226
+ "application/*+json": components["schemas"]["UpsertAgentRuntimeContextRequest"];
227
+ };
228
+ };
229
+ responses: {
230
+ /** @description OK */
231
+ 200: {
232
+ headers: {
233
+ [name: string]: unknown;
234
+ };
235
+ content?: never;
236
+ };
237
+ };
238
+ };
239
+ post?: never;
240
+ delete?: never;
241
+ options?: never;
242
+ head?: never;
243
+ patch?: never;
244
+ trace?: never;
245
+ };
149
246
  "/v1/api/agents": {
150
247
  parameters: {
151
248
  query?: never;
@@ -206,15 +303,13 @@ export interface paths {
206
303
  put?: never;
207
304
  /**
208
305
  * Creates a new agent in the current workspace.
209
- * @description Creates a new agent with the specified configuration. The agent is created in draft mode
210
- * and must have a version published before it can be used for runs.
306
+ * @description Creates a new agent in draft mode and seeds a minimal `agent_ir.v1`.
307
+ * The agent must have a published artifact before it can be used for runs.
211
308
  *
212
309
  * **Example Request:**
213
310
  * ```json
214
311
  * {
215
- * "name": "customer-support-agent",
216
- * "description": "Handles customer inquiries and support tickets",
217
- * "graph_spec": { "nodes": [...], "edges": [...] }
312
+ * "name": "customer-support-agent"
218
313
  * }
219
314
  * ```
220
315
  */
@@ -225,7 +320,7 @@ export interface paths {
225
320
  path?: never;
226
321
  cookie?: never;
227
322
  };
228
- /** @description The agent creation request containing name, description, and optional graph specification. */
323
+ /** @description The agent creation request containing the name and optional metadata. */
229
324
  requestBody?: {
230
325
  content: {
231
326
  "application/json": components["schemas"]["CreateAgentRequest"];
@@ -455,6 +550,88 @@ export interface paths {
455
550
  };
456
551
  trace?: never;
457
552
  };
553
+ "/v1/api/agents/{id}/credential-bindings": {
554
+ parameters: {
555
+ query?: never;
556
+ header?: never;
557
+ path?: never;
558
+ cookie?: never;
559
+ };
560
+ get?: never;
561
+ put?: never;
562
+ /** Creates or updates a credential binding for an agent alias. */
563
+ post: {
564
+ parameters: {
565
+ query?: never;
566
+ header?: never;
567
+ path: {
568
+ /** @description The agent identifier. */
569
+ id: string;
570
+ };
571
+ cookie?: never;
572
+ };
573
+ /** @description Binding payload (credential id, alias, priority). */
574
+ requestBody?: {
575
+ content: {
576
+ "application/json": components["schemas"]["UpsertAgentCredentialBindingRequest"];
577
+ "text/json": components["schemas"]["UpsertAgentCredentialBindingRequest"];
578
+ "application/*+json": components["schemas"]["UpsertAgentCredentialBindingRequest"];
579
+ };
580
+ };
581
+ responses: {
582
+ /** @description OK */
583
+ 200: {
584
+ headers: {
585
+ [name: string]: unknown;
586
+ };
587
+ content: {
588
+ "application/json": components["schemas"]["UpsertAgentCredentialBindingResponse"];
589
+ };
590
+ };
591
+ /** @description Created */
592
+ 201: {
593
+ headers: {
594
+ [name: string]: unknown;
595
+ };
596
+ content: {
597
+ "application/json": components["schemas"]["UpsertAgentCredentialBindingResponse"];
598
+ };
599
+ };
600
+ /** @description Bad Request */
601
+ 400: {
602
+ headers: {
603
+ [name: string]: unknown;
604
+ };
605
+ content: {
606
+ "application/json": components["schemas"]["ProblemDetails"];
607
+ };
608
+ };
609
+ /** @description Unauthorized */
610
+ 401: {
611
+ headers: {
612
+ [name: string]: unknown;
613
+ };
614
+ content: {
615
+ "application/json": components["schemas"]["ProblemDetails"];
616
+ };
617
+ };
618
+ /** @description Not Found */
619
+ 404: {
620
+ headers: {
621
+ [name: string]: unknown;
622
+ };
623
+ content: {
624
+ "application/json": components["schemas"]["ProblemDetails"];
625
+ };
626
+ };
627
+ };
628
+ };
629
+ delete?: never;
630
+ options?: never;
631
+ head?: never;
632
+ patch?: never;
633
+ trace?: never;
634
+ };
458
635
  "/v1/api/agents/{id}/publish": {
459
636
  parameters: {
460
637
  query?: never;
@@ -535,20 +712,14 @@ export interface paths {
535
712
  patch?: never;
536
713
  trace?: never;
537
714
  };
538
- "/v1/api/agents/{id}/draft/graph": {
715
+ "/v1/api/agents/{id}/draft/ir": {
539
716
  parameters: {
540
717
  query?: never;
541
718
  header?: never;
542
719
  path?: never;
543
720
  cookie?: never;
544
721
  };
545
- /**
546
- * Gets the draft graph specification for an agent.
547
- * @description Returns the current draft graph JSON as saved by autosave.
548
- * Studio should use this as source of truth, not generate graphs locally.
549
- *
550
- * **Response includes ETag** for subsequent PUT If-Match.
551
- */
722
+ /** Gets the draft authoring IR (`agent_ir.v1`) for an agent. */
552
723
  get: {
553
724
  parameters: {
554
725
  query?: never;
@@ -566,7 +737,7 @@ export interface paths {
566
737
  [name: string]: unknown;
567
738
  };
568
739
  content: {
569
- "application/json": components["schemas"]["AgentDraftResponse"];
740
+ "application/json": components["schemas"]["AgentDraftIrResponse"];
570
741
  };
571
742
  };
572
743
  /** @description Not Found */
@@ -578,24 +749,16 @@ export interface paths {
578
749
  "application/json": components["schemas"]["ProblemDetails"];
579
750
  };
580
751
  };
752
+ /** @description Internal Server Error */
753
+ 500: {
754
+ headers: {
755
+ [name: string]: unknown;
756
+ };
757
+ content?: never;
758
+ };
581
759
  };
582
760
  };
583
- /**
584
- * Updates the draft graph specification for an agent (autosave/resume).
585
- * @description **IMPORTANT:** Draft is for UI autosave only. Publish does NOT read from draft.
586
- * Publish continues to use `request.GraphSpec` as the canonical source.
587
- *
588
- * Requires `If-Match` header with ETag from previous GET/PUT.
589
- *
590
- * **ETag Format:**
591
- * - Header: `"agentId:ticks"` (with quotes)
592
- * - Body: `agentId:ticks` (no quotes)
593
- *
594
- * **Hints (in ProblemDetails.Extensions):**
595
- * - 428: `include_if_match` - SDK should auto-fetch ETag
596
- * - 412: `reload_and_retry` - Front should refetch and confirm
597
- * - 400: `fix_payload` - Editor should show validation error
598
- */
761
+ /** Updates the draft authoring IR (`agent_ir.v1`) for an agent. */
599
762
  put: {
600
763
  parameters: {
601
764
  query?: never;
@@ -607,9 +770,9 @@ export interface paths {
607
770
  };
608
771
  requestBody?: {
609
772
  content: {
610
- "application/json": components["schemas"]["UpdateDraftGraphRequest"];
611
- "text/json": components["schemas"]["UpdateDraftGraphRequest"];
612
- "application/*+json": components["schemas"]["UpdateDraftGraphRequest"];
773
+ "application/json": components["schemas"]["UpdateDraftIrRequest"];
774
+ "text/json": components["schemas"]["UpdateDraftIrRequest"];
775
+ "application/*+json": components["schemas"]["UpdateDraftIrRequest"];
613
776
  };
614
777
  };
615
778
  responses: {
@@ -619,7 +782,7 @@ export interface paths {
619
782
  [name: string]: unknown;
620
783
  };
621
784
  content: {
622
- "application/json": components["schemas"]["AgentDraftResponseApiEnvelope"];
785
+ "application/json": components["schemas"]["AgentDraftIrResponseApiEnvelope"];
623
786
  };
624
787
  };
625
788
  /** @description Bad Request */
@@ -658,6 +821,20 @@ export interface paths {
658
821
  "application/json": components["schemas"]["ProblemDetails"];
659
822
  };
660
823
  };
824
+ /** @description Internal Server Error */
825
+ 500: {
826
+ headers: {
827
+ [name: string]: unknown;
828
+ };
829
+ content?: never;
830
+ };
831
+ /** @description Service Unavailable */
832
+ 503: {
833
+ headers: {
834
+ [name: string]: unknown;
835
+ };
836
+ content?: never;
837
+ };
661
838
  };
662
839
  };
663
840
  post?: never;
@@ -1305,37 +1482,25 @@ export interface paths {
1305
1482
  patch?: never;
1306
1483
  trace?: never;
1307
1484
  };
1308
- "/v1/api/builder/{agentId}/chat": {
1485
+ "/v1/api/agents/{agentId}/bundles/{bundleId}/manifest": {
1309
1486
  parameters: {
1310
1487
  query?: never;
1311
1488
  header?: never;
1312
1489
  path?: never;
1313
1490
  cookie?: never;
1314
1491
  };
1315
- get?: never;
1316
- put?: never;
1317
- /**
1318
- * Chat with the Meta-Agent to modify an agent's graph.
1319
- * Returns SSE stream: message, graph_update, done events.
1320
- * @description KERNEL: Frontend sends intention only. CP loads everything from DB.
1321
- * SECURITY: X-Workspace-Id header is MANDATORY for workspace isolation.
1322
- */
1323
- post: {
1492
+ /** Get artifact manifest for a bundle. */
1493
+ get: {
1324
1494
  parameters: {
1325
1495
  query?: never;
1326
1496
  header?: never;
1327
1497
  path: {
1328
1498
  agentId: string;
1499
+ bundleId: string;
1329
1500
  };
1330
1501
  cookie?: never;
1331
1502
  };
1332
- requestBody?: {
1333
- content: {
1334
- "application/json": components["schemas"]["BuilderChatRequest"];
1335
- "text/json": components["schemas"]["BuilderChatRequest"];
1336
- "application/*+json": components["schemas"]["BuilderChatRequest"];
1337
- };
1338
- };
1503
+ requestBody?: never;
1339
1504
  responses: {
1340
1505
  /** @description OK */
1341
1506
  200: {
@@ -1346,38 +1511,33 @@ export interface paths {
1346
1511
  };
1347
1512
  };
1348
1513
  };
1514
+ put?: never;
1515
+ post?: never;
1349
1516
  delete?: never;
1350
1517
  options?: never;
1351
1518
  head?: never;
1352
1519
  patch?: never;
1353
1520
  trace?: never;
1354
1521
  };
1355
- "/v1/api/builder/{agentId}/chat/sync": {
1522
+ "/v1/api/agents/{agentId}/bundles/{bundleId}/graph/mermaid": {
1356
1523
  parameters: {
1357
1524
  query?: never;
1358
1525
  header?: never;
1359
1526
  path?: never;
1360
1527
  cookie?: never;
1361
1528
  };
1362
- get?: never;
1363
- put?: never;
1364
- /** Synchronous version of builder chat (for testing). */
1365
- post: {
1529
+ /** Get Mermaid diagram for graph. */
1530
+ get: {
1366
1531
  parameters: {
1367
1532
  query?: never;
1368
1533
  header?: never;
1369
1534
  path: {
1370
1535
  agentId: string;
1536
+ bundleId: string;
1371
1537
  };
1372
1538
  cookie?: never;
1373
1539
  };
1374
- requestBody?: {
1375
- content: {
1376
- "application/json": components["schemas"]["BuilderChatRequest"];
1377
- "text/json": components["schemas"]["BuilderChatRequest"];
1378
- "application/*+json": components["schemas"]["BuilderChatRequest"];
1379
- };
1380
- };
1540
+ requestBody?: never;
1381
1541
  responses: {
1382
1542
  /** @description OK */
1383
1543
  200: {
@@ -1388,28 +1548,28 @@ export interface paths {
1388
1548
  };
1389
1549
  };
1390
1550
  };
1551
+ put?: never;
1552
+ post?: never;
1391
1553
  delete?: never;
1392
1554
  options?: never;
1393
1555
  head?: never;
1394
1556
  patch?: never;
1395
1557
  trace?: never;
1396
1558
  };
1397
- "/v1/api/agents/{agentId}/bundles/{bundleId}/manifest": {
1559
+ "/v1/api/catalog/nodes": {
1398
1560
  parameters: {
1399
1561
  query?: never;
1400
1562
  header?: never;
1401
1563
  path?: never;
1402
1564
  cookie?: never;
1403
1565
  };
1404
- /** Get artifact manifest for a bundle. */
1405
1566
  get: {
1406
1567
  parameters: {
1407
- query?: never;
1408
- header?: never;
1409
- path: {
1410
- agentId: string;
1411
- bundleId: string;
1568
+ query?: {
1569
+ version?: number;
1412
1570
  };
1571
+ header?: never;
1572
+ path?: never;
1413
1573
  cookie?: never;
1414
1574
  };
1415
1575
  requestBody?: never;
@@ -1419,7 +1579,9 @@ export interface paths {
1419
1579
  headers: {
1420
1580
  [name: string]: unknown;
1421
1581
  };
1422
- content?: never;
1582
+ content: {
1583
+ "application/json": components["schemas"]["NodeCatalogResponse"];
1584
+ };
1423
1585
  };
1424
1586
  };
1425
1587
  };
@@ -1431,22 +1593,20 @@ export interface paths {
1431
1593
  patch?: never;
1432
1594
  trace?: never;
1433
1595
  };
1434
- "/v1/api/agents/{agentId}/bundles/{bundleId}/graph/mermaid": {
1596
+ "/v1/api/triggers/templates": {
1435
1597
  parameters: {
1436
1598
  query?: never;
1437
1599
  header?: never;
1438
1600
  path?: never;
1439
1601
  cookie?: never;
1440
1602
  };
1441
- /** Get Mermaid diagram for graph. */
1442
1603
  get: {
1443
1604
  parameters: {
1444
- query?: never;
1445
- header?: never;
1446
- path: {
1447
- agentId: string;
1448
- bundleId: string;
1605
+ query?: {
1606
+ version?: number;
1449
1607
  };
1608
+ header?: never;
1609
+ path?: never;
1450
1610
  cookie?: never;
1451
1611
  };
1452
1612
  requestBody?: never;
@@ -1456,7 +1616,9 @@ export interface paths {
1456
1616
  headers: {
1457
1617
  [name: string]: unknown;
1458
1618
  };
1459
- content?: never;
1619
+ content: {
1620
+ "application/json": components["schemas"]["TriggerTemplatesCatalogResponse"];
1621
+ };
1460
1622
  };
1461
1623
  };
1462
1624
  };
@@ -1468,7 +1630,7 @@ export interface paths {
1468
1630
  patch?: never;
1469
1631
  trace?: never;
1470
1632
  };
1471
- "/v1/api/catalog/nodes": {
1633
+ "/v1/api/catalog/presets": {
1472
1634
  parameters: {
1473
1635
  query?: never;
1474
1636
  header?: never;
@@ -1492,7 +1654,7 @@ export interface paths {
1492
1654
  [name: string]: unknown;
1493
1655
  };
1494
1656
  content: {
1495
- "application/json": components["schemas"]["NodeCatalogResponse"];
1657
+ "application/json": components["schemas"]["NodePresetsCatalogResponse"];
1496
1658
  };
1497
1659
  };
1498
1660
  };
@@ -1505,20 +1667,22 @@ export interface paths {
1505
1667
  patch?: never;
1506
1668
  trace?: never;
1507
1669
  };
1508
- "/v1/api/triggers/templates": {
1670
+ "/v1/api/workspaces/{workspaceId}/runs/{runId}/checkpoints": {
1509
1671
  parameters: {
1510
1672
  query?: never;
1511
1673
  header?: never;
1512
1674
  path?: never;
1513
1675
  cookie?: never;
1514
1676
  };
1677
+ /** List checkpoints for a run as a tree structure. */
1515
1678
  get: {
1516
1679
  parameters: {
1517
- query?: {
1518
- version?: number;
1519
- };
1680
+ query?: never;
1520
1681
  header?: never;
1521
- path?: never;
1682
+ path: {
1683
+ workspaceId: string;
1684
+ runId: string;
1685
+ };
1522
1686
  cookie?: never;
1523
1687
  };
1524
1688
  requestBody?: never;
@@ -1529,64 +1693,65 @@ export interface paths {
1529
1693
  [name: string]: unknown;
1530
1694
  };
1531
1695
  content: {
1532
- "application/json": components["schemas"]["TriggerTemplatesCatalogResponse"];
1696
+ "application/json": components["schemas"]["CheckpointListResponse"];
1697
+ };
1698
+ };
1699
+ /** @description Not Found */
1700
+ 404: {
1701
+ headers: {
1702
+ [name: string]: unknown;
1703
+ };
1704
+ content: {
1705
+ "application/json": components["schemas"]["ProblemDetails"];
1533
1706
  };
1534
1707
  };
1535
1708
  };
1536
1709
  };
1537
1710
  put?: never;
1538
- post?: never;
1539
- delete?: never;
1540
- options?: never;
1541
- head?: never;
1542
- patch?: never;
1543
- trace?: never;
1544
- };
1545
- "/v1/api/catalog/presets": {
1546
- parameters: {
1547
- query?: never;
1548
- header?: never;
1549
- path?: never;
1550
- cookie?: never;
1551
- };
1552
- get: {
1711
+ /** Create a checkpoint for a run (called by kernel callbacks). */
1712
+ post: {
1553
1713
  parameters: {
1554
- query?: {
1555
- version?: number;
1556
- };
1714
+ query?: never;
1557
1715
  header?: never;
1558
- path?: never;
1716
+ path: {
1717
+ workspaceId: string;
1718
+ runId: string;
1719
+ };
1559
1720
  cookie?: never;
1560
1721
  };
1561
- requestBody?: never;
1722
+ requestBody?: {
1723
+ content: {
1724
+ "application/json": components["schemas"]["CreateCheckpointRequest"];
1725
+ "text/json": components["schemas"]["CreateCheckpointRequest"];
1726
+ "application/*+json": components["schemas"]["CreateCheckpointRequest"];
1727
+ };
1728
+ };
1562
1729
  responses: {
1563
- /** @description OK */
1564
- 200: {
1730
+ /** @description Created */
1731
+ 201: {
1565
1732
  headers: {
1566
1733
  [name: string]: unknown;
1567
1734
  };
1568
1735
  content: {
1569
- "application/json": components["schemas"]["NodePresetsCatalogResponse"];
1736
+ "application/json": components["schemas"]["CheckpointDetail"];
1570
1737
  };
1571
1738
  };
1572
1739
  };
1573
1740
  };
1574
- put?: never;
1575
- post?: never;
1576
1741
  delete?: never;
1577
1742
  options?: never;
1578
1743
  head?: never;
1579
1744
  patch?: never;
1580
1745
  trace?: never;
1581
1746
  };
1582
- "/v1/api/workspaces/{workspaceId}/runs/{runId}/checkpoints": {
1747
+ "/v1/api/workspaces/{workspaceId}/runs/{runId}/checkpoints/{checkpointId}": {
1583
1748
  parameters: {
1584
1749
  query?: never;
1585
1750
  header?: never;
1586
1751
  path?: never;
1587
1752
  cookie?: never;
1588
1753
  };
1589
- /** List checkpoints for a run as a tree structure. */
1754
+ /** Get checkpoint details. */
1590
1755
  get: {
1591
1756
  parameters: {
1592
1757
  query?: never;
@@ -1594,6 +1759,7 @@ export interface paths {
1594
1759
  path: {
1595
1760
  workspaceId: string;
1596
1761
  runId: string;
1762
+ checkpointId: string;
1597
1763
  };
1598
1764
  cookie?: never;
1599
1765
  };
@@ -1605,7 +1771,7 @@ export interface paths {
1605
1771
  [name: string]: unknown;
1606
1772
  };
1607
1773
  content: {
1608
- "application/json": components["schemas"]["CheckpointListResponse"];
1774
+ "application/json": components["schemas"]["CheckpointDetail"];
1609
1775
  };
1610
1776
  };
1611
1777
  /** @description Not Found */
@@ -1620,7 +1786,23 @@ export interface paths {
1620
1786
  };
1621
1787
  };
1622
1788
  put?: never;
1623
- /** Create a checkpoint for a run (called by kernel callbacks). */
1789
+ post?: never;
1790
+ delete?: never;
1791
+ options?: never;
1792
+ head?: never;
1793
+ patch?: never;
1794
+ trace?: never;
1795
+ };
1796
+ "/v1/api/workspaces/{workspaceId}/runs/{runId}/checkpoints/{checkpointId}/replay": {
1797
+ parameters: {
1798
+ query?: never;
1799
+ header?: never;
1800
+ path?: never;
1801
+ cookie?: never;
1802
+ };
1803
+ get?: never;
1804
+ put?: never;
1805
+ /** Replay from a checkpoint, creating a new run. */
1624
1806
  post: {
1625
1807
  parameters: {
1626
1808
  query?: never;
@@ -1628,14 +1810,15 @@ export interface paths {
1628
1810
  path: {
1629
1811
  workspaceId: string;
1630
1812
  runId: string;
1813
+ checkpointId: string;
1631
1814
  };
1632
1815
  cookie?: never;
1633
1816
  };
1634
1817
  requestBody?: {
1635
1818
  content: {
1636
- "application/json": components["schemas"]["CreateCheckpointRequest"];
1637
- "text/json": components["schemas"]["CreateCheckpointRequest"];
1638
- "application/*+json": components["schemas"]["CreateCheckpointRequest"];
1819
+ "application/json": components["schemas"]["ReplayRequest"];
1820
+ "text/json": components["schemas"]["ReplayRequest"];
1821
+ "application/*+json": components["schemas"]["ReplayRequest"];
1639
1822
  };
1640
1823
  };
1641
1824
  responses: {
@@ -1645,7 +1828,16 @@ export interface paths {
1645
1828
  [name: string]: unknown;
1646
1829
  };
1647
1830
  content: {
1648
- "application/json": components["schemas"]["CheckpointDetail"];
1831
+ "application/json": components["schemas"]["ReplayResponse"];
1832
+ };
1833
+ };
1834
+ /** @description Not Found */
1835
+ 404: {
1836
+ headers: {
1837
+ [name: string]: unknown;
1838
+ };
1839
+ content: {
1840
+ "application/json": components["schemas"]["ProblemDetails"];
1649
1841
  };
1650
1842
  };
1651
1843
  };
@@ -1656,23 +1848,18 @@ export interface paths {
1656
1848
  patch?: never;
1657
1849
  trace?: never;
1658
1850
  };
1659
- "/v1/api/workspaces/{workspaceId}/runs/{runId}/checkpoints/{checkpointId}": {
1851
+ "/v1/api/contracts/supported": {
1660
1852
  parameters: {
1661
1853
  query?: never;
1662
1854
  header?: never;
1663
1855
  path?: never;
1664
1856
  cookie?: never;
1665
1857
  };
1666
- /** Get checkpoint details. */
1667
1858
  get: {
1668
1859
  parameters: {
1669
1860
  query?: never;
1670
1861
  header?: never;
1671
- path: {
1672
- workspaceId: string;
1673
- runId: string;
1674
- checkpointId: string;
1675
- };
1862
+ path?: never;
1676
1863
  cookie?: never;
1677
1864
  };
1678
1865
  requestBody?: never;
@@ -1683,17 +1870,22 @@ export interface paths {
1683
1870
  [name: string]: unknown;
1684
1871
  };
1685
1872
  content: {
1686
- "application/json": components["schemas"]["CheckpointDetail"];
1873
+ "application/json": components["schemas"]["SupportedContractsResponse"];
1687
1874
  };
1688
1875
  };
1689
- /** @description Not Found */
1690
- 404: {
1876
+ /** @description Internal Server Error */
1877
+ 500: {
1691
1878
  headers: {
1692
1879
  [name: string]: unknown;
1693
1880
  };
1694
- content: {
1695
- "application/json": components["schemas"]["ProblemDetails"];
1881
+ content?: never;
1882
+ };
1883
+ /** @description Service Unavailable */
1884
+ 503: {
1885
+ headers: {
1886
+ [name: string]: unknown;
1696
1887
  };
1888
+ content?: never;
1697
1889
  };
1698
1890
  };
1699
1891
  };
@@ -1705,7 +1897,7 @@ export interface paths {
1705
1897
  patch?: never;
1706
1898
  trace?: never;
1707
1899
  };
1708
- "/v1/api/workspaces/{workspaceId}/runs/{runId}/checkpoints/{checkpointId}/replay": {
1900
+ "/v1/api/contracts/validate": {
1709
1901
  parameters: {
1710
1902
  query?: never;
1711
1903
  header?: never;
@@ -1714,37 +1906,96 @@ export interface paths {
1714
1906
  };
1715
1907
  get?: never;
1716
1908
  put?: never;
1717
- /** Replay from a checkpoint, creating a new run. */
1718
1909
  post: {
1719
1910
  parameters: {
1720
1911
  query?: never;
1721
1912
  header?: never;
1722
- path: {
1723
- workspaceId: string;
1724
- runId: string;
1725
- checkpointId: string;
1913
+ path?: never;
1914
+ cookie?: never;
1915
+ };
1916
+ requestBody?: {
1917
+ content: {
1918
+ "application/json": components["schemas"]["ValidateContractRequest"];
1919
+ "text/json": components["schemas"]["ValidateContractRequest"];
1920
+ "application/*+json": components["schemas"]["ValidateContractRequest"];
1921
+ };
1922
+ };
1923
+ responses: {
1924
+ /** @description OK */
1925
+ 200: {
1926
+ headers: {
1927
+ [name: string]: unknown;
1928
+ };
1929
+ content: {
1930
+ "application/json": components["schemas"]["ValidateContractResponse"];
1931
+ };
1932
+ };
1933
+ /** @description Bad Request */
1934
+ 400: {
1935
+ headers: {
1936
+ [name: string]: unknown;
1937
+ };
1938
+ content: {
1939
+ "application/json": components["schemas"]["ProblemDetails"];
1940
+ };
1941
+ };
1942
+ /** @description Internal Server Error */
1943
+ 500: {
1944
+ headers: {
1945
+ [name: string]: unknown;
1946
+ };
1947
+ content?: never;
1948
+ };
1949
+ /** @description Service Unavailable */
1950
+ 503: {
1951
+ headers: {
1952
+ [name: string]: unknown;
1953
+ };
1954
+ content?: never;
1726
1955
  };
1956
+ };
1957
+ };
1958
+ delete?: never;
1959
+ options?: never;
1960
+ head?: never;
1961
+ patch?: never;
1962
+ trace?: never;
1963
+ };
1964
+ "/v1/api/contracts/compile/runtime-package": {
1965
+ parameters: {
1966
+ query?: never;
1967
+ header?: never;
1968
+ path?: never;
1969
+ cookie?: never;
1970
+ };
1971
+ get?: never;
1972
+ put?: never;
1973
+ post: {
1974
+ parameters: {
1975
+ query?: never;
1976
+ header?: never;
1977
+ path?: never;
1727
1978
  cookie?: never;
1728
1979
  };
1729
1980
  requestBody?: {
1730
1981
  content: {
1731
- "application/json": components["schemas"]["ReplayRequest"];
1732
- "text/json": components["schemas"]["ReplayRequest"];
1733
- "application/*+json": components["schemas"]["ReplayRequest"];
1982
+ "application/json": components["schemas"]["CompileRuntimePackageRequest"];
1983
+ "text/json": components["schemas"]["CompileRuntimePackageRequest"];
1984
+ "application/*+json": components["schemas"]["CompileRuntimePackageRequest"];
1734
1985
  };
1735
1986
  };
1736
1987
  responses: {
1737
- /** @description Created */
1738
- 201: {
1988
+ /** @description OK */
1989
+ 200: {
1739
1990
  headers: {
1740
1991
  [name: string]: unknown;
1741
1992
  };
1742
1993
  content: {
1743
- "application/json": components["schemas"]["ReplayResponse"];
1994
+ "application/json": components["schemas"]["CompileRuntimePackageResponse"];
1744
1995
  };
1745
1996
  };
1746
- /** @description Not Found */
1747
- 404: {
1997
+ /** @description Bad Request */
1998
+ 400: {
1748
1999
  headers: {
1749
2000
  [name: string]: unknown;
1750
2001
  };
@@ -1752,6 +2003,20 @@ export interface paths {
1752
2003
  "application/json": components["schemas"]["ProblemDetails"];
1753
2004
  };
1754
2005
  };
2006
+ /** @description Internal Server Error */
2007
+ 500: {
2008
+ headers: {
2009
+ [name: string]: unknown;
2010
+ };
2011
+ content?: never;
2012
+ };
2013
+ /** @description Service Unavailable */
2014
+ 503: {
2015
+ headers: {
2016
+ [name: string]: unknown;
2017
+ };
2018
+ content?: never;
2019
+ };
1755
2020
  };
1756
2021
  };
1757
2022
  delete?: never;
@@ -3104,374 +3369,40 @@ export interface paths {
3104
3369
  };
3105
3370
  requestBody?: never;
3106
3371
  responses: {
3107
- /** @description OK */
3108
- 200: {
3109
- headers: {
3110
- [name: string]: unknown;
3111
- };
3112
- content: {
3113
- "application/json": components["schemas"]["FileListItem"][];
3114
- };
3115
- };
3116
- };
3117
- };
3118
- put?: never;
3119
- post?: never;
3120
- delete?: never;
3121
- options?: never;
3122
- head?: never;
3123
- patch?: never;
3124
- trace?: never;
3125
- };
3126
- "/v1/api/workspaces/{workspaceId}/files/{fileId}": {
3127
- parameters: {
3128
- query?: never;
3129
- header?: never;
3130
- path?: never;
3131
- cookie?: never;
3132
- };
3133
- /** Get file metadata. */
3134
- get: {
3135
- parameters: {
3136
- query?: never;
3137
- header?: never;
3138
- path: {
3139
- workspaceId: string;
3140
- fileId: string;
3141
- };
3142
- cookie?: never;
3143
- };
3144
- requestBody?: never;
3145
- responses: {
3146
- /** @description OK */
3147
- 200: {
3148
- headers: {
3149
- [name: string]: unknown;
3150
- };
3151
- content: {
3152
- "application/json": components["schemas"]["FileDetail"];
3153
- };
3154
- };
3155
- /** @description Not Found */
3156
- 404: {
3157
- headers: {
3158
- [name: string]: unknown;
3159
- };
3160
- content: {
3161
- "application/json": components["schemas"]["ProblemDetails"];
3162
- };
3163
- };
3164
- };
3165
- };
3166
- put?: never;
3167
- post?: never;
3168
- /** Soft delete a file. */
3169
- delete: {
3170
- parameters: {
3171
- query?: never;
3172
- header?: never;
3173
- path: {
3174
- workspaceId: string;
3175
- fileId: string;
3176
- };
3177
- cookie?: never;
3178
- };
3179
- requestBody?: never;
3180
- responses: {
3181
- /** @description No Content */
3182
- 204: {
3183
- headers: {
3184
- [name: string]: unknown;
3185
- };
3186
- content?: never;
3187
- };
3188
- /** @description Not Found */
3189
- 404: {
3190
- headers: {
3191
- [name: string]: unknown;
3192
- };
3193
- content: {
3194
- "application/json": components["schemas"]["ProblemDetails"];
3195
- };
3196
- };
3197
- };
3198
- };
3199
- options?: never;
3200
- head?: never;
3201
- patch?: never;
3202
- trace?: never;
3203
- };
3204
- "/v1/api/observability/frontend-log": {
3205
- parameters: {
3206
- query?: never;
3207
- header?: never;
3208
- path?: never;
3209
- cookie?: never;
3210
- };
3211
- get?: never;
3212
- put?: never;
3213
- post: {
3214
- parameters: {
3215
- query?: never;
3216
- header?: never;
3217
- path?: never;
3218
- cookie?: never;
3219
- };
3220
- requestBody?: {
3221
- content: {
3222
- "application/json": components["schemas"]["FrontendLogIngestRequest"];
3223
- };
3224
- };
3225
- responses: {
3226
- /** @description OK */
3227
- 200: {
3228
- headers: {
3229
- [name: string]: unknown;
3230
- };
3231
- content?: never;
3232
- };
3233
- };
3234
- };
3235
- delete?: never;
3236
- options?: never;
3237
- head?: never;
3238
- patch?: never;
3239
- trace?: never;
3240
- };
3241
- "/v1/api/graphs/validate": {
3242
- parameters: {
3243
- query?: never;
3244
- header?: never;
3245
- path?: never;
3246
- cookie?: never;
3247
- };
3248
- get?: never;
3249
- put?: never;
3250
- /**
3251
- * Validate graph structure without compiling.
3252
- * @description Does NOT require LLM credentials - only validates nodes/edges structure.
3253
- * Returns Mermaid diagram if valid, or detailed errors if invalid.
3254
- * Use this endpoint for real-time graph builder validation.
3255
- */
3256
- post: {
3257
- parameters: {
3258
- query?: never;
3259
- header?: never;
3260
- path?: never;
3261
- cookie?: never;
3262
- };
3263
- requestBody?: {
3264
- content: {
3265
- "application/json": components["schemas"]["ValidateGraphRequest"];
3266
- "text/json": components["schemas"]["ValidateGraphRequest"];
3267
- "application/*+json": components["schemas"]["ValidateGraphRequest"];
3268
- };
3269
- };
3270
- responses: {
3271
- /** @description OK */
3272
- 200: {
3273
- headers: {
3274
- [name: string]: unknown;
3275
- };
3276
- content: {
3277
- "application/json": components["schemas"]["ValidateGraphResponse"];
3278
- };
3279
- };
3280
- /** @description Bad Request */
3281
- 400: {
3282
- headers: {
3283
- [name: string]: unknown;
3284
- };
3285
- content: {
3286
- "application/json": components["schemas"]["ProblemDetails"];
3287
- };
3288
- };
3289
- /** @description Internal Server Error */
3290
- 500: {
3291
- headers: {
3292
- [name: string]: unknown;
3293
- };
3294
- content?: never;
3295
- };
3296
- /** @description Service Unavailable */
3297
- 503: {
3298
- headers: {
3299
- [name: string]: unknown;
3300
- };
3301
- content?: never;
3302
- };
3303
- };
3304
- };
3305
- delete?: never;
3306
- options?: never;
3307
- head?: never;
3308
- patch?: never;
3309
- trace?: never;
3310
- };
3311
- "/v1/api/graphs/introspect": {
3312
- parameters: {
3313
- query?: never;
3314
- header?: never;
3315
- path?: never;
3316
- cookie?: never;
3317
- };
3318
- get?: never;
3319
- put?: never;
3320
- /**
3321
- * Introspect a graph_spec with credentials and return its Mermaid diagram.
3322
- * @description Requires LLM credentials for compilation.
3323
- * Use this endpoint when you need the actual LangGraph compiled structure.
3324
- */
3325
- post: {
3326
- parameters: {
3327
- query?: never;
3328
- header?: never;
3329
- path?: never;
3330
- cookie?: never;
3331
- };
3332
- requestBody?: {
3333
- content: {
3334
- "application/json": components["schemas"]["IntrospectGraphRequest"];
3335
- "text/json": components["schemas"]["IntrospectGraphRequest"];
3336
- "application/*+json": components["schemas"]["IntrospectGraphRequest"];
3337
- };
3338
- };
3339
- responses: {
3340
- /** @description OK */
3341
- 200: {
3342
- headers: {
3343
- [name: string]: unknown;
3344
- };
3345
- content?: never;
3346
- };
3347
- };
3348
- };
3349
- delete?: never;
3350
- options?: never;
3351
- head?: never;
3352
- patch?: never;
3353
- trace?: never;
3354
- };
3355
- "/v1/api/graph/commit": {
3356
- parameters: {
3357
- query?: never;
3358
- header?: never;
3359
- path?: never;
3360
- cookie?: never;
3361
- };
3362
- get?: never;
3363
- put?: never;
3364
- /**
3365
- * Commit GraphSpec — atomic, idempotent, validated.
3366
- * @description **Flow:**
3367
- * 1. Validate spec_version (reject unsupported)
3368
- * 2. Verify agent exists in workspace
3369
- * 3. Check optimistic concurrency (expected_revision)
3370
- * 4. Call DataPlane to validate/normalize
3371
- * 5. Canonicalize JSON for deterministic hashing
3372
- * 6. Idempotence: if revision unchanged, return no_change
3373
- * 7. Persist with atomic check
3374
- * 8. Return canonical spec + new revision
3375
- *
3376
- * **Status Codes:**
3377
- * - 200: Success (includes no_change case)
3378
- * - 400: Missing workspace
3379
- * - 404: Agent not found
3380
- * - 409: Revision mismatch (concurrent edit)
3381
- * - 422: Validation failed / unsupported spec version
3382
- * - 502: DataPlane unreachable
3383
- */
3384
- post: {
3385
- parameters: {
3386
- query?: never;
3387
- header?: never;
3388
- path?: never;
3389
- cookie?: never;
3390
- };
3391
- requestBody?: {
3392
- content: {
3393
- "application/json": components["schemas"]["CommitGraphSpecRequest"];
3394
- "text/json": components["schemas"]["CommitGraphSpecRequest"];
3395
- "application/*+json": components["schemas"]["CommitGraphSpecRequest"];
3396
- };
3397
- };
3398
- responses: {
3399
- /** @description OK */
3400
- 200: {
3401
- headers: {
3402
- [name: string]: unknown;
3403
- };
3404
- content: {
3405
- "application/json": components["schemas"]["CommitGraphSpecResponseApiEnvelope"];
3406
- };
3407
- };
3408
- /** @description Bad Request */
3409
- 400: {
3410
- headers: {
3411
- [name: string]: unknown;
3412
- };
3413
- content: {
3414
- "application/json": components["schemas"]["ProblemDetails"];
3415
- };
3416
- };
3417
- /** @description Not Found */
3418
- 404: {
3419
- headers: {
3420
- [name: string]: unknown;
3421
- };
3422
- content: {
3423
- "application/json": components["schemas"]["ProblemDetails"];
3424
- };
3425
- };
3426
- /** @description Conflict */
3427
- 409: {
3428
- headers: {
3429
- [name: string]: unknown;
3430
- };
3431
- content: {
3432
- "application/json": components["schemas"]["ProblemDetails"];
3433
- };
3434
- };
3435
- /** @description Unprocessable Content */
3436
- 422: {
3437
- headers: {
3438
- [name: string]: unknown;
3439
- };
3440
- content: {
3441
- "application/json": components["schemas"]["ProblemDetails"];
3442
- };
3443
- };
3444
- /** @description Bad Gateway */
3445
- 502: {
3372
+ /** @description OK */
3373
+ 200: {
3446
3374
  headers: {
3447
3375
  [name: string]: unknown;
3448
3376
  };
3449
3377
  content: {
3450
- "application/json": components["schemas"]["ProblemDetails"];
3378
+ "application/json": components["schemas"]["FileListItem"][];
3451
3379
  };
3452
3380
  };
3453
3381
  };
3454
3382
  };
3383
+ put?: never;
3384
+ post?: never;
3455
3385
  delete?: never;
3456
3386
  options?: never;
3457
3387
  head?: never;
3458
3388
  patch?: never;
3459
3389
  trace?: never;
3460
3390
  };
3461
- "/v1/api/graph/{agentId}": {
3391
+ "/v1/api/workspaces/{workspaceId}/files/{fileId}": {
3462
3392
  parameters: {
3463
3393
  query?: never;
3464
3394
  header?: never;
3465
3395
  path?: never;
3466
3396
  cookie?: never;
3467
3397
  };
3468
- /** Get current graph spec with revision. */
3398
+ /** Get file metadata. */
3469
3399
  get: {
3470
3400
  parameters: {
3471
3401
  query?: never;
3472
3402
  header?: never;
3473
3403
  path: {
3474
- agentId: string;
3404
+ workspaceId: string;
3405
+ fileId: string;
3475
3406
  };
3476
3407
  cookie?: never;
3477
3408
  };
@@ -3483,16 +3414,7 @@ export interface paths {
3483
3414
  [name: string]: unknown;
3484
3415
  };
3485
3416
  content: {
3486
- "application/json": components["schemas"]["GetGraphSpecResponseApiEnvelope"];
3487
- };
3488
- };
3489
- /** @description Bad Request */
3490
- 400: {
3491
- headers: {
3492
- [name: string]: unknown;
3493
- };
3494
- content: {
3495
- "application/json": components["schemas"]["ProblemDetails"];
3417
+ "application/json": components["schemas"]["FileDetail"];
3496
3418
  };
3497
3419
  };
3498
3420
  /** @description Not Found */
@@ -3504,57 +3426,32 @@ export interface paths {
3504
3426
  "application/json": components["schemas"]["ProblemDetails"];
3505
3427
  };
3506
3428
  };
3507
- /** @description Internal Server Error */
3508
- 500: {
3509
- headers: {
3510
- [name: string]: unknown;
3511
- };
3512
- content: {
3513
- "application/json": components["schemas"]["ProblemDetails"];
3514
- };
3515
- };
3516
3429
  };
3517
3430
  };
3518
3431
  put?: never;
3519
3432
  post?: never;
3520
- delete?: never;
3521
- options?: never;
3522
- head?: never;
3523
- patch?: never;
3524
- trace?: never;
3525
- };
3526
- "/v1/api/graph/{agentId}/revisions": {
3527
- parameters: {
3528
- query?: never;
3529
- header?: never;
3530
- path?: never;
3531
- cookie?: never;
3532
- };
3533
- /** List revision history for an agent (metadata only, not full spec). */
3534
- get: {
3433
+ /** Soft delete a file. */
3434
+ delete: {
3535
3435
  parameters: {
3536
- query?: {
3537
- limit?: number;
3538
- };
3436
+ query?: never;
3539
3437
  header?: never;
3540
3438
  path: {
3541
- agentId: string;
3439
+ workspaceId: string;
3440
+ fileId: string;
3542
3441
  };
3543
3442
  cookie?: never;
3544
3443
  };
3545
3444
  requestBody?: never;
3546
3445
  responses: {
3547
- /** @description OK */
3548
- 200: {
3446
+ /** @description No Content */
3447
+ 204: {
3549
3448
  headers: {
3550
3449
  [name: string]: unknown;
3551
3450
  };
3552
- content: {
3553
- "application/json": components["schemas"]["RevisionListResponseApiEnvelope"];
3554
- };
3451
+ content?: never;
3555
3452
  };
3556
- /** @description Bad Request */
3557
- 400: {
3453
+ /** @description Not Found */
3454
+ 404: {
3558
3455
  headers: {
3559
3456
  [name: string]: unknown;
3560
3457
  };
@@ -3564,56 +3461,42 @@ export interface paths {
3564
3461
  };
3565
3462
  };
3566
3463
  };
3567
- put?: never;
3568
- post?: never;
3569
- delete?: never;
3570
3464
  options?: never;
3571
3465
  head?: never;
3572
3466
  patch?: never;
3573
3467
  trace?: never;
3574
3468
  };
3575
- "/v1/api/graph/{agentId}/revisions/{revision}": {
3469
+ "/v1/api/observability/frontend-log": {
3576
3470
  parameters: {
3577
3471
  query?: never;
3578
3472
  header?: never;
3579
3473
  path?: never;
3580
3474
  cookie?: never;
3581
3475
  };
3582
- /** Get a specific revision with full graph spec. */
3583
- get: {
3476
+ get?: never;
3477
+ put?: never;
3478
+ post: {
3584
3479
  parameters: {
3585
3480
  query?: never;
3586
3481
  header?: never;
3587
- path: {
3588
- agentId: string;
3589
- revision: string;
3590
- };
3482
+ path?: never;
3591
3483
  cookie?: never;
3592
3484
  };
3593
- requestBody?: never;
3485
+ requestBody?: {
3486
+ content: {
3487
+ "application/json": components["schemas"]["FrontendLogIngestRequest"];
3488
+ };
3489
+ };
3594
3490
  responses: {
3595
3491
  /** @description OK */
3596
3492
  200: {
3597
3493
  headers: {
3598
3494
  [name: string]: unknown;
3599
3495
  };
3600
- content: {
3601
- "application/json": components["schemas"]["RevisionDetailResponseApiEnvelope"];
3602
- };
3603
- };
3604
- /** @description Not Found */
3605
- 404: {
3606
- headers: {
3607
- [name: string]: unknown;
3608
- };
3609
- content: {
3610
- "application/json": components["schemas"]["ProblemDetails"];
3611
- };
3496
+ content?: never;
3612
3497
  };
3613
3498
  };
3614
3499
  };
3615
- put?: never;
3616
- post?: never;
3617
3500
  delete?: never;
3618
3501
  options?: never;
3619
3502
  head?: never;
@@ -4088,46 +3971,6 @@ export interface paths {
4088
3971
  patch?: never;
4089
3972
  trace?: never;
4090
3973
  };
4091
- "/v1/api/playground/dry-run": {
4092
- parameters: {
4093
- query?: never;
4094
- header?: never;
4095
- path?: never;
4096
- cookie?: never;
4097
- };
4098
- get?: never;
4099
- put?: never;
4100
- /** Dry run - compile and validate only, no execution. */
4101
- post: {
4102
- parameters: {
4103
- query?: never;
4104
- header?: never;
4105
- path?: never;
4106
- cookie?: never;
4107
- };
4108
- requestBody?: {
4109
- content: {
4110
- "application/json": components["schemas"]["DryRunRequest"];
4111
- "text/json": components["schemas"]["DryRunRequest"];
4112
- "application/*+json": components["schemas"]["DryRunRequest"];
4113
- };
4114
- };
4115
- responses: {
4116
- /** @description OK */
4117
- 200: {
4118
- headers: {
4119
- [name: string]: unknown;
4120
- };
4121
- content?: never;
4122
- };
4123
- };
4124
- };
4125
- delete?: never;
4126
- options?: never;
4127
- head?: never;
4128
- patch?: never;
4129
- trace?: never;
4130
- };
4131
3974
  "/v1/api/prompts": {
4132
3975
  parameters: {
4133
3976
  query?: never;
@@ -7657,8 +7500,8 @@ export interface paths {
7657
7500
  * The store is ready to accept file attachments immediately after creation.
7658
7501
  *
7659
7502
  * **Default Configuration:**
7660
- * - Provider: `openai`
7661
- * - Model: `text-embedding-3-small`
7503
+ * - Provider: `google_ai`
7504
+ * - Model: `gemini-embedding-001`
7662
7505
  * - Dimension: `1536`
7663
7506
  */
7664
7507
  post: {
@@ -8086,6 +7929,43 @@ export interface paths {
8086
7929
  patch?: never;
8087
7930
  trace?: never;
8088
7931
  };
7932
+ "/v1/api/workspaces/events/stream": {
7933
+ parameters: {
7934
+ query?: never;
7935
+ header?: never;
7936
+ path?: never;
7937
+ cookie?: never;
7938
+ };
7939
+ /**
7940
+ * Stream workspace events via SSE.
7941
+ * Workspace is resolved from X-Workspace-Id header (standard auth flow).
7942
+ */
7943
+ get: {
7944
+ parameters: {
7945
+ query?: never;
7946
+ header?: never;
7947
+ path?: never;
7948
+ cookie?: never;
7949
+ };
7950
+ requestBody?: never;
7951
+ responses: {
7952
+ /** @description OK */
7953
+ 200: {
7954
+ headers: {
7955
+ [name: string]: unknown;
7956
+ };
7957
+ content?: never;
7958
+ };
7959
+ };
7960
+ };
7961
+ put?: never;
7962
+ post?: never;
7963
+ delete?: never;
7964
+ options?: never;
7965
+ head?: never;
7966
+ patch?: never;
7967
+ trace?: never;
7968
+ };
8089
7969
  "/v1/api/workspaces": {
8090
7970
  parameters: {
8091
7971
  query?: never;
@@ -8363,19 +8243,20 @@ export interface components {
8363
8243
  /** Format: date-time */
8364
8244
  created_at?: string;
8365
8245
  };
8366
- AgentDraftResponse: {
8246
+ AgentDraftIrResponse: {
8367
8247
  /** Format: uuid */
8368
8248
  id?: string;
8369
8249
  name?: string | null;
8370
- draft_graph_revision?: string | null;
8250
+ draft_ir_revision?: string | null;
8371
8251
  /** Format: date-time */
8372
8252
  draft_updated_at?: string | null;
8373
8253
  /** Format: uuid */
8374
8254
  live_bundle_id?: string | null;
8375
8255
  e_tag?: string | null;
8256
+ ir_json?: unknown;
8376
8257
  };
8377
- AgentDraftResponseApiEnvelope: {
8378
- data?: components["schemas"]["AgentDraftResponse"];
8258
+ AgentDraftIrResponseApiEnvelope: {
8259
+ data?: components["schemas"]["AgentDraftIrResponse"];
8379
8260
  hints?: components["schemas"]["ApiHint"][] | null;
8380
8261
  };
8381
8262
  AgentExportAgent: {
@@ -8454,16 +8335,6 @@ export interface components {
8454
8335
  member_id?: string;
8455
8336
  role_name?: string | null;
8456
8337
  };
8457
- /**
8458
- * @description KERNEL P0: Request DTO for builder chat.
8459
- * Contains ONLY intention fields. No graph_spec, no catalogs.
8460
- */
8461
- BuilderChatRequest: {
8462
- message?: string | null;
8463
- thread_id?: string | null;
8464
- history?: components["schemas"]["ChatHistoryMessage"][] | null;
8465
- base_graph_etag?: string | null;
8466
- };
8467
8338
  BundleResponse: {
8468
8339
  /** Format: uuid */
8469
8340
  id?: string;
@@ -8497,10 +8368,6 @@ export interface components {
8497
8368
  * @enum {integer}
8498
8369
  */
8499
8370
  Channel: 0 | 1 | 2 | 3 | 4;
8500
- ChatHistoryMessage: {
8501
- role?: string | null;
8502
- content?: string | null;
8503
- };
8504
8371
  CheckpointDetail: {
8505
8372
  /** Format: uuid */
8506
8373
  id?: string;
@@ -8510,6 +8377,7 @@ export interface components {
8510
8377
  thread_id?: string;
8511
8378
  step_name?: string | null;
8512
8379
  checkpoint_id?: string | null;
8380
+ /** Format: uuid */
8513
8381
  parent_checkpoint_id?: string | null;
8514
8382
  has_state_snapshot?: boolean;
8515
8383
  /** Format: date-time */
@@ -8543,37 +8411,23 @@ export interface components {
8543
8411
  id?: string;
8544
8412
  step_name?: string | null;
8545
8413
  checkpoint_id?: string | null;
8414
+ /** Format: uuid */
8546
8415
  parent_checkpoint_id?: string | null;
8547
8416
  /** Format: date-time */
8548
8417
  created_at?: string;
8549
8418
  children?: components["schemas"]["CheckpointNode"][] | null;
8550
8419
  };
8551
- CommitGraphSpecRequest: {
8552
- spec_version?: string | null;
8553
- /** Format: uuid */
8554
- agent_id?: string;
8555
- graph_spec?: unknown;
8556
- expected_revision?: string | null;
8557
- /** @description Source of the commit: ui.dragdrop, ui.json, meta_builder, system */
8558
- source?: string | null;
8559
- };
8560
- CommitGraphSpecResponse: {
8561
- /** @description Explicit status: committed, no_change, conflict */
8562
- status?: string | null;
8563
- /** Format: uuid */
8564
- agent_id?: string;
8565
- revision?: string | null;
8566
- /** @description Only present in conflict response (409 body). */
8567
- current_revision?: string | null;
8568
- canonical_spec?: unknown;
8569
- /** Format: date-time */
8570
- committed_at?: string | null;
8571
- warnings?: components["schemas"]["ValidationMessage"][] | null;
8572
- validation?: components["schemas"]["ValidationResult"];
8420
+ CompileRuntimePackageRequest: {
8421
+ ir_spec?: unknown;
8422
+ capability_registry_spec?: unknown;
8423
+ policy_refs?: unknown;
8424
+ runtime_config_refs?: unknown;
8425
+ package_id?: string | null;
8426
+ metadata?: unknown;
8427
+ compiled_at?: string | null;
8573
8428
  };
8574
- CommitGraphSpecResponseApiEnvelope: {
8575
- data?: components["schemas"]["CommitGraphSpecResponse"];
8576
- hints?: components["schemas"]["ApiHint"][] | null;
8429
+ CompileRuntimePackageResponse: {
8430
+ package_spec?: unknown;
8577
8431
  };
8578
8432
  ConfirmUploadRequest: {
8579
8433
  sha256?: string | null;
@@ -8586,6 +8440,7 @@ export interface components {
8586
8440
  step_name?: string | null;
8587
8441
  checkpoint_ns?: string | null;
8588
8442
  checkpoint_id?: string | null;
8443
+ /** Format: uuid */
8589
8444
  parent_checkpoint_id?: string | null;
8590
8445
  };
8591
8446
  CreateCredentialRequest: {
@@ -8677,6 +8532,8 @@ export interface components {
8677
8532
  event_key?: string | null;
8678
8533
  /** Format: uuid */
8679
8534
  rerun_of_run_id?: string | null;
8535
+ /** Format: uuid */
8536
+ correlation_id?: string | null;
8680
8537
  };
8681
8538
  CreateTenantRequest: {
8682
8539
  name?: string | null;
@@ -8721,7 +8578,6 @@ export interface components {
8721
8578
  };
8722
8579
  CreateVectorStoreRequest: {
8723
8580
  name?: string | null;
8724
- embedding_provider?: string | null;
8725
8581
  embedding_model?: string | null;
8726
8582
  /** Format: int32 */
8727
8583
  dimension?: number | null;
@@ -8795,11 +8651,6 @@ export interface components {
8795
8651
  /** Format: date-time */
8796
8652
  updatedAt?: string;
8797
8653
  };
8798
- DryRunRequest: {
8799
- /** Format: uuid */
8800
- agent_id?: string;
8801
- graph_spec?: unknown;
8802
- };
8803
8654
  EnsureMembershipRequest: {
8804
8655
  /** Format: uuid */
8805
8656
  tenant_id?: string | null;
@@ -8882,20 +8733,6 @@ export interface components {
8882
8733
  [key: string]: unknown;
8883
8734
  } | null;
8884
8735
  };
8885
- GetGraphSpecResponse: {
8886
- /** Format: uuid */
8887
- agent_id?: string;
8888
- revision?: string | null;
8889
- canonical_spec?: unknown;
8890
- /** Format: date-time */
8891
- committed_at?: string | null;
8892
- warnings?: components["schemas"]["ValidationMessage"][] | null;
8893
- validation?: components["schemas"]["ValidationResult"];
8894
- };
8895
- GetGraphSpecResponseApiEnvelope: {
8896
- data?: components["schemas"]["GetGraphSpecResponse"];
8897
- hints?: components["schemas"]["ApiHint"][] | null;
8898
- };
8899
8736
  GrantAccessRequest: {
8900
8737
  /** Format: uuid */
8901
8738
  workspace_id?: string;
@@ -8911,17 +8748,6 @@ export interface components {
8911
8748
  paths?: components["schemas"]["PathInfoDto"][] | null;
8912
8749
  warnings?: string[] | null;
8913
8750
  };
8914
- IntrospectGraphRequest: {
8915
- graph_spec?: {
8916
- [key: string]: unknown;
8917
- } | null;
8918
- credentials?: {
8919
- [key: string]: unknown;
8920
- }[] | null;
8921
- catalog_versions?: {
8922
- [key: string]: string;
8923
- } | null;
8924
- };
8925
8751
  InviteMemberRequest: {
8926
8752
  /** Format: uuid */
8927
8753
  user_id?: string | null;
@@ -9089,7 +8915,6 @@ export interface components {
9089
8915
  };
9090
8916
  PublishAgentRequest: {
9091
8917
  version_label?: string | null;
9092
- graph_spec?: unknown;
9093
8918
  set_as_live?: boolean;
9094
8919
  required_tools?: string[] | null;
9095
8920
  tool_credential_bindings?: {
@@ -9143,41 +8968,6 @@ export interface components {
9143
8968
  /** Format: date-time */
9144
8969
  resumed_at?: string;
9145
8970
  };
9146
- RevisionDetailResponse: {
9147
- /** Format: uuid */
9148
- agent_id?: string;
9149
- revision?: string | null;
9150
- graph_spec?: unknown;
9151
- /** Format: date-time */
9152
- created_at?: string;
9153
- source?: string | null;
9154
- /** Format: uuid */
9155
- actor_user_id?: string | null;
9156
- warnings?: components["schemas"]["ValidationMessage"][] | null;
9157
- };
9158
- RevisionDetailResponseApiEnvelope: {
9159
- data?: components["schemas"]["RevisionDetailResponse"];
9160
- hints?: components["schemas"]["ApiHint"][] | null;
9161
- };
9162
- RevisionListItem: {
9163
- revision?: string | null;
9164
- /** Format: date-time */
9165
- created_at?: string;
9166
- source?: string | null;
9167
- /** Format: uuid */
9168
- actor_user_id?: string | null;
9169
- };
9170
- RevisionListResponse: {
9171
- /** Format: uuid */
9172
- agent_id?: string;
9173
- /** Format: int32 */
9174
- total?: number;
9175
- items?: components["schemas"]["RevisionListItem"][] | null;
9176
- };
9177
- RevisionListResponseApiEnvelope: {
9178
- data?: components["schemas"]["RevisionListResponse"];
9179
- hints?: components["schemas"]["ApiHint"][] | null;
9180
- };
9181
8971
  RoleContextDto: {
9182
8972
  /** Format: uuid */
9183
8973
  id?: string;
@@ -9231,6 +9021,12 @@ export interface components {
9231
9021
  /** Format: uuid */
9232
9022
  attempt_id?: string;
9233
9023
  payload?: unknown;
9024
+ /** Format: uuid */
9025
+ operation_id?: string;
9026
+ /** Format: uuid */
9027
+ parent_operation_id?: string | null;
9028
+ /** Format: uuid */
9029
+ root_operation_id?: string;
9234
9030
  truncated?: boolean;
9235
9031
  };
9236
9032
  RunEventsPollResponse: {
@@ -9342,6 +9138,9 @@ export interface components {
9342
9138
  /** Format: int32 */
9343
9139
  ttl_seconds?: number | null;
9344
9140
  };
9141
+ SupportedContractsResponse: {
9142
+ contract_ids?: string[] | null;
9143
+ };
9345
9144
  TenantContextDto: {
9346
9145
  /** Format: uuid */
9347
9146
  id?: string;
@@ -9518,8 +9317,8 @@ export interface components {
9518
9317
  /** Format: uuid */
9519
9318
  agentId?: string | null;
9520
9319
  };
9521
- UpdateDraftGraphRequest: {
9522
- graphJson?: unknown;
9320
+ UpdateDraftIrRequest: {
9321
+ ir_json?: unknown;
9523
9322
  };
9524
9323
  UpdateMemberRequest: {
9525
9324
  /** Format: uuid */
@@ -9545,6 +9344,29 @@ export interface components {
9545
9344
  UpdateWorkspaceRequest: {
9546
9345
  name?: string | null;
9547
9346
  };
9347
+ UpsertAgentCredentialBindingRequest: {
9348
+ /** Format: uuid */
9349
+ credential_id?: string;
9350
+ alias?: string | null;
9351
+ /** Format: int32 */
9352
+ priority?: number;
9353
+ };
9354
+ UpsertAgentCredentialBindingResponse: {
9355
+ /** Format: uuid */
9356
+ id?: string;
9357
+ updated?: boolean;
9358
+ /** Format: uuid */
9359
+ agent_id?: string;
9360
+ /** Format: uuid */
9361
+ credential_id?: string;
9362
+ alias?: string | null;
9363
+ /** Format: int32 */
9364
+ priority?: number;
9365
+ };
9366
+ UpsertAgentRuntimeContextRequest: {
9367
+ content?: string | null;
9368
+ source?: string | null;
9369
+ };
9548
9370
  UserContextResponse: {
9549
9371
  user?: components["schemas"]["UserIdentityDto"];
9550
9372
  memberships?: components["schemas"]["MembershipContextDto"][] | null;
@@ -9554,20 +9376,15 @@ export interface components {
9554
9376
  id?: string;
9555
9377
  email?: string | null;
9556
9378
  };
9557
- ValidateGraphRequest: {
9558
- graph_spec?: {
9559
- [key: string]: unknown;
9560
- } | null;
9561
- catalog_versions?: {
9562
- [key: string]: string;
9563
- } | null;
9379
+ ValidateContractRequest: {
9380
+ contract_id?: string | null;
9381
+ spec?: unknown;
9564
9382
  };
9565
- ValidateGraphResponse: {
9383
+ ValidateContractResponse: {
9384
+ contract_id?: string | null;
9566
9385
  valid?: boolean;
9567
- mermaid?: string | null;
9568
- nodes?: string[] | null;
9569
- edges?: string[][] | null;
9570
- errors?: components["schemas"]["ValidationError"][] | null;
9386
+ errors?: components["schemas"]["ValidationIssueDto"][] | null;
9387
+ warnings?: components["schemas"]["ValidationIssueDto"][] | null;
9571
9388
  };
9572
9389
  ValidateRequest: {
9573
9390
  tool_name?: string | null;
@@ -9577,29 +9394,12 @@ export interface components {
9577
9394
  raw_config?: unknown;
9578
9395
  test_mode?: boolean;
9579
9396
  };
9580
- /**
9581
- * @description Validation error from graph validation.
9582
- * Aligned with Data Plane validator output (RFC 6901 JSON Pointer paths).
9583
- */
9584
- ValidationError: {
9585
- code?: string | null;
9586
- message?: string | null;
9587
- path?: string | null;
9588
- node_id?: string | null;
9589
- severity?: string | null;
9590
- };
9591
- ValidationMessage: {
9397
+ ValidationIssueDto: {
9592
9398
  code?: string | null;
9593
9399
  message?: string | null;
9594
9400
  path?: string | null;
9595
- node_id?: string | null;
9596
9401
  severity?: string | null;
9597
9402
  };
9598
- /** @description Validation result block returned in all commit responses. */
9599
- ValidationResult: {
9600
- valid?: boolean;
9601
- errors?: components["schemas"]["ValidationMessage"][] | null;
9602
- };
9603
9403
  VectorQueryRequest: {
9604
9404
  query?: string | null;
9605
9405
  /** Format: int32 */