"""Connector integration boundary for managed gateway accounts and local MCP servers. Only the names below are cross-package surface; imports beyond it need a design decision. Siblings: ``contract`` (states, actors, transition table), ``operation`` (the record), ``live`` (open operation per session), ``run`` (the lifecycle loop), ``managed`` / ``mcp`` (per-kind hooks), ``targets``, ``search``, ``dispatch``, ``gateway/`` (HTTP wire + client). The surface is exported lazily (PEP 562): eager submodule imports here deadlocked the concurrent registry scan and the Group Chat worker (see test_connectors_import_deadlock.py). """ import importlib # name -> module owning it: the single source of truth for __all__ and __getattr__. _LAZY_EXPORTS: dict[str, str] = { "CONNECTOR_BATCH_SENTINEL": "tools.connectors.gateway.names", "MANAGE_CONNECTIONS_SCHEMA": "tools.connectors.tool", "connector_describe": "tools.connectors.gateway.bridge", "connector_search_hits": "tools.connectors.gateway.bridge", "connectors_available": "tools.connectors.gateway.config", "dispatch_connector_batch": "tools.connectors.dispatch", "dispatch_connector_call": "tools.connectors.dispatch", "ensure_guest_identity": "tools.connectors.gateway.config", "guest_identity_pending": "tools.connectors.gateway.config", "is_connector_name": "tools.connectors.gateway.names", "manage_connections": "tools.connectors.tool", } __all__ = sorted(_LAZY_EXPORTS) def __getattr__(name: str): """Resolve and cache a public name on first access (PEP 562).""" module_name = _LAZY_EXPORTS.get(name) if module_name is None: raise AttributeError(f"module {__name__!r} has no attribute {name!r}") value = getattr(importlib.import_module(module_name), name) globals()[name] = value return value def __dir__() -> list[str]: return sorted(set(globals()) | set(__all__))