relay_plugin_cutover.py 1.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142
  1. """Shared migration guards for Hermes' native NeMo Relay ownership."""
  2. from __future__ import annotations
  3. from collections.abc import Mapping
  4. from typing import Any
  5. RELAY_PLUGINS_CONFIG_ENV = "HERMES_NEMO_RELAY_PLUGINS_TOML"
  6. LEGACY_RELAY_PLUGIN_KEYS = frozenset({"nemo_relay", "observability/nemo_relay"})
  7. LEGACY_RELAY_EXPORT_ENV_VARS = frozenset({
  8. "HERMES_NEMO_RELAY_ATOF_ENABLED",
  9. "HERMES_NEMO_RELAY_ATOF_OUTPUT_DIRECTORY",
  10. "HERMES_NEMO_RELAY_ATOF_FILENAME",
  11. "HERMES_NEMO_RELAY_ATOF_MODE",
  12. "HERMES_NEMO_RELAY_ATIF_ENABLED",
  13. "HERMES_NEMO_RELAY_ATIF_OUTPUT_DIRECTORY",
  14. "HERMES_NEMO_RELAY_ATIF_FILENAME_TEMPLATE",
  15. "HERMES_NEMO_RELAY_ATIF_AGENT_NAME",
  16. "HERMES_NEMO_RELAY_ATIF_AGENT_VERSION",
  17. "HERMES_NEMO_RELAY_ATIF_EXPORT_TIMEOUT_S",
  18. "HERMES_NEMO_RELAY_ATIF_MODEL_NAME",
  19. "HERMES_NEMO_RELAY_ATIF_SUBAGENT_EXPORT_MODE",
  20. })
  21. def legacy_relay_plugin_keys(values: Any) -> tuple[str, ...]:
  22. """Return removed Relay plugin identities present in a config value."""
  23. if not isinstance(values, (list, tuple, set, frozenset)):
  24. return ()
  25. return tuple(sorted({v for v in values if isinstance(v, str) and v in LEGACY_RELAY_PLUGIN_KEYS}))
  26. def configured_legacy_relay_env_vars(env: Mapping[str, Any] | None) -> tuple[str, ...]:
  27. """Return non-empty legacy Relay exporter variables in *env*."""
  28. if env is None:
  29. return ()
  30. return tuple(sorted(
  31. name for name in LEGACY_RELAY_EXPORT_ENV_VARS if env.get(name) is not None and str(env[name]).strip()
  32. ))