session

type AhaMoment struct {
	Seq       int    `json:"seq"`       // message sequence number for navigation
	Role      string `json:"role"`      // user, assistant, or system
	Type      string `json:"type"`      // question, insight, decision, breakthrough, synthesis
	Highlight string `json:"highlight"` // the key text/quote from this moment
	Why       string `json:"why"`       // brief explanation of why this was important
}

type ArtifactPaths struct {
	SummaryMD   string // summary.md — structured markdown summary
	SummaryJSON string // summary.json — machine-readable summary
	HTML        string // session.html — interactive HTML viewer
	SessionMD   string // session.md — full session transcript in markdown
}

type CaptureOptions struct {
	// AgentID is the current agent's ID (used if not in history metadata)
	AgentID string

	// Title is an optional title for the captured session
	Title string

	// MergeWithActive if true, merges with any active recording
	MergeWithActive bool

	// SkipRedaction if true, skips secret redaction (for testing only)
	SkipRedaction bool
}

type CaptureOutput struct {
	Success         bool              `json:"success"`
	Type            string            `json:"type"` // "session_capture_prior"
	AgentID         string            `json:"agent_id"`
	Path            string            `json:"path"`
	SessionName     string            `json:"session_name,omitempty"`
	EntryCount      int               `json:"entry_count"`
	SecretsRedacted int               `json:"secrets_redacted,omitempty"`
	TimeRange       *HistoryTimeRange `json:"time_range,omitempty"`
	Title           string            `json:"title,omitempty"`
	Message         string            `json:"message,omitempty"`
}

type CaptureResult struct {
	// Path where the history was stored
	Path string `json:"path"`

	// SessionName is the generated session folder name
	SessionName string `json:"session_name,omitempty"`

	// EntryCount is the number of entries captured
	EntryCount int `json:"entry_count"`

	// SecretsRedacted is the count of secrets found and redacted
	SecretsRedacted int `json:"secrets_redacted"`

	// TimeRange contains the time span of the captured history
	TimeRange *HistoryTimeRange `json:"time_range,omitempty"`

	// Title is the session title from metadata
	Title string `json:"title,omitempty"`

	// AgentID from the captured metadata
	AgentID string `json:"agent_id,omitempty"`
}

type CaptureSubagentOptions struct {
	// SessionPath is the parent session's folder path
	SessionPath string

	// SessionsBasePath is the base path where sessions are stored
	SessionsBasePath string

	// RecordingStartTime is when the parent recording started
	RecordingStartTime time.Time

	// RecordingEndTime is when the parent recording ended (optional, defaults to now)
	RecordingEndTime time.Time

	// TimeWindowBuffer is extra time to search for subagent sessions (default: 5 minutes)
	TimeWindowBuffer time.Duration
}

type CaptureSubagentResult struct {
	// TaskCallsFound is the number of Task tool calls detected
	TaskCallsFound int

	// SubagentsMatched is the number of subagents successfully matched
	SubagentsMatched int

	// EnrichedEntries contains entry indices that were enriched with subagent refs
	EnrichedEntries []int

	// UnmatchedTasks contains indices of Task calls that could not be matched
	UnmatchedTasks []int
}

type CapturedHistory struct {
	Meta    *HistoryMeta
	Entries []HistoryEntry
}

type ChapterSummary struct {
	ID         int            `json:"id"`                    // 1-based chapter number
	Title      string         `json:"title"`                 // LLM or heuristic title
	StartSeq   int            `json:"start_seq"`             // first message seq in this chapter
	EndSeq     int            `json:"end_seq"`               // last message seq in this chapter
	ToolCounts map[string]int `json:"tool_counts,omitempty"` // aggregated tool usage {"Read": 5, "Edit": 3}
	TotalTools int            `json:"total_tools"`           // total tool calls in chapter
	HasEdits   bool           `json:"has_edits"`             // true if chapter contains file modifications
}

