TAI42 — the OS for AI tools

The concrete tai42_contract.app.TaiApp server (TaiMCP) and its uniform-500 handler.

logger

tai42_skeleton.app.server.logger

logger = logging.getLogger(__name__)

TaiMCP

tai42_skeleton.app.server.TaiMCP

class TaiMCP(TaiMCPLifecycleMixin)

The concrete tai42_contract.app.TaiApp impl — owns the FastMCP server. Exposes the contract facet namespaces as its SOLE feature/contract surface; the concrete server additionally exposes a launch surface (sse_app / http_app / run and friends) that is not part of the facade. This class is the composition root only: each feature’s impl body lives in its feature package (tools.binding.ToolBinding, agent.binding .AgentBinding, backend.registry.BackendHolder, the extension/monitoring registries, app.http.HttpSurface) and each facet forwards straight to its collaborator. Callers reach the app’s features only through the facets (app.tools.run_tool, app.backends.backend, …) or the tai42_app handle, never a flat member.

Members

tools

tai42_skeleton.app.server.TaiMCP.tools

tools: ToolsFacet

The tool/toolkit registration, lookup, and execution facet (app.tools).

agents

tai42_skeleton.app.server.TaiMCP.agents

agents: AgentsFacet

The agent registration and run-binding facet (app.agents).

backends

tai42_skeleton.app.server.TaiMCP.backends

backends: BackendsFacet

The background-execution backend facet (app.backends).

sandboxes

tai42_skeleton.app.server.TaiMCP.sandboxes

sandboxes: SandboxesFacet

The sandbox-provider facet (app.sandboxes).

storage

tai42_skeleton.app.server.TaiMCP.storage

storage: StorageFacet

The resource-storage facet (app.storage).

connectors

tai42_skeleton.app.server.TaiMCP.connectors

connectors: ConnectorsFacet

The connector registration and credential-resolution facet (app.connectors).

interactions

tai42_skeleton.app.server.TaiMCP.interactions

interactions: InteractionsFacet

The interactions facet (app.interactions) — the ask facade.

accounts

tai42_skeleton.app.server.TaiMCP.accounts

accounts: AccountsFacet

The identity/accounts provider facet (app.accounts).

webhook_verifiers

tai42_skeleton.app.server.TaiMCP.webhook_verifiers

webhook_verifiers: WebhookVerifiersFacet

The webhook-verifier registration facet (app.webhook_verifiers).

channels

tai42_skeleton.app.server.TaiMCP.channels

channels: ChannelsFacet

The channel registration facet (app.channels).

conversations

tai42_skeleton.app.server.TaiMCP.conversations

conversations: ConversationsFacet

The conversation-bridge facet (app.conversations).

monitoring

tai42_skeleton.app.server.TaiMCP.monitoring

monitoring: MonitoringFacet

The monitoring-backend facet (app.monitoring).

extensions

tai42_skeleton.app.server.TaiMCP.extensions

extensions: ExtensionsFacet

The extension registration facet (app.extensions).

http

tai42_skeleton.app.server.TaiMCP.http

http: HttpFacet

The custom HTTP route facet (app.http).

clients

tai42_skeleton.app.server.TaiMCP.clients

clients: ClientsFacet

The pooled-client lifecycle facet (app.clients).

lifecycle

tai42_skeleton.app.server.TaiMCP.lifecycle

lifecycle: LifecycleFacet

The startup/shutdown/reload lifecycle facet (app.lifecycle).

admin

tai42_skeleton.app.server.TaiMCP.admin

admin: AdminFacet

The in-process admin-operations facet (app.admin).

config

tai42_skeleton.app.server.TaiMCP.config

config: ConfigFacet

The process config-manager facet (app.config).

sub_app

tai42_skeleton.app.server.TaiMCP.sub_app

sub_app: SubAppFacet

The sub-app MCP router facet (app.sub_app).

backup

tai42_skeleton.app.server.TaiMCP.backup

backup: BackupFacet

The backup-section facet (app.backup).

versioning

tai42_skeleton.app.server.TaiMCP.versioning

versioning: VersioningFacet

The versioned-document store facet (app.versioning).

presets

tai42_skeleton.app.server.TaiMCP.presets

presets: PresetsFacet

The presets facet (app.presets).

states

tai42_skeleton.app.server.TaiMCP.states

states: StatesFacet

The subject-keyed state store facet — the tai42_contract.app.AppStates namespace.

tool_meta

tai42_skeleton.app.server.TaiMCP.tool_meta

tool_meta: ToolMetaFacet

The tool-metadata overlay facet — the tai42_contract.app.AppToolMeta namespace. The organizational overlay (folders + per-tool rows) over any live tool.

