sessions

type BackgroundTaskItem struct {
	DurationMs  float64
	Command     string // full, never store-truncate
	Description string
	ExitCode    *int
	Kind, CWD   string
}

type FormatStatsOptions struct {
	Home      string
	Now       time.Time
	ColorMode string // "auto" | "always" | "never"; empty → treat as "never" in tests
	TopN      int    // default 5 at CLI; 0 hides Top tools/background/subagent sections
}

type MatchHit struct {
	File       string // "summary.json", "chat_history.jsonl"
	Line       int    // 1-based
	Part       string // title, session_summary, cwd, user, assistant, ...
	Snippet    string // one-line excerpt
	MatchStart int    // byte offset into Snippet
	MatchLen   int    // length of match in Snippet
}

type RelocateCWDOptions struct {
	// GrokHome is the Grok home directory. Empty → $GROK_HOME or ~/.grok.
	GrokHome string
}

type RelocateCWDResult struct {
	OldCWD, NewCWD, OldSessionDir, NewSessionDir string
	FilesTouched                                 []string // optional
}

type Session struct {
	ID              string
	LastActiveAt    time.Time
	CWD             string
	Title           string
	Path            string
	NumChatMessages int
}

type SessionInfo struct {
	Session
	CreatedAt, UpdatedAt        time.Time
	NumMessages                 int
	CurrentModelID              string
	AgentName                   string
	SandboxProfile              string
	GitRootDir                  string
	HeadBranch                  string
	HeadCommit                  string
	SessionDir                  string
	SummaryPath                 string
	UpdatesPath                 string
	SignalsPath                 string
	PromptContextPath           string
	UpdatesExists               bool
	SignalsExists               bool
	PromptContextExists         bool
	ContextTokensUsed           int
	ContextWindowTokens         int
	ContextWindowUsage          int
	TotalTokensBeforeCompaction int
}

type SessionMatch struct {
	Session
	Hits []MatchHit // full hit list; formatter caps display at 5
}

type SessionStats struct {
	ID, Title, CWD, Model, Agent string
	CreatedAt, LastActiveAt      time.Time

	Turns, UserMessages, AssistantMessages int
	ThinkingBlocks                         int
	ToolCalls, ToolCompleted, ToolFailed   int
	Compactions, Cancellations, Errors     int

	SessionDurationSec int
	AvgResponseMs      int
	AvgTTFTMs          int

	Tools           []ToolStat
	BackgroundTasks *TaskAgg
	Subagents       *TaskAgg

	// Per-item samples for Top background / Top subagent sections.
	// Command is stored full; display truncation is applied in FormatStatsTextOpts.
	BackgroundTaskItems []BackgroundTaskItem
	SubagentItems       []SubagentItem

	Sources StatsSources
}

type StatsSources struct {
	Summary, Signals, Events, Updates bool
	Warnings                          []string
}

type SubagentItem struct {
	DurationMs                   float64
	ID, Description, Type        string
	Status, Model                string
	ToolCalls, Turns, TokensUsed int
}

type TaskAgg struct {
	Count        int
	AvgMs, MaxMs float64
}

type ToolStat struct {
	Name           string
	Count          int
	Success, Error int
	AvgMs, MedMs   float64
	MinMs, MaxMs   float64
}