session

type CompactionRecord struct {
	At     time.Time `json:"at"`
	Before int       `json:"before"`
	After  int       `json:"after"`
	Auto   bool      `json:"auto,omitempty"`
}

type ListOptions struct {
	IncludeArchived bool
	// Offset skips this many newest rows before returning results. It lets TUI
	// pickers page through large session stores without decoding every session
	// file before the first screen can render.
	Offset int
	// Limit caps returned rows. A non-positive limit preserves the legacy full list.
	Limit int
}

type Session struct {
	ID       string            `json:"id"`
	Name     string            `json:"name,omitempty"`
	Model    string            `json:"model"`
	Created  time.Time         `json:"created"`
	Cwd      string            `json:"cwd"`
	Messages []adapter.Message `json:"messages"`
	// Todos is the working plan written by the todo_write tool. Omitted
	// from JSON when empty so older session files load unchanged.
	Todos []agent.Todo `json:"todos,omitempty"`
	// Worktree is the yottacode-managed worktree name this session was
	// launched in (via `yottacode --worktree <name>`). Empty for sessions
	// running against the main checkout. Stored so `sessions resume`
	// lands back in the correct worktree dir even if the user moved or
	// renamed the repo. Omitted from JSON when empty so existing session
	// files load unchanged.
	Worktree string `json:"worktree,omitempty"`
	// TotalUsage is the cumulative token tally across every assistant
	// turn in this session. Written by AddUsage on each EventDone.
	// Omitted from JSON when zero so existing session files load
	// byte-identical until the first usage is recorded.
	TotalUsage adapter.Usage `json:"total_usage,omitzero"`
	// ModelUsage is per-model breakdown — users mix models within a
	// session (Anthropic for code review, Gemini for grep, etc.) and
	// the cost calculator needs to know which model produced each
	// turn. Keyed by model ID exactly as the adapter reported it.
	ModelUsage map[string]adapter.Usage `json:"model_usage,omitempty"`
	// SubagentTasks is the persisted index of this session's subagent runs.
	// The live registry (internal/subagents) is in-memory and rebuilt empty
	// each launch; persisting a summary lets get_subagent_result and
	// /subagents resolve task-ids the model wrote into the conversation in a
	// prior session, and lets a startup sweep reclaim a crashed session's
	// empty dispatch worktrees. Omitted when empty so existing session files
	// load unchanged.
	SubagentTasks []subagents.TaskRecord `json:"subagent_tasks,omitempty"`
	// ToolStats is a per-tool-name breakdown of main-thread tool calls —
	// count, approximate output tokens, and error count. Keyed by tool
	// name. Deliberately main-thread only (mirrors TotalUsage/ModelUsage):
	// subagent tool calls stay a single count on subagents.Task.ToolCalls,
	// not broken out by name. Omitted from JSON when empty so existing
	// session files load unchanged.
	ToolStats map[string]ToolStat `json:"tool_stats,omitempty"`
	// CompactionEvents records each time this session's history was
	// compacted, from either mechanism: the TUI's turn-boundary
	// auto-summarize (or manual /summarize), and the main loop's own
	// in-loop agent.ContextCompacted mid-turn self-compaction (wired
	// whenever agentruntime.Build resolves a compaction window — not
	// subagent-only, contrary to an earlier assumption here). Both record
	// into the same slice so /usage can explain otherwise-invisible token
	// spend from re-summarization regardless of which path fired. Omitted
	// from JSON when empty.
	CompactionEvents []CompactionRecord `json:"compaction_events,omitempty"`
	// RestoredFrom records the archived snapshot this session was seeded
	// from, when it was restored rather than started fresh. Provenance only
	// — the restored session is a full independent session from here on.
	RestoredFrom string `json:"restored_from,omitempty"`
	// contains filtered or unexported fields
}

type SessionInfo struct {
	ID       string
	Name     string
	Model    string
	Created  time.Time
	Messages int
	// Worktree is the yottacode worktree name this session ran in, or
	// empty for the main checkout. Surfaced in `yottacode sessions list`
	// output so users can tell which sessions belong to which worktree.
	Worktree string
	// Summary is the one-line gist from the session's first real user
	// prompt — the "what was this one about?" that an id and a timestamp
	// can't answer. See Session.Summary. Empty when nothing usable.
	Summary string
	// Archived marks a pre-compaction snapshot rather than a live session.
	// Loading one restores its history into a NEW session; the archive
	// itself is never written to. ArchivedOf names the session it was
	// captured from (which may no longer exist).
	Archived   bool
	ArchivedOf string
}

type SessionUsageSummary struct {
	ID            string
	Name          string
	Model         string
	Created       time.Time
	TotalUsage    adapter.Usage
	ModelUsage    map[string]adapter.Usage
	SubagentTasks []subagents.TaskRecord
}

type SubagentUsageRollup struct {
	Total      adapter.Usage
	ByModel    map[string]adapter.Usage
	AgentCount int // number of subagents that reported non-zero usage
}

type ToolStat struct {
	Count        int   `json:"count"`
	OutputTokens int64 `json:"output_tokens,omitempty"`
	Errors       int   `json:"errors,omitempty"`
}