@tangle-network/agent-integrations 0.22.0 → 0.23.0

package/dist/specs.d.ts

@@ -1,3 +1,5 @@
+import { Server, IncomingMessage, ServerResponse } from 'node:http';
+
 type IntegrationSupportTier = 'catalogOnly' | 'setupReady' | 'gatewayExecutable' | 'firstPartyExecutable' | 'sandboxExecutable';
 interface IntegrationCatalogSource {
     id: string;
@@ -572,6 +574,9 @@ type ConnectorCredentials = {
 } | {
     kind: 'api-key';
     apiKey: string;
+} | {
+    kind: 'custom';
+    values: Record<string, unknown>;
 } | {
     kind: 'hmac';
     secret: string;
@@ -1815,6 +1820,9 @@ interface CatalogExecutorProviderOptions {
     startAuth?: (request: StartAuthRequest) => Promise<StartAuthResult> | StartAuthResult;
     completeAuth?: (request: CompleteAuthRequest) => Promise<IntegrationConnection> | IntegrationConnection;
     executeAction: (invocation: CatalogExecutorInvocation) => Promise<IntegrationActionResult> | IntegrationActionResult;
+    subscribeTrigger?: (connection: IntegrationConnection, trigger: NonNullable<IntegrationConnector['triggers']>[number], targetUrl?: string) => Promise<IntegrationTriggerSubscription> | IntegrationTriggerSubscription;
+    unsubscribeTrigger?: (subscriptionId: string) => Promise<void> | void;
+    normalizeTriggerEvent?: (raw: unknown) => Promise<IntegrationTriggerEvent> | IntegrationTriggerEvent;
 }
 declare function createCatalogExecutorProvider(options: CatalogExecutorProviderOptions): IntegrationProvider;
 
@@ -1992,6 +2000,7 @@ interface ActivepiecesCatalogEntry {
     version?: string;
     category: IntegrationConnectorCategory;
     auth: IntegrationConnector['auth'];
+    authFields?: ActivepiecesCatalogAuthField[];
     domains: string[];
     actions: Array<{
         id: string;
@@ -2002,6 +2011,7 @@ interface ActivepiecesCatalogEntry {
     triggers: Array<{
         id: string;
         title: string;
+        upstreamName?: string;
     }>;
     source: {
         repository: string;
@@ -2009,6 +2019,14 @@ interface ActivepiecesCatalogEntry {
         license: 'MIT';
     };
 }
+interface ActivepiecesCatalogAuthField {
+    key: string;
+    label: string;
+    required: boolean;
+    secret: boolean;
+    kind: 'text' | 'number' | 'boolean' | 'select' | 'object' | 'unknown';
+    description?: string;
+}
 declare function listActivepiecesCatalogEntries(): ActivepiecesCatalogEntry[];
 declare function buildActivepiecesConnectors(options?: {
     providerId?: string;
@@ -2145,6 +2163,7 @@ interface TangleIntegrationCatalogEntry {
     description: string;
     category: IntegrationConnector['category'];
     auth: IntegrationConnector['auth'];
+    authFields?: ActivepiecesCatalogEntry['authFields'];
     domains: string[];
     actions: Array<{
         id: string;
@@ -2154,6 +2173,7 @@ interface TangleIntegrationCatalogEntry {
     triggers: Array<{
         id: string;
         title: string;
+        upstreamName?: string;
     }>;
 }
 interface TangleCatalogExecutorInvocation {
@@ -2169,12 +2189,29 @@ interface TangleCatalogExecutorInvocation {
         upstreamActionName?: string;
     };
 }
+interface TangleCatalogTriggerInvocation {
+    connection: IntegrationConnection;
+    connector: IntegrationConnector;
+    catalogEntry: TangleIntegrationCatalogEntry;
+    trigger: NonNullable<IntegrationConnector['triggers']>[number];
+    targetUrl?: string;
+    piece: {
+        id: string;
+        packageName?: string;
+        version?: string;
+        triggerId: string;
+        upstreamTriggerName?: string;
+    };
+}
 interface TangleCatalogExecutorProviderOptions {
     id?: string;
     connectors?: IntegrationConnector[];
     startAuth?: (request: StartAuthRequest) => Promise<StartAuthResult> | StartAuthResult;
     completeAuth?: (request: CompleteAuthRequest) => Promise<IntegrationConnection> | IntegrationConnection;
     executeAction: (invocation: TangleCatalogExecutorInvocation) => Promise<IntegrationActionResult> | IntegrationActionResult;
+    subscribeTrigger?: (invocation: TangleCatalogTriggerInvocation) => Promise<IntegrationTriggerSubscription> | IntegrationTriggerSubscription;
+    unsubscribeTrigger?: (subscriptionId: string) => Promise<void> | void;
+    normalizeTriggerEvent?: (raw: unknown) => Promise<IntegrationTriggerEvent> | IntegrationTriggerEvent;
 }
 type TangleIntegrationCatalogFreshnessOptions = IntegrationCatalogFreshnessOptions;
 interface TangleIntegrationCatalogFreshnessResult {
@@ -2203,6 +2240,11 @@ interface TangleIntegrationCatalogFreshnessResult {
     warnings: string[];
 }
 declare function listTangleIntegrationCatalogEntries(): TangleIntegrationCatalogEntry[];
+declare function listTangleIntegrationCatalogRuntimePackages(): Array<{
+    connectorId: string;
+    packageName: string;
+    version?: string;
+}>;
 declare function buildTangleIntegrationCatalogConnectors(options?: {
     providerId?: string;
     includeCatalogActions?: boolean;
@@ -2232,6 +2274,31 @@ interface TangleCatalogInstalledPackageExecutorOptions {
     resolveAuth?: (connection: IntegrationConnection) => Promise<unknown> | unknown;
     beforeRun?: (invocation: TangleCatalogRuntimeInvocation) => Promise<void> | void;
 }
+interface TangleCatalogAuthResolverOptions {
+    secrets: IntegrationSecretStore;
+    mapCredentials?: (input: {
+        connection: IntegrationConnection;
+        credentials: ConnectorCredentials;
+        connectorId: string;
+    }) => unknown;
+}
+interface TangleCatalogHttpAuthResolverOptions {
+    endpoint: string;
+    secret: string;
+    path?: string;
+    timeoutMs?: number;
+    fetchImpl?: typeof fetch;
+    headers?: Record<string, string>;
+    requestId?: () => string;
+}
+interface TangleCatalogHttpAuthResolverRequest {
+    version: 1;
+    requestId: string;
+    providerId: string;
+    connectorId: string;
+    connectionId: string;
+    secretRef?: IntegrationConnection['secretRef'];
+}
 interface TangleCatalogRuntimeModuleAction {
     name?: string;
     displayName?: string;
@@ -2261,6 +2328,34 @@ interface TangleCatalogRuntimeHttpResponse {
 }
 declare function createTangleCatalogRuntimeHandler(options: TangleCatalogRuntimeHandlerOptions): (input: TangleCatalogRuntimeHttpRequest) => Promise<TangleCatalogRuntimeHttpResponse>;
 declare function createTangleCatalogInstalledPackageExecutor(options?: TangleCatalogInstalledPackageExecutorOptions): TangleCatalogRuntimeHandlerOptions['executeAction'];
+declare function createTangleCatalogCredentialAuthResolver(options: TangleCatalogAuthResolverOptions): (connection: IntegrationConnection) => Promise<unknown>;
+declare function createTangleCatalogHttpAuthResolver(options: TangleCatalogHttpAuthResolverOptions): (connection: IntegrationConnection) => Promise<unknown>;
+declare function tangleCatalogAuthValue(credentials: ConnectorCredentials): unknown;
+
+interface TangleCatalogRuntimeNodeServerOptions {
+    secret: string;
+    host?: string;
+    port?: number;
+    path?: string;
+    maxBodyBytes?: number;
+    requireSignature?: boolean;
+    authResolver?: false | TangleCatalogHttpAuthResolverOptions;
+    executor?: Omit<TangleCatalogInstalledPackageExecutorOptions, 'resolveAuth'> & {
+        resolveAuth?: TangleCatalogInstalledPackageExecutorOptions['resolveAuth'];
+    };
+    onLog?: (event: {
+        level: 'info' | 'warn' | 'error';
+        message: string;
+        metadata?: Record<string, unknown>;
+    }) => void;
+}
+interface StartedTangleCatalogRuntimeNodeServer {
+    server: Server;
+    url: string;
+    close: () => Promise<void>;
+}
+declare function createTangleCatalogRuntimeNodeRequestListener(options: TangleCatalogRuntimeNodeServerOptions): (request: IncomingMessage, response: ServerResponse) => Promise<void>;
+declare function startTangleCatalogRuntimeNodeServer(options: TangleCatalogRuntimeNodeServerOptions): Promise<StartedTangleCatalogRuntimeNodeServer>;
 
 type IntegrationCoveragePriority = 'tier_0' | 'tier_1' | 'tier_2' | 'long_tail';
 interface IntegrationCoverageSpec {
@@ -2721,8 +2816,8 @@ interface InvokeWithCapabilityRequest extends Omit<IntegrationActionRequest, 'co
     connectionId?: never;
 }
 declare class IntegrationError extends Error {
-    readonly code: 'provider_not_found' | 'connector_not_found' | 'connection_not_found' | 'connection_not_active' | 'auth_not_supported' | 'capability_invalid' | 'capability_expired' | 'scope_denied' | 'action_denied' | 'action_not_found' | 'approval_required' | 'policy_denied';
-    constructor(message: string, code: 'provider_not_found' | 'connector_not_found' | 'connection_not_found' | 'connection_not_active' | 'auth_not_supported' | 'capability_invalid' | 'capability_expired' | 'scope_denied' | 'action_denied' | 'action_not_found' | 'approval_required' | 'policy_denied');
+    readonly code: 'provider_not_found' | 'connector_not_found' | 'connection_not_found' | 'connection_not_active' | 'auth_not_supported' | 'capability_invalid' | 'capability_expired' | 'scope_denied' | 'action_denied' | 'action_not_found' | 'trigger_not_found' | 'approval_required' | 'policy_denied';
+    constructor(message: string, code: 'provider_not_found' | 'connector_not_found' | 'connection_not_found' | 'connection_not_active' | 'auth_not_supported' | 'capability_invalid' | 'capability_expired' | 'scope_denied' | 'action_denied' | 'action_not_found' | 'trigger_not_found' | 'approval_required' | 'policy_denied');
 }
 declare class InMemoryConnectionStore implements IntegrationConnectionStore {
     private readonly connections;
@@ -2764,4 +2859,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, 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 };
+export { type HttpIntegrationProviderOptions as $, ACTIVEPIECES_OVERRIDES as A, type ApiKeyAuthSpec, type ConnectionCredentialResolverOptions as B, CANONICAL_INTEGRATION_ACTIONS as C, type ConsoleStep, type CredentialFieldSpec, type CredentialValidationInput, type CredentialValidationResult, type CustomAuthSpec, type ConnectorAdapter as D, type ConnectorAdapterProviderOptions as E, type ConnectorCredentials as F, type ConnectorInvocation as G, type ConnectorManifest as H, type HealthcheckPlan, type HealthcheckSpec, type HmacAuthSpec, type ConnectorManifestValidationIssue 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 ConnectorManifestValidationResult as J, type ConsentSummary as K, type ConsistencyModel as L, CredentialsExpired as M, DEFAULT_INTEGRATION_BRIDGE_ENV as N, type NoneAuthSpec, type NormalizedPermission, DEFAULT_SIGNATURE_TOLERANCE_SECONDS as O, type OAuth2AuthSpec, type DataSourceMetadata as P, type PermissionDescriptor, type PostSetupCheck, DefaultIntegrationActionGuard as Q, type Quirk, type EventHandlerResult as R, type RenderSpecOptions, type RenderedConsoleStep, type ExchangeCodeInput as S, type ScopeDescriptor, type GatewayCatalogAction as T, type GatewayCatalogEntry as U, type GatewayCatalogProviderOptions as V, type GatewayCatalogTrigger as W, type GenericHmacVerifyOptions as X, type GoogleCalendarOptions as Y, type GoogleSheetsOptions as Z, type GraphqlOperationSpec as _, ACTIVEPIECES_PUBLIC_CATALOG_URL as a, type IntegrationInvocationEnvelopeValidationOptions as a$, type HubSpotOptions as a0, type ImportCatalogOptions as a1, InMemoryConnectionStore as a2, InMemoryIntegrationApprovalStore as a3, InMemoryIntegrationAuditStore as a4, InMemoryIntegrationEventStore as a5, InMemoryIntegrationGrantStore as a6, InMemoryIntegrationHealthcheckStore as a7, InMemoryIntegrationIdempotencyStore as a8, InMemoryIntegrationSecretStore as a9, type IntegrationCatalogFreshnessOptions as aA, type IntegrationCatalogFreshnessResult as aB, type IntegrationCatalogSource as aC, type IntegrationConnection as aD, type IntegrationConnectionStore as aE, type IntegrationConnector as aF, type IntegrationConnectorAction as aG, type IntegrationConnectorCategory as aH, type IntegrationConnectorTrigger as aI, type IntegrationCoveragePriority as aJ, type IntegrationCoverageSpec as aK, type IntegrationDataClass as aL, IntegrationError as aM, type IntegrationErrorCode as aN, type IntegrationEventStore as aO, type IntegrationGrant as aP, type IntegrationGrantStore as aQ, type IntegrationGuardContext as aR, type IntegrationHealthcheckCheck as aS, type IntegrationHealthcheckResult as aT, type IntegrationHealthcheckStatus as aU, type IntegrationHealthcheckStore as aV, IntegrationHub as aW, type IntegrationHubOptions as aX, type IntegrationIdempotencyRecord as aY, type IntegrationIdempotencyStore as aZ, type IntegrationInvocationEnvelope as a_, InMemoryIntegrationWorkflowStore as aa, InMemoryOAuthFlowStore as ab, type InboundEvent as ac, type InferIntegrationRequirementsOptions as ad, type InstalledIntegrationWorkflow as ae, type IntegrationActionGuard as af, type IntegrationActionPack as ag, type IntegrationActionRequest as ah, type IntegrationActionResult as ai, type IntegrationActionRisk as aj, type IntegrationActor as ak, type IntegrationApprovalFilter as al, type IntegrationApprovalRecord as am, type IntegrationApprovalRequest as an, type IntegrationApprovalResolution as ao, type IntegrationApprovalStatus as ap, type IntegrationApprovalStore as aq, type IntegrationAuditEvent as ar, type IntegrationAuditEventType as as, assertValidIntegrationSpec, type IntegrationAuditFilter as at, type IntegrationAuditSink as au, type IntegrationAuditStore as av, type IntegrationBridgePayload as aw, type IntegrationBridgeToolBinding as ax, type IntegrationCapability as ay, type IntegrationCapabilityBinding as az, ACTIVEPIECES_RUNTIME_SIGNATURE_HEADER as b, type ProviderPassthroughPolicy as b$, type IntegrationManifest as b0, type IntegrationManifestResolution as b1, type IntegrationPolicyDecision as b2, type IntegrationPolicyEffect as b3, type IntegrationPolicyEngine as b4, type IntegrationPolicyRule as b5, type IntegrationProvider as b6, type IntegrationProviderKind as b7, type IntegrationRateLimitDecision as b8, type IntegrationRateLimiter as b9, type IntegrationWorkflowDefinition as bA, IntegrationWorkflowRuntime as bB, type IntegrationWorkflowRuntimeHub as bC, type IntegrationWorkflowRuntimeOptions as bD, type IntegrationWorkflowStore as bE, type InvokeWithCapabilityRequest as bF, type IssueCapabilityRequest as bG, type IssuedIntegrationCapability as bH, type ManifestValidationIssue as bI, type ManifestValidationResult as bJ, type McpCatalog as bK, type McpCatalogTool as bL, type McpToolDefinition as bM, type MicrosoftCalendarOptions as bN, type MissingRequirementExplanation as bO, type NormalizedIntegrationError as bP, type NormalizedIntegrationResult as bQ, type NotionDatabaseOptions as bR, type OAuthFlowStore as bS, type OAuthTokens as bT, type OpenApiDocument as bU, type OpenApiOperation as bV, PROVIDER_PASSTHROUGH_ACTION as bW, type ParsedStripeSignatureHeader as bX, type PendingOAuthFlow as bY, type PlatformIntegrationPolicyPresetOptions as bZ, type ProviderHttpRequestInput as b_, type IntegrationRegistry as ba, type IntegrationRegistryConflict as bb, type IntegrationRegistryEntry as bc, type IntegrationRegistrySourceRef as bd, type IntegrationRegistrySummary as be, type IntegrationRequirement as bf, type IntegrationRequirementMode as bg, type IntegrationRequirementResolution as bh, type IntegrationRequirementStatus as bi, IntegrationRuntime as bj, IntegrationRuntimeError as bk, type IntegrationRuntimeHub as bl, type IntegrationRuntimeOptions as bm, type IntegrationSandboxBundle as bn, IntegrationSandboxHost as bo, type IntegrationSandboxHostHub as bp, type IntegrationSandboxHostOptions as bq, type IntegrationSecretStore as br, type IntegrationSupportTier as bs, type IntegrationToolDefinition as bt, type IntegrationToolSearchFilters as bu, buildHealthcheckPlan, type IntegrationToolSearchResult as bv, type IntegrationTriggerEvent as bw, type IntegrationTriggerSubscription as bx, type IntegrationUserAction as by, type IntegrationWebhookReceiverResult as bz, type ActivepiecesCatalogAuthField as c, buildIntegrationCoverageConnectors as c$, type RateLimitSpec as c0, type RefreshInput as c1, type RenderConsentOptions as c2, type ResolvedDataSource as c3, ResourceContention as c4, type RestConnectorSpec as c5, type RestCredentialPlacement as c6, type RestOperationSpec as c7, type RestRequestSpec as c8, type SecretRef as c9, type TangleCatalogRuntimeModuleAction as cA, type TangleCatalogRuntimeNodeServerOptions as cB, type TangleCatalogRuntimeRequest as cC, type TangleCatalogTriggerInvocation as cD, type TangleIntegrationCatalogEntry as cE, type TangleIntegrationCatalogFreshnessOptions as cF, type TangleIntegrationCatalogFreshnessResult as cG, type TangleIntegrationInvokeInput as cH, type TangleIntegrationInvokeResult as cI, TangleIntegrationsClient as cJ, type TangleIntegrationsClientOptions as cK, type TwilioVerifyOptions as cL, _resetPendingFlowsForTests as cM, adapterManifestsToConnectors as cN, airtableConnector as cO, asanaConnector as cP, assertValidConnectorManifest as cQ, assertValidIntegrationManifest as cR, auditIntegrationCatalogFreshness as cS, auditTangleIntegrationCatalogFreshness as cT, buildActivepiecesConnectors as cU, buildActivepiecesRuntimeRequest as cV, buildApprovalRequest as cW, buildCanonicalLaunchConnectors as cX, buildDefaultIntegrationRegistry as cY, buildIntegrationBridgeEnvironment as cZ, buildIntegrationBridgePayload as c_, type SlackOptions as ca, type SlackVerifyOptions as cb, type StartAuthRequest as cc, type StartAuthResult as cd, type StartOAuthInput as ce, type StartOAuthOutput as cf, type StartedTangleCatalogRuntimeNodeServer as cg, StaticIntegrationPolicyEngine as ch, type StaticIntegrationPolicyOptions as ci, type StoredIntegrationEvent as cj, type StripeVerifyOptions as ck, TANGLE_CATALOG_RUNTIME_SIGNATURE_HEADER as cl, TANGLE_INTEGRATIONS_CATALOG_PROVIDER_ID as cm, TANGLE_INTEGRATIONS_CATALOG_SOURCE as cn, type TangleCatalogAuthResolverOptions as co, consoleStepsToText, type TangleCatalogExecutorInvocation as cp, type TangleCatalogExecutorProviderOptions as cq, type TangleCatalogHttpAuthResolverOptions as cr, type TangleCatalogHttpAuthResolverRequest as cs, type TangleCatalogHttpExecutorInvocation as ct, type TangleCatalogHttpExecutorOptions as cu, type TangleCatalogInstalledPackageExecutorOptions as cv, type TangleCatalogRuntimeHandlerOptions as cw, type TangleCatalogRuntimeHttpRequest as cx, type TangleCatalogRuntimeHttpResponse as cy, type TangleCatalogRuntimeInvocation as cz, type ActivepiecesCatalogEntry as d, listTangleIntegrationCatalogRuntimePackages as d$, buildIntegrationInvocationEnvelope as d0, buildIntegrationToolCatalog as d1, buildTangleCatalogRuntimeRequest as d2, buildTangleIntegrationCatalogConnectors as d3, calendarExercisePlannerManifest as d4, canonicalActionConnectorId as d5, canonicalConnectorId as d6, composeIntegrationRegistry as d7, consumePendingFlow as d8, createActivepiecesExecutorProvider as d9, declarativeRestConnector as dA, decodeIntegrationBridgePayload as dB, dispatchIntegrationInvocation as dC, encodeIntegrationBridgePayload as dD, exchangeAuthorizationCode as dE, explainMissingRequirements as dF, extractActivepiecesPublicPieceCount as dG, extractExternalCatalogPublicCount as dH, firstHeader as dI, getActivepiecesOverride as dJ, githubConnector as dK, gitlabConnector as dL, googleCalendar as dM, googleSheets as dN, healthcheckRequest as dO, hubspot as dP, importGraphqlConnector as dQ, importMcpConnector as dR, importOpenApiConnector as dS, inferIntegrationManifestFromTools as dT, inferIntegrationSupportTier as dU, integrationCoverageChecklistMarkdown as dV, integrationToolName as dW, invocationRequestFromEnvelope as dX, listActivepiecesCatalogEntries as dY, listIntegrationCoverageSpecs as dZ, listTangleIntegrationCatalogEntries as d_, createActivepiecesHttpExecutor as da, createApprovalBackedPolicyEngine as db, createAuditingActionGuard as dc, createCatalogExecutorProvider as dd, createConnectionCredentialResolver as de, createConnectorAdapterCatalogSource as df, createConnectorAdapterProvider as dg, createCredentialBackedAdapterProvider as dh, createDefaultIntegrationActionGuard as di, createDefaultIntegrationPolicyEngine as dj, createGatewayCatalogProvider as dk, createHttpIntegrationProvider as dl, createIntegrationAuditEvent as dm, createIntegrationRuntime as dn, createIntegrationWorkflowRuntime as dp, createMockIntegrationProvider as dq, createPlatformIntegrationPolicyPreset as dr, createTangleCatalogCredentialAuthResolver as ds, createTangleCatalogExecutorProvider as dt, createTangleCatalogHttpAuthResolver as du, createTangleCatalogHttpExecutor as dv, createTangleCatalogInstalledPackageExecutor as dw, createTangleCatalogRuntimeHandler as dx, createTangleCatalogRuntimeNodeRequestListener as dy, createTangleIntegrationsClient as dz, type ActivepiecesExecutorInvocation as e, manifestToConnector as e0, microsoftCalendar as e1, normalizeGatewayCatalog as e2, normalizeIntegrationError as e3, normalizeIntegrationResult as e4, notionDatabase as e5, parseIntegrationBridgeEnvironment as e6, parseIntegrationToolName as e7, parseStripeSignatureHeader as e8, receiveIntegrationWebhook as e9, stripeWebhookReceiverConnector as eA, summarizeIntegrationRegistry as eB, tangleCatalogAuthValue as eC, toMcpTools as eD, twilioSmsConnector as eE, validateConnectorManifest as eF, validateIntegrationInvocationEnvelope as eG, validateIntegrationManifest as eH, validateProviderPassthroughRequest as eI, verifyActivepiecesRuntimeSignature as eJ, verifyCapabilityToken as eK, verifyHmacSignature as eL, verifySlackSignature as eM, verifyStripeSignature as eN, verifyTangleCatalogRuntimeSignature as eO, verifyTwilioSignature as eP, webhookConnector as eQ, redactApprovalRequest as ea, redactCapability as eb, redactIntegrationBridgePayload as ec, redactInvocationEnvelope as ed, refreshAccessToken as ee, renderApprovalCopy as ef, renderConsentSummary as eg, resolveConnectionCredentials as eh, resolveIntegrationApproval as ei, revokeConnection as ej, runIntegrationHealthcheck as ek, runIntegrationHealthchecks as el, salesforceConnector as em, sanitizeAuditConnection as en, sanitizeConnection as eo, searchIntegrationTools as ep, signActivepiecesRuntimeRequest as eq, signCapability as er, signTangleCatalogRuntimeRequest as es, slack as et, slackEventsConnector as eu, startOAuthFlow as ev, startTangleCatalogRuntimeNodeServer as ew, statusForCode as ex, storedEventToTriggerEvent as ey, stripePackConnector as ez, type ActivepiecesExecutorProviderOptions as f, type ActivepiecesHttpExecutorOptions as g, getIntegrationFamily, getIntegrationSpec, type ActivepiecesPieceOverride as h, type ActivepiecesRuntimeRequest as i, integrationSpecToConnector, ApprovalBackedPolicyEngine as j, type ApprovalBackedPolicyOptions as k, type AuthSpec as l, listExecutableIntegrationSpecs, listIntegrationSpecs, type CASStrategy as m, type CanonicalIntegrationActionId as n, type CanonicalLaunchConnectorOptions as o, type Capability as p, type CapabilityClass as q, type CapabilityMutation as r, renderAgentToolDescription, renderConsoleSteps, renderRunbookMarkdown, type CapabilityMutationResult as s, specAuthToConnectorAuth, type CapabilityParameterSchema as t, type CapabilityRead as u, type CapabilityReadResult as v, validateCredentialFormat, validateCredentialSet, validateIntegrationSpec, type CatalogExecutorInvocation as w, type CatalogExecutorProviderOptions as x, type CompleteAuthRequest as y, type ComposeIntegrationRegistryOptions as z };

package/docs/integration-execution-audit.md

@@ -0,0 +1,198 @@
+# 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 | 3790 |
+| Catalog triggers | 998 |
+| Catalog triggers with verified upstream names in this repo | 998 |
+| Catalog actions with verified upstream action names in this repo | 3790 |
+| Catalog connectors with auth field metadata | 648 |
+| Custom-auth connectors with auth field metadata | 11 |
+| 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 | 3970 |
+
+Full machine-readable matrix: [integration-execution-matrix.json](./integration-execution-matrix.json).
+
+## Auth Breakdown
+
+| Auth | Connectors |
+| --- | --- |
+| api_key | 519 |
+| oauth2 | 118 |
+| none | 21 |
+| custom | 11 |
+
+## Category Breakdown
+
+| Category | Connectors |
+| --- | --- |
+| workflow | 271 |
+| crm | 178 |
+| docs | 76 |
+| chat | 58 |
+| storage | 29 |
+| database | 28 |
+| webhook | 18 |
+| email | 5 |
+| calendar | 3 |
+| internal | 3 |
+
+## 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, 3790 actions, 998 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 | Wiring done; package install/smoke pending | 669 entries have package names and 3790 actions have upstream names. Runtime packages are not bundled into this npm package. |
+| Long-tail credential mapping | Mostly mapped | 648 connectors have auth field metadata. 0 custom-auth connectors still need exact manual auth fields. |
+| Trigger provider flow | Done structurally | 998 triggers are cataloged, 998 have upstream names, and catalog providers can route subscribe/unsubscribe/normalize hooks. Runtime services still need package-specific trigger hosting. |
+| 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 | 0 | We normalized action labels, but have not checked the exact runtime action export names into the catalog. |
+| Custom-auth catalog connectors needing manual credential-field mapping | 0 | These are still custom auth and no field names were extracted from source. |
+| Catalog connectors with triggers needing runtime-service hosting | 288 | Trigger metadata and provider hooks exist; runtime services still need package-specific webhook/polling hosting. |
+
+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 manual custom auth mapping:
+
+
+
+## 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 complete for cataloged actions.**
+   Done for cataloged actions: the catalog currently has 3790 actions and 3790 verified upstream action-name mappings in the checked-in catalog. The runtime executor uses those names automatically and still accepts explicit `actionAliases` for overrides.
+
+3. **Credential field mapping is complete for catalog auth setup.**
+   Auth shapes are api_key: 519, oauth2: 118, none: 21, custom: 11. The catalog now includes auth field metadata for all 648 connectors that require credentials. 0 custom-auth connectors need manual auth-field mapping.
+
+4. **Triggers are cataloged, not universally hosted.**
+   There are 998 catalog triggers and 998 upstream trigger names. The provider flow now supports trigger subscribe/unsubscribe/normalize hooks. Runtime services still need package-specific webhook/polling hosting.
+
+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
+- package installed in the runtime service
+- package load verified
+- normalized action maps to real action
+- auth shape identified or marked as manual
+- dry-run invocation possible
+- live smoke credential available