@tangle-network/agent-integrations 0.16.2 → 0.18.0

package/dist/specs.d.ts

@@ -1796,6 +1796,22 @@ declare const asanaConnector: ConnectorAdapter;
 
 declare const salesforceConnector: ConnectorAdapter;
 
+interface CatalogExecutorInvocation {
+    connection: IntegrationConnection;
+    request: IntegrationActionRequest;
+    connector: IntegrationConnector;
+    action: IntegrationConnector['actions'][number];
+}
+interface CatalogExecutorProviderOptions {
+    id: string;
+    kind: IntegrationProviderKind;
+    connectors: IntegrationConnector[];
+    startAuth?: (request: StartAuthRequest) => Promise<StartAuthResult> | StartAuthResult;
+    completeAuth?: (request: CompleteAuthRequest) => Promise<IntegrationConnection> | IntegrationConnection;
+    executeAction: (invocation: CatalogExecutorInvocation) => Promise<IntegrationActionResult> | IntegrationActionResult;
+}
+declare function createCatalogExecutorProvider(options: CatalogExecutorProviderOptions): IntegrationProvider;
+
 interface IntegrationInvocationEnvelope {
     kind: 'integration.invocation';
     capabilityToken: string;
@@ -1975,6 +1991,7 @@ interface ActivepiecesCatalogEntry {
         id: string;
         title: string;
         risk: IntegrationActionRisk;
+        upstreamName?: string;
     }>;
     triggers: Array<{
         id: string;
@@ -1990,6 +2007,7 @@ declare function listActivepiecesCatalogEntries(): ActivepiecesCatalogEntry[];
 declare function buildActivepiecesConnectors(options?: {
     providerId?: string;
     includeCatalogActions?: boolean;
+    executable?: boolean;
 }): IntegrationConnector[];
 
 interface ActivepiecesPieceOverride {
@@ -2000,6 +2018,92 @@ interface ActivepiecesPieceOverride {
 declare const ACTIVEPIECES_OVERRIDES: Record<string, ActivepiecesPieceOverride>;
 declare function getActivepiecesOverride(id: string): ActivepiecesPieceOverride | undefined;
 
+interface ActivepiecesExecutorInvocation {
+    connection: IntegrationConnection;
+    request: IntegrationActionRequest;
+    connector: IntegrationConnector;
+    catalogEntry: ActivepiecesCatalogEntry;
+    piece: {
+        id: string;
+        npmPackage?: string;
+        version?: string;
+        actionId: string;
+        upstreamActionName?: string;
+    };
+}
+interface ActivepiecesExecutorProviderOptions {
+    id?: string;
+    connectors?: IntegrationConnector[];
+    startAuth?: (request: StartAuthRequest) => Promise<StartAuthResult> | StartAuthResult;
+    completeAuth?: (request: CompleteAuthRequest) => Promise<IntegrationConnection> | IntegrationConnection;
+    executeAction: (invocation: ActivepiecesExecutorInvocation) => Promise<IntegrationActionResult> | IntegrationActionResult;
+}
+declare function createActivepiecesExecutorProvider(options: ActivepiecesExecutorProviderOptions): IntegrationProvider;
+
+declare const ACTIVEPIECES_RUNTIME_SIGNATURE_HEADER = "x-tangle-activepieces-signature";
+interface ActivepiecesRuntimeRequest {
+    version: 1;
+    requestId: string;
+    providerId: string;
+    connection: IntegrationConnection;
+    connector: Pick<IntegrationConnector, 'id' | 'title' | 'auth' | 'scopes' | 'metadata'>;
+    piece: ActivepiecesExecutorInvocation['piece'];
+    action: {
+        id: string;
+        input: unknown;
+        idempotencyKey?: string;
+        dryRun?: boolean;
+        metadata?: Record<string, unknown>;
+    };
+}
+interface ActivepiecesHttpExecutorOptions {
+    endpoint: string;
+    secret?: string;
+    fetchImpl?: typeof fetch;
+    headers?: Record<string, string>;
+    timeoutMs?: number;
+    requestId?: () => string;
+}
+declare function createActivepiecesHttpExecutor(options: ActivepiecesHttpExecutorOptions): ActivepiecesExecutorProviderOptions['executeAction'];
+declare function buildActivepiecesRuntimeRequest(invocation: ActivepiecesExecutorInvocation, requestId?: string): ActivepiecesRuntimeRequest;
+declare function signActivepiecesRuntimeRequest(serializedBody: string, secret: string): string;
+declare function verifyActivepiecesRuntimeSignature(serializedBody: string, signature: string | null | undefined, secret: string): boolean;
+
+interface IntegrationCatalogFreshnessOptions {
+    liveActivepieces?: boolean;
+    minActivepiecesConnectors?: number;
+    staleConnectorDelta?: number;
+    fetchImpl?: typeof fetch;
+}
+interface IntegrationCatalogFreshnessResult {
+    ok: boolean;
+    generatedAt: string;
+    local: {
+        activepiecesEntries: number;
+        activepiecesConnectors: number;
+        activepiecesActions: number;
+        activepiecesTriggers: number;
+        executableActivepiecesConnectors: number;
+        executableActivepiecesActions: number;
+        executableActivepiecesTriggers: number;
+        executableToolDefinitions: number;
+        unsupportedExecutableConnectorIds: string[];
+        registryEntries: number;
+        registrySummary: IntegrationRegistrySummary;
+        conflictSamples: IntegrationRegistryConflict[];
+    };
+    upstream?: {
+        activepiecesPieces?: number;
+        activepiecesDelta?: number;
+        checkedUrl: string;
+        warning?: string;
+    };
+    warnings: string[];
+}
+declare const ACTIVEPIECES_PUBLIC_CATALOG_URL = "https://www.activepieces.com/pieces";
+declare function extractActivepiecesPublicPieceCount(html: string): number | undefined;
+declare function auditIntegrationCatalogFreshness(options?: IntegrationCatalogFreshnessOptions): Promise<IntegrationCatalogFreshnessResult>;
+
 type IntegrationCoveragePriority = 'tier_0' | 'tier_1' | 'tier_2' | 'long_tail';
 interface IntegrationCoverageSpec {
     id: string;
@@ -2503,4 +2607,4 @@ declare function createHttpIntegrationProvider(options: HttpIntegrationProviderO
 declare function signCapability(capability: IntegrationCapability, secret: string): string;
 declare function verifyCapabilityToken(token: string, secret: string): IntegrationCapability;
 
-export { InMemoryIntegrationIdempotencyStore as $, ACTIVEPIECES_OVERRIDES as A, type ApiKeyAuthSpec, type ConsistencyModel as B, CANONICAL_INTEGRATION_ACTIONS as C, type ConsoleStep, type CredentialFieldSpec, type CredentialValidationInput, type CredentialValidationResult, type CustomAuthSpec, CredentialsExpired as D, DEFAULT_INTEGRATION_BRIDGE_ENV as E, DEFAULT_SIGNATURE_TOLERANCE_SECONDS as F, type DataSourceMetadata as G, DefaultIntegrationActionGuard as H, type HealthcheckPlan, type HealthcheckSpec, type HmacAuthSpec, type EventHandlerResult as I, INTEGRATION_FAMILIES, type IntegrationAuthMode, type IntegrationAuthSpec, type IntegrationFamilyId, type IntegrationFamilySpec, type IntegrationLifecycleSpec, type IntegrationPlannerHints, type IntegrationSetupSpec, type IntegrationSpec, type IntegrationSpecStatus, type IntegrationSpecValidationIssue, type IntegrationSpecValidationResult, type ExchangeCodeInput as J, type GatewayCatalogAction as K, type GatewayCatalogEntry as L, type GatewayCatalogProviderOptions as M, type GatewayCatalogTrigger as N, type NoneAuthSpec, type NormalizedPermission, type GenericHmacVerifyOptions as O, type OAuth2AuthSpec, type GoogleCalendarOptions as P, type PermissionDescriptor, type PostSetupCheck, type GoogleSheetsOptions as Q, type Quirk, type GraphqlOperationSpec as R, type RenderSpecOptions, type RenderedConsoleStep, type HttpIntegrationProviderOptions as S, type ScopeDescriptor, type HubSpotOptions as T, type ImportCatalogOptions as U, InMemoryConnectionStore as V, InMemoryIntegrationApprovalStore as W, InMemoryIntegrationAuditStore as X, InMemoryIntegrationEventStore as Y, InMemoryIntegrationGrantStore as Z, InMemoryIntegrationHealthcheckStore as _, type ActivepiecesCatalogEntry as a, type IntegrationRegistry as a$, InMemoryIntegrationSecretStore as a0, InMemoryIntegrationWorkflowStore as a1, InMemoryOAuthFlowStore as a2, type InboundEvent as a3, type InferIntegrationRequirementsOptions as a4, type InstalledIntegrationWorkflow as a5, type IntegrationActionGuard as a6, type IntegrationActionPack as a7, type IntegrationActionRequest as a8, type IntegrationActionResult as a9, type IntegrationDataClass as aA, IntegrationError as aB, type IntegrationErrorCode as aC, type IntegrationEventStore as aD, type IntegrationGrant as aE, type IntegrationGrantStore as aF, type IntegrationGuardContext as aG, type IntegrationHealthcheckCheck as aH, type IntegrationHealthcheckResult as aI, type IntegrationHealthcheckStatus as aJ, type IntegrationHealthcheckStore as aK, IntegrationHub as aL, type IntegrationHubOptions as aM, type IntegrationIdempotencyRecord as aN, type IntegrationIdempotencyStore as aO, type IntegrationInvocationEnvelope as aP, type IntegrationInvocationEnvelopeValidationOptions as aQ, type IntegrationManifest as aR, type IntegrationManifestResolution as aS, type IntegrationPolicyDecision as aT, type IntegrationPolicyEffect as aU, type IntegrationPolicyEngine as aV, type IntegrationPolicyRule as aW, type IntegrationProvider as aX, type IntegrationProviderKind as aY, type IntegrationRateLimitDecision as aZ, type IntegrationRateLimiter as a_, type IntegrationActionRisk as aa, type IntegrationActor as ab, type IntegrationApprovalFilter as ac, type IntegrationApprovalRecord as ad, type IntegrationApprovalRequest as ae, type IntegrationApprovalResolution as af, type IntegrationApprovalStatus as ag, type IntegrationApprovalStore as ah, type IntegrationAuditEvent as ai, type IntegrationAuditEventType as aj, type IntegrationAuditFilter as ak, type IntegrationAuditSink as al, type IntegrationAuditStore as am, type IntegrationBridgePayload as an, type IntegrationBridgeToolBinding as ao, type IntegrationCapability as ap, type IntegrationCapabilityBinding as aq, type IntegrationCatalogSource as ar, type IntegrationConnection as as, assertValidIntegrationSpec, type IntegrationConnectionStore as at, type IntegrationConnector as au, type IntegrationConnectorAction as av, type IntegrationConnectorCategory as aw, type IntegrationConnectorTrigger as ax, type IntegrationCoveragePriority as ay, type IntegrationCoverageSpec as az, type ActivepiecesPieceOverride as b, type SlackOptions as b$, type IntegrationRegistryConflict as b0, type IntegrationRegistryEntry as b1, type IntegrationRegistrySourceRef as b2, type IntegrationRegistrySummary as b3, type IntegrationRequirement as b4, type IntegrationRequirementMode as b5, type IntegrationRequirementResolution as b6, type IntegrationRequirementStatus as b7, IntegrationRuntime as b8, IntegrationRuntimeError as b9, type McpCatalogTool as bA, type McpToolDefinition as bB, type MicrosoftCalendarOptions as bC, type MissingRequirementExplanation as bD, type NormalizedIntegrationError as bE, type NormalizedIntegrationResult as bF, type NotionDatabaseOptions as bG, type OAuthFlowStore as bH, type OAuthTokens as bI, type OpenApiDocument as bJ, type OpenApiOperation as bK, PROVIDER_PASSTHROUGH_ACTION as bL, type ParsedStripeSignatureHeader as bM, type PendingOAuthFlow as bN, type PlatformIntegrationPolicyPresetOptions as bO, type ProviderHttpRequestInput as bP, type ProviderPassthroughPolicy as bQ, type RateLimitSpec as bR, type RefreshInput as bS, type RenderConsentOptions as bT, type ResolvedDataSource as bU, ResourceContention as bV, type RestConnectorSpec as bW, type RestCredentialPlacement as bX, type RestOperationSpec as bY, type RestRequestSpec as bZ, type SecretRef as b_, type IntegrationRuntimeHub as ba, type IntegrationRuntimeOptions as bb, type IntegrationSandboxBundle as bc, IntegrationSandboxHost as bd, type IntegrationSandboxHostHub as be, type IntegrationSandboxHostOptions as bf, type IntegrationSecretStore as bg, type IntegrationSupportTier as bh, type IntegrationToolDefinition as bi, type IntegrationToolSearchFilters as bj, type IntegrationToolSearchResult as bk, type IntegrationTriggerEvent as bl, type IntegrationTriggerSubscription as bm, type IntegrationUserAction as bn, type IntegrationWebhookReceiverResult as bo, type IntegrationWorkflowDefinition as bp, IntegrationWorkflowRuntime as bq, type IntegrationWorkflowRuntimeHub as br, type IntegrationWorkflowRuntimeOptions as bs, type IntegrationWorkflowStore as bt, type InvokeWithCapabilityRequest as bu, buildHealthcheckPlan, type IssueCapabilityRequest as bv, type IssuedIntegrationCapability as bw, type ManifestValidationIssue as bx, type ManifestValidationResult as by, type McpCatalog as bz, ApprovalBackedPolicyEngine as c, hubspot as c$, type SlackVerifyOptions as c0, type StartAuthRequest as c1, type StartAuthResult as c2, type StartOAuthInput as c3, type StartOAuthOutput as c4, StaticIntegrationPolicyEngine as c5, type StaticIntegrationPolicyOptions as c6, type StoredIntegrationEvent as c7, type StripeVerifyOptions as c8, type TangleIntegrationInvokeInput as c9, createConnectionCredentialResolver as cA, createConnectorAdapterCatalogSource as cB, createConnectorAdapterProvider as cC, createCredentialBackedAdapterProvider as cD, createDefaultIntegrationActionGuard as cE, createDefaultIntegrationPolicyEngine as cF, createGatewayCatalogProvider as cG, createHttpIntegrationProvider as cH, createIntegrationAuditEvent as cI, createIntegrationRuntime as cJ, createIntegrationWorkflowRuntime as cK, createMockIntegrationProvider as cL, createPlatformIntegrationPolicyPreset as cM, createTangleIntegrationsClient as cN, declarativeRestConnector as cO, decodeIntegrationBridgePayload as cP, dispatchIntegrationInvocation as cQ, encodeIntegrationBridgePayload as cR, exchangeAuthorizationCode as cS, explainMissingRequirements as cT, firstHeader as cU, getActivepiecesOverride as cV, githubConnector as cW, gitlabConnector as cX, googleCalendar as cY, googleSheets as cZ, healthcheckRequest as c_, type TangleIntegrationInvokeResult as ca, TangleIntegrationsClient as cb, type TangleIntegrationsClientOptions as cc, type TwilioVerifyOptions as cd, _resetPendingFlowsForTests as ce, adapterManifestsToConnectors as cf, airtableConnector as cg, asanaConnector as ch, assertValidConnectorManifest as ci, assertValidIntegrationManifest as cj, buildActivepiecesConnectors as ck, buildApprovalRequest as cl, buildCanonicalLaunchConnectors as cm, buildDefaultIntegrationRegistry as cn, buildIntegrationBridgeEnvironment as co, consoleStepsToText, buildIntegrationBridgePayload as cp, buildIntegrationCoverageConnectors as cq, buildIntegrationInvocationEnvelope as cr, buildIntegrationToolCatalog as cs, calendarExercisePlannerManifest as ct, canonicalActionConnectorId as cu, canonicalConnectorId as cv, composeIntegrationRegistry as cw, consumePendingFlow as cx, createApprovalBackedPolicyEngine as cy, createAuditingActionGuard as cz, type ApprovalBackedPolicyOptions as d, importGraphqlConnector as d0, importMcpConnector as d1, importOpenApiConnector as d2, inferIntegrationManifestFromTools as d3, inferIntegrationSupportTier as d4, integrationCoverageChecklistMarkdown as d5, integrationToolName as d6, invocationRequestFromEnvelope as d7, listActivepiecesCatalogEntries as d8, listIntegrationCoverageSpecs as d9, searchIntegrationTools as dA, signCapability as dB, slack as dC, slackEventsConnector as dD, startOAuthFlow as dE, statusForCode as dF, storedEventToTriggerEvent as dG, stripePackConnector as dH, stripeWebhookReceiverConnector as dI, summarizeIntegrationRegistry as dJ, toMcpTools as dK, twilioSmsConnector as dL, validateConnectorManifest as dM, validateIntegrationInvocationEnvelope as dN, validateIntegrationManifest as dO, validateProviderPassthroughRequest as dP, verifyCapabilityToken as dQ, verifyHmacSignature as dR, verifySlackSignature as dS, verifyStripeSignature as dT, verifyTwilioSignature as dU, webhookConnector as dV, manifestToConnector as da, microsoftCalendar as db, normalizeGatewayCatalog as dc, normalizeIntegrationError as dd, normalizeIntegrationResult as de, notionDatabase as df, parseIntegrationBridgeEnvironment as dg, parseIntegrationToolName as dh, parseStripeSignatureHeader as di, receiveIntegrationWebhook as dj, redactApprovalRequest as dk, redactCapability as dl, redactIntegrationBridgePayload as dm, redactInvocationEnvelope as dn, refreshAccessToken as dp, renderApprovalCopy as dq, renderConsentSummary as dr, resolveConnectionCredentials as ds, resolveIntegrationApproval as dt, revokeConnection as du, runIntegrationHealthcheck as dv, runIntegrationHealthchecks as dw, salesforceConnector as dx, sanitizeAuditConnection as dy, sanitizeConnection as dz, type AuthSpec as e, type CASStrategy as f, type CanonicalIntegrationActionId as g, getIntegrationFamily, getIntegrationSpec, type CanonicalLaunchConnectorOptions as h, type Capability as i, integrationSpecToConnector, type CapabilityClass as j, type CapabilityMutation as k, type CapabilityMutationResult as l, listExecutableIntegrationSpecs, listIntegrationSpecs, type CapabilityParameterSchema as m, type CapabilityRead as n, type CapabilityReadResult as o, type CompleteAuthRequest as p, type ComposeIntegrationRegistryOptions as q, type ConnectionCredentialResolverOptions as r, renderAgentToolDescription, renderConsoleSteps, renderRunbookMarkdown, type ConnectorAdapter as s, specAuthToConnectorAuth, type ConnectorAdapterProviderOptions as t, type ConnectorCredentials as u, type ConnectorInvocation as v, validateCredentialFormat, validateCredentialSet, validateIntegrationSpec, type ConnectorManifest as w, type ConnectorManifestValidationIssue as x, type ConnectorManifestValidationResult as y, type ConsentSummary as z };
+export { type HubSpotOptions as $, ACTIVEPIECES_OVERRIDES as A, type ApiKeyAuthSpec, type ConnectorAdapter as B, CANONICAL_INTEGRATION_ACTIONS as C, type ConsoleStep, type CredentialFieldSpec, type CredentialValidationInput, type CredentialValidationResult, type CustomAuthSpec, type ConnectorAdapterProviderOptions as D, type ConnectorCredentials as E, type ConnectorInvocation as F, type ConnectorManifest as G, type ConnectorManifestValidationIssue as H, type HealthcheckPlan, type HealthcheckSpec, type HmacAuthSpec, type ConnectorManifestValidationResult as I, INTEGRATION_FAMILIES, type IntegrationAuthMode, type IntegrationAuthSpec, type IntegrationFamilyId, type IntegrationFamilySpec, type IntegrationLifecycleSpec, type IntegrationPlannerHints, type IntegrationSetupSpec, type IntegrationSpec, type IntegrationSpecStatus, type IntegrationSpecValidationIssue, type IntegrationSpecValidationResult, type ConsentSummary as J, type ConsistencyModel as K, CredentialsExpired as L, DEFAULT_INTEGRATION_BRIDGE_ENV as M, DEFAULT_SIGNATURE_TOLERANCE_SECONDS as N, type NoneAuthSpec, type NormalizedPermission, type DataSourceMetadata as O, type OAuth2AuthSpec, DefaultIntegrationActionGuard as P, type PermissionDescriptor, type PostSetupCheck, type EventHandlerResult as Q, type Quirk, type ExchangeCodeInput as R, type RenderSpecOptions, type RenderedConsoleStep, type GatewayCatalogAction as S, type ScopeDescriptor, type GatewayCatalogEntry as T, type GatewayCatalogProviderOptions as U, type GatewayCatalogTrigger as V, type GenericHmacVerifyOptions as W, type GoogleCalendarOptions as X, type GoogleSheetsOptions as Y, type GraphqlOperationSpec as Z, type HttpIntegrationProviderOptions as _, ACTIVEPIECES_PUBLIC_CATALOG_URL as a, type IntegrationManifest as a$, type ImportCatalogOptions as a0, InMemoryConnectionStore as a1, InMemoryIntegrationApprovalStore as a2, InMemoryIntegrationAuditStore as a3, InMemoryIntegrationEventStore as a4, InMemoryIntegrationGrantStore as a5, InMemoryIntegrationHealthcheckStore as a6, InMemoryIntegrationIdempotencyStore as a7, InMemoryIntegrationSecretStore as a8, InMemoryIntegrationWorkflowStore as a9, type IntegrationCatalogFreshnessResult as aA, type IntegrationCatalogSource as aB, type IntegrationConnection as aC, type IntegrationConnectionStore as aD, type IntegrationConnector as aE, type IntegrationConnectorAction as aF, type IntegrationConnectorCategory as aG, type IntegrationConnectorTrigger as aH, type IntegrationCoveragePriority as aI, type IntegrationCoverageSpec as aJ, type IntegrationDataClass as aK, IntegrationError as aL, type IntegrationErrorCode as aM, type IntegrationEventStore as aN, type IntegrationGrant as aO, type IntegrationGrantStore as aP, type IntegrationGuardContext as aQ, type IntegrationHealthcheckCheck as aR, type IntegrationHealthcheckResult as aS, type IntegrationHealthcheckStatus as aT, type IntegrationHealthcheckStore as aU, IntegrationHub as aV, type IntegrationHubOptions as aW, type IntegrationIdempotencyRecord as aX, type IntegrationIdempotencyStore as aY, type IntegrationInvocationEnvelope as aZ, type IntegrationInvocationEnvelopeValidationOptions as a_, InMemoryOAuthFlowStore as aa, type InboundEvent as ab, type InferIntegrationRequirementsOptions as ac, type InstalledIntegrationWorkflow as ad, type IntegrationActionGuard as ae, type IntegrationActionPack as af, type IntegrationActionRequest as ag, type IntegrationActionResult as ah, type IntegrationActionRisk as ai, type IntegrationActor as aj, type IntegrationApprovalFilter as ak, type IntegrationApprovalRecord as al, type IntegrationApprovalRequest as am, type IntegrationApprovalResolution as an, type IntegrationApprovalStatus as ao, type IntegrationApprovalStore as ap, type IntegrationAuditEvent as aq, type IntegrationAuditEventType as ar, type IntegrationAuditFilter as as, assertValidIntegrationSpec, type IntegrationAuditSink as at, type IntegrationAuditStore as au, type IntegrationBridgePayload as av, type IntegrationBridgeToolBinding as aw, type IntegrationCapability as ax, type IntegrationCapabilityBinding as ay, type IntegrationCatalogFreshnessOptions as az, ACTIVEPIECES_RUNTIME_SIGNATURE_HEADER as b, type RateLimitSpec as b$, type IntegrationManifestResolution as b0, type IntegrationPolicyDecision as b1, type IntegrationPolicyEffect as b2, type IntegrationPolicyEngine as b3, type IntegrationPolicyRule as b4, type IntegrationProvider as b5, type IntegrationProviderKind as b6, type IntegrationRateLimitDecision as b7, type IntegrationRateLimiter as b8, type IntegrationRegistry as b9, IntegrationWorkflowRuntime as bA, type IntegrationWorkflowRuntimeHub as bB, type IntegrationWorkflowRuntimeOptions as bC, type IntegrationWorkflowStore as bD, type InvokeWithCapabilityRequest as bE, type IssueCapabilityRequest as bF, type IssuedIntegrationCapability as bG, type ManifestValidationIssue as bH, type ManifestValidationResult as bI, type McpCatalog as bJ, type McpCatalogTool as bK, type McpToolDefinition as bL, type MicrosoftCalendarOptions as bM, type MissingRequirementExplanation as bN, type NormalizedIntegrationError as bO, type NormalizedIntegrationResult as bP, type NotionDatabaseOptions as bQ, type OAuthFlowStore as bR, type OAuthTokens as bS, type OpenApiDocument as bT, type OpenApiOperation as bU, PROVIDER_PASSTHROUGH_ACTION as bV, type ParsedStripeSignatureHeader as bW, type PendingOAuthFlow as bX, type PlatformIntegrationPolicyPresetOptions as bY, type ProviderHttpRequestInput as bZ, type ProviderPassthroughPolicy as b_, type IntegrationRegistryConflict as ba, type IntegrationRegistryEntry as bb, type IntegrationRegistrySourceRef as bc, type IntegrationRegistrySummary as bd, type IntegrationRequirement as be, type IntegrationRequirementMode as bf, type IntegrationRequirementResolution as bg, type IntegrationRequirementStatus as bh, IntegrationRuntime as bi, IntegrationRuntimeError as bj, type IntegrationRuntimeHub as bk, type IntegrationRuntimeOptions as bl, type IntegrationSandboxBundle as bm, IntegrationSandboxHost as bn, type IntegrationSandboxHostHub as bo, type IntegrationSandboxHostOptions as bp, type IntegrationSecretStore as bq, type IntegrationSupportTier as br, type IntegrationToolDefinition as bs, type IntegrationToolSearchFilters as bt, type IntegrationToolSearchResult as bu, buildHealthcheckPlan, type IntegrationTriggerEvent as bv, type IntegrationTriggerSubscription as bw, type IntegrationUserAction as bx, type IntegrationWebhookReceiverResult as by, type IntegrationWorkflowDefinition as bz, type ActivepiecesCatalogEntry as c, createPlatformIntegrationPolicyPreset as c$, type RefreshInput as c0, type RenderConsentOptions as c1, type ResolvedDataSource as c2, ResourceContention as c3, type RestConnectorSpec as c4, type RestCredentialPlacement as c5, type RestOperationSpec as c6, type RestRequestSpec as c7, type SecretRef as c8, type SlackOptions as c9, buildIntegrationBridgeEnvironment as cA, buildIntegrationBridgePayload as cB, buildIntegrationCoverageConnectors as cC, buildIntegrationInvocationEnvelope as cD, buildIntegrationToolCatalog as cE, calendarExercisePlannerManifest as cF, canonicalActionConnectorId as cG, canonicalConnectorId as cH, composeIntegrationRegistry as cI, consumePendingFlow as cJ, createActivepiecesExecutorProvider as cK, createActivepiecesHttpExecutor as cL, createApprovalBackedPolicyEngine as cM, createAuditingActionGuard as cN, createCatalogExecutorProvider as cO, createConnectionCredentialResolver as cP, createConnectorAdapterCatalogSource as cQ, createConnectorAdapterProvider as cR, createCredentialBackedAdapterProvider as cS, createDefaultIntegrationActionGuard as cT, createDefaultIntegrationPolicyEngine as cU, createGatewayCatalogProvider as cV, createHttpIntegrationProvider as cW, createIntegrationAuditEvent as cX, createIntegrationRuntime as cY, createIntegrationWorkflowRuntime as cZ, createMockIntegrationProvider as c_, type SlackVerifyOptions as ca, type StartAuthRequest as cb, type StartAuthResult as cc, type StartOAuthInput as cd, type StartOAuthOutput as ce, StaticIntegrationPolicyEngine as cf, type StaticIntegrationPolicyOptions as cg, type StoredIntegrationEvent as ch, type StripeVerifyOptions as ci, type TangleIntegrationInvokeInput as cj, type TangleIntegrationInvokeResult as ck, TangleIntegrationsClient as cl, type TangleIntegrationsClientOptions as cm, type TwilioVerifyOptions as cn, _resetPendingFlowsForTests as co, consoleStepsToText, adapterManifestsToConnectors as cp, airtableConnector as cq, asanaConnector as cr, assertValidConnectorManifest as cs, assertValidIntegrationManifest as ct, auditIntegrationCatalogFreshness as cu, buildActivepiecesConnectors as cv, buildActivepiecesRuntimeRequest as cw, buildApprovalRequest as cx, buildCanonicalLaunchConnectors as cy, buildDefaultIntegrationRegistry as cz, type ActivepiecesExecutorInvocation as d, toMcpTools as d$, createTangleIntegrationsClient as d0, declarativeRestConnector as d1, decodeIntegrationBridgePayload as d2, dispatchIntegrationInvocation as d3, encodeIntegrationBridgePayload as d4, exchangeAuthorizationCode as d5, explainMissingRequirements as d6, extractActivepiecesPublicPieceCount as d7, firstHeader as d8, getActivepiecesOverride as d9, receiveIntegrationWebhook as dA, redactApprovalRequest as dB, redactCapability as dC, redactIntegrationBridgePayload as dD, redactInvocationEnvelope as dE, refreshAccessToken as dF, renderApprovalCopy as dG, renderConsentSummary as dH, resolveConnectionCredentials as dI, resolveIntegrationApproval as dJ, revokeConnection as dK, runIntegrationHealthcheck as dL, runIntegrationHealthchecks as dM, salesforceConnector as dN, sanitizeAuditConnection as dO, sanitizeConnection as dP, searchIntegrationTools as dQ, signActivepiecesRuntimeRequest as dR, signCapability as dS, slack as dT, slackEventsConnector as dU, startOAuthFlow as dV, statusForCode as dW, storedEventToTriggerEvent as dX, stripePackConnector as dY, stripeWebhookReceiverConnector as dZ, summarizeIntegrationRegistry as d_, githubConnector as da, gitlabConnector as db, googleCalendar as dc, googleSheets as dd, healthcheckRequest as de, hubspot as df, importGraphqlConnector as dg, importMcpConnector as dh, importOpenApiConnector as di, inferIntegrationManifestFromTools as dj, inferIntegrationSupportTier as dk, integrationCoverageChecklistMarkdown as dl, integrationToolName as dm, invocationRequestFromEnvelope as dn, listActivepiecesCatalogEntries as dp, listIntegrationCoverageSpecs as dq, manifestToConnector as dr, microsoftCalendar as ds, normalizeGatewayCatalog as dt, normalizeIntegrationError as du, normalizeIntegrationResult as dv, notionDatabase as dw, parseIntegrationBridgeEnvironment as dx, parseIntegrationToolName as dy, parseStripeSignatureHeader as dz, type ActivepiecesExecutorProviderOptions as e, twilioSmsConnector as e0, validateConnectorManifest as e1, validateIntegrationInvocationEnvelope as e2, validateIntegrationManifest as e3, validateProviderPassthroughRequest as e4, verifyActivepiecesRuntimeSignature as e5, verifyCapabilityToken as e6, verifyHmacSignature as e7, verifySlackSignature as e8, verifyStripeSignature as e9, verifyTwilioSignature as ea, webhookConnector as eb, type ActivepiecesHttpExecutorOptions as f, type ActivepiecesPieceOverride as g, getIntegrationFamily, getIntegrationSpec, type ActivepiecesRuntimeRequest as h, ApprovalBackedPolicyEngine as i, integrationSpecToConnector, type ApprovalBackedPolicyOptions as j, type AuthSpec as k, type CASStrategy as l, listExecutableIntegrationSpecs, listIntegrationSpecs, type CanonicalIntegrationActionId as m, type CanonicalLaunchConnectorOptions as n, type Capability as o, type CapabilityClass as p, type CapabilityMutation as q, type CapabilityMutationResult as r, renderAgentToolDescription, renderConsoleSteps, renderRunbookMarkdown, type CapabilityParameterSchema as s, specAuthToConnectorAuth, type CapabilityRead as t, type CapabilityReadResult as u, type CatalogExecutorInvocation as v, validateCredentialFormat, validateCredentialSet, validateIntegrationSpec, type CatalogExecutorProviderOptions as w, type CompleteAuthRequest as x, type ComposeIntegrationRegistryOptions as y, type ConnectionCredentialResolverOptions as z };

package/docs/adapter-triage.md

@@ -48,6 +48,40 @@ Aliases matter when comparing coverage:
 - `stripe` maps to `stripe-pack` for outbound payment actions.
 - `twilio` maps to `twilio-sms`.
 
+## 600+ Catalog Execution Path
+
+The repo does not need 600 hand-written adapter files. Long-tail execution uses
+one strict catalog executor:
+
+```ts
+import {
+  createActivepiecesExecutorProvider,
+  IntegrationHub,
+} from '@tangle-network/agent-integrations'
+
+const provider = createActivepiecesExecutorProvider({
+  executeAction: createActivepiecesHttpExecutor({
+    endpoint: 'https://id.tangle.tools/integration-runtime',
+    secret: process.env.ACTIVEPIECES_RUNTIME_SECRET,
+  }),
+})
+
+const hub = new IntegrationHub({ providers: [provider], store, capabilitySecret })
+```
+
+This promotes all vendored Activepieces community entries to
+`gatewayExecutable` only when a caller supplies an executor. The default catalog
+remains `catalogOnly`, so generated apps cannot accidentally call metadata.
+
+The execution boundary remains the Tangle boundary:
+
+- `IntegrationHub` checks connection status, scopes, capability tokens, policy,
+  approvals, and guard hooks.
+- The provider validates the connector and action before calling the executor.
+- The executor owns package loading, provider credentials, sandboxing, and
+  upstream runtime quirks.
+- Trigger execution is separate; current long-tail promotion covers actions.
+
 ## Current Setup/Catalog Coverage
 
 `listIntegrationCoverageSpecs()` currently defines 142 setup specs. The default

package/docs/integration-coverage-checklist.md

@@ -25,6 +25,8 @@ Goal: cover the integrations that make agents useful for 99% of practical produc
 - [ ] Tier 0 write actions have idempotency and approval tests.
 - [x] Provider gateway adapters can import/sync catalog metadata from Nango/Pipedream/Activepieces registries.
 - [x] Adapter execution triage is documented in [`adapter-triage.md`](./adapter-triage.md).
+- [x] Activepieces community catalog can be promoted to executable actions through `createActivepiecesExecutorProvider`.
+- [x] Activepieces executable actions can dispatch through a signed HTTP runtime executor protocol.
 
 ## Tier 0 First-Party Promotion Queue
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-integrations",
-  "version": "0.16.2",
+  "version": "0.18.0",
   "description": "Vendor-neutral integration contracts and runtime helpers for sandbox and agent apps.",
   "homepage": "https://github.com/tangle-network/agent-integrations#readme",
   "repository": {