@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.
- package/README.md +26 -2
- package/compatibility.json +6 -6
- package/dist/bff.cjs +468 -51
- package/dist/bff.cjs.map +1 -1
- package/dist/bff.d.cts +23 -4
- package/dist/bff.d.ts +23 -4
- package/dist/bff.js +468 -51
- package/dist/bff.js.map +1 -1
- package/dist/{client-C5ui84wi.d.cts → client-xWr_OGEe.d.cts} +285 -86
- package/dist/{client-C5ui84wi.d.ts → client-xWr_OGEe.d.ts} +285 -86
- package/dist/index.cjs +177 -65
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +2 -2
- package/dist/index.d.ts +2 -2
- package/dist/index.js +177 -65
- package/dist/index.js.map +1 -1
- package/dist/types/bff-agent-resolution.d.ts +41 -0
- package/dist/types/bff-agent-resolution.d.ts.map +1 -0
- package/dist/types/bff-errors.d.ts +3 -0
- package/dist/types/bff-errors.d.ts.map +1 -0
- package/dist/types/bff.d.ts +6 -20
- package/dist/types/bff.d.ts.map +1 -1
- package/dist/types/client.d.ts +2 -2
- package/dist/types/client.d.ts.map +1 -1
- package/dist/types/embed.d.ts +7 -1
- package/dist/types/embed.d.ts.map +1 -1
- package/dist/types/generated/customerProfiles.d.ts +11 -0
- package/dist/types/generated/customerProfiles.d.ts.map +1 -0
- package/dist/types/generated/manifest.d.ts +1 -1
- package/dist/types/generated/manifest.d.ts.map +1 -1
- package/dist/types/generated/resourceInstallations.d.ts +6 -2
- package/dist/types/generated/resourceInstallations.d.ts.map +1 -1
- package/dist/types/generated/resourcePackages.d.ts +7 -3
- package/dist/types/generated/resourcePackages.d.ts.map +1 -1
- package/dist/types/generated/resourcePolicies.d.ts +3 -3
- package/dist/types/generated/resourcePolicies.d.ts.map +1 -1
- package/dist/types/types.d.ts +255 -69
- package/dist/types/types.d.ts.map +1 -1
- package/package.json +2 -2
- package/dist/types/generated/resourceBundles.d.ts +0 -12
- 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
|
-
|
|
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
|
-
|
|
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
|
|
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:
|
|
685
|
-
callable_bindings:
|
|
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
|
|
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
|
|
722
|
-
format: "agents24.
|
|
818
|
+
type ResourcePackageExportPlan = {
|
|
819
|
+
format: "agents24.resource_package";
|
|
723
820
|
schema_version: "2.0";
|
|
724
|
-
|
|
725
|
-
resources:
|
|
726
|
-
|
|
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
|
-
|
|
729
|
-
|
|
730
|
-
|
|
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
|
-
|
|
733
|
-
|
|
734
|
-
|
|
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
|
-
|
|
739
|
-
|
|
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
|
-
|
|
745
|
-
external_references: ResourceBundleDependency[];
|
|
868
|
+
can_import: boolean;
|
|
746
869
|
};
|
|
747
|
-
type
|
|
748
|
-
|
|
749
|
-
|
|
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
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
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" | "
|
|
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
|
|
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 =
|
|
1096
|
+
type EffectiveCustomerResourcePolicyRequest = CustomerPrincipalRefRequest & {
|
|
898
1097
|
deployment_id: string;
|
|
899
1098
|
};
|
|
900
1099
|
type EmbedResourcePolicyRequest = {
|
|
901
1100
|
external_user_id: string;
|
|
902
|
-
|
|
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<
|
|
1113
|
-
|
|
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<
|
|
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:
|
|
1164
|
-
clearCustomerAssignment(request:
|
|
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 {
|
|
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 };
|