@tangle-network/agent-integrations 0.14.0 → 0.15.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/dist/index.d.ts CHANGED
@@ -53,6 +53,314 @@ declare function summarizeIntegrationRegistry(registry: IntegrationRegistry): In
53
53
  declare function canonicalConnectorId(id: string, aliases?: Record<string, string>): string;
54
54
  declare function inferIntegrationSupportTier(connector: IntegrationConnector): IntegrationSupportTier;
55
55
 
56
+ type IntegrationAuditEventType = 'connection.created' | 'connection.updated' | 'connection.revoked' | 'grant.created' | 'grant.revoked' | 'capability.issued' | 'action.invoked' | 'action.failed' | 'trigger.subscribed' | 'trigger.received' | 'workflow.installed' | 'approval.requested' | 'approval.resolved' | 'healthcheck.completed';
57
+ interface IntegrationAuditEvent {
58
+ id: string;
59
+ type: IntegrationAuditEventType;
60
+ occurredAt: string;
61
+ actor?: IntegrationActor;
62
+ connectionId?: string;
63
+ providerId?: string;
64
+ connectorId?: string;
65
+ action?: string;
66
+ risk?: IntegrationConnectorAction['risk'];
67
+ dataClass?: IntegrationDataClass;
68
+ ok?: boolean;
69
+ message?: string;
70
+ metadata?: Record<string, unknown>;
71
+ }
72
+ interface IntegrationAuditSink {
73
+ record(event: IntegrationAuditEvent): Promise<void> | void;
74
+ }
75
+ interface IntegrationAuditStore extends IntegrationAuditSink {
76
+ list(filter?: IntegrationAuditFilter): Promise<IntegrationAuditEvent[]> | IntegrationAuditEvent[];
77
+ }
78
+ interface IntegrationAuditFilter {
79
+ type?: IntegrationAuditEventType;
80
+ actor?: IntegrationActor;
81
+ connectionId?: string;
82
+ providerId?: string;
83
+ connectorId?: string;
84
+ action?: string;
85
+ }
86
+ declare class InMemoryIntegrationAuditStore implements IntegrationAuditStore {
87
+ private readonly events;
88
+ record(event: IntegrationAuditEvent): void;
89
+ list(filter?: IntegrationAuditFilter): IntegrationAuditEvent[];
90
+ }
91
+ declare function createIntegrationAuditEvent(input: Omit<IntegrationAuditEvent, 'id' | 'occurredAt'> & {
92
+ id?: string;
93
+ occurredAt?: string | Date;
94
+ now?: () => Date;
95
+ }): IntegrationAuditEvent;
96
+ declare function createAuditingActionGuard(options: {
97
+ sink: IntegrationAuditSink;
98
+ subject?: IntegrationActor;
99
+ now?: () => Date;
100
+ includeInputPreview?: boolean;
101
+ }): IntegrationActionGuard;
102
+ declare function sanitizeAuditConnection(connection: IntegrationConnection): Record<string, unknown>;
103
+
104
+ type IntegrationApprovalStatus = 'pending' | 'approved' | 'denied' | 'expired';
105
+ interface IntegrationApprovalRecord {
106
+ id: string;
107
+ request: IntegrationApprovalRequest;
108
+ status: IntegrationApprovalStatus;
109
+ requestedAt: string;
110
+ resolvedAt?: string;
111
+ resolvedBy?: IntegrationActor;
112
+ reason?: string;
113
+ expiresAt?: string;
114
+ metadata?: Record<string, unknown>;
115
+ }
116
+ interface IntegrationApprovalStore {
117
+ get(approvalId: string): Promise<IntegrationApprovalRecord | undefined> | IntegrationApprovalRecord | undefined;
118
+ put(record: IntegrationApprovalRecord): Promise<void> | void;
119
+ list(filter?: IntegrationApprovalFilter): Promise<IntegrationApprovalRecord[]> | IntegrationApprovalRecord[];
120
+ }
121
+ interface IntegrationApprovalFilter {
122
+ status?: IntegrationApprovalStatus;
123
+ connectionId?: string;
124
+ connectorId?: string;
125
+ action?: string;
126
+ actor?: IntegrationActor;
127
+ }
128
+ interface ApprovalBackedPolicyOptions {
129
+ base: IntegrationPolicyEngine;
130
+ store: IntegrationApprovalStore;
131
+ audit?: IntegrationAuditSink;
132
+ now?: () => Date;
133
+ approvalTtlMs?: number;
134
+ }
135
+ declare class InMemoryIntegrationApprovalStore implements IntegrationApprovalStore {
136
+ private readonly records;
137
+ get(approvalId: string): IntegrationApprovalRecord | undefined;
138
+ put(record: IntegrationApprovalRecord): void;
139
+ list(filter?: IntegrationApprovalFilter): IntegrationApprovalRecord[];
140
+ }
141
+ declare class ApprovalBackedPolicyEngine implements IntegrationPolicyEngine {
142
+ private readonly base;
143
+ private readonly store;
144
+ private readonly audit;
145
+ private readonly now;
146
+ private readonly approvalTtlMs;
147
+ constructor(options: ApprovalBackedPolicyOptions);
148
+ decide(ctx: IntegrationGuardContext & {
149
+ subject: IntegrationActor;
150
+ }): Promise<IntegrationPolicyDecision>;
151
+ private findApprovedRecord;
152
+ }
153
+ declare function createApprovalBackedPolicyEngine(options: ApprovalBackedPolicyOptions): ApprovalBackedPolicyEngine;
154
+ declare function resolveIntegrationApproval(input: {
155
+ store: IntegrationApprovalStore;
156
+ approvalId: string;
157
+ approved: boolean;
158
+ resolvedBy: IntegrationActor;
159
+ reason?: string;
160
+ metadata?: Record<string, unknown>;
161
+ audit?: IntegrationAuditSink;
162
+ now?: () => Date;
163
+ }): Promise<IntegrationApprovalRecord>;
164
+
165
+ interface IntegrationToolDefinition {
166
+ name: string;
167
+ title: string;
168
+ description: string;
169
+ providerId: string;
170
+ connectorId: string;
171
+ connectorTitle: string;
172
+ category: IntegrationConnectorCategory;
173
+ action: IntegrationConnectorAction;
174
+ risk: IntegrationActionRisk;
175
+ dataClass: IntegrationDataClass;
176
+ requiredScopes: string[];
177
+ inputSchema?: unknown;
178
+ outputSchema?: unknown;
179
+ tags: string[];
180
+ }
181
+ interface IntegrationToolSearchFilters {
182
+ providerId?: string;
183
+ connectorId?: string;
184
+ category?: IntegrationConnectorCategory;
185
+ maxRisk?: IntegrationActionRisk;
186
+ dataClass?: IntegrationDataClass;
187
+ limit?: number;
188
+ }
189
+ interface IntegrationToolSearchResult {
190
+ tool: IntegrationToolDefinition;
191
+ score: number;
192
+ matched: string[];
193
+ }
194
+ interface McpToolDefinition {
195
+ name: string;
196
+ description: string;
197
+ inputSchema: unknown;
198
+ }
199
+ declare function integrationToolName(providerId: string, connectorId: string, actionId: string): string;
200
+ declare function parseIntegrationToolName(name: string): {
201
+ providerId: string;
202
+ connectorId: string;
203
+ actionId: string;
204
+ };
205
+ declare function buildIntegrationToolCatalog(connectors: IntegrationConnector[]): IntegrationToolDefinition[];
206
+ declare function searchIntegrationTools(catalog: IntegrationToolDefinition[], query: string, filters?: IntegrationToolSearchFilters): IntegrationToolSearchResult[];
207
+ declare function toMcpTools(tools: IntegrationToolDefinition[]): McpToolDefinition[];
208
+
209
+ type IntegrationRequirementMode = 'read' | 'write' | 'trigger';
210
+ type IntegrationRequirementStatus = 'ready' | 'missing_connection' | 'not_executable' | 'unknown_connector';
211
+ interface IntegrationRequirement {
212
+ id: string;
213
+ connectorId: string;
214
+ reason: string;
215
+ mode: IntegrationRequirementMode;
216
+ requiredActions?: string[];
217
+ requiredTriggers?: string[];
218
+ requiredScopes?: string[];
219
+ optional?: boolean;
220
+ }
221
+ interface IntegrationManifest {
222
+ id: string;
223
+ title?: string;
224
+ owner?: IntegrationActor;
225
+ requirements: IntegrationRequirement[];
226
+ metadata?: Record<string, unknown>;
227
+ }
228
+ interface IntegrationRequirementResolution {
229
+ requirement: IntegrationRequirement;
230
+ status: IntegrationRequirementStatus;
231
+ connector?: IntegrationConnector;
232
+ registryEntry?: IntegrationRegistryEntry;
233
+ connection?: IntegrationConnection;
234
+ missingScopes: string[];
235
+ missingActions: string[];
236
+ missingTriggers: string[];
237
+ message: string;
238
+ }
239
+ interface IntegrationManifestResolution {
240
+ manifest: IntegrationManifest;
241
+ owner: IntegrationActor;
242
+ ready: IntegrationRequirementResolution[];
243
+ missing: IntegrationRequirementResolution[];
244
+ optionalMissing: IntegrationRequirementResolution[];
245
+ }
246
+ interface IntegrationGrant {
247
+ id: string;
248
+ manifestId: string;
249
+ requirementId: string;
250
+ owner: IntegrationActor;
251
+ grantee: IntegrationActor;
252
+ connectionId: string;
253
+ connectorId: string;
254
+ scopes: string[];
255
+ allowedActions: string[];
256
+ allowedTriggers: string[];
257
+ status: 'active' | 'revoked';
258
+ createdAt: string;
259
+ updatedAt: string;
260
+ metadata?: Record<string, unknown>;
261
+ }
262
+ interface IntegrationGrantStore {
263
+ get(grantId: string): Promise<IntegrationGrant | undefined> | IntegrationGrant | undefined;
264
+ put(grant: IntegrationGrant): Promise<void> | void;
265
+ listByManifest(manifestId: string, grantee?: IntegrationActor): Promise<IntegrationGrant[]> | IntegrationGrant[];
266
+ listByGrantee(grantee: IntegrationActor): Promise<IntegrationGrant[]> | IntegrationGrant[];
267
+ delete?(grantId: string): Promise<void> | void;
268
+ }
269
+ interface IntegrationCapabilityBinding {
270
+ requirementId: string;
271
+ connectorId: string;
272
+ connectionId: string;
273
+ grantId: string;
274
+ scopes: string[];
275
+ allowedActions: string[];
276
+ allowedTriggers: string[];
277
+ capability: IssuedIntegrationCapability;
278
+ }
279
+ interface IntegrationSandboxBundle {
280
+ manifestId: string;
281
+ subject: IntegrationActor;
282
+ capabilities: IntegrationCapabilityBinding[];
283
+ connectors: IntegrationConnector[];
284
+ tools: IntegrationToolDefinition[];
285
+ expiresAt: string;
286
+ }
287
+ interface IntegrationRuntimeHub {
288
+ listRegistry(): Promise<IntegrationRegistry> | IntegrationRegistry;
289
+ listConnections(owner: IntegrationActor): Promise<IntegrationConnection[]> | IntegrationConnection[];
290
+ issueCapability(input: {
291
+ subject: IntegrationActor;
292
+ connectionId: string;
293
+ scopes: string[];
294
+ allowedActions: string[];
295
+ ttlMs: number;
296
+ metadata?: Record<string, unknown>;
297
+ }): Promise<IssuedIntegrationCapability> | IssuedIntegrationCapability;
298
+ }
299
+ interface IntegrationRuntimeOptions {
300
+ hub: IntegrationRuntimeHub;
301
+ grants?: IntegrationGrantStore;
302
+ now?: () => Date;
303
+ }
304
+ declare class InMemoryIntegrationGrantStore implements IntegrationGrantStore {
305
+ private readonly grants;
306
+ get(grantId: string): IntegrationGrant | undefined;
307
+ put(grant: IntegrationGrant): void;
308
+ listByManifest(manifestId: string, grantee?: IntegrationActor): IntegrationGrant[];
309
+ listByGrantee(grantee: IntegrationActor): IntegrationGrant[];
310
+ delete(grantId: string): void;
311
+ }
312
+ declare class IntegrationRuntime {
313
+ private readonly hub;
314
+ private readonly grants;
315
+ private readonly now;
316
+ constructor(options: IntegrationRuntimeOptions);
317
+ registry(): Promise<IntegrationRegistry>;
318
+ resolveManifest(manifest: IntegrationManifest, owner: IntegrationActor): Promise<IntegrationManifestResolution>;
319
+ createGrants(input: {
320
+ manifest: IntegrationManifest;
321
+ owner: IntegrationActor;
322
+ grantee: IntegrationActor;
323
+ metadata?: Record<string, unknown>;
324
+ }): Promise<IntegrationGrant[]>;
325
+ buildSandboxBundle(input: {
326
+ manifestId: string;
327
+ subject: IntegrationActor;
328
+ ttlMs: number;
329
+ grantee?: IntegrationActor;
330
+ }): Promise<IntegrationSandboxBundle>;
331
+ }
332
+ declare function createIntegrationRuntime(options: IntegrationRuntimeOptions): IntegrationRuntime;
333
+
334
+ declare const DEFAULT_INTEGRATION_BRIDGE_ENV = "TANGLE_INTEGRATION_BUNDLE";
335
+ interface IntegrationBridgePayload {
336
+ version: 1;
337
+ manifestId: string;
338
+ subject: IntegrationSandboxBundle['subject'];
339
+ expiresAt: string;
340
+ tools: IntegrationBridgeToolBinding[];
341
+ }
342
+ interface IntegrationBridgeToolBinding {
343
+ name: string;
344
+ title: string;
345
+ connectorId: string;
346
+ connectionId: string;
347
+ action: string;
348
+ risk: string;
349
+ dataClass: string;
350
+ requiredScopes: string[];
351
+ capabilityToken: string;
352
+ }
353
+ declare function buildIntegrationBridgePayload(bundle: IntegrationSandboxBundle): IntegrationBridgePayload;
354
+ declare function encodeIntegrationBridgePayload(payload: IntegrationBridgePayload): string;
355
+ declare function decodeIntegrationBridgePayload(encoded: string): IntegrationBridgePayload;
356
+ declare function buildIntegrationBridgeEnvironment(bundle: IntegrationSandboxBundle, options?: {
357
+ envVar?: string;
358
+ }): Record<string, string>;
359
+ declare function parseIntegrationBridgeEnvironment(env: Record<string, string | undefined>, options?: {
360
+ envVar?: string;
361
+ }): IntegrationBridgePayload;
362
+ declare function redactIntegrationBridgePayload(payload: IntegrationBridgePayload): IntegrationBridgePayload;
363
+
56
364
  /**
57
365
  * Connector primitives — the contract a concrete first-party integration
58
366
  * (Google Calendar, HubSpot, Stripe, ...) implements. Lower level than the
@@ -436,6 +744,238 @@ interface ConnectorManifestValidationResult {
436
744
  declare function validateConnectorManifest(manifest: ConnectorManifest): ConnectorManifestValidationResult;
437
745
  declare function assertValidConnectorManifest(manifest: ConnectorManifest): void;
438
746
 
747
+ interface ConnectorAdapterProviderOptions {
748
+ id?: string;
749
+ kind?: IntegrationProviderKind;
750
+ adapters: ConnectorAdapter[];
751
+ resolveDataSource: (connection: IntegrationConnection) => Promise<ResolvedDataSource> | ResolvedDataSource;
752
+ now?: () => Date;
753
+ }
754
+ declare function createConnectorAdapterProvider(options: ConnectorAdapterProviderOptions): IntegrationProvider;
755
+ declare function manifestToConnector(providerId: string, adapter: ConnectorAdapter): IntegrationConnector;
756
+
757
+ interface IntegrationSecretStore {
758
+ get(ref: SecretRef): Promise<ConnectorCredentials | undefined> | ConnectorCredentials | undefined;
759
+ put(ref: SecretRef, credentials: ConnectorCredentials): Promise<void> | void;
760
+ delete?(ref: SecretRef): Promise<void> | void;
761
+ }
762
+ interface ConnectionCredentialResolverOptions {
763
+ secrets: IntegrationSecretStore;
764
+ connections?: IntegrationConnectionStore;
765
+ adapters?: ConnectorAdapter[];
766
+ now?: () => Date;
767
+ markConnectionError?: (connection: IntegrationConnection, error: Error) => Promise<void> | void;
768
+ }
769
+ declare class InMemoryIntegrationSecretStore implements IntegrationSecretStore {
770
+ private readonly secrets;
771
+ get(ref: SecretRef): ConnectorCredentials | undefined;
772
+ put(ref: SecretRef, credentials: ConnectorCredentials): void;
773
+ delete(ref: SecretRef): void;
774
+ }
775
+ declare function createConnectionCredentialResolver(options: ConnectionCredentialResolverOptions): (connection: IntegrationConnection) => Promise<ResolvedDataSource>;
776
+ declare function resolveConnectionCredentials(input: IntegrationConnection, options: ConnectionCredentialResolverOptions): Promise<ConnectorCredentials>;
777
+ declare function createCredentialBackedAdapterProvider(options: Omit<ConnectorAdapterProviderOptions, 'resolveDataSource'> & ConnectionCredentialResolverOptions): IntegrationProvider;
778
+ declare function revokeConnection(input: {
779
+ connection: IntegrationConnection;
780
+ connections?: IntegrationConnectionStore;
781
+ secrets?: IntegrationSecretStore;
782
+ now?: () => Date;
783
+ }): Promise<IntegrationConnection>;
784
+
785
+ interface IntegrationWorkflowDefinition {
786
+ id: string;
787
+ title?: string;
788
+ manifest: IntegrationManifest;
789
+ trigger: {
790
+ requirementId: string;
791
+ triggerId: string;
792
+ targetUrl?: string;
793
+ };
794
+ metadata?: Record<string, unknown>;
795
+ }
796
+ interface InstalledIntegrationWorkflow {
797
+ id: string;
798
+ workflowId: string;
799
+ manifestId: string;
800
+ owner: IntegrationActor;
801
+ grantee: IntegrationActor;
802
+ triggerGrantId: string;
803
+ subscription: IntegrationTriggerSubscription;
804
+ status: 'active' | 'paused' | 'error';
805
+ createdAt: string;
806
+ metadata?: Record<string, unknown>;
807
+ }
808
+ interface IntegrationWorkflowStore {
809
+ put(workflow: InstalledIntegrationWorkflow): Promise<void> | void;
810
+ get(id: string): Promise<InstalledIntegrationWorkflow | undefined> | InstalledIntegrationWorkflow | undefined;
811
+ list(): Promise<InstalledIntegrationWorkflow[]> | InstalledIntegrationWorkflow[];
812
+ listByWorkflow(workflowId: string): Promise<InstalledIntegrationWorkflow[]> | InstalledIntegrationWorkflow[];
813
+ listByOwner(owner: IntegrationActor): Promise<InstalledIntegrationWorkflow[]> | InstalledIntegrationWorkflow[];
814
+ }
815
+ interface IntegrationWorkflowRuntimeHub {
816
+ subscribeTrigger(connectionId: string, trigger: string, targetUrl?: string): Promise<IntegrationTriggerSubscription> | IntegrationTriggerSubscription;
817
+ }
818
+ interface IntegrationWorkflowRuntimeOptions {
819
+ runtime: IntegrationRuntime;
820
+ hub: IntegrationWorkflowRuntimeHub;
821
+ grants: IntegrationGrantStore;
822
+ store?: IntegrationWorkflowStore;
823
+ now?: () => Date;
824
+ }
825
+ declare class InMemoryIntegrationWorkflowStore implements IntegrationWorkflowStore {
826
+ private readonly workflows;
827
+ put(workflow: InstalledIntegrationWorkflow): void;
828
+ get(id: string): InstalledIntegrationWorkflow | undefined;
829
+ list(): InstalledIntegrationWorkflow[];
830
+ listByWorkflow(workflowId: string): InstalledIntegrationWorkflow[];
831
+ listByOwner(owner: IntegrationActor): InstalledIntegrationWorkflow[];
832
+ }
833
+ declare class IntegrationWorkflowRuntime {
834
+ private readonly runtime;
835
+ private readonly hub;
836
+ private readonly grants;
837
+ private readonly store;
838
+ private readonly now;
839
+ constructor(options: IntegrationWorkflowRuntimeOptions);
840
+ install(input: {
841
+ workflow: IntegrationWorkflowDefinition;
842
+ owner: IntegrationActor;
843
+ grantee: IntegrationActor;
844
+ }): Promise<InstalledIntegrationWorkflow>;
845
+ dispatchEvent<T = unknown>(event: IntegrationTriggerEvent<T>, handler: (input: {
846
+ event: IntegrationTriggerEvent<T>;
847
+ workflows: InstalledIntegrationWorkflow[];
848
+ }) => Promise<void> | void): Promise<{
849
+ matched: InstalledIntegrationWorkflow[];
850
+ }>;
851
+ }
852
+ declare function createIntegrationWorkflowRuntime(options: IntegrationWorkflowRuntimeOptions): IntegrationWorkflowRuntime;
853
+
854
+ interface StoredIntegrationEvent {
855
+ id: string;
856
+ sourceId: string;
857
+ connectorId: string;
858
+ eventType: string;
859
+ providerEventId?: string;
860
+ receivedAt: string;
861
+ payload: Record<string, unknown>;
862
+ dispatchedAt?: string;
863
+ metadata?: Record<string, unknown>;
864
+ }
865
+ interface IntegrationEventStore {
866
+ put(event: StoredIntegrationEvent): Promise<void> | void;
867
+ hasProviderEvent(sourceId: string, providerEventId: string): Promise<boolean> | boolean;
868
+ list(): Promise<StoredIntegrationEvent[]> | StoredIntegrationEvent[];
869
+ }
870
+ interface IntegrationWebhookReceiverResult {
871
+ status: number;
872
+ body: unknown;
873
+ headers?: Record<string, string>;
874
+ received: StoredIntegrationEvent[];
875
+ duplicates: StoredIntegrationEvent[];
876
+ }
877
+ declare class InMemoryIntegrationEventStore implements IntegrationEventStore {
878
+ private readonly events;
879
+ private readonly providerIds;
880
+ put(event: StoredIntegrationEvent): void;
881
+ hasProviderEvent(sourceId: string, providerEventId: string): boolean;
882
+ list(): StoredIntegrationEvent[];
883
+ }
884
+ declare function receiveIntegrationWebhook(input: {
885
+ adapter: ConnectorAdapter;
886
+ source: ResolvedDataSource;
887
+ rawBody: string;
888
+ headers: Record<string, string | string[] | undefined>;
889
+ store: IntegrationEventStore;
890
+ workflowRuntime?: IntegrationWorkflowRuntime;
891
+ now?: () => Date;
892
+ }): Promise<IntegrationWebhookReceiverResult>;
893
+ declare function storedEventToTriggerEvent(event: StoredIntegrationEvent, source: ResolvedDataSource): IntegrationTriggerEvent;
894
+
895
+ interface IntegrationIdempotencyRecord {
896
+ key: string;
897
+ requestHash: string;
898
+ result: IntegrationActionResult;
899
+ createdAt: string;
900
+ }
901
+ interface IntegrationIdempotencyStore {
902
+ get(key: string): Promise<IntegrationIdempotencyRecord | undefined> | IntegrationIdempotencyRecord | undefined;
903
+ put(record: IntegrationIdempotencyRecord): Promise<void> | void;
904
+ }
905
+ interface IntegrationRateLimitDecision {
906
+ allowed: boolean;
907
+ retryAfterMs?: number;
908
+ reason?: string;
909
+ }
910
+ interface IntegrationRateLimiter {
911
+ check(ctx: IntegrationGuardContext): Promise<IntegrationRateLimitDecision> | IntegrationRateLimitDecision;
912
+ }
913
+ declare class InMemoryIntegrationIdempotencyStore implements IntegrationIdempotencyStore {
914
+ private readonly records;
915
+ get(key: string): IntegrationIdempotencyRecord | undefined;
916
+ put(record: IntegrationIdempotencyRecord): void;
917
+ }
918
+ declare class DefaultIntegrationActionGuard implements IntegrationActionGuard {
919
+ private readonly idempotency;
920
+ private readonly audit;
921
+ private readonly rateLimiter;
922
+ private readonly now;
923
+ constructor(options?: {
924
+ idempotency?: IntegrationIdempotencyStore;
925
+ audit?: IntegrationAuditSink;
926
+ rateLimiter?: IntegrationRateLimiter;
927
+ now?: () => Date;
928
+ });
929
+ invokeAction(ctx: IntegrationGuardContext, proceed: () => Promise<IntegrationActionResult>): Promise<IntegrationActionResult>;
930
+ private writeIdempotency;
931
+ }
932
+ declare function createDefaultIntegrationActionGuard(options?: ConstructorParameters<typeof DefaultIntegrationActionGuard>[0]): DefaultIntegrationActionGuard;
933
+
934
+ type IntegrationHealthcheckStatus = 'healthy' | 'degraded' | 'unhealthy' | 'unknown';
935
+ interface IntegrationHealthcheckCheck {
936
+ id: string;
937
+ status: IntegrationHealthcheckStatus;
938
+ message: string;
939
+ metadata?: Record<string, unknown>;
940
+ }
941
+ interface IntegrationHealthcheckResult {
942
+ connectionId: string;
943
+ providerId: string;
944
+ connectorId: string;
945
+ status: IntegrationHealthcheckStatus;
946
+ checkedAt: string;
947
+ checks: IntegrationHealthcheckCheck[];
948
+ metadata?: Record<string, unknown>;
949
+ }
950
+ interface IntegrationHealthcheckStore {
951
+ put(result: IntegrationHealthcheckResult): Promise<void> | void;
952
+ get(connectionId: string): Promise<IntegrationHealthcheckResult | undefined> | IntegrationHealthcheckResult | undefined;
953
+ list(): Promise<IntegrationHealthcheckResult[]> | IntegrationHealthcheckResult[];
954
+ }
955
+ declare class InMemoryIntegrationHealthcheckStore implements IntegrationHealthcheckStore {
956
+ private readonly results;
957
+ put(result: IntegrationHealthcheckResult): void;
958
+ get(connectionId: string): IntegrationHealthcheckResult | undefined;
959
+ list(): IntegrationHealthcheckResult[];
960
+ }
961
+ declare function runIntegrationHealthcheck(input: {
962
+ connection: IntegrationConnection;
963
+ connector?: IntegrationConnector;
964
+ registry?: IntegrationRegistry;
965
+ test?: (connection: IntegrationConnection, connector: IntegrationConnector) => Promise<IntegrationActionResult | boolean> | IntegrationActionResult | boolean;
966
+ audit?: IntegrationAuditSink;
967
+ now?: () => Date;
968
+ }): Promise<IntegrationHealthcheckResult>;
969
+ declare function runIntegrationHealthchecks(input: {
970
+ connections: IntegrationConnection[];
971
+ registry?: IntegrationRegistry;
972
+ store?: IntegrationHealthcheckStore;
973
+ audit?: IntegrationAuditSink;
974
+ now?: () => Date;
975
+ test?: (connection: IntegrationConnection, connector: IntegrationConnector) => Promise<IntegrationActionResult | boolean> | IntegrationActionResult | boolean;
976
+ }): Promise<IntegrationHealthcheckResult[]>;
977
+ declare function healthcheckRequest(action?: string): IntegrationActionRequest;
978
+
439
979
  /**
440
980
  * Generic OAuth2 helper used by every oauth-shaped connector (Google
441
981
  * Calendar, Sheets, Drive, HubSpot, Salesforce, Zoom, ...).
@@ -1032,50 +1572,6 @@ declare const asanaConnector: ConnectorAdapter;
1032
1572
 
1033
1573
  declare const salesforceConnector: ConnectorAdapter;
1034
1574
 
1035
- interface IntegrationToolDefinition {
1036
- name: string;
1037
- title: string;
1038
- description: string;
1039
- providerId: string;
1040
- connectorId: string;
1041
- connectorTitle: string;
1042
- category: IntegrationConnectorCategory;
1043
- action: IntegrationConnectorAction;
1044
- risk: IntegrationActionRisk;
1045
- dataClass: IntegrationDataClass;
1046
- requiredScopes: string[];
1047
- inputSchema?: unknown;
1048
- outputSchema?: unknown;
1049
- tags: string[];
1050
- }
1051
- interface IntegrationToolSearchFilters {
1052
- providerId?: string;
1053
- connectorId?: string;
1054
- category?: IntegrationConnectorCategory;
1055
- maxRisk?: IntegrationActionRisk;
1056
- dataClass?: IntegrationDataClass;
1057
- limit?: number;
1058
- }
1059
- interface IntegrationToolSearchResult {
1060
- tool: IntegrationToolDefinition;
1061
- score: number;
1062
- matched: string[];
1063
- }
1064
- interface McpToolDefinition {
1065
- name: string;
1066
- description: string;
1067
- inputSchema: unknown;
1068
- }
1069
- declare function integrationToolName(providerId: string, connectorId: string, actionId: string): string;
1070
- declare function parseIntegrationToolName(name: string): {
1071
- providerId: string;
1072
- connectorId: string;
1073
- actionId: string;
1074
- };
1075
- declare function buildIntegrationToolCatalog(connectors: IntegrationConnector[]): IntegrationToolDefinition[];
1076
- declare function searchIntegrationTools(catalog: IntegrationToolDefinition[], query: string, filters?: IntegrationToolSearchFilters): IntegrationToolSearchResult[];
1077
- declare function toMcpTools(tools: IntegrationToolDefinition[]): McpToolDefinition[];
1078
-
1079
1575
  type IntegrationPolicyEffect = 'allow' | 'require_approval' | 'deny';
1080
1576
  interface IntegrationPolicyRule {
1081
1577
  id: string;
@@ -1158,6 +1654,12 @@ type NormalizedIntegrationResult = {
1158
1654
  error: string;
1159
1655
  metadata?: Record<string, unknown>;
1160
1656
  };
1657
+ interface IntegrationSandboxHostHub {
1658
+ invokeWithCapability(token: string, request: InvokeWithCapabilityRequest): Promise<IntegrationActionResult> | IntegrationActionResult;
1659
+ }
1660
+ interface IntegrationSandboxHostOptions extends IntegrationInvocationEnvelopeValidationOptions {
1661
+ hub: IntegrationSandboxHostHub;
1662
+ }
1161
1663
  declare function buildIntegrationInvocationEnvelope(input: {
1162
1664
  capabilityToken: string;
1163
1665
  toolName: string;
@@ -1173,16 +1675,12 @@ declare function redactInvocationEnvelope(envelope: IntegrationInvocationEnvelop
1173
1675
  };
1174
1676
  declare function redactCapability(capability: IntegrationCapability): IntegrationCapability;
1175
1677
  declare function normalizeIntegrationResult(result: IntegrationActionResult): NormalizedIntegrationResult;
1176
-
1177
- interface ConnectorAdapterProviderOptions {
1178
- id?: string;
1179
- kind?: IntegrationProviderKind;
1180
- adapters: ConnectorAdapter[];
1181
- resolveDataSource: (connection: IntegrationConnection) => Promise<ResolvedDataSource> | ResolvedDataSource;
1182
- now?: () => Date;
1678
+ declare function dispatchIntegrationInvocation(envelope: IntegrationInvocationEnvelope, options: IntegrationSandboxHostOptions): Promise<NormalizedIntegrationResult>;
1679
+ declare class IntegrationSandboxHost {
1680
+ private readonly options;
1681
+ constructor(options: IntegrationSandboxHostOptions);
1682
+ dispatch(envelope: IntegrationInvocationEnvelope): Promise<NormalizedIntegrationResult>;
1183
1683
  }
1184
- declare function createConnectorAdapterProvider(options: ConnectorAdapterProviderOptions): IntegrationProvider;
1185
- declare function manifestToConnector(providerId: string, adapter: ConnectorAdapter): IntegrationConnector;
1186
1684
 
1187
1685
  interface ImportCatalogOptions {
1188
1686
  providerId: string;
@@ -1329,200 +1827,6 @@ interface ActivepiecesPieceOverride {
1329
1827
  declare const ACTIVEPIECES_OVERRIDES: Record<string, ActivepiecesPieceOverride>;
1330
1828
  declare function getActivepiecesOverride(id: string): ActivepiecesPieceOverride | undefined;
1331
1829
 
1332
- type IntegrationRequirementMode = 'read' | 'write' | 'trigger';
1333
- type IntegrationRequirementStatus = 'ready' | 'missing_connection' | 'not_executable' | 'unknown_connector';
1334
- interface IntegrationRequirement {
1335
- id: string;
1336
- connectorId: string;
1337
- reason: string;
1338
- mode: IntegrationRequirementMode;
1339
- requiredActions?: string[];
1340
- requiredTriggers?: string[];
1341
- requiredScopes?: string[];
1342
- optional?: boolean;
1343
- }
1344
- interface IntegrationManifest {
1345
- id: string;
1346
- title?: string;
1347
- owner?: IntegrationActor;
1348
- requirements: IntegrationRequirement[];
1349
- metadata?: Record<string, unknown>;
1350
- }
1351
- interface IntegrationRequirementResolution {
1352
- requirement: IntegrationRequirement;
1353
- status: IntegrationRequirementStatus;
1354
- connector?: IntegrationConnector;
1355
- registryEntry?: IntegrationRegistryEntry;
1356
- connection?: IntegrationConnection;
1357
- missingScopes: string[];
1358
- missingActions: string[];
1359
- missingTriggers: string[];
1360
- message: string;
1361
- }
1362
- interface IntegrationManifestResolution {
1363
- manifest: IntegrationManifest;
1364
- owner: IntegrationActor;
1365
- ready: IntegrationRequirementResolution[];
1366
- missing: IntegrationRequirementResolution[];
1367
- optionalMissing: IntegrationRequirementResolution[];
1368
- }
1369
- interface IntegrationGrant {
1370
- id: string;
1371
- manifestId: string;
1372
- requirementId: string;
1373
- owner: IntegrationActor;
1374
- grantee: IntegrationActor;
1375
- connectionId: string;
1376
- connectorId: string;
1377
- scopes: string[];
1378
- allowedActions: string[];
1379
- allowedTriggers: string[];
1380
- status: 'active' | 'revoked';
1381
- createdAt: string;
1382
- updatedAt: string;
1383
- metadata?: Record<string, unknown>;
1384
- }
1385
- interface IntegrationGrantStore {
1386
- get(grantId: string): Promise<IntegrationGrant | undefined> | IntegrationGrant | undefined;
1387
- put(grant: IntegrationGrant): Promise<void> | void;
1388
- listByManifest(manifestId: string, grantee?: IntegrationActor): Promise<IntegrationGrant[]> | IntegrationGrant[];
1389
- listByGrantee(grantee: IntegrationActor): Promise<IntegrationGrant[]> | IntegrationGrant[];
1390
- delete?(grantId: string): Promise<void> | void;
1391
- }
1392
- interface IntegrationCapabilityBinding {
1393
- requirementId: string;
1394
- connectorId: string;
1395
- connectionId: string;
1396
- grantId: string;
1397
- scopes: string[];
1398
- allowedActions: string[];
1399
- allowedTriggers: string[];
1400
- capability: IssuedIntegrationCapability;
1401
- }
1402
- interface IntegrationSandboxBundle {
1403
- manifestId: string;
1404
- subject: IntegrationActor;
1405
- capabilities: IntegrationCapabilityBinding[];
1406
- connectors: IntegrationConnector[];
1407
- tools: IntegrationToolDefinition[];
1408
- expiresAt: string;
1409
- }
1410
- interface IntegrationRuntimeHub {
1411
- listRegistry(): Promise<IntegrationRegistry> | IntegrationRegistry;
1412
- listConnections(owner: IntegrationActor): Promise<IntegrationConnection[]> | IntegrationConnection[];
1413
- issueCapability(input: {
1414
- subject: IntegrationActor;
1415
- connectionId: string;
1416
- scopes: string[];
1417
- allowedActions: string[];
1418
- ttlMs: number;
1419
- metadata?: Record<string, unknown>;
1420
- }): Promise<IssuedIntegrationCapability> | IssuedIntegrationCapability;
1421
- }
1422
- interface IntegrationRuntimeOptions {
1423
- hub: IntegrationRuntimeHub;
1424
- grants?: IntegrationGrantStore;
1425
- now?: () => Date;
1426
- }
1427
- declare class InMemoryIntegrationGrantStore implements IntegrationGrantStore {
1428
- private readonly grants;
1429
- get(grantId: string): IntegrationGrant | undefined;
1430
- put(grant: IntegrationGrant): void;
1431
- listByManifest(manifestId: string, grantee?: IntegrationActor): IntegrationGrant[];
1432
- listByGrantee(grantee: IntegrationActor): IntegrationGrant[];
1433
- delete(grantId: string): void;
1434
- }
1435
- declare class IntegrationRuntime {
1436
- private readonly hub;
1437
- private readonly grants;
1438
- private readonly now;
1439
- constructor(options: IntegrationRuntimeOptions);
1440
- registry(): Promise<IntegrationRegistry>;
1441
- resolveManifest(manifest: IntegrationManifest, owner: IntegrationActor): Promise<IntegrationManifestResolution>;
1442
- createGrants(input: {
1443
- manifest: IntegrationManifest;
1444
- owner: IntegrationActor;
1445
- grantee: IntegrationActor;
1446
- metadata?: Record<string, unknown>;
1447
- }): Promise<IntegrationGrant[]>;
1448
- buildSandboxBundle(input: {
1449
- manifestId: string;
1450
- subject: IntegrationActor;
1451
- ttlMs: number;
1452
- grantee?: IntegrationActor;
1453
- }): Promise<IntegrationSandboxBundle>;
1454
- }
1455
- declare function createIntegrationRuntime(options: IntegrationRuntimeOptions): IntegrationRuntime;
1456
-
1457
- interface IntegrationWorkflowDefinition {
1458
- id: string;
1459
- title?: string;
1460
- manifest: IntegrationManifest;
1461
- trigger: {
1462
- requirementId: string;
1463
- triggerId: string;
1464
- targetUrl?: string;
1465
- };
1466
- metadata?: Record<string, unknown>;
1467
- }
1468
- interface InstalledIntegrationWorkflow {
1469
- id: string;
1470
- workflowId: string;
1471
- manifestId: string;
1472
- owner: IntegrationActor;
1473
- grantee: IntegrationActor;
1474
- triggerGrantId: string;
1475
- subscription: IntegrationTriggerSubscription;
1476
- status: 'active' | 'paused' | 'error';
1477
- createdAt: string;
1478
- metadata?: Record<string, unknown>;
1479
- }
1480
- interface IntegrationWorkflowStore {
1481
- put(workflow: InstalledIntegrationWorkflow): Promise<void> | void;
1482
- get(id: string): Promise<InstalledIntegrationWorkflow | undefined> | InstalledIntegrationWorkflow | undefined;
1483
- list(): Promise<InstalledIntegrationWorkflow[]> | InstalledIntegrationWorkflow[];
1484
- listByWorkflow(workflowId: string): Promise<InstalledIntegrationWorkflow[]> | InstalledIntegrationWorkflow[];
1485
- listByOwner(owner: IntegrationActor): Promise<InstalledIntegrationWorkflow[]> | InstalledIntegrationWorkflow[];
1486
- }
1487
- interface IntegrationWorkflowRuntimeHub {
1488
- subscribeTrigger(connectionId: string, trigger: string, targetUrl?: string): Promise<IntegrationTriggerSubscription> | IntegrationTriggerSubscription;
1489
- }
1490
- interface IntegrationWorkflowRuntimeOptions {
1491
- runtime: IntegrationRuntime;
1492
- hub: IntegrationWorkflowRuntimeHub;
1493
- grants: IntegrationGrantStore;
1494
- store?: IntegrationWorkflowStore;
1495
- now?: () => Date;
1496
- }
1497
- declare class InMemoryIntegrationWorkflowStore implements IntegrationWorkflowStore {
1498
- private readonly workflows;
1499
- put(workflow: InstalledIntegrationWorkflow): void;
1500
- get(id: string): InstalledIntegrationWorkflow | undefined;
1501
- list(): InstalledIntegrationWorkflow[];
1502
- listByWorkflow(workflowId: string): InstalledIntegrationWorkflow[];
1503
- listByOwner(owner: IntegrationActor): InstalledIntegrationWorkflow[];
1504
- }
1505
- declare class IntegrationWorkflowRuntime {
1506
- private readonly runtime;
1507
- private readonly hub;
1508
- private readonly grants;
1509
- private readonly store;
1510
- private readonly now;
1511
- constructor(options: IntegrationWorkflowRuntimeOptions);
1512
- install(input: {
1513
- workflow: IntegrationWorkflowDefinition;
1514
- owner: IntegrationActor;
1515
- grantee: IntegrationActor;
1516
- }): Promise<InstalledIntegrationWorkflow>;
1517
- dispatchEvent<T = unknown>(event: IntegrationTriggerEvent<T>, handler: (input: {
1518
- event: IntegrationTriggerEvent<T>;
1519
- workflows: InstalledIntegrationWorkflow[];
1520
- }) => Promise<void> | void): Promise<{
1521
- matched: InstalledIntegrationWorkflow[];
1522
- }>;
1523
- }
1524
- declare function createIntegrationWorkflowRuntime(options: IntegrationWorkflowRuntimeOptions): IntegrationWorkflowRuntime;
1525
-
1526
1830
  type IntegrationCoveragePriority = 'tier_0' | 'tier_1' | 'tier_2' | 'long_tail';
1527
1831
  interface IntegrationCoverageSpec {
1528
1832
  id: string;
@@ -2026,4 +2330,4 @@ declare function createHttpIntegrationProvider(options: HttpIntegrationProviderO
2026
2330
  declare function signCapability(capability: IntegrationCapability, secret: string): string;
2027
2331
  declare function verifyCapabilityToken(token: string, secret: string): IntegrationCapability;
2028
2332
 
2029
- export { ACTIVEPIECES_OVERRIDES, type ActivepiecesCatalogEntry, type ActivepiecesPieceOverride, type ApiKeyAuthSpec, type AuthSpec, type CASStrategy, type Capability, type CapabilityClass, type CapabilityMutation, type CapabilityMutationResult, type CapabilityParameterSchema, type CapabilityRead, type CapabilityReadResult, type CompleteAuthRequest, type ComposeIntegrationRegistryOptions, type ConnectorAdapter, type ConnectorAdapterProviderOptions, type ConnectorCredentials, type ConnectorInvocation, type ConnectorManifest, type ConnectorManifestValidationIssue, type ConnectorManifestValidationResult, type ConsistencyModel, type ConsoleStep, type CredentialFieldSpec, type CredentialValidationInput, type CredentialValidationResult, CredentialsExpired, type CustomAuthSpec, DEFAULT_SIGNATURE_TOLERANCE_SECONDS, type DataSourceMetadata, type EventHandlerResult, type ExchangeCodeInput, type GatewayCatalogAction, type GatewayCatalogEntry, type GatewayCatalogProviderOptions, type GatewayCatalogTrigger, type GenericHmacVerifyOptions, type GoogleCalendarOptions, type GoogleSheetsOptions, type GraphqlOperationSpec, type HealthcheckPlan, type HealthcheckSpec, type HmacAuthSpec, type HttpIntegrationProviderOptions, type HubSpotOptions, INTEGRATION_FAMILIES, type ImportCatalogOptions, InMemoryConnectionStore, InMemoryIntegrationGrantStore, InMemoryIntegrationWorkflowStore, InMemoryOAuthFlowStore, type InboundEvent, type InstalledIntegrationWorkflow, type IntegrationActionGuard, type IntegrationActionPack, type IntegrationActionRequest, type IntegrationActionResult, type IntegrationActionRisk, type IntegrationActor, type IntegrationApprovalRequest, type IntegrationApprovalResolution, type IntegrationAuthMode, type IntegrationAuthSpec, type IntegrationCapability, type IntegrationCapabilityBinding, type IntegrationCatalogSource, type IntegrationConnection, type IntegrationConnectionStore, type IntegrationConnector, type IntegrationConnectorAction, type IntegrationConnectorCategory, type IntegrationConnectorTrigger, type IntegrationCoveragePriority, type IntegrationCoverageSpec, type IntegrationDataClass, IntegrationError, type IntegrationFamilyId, type IntegrationFamilySpec, type IntegrationGrant, type IntegrationGrantStore, type IntegrationGuardContext, IntegrationHub, type IntegrationHubOptions, type IntegrationInvocationEnvelope, type IntegrationInvocationEnvelopeValidationOptions, type IntegrationLifecycleSpec, type IntegrationManifest, type IntegrationManifestResolution, type IntegrationPlannerHints, type IntegrationPolicyDecision, type IntegrationPolicyEffect, type IntegrationPolicyEngine, type IntegrationPolicyRule, type IntegrationProvider, type IntegrationProviderKind, type IntegrationRegistry, type IntegrationRegistryConflict, type IntegrationRegistryEntry, type IntegrationRegistrySourceRef, type IntegrationRegistrySummary, type IntegrationRequirement, type IntegrationRequirementMode, type IntegrationRequirementResolution, type IntegrationRequirementStatus, IntegrationRuntime, type IntegrationRuntimeHub, type IntegrationRuntimeOptions, type IntegrationSandboxBundle, type IntegrationSetupSpec, type IntegrationSpec, type IntegrationSpecStatus, type IntegrationSpecValidationIssue, type IntegrationSpecValidationResult, type IntegrationSupportTier, type IntegrationToolDefinition, type IntegrationToolSearchFilters, type IntegrationToolSearchResult, type IntegrationTriggerEvent, type IntegrationTriggerSubscription, type IntegrationWorkflowDefinition, IntegrationWorkflowRuntime, type IntegrationWorkflowRuntimeHub, type IntegrationWorkflowRuntimeOptions, type IntegrationWorkflowStore, type InvokeWithCapabilityRequest, type IssueCapabilityRequest, type IssuedIntegrationCapability, type McpCatalog, type McpCatalogTool, type McpToolDefinition, type MicrosoftCalendarOptions, type NoneAuthSpec, type NormalizedIntegrationResult, type NormalizedPermission, type NotionDatabaseOptions, type OAuth2AuthSpec, type OAuthFlowStore, type OAuthTokens, type OpenApiDocument, type OpenApiOperation, type ParsedStripeSignatureHeader, type PendingOAuthFlow, type PermissionDescriptor, type PostSetupCheck, type Quirk, type RateLimitSpec, type RefreshInput, type RenderSpecOptions, type RenderedConsoleStep, type ResolvedDataSource, ResourceContention, type RestConnectorSpec, type RestCredentialPlacement, type RestOperationSpec, type RestRequestSpec, type ScopeDescriptor, type SecretRef, type SlackOptions, type SlackVerifyOptions, type StartAuthRequest, type StartAuthResult, type StartOAuthInput, type StartOAuthOutput, StaticIntegrationPolicyEngine, type StaticIntegrationPolicyOptions, type StripeVerifyOptions, type TwilioVerifyOptions, _resetPendingFlowsForTests, airtableConnector, asanaConnector, assertValidConnectorManifest, assertValidIntegrationSpec, buildActivepiecesConnectors, buildApprovalRequest, buildDefaultIntegrationRegistry, buildHealthcheckPlan, buildIntegrationCoverageConnectors, buildIntegrationInvocationEnvelope, buildIntegrationToolCatalog, canonicalConnectorId, composeIntegrationRegistry, consoleStepsToText, consumePendingFlow, createConnectorAdapterProvider, createDefaultIntegrationPolicyEngine, createGatewayCatalogProvider, createHttpIntegrationProvider, createIntegrationRuntime, createIntegrationWorkflowRuntime, createMockIntegrationProvider, declarativeRestConnector, exchangeAuthorizationCode, firstHeader, getActivepiecesOverride, getIntegrationFamily, getIntegrationSpec, githubConnector, gitlabConnector, googleCalendar, googleSheets, hubspot, importGraphqlConnector, importMcpConnector, importOpenApiConnector, inferIntegrationSupportTier, integrationCoverageChecklistMarkdown, integrationSpecToConnector, integrationToolName, invocationRequestFromEnvelope, listActivepiecesCatalogEntries, listExecutableIntegrationSpecs, listIntegrationCoverageSpecs, listIntegrationSpecs, manifestToConnector, microsoftCalendar, normalizeGatewayCatalog, normalizeIntegrationResult, notionDatabase, parseIntegrationToolName, parseStripeSignatureHeader, redactApprovalRequest, redactCapability, redactInvocationEnvelope, refreshAccessToken, renderAgentToolDescription, renderConsoleSteps, renderRunbookMarkdown, salesforceConnector, sanitizeConnection, searchIntegrationTools, signCapability, slack, slackEventsConnector, specAuthToConnectorAuth, startOAuthFlow, stripePackConnector, stripeWebhookReceiverConnector, summarizeIntegrationRegistry, toMcpTools, twilioSmsConnector, validateConnectorManifest, validateCredentialFormat, validateCredentialSet, validateIntegrationInvocationEnvelope, validateIntegrationSpec, verifyCapabilityToken, verifyHmacSignature, verifySlackSignature, verifyStripeSignature, verifyTwilioSignature, webhookConnector };
2333
+ export { ACTIVEPIECES_OVERRIDES, type ActivepiecesCatalogEntry, type ActivepiecesPieceOverride, type ApiKeyAuthSpec, ApprovalBackedPolicyEngine, type ApprovalBackedPolicyOptions, type AuthSpec, type CASStrategy, type Capability, type CapabilityClass, type CapabilityMutation, type CapabilityMutationResult, type CapabilityParameterSchema, type CapabilityRead, type CapabilityReadResult, type CompleteAuthRequest, type ComposeIntegrationRegistryOptions, type ConnectionCredentialResolverOptions, type ConnectorAdapter, type ConnectorAdapterProviderOptions, type ConnectorCredentials, type ConnectorInvocation, type ConnectorManifest, type ConnectorManifestValidationIssue, type ConnectorManifestValidationResult, type ConsistencyModel, type ConsoleStep, type CredentialFieldSpec, type CredentialValidationInput, type CredentialValidationResult, CredentialsExpired, type CustomAuthSpec, DEFAULT_INTEGRATION_BRIDGE_ENV, DEFAULT_SIGNATURE_TOLERANCE_SECONDS, type DataSourceMetadata, DefaultIntegrationActionGuard, type EventHandlerResult, type ExchangeCodeInput, type GatewayCatalogAction, type GatewayCatalogEntry, type GatewayCatalogProviderOptions, type GatewayCatalogTrigger, type GenericHmacVerifyOptions, type GoogleCalendarOptions, type GoogleSheetsOptions, type GraphqlOperationSpec, type HealthcheckPlan, type HealthcheckSpec, type HmacAuthSpec, type HttpIntegrationProviderOptions, type HubSpotOptions, INTEGRATION_FAMILIES, type ImportCatalogOptions, InMemoryConnectionStore, InMemoryIntegrationApprovalStore, InMemoryIntegrationAuditStore, InMemoryIntegrationEventStore, InMemoryIntegrationGrantStore, InMemoryIntegrationHealthcheckStore, InMemoryIntegrationIdempotencyStore, InMemoryIntegrationSecretStore, InMemoryIntegrationWorkflowStore, InMemoryOAuthFlowStore, type InboundEvent, type InstalledIntegrationWorkflow, type IntegrationActionGuard, type IntegrationActionPack, type IntegrationActionRequest, type IntegrationActionResult, type IntegrationActionRisk, type IntegrationActor, type IntegrationApprovalFilter, type IntegrationApprovalRecord, type IntegrationApprovalRequest, type IntegrationApprovalResolution, type IntegrationApprovalStatus, type IntegrationApprovalStore, type IntegrationAuditEvent, type IntegrationAuditEventType, type IntegrationAuditFilter, type IntegrationAuditSink, type IntegrationAuditStore, type IntegrationAuthMode, type IntegrationAuthSpec, type IntegrationBridgePayload, type IntegrationBridgeToolBinding, type IntegrationCapability, type IntegrationCapabilityBinding, type IntegrationCatalogSource, type IntegrationConnection, type IntegrationConnectionStore, type IntegrationConnector, type IntegrationConnectorAction, type IntegrationConnectorCategory, type IntegrationConnectorTrigger, type IntegrationCoveragePriority, type IntegrationCoverageSpec, type IntegrationDataClass, IntegrationError, type IntegrationEventStore, type IntegrationFamilyId, type IntegrationFamilySpec, type IntegrationGrant, type IntegrationGrantStore, type IntegrationGuardContext, type IntegrationHealthcheckCheck, type IntegrationHealthcheckResult, type IntegrationHealthcheckStatus, type IntegrationHealthcheckStore, IntegrationHub, type IntegrationHubOptions, type IntegrationIdempotencyRecord, type IntegrationIdempotencyStore, type IntegrationInvocationEnvelope, type IntegrationInvocationEnvelopeValidationOptions, type IntegrationLifecycleSpec, type IntegrationManifest, type IntegrationManifestResolution, type IntegrationPlannerHints, type IntegrationPolicyDecision, type IntegrationPolicyEffect, type IntegrationPolicyEngine, type IntegrationPolicyRule, type IntegrationProvider, type IntegrationProviderKind, type IntegrationRateLimitDecision, type IntegrationRateLimiter, type IntegrationRegistry, type IntegrationRegistryConflict, type IntegrationRegistryEntry, type IntegrationRegistrySourceRef, type IntegrationRegistrySummary, type IntegrationRequirement, type IntegrationRequirementMode, type IntegrationRequirementResolution, type IntegrationRequirementStatus, IntegrationRuntime, type IntegrationRuntimeHub, type IntegrationRuntimeOptions, type IntegrationSandboxBundle, IntegrationSandboxHost, type IntegrationSandboxHostHub, type IntegrationSandboxHostOptions, type IntegrationSecretStore, type IntegrationSetupSpec, type IntegrationSpec, type IntegrationSpecStatus, type IntegrationSpecValidationIssue, type IntegrationSpecValidationResult, type IntegrationSupportTier, type IntegrationToolDefinition, type IntegrationToolSearchFilters, type IntegrationToolSearchResult, type IntegrationTriggerEvent, type IntegrationTriggerSubscription, type IntegrationWebhookReceiverResult, type IntegrationWorkflowDefinition, IntegrationWorkflowRuntime, type IntegrationWorkflowRuntimeHub, type IntegrationWorkflowRuntimeOptions, type IntegrationWorkflowStore, type InvokeWithCapabilityRequest, type IssueCapabilityRequest, type IssuedIntegrationCapability, type McpCatalog, type McpCatalogTool, type McpToolDefinition, type MicrosoftCalendarOptions, type NoneAuthSpec, type NormalizedIntegrationResult, type NormalizedPermission, type NotionDatabaseOptions, type OAuth2AuthSpec, type OAuthFlowStore, type OAuthTokens, type OpenApiDocument, type OpenApiOperation, type ParsedStripeSignatureHeader, type PendingOAuthFlow, type PermissionDescriptor, type PostSetupCheck, type Quirk, type RateLimitSpec, type RefreshInput, type RenderSpecOptions, type RenderedConsoleStep, type ResolvedDataSource, ResourceContention, type RestConnectorSpec, type RestCredentialPlacement, type RestOperationSpec, type RestRequestSpec, type ScopeDescriptor, type SecretRef, type SlackOptions, type SlackVerifyOptions, type StartAuthRequest, type StartAuthResult, type StartOAuthInput, type StartOAuthOutput, StaticIntegrationPolicyEngine, type StaticIntegrationPolicyOptions, type StoredIntegrationEvent, type StripeVerifyOptions, type TwilioVerifyOptions, _resetPendingFlowsForTests, airtableConnector, asanaConnector, assertValidConnectorManifest, assertValidIntegrationSpec, buildActivepiecesConnectors, buildApprovalRequest, buildDefaultIntegrationRegistry, buildHealthcheckPlan, buildIntegrationBridgeEnvironment, buildIntegrationBridgePayload, buildIntegrationCoverageConnectors, buildIntegrationInvocationEnvelope, buildIntegrationToolCatalog, canonicalConnectorId, composeIntegrationRegistry, consoleStepsToText, consumePendingFlow, createApprovalBackedPolicyEngine, createAuditingActionGuard, createConnectionCredentialResolver, createConnectorAdapterProvider, createCredentialBackedAdapterProvider, createDefaultIntegrationActionGuard, createDefaultIntegrationPolicyEngine, createGatewayCatalogProvider, createHttpIntegrationProvider, createIntegrationAuditEvent, createIntegrationRuntime, createIntegrationWorkflowRuntime, createMockIntegrationProvider, declarativeRestConnector, decodeIntegrationBridgePayload, dispatchIntegrationInvocation, encodeIntegrationBridgePayload, exchangeAuthorizationCode, firstHeader, getActivepiecesOverride, getIntegrationFamily, getIntegrationSpec, githubConnector, gitlabConnector, googleCalendar, googleSheets, healthcheckRequest, hubspot, importGraphqlConnector, importMcpConnector, importOpenApiConnector, inferIntegrationSupportTier, integrationCoverageChecklistMarkdown, integrationSpecToConnector, integrationToolName, invocationRequestFromEnvelope, listActivepiecesCatalogEntries, listExecutableIntegrationSpecs, listIntegrationCoverageSpecs, listIntegrationSpecs, manifestToConnector, microsoftCalendar, normalizeGatewayCatalog, normalizeIntegrationResult, notionDatabase, parseIntegrationBridgeEnvironment, parseIntegrationToolName, parseStripeSignatureHeader, receiveIntegrationWebhook, redactApprovalRequest, redactCapability, redactIntegrationBridgePayload, redactInvocationEnvelope, refreshAccessToken, renderAgentToolDescription, renderConsoleSteps, renderRunbookMarkdown, resolveConnectionCredentials, resolveIntegrationApproval, revokeConnection, runIntegrationHealthcheck, runIntegrationHealthchecks, salesforceConnector, sanitizeAuditConnection, sanitizeConnection, searchIntegrationTools, signCapability, slack, slackEventsConnector, specAuthToConnectorAuth, startOAuthFlow, storedEventToTriggerEvent, stripePackConnector, stripeWebhookReceiverConnector, summarizeIntegrationRegistry, toMcpTools, twilioSmsConnector, validateConnectorManifest, validateCredentialFormat, validateCredentialSet, validateIntegrationInvocationEnvelope, validateIntegrationSpec, verifyCapabilityToken, verifyHmacSignature, verifySlackSignature, verifyStripeSignature, verifyTwilioSignature, webhookConnector };