config

type Config struct {
	Telegram      TelegramConfig     `toml:"telegram"`
	Storage       StorageConfig      `toml:"storage"`
	UI            UIConfig           `toml:"ui"`
	Media         MediaConfig        `toml:"media"`
	Notifications NotificationConfig `toml:"notifications"`
	Keys          KeyConfig          `toml:"keys"`
}

type KeyConfig struct {
	// Quit quits from anywhere, without asking. A bare printable is
	// refused here: it is matched before every focus gate, so it would be
	// untypable in a message. See [ResolveQuitKey]. Default ctrl+q.
	Quit string `toml:"quit"`
	// QuitBrowsing quits from the chat list and the chat view only, where
	// a bare letter cannot be mistaken for typing — the composer owns
	// printables and never sees it. An unsent draft or a pending
	// attachment turns it into a confirm rather than an immediate exit, so
	// a single keystroke cannot discard a message being written.
	// Default "q".
	QuitBrowsing string `toml:"quit_browsing"`
	// Search searches the buffer in front of you: in-chat find from the
	// chat view, a live filter over the chat list. Default "/".
	Search string `toml:"search"`
	// GlobalSearch searches every chat, from any panel — the
	// panel-independent binding Search cannot be, since vi convention
	// gives "/" to the buffer you are looking at. Default ctrl+g.
	GlobalSearch string `toml:"global_search"`
	// Contacts toggles the contacts overlay. Default "c".
	Contacts string `toml:"contacts"`
	// Compose moves focus to the composer, opening the cursored chat
	// first when it is not already the open one. Default "i".
	Compose string `toml:"compose"`
	// Help opens the keybinding overlay. Default "?".
	Help string `toml:"help"`
	// NextChat/PrevChat open the next and previous chat outright, unlike
	// the chat list's own j/k which only move the cursor. Defaults "J"
	// and "K".
	NextChat string `toml:"next_chat"`
	PrevChat string `toml:"prev_chat"`
	// NextUnread opens the next chat with unread messages, searching down
	// from the cursor within the active folder and wrapping once.
	// Default "u".
	NextUnread string `toml:"next_unread"`
	// NextFolder/PrevFolder cycle the folder tabs from either browsing
	// panel. Defaults "]" and "[".
	NextFolder string `toml:"next_folder"`
	PrevFolder string `toml:"prev_folder"`
	// Reply/EditMessage/DeleteMessage/Forward act on the cursored message
	// in the chat view. Defaults "r", "e", "d", "f".
	Reply         string `toml:"reply"`
	EditMessage   string `toml:"edit_message"`
	DeleteMessage string `toml:"delete_message"`
	// Forward opens the destination picker for the cursored message. It
	// was the one field the keymap cut removed for being inert (I-13); it
	// is back because it now does something. See issue #39.
	Forward string `toml:"forward"`
	// MarkRead marks the open chat read without moving the scroll or the
	// unread divider. Default "m".
	MarkRead string `toml:"mark_read"`
}

type MediaConfig struct {
	ImageProtocol       string `toml:"image_protocol"`
	MaxImageWidth       int    `toml:"max_image_width"`
	MaxImageHeight      int    `toml:"max_image_height"`
	VoicePlayer         string `toml:"voice_player"`
	VideoPlayer         string `toml:"video_player"`
	AutoDownloadPhotos  bool   `toml:"auto_download_photos"`
	AutoDownloadLimitMB int    `toml:"auto_download_limit_mb"`

	// AutoDownloadVoice is read back and written out, and nothing consults
	// it. Voice notes are never prefetched: one is fetched when you press
	// space on it, which is the only moment anybody wants the bytes, and
	// turning that off would mean a key that does nothing. Kept for config
	// round-tripping — see TimestampFormat for the same reasoning at
	// length.
	AutoDownloadVoice bool `toml:"auto_download_voice"`
}

type MigrationChange struct {
	// Field is the TOML key, qualified by its table (e.g. "keys.contacts").
	Field string
	// Old is the value the config carried, empty when Absent.
	Old string
	// Absent distinguishes a key the file never had from one it set to the
	// empty string. Both read as "" in Old, but they are different
	// mistakes: the first is an old config missing a field added since, the
	// second is someone who wrote `contacts = ""` and deserves to see that
	// their (broken) setting was replaced rather than merely filled in.
	Absent bool
	// New is the value written in its place.
	New string
	// Removed marks a field the client no longer has. The key is dropped
	// from the rewritten file rather than replaced, and the summary says so
	// — a user who tuned it deserves to learn it stopped doing anything,
	// which is not the same news as a value being changed.
	Removed bool
}

type NotificationConfig struct {
	Enabled     bool `toml:"enabled"`
	Sound       bool `toml:"sound"`
	ShowPreview bool `toml:"show_preview"`

	// Method is who posts the notification: "auto" (the default — the
	// terminal where it is known to understand the sequence, the system
	// otherwise), "terminal", or "system". See internal/notification for
	// why the terminal is usually the right answer, and why macOS labels
	// the system path "Script Editor".
	Method string `toml:"method"`
}

type RawFile struct {
	// Config is the file parsed with no defaults applied.
	Config *Config
	// contains filtered or unexported fields
}