type DelegationHint struct {
	Recommended     bool   `json:"recommended"`
	SubagentType    string `json:"subagent_type,omitempty"`
	ModelTier       string `json:"model_tier,omitempty"` // "fast" (haiku), "balanced" (sonnet), "reasoning" (opus)
	RunInBackground bool   `json:"run_in_background"`
	Reason          string `json:"reason"`
	Command         string `json:"cmd,omitempty"` // actionable command for agent to run
}

type Entry = SessionEntry

type EntryType = SessionEntryType

type FileModification struct {
	Path   string // file path (relative or absolute)
	Action string // Created, Modified, Deleted
}

type FileSummary struct {
	Path    string `json:"path"`              // shortened file path
	Added   int    `json:"added"`             // lines added
	Removed int    `json:"removed,omitempty"` // lines removed
}

type GhostCleanupResult struct {
	Removed int      // number of ghost sessions removed
	Names   []string // session folder names that were removed
}

type GuidanceOutput struct {
	Success  bool            `json:"success"`
	Type     string          `json:"type"` // always "session_guidance"
	Phase    GuidancePhase   `json:"phase"`
	AgentID  string          `json:"agent_id"`
	Guidance SessionGuidance `json:"guidance"`
	Message  string          `json:"message,omitempty"`
}

type GuidancePhase string

type HTMLGenerator interface {
	GenerateToFile(stored *StoredSession, outputPath string) error
	GenerateToFileWithSummary(stored *StoredSession, summary *SummarizeResponse, outputPath string) error
}

type HTMLGuidance struct {
	Instructions   []string        `json:"instructions"`
	OutputPath     string          `json:"output_path"`
	SourcePath     string          `json:"source_path"`
	Features       []string        `json:"features"`
	DelegationHint *DelegationHint `json:"delegation_hint,omitempty"`
}

type HTMLGuidanceOutput struct {
	Success   bool         `json:"success"`
	Type      string       `json:"type"` // always "session_html_guidance"
	AgentID   string       `json:"agent_id"`
	Guidance  HTMLGuidance `json:"guidance"`
	Generated bool         `json:"generated"`
	HTMLPath  string       `json:"html_path,omitempty"`
	Message   string       `json:"message,omitempty"`
}

type HealthStatus struct {
	// StorageWritable indicates if local storage is writable
	StorageWritable bool

	// StoragePath is the path to local session storage
	StoragePath string

	// StorageError contains error details if storage is not writable
	StorageError string

	// RepoCloned indicates if the ledger is cloned
	RepoCloned bool

	// RepoPath is the path to the ledger
	RepoPath string

	// RepoError contains error details if ledger has issues
	RepoError string

	// IsRecordingActive indicates if a recording is currently in progress
	IsRecordingActive bool

	// Recording contains the current recording state (if active)
	Recording *RecordingState

	// IsStaleRecording indicates the active recording may be abandoned
	// (running for more than StaleRecordingThreshold)
	IsStaleRecording bool

	// StaleRecordingAge is how long the stale recording has been running
	StaleRecordingAge time.Duration

	// AllRecordings contains all active recording states found
	AllRecordings []*RecordingState

	// StaleRecordings contains recordings older than StaleRecordingThreshold
	StaleRecordings []*RecordingState

	// EmptyStaleCount is the number of stale recordings with no raw.jsonl (empty stubs)
	EmptyStaleCount int

	// ContentStaleCount is the number of stale recordings that have raw.jsonl content
	ContentStaleCount int

	// IsStopIncomplete indicates the recording was stopped but the session file was empty
	IsStopIncomplete bool

	// StopIncompleteAge is how long since the incomplete stop occurred
	StopIncompleteAge time.Duration

	// PendingCount is the number of sessions pending commit
	PendingCount int

	// SyncedWithRemote indicates if local repo is synced with remote
	SyncedWithRemote bool

	// SyncStatus describes the sync state (e.g., "ahead by 3", "behind by 1")
	SyncStatus string

	// Errors contains any errors encountered during health checks
	Errors []string
}

