Import AITURK IDE 1.0.0-beta.1 from Hermes 63279301; preserve MIT license

agent/monitoring/events.py

@@ -0,0 +1,86 @@
+"""Typed gateway monitoring events.
+
+Content-free service-health and redacted diagnostic events for the gateway
+daemon. These are the only event shapes the monitoring plane emits: no
+prompts, messages, tool args/results, session history, or usage analytics.
+"""
+
+from __future__ import annotations
+
+import time
+from dataclasses import dataclass, field, asdict
+from typing import Any, Dict, Optional
+
+
+def _now_ns() -> int:
+    return time.time_ns()
+
+
+@dataclass(slots=True)
+class GatewayHealthEvent:
+    """Content-free gateway health snapshot or lifecycle event."""
+
+    name: str
+    gateway_state: Optional[str] = None
+    old_state: Optional[str] = None
+    new_state: Optional[str] = None
+    exit_reason: Optional[str] = None
+    restart_requested: Optional[bool] = None
+    active_agents: int = 0
+    gateway_busy: bool = False
+    gateway_drainable: bool = False
+    platform_count: int = 0
+    fatal_platform_count: int = 0
+    profile: Optional[str] = None
+    install_id: Optional[str] = None
+    version: Optional[str] = None
+    supervision_mode: Optional[str] = None
+    pid: Optional[int] = None
+    ts_ns: int = field(default_factory=_now_ns)
+
+    def to_dict(self) -> Dict[str, Any]:
+        return {"event": "gateway_health", **asdict(self)}
+
+
+@dataclass(slots=True)
+class GatewayDiagnosticEvent:
+    """Redacted gateway diagnostic event for operator-owned observability."""
+
+    name: str
+    subsystem: str
+    error_class: str = "unknown"
+    error_code: Optional[str] = None
+    platform: Optional[str] = None
+    old_state: Optional[str] = None
+    new_state: Optional[str] = None
+    profile: Optional[str] = None
+    version: Optional[str] = None
+    severity: str = "warning"
+    ts_ns: int = field(default_factory=_now_ns)
+    source_logger: Optional[str] = None
+
+    def to_dict(self) -> Dict[str, Any]:
+        return {"event": "gateway_diagnostic", **asdict(self)}
+
+
+@dataclass(slots=True)
+class CronExecutionEvent:
+    """Content-free durable cron execution lifecycle projection."""
+
+    status: str
+    job_key: str
+    source: str = "unknown"
+    duration_ms: Optional[int] = None
+    delivery_outcome: Optional[str] = None
+    error_class: Optional[str] = None
+    ts_ns: int = field(default_factory=_now_ns)
+
+    def to_dict(self) -> Dict[str, Any]:
+        return {"event": "cron_execution", **asdict(self)}
+
+
+__all__ = [
+    "GatewayHealthEvent",
+    "GatewayDiagnosticEvent",
+    "CronExecutionEvent",
+]