extra="forbid"), naming
it, so a misspelled field fails loudly instead of being dropped.
SLUG_RE
tai42_contract.connectors.providers.SLUG_RE
McpServerDescriptor
tai42_contract.connectors.providers.McpServerDescriptor
http (hosted out-of-band, set url)
or stdio (launched as a child process, set command + args).
Exactly one configuration is allowed: url xor (command + args).
Attributes
Members
model_post_init
tai42_contract.connectors.providers.McpServerDescriptor.model_post_init
url for http, command + args for stdio.
Parameters
ConfigFieldSpec
tai42_contract.connectors.providers.ConfigFieldSpec
target picks the injection channel and MUST match the server transport
(env for stdio, header for http). secret flags a value
masked in the UI and never logged; required gates connect-time validation.
Attributes
SubServiceDescriptor
tai42_contract.connectors.providers.SubServiceDescriptor
OAuthEndpoints
tai42_contract.connectors.providers.OAuthEndpoints
kind == "oauth" provider without it is in discovered mode, where the engine
reads the endpoints from the authorization server its MCP server names.
Attributes
ProviderDescriptor
tai42_contract.connectors.providers.ProviderDescriptor
connectors list at boot/reload.
A kind == "oauth" provider is in exactly one of two modes. Declared: oauth carries the
endpoints and client_id_env / client_secret_env name the operator’s client. Discovered:
oauth is unset and the engine discovers the authorization server from the one MCP server all
sub-services share; the client is either the env client pinned by issuer to the authorization
server it is registered with, or (all three unset) a stored client.
Attributes
Members
icon_url
tai42_contract.connectors.providers.ProviderDescriptor.icon_url
https:// URL to the provider’s icon, or None for none; http, relative, or empty is
rejected. The catalog serves this value verbatim as a brand mark, the same
rule the plugin spec’s icon enforces.
is_discovered
tai42_contract.connectors.providers.ProviderDescriptor.is_discovered
oauth endpoints).
discovery_url
tai42_contract.connectors.providers.ProviderDescriptor.discovery_url
RuntimeError for a declared or no-auth provider (a caller bug: only a discovered
provider is discovered).
