Skip to content

armgit / Pulse

Public Imported from GitHub
0

Real-time monitoring dashboard for Proxmox VE, PBS, Docker, Kubernetes, TrueNAS and vSphere. Self-hosted, with alerts for failed backups, full disks, unhealthy containers and offline nodes.

13.7 KB
Raw Blame
package tools

import (
	"context"
	"fmt"
	"strings"
	"time"

	"github.com/rcourtman/pulse-go-rewrite/internal/agentcapabilities"
)

// registerAlertsTools registers the pulse_alerts tool
func (e *PulseToolExecutor) registerAlertsTools() {
	e.registry.registerBuiltin(RegisteredTool{
		Definition: Tool{
			Name: agentcapabilities.PulseAlertsToolName,
			Description: `Manage alerts and AI patrol findings.

Actions:
- list: List active threshold alerts (CPU > 80%, disk full, etc.)
- findings: List AI patrol findings (detected issues)
- resolved: List recently resolved alerts; one with a resolution closed without recovering
- resolve: Mark a finding as resolved
- dismiss: Dismiss a finding as not an issue

Examples:
- List critical alerts: action="list", severity="critical"
- List all findings: action="findings"
- List resolved: action="resolved"
- Resolve finding: action="resolve", finding_id="abc123", resolution_note="Fixed by restarting service"
- Dismiss finding: action="dismiss", finding_id="abc123", reason="expected_behavior", note="This is normal during maintenance"`,
			InputSchema: InputSchema{
				Type: "object",
				Properties: map[string]PropertySchema{
					"action": {
						Type:        "string",
						Description: "Alert action to perform",
						Enum:        []string{"list", "findings", "resolved", "resolve", "dismiss"},
					},
					"severity": {
						Type:        "string",
						Description: "Filter by severity: critical, warning, info (for list, findings)",
						Enum:        []string{"critical", "warning", "info"},
					},
					"resource_type": {
						Type:        "string",
						Description: "Filter by canonical v6 resource type: vm, system-container, app-container, node (for findings)",
					},
					"resource_id": {
						Type:        "string",
						Description: "Filter by resource ID (for findings)",
					},
					agentcapabilities.FindingIDArgumentName: {
						Type:        "string",
						Description: "Finding ID (for resolve, dismiss)",
					},
					agentcapabilities.ResolutionNoteArgumentName: {
						Type:        "string",
						Description: "Optional resolution note (for resolve action)",
					},
					agentcapabilities.NoteArgumentName: {
						Type:        "string",
						Description: "Optional explanation note (for dismiss action)",
					},
					agentcapabilities.ReasonArgumentName: {
						Type:        "string",
						Description: "Dismissal reason: not_an_issue, expected_behavior, will_fix_later",
						Enum:        []string{"not_an_issue", "expected_behavior", "will_fix_later"},
					},
					"include_dismissed": {
						Type:        "boolean",
						Description: "Include previously dismissed findings (for findings)",
					},
					"type": {
						Type:        "string",
						Description: "Filter resolved alerts by type",
					},
					"level": {
						Type:        "string",
						Description: "Filter resolved alerts by level: critical, warning",
					},
					"limit": {
						Type:        "integer",
						Description: "Maximum number of results (default: 100)",
					},
					"offset": {
						Type:        "integer",
						Description: "Number of results to skip",
					},
				},
				Required: []string{"action"},
			},
		},
		Handler: func(ctx context.Context, exec *PulseToolExecutor, args map[string]interface{}) (CallToolResult, error) {
			return exec.executeAlerts(ctx, args)
		},
		Governance: ToolGovernance{
			ActionMode:      ToolActionMixed,
			ApprovalPolicy:  ToolApprovalActionPlan,
			ApprovalSummary: "read/list actions are safe; finding resolution and dismissal require the alerts governance path",
			Summary:         "Reviews alert and finding state and records governed finding decisions.",
		},
	})
}

// executeAlerts routes to the appropriate alerts handler based on action
func (e *PulseToolExecutor) executeAlerts(ctx context.Context, args map[string]interface{}) (CallToolResult, error) {
	action, _ := args["action"].(string)
	switch action {
	case "list":
		return e.executeListAlerts(ctx, args)
	case "findings":
		return e.executeListFindings(ctx, args)
	case "resolved":
		return e.executeListResolvedAlerts(ctx, args)
	case "resolve":
		return e.executeResolveFinding(ctx, args)
	case "dismiss":
		return e.executeDismissFinding(ctx, args)
	default:
		return NewErrorResult(fmt.Errorf("unknown action: %s. Use: list, findings, resolved, resolve, dismiss", action)), nil
	}
}

