@tangle-network/agent-integrations 0.21.0 → 0.22.1

package/dist/specs.d.ts

@@ -2226,6 +2226,23 @@ interface TangleCatalogRuntimeHandlerOptions {
     maxBodyBytes?: number;
     executeAction: (invocation: TangleCatalogRuntimeInvocation) => Promise<IntegrationActionResult> | IntegrationActionResult;
 }
+interface TangleCatalogInstalledPackageExecutorOptions {
+    moduleLoader?: (packageName: string) => Promise<unknown> | unknown;
+    actionAliases?: Record<string, Record<string, string>>;
+    resolveAuth?: (connection: IntegrationConnection) => Promise<unknown> | unknown;
+    beforeRun?: (invocation: TangleCatalogRuntimeInvocation) => Promise<void> | void;
+}
+interface TangleCatalogRuntimeModuleAction {
+    name?: string;
+    displayName?: string;
+    run?: (context: {
+        auth: unknown;
+        propsValue: unknown;
+        input: unknown;
+        connection: IntegrationConnection;
+        request: TangleCatalogRuntimeRequest;
+    }) => Promise<unknown> | unknown;
+}
 interface TangleCatalogRuntimeHttpRequest {
     body: string | Uint8Array | TangleCatalogRuntimeRequest;
     headers?: Headers | Record<string, string | string[] | undefined>;
@@ -2243,6 +2260,7 @@ interface TangleCatalogRuntimeHttpResponse {
     };
 }
 declare function createTangleCatalogRuntimeHandler(options: TangleCatalogRuntimeHandlerOptions): (input: TangleCatalogRuntimeHttpRequest) => Promise<TangleCatalogRuntimeHttpResponse>;
