@tangle-network/agent-integrations 0.16.1 → 0.17.0

package/dist/specs.d.ts

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

package/docs/adapter-triage.md

@@ -0,0 +1,206 @@
+# Adapter Triage
+
+This is the execution-readiness map for `agent-integrations`.
+
+The important distinction:
+
+- `catalogOnly`: known provider/action metadata. Good for search, planning,
+  and demand capture. Not safe to invoke.
+- `setupReady`: has connection/setup/spec metadata. Good for OAuth/admin UI and
+  generated app requirements. Still needs an executable provider.
+- `gatewayExecutable`: callable through an explicitly configured gateway
+  provider.
+- `firstPartyExecutable`: callable through a reviewed adapter in this package.
+- `sandboxExecutable`: callable directly from generated sandbox apps with a
+  narrowed capability token.
+
+Do not treat catalog or setup entries as executable tools. Generated apps and
+agents must only receive executable capabilities.
+
+## Current First-Party Adapters
+
+These are real adapters in `src/connectors/adapters` with read/write or event
+behavior behind the `ConnectorAdapter` contract.
+
+| Connector | Auth | Surface | Status |
+| --- | --- | --- | --- |
+| `google-calendar` | OAuth2 | read/write | first-party executable |
+| `google-sheets` | OAuth2 | read/write | first-party executable |
+| `microsoft-calendar` | OAuth2 | read/write | first-party executable |
+| `hubspot` | OAuth2 | read/write | first-party executable |
+| `slack` | OAuth2 | read/write | first-party executable |
+| `notion-database` | OAuth2 | read/write | first-party executable |
+| `salesforce` | OAuth2 | read/write | first-party executable |
+| `twilio-sms` | API key | read/write | first-party executable |
+| `stripe-pack` | API key | read/write | first-party executable |
+| `github` | API key | read/write | first-party executable |
+| `gitlab` | API key | read/write | first-party executable |
+| `airtable` | API key | read/write | first-party executable |
+| `asana` | API key | read/write | first-party executable |
+| `webhook` | HMAC | read/write | first-party executable |
+| `stripe` | HMAC | inbound events | first-party executable |
+| `slack-inbound` | HMAC | inbound events | first-party executable |
+
+Aliases matter when comparing coverage:
+
+- `outlook-calendar` maps to `microsoft-calendar`.
+- `notion` maps to `notion-database`.
+- `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({
+  async executeAction({ piece, request, connection }) {
+    return runInHardenedExecutor({
+      packageName: piece.npmPackage,
+      version: piece.version,
+      actionId: piece.actionId,
+      upstreamActionName: piece.upstreamActionName,
+      input: request.input,
+      connection,
+    })
+  },
+})
+
+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
+registry resolves all coverage IDs to setup-ready entries, including alias
+lookups.
+
+| Priority | Count | Current library status |
+| --- | ---: | --- |
+| Tier 0 | 38 | setup-ready specs |
+| Tier 1 | 89 | setup-ready specs |
+| Tier 2 | 14 | setup-ready specs |
+| Long tail | 1 | setup-ready spec |
+
+Four Tier 0 entries are canonicalized aliases:
+
+- `outlook-calendar` should resolve to `microsoft-calendar`.
+- `notion` should resolve to `notion-database`.
+- `stripe` should resolve to `stripe-pack` for outbound payment actions and
+  `stripe` for inbound webhooks.
+- `twilio` should resolve to `twilio-sms`.
+
+## Tier 0 Promotion Queue
+
+### Already First-Party Executable
+
+- Google Calendar
+- Google Sheets
+- Outlook Calendar / Microsoft Calendar
+- Slack
+- HubSpot
+- Notion database
+- Salesforce
+- GitHub
+- Airtable
+- Stripe payments pack
+- Twilio SMS
+- Generic webhook
+
+### Next First-Party Adapters
+
+These should be promoted before claiming broad production readiness for
+generated agent apps.
+
+1. Gmail: read/search/send email, thread summaries, draft/send approval path.
+2. Google Drive: file search/list/download/upload, scoped file grants.
+3. Outlook Mail: read/search/send email, same approval model as Gmail.
+4. OneDrive: file search/list/download/upload.
+5. Google Docs: read/export/create/update docs.
+6. Microsoft Teams: channel/message read/write.
+7. Linear: issues/projects/comments.
+8. Jira: issues/projects/comments.
+9. Zendesk: tickets/users/comments.
+10. Intercom: conversations/contacts/messages.
+11. Shopify: customers/orders/products.
+12. QuickBooks: customers/invoices/payments.
+13. Mailchimp: audiences/campaigns.
+14. Klaviyo: profiles/events/campaign triggers.
+15. Google Analytics: properties/reports.
+16. Postgres: query/read/write with explicit SQL policy.
+17. BigQuery: query/jobs/datasets.
+18. Snowflake: query/warehouse scoped execution.
+19. Amazon S3: list/get/put objects.
+20. Figma: files/comments/assets.
+
+### Setup-Ready, Use Gateway Or Declarative REST First
+
+These are valuable, but do not need bespoke hand adapters immediately if a
+gateway provider or reviewed declarative REST spec covers the first launch use
+case.
+
+- Dropbox, Box, SharePoint, Coda, Confluence
+- Pipedrive, Zoho CRM, Close, Attio
+- Trello, monday.com, ClickUp
+- Freshdesk, Help Scout, Front, Gorgias
+- Xero, NetSuite, Plaid
+- WooCommerce, BigCommerce, Amazon Seller Central
+- Marketo, Braze, Customer.io, SendGrid, Postmark
+- Discord, Telegram, WhatsApp Business
+- Facebook Pages, Instagram Business, LinkedIn, X/Twitter, YouTube
+- Mixpanel, Amplitude, Segment
+- Redshift, MySQL, MongoDB, Supabase, Firebase
+- Google Cloud Storage, Azure Blob Storage
+- Vercel, Cloudflare, Sentry, Datadog, PagerDuty
+- Okta, Auth0
+- Workday, BambooHR, Greenhouse, Lever, Gusto, Rippling
+- DocuSign, PandaDoc, Clio, Ironclad
+- Calendly, Cal.com, Zoom, Google Meet
+- OpenAI, Anthropic, Gemini, Hugging Face
+- Pinecone, Weaviate, Qdrant
+- Typeform, Google Forms, Webflow, WordPress, Contentful, Sanity, Canva, Miro
+
+## Product Release Gates
+
+Before any product says an integration is “supported” for real users:
+
+- It is exposed as `firstPartyExecutable`, `gatewayExecutable`, or
+  `sandboxExecutable`.
+- It has a real connection flow or gateway credential path.
+- It has action input schemas good enough for LLM tool binding.
+- It classifies auth, scope, rate-limit, provider outage, validation,
+  approval-required, and conflict errors.
+- Writes and destructive actions require approval unless explicitly allowed by
+  policy.
+- Mutations have idempotency or an explicit “not idempotent” guard.
+- It has a healthcheck.
+- It has at least one mocked unit test and one live smoke path gated by
+  credentials.
+
+## Immediate Fixes
+
+- Include first-party adapter catalogs in registry composition when a consumer
+  provides adapter instances.
+- Add a generated triage command that compares coverage specs, setup specs,
+  active catalog entries, and adapter manifests.
+- Promote Gmail, Drive, Outlook Mail, Linear, Jira, Zendesk, Intercom, Shopify,
+  QuickBooks, S3, and Postgres first.

package/docs/integration-coverage-checklist.md

@@ -24,6 +24,8 @@ Goal: cover the integrations that make agents useful for 99% of practical produc
 - [ ] Tier 0 connector failures are classified by auth, scope, rate-limit, provider outage, validation, approval, and conflict.
 - [ ] 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`.
 
 ## Tier 0 First-Party Promotion Queue
 
@@ -37,7 +39,7 @@ Goal: cover the integrations that make agents useful for 99% of practical produc
 - [x] Generic webhook
 - [ ] Gmail
 - [ ] Outlook Mail
-- [ ] Outlook Calendar
+- [x] Outlook Calendar via `microsoft-calendar`
 - [ ] Google Drive
 - [ ] Google Docs
 - [ ] Microsoft Teams
@@ -60,7 +62,7 @@ Goal: cover the integrations that make agents useful for 99% of practical produc
 - [ ] Amazon S3
 - [ ] Calendly
 - [ ] Zoom
-- [ ] Microsoft Graph
+- [ ] Microsoft Graph broader graph pack
 - [ ] OpenAI
 - [ ] Figma
 

package/package.json

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