func (e *PulseToolExecutor) executeListAlerts(_ context.Context, args map[string]interface{}) (CallToolResult, error) {
	if e.alertProvider == nil {
		return NewTextResult("Alert data not available."), nil
	}

	severityFilter, _ := args["severity"].(string)
	limit := intArg(args, "limit", 100)
	offset := intArg(args, "offset", 0)

	allAlerts := e.alertProvider.GetActiveAlerts()

	var filtered []ActiveAlert
	for i, a := range allAlerts {
		if i < offset {
			continue
		}
		if len(filtered) >= limit {
			break
		}
		if severityFilter != "" && a.Severity != severityFilter {
			continue
		}
		filtered = append(filtered, a)
	}

	if filtered == nil {
		filtered = []ActiveAlert{}
	}

	response := EmptyAlertsResponse()
	response.Alerts = filtered
	response.Count = len(filtered)

	if offset > 0 || len(allAlerts) > limit {
		response.Pagination = &PaginationInfo{
			Total:  len(allAlerts),
			Limit:  limit,
			Offset: offset,
		}
	}

	return NewJSONResult(response.NormalizeCollections()), nil
}

func (e *PulseToolExecutor) executeListFindings(_ context.Context, args map[string]interface{}) (CallToolResult, error) {
	includeDismissed, _ := args["include_dismissed"].(bool)
	severityFilter, _ := args["severity"].(string)
	resourceType, _ := args["resource_type"].(string)
	resourceID, _ := args["resource_id"].(string)
	limit := intArg(args, "limit", 100)
	offset := intArg(args, "offset", 0)
	if limit <= 0 {
		limit = 100
	}
	if offset < 0 {
		offset = 0
	}
	resourceType = strings.ToLower(strings.TrimSpace(resourceType))
	resourceID = strings.TrimSpace(resourceID)
	if resourceType != "" {
		resourceType = canonicalAlertFindingResourceType(resourceType)
		validTypes := map[string]bool{
			"vm":               true,
			"system-container": true,
			"node":             true,
			"app-container":    true,
		}
		if !validTypes[resourceType] {
			return NewErrorResult(fmt.Errorf("invalid resource_type: %s. Use vm, system-container, node, or app-container", resourceType)), nil
		}
	}

	// During a first-party Patrol run, pulse_alerts(action=findings) is a
	// model-friendly alias for the same scoped duplicate check as
	// patrol_get_findings. Both reads come from the Patrol adapter so the
	// report/assessment precondition is satisfied without exposing findings
	// outside the run's effective resource scope. Dismissed history is not part
	// of the active duplicate-check contract and remains empty in this mode.
	if creator := e.GetPatrolFindingCreator(); creator != nil {
		allScoped := creator.GetActiveFindings(resourceID, "")
		active := make([]Finding, 0, len(allScoped))
		for _, finding := range allScoped {
			if severityFilter != "" && finding.Severity != severityFilter {
				continue
			}
			if resourceType != "" && canonicalAlertFindingResourceType(finding.ResourceType) != resourceType {
				continue
			}
			detectedAt, _ := time.ParseInLocation("2006-01-02 15:04", finding.DetectedAt, time.Local)
			active = append(active, Finding{
				ID: finding.ID, Key: finding.Key, Severity: finding.Severity, Category: finding.Category,
				ResourceID: finding.ResourceID, ResourceName: finding.ResourceName, ResourceType: finding.ResourceType,
				Title: finding.Title, Description: finding.Description, DetectedAt: detectedAt,
			})
		}
		totalActive := len(active)
		start := offset
		if start > totalActive {
			start = totalActive
		}
		end := start + limit
		if end > totalActive {
			end = totalActive
		}
		response := EmptyFindingsResponse()
		response.Active = active[start:end]
		response.Dismissed = []Finding{}
		response.Counts = FindingCounts{Active: totalActive}
		if offset > 0 || totalActive > limit {
			response.Pagination = &PaginationInfo{Total: totalActive, Limit: limit, Offset: offset}
		}
		return NewJSONResult(response.NormalizeCollections()), nil
	}

	if e.findingsProvider == nil {
		return NewTextResult("Patrol findings not available. Pulse Patrol may not be running."), nil
	}

	allActive := e.findingsProvider.GetActiveFindings()
	var allDismissed []Finding
	if includeDismissed {
		allDismissed = e.findingsProvider.GetDismissedFindings()
	}

	matches := func(f Finding) bool {
		if severityFilter != "" && f.Severity != severityFilter {
			return false
		}
		if resourceID != "" && f.ResourceID != resourceID {
			return false
		}
		if resourceType != "" && canonicalAlertFindingResourceType(f.ResourceType) != resourceType {
			return false
		}
		return true
	}

	// Filter active
	var active []Finding
	totalActive := 0
	for _, f := range allActive {
		if !matches(f) {
			continue
		}
		if totalActive < offset {
			totalActive++
			continue
		}
		if len(active) >= limit {
			totalActive++
			continue
		}
		active = append(active, f)
		totalActive++
	}

	// Filter dismissed
	var dismissed []Finding
	totalDismissed := 0
	if includeDismissed {
		for _, f := range allDismissed {
			if !matches(f) {
				continue
			}
			if totalDismissed < offset {
				totalDismissed++
				continue
			}
			if len(dismissed) >= limit {
				totalDismissed++
				continue
			}
			dismissed = append(dismissed, f)
			totalDismissed++
		}
	}

	if active == nil {
		active = []Finding{}
	}
	if dismissed == nil {
		dismissed = []Finding{}
	}

	response := EmptyFindingsResponse()
	response.Active = active
	response.Dismissed = dismissed
	response.Counts = FindingCounts{
		Active:    totalActive,
		Dismissed: totalDismissed,
	}

	total := totalActive + totalDismissed
	if offset > 0 || total > limit {
		response.Pagination = &PaginationInfo{
			Total:  total,
			Limit:  limit,
			Offset: offset,
		}
	}

	return NewJSONResult(response.NormalizeCollections()), nil
}