type StorageConfig struct {
	SessionFile string `toml:"session_file"`

	// FilesDir is the media CACHE: where downloads land so a photo drawn
	// twice is fetched once. It is not where "save this" saves to — see
	// DownloadDir — and a user who set files_dir expecting the latter got
	// a cache directory full of files with server-side names.
	FilesDir string `toml:"files_dir"`

	// DownloadDir is where `s` puts a copy, under the sender's own
	// filename. Defaults to the platform download folder, because that is
	// where a person looks for a thing they just saved.
	DownloadDir string `toml:"download_dir"`
	// StateFile is the bbolt database holding the update-sequence state
	// (pts/qts/seq/date) and the peer access-hash cache, so updates that
	// arrived while the app was offline can be recovered on the next start.
	// Empty (the default) means "state.db" next to SessionFile.
	StateFile string `toml:"state_file"`

	// SendDirs is the allowlist of directories a REMOTE caller may send
	// files from: the `send_file` MCP tool and POST /api/send-file. It does
	// not constrain the TUI, where the person choosing the file is the
	// person running the process.
	//
	// Empty means [DefaultOutboxDir], which is also what the shipped
	// default holds. Read it through [Config.SendRoots], never directly:
	// the media cache is always a root and is not listed here.
	//
	// There is deliberately no spelling of "the cache and nothing else" —
	// `send_dirs = []` reads as unset, because a list that is empty by
	// accident (a commented-out entry, a cleared value) must not silently
	// mean something different from a list that was never written. An
	// operator who wants exactly that points send_dirs at files_dir.
	//
	// This used to be the process's working directory, which nobody chose
	// and nothing logged — whatever directory `telegram-mcp serve` happened
	// to start in became sendable. For an MCP host launched from a login
	// shell that is $HOME, and the caller on the other end is a language
	// model reading untrusted incoming messages. The allowlist exists so
	// the set has a size somebody picked.
	SendDirs []string `toml:"send_dirs"`
}

type TelegramConfig struct {
	APIID   int32  `toml:"api_id"`
	APIHash string `toml:"api_hash"`
	Phone   string `toml:"phone"`
}

type UIConfig struct {
	Theme string `toml:"theme"`

	// TimestampFormat and DateFormat are READ BACK AND WRITTEN OUT, and
	// nothing consults them. Every time on screen has a fixed form chosen
	// for the column it sits in: the thread's clock is 15:04 because the
	// grid gives it five cells and puts the date in a day divider, the
	// chat list is relative because a chat list is read for recency, and a
	// day divider names the day. A Go layout string cannot express those,
	// and one that overrode all three would break the column widths the
	// frame is built on.
	//
	// Kept so an existing config round-trips rather than losing keys on
	// -migrate-config. Marked here, and in config.example.toml, so nobody
	// spends an afternoon finding out they do nothing.
	TimestampFormat string `toml:"timestamp_format"`
	DateFormat      string `toml:"date_format"`

	// InlineImages governs WHERE a photo is drawn:
	// [InlineImagesNever], [InlineImagesOnOpen] (the default), or
	// [InlineImagesAlways]. Only the last puts art in the thread, and only
	// bounded — see render.inlineArtRows for why the bound is not
	// negotiable.
	InlineImages string `toml:"inline_images"`

	// Hyperlinks governs OSC 8 terminal hyperlinks on links in a message:
	// [HyperlinksAuto] (the default), [HyperlinksNever], or
	// [HyperlinksAlways].
	Hyperlinks string `toml:"hyperlinks"`

	// EmojiWidth declares how this terminal draws emoji sequences that
	// have a composition rule: [EmojiWidthAuto] (the default),
	// [EmojiWidthComposed], or [EmojiWidthSeparate]. It is a declaration
	// because it cannot be detected — see internal/ui/cell for why.
	EmojiWidth string `toml:"emoji_width"`

	// Rail shows the right-hand context rail — pinned message, members,
	// shared files — on a terminal wide enough for it. Off by default: it
	// costs 30 columns, and they come out of the thread.
	Rail bool `toml:"rail"`
	// ComposeEditing selects the composer's line-editing keymap:
	// [ComposeEditingEmacs], [ComposeEditingVi], or [ComposeEditingAuto]
	// (the default) to infer it from $VISUAL/$EDITOR. Resolve it with
	// [ResolveComposeEditing]; never read the raw value.
	ComposeEditing string `toml:"compose_editing"`
	// ParseMarkdown enables the Telegram Desktop markdown subset in
	// outgoing messages and captions (**bold**, __italic__, `code`,
	// “`pre“`, ~~strike~~, ||spoiler||, [text](url)).
	//
	// Defaults to FALSE: what you typed is what gets sent. The composer has
	// no preview, so with parsing on silently by default the first time a
	// user notices is when a message has already left — and the syntax
	// overlaps with things people paste verbatim. __init__ arrives as
	// init, a snippet full of ** loses it, a table of || collapses. Opting
	// in means knowing that transformation happens.
	//
	// -migrate-config turns it on for existing configs, where it reports
	// the change, so upgraders get the feature but are told about it.
	ParseMarkdown bool `toml:"parse_markdown"`
}