@agents24/node 0.4.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 +26 -2
  2. package/compatibility.json +6 -6
  3. package/dist/bff.cjs +468 -51
  4. package/dist/bff.cjs.map +1 -1
  5. package/dist/bff.d.cts +23 -4
  6. package/dist/bff.d.ts +23 -4
  7. package/dist/bff.js +468 -51
  8. package/dist/bff.js.map +1 -1
  9. package/dist/{client-C5ui84wi.d.cts → client-xWr_OGEe.d.cts} +285 -86
  10. package/dist/{client-C5ui84wi.d.ts → client-xWr_OGEe.d.ts} +285 -86
  11. package/dist/index.cjs +177 -65
  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 +177 -65
  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 -20
  22. package/dist/types/bff.d.ts.map +1 -1
  23. package/dist/types/client.d.ts +2 -2
  24. package/dist/types/client.d.ts.map +1 -1
  25. package/dist/types/embed.d.ts +7 -1
  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 +6 -2
  32. package/dist/types/generated/resourceInstallations.d.ts.map +1 -1
  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 +255 -69
  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,11 +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>;
82
81
  runtime_target?: "draft" | "published";
82
+ integration_id: string;
83
83
  };
84
84
  type AttachRunRequest = {
85
85
  external_user_id: string;
@@ -88,6 +88,7 @@ type AttachRunRequest = {
88
88
  client?: Record<string, unknown>;
89
89
  cursor?: number;
90
90
  runtime_target?: "draft" | "published";
91
+ integration_id: string;
91
92
  };
92
93
  type FeedbackRating = "like" | "dislike";
93
94
  type FeedbackReason = "incorrect" | "irrelevant" | "incomplete" | "unsafe" | "citation_issue" | "other";
@@ -109,6 +110,7 @@ type EmbeddedResponseFeedbackInput = {
109
110
  reason?: FeedbackReason | null;
110
111
  comment?: string | null;
111
112
  runtime_target?: "draft" | "published";
113
+ integration_id: string;
112
114
  };
113
115
  type HitlAction = "approve" | "reject" | "connect" | "skip" | "respond";
114
116
  type HitlAnswer = {
@@ -134,17 +136,28 @@ type McpAuthStartResult = {
134
136
  };
135
137
  type EmbedRuntimeBootstrap = {
136
138
  version: string;
137
- agent_name?: string;
139
+ agent_id: string;
140
+ agent_name: string;
141
+ agent_alias: string;
142
+ agent_aliases: string[];
138
143
  agent_version_id?: string;
139
144
  agent_version_number?: number;
140
145
  features: Record<string, unknown>;
141
146
  thread_events_path?: string | null;
142
147
  thread_events_url?: string | null;
143
148
  };
149
+ type EmbedAgentAliasResolution = {
150
+ agent_id: string;
151
+ agent_name: string;
152
+ agent_alias: string;
153
+ agent_aliases: string[];
154
+ };
144
155
  type MultiAgentThreadListRequest = {
145
156
  agent_ids: string[];
146
157
  external_user_id: string;
147
158
  external_session_id?: string | null;
159
+ runtime_target?: "draft" | "published";
160
+ integration_id: string;
148
161
  skip?: number;
149
162
  limit?: number;
150
163
  };
@@ -152,6 +165,7 @@ type ThreadListOptions = {
152
165
  externalUserId: string;
153
166
  externalSessionId?: string;
154
167
  runtimeTarget?: "draft" | "published";
168
+ integrationId: string;
155
169
  skip?: number;
156
170
  limit?: number;
157
171
  };
@@ -165,11 +179,13 @@ type ThreadDetailOptions = {
165
179
  subthreadDepth?: number;
166
180
  subthreadTurnLimit?: number;
167
181
  subthreadChildLimit?: number;
182
+ integrationId: string;
168
183
  };
169
184
  type RunContextOptions = {
170
185
  externalUserId: string;
171
186
  externalSessionId?: string;
172
187
  runtimeTarget?: "draft" | "published";
188
+ integrationId: string;
173
189
  };
174
190
  type RunCancelOptions = {
175
191
  externalUserId?: string;
@@ -180,11 +196,13 @@ type EmbedRunCancelOptions = {
180
196
  externalUserId?: string;
181
197
  externalSessionId?: string;
182
198
  runtimeTarget?: "draft" | "published";
199
+ integrationId: string;
183
200
  };
184
201
  type ThreadDeleteOptions = {
185
202
  externalUserId: string;
186
203
  externalSessionId?: string;
187
204
  runtimeTarget?: "draft" | "published";
205
+ integrationId: string;
188
206
  };
189
207
  type ThreadSummaryEventOptions = {
190
208
  externalUserId: string;
@@ -192,10 +210,47 @@ type ThreadSummaryEventOptions = {
192
210
  cursor?: number | null;
193
211
  signal?: AbortSignal;
194
212
  runtimeTarget?: "draft" | "published";
213
+ integrationId: string;
195
214
  };
196
215
  type MultiAgentThreadSummaryEventOptions = ThreadSummaryEventOptions & {
197
216
  agentIds: string[];
198
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
+ };
199
254
  type ServerAttachmentUploadOptions = {
200
255
  threadId?: string;
201
256
  agentVersionId?: string;
@@ -209,11 +264,13 @@ type EmbedAttachmentContentAccessRequest = AttachmentContentAccessRequest & {
209
264
  external_user_id: string;
210
265
  external_session_id?: string | null;
211
266
  runtime_target?: "draft" | "published";
267
+ integration_id: string;
212
268
  };
213
269
  type ServerEmbedAttachmentUploadOptions = ServerAttachmentUploadOptions & {
214
270
  externalUserId: string;
215
271
  externalSessionId?: string;
216
272
  runtimeTarget?: "draft" | "published";
273
+ integrationId: string;
217
274
  };
218
275
  type GraphValueRef = {
219
276
  namespace: "workflow_input" | "state" | "node_output";
@@ -341,6 +398,7 @@ type AgentValidationResult = {
341
398
  };
342
399
  type AgentCreateRequest = {
343
400
  name: string;
401
+ aliases?: string[];
344
402
  description?: string | null;
345
403
  tags?: string[];
346
404
  graph_definition: GraphDefinition;
@@ -352,6 +410,7 @@ type AgentSummary = {
352
410
  id: string;
353
411
  organization_id: string;
354
412
  name: string;
413
+ aliases: string[];
355
414
  description?: string | null;
356
415
  tags: string[];
357
416
  lifecycle_status: "active" | "deprecated" | "archived" | "disabled";
@@ -663,10 +722,38 @@ type ResourcePackageUpload = {
663
722
  data: Uint8Array;
664
723
  filename?: string;
665
724
  };
725
+ type ResourcePackageImportUpload = ResourcePackageUpload & {
726
+ mappings?: Record<string, string>;
727
+ };
666
728
  type ResourceInstallationPlanUpload = ResourcePackageUpload & {
667
- installationId?: string;
668
729
  prune?: boolean;
669
- development?: 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;
670
757
  };
671
758
  type ResourcePackageDiagnostic = {
672
759
  severity: "error" | "warning";
@@ -674,38 +761,42 @@ type ResourcePackageDiagnostic = {
674
761
  path: string;
675
762
  message: string;
676
763
  };
677
- 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 = {
678
786
  valid: boolean;
787
+ package_hash?: string;
679
788
  format: "agents24.resource_package";
680
789
  schema_version: "2.0";
681
790
  package: Record<string, unknown>;
682
791
  resources: Array<Record<string, unknown>>;
683
792
  requirements: string[];
684
- tool_exports: Array<Record<string, unknown>>;
685
- callable_bindings: Array<Record<string, unknown>>;
793
+ tool_exports: ResourceToolExport[];
794
+ callable_bindings: ResourceCallableBinding[];
686
795
  diagnostics: ResourcePackageDiagnostic[];
687
- bundle?: ResourceBundle | null;
688
- };
689
- type ResourceBundleImportRequest = {
690
- bundle: ResourceBundle;
691
- selected_resource_keys?: string[];
692
- mappings?: Record<string, string>;
693
- };
694
- type ResourceBundleOrigin = {
695
- source_id: string;
696
- target: "draft" | "version";
697
- version_id?: string | null;
698
- label: string;
699
796
  };
700
- type ResourceBundleResource = {
701
- resource_key: string;
702
- kind: PortableResourceKind;
703
- name: string;
704
- document: Record<string, unknown>;
705
- origin?: ResourceBundleOrigin;
706
- };
707
- type ResourceBundleDependency = {
797
+ type ResourcePackageDependency = {
708
798
  id: string;
799
+ requirement_key?: string | null;
709
800
  from_resource_key: string;
710
801
  to_resource_key?: string | null;
711
802
  kind: string;
@@ -717,45 +808,88 @@ type ResourceBundleDependency = {
717
808
  bundled: boolean;
718
809
  included?: boolean;
719
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;
720
817
  };
721
- type ResourceBundle = {
722
- format: "agents24.resource_bundle";
818
+ type ResourcePackageExportPlan = {
819
+ format: "agents24.resource_package";
723
820
  schema_version: "2.0";
724
- exported_at?: string;
725
- resources: ResourceBundleResource[];
726
- dependencies: ResourceBundleDependency[];
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
+ }>;
727
834
  warnings: string[];
728
- tool_exports?: Array<Record<string, unknown>>;
729
- callable_bindings?: Array<Record<string, unknown>>;
730
- content_sets?: Array<{
835
+ blockers: Array<{
836
+ code: string;
837
+ message: string;
838
+ }>;
839
+ can_export: boolean;
840
+ };
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<{
731
847
  resource_key: string;
732
- files: Array<{
733
- path: string;
734
- sha256: 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;
735
855
  }>;
736
856
  }>;
737
- };
738
- type ResourceBundlePlan = Omit<ResourceBundle, "resources"> & {
739
- resources: Array<Omit<ResourceBundleResource, "document">>;
857
+ dependencies: ResourcePackageDependency[];
858
+ suggested_mappings: Array<{
859
+ dependency_id: string;
860
+ id: string;
861
+ name: string;
862
+ }>;
863
+ warnings: string[];
740
864
  blockers: Array<{
741
865
  code: string;
742
866
  message: string;
743
867
  }>;
744
- can_export: boolean;
745
- external_references: ResourceBundleDependency[];
868
+ can_import: boolean;
746
869
  };
747
- type ResourceBundleExportRequest = {
748
- selectors: ResourceSelector[];
749
- included_resource_keys?: string[];
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[];
750
884
  };
751
- type ResourceBundleCandidateList = {
885
+ type ResourceCandidateList = {
752
886
  items: Array<{
753
887
  id: string;
754
888
  name: string;
755
889
  }>;
756
890
  total: number;
757
891
  };
758
- type ResourceBundleCandidateOptions = {
892
+ type ResourcePackageCandidateOptions = {
759
893
  kind: string;
760
894
  query?: string;
761
895
  limit?: number;
@@ -769,9 +903,25 @@ type ResourceInstallationBinding = {
769
903
  source_hash?: string | null;
770
904
  retained_orphan?: boolean;
771
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
+ };
772
921
  type ResourceInstallationOperation = {
773
922
  operation_id: string;
774
923
  installation_id: string;
924
+ package_id: string;
775
925
  status: "planned" | "applying" | "waiting" | "completed" | "failed";
776
926
  phase: string;
777
927
  result: Record<string, unknown>;
@@ -779,17 +929,22 @@ type ResourceInstallationOperation = {
779
929
  };
780
930
  type ResourceInstallation = {
781
931
  id: string;
932
+ package_id: string | null;
782
933
  package_name: string;
783
934
  primary_resource_key?: string | null;
784
935
  integration_mode: "bff" | "client-deployment" | "publish-only";
785
936
  client_deployment_id?: string | null;
786
937
  status: string;
787
- last_package_hash?: string | null;
938
+ synchronized_package_hash?: string | null;
788
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>;
789
943
  last_published_package_hash?: string | null;
790
944
  last_published_at?: string | null;
791
945
  publication_state?: "never_published" | "current" | "draft_changes";
792
946
  bindings?: ResourceInstallationBinding[];
947
+ callable_bindings?: ResourceCallableBindingStatus[];
793
948
  development_connections?: ArtifactDevelopmentSession[];
794
949
  remote_artifact_stages?: Array<{
795
950
  resource_key: string;
@@ -799,24 +954,32 @@ type ResourceInstallation = {
799
954
  manifest_hash: string;
800
955
  base_url?: string | null;
801
956
  }>;
802
- latest_operation?: ResourceInstallationOperation | null;
957
+ latest_apply?: ResourceInstallationOperation | null;
958
+ latest_pull?: ResourceInstallationPullPlan | null;
803
959
  };
804
960
  type ResourceInstallationList = {
805
961
  items: ResourceInstallation[];
806
962
  };
807
963
  type ResourceInstallationCreateRequest = {
964
+ package_id: string;
808
965
  package_name: string;
809
966
  operation_id: string;
810
967
  };
811
968
  type ResourceInstallationPlan = {
812
969
  installation_id: string | null;
813
970
  operation_id: string;
971
+ package_id: string;
814
972
  package_name: string;
815
973
  package_hash: string;
816
974
  actions: Array<Record<string, unknown>>;
817
975
  content: Array<Record<string, unknown>>;
818
976
  external_requirements: Array<Record<string, unknown>>;
819
977
  artifact_actions: Array<Record<string, unknown>>;
978
+ artifact_readiness: Array<{
979
+ resource_key: string;
980
+ status: string;
981
+ blocking: false;
982
+ }>;
820
983
  generated_tool_changes: Array<Record<string, unknown>>;
821
984
  publication_order: string[];
822
985
  deployment: Record<string, unknown>;
@@ -839,7 +1002,6 @@ type ResourceInstallationApplyRequest = {
839
1002
  secrets?: Record<string, string>;
840
1003
  primary_resource_key?: string;
841
1004
  integration_mode?: "bff" | "client-deployment" | "publish-only";
842
- development_sessions?: Record<string, string>;
843
1005
  };
844
1006
  type ResourceInstallationPublishRequest = {
845
1007
  package_hash: string;
@@ -861,10 +1023,13 @@ type ArtifactDevelopmentSession = {
861
1023
  installation_id: string;
862
1024
  resource_key: string;
863
1025
  artifact_id?: string | null;
864
- status: "prepared" | "connecting" | "verified_provisional" | "connected" | "disconnected" | "expired" | "superseded" | "revoked";
1026
+ status: "prepared" | "connecting" | "connected" | "disconnected" | "expired" | "superseded" | "revoked";
1027
+ contract_status: "unverified" | "verifying" | "healthy" | "stale";
865
1028
  machine_label?: string;
866
1029
  manifest_hash?: string | null;
867
1030
  last_heartbeat_at?: string | null;
1031
+ contract_checked_at?: string | null;
1032
+ failure_id?: string | null;
868
1033
  expires_at?: string | null;
869
1034
  };
870
1035
  type ArtifactDevelopmentSessionAdmission = ArtifactDevelopmentSession & {
@@ -891,15 +1056,49 @@ type CustomerIdentityRequest = {
891
1056
  issuer: string;
892
1057
  subject: string;
893
1058
  };
894
- 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 & {
895
1094
  policy_set_id: string;
896
1095
  };
897
- type EffectiveCustomerResourcePolicyRequest = CustomerIdentityRequest & {
1096
+ type EffectiveCustomerResourcePolicyRequest = CustomerPrincipalRefRequest & {
898
1097
  deployment_id: string;
899
1098
  };
900
1099
  type EmbedResourcePolicyRequest = {
901
1100
  external_user_id: string;
902
- external_user_issuer?: string;
1101
+ integration_id: string;
903
1102
  agent_version_id?: string;
904
1103
  runtime_target?: "draft" | "published";
905
1104
  };
@@ -929,6 +1128,7 @@ type ClearCustomerResourcePolicyAssignmentResult = {
929
1128
  cleared: boolean;
930
1129
  };
931
1130
  type EffectiveResourcePolicy = {
1131
+ agent_access_allowed?: boolean;
932
1132
  customer_principal_ref: string | null;
933
1133
  model_selection: {
934
1134
  selectable: boolean;
@@ -967,20 +1167,6 @@ type ResourcePolicyQuotaScheduleResult = {
967
1167
  subject_ref: ResourcePolicySubjectRef;
968
1168
  quota_schedule: ResourcePolicyQuotaSchedule;
969
1169
  };
970
- type ResourceBundleImportPreview = {
971
- resources: Array<Record<string, unknown>>;
972
- dependencies: Array<Record<string, unknown>>;
973
- warnings: unknown[];
974
- blockers: unknown[];
975
- can_import: boolean;
976
- [key: string]: unknown;
977
- };
978
- type ResourceBundleImportResult = {
979
- status: "created";
980
- resources: Array<Record<string, unknown>>;
981
- id_map: Record<string, string>;
982
- warnings: unknown[];
983
- };
984
1170
 
985
1171
  type RequestConfig = {
986
1172
  method?: string;
@@ -1081,11 +1267,17 @@ declare class EmbedNamespace {
1081
1267
  resumeAgentRun(agentId: string, runId: string, payload: ResumeRunRequest, options?: RequestOptions): Promise<RunResumeResult>;
1082
1268
  startAgentRunMcpAuth(agentId: string, runId: string, serverId: string, payload: McpAuthStartRequest, options?: RequestOptions): Promise<McpAuthStartResult>;
1083
1269
  getRuntimeBootstrap(agentId: string, agentVersionId?: string, runtimeTarget?: "draft" | "published"): Promise<EmbedRuntimeBootstrap>;
1270
+ resolveAgentAlias(agentAlias: string): Promise<EmbedAgentAliasResolution>;
1271
+ resolveCustomerPrincipal(request: EmbedCustomerPrincipalResolveRequest): Promise<EmbedCustomerPrincipalResolveResponse>;
1084
1272
  getResourcePolicy(agentId: string, request: EmbedResourcePolicyRequest): Promise<EffectiveResourcePolicy>;
1085
1273
  listAgentThreads(agentId: string, options: ThreadListOptions): Promise<ThreadsResponse>;
1086
1274
  listAgentThreadsMulti(options: MultiAgentThreadListRequest): Promise<ThreadsResponse>;
1087
1275
  subscribeAgentThreadEvents(agentId: string, options: ThreadSummaryEventOptions, onEvent: (event: ThreadSummaryEvent) => void | Promise<void>): Promise<void>;
1088
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>;
1089
1281
  getAgentThread(agentId: string, threadId: string, options: ThreadDetailOptions): Promise<ThreadDetail>;
1090
1282
  deleteAgentThread(agentId: string, threadId: string, options: ThreadDeleteOptions, requestOptions?: RequestOptions): Promise<ThreadDeleteResult>;
1091
1283
  getAgentRunContext(agentId: string, runId: string, options: RunContextOptions): Promise<RunContext>;
@@ -1095,22 +1287,16 @@ declare class EmbedNamespace {
1095
1287
  createAttachmentContentAccess(agentId: string, attachmentId: string, request: EmbedAttachmentContentAccessRequest, options?: RequestOptions): Promise<AttachmentContentAccess>;
1096
1288
  }
1097
1289
 
1098
- declare class ResourceBundlesNamespace {
1099
- protected readonly http: Agents24HttpClient;
1100
- constructor(http: Agents24HttpClient);
1101
- exportPlan(request: ResourceBundleExportRequest): Promise<ResourceBundlePlan>;
1102
- exportBundle(request: ResourceBundleExportRequest): Promise<ResourceBundle>;
1103
- candidates(options: ResourceBundleCandidateOptions): Promise<ResourceBundleCandidateList>;
1104
- importPreview(request: ResourceBundleImportRequest): Promise<ResourceBundleImportPreview>;
1105
- importBundle(request: ResourceBundleImportRequest, options?: RequestOptions): Promise<ResourceBundleImportResult>;
1106
- }
1107
-
1108
1290
  declare class ResourcePackagesNamespace {
1109
1291
  protected readonly http: Agents24HttpClient;
1110
1292
  constructor(http: Agents24HttpClient);
1293
+ getExportability(): Promise<Record<string, unknown>>;
1294
+ exportPlan(request: ResourcePackageExportRequest): Promise<ResourcePackageExportPlan>;
1111
1295
  exportPackage(request: ResourcePackageExportRequest): Promise<ResourcePackageArchive>;
1112
- validatePackage(upload: ResourcePackageUpload): Promise<ResourcePackageCompileResult>;
1113
- compilePackage(upload: ResourcePackageUpload): Promise<ResourcePackageCompileResult>;
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>;
1114
1300
  }
1115
1301
 
1116
1302
  declare class ResourceInstallationsNamespace {
@@ -1119,7 +1305,11 @@ declare class ResourceInstallationsNamespace {
1119
1305
  list(): Promise<ResourceInstallationList>;
1120
1306
  create(request: ResourceInstallationCreateRequest, options?: RequestOptions): Promise<ResourceInstallation>;
1121
1307
  get(installationId: string): Promise<ResourceInstallation>;
1308
+ getByPackageId(packageId: string): Promise<ResourceInstallation>;
1122
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>;
1123
1313
  link(installationId: string, request: ResourceInstallationLinkRequest, options?: RequestOptions): Promise<ResourceInstallationBinding>;
1124
1314
  configureSecrets(installationId: string, request: ResourceInstallationSecretsRequest, options?: RequestOptions): Promise<ResourceInstallationSecretStatus>;
1125
1315
  apply(operationId: string, request: ResourceInstallationApplyRequest, options?: RequestOptions): Promise<ResourceInstallationOperation>;
@@ -1129,7 +1319,7 @@ declare class ResourceInstallationsNamespace {
1129
1319
  developmentSessionStatus(installationId: string, resourceKey: string): Promise<ArtifactDevelopmentSession>;
1130
1320
  revokeDevelopmentSession(installationId: string, sessionId: string, options?: RequestOptions): Promise<ArtifactDevelopmentSession>;
1131
1321
  bindDeployment(installationId: string, request: ResourceInstallationDeploymentRequest, options?: RequestOptions): Promise<ResourceInstallation>;
1132
- resources(options: ResourceInstallationResourceListOptions): Promise<ResourceBundleCandidateList>;
1322
+ resources(options: ResourceInstallationResourceListOptions): Promise<ResourceCandidateList>;
1133
1323
  }
1134
1324
 
1135
1325
  declare class RunsNamespace {
@@ -1160,27 +1350,36 @@ declare class ResourcePoliciesNamespace {
1160
1350
  constructor(http: Agents24HttpClient);
1161
1351
  list(): Promise<ResourcePolicyList>;
1162
1352
  setCustomerAssignment(request: SetCustomerResourcePolicyAssignmentRequest, options?: RequestOptions): Promise<CustomerResourcePolicyAssignment>;
1163
- getCustomerAssignment(request: CustomerIdentityRequest): Promise<CustomerResourcePolicyAssignment>;
1164
- clearCustomerAssignment(request: CustomerIdentityRequest, options?: RequestOptions): Promise<ClearCustomerResourcePolicyAssignmentResult>;
1353
+ getCustomerAssignment(request: CustomerPrincipalRefRequest): Promise<CustomerResourcePolicyAssignment>;
1354
+ clearCustomerAssignment(request: CustomerPrincipalRefRequest, options?: RequestOptions): Promise<ClearCustomerResourcePolicyAssignmentResult>;
1165
1355
  getEffectiveCustomerPolicy(request: EffectiveCustomerResourcePolicyRequest): Promise<EffectiveResourcePolicy>;
1166
1356
  setQuotaSchedule(request: SetResourcePolicyQuotaScheduleRequest, options?: RequestOptions): Promise<ResourcePolicyQuotaScheduleResult>;
1167
1357
  resetQuotaNow(request: ResetResourcePolicyQuotaRequest, options?: RequestOptions): Promise<ResourcePolicyQuotaScheduleResult>;
1168
1358
  }
1169
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
+
1170
1369
  declare class Agents24 {
1171
1370
  readonly agents: AgentsNamespace;
1172
1371
  readonly embed: EmbedNamespace;
1173
1372
  readonly runs: RunsNamespace;
1174
- readonly resourceBundles: ResourceBundlesNamespace;
1175
1373
  readonly resourcePackages: ResourcePackagesNamespace;
1176
1374
  readonly resourceInstallations: ResourceInstallationsNamespace;
1177
1375
  readonly clientDeployments: ClientDeploymentsNamespace;
1178
1376
  readonly clientSessions: ClientSessionsNamespace;
1179
1377
  readonly instructions: InstructionsNamespace;
1180
1378
  readonly resourcePolicies: ResourcePoliciesNamespace;
1379
+ readonly customerProfiles: CustomerProfilesNamespace;
1181
1380
  constructor(options: Agents24NodeOptions);
1182
1381
  agent(options: AgentDefinitionOptions): AgentDefinitionBuilder;
1183
1382
  graph(): GraphBuilder;
1184
1383
  }
1185
1384
 
1186
- export { GraphBuilder 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 CreateBackendClientSessionRequest as L, type CreateClientDeploymentRequest as M, type CustomerIdentityRequest as N, type CustomerResourcePolicyAssignment as O, type EffectiveCustomerResourcePolicyRequest as P, type EffectiveResourcePolicy as Q, type EmbedAttachmentContentAccessRequest as R, type EmbedResourcePolicyRequest as S, type EmbedRunCancelOptions as T, type EmbedRuntimeBootstrap as U, type EmbedStreamRequest as V, type EmbeddedResponseFeedbackInput as W, type FailureCategory as X, type FailureView as Y, type FeedbackRating as Z, type FeedbackReason as _, type AgentCreateRequest as a, type RunTrace as a$, type GraphDefinition as a0, type GraphEdge as a1, type GraphHints as a2, type GraphNode as a3, type GraphValueRef as a4, type HitlAction as a5, type HitlAnswer as a6, type LatestOrPinnedPolicy as a7, type McpAuthStartRequest as a8, type McpAuthStartResult as a9, type ResourceInstallationLinkRequest as aA, type ResourceInstallationList as aB, type ResourceInstallationOperation as aC, type ResourceInstallationPlan as aD, type ResourceInstallationPlanUpload as aE, type ResourceInstallationPublication as aF, type ResourceInstallationPublishRequest as aG, type ResourceInstallationResourceListOptions as aH, type ResourceInstallationSecretStatus as aI, type ResourceInstallationSecretsRequest as aJ, type ResourcePackageArchive as aK, type ResourcePackageCompileResult as aL, type ResourcePackageDiagnostic as aM, type ResourcePackageExportRequest as aN, type ResourcePackageUpload as aO, type ResourcePolicyList as aP, type ResourcePolicyQuotaSchedule as aQ, type ResourcePolicyQuotaScheduleResult as aR, type ResourcePolicySubjectRef as aS, type ResourcePolicySummary as aT, type ResourceSelector as aU, type ResponseFeedback as aV, type ResponseFeedbackResult as aW, type ResumeRunRequest as aX, type RunCancelOptions as aY, type RunContextOptions as aZ, type RunStatus as a_, type MultiAgentThreadListRequest as aa, type MultiAgentThreadSummaryEventOptions as ab, type NativePlatform as ac, type NodeAuthoringSpec as ad, type NodeCatalogItem as ae, type NodeCatalogResponse as af, type NodeSchemaResponse as ag, type PortableResourceKind as ah, type RequestOptions as ai, type ResetResourcePolicyQuotaRequest as aj, type ResourceBundle as ak, type ResourceBundleCandidateList as al, type ResourceBundleCandidateOptions as am, type ResourceBundleDependency as an, type ResourceBundleExportRequest as ao, type ResourceBundleImportPreview as ap, type ResourceBundleImportRequest as aq, type ResourceBundleImportResult as ar, type ResourceBundleOrigin as as, type ResourceBundlePlan as at, type ResourceBundleResource as au, type ResourceInstallation as av, type ResourceInstallationApplyRequest as aw, type ResourceInstallationBinding as ax, type ResourceInstallationCreateRequest as ay, type ResourceInstallationDeploymentRequest as az, AgentDefinitionBuilder as b, type ServerAttachmentUploadOptions as b0, type ServerEmbedAttachmentUploadOptions as b1, type SetCustomerResourcePolicyAssignmentRequest as b2, type SetResourcePolicyQuotaScheduleRequest as b3, type StartRunResult as b4, type StateVariableDefinition as b5, type StreamRequestOptions as b6, type StreamResult as b7, type ThreadDeleteOptions as b8, type ThreadDetailOptions as b9, type ThreadListOptions as ba, type ThreadSummaryEventOptions as bb, type TraceContent as bc, type TraceError as bd, type TraceSpan as be, type TraceSpanKind as bf, type TraceSpanStatus as bg, type TraceView as bh, type UpdateClientDeploymentRequest as bi, type WorkflowInputDefinition as bj, 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 };
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 };