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