@agenthippo-ai/agenthippo 0.1.0

package/out/scripts/analytics/start-analytics.ps1

@@ -0,0 +1,169 @@
+#
+# Analytics -- Start/Stop OTEL Collector (Windows)
+#
+# Usage:
+#   .\start-analytics.ps1                  # Start collector
+#   .\start-analytics.ps1 -ForceDaemon     # Start (kill orphans first)
+#   .\start-analytics.ps1 -Stop            # Stop collector
+#   .\start-analytics.ps1 -Status          # Check status
+#
+
+param(
+    [switch]$ForceDaemon,
+    [switch]$Stop,
+    [switch]$Status
+)
+
+$ErrorActionPreference = "Stop"
+
+$AgentHomeDir = if ($env:AGENT_HOME_DIR) { $env:AGENT_HOME_DIR } else { Join-Path $env:USERPROFILE ".agent-hippo" }
+$AnalyticsDir = Join-Path $AgentHomeDir "analytics"
+$BinDir = Join-Path $AgentHomeDir "bin"
+$PidFile = Join-Path $AnalyticsDir "otelcol.pid"
+$ConfigFile = Join-Path $AnalyticsDir "config\otel-collector.yaml"
+
+function Log-Info    { param([string]$msg) Write-Host ("[INFO] {0}" -f $msg) -ForegroundColor Blue }
+function Log-Success { param([string]$msg) Write-Host ("[OK]   {0}" -f $msg) -ForegroundColor Green }
+function Log-Warn    { param([string]$msg) Write-Host ("[WARN] {0}" -f $msg) -ForegroundColor Yellow }
+function Log-Error   { param([string]$msg) Write-Host ("[ERROR] {0}" -f $msg) -ForegroundColor Red }
+
+function Get-OtelBinary {
+    # Check system PATH
+    $systemOtel = Get-Command otelcol-contrib -ErrorAction SilentlyContinue
+    if ($systemOtel) { return $systemOtel.Source }
+
+    # Check local bin
+    $localOtel = Join-Path $BinDir "otelcol-contrib.exe"
+    if (Test-Path $localOtel) { return $localOtel }
+
+    return $null
+}
+
+function Get-RunningPid {
+    if (-not (Test-Path $PidFile)) { return $null }
+    $content = Get-Content $PidFile -ErrorAction SilentlyContinue | Select-Object -First 1
+    $otelPid = [int]0
+    if ([int]::TryParse($content, [ref]$otelPid)) {
+        try {
+            $proc = Get-Process -Id $otelPid -ErrorAction SilentlyContinue
+            if ($proc) { return $otelPid }
+        } catch {}
+    }
+    # Stale PID file
+    Remove-Item $PidFile -Force -ErrorAction SilentlyContinue
+    return $null
+}
+
+function Get-MatchingCollectorProcesses {
+    $normalizedConfig = [System.IO.Path]::GetFullPath($ConfigFile).ToLowerInvariant()
+    return @(Get-CimInstance Win32_Process -Filter "Name = 'otelcol-contrib.exe'" -ErrorAction SilentlyContinue | Where-Object {
+        $commandLine = $_.CommandLine
+        $commandLine -and $commandLine.ToLowerInvariant().Contains($normalizedConfig)
+    })
+}
+
+# --- Status ---
+if ($Status) {
+    $otelPid = Get-RunningPid
+    if ($otelPid) {
+        Log-Success ("OTEL Collector running (PID: {0})" -f $otelPid)
+    } else {
+        Log-Warn "OTEL Collector not running"
+    }
+    exit 0
+}
+
+# --- Stop ---
+if ($Stop) {
+    $stopped = $false
+    $otelPid = Get-RunningPid
+    if ($otelPid) {
+        Log-Info ("Stopping OTEL Collector (PID: {0})..." -f $otelPid)
+        Stop-Process -Id $otelPid -Force -ErrorAction SilentlyContinue
+        Remove-Item $PidFile -Force -ErrorAction SilentlyContinue
+        $stopped = $true
+    }
+
+    # Also stop any collector that is using this home's config file.
+    $procs = @(Get-MatchingCollectorProcesses)
+    if ($procs) {
+        $procs | ForEach-Object {
+            if ($_.ProcessId -ne $otelPid) {
+                Log-Info ("Stopping orphaned OTEL Collector (PID: {0})..." -f $_.ProcessId)
+                Stop-Process -Id $_.ProcessId -Force -ErrorAction SilentlyContinue
+                $stopped = $true
+            }
+        }
+    }
+    Remove-Item $PidFile -Force -ErrorAction SilentlyContinue
+
+    if ($stopped) {
+        Log-Success "OTEL Collector stopped"
+    } else {
+        Log-Info "OTEL Collector not running"
+    }
+    exit 0
+}
+
+# --- Start ---
+if ($ForceDaemon) {
+    # Kill any tracked or orphaned collector for this Spotlight config first.
+    $existingPid = Get-RunningPid
+    if ($existingPid) {
+        Log-Info "Stopping existing OTEL Collector (PID: $existingPid)..."
+        Stop-Process -Id $existingPid -Force -ErrorAction SilentlyContinue
+        Start-Sleep 1
+    }
+
+    $matchingCollectors = @(Get-MatchingCollectorProcesses)
+    foreach ($collector in $matchingCollectors) {
+        if ($collector.ProcessId -eq $existingPid) {
+            continue
+        }
+        Log-Info "Stopping orphaned OTEL Collector (PID: $($collector.ProcessId))..."
+        Stop-Process -Id $collector.ProcessId -Force -ErrorAction SilentlyContinue
+    }
+    if ($matchingCollectors.Count -gt 0) {
+        Start-Sleep 1
+    }
+    Remove-Item $PidFile -Force -ErrorAction SilentlyContinue
+}
+
+$otelBin = Get-OtelBinary
+if (-not $otelBin) {
+    Log-Error "OTEL Collector not found. Run 'Setup Analytics' first."
+    exit 1
+}
+
+if (-not (Test-Path $ConfigFile)) {
+    Log-Error ("OTEL Collector config not found at {0}" -f $ConfigFile)
+    Log-Info "Run 'Setup Analytics' to create the configuration."
+    exit 1
+}
+
+# Create traces directory
+New-Item -ItemType Directory -Path (Join-Path $AnalyticsDir "traces") -Force | Out-Null
+
+Log-Info "Starting OTEL Collector..."
+$proc = Start-Process -FilePath $otelBin `
+    -ArgumentList "--config", $ConfigFile `
+    -WindowStyle Hidden `
+    -PassThru `
+    -RedirectStandardOutput (Join-Path $AnalyticsDir "otelcol.log") `
+    -RedirectStandardError (Join-Path $AnalyticsDir "otelcol.error.log")
+
+# Write PID file
+Set-Content -Path $PidFile -Value $proc.Id
+
+Start-Sleep 2
+
+# Verify it's still running
+try {
+    $check = Get-Process -Id $proc.Id -ErrorAction Stop
+    Log-Success "OTEL Collector started (PID: $($proc.Id))"
+} catch {
+    $errorLog = Join-Path $AnalyticsDir "otelcol.error.log"
+    Log-Error ("OTEL Collector failed to start. Check {0}" -f $errorLog)
+    Remove-Item $PidFile -Force -ErrorAction SilentlyContinue
+    exit 1
+}

package/out/scripts/analytics/start-analytics.sh

@@ -0,0 +1,323 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) AgentHippo.ai. All rights reserved.
+#
+# Start AgentHippo Analytics Stack
+# Runs OTEL Collector in background to receive traces from LiteLLM
+#
+# Usage:
+#   ./start-analytics.sh           # Start in foreground
+#   ./start-analytics.sh --daemon  # Start in background
+#   ./start-analytics.sh --stop    # Stop background process
+#   ./start-analytics.sh --status  # Check if running
+#
+
+set -euo pipefail
+
+# AGENT_HOME_DIR is set by the extension with the branded directory path
+# Falls back to ~/.agent-hippo for manual script runs
+AGENT_HOME_DIR="${AGENT_HOME_DIR:-$HOME/.agent-hippo}"
+ANALYTICS_DIR="${AGENT_HOME_DIR}/analytics"
+BIN_DIR="${AGENT_HOME_DIR}/bin"
+PID_FILE="${ANALYTICS_DIR}/otelcol.pid"
+LOG_FILE="${ANALYTICS_DIR}/otelcol.log"
+CONFIG_FILE="${ANALYTICS_DIR}/config/otel-collector.yaml"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+log_info() { echo -e "${BLUE}[INFO]${NC} $1"; }
+log_success() { echo -e "${GREEN}[OK]${NC} $1"; }
+log_warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
+log_error() { echo -e "${RED}[ERROR]${NC} $1"; }
+
+# Find otelcol-contrib binary
+find_otelcol() {
+    if command -v otelcol-contrib &> /dev/null; then
+        echo "otelcol-contrib"
+    elif [[ -x "${BIN_DIR}/otelcol-contrib" ]]; then
+        echo "${BIN_DIR}/otelcol-contrib"
+    else
+        log_error "OTEL Collector not found. Run install-analytics.sh first."
+        exit 1
+    fi
+}
+
+# Check if our tracked process is running
+is_running() {
+    if [[ -f "${PID_FILE}" ]]; then
+        local pid=$(cat "${PID_FILE}")
+        if kill -0 "${pid}" 2>/dev/null; then
+            return 0
+        else
+            # PID file exists but process is dead - clean up stale PID file
+            rm -f "${PID_FILE}"
+        fi
+    fi
+    return 1
+}
+
+# Check if port is in use (returns 0 if in use)
+port_in_use() {
+    local port=$1
+    if command -v lsof &> /dev/null; then
+        lsof -i :"${port}" &>/dev/null
+    elif command -v ss &> /dev/null; then
+        ss -ltn | grep -q ":${port} "
+    elif command -v netstat &> /dev/null; then
+        netstat -an | grep -q "[:.]${port} .*LISTEN"
+    else
+        # Can't check, assume not in use
+        return 1
+    fi
+}
+
+# Find orphan otelcol processes (not tracked by our PID file)
+find_orphan_otelcol() {
+    local our_pid=""
+    if [[ -f "${PID_FILE}" ]]; then
+        our_pid=$(cat "${PID_FILE}")
+    fi
+
+    # Find all otelcol-contrib processes
+    local pids=$(pgrep -f "otelcol-contrib" 2>/dev/null || true)
+
+    for pid in $pids; do
+        if [[ -n "$our_pid" && "$pid" == "$our_pid" ]]; then
+            continue  # Skip our tracked process
+        fi
+        # Return first orphan found
+        echo "$pid"
+        return 0
+    done
+    return 1
+}
+
+# Kill orphan collector if user confirms
+handle_orphan_collector() {
+    local orphan_pid=$1
+    local orphan_cmdline=$(ps -p "$orphan_pid" -o command= 2>/dev/null || echo "unknown")
+
+    log_warn "Found orphan OTEL Collector (PID: ${orphan_pid})"
+    log_warn "Command: ${orphan_cmdline}"
+
+    if [[ "${FORCE:-}" == "1" ]] || [[ "${1:-}" == "--force" ]]; then
+        log_info "Killing orphan process..."
+        kill "${orphan_pid}" 2>/dev/null || true
+        sleep 1
+        if kill -0 "${orphan_pid}" 2>/dev/null; then
+            kill -9 "${orphan_pid}" 2>/dev/null || true
+        fi
+        return 0
+    fi
+
+    log_error "Port 4317 is in use by an orphan collector."
+    log_error "This may be a leftover from a previous installation."
+    echo ""
+    echo "To fix, run one of:"
+    echo "  kill ${orphan_pid}                    # Kill the orphan process"
+    echo "  FORCE=1 $0 --daemon                   # Auto-kill and restart"
+    echo ""
+    return 1
+}
+
+# Start in foreground
+start_foreground() {
+    local otelcol=$(find_otelcol)
+
+    log_info "Starting OTEL Collector (foreground)..."
+    log_info "Config: ${CONFIG_FILE}"
+    log_info "Traces: ${ANALYTICS_DIR}/traces/"
+    log_info "OTLP endpoint: http://127.0.0.1:4317 (gRPC), http://127.0.0.1:4318 (HTTP)"
+    echo ""
+    log_info "Press Ctrl+C to stop"
+    echo ""
+
+    exec "${otelcol}" --config "${CONFIG_FILE}"
+}
+
+# Start in background
+start_daemon() {
+    if is_running; then
+        log_warn "OTEL Collector already running (PID: $(cat ${PID_FILE}))"
+        return 0
+    fi
+
+    local otelcol=$(find_otelcol)
+
+    # Check for port conflicts before starting
+    if port_in_use 4317; then
+        local orphan_pid=$(find_orphan_otelcol || true)
+        if [[ -n "$orphan_pid" ]]; then
+            if [[ "${FORCE:-}" == "1" ]]; then
+                log_warn "Port 4317 in use by orphan process (PID: ${orphan_pid}). Killing..."
+                kill "${orphan_pid}" 2>/dev/null || true
+                sleep 1
+                # Force kill if still running
+                if kill -0 "${orphan_pid}" 2>/dev/null; then
+                    kill -9 "${orphan_pid}" 2>/dev/null || true
+                    sleep 1
+                fi
+            else
+                handle_orphan_collector "$orphan_pid"
+                exit 1
+            fi
+        else
+            log_error "Port 4317 is in use by another process."
+            log_error "Check with: lsof -i :4317"
+            exit 1
+        fi
+    fi
+
+    # Ensure directories exist
+    mkdir -p "${ANALYTICS_DIR}/traces"
+    mkdir -p "$(dirname "${LOG_FILE}")"
+
+    log_info "Starting OTEL Collector (daemon)..."
+
+    # Export AGENT_HOME_DIR for the config file's environment variable substitution
+    export AGENT_HOME_DIR
+    nohup "${otelcol}" --config "${CONFIG_FILE}" > "${LOG_FILE}" 2>&1 &
+    echo $! > "${PID_FILE}"
+
+    sleep 1
+
+    if is_running; then
+        log_success "OTEL Collector started (PID: $(cat ${PID_FILE}))"
+        log_info "Log: ${LOG_FILE}"
+        log_info "OTLP endpoint: http://127.0.0.1:4318 (HTTP), http://127.0.0.1:4317 (gRPC)"
+    else
+        log_error "Failed to start OTEL Collector. Check ${LOG_FILE}"
+        # Show last few lines of log for debugging
+        if [[ -f "${LOG_FILE}" ]]; then
+            echo ""
+            log_info "Last 5 lines of log:"
+            tail -5 "${LOG_FILE}" 2>/dev/null || true
+        fi
+        exit 1
+    fi
+}
+
+# Stop daemon
+stop_daemon() {
+    local stopped=0
+
+    # Stop tracked process
+    if is_running; then
+        local pid=$(cat "${PID_FILE}")
+        log_info "Stopping OTEL Collector (PID: ${pid})..."
+        kill "${pid}" 2>/dev/null || true
+        rm -f "${PID_FILE}"
+        stopped=1
+    fi
+
+    # Also check for orphan processes
+    local orphan_pid=$(find_orphan_otelcol || true)
+    if [[ -n "$orphan_pid" ]]; then
+        log_info "Stopping orphan OTEL Collector (PID: ${orphan_pid})..."
+        kill "${orphan_pid}" 2>/dev/null || true
+        sleep 1
+        # Force kill if still running
+        if kill -0 "${orphan_pid}" 2>/dev/null; then
+            kill -9 "${orphan_pid}" 2>/dev/null || true
+        fi
+        stopped=1
+    fi
+
+    if [[ $stopped -eq 1 ]]; then
+        log_success "OTEL Collector stopped"
+    else
+        log_warn "OTEL Collector not running"
+    fi
+}
+
+# Show status
+show_status() {
+    echo ""
+    echo "🦛 AgentHippo Analytics Status"
+    echo "=============================="
+    echo ""
+
+    # OTEL Collector status
+    if is_running; then
+        echo -e "OTEL Collector: ${GREEN}Running${NC} (PID: $(cat ${PID_FILE}))"
+        echo "  OTLP gRPC:  http://127.0.0.1:4317"
+        echo "  OTLP HTTP:  http://127.0.0.1:4318"
+    else
+        # Check for orphan processes
+        local orphan_pid=$(find_orphan_otelcol || true)
+        if [[ -n "$orphan_pid" ]]; then
+            echo -e "OTEL Collector: ${YELLOW}Orphan${NC} (PID: ${orphan_pid})"
+            echo -e "  ${YELLOW}⚠ Not managed by this installation${NC}"
+            local orphan_cmd=$(ps -p "$orphan_pid" -o command= 2>/dev/null | head -c 60 || echo "unknown")
+            echo "  Command: ${orphan_cmd}..."
+            echo ""
+            echo "  To take control, run:"
+            echo "    kill ${orphan_pid} && $0 --daemon"
+            echo "  Or auto-fix with:"
+            echo "    FORCE=1 $0 --daemon"
+        elif port_in_use 4317; then
+            echo -e "OTEL Collector: ${RED}Port Conflict${NC}"
+            echo -e "  ${RED}⚠ Port 4317 in use by another process${NC}"
+            echo "  Check with: lsof -i :4317"
+        else
+            echo -e "OTEL Collector: ${RED}Stopped${NC}"
+        fi
+    fi
+    echo ""
+
+    # Trace files
+    local trace_count=$(find "${ANALYTICS_DIR}/traces" -name "*.jsonl" 2>/dev/null | wc -l | tr -d ' ')
+    local trace_size=$(du -sh "${ANALYTICS_DIR}/traces" 2>/dev/null | cut -f1 || echo "0")
+    echo "Traces:"
+    echo "  Directory: ${ANALYTICS_DIR}/traces/"
+    echo "  Files: ${trace_count}"
+    echo "  Size: ${trace_size}"
+    echo ""
+
+    # DuckDB availability
+    if command -v duckdb &> /dev/null || [[ -x "${BIN_DIR}/duckdb" ]]; then
+        echo -e "DuckDB: ${GREEN}Available${NC}"
+    else
+        echo -e "DuckDB: ${YELLOW}Not installed${NC}"
+    fi
+    echo ""
+}
+
+# Main
+case "${1:-}" in
+    --daemon|-d)
+        start_daemon
+        ;;
+    --force-daemon)
+        FORCE=1 start_daemon
+        ;;
+    --stop)
+        stop_daemon
+        ;;
+    --status|-s)
+        show_status
+        ;;
+    --help|-h)
+        echo "Usage: $0 [--daemon|--stop|--status]"
+        echo ""
+        echo "Options:"
+        echo "  (none)         Start in foreground"
+        echo "  --daemon       Start in background"
+        echo "  --force-daemon Start in background, killing orphan processes if needed"
+        echo "  --stop         Stop background process"
+        echo "  --status       Show status"
+        echo ""
+        echo "Environment:"
+        echo "  AGENT_HOME_DIR  Base directory (default: ~/.agent-hippo)"
+        echo "  FORCE=1         Auto-kill orphan processes on port conflict"
+        ;;
+    *)
+        start_foreground
+        ;;
+esac
+