func canonicalAlertFindingResourceType(raw string) string {
	return strings.ToLower(strings.TrimSpace(raw))
}

func (e *PulseToolExecutor) executeResolveFinding(_ context.Context, args map[string]interface{}) (CallToolResult, error) {
	findingID, _ := args[agentcapabilities.FindingIDArgumentName].(string)
	resolutionNote, _ := args[agentcapabilities.ResolutionNoteArgumentName].(string)

	if findingID == "" {
		return NewErrorResult(fmt.Errorf("%s is required", agentcapabilities.FindingIDArgumentName)), nil
	}

	if e.findingsManager == nil {
		return NewTextResult("Findings manager not available."), nil
	}

	if err := e.findingsManager.ResolveFinding(findingID, resolutionNote); err != nil {
		return NewErrorResult(err), nil
	}

	return NewJSONResult(map[string]interface{}{
		"success":                               true,
		agentcapabilities.FindingIDArgumentName: findingID,
		"action":                                "resolved",
		agentcapabilities.ResolutionNoteArgumentName: resolutionNote,
		"verification": map[string]interface{}{"ok": true, "method": "store"},
	}), nil
}

func (e *PulseToolExecutor) executeDismissFinding(_ context.Context, args map[string]interface{}) (CallToolResult, error) {
	findingID, _ := args[agentcapabilities.FindingIDArgumentName].(string)
	reason, _ := args[agentcapabilities.ReasonArgumentName].(string)
	note, _ := args[agentcapabilities.NoteArgumentName].(string)

	if findingID == "" {
		return NewErrorResult(fmt.Errorf("%s is required", agentcapabilities.FindingIDArgumentName)), nil
	}
	if reason == "" {
		return NewErrorResult(fmt.Errorf("%s is required", agentcapabilities.ReasonArgumentName)), nil
	}

	if e.findingsManager == nil {
		return NewTextResult("Findings manager not available."), nil
	}

	if err := e.findingsManager.DismissFinding(findingID, reason, note); err != nil {
		return NewErrorResult(err), nil
	}

	return NewJSONResult(map[string]interface{}{
		"success":                               true,
		agentcapabilities.FindingIDArgumentName: findingID,
		"action":                                "dismissed",
		agentcapabilities.ReasonArgumentName:    reason,
		agentcapabilities.NoteArgumentName:      note,
		"verification":                          map[string]interface{}{"ok": true, "method": "store"},
	}), nil
}

// ========== Resolved Alerts Tool Implementation ==========

func (e *PulseToolExecutor) executeListResolvedAlerts(_ context.Context, args map[string]interface{}) (CallToolResult, error) {
	typeFilter, _ := args["type"].(string)
	levelFilter, _ := args["level"].(string)
	limit := intArg(args, "limit", 50)

	if e.alertProvider == nil {
		return NewTextResult("Alert provider not available."), nil
	}

	recentlyResolved := e.alertProvider.GetRecentlyResolved(24 * 60) // past 24 hours

	if len(recentlyResolved) == 0 {
		return NewTextResult("No recently resolved alerts."), nil
	}

	var alerts []ResolvedAlertSummary

	for _, alert := range recentlyResolved {
		// Apply filters
		if typeFilter != "" && !strings.EqualFold(alert.Type, typeFilter) {
			continue
		}
		if levelFilter != "" && !strings.EqualFold(alert.Level, levelFilter) {
			continue
		}

		if len(alerts) >= limit {
			break
		}

		summary := ResolvedAlertSummary{
			ID:           alert.ID,
			Type:         alert.Type,
			Level:        alert.Level,
			ResourceID:   alert.ResourceID,
			ResourceName: alert.ResourceName,
			Node:         alert.Node,
			Instance:     alert.Instance,
			Message:      alert.Message,
			Value:        alert.Value,
			Threshold:    alert.Threshold,
			StartTime:    alert.StartTime,
			ResolvedTime: alert.ResolvedTime,
		}
		if resolution := alert.Resolution; resolution != nil {
			summary.Resolution = resolution.Summary
			summary.SuccessorResourceID = resolution.SuccessorResourceID
		}
		alerts = append(alerts, summary)
	}

	if alerts == nil {
		alerts = []ResolvedAlertSummary{}
	}

	response := EmptyResolvedAlertsResponse()
	response.Alerts = alerts
	response.Total = len(recentlyResolved)

	return NewJSONResult(response.NormalizeCollections()), nil
}