@agent-os-sdk/client 0.4.1 → 0.4.3

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.
@@ -51,7 +51,7 @@ export interface paths {
51
51
  path?: never;
52
52
  cookie?: never;
53
53
  };
54
- /** Export an agent with all its versions. */
54
+ /** Export an agent with all its bundles. */
55
55
  get: {
56
56
  parameters: {
57
57
  query?: never;
@@ -92,11 +92,12 @@ export interface paths {
92
92
  /**
93
93
  * Import an agent bundle.
94
94
  * @description Imports an agent bundle into the current tenant/workspace.
95
- * The agent and all versions are created with new IDs to avoid conflicts.
95
+ * The agent and all bundles are created with new IDs to avoid conflicts.
96
96
  *
97
97
  * **Security:**
98
98
  * - Tenant and workspace are resolved from the authenticated context
99
99
  * - Original IDs from the bundle are replaced with new GUIDs
100
+ * - LiveBundleId is preserved via ID mapping
100
101
  */
101
102
  post: {
102
103
  parameters: {
@@ -105,23 +106,22 @@ export interface paths {
105
106
  path?: never;
106
107
  cookie?: never;
107
108
  };
108
- /** @description The agent bundle to import. */
109
109
  requestBody?: {
110
110
  content: {
111
- "application/json": components["schemas"]["AgentBundle"];
112
- "text/json": components["schemas"]["AgentBundle"];
113
- "application/*+json": components["schemas"]["AgentBundle"];
111
+ "application/json": components["schemas"]["AgentExportBundle"];
112
+ "text/json": components["schemas"]["AgentExportBundle"];
113
+ "application/*+json": components["schemas"]["AgentExportBundle"];
114
114
  };
115
115
  };
116
116
  responses: {
117
- /** @description Agent imported successfully. */
117
+ /** @description Created */
118
118
  201: {
119
119
  headers: {
120
120
  [name: string]: unknown;
121
121
  };
122
122
  content?: never;
123
123
  };
124
- /** @description Invalid bundle format. */
124
+ /** @description Bad Request */
125
125
  400: {
126
126
  headers: {
127
127
  [name: string]: unknown;
@@ -130,7 +130,7 @@ export interface paths {
130
130
  "application/json": components["schemas"]["ProblemDetails"];
131
131
  };
132
132
  };
133
- /** @description Authentication required or missing workspace context. */
133
+ /** @description Unauthorized */
134
134
  401: {
135
135
  headers: {
136
136
  [name: string]: unknown;
@@ -524,387 +524,6 @@ export interface paths {
524
524
  patch?: never;
525
525
  trace?: never;
526
526
  };
527
- "/v1/api/agents/{agentId}/versions/{versionId}/manifest": {
528
- parameters: {
529
- query?: never;
530
- header?: never;
531
- path?: never;
532
- cookie?: never;
533
- };
534
- /** Get artifact manifest for a version. */
535
- get: {
536
- parameters: {
537
- query?: never;
538
- header?: never;
539
- path: {
540
- agentId: string;
541
- versionId: string;
542
- };
543
- cookie?: never;
544
- };
545
- requestBody?: never;
546
- responses: {
547
- /** @description OK */
548
- 200: {
549
- headers: {
550
- [name: string]: unknown;
551
- };
552
- content?: never;
553
- };
554
- };
555
- };
556
- put?: never;
557
- post?: never;
558
- delete?: never;
559
- options?: never;
560
- head?: never;
561
- patch?: never;
562
- trace?: never;
563
- };
564
- "/v1/api/agents/{agentId}/versions/{versionId}/graph/mermaid": {
565
- parameters: {
566
- query?: never;
567
- header?: never;
568
- path?: never;
569
- cookie?: never;
570
- };
571
- /** Get Mermaid diagram for graph. */
572
- get: {
573
- parameters: {
574
- query?: never;
575
- header?: never;
576
- path: {
577
- agentId: string;
578
- versionId: string;
579
- };
580
- cookie?: never;
581
- };
582
- requestBody?: never;
583
- responses: {
584
- /** @description OK */
585
- 200: {
586
- headers: {
587
- [name: string]: unknown;
588
- };
589
- content?: never;
590
- };
591
- };
592
- };
593
- put?: never;
594
- post?: never;
595
- delete?: never;
596
- options?: never;
597
- head?: never;
598
- patch?: never;
599
- trace?: never;
600
- };
601
- "/v1/api/agents/{agentId}/versions": {
602
- parameters: {
603
- query?: never;
604
- header?: never;
605
- path?: never;
606
- cookie?: never;
607
- };
608
- /**
609
- * Lists all versions for an agent.
610
- * @description Returns all versions of the specified agent, ordered by creation date (newest first).
611
- * The response includes which version is currently set as "live".
612
- */
613
- get: {
614
- parameters: {
615
- query?: never;
616
- header?: never;
617
- path: {
618
- /** @description The unique identifier of the agent. */
619
- agentId: string;
620
- };
621
- cookie?: never;
622
- };
623
- requestBody?: never;
624
- responses: {
625
- /** @description Returns the list of versions. */
626
- 200: {
627
- headers: {
628
- [name: string]: unknown;
629
- };
630
- content?: never;
631
- };
632
- /** @description Authentication required. */
633
- 401: {
634
- headers: {
635
- [name: string]: unknown;
636
- };
637
- content: {
638
- "application/json": components["schemas"]["ProblemDetails"];
639
- };
640
- };
641
- };
642
- };
643
- put?: never;
644
- /**
645
- * Creates a new version for an agent.
646
- * @description Creates an immutable snapshot of the agent's configuration. The new version
647
- * can optionally be marked as the live version immediately.
648
- *
649
- * **Example Request:**
650
- * ```json
651
- * {
652
- * "version_tag": "v1.2.0",
653
- * "graph_spec": { "nodes": [...], "edges": [...] },
654
- * "set_live": true
655
- * }
656
- * ```
657
- */
658
- post: {
659
- parameters: {
660
- query?: never;
661
- header?: never;
662
- path: {
663
- /** @description The unique identifier of the parent agent. */
664
- agentId: string;
665
- };
666
- cookie?: never;
667
- };
668
- /** @description The version creation request with graph specification. */
669
- requestBody?: {
670
- content: {
671
- "application/json": components["schemas"]["CreateAgentVersionRequest"];
672
- "text/json": components["schemas"]["CreateAgentVersionRequest"];
673
- "application/*+json": components["schemas"]["CreateAgentVersionRequest"];
674
- };
675
- };
676
- responses: {
677
- /** @description Version created successfully. */
678
- 201: {
679
- headers: {
680
- [name: string]: unknown;
681
- };
682
- content?: never;
683
- };
684
- /** @description Invalid request body or validation error. */
685
- 400: {
686
- headers: {
687
- [name: string]: unknown;
688
- };
689
- content: {
690
- "application/json": components["schemas"]["ProblemDetails"];
691
- };
692
- };
693
- /** @description Authentication required. */
694
- 401: {
695
- headers: {
696
- [name: string]: unknown;
697
- };
698
- content: {
699
- "application/json": components["schemas"]["ProblemDetails"];
700
- };
701
- };
702
- /** @description Parent agent not found. */
703
- 404: {
704
- headers: {
705
- [name: string]: unknown;
706
- };
707
- content: {
708
- "application/json": components["schemas"]["ProblemDetails"];
709
- };
710
- };
711
- };
712
- };
713
- delete?: never;
714
- options?: never;
715
- head?: never;
716
- patch?: never;
717
- trace?: never;
718
- };
719
- "/v1/api/agents/{agentId}/versions/{versionId}": {
720
- parameters: {
721
- query?: never;
722
- header?: never;
723
- path?: never;
724
- cookie?: never;
725
- };
726
- /**
727
- * Retrieves a specific version by its identifier.
728
- * @description Returns the full details of a specific agent version, including its
729
- * graph specification and all configuration settings.
730
- */
731
- get: {
732
- parameters: {
733
- query?: never;
734
- header?: never;
735
- path: {
736
- /** @description The unique identifier of the parent agent. */
737
- agentId: string;
738
- /** @description The unique identifier of the version to retrieve. */
739
- versionId: string;
740
- };
741
- cookie?: never;
742
- };
743
- requestBody?: never;
744
- responses: {
745
- /** @description Returns the version details. */
746
- 200: {
747
- headers: {
748
- [name: string]: unknown;
749
- };
750
- content?: never;
751
- };
752
- /** @description Authentication required. */
753
- 401: {
754
- headers: {
755
- [name: string]: unknown;
756
- };
757
- content: {
758
- "application/json": components["schemas"]["ProblemDetails"];
759
- };
760
- };
761
- /** @description Version not found. */
762
- 404: {
763
- headers: {
764
- [name: string]: unknown;
765
- };
766
- content: {
767
- "application/json": components["schemas"]["ProblemDetails"];
768
- };
769
- };
770
- };
771
- };
772
- put?: never;
773
- post?: never;
774
- delete?: never;
775
- options?: never;
776
- head?: never;
777
- /**
778
- * Updates are not allowed - versions are immutable.
779
- * @description Agent versions are immutable by design. This endpoint always returns a 409 Conflict
780
- * to enforce this invariant. To change an agent's behavior, create a new version instead.
781
- *
782
- * **Why immutability?**
783
- * - Reproducibility: Every run can be traced to an exact version
784
- * - Auditability: Version history provides a complete changelog
785
- * - Rollback: Easy to revert to any previous version
786
- */
787
- patch: {
788
- parameters: {
789
- query?: never;
790
- header?: never;
791
- path: {
792
- /** @description The unique identifier of the parent agent. */
793
- agentId: string;
794
- /** @description The unique identifier of the version. */
795
- versionId: string;
796
- };
797
- cookie?: never;
798
- };
799
- /** @description The update request (ignored - updates not allowed). */
800
- requestBody?: {
801
- content: {
802
- "application/json": unknown;
803
- "text/json": unknown;
804
- "application/*+json": unknown;
805
- };
806
- };
807
- responses: {
808
- /** @description Versions are immutable. Create a new version instead. */
809
- 409: {
810
- headers: {
811
- [name: string]: unknown;
812
- };
813
- content: {
814
- "application/json": components["schemas"]["ProblemDetails"];
815
- };
816
- };
817
- };
818
- };
819
- trace?: never;
820
- };
821
- "/v1/api/agents/{agentId}/versions/{versionId}/bundle": {
822
- parameters: {
823
- query?: never;
824
- header?: never;
825
- path?: never;
826
- cookie?: never;
827
- };
828
- /**
829
- * Gets the full execution bundle for a version including resolved graph_spec.
830
- * @description Returns the complete graph specification and metadata for a version.
831
- * The graph_spec is fully resolved - no need to fetch artifacts separately.
832
- *
833
- * **Caching:** Uses strong ETag based on artifact_hash for efficient caching.
834
- * Include `If-None-Match` header to get 304 Not Modified when content unchanged.
835
- *
836
- * **Example Response:**
837
- * ```json
838
- * {
839
- * "version": { "id": "...", "version_tag": "v1.2.0", ... },
840
- * "graph_spec": { "nodes": [...], "edges": [...] },
841
- * "artifact_hash": "a1b2c3...",
842
- * "format": "langgraph_json_v1",
843
- * "resolved_at": "2024-01-01T12:00:00Z"
844
- * }
845
- * ```
846
- */
847
- get: {
848
- parameters: {
849
- query?: never;
850
- header?: {
851
- /** @description Optional ETag for cache validation (304 support). */
852
- "If-None-Match"?: string;
853
- };
854
- path: {
855
- /** @description The unique identifier of the parent agent. */
856
- agentId: string;
857
- /** @description The unique identifier of the version to retrieve. */
858
- versionId: string;
859
- };
860
- cookie?: never;
861
- };
862
- requestBody?: never;
863
- responses: {
864
- /** @description Returns the full bundle. */
865
- 200: {
866
- headers: {
867
- [name: string]: unknown;
868
- };
869
- content: {
870
- "application/json": components["schemas"]["AgentVersionBundleResponse"];
871
- };
872
- };
873
- /** @description Content not modified (ETag matched). */
874
- 304: {
875
- headers: {
876
- [name: string]: unknown;
877
- };
878
- content?: never;
879
- };
880
- /** @description Authentication required. */
881
- 401: {
882
- headers: {
883
- [name: string]: unknown;
884
- };
885
- content: {
886
- "application/json": components["schemas"]["ProblemDetails"];
887
- };
888
- };
889
- /** @description Agent or version not found. */
890
- 404: {
891
- headers: {
892
- [name: string]: unknown;
893
- };
894
- content: {
895
- "application/json": components["schemas"]["ProblemDetails"];
896
- };
897
- };
898
- };
899
- };
900
- put?: never;
901
- post?: never;
902
- delete?: never;
903
- options?: never;
904
- head?: never;
905
- patch?: never;
906
- trace?: never;
907
- };
908
527
  "/v1/api/tokens": {
909
528
  parameters: {
910
529
  query?: never;
@@ -1320,6 +939,7 @@ export interface paths {
1320
939
  /**
1321
940
  * Chat with the Meta-Agent to modify an agent's graph.
1322
941
  * Returns SSE stream: message, graph_update, done events.
942
+ * @description KERNEL: Frontend sends intention only. CP loads everything from DB.
1323
943
  */
1324
944
  post: {
1325
945
  parameters: {
@@ -1395,6 +1015,80 @@ export interface paths {
1395
1015
  patch?: never;
1396
1016
  trace?: never;
1397
1017
  };
1018
+ "/v1/api/agents/{agentId}/bundles/{bundleId}/manifest": {
1019
+ parameters: {
1020
+ query?: never;
1021
+ header?: never;
1022
+ path?: never;
1023
+ cookie?: never;
1024
+ };
1025
+ /** Get artifact manifest for a bundle. */
1026
+ get: {
1027
+ parameters: {
1028
+ query?: never;
1029
+ header?: never;
1030
+ path: {
1031
+ agentId: string;
1032
+ bundleId: string;
1033
+ };
1034
+ cookie?: never;
1035
+ };
1036
+ requestBody?: never;
1037
+ responses: {
1038
+ /** @description OK */
1039
+ 200: {
1040
+ headers: {
1041
+ [name: string]: unknown;
1042
+ };
1043
+ content?: never;
1044
+ };
1045
+ };
1046
+ };
1047
+ put?: never;
1048
+ post?: never;
1049
+ delete?: never;
1050
+ options?: never;
1051
+ head?: never;
1052
+ patch?: never;
1053
+ trace?: never;
1054
+ };
1055
+ "/v1/api/agents/{agentId}/bundles/{bundleId}/graph/mermaid": {
1056
+ parameters: {
1057
+ query?: never;
1058
+ header?: never;
1059
+ path?: never;
1060
+ cookie?: never;
1061
+ };
1062
+ /** Get Mermaid diagram for graph. */
1063
+ get: {
1064
+ parameters: {
1065
+ query?: never;
1066
+ header?: never;
1067
+ path: {
1068
+ agentId: string;
1069
+ bundleId: string;
1070
+ };
1071
+ cookie?: never;
1072
+ };
1073
+ requestBody?: never;
1074
+ responses: {
1075
+ /** @description OK */
1076
+ 200: {
1077
+ headers: {
1078
+ [name: string]: unknown;
1079
+ };
1080
+ content?: never;
1081
+ };
1082
+ };
1083
+ };
1084
+ put?: never;
1085
+ post?: never;
1086
+ delete?: never;
1087
+ options?: never;
1088
+ head?: never;
1089
+ patch?: never;
1090
+ trace?: never;
1091
+ };
1398
1092
  "/v1/api/catalog/nodes": {
1399
1093
  parameters: {
1400
1094
  query?: never;
@@ -1402,11 +1096,12 @@ export interface paths {
1402
1096
  path?: never;
1403
1097
  cookie?: never;
1404
1098
  };
1405
- /** Get the Node Catalog (v1). */
1099
+ /** Get the Node Types Catalog. */
1406
1100
  get: {
1407
1101
  parameters: {
1408
1102
  query?: {
1409
- version?: string;
1103
+ /** @description API version (default: 1) */
1104
+ version?: number;
1410
1105
  };
1411
1106
  header?: never;
1412
1107
  path?: never;
@@ -1419,7 +1114,9 @@ export interface paths {
1419
1114
  headers: {
1420
1115
  [name: string]: unknown;
1421
1116
  };
1422
- content?: never;
1117
+ content: {
1118
+ "application/json": components["schemas"]["NodeCatalogResponse"];
1119
+ };
1423
1120
  };
1424
1121
  };
1425
1122
  };
@@ -1438,11 +1135,12 @@ export interface paths {
1438
1135
  path?: never;
1439
1136
  cookie?: never;
1440
1137
  };
1441
- /** Get the Trigger Templates Catalog (v1). */
1138
+ /** Get the Trigger Templates Catalog. */
1442
1139
  get: {
1443
1140
  parameters: {
1444
1141
  query?: {
1445
- version?: string;
1142
+ /** @description API version (default: 1) */
1143
+ version?: number;
1446
1144
  };
1447
1145
  header?: never;
1448
1146
  path?: never;
@@ -1455,7 +1153,48 @@ export interface paths {
1455
1153
  headers: {
1456
1154
  [name: string]: unknown;
1457
1155
  };
1458
- content?: never;
1156
+ content: {
1157
+ "application/json": components["schemas"]["TriggerTemplatesCatalogResponse"];
1158
+ };
1159
+ };
1160
+ };
1161
+ };
1162
+ put?: never;
1163
+ post?: never;
1164
+ delete?: never;
1165
+ options?: never;
1166
+ head?: never;
1167
+ patch?: never;
1168
+ trace?: never;
1169
+ };
1170
+ "/v1/api/catalog/presets": {
1171
+ parameters: {
1172
+ query?: never;
1173
+ header?: never;
1174
+ path?: never;
1175
+ cookie?: never;
1176
+ };
1177
+ /** Get the Node Presets Catalog. */
1178
+ get: {
1179
+ parameters: {
1180
+ query?: {
1181
+ /** @description API version (default: 1) */
1182
+ version?: number;
1183
+ };
1184
+ header?: never;
1185
+ path?: never;
1186
+ cookie?: never;
1187
+ };
1188
+ requestBody?: never;
1189
+ responses: {
1190
+ /** @description OK */
1191
+ 200: {
1192
+ headers: {
1193
+ [name: string]: unknown;
1194
+ };
1195
+ content: {
1196
+ "application/json": components["schemas"]["NodePresetsCatalogResponse"];
1197
+ };
1459
1198
  };
1460
1199
  };
1461
1200
  };
@@ -1752,7 +1491,37 @@ export interface paths {
1752
1491
  path?: never;
1753
1492
  cookie?: never;
1754
1493
  };
1755
- get?: never;
1494
+ /** Gets a single credential by ID. */
1495
+ get: {
1496
+ parameters: {
1497
+ query?: never;
1498
+ header?: never;
1499
+ path: {
1500
+ /** @description The credential ID. */
1501
+ id: string;
1502
+ };
1503
+ cookie?: never;
1504
+ };
1505
+ requestBody?: never;
1506
+ responses: {
1507
+ /** @description Returns the credential. */
1508
+ 200: {
1509
+ headers: {
1510
+ [name: string]: unknown;
1511
+ };
1512
+ content?: never;
1513
+ };
1514
+ /** @description Credential not found. */
1515
+ 404: {
1516
+ headers: {
1517
+ [name: string]: unknown;
1518
+ };
1519
+ content: {
1520
+ "application/json": components["schemas"]["ProblemDetails"];
1521
+ };
1522
+ };
1523
+ };
1524
+ };
1756
1525
  put?: never;
1757
1526
  post?: never;
1758
1527
  delete?: never;
@@ -4056,6 +3825,221 @@ export interface paths {
4056
3825
  patch?: never;
4057
3826
  trace?: never;
4058
3827
  };
3828
+ "/v1/api/roles": {
3829
+ parameters: {
3830
+ query?: never;
3831
+ header?: never;
3832
+ path?: never;
3833
+ cookie?: never;
3834
+ };
3835
+ /** List all roles available in the tenant. */
3836
+ get: {
3837
+ parameters: {
3838
+ query?: never;
3839
+ header?: never;
3840
+ path?: never;
3841
+ cookie?: never;
3842
+ };
3843
+ requestBody?: never;
3844
+ responses: {
3845
+ /** @description OK */
3846
+ 200: {
3847
+ headers: {
3848
+ [name: string]: unknown;
3849
+ };
3850
+ content?: never;
3851
+ };
3852
+ };
3853
+ };
3854
+ put?: never;
3855
+ /** Create a new custom role. */
3856
+ post: {
3857
+ parameters: {
3858
+ query?: never;
3859
+ header?: never;
3860
+ path?: never;
3861
+ cookie?: never;
3862
+ };
3863
+ requestBody?: {
3864
+ content: {
3865
+ "application/json": components["schemas"]["CreateRoleRequest"];
3866
+ "text/json": components["schemas"]["CreateRoleRequest"];
3867
+ "application/*+json": components["schemas"]["CreateRoleRequest"];
3868
+ };
3869
+ };
3870
+ responses: {
3871
+ /** @description OK */
3872
+ 200: {
3873
+ headers: {
3874
+ [name: string]: unknown;
3875
+ };
3876
+ content?: never;
3877
+ };
3878
+ };
3879
+ };
3880
+ delete?: never;
3881
+ options?: never;
3882
+ head?: never;
3883
+ patch?: never;
3884
+ trace?: never;
3885
+ };
3886
+ "/v1/api/roles/permissions": {
3887
+ parameters: {
3888
+ query?: never;
3889
+ header?: never;
3890
+ path?: never;
3891
+ cookie?: never;
3892
+ };
3893
+ /** List all available system permissions. */
3894
+ get: {
3895
+ parameters: {
3896
+ query?: never;
3897
+ header?: never;
3898
+ path?: never;
3899
+ cookie?: never;
3900
+ };
3901
+ requestBody?: never;
3902
+ responses: {
3903
+ /** @description OK */
3904
+ 200: {
3905
+ headers: {
3906
+ [name: string]: unknown;
3907
+ };
3908
+ content?: never;
3909
+ };
3910
+ };
3911
+ };
3912
+ put?: never;
3913
+ post?: never;
3914
+ delete?: never;
3915
+ options?: never;
3916
+ head?: never;
3917
+ patch?: never;
3918
+ trace?: never;
3919
+ };
3920
+ "/v1/api/roles/{id}": {
3921
+ parameters: {
3922
+ query?: never;
3923
+ header?: never;
3924
+ path?: never;
3925
+ cookie?: never;
3926
+ };
3927
+ /** Get a specific role by ID. */
3928
+ get: {
3929
+ parameters: {
3930
+ query?: never;
3931
+ header?: never;
3932
+ path: {
3933
+ id: string;
3934
+ };
3935
+ cookie?: never;
3936
+ };
3937
+ requestBody?: never;
3938
+ responses: {
3939
+ /** @description OK */
3940
+ 200: {
3941
+ headers: {
3942
+ [name: string]: unknown;
3943
+ };
3944
+ content?: never;
3945
+ };
3946
+ };
3947
+ };
3948
+ /**
3949
+ * Update an existing custom role.
3950
+ * System roles cannot be updated.
3951
+ */
3952
+ put: {
3953
+ parameters: {
3954
+ query?: never;
3955
+ header?: never;
3956
+ path: {
3957
+ id: string;
3958
+ };
3959
+ cookie?: never;
3960
+ };
3961
+ requestBody?: {
3962
+ content: {
3963
+ "application/json": components["schemas"]["UpdateRoleRequest"];
3964
+ "text/json": components["schemas"]["UpdateRoleRequest"];
3965
+ "application/*+json": components["schemas"]["UpdateRoleRequest"];
3966
+ };
3967
+ };
3968
+ responses: {
3969
+ /** @description OK */
3970
+ 200: {
3971
+ headers: {
3972
+ [name: string]: unknown;
3973
+ };
3974
+ content?: never;
3975
+ };
3976
+ };
3977
+ };
3978
+ post?: never;
3979
+ /**
3980
+ * Delete a custom role.
3981
+ * System roles cannot be deleted.
3982
+ * Roles assigned to members cannot be deleted.
3983
+ */
3984
+ delete: {
3985
+ parameters: {
3986
+ query?: never;
3987
+ header?: never;
3988
+ path: {
3989
+ id: string;
3990
+ };
3991
+ cookie?: never;
3992
+ };
3993
+ requestBody?: never;
3994
+ responses: {
3995
+ /** @description OK */
3996
+ 200: {
3997
+ headers: {
3998
+ [name: string]: unknown;
3999
+ };
4000
+ content?: never;
4001
+ };
4002
+ };
4003
+ };
4004
+ options?: never;
4005
+ head?: never;
4006
+ patch?: never;
4007
+ trace?: never;
4008
+ };
4009
+ "/v1/api/roles/seed-defaults": {
4010
+ parameters: {
4011
+ query?: never;
4012
+ header?: never;
4013
+ path?: never;
4014
+ cookie?: never;
4015
+ };
4016
+ get?: never;
4017
+ put?: never;
4018
+ /** SEED DEFAULT PERMISSIONS (Temporary/Admin Helper) */
4019
+ post: {
4020
+ parameters: {
4021
+ query?: never;
4022
+ header?: never;
4023
+ path?: never;
4024
+ cookie?: never;
4025
+ };
4026
+ requestBody?: never;
4027
+ responses: {
4028
+ /** @description OK */
4029
+ 200: {
4030
+ headers: {
4031
+ [name: string]: unknown;
4032
+ };
4033
+ content?: never;
4034
+ };
4035
+ };
4036
+ };
4037
+ delete?: never;
4038
+ options?: never;
4039
+ head?: never;
4040
+ patch?: never;
4041
+ trace?: never;
4042
+ };
4059
4043
  "/v1/api/runs": {
4060
4044
  parameters: {
4061
4045
  query?: never;
@@ -4307,7 +4291,7 @@ export interface paths {
4307
4291
  cookie?: never;
4308
4292
  };
4309
4293
  /**
4310
- * Wave 1.0: Get run events for polling-based replay.
4294
+ * .0: Get run events for polling-based replay.
4311
4295
  * Returns events after a specific sequence number for incremental polling.
4312
4296
  * @description This is the recommended endpoint for SDK/UI event consumption.
4313
4297
  * Events are ordered by sequence number (ascending) and limited to prevent
@@ -4581,7 +4565,7 @@ export interface paths {
4581
4565
  cookie?: never;
4582
4566
  };
4583
4567
  /**
4584
- * Wave 5.2: Stream run events via SSE (Server-Sent Events).
4568
+ * .2: Stream run events via SSE (Server-Sent Events).
4585
4569
  * Uses robust internal polling (Cinema V1.2) to ensure strict ordering and reliability.
4586
4570
  * Closes connection when run is terminal and all events are delivered.
4587
4571
  */
@@ -6892,7 +6876,7 @@ export interface paths {
6892
6876
  patch?: never;
6893
6877
  trace?: never;
6894
6878
  };
6895
- "/v1/api/tenants/{tenantId}/workspaces": {
6879
+ "/v1/api/workspaces": {
6896
6880
  parameters: {
6897
6881
  query?: never;
6898
6882
  header?: never;
@@ -6903,9 +6887,7 @@ export interface paths {
6903
6887
  parameters: {
6904
6888
  query?: never;
6905
6889
  header?: never;
6906
- path: {
6907
- tenantId: string;
6908
- };
6890
+ path?: never;
6909
6891
  cookie?: never;
6910
6892
  };
6911
6893
  requestBody?: never;
@@ -6924,9 +6906,7 @@ export interface paths {
6924
6906
  parameters: {
6925
6907
  query?: never;
6926
6908
  header?: never;
6927
- path: {
6928
- tenantId: string;
6929
- };
6909
+ path?: never;
6930
6910
  cookie?: never;
6931
6911
  };
6932
6912
  requestBody?: {
@@ -6952,7 +6932,7 @@ export interface paths {
6952
6932
  patch?: never;
6953
6933
  trace?: never;
6954
6934
  };
6955
- "/v1/api/tenants/{tenantId}/workspaces/{id}": {
6935
+ "/v1/api/workspaces/{id}": {
6956
6936
  parameters: {
6957
6937
  query?: never;
6958
6938
  header?: never;
@@ -6964,7 +6944,6 @@ export interface paths {
6964
6944
  query?: never;
6965
6945
  header?: never;
6966
6946
  path: {
6967
- tenantId: string;
6968
6947
  id: string;
6969
6948
  };
6970
6949
  cookie?: never;
@@ -6985,7 +6964,6 @@ export interface paths {
6985
6964
  query?: never;
6986
6965
  header?: never;
6987
6966
  path: {
6988
- tenantId: string;
6989
6967
  id: string;
6990
6968
  };
6991
6969
  cookie?: never;
@@ -7013,7 +6991,6 @@ export interface paths {
7013
6991
  query?: never;
7014
6992
  header?: never;
7015
6993
  path: {
7016
- tenantId: string;
7017
6994
  id: string;
7018
6995
  };
7019
6996
  cookie?: never;
@@ -7131,46 +7108,29 @@ export interface components {
7131
7108
  [key: string]: unknown;
7132
7109
  } | null;
7133
7110
  };
7134
- AgentBundle: {
7135
- schema_version?: string | null;
7136
- /** Format: date-time */
7137
- exported_at?: string;
7138
- agent?: components["schemas"]["AgentBundleAgent"];
7139
- versions?: components["schemas"]["AgentBundleVersion"][] | null;
7140
- };
7141
- AgentBundleAgent: {
7142
- /** Format: uuid */
7143
- id?: string;
7144
- name?: string | null;
7145
- /** Format: uuid */
7146
- live_version_id?: string | null;
7147
- };
7148
- AgentBundleVersion: {
7111
+ AgentBundleItem: {
7149
7112
  /** Format: uuid */
7150
7113
  id?: string;
7151
- version_tag?: string | null;
7152
7114
  artifact_uri?: string | null;
7153
7115
  artifact_hash?: string | null;
7154
7116
  format?: string | null;
7117
+ content_hash?: string | null;
7155
7118
  /** Format: date-time */
7156
7119
  created_at?: string;
7157
7120
  };
7158
- AgentVersionBundleResponse: {
7159
- version?: components["schemas"]["AgentVersionMetadata"];
7160
- graph_spec?: unknown;
7161
- artifact_hash?: string | null;
7162
- format?: string | null;
7163
- /** Format: date-time */
7164
- resolved_at?: string;
7165
- };
7166
- AgentVersionMetadata: {
7121
+ AgentExportAgent: {
7167
7122
  /** Format: uuid */
7168
7123
  id?: string;
7124
+ name?: string | null;
7169
7125
  /** Format: uuid */
7170
- agent_id?: string;
7171
- version_tag?: string | null;
7126
+ live_bundle_id?: string | null;
7127
+ };
7128
+ AgentExportBundle: {
7129
+ schema_version?: string | null;
7172
7130
  /** Format: date-time */
7173
- created_at?: string;
7131
+ exported_at?: string;
7132
+ agent?: components["schemas"]["AgentExportAgent"];
7133
+ bundles?: components["schemas"]["AgentBundleItem"][] | null;
7174
7134
  };
7175
7135
  ApprovalDecision: {
7176
7136
  decision?: string | null;
@@ -7199,9 +7159,7 @@ export interface components {
7199
7159
  /** Format: uuid */
7200
7160
  workspace_id?: string;
7201
7161
  /** Format: uuid */
7202
- agent_id?: string | null;
7203
- /** Format: uuid */
7204
- agent_version_id?: string | null;
7162
+ agent_id?: string;
7205
7163
  inputs?: components["schemas"]["BatchInput"][] | null;
7206
7164
  };
7207
7165
  BatchRunResponse: {
@@ -7213,13 +7171,14 @@ export interface components {
7213
7171
  /** Format: uuid */
7214
7172
  agent_id?: string;
7215
7173
  };
7216
- /** @description Request DTO for builder chat. */
7174
+ /**
7175
+ * @description KERNEL P0: Request DTO for builder chat.
7176
+ * Contains ONLY intention fields. No graph_spec, no catalogs.
7177
+ */
7217
7178
  BuilderChatRequest: {
7218
7179
  message?: string | null;
7219
- current_graph_spec?: unknown;
7220
7180
  thread_id?: string | null;
7221
- catalog_versions?: components["schemas"]["CatalogVersionsDto"];
7222
- catalog_ref?: string | null;
7181
+ base_graph_etag?: string | null;
7223
7182
  };
7224
7183
  CancelRequest: {
7225
7184
  reason?: string | null;
@@ -7230,12 +7189,6 @@ export interface components {
7230
7189
  status?: string | null;
7231
7190
  was_cancelled?: boolean;
7232
7191
  };
7233
- /** @description Catalog versions for world snapshot. */
7234
- CatalogVersionsDto: {
7235
- nodes?: string | null;
7236
- tools?: string | null;
7237
- triggers?: string | null;
7238
- };
7239
7192
  /**
7240
7193
  * Format: int32
7241
7194
  * @enum {integer}
@@ -7294,14 +7247,6 @@ export interface components {
7294
7247
  CreateAgentRequest: {
7295
7248
  name?: string | null;
7296
7249
  };
7297
- CreateAgentVersionRequest: {
7298
- /** Format: uuid */
7299
- tenant_id?: string;
7300
- /** Format: uuid */
7301
- workspace_id?: string;
7302
- version_tag?: string | null;
7303
- graph_spec?: unknown;
7304
- };
7305
7250
  CreateCheckpointRequest: {
7306
7251
  step_name?: string | null;
7307
7252
  checkpoint_ns?: string | null;
@@ -7333,7 +7278,7 @@ export interface components {
7333
7278
  agent_id?: string;
7334
7279
  schedule?: string | null;
7335
7280
  /** Format: uuid */
7336
- agent_version_id?: string | null;
7281
+ bundle_id?: string | null;
7337
7282
  input?: unknown;
7338
7283
  enabled?: boolean | null;
7339
7284
  };
@@ -7349,7 +7294,7 @@ export interface components {
7349
7294
  /** Format: uuid */
7350
7295
  agent_id?: string;
7351
7296
  /** Format: uuid */
7352
- agent_version_id?: string | null;
7297
+ bundle_id?: string | null;
7353
7298
  name?: string | null;
7354
7299
  config?: {
7355
7300
  [key: string]: unknown;
@@ -7376,6 +7321,10 @@ export interface components {
7376
7321
  commit_message?: string | null;
7377
7322
  set_as_live?: boolean;
7378
7323
  };
7324
+ CreateRoleRequest: {
7325
+ name?: string | null;
7326
+ permissions?: string[] | null;
7327
+ };
7379
7328
  CreateRunRequest: {
7380
7329
  /** Format: uuid */
7381
7330
  tenant_id?: string;
@@ -7383,12 +7332,12 @@ export interface components {
7383
7332
  workspace_id?: string;
7384
7333
  /** Format: uuid */
7385
7334
  agent_id?: string | null;
7386
- /** Format: uuid */
7387
- agent_version_id?: string | null;
7388
7335
  thread?: components["schemas"]["ThreadRequest"];
7389
7336
  idempotency_key?: string | null;
7390
7337
  input?: unknown;
7391
7338
  webhook_url?: string | null;
7339
+ /** Format: uuid */
7340
+ bundle_id?: string | null;
7392
7341
  };
7393
7342
  CreateTenantRequest: {
7394
7343
  name?: string | null;
@@ -7424,6 +7373,8 @@ export interface components {
7424
7373
  /** Format: uuid */
7425
7374
  agent_id?: string;
7426
7375
  name?: string | null;
7376
+ trigger_type?: string | null;
7377
+ config?: unknown;
7427
7378
  };
7428
7379
  CreateVectorStoreRequest: {
7429
7380
  name?: string | null;
@@ -7509,7 +7460,8 @@ export interface components {
7509
7460
  };
7510
7461
  InviteMemberRequest: {
7511
7462
  /** Format: uuid */
7512
- user_id?: string;
7463
+ user_id?: string | null;
7464
+ email?: string | null;
7513
7465
  /** Format: uuid */
7514
7466
  role_id?: string;
7515
7467
  workspace_ids?: string[] | null;
@@ -7520,6 +7472,32 @@ export interface components {
7520
7472
  method?: string | null;
7521
7473
  params?: unknown;
7522
7474
  };
7475
+ NodeCatalogResponse: {
7476
+ version: string | null;
7477
+ nodes: components["schemas"]["NodeTypeDto"][] | null;
7478
+ };
7479
+ NodePresetDto: {
7480
+ preset_slug: string | null;
7481
+ base_node_slug: string | null;
7482
+ title: string | null;
7483
+ description?: string | null;
7484
+ default_config?: unknown;
7485
+ locked_fields?: unknown;
7486
+ ui_variant?: string | null;
7487
+ };
7488
+ NodePresetsCatalogResponse: {
7489
+ version: string | null;
7490
+ presets: components["schemas"]["NodePresetDto"][] | null;
7491
+ };
7492
+ NodeTypeDto: {
7493
+ id: string | null;
7494
+ title: string | null;
7495
+ category: string | null;
7496
+ description?: string | null;
7497
+ ports?: unknown;
7498
+ config_schema?: unknown;
7499
+ default_config?: unknown;
7500
+ };
7523
7501
  PlaygroundRequest: {
7524
7502
  variables?: {
7525
7503
  [key: string]: unknown;
@@ -7538,8 +7516,6 @@ export interface components {
7538
7516
  workspace_id?: string;
7539
7517
  /** Format: uuid */
7540
7518
  agent_id?: string;
7541
- /** Format: uuid */
7542
- agent_version_id?: string | null;
7543
7519
  input?: unknown;
7544
7520
  /** Format: int32 */
7545
7521
  timeout_seconds?: number | null;
@@ -7591,8 +7567,6 @@ export interface components {
7591
7567
  };
7592
7568
  RerunRequest: {
7593
7569
  input?: unknown;
7594
- /** Format: uuid */
7595
- agent_version_id?: string | null;
7596
7570
  };
7597
7571
  RerunResponse: {
7598
7572
  /** Format: uuid */
@@ -7637,7 +7611,7 @@ export interface components {
7637
7611
  /** Format: uuid */
7638
7612
  agent_id?: string;
7639
7613
  /** Format: uuid */
7640
- agent_version_id?: string;
7614
+ bundle_id?: string;
7641
7615
  /** Format: uuid */
7642
7616
  thread_id?: string;
7643
7617
  status?: components["schemas"]["RunStatus"];
@@ -7765,8 +7739,6 @@ export interface components {
7765
7739
  workspace_id?: string;
7766
7740
  /** Format: uuid */
7767
7741
  agent_id?: string | null;
7768
- /** Format: uuid */
7769
- agent_version_id?: string | null;
7770
7742
  thread?: components["schemas"]["ThreadRequest"];
7771
7743
  idempotency_key?: string | null;
7772
7744
  input?: unknown;
@@ -7791,6 +7763,10 @@ export interface components {
7791
7763
  ThreadSearchRequest: {
7792
7764
  /** Format: uuid */
7793
7765
  workspace_id?: string | null;
7766
+ /** @description Filter by external conversation ID (exact match). */
7767
+ external_conversation_id?: string | null;
7768
+ /** @description Filter by channel (Http, Whatsapp, Chatwoot, etc). */
7769
+ channel?: string | null;
7794
7770
  /** Format: uuid */
7795
7771
  agent_id?: string | null;
7796
7772
  /** Format: date-time */
@@ -7809,10 +7785,23 @@ export interface components {
7809
7785
  name?: string | null;
7810
7786
  arguments?: unknown;
7811
7787
  };
7788
+ TriggerTemplateDto: {
7789
+ slug: string | null;
7790
+ kind: string | null;
7791
+ name: string | null;
7792
+ description?: string | null;
7793
+ run_input_schema?: unknown;
7794
+ example_payload?: unknown;
7795
+ config_schema?: unknown;
7796
+ };
7797
+ TriggerTemplatesCatalogResponse: {
7798
+ version: string | null;
7799
+ templates: components["schemas"]["TriggerTemplateDto"][] | null;
7800
+ };
7812
7801
  UpdateAgentRequest: {
7813
7802
  name?: string | null;
7814
7803
  /** Format: uuid */
7815
- live_version_id?: string | null;
7804
+ live_bundle_id?: string | null;
7816
7805
  };
7817
7806
  UpdateCredentialRequest: {
7818
7807
  name?: string | null;
@@ -7832,6 +7821,10 @@ export interface components {
7832
7821
  role_id?: string | null;
7833
7822
  workspace_ids?: string[] | null;
7834
7823
  };
7824
+ UpdateRoleRequest: {
7825
+ name?: string | null;
7826
+ permissions?: string[] | null;
7827
+ };
7835
7828
  UpdateTenantRequest: {
7836
7829
  name?: string | null;
7837
7830
  slug?: string | null;
@@ -7932,8 +7925,6 @@ export interface components {
7932
7925
  workspace_id?: string;
7933
7926
  /** Format: uuid */
7934
7927
  agent_id?: string | null;
7935
- /** Format: uuid */
7936
- agent_version_id?: string | null;
7937
7928
  thread?: components["schemas"]["ThreadRequest"];
7938
7929
  idempotency_key?: string | null;
7939
7930
  input?: unknown;