names.py 1.7 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061
  1. """Codec for model-facing connector tool names.
  2. Compose and parse bridge names only here. The composed-name collision resolves prefixed vendor slugs first everywhere.
  3. """
  4. from __future__ import annotations
  5. from dataclasses import dataclass
  6. from typing import Optional
  7. __all__ = [
  8. "CONNECTOR_BATCH_SENTINEL",
  9. "CONNECTOR_NAME_PREFIX",
  10. "ConnectorName",
  11. "format_connector_name",
  12. "is_connector_name",
  13. "parse_connector_name",
  14. "vendor_slug_candidates",
  15. ]
  16. CONNECTOR_NAME_PREFIX = "connectors__"
  17. # Planner sentinel, not a callable connector name.
  18. CONNECTOR_BATCH_SENTINEL = "connectors__execute"
  19. @dataclass(frozen=True)
  20. class ConnectorName:
  21. raw: str
  22. connector: str
  23. tool: str
  24. def is_connector_name(name: object) -> bool:
  25. """Prefix match only; malformed names are rejected by the parser."""
  26. return isinstance(name, str) and name.startswith(CONNECTOR_NAME_PREFIX)
  27. def parse_connector_name(name: object) -> Optional[ConnectorName]:
  28. """Use a bounded split so tool slugs retain internal underscores."""
  29. if not isinstance(name, str):
  30. return None
  31. parts = name.split("__", 2)
  32. if len(parts) != 3:
  33. return None
  34. prefix, connector, tool = parts
  35. if prefix != "connectors" or not connector or not tool:
  36. return None
  37. return ConnectorName(raw=name, connector=connector, tool=tool)
  38. def format_connector_name(connector: str, tool: str) -> str:
  39. prefix = f"{connector.upper()}_"
  40. tool = tool.removeprefix(prefix)
  41. return f"{CONNECTOR_NAME_PREFIX}{connector}__{tool}"
  42. def vendor_slug_candidates(connector: str, tool: str) -> tuple[str, ...]:
  43. """Try the stripped conventional prefix before a literal vendor slug."""
  44. return (f"{connector.upper()}_{tool}", tool)