tui

type AgentEventMsg struct {
	Event agentcore.Event
}

type AskUserMsg struct {
	Questions []tools.Question
	RespCh    chan<- *tools.AskUserResponse
}

type BtwResultMsg struct {
	Answer string
	Err    error
}

type CommandResultMsg struct {
	Text     string
	Quit     bool   // true for /exit
	Clear    bool   // true for /clear
	NewModel string // non-empty if model was switched
}

type CompletionItem struct {
	Name        string // command name without "/" (e.g. "model")
	Description string
	Usage       string
	Kind        string
	Category    string
	NeedsIdle   bool
	Source      string
	Aliases     []string
	AutoExecute bool
}

type Config struct {
	Placeholder      string
	Version          string
	Cwd              string
	GitBranch        string
	EnvHint          string                   // shown below welcome when using env var credentials
	History          *storage.History         // input history (Up/Down navigation)
	RestoredMessages []agentcore.AgentMessage // messages restored from a previous session (rendered on Init)
	OnKey            func(m *Model, msg tea.KeyMsg) (handled bool, cmd tea.Cmd)
	OnEvent          func(m *Model, ev agentcore.Event) tea.Cmd
	OnPaste          func(m *Model) tea.Cmd              // Ctrl+V: read clipboard image, return ImageAttachedMsg
	OnDrop           func(m *Model, text string) tea.Cmd // Drag-drop: if text is image path, return cmd; else nil
	OnMCPReady       func(msg MCPReadyMsg)               // called when MCP servers finish connecting
	StatusRight      func(m *Model) string
	StatusMode       func(m *Model) string // mode indicator for context bar (e.g. "⏵⏵ trust")
	StatusPlan       func(m *Model) *PlanBarInfo
	Overlay          func(m *Model) *OverlayState         // interactive command overlay
	Completions      func(prefix string) []CompletionItem // slash command completions
	OnBtwResult      func(msg BtwResultMsg)               // called when /btw side question completes
}

type Driver interface {
	Prompt(text string) error
	PromptWithBlocks(blocks []agentcore.ContentBlock) error
	Steer(text string)
	Abort()
}

type ImageAttachedMsg struct {
	Block agentcore.ContentBlock // pre-built ImageBlock (base64 + mime)
}

type MCPReadyMsg struct {
	Tools        int      // total number of tools loaded across all servers
	Errors       []string // connection errors (server: reason)
	Instructions string   // MCP server instructions to set as system suffix
}

type Model struct {
	Driver    Driver
	ModelName string
	Version   string

	Input   textarea.Model
	Spinner spinner.Model

	ToolSpinner spinner.Model // breathing-dot spinner for tool execution

	Streaming *strings.Builder
	Thinking  *strings.Builder
	IsStream  bool

	Running         bool
	TurnCount       int
	PendingTools    map[string]string           // toolID -> tool name
	ToolHeaders     map[string]string           // toolID -> formatted header (printed at end)
	ToolOutputBuf   map[string]*strings.Builder // toolID -> streaming output
	ToolDeltaBuf    map[string]*strings.Builder // toolID -> accumulated subagent delta text
	ToolThinkingBuf map[string]*strings.Builder // toolID -> accumulated subagent thinking text

	Width  int
	Height int
	Ready  bool

	Cwd         string
	GitBranch   string
	ShowWelcome bool
	EnvHint     string // env var hint shown below welcome
	ShowSummary bool
	RunStats    runStats
	Images      []agentcore.ContentBlock // attached images (from Ctrl+V clipboard paste)
	ImageCursor int                      // -1 = not selecting; 0+ = selected image index
	Pasting     int                      // number of async image reads in progress (clipboard paste or drag-drop)

	Markdown *markdown.Renderer

	AskUser    *askUserState    // non-nil when ask-user UI is active
	Permission *permissionState // non-nil when permission prompt is active

	Tasks *tools.TaskSnapshot // non-nil when tasks exist; displayed above input

	QueuedMsgs []string // messages queued while agent is running (display only)

	MCPLoading bool // true while MCP servers are connecting in background

	Suggestion string // prompt suggestion shown as placeholder after agent completes

	QuitPending bool // true after first Ctrl+C, waiting for second to quit
	// contains filtered or unexported fields
}

type OverlayState struct {
	HandleKey     func(msg tea.KeyMsg) (handled bool, cmd tea.Cmd)
	View          func(width int) string
	ReplacesInput bool // when true, overlay replaces the input area instead of appearing below it
}

type PasteErrorMsg struct {
	Text string
}

type PasteTextMsg struct{}

type PermissionDismissMsg struct{}

type PermissionMsg struct {
	Tool         string
	Command      string
	Reason       string
	Preview      string
	OutsideRoots bool // when true, only AllowOnce and Deny are shown
	RespCh       chan<- PermitChoice
}

type PermitChoice int

type PlanBarInfo struct {
	Tag     string   // appended to status bar (e.g., "plan mode")
	Choices []string // selectable options
	Active  int      // active choice index

	// Plan review card fields.
	Prompt    string // e.g., "Would you like to proceed?"
	OtherMode bool   // typing custom feedback
	OtherBuf  string // custom feedback buffer
}

type PromptMsg struct {
	Text string
}

type RestoreMsg struct{ Msgs []agentcore.AgentMessage }

type SuggestionMsg struct {
	Text string
}

type TaskListUpdateMsg struct {
	Snapshot tools.TaskSnapshot
}

type TasksRefreshMsg struct{}