Skip to main content

Crates

Generated by connectors-docs from cargo metadata --no-deps: every package of the workspace, with the description its Cargo.toml gives. There are 23 packages. None is on a registry; build them from the source checkout. The generated CLI parser, apps/connectors-cli-contract, is a path dependency of connectors outside the workspace and is regenerated by connectors-build cli, never edited.

Libraries and the command lineโ€‹

The shared boundary an application, an adapter or a host builds on, and the connectors command.

PackageDirectoryIn RustWhat it is
connectorsapps/connectorsuse connectors, binary connectorsThe connectors command: invoke a connector's operations, and set up instances, connections and approvals through a local owner.
connectors-catalogcrates/connectors-cataloguse connectors_catalogCatalog ingest: a pinned OpenAPI source document compiled into a bundle with the provenance every later artifact cites; never reaches the network.
connectors-clientcrates/connectors-clientuse connectors_clientGeneric client that describes an adapter service and invokes its operations over the service wire.
connectors-contractscrates/connectors-contractsuse connectors_contractsHigher-level, provider-neutral data and discovery contracts.
connectors-corecrates/connectors-coreuse connectors_coreProvider-independent operation and service wire contracts: descriptors, requests, results, errors and limits.
connectors-custodycrates/connectors-custodyuse connectors_custodyCredential custody of the local host: the read and write backend traits, an in-memory reference, one platform binding each for the Secret Service, the macOS login keychain and the Windows Credential Manager, and the explicitly selected read-only mounted-secret binding on Linux.
connectors-definitions-installcrates/connectors-definitions-installuse connectors_definitions_installFetches a connectors-definitions release by tag from an https repository or a local directory, checks every file against its index.json, and records it in a lock file and a read-only cache keyed by the index's SHA-256; depends on no connectors crate and embeds no catalog.
connectors-hostcrates/connectors-hostuse connectors_hostAdapter service host: HTTP serving, credential references, one-hop federation, and the local owner, custody and metadata runtime.
connectors-oauth2crates/connectors-oauth2use connectors_oauth2Provider-neutral OAuth 2.0 client: the authorization-code grant with PKCE, the device grant, the code and refresh exchanges and the loopback and pasted-code redirect receivers, over a transport the host supplies.
connectors-sdkcrates/connectors-sdkuse connectors_sdkThe adapter interface and shared semantic mechanisms (descriptors, handler verification, cursors); concrete infrastructure stays with the host.
connectors-speccrates/connectors-specuse connectors_specThe adapter specification kind: compiles adapter specifications to descriptors and pins the ESS release used for generation.
connectors-tool-contractscrates/connectors-tool-contractsuse connectors_tool_contracts, binary connectors-tool-contractsPublishes an instance's tool-contract/1 document from its descriptor and the tool profiles authored beside its adapter, and serves it as a tool-conformance/1 toolset over the adapter's invoke.

Adaptersโ€‹

Each adapter owns its provider behaviour and builds a standalone executable. With --no-default-features the library alone depends on no host, client or sibling adapter; the repository gate holds that boundary.

PackageDirectoryIn RustWhat it is
connectors-catalog-provideradapters/cataloguse connectors_catalog_provider, binary connectors-catalog-providerThe catalog provider: one verified bundle, a declarative selection of its operations, and one engine that binds, sends and classifies them.
connectors-grafanaadapters/grafanause connectors_grafana, binary connectors-grafanaGrafana adapter: bounded data-source records from the Grafana HTTP API, and read-only IRM alert groups, incidents and their links over a since window.
connectors-kubernetesadapters/kubernetesuse connectors_kubernetes, binary connectors-kubernetesKubernetes adapter: resource inventory, endpoint and host discovery, and Helm release reads.
connectors-lokiadapters/lokiuse connectors_loki, binary connectors-lokiLoki adapter: LogQL range and metric queries and label reads, one GET each.
connectors-mcpadapters/mcp/runtimeuse connectors_mcpNative MCP mechanics of the stdio server: launch grammar, newline framing, tool names, exact JSON, results, the local lease and request supervision; admission and custody are ports the application supplies.
connectors-prometheusadapters/prometheususe connectors_prometheus, binary connectors-prometheusPrometheus adapter: PromQL instant and range queries and the rule list, one GET each.
connectors-sqladapters/sqluse connectors_sql, binary connectors-sqlSQL adapter (PostgreSQL and MySQL): bounded read-only queries, catalogue reads (databases, tables, columns and keys, indexes) and configured read profiles with typed, masked, keyset-paged output.
connectors-tavilyadapters/tavilyuse connectors_tavily, binary connectors-tavilyTavily adapter: web search, page fetch and site crawl through the shared websearch family.

Repository toolingโ€‹

Generators, checks and acceptance runners the repository's own gate and maintainers use. Nothing outside the repository depends on them.

PackageDirectoryIn RustWhat it is
connectors-buildcrates/connectors-buildbinary connectors-buildRepository build tool: the gate, generation and drift checks, catalog bundles, source projections and the website examples.
connectors-conformancecrates/connectors-conformancebinary connectors-conformanceLive acceptance runner against independently started adapter services.
connectors-docscrates/connectors-docsbinary connectors-docsGenerates the derived pages of the Connectors documentation site (CLI, crates, contract and model reference, status) and checks them for drift.