type HistoryEntry struct {
	// Seq is the sequence number (monotonically increasing)
	Seq int `json:"seq"`

	// Type identifies the entry type (user, assistant, system, tool)
	Type string `json:"type"`

	// Content is the message or response content
	Content string `json:"content"`

	// Timestamp is when this entry occurred (if known)
	Timestamp time.Time `json:"ts,omitempty"`

	// Source identifies the origin of this entry
	Source string `json:"source,omitempty"` // "planning_history"

	// ToolName is the name of the tool called (for tool entries)
	ToolName string `json:"tool_name,omitempty"`

	// ToolInput is the input passed to the tool (for tool entries)
	ToolInput string `json:"tool_input,omitempty"`

	// ToolOutput is the output from the tool (for tool entries)
	ToolOutput string `json:"tool_output,omitempty"`

	// Summary is a brief summary of this entry (optional)
	Summary string `json:"summary,omitempty"`

	// IsPlan indicates this entry contains a plan or decision
	IsPlan bool `json:"is_plan,omitempty"`
}

type HistoryMeta struct {
	// SchemaVersion identifies the history format version
	SchemaVersion string `json:"schema_version"`

	// CapturedAt is when this history was captured
	CapturedAt time.Time `json:"captured_at"`

	// StartedAt is when the original conversation began (if known)
	StartedAt time.Time `json:"started_at,omitempty"`

	// Source identifies how this history was generated
	Source string `json:"source"` // "agent_reconstruction"

	// AgentID is the short agent ID (e.g., "Oxa7b3")
	AgentID string `json:"agent_id"`

	// SessionID is an alias for AgentID for compatibility
	SessionID string `json:"session_id,omitempty"`

	// AgentType identifies the AI agent (e.g., "claude-code", "cursor")
	AgentType string `json:"agent_type,omitempty"`

	// SessionTitle is a human-readable title for this session
	SessionTitle string `json:"session_title,omitempty"`

	// Username is the authenticated user who created this session
	Username string `json:"username,omitempty"`

	// MessageCount is the total number of entries captured
	MessageCount int `json:"message_count,omitempty"`

	// TimeRange is the time span of captured history
	TimeRange *HistoryTimeRange `json:"time_range,omitempty"`
}

type HistoryTimeRange struct {
	Earliest time.Time `json:"earliest"`
	Latest   time.Time `json:"latest"`
}

type HistoryValidationResult struct {
	Valid      bool     `json:"valid"`
	Errors     []string `json:"errors,omitempty"`
	EntryCount int      `json:"entry_count"`
	HasMeta    bool     `json:"has_meta"`
}

type MarkdownGenerator struct {
	// contains filtered or unexported fields
}

type MemoryStorage struct {
	// contains filtered or unexported fields
}

type NeedsSummaryInfo struct {
	CacheDir         string `json:"cache_dir"`
	RawPath          string `json:"raw_path"`
	LedgerSessionDir string `json:"ledger_session_dir"`
}

type ParsedRedactFile struct {
	Path   string
	Source RedactRuleSource
	Rules  []RedactRule
	Errors []RedactParseError
}

type PatternManifestEntry struct {
	Name   string `json:"name"`
	Regex  string `json:"regex"`
	Redact string `json:"redact"`
}

type PlanEntry struct {
	// Entry is the original session entry
	Entry SessionEntry

	// Marker indicates which plan marker was detected
	Marker PlanMarker

	// IsPlanFlag indicates whether the entry had is_plan:true metadata
	IsPlanFlag bool
}

type PlanMarker string

type QualityDisposition string

