workspace

type Agent struct {
	Type        AgentType // claude, codex, aider, gemini
	TmuxSession string    // tmux session name
	TmuxPane    string    // Pane identifier (e.g., "%12" - globally unique)
	PID         int       // Process ID (if available)
	StartedAt   time.Time
	LastOutput  time.Time     // Last time output was detected
	OutputBuf   *OutputBuffer // Last N lines of output
	Status      AgentStatus
	WaitingFor  string // Prompt text if waiting

	// Runaway detection fields (td-018f25)
	// Track recent poll times to detect continuous output that would cause CPU spikes.
	RecentPollTimes    []time.Time // Last N poll times for runaway detection
	PollsThrottled     bool        // True if this agent is throttled due to continuous output
	UnchangedPollCount int         // Consecutive unchanged polls (for throttle reset)
}

type AgentOutputMsg struct {
	WorkspaceName string
	Output        string
	Status        WorktreeStatus
	WaitingFor    string
	// Cursor position captured atomically with output (only set in interactive mode)
	CursorRow     int
	CursorCol     int
	CursorVisible bool
	HasCursor     bool // True if cursor position was captured
	PaneHeight    int  // Tmux pane height for cursor offset calculation
	PaneWidth     int  // Tmux pane width for display alignment
}

type AgentPollUnchangedMsg struct {
	WorkspaceName string
	CurrentStatus WorktreeStatus // Status including session file re-check
	WaitingFor    string         // Prompt text if waiting
	// Cursor position captured atomically (even when content unchanged)
	CursorRow     int
	CursorCol     int
	CursorVisible bool
	HasCursor     bool
	PaneHeight    int // Tmux pane height for cursor offset calculation
	PaneWidth     int // Tmux pane width for display alignment
}

type AgentStartedMsg struct {
	Epoch         uint64 // Epoch when request was issued (for stale detection)
	WorkspaceName string
	SessionName   string
	PaneID        string // tmux pane ID (e.g., "%12") for interactive mode
	AgentType     AgentType
	Reconnected   bool // True if we reconnected to an existing session
	Err           error
}

type AgentStatus int

type AgentStoppedMsg struct {
	WorkspaceName string
	Err           error
}

type AgentType string

type ApproveResultMsg struct {
	WorkspaceName string
	Err           error
}

type AsyncCaptureResultMsg struct {
	WorkspaceName string // Worktree this capture is for
	SessionName   string // tmux session name
	Output        string // Captured output (empty on error)
	Err           error  // Non-nil if capture failed
}

type AsyncShellCaptureResultMsg struct {
	TmuxName string // Shell session tmux name
	Output   string // Captured output (empty on error)
	Err      error  // Non-nil if capture failed
}

type BranchListMsg struct {
	Branches []string
	Err      error
}

type CheckPRMergedMsg struct {
	WorkspaceName string
	Merged        bool
	Err           error
}

type CleanupDoneMsg struct {
	WorkspaceName string
	Results       *CleanupResults
}

type CleanupResults struct {
	LocalWorktreeDeleted bool
	LocalBranchDeleted   bool
	RemoteBranchDeleted  bool
	PullAttempted        bool
	PullSuccess          bool
	PullError            error
	Errors               []string

	// Error detail expansion state (for UX improvements)
	ShowErrorDetails bool   // Toggle for expanded error view
	PullErrorSummary string // Concise 1-line summary
	PullErrorFull    string // Full git output for details view
	BranchDiverged   bool   // Enables rebase/merge resolution actions
	BaseBranch       string // Branch name for resolution commands
}

type CommitStatusInfo struct {
	Hash    string // Short commit hash
	Subject string // Commit subject line
	Pushed  bool   // Is commit pushed to remote?
	Merged  bool   // Is commit merged to base branch?
}

type CommitStatusLoadedMsg struct {
	Epoch         uint64 // Epoch when request was issued (for stale detection)
	WorkspaceName string
	Commits       []CommitStatusInfo
	Err           error
}

type Conflict struct {
	Worktrees []string // Names of worktrees with conflicting changes
	Files     []string // List of conflicting files
}

type ConflictsDetectedMsg struct {
	Conflicts []Conflict
	Err       error
}

type CreateDoneMsg struct {
	Worktree  *Worktree
	AgentType AgentType // Agent selected at creation
	SkipPerms bool      // Whether to skip permissions
	Prompt    *Prompt   // Selected prompt template (nil if none)
	Err       error
}

type CreateWorktreeMsg struct {
	Name       string
	BaseBranch string
	TaskID     string
}