+declare function createTangleCatalogInstalledPackageExecutor(options?: TangleCatalogInstalledPackageExecutorOptions): TangleCatalogRuntimeHandlerOptions['executeAction'];
 
 type IntegrationCoveragePriority = 'tier_0' | 'tier_1' | 'tier_2' | 'long_tail';
 interface IntegrationCoverageSpec {
@@ -2746,4 +2764,4 @@ declare function createHttpIntegrationProvider(options: HttpIntegrationProviderO
 declare function signCapability(capability: IntegrationCapability, secret: string): string;
 declare function verifyCapabilityToken(token: string, secret: string): IntegrationCapability;
 
-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, consumePendingFlow 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, TangleIntegrationsClient as cA, type TangleIntegrationsClientOptions as cB, type TwilioVerifyOptions as cC, _resetPendingFlowsForTests as cD, adapterManifestsToConnectors as cE, airtableConnector as cF, asanaConnector as cG, assertValidConnectorManifest as cH, assertValidIntegrationManifest as cI, auditIntegrationCatalogFreshness as cJ, auditTangleIntegrationCatalogFreshness as cK, buildActivepiecesConnectors as cL, buildActivepiecesRuntimeRequest as cM, buildApprovalRequest as cN, buildCanonicalLaunchConnectors as cO, buildDefaultIntegrationRegistry as cP, buildIntegrationBridgeEnvironment as cQ, buildIntegrationBridgePayload as cR, buildIntegrationCoverageConnectors as cS, buildIntegrationInvocationEnvelope as cT, buildIntegrationToolCatalog as cU, buildTangleCatalogRuntimeRequest as cV, buildTangleIntegrationCatalogConnectors as cW, calendarExercisePlannerManifest as cX, canonicalActionConnectorId as cY, canonicalConnectorId as cZ, composeIntegrationRegistry 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, TANGLE_CATALOG_RUNTIME_SIGNATURE_HEADER as cj, TANGLE_INTEGRATIONS_CATALOG_PROVIDER_ID as ck, TANGLE_INTEGRATIONS_CATALOG_SOURCE as cl, type TangleCatalogExecutorInvocation as cm, type TangleCatalogExecutorProviderOptions as cn, type TangleCatalogHttpExecutorInvocation as co, consoleStepsToText, type TangleCatalogHttpExecutorOptions as cp, type TangleCatalogRuntimeHandlerOptions as cq, type TangleCatalogRuntimeHttpRequest as cr, type TangleCatalogRuntimeHttpResponse as cs, type TangleCatalogRuntimeInvocation as ct, type TangleCatalogRuntimeRequest as cu, type TangleIntegrationCatalogEntry as cv, type TangleIntegrationCatalogFreshnessOptions as cw, type TangleIntegrationCatalogFreshnessResult as cx, type TangleIntegrationInvokeInput as cy, type TangleIntegrationInvokeResult as cz, type ActivepiecesExecutorInvocation as d, redactInvocationEnvelope as d$, createActivepiecesExecutorProvider as d0, createActivepiecesHttpExecutor as d1, createApprovalBackedPolicyEngine as d2, createAuditingActionGuard as d3, createCatalogExecutorProvider as d4, createConnectionCredentialResolver as d5, createConnectorAdapterCatalogSource as d6, createConnectorAdapterProvider as d7, createCredentialBackedAdapterProvider as d8, createDefaultIntegrationActionGuard as d9, googleSheets as dA, healthcheckRequest as dB, hubspot as dC, importGraphqlConnector as dD, importMcpConnector as dE, importOpenApiConnector as dF, inferIntegrationManifestFromTools as dG, inferIntegrationSupportTier as dH, integrationCoverageChecklistMarkdown as dI, integrationToolName as dJ, invocationRequestFromEnvelope as dK, listActivepiecesCatalogEntries as dL, listIntegrationCoverageSpecs as dM, listTangleIntegrationCatalogEntries as dN, manifestToConnector as dO, microsoftCalendar as dP, normalizeGatewayCatalog as dQ, normalizeIntegrationError as dR, normalizeIntegrationResult as dS, notionDatabase as dT, parseIntegrationBridgeEnvironment as dU, parseIntegrationToolName as dV, parseStripeSignatureHeader as dW, receiveIntegrationWebhook as dX, redactApprovalRequest as dY, redactCapability as dZ, redactIntegrationBridgePayload as d_, createDefaultIntegrationPolicyEngine as da, createGatewayCatalogProvider as db, createHttpIntegrationProvider as dc, createIntegrationAuditEvent as dd, createIntegrationRuntime as de, createIntegrationWorkflowRuntime as df, createMockIntegrationProvider as dg, createPlatformIntegrationPolicyPreset as dh, createTangleCatalogExecutorProvider as di, createTangleCatalogHttpExecutor as dj, createTangleCatalogRuntimeHandler as dk, createTangleIntegrationsClient as dl, declarativeRestConnector as dm, decodeIntegrationBridgePayload as dn, dispatchIntegrationInvocation as dp, encodeIntegrationBridgePayload as dq, exchangeAuthorizationCode as dr, explainMissingRequirements as ds, extractActivepiecesPublicPieceCount as dt, extractExternalCatalogPublicCount as du, firstHeader as dv, getActivepiecesOverride as dw, githubConnector as dx, gitlabConnector as dy, googleCalendar as dz, type ActivepiecesExecutorProviderOptions as e, refreshAccessToken as e0, renderApprovalCopy as e1, renderConsentSummary as e2, resolveConnectionCredentials as e3, resolveIntegrationApproval as e4, revokeConnection as e5, runIntegrationHealthcheck as e6, runIntegrationHealthchecks as e7, salesforceConnector as e8, sanitizeAuditConnection as e9, webhookConnector as eA, sanitizeConnection as ea, searchIntegrationTools as eb, signActivepiecesRuntimeRequest as ec, signCapability as ed, signTangleCatalogRuntimeRequest as ee, slack as ef, slackEventsConnector as eg, startOAuthFlow as eh, statusForCode as ei, storedEventToTriggerEvent as ej, stripePackConnector as ek, stripeWebhookReceiverConnector as el, summarizeIntegrationRegistry as em, toMcpTools as en, twilioSmsConnector as eo, validateConnectorManifest as ep, validateIntegrationInvocationEnvelope as eq, validateIntegrationManifest as er, validateProviderPassthroughRequest as es, verifyActivepiecesRuntimeSignature as et, verifyCapabilityToken as eu, verifyHmacSignature as ev, verifySlackSignature as ew, verifyStripeSignature as ex, verifyTangleCatalogRuntimeSignature as ey, verifyTwilioSignature as ez, 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 };
+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, canonicalConnectorId 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, type TangleIntegrationInvokeInput as cA, type TangleIntegrationInvokeResult as cB, TangleIntegrationsClient as cC, type TangleIntegrationsClientOptions as cD, type TwilioVerifyOptions as cE, _resetPendingFlowsForTests as cF, adapterManifestsToConnectors as cG, airtableConnector as cH, asanaConnector as cI, assertValidConnectorManifest as cJ, assertValidIntegrationManifest as cK, auditIntegrationCatalogFreshness as cL, auditTangleIntegrationCatalogFreshness as cM, buildActivepiecesConnectors as cN, buildActivepiecesRuntimeRequest as cO, buildApprovalRequest as cP, buildCanonicalLaunchConnectors as cQ, buildDefaultIntegrationRegistry as cR, buildIntegrationBridgeEnvironment as cS, buildIntegrationBridgePayload as cT, buildIntegrationCoverageConnectors as cU, buildIntegrationInvocationEnvelope as cV, buildIntegrationToolCatalog as cW, buildTangleCatalogRuntimeRequest as cX, buildTangleIntegrationCatalogConnectors as cY, calendarExercisePlannerManifest as cZ, canonicalActionConnectorId 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, TANGLE_CATALOG_RUNTIME_SIGNATURE_HEADER as cj, TANGLE_INTEGRATIONS_CATALOG_PROVIDER_ID as ck, TANGLE_INTEGRATIONS_CATALOG_SOURCE as cl, type TangleCatalogExecutorInvocation as cm, type TangleCatalogExecutorProviderOptions as cn, type TangleCatalogHttpExecutorInvocation as co, consoleStepsToText, type TangleCatalogHttpExecutorOptions as cp, type TangleCatalogInstalledPackageExecutorOptions as cq, type TangleCatalogRuntimeHandlerOptions as cr, type TangleCatalogRuntimeHttpRequest as cs, type TangleCatalogRuntimeHttpResponse as ct, type TangleCatalogRuntimeInvocation as cu, type TangleCatalogRuntimeModuleAction as cv, type TangleCatalogRuntimeRequest as cw, type TangleIntegrationCatalogEntry as cx, type TangleIntegrationCatalogFreshnessOptions as cy, type TangleIntegrationCatalogFreshnessResult as cz, type ActivepiecesExecutorInvocation as d, redactApprovalRequest as d$, composeIntegrationRegistry as d0, consumePendingFlow as d1, createActivepiecesExecutorProvider as d2, createActivepiecesHttpExecutor as d3, createApprovalBackedPolicyEngine as d4, createAuditingActionGuard as d5, createCatalogExecutorProvider as d6, createConnectionCredentialResolver as d7, createConnectorAdapterCatalogSource as d8, createConnectorAdapterProvider as d9, 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 dO, listIntegrationCoverageSpecs as dP, listTangleIntegrationCatalogEntries 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, receiveIntegrationWebhook as d_, createCredentialBackedAdapterProvider as da, createDefaultIntegrationActionGuard as db, createDefaultIntegrationPolicyEngine as dc, createGatewayCatalogProvider as dd, createHttpIntegrationProvider as de, createIntegrationAuditEvent as df, createIntegrationRuntime as dg, createIntegrationWorkflowRuntime as dh, createMockIntegrationProvider as di, createPlatformIntegrationPolicyPreset as dj, createTangleCatalogExecutorProvider as dk, createTangleCatalogHttpExecutor as dl, createTangleCatalogInstalledPackageExecutor as dm, createTangleCatalogRuntimeHandler as dn, createTangleIntegrationsClient as dp, declarativeRestConnector as dq, decodeIntegrationBridgePayload as dr, dispatchIntegrationInvocation as ds, encodeIntegrationBridgePayload as dt, exchangeAuthorizationCode as du, explainMissingRequirements as dv, extractActivepiecesPublicPieceCount as dw, extractExternalCatalogPublicCount as dx, firstHeader as dy, getActivepiecesOverride as dz, type ActivepiecesExecutorProviderOptions as e, redactCapability as e0, redactIntegrationBridgePayload as e1, redactInvocationEnvelope as e2, refreshAccessToken as e3, renderApprovalCopy as e4, renderConsentSummary as e5, resolveConnectionCredentials as e6, resolveIntegrationApproval as e7, revokeConnection as e8, runIntegrationHealthcheck as e9, verifyStripeSignature as eA, verifyTangleCatalogRuntimeSignature as eB, verifyTwilioSignature as eC, webhookConnector as eD, runIntegrationHealthchecks as ea, salesforceConnector as eb, sanitizeAuditConnection as ec, sanitizeConnection as ed, searchIntegrationTools as ee, signActivepiecesRuntimeRequest as ef, signCapability as eg, signTangleCatalogRuntimeRequest as eh, slack as ei, slackEventsConnector as ej, startOAuthFlow as ek, statusForCode as el, storedEventToTriggerEvent as em, stripePackConnector as en, stripeWebhookReceiverConnector as eo, summarizeIntegrationRegistry as ep, toMcpTools as eq, twilioSmsConnector as er, validateConnectorManifest as es, validateIntegrationInvocationEnvelope as et, validateIntegrationManifest as eu, validateProviderPassthroughRequest as ev, verifyActivepiecesRuntimeSignature as ew, verifyCapabilityToken as ex, verifyHmacSignature as ey, verifySlackSignature as ez, 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/integration-execution-audit.md

@@ -0,0 +1,233 @@
+# Integration Execution Audit
+
+Generated from the current checkout by `node scripts/audit-integration-execution.mjs`.
+
+This audit separates four very different states that were getting conflated:
+
+- **Cataloged**: we know the connector exists and have normalized metadata.
+- **Setup-ready**: we have setup/auth/runbook metadata for product UI and admin configuration.
+- **First-party executable**: this repo ships a reviewed adapter implementation.
+- **Package-runtime executable**: a Tangle runtime service has the connector package installed, credentials resolvable, and action-name mapping verified.
+
+## Summary
+
+| Item | Count |
+| --- | ---: |
+| Catalog connectors | 669 |
+| Catalog connectors with runtime package names | 669 |
+| Catalog actions | 3783 |
+| Catalog triggers | 999 |
+| Catalog actions with verified upstream action names in this repo | 0 |
+| Runtime package dependencies declared by this package | 0 |
+| Setup specs | 142 |
+| Executable setup specs | 14 |
+| Catalog/setup-only specs | 128 |
+| First-party adapter surfaces | 16 |
+| Tangle catalog connectors exposable behind runtime | 669 |
+| Tangle catalog actions exposable behind runtime | 3963 |
+
+Full machine-readable matrix: [integration-execution-matrix.json](./integration-execution-matrix.json).
+
+## Auth Breakdown
+
+| Auth | Connectors |
+| --- | --- |
+| api_key | 334 |
+| custom | 248 |
+| oauth2 | 69 |
+| none | 18 |
+
+## Category Breakdown
+
+| Category | Connectors |
+| --- | --- |
+| workflow | 296 |
+| webhook | 91 |
+| crm | 63 |
+| storage | 50 |
+| email | 49 |
+| chat | 48 |
+| docs | 23 |
+| calendar | 22 |
+| database | 16 |
+| internal | 11 |
+
+## First-Party Executable Surfaces
+
+These are implemented in `src/connectors/adapters` or represented as executable setup specs:
+
+- `google-calendar`
+- `google-sheets`
+- `microsoft-calendar`
+- `hubspot`
+- `slack`
+- `notion-database`
+- `twilio-sms`
+- `stripe-pack`
+- `webhook`
+- `stripe`
+- `slack-inbound`
+- `github`
+- `gitlab`
+- `airtable`
+- `asana`
+- `salesforce`
+
+Executable setup specs:
+
+- `airtable`
+- `asana`
+- `github`
+- `gitlab`
+- `google-calendar`
+- `google-sheets`
+- `hubspot`
+- `microsoft-calendar`
+- `notion-database`
+- `salesforce`
+- `slack`
+- `stripe-pack`
+- `twilio-sms`
+- `webhook`
+
+## Flow Readiness
+
+| Flow | Status | Concrete state |
+| --- | --- | --- |
+| Connector discovery/catalog search | Done | 669 catalog connectors, 3783 actions, 999 triggers normalized into Tangle catalog shapes. |
+| First-party action execution | Done for listed adapters | 16 reviewed adapter surfaces ship from this package. |
+| OAuth/API-key setup metadata | Partial | 142 setup specs exist; 14 are executable setup specs and 128 are catalog/setup-only. |
+| Long-tail package action execution | Runtime path exists; coverage unverified | 669 entries have package names, but runtime packages are not bundled and 0 catalog actions have verified upstream action mappings. |
+| Long-tail credential mapping | Partial | api_key: 334, oauth2: 69, custom: 248, none: 18. Custom connectors need per-package credential shaping before execution can be claimed. |
+| Trigger hosting/subscription | Partial | 999 triggers are cataloged. Runtime action invocation exists; universal trigger install/hosting is not done. |
+| Sandbox/app invocation envelope | Done | The library has capability bundles, invocation envelopes, policy checks, guard hooks, signed catalog runtime HTTP calls, and generated-app client helpers. |
+| Live provider smoke tests | Not globally done | First-party adapters can be tested by consumers with credentials; long-tail smoke matrix is not generated yet. |
+
+## Concrete Not-Done Buckets
+
+| Bucket | Count | What it means |
+| --- | ---: | --- |
+| Catalog connectors needing package-runtime verification | 659 | Connector has a known runtime package but is not a first-party adapter here. |
+| Catalog connectors with zero verified action mappings | 570 | We normalized action labels, but have not checked the exact runtime action export names into the catalog. |
+| Custom-auth catalog connectors needing credential shape mapping | 248 | A generic OAuth/API-key form is not enough; the runtime must shape auth exactly as the package expects. |
+| Catalog connectors with triggers needing hosted trigger support | 288 | Trigger metadata exists, but trigger subscription/webhook execution is not universally implemented. |
+
+Examples needing package-runtime verification:
+
+- `activecampaign` -> `@activepieces/piece-activecampaign`
+- `activepieces` -> `@activepieces/piece-activepieces`
+- `actualbudget` -> `@activepieces/piece-actualbudget`
+- `acuity-scheduling` -> `@activepieces/piece-acuity-scheduling`
+- `acumbamail` -> `@activepieces/piece-acumbamail`
+- `afforai` -> `@activepieces/piece-afforai`
+- `agentx` -> `@activepieces/piece-agentx`
+- `ai` -> `@activepieces/piece-ai`
+- `aianswer` -> `@activepieces/piece-aianswer`
+- `aidbase` -> `@activepieces/piece-aidbase`
+- `aiprise` -> `@activepieces/piece-aiprise`
+- `air-ops` -> `@activepieces/piece-air-ops`
+- `aircall` -> `@activepieces/piece-aircall`
+- `airparser` -> `@activepieces/piece-airparser`
+- `airtop` -> `@activepieces/piece-airtop`
+- `alai` -> `@activepieces/piece-alai`
+- `algolia` -> `@activepieces/piece-algolia`
+- `alt-text-ai` -> `@activepieces/piece-alt-text-ai`
+- `alttextify` -> `@activepieces/piece-alttextify`
+- `amazon-bedrock` -> `@activepieces/piece-amazon-bedrock`
+- `amazon-s3` -> `@activepieces/piece-amazon-s3`
+- `amazon-secrets-manager` -> `@activepieces/piece-amazon-secrets-manager`
+- `amazon-ses` -> `@activepieces/piece-amazon-ses`
+- `amazon-sns` -> `@activepieces/piece-amazon-sns`
+- `amazon-sqs` -> `@activepieces/piece-amazon-sqs`
+- `amazon-textract` -> `@activepieces/piece-amazon-textract`
+- `aminos` -> `@activepieces/piece-aminos`
+- `ampeco` -> `@activepieces/piece-ampeco`
+- `anyhook-graphql` -> `@activepieces/piece-anyhook-graphql`
+- `anyhook-websocket` -> `@activepieces/piece-anyhook-websocket`
+- `apify` -> `@activepieces/piece-apify`
+- `apitable` -> `@activepieces/piece-apitable`
+- `apitemplate-io` -> `@activepieces/piece-apitemplate-io`
+- `apollo` -> `@activepieces/piece-apollo`
+- `appfollow` -> `@activepieces/piece-appfollow`
+- `ashby` -> `@activepieces/piece-ashby`
+- `ask-handle` -> `@activepieces/piece-ask-handle`
+- `asknews` -> `@activepieces/piece-asknews`
+- `assembled` -> `@activepieces/piece-assembled`
+- `assemblyai` -> `@activepieces/piece-assemblyai`
+
+Examples needing custom auth mapping:
+
+- `activecampaign` -> `@activepieces/piece-activecampaign`
+- `acumbamail` -> `@activepieces/piece-acumbamail`
+- `afforai` -> `@activepieces/piece-afforai`
+- `agentx` -> `@activepieces/piece-agentx`
+- `aiprise` -> `@activepieces/piece-aiprise`
+- `aircall` -> `@activepieces/piece-aircall`
+- `airparser` -> `@activepieces/piece-airparser`
+- `alt-text-ai` -> `@activepieces/piece-alt-text-ai`
+- `alttextify` -> `@activepieces/piece-alttextify`
+- `amazon-bedrock` -> `@activepieces/piece-amazon-bedrock`
+- `amazon-s3` -> `@activepieces/piece-amazon-s3`
+- `amazon-secrets-manager` -> `@activepieces/piece-amazon-secrets-manager`
+- `amazon-ses` -> `@activepieces/piece-amazon-ses`
+- `amazon-textract` -> `@activepieces/piece-amazon-textract`
+- `anyhook-graphql` -> `@activepieces/piece-anyhook-graphql`
+- `anyhook-websocket` -> `@activepieces/piece-anyhook-websocket`
+- `apollo` -> `@activepieces/piece-apollo`
+- `ask-handle` -> `@activepieces/piece-ask-handle`
+- `assembled` -> `@activepieces/piece-assembled`
+- `assemblyai` -> `@activepieces/piece-assemblyai`
+- `avian` -> `@activepieces/piece-avian`
+- `avoma` -> `@activepieces/piece-avoma`
+- `azure-blob-storage` -> `@activepieces/piece-azure-blob-storage`
+- `azure-openai` -> `@activepieces/piece-azure-openai`
+- `barcode-lookup` -> `@activepieces/piece-barcode-lookup`
+- `baremetrics` -> `@activepieces/piece-baremetrics`
+- `beamer` -> `@activepieces/piece-beamer`
+- `bigin-by-zoho` -> `@activepieces/piece-bigin-by-zoho`
+- `billplz` -> `@activepieces/piece-billplz`
+- `bland-ai` -> `@activepieces/piece-bland-ai`
+- `bluesky` -> `@activepieces/piece-bluesky`
+- `browserless` -> `@activepieces/piece-browserless`
+- `bumpups` -> `@activepieces/piece-bumpups`
+- `bursty-ai` -> `@activepieces/piece-bursty-ai`
+- `buttondown` -> `@activepieces/piece-buttondown`
+- `camb-ai` -> `@activepieces/piece-camb-ai`
+- `campaign-monitor` -> `@activepieces/piece-campaign-monitor`
+- `canny` -> `@activepieces/piece-canny`
+- `capsule-crm` -> `@activepieces/piece-capsule-crm`
+- `cashfree-payments` -> `@activepieces/piece-cashfree-payments`
+
+## What Is Not Done
+
+1. **Package runtime installation is not bundled into this npm package.**
+   All 669 catalog entries have runtime package names, but `package.json` intentionally declares 0 long-tail runtime packages. The runtime service must install the packages it wants to execute.
+
+2. **Action-name mapping is not complete.**
+   The catalog currently has 3783 actions and 0 verified upstream action-name mappings in the checked-in catalog. The runtime executor supports `actionAliases`, but production aliases must be generated/verified before claiming every action works.
+
+3. **Credential shape mapping is not complete for every connector.**
+   Auth shapes are custom: 248, api_key: 334, oauth2: 69, none: 18. The runtime must map each user connection/secret into the shape expected by that package.
+
+4. **Triggers are cataloged, not universally hosted.**
+   There are 999 catalog triggers. The current Tangle catalog runtime executes actions. Trigger subscription/webhook hosting still needs per-provider runtime support.
+
+5. **First-party coverage is intentionally smaller than catalog breadth.**
+   This repo ships 16 first-party surfaces. The other catalog connectors depend on the package-runtime path.
+
+## Concrete Launch Interpretation
+
+- It is accurate to say: **we have a 669-connector Tangle catalog and a generic runtime execution path.**
+- It is accurate to say: **a connector can work with minimal app code when its runtime package is installed, auth is resolvable, and action aliases are configured.**
+- It is not accurate to say: **all 669 connectors are guaranteed to work out of the box today with zero runtime package/action/auth work.**
+
+## Next Gap To Close
+
+Build a runtime coverage generator that installs/imports each package in isolation, extracts real action names, writes `actionAliases`, and emits a pass/fail matrix per connector:
+
+- package loads
+- action list extracted
+- normalized action maps to real action
+- auth shape identified
+- dry-run invocation possible
+- live smoke credential available