| 12345678910111213141516171819202122232425262728293031323334353637383940414243 |
- """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__))
|