chat

type ChatMode int //nolint:revive // ChatMode is clearer than Mode given existing ModeRef type in this package.

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

type CommandBuilder func(args map[string]any) string

type KeyMap struct {
	// Navigation
	Up       key.Binding
	Down     key.Binding
	PageUp   key.Binding
	PageDown key.Binding

	// Actions
	Send       key.Binding
	NewLine    key.Binding
	Cancel     key.Binding
	Quit       key.Binding
	ToggleMode key.Binding
	ToggleHelp key.Binding

	// Tools
	ExpandTools key.Binding

	// Output
	CopyOutput key.Binding

	// YOLO mode
	ToggleYolo key.Binding

	// Modals
	OpenSessions key.Binding
	OpenModel    key.Binding
	NewChat      key.Binding

	// Permission modal
	Allow key.Binding
	Deny  key.Binding

	// Picker navigation
	Select key.Binding
	Rename key.Binding
	Delete key.Binding

	// Filter/search
	Filter key.Binding
}

type MessageMetadata struct {
	// ChatMode stores the chat mode when the message was sent.
	// 0 = agent, 1 = plan, 2 = ask.
	ChatMode ChatMode `json:"chatMode"`
}

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

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

type Params struct {
	// Session is the active Copilot chat session.
	Session *copilot.Session

	// Client is the Copilot client used for API calls.
	Client *copilot.Client

	// SessionConfig holds the session configuration.
	SessionConfig *copilot.SessionConfig

	// Models is the list of available models.
	Models []copilot.ModelInfo

	// CurrentModel is the initially-selected model identifier.
	CurrentModel string

	// Timeout controls the per-request timeout.
	Timeout time.Duration

	// EventChan is an optional pre-created event channel for sending external events to the TUI.
	// If nil, a new channel is created internally.
	EventChan chan tea.Msg

	// ChatModeRef is an optional reference to synchronize chat mode state with tool handlers.
	ChatModeRef *ChatModeRef

	// YoloModeRef is an optional reference to synchronize YOLO mode state with tool handlers.
	YoloModeRef *YoloModeRef

	// Theme configures colors, logo, labels, and other visual aspects.
	// Zero value applies DefaultThemeConfig().
	Theme ThemeConfig

	// ToolDisplay configures tool name mappings and command builders.
	// Zero value applies DefaultToolDisplayConfig().
	ToolDisplay ToolDisplayConfig
}

type PermissionRequestMsg struct {
	ToolCallID string
	ToolName   string
	Command    string
	Arguments  string
	Response   chan<- bool
}

type SessionMetadata struct {
	ID       string    `json:"id"`
	Name     string    `json:"name"`
	Model    string    `json:"model,omitempty"`
	ChatMode *ChatMode `json:"chatMode,omitempty"` // nil = agent mode (default)
	// Messages stores per-message metadata (chatMode for each user message).
	Messages    []MessageMetadata        `json:"messages,omitempty"`
	SDKMetadata *copilot.SessionMetadata `json:"-"` // SDK metadata (not persisted)
	CreatedAt   time.Time                `json:"createdAt"`
	UpdatedAt   time.Time                `json:"updatedAt"`
}

type SystemContextConfig struct {
	// Identity is the assistant's identity and role description.
	Identity string

	// Documentation is reference documentation embedded in the system prompt.
	Documentation string

	// CLIHelp is pre-rendered CLI help text (e.g., from --help output).
	CLIHelp string

	// Instructions are behavioral instructions for the assistant.
	Instructions string

	// IncludeWorkingDirContext enables auto-detection of current working directory
	// and config file content to include in the prompt.
	IncludeWorkingDirContext bool

	// ConfigFileName is the config file to detect in the working directory (e.g., "ksail.yaml").
	// Only used when IncludeWorkingDirContext is true.
	ConfigFileName string
}

type ThemeConfig struct {
	// Logo returns the ASCII art logo text (multi-line). Called on each render.
	Logo func() string

	// Tagline returns the tagline text displayed below the logo.
	Tagline func() string

	// LogoHeight is the number of lines in the logo (used for layout calculations).
	LogoHeight int

	// AssistantLabel is the label shown before assistant messages (e.g., "▶ KSail").
	AssistantLabel string

	// Placeholder is the textarea placeholder text.
	Placeholder string

	// WelcomeMessage is shown in the viewport before any messages.
	WelcomeMessage string

	// GoodbyeMessage is shown when the user quits.
	GoodbyeMessage string

	// SessionDir is the app-specific directory name for session storage under $HOME.
	// For example, ".ksail" stores sessions at ~/.ksail/chat/sessions.
	SessionDir string

	// PrimaryColor is used for main accents (header border, input border, logo).
	PrimaryColor lipgloss.AdaptiveColor

	// AccentColor is used for tagline and spinner.
	AccentColor lipgloss.AdaptiveColor

	// SecondaryColor is used for borders and muted elements.
	SecondaryColor lipgloss.AdaptiveColor

	// UserColor styles user messages.
	UserColor lipgloss.AdaptiveColor

	// AssistantColor styles assistant message labels.
	AssistantColor lipgloss.AdaptiveColor

	// ToolColor styles tool calls and help keybindings.
	ToolColor lipgloss.AdaptiveColor

	// SuccessColor styles success indicators and completed tools.
	SuccessColor lipgloss.AdaptiveColor

	// DimColor styles muted/less important text.
	DimColor lipgloss.AdaptiveColor

	// ErrorColor styles error messages.
	ErrorColor lipgloss.AdaptiveColor
}

type ToolDisplayConfig struct {
	// NameMappings maps tool names to human-readable labels.
	// Example: {"my_tool_list": "Listing items", "bash": "Running command"}
	// The generic fallback (snake_case → Title Case) is used for unmapped names.
	NameMappings map[string]string

	// CommandBuilders maps tool names to functions that extract display commands from arguments.
	CommandBuilders map[string]CommandBuilder
}

type ToolOutputChunkMsg struct {
	ToolID string
	Chunk  string
}

type YoloModeRef = ModeRef