@agents24/node 0.3.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/README.md +27 -3
  2. package/compatibility.json +6 -6
  3. package/dist/bff.cjs +481 -52
  4. package/dist/bff.cjs.map +1 -1
  5. package/dist/bff.d.cts +24 -4
  6. package/dist/bff.d.ts +24 -4
  7. package/dist/bff.js +481 -52
  8. package/dist/bff.js.map +1 -1
  9. package/dist/{client-Rmk3dh_D.d.cts → client-xWr_OGEe.d.cts} +437 -76
  10. package/dist/{client-Rmk3dh_D.d.ts → client-xWr_OGEe.d.ts} +437 -76
  11. package/dist/index.cjs +302 -57
  12. package/dist/index.cjs.map +1 -1
  13. package/dist/index.d.cts +2 -2
  14. package/dist/index.d.ts +2 -2
  15. package/dist/index.js +302 -57
  16. package/dist/index.js.map +1 -1
  17. package/dist/types/bff-agent-resolution.d.ts +41 -0
  18. package/dist/types/bff-agent-resolution.d.ts.map +1 -0
  19. package/dist/types/bff-errors.d.ts +3 -0
  20. package/dist/types/bff-errors.d.ts.map +1 -0
  21. package/dist/types/bff.d.ts +6 -19
  22. package/dist/types/bff.d.ts.map +1 -1
  23. package/dist/types/client.d.ts +4 -2
  24. package/dist/types/client.d.ts.map +1 -1
  25. package/dist/types/embed.d.ts +8 -2
  26. package/dist/types/embed.d.ts.map +1 -1
  27. package/dist/types/generated/customerProfiles.d.ts +11 -0
  28. package/dist/types/generated/customerProfiles.d.ts.map +1 -0
  29. package/dist/types/generated/manifest.d.ts +1 -1
  30. package/dist/types/generated/manifest.d.ts.map +1 -1
  31. package/dist/types/generated/resourceInstallations.d.ts +25 -0
  32. package/dist/types/generated/resourceInstallations.d.ts.map +1 -0
  33. package/dist/types/generated/resourcePackages.d.ts +7 -3
  34. package/dist/types/generated/resourcePackages.d.ts.map +1 -1
  35. package/dist/types/generated/resourcePolicies.d.ts +3 -3
  36. package/dist/types/generated/resourcePolicies.d.ts.map +1 -1
  37. package/dist/types/types.d.ts +389 -61
  38. package/dist/types/types.d.ts.map +1 -1
  39. package/package.json +2 -2
  40. package/dist/types/generated/resourceBundles.d.ts +0 -12
  41. package/dist/types/generated/resourceBundles.d.ts.map +0 -1
@@ -75,10 +75,11 @@ type EmbedStreamRequest = {
75
75
  requested_model_id?: string;
76
76
  requested_model_node_id?: string;
77
77
  external_user_id: string;
78
- external_user_issuer?: string;
79
78
  external_session_id?: string;
80
79
  metadata?: Record<string, unknown>;
81
80
  client?: Record<string, unknown>;
81
+ runtime_target?: "draft" | "published";
82
+ integration_id: string;
82
83
  };