fastmcp

tai42_skeleton.app.server.TaiMCP.fastmcp

fastmcp: FastMCP

The raw, ungoverned FastMCP server — the escape hatch beneath the facets. Prefer the facets; reach here only for what the facets don’t wrap (prompts, resources, add_middleware, sampling, elicit-handlers, completions, server metadata such as name/version/auth, the process-global fastmcp.settings). Anything registered THROUGH this server skips the platform’s governance: manifest gating, the extension registry’s validate(), and the access-control gate. It is deliberately NOT on the tai42_contract.app.TaiApp protocol — the contract stays FastMCP-free so an alternative impl remains possible, so this accessor is skeleton-specific. Named fastmcp (not mcp) because app.sub_app already owns the sub-MCP namespace; mcp here would read as the sub-MCP.

emit_list_changed

tai42_skeleton.app.server.TaiMCP.emit_list_changed

async emit_list_changed(self, kind: str) -> None

Broadcast a list_changed notification to every active MCP session for the given registry kind. kind is SINGULAR (tool / prompt / resource). The generic in-process registration-mutation path (e.g. a dev’s runtime add_prompt via app.fastmcp) awaits this after its own registry mutation; the reload path drives the same registry from its sync scheduler. Parameters

Parameter	Type	Default	Description
`kind`	`str`	—	—

sse_app

tai42_skeleton.app.server.TaiMCP.sse_app

sse_app(
    self,
    path: str | None = None,
    message_path: str | None = None,
    middleware: list[Middleware] | None = None,
) -> StarletteWithLifespan

Build the SSE ASGI app for this server, recording the served SSE surface. Parameters

Parameter	Type	Default	Description
`path`	`str \| None`	`None`	—
`message_path`	`str \| None`	`None`	—
`middleware`	`list[Middleware] \| None`	`None`	—

http_app

tai42_skeleton.app.server.TaiMCP.http_app

http_app(
    self,
    path: str | None = None,
    middleware: list[Middleware] | None = None,
    json_response: bool | None = None,
    stateless_http: bool | None = None,
    transport: Literal['http', 'streamable-http', 'sse'] = 'http',
) -> StarletteWithLifespan

Build the streamable-HTTP (or SSE) ASGI app for this server, recording the served surface. Parameters

Parameter	Type	Default	Description
`path`	`str \| None`	`None`	—
`middleware`	`list[Middleware] \| None`	`None`	—
`json_response`	`bool \| None`	`None`	—
`stateless_http`	`bool \| None`	`None`	—
`transport`	`Literal['http', 'streamable-http', 'sse']`	`'http'`	—

run_async

tai42_skeleton.app.server.TaiMCP.run_async

async run_async(
    self,
    transport: Transport | None = None,
    show_banner: bool = True,
    **transport_kwargs: Any,
) -> None

Run the FastMCP server asynchronously over transport. Parameters

Parameter	Type	Default	Description
`transport`	`Transport \| None`	`None`	—
`show_banner`	`bool`	`True`	—
`transport_kwargs`	`Any`	`{}`	—

run

tai42_skeleton.app.server.TaiMCP.run

run(
    self,
    transport: Transport | None = None,
    show_banner: bool = True,
    **transport_kwargs: Any,
) -> None

Run the FastMCP server (blocking) over transport. Parameters

Parameter	Type	Default	Description
`transport`	`Transport \| None`	`None`	—
`show_banner`	`bool`	`True`	—
`transport_kwargs`	`Any`	`{}`	—

run_backend

tai42_skeleton.app.server.TaiMCP.run_backend

async run_backend(self, args) -> None

Launch the background-execution backend with args. Parameters

Parameter	Type	Default	Description
`args`	—	—	—

preset_manager

tai42_skeleton.app.server.TaiMCP.preset_manager

preset_manager: PresetManager

The preset register/reload engine (spec map + quarantine set + register/reload/remove/rehydrate). Skeleton-only surface — like emit_list_changed and fastmcp, it is deliberately not on the tai42_contract.app.TaiApp protocol; the preset routes and the startup/reload rehydration hook reach it through this concrete instance.

​logger

​TaiMCP

​Members

​tools

​agents

​backends

​sandboxes

​storage

​connectors

​interactions

​accounts

​webhook_verifiers

​channels

​conversations

​monitoring

​extensions

​http

​clients

​lifecycle

​admin

​config

​sub_app

​backup

​versioning

​presets

​states

​tool_meta

​fastmcp

​emit_list_changed

​sse_app

​http_app

​run_async

​run

​run_backend

​preset_manager