type DeleteDoneMsg struct {
	Name     string
	Err      error
	Warnings []string // Non-fatal warnings (e.g., branch deletion failures)
}

type DeleteWorktreeMsg struct {
	Name  string
	Force bool
}

type DiffErrorMsg struct {
	WorkspaceName string
	Err           error
}

type DiffLoadedMsg struct {
	Epoch         uint64 // Epoch when request was issued (for stale detection)
	WorkspaceName string
	Content       string
	Raw           string
}

type DiffViewMode int

type DirectMergeDoneMsg struct {
	WorkspaceName string
	BaseBranch    string
	Err           error
}

type FetchPRDoneMsg struct {
	Worktree     *Worktree
	AlreadyLocal bool   // branch already existed locally
	Branch       string // for finding existing worktree when Worktree is nil
	Err          error
}

type FetchPRListMsg struct {
	PRs []PRListItem
	Err error
}

type FocusPane int

type GitStats struct {
	Additions    int
	Deletions    int
	FilesChanged int
	Ahead        int // Commits ahead of base branch
	Behind       int // Commits behind base branch
}

type InteractivePasteResultMsg struct {
	Err         error
	Empty       bool
	SessionDead bool
}

type InteractiveSessionDeadMsg struct{}

type InteractiveState struct {
	// Active indicates whether interactive mode is currently active.
	Active bool

	// TargetPane is the tmux pane ID (e.g., "%12") receiving input.
	TargetPane string

	// TargetSession is the tmux session name for the active pane.
	TargetSession string

	// LastKeyTime tracks when the last key was sent for polling decay.
	LastKeyTime time.Time

	// EscapePressed tracks if a single Escape was recently pressed
	// (for double-escape exit detection with 150ms delay).
	EscapePressed bool

	// EscapeTime is when the first Escape was pressed.
	EscapeTime time.Time

	// CursorRow and CursorCol track the cached cursor position for overlay rendering.
	// Updated asynchronously via cursorPositionMsg from poll handler (td-648af4).
	CursorRow int
	CursorCol int

	// CursorVisible indicates if the cursor should be rendered.
	// Updated asynchronously via cursorPositionMsg from poll handler (td-648af4).
	CursorVisible bool

	// PaneHeight tracks the tmux pane height for cursor offset calculation.
	// Used to adjust cursor_y when display height differs from pane height.
	PaneHeight int

	// PaneWidth tracks the tmux pane width for display width alignment.
	PaneWidth int

	// VisibleStart and VisibleEnd track the buffer line range currently visible.
	// Used for interactive selection mapping.
	VisibleStart int
	VisibleEnd   int

	// ContentRowOffset is the number of preview content rows before output lines.
	// Used to map mouse coordinates to buffer lines.
	ContentRowOffset int

	// BracketedPasteEnabled tracks whether the target app has enabled
	// bracketed paste mode (ESC[?2004h). Updated from captured output.
	BracketedPasteEnabled bool

	// MouseReportingEnabled tracks whether the target app has enabled
	// mouse reporting (1000/1002/1003/1006/1015). Updated from captured output.
	MouseReportingEnabled bool

	// EscapeTimerPending tracks if an escape timer is already in flight.
	// Prevents duplicate timers from accumulating (td-83dc22).
	EscapeTimerPending bool

	// LastResizeAt tracks the last time we attempted to resize the tmux pane.
	LastResizeAt time.Time
}

type LocalBranchesMsg struct {
	Branches []string
	Err      error
}

type MergeCommitDoneMsg struct {
	WorkspaceName string
	CommitHash    string
	Err           error
}

type MergeCommitState struct {
	Worktree       *Worktree
	StagedCount    int
	ModifiedCount  int
	UntrackedCount int
	CommitMessage  string
	Error          string
}

type MergeResolutionMsg struct {
	WorkspaceName string
	Branch        string
	Success       bool
	Err           error
}

type MergeStepCompleteMsg struct {
	WorkspaceName   string
	Step            MergeWorkflowStep
	Data            string // Step-specific data (e.g., PR URL)
	Err             error
	ExistingPRFound bool // True if PR already existed (vs newly created)
}

