sidebar

type AgentInfoMode int

type AgentSwitchResult struct {
	Cmd      tea.Cmd
	Timers   []TransferTimer
	Accepted bool
}

type ClickResult int

type CollapsedViewModel struct {
	TitleWithStar    string
	WorkingIndicator string
	WorkingDir       string
	UsageSummary     string
	// InfoLine is the compact agents/tools/todos summary shown when the
	// sidebar renders as a horizontal band.
	InfoLine string

	// Layout decisions computed from the data
	TitleAndIndicatorOnOneLine bool
	WdAndUsageOnOneLine        bool
	ContentWidth               int
}

type LayoutConfig struct {
	// PaddingLeft is the space between the left edge of the sidebar and content.
	// This replaces the external wrapper padding that was previously in chat.go.
	PaddingLeft int
	// PaddingRight is the space between the content and the right edge (when no scrollbar).
	PaddingRight int
	// ScrollbarGap is the space between content and the scrollbar when visible.
	ScrollbarGap int
}

type Metrics struct {
	// OuterWidth is the total width allocated to the sidebar.
	OuterWidth int
	// ContentWidth is the width available for actual content (tabs, text, etc.).
	ContentWidth int
	// ScrollbarVisible indicates whether the scrollbar will be rendered.
	ScrollbarVisible bool
	// contains filtered or unexported fields
}

type Mode int

type Model interface {
	layout.Model
	layout.Sizeable
	layout.Positionable

	SetTokenUsage(event *runtime.TokenUsageEvent)
	SetTodos(result *tools.ToolCallResult) error
	SetMode(mode Mode)
	// SetMirroredPadding swaps the horizontal edge padding so the sidebar hugs
	// the terminal edge when rendered on the left of the chat.
	SetMirroredPadding(mirrored bool)
	SetAgentInfo(agentName, model, description string, contextLimit int64, compactionModel string, primaryContextLimit int64) tea.Cmd
	SetTeamInfo(availableAgents []runtime.AgentDetails)
	// SetAgentSwitching records the start (switching=true) or end of a
	// transfer_task hop between fromAgent and toAgent. Stops carry the
	// inverse pair of their start (start A→B is closed by stop B→A) and are
	// only accepted when that exact hop is live. A start presents the
	// outbound transfer box for a bounded window (≥ ~1.5s, until the
	// destination's first useful activity, ≤ ~3s); an accepted stop replaces
	// it with a transient child→parent Return box shown for up to ~1.5s —
	// it may disappear earlier when the enclosing turn/stream ends, since
	// the outermost StreamStopped intentionally clears any leftover
	// presentation. Callers must dispatch the result's Cmd and schedule its
	// Timers (see AgentSwitchResult).
	SetAgentSwitching(switching bool, fromAgent, toAgent string) AgentSwitchResult
	// SetAgentActivity records the first useful activity (reasoning, content
	// or a tool call) attributed to agentName, acknowledging the outbound
	// transfer box of the innermost hop targeting that agent.
	SetAgentActivity(agentName string) tea.Cmd
	SetToolsetInfo(availableTools int, loading bool)
	SetSkillsInfo(availableSkills int)
	SetSessionStarred(starred bool)
	SetQueuedMessages(messages ...string)
	// SetSectionVisibility controls which optional sidebar sections are rendered.
	SetSectionVisibility(v SectionVisibility)
	// SetSectionGap sets the number of blank lines between sidebar sections.
	SetSectionGap(lines int)
	// SetAgentInfoMode selects how the vertical Agents section renders each
	// agent: the compact two-line roster (default) or detailed mini-cards.
	SetAgentInfoMode(mode AgentInfoMode)
	// SetActiveAgentsOnly filters the Agents roster (vertical panel and
	// collapsed band) to agents active in the current session instead of the
	// whole configured team.
	SetActiveAgentsOnly(enabled bool)
	GetSize() (width, height int)
	LoadFromSession(sess *session.Session)
	// ResetStreamTracking clears the active-stream stack so a new top-level run
	// starts from a clean slate, even if a previous run's stream events were
	// left unbalanced (e.g. cancelled without a StreamCancelledMsg).
	ResetStreamTracking()
	// HandleClick checks if click is on the star or title and returns true if handled
	HandleClick(x, y int) bool
	// HandleClickType returns the type of click (see ClickResult).
	// For ClickAgent, the second return value is the agent name.
	HandleClickType(x, y int) (ClickResult, string)
	// IsCollapsed returns whether the sidebar is collapsed
	IsCollapsed() bool
	// ToggleCollapsed toggles the collapsed state
	ToggleCollapsed()
	// SetCollapsed sets the collapsed state directly
	SetCollapsed(collapsed bool)
	// CollapsedHeight returns the number of lines needed for collapsed mode
	CollapsedHeight(contentWidth int) int
	// GetPreferredWidth returns the user's preferred width (for resize persistence)
	GetPreferredWidth() int
	// SetPreferredWidth sets the user's preferred width
	SetPreferredWidth(width int)
	// ClampWidth ensures width is within valid bounds for the given window width
	ClampWidth(width, windowInnerWidth int) int
	// HandleTitleClick handles a click on the title area and returns true if
	// edit mode should start (on double-click)
	HandleTitleClick() bool
	// BeginTitleEdit starts inline editing of the session title
	BeginTitleEdit()
	// IsEditingTitle returns true if the title is being edited
	IsEditingTitle() bool
	// CommitTitleEdit commits the current title edit and returns the new title
	CommitTitleEdit() string
	// CancelTitleEdit cancels the current title edit
	CancelTitleEdit()
	// UpdateTitleInput passes a key message to the title input
	UpdateTitleInput(msg tea.Msg) tea.Cmd
	// SetTitleRegenerating sets the title regeneration state and returns a command to start/stop spinner
	SetTitleRegenerating(regenerating bool) tea.Cmd
	// IsScrollbarDragging returns true when the scrollbar thumb is being dragged.
	IsScrollbarDragging() bool
	// VisualGeneration increments whenever an update changes rendered sidebar state.
	VisualGeneration() uint64
	// WorkingDirectory returns the working directory path displayed in the sidebar.
	WorkingDirectory() string
}

type SectionVisibility struct {
	HideSessionPath bool
	HideUsage       bool
	HideAgents      bool
	HideTools       bool
	HideTodos       bool
}

type TransferTimer struct {
	Duration time.Duration
	Msg      tea.Msg
}