config

type ColorScheme struct {
	Name                string `json:"name"`
	Foreground          string `json:"foreground"`
	Background          string `json:"background"`
	CursorColor         string `json:"cursorColor,omitempty"`
	SelectionBackground string `json:"selectionBackground,omitempty"`

	// Standard 8 ANSI colors.
	Black  string `json:"black"`
	Red    string `json:"red"`
	Green  string `json:"green"`
	Yellow string `json:"yellow"`
	Blue   string `json:"blue"`
	Purple string `json:"purple"`
	Cyan   string `json:"cyan"`
	White  string `json:"white"`

	// Bright variants.
	BrightBlack  string `json:"brightBlack"`
	BrightRed    string `json:"brightRed"`
	BrightGreen  string `json:"brightGreen"`
	BrightYellow string `json:"brightYellow"`
	BrightBlue   string `json:"brightBlue"`
	BrightPurple string `json:"brightPurple"`
	BrightCyan   string `json:"brightCyan"`
	BrightWhite  string `json:"brightWhite"`
}

type Config struct {
	// ConfigVersion tracks the schema version of this config file. Used to
	// detect and apply migrations when the config schema changes across
	// dispatch releases. The current version is set by [currentConfigVersion].
	ConfigVersion int `json:"config_version,omitempty"`

	// DefaultShell is the preferred shell name (e.g. "pwsh", "bash", "zsh").
	DefaultShell string `json:"default_shell"`

	// DefaultTerminal is the preferred terminal emulator name
	// (e.g. "Windows Terminal", "alacritty", "iTerm2").
	DefaultTerminal string `json:"default_terminal"`

	// DefaultTimeRange is the default time filter applied to session lists.
	// Valid values: "1h", "1d", "7d", "all".
	DefaultTimeRange string `json:"default_time_range"`

	// DefaultSort is the field used to order session lists.
	// Valid values: "updated", "created", "turns", "name", "folder".
	DefaultSort string `json:"default_sort"`

	// DefaultSortOrder is the direction used to order session lists.
	// Valid values: "asc", "desc".
	DefaultSortOrder string `json:"default_sort_order,omitempty"`

	// DefaultPivot is the default grouping applied to session lists.
	// Valid values: "none", "folder", "repo", "branch", "date", "host".
	DefaultPivot string `json:"default_pivot"`

	// ShowPreview controls whether the detail/preview panel is visible.
	ShowPreview bool `json:"show_preview"`

	// MaxSessions is the maximum number of sessions to load initially.
	MaxSessions int `json:"max_sessions"`

	// YoloMode enables the --allow-all flag when resuming sessions,
	// allowing the Copilot CLI to run commands without confirmation prompts.
	YoloMode bool `json:"yoloMode"`

	// Agent specifies the --agent <name> flag passed to the Copilot CLI
	// when resuming sessions. Empty string means no agent override.
	Agent string `json:"agent"`

	// Model specifies the --model <name> flag passed to the Copilot CLI
	// when resuming sessions. Empty string means no model override.
	Model string `json:"model"`

	// LaunchMode controls how sessions are opened:
	//   "in-place" — resume in the current terminal (replaces the TUI)
	//   "tab"      — open in a new tab of the current terminal
	//   "window"   — open in a new terminal window
	//   "pane"     — open in a split pane (Windows Terminal only)
	// Default is "tab" when unset.
	LaunchMode string `json:"launch_mode,omitempty"`

	// PaneDirection controls the split direction when LaunchMode is "pane":
	//   "auto"  — let Windows Terminal choose (default)
	//   "right" — split to the right (vertical)
	//   "down"  — split downward (horizontal)
	//   "left"  — split to the left
	//   "up"    — split upward
	// Only used when LaunchMode is "pane" and the terminal is Windows Terminal.
	PaneDirection string `json:"pane_direction,omitempty"`

	// LaunchInPlace is deprecated; kept for backward compatibility.
	// When LaunchMode is unset and LaunchInPlace is true, the effective
	// mode is "in-place". New code should use LaunchMode.
	LaunchInPlace bool `json:"launchInPlace"`

	// ExcludedDirs is a list of directory paths to exclude from session
	// listings. Sessions whose Cwd starts with any of these paths are hidden.
	ExcludedDirs []string `json:"excluded_dirs,omitempty"`

	// CustomCommand is a user-defined command that replaces the default
	// copilot CLI resume command. The placeholder {sessionId} is replaced
	// with the actual session ID at launch time. When set, YoloMode, Agent,
	// and Model are ignored (they only apply to the default copilot CLI).
	// Terminal and Shell settings are still used.
	CustomCommand string `json:"custom_command,omitempty"`

	// ExcludedWords is a list of words used to filter sessions from the
	// dispatch list. Sessions whose summary or turn content contains any
	// of these words (case-insensitive) are hidden from the session list.
	ExcludedWords []string `json:"excluded_words,omitempty"`

	// HiddenSessions is a list of session IDs that the user has chosen to
	// hide from the main session list. They can be revealed with the
	// "show hidden" toggle and unhidden individually.
	HiddenSessions []string `json:"hiddenSessions,omitempty"`

	// FavoriteSessions is a list of session IDs that the user has starred
	// as favorites. They can be filtered with the "filter favorites" toggle.
	FavoriteSessions []string `json:"favoriteSessions,omitempty"`

	// SessionNotes maps session IDs to user-defined note strings.
	// Notes provide context about why a session matters or what follow-up
	// is needed. They are displayed in the preview panel and indicated
	// by a marker in the session list.
	SessionNotes map[string]string `json:"sessionNotes,omitempty"`

	// SessionLaunches maps session IDs to their launch statistics. It is
	// used by the frecency sort to rank sessions the user launches often
	// and recently ahead of ones they rarely open.
	SessionLaunches map[string]SessionLaunch `json:"sessionLaunches,omitempty"`

	// SessionTags maps session IDs to a list of user-defined tags. Tags group
	// related sessions for quick filtering with the tag: search token and are
	// indicated by a marker in the session list.
	SessionTags map[string][]string `json:"sessionTags,omitempty"`

	// SessionAliases maps session IDs to a single short, user-chosen alias.
	// Aliases are unique and let "dispatch open <alias>" resume a session
	// without typing the full ID.
	SessionAliases map[string]string `json:"sessionAliases,omitempty"`
	// HiddenColumns lists optional session-list columns the user has chosen
	// to hide (for example "repo", "folder", "turns", "host"). When empty
	// (the default), every column is shown. The session name and attention
	// indicator are always visible and cannot be hidden.
	HiddenColumns []string `json:"hidden_columns,omitempty"`

	// AISearch enables Copilot SDK-powered AI search. When false (the
	// default), only the local FTS5 index is used.  Set to true to also
	// query the Copilot backend for semantically relevant sessions.
	AISearch bool `json:"ai_search,omitempty"`

	// AttentionThreshold is the duration string (e.g. "15m", "1h") after
	// which a running session with no activity is classified as "stale"
	// instead of "waiting" or "active". Default is "15m".
	AttentionThreshold string `json:"attention_threshold,omitempty"`

	// NotifyOnWaiting rings the terminal bell and shows a footer message when
	// a session enters the waiting state (the AI has responded and is waiting
	// for user input). The bell fires once per transition into waiting, not on
	// every scan and not for sessions already waiting when dispatch starts.
	NotifyOnWaiting bool `json:"notify_on_waiting,omitempty"`

	// Keybindings remaps keyboard shortcuts. Keys are action names (see the
	// README for the full list, e.g. "search", "quit", "preview") and values
	// are comma-separated key lists (e.g. "/,ctrl+f"). Listed actions replace
	// their default keys; unlisted actions keep their defaults. Unknown action
	// names and keys that collide with another action are ignored.
	Keybindings map[string]string `json:"keybindings,omitempty"`

	// Theme is the active color scheme name.  "auto" (or empty) means
	// detect from the terminal; any other value is looked up in Schemes
	// and then the built-in scheme list.
	Theme string `json:"theme,omitempty"`

	// Schemes is a list of user-defined color schemes in Windows Terminal
	// format.  Users can paste any WT scheme JSON directly here.
	Schemes []ColorScheme `json:"schemes,omitempty"`

	// PreviewPosition controls where the session detail/preview panel
	// is displayed relative to the session list.
	// Valid values: "right", "bottom", "left", "top".
	// Default is "right" when unset.
	PreviewPosition string `json:"preview_position,omitempty"`

	// DefaultCollapsed controls whether session header rows start in
	// collapsed (single-line) or expanded (multi-line) state. When false
	// (default), sessions are expanded showing full details. When true,
	// sessions start collapsed showing only the compact indicator row.
	DefaultCollapsed bool `json:"default_collapsed,omitempty"`

	// ConversationNewestFirst controls the turn display order in the
	// preview panel's Conversation section. When true (default), turns
	// are shown newest-first (descending). When false, turns are shown
	// oldest-first (ascending by TurnIndex).
	ConversationNewestFirst bool `json:"conversation_newest_first"`

	// WorkspaceRecovery enables detection of sessions interrupted by
	// crash/reboot. When false, stale lock files are ignored. Default true.
	WorkspaceRecovery bool `json:"workspace_recovery"`

	// RedactPreviewSecrets enables replacement of common secret patterns
	// (bearer tokens, GitHub PATs, Azure connection strings, .env secrets)
	// with [redacted] in the preview pane. Only affects rendering; stored
	// session data is never modified.
	RedactPreviewSecrets bool `json:"redact_preview_secrets,omitempty"`

	// AutoRefreshSeconds controls the session-list auto-refresh poll
	// interval, in seconds. When unset (nil), the built-in default interval
	// is used. A value of 0 disables polling entirely, so the list refreshes
	// only on explicit reload or reindex. A positive value sets the interval
	// (clamped to a one-second minimum); negative values are ignored and fall
	// back to the default. A pointer is used so "unset" and "0" are distinct.
	AutoRefreshSeconds *int `json:"auto_refresh_seconds,omitempty"`

	// Views is a list of named views, each storing a combination of
	// filter/sort/pivot settings that can be applied together.
	Views []NamedView `json:"views,omitempty"`

	// ActiveView is the name of the currently active named view.
	// Empty or "Default" means no named view is active.
	ActiveView string `json:"active_view,omitempty"`
}

