lifecycle.py 3.1 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697
  1. """Hermes lifecycle dispatch for first-party observers and plugins."""
  2. from __future__ import annotations
  3. import logging
  4. from typing import Any, List
  5. logger = logging.getLogger(__name__)
  6. def _observe(hook_name: str, **kwargs: Any) -> None:
  7. from agent.safe_worker_policy import safe_worker_enabled
  8. if safe_worker_enabled():
  9. return
  10. try:
  11. from hermes_cli.observability import observe_lifecycle
  12. observe_lifecycle(hook_name, **kwargs)
  13. except Exception:
  14. logger.warning("Built-in observability hook failed", exc_info=True)
  15. def _plugin_hooks(hook_name: str, **kwargs: Any) -> list[Any]:
  16. from hermes_cli import plugins
  17. return plugins.invoke_hook(hook_name, **kwargs)
  18. def invoke_hook(hook_name: str, **kwargs: Any) -> list[Any]:
  19. """Notify first-party observers, then invoke compatibility plugin hooks."""
  20. from agent.safe_worker_policy import safe_worker_enabled
  21. if safe_worker_enabled():
  22. return []
  23. _observe(hook_name, **kwargs)
  24. return _plugin_hooks(hook_name, **kwargs)
  25. async def ainvoke_hook(hook_name: str, **kwargs: Any) -> list[Any]:
  26. """:func:`invoke_hook` for callers on an event loop: same observers-then-plugins
  27. composition, with ``async def`` plugin callbacks awaited on that loop."""
  28. _observe(hook_name, **kwargs)
  29. from hermes_cli import plugins
  30. return await plugins.ainvoke_hook(hook_name, **kwargs)
  31. def has_hook(hook_name: str) -> bool:
  32. """Return whether a first-party observer or plugin consumes a hook."""
  33. from agent.safe_worker_policy import safe_worker_enabled
  34. if safe_worker_enabled():
  35. return False
  36. try:
  37. from hermes_cli.observability import handles_hook
  38. if handles_hook(hook_name):
  39. return True
  40. except Exception:
  41. logger.warning("Unable to inspect built-in observability hooks", exc_info=True)
  42. from hermes_cli import plugins
  43. return plugins.has_hook(hook_name)
  44. def session_end_messages(results: Any) -> list[str]:
  45. """User-facing text from ``on_session_finalize`` results: a non-empty ``str`` or ``{"message": str}``.
  46. Surfaces show these out-of-band (CLI print, TUI system line, gateway chat send) — never as a model
  47. turn. ``on_session_end`` is per-turn and stays observer-only."""
  48. messages: list[str] = []
  49. for result in results or ():
  50. text = result.get("message") if isinstance(result, dict) else result
  51. if isinstance(text, str) and text.strip():
  52. messages.append(text.strip())
  53. return messages
  54. def finalize_session(**kwargs: Any) -> list[Any]:
  55. """Notify observers and hard-close one core-owned Relay conversation."""
  56. _observe("on_session_finalize", **kwargs)
  57. session_id = str(kwargs.get("session_id") or "")
  58. if session_id:
  59. try:
  60. from agent import relay_runtime
  61. relay_runtime.SESSION_COORDINATOR.finalize_conversation(
  62. profile_key=relay_runtime.current_profile_key(),
  63. session_id=session_id,
  64. )
  65. except Exception:
  66. logger.warning("Core Relay session finalization failed", exc_info=True)
  67. return _plugin_hooks("on_session_finalize", **kwargs)