events.py 2.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778
  1. """Typed gateway monitoring events.
  2. Content-free service-health and redacted diagnostic events for the gateway
  3. daemon — the only shapes the monitoring plane emits: no prompts, messages,
  4. tool args/results, session history, or usage analytics. Field order is wire
  5. order (``asdict``); never reorder.
  6. """
  7. from __future__ import annotations
  8. import time
  9. from dataclasses import dataclass, field, asdict
  10. from typing import Any, ClassVar, Dict, Optional
  11. class _MonitoringEvent:
  12. __slots__ = ()
  13. EVENT: ClassVar[str]
  14. def to_dict(self) -> dict[str, Any]:
  15. return {"event": self.EVENT, **asdict(self)}
  16. @dataclass(slots=True)
  17. class GatewayHealthEvent(_MonitoringEvent):
  18. """Content-free gateway health snapshot or lifecycle event."""
  19. EVENT: ClassVar[str] = "gateway_health"
  20. name: str
  21. gateway_state: Optional[str] = None
  22. old_state: Optional[str] = None
  23. new_state: Optional[str] = None
  24. exit_reason: Optional[str] = None
  25. restart_requested: Optional[bool] = None
  26. active_agents: int = 0
  27. gateway_busy: bool = False
  28. gateway_drainable: bool = False
  29. platform_count: int = 0
  30. fatal_platform_count: int = 0
  31. profile: Optional[str] = None
  32. install_id: Optional[str] = None
  33. version: Optional[str] = None
  34. supervision_mode: Optional[str] = None
  35. pid: Optional[int] = None
  36. ts_ns: int = field(default_factory=time.time_ns)
  37. @dataclass(slots=True)
  38. class GatewayDiagnosticEvent(_MonitoringEvent):
  39. """Redacted gateway diagnostic event for operator-owned observability."""
  40. EVENT: ClassVar[str] = "gateway_diagnostic"
  41. name: str
  42. subsystem: str
  43. error_class: str = "unknown"
  44. error_code: Optional[str] = None
  45. platform: Optional[str] = None
  46. old_state: Optional[str] = None
  47. new_state: Optional[str] = None
  48. profile: Optional[str] = None
  49. version: Optional[str] = None
  50. severity: str = "warning"
  51. ts_ns: int = field(default_factory=time.time_ns)
  52. source_logger: Optional[str] = None
  53. @dataclass(slots=True)
  54. class CronExecutionEvent(_MonitoringEvent):
  55. """Content-free durable cron execution lifecycle projection."""
  56. EVENT: ClassVar[str] = "cron_execution"
  57. status: str
  58. job_key: str
  59. source: str = "unknown"
  60. duration_ms: Optional[int] = None
  61. delivery_outcome: Optional[str] = None
  62. error_class: Optional[str] = None
  63. ts_ns: int = field(default_factory=time.time_ns)
  64. __all__ = ["CronExecutionEvent", "GatewayDiagnosticEvent", "GatewayHealthEvent"]