type LaunchMode = string

type NamedView struct {
	// Name is the unique display name for this view (e.g. "Work", "Personal").
	Name string `json:"name"`

	// Search is the search text to apply.
	Search string `json:"search,omitempty"`

	// TimeRange is the time filter (e.g. "1h", "1d", "7d", "all").
	TimeRange string `json:"time_range,omitempty"`

	// Sort is the sort field (e.g. "updated", "created", "turns", "name", "folder").
	Sort string `json:"sort,omitempty"`

	// SortOrder is the sort direction ("asc" or "desc").
	SortOrder string `json:"sort_order,omitempty"`

	// Pivot is the grouping mode (e.g. "none", "folder", "repo", "branch", "date", "host").
	Pivot string `json:"pivot,omitempty"`

	// FavoritesOnly restricts the list to favorited sessions.
	FavoritesOnly bool `json:"favorites_only,omitempty"`

	// ShowHidden includes hidden sessions in the list.
	ShowHidden bool `json:"show_hidden,omitempty"`

	// ExcludedDirs overrides the global excluded directories for this view.
	ExcludedDirs []string `json:"excluded_dirs,omitempty"`
}

type SessionLaunch struct {
	// Count is the total number of times the session has been launched.
	Count int `json:"count"`

	// Last is the Unix time (seconds) of the most recent launch.
	Last int64 `json:"last"`
}