observability

type AttemptNode struct {
	TaskID, RunID                                       string
	Ordinal, RunOrdinal                                 int
	Phase, RuntimeClass, RuntimeInstanceID, FailureCode string
	FencingToken                                        int64
	CreatedAt                                           time.Time
}

type AuditNode struct {
	EventType, ResourceType, ResourceID, Actor, Details string
	OccurredAt                                          time.Time
}

type ExecutionCorrelation struct {
	Workflow    WorkflowNode
	Steps       []StepNode
	Tasks       []TaskNode
	Attempts    []AttemptNode
	ModelCalls  []ModelCallNode
	ToolCalls   []ToolCallNode
	Memories    []MemoryNode
	AuditEvents []AuditNode

	RuntimeOperationReceipts int
}

type MemoryNode struct {
	Namespace, Key                string
	SourceTaskID, SourceAttemptID string
}

type Metrics struct {
	WorkflowCount, WorkflowSucceeded, WorkflowFailed int
	TaskCount, TaskSucceeded, TaskFailed             int
	ModelCalls, ToolCalls, MemoryRecords             int
	AuditEvents, Receipts                            int

	WorkflowSuccessRate, TaskSuccessRate float64
	SchedulingLatencyMillis              Percentiles
	RetryRate, RecoveryRate              float64

	BudgetDrift           bool // reserved != settled tokens
	CapacityDrift         int  // ACTIVE reservations remaining
	DuplicateSideEffects  int  // tool_calls EXECUTED more than once for the same (task, tool, args)
	CrossTenantViolations int  // rows in other tenants referencing this workflow's resources
}

type ModelCallNode struct {
	TaskID, RunID, AttemptID, ModelRef, Status string
}

type Percentiles struct {
	P50, P95, P99 float64
}

type StepNode struct {
	Name, Status, TaskID, FailureCode string
	AttemptCount                      int
}

type TaskNode struct {
	ID, AgentVersionRef, Phase, ResultRef string
	CreatedAt                             time.Time
}

type ToolCallNode struct {
	TaskID, RunID, AttemptID, ToolName, Action, Status string
}

type WorkflowNode struct {
	ID, Status, Goal       string
	CreatedAt, CompletedAt time.Time
}