package models

import "time"

// AIAgentRun is one task an AI_engine agent finished, recorded from its
// `telemetry.task` event (internal/ai/telemetry). Phase 4 of
// krow_talent_app/docs/agent-platform-plan.md: before this, a run existed only
// as a log line and an ephemeral NATS message, so nothing could say how often
// an agent ran or how often it failed.
//
// Append-only, and pruned after 30 days. Live agent STATE (the 5-second
// `telemetry.agent` heartbeat) is deliberately not stored here — it is
// ephemeral and lives in Redis.
type AIAgentRun struct {
	Runid   int64  `json:"runid" gorm:"primaryKey;column:runid;autoIncrement"`
	Agentid string `json:"agentid" gorm:"column:agentid;size:64;not null;index:idx_aiagentruns_agent_received,priority:1;uniqueIndex:uq_aiagentruns_agent_task,priority:1"`
	// Taskid is the engine's task id. Null when the event carried none; the
	// unique index then does not apply (Postgres treats NULLs as distinct), so
	// a redelivered event with an id is stored once and one without is not lost.
	Taskid   *string `json:"taskid" gorm:"column:taskid;size:64;uniqueIndex:uq_aiagentruns_agent_task,priority:2"`
	Tasktype string  `json:"tasktype" gorm:"column:tasktype;size:64"`
	Status   string  `json:"status" gorm:"column:status;size:20;not null"` // completed, failed
	Error    string  `json:"error" gorm:"column:error;type:text"`
	// Durationms is how long the task ran, as the engine measured it.
	Durationms int `json:"durationms" gorm:"column:durationms"`
	// Occurredat is the engine's own timestamp, kept for display only: it is a
	// naive local time from whatever clock and zone the engine host runs.
	// Windows and ordering use Receivedat, which is this backend's clock as a
	// true instant (time.Now) — the column is timestamptz, so utils.DBNow's
	// IST-digits-labelled-UTC value would be 5h30m off here.
	Occurredat *time.Time `json:"occurredat" gorm:"column:occurredat"`
	Receivedat time.Time  `json:"receivedat" gorm:"column:receivedat;not null;index:idx_aiagentruns_agent_received,priority:2;index:idx_aiagentruns_received"`
}

func (AIAgentRun) TableName() string { return "aiagentruns" }