history

type APIMessage struct {
	Role             string        `json:"role"`
	Content          string        `json:"content"`
	ReasoningContent string        `json:"reasoning_content,omitempty"`
	ToolCallID       string        `json:"tool_call_id,omitempty"`
	ToolCalls        []APIToolCall `json:"tool_calls,omitempty"`
}

type APIToolCall struct {
	ID       string `json:"id"`
	Type     string `json:"type"`
	Function struct {
		Name      string `json:"name"`
		Arguments string `json:"arguments"`
	} `json:"function"`
}

type ChangeLog struct {
	RequestHash      string
	Instructions     string
	Response         string
	FileRevisionHash string
	Filename         string
	OriginalCode     string
	NewCode          string
	Description      string
	Note             sql.NullString
	Status           string
	Timestamp        time.Time
	OriginalPrompt   string // Added: Original user prompt
	LLMMessage       string // Added: Full message sent to LLM
	AgentModel       string // Added: Editing model used
	HasConversation  bool   // Added: Whether conversation.json exists for this revision
	// Tier reflects the revision's compaction state: "hot" (full data
	// including conversation.json) or "warm" (conversation.json
	// dropped). Empty string is treated as hot for backward compat.
	Tier string
}

type ChangeMetadata struct {
	Version          int       `json:"version"`
	Filename         string    `json:"filename"`
	FileRevisionHash string    `json:"file_revision_hash"`
	RequestHash      string    `json:"request_hash"` // This is the revision ID
	Timestamp        time.Time `json:"timestamp"`
	Status           string    `json:"status"`
	Note             string    `json:"note"`
	Description      string    `json:"description"`
	OriginalPrompt   string    `json:"original_prompt,omitempty"` // Added: Original user prompt
	LLMMessage       string    `json:"llm_message,omitempty"`     // Added: Full message sent to LLM
	AgentModel       string    `json:"agent_model,omitempty"`     // Added: Editing model used
}

type CompactionStats struct {
	TotalRevisions         int
	HotKept                int
	WarmDemoted            int // revisions moved hot→warm or already warm
	Dropped                int // revisions moved out of warm → deleted/archived
	ChangesPayloadsDeleted int
	BytesReclaimed         int64
	HardCapTrimmed         int
	OrphanChangesDropped   int
	OverCapChangesDropped  int
	AgedChangesDropped     int
}

type RetentionPolicy struct {
	HotCount      int
	WarmCount     int
	MaxDirBytes   int64
	ArchiveFrozen bool

	// MaxChangesPerRevision caps the per-revision change-record count
	// in the changes/ directory. A single runaway session can produce
	// tens of thousands of records (e.g. when the agent `cd`s into
	// $HOME and a shell walk misclassifies pre-existing files as
	// creates). Without this cap, count-based bloat persists even
	// when total bytes are under MaxDirBytes. Zero disables.
	MaxChangesPerRevision int

	// MaxChangesAge drops change records older than this regardless of
	// their parent revision's tier. Belt-and-suspenders against
	// changes/ growing unbounded inside the hot window. Zero disables.
	MaxChangesAge time.Duration
}

type RevisionGroup struct {
	RevisionID   string
	Instructions string
	Response     string
	Changes      []ChangeLog
	Timestamp    time.Time
	AgentModel   string       // Editing model used for this revision
	Conversation []APIMessage // Full conversation history for multi-turn conversations
}