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