type RecordingState struct {
	AgentID          string    `json:"agent_id"`
	StartedAt        time.Time `json:"started_at"`
	AdapterName      string    `json:"adapter_name"`
	SessionFile      string    `json:"session_file"` // source file from adapter (Claude Code JSONL)
	OutputFile       string    `json:"output_file"`  // output file being recorded
	SessionPath      string    `json:"session_path"` // path to session folder
	Title            string    `json:"title,omitempty"`
	EntryCount       int       `json:"entry_count"`
	LastReminderSeq  int       `json:"last_reminder_seq"`
	ReminderInterval int       `json:"reminder_interval"`
	FilterMode       string    `json:"filter_mode,omitempty"`    // "infra" or "all" - controls event filtering
	WorkspacePath    string    `json:"workspace_path,omitempty"` // git root / project directory
	Branch           string    `json:"branch,omitempty"`         // git branch at recording start

	// Parent-child session tracking for subagent workflows
	// When a parent spawns subagents, each subagent can report its session
	// back to the parent session for aggregation.
	ParentSessionPath string `json:"parent_session_path,omitempty"` // path to parent's session folder
	ParentAgentID     string `json:"parent_agent_id,omitempty"`     // parent's agent ID (e.g., "Oxa7b3")

	AgentType      string `json:"agent_type,omitempty"`      // original agent type for metadata: "codex", "amp", etc. Falls back to AdapterName if empty.
	StopIncomplete bool   `json:"stop_incomplete,omitempty"` // set when stop returned retry guidance (empty file)
	Model          string `json:"model,omitempty"`           // LLM model for generic adapters where ReadMetadata returns nil
	ParentPID      int    `json:"parent_pid,omitempty"`      // parent agent process ID for liveness detection
	SourceOffset   int64  `json:"source_offset,omitempty"`   // byte offset in source file for incremental reading
	Origin         string `json:"origin,omitempty"`          // session origin: "human", "subagent", "agent" (from agentx.DetectOrigin)
}

type RedactParseError struct {
	Path    string
	Line    int
	Message string
}

type RedactRule struct {
	Type        string           // "literal" or "regex"
	RawPattern  string           // original text from the file
	Replacement string           // e.g. "[REDACTED_CODENAME]"
	Source      RedactRuleSource // team, repo, or user
	SourcePath  string           // absolute path to the REDACT.md file
	LineNumber  int              // line number in the source file
}

type RedactRuleSource string

type RedactSourceInfo struct {
	Source  RedactRuleSource
	Path    string // empty if file not found
	Rules   []RedactRule
	Errors  []RedactParseError
	IOError error // non-nil if file could not be read (permission denied, etc.)
}

type RedactionManifest struct {
	SchemaVersion string                 `json:"schema_version"`
	Patterns      []PatternManifestEntry `json:"patterns"`
}

type RedactionResult struct {
	PatternName string // which pattern matched
	Original    string // the original matched text (for logging, be careful with this)
	Position    int    // position in the string where match was found
}

type Redactor struct {
	// contains filtered or unexported fields
}

type SageoxInsight struct {
	Seq     int    `json:"seq"`     // message sequence number for navigation
	Topic   string `json:"topic"`   // domain/topic area (e.g., "react-patterns", "api-design")
	Insight string `json:"insight"` // what guidance was applied
	Impact  string `json:"impact"`  // the outcome or value it provided
}

type SecretPattern struct {
	Name    string           // identifier for the pattern
	Pattern *regexp.Regexp   // compiled regex
	Redact  string           // replacement text, e.g., "[REDACTED_AWS_KEY]"
	Source  RedactRuleSource // origin: builtin, team, repo, or user (zero = builtin)
}

type Session struct {
	// Meta is session context (first line in JSONL)
	Meta *SessionMeta `json:"_meta"`

	// Entries are conversation turns (stored as separate JSONL lines)
	Entries []SessionEntry `json:"-"`
}

