TAI42 — the OS for AI tools

Provider descriptors — declarative shape of a supported third-party. Pure pydantic models describing a provider, its sub-services, MCP server endpoints, OAuth endpoints, and client-supplied config fields. Descriptors are validated when built so a misconfigured provider fails loudly rather than at first user click.

SLUG_RE

tai42_contract.connectors.providers.SLUG_RE

SLUG_RE = re.compile('^[a-z][a-z0-9_]*$')

McpServerDescriptor

tai42_contract.connectors.providers.McpServerDescriptor

class McpServerDescriptor(BaseModel)

MCP server endpoint for one sub-service. Transport is either http/websocket (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

Attribute	Type
`type`	`Literal['http', 'websocket', 'stdio']`
`url`	`str \| None`
`command`	`str \| None`
`args`	`list[str]`
`env`	`dict[str, str]`
`extra_headers`	`dict[str, str]`

Members

model_post_init

tai42_contract.connectors.providers.McpServerDescriptor.model_post_init

model_post_init(self, _ctx: Any) -> None

Enforce the transport rule: url for http/websocket, command + args for stdio. Parameters

Parameter	Type	Default	Description
`_ctx`	`Any`	—	—

ConfigFieldSpec

tai42_contract.connectors.providers.ConfigFieldSpec

class ConfigFieldSpec(BaseModel)

One client-supplied static config value for a no-auth provider. target picks the injection channel and MUST match the server transport (env for stdio, header for http/websocket). secret flags a value masked in the UI and never logged; required gates connect-time validation. Attributes

Attribute	Type
`key`	`str`
`label`	`str`
`target`	`Literal['env', 'header']`
`required`	`bool`
`secret`	`bool`

SubServiceDescriptor

tai42_contract.connectors.providers.SubServiceDescriptor

class SubServiceDescriptor(BaseModel)

One sub-service a provider exposes, with its scopes and a single launch path. Attributes

Attribute	Type
`id`	`str`
`display_name`	`str`
`description`	`str`
`scopes`	`list[str]`
`mcp_server`	`McpServerDescriptor \| None`
`entry_point`	`str \| None`

OAuthEndpoints

tai42_contract.connectors.providers.OAuthEndpoints

class OAuthEndpoints(BaseModel)

The OAuth endpoint URLs a provider authorizes against, exchanges tokens at, and optionally revokes. Attributes

Attribute	Type
`authorize`	`str`
`token`	`str`
`revoke`	`str \| None`

ProviderDescriptor

tai42_contract.connectors.providers.ProviderDescriptor

class ProviderDescriptor(BaseModel)

The universal connector-provider contract, registered from the manifest connectors list at boot/reload. Attributes

Attribute	Type
`id`	`str`
`display_name`	`str`
`description`	`str`
`kind`	`Literal['oauth', 'none']`
`origin`	`Literal['system', 'community']`
`category`	`str`
`oauth`	`OAuthEndpoints \| None`
`client_id_env`	`str \| None`
`client_secret_env`	`str \| None`
`sub_services`	`dict[str, SubServiceDescriptor]`
`pkg_manager`	`Literal['uvx', 'npx'] \| None`
`pkg_version`	`str \| None`
`config_fields`	`list[ConfigFieldSpec]`
`extra_authorize_params`	`dict[str, str]`

Members

icon_url

tai42_contract.connectors.providers.ProviderDescriptor.icon_url

icon_url: str

An https:// URL to the provider’s icon; 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.

HTTP API

CLI

Settings

Capability map

Conversation bridge

Python SDK

Studio SDK

Connectors (tai42_contract.connectors)

SLUG_RE

McpServerDescriptor

Members

model_post_init

ConfigFieldSpec

SubServiceDescriptor

OAuthEndpoints

ProviderDescriptor

Members

icon_url

​SLUG_RE

​McpServerDescriptor

​Members

​model_post_init

​ConfigFieldSpec

​SubServiceDescriptor

​OAuthEndpoints

​ProviderDescriptor

​Members

​icon_url

SLUG_RE

McpServerDescriptor

Members

model_post_init

ConfigFieldSpec

SubServiceDescriptor

OAuthEndpoints

ProviderDescriptor

Members

icon_url