@tangle-network/agent-integrations 0.13.0 → 0.14.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 CHANGED
@@ -40,6 +40,11 @@ agent-facing tool contract.
40
40
  pretending every catalog item is executable.
41
41
  - A canonical registry that deduplicates overlapping catalogs, keeps support
42
42
  tiers explicit, and reports auth/category conflicts.
43
+ - App/agent manifests, grants, and sandbox bundles so Builder, generated apps,
44
+ vertical agents, Blueprint Agent, and executor-backed runtimes can reuse the
45
+ same user-owned connections safely.
46
+ - Workflow trigger installation and normalized event dispatch for non-agent UI
47
+ automation, sync jobs, webhooks, and product workflows.
43
48
  - A generated `IntegrationSpec` registry used for setup docs, admin UI steps,
44
49
  normalized permissions, healthcheck plans, and tool descriptions.
45
50
 
@@ -77,6 +82,10 @@ pnpm add @tangle-network/agent-integrations
77
82
  | `IntegrationConnection` | User/team/agent-owned grant with scopes and secret references. |
78
83
  | `IntegrationHub` | Facade for provider catalogs, connection storage, capabilities, and invocation. |
79
84
  | `IntegrationCapability` | Short-lived authorization for a specific subject, connection, scope set, and action set. |
85
+ | `IntegrationManifest` | Generated app or agent requirements: connectors, actions, scopes, and reasons. |
86
+ | `IntegrationGrant` | Persistent grant from a user-owned connection to an app, agent, or sandbox consumer. |
87
+ | `createIntegrationRuntime` | Facade for manifest resolution, grant creation, and sandbox capability bundles. |
88
+ | `createIntegrationWorkflowRuntime` | Installs trigger workflows and dispatches normalized provider events. |
80
89
  | `buildIntegrationToolCatalog` | Converts connector actions into agent/tool definitions. |
81
90
  | `searchIntegrationTools` | Intent search over normalized integration tools. |
82
91
  | `buildDefaultIntegrationRegistry` | Composes setup specs and vendored catalog metadata into one deduplicated connector registry. |
@@ -109,6 +118,45 @@ catalogOnly < setupReady < gatewayExecutable < firstPartyExecutable < sandboxExe
109
118
 
110
119
  See [Catalog Registry](./docs/catalog-registry.md).
111
120
 
121
+ ## App And Agent Grants
122
+
123
+ Use `IntegrationManifest` for any app or agent that needs integrations:
124
+ Agent Builder-generated apps, tax/legal/GTM/creative agents, Blueprint Agent
125
+ sandboxes, and executor-backed workflows all use the same shape.
126
+
127
+ ```ts
128
+ const runtime = createIntegrationRuntime({ hub, grants })
129
+
130
+ const resolution = await runtime.resolveManifest(manifest, user)
131
+ const grants = await runtime.createGrants({
132
+ manifest,
133
+ owner: user,
134
+ grantee: { type: 'app', id: manifest.id },
135
+ })
136
+ const bundle = await runtime.buildSandboxBundle({
137
+ manifestId: manifest.id,
138
+ subject: { type: 'sandbox', id: sandboxId },
139
+ ttlMs: 15 * 60_000,
140
+ })
141
+ ```
142
+
143
+ Generated apps and sandboxes receive scoped capability tokens and tool
144
+ definitions. They never receive OAuth refresh tokens, API keys, or raw secrets.
145
+
146
+ The same manifest/grant model works for non-agent workflows:
147
+
148
+ ```ts
149
+ await workflows.install({
150
+ workflow,
151
+ owner: user,
152
+ grantee: { type: 'app', id: 'github-pr-sync' },
153
+ })
154
+ ```
155
+
156
+ That installs provider trigger subscriptions against the user's connection and
157
+ lets the product dispatch normalized events to UI workflows, sync jobs, or
158
+ agent runs.
159
+
112
160
  ## Provider Strategy
113
161
 
114
162
  The package deliberately avoids vendor lock-in.
package/dist/index.d.ts CHANGED
@@ -1318,6 +1318,7 @@ interface ActivepiecesCatalogEntry {
1318
1318
  declare function listActivepiecesCatalogEntries(): ActivepiecesCatalogEntry[];
1319
1319
  declare function buildActivepiecesConnectors(options?: {
1320
1320
  providerId?: string;
1321
+ includeCatalogActions?: boolean;
1321
1322
  }): IntegrationConnector[];
1322
1323
 
1323
1324
  interface ActivepiecesPieceOverride {
@@ -1328,6 +1329,200 @@ interface ActivepiecesPieceOverride {
1328
1329
  declare const ACTIVEPIECES_OVERRIDES: Record<string, ActivepiecesPieceOverride>;
1329
1330
  declare function getActivepiecesOverride(id: string): ActivepiecesPieceOverride | undefined;
1330
1331
 
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
+
1331
1526
  type IntegrationCoveragePriority = 'tier_0' | 'tier_1' | 'tier_2' | 'long_tail';
1332
1527
  interface IntegrationCoverageSpec {
1333
1528
  id: string;
@@ -1811,6 +2006,7 @@ declare class IntegrationHub {
1811
2006
  startAuth(providerId: string, request: StartAuthRequest): Promise<StartAuthResult>;
1812
2007
  completeAuth(providerId: string, request: CompleteAuthRequest): Promise<IntegrationConnection>;
1813
2008
  upsertConnection(connection: IntegrationConnection): Promise<IntegrationConnection>;
2009
+ listConnections(owner: IntegrationActor): Promise<IntegrationConnection[]>;
1814
2010
  issueCapability(request: IssueCapabilityRequest): Promise<IssuedIntegrationCapability>;
1815
2011
  verifyCapability(token: string): IntegrationCapability;
1816
2012
  invokeWithCapability(token: string, request: InvokeWithCapabilityRequest): Promise<IntegrationActionResult>;
@@ -1830,4 +2026,4 @@ declare function createHttpIntegrationProvider(options: HttpIntegrationProviderO
1830
2026
  declare function signCapability(capability: IntegrationCapability, secret: string): string;
1831
2027
  declare function verifyCapabilityToken(token: string, secret: string): IntegrationCapability;
1832
2028
 
1833
- 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, InMemoryOAuthFlowStore, type InboundEvent, type IntegrationActionGuard, type IntegrationActionPack, type IntegrationActionRequest, type IntegrationActionResult, type IntegrationActionRisk, type IntegrationActor, type IntegrationApprovalRequest, type IntegrationApprovalResolution, type IntegrationAuthMode, type IntegrationAuthSpec, type IntegrationCapability, 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 IntegrationGuardContext, IntegrationHub, type IntegrationHubOptions, type IntegrationInvocationEnvelope, type IntegrationInvocationEnvelopeValidationOptions, type IntegrationLifecycleSpec, 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 IntegrationSetupSpec, type IntegrationSpec, type IntegrationSpecStatus, type IntegrationSpecValidationIssue, type IntegrationSpecValidationResult, type IntegrationSupportTier, type IntegrationToolDefinition, type IntegrationToolSearchFilters, type IntegrationToolSearchResult, type IntegrationTriggerEvent, type IntegrationTriggerSubscription, 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, 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 };
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 };