type MergeWorkflowState struct {
	Worktree         *Worktree
	Step             MergeWorkflowStep
	DiffSummary      string
	PRTitle          string
	PRBody           string
	PRURL            string
	ExistingPR       bool // True if using an existing PR (vs newly created)
	Error            error
	ErrorTitle       string                       // Short title for error display (e.g. "Direct Merge Failed")
	ErrorDetail      string                       // Full error text for display and clipboard copy
	ErrorFromStep    MergeWorkflowStep            // Which step produced the error
	StepStatus       map[MergeWorkflowStep]string // "pending", "running", "done", "error", "skipped"
	DeleteAfterMerge bool                         // true = delete worktree after merge (default)

	// Target branch selection
	TargetBranch       string   // Resolved target branch for merge/PR
	TargetBranchOption int      // Selected index in branch list
	TargetBranches     []string // Available branches for selection

	// Merge method selection
	UseDirectMerge    bool // true = direct merge to base, false = PR workflow
	MergeMethodOption int  // 0 = Create PR (default), 1 = Direct merge

	// Post-merge confirmation options
	DeleteLocalWorktree bool   // Checkbox: delete local worktree (default: true)
	DeleteLocalBranch   bool   // Checkbox: delete local branch (default: true)
	DeleteRemoteBranch  bool   // Checkbox: delete remote branch (default: false)
	PullAfterMerge      bool   // Checkbox: pull changes to current branch after merge
	CurrentBranch       string // Branch user was on before merge (for pull)
	ConfirmationFocus   int    // 0-3=checkboxes, 4=confirm btn, 5=skip btn
	ConfirmationHover   int    // Mouse hover state

	// Cleanup results for summary display
	CleanupResults    *CleanupResults
	PendingCleanupOps int // Counter for parallel cleanup operations in flight
}

type MergeWorkflowStep int

type OpenCreateModalWithTaskMsg struct {
	TaskID    string
	TaskTitle string
}

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

type PRListItem struct {
	Number    int      `json:"number"`
	Title     string   `json:"title"`
	Branch    string   `json:"headRefName"`
	Author    prAuthor `json:"author"`
	URL       string   `json:"url"`
	CreatedAt string   `json:"createdAt"`
	IsDraft   bool     `json:"isDraft"`
}

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

type PreviewTab int

type Prompt struct {
	Name       string     `json:"name"`
	TicketMode TicketMode `json:"ticketMode"`
	Body       string     `json:"body"`
	Source     string     `json:"-"` // "global" or "project" (set at load time)
}

type PromptCancelledMsg struct{}

type PromptInstallDefaultsMsg struct{}

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

type PromptSelectedMsg struct {
	Prompt *Prompt // nil means "none" was selected
}

type PullAfterMergeMsg struct {
	WorkspaceName string
	Branch        string
	Success       bool
	Err           error
}

type PushDoneMsg struct {
	WorkspaceName string
	Err           error
}

type PushMsg struct {
	WorkspaceName string
	Force         bool
	SetUpstream   bool
}

type RebaseResolutionMsg struct {
	WorkspaceName string
	Branch        string
	Success       bool
	Err           error
}

type RefreshDoneMsg struct {
	Epoch     uint64 // Epoch when request was issued (for stale detection)
	Worktrees []*Worktree
	Err       error
}

type RefreshMsg struct{}

type RejectResultMsg struct {
	WorkspaceName string
	Err           error
}

type RemoteBranchDeleteMsg struct {
	WorkspaceName string
	BranchName    string
	Err           error
}

type RemoteCheckDoneMsg struct {
	WorkspaceName string
	Branch        string
	Exists        bool
}

type RenameShellDoneMsg struct {
	TmuxName string // Session name (stable identifier)
	NewName  string // New display name
	Err      error  // Non-nil if rename failed
}

type ResumeConversationMsg struct {
	SessionID string // Adapter session ID for resume command
	AdapterID string // Adapter type (claude-code, codex, etc.)
	ResumeCmd string // Full resume command (e.g., "claude --resume xyz")
	Type      string // "shell" or "worktree"
	// Worktree-specific fields (only used when Type == "worktree")
	WorktreeName string    // Branch name for new worktree
	BaseBranch   string    // Base branch to create from
	AgentType    AgentType // Agent to start (matches adapter or user selection)
	SkipPerms    bool      // Whether to auto-approve agent actions
}

type SendTextResultMsg struct {
	WorkspaceName string
	Text          string
	Err           error
}

type SetupConfig struct {
	CopyEnv        bool     // Whether to copy env files (default: true)
	EnvFiles       []string // List of env files to copy
	SymlinkDirs    []string // Directories to symlink (default: empty, opt-in)
	RunSetupScript bool     // Whether to run .worktree-setup.sh (default: true)
}

type ShellAgentErrorMsg struct {
	TmuxName string // Shell's tmux session name
	Err      error  // Error that occurred
}

type ShellAgentStartedMsg struct {
	TmuxName  string    // Shell's tmux session name
	AgentType AgentType // Agent type that was started
	SkipPerms bool      // Whether skip permissions was enabled
}

