From 3fdd8314c73568524e0f5dfc2ac035411cc771ba Mon Sep 17 00:00:00 2001
From: ajbmachon <ajbmachon2@gmail.com>
Date: Fri, 16 Jan 2026 00:44:10 +0100
Subject: [PATCH] fix: Restore missing observability.ts lib for pai-hook-system

The observability.ts file was accidentally deleted during the kai-* to pai-*
rebrand in commit 0faf5e4. The file was deleted but not re-added under the
new pai- naming convention.

This file is required by security-validator.ts and other hooks that import
from './lib/observability'. Without it, hooks fail with:
  "Cannot find module './lib/observability'"

Restored from git history (commit 1c34d06).
---
 .../pai-hook-system/src/lib/observability.ts  | 58 +++++++++++++++++++
 1 file changed, 58 insertions(+)
 create mode 100644 Packs/pai-hook-system/src/lib/observability.ts

diff --git a/Packs/pai-hook-system/src/lib/observability.ts b/Packs/pai-hook-system/src/lib/observability.ts
new file mode 100644
index 0000000000..2683be6fa6
--- /dev/null
+++ b/Packs/pai-hook-system/src/lib/observability.ts
@@ -0,0 +1,58 @@
+// $PAI_DIR/hooks/lib/observability.ts
+// Sends hook events to observability dashboards
+
+export interface ObservabilityEvent {
+  source_app: string;
+  session_id: string;
+  hook_event_type: 'PreToolUse' | 'PostToolUse' | 'UserPromptSubmit' | 'Notification' | 'Stop' | 'SubagentStop' | 'SessionStart' | 'SessionEnd' | 'PreCompact';
+  timestamp: string;
+  transcript_path?: string;
+  summary?: string;
+  tool_name?: string;
+  tool_input?: any;
+  tool_output?: any;
+  agent_type?: string;
+  model?: string;
+  [key: string]: any;
+}
+
+/**
+ * Send event to observability dashboard
+ * Fails silently if dashboard is not running - doesn't block hook execution
+ */
+export async function sendEventToObservability(event: ObservabilityEvent): Promise<void> {
+  const dashboardUrl = process.env.PAI_OBSERVABILITY_URL || 'http://localhost:4000/events';
+
+  try {
+    const response = await fetch(dashboardUrl, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'User-Agent': 'PAI-Hook/1.0'
+      },
+      body: JSON.stringify(event),
+    });
+
+    if (!response.ok) {
+      // Log error but don't throw - dashboard may be offline
+      console.error(`Observability server returned status: ${response.status}`);
+    }
+  } catch (error) {
+    // Fail silently - dashboard may not be running
+    // This is intentional - hooks should never fail due to observability issues
+  }
+}
+
+/**
+ * Helper to get current timestamp in ISO format
+ */
+export function getCurrentTimestamp(): string {
+  return new Date().toISOString();
+}
+
+/**
+ * Helper to get source app name from environment
+ */
+export function getSourceApp(): string {
+  return process.env.PAI_SOURCE_APP || process.env.DA || 'PAI';
+}