@tangle-network/agent-integrations 0.16.1 → 0.16.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.ts +1 -1
- package/dist/index.js +16 -1
- package/dist/index.js.map +1 -1
- package/dist/specs.d.ts +8 -1
- package/docs/adapter-triage.md +166 -0
- package/docs/integration-coverage-checklist.md +3 -2
- package/package.json +1 -1
package/dist/specs.d.ts
CHANGED
|
@@ -831,6 +831,13 @@ interface ConnectorAdapterProviderOptions {
|
|
|
831
831
|
now?: () => Date;
|
|
832
832
|
}
|
|
833
833
|
declare function createConnectorAdapterProvider(options: ConnectorAdapterProviderOptions): IntegrationProvider;
|
|
834
|
+
declare function adapterManifestsToConnectors(adapters: ConnectorAdapter[], providerId?: string): IntegrationConnector[];
|
|
835
|
+
declare function createConnectorAdapterCatalogSource(options: {
|
|
836
|
+
id?: string;
|
|
837
|
+
providerId?: string;
|
|
838
|
+
adapters: ConnectorAdapter[];
|
|
839
|
+
precedence?: number;
|
|
840
|
+
}): IntegrationCatalogSource;
|
|
834
841
|
declare function manifestToConnector(providerId: string, adapter: ConnectorAdapter): IntegrationConnector;
|
|
835
842
|
|
|
836
843
|
interface IntegrationSecretStore {
|
|
@@ -2496,4 +2503,4 @@ declare function createHttpIntegrationProvider(options: HttpIntegrationProviderO
|
|
|
2496
2503
|
declare function signCapability(capability: IntegrationCapability, secret: string): string;
|
|
2497
2504
|
declare function verifyCapabilityToken(token: string, secret: string): IntegrationCapability;
|
|
2498
2505
|
|
|
2499
|
-
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 };
|
|
2506
|
+
export { InMemoryIntegrationIdempotencyStore as $, ACTIVEPIECES_OVERRIDES as A, type ApiKeyAuthSpec, type ConsistencyModel as B, CANONICAL_INTEGRATION_ACTIONS as C, type ConsoleStep, type CredentialFieldSpec, type CredentialValidationInput, type CredentialValidationResult, type CustomAuthSpec, CredentialsExpired as D, DEFAULT_INTEGRATION_BRIDGE_ENV as E, DEFAULT_SIGNATURE_TOLERANCE_SECONDS as F, type DataSourceMetadata as G, DefaultIntegrationActionGuard as H, type HealthcheckPlan, type HealthcheckSpec, type HmacAuthSpec, type EventHandlerResult as I, INTEGRATION_FAMILIES, type IntegrationAuthMode, type IntegrationAuthSpec, type IntegrationFamilyId, type IntegrationFamilySpec, type IntegrationLifecycleSpec, type IntegrationPlannerHints, type IntegrationSetupSpec, type IntegrationSpec, type IntegrationSpecStatus, type IntegrationSpecValidationIssue, type IntegrationSpecValidationResult, type ExchangeCodeInput as J, type GatewayCatalogAction as K, type GatewayCatalogEntry as L, type GatewayCatalogProviderOptions as M, type GatewayCatalogTrigger as N, type NoneAuthSpec, type NormalizedPermission, type GenericHmacVerifyOptions as O, type OAuth2AuthSpec, type GoogleCalendarOptions as P, type PermissionDescriptor, type PostSetupCheck, type GoogleSheetsOptions as Q, type Quirk, type GraphqlOperationSpec as R, type RenderSpecOptions, type RenderedConsoleStep, type HttpIntegrationProviderOptions as S, type ScopeDescriptor, type HubSpotOptions as T, type ImportCatalogOptions as U, InMemoryConnectionStore as V, InMemoryIntegrationApprovalStore as W, InMemoryIntegrationAuditStore as X, InMemoryIntegrationEventStore as Y, InMemoryIntegrationGrantStore as Z, InMemoryIntegrationHealthcheckStore as _, type ActivepiecesCatalogEntry as a, type IntegrationRegistry as a$, InMemoryIntegrationSecretStore as a0, InMemoryIntegrationWorkflowStore as a1, InMemoryOAuthFlowStore as a2, type InboundEvent as a3, type InferIntegrationRequirementsOptions as a4, type InstalledIntegrationWorkflow as a5, type IntegrationActionGuard as a6, type IntegrationActionPack as a7, type IntegrationActionRequest as a8, type IntegrationActionResult as a9, type IntegrationDataClass as aA, IntegrationError as aB, type IntegrationErrorCode as aC, type IntegrationEventStore as aD, type IntegrationGrant as aE, type IntegrationGrantStore as aF, type IntegrationGuardContext as aG, type IntegrationHealthcheckCheck as aH, type IntegrationHealthcheckResult as aI, type IntegrationHealthcheckStatus as aJ, type IntegrationHealthcheckStore as aK, IntegrationHub as aL, type IntegrationHubOptions as aM, type IntegrationIdempotencyRecord as aN, type IntegrationIdempotencyStore as aO, type IntegrationInvocationEnvelope as aP, type IntegrationInvocationEnvelopeValidationOptions as aQ, type IntegrationManifest as aR, type IntegrationManifestResolution as aS, type IntegrationPolicyDecision as aT, type IntegrationPolicyEffect as aU, type IntegrationPolicyEngine as aV, type IntegrationPolicyRule as aW, type IntegrationProvider as aX, type IntegrationProviderKind as aY, type IntegrationRateLimitDecision as aZ, type IntegrationRateLimiter as a_, type IntegrationActionRisk as aa, type IntegrationActor as ab, type IntegrationApprovalFilter as ac, type IntegrationApprovalRecord as ad, type IntegrationApprovalRequest as ae, type IntegrationApprovalResolution as af, type IntegrationApprovalStatus as ag, type IntegrationApprovalStore as ah, type IntegrationAuditEvent as ai, type IntegrationAuditEventType as aj, type IntegrationAuditFilter as ak, type IntegrationAuditSink as al, type IntegrationAuditStore as am, type IntegrationBridgePayload as an, type IntegrationBridgeToolBinding as ao, type IntegrationCapability as ap, type IntegrationCapabilityBinding as aq, type IntegrationCatalogSource as ar, type IntegrationConnection as as, assertValidIntegrationSpec, type IntegrationConnectionStore as at, type IntegrationConnector as au, type IntegrationConnectorAction as av, type IntegrationConnectorCategory as aw, type IntegrationConnectorTrigger as ax, type IntegrationCoveragePriority as ay, type IntegrationCoverageSpec as az, type ActivepiecesPieceOverride as b, type SlackOptions as b$, type IntegrationRegistryConflict as b0, type IntegrationRegistryEntry as b1, type IntegrationRegistrySourceRef as b2, type IntegrationRegistrySummary as b3, type IntegrationRequirement as b4, type IntegrationRequirementMode as b5, type IntegrationRequirementResolution as b6, type IntegrationRequirementStatus as b7, IntegrationRuntime as b8, IntegrationRuntimeError as b9, type McpCatalogTool as bA, type McpToolDefinition as bB, type MicrosoftCalendarOptions as bC, type MissingRequirementExplanation as bD, type NormalizedIntegrationError as bE, type NormalizedIntegrationResult as bF, type NotionDatabaseOptions as bG, type OAuthFlowStore as bH, type OAuthTokens as bI, type OpenApiDocument as bJ, type OpenApiOperation as bK, PROVIDER_PASSTHROUGH_ACTION as bL, type ParsedStripeSignatureHeader as bM, type PendingOAuthFlow as bN, type PlatformIntegrationPolicyPresetOptions as bO, type ProviderHttpRequestInput as bP, type ProviderPassthroughPolicy as bQ, type RateLimitSpec as bR, type RefreshInput as bS, type RenderConsentOptions as bT, type ResolvedDataSource as bU, ResourceContention as bV, type RestConnectorSpec as bW, type RestCredentialPlacement as bX, type RestOperationSpec as bY, type RestRequestSpec as bZ, type SecretRef as b_, type IntegrationRuntimeHub as ba, type IntegrationRuntimeOptions as bb, type IntegrationSandboxBundle as bc, IntegrationSandboxHost as bd, type IntegrationSandboxHostHub as be, type IntegrationSandboxHostOptions as bf, type IntegrationSecretStore as bg, type IntegrationSupportTier as bh, type IntegrationToolDefinition as bi, type IntegrationToolSearchFilters as bj, type IntegrationToolSearchResult as bk, type IntegrationTriggerEvent as bl, type IntegrationTriggerSubscription as bm, type IntegrationUserAction as bn, type IntegrationWebhookReceiverResult as bo, type IntegrationWorkflowDefinition as bp, IntegrationWorkflowRuntime as bq, type IntegrationWorkflowRuntimeHub as br, type IntegrationWorkflowRuntimeOptions as bs, type IntegrationWorkflowStore as bt, type InvokeWithCapabilityRequest as bu, buildHealthcheckPlan, type IssueCapabilityRequest as bv, type IssuedIntegrationCapability as bw, type ManifestValidationIssue as bx, type ManifestValidationResult as by, type McpCatalog as bz, ApprovalBackedPolicyEngine as c, hubspot as c$, type SlackVerifyOptions as c0, type StartAuthRequest as c1, type StartAuthResult as c2, type StartOAuthInput as c3, type StartOAuthOutput as c4, StaticIntegrationPolicyEngine as c5, type StaticIntegrationPolicyOptions as c6, type StoredIntegrationEvent as c7, type StripeVerifyOptions as c8, type TangleIntegrationInvokeInput as c9, createConnectionCredentialResolver as cA, createConnectorAdapterCatalogSource as cB, createConnectorAdapterProvider as cC, createCredentialBackedAdapterProvider as cD, createDefaultIntegrationActionGuard as cE, createDefaultIntegrationPolicyEngine as cF, createGatewayCatalogProvider as cG, createHttpIntegrationProvider as cH, createIntegrationAuditEvent as cI, createIntegrationRuntime as cJ, createIntegrationWorkflowRuntime as cK, createMockIntegrationProvider as cL, createPlatformIntegrationPolicyPreset as cM, createTangleIntegrationsClient as cN, declarativeRestConnector as cO, decodeIntegrationBridgePayload as cP, dispatchIntegrationInvocation as cQ, encodeIntegrationBridgePayload as cR, exchangeAuthorizationCode as cS, explainMissingRequirements as cT, firstHeader as cU, getActivepiecesOverride as cV, githubConnector as cW, gitlabConnector as cX, googleCalendar as cY, googleSheets as cZ, healthcheckRequest as c_, type TangleIntegrationInvokeResult as ca, TangleIntegrationsClient as cb, type TangleIntegrationsClientOptions as cc, type TwilioVerifyOptions as cd, _resetPendingFlowsForTests as ce, adapterManifestsToConnectors as cf, airtableConnector as cg, asanaConnector as ch, assertValidConnectorManifest as ci, assertValidIntegrationManifest as cj, buildActivepiecesConnectors as ck, buildApprovalRequest as cl, buildCanonicalLaunchConnectors as cm, buildDefaultIntegrationRegistry as cn, buildIntegrationBridgeEnvironment as co, consoleStepsToText, buildIntegrationBridgePayload as cp, buildIntegrationCoverageConnectors as cq, buildIntegrationInvocationEnvelope as cr, buildIntegrationToolCatalog as cs, calendarExercisePlannerManifest as ct, canonicalActionConnectorId as cu, canonicalConnectorId as cv, composeIntegrationRegistry as cw, consumePendingFlow as cx, createApprovalBackedPolicyEngine as cy, createAuditingActionGuard as cz, type ApprovalBackedPolicyOptions as d, importGraphqlConnector as d0, importMcpConnector as d1, importOpenApiConnector as d2, inferIntegrationManifestFromTools as d3, inferIntegrationSupportTier as d4, integrationCoverageChecklistMarkdown as d5, integrationToolName as d6, invocationRequestFromEnvelope as d7, listActivepiecesCatalogEntries as d8, listIntegrationCoverageSpecs as d9, searchIntegrationTools as dA, signCapability as dB, slack as dC, slackEventsConnector as dD, startOAuthFlow as dE, statusForCode as dF, storedEventToTriggerEvent as dG, stripePackConnector as dH, stripeWebhookReceiverConnector as dI, summarizeIntegrationRegistry as dJ, toMcpTools as dK, twilioSmsConnector as dL, validateConnectorManifest as dM, validateIntegrationInvocationEnvelope as dN, validateIntegrationManifest as dO, validateProviderPassthroughRequest as dP, verifyCapabilityToken as dQ, verifyHmacSignature as dR, verifySlackSignature as dS, verifyStripeSignature as dT, verifyTwilioSignature as dU, webhookConnector as dV, manifestToConnector as da, microsoftCalendar as db, normalizeGatewayCatalog as dc, normalizeIntegrationError as dd, normalizeIntegrationResult as de, notionDatabase as df, parseIntegrationBridgeEnvironment as dg, parseIntegrationToolName as dh, parseStripeSignatureHeader as di, receiveIntegrationWebhook as dj, redactApprovalRequest as dk, redactCapability as dl, redactIntegrationBridgePayload as dm, redactInvocationEnvelope as dn, refreshAccessToken as dp, renderApprovalCopy as dq, renderConsentSummary as dr, resolveConnectionCredentials as ds, resolveIntegrationApproval as dt, revokeConnection as du, runIntegrationHealthcheck as dv, runIntegrationHealthchecks as dw, salesforceConnector as dx, sanitizeAuditConnection as dy, sanitizeConnection as dz, type AuthSpec as e, type CASStrategy as f, type CanonicalIntegrationActionId as g, getIntegrationFamily, getIntegrationSpec, type CanonicalLaunchConnectorOptions as h, type Capability as i, integrationSpecToConnector, type CapabilityClass as j, type CapabilityMutation as k, type CapabilityMutationResult as l, listExecutableIntegrationSpecs, listIntegrationSpecs, type CapabilityParameterSchema as m, type CapabilityRead as n, type CapabilityReadResult as o, type CompleteAuthRequest as p, type ComposeIntegrationRegistryOptions as q, type ConnectionCredentialResolverOptions as r, renderAgentToolDescription, renderConsoleSteps, renderRunbookMarkdown, type ConnectorAdapter as s, specAuthToConnectorAuth, type ConnectorAdapterProviderOptions as t, type ConnectorCredentials as u, type ConnectorInvocation as v, validateCredentialFormat, validateCredentialSet, validateIntegrationSpec, type ConnectorManifest as w, type ConnectorManifestValidationIssue as x, type ConnectorManifestValidationResult as y, type ConsentSummary as z };
|
|
@@ -0,0 +1,166 @@
|
|
|
1
|
+
# Adapter Triage
|
|
2
|
+
|
|
3
|
+
This is the execution-readiness map for `agent-integrations`.
|
|
4
|
+
|
|
5
|
+
The important distinction:
|
|
6
|
+
|
|
7
|
+
- `catalogOnly`: known provider/action metadata. Good for search, planning,
|
|
8
|
+
and demand capture. Not safe to invoke.
|
|
9
|
+
- `setupReady`: has connection/setup/spec metadata. Good for OAuth/admin UI and
|
|
10
|
+
generated app requirements. Still needs an executable provider.
|
|
11
|
+
- `gatewayExecutable`: callable through an explicitly configured gateway
|
|
12
|
+
provider.
|
|
13
|
+
- `firstPartyExecutable`: callable through a reviewed adapter in this package.
|
|
14
|
+
- `sandboxExecutable`: callable directly from generated sandbox apps with a
|
|
15
|
+
narrowed capability token.
|
|
16
|
+
|
|
17
|
+
Do not treat catalog or setup entries as executable tools. Generated apps and
|
|
18
|
+
agents must only receive executable capabilities.
|
|
19
|
+
|
|
20
|
+
## Current First-Party Adapters
|
|
21
|
+
|
|
22
|
+
These are real adapters in `src/connectors/adapters` with read/write or event
|
|
23
|
+
behavior behind the `ConnectorAdapter` contract.
|
|
24
|
+
|
|
25
|
+
| Connector | Auth | Surface | Status |
|
|
26
|
+
| --- | --- | --- | --- |
|
|
27
|
+
| `google-calendar` | OAuth2 | read/write | first-party executable |
|
|
28
|
+
| `google-sheets` | OAuth2 | read/write | first-party executable |
|
|
29
|
+
| `microsoft-calendar` | OAuth2 | read/write | first-party executable |
|
|
30
|
+
| `hubspot` | OAuth2 | read/write | first-party executable |
|
|
31
|
+
| `slack` | OAuth2 | read/write | first-party executable |
|
|
32
|
+
| `notion-database` | OAuth2 | read/write | first-party executable |
|
|
33
|
+
| `salesforce` | OAuth2 | read/write | first-party executable |
|
|
34
|
+
| `twilio-sms` | API key | read/write | first-party executable |
|
|
35
|
+
| `stripe-pack` | API key | read/write | first-party executable |
|
|
36
|
+
| `github` | API key | read/write | first-party executable |
|
|
37
|
+
| `gitlab` | API key | read/write | first-party executable |
|
|
38
|
+
| `airtable` | API key | read/write | first-party executable |
|
|
39
|
+
| `asana` | API key | read/write | first-party executable |
|
|
40
|
+
| `webhook` | HMAC | read/write | first-party executable |
|
|
41
|
+
| `stripe` | HMAC | inbound events | first-party executable |
|
|
42
|
+
| `slack-inbound` | HMAC | inbound events | first-party executable |
|
|
43
|
+
|
|
44
|
+
Aliases matter when comparing coverage:
|
|
45
|
+
|
|
46
|
+
- `outlook-calendar` maps to `microsoft-calendar`.
|
|
47
|
+
- `notion` maps to `notion-database`.
|
|
48
|
+
- `stripe` maps to `stripe-pack` for outbound payment actions.
|
|
49
|
+
- `twilio` maps to `twilio-sms`.
|
|
50
|
+
|
|
51
|
+
## Current Setup/Catalog Coverage
|
|
52
|
+
|
|
53
|
+
`listIntegrationCoverageSpecs()` currently defines 142 setup specs. The default
|
|
54
|
+
registry resolves all coverage IDs to setup-ready entries, including alias
|
|
55
|
+
lookups.
|
|
56
|
+
|
|
57
|
+
| Priority | Count | Current library status |
|
|
58
|
+
| --- | ---: | --- |
|
|
59
|
+
| Tier 0 | 38 | setup-ready specs |
|
|
60
|
+
| Tier 1 | 89 | setup-ready specs |
|
|
61
|
+
| Tier 2 | 14 | setup-ready specs |
|
|
62
|
+
| Long tail | 1 | setup-ready spec |
|
|
63
|
+
|
|
64
|
+
Four Tier 0 entries are canonicalized aliases:
|
|
65
|
+
|
|
66
|
+
- `outlook-calendar` should resolve to `microsoft-calendar`.
|
|
67
|
+
- `notion` should resolve to `notion-database`.
|
|
68
|
+
- `stripe` should resolve to `stripe-pack` for outbound payment actions and
|
|
69
|
+
`stripe` for inbound webhooks.
|
|
70
|
+
- `twilio` should resolve to `twilio-sms`.
|
|
71
|
+
|
|
72
|
+
## Tier 0 Promotion Queue
|
|
73
|
+
|
|
74
|
+
### Already First-Party Executable
|
|
75
|
+
|
|
76
|
+
- Google Calendar
|
|
77
|
+
- Google Sheets
|
|
78
|
+
- Outlook Calendar / Microsoft Calendar
|
|
79
|
+
- Slack
|
|
80
|
+
- HubSpot
|
|
81
|
+
- Notion database
|
|
82
|
+
- Salesforce
|
|
83
|
+
- GitHub
|
|
84
|
+
- Airtable
|
|
85
|
+
- Stripe payments pack
|
|
86
|
+
- Twilio SMS
|
|
87
|
+
- Generic webhook
|
|
88
|
+
|
|
89
|
+
### Next First-Party Adapters
|
|
90
|
+
|
|
91
|
+
These should be promoted before claiming broad production readiness for
|
|
92
|
+
generated agent apps.
|
|
93
|
+
|
|
94
|
+
1. Gmail: read/search/send email, thread summaries, draft/send approval path.
|
|
95
|
+
2. Google Drive: file search/list/download/upload, scoped file grants.
|
|
96
|
+
3. Outlook Mail: read/search/send email, same approval model as Gmail.
|
|
97
|
+
4. OneDrive: file search/list/download/upload.
|
|
98
|
+
5. Google Docs: read/export/create/update docs.
|
|
99
|
+
6. Microsoft Teams: channel/message read/write.
|
|
100
|
+
7. Linear: issues/projects/comments.
|
|
101
|
+
8. Jira: issues/projects/comments.
|
|
102
|
+
9. Zendesk: tickets/users/comments.
|
|
103
|
+
10. Intercom: conversations/contacts/messages.
|
|
104
|
+
11. Shopify: customers/orders/products.
|
|
105
|
+
12. QuickBooks: customers/invoices/payments.
|
|
106
|
+
13. Mailchimp: audiences/campaigns.
|
|
107
|
+
14. Klaviyo: profiles/events/campaign triggers.
|
|
108
|
+
15. Google Analytics: properties/reports.
|
|
109
|
+
16. Postgres: query/read/write with explicit SQL policy.
|
|
110
|
+
17. BigQuery: query/jobs/datasets.
|
|
111
|
+
18. Snowflake: query/warehouse scoped execution.
|
|
112
|
+
19. Amazon S3: list/get/put objects.
|
|
113
|
+
20. Figma: files/comments/assets.
|
|
114
|
+
|
|
115
|
+
### Setup-Ready, Use Gateway Or Declarative REST First
|
|
116
|
+
|
|
117
|
+
These are valuable, but do not need bespoke hand adapters immediately if a
|
|
118
|
+
gateway provider or reviewed declarative REST spec covers the first launch use
|
|
119
|
+
case.
|
|
120
|
+
|
|
121
|
+
- Dropbox, Box, SharePoint, Coda, Confluence
|
|
122
|
+
- Pipedrive, Zoho CRM, Close, Attio
|
|
123
|
+
- Trello, monday.com, ClickUp
|
|
124
|
+
- Freshdesk, Help Scout, Front, Gorgias
|
|
125
|
+
- Xero, NetSuite, Plaid
|
|
126
|
+
- WooCommerce, BigCommerce, Amazon Seller Central
|
|
127
|
+
- Marketo, Braze, Customer.io, SendGrid, Postmark
|
|
128
|
+
- Discord, Telegram, WhatsApp Business
|
|
129
|
+
- Facebook Pages, Instagram Business, LinkedIn, X/Twitter, YouTube
|
|
130
|
+
- Mixpanel, Amplitude, Segment
|
|
131
|
+
- Redshift, MySQL, MongoDB, Supabase, Firebase
|
|
132
|
+
- Google Cloud Storage, Azure Blob Storage
|
|
133
|
+
- Vercel, Cloudflare, Sentry, Datadog, PagerDuty
|
|
134
|
+
- Okta, Auth0
|
|
135
|
+
- Workday, BambooHR, Greenhouse, Lever, Gusto, Rippling
|
|
136
|
+
- DocuSign, PandaDoc, Clio, Ironclad
|
|
137
|
+
- Calendly, Cal.com, Zoom, Google Meet
|
|
138
|
+
- OpenAI, Anthropic, Gemini, Hugging Face
|
|
139
|
+
- Pinecone, Weaviate, Qdrant
|
|
140
|
+
- Typeform, Google Forms, Webflow, WordPress, Contentful, Sanity, Canva, Miro
|
|
141
|
+
|
|
142
|
+
## Product Release Gates
|
|
143
|
+
|
|
144
|
+
Before any product says an integration is “supported” for real users:
|
|
145
|
+
|
|
146
|
+
- It is exposed as `firstPartyExecutable`, `gatewayExecutable`, or
|
|
147
|
+
`sandboxExecutable`.
|
|
148
|
+
- It has a real connection flow or gateway credential path.
|
|
149
|
+
- It has action input schemas good enough for LLM tool binding.
|
|
150
|
+
- It classifies auth, scope, rate-limit, provider outage, validation,
|
|
151
|
+
approval-required, and conflict errors.
|
|
152
|
+
- Writes and destructive actions require approval unless explicitly allowed by
|
|
153
|
+
policy.
|
|
154
|
+
- Mutations have idempotency or an explicit “not idempotent” guard.
|
|
155
|
+
- It has a healthcheck.
|
|
156
|
+
- It has at least one mocked unit test and one live smoke path gated by
|
|
157
|
+
credentials.
|
|
158
|
+
|
|
159
|
+
## Immediate Fixes
|
|
160
|
+
|
|
161
|
+
- Include first-party adapter catalogs in registry composition when a consumer
|
|
162
|
+
provides adapter instances.
|
|
163
|
+
- Add a generated triage command that compares coverage specs, setup specs,
|
|
164
|
+
active catalog entries, and adapter manifests.
|
|
165
|
+
- Promote Gmail, Drive, Outlook Mail, Linear, Jira, Zendesk, Intercom, Shopify,
|
|
166
|
+
QuickBooks, S3, and Postgres first.
|
|
@@ -24,6 +24,7 @@ Goal: cover the integrations that make agents useful for 99% of practical produc
|
|
|
24
24
|
- [ ] Tier 0 connector failures are classified by auth, scope, rate-limit, provider outage, validation, approval, and conflict.
|
|
25
25
|
- [ ] Tier 0 write actions have idempotency and approval tests.
|
|
26
26
|
- [x] Provider gateway adapters can import/sync catalog metadata from Nango/Pipedream/Activepieces registries.
|
|
27
|
+
- [x] Adapter execution triage is documented in [`adapter-triage.md`](./adapter-triage.md).
|
|
27
28
|
|
|
28
29
|
## Tier 0 First-Party Promotion Queue
|
|
29
30
|
|
|
@@ -37,7 +38,7 @@ Goal: cover the integrations that make agents useful for 99% of practical produc
|
|
|
37
38
|
- [x] Generic webhook
|
|
38
39
|
- [ ] Gmail
|
|
39
40
|
- [ ] Outlook Mail
|
|
40
|
-
- [
|
|
41
|
+
- [x] Outlook Calendar via `microsoft-calendar`
|
|
41
42
|
- [ ] Google Drive
|
|
42
43
|
- [ ] Google Docs
|
|
43
44
|
- [ ] Microsoft Teams
|
|
@@ -60,7 +61,7 @@ Goal: cover the integrations that make agents useful for 99% of practical produc
|
|
|
60
61
|
- [ ] Amazon S3
|
|
61
62
|
- [ ] Calendly
|
|
62
63
|
- [ ] Zoom
|
|
63
|
-
- [ ] Microsoft Graph
|
|
64
|
+
- [ ] Microsoft Graph broader graph pack
|
|
64
65
|
- [ ] OpenAI
|
|
65
66
|
- [ ] Figma
|
|
66
67
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tangle-network/agent-integrations",
|
|
3
|
-
"version": "0.16.
|
|
3
|
+
"version": "0.16.2",
|
|
4
4
|
"description": "Vendor-neutral integration contracts and runtime helpers for sandbox and agent apps.",
|
|
5
5
|
"homepage": "https://github.com/tangle-network/agent-integrations#readme",
|
|
6
6
|
"repository": {
|