type ShellCreatedMsg struct {
	SessionName string    // tmux session name
	DisplayName string    // Display name (e.g., "Shell 1")
	PaneID      string    // tmux pane ID (e.g., "%12") for interactive mode
	Err         error     // Non-nil if creation failed
	AgentType   AgentType // td-16b2b5: Agent to start (AgentNone if plain shell)
	SkipPerms   bool      // td-16b2b5: Whether to skip permissions for agent
}

type ShellDefinition struct {
	TmuxName    string    `json:"tmuxName"`
	DisplayName string    `json:"displayName"`
	CreatedAt   time.Time `json:"createdAt"`
	AgentType   string    `json:"agentType,omitempty"`
	SkipPerms   bool      `json:"skipPerms,omitempty"`
}

type ShellDetachedMsg struct {
	Err error
}

type ShellKilledMsg struct {
	SessionName string // tmux session name that was killed
}

type ShellManifest struct {
	Version int               `json:"version"`
	Shells  []ShellDefinition `json:"shells"`
	// contains filtered or unexported fields
}

type ShellManifestChangedMsg struct{}

type ShellOutputMsg struct {
	TmuxName string // Session name (stable identifier)
	Output   string
	Changed  bool
	// Cursor position captured atomically with output (only set in interactive mode)
	CursorRow     int
	CursorCol     int
	CursorVisible bool
	HasCursor     bool // True if cursor position was captured
	PaneHeight    int  // Tmux pane height for cursor offset calculation
	PaneWidth     int  // Tmux pane width for display alignment
}

type ShellSession struct {
	Name        string // Display name (e.g., "Shell 1")
	TmuxName    string // tmux session name (e.g., "sidecar-sh-project-1")
	Agent       *Agent // Reuses Agent struct for tmux state
	CreatedAt   time.Time
	ChosenAgent AgentType // td-317b64: Agent type selected at creation (AgentNone for plain shell)
	SkipPerms   bool      // td-317b64: Whether skip permissions was enabled
	IsOrphaned  bool      // td-f88fdd: True if manifest entry exists but tmux session is gone
}

type ShellSessionDeadMsg struct {
	TmuxName string // Session name for cleanup (stable identifier)
}

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

type StatsErrorMsg struct {
	WorkspaceName string
	Err           error
}

type StatsLoadedMsg struct {
	Epoch         uint64 // Epoch when request was issued (for stale detection)
	WorkspaceName string
	Stats         *GitStats
}

type Task struct {
	ID          string
	Title       string
	Status      string
	Description string
	EpicTitle   string // Parent epic title for search
}

type TaskDetails struct {
	ID          string
	Title       string
	Status      string
	Priority    string
	Type        string
	Description string
	Acceptance  string
	CreatedAt   string
	UpdatedAt   string
}

type TaskDetailsLoadedMsg struct {
	TaskID  string
	Details *TaskDetails
	Err     error
}

type TaskLinkedMsg struct {
	WorkspaceName string
	TaskID        string
	Err           error
}

type TaskSearchResultsMsg struct {
	Tasks []Task
	Err   error
}

type TicketMode string

type TmuxAttachFinishedMsg struct {
	WorkspaceName string
	Err           error
}

type UncommittedChangesCheckMsg struct {
	WorkspaceName  string
	HasChanges     bool
	StagedCount    int
	ModifiedCount  int
	UntrackedCount int
	Err            error
}

type ViewMode int

type WatchEventMsg struct {
	Path string
}

type WatcherErrorMsg struct {
	Err error
}

type WatcherStartedMsg struct{}

type WorkDirDeletedMsg struct {
	MainWorktreePath string
}

type Worktree struct {
	Name            string         // e.g., "auth-oauth-flow"
	Path            string         // Absolute path
	Branch          string         // Git branch name
	BaseBranch      string         // Branch worktree was created from
	TaskID          string         // Linked td task (e.g., "td-a1b2")
	TaskTitle       string         // Task title (used as fallback if td show fails)
	PRURL           string         // URL of open PR (if any)
	ChosenAgentType AgentType      // Agent selected at creation (persists even when agent not running)
	Agent           *Agent         // nil if no agent running
	Status          WorktreeStatus // Derived from agent state
	Stats           *GitStats      // +/- line counts
	CreatedAt       time.Time
	UpdatedAt       time.Time
	IsOrphaned      bool // True if agent file exists but tmux session is gone
	IsMain          bool // True if this is the primary/main worktree (project root)
	IsMissing       bool // True if worktree directory no longer exists (detected via os.Stat or git prunable)
}

type WorktreeStatus int