type SessionEntry struct {
	// Timestamp is when this entry was recorded
	Timestamp time.Time `json:"ts"`

	// Type identifies the entry type (user, assistant, system, tool)
	Type SessionEntryType `json:"type"`

	// Content is the message or response content
	Content string `json:"content"`

	// ToolName is the name of the tool called (for tool entries)
	ToolName string `json:"tool_name,omitempty"`

	// ToolInput is the input passed to the tool (for tool entries)
	ToolInput string `json:"tool_input,omitempty"`

	// ToolOutput is the output from the tool (for tool entries)
	ToolOutput string `json:"tool_output,omitempty"`

	// CoworkerName identifies the coworker or subagent that contributed to this entry.
	// This includes both team coworkers (loaded via ox coworker load) and built-in
	// Claude Code subagents (invoked via Task tool, e.g., code-reviewer, debugger).
	CoworkerName string `json:"coworker_name,omitempty"`

	// CoworkerModel is the model tier used by the coworker (e.g., sonnet, opus, haiku).
	CoworkerModel string `json:"coworker_model,omitempty"`
}

type SessionEntryType string

type SessionError struct {
	Code      string `json:"code"`          // machine-readable error code (e.g., NOT_RECORDING)
	Message   string `json:"msg"`           // human-readable description
	Retryable bool   `json:"retry"`         // whether the operation can be retried
	Fix       string `json:"fix,omitempty"` // suggested fix command
}

type SessionFilterMode string

type SessionFooter struct {
	// EndedAt is when the recording session ended
	EndedAt time.Time `json:"ended_at"`

	// DurationMins is the total duration in minutes
	DurationMins int `json:"duration_minutes"`

	// EntryCount is the total number of entries recorded
	EntryCount int `json:"entry_count"`
}

type SessionGuidance struct {
	Include          []string `json:"include"`
	Exclude          []string `json:"exclude"`
	Tips             []string `json:"tips,omitempty"`
	ReminderInterval int      `json:"reminder_interval,omitempty"`

	// UserNotification is a message the agent should relay to the user.
	// This is separate from agent instructions - it's for human awareness.
	UserNotification string `json:"user_notification,omitempty"`
}

type SessionInfo struct {
	SessionName     string              `json:"session_name,omitempty"` // session folder name (empty for legacy)
	Filename        string              `json:"filename"`               // file name only
	FilePath        string              `json:"file_path"`              // full path to file
	Type            string              `json:"type"`                   // "raw" or "events"
	Size            int64               `json:"size"`
	CreatedAt       time.Time           `json:"created_at"`
	ModTime         time.Time           `json:"mod_time"`
	HydrationStatus lfs.HydrationStatus `json:"hydration_status,omitempty"` // hydrated/dehydrated/partial
	Username        string              `json:"username,omitempty"`         // from meta.json
	Summary         string              `json:"summary,omitempty"`          // from meta.json
	Recording       bool                `json:"recording,omitempty"`        // true if session is actively being recorded
	AgentID         string              `json:"agent_id,omitempty"`         // from .recording.json when recording
	EntryCount      int                 `json:"entry_count,omitempty"`      // from .recording.json or meta.json
	IsSubagent      bool                `json:"is_subagent,omitempty"`      // true if spawned by a parent session
	ParentPID       int                 `json:"parent_pid,omitempty"`       // from .recording.json for liveness detection
	Origin          string              `json:"origin,omitempty"`           // session origin: "human", "subagent", "agent"
	HasRawData      bool                `json:"has_raw_data,omitempty"`     // true if raw.jsonl exists with content on disk
	StopReason      string              `json:"stop_reason,omitempty"`      // how session ended: "stopped", "aborted", "recovered"
}

