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.
Go aialertsdashboarddockerdocker-monitoringgohomelabinfrastructure-monitoringkubernetesmonitoringmspproxmoxproxmox-backup-serverproxmox-mail-gatewayproxmox-veself-hostedtruenastypescriptvspherewebhooks
package telemetry
import (
"strings"
"time"
"github.com/rcourtman/pulse-go-rewrite/internal/config"
)
// PulseIntelligenceAIUsageEvidence is the content-free subset of AI usage
// history used to prove Pulse Intelligence loop collaboration.
type PulseIntelligenceAIUsageEvidence struct {
AssistantAICalls int
AssistantContextAICalls int
AssistantToolCalls int
PatrolAICalls int
// PatrolInputTokens and PatrolOutputTokens are the exact local Patrol
// token totals for the window. They are bucketed before export; the
// exact figures never leave the install.
PatrolInputTokens int64
PatrolOutputTokens int64
}
// PulseIntelligenceAIUsageEvidenceFromHistory projects AI usage history into
// the same content-free Pulse Intelligence evidence used by telemetry and the
// agent operations-loop status endpoint.
func PulseIntelligenceAIUsageEvidenceFromHistory(history *config.AIUsageHistoryData, since time.Time) PulseIntelligenceAIUsageEvidence {
var evidence PulseIntelligenceAIUsageEvidence
if history == nil {
return evidence
}
for _, event := range history.Events {
if event.Timestamp.IsZero() || event.Timestamp.Before(since) {
continue
}
switch strings.ToLower(strings.TrimSpace(event.UseCase)) {
case "chat":
evidence.AssistantAICalls++
if PulseIntelligenceAssistantContextEvent(event) {
evidence.AssistantContextAICalls++
}
if event.ToolCallCount > 0 {
evidence.AssistantToolCalls += event.ToolCallCount
}
case "patrol":
evidence.PatrolAICalls++
if event.InputTokens > 0 {
evidence.PatrolInputTokens += int64(event.InputTokens)
}
if event.OutputTokens > 0 {
evidence.PatrolOutputTokens += int64(event.OutputTokens)
}
}
}
return evidence
}
// PulseIntelligenceAssistantContextEvent reports whether a chat usage event
// carried governed context. It deliberately ignores prompt text and responses.
func PulseIntelligenceAssistantContextEvent(event config.AIUsageEventRecord) bool {
return strings.TrimSpace(event.ContextScope) != "" ||
strings.TrimSpace(event.TargetType) != "" ||
strings.TrimSpace(event.TargetID) != "" ||
strings.TrimSpace(event.FindingID) != ""
}
// PulseIntelligenceExternalAgentEvidence is the content-free subset of
// authenticated agent/MCP route activity used to prove external collaboration.
//
// Interpretation constraint: the agent_api surface counts any suitably scoped
// API-token request to manifest-listed routes — including plain REST consumers
// like scripts and dashboards hitting GET /api/config/nodes or
// /api/ai/patrol/findings — so Used does NOT imply a BYO AI agent. Only
// MCPAdapterUsed (the pulse_mcp surface header) certainly identifies an MCP
// client. Do not read Used-vs-MCPAdapterUsed as an adoption funnel of the
// same population.
type PulseIntelligenceExternalAgentEvidence struct {
Used bool
MCPAdapterUsed bool
ContextRequests int
EventStreamRequests int
ProvisioningRequests int
OperatorStateRequests int
FindingRequests int
ActionRequests int
// HistoryReadDays counts distinct UTC days in the window with at least
// one successful requested history read (list_recent_changes,
// get_metric_history). It backs the event-record review and is not a
// request count.
HistoryReadDays int
}
// CollaborationActive reports whether an external agent or MCP adapter used a
// manifest-published Pulse Intelligence capability in the evidence window.
func (e PulseIntelligenceExternalAgentEvidence) CollaborationActive() bool {
return e.Used ||
e.MCPAdapterUsed ||
e.ContextRequests > 0 ||
e.EventStreamRequests > 0 ||
e.ProvisioningRequests > 0 ||
e.OperatorStateRequests > 0 ||
e.FindingRequests > 0 ||
e.ActionRequests > 0
}
// CollaborationCount returns a coarse activity count for step-level rollups.
func (e PulseIntelligenceExternalAgentEvidence) CollaborationCount() int {
count := e.ContextRequests +
e.EventStreamRequests +
e.ProvisioningRequests +
e.OperatorStateRequests +
e.FindingRequests +
e.ActionRequests
if count > 0 {
return count
}
if e.Used || e.MCPAdapterUsed {
return 1
}
return 0
}
// PulseIntelligenceExternalAgentEvidenceFromHistory projects external-agent
// activity history into content-free collaboration evidence.
func PulseIntelligenceExternalAgentEvidenceFromHistory(history *config.ExternalAgentActivityHistoryData, since time.Time) PulseIntelligenceExternalAgentEvidence {
var evidence PulseIntelligenceExternalAgentEvidence
if history == nil {
return evidence
}
// History-read days are whole UTC dates: the partial date the window
// starts in is left out, so the count is at most 30 and a day is never
// lost because its first read fell before the cutoff.
firstHistoryReadDay := since.UTC().Truncate(24 * time.Hour)
if firstHistoryReadDay.Before(since) {
firstHistoryReadDay = firstHistoryReadDay.Add(24 * time.Hour)
}
historyReadDays := make(map[string]struct{})
for _, event := range history.Events {
if event.Timestamp.IsZero() || event.Timestamp.Before(since) {
continue
}
if !PulseIntelligenceExternalAgentActivitySurface(event.Surface) {
continue
}
evidence.Used = true
if strings.TrimSpace(event.Surface) == config.ExternalAgentActivitySurfacePulseMCP {
evidence.MCPAdapterUsed = true
}
if strings.TrimSpace(event.Activity) == config.ExternalAgentActivityHistoryRead && !event.Timestamp.Before(firstHistoryReadDay) {
historyReadDays[event.Timestamp.UTC().Format(time.DateOnly)] = struct{}{}
}
evidence.ApplyActivity(event.Activity)
}
evidence.HistoryReadDays = len(historyReadDays)
return evidence
}
// PulseIntelligenceExternalAgentActivitySurface reports whether a persisted
// activity surface is part of the governed external-agent contract.
func PulseIntelligenceExternalAgentActivitySurface(surface string) bool {
switch strings.TrimSpace(surface) {
case config.ExternalAgentActivitySurfaceAgentAPI, config.ExternalAgentActivitySurfacePulseMCP:
return true
default:
return false
}
}
// ApplyActivity increments the matching content-free external-agent activity
// bucket.
func (e *PulseIntelligenceExternalAgentEvidence) ApplyActivity(activity string) {
if e == nil {
return
}
switch strings.TrimSpace(activity) {
case config.ExternalAgentActivityResourceContext, config.ExternalAgentActivityFleetContext:
e.ContextRequests++
case config.ExternalAgentActivityEventStream:
e.EventStreamRequests++
case config.ExternalAgentActivityProvisioning:
e.ProvisioningRequests++
case config.ExternalAgentActivityOperatorState:
e.OperatorStateRequests++
case config.ExternalAgentActivityFindingList, config.ExternalAgentActivityFindingDecision:
e.FindingRequests++
case config.ExternalAgentActivityActionPlan, config.ExternalAgentActivityActionDecision, config.ExternalAgentActivityActionExecute:
e.ActionRequests++
}
}