SysOps: voice-agy-webbuilder-backup — 2026-06-23 10:04 UTC

cockpit/app/services/agent_events_log.py

@@ -0,0 +1,48 @@
+"""Log agent activity to agent_events for terminals and audit."""
+from __future__ import annotations
+
+import json
+from typing import Any, Optional
+
+from app.db import fetch_one
+from app.services.agent_names import normalize_agent_key
+
+
+def log_agent_event(
+    agent_name: str,
+    event_type: str,
+    title: str,
+    body: str = "",
+    *,
+    agent_type: Optional[str] = None,
+    status: str = "completed",
+    channel: str = "cockpit",
+    metadata: Optional[dict[str, Any]] = None,
+) -> Optional[dict[str, Any]]:
+    key = normalize_agent_key(agent_name)
+    if not key:
+        return None
+    meta = json.dumps(metadata or {})
+    row = fetch_one(
+        """
+        INSERT INTO agent_events (agent_name, agent_type, event_type, title, body, status, channel, metadata)
+        VALUES (%s, %s, %s, %s, %s, %s, %s, %s::jsonb)
+        RETURNING id, agent_name, event_type, title, body, status, channel, metadata, created_at
+        """,
+        (
+            key,
+            agent_type or key,
+            event_type,
+            title[:255],
+            (body or "")[:8000],
+            status,
+            channel,
+            meta,
+        ),
+    )
+    if not row:
+        return None
+    out = dict(row)
+    if out.get("created_at") and hasattr(out["created_at"], "isoformat"):
+        out["created_at"] = out["created_at"].isoformat()
+    return out