type SessionMeta struct {
	// OxVersion is the version of ox that created this session
	OxVersion string `json:"ox_version"`

	// OxUsername is the authenticated SageOx username (if logged in)
	OxUsername string `json:"ox_username,omitempty"`

	// UserID is the unique user identifier from auth (if logged in)
	UserID string `json:"user_id,omitempty"`

	// SchemaVersion identifies the session format version
	SchemaVersion string `json:"schema_version"`

	// AgentType identifies the AI agent (e.g., "claude-code", "cursor", "copilot")
	AgentType string `json:"agent_type"`

	// AgentVersion is the version of the AI agent (if known)
	AgentVersion string `json:"agent_version,omitempty"`

	// Model is the LLM model used (e.g., "claude-sonnet-4-20250514")
	Model string `json:"model,omitempty"`

	// SessionID is the short agent ID (e.g., "Oxa7b3")
	SessionID string `json:"session_id"`

	// OxSID is the full session ID (e.g., "oxsid_01JEYQ9Z8X...")
	OxSID string `json:"oxsid"`

	// StartedAt is when the recording session began
	StartedAt time.Time `json:"started_at"`

	// EndedAt is when the recording session ended (set on close)
	EndedAt time.Time `json:"ended_at,omitempty"`

	// ProjectRemote is the git remote URL for provenance tracking
	ProjectRemote string `json:"project_remote,omitempty"`
}

type SessionStatus string

type SessionWriter struct {
	// contains filtered or unexported fields
}

type StartGuidanceOptions struct {
	AutoStarted bool // true if session was auto-started by ox agent prime
}

type StartRecordingOptions struct {
	AgentID          string
	AdapterName      string
	SessionFile      string // source file from adapter (Claude Code JSONL)
	OutputFile       string // output file being recorded
	Title            string
	Username         string // username for session folder name
	RepoContextPath  string // path to repo context directory (for storing sessions)
	ReminderInterval int    // defaults to DefaultReminderInterval if 0
	FilterMode       string // "infra" or "all" - controls event filtering on stop
	WorkspacePath    string // git root / project directory
	Branch           string // git branch at recording start

	// Parent session tracking for subagent workflows
	ParentSessionPath string // path to parent's session folder (optional)
	ParentAgentID     string // parent's agent ID (optional)

	AgentType string // original agent type for metadata (e.g., "codex", "amp")
	Model     string // LLM model for generic adapters
	ParentPID int    // parent agent process ID for liveness detection
	Origin    string // session origin: "human", "subagent", "agent" (from agentx.DetectOrigin)
}

type Storage interface {
	// Save writes a complete session with metadata and entries.
	// The filename should include the .jsonl extension.
	// The sessionType should be "raw" or "events".
	Save(filename, sessionType string, meta *StoreMeta, entries []map[string]any) error

	// Load reads a session by filename.
	// Searches both raw and events directories for file-based storage.
	Load(filename string) (*StoredSession, error)

	// List returns all session infos, sorted by date descending.
	List() ([]SessionInfo, error)

	// Delete removes a session by filename.
	Delete(filename string) error

	// Exists checks if a session with the given filename exists.
	Exists(filename string) bool

	// GetLatest returns the most recent session info.
	GetLatest() (*SessionInfo, error)
}

type Store struct {
	// contains filtered or unexported fields
}

type StoreMeta struct {
	Version      string    `json:"version"`
	CreatedAt    time.Time `json:"created_at"`
	AgentID      string    `json:"agent_id,omitempty"`
	AgentType    string    `json:"agent_type,omitempty"`
	AgentVersion string    `json:"agent_version,omitempty"` // version of the coding agent (e.g., "1.0.3")
	Model        string    `json:"model,omitempty"`         // LLM model used (e.g., "claude-sonnet-4-20250514")
	Username     string    `json:"username,omitempty"`
	RepoID       string    `json:"repo_id,omitempty"`
	OxVersion    string    `json:"ox_version,omitempty"` // version of ox that created this session
}

type StoredSession struct {
	Info    SessionInfo      `json:"info"`
	Meta    *StoreMeta       `json:"metadata,omitempty"`
	Entries []map[string]any `json:"entries"`
	Footer  map[string]any   `json:"footer,omitempty"`
}

