# Integrations and provider selection Choose concrete external capabilities through provider-neutral contracts, explicit connections and observable runtime bindings. Source snapshot: bcc79fcc27c4d801c2119bef81ddcce7b4e86498 ## Begin with a capability, not a vendor name ContractsIntegrations defines provider-agnostic specifications, connections, authentication/transport, secret resolution, health and capability interfaces such as LLM, embeddings, email, vector stores and storage. The provider integration packages implement concrete boundaries. Start from the operation your product needs, find its capability contract, then inspect the adapter that claims that exact surface. A provider package name or a registered catalog record does not establish that every provider product feature is supported or enabled for an account. Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-integrations/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-spec/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/README.md ## Keep execution mode separate from credentials ProviderSpec describes runtime targets, routing policies, leases, receipts, observations and comparison evidence. ProviderRuntime normalizes those records for host use. The README distinguishes managed/local/hybrid runtime targets from credential ownership modes such as BYOK, ephemeral or none. Preserve that distinction in configuration and UI so a credential selection does not silently choose an execution location. Redact credential-like resolver fields before logging while retaining non-secret mode and capability information needed for diagnosis. Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-integrations/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-spec/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/README.md ## Inspect the whole connection lifecycle A useful integration guide should follow connection creation, required scopes/capabilities, secret references, readiness, one operation and its returned receipt. Reconnection, revoked access, rate limits, stale health and ambiguous effects belong to the same story. Provider observations can inform routing and budget decisions, but source metadata still needs the host’s current evidence. For capabilities such as meeting capture or external publication, domain consent and current authorization remain prerequisites even when the provider SDK is available. Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-integrations/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-spec/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/README.md ## Select the exact interface Read the consumer’s provider contract and list the methods or capability references it needs. Open the matching integration package export map and README rather than importing a broad implementation bundle by default. Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-integrations/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-spec/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/README.md ## Bind a scoped connection Identify the credential owner, runtime target, secret resolver and required permissions. Follow how the product checks readiness and handles a missing capability or disconnected account before offering an action. Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-integrations/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-spec/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/README.md ## Inspect a provider result Trace the adapter response into the normalized receipt and domain outcome. Use the owning fixture for denial, throttling and uncertain completion, then qualify real provider behavior in the intended environment before advertising it as available. Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-integrations/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-spec/README.md Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/README.md ## Packages - [@lssm-tech/lib.ai-providers](https://lssm.co/docs/packages/lib.ai-providers/): Unified AI provider abstraction layer - [@lssm-tech/module.provider-ranking](https://lssm.co/docs/packages/module.provider-ranking/): AI provider ranking module with persistence and pipeline orchestration - [@lssm-tech/lib.provider-ranking](https://lssm.co/docs/packages/lib.provider-ranking/): AI provider ranking: benchmark ingestion, scoring, and model comparison - [@lssm-tech/lib.provider-runtime](https://lssm.co/docs/packages/lib.provider-runtime/): Builder provider-runtime helpers for routing, context prep, runtime targets, and receipt normalization. - [@lssm-tech/lib.provider-spec](https://lssm.co/docs/packages/lib.provider-spec/): Provider routing and runtime-target contracts for ContractSpec Builder. - [@lssm-tech/module.alpic](https://lssm.co/docs/packages/module.alpic/): Alpic MCP and ChatGPT App hosting helpers - [@lssm-tech/lib.contracts-integrations](https://lssm.co/docs/packages/lib.contracts-integrations/): Integration contract definitions for external services - [@lssm-tech/module.integration-hub](https://lssm.co/docs/packages/module.integration-hub/): Scoped integration-hub module — 3 genuinely reusable primitives (useIntegrationData, useCredentialSetup, renderIntegrationMarkdown) promoted from examples/integration-hub. RSC-directive boundaries are explicit. - [@lssm-tech/integration.app-store-connect](https://lssm.co/docs/packages/integration.app-store-connect/): Read-first App Store Connect API integration for ReviewReady app submission readiness, with deterministic mocks and secret-ref-only credentials. - [@lssm-tech/integration.builder-telegram](https://lssm.co/docs/packages/integration.builder-telegram/): Telegram Builder control-channel integration. - [@lssm-tech/integration.builder-voice](https://lssm.co/docs/packages/integration.builder-voice/): Voice Builder input integration. - [@lssm-tech/integration.builder-whatsapp](https://lssm.co/docs/packages/integration.builder-whatsapp/): WhatsApp Builder control-channel integration. - [@lssm-tech/integration.example-generator](https://lssm.co/docs/packages/integration.example-generator/): Example plugin: Markdown documentation generator for ContractSpec specs - [@lssm-tech/integration.fake-outbox-adapter](https://lssm.co/docs/packages/integration.fake-outbox-adapter/): Fake/sandbox outbox adapter for builder delivery loop testing. - [@lssm-tech/integration.google-play-developer](https://lssm.co/docs/packages/integration.google-play-developer/): Read-first Google Play Android Publisher API integration for ReviewReady app submission readiness, with deterministic mocks and secret-ref-only credentials. - [@lssm-tech/integration.integration-topology-evidence-postgres](https://lssm.co/docs/packages/integration.integration-topology-evidence-postgres/): Tenant-scoped append-only Postgres evidence adapter for Integration Hub topology receipts. - [@lssm-tech/integration.provider-analytics](https://lssm.co/docs/packages/integration.provider-analytics/): Analytics provider implementations for ContractSpec. - [@lssm-tech/integration.provider-attio](https://lssm.co/docs/packages/integration.provider-attio/): Attio API, webhook, and hosted MCP integration for ContractSpec. - [@lssm-tech/integration.provider-calendar](https://lssm.co/docs/packages/integration.provider-calendar/): Calendar provider implementations for ContractSpec. - [@lssm-tech/integration.provider-claude-code](https://lssm.co/docs/packages/integration.provider-claude-code/): Claude Code provider compatibility wrapper for Builder. - [@lssm-tech/integration.provider-clay](https://lssm.co/docs/packages/integration.provider-clay/): Clay API, webhook, and hosted MCP integration for ContractSpec. - [@lssm-tech/integration.provider-codex](https://lssm.co/docs/packages/integration.provider-codex/): Codex provider compatibility wrapper for Builder. - [@lssm-tech/integration.provider-company-metrics](https://lssm.co/docs/packages/integration.provider-company-metrics/): Read-only governed source adapters for CompanyOS metrics. - [@lssm-tech/integration.provider-copilot](https://lssm.co/docs/packages/integration.provider-copilot/): Copilot provider compatibility wrapper for Builder. - [@lssm-tech/integration.provider-customer-support](https://lssm.co/docs/packages/integration.provider-customer-support/): Provider adapters for SupportOS, beginning with a version-pinned Intercom mirror and cutover lane. - [@lssm-tech/integration.provider-database](https://lssm.co/docs/packages/integration.provider-database/): Database provider implementations for ContractSpec. - [@lssm-tech/integration.provider-einvoicing](https://lssm.co/docs/packages/integration.provider-einvoicing/): French Factur-X (EN16931 CII) generation, EN16931/CIUS-FR conformance (Mustangproject), and PDP submission adapters for ContractSpec BillingOS. - [@lssm-tech/integration.provider-email](https://lssm.co/docs/packages/integration.provider-email/): Email provider implementations for ContractSpec. - [@lssm-tech/integration.provider-gemini](https://lssm.co/docs/packages/integration.provider-gemini/): Gemini provider compatibility wrapper for Builder. - [@lssm-tech/integration.provider-github](https://lssm.co/docs/packages/integration.provider-github/): GitHub provider implementation for ContractSpec with repository, issue, and pull request management. - [@lssm-tech/integration.provider-google-ads](https://lssm.co/docs/packages/integration.provider-google-ads/): Official advertising API request adapter. - [@lssm-tech/integration.provider-health](https://lssm.co/docs/packages/integration.provider-health/): Health data provider implementations for ContractSpec. - [@lssm-tech/integration.provider-higgsfield](https://lssm.co/docs/packages/integration.provider-higgsfield/): Tenant-isolated asynchronous Higgsfield media provider. - [@lssm-tech/integration.provider-instagram](https://lssm.co/docs/packages/integration.provider-instagram/): Official Instagram API read adapters for ContractSpec. - [@lssm-tech/integration.provider-linkedin](https://lssm.co/docs/packages/integration.provider-linkedin/): Official LinkedIn API adapters for ContractSpec. - [@lssm-tech/integration.provider-llm](https://lssm.co/docs/packages/integration.provider-llm/): LLM provider implementations for ContractSpec. - [@lssm-tech/integration.provider-local-model](https://lssm.co/docs/packages/integration.provider-local-model/): Local model provider compatibility wrapper for Builder. - [@lssm-tech/integration.provider-meeting-recorder](https://lssm.co/docs/packages/integration.provider-meeting-recorder/): Meeting recorder provider implementations for ContractSpec. - [@lssm-tech/integration.provider-messaging](https://lssm.co/docs/packages/integration.provider-messaging/): Messaging provider implementations for ContractSpec. - [@lssm-tech/integration.provider-meta-ads](https://lssm.co/docs/packages/integration.provider-meta-ads/): Official advertising API request adapter. - [@lssm-tech/integration.provider-openbanking](https://lssm.co/docs/packages/integration.provider-openbanking/): Open banking provider implementations for ContractSpec. - [@lssm-tech/integration.provider-opencode-go](https://lssm.co/docs/packages/integration.provider-opencode-go/): OpenCode Go provider compatibility wrapper for Builder. - [@lssm-tech/integration.provider-payments](https://lssm.co/docs/packages/integration.provider-payments/): Payments provider implementations for ContractSpec. - [@lssm-tech/integration.provider-pioneer-ai](https://lssm.co/docs/packages/integration.provider-pioneer-ai/): Pioneer AI provider adapter for ContractSpec AI improvement workflows. - [@lssm-tech/integration.provider-project-management](https://lssm.co/docs/packages/integration.provider-project-management/): Project management provider implementations for ContractSpec. - [@lssm-tech/integration.provider-reclaim](https://lssm.co/docs/packages/integration.provider-reclaim/): Signed Reclaim Scheduling Link webhook ingestion for CompanyOS OPA. - [@lssm-tech/integration.provider-sms](https://lssm.co/docs/packages/integration.provider-sms/): SMS provider implementations for ContractSpec. - [@lssm-tech/integration.provider-storage](https://lssm.co/docs/packages/integration.provider-storage/): Object storage provider implementations for ContractSpec. - [@lssm-tech/integration.provider-stt](https://lssm.co/docs/packages/integration.provider-stt/): Speech-to-text provider compatibility wrapper for Builder. - [@lssm-tech/integration.provider-tiktok](https://lssm.co/docs/packages/integration.provider-tiktok/): Official TikTok social provider adapter for ContractSpec. - [@lssm-tech/integration.provider-voice](https://lssm.co/docs/packages/integration.provider-voice/): Voice, speech, and conversational provider implementations for ContractSpec. - [@lssm-tech/integration.provider-web-access](https://lssm.co/docs/packages/integration.provider-web-access/): Governed web access, scraping, browser, MCP, and residential proxy integrations. - [@lssm-tech/integration.provider-x](https://lssm.co/docs/packages/integration.provider-x/): Official X API read and scoped native publication adapters for ContractSpec. - [@lssm-tech/integration.provider-youtube](https://lssm.co/docs/packages/integration.provider-youtube/): Official YouTube social provider adapter for ContractSpec. - [@lssm-tech/integration.providers-impls](https://lssm.co/docs/packages/integration.providers-impls/): Integration provider implementations for email, payments, storage, and more - [@lssm-tech/bundle.alpic](https://lssm.co/docs/packages/bundle.alpic/): Alpic MCP server and ChatGPT App hosting bundle - [@lssm-tech/app.alpic-mcp](https://lssm.co/docs/packages/app.alpic-mcp/): MCP server exposing ALPIC application lifecycle and platform integration operations. - [@lssm-tech/app.notion-mcp](https://lssm.co/docs/packages/app.notion-mcp/): MCP server exposing governed Notion workspace operations. - [@lssm-tech/app.provider-ranking-mcp](https://lssm.co/docs/packages/app.provider-ranking-mcp/): MCP server for provider discovery, evaluation, and ranking workflows. - [@lssm-tech/app.teams-mcp](https://lssm.co/docs/packages/app.teams-mcp/): MCP server exposing governed Microsoft Teams collaboration operations.