@tangle-network/agent-integrations 0.9.0 → 0.13.0

package/dist/index.d.ts

@@ -1,3 +1,58 @@
+type IntegrationSupportTier = 'catalogOnly' | 'setupReady' | 'gatewayExecutable' | 'firstPartyExecutable' | 'sandboxExecutable';
+interface IntegrationCatalogSource {
+    id: string;
+    connectors: IntegrationConnector[];
+    precedence?: number;
+}
+interface IntegrationRegistrySourceRef {
+    sourceId: string;
+    providerId: string;
+    connectorId: string;
+    supportTier: IntegrationSupportTier;
+    actionCount: number;
+    triggerCount: number;
+}
+interface IntegrationRegistryConflict {
+    field: 'auth' | 'category';
+    values: Array<{
+        value: string;
+        sourceId: string;
+        connectorId: string;
+    }>;
+}
+interface IntegrationRegistryEntry {
+    canonicalId: string;
+    connector: IntegrationConnector;
+    aliases: string[];
+    supportTier: IntegrationSupportTier;
+    sources: IntegrationRegistrySourceRef[];
+    conflicts: IntegrationRegistryConflict[];
+}
+interface IntegrationRegistry {
+    entries: IntegrationRegistryEntry[];
+    connectors: IntegrationConnector[];
+    byId: Map<string, IntegrationRegistryEntry>;
+}
+interface IntegrationRegistrySummary {
+    totalEntries: number;
+    totalSources: number;
+    toolBindableEntries: number;
+    conflictEntries: number;
+    bySupportTier: Record<IntegrationSupportTier, number>;
+}
+interface ComposeIntegrationRegistryOptions {
+    aliases?: Record<string, string>;
+    sourcePrecedence?: Record<string, number>;
+}
+declare function buildDefaultIntegrationRegistry(options?: {
+    includeSpecs?: boolean;
+    includeActivepieces?: boolean;
+}): IntegrationRegistry;
+declare function composeIntegrationRegistry(sources: IntegrationCatalogSource[], options?: ComposeIntegrationRegistryOptions): IntegrationRegistry;
+declare function summarizeIntegrationRegistry(registry: IntegrationRegistry): IntegrationRegistrySummary;
+declare function canonicalConnectorId(id: string, aliases?: Record<string, string>): string;
+declare function inferIntegrationSupportTier(connector: IntegrationConnector): IntegrationSupportTier;
+
 /**
  * Connector primitives — the contract a concrete first-party integration
  * (Google Calendar, HubSpot, Stripe, ...) implements. Lower level than the
@@ -1183,6 +1238,96 @@ declare function importOpenApiConnector(document: OpenApiDocument, options: Impo
 declare function importGraphqlConnector(operations: GraphqlOperationSpec[], options: ImportCatalogOptions): IntegrationConnector;
 declare function importMcpConnector(catalog: McpCatalog, options: ImportCatalogOptions): IntegrationConnector;
 
+interface GatewayCatalogProviderOptions {
+    id: string;
+    kind: Extract<IntegrationProviderKind, 'nango' | 'pipedream' | 'activepieces' | 'zapier' | 'executor' | 'custom'>;
+    fetchCatalog: () => Promise<GatewayCatalogEntry[]> | GatewayCatalogEntry[];
+    startAuth?: (request: StartAuthRequest) => Promise<StartAuthResult> | StartAuthResult;
+    completeAuth?: (request: CompleteAuthRequest) => Promise<IntegrationConnection> | IntegrationConnection;
+    invokeAction?: (connection: IntegrationConnection, request: IntegrationActionRequest) => Promise<IntegrationActionResult> | IntegrationActionResult;
+    cacheTtlMs?: number;
+    now?: () => Date;
+}
+interface GatewayCatalogEntry {
+    id?: string;
+    key?: string;
+    name?: string;
+    title?: string;
+    category?: string;
+    auth?: 'oauth2' | 'api_key' | 'none' | 'custom' | string;
+    scopes?: string[];
+    actions?: GatewayCatalogAction[];
+    triggers?: GatewayCatalogTrigger[];
+    metadata?: Record<string, unknown>;
+}
+interface GatewayCatalogAction {
+    id?: string;
+    key?: string;
+    name?: string;
+    title?: string;
+    description?: string;
+    risk?: 'read' | 'write' | 'destructive' | string;
+    scopes?: string[];
+    requiredScopes?: string[];
+    dataClass?: IntegrationDataClass | string;
+    approvalRequired?: boolean;
+    inputSchema?: unknown;
+    outputSchema?: unknown;
+}
+interface GatewayCatalogTrigger {
+    id?: string;
+    key?: string;
+    name?: string;
+    title?: string;
+    description?: string;
+    scopes?: string[];
+    requiredScopes?: string[];
+    dataClass?: IntegrationDataClass | string;
+    payloadSchema?: unknown;
+}
+declare function createGatewayCatalogProvider(options: GatewayCatalogProviderOptions): IntegrationProvider;
+declare function normalizeGatewayCatalog(entries: GatewayCatalogEntry[], options: {
+    providerId: string;
+    providerKind: IntegrationProviderKind;
+}): IntegrationConnector[];
+
+interface ActivepiecesCatalogEntry {
+    id: string;
+    title: string;
+    description: string;
+    npmPackage?: string;
+    version?: string;
+    category: IntegrationConnectorCategory;
+    auth: IntegrationConnector['auth'];
+    domains: string[];
+    actions: Array<{
+        id: string;
+        title: string;
+        risk: IntegrationActionRisk;
+    }>;
+    triggers: Array<{
+        id: string;
+        title: string;
+    }>;
+    source: {
+        repository: string;
+        path: string;
+        license: 'MIT';
+    };
+}
+declare function listActivepiecesCatalogEntries(): ActivepiecesCatalogEntry[];
+declare function buildActivepiecesConnectors(options?: {
+    providerId?: string;
+}): IntegrationConnector[];
+
+interface ActivepiecesPieceOverride {
+    category?: IntegrationConnectorCategory;
+    actionRisks?: Record<string, IntegrationActionRisk>;
+    approvalRequired?: Record<string, boolean>;
+}
+declare const ACTIVEPIECES_OVERRIDES: Record<string, ActivepiecesPieceOverride>;
+declare function getActivepiecesOverride(id: string): ActivepiecesPieceOverride | undefined;
+
 type IntegrationCoveragePriority = 'tier_0' | 'tier_1' | 'tier_2' | 'long_tail';
 interface IntegrationCoverageSpec {
     id: string;
@@ -1393,7 +1538,7 @@ type IntegrationConnectorCategory = 'email' | 'calendar' | 'chat' | 'crm' | 'sto
 type IntegrationActionRisk = 'read' | 'write' | 'destructive';
 type IntegrationDataClass = 'public' | 'internal' | 'private' | 'sensitive' | 'secret';
 interface IntegrationActor {
-    type: 'user' | 'team' | 'agent' | 'sandbox' | 'system';
+    type: 'user' | 'team' | 'app' | 'agent' | 'sandbox' | 'system';
     id: string;
 }
 interface IntegrationConnectorAction {
@@ -1662,6 +1807,7 @@ declare class IntegrationHub {
     private readonly now;
     constructor(options: IntegrationHubOptions);
     listConnectors(): Promise<IntegrationConnector[]>;
+    listRegistry(options?: ComposeIntegrationRegistryOptions): Promise<IntegrationRegistry>;
     startAuth(providerId: string, request: StartAuthRequest): Promise<StartAuthResult>;
     completeAuth(providerId: string, request: CompleteAuthRequest): Promise<IntegrationConnection>;
     upsertConnection(connection: IntegrationConnection): Promise<IntegrationConnection>;
@@ -1684,4 +1830,4 @@ declare function createHttpIntegrationProvider(options: HttpIntegrationProviderO
 declare function signCapability(capability: IntegrationCapability, secret: string): string;
 declare function verifyCapabilityToken(token: string, secret: string): IntegrationCapability;
 
-export { type ApiKeyAuthSpec, type AuthSpec, type CASStrategy, type Capability, type CapabilityClass, type CapabilityMutation, type CapabilityMutationResult, type CapabilityParameterSchema, type CapabilityRead, type CapabilityReadResult, type CompleteAuthRequest, type ConnectorAdapter, type ConnectorAdapterProviderOptions, type ConnectorCredentials, type ConnectorInvocation, type ConnectorManifest, type ConnectorManifestValidationIssue, type ConnectorManifestValidationResult, type ConsistencyModel, type ConsoleStep, type CredentialFieldSpec, type CredentialValidationInput, type CredentialValidationResult, CredentialsExpired, type CustomAuthSpec, DEFAULT_SIGNATURE_TOLERANCE_SECONDS, type DataSourceMetadata, type EventHandlerResult, type ExchangeCodeInput, type GenericHmacVerifyOptions, type GoogleCalendarOptions, type GoogleSheetsOptions, type GraphqlOperationSpec, type HealthcheckPlan, type HealthcheckSpec, type HmacAuthSpec, type HttpIntegrationProviderOptions, type HubSpotOptions, INTEGRATION_FAMILIES, type ImportCatalogOptions, InMemoryConnectionStore, InMemoryOAuthFlowStore, type InboundEvent, type IntegrationActionGuard, type IntegrationActionPack, type IntegrationActionRequest, type IntegrationActionResult, type IntegrationActionRisk, type IntegrationActor, type IntegrationApprovalRequest, type IntegrationApprovalResolution, type IntegrationAuthMode, type IntegrationAuthSpec, type IntegrationCapability, type IntegrationConnection, type IntegrationConnectionStore, type IntegrationConnector, type IntegrationConnectorAction, type IntegrationConnectorCategory, type IntegrationConnectorTrigger, type IntegrationCoveragePriority, type IntegrationCoverageSpec, type IntegrationDataClass, IntegrationError, type IntegrationFamilyId, type IntegrationFamilySpec, type IntegrationGuardContext, IntegrationHub, type IntegrationHubOptions, type IntegrationInvocationEnvelope, type IntegrationInvocationEnvelopeValidationOptions, type IntegrationLifecycleSpec, type IntegrationPlannerHints, type IntegrationPolicyDecision, type IntegrationPolicyEffect, type IntegrationPolicyEngine, type IntegrationPolicyRule, type IntegrationProvider, type IntegrationProviderKind, type IntegrationSetupSpec, type IntegrationSpec, type IntegrationSpecStatus, type IntegrationSpecValidationIssue, type IntegrationSpecValidationResult, type IntegrationToolDefinition, type IntegrationToolSearchFilters, type IntegrationToolSearchResult, type IntegrationTriggerEvent, type IntegrationTriggerSubscription, type InvokeWithCapabilityRequest, type IssueCapabilityRequest, type IssuedIntegrationCapability, type McpCatalog, type McpCatalogTool, type McpToolDefinition, type MicrosoftCalendarOptions, type NoneAuthSpec, type NormalizedIntegrationResult, type NormalizedPermission, type NotionDatabaseOptions, type OAuth2AuthSpec, type OAuthFlowStore, type OAuthTokens, type OpenApiDocument, type OpenApiOperation, type ParsedStripeSignatureHeader, type PendingOAuthFlow, type PermissionDescriptor, type PostSetupCheck, type Quirk, type RateLimitSpec, type RefreshInput, type RenderSpecOptions, type RenderedConsoleStep, type ResolvedDataSource, ResourceContention, type RestConnectorSpec, type RestCredentialPlacement, type RestOperationSpec, type RestRequestSpec, type ScopeDescriptor, type SecretRef, type SlackOptions, type SlackVerifyOptions, type StartAuthRequest, type StartAuthResult, type StartOAuthInput, type StartOAuthOutput, StaticIntegrationPolicyEngine, type StaticIntegrationPolicyOptions, type StripeVerifyOptions, type TwilioVerifyOptions, _resetPendingFlowsForTests, airtableConnector, asanaConnector, assertValidConnectorManifest, assertValidIntegrationSpec, buildApprovalRequest, buildHealthcheckPlan, buildIntegrationCoverageConnectors, buildIntegrationInvocationEnvelope, buildIntegrationToolCatalog, consoleStepsToText, consumePendingFlow, createConnectorAdapterProvider, createDefaultIntegrationPolicyEngine, createHttpIntegrationProvider, createMockIntegrationProvider, declarativeRestConnector, exchangeAuthorizationCode, firstHeader, getIntegrationFamily, getIntegrationSpec, githubConnector, gitlabConnector, googleCalendar, googleSheets, hubspot, importGraphqlConnector, importMcpConnector, importOpenApiConnector, integrationCoverageChecklistMarkdown, integrationSpecToConnector, integrationToolName, invocationRequestFromEnvelope, listExecutableIntegrationSpecs, listIntegrationCoverageSpecs, listIntegrationSpecs, manifestToConnector, microsoftCalendar, normalizeIntegrationResult, notionDatabase, parseIntegrationToolName, parseStripeSignatureHeader, redactApprovalRequest, redactCapability, redactInvocationEnvelope, refreshAccessToken, renderAgentToolDescription, renderConsoleSteps, renderRunbookMarkdown, salesforceConnector, sanitizeConnection, searchIntegrationTools, signCapability, slack, slackEventsConnector, specAuthToConnectorAuth, startOAuthFlow, stripePackConnector, stripeWebhookReceiverConnector, toMcpTools, twilioSmsConnector, validateConnectorManifest, validateCredentialFormat, validateCredentialSet, validateIntegrationInvocationEnvelope, validateIntegrationSpec, verifyCapabilityToken, verifyHmacSignature, verifySlackSignature, verifyStripeSignature, verifyTwilioSignature, webhookConnector };
+export { ACTIVEPIECES_OVERRIDES, type ActivepiecesCatalogEntry, type ActivepiecesPieceOverride, type ApiKeyAuthSpec, type AuthSpec, type CASStrategy, type Capability, type CapabilityClass, type CapabilityMutation, type CapabilityMutationResult, type CapabilityParameterSchema, type CapabilityRead, type CapabilityReadResult, type CompleteAuthRequest, type ComposeIntegrationRegistryOptions, type ConnectorAdapter, type ConnectorAdapterProviderOptions, type ConnectorCredentials, type ConnectorInvocation, type ConnectorManifest, type ConnectorManifestValidationIssue, type ConnectorManifestValidationResult, type ConsistencyModel, type ConsoleStep, type CredentialFieldSpec, type CredentialValidationInput, type CredentialValidationResult, CredentialsExpired, type CustomAuthSpec, DEFAULT_SIGNATURE_TOLERANCE_SECONDS, type DataSourceMetadata, type EventHandlerResult, type ExchangeCodeInput, type GatewayCatalogAction, type GatewayCatalogEntry, type GatewayCatalogProviderOptions, type GatewayCatalogTrigger, type GenericHmacVerifyOptions, type GoogleCalendarOptions, type GoogleSheetsOptions, type GraphqlOperationSpec, type HealthcheckPlan, type HealthcheckSpec, type HmacAuthSpec, type HttpIntegrationProviderOptions, type HubSpotOptions, INTEGRATION_FAMILIES, type ImportCatalogOptions, InMemoryConnectionStore, InMemoryOAuthFlowStore, type InboundEvent, type IntegrationActionGuard, type IntegrationActionPack, type IntegrationActionRequest, type IntegrationActionResult, type IntegrationActionRisk, type IntegrationActor, type IntegrationApprovalRequest, type IntegrationApprovalResolution, type IntegrationAuthMode, type IntegrationAuthSpec, type IntegrationCapability, type IntegrationCatalogSource, type IntegrationConnection, type IntegrationConnectionStore, type IntegrationConnector, type IntegrationConnectorAction, type IntegrationConnectorCategory, type IntegrationConnectorTrigger, type IntegrationCoveragePriority, type IntegrationCoverageSpec, type IntegrationDataClass, IntegrationError, type IntegrationFamilyId, type IntegrationFamilySpec, type IntegrationGuardContext, IntegrationHub, type IntegrationHubOptions, type IntegrationInvocationEnvelope, type IntegrationInvocationEnvelopeValidationOptions, type IntegrationLifecycleSpec, type IntegrationPlannerHints, type IntegrationPolicyDecision, type IntegrationPolicyEffect, type IntegrationPolicyEngine, type IntegrationPolicyRule, type IntegrationProvider, type IntegrationProviderKind, type IntegrationRegistry, type IntegrationRegistryConflict, type IntegrationRegistryEntry, type IntegrationRegistrySourceRef, type IntegrationRegistrySummary, type IntegrationSetupSpec, type IntegrationSpec, type IntegrationSpecStatus, type IntegrationSpecValidationIssue, type IntegrationSpecValidationResult, type IntegrationSupportTier, type IntegrationToolDefinition, type IntegrationToolSearchFilters, type IntegrationToolSearchResult, type IntegrationTriggerEvent, type IntegrationTriggerSubscription, type InvokeWithCapabilityRequest, type IssueCapabilityRequest, type IssuedIntegrationCapability, type McpCatalog, type McpCatalogTool, type McpToolDefinition, type MicrosoftCalendarOptions, type NoneAuthSpec, type NormalizedIntegrationResult, type NormalizedPermission, type NotionDatabaseOptions, type OAuth2AuthSpec, type OAuthFlowStore, type OAuthTokens, type OpenApiDocument, type OpenApiOperation, type ParsedStripeSignatureHeader, type PendingOAuthFlow, type PermissionDescriptor, type PostSetupCheck, type Quirk, type RateLimitSpec, type RefreshInput, type RenderSpecOptions, type RenderedConsoleStep, type ResolvedDataSource, ResourceContention, type RestConnectorSpec, type RestCredentialPlacement, type RestOperationSpec, type RestRequestSpec, type ScopeDescriptor, type SecretRef, type SlackOptions, type SlackVerifyOptions, type StartAuthRequest, type StartAuthResult, type StartOAuthInput, type StartOAuthOutput, StaticIntegrationPolicyEngine, type StaticIntegrationPolicyOptions, type StripeVerifyOptions, type TwilioVerifyOptions, _resetPendingFlowsForTests, airtableConnector, asanaConnector, assertValidConnectorManifest, assertValidIntegrationSpec, buildActivepiecesConnectors, buildApprovalRequest, buildDefaultIntegrationRegistry, buildHealthcheckPlan, buildIntegrationCoverageConnectors, buildIntegrationInvocationEnvelope, buildIntegrationToolCatalog, canonicalConnectorId, composeIntegrationRegistry, consoleStepsToText, consumePendingFlow, createConnectorAdapterProvider, createDefaultIntegrationPolicyEngine, createGatewayCatalogProvider, createHttpIntegrationProvider, createMockIntegrationProvider, declarativeRestConnector, exchangeAuthorizationCode, firstHeader, getActivepiecesOverride, getIntegrationFamily, getIntegrationSpec, githubConnector, gitlabConnector, googleCalendar, googleSheets, hubspot, importGraphqlConnector, importMcpConnector, importOpenApiConnector, inferIntegrationSupportTier, integrationCoverageChecklistMarkdown, integrationSpecToConnector, integrationToolName, invocationRequestFromEnvelope, listActivepiecesCatalogEntries, listExecutableIntegrationSpecs, listIntegrationCoverageSpecs, listIntegrationSpecs, manifestToConnector, microsoftCalendar, normalizeGatewayCatalog, normalizeIntegrationResult, notionDatabase, parseIntegrationToolName, parseStripeSignatureHeader, redactApprovalRequest, redactCapability, redactInvocationEnvelope, refreshAccessToken, renderAgentToolDescription, renderConsoleSteps, renderRunbookMarkdown, salesforceConnector, sanitizeConnection, searchIntegrationTools, signCapability, slack, slackEventsConnector, specAuthToConnectorAuth, startOAuthFlow, stripePackConnector, stripeWebhookReceiverConnector, summarizeIntegrationRegistry, toMcpTools, twilioSmsConnector, validateConnectorManifest, validateCredentialFormat, validateCredentialSet, validateIntegrationInvocationEnvelope, validateIntegrationSpec, verifyCapabilityToken, verifyHmacSignature, verifySlackSignature, verifyStripeSignature, verifyTwilioSignature, webhookConnector };