type SubagentCompleteOptions struct {
	// SubagentID is the completing subagent's agent ID
	SubagentID string

	// ParentSessionPath is the path to the parent's session folder
	ParentSessionPath string

	// SessionPath is the path to the subagent's session (optional)
	SessionPath string

	// SessionName is the subagent's session folder name (optional)
	SessionName string

	// Summary describes what the subagent accomplished (optional)
	Summary string

	// DurationMs is how long the subagent ran (optional)
	DurationMs int64

	// EntryCount is the number of session entries (optional)
	EntryCount int

	// Model is the LLM model used (optional)
	Model string

	// AgentType is the coding agent type (optional)
	AgentType string
}

type SubagentReference struct {
	// SessionID is the subagent's agent ID (e.g., "Oxa7b3")
	SessionID string `json:"session_id"`

	// SessionPath is the relative path to the subagent's session folder
	// Example: "sessions/2026-01-06T14-35-history-Oxdef/"
	SessionPath string `json:"session_path"`

	// EntryCount is the number of entries in the subagent's session
	EntryCount int `json:"entry_count"`

	// DurationMs is how long the subagent ran in milliseconds (optional)
	DurationMs int64 `json:"duration_ms,omitempty"`

	// Summary is a brief description of what the subagent did (optional)
	Summary string `json:"summary,omitempty"`

	// Model is the LLM model the subagent used (optional)
	Model string `json:"model,omitempty"`

	// AgentType is the coding agent type (optional)
	AgentType string `json:"agent_type,omitempty"`
}

type SubagentRegistry struct {
	// contains filtered or unexported fields
}

type SubagentSession struct {
	// SubagentID is the subagent's agent ID (e.g., "Oxa7b3")
	SubagentID string `json:"subagent_id"`

	// ParentSessionID is the parent's session ID
	ParentSessionID string `json:"parent_session_id"`

	// SessionPath is the path to the subagent's raw session
	SessionPath string `json:"session_path,omitempty"`

	// SessionName is the subagent's session folder name
	SessionName string `json:"session_name,omitempty"`

	// CompletedAt is when the subagent finished
	CompletedAt time.Time `json:"completed_at"`

	// EntryCount is the number of entries in the subagent session
	EntryCount int `json:"entry_count,omitempty"`

	// Summary is a brief description of what the subagent did
	Summary string `json:"summary,omitempty"`

	// DurationMs is how long the subagent ran in milliseconds
	DurationMs int64 `json:"duration_ms,omitempty"`

	// Model is the LLM model the subagent used
	Model string `json:"model,omitempty"`

	// AgentType is the coding agent type (claude-code, cursor, etc.)
	AgentType string `json:"agent_type,omitempty"`
}

type SubagentSummary struct {
	// Count is the number of subagents that completed
	Count int `json:"count"`

	// TotalEntries is the sum of all subagent session entries
	TotalEntries int `json:"total_entries"`

	// TotalDurationMs is the sum of all subagent durations
	TotalDurationMs int64 `json:"total_duration_ms"`

	// Subagents is the list of subagent references
	Subagents []*SubagentSession `json:"subagents,omitempty"`
}

type SummarizeEntry struct {
	Type      string `json:"type"`
	Content   string `json:"content"`
	ToolName  string `json:"tool_name,omitempty"`
	Timestamp string `json:"timestamp,omitempty"`
}

type SummarizeGuidance struct {
	Instructions   []string        `json:"instructions"`
	Format         string          `json:"format"`
	SavePath       string          `json:"save_path"`
	LedgerPath     string          `json:"ledger_path"`
	DelegationHint *DelegationHint `json:"delegation_hint,omitempty"`
}

type SummarizeGuidanceOutput struct {
	Success  bool              `json:"success"`
	Type     string            `json:"type"` // always "session_summarize_guidance"
	AgentID  string            `json:"agent_id"`
	Guidance SummarizeGuidance `json:"guidance"`
	Summary  *SummarizeOutput  `json:"summary,omitempty"`
}

type SummarizeOutput struct {
	Success       bool     `json:"success"`
	Type          string   `json:"type"` // always "session_summary"
	AgentID       string   `json:"agent_id"`
	Summary       string   `json:"summary"`
	KeyActions    []string `json:"key_actions,omitempty"`
	Outcome       string   `json:"outcome,omitempty"`
	TopicsFound   []string `json:"topics_found,omitempty"`
	FinalPlan     string   `json:"final_plan,omitempty"` // final plan/architecture from session
	Diagrams      []string `json:"diagrams,omitempty"`   // extracted mermaid diagrams
	EntryCount    int      `json:"entry_count,omitempty"`
	FilePath      string   `json:"file_path,omitempty"`
	Message       string   `json:"message,omitempty"`
	SummaryPrompt string   `json:"summary_prompt,omitempty"` // prompt for calling agent to generate summary
}

type SummarizeRequest struct {
	AgentID   string           `json:"agent_id"`
	AgentType string           `json:"agent_type"`
	Model     string           `json:"model,omitempty"`
	Entries   []SummarizeEntry `json:"entries"`
}

type SummarizeResponse struct {
	Title          string           `json:"title"`                     // short descriptive title for the session
	Summary        string           `json:"summary"`                   // one paragraph executive summary
	KeyActions     []string         `json:"key_actions"`               // bullet points of key actions taken
	Outcome        string           `json:"outcome"`                   // success/partial/failed
	TopicsFound    []string         `json:"topics_found"`              // topics detected during session
	FinalPlan      string           `json:"final_plan,omitempty"`      // final plan/architecture from session
	Diagrams       []string         `json:"diagrams,omitempty"`        // extracted mermaid diagrams
	ChapterTitles  []string         `json:"chapter_titles,omitempty"`  // LLM-generated narrative chapter titles
	Chapters       []ChapterSummary `json:"chapters,omitempty"`        // structured chapter data (computed from JSONL)
	FilesChanged   []FileSummary    `json:"files_changed,omitempty"`   // files modified during session (computed from JSONL)
	AhaMoments     []AhaMoment      `json:"aha_moments,omitempty"`     // pivotal moments of collaborative intelligence
	SageoxInsights []SageoxInsight  `json:"sageox_insights,omitempty"` // moments where SageOx guidance provided value
	QualityScore   float64          `json:"quality_score"`             // 0.0-1.0 session value for team sharing
	ScoreReason    string           `json:"score_reason,omitempty"`    // brief explanation of the quality score
}

type SummaryMarkdownGenerator struct{}

type SummaryView struct {
	Text        string   // one paragraph executive summary
	KeyActions  []string // bullet points of key actions taken
	Outcome     string   // success/partial/failed
	TopicsFound []string // topics detected during session
	FinalPlan   string   // final plan/architecture from session
	Diagrams    []string // extracted mermaid diagrams
}

type TaskInput struct {
	// Description is the task description/prompt
	Description string `json:"description,omitempty"`

	// Prompt is an alternative field name for description
	Prompt string `json:"prompt,omitempty"`

	// AgentType hints at what kind of subagent to spawn
	AgentType string `json:"agent_type,omitempty"`
}

type TaskToolCallInfo struct {
	// EntryIndex is the index of this entry in the session
	EntryIndex int

	// Timestamp is when the Task tool was called
	Timestamp time.Time

	// ToolInput is the raw tool input (the task prompt)
	ToolInput string

	// ToolOutput is the raw tool output (the task result)
	ToolOutput string

	// ParsedInput contains structured task input if parseable
	ParsedInput *TaskInput
}

type Writable interface {
	// EntryType returns the type identifier for this entry (e.g., "message", "tool_call")
	EntryType() string
}