83
84
  type AttachRunRequest = {
84
85
  external_user_id: string;
@@ -86,6 +87,8 @@ type AttachRunRequest = {
86
87
  metadata?: Record<string, unknown>;
87
88
  client?: Record<string, unknown>;
88
89
  cursor?: number;
90
+ runtime_target?: "draft" | "published";
91
+ integration_id: string;
89
92
  };
90
93
  type FeedbackRating = "like" | "dislike";
91
94
  type FeedbackReason = "incorrect" | "irrelevant" | "incomplete" | "unsafe" | "citation_issue" | "other";
@@ -106,6 +109,8 @@ type EmbeddedResponseFeedbackInput = {
106
109
  rating: FeedbackRating | null;
107
110
  reason?: FeedbackReason | null;
108
111
  comment?: string | null;
112
+ runtime_target?: "draft" | "published";
113
+ integration_id: string;
109
114
  };
110
115
  type HitlAction = "approve" | "reject" | "connect" | "skip" | "respond";
111
116
  type HitlAnswer = {
@@ -131,39 +136,56 @@ type McpAuthStartResult = {
131
136
  };
132
137
  type EmbedRuntimeBootstrap = {
133
138
  version: string;
134
- agent_name?: string;
139
+ agent_id: string;
140
+ agent_name: string;
141
+ agent_alias: string;
142
+ agent_aliases: string[];
135
143
  agent_version_id?: string;
136
144
  agent_version_number?: number;
137
145
  features: Record<string, unknown>;
138
146
  thread_events_path?: string | null;
139
147
  thread_events_url?: string | null;
140
148
  };
149
+ type EmbedAgentAliasResolution = {
150
+ agent_id: string;
151
+ agent_name: string;
152
+ agent_alias: string;
153
+ agent_aliases: string[];
154
+ };
141
155
  type MultiAgentThreadListRequest = {
142
156
  agent_ids: string[];
143
157
  external_user_id: string;
144
158
  external_session_id?: string | null;
159
+ runtime_target?: "draft" | "published";
160
+ integration_id: string;
145
161
  skip?: number;
146
162
  limit?: number;
147
163
  };
148
164
  type ThreadListOptions = {
149
165
  externalUserId: string;
150
166
  externalSessionId?: string;
167
+ runtimeTarget?: "draft" | "published";
168
+ integrationId: string;
151
169
  skip?: number;
152
170
  limit?: number;
153
171
  };
154
172
  type ThreadDetailOptions = {
155
173
  externalUserId: string;
156
174
  externalSessionId?: string;
175
+ runtimeTarget?: "draft" | "published";
157
176
  beforeTurnIndex?: number;
158
177
  limit?: number;
159
178
  includeSubthreads?: boolean;
160
179
  subthreadDepth?: number;
161
180
  subthreadTurnLimit?: number;
162
181
  subthreadChildLimit?: number;
182
+ integrationId: string;
163
183
  };
164
184
  type RunContextOptions = {
165
185
  externalUserId: string;
166
186
  externalSessionId?: string;
187
+ runtimeTarget?: "draft" | "published";
188
+ integrationId: string;
167
189
  };
168
190
  type RunCancelOptions = {
169
191
  externalUserId?: string;
@@ -173,20 +195,62 @@ type RunCancelOptions = {
173
195
  type EmbedRunCancelOptions = {
174
196
  externalUserId?: string;
175
197
  externalSessionId?: string;
198
+ runtimeTarget?: "draft" | "published";
199
+ integrationId: string;
176
200
  };
177
201
  type ThreadDeleteOptions = {
178
202
  externalUserId: string;
179
203
  externalSessionId?: string;
204
+ runtimeTarget?: "draft" | "published";
205
+ integrationId: string;
180
206
  };
181
207
  type ThreadSummaryEventOptions = {
182
208
  externalUserId: string;
183
209
  externalSessionId?: string | null;
184
210
  cursor?: number | null;
185
211
  signal?: AbortSignal;
212
+ runtimeTarget?: "draft" | "published";
213
+ integrationId: string;
186
214
  };
187
215
  type MultiAgentThreadSummaryEventOptions = ThreadSummaryEventOptions & {
188
216
  agentIds: string[];
189
217
  };
218
+ type ConversationThreadOptions = ThreadDetailOptions & {
219
+ agentIds: string[];
220
+ integrationId: string;
221
+ };
222
+ type ConversationRuntimeSelectionRequest = {
223
+ agent_ids: string[];
224
+ preferred_agent_id: string;
225
+ preferred_model_id?: string | null;
226
+ external_user_id: string;
227
+ external_session_id?: string | null;
228
+ integration_id: string;
229
+ runtime_target?: "draft" | "published";
230
+ };
231
+ type ConversationRuntimeSelectionResult = {
232
+ runtime_selection: {
233
+ agent_id: string;
234
+ model_id: string | null;
235
+ };
236
+ models: {
237
+ default_id: string | null;
238
+ options: Array<{
239
+ id: string;
240
+ label: string;
241
+ }>;
242
+ };
243
+ };
244
+ type ConversationRunRequest = {
245
+ agent_ids: string[];
246
+ external_user_id: string;
247
+ external_session_id?: string | null;
248
+ integration_id: string;
249
+ runtime_target?: "draft" | "published";
250
+ };
251
+ type ConversationRunResult = {
252
+ agent_id: string;
253
+ };
190
254
  type ServerAttachmentUploadOptions = {
191
255
  threadId?: string;
192
256
  agentVersionId?: string;
@@ -199,10 +263,14 @@ type AttachmentContentAccessRequest = {
199
263
  type EmbedAttachmentContentAccessRequest = AttachmentContentAccessRequest & {
200
264
  external_user_id: string;
201
265
  external_session_id?: string | null;
266
+ runtime_target?: "draft" | "published";
267
+ integration_id: string;
202
268
  };
203
269
  type ServerEmbedAttachmentUploadOptions = ServerAttachmentUploadOptions & {
204
270
  externalUserId: string;
205
271
  externalSessionId?: string;
272
+ runtimeTarget?: "draft" | "published";
273
+ integrationId: string;
206
274
  };
207
275
  type GraphValueRef = {
208
276
  namespace: "workflow_input" | "state" | "node_output";
@@ -330,6 +398,7 @@ type AgentValidationResult = {
330
398
  };
331
399
  type AgentCreateRequest = {
332
400
  name: string;
401
+ aliases?: string[];
333
402
  description?: string | null;
334
403
  tags?: string[];
335
404
  graph_definition: GraphDefinition;
@@ -341,6 +410,7 @@ type AgentSummary = {
341
410
  id: string;
342
411
  organization_id: string;
343
412
  name: string;
413
+ aliases: string[];
344
414
  description?: string | null;
345
415
  tags: string[];
346
416
  lifecycle_status: "active" | "deprecated" | "archived" | "disabled";
@@ -634,7 +704,7 @@ type ClientSessionCredentials = {
634
704
  refresh_expires_at: string | null;
635
705
  dpop_nonce: string | null;
636
706
  };
637
- type PortableResourceKind = "agent" | "rag_pipeline" | "instruction" | "knowledge_store";
707
+ type PortableResourceKind = "agent" | "rag_pipeline" | "instruction" | "knowledge_store" | "artifact";
638
708
  type ResourceSelector = {
639
709
  kind: PortableResourceKind;
640
710
  id: string;
@@ -652,44 +722,81 @@ type ResourcePackageUpload = {
652
722
  data: Uint8Array;
653
723
  filename?: string;
654
724
  };
725
+ type ResourcePackageImportUpload = ResourcePackageUpload & {
726
+ mappings?: Record<string, string>;
727
+ };
728
+ type ResourceInstallationPlanUpload = ResourcePackageUpload & {
729
+ prune?: boolean;
730
+ };
731
+ type ResourceInstallationPullChange = {
732
+ status: "A" | "M" | "D";
733
+ path: string;
734
+ };
735
+ type ResourceInstallationPullPlan = {
736
+ pull_id: string;
737
+ installation_id: string;
738
+ status: "planned" | "completed";
739
+ platform_snapshot_hash: string;
740
+ package_hash: string;
741
+ plan: {
742
+ summary: Record<string, number>;
743
+ files: ResourceInstallationPullChange[];
744
+ resources: Array<Record<string, unknown>>;
745
+ };
746
+ completed_at?: string | null;
747
+ };
748
+ type ResourceInstallationPullPayload = {
749
+ pull_id: string;
750
+ platform_snapshot_hash: string;
751
+ package_hash: string;
752
+ files: Record<string, string>;
753
+ };
754
+ type ResourceInstallationPullAcceptRequest = {
755
+ platform_snapshot_hash: string;
756
+ package_hash: string;
757
+ };
655
758
  type ResourcePackageDiagnostic = {
656
759
  severity: "error" | "warning";
657
760
  code: string;
658
761
  path: string;
659
762
  message: string;
660
763
  };
661
- type ResourcePackageCompileResult = {
764
+ type ResourceToolExport = {
765
+ source_resource_key: string;
766
+ source_kind: "agent" | "rag_pipeline";
767
+ key?: string;
768
+ name: string;
769
+ description: string;
770
+ input_schema: Record<string, unknown>;
771
+ output_schema: Record<string, unknown>;
772
+ session?: "fresh" | "persistent" | "shared";
773
+ };
774
+ type ResourceCallableBinding = {
775
+ consumer_resource_key: string;
776
+ consumer_node_id: string;
777
+ source_resource_key: string;
778
+ source_kind: "agent" | "rag_pipeline" | "artifact";
779
+ tool_title?: string;
780
+ description?: string;
781
+ source_tool_id?: string;
782
+ export_key?: string;
783
+ loading_mode?: "static" | "dynamic";
784
+ };
785
+ type ResourcePackageValidationResult = {
662
786
  valid: boolean;
787
+ package_hash?: string;
663
788
  format: "agents24.resource_package";
664
- schema_version: "1.0";
789
+ schema_version: "2.0";
665
790
  package: Record<string, unknown>;
666
791
  resources: Array<Record<string, unknown>>;
667
792
  requirements: string[];
668
- tool_exports: Array<Record<string, unknown>>;
669
- callable_bindings: Array<Record<string, unknown>>;
793
+ tool_exports: ResourceToolExport[];
794
+ callable_bindings: ResourceCallableBinding[];
670
795
  diagnostics: ResourcePackageDiagnostic[];
671
- bundle?: ResourceBundle | null;
672
- };
673
- type ResourceBundleImportRequest = {
674
- bundle: ResourceBundle;
675
- selected_resource_keys?: string[];
676
- mappings?: Record<string, string>;
677
- };
678
- type ResourceBundleOrigin = {
679
- source_id: string;
680
- target: "draft" | "version";
681
- version_id?: string | null;
682
- label: string;
683
- };
684
- type ResourceBundleResource = {
685
- resource_key: string;
686
- kind: PortableResourceKind;
687
- name: string;
688
- document: Record<string, unknown>;
689
- origin?: ResourceBundleOrigin;
690
796
  };
691
- type ResourceBundleDependency = {
797
+ type ResourcePackageDependency = {
692
798
  id: string;
799
+ requirement_key?: string | null;
693
800
  from_resource_key: string;
694
801
  to_resource_key?: string | null;
695
802
  kind: string;
@@ -701,44 +808,243 @@ type ResourceBundleDependency = {
701
808
  bundled: boolean;
702
809
  included?: boolean;
703
810
  required_capability?: "chat" | "embedding";
811
+ status?: "bundled" | "mapped" | "unresolved";
812
+ mapped_id?: string | null;
813
+ suggested_mapping?: {
814
+ id: string;
815
+ name: string;
816
+ } | null;
704
817
  };
705
- type ResourceBundle = {
706
- format: "agents24.resource_bundle";
707
- schema_version: "1.0";
708
- exported_at?: string;
709
- resources: ResourceBundleResource[];
710
- dependencies: ResourceBundleDependency[];
818
+ type ResourcePackageExportPlan = {
819
+ format: "agents24.resource_package";
820
+ schema_version: "2.0";
821
+ selected_roots: ResourceSelector[];
822
+ resources: Array<{
823
+ resource_key: string;
824
+ kind: PortableResourceKind;
825
+ name: string;
826
+ }>;
827
+ external_requirements: Array<{
828
+ requirement_key: string | null;
829
+ kind: string;
830
+ name?: string | null;
831
+ required: boolean;
832
+ required_capability?: "chat" | "embedding";
833
+ }>;
711
834
  warnings: string[];
712
- tool_exports?: Array<Record<string, unknown>>;
713
- callable_bindings?: Array<Record<string, unknown>>;
714
- };
715
- type ResourceBundlePlan = Omit<ResourceBundle, "resources"> & {
716
- resources: Array<Omit<ResourceBundleResource, "document">>;
717
835
  blockers: Array<{
718
836
  code: string;
719
837
  message: string;
720
838
  }>;
721
839
  can_export: boolean;
722
- external_references: ResourceBundleDependency[];
723
840
  };
724
- type ResourceBundleExportRequest = {
725
- selectors: ResourceSelector[];
726
- included_resource_keys?: string[];
841
+ type ResourcePackageImportPreview = {
842
+ format: "agents24.resource_package";
843
+ schema_version: "2.0";
844
+ package: Record<string, unknown>;
845
+ package_hash: string;
846
+ resources: Array<{
847
+ resource_key: string;
848
+ kind: PortableResourceKind;
849
+ name: string;
850
+ status: "ready" | "incomplete";
851
+ incomplete_reasons: Array<{
852
+ dependency_id: string;
853
+ kind: string;
854
+ message: string;
855
+ }>;
856
+ }>;
857
+ dependencies: ResourcePackageDependency[];
858
+ suggested_mappings: Array<{
859
+ dependency_id: string;
860
+ id: string;
861
+ name: string;
862
+ }>;
863
+ warnings: string[];
864
+ blockers: Array<{
865
+ code: string;
866
+ message: string;
867
+ }>;
868
+ can_import: boolean;
727
869
  };
728
- type ResourceBundleCandidateList = {
870
+ type ResourcePackageImportResult = {
871
+ format: "agents24.resource_package";
872
+ schema_version: "2.0";
873
+ package_hash: string;
874
+ status: "created";
875
+ resources: Array<{
876
+ resource_key: string;
877
+ kind: PortableResourceKind;
878
+ id: string;
879
+ name: string;
880
+ status: "ready" | "incomplete";
881
+ }>;
882
+ id_map: Record<string, string>;
883
+ warnings: string[];
884
+ };
885
+ type ResourceCandidateList = {
729
886
  items: Array<{
730
887
  id: string;
731
888
  name: string;
732
889
  }>;
733
890
  total: number;
734
891
  };
735
- type ResourceBundleCandidateOptions = {
892
+ type ResourcePackageCandidateOptions = {
736
893
  kind: string;
737
894
  query?: string;
738
895
  limit?: number;
739
896
  offset?: number;
740
897
  requiredCapability?: "chat" | "embedding";
741
898
  };
899
+ type ResourceInstallationBinding = {
900
+ resource_key: string;
901
+ kind: string;
902
+ resource_id: string;
903
+ source_hash?: string | null;
904
+ retained_orphan?: boolean;
905
+ };
906
+ type ResourceCallableBindingStatus = {
907
+ consumer_resource_key: string;
908
+ consumer_node_id: string;
909
+ source_resource_key: string;
910
+ source_kind: "agent" | "rag_pipeline" | "artifact";
911
+ registry_kind: "tool" | "toolset" | null;
912
+ tool_id: string | null;
913
+ tool_key: string | null;
914
+ toolset_id: string | null;
915
+ toolset_key: string | null;
916
+ draft_status: "attached" | "unavailable" | "missing" | "stale" | "blocked";
917
+ published_status: "attached" | "unavailable" | "missing" | "stale" | "not_published";
918
+ published_version_id: string | null;
919
+ blocker_code: string | null;
920
+ };
921
+ type ResourceInstallationOperation = {
922
+ operation_id: string;
923
+ installation_id: string;
924
+ package_id: string;
925
+ status: "planned" | "applying" | "waiting" | "completed" | "failed";
926
+ phase: string;
927
+ result: Record<string, unknown>;
928
+ failure_id?: string | null;
929
+ };
930
+ type ResourceInstallation = {
931
+ id: string;
932
+ package_id: string | null;
933
+ package_name: string;
934
+ primary_resource_key?: string | null;
935
+ integration_mode: "bff" | "client-deployment" | "publish-only";
936
+ client_deployment_id?: string | null;
937
+ status: string;
938
+ synchronized_package_hash?: string | null;
939
+ last_applied_at?: string | null;
940
+ last_sync_direction?: "apply" | "pull" | null;
941
+ last_synchronized_at?: string | null;
942
+ last_pull_summary?: Record<string, unknown>;
943
+ last_published_package_hash?: string | null;
944
+ last_published_at?: string | null;
945
+ publication_state?: "never_published" | "current" | "draft_changes";
946
+ bindings?: ResourceInstallationBinding[];
947
+ callable_bindings?: ResourceCallableBindingStatus[];
948
+ development_connections?: ArtifactDevelopmentSession[];
949
+ remote_artifact_stages?: Array<{
950
+ resource_key: string;
951
+ artifact_id: string;
952
+ target: "development" | "production";
953
+ status: string;
954
+ manifest_hash: string;
955
+ base_url?: string | null;
956
+ }>;
957
+ latest_apply?: ResourceInstallationOperation | null;
958
+ latest_pull?: ResourceInstallationPullPlan | null;
959
+ };
960
+ type ResourceInstallationList = {
961
+ items: ResourceInstallation[];
962
+ };
963
+ type ResourceInstallationCreateRequest = {
964
+ package_id: string;
965
+ package_name: string;
966
+ operation_id: string;
967
+ };
968
+ type ResourceInstallationPlan = {
969
+ installation_id: string | null;
970
+ operation_id: string;
971
+ package_id: string;
972
+ package_name: string;
973
+ package_hash: string;
974
+ actions: Array<Record<string, unknown>>;
975
+ content: Array<Record<string, unknown>>;
976
+ external_requirements: Array<Record<string, unknown>>;
977
+ artifact_actions: Array<Record<string, unknown>>;
978
+ artifact_readiness: Array<{
979
+ resource_key: string;
980
+ status: string;
981
+ blocking: false;
982
+ }>;
983
+ generated_tool_changes: Array<Record<string, unknown>>;
984
+ publication_order: string[];
985
+ deployment: Record<string, unknown>;
986
+ blockers: Array<Record<string, unknown>>;
987
+ can_apply: boolean;
988
+ prune: boolean;
989
+ };
990
+ type ResourceInstallationLinkRequest = {
991
+ resource_key: string;
992
+ resource_id: string;
993
+ };
994
+ type ResourceInstallationSecretsRequest = {
995
+ secrets: Record<string, string>;
996
+ };
997
+ type ResourceInstallationSecretStatus = {
998
+ installation_id: string;
999
+ configured: string[];
1000
+ };
1001
+ type ResourceInstallationApplyRequest = {
1002
+ secrets?: Record<string, string>;
1003
+ primary_resource_key?: string;
1004
+ integration_mode?: "bff" | "client-deployment" | "publish-only";
1005
+ };
1006
+ type ResourceInstallationPublishRequest = {
1007
+ package_hash: string;
1008
+ };
1009
+ type ResourceInstallationPublication = {
1010
+ installation_id: string;
1011
+ operation_id: string;
1012
+ package_hash: string;
1013
+ status: "published" | "already_published";
1014
+ published_at?: string | null;
1015
+ client_deployment_id?: string | null;
1016
+ };
1017
+ type ArtifactDevelopmentSessionPrepareRequest = {
1018
+ resource_key: string;
1019
+ machine_label: string;
1020
+ };
1021
+ type ArtifactDevelopmentSession = {
1022
+ id?: string;
1023
+ installation_id: string;
1024
+ resource_key: string;
1025
+ artifact_id?: string | null;
1026
+ status: "prepared" | "connecting" | "connected" | "disconnected" | "expired" | "superseded" | "revoked";
1027
+ contract_status: "unverified" | "verifying" | "healthy" | "stale";
1028
+ machine_label?: string;
1029
+ manifest_hash?: string | null;
1030
+ last_heartbeat_at?: string | null;
1031
+ contract_checked_at?: string | null;
1032
+ failure_id?: string | null;
1033
+ expires_at?: string | null;
1034
+ };
1035
+ type ArtifactDevelopmentSessionAdmission = ArtifactDevelopmentSession & {
1036
+ id: string;
1037
+ relay_token: string;
1038
+ relay_path: string;
1039
+ };
1040
+ type ResourceInstallationDeploymentRequest = {
1041
+ client_deployment_id?: string | null;
1042
+ };
1043
+ type ResourceInstallationResourceListOptions = {
1044
+ kind: string;
1045
+ query?: string;
1046
+ limit?: number;
1047
+ };
742
1048
  type ResourcePolicySummary = {
743
1049
  id: string;
744
1050
  name: string;
@@ -750,16 +1056,51 @@ type CustomerIdentityRequest = {
750
1056
  issuer: string;
751
1057
  subject: string;
752
1058
  };
753
- type SetCustomerResourcePolicyAssignmentRequest = CustomerIdentityRequest & {
1059
+ type CustomerProfilePatch = {
1060
+ display_name?: string | null;
1061
+ email?: string | null;
1062
+ avatar_url?: string | null;
1063
+ };
1064
+ type EmbedCustomerPrincipalResolveRequest = {
1065
+ integration_id: string;
1066
+ integration_name?: string;
1067
+ issuer?: string;
1068
+ subject: string;
1069
+ profile?: CustomerProfilePatch;
1070
+ };
1071
+ type EmbedCustomerPrincipalResolveResponse = {
1072
+ customer_principal_ref: string;
1073
+ };
1074
+ type CustomerProfile = {
1075
+ customer_principal_ref: string;
1076
+ display_name: string | null;
1077
+ email: string | null;
1078
+ avatar_url: string | null;
1079
+ integration_id: string | null;
1080
+ integration_name: string | null;
1081
+ };
1082
+ type CustomerProfileList = {
1083
+ items: CustomerProfile[];
1084
+ };
1085
+ type CustomerProfileSearchOptions = {
1086
+ query?: string;
1087
+ integrationId?: string;
1088
+ limit?: number;
1089
+ };
1090
+ type CustomerPrincipalRefRequest = {
1091
+ customer_principal_ref: string;
1092
+ };
1093
+ type SetCustomerResourcePolicyAssignmentRequest = CustomerPrincipalRefRequest & {
754
1094
  policy_set_id: string;
755
1095
  };
756
- type EffectiveCustomerResourcePolicyRequest = CustomerIdentityRequest & {
1096
+ type EffectiveCustomerResourcePolicyRequest = CustomerPrincipalRefRequest & {
757
1097
  deployment_id: string;
758
1098
  };
759
1099
  type EmbedResourcePolicyRequest = {
760
1100
  external_user_id: string;
761
- external_user_issuer?: string;
1101
+ integration_id: string;
762
1102
  agent_version_id?: string;
1103
+ runtime_target?: "draft" | "published";
763
1104
  };
764
1105
  type ResourcePolicySubjectRef = {
765
1106
  kind: "agent" | "client_deployment" | "organization_user" | "customer_principal";
@@ -787,6 +1128,7 @@ type ClearCustomerResourcePolicyAssignmentResult = {
787
1128
  cleared: boolean;
788
1129
  };
789
1130
  type EffectiveResourcePolicy = {
1131
+ agent_access_allowed?: boolean;
790
1132
  customer_principal_ref: string | null;
791
1133
  model_selection: {
792
1134
  selectable: boolean;
@@ -825,20 +1167,6 @@ type ResourcePolicyQuotaScheduleResult = {
825
1167
  subject_ref: ResourcePolicySubjectRef;
826
1168
  quota_schedule: ResourcePolicyQuotaSchedule;
827
1169
  };
828
- type ResourceBundleImportPreview = {
829
- resources: Array<Record<string, unknown>>;
830
- dependencies: Array<Record<string, unknown>>;
831
- warnings: unknown[];
832
- blockers: unknown[];
833
- can_import: boolean;
834
- [key: string]: unknown;
835
- };
836
- type ResourceBundleImportResult = {
837
- status: "created";
838
- resources: Array<Record<string, unknown>>;
839
- id_map: Record<string, string>;
840
- warnings: unknown[];
841
- };
842
1170
 
843
1171
  type RequestConfig = {
844
1172
  method?: string;
@@ -938,12 +1266,18 @@ declare class EmbedNamespace {
938
1266
  private stream;
939
1267
  resumeAgentRun(agentId: string, runId: string, payload: ResumeRunRequest, options?: RequestOptions): Promise<RunResumeResult>;
940
1268
  startAgentRunMcpAuth(agentId: string, runId: string, serverId: string, payload: McpAuthStartRequest, options?: RequestOptions): Promise<McpAuthStartResult>;
941
- getRuntimeBootstrap(agentId: string, agentVersionId?: string): Promise<EmbedRuntimeBootstrap>;
1269
+ getRuntimeBootstrap(agentId: string, agentVersionId?: string, runtimeTarget?: "draft" | "published"): Promise<EmbedRuntimeBootstrap>;
1270
+ resolveAgentAlias(agentAlias: string): Promise<EmbedAgentAliasResolution>;
1271
+ resolveCustomerPrincipal(request: EmbedCustomerPrincipalResolveRequest): Promise<EmbedCustomerPrincipalResolveResponse>;
942
1272
  getResourcePolicy(agentId: string, request: EmbedResourcePolicyRequest): Promise<EffectiveResourcePolicy>;
943
1273
  listAgentThreads(agentId: string, options: ThreadListOptions): Promise<ThreadsResponse>;
944
1274
  listAgentThreadsMulti(options: MultiAgentThreadListRequest): Promise<ThreadsResponse>;
945
1275
  subscribeAgentThreadEvents(agentId: string, options: ThreadSummaryEventOptions, onEvent: (event: ThreadSummaryEvent) => void | Promise<void>): Promise<void>;
946
1276
  subscribeAgentThreadEventsMulti(options: MultiAgentThreadSummaryEventOptions, onEvent: (event: ThreadSummaryEvent) => void | Promise<void>): Promise<void>;
1277
+ getConversationThread(threadId: string, options: ConversationThreadOptions): Promise<ThreadDetail>;
1278
+ setConversationRuntimeSelection(threadId: string, request: ConversationRuntimeSelectionRequest): Promise<ConversationRuntimeSelectionResult>;
1279
+ resolveConversationRun(runId: string, request: ConversationRunRequest): Promise<ConversationRunResult>;
1280
+ deleteConversationThread(threadId: string, options: ConversationThreadOptions, requestOptions?: RequestOptions): Promise<ThreadDeleteResult>;
947
1281
  getAgentThread(agentId: string, threadId: string, options: ThreadDetailOptions): Promise<ThreadDetail>;
948
1282
  deleteAgentThread(agentId: string, threadId: string, options: ThreadDeleteOptions, requestOptions?: RequestOptions): Promise<ThreadDeleteResult>;
949
1283
  getAgentRunContext(agentId: string, runId: string, options: RunContextOptions): Promise<RunContext>;
@@ -953,22 +1287,39 @@ declare class EmbedNamespace {
953
1287
  createAttachmentContentAccess(agentId: string, attachmentId: string, request: EmbedAttachmentContentAccessRequest, options?: RequestOptions): Promise<AttachmentContentAccess>;
954
1288
  }
955
1289
 
956
- declare class ResourceBundlesNamespace {
1290
+ declare class ResourcePackagesNamespace {
957
1291
  protected readonly http: Agents24HttpClient;
958
1292
  constructor(http: Agents24HttpClient);
959
- exportPlan(request: ResourceBundleExportRequest): Promise<ResourceBundlePlan>;
960
- exportBundle(request: ResourceBundleExportRequest): Promise<ResourceBundle>;
961
- candidates(options: ResourceBundleCandidateOptions): Promise<ResourceBundleCandidateList>;
962
- importPreview(request: ResourceBundleImportRequest): Promise<ResourceBundleImportPreview>;
963
- importBundle(request: ResourceBundleImportRequest, options?: RequestOptions): Promise<ResourceBundleImportResult>;
1293
+ getExportability(): Promise<Record<string, unknown>>;
1294
+ exportPlan(request: ResourcePackageExportRequest): Promise<ResourcePackageExportPlan>;
1295
+ exportPackage(request: ResourcePackageExportRequest): Promise<ResourcePackageArchive>;
1296
+ validatePackage(upload: ResourcePackageUpload): Promise<ResourcePackageValidationResult>;
1297
+ importPreview(upload: ResourcePackageImportUpload): Promise<ResourcePackageImportPreview>;
1298
+ importPackage(upload: ResourcePackageImportUpload, options?: RequestOptions): Promise<ResourcePackageImportResult>;
1299
+ candidates(options: ResourcePackageCandidateOptions): Promise<ResourceCandidateList>;
964
1300
  }
965
1301
 
966
- declare class ResourcePackagesNamespace {
1302
+ declare class ResourceInstallationsNamespace {
967
1303
  protected readonly http: Agents24HttpClient;
968
1304
  constructor(http: Agents24HttpClient);
969
- exportPackage(request: ResourcePackageExportRequest): Promise<ResourcePackageArchive>;
970
- validatePackage(upload: ResourcePackageUpload): Promise<ResourcePackageCompileResult>;
971
- compilePackage(upload: ResourcePackageUpload): Promise<ResourcePackageCompileResult>;
1305
+ list(): Promise<ResourceInstallationList>;
1306
+ create(request: ResourceInstallationCreateRequest, options?: RequestOptions): Promise<ResourceInstallation>;
1307
+ get(installationId: string): Promise<ResourceInstallation>;
1308
+ getByPackageId(packageId: string): Promise<ResourceInstallation>;
1309
+ plan(upload: ResourceInstallationPlanUpload): Promise<ResourceInstallationPlan>;
1310
+ planPull(installationId: string, upload: ResourcePackageUpload): Promise<ResourceInstallationPullPlan>;
1311
+ downloadPull(installationId: string, pullId: string): Promise<ResourceInstallationPullPayload>;
1312
+ acceptPull(installationId: string, pullId: string, request: ResourceInstallationPullAcceptRequest, options?: RequestOptions): Promise<ResourceInstallationPullPlan>;
1313
+ link(installationId: string, request: ResourceInstallationLinkRequest, options?: RequestOptions): Promise<ResourceInstallationBinding>;
1314
+ configureSecrets(installationId: string, request: ResourceInstallationSecretsRequest, options?: RequestOptions): Promise<ResourceInstallationSecretStatus>;
1315
+ apply(operationId: string, request: ResourceInstallationApplyRequest, options?: RequestOptions): Promise<ResourceInstallationOperation>;
1316
+ operationStatus(operationId: string): Promise<ResourceInstallationOperation>;
1317
+ publish(installationId: string, request: ResourceInstallationPublishRequest, options?: RequestOptions): Promise<ResourceInstallationPublication>;
1318
+ prepareDevelopmentSession(installationId: string, request: ArtifactDevelopmentSessionPrepareRequest, options?: RequestOptions): Promise<ArtifactDevelopmentSessionAdmission>;
1319
+ developmentSessionStatus(installationId: string, resourceKey: string): Promise<ArtifactDevelopmentSession>;
1320
+ revokeDevelopmentSession(installationId: string, sessionId: string, options?: RequestOptions): Promise<ArtifactDevelopmentSession>;
1321
+ bindDeployment(installationId: string, request: ResourceInstallationDeploymentRequest, options?: RequestOptions): Promise<ResourceInstallation>;
1322
+ resources(options: ResourceInstallationResourceListOptions): Promise<ResourceCandidateList>;
972
1323
  }
973
1324
 
974
1325
  declare class RunsNamespace {
@@ -999,26 +1350,36 @@ declare class ResourcePoliciesNamespace {
999
1350
  constructor(http: Agents24HttpClient);
1000
1351
  list(): Promise<ResourcePolicyList>;
1001
1352
  setCustomerAssignment(request: SetCustomerResourcePolicyAssignmentRequest, options?: RequestOptions): Promise<CustomerResourcePolicyAssignment>;
1002
- getCustomerAssignment(request: CustomerIdentityRequest): Promise<CustomerResourcePolicyAssignment>;
1003
- clearCustomerAssignment(request: CustomerIdentityRequest, options?: RequestOptions): Promise<ClearCustomerResourcePolicyAssignmentResult>;
1353
+ getCustomerAssignment(request: CustomerPrincipalRefRequest): Promise<CustomerResourcePolicyAssignment>;
1354
+ clearCustomerAssignment(request: CustomerPrincipalRefRequest, options?: RequestOptions): Promise<ClearCustomerResourcePolicyAssignmentResult>;
1004
1355
  getEffectiveCustomerPolicy(request: EffectiveCustomerResourcePolicyRequest): Promise<EffectiveResourcePolicy>;
1005
1356
  setQuotaSchedule(request: SetResourcePolicyQuotaScheduleRequest, options?: RequestOptions): Promise<ResourcePolicyQuotaScheduleResult>;
1006
1357
  resetQuotaNow(request: ResetResourcePolicyQuotaRequest, options?: RequestOptions): Promise<ResourcePolicyQuotaScheduleResult>;
1007
1358
  }
1008
1359
 
1360
+ declare class CustomerProfilesNamespace {
1361
+ protected readonly http: Agents24HttpClient;
1362
+ constructor(http: Agents24HttpClient);
1363
+ upsert(request: EmbedCustomerPrincipalResolveRequest, options?: RequestOptions): Promise<EmbedCustomerPrincipalResolveResponse>;
1364
+ get(customerPrincipalRef: string): Promise<CustomerProfile>;
1365
+ clear(customerPrincipalRef: string, options?: RequestOptions): Promise<unknown>;
1366
+ search(options: CustomerProfileSearchOptions): Promise<CustomerProfileList>;
1367
+ }
1368
+
1009
1369
  declare class Agents24 {
1010
1370
  readonly agents: AgentsNamespace;
1011
1371
  readonly embed: EmbedNamespace;
1012
1372
  readonly runs: RunsNamespace;
1013
- readonly resourceBundles: ResourceBundlesNamespace;
1014
1373
  readonly resourcePackages: ResourcePackagesNamespace;
1374
+ readonly resourceInstallations: ResourceInstallationsNamespace;
1015
1375
  readonly clientDeployments: ClientDeploymentsNamespace;
1016
1376
  readonly clientSessions: ClientSessionsNamespace;
1017
1377
  readonly instructions: InstructionsNamespace;
1018
1378
  readonly resourcePolicies: ResourcePoliciesNamespace;
1379
+ readonly customerProfiles: CustomerProfilesNamespace;
1019
1380
  constructor(options: Agents24NodeOptions);
1020
1381
  agent(options: AgentDefinitionOptions): AgentDefinitionBuilder;
1021
1382
  graph(): GraphBuilder;
1022
1383
  }
1023
1384
 
1024
- export { type GraphHints as $, Agents24 as A, type BackendSessionRequestOptions as B, type ClearCustomerResourcePolicyAssignmentResult as C, type ClientRuntimeNativeProfileInput as D, type ClientRuntimeOidcConfig as E, type ClientRuntimePolicyInput as F, type ClientSessionCredentials as G, type ControlPlaneRunEventsResponse as H, type CreateBackendClientSessionRequest as I, type CreateClientDeploymentRequest as J, type CustomerIdentityRequest as K, type CustomerResourcePolicyAssignment as L, type EffectiveCustomerResourcePolicyRequest as M, type EffectiveResourcePolicy as N, type EmbedAttachmentContentAccessRequest as O, type EmbedResourcePolicyRequest as P, type EmbedRunCancelOptions as Q, type EmbedRuntimeBootstrap as R, type EmbedStreamRequest as S, type EmbeddedResponseFeedbackInput as T, type FailureCategory as U, type FailureView as V, type FeedbackRating as W, type FeedbackReason as X, GraphBuilder as Y, type GraphDefinition as Z, type GraphEdge as _, type AgentCreateRequest as a, type TraceView as a$, type GraphNode as a0, type GraphValueRef as a1, type HitlAction as a2, type HitlAnswer as a3, type LatestOrPinnedPolicy as a4, type McpAuthStartRequest as a5, type McpAuthStartResult as a6, type MultiAgentThreadListRequest as a7, type MultiAgentThreadSummaryEventOptions as a8, type NativePlatform as a9, type ResourcePolicySubjectRef as aA, type ResourcePolicySummary as aB, type ResourceSelector as aC, type ResponseFeedback as aD, type ResponseFeedbackResult as aE, type ResumeRunRequest as aF, type RunCancelOptions as aG, type RunContextOptions as aH, type RunStatus as aI, type RunTrace as aJ, type ServerAttachmentUploadOptions as aK, type ServerEmbedAttachmentUploadOptions as aL, type SetCustomerResourcePolicyAssignmentRequest as aM, type SetResourcePolicyQuotaScheduleRequest as aN, type StartRunResult as aO, type StateVariableDefinition as aP, type StreamRequestOptions as aQ, type StreamResult as aR, type ThreadDeleteOptions as aS, type ThreadDetailOptions as aT, type ThreadListOptions as aU, type ThreadSummaryEventOptions as aV, type TraceContent as aW, type TraceError as aX, type TraceSpan as aY, type TraceSpanKind as aZ, type TraceSpanStatus as a_, type NodeAuthoringSpec as aa, type NodeCatalogItem as ab, type NodeCatalogResponse as ac, type NodeSchemaResponse as ad, type PortableResourceKind as ae, type RequestOptions as af, type ResetResourcePolicyQuotaRequest as ag, type ResourceBundle as ah, type ResourceBundleCandidateList as ai, type ResourceBundleCandidateOptions as aj, type ResourceBundleDependency as ak, type ResourceBundleExportRequest as al, type ResourceBundleImportPreview as am, type ResourceBundleImportRequest as an, type ResourceBundleImportResult as ao, type ResourceBundleOrigin as ap, type ResourceBundlePlan as aq, type ResourceBundleResource as ar, type ResourcePackageArchive as as, type ResourcePackageCompileResult as at, type ResourcePackageDiagnostic as au, type ResourcePackageExportRequest as av, type ResourcePackageUpload as aw, type ResourcePolicyList as ax, type ResourcePolicyQuotaSchedule as ay, type ResourcePolicyQuotaScheduleResult as az, AgentDefinitionBuilder as b, type UpdateClientDeploymentRequest as b0, type WorkflowInputDefinition as b1, type AgentDefinitionOptions as c, type AgentListResponse as d, type AgentRef as e, type AgentResponse as f, type AgentStreamRequest as g, type AgentSummary as h, type AgentToolsetAttachment as i, type AgentUpdateRequest as j, type AgentValidationIssue as k, type AgentValidationResult as l, Agents24SDKError as m, type Agents24NodeErrorKind as n, type Agents24NodeOptions as o, type Agents24Options as p, type Agents24SDKErrorKind as q, type Agents24SDKSerializedError as r, type AttachRunRequest as s, type AttachmentContentAccessRequest as t, type BranchingHint as u, type ClientAuthMode as v, type ClientDeployment as w, type ClientDeploymentListQuery as x, type ClientDeploymentListResponse as y, type ClientNativeProfile as z };
1385
+ export { type EmbedAgentAliasResolution as $, Agents24 as A, type BackendSessionRequestOptions as B, type ClearCustomerResourcePolicyAssignmentResult as C, type ClientDeploymentListQuery as D, type ClientDeploymentListResponse as E, type ClientNativeProfile as F, type ClientRuntimeNativeProfileInput as G, type ClientRuntimeOidcConfig as H, type ClientRuntimePolicyInput as I, type ClientSessionCredentials as J, type ControlPlaneRunEventsResponse as K, type ConversationRunRequest as L, type ConversationRunResult as M, type ConversationRuntimeSelectionRequest as N, type ConversationRuntimeSelectionResult as O, type ConversationThreadOptions as P, type CreateBackendClientSessionRequest as Q, type CreateClientDeploymentRequest as R, type CustomerIdentityRequest as S, type CustomerPrincipalRefRequest as T, type CustomerProfile as U, type CustomerProfileList as V, type CustomerProfilePatch as W, type CustomerProfileSearchOptions as X, type CustomerResourcePolicyAssignment as Y, type EffectiveCustomerResourcePolicyRequest as Z, type EffectiveResourcePolicy as _, type AgentCreateRequest as a, type ResourcePackageImportUpload as a$, type EmbedAttachmentContentAccessRequest as a0, type EmbedCustomerPrincipalResolveRequest as a1, type EmbedCustomerPrincipalResolveResponse as a2, type EmbedResourcePolicyRequest as a3, type EmbedRunCancelOptions as a4, type EmbedRuntimeBootstrap as a5, type EmbedStreamRequest as a6, type EmbeddedResponseFeedbackInput as a7, type FailureCategory as a8, type FailureView as a9, type ResourceInstallation as aA, type ResourceInstallationApplyRequest as aB, type ResourceInstallationBinding as aC, type ResourceInstallationCreateRequest as aD, type ResourceInstallationDeploymentRequest as aE, type ResourceInstallationLinkRequest as aF, type ResourceInstallationList as aG, type ResourceInstallationOperation as aH, type ResourceInstallationPlan as aI, type ResourceInstallationPlanUpload as aJ, type ResourceInstallationPublication as aK, type ResourceInstallationPublishRequest as aL, type ResourceInstallationPullAcceptRequest as aM, type ResourceInstallationPullChange as aN, type ResourceInstallationPullPayload as aO, type ResourceInstallationPullPlan as aP, type ResourceInstallationResourceListOptions as aQ, type ResourceInstallationSecretStatus as aR, type ResourceInstallationSecretsRequest as aS, type ResourcePackageArchive as aT, type ResourcePackageCandidateOptions as aU, type ResourcePackageDependency as aV, type ResourcePackageDiagnostic as aW, type ResourcePackageExportPlan as aX, type ResourcePackageExportRequest as aY, type ResourcePackageImportPreview as aZ, type ResourcePackageImportResult as a_, type FeedbackRating as aa, type FeedbackReason as ab, GraphBuilder as ac, type GraphDefinition as ad, type GraphEdge as ae, type GraphHints as af, type GraphNode as ag, type GraphValueRef as ah, type HitlAction as ai, type HitlAnswer as aj, type LatestOrPinnedPolicy as ak, type McpAuthStartRequest as al, type McpAuthStartResult as am, type MultiAgentThreadListRequest as an, type MultiAgentThreadSummaryEventOptions as ao, type NativePlatform as ap, type NodeAuthoringSpec as aq, type NodeCatalogItem as ar, type NodeCatalogResponse as as, type NodeSchemaResponse as at, type PortableResourceKind as au, type RequestOptions as av, type ResetResourcePolicyQuotaRequest as aw, type ResourceCallableBinding as ax, type ResourceCallableBindingStatus as ay, type ResourceCandidateList as az, AgentDefinitionBuilder as b, type ResourcePackageUpload as b0, type ResourcePackageValidationResult as b1, type ResourcePolicyList as b2, type ResourcePolicyQuotaSchedule as b3, type ResourcePolicyQuotaScheduleResult as b4, type ResourcePolicySubjectRef as b5, type ResourcePolicySummary as b6, type ResourceSelector as b7, type ResourceToolExport as b8, type ResponseFeedback as b9, type ResponseFeedbackResult as ba, type ResumeRunRequest as bb, type RunCancelOptions as bc, type RunContextOptions as bd, type RunStatus as be, type RunTrace as bf, type ServerAttachmentUploadOptions as bg, type ServerEmbedAttachmentUploadOptions as bh, type SetCustomerResourcePolicyAssignmentRequest as bi, type SetResourcePolicyQuotaScheduleRequest as bj, type StartRunResult as bk, type StateVariableDefinition as bl, type StreamRequestOptions as bm, type StreamResult as bn, type ThreadDeleteOptions as bo, type ThreadDetailOptions as bp, type ThreadListOptions as bq, type ThreadSummaryEventOptions as br, type TraceContent as bs, type TraceError as bt, type TraceSpan as bu, type TraceSpanKind as bv, type TraceSpanStatus as bw, type TraceView as bx, type UpdateClientDeploymentRequest as by, type WorkflowInputDefinition as bz, type AgentDefinitionOptions as c, type AgentListResponse as d, type AgentRef as e, type AgentResponse as f, type AgentStreamRequest as g, type AgentSummary as h, type AgentToolsetAttachment as i, type AgentUpdateRequest as j, type AgentValidationIssue as k, type AgentValidationResult as l, Agents24SDKError as m, type Agents24NodeErrorKind as n, type Agents24NodeOptions as o, type Agents24Options as p, type Agents24SDKErrorKind as q, type Agents24SDKSerializedError as r, type ArtifactDevelopmentSession as s, type ArtifactDevelopmentSessionAdmission as t, type ArtifactDevelopmentSessionPrepareRequest as u, type AttachRunRequest as v, type AttachmentContentAccessRequest as w, type BranchingHint as x, type ClientAuthMode as y, type ClientDeployment as z };