config

type AgentAlertPolicy struct {
	Enabled         bool
	Notify          bool
	Sound           bool
	SoundMode       AgentSoundMode
	SoundCooldown   time.Duration
	SoundDone       string
	SoundNeedsInput string
	Dock            bool
	SuppressFocused bool
	Settle          time.Duration
	// contains filtered or unexported fields
}

type AgentAlertSounds struct {
	// Done is the cue for an agent that stopped. Default: built in.
	Done string `toml:"done"`
	// NeedsInput is the cue for an agent waiting on a human, or one that
	// failed. Default: built in.
	NeedsInput string `toml:"needs_input"`
}

type AgentAlertStates struct {
	// NeedsInput is the agent blocked on the user. Default: true.
	NeedsInput *bool `toml:"needs_input"`
	// Errored is the agent having stopped on an error. Default: true.
	Errored *bool `toml:"errored"`
	// Done is the agent having finished its task, which only an explicit report
	// produces. Default: true.
	Done *bool `toml:"done"`
	// Idle is the agent having gone quiet. The stall timer guesses this one from
	// silence, so it is the flappy state and the one that would make tuios the
	// thing people mute. Default: false.
	Idle *bool `toml:"idle"`
	// Working is the agent starting work, which is not news. Default: false.
	Working *bool `toml:"working"`
}

type AgentAlertsConfig struct {
	// Enabled is the master switch. False silences every sink below, including
	// the command. Default: true.
	Enabled *bool `toml:"enabled"`

	// States selects which transitions alert at all.
	States AgentAlertStates `toml:"states"`

	// Notify writes an in-band desktop notification to the terminal the client
	// is attached to. Default: true.
	Notify *bool `toml:"notify"`

	// Sound makes the alert audible. What that means is SoundMode's job.
	// Default: false.
	Sound *bool `toml:"sound"`

	// SoundMode chooses how Sound makes a noise: "audio" plays one of tuios's
	// two cues through whatever audio player the machine has, "bell" writes a
	// BEL and lets the terminal decide what that means, and "both" does each.
	// An unrecognised value is reported as a config warning and read as the
	// default. Default: "audio".
	SoundMode string `toml:"sound_mode"`

	// SoundCooldownSeconds is the shortest gap between two audible cues,
	// counted across every pane. It exists because a workspace where six agents
	// finish together should make one sound rather than six. It does not apply
	// to the bell, which the terminal rate-limits or does not, as it prefers.
	// Default: 3.
	SoundCooldownSeconds *int `toml:"sound_cooldown_seconds"`

	// Sounds replaces the built-in cues with files of the user's own.
	Sounds AgentAlertSounds `toml:"sounds"`

	// Dock shows the message in tuios's own dock, where it is clickable and
	// jumps to the pane that raised it. Default: true.
	Dock *bool `toml:"dock"`

	// Command is a shell command run on an alert, shorthand for registering one
	// under the after-agent-state hook. Default: empty (nothing runs).
	Command string `toml:"command"`

	// SettleSeconds holds an alert for this long and drops it if the pane leaves
	// the state before it expires, so a flapping agent produces one alert rather
	// than a stream. Zero alerts immediately. Default: 2.
	SettleSeconds *int `toml:"settle_seconds"`

	// SuppressFocused drops alerts for the pane the user is already looking at,
	// which is what tuios did before any of this was configurable. A pane is
	// looked at while it is focused and the host terminal has not reported
	// losing focus (DECSET 1004 focus events). Set it false
	// to be told anyway, on the grounds that a pane being on screen is not
	// evidence anyone read it. Default: true.
	SuppressFocused *bool `toml:"suppress_focused"`

	// QuietHours silences every sink inside a local-time window written
	// "HH:MM-HH:MM". A window that wraps midnight is understood. Default: empty
	// (never quiet).
	QuietHours string `toml:"quiet_hours"`
}

type AgentSoundMode string

type AgentsConfig struct {
	// Enabled turns every agent feature on or off: agent detection, the
	// agent rows of the rail, the Inbox, agent mail, approvals, attention,
	// the agent keys and start-agent. Nil means on, the default. False keeps
	// only the multiplexer. See On.
	Enabled *bool `toml:"enabled,omitempty"`
	// Approvals is the [agents.approvals] table. See ApprovalsConfig.
	Approvals ApprovalsConfig `toml:"approvals,omitempty"`
	// Permissions is the [agents.permissions] table: what a process in a
	// pane may do through tuios. See pane_grants.go.
	Permissions PermissionsConfig `toml:"permissions,omitempty"`
	// Recap is the [agents.recap] table: the summary of what an agent did
	// while the person was away. See agents_work.go.
	Recap RecapConfig `toml:"recap,omitempty"`
	// Queue is the [agents.queue] table: messages waiting to be typed to an
	// agent when it comes to rest. See agents_work.go.
	Queue QueueConfig `toml:"queue,omitempty"`
	// Checkpoints is the [agents.checkpoints] table: the state of a pane's
	// git work tree saved at the end of each agent turn. See agents_work.go.
	Checkpoints CheckpointsConfig `toml:"checkpoints,omitempty"`
	// HerdrProtocol says which panes are told about the socket tuios accepts
	// herdr's pane state protocol on, which Crush and other harnesses report
	// to by themselves: "always" (the default) for every pane, the way herdr
	// tells every pane, so a harness started from a shell reports too;
	// "agents" for a pane that starts such a harness directly; and "off" for
	// none. A pane told about it reads as a herdr pane to anything that checks
	// HERDR_ENV, herdr itself included, which refuses to start inside one
	// unless its own config allows nesting. See docs/AGENT_STATE.md.
	HerdrProtocol string `toml:"herdr_protocol,omitempty"`
	// HostProgramStatus says whether tuios reports its panes' agent states to
	// the terminal it runs in, with OSC 7501 (the Program Status Protocol):
	// "auto" (the default) asks the terminal at start and reports only when
	// it answers, and "off" never asks. See docs/PROGRAM_STATUS.md.
	HostProgramStatus string `toml:"host_program_status,omitempty"`
}

type Ambiguity struct {
	// Keys are the names that collapse onto one another.
	Keys []string `json:"keys"`
	// Byte is the control code they all arrive as in the legacy encoding.
	Byte byte `json:"byte"`
	// Why is the one sentence explaining the pair.
	Why string `json:"why"`
	// Separable is whether the Kitty keyboard protocol's disambiguation can
	// tell them apart when the host grants it. All the control-code pairs can
	// be; the pair kept here that cannot is noted in its Why.
	Separable bool `json:"separable"`
}

type AmbiguousBinding struct {
	Scope    string   `json:"scope"`
	Action   string   `json:"action"`
	Key      string   `json:"key"`
	Partners []string `json:"partners"`
	Verdict  string   `json:"verdict"`
	Evidence Evidence `json:"evidence"`
}

type AppearanceConfig struct {
	BorderStyle              string                  `toml:"border_style"`                 // Border style: rounded, normal, thick, double, hidden, block, ascii, outer-half-block, inner-half-block, glyphs
	ZenMode                  string                  `toml:"zen_mode"`                     // Zen mode: disabled, always, mouse (default: disabled)
	Links                    string                  `toml:"links"`                        // Links tuios acts on: off, marked, all (default: all)
	LinkClick                string                  `toml:"link_click"`                   // The click that opens a link: both, ctrl, shift, off (default: both)
	LinkOpener               string                  `toml:"link_opener"`                  // Command that opens a web link; empty uses $BROWSER, then the system opener
	HideWindowButtons        bool                    `toml:"hide_window_buttons"`          // Hide window control buttons (minimize, maximize, close)
	WindowButtonStyle        string                  `toml:"window_button_style"`          // Window control style: pill, dots (default: dots)
	WindowButtonPosition     string                  `toml:"window_button_position"`       // Which end of the title bar the window controls sit on: right, left (default: left)
	HideScrollbar            bool                    `toml:"hide_scrollbar"`               // Hide the window scrollbar thumb on the border
	ScrollbackLines          int                     `toml:"scrollback_lines"`             // Number of lines to keep in scrollback buffer (default: 10000, min: 100, max: 1000000)
	ScrollLines              int                     `toml:"scroll_lines"`                 // Lines scrolled per mouse wheel notch (default: 3, min: 1, max: 50)
	CopyOnSelect             *bool                   `toml:"copy_on_select"`               // Copy a mouse selection to the clipboard on release (default: true)
	NvimNavigation           *bool                   `toml:"nvim_navigation"`              // Let the Neovim navigator plugin hand terminal focus keys back to TUIOS (default: false)
	FocusFollowsMouse        *bool                   `toml:"focus_follows_mouse"`          // Focus the pane under the cursor as the mouse moves (default: false)
	AltDrag                  *bool                   `toml:"alt_drag"`                     // Alt + left-drag moves a pane (default: true)
	RightClickOpensMenu      *bool                   `toml:"right_click_opens_menu"`       // A plain right-click on a pane in terminal mode opens the pane menu (default: false)
	KittyPlaceholders        string                  `toml:"kitty_placeholders"`           // Draw kitty Unicode placeholder images: auto, on, off (default: auto)
	ImageSymbols             string                  `toml:"image_symbols"`                // Draw pane images as block glyphs on a terminal without graphics: auto, octant, sextant, quadrant, half, off (default: auto)
	NewWindowInheritCwd      *bool                   `toml:"new_window_inherit_cwd"`       // A new window starts in the focused pane's working directory (default: true)
	NewWindowFollowSSH       *bool                   `toml:"new_window_follow_ssh"`        // A split or new window of a pane that runs ssh runs the same ssh (default: false)
	AutoEnterTerminalOnFocus AutoEnterTerminalPolicy `toml:"auto_enter_terminal_on_focus"` // When a keyboard focus command should start typing in that pane: off, targeted, all (default: off)
	ClickToType              string                  `toml:"click_to_type"`                // What a click on a pane's content does in window-management mode: single, double, off (default: double)
	WordCharacters           *string                 `toml:"word_characters"`              // Punctuation that counts as part of a word for double-click selection (default: "@-./_~?&=%+#")
	DockbarPosition          string                  `toml:"dockbar_position"`             // Dockbar position: bottom, top, hidden (default: top)
	PreferredShell           string                  `toml:"preferred_shell"`              // Preferred shell: if empty, auto-detect based on platform.
	AnimationsEnabled        *bool                   `toml:"animations_enabled,omitempty"` // Deprecated: folded into motion on load (false is none)
	Motion                   string                  `toml:"motion"`                       // How much moves: none, basic (window slides, copy sweep), full (also fades and the working shimmer) (default: full)
	ModalDim                 *int                    `toml:"modal_dim"`                    // Percent the screen behind a modal overlay is darkened; 0 is off (default: 30)
	ConfirmQuit              *bool                   `toml:"confirm_quit"`                 // Always show quit confirmation dialog (default: false). When false, only shown if foreground processes are running.
	WhichKeyEnabled          *bool                   `toml:"whichkey_enabled"`             // Show which-key popup after pressing leader key (default: true)
	WhichKeyPosition         string                  `toml:"whichkey_position"`            // Which-key popup position: bottom-right, bottom-left, top-right, top-left, center (default: bottom-right)
	WrapLists                *bool                   `toml:"wrap_lists"`                   // Up on a list's first row goes to its last, and down on the last to the first (default: true)
	WindowTitlePosition      string                  `toml:"window_title_position"`        // Window title position: bottom, top, hidden (default: top). Shows CustomName if set, else terminal title.
	HideClock                bool                    `toml:"hide_clock"`                   // Hide the clock overlay (deprecated, use show_clock)
	ShowClock                bool                    `toml:"show_clock"`                   // Show the clock overlay (default: false)
	ShowCPU                  bool                    `toml:"show_cpu"`                     // Show CPU graph in dock (default: false)
	ShowRAM                  bool                    `toml:"show_ram"`                     // Show RAM usage in dock (default: false)
	Theme                    string                  `toml:"theme"`                        // Color theme name (e.g., dracula, nord, my-custom-theme)
	SharedBorders            *bool                   `toml:"shared_borders"`               // Share borders between adjacent tiled windows (default: false)
	// Customization
	BorderFocusedColor   string `toml:"border_focused_color"`   // Hex color for focused pane border (e.g., "#89b4fa")
	BorderUnfocusedColor string `toml:"border_unfocused_color"` // Hex color for unfocused pane border (e.g., "#585b70")
	WindowTitleFormat    string `toml:"window_title_format"`    // Format string for window titles: {title}, {index}, {cwd}
	ZoomMaxWidth         int    `toml:"zoom_max_width"`         // Max width in cells for zoom mode (0 = fullscreen, e.g. 120 centers at 120 cols)
	NiriReverseScroll    bool   `toml:"niri_reverse_scroll"`    // Reverse mouse scroll direction in niri scrolling mode (default: false)
	NiriScrollCells      int    `toml:"niri_scroll_cells"`      // Cells the niri viewport moves per mouse wheel event (default: 8, min: 1, max: 200)
	// PrefixRepeatTime is how long the prefix stays armed after a repeatable
	// prefix command, in milliseconds, so ctrl+b then left left left walks
	// three columns. Zero turns it off. This is tmux's repeat-time.
	PrefixRepeatTime       *int     `toml:"prefix_repeat_time"`
	MaxFPS                 FPSLimit `toml:"max_fps"`                   // Maximum render FPS: 0 uses 60, "auto" follows the display, otherwise 10 to 240
	DockWorkspaceTabs      *bool    `toml:"dock_workspace_tabs"`       // Clickable workspace strip in the dock (default: true)
	DockWorkspaceTabFormat string   `toml:"dock_workspace_tab_format"` // Format string for workspace tabs: {index}, {name} (default: "{name}")
	DockWorkspaceTooltip   *bool    `toml:"dock_workspace_tooltip"`    // Pop a truncated workspace name in full on hover (default: true)
	DockWorkspaceLabelMax  *int     `toml:"dock_workspace_label_max"`  // Cell cap on a workspace pill's label; 0 draws the whole name (default: 12)
	DockPillCaps           *bool    `toml:"dock_pill_caps"`            // Rounded caps on every dock pill (default: true; false draws flat pills)
	DockModeIconWindow     *string  `toml:"dock_mode_icon_window"`     // Mode pill icon in window mode; "" draws none (default: the glyph set's)
	DockModeIconTerminal   *string  `toml:"dock_mode_icon_terminal"`   // Mode pill icon in terminal mode; "" draws none (default: the glyph set's)
	DockModeIconTiling     *string  `toml:"dock_mode_icon_tiling"`     // Mode pill icon while tiling is on; "" draws none (default: the glyph set's)
	DockCompact            bool     `toml:"dock_compact"`              // One-row dock with no rule (default: false)
	SessionColors          *bool    `toml:"session_colors"`            // Give each session its own colour on the rail and the switcher (default: true)
	SessionBorder          *bool    `toml:"session_border"`            // Carry that colour on every pane border too (default: false)
	GlobalSession          *bool    `toml:"global_session"`            // Offer a session that holds panes from several machines (default: true)
	NiriClickReveals       *bool    `toml:"niri_click_reveals"`        // Bring a clicked column fully on screen in the scrolling layout (default: true)
	NiriHoverReveals       *bool    `toml:"niri_hover_reveals"`        // With focus-follows-mouse on, bring the hovered column fully on screen (default: true)
	ZoomAnimation          *bool    `toml:"zoom_animation"`            // Slide a pane between its tile and the zoom box (default: true)
	ZoomBorderless         bool     `toml:"zoom_borderless"`           // A zoomed pane fills the whole pane region with no border (default: false)
	ZoomFollowsFocus       *bool    `toml:"zoom_follows_focus"`        // Hand the zoom to the pane the focus lands on (default: true)
	WindowButtonZoom       *bool    `toml:"window_button_zoom"`        // Carry the zoom control on a tiled pane's title bar (default: true)
	SidebarGitDirty        *bool    `toml:"git_dirty"`                 // Count changed and untracked paths in the rail's git section (default: true)
	Glyphs                 string   `toml:"glyphs"`                    // Chrome glyph set: default, unicode, heavy, ascii, or one from ~/.config/tuios/glyphs
	Gap                    int      `toml:"gap"`                       // Cells of empty space kept between neighbouring tiled panes (default: 0)
	// TilingScheme is the BSP insertion scheme a workspace starts with the
	// first time it is tiled: spiral, longest_side, alternate or smart_split.
	// See TilingSchemes. A workspace that already has a tree keeps its own
	// scheme, set here, by a layout template, or by cycle_tiling_scheme;
	// changing this later does not move it. See GetOrCreateBSPTree.
	TilingScheme string `toml:"tiling_scheme"` // Default BSP insertion scheme for a new workspace (default: spiral)
	// MasterRatio and ScrollColumnWidth are percentages rather than fractions
	// because that is what a settings stepper and a CLI argument can carry: the
	// option registry holds ints, and "50" is a value a person types. The model
	// keeps the master ratio as the fraction the tilers want.
	MasterRatio       int    `toml:"master_ratio"`        // Master pane width in the master-stack layout, percent of the screen (default: 50)
	ScrollColumnWidth int    `toml:"scroll_column_width"` // New column width in the scrolling layout, percent of the screen (default: 55)
	ScrollColumnMax   int    `toml:"scroll_column_max"`   // Highest that width may be set to, percent of the screen (default: 90, up to 100)
	ZoomSize          int    `toml:"zoom_size"`           // How much of the screen a zoomed pane takes, percent (default: 95)
	PanelPadding      int    `toml:"panel_padding"`       // Columns of surface padding inside every overlay panel (default: 2)
	ClockFormat       string `toml:"clock_format"`        // Go time layout the clock overlay is drawn with (default: 15:04:05)
	DimUnfocused      int    `toml:"dim_unfocused"`       // Percent an unfocused pane's content is carried toward its own ground (default: 0)
	DimMultifocus     bool   `toml:"dim_multifocus"`      // Dim the panes in the multifocus set too (default: false)

	// MasterPosition, MasterCount and MasterGrid shape the master-stack layout
	// for a workspace nobody has changed at run time. The actions that change
	// them (cycle_master_position, add_master, remove_master and the rest) act
	// on the current workspace only, and the session keeps what they set.
	MasterPosition string `toml:"master_position"` // Side the master panes take: left, right, top, bottom or center (default: left)
	MasterCount    int    `toml:"master_count"`    // How many panes are masters (default: 1)
	MasterGrid     *bool  `toml:"master_grid"`     // With one master on the left, show four or more panes as a grid (default: true)
	// The backgrounds tuios paints on cells that have none of their own. Each
	// takes off, theme or #RRGGBB. background is the default for every
	// surface; a surface's own key overrides it, and empty follows it. See
	// ResolveBackground.
	Background             string `toml:"background"`               // Ground for every surface not set on its own (default: off)
	PaneBackground         string `toml:"pane_background"`          // Ground behind pane content (default: empty, follows background)
	DesktopBackground      string `toml:"desktop_background"`       // Ground behind and between panes (default: empty, follows background)
	WindowChromeBackground string `toml:"window_chrome_background"` // Ground under pane borders and title bars (default: empty, follows background)
	DockBackground         string `toml:"dock_background"`          // Ground under the dock (default: empty, follows background)

	// Legacy flat sidebar keys, superseded by the [appearance.sidebar] table.
	// migrateLegacySidebar folds them into it and clears them, so they are read
	// from an old file but never written back to a new one.
	SidebarEnabled     *bool  `toml:"sidebar_enabled,omitempty"`
	SidebarPosition    string `toml:"sidebar_position,omitempty"`
	SidebarWidth       int    `toml:"sidebar_width,omitempty"`
	SidebarShowWindows *bool  `toml:"sidebar_show_windows,omitempty"`
	SidebarShowGlyphs  *bool  `toml:"sidebar_show_glyphs,omitempty"`
	SidebarShowCounts  *bool  `toml:"sidebar_show_counts,omitempty"`

	// The tables are last so the TOML encoder emits them after every scalar key
	// of [appearance]; a table written mid-section would swallow the keys that
	// follow it.
	Scrollbar ScrollbarConfig `toml:"scrollbar"`
	// Selection is the [appearance.selection] table: the colours a pane uses to
	// mark text. See SelectionConfig.
	Selection SelectionConfig `toml:"selection"`
	Sidebar   SidebarConfig   `toml:"sidebar"`
}

type ApprovalsConfig struct {
	// Enabled lists the harnesses whose approvals the Inbox may answer, by
	// harness id or alias (claude, claude-code, opencode, kilo, qwen). Empty, the
	// default, turns the feature off.
	Enabled []string `toml:"enabled,omitempty"`
	// HoldSeconds is how long a hook waits for an answer before it gives the
	// prompt back to the harness. Zero means the default, 120. The daemon
	// keeps it between 10 and 300, and the Claude Code hook tuios installs
	// allows 310 seconds, so a hold never outlives the hook.
	HoldSeconds int `toml:"hold_seconds,omitempty"`
	// HoldPlans also hands a plan an agent in plan mode asks to have
	// approved to the Inbox, for the harnesses Enabled names. Unset means
	// true: a plan follows enabled. See PlansHeld.
	HoldPlans *bool `toml:"hold_plans,omitempty"`
	// Risk is the [agents.approvals.risk] table: the rules that mark an
	// approval risky. See RiskConfig.
	Risk RiskConfig `toml:"risk,omitempty"`
}

type AutoEnterTerminalPolicy string

type Binding struct {
	Scope   string `json:"scope"`
	Section string `json:"section"`
	Action  string `json:"action"`
	Desc    string `json:"description"`
	// Key is the key as the lookup sees it, after the normalizer's platform
	// expansion has been undone: what the user wrote in config.toml.
	Key string `json:"key"`
	// Press is the whole thing to press, chord included.
	Press string `json:"press"`
	// Shadowed is set when an earlier claimant in the same scope already took
	// the key, so pressing it runs that other action instead of this one.
	Shadowed bool `json:"shadowed"`
	// ShadowedBy names the action that actually runs, when Shadowed.
	ShadowedBy string `json:"shadowed_by,omitempty"`
	// Unbound is set on the one row an action with no keys still gets. Key and
	// Press are empty on such a row.
	//
	// It is listed rather than left out because the alternative is a one-way
	// door: an action taken off its key would vanish from every surface that
	// reads this, and the overlay binds a key by selecting the action's row.
	// Unbinding something and then being unable to find it again is not an
	// unbind, it is a loss.
	Unbound bool `json:"unbound,omitempty"`
}

type CheckpointsConfig struct {
	// Enabled saves a checkpoint of a pane's git work tree each time its
	// agent finishes a turn. Unset means true.
	Enabled *bool `toml:"enabled,omitempty"`
	// Keep is how many checkpoints one pane keeps. Zero means the default,
	// 50; values past 1000 read as 1000.
	Keep int `toml:"keep,omitempty"`
	// MaxUntrackedMB is the size past which an untracked file is left out
	// of a checkpoint, in megabytes. Zero means the default, 50. A negative
	// value means no limit.
	MaxUntrackedMB int `toml:"max_untracked_mb,omitempty"`
}

type Collision struct {
	Scope     string `json:"scope"`
	ScopeName string `json:"scope_name"`
	Key       string `json:"key"`
	Press     string `json:"press"`
	// Winner is the action the key actually runs.
	Winner     string `json:"winner"`
	WinnerDesc string `json:"winner_description"`
	// Losers are the actions bound to the same key that never run.
	Losers []CollisionLoser `json:"losers"`
	// CrossSection is true when the competing actions came from different
	// tables in config.toml. Those are the ones worth flagging loudest: the two
	// bindings look unrelated in the file, and nothing in the TOML hints that
	// one of them is dead.
	CrossSection bool     `json:"cross_section"`
	Evidence     Evidence `json:"evidence"`
}

type CollisionLoser struct {
	Action  string `json:"action"`
	Desc    string `json:"description"`
	Section string `json:"section"`
}

type CommandBinding struct {
	// Key is the key that runs the command. "prefix+" puts it after the
	// leader. Any other key acts in window mode and terminal mode.
	Key string `toml:"key"`
	// Type is scratch, popup, pane or shell. Empty means popup.
	Type string `toml:"type,omitempty"`
	// Command is run by sh -c, so it can hold pipes and quotes. A scratch
	// entry with no command runs the user's shell.
	Command string `toml:"command,omitempty"`
	// Description names the entry in the command palette and in
	// tuios keybinds list. Optional.
	Description string `toml:"description,omitempty"`
	// Name is the entry's stable name. Optional: see ResolvedName.
	Name string `toml:"name,omitempty"`
	// Width and Height size a scratch or popup entry, in cells (60) or
	// percent (80%) of the pane region. Empty means 80%.
	Width  string `toml:"width,omitempty"`
	Height string `toml:"height,omitempty"`
}

type CommandProblem struct {
	// Entry is the entry's place in config.toml, from 1.
	Entry int    `json:"entry"`
	Key   string `json:"key"`
	// Name is the name tuios gives the entry, when it can make one.
	Name string `json:"name,omitempty"`
	// Ignored is true when tuios leaves the entry out.
	Ignored bool   `json:"ignored"`
	Problem string `json:"problem"`
}

type ConfigLayer struct {
	// Path is the file as named, made absolute. A symlink is not resolved, so
	// the listing shows the path the person wrote.
	Path string
	// Real is Path with its symlinks resolved. The watcher follows both.
	Real string
	Kind LayerKind
	// From is the file whose include list named this one, empty for the main
	// file and the config.d files.
	From string
	// Data is the file as read. It is nil for a main file that is not there
	// yet.
	Data []byte
	// Values is the file parsed, without its include key, and with the
	// relative file paths of an included file made absolute.
	Values map[string]any
}

type ConfigReloadCallback func(newConfig *UserConfig, err error)

type CopyModeProblem struct {
	Action  string `json:"action"`
	Key     string `json:"key"`
	Problem string `json:"problem"`
}

type CopyPipeBinding struct {
	// Key is the copy-mode key, written as elsewhere in the config.
	Key string `toml:"key"`
	// Command is run by sh -c with the selection on stdin. What it writes to
	// stdout goes to the clipboard.
	Command string `toml:"command"`
	// Cancel leaves copy mode after the yank (copy-pipe-and-cancel). False
	// stays in copy mode at the same place (copy-pipe).
	Cancel bool `toml:"cancel,omitempty"`
	// Description names the entry in the dock messages. Optional.
	Description string `toml:"description,omitempty"`
}

type DaemonConfig struct {
	LogLevel string `toml:"log_level"` // Debug log level: off, errors, basic, messages, verbose, trace (default: off)
	// AgentAutoDetect toggles automatic detection of a pane's foreground AI-agent
	// CLI (claude, codex, aider, ...), which sets the pane's agent-state glyph
	// without set-agent-state. Nil means enabled (the default); set to false to
	// turn it off.
	AgentAutoDetect *bool `toml:"agent_autodetect"`
	// AgentDetectSeconds overrides how often the auto-detector polls each pane, in
	// seconds. Zero uses the default (2s); a negative value disables detection.
	AgentDetectSeconds int `toml:"agent_detect_seconds"`
	// AgentBinaries lists extra binary names to treat as agents, merged with the
	// built-in defaults (not replacing them).
	AgentBinaries []string `toml:"agent_binaries"`
	// RespondFromShell lets `tuios respond`, run from a shell outside every
	// pane, answer an agent's prompt without an attached client. Off by default:
	// respond is then for the person at the Inbox of an attached client. A
	// caller inside a pane is refused either way.
	RespondFromShell bool `toml:"respond_from_shell"`
	// ResumeAgents is what a daemon restart does with the agent conversations
	// the restored panes were running: "ask" (the default) puts one Inbox item
	// per pane that the person answers, "auto" types each harness's resume
	// command into its restored shell, and "off" does neither. The processes
	// themselves never survive a restart; this brings back the conversation.
	ResumeAgents string `toml:"resume_agents"`
	// PersistScrollback saves each pane's history with its session, and a
	// restore after a daemon restart or a reboot shows it again above the new
	// shell. Nil means on, the default. The files hold whatever the panes
	// printed, secrets included, so false is for the person who does not want
	// that on disk; turning it off deletes what was saved when the daemon
	// next starts.
	PersistScrollback *bool `toml:"persist_scrollback"`
	// PersistScrollbackLines is the most history lines one pane saves, the
	// screen not counted. Zero means 1000.
	PersistScrollbackLines int `toml:"persist_scrollback_lines"`
	// PersistScrollbackKB is the most one pane's saved history takes on
	// disk, compressed, in KiB. Zero means 2048. A pane over it saves fewer
	// lines.
	PersistScrollbackKB int `toml:"persist_scrollback_kb"`
	// WindowSize decides the size of a session with more than one client
	// attached, as tmux's window-size option does: "smallest" (the default)
	// takes the smallest client, "largest" the largest, and "latest" the
	// client that last had input. A client smaller than the session shows
	// the part of it around the focused pane's cursor.
	WindowSize string `toml:"window_size"`
	// SingleClient keeps one client per session, like tmux's attach -d on
	// every attach: a client that attaches takes the other clients off the
	// session, and each of them exits with a message. Off by default.
	SingleClient bool `toml:"single_client"`
	// SSHAgent is "follow" to keep, for each session, a link to the ssh
	// agent socket of the client that attached or used it last, and give
	// new panes SSH_AUTH_SOCK naming the link. "off", the default, or empty
	// leaves SSH_AUTH_SOCK as the daemon has it.
	SSHAgent string `toml:"ssh_agent"`
}

type DebugConfig struct {
	// ShowKeyEvents enables the on-screen showkeys overlay, a bottom-right
	// keycast that shows the last several keypresses as styled pills in both
	// window management and terminal mode. The same overlay is toggled by the
	// --show-keys flag, the settings entry, the command palette, and the
	// leader-D-k keybinding. Default false.
	ShowKeyEvents bool `toml:"show_key_events"`
}

type DockClockConfig struct {
	// Format is a Go reference-time layout, e.g. "15:04" or "Mon 15:04:05".
	// The refresh cadence is derived from it: a layout showing seconds is
	// scheduled to the next second, one without to the next minute.
	Format string `toml:"format,omitempty"`
}

type DockConfig struct {
	Left   *[]string `toml:"left,omitempty"`
	Center *[]string `toml:"center,omitempty"`
	Right  *[]string `toml:"right,omitempty"`

	// Clock is [dock.clock]: the format the clock component and the status
	// badge both render. Empty means the built-in default.
	Clock DockClockConfig `toml:"clock"`

	// Custom is the set of [dock.custom.NAME] tables. A list entry of
	// "custom/NAME" draws the cell this table describes.
	Custom map[string]DockCustomConfig `toml:"custom,omitempty"`
}

type DockCustomConfig struct {
	// Command is run through sh -c. Its first line of stdout is the cell.
	Command string `toml:"command"`

	// Refresh is when to run it: "once" (the default), a duration such as
	// "30s", "push" (the command stays running and each line it writes is an
	// update), or "event:TYPE[,TYPE]" (re-run when the daemon reports one).
	Refresh string `toml:"refresh,omitempty"`

	// OnClick is run through sh -c when the cell is clicked, like a hook.
	OnClick string `toml:"on-click,omitempty"`

	// MaxWidth caps the cell in cells; 0 takes DockCustomDefaultMaxWidth.
	MaxWidth int `toml:"max-width,omitempty"`
}

type DockRefresh struct {
	Kind     DockRefreshKind
	Interval time.Duration
	Events   []string
}

type DockRefreshKind int

type DroppedKey struct {
	// File is the config file that sets the key, as DisplayPath writes it,
	// or "config.toml" when the files are not known.
	File string `json:"file"`
	// Section is the config table, or "keybindings" for the leader.
	Section string `json:"section"`
	// Action is the action the key was bound to, or "leader_key".
	Action string `json:"action"`
	Key    string `json:"key"`
	// Problem is what is wrong, in the validator's words.
	Problem string `json:"problem"`
	// Fallback is the key the action uses now: the default key when the
	// action had no other key, or the default leader. It is empty when the
	// action kept another key of its own, or when every default key was
	// already another action's.
	Fallback []string `json:"fallback,omitempty"`
	// TakenBy is the action that holds the default key, when the action got
	// no key back because of it.
	TakenBy string `json:"taken_by,omitempty"`
	// KeptOthers is true when the action still has another key of its own.
	KeptOthers bool `json:"kept_others,omitempty"`
}

type Evidence string

type FPSLimit string

type GlyphEnv uint8

type GuestClash struct {
	Key string `json:"key"`
	// TuiosAction is what tuios does with the key instead.
	TuiosAction string `json:"tuios_action"`
	TuiosDesc   string `json:"tuios_description"`
	Program     string `json:"program"`
	// ProgramUse is what the program would have done with it.
	ProgramUse string `json:"program_use"`
	Note       string `json:"note"`
	// Evidence is EvidenceReference for every entry here, and it is carried
	// explicitly so a consumer never has to infer it from the field's name.
	Evidence Evidence `json:"evidence"`
	// Running is true when the pane that was inspected is actually running this
	// program, which lifts the finding from "some day" to "right now". The
	// clash itself stays reference-tier either way: knowing nvim is running is
	// observation, knowing nvim wants ctrl+w is not.
	Running bool `json:"running"`
}

type GuestProgram struct {
	// Name is what to call it on screen.
	Name string
	// Comms are the process names it appears under in the foreground process
	// group, used to raise an entry from reference to "this is what is running".
	Comms []string
	// Keys maps a key to what the program does with it. Deliberately short: the
	// entries earn their place by colliding with something tuios binds or by
	// being the program's prefix, not by being complete. A complete keymap for
	// vim would be a lie told at length.
	Keys map[string]string
	// Note is the one sentence a user needs about this program's claim.
	Note string
}

type HintsConfig struct {
	// Builtins names the built-in patterns in use: "all", "none", or a comma
	// separated list such as "url,path,sha" (default: all).
	Builtins string `toml:"builtins"`
	// Patterns are more regular expressions to look for, in Go syntax. A
	// group named match narrows what is copied: "branch: (?P<match>\S+)".
	Patterns []string `toml:"patterns"`
	// Alphabet is the letters labels are made of, nearest match first
	// (default: asdfghjkl). Lowercase letters only.
	Alphabet string `toml:"alphabet"`
	// Open lets Ctrl and a label open a URL or a path (default: true).
	Open *bool `toml:"open"`
	// Dim is the percent of its light the text around the matches loses
	// (default: 60).
	Dim int `toml:"dim"`
	// AllPanes makes the hints action label every pane the workspace shows,
	// as hints_all_panes does, instead of the focused pane only
	// (default: false).
	AllPanes bool `toml:"all_panes"`
}

type HooksConfig map[string]any

type HostConfig struct {
	// Addr is anything ssh understands, ssh_config aliases included. A host
	// with no addr is ignored, and the daemon logs why.
	Addr string `toml:"addr"`
	// ConnectTimeout is how many seconds one dial may take before the host is
	// called unreachable. Zero uses the built-in default. It is also handed to
	// ssh, so a machine that is powered off is reported rather than waited on.
	ConnectTimeout int `toml:"connect_timeout,omitempty"`
	// Command is the tuios binary on the far side. Empty means the link finds
	// one itself: on the PATH, at the known install paths, or through the
	// login shell. Set it to run a given binary instead; nothing is then
	// looked for.
	Command string `toml:"command,omitempty"`
	// SSHOptions are extra arguments passed to ssh before the address, for a
	// host that needs a flag ssh_config cannot carry.
	SSHOptions []string `toml:"ssh_options,omitempty"`
	// ReposRoot is the directory on the host where its checkouts live. When
	// a command on this machine names a repository on the host by its origin
	// URL (fan --host, worktree new --host, start-agent -s HOST:SESSION), the
	// host looks for the checkout under it, and clones into it with --clone.
	// Empty lets the host look under its usual source directories. It is a
	// path on the host, written the way the host reads it: absolute, or
	// starting with ~/ for the host's home.
	ReposRoot string `toml:"repos_root,omitempty"`
	// TailscaleLogin is the origin of a Headscale server that sends this
	// host's Tailscale SSH check, such as "https://headscale.example". tuios
	// shows and opens a sign-in link only on Tailscale's own login origins
	// and on this one, because the banner that carries the link can be
	// printed by anything on the host.
	TailscaleLogin string `toml:"tailscale_login,omitempty"`

	// Allow is the capabilities the machine gets, from LinkCapabilities. Nil
	// inherits [hosts."*"] and then DefaultLinkAllow; an empty list allows
	// nothing.
	Allow []string `toml:"allow,omitempty"`
	// HoldMail, when true, holds mail from the machine in the Inbox until the
	// person passes it on. Nil inherits.
	HoldMail *bool `toml:"hold_mail,omitempty"`
	// HostedGrace is how long a pane this machine runs for the other one
	// outlives a dropped link, waiting to be reattached, as a Go duration
	// such as "10m". "0" ends it with the link. Empty inherits.
	HostedGrace string `toml:"hosted_grace,omitempty"`
}

type HostTerminal string

type KeyFate struct {
	Key string `json:"key"`
	// ReadAs is the spelling tuios matches the key in, when it differs from
	// Key by more than case: opt+f12 is read as alt+f12.
	ReadAs string `json:"read_as,omitempty"`
	// Acts is every scope the key does something in.
	Acts []Binding `json:"acts"`
	// SwallowedInTerminal is set when the key does not reach the pane's program
	// while typing, with the reason.
	SwallowedInTerminal bool   `json:"swallowed_in_terminal"`
	SwallowReason       string `json:"swallow_reason,omitempty"`
	// Ambiguity is the terminal-level pair the key belongs to, if any.
	Ambiguity string `json:"ambiguity,omitempty"`
	// GuestWants is every curated program that binds this key.
	GuestWants []GuestClash `json:"guest_wants,omitempty"`
	// Free is true when nothing in tuios claims the key in any scope.
	Free bool `json:"free"`
}

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

type KeyOrigin struct {
	// Key is the dotted path. An entry of an array of tables is written
	// with its name, or its key, in brackets, such as
	// keybindings.command[ctrl+g].
	Key string
	// File is the file whose value is in force.
	File string
	// Hidden are the earlier files that also set it, whose values lose.
	Hidden []string
}

type KeyProblem struct {
	// Section is the config table, or "keybindings" for the leader.
	Section string `json:"section"`
	// Action is the action the key is bound to, or "leader_key".
	Action string `json:"action"`
	Key    string `json:"key"`
	// Problem is what is wrong, in the validator's words.
	Problem string `json:"problem"`
	// File is the config file that sets the key.
	File string `json:"file"`
	// Outcome says what tuios does instead: the action uses its default
	// key, the leader is the default leader, or no key press matches.
	Outcome  string   `json:"outcome"`
	Evidence Evidence `json:"evidence"`
}

type KeyReadAs struct {
	// Section is the config table, or "keybindings" for the leader.
	Section string `json:"section"`
	// Action is the action the key is bound to, or "leader_key".
	Action string `json:"action"`
	Key    string `json:"key"`
	ReadAs string `json:"read_as"`
}

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

type KeybindReport struct {
	Leader string `json:"leader"`
	// LeaderReadAs is the spelling tuios matches the leader in, when it
	// differs from Leader by more than case.
	LeaderReadAs string `json:"leader_read_as,omitempty"`
	// KeyProblems are the keys in config.toml that tuios cannot read.
	KeyProblems []KeyProblem `json:"key_problems"`
	// OptionKeys are the opt+ and option+ keys tuios reads as alt+ off
	// macOS. They are information, not problems: a config.toml shared with a
	// Mac works as it is.
	OptionKeys []KeyReadAs `json:"option_keys_read_as_alt,omitempty"`
	// CommandProblems are the [[keybindings.command]] entries tuios ignores
	// or warns about, in the validator's words.
	CommandProblems []CommandProblem `json:"command_problems"`
	// CopyModeProblems are the [keybindings.copy_mode] keys that a copy pipe
	// entry or one of copy mode's own keys also uses.
	CopyModeProblems []CopyModeProblem `json:"copy_mode_problems"`
	// EvidenceNote is the report explaining its own tiers. It ships inside the
	// payload because a consumer that only ever sees the JSON has nowhere else
	// to learn that one third of it is a curated list.
	EvidenceNote map[Evidence]string `json:"evidence_note"`
	Pane         PaneFacts           `json:"pane"`
	Observations []Observation       `json:"observations"`
	Bindings     []Binding           `json:"bindings"`
	Collisions   []Collision         `json:"collisions"`
	Swallowed    []Swallow           `json:"terminal_mode_swallowed"`
	GuestClashes []GuestClash        `json:"guest_clashes"`
	Ambiguous    []AmbiguousBinding  `json:"ambiguous_bindings"`
	// Yielded are new default bindings tuios left off because the key was
	// already bound to another action in the same table.
	Yielded []YieldedDefault `json:"yielded_defaults,omitempty"`
}

type Keybinding struct {
	Key         string
	Description string
	// Submenu marks a key that opens another prefix menu rather than doing
	// something itself. The panel draws it with a leading + so nested menus
	// can be told from actions at a glance.
	Submenu bool
	// Action names the row: the first action the menu built it from. It
	// stays the same when the row's keys are rebound, so code that finds a
	// row finds it by this and never by the keys a config may have moved.
	Action string
}

type KeybindingGroup struct {
	Title    string
	Bindings []Keybinding
}

type KeybindingsConfig struct {
	LeaderKey        string              `toml:"leader_key"` // Leader key for prefix commands (default: ctrl+b)
	WindowManagement map[string][]string `toml:"window_management"`
	Workspaces       map[string][]string `toml:"workspaces"`
	Layout           map[string][]string `toml:"layout"`
	ModeControl      map[string][]string `toml:"mode_control"`
	System           map[string][]string `toml:"system"`
	Navigation       map[string][]string `toml:"navigation"`
	RestoreMinimized map[string][]string `toml:"restore_minimized"`
	PrefixMode       map[string][]string `toml:"prefix_mode"`
	WindowPrefix     map[string][]string `toml:"window_prefix"`
	MinimizePrefix   map[string][]string `toml:"minimize_prefix"`
	WorkspacePrefix  map[string][]string `toml:"workspace_prefix"`
	DebugPrefix      map[string][]string `toml:"debug_prefix"`
	TapePrefix       map[string][]string `toml:"tape_prefix"`
	LayoutPrefix     map[string][]string `toml:"layout_prefix"`
	TerminalMode     map[string][]string `toml:"terminal_mode"` // Direct keybinds in terminal mode (no prefix required)
	// Global binds are consulted in window mode and in terminal mode alike, so
	// the palette and the launcher answer to one key wherever the user is. They
	// are a section of their own rather than entries in terminal_mode because
	// they are not terminal-mode-only, and rather than literals in the input
	// path because a key nobody can rebind is a key nobody can inspect.
	Global map[string][]string `toml:"global"`
	// Command is the [[keybindings.command]] entries: a key that runs a
	// command the user writes. See command_keys.go.
	Command []CommandBinding `toml:"command,omitempty"`
	// CopyPipe is the [[keybindings.copy_pipe]] entries: a copy-mode key
	// that pipes the selection through a command. See copy_pipe.go.
	CopyPipe []CopyPipeBinding `toml:"copy_pipe,omitempty"`
	// Script binds are live only while a .tape is playing back. Its own section
	// because it is its own keyboard context: sharing ctrl+p with the palette by
	// default is not a conflict, since only one of the two contexts is ever
	// active.
	Script map[string][]string `toml:"script"`
	// Sidebar binds are looked up only while the rail owns the keyboard
	// (SidebarFocused), through GetSidebarAction. They are deliberately kept out
	// of buildMappings: that flattens sections into the global keymap, which would
	// leak rail keys (j/k/h/l/enter) onto panes.
	Sidebar map[string][]string `toml:"sidebar"`
	// SidebarFiles binds are looked up before Sidebar, and only while the rail's
	// cursor is on a row of the files section. See
	// getDefaultSidebarFilesKeybinds for why they are not in Sidebar.
	SidebarFiles map[string][]string `toml:"sidebar_files"`
	// SidebarAgents binds are looked up before Sidebar, and only while the
	// rail's cursor is on an agent row. See getDefaultSidebarAgentsKeybinds.
	SidebarAgents map[string][]string `toml:"sidebar_agents"`
	// Inbox binds are live while the Inbox is open and its selector line is
	// not, through GetInboxAction. The digits 1 to 9 are not in it: they
	// answer a held approval or a question by its number, which is the number
	// the prompt itself shows. See getDefaultInboxKeybinds.
	Inbox map[string][]string `toml:"inbox"`
	// InboxPeek binds are live while a prompt is open over the Inbox and its
	// text line is not. A scope of its own because d dismisses in the list and
	// denies in the peek.
	InboxPeek map[string][]string `toml:"inbox_peek"`
	// Mail binds are live while the mailbox is open and no reply is being
	// written.
	Mail map[string][]string `toml:"mail"`
	// CopyMode binds are live while a pane is in copy mode, in normal and
	// visual selection. Copy mode's vim motions are fixed keys and are not
	// here. See getDefaultCopyModeKeybinds.
	CopyMode map[string][]string `toml:"copy_mode"`
}

type LauncherConfig struct {
	// GUICommand is a command that starts a graphical desktop entry instead of
	// a new pane. The entry's argv is appended to it. With it empty, every
	// entry runs in a pane, as before.
	//
	// It exists for a Wayland compositor that shows its windows as panes
	// (tuios-wayland launch --), and works as well for one that does not
	// (niri msg action spawn --).
	//
	// tuios runs the argv directly, but the command it names may not. A
	// spawn command that joins its arguments into one shell line (swaymsg
	// exec --, hyprctl dispatch exec) turns the text of a desktop entry,
	// which any installed package can write, into shell code. Only commands
	// that keep the argv as an argv are safe here.
	GUICommand string `toml:"gui_command"`
}

type LayerKind int

type LayeredConfig struct {
	// Main is the path of config.toml.
	Main string
	// Layers are the files in merge order, lowest precedence first. The main
	// file is last.
	Layers []ConfigLayer
	// Missing are the included files that were not there, as resolved paths,
	// optional ones included. The watcher follows them.
	Missing []string
	// Warnings say what was skipped and why.
	Warnings []string
	// Layered is true when config.toml has an include key or a config.d
	// directory exists.
	Layered bool
	// DropInDir is the config.d directory, whether or not it exists.
	DropInDir string
	// MainMissing is true when config.toml is not there yet. Only a load for a
	// write accepts that.
	MainMissing bool
	// contains filtered or unexported fields
}

type LinkPolicy struct {
	// Peer is the name the machine arrived under, empty when it gave none.
	Peer string
	// Allow is the capabilities it has, a subset of LinkCapabilities.
	Allow []string
	// HoldMail holds its mail in the Inbox until the person passes it on.
	HoldMail bool
	// HostedGrace is how long a pane run for it outlives a dropped link.
	HostedGrace time.Duration
	// Source names the table the policy came from, for an error that tells
	// the caller which key to change: hosts.laptop, hosts."*", or empty for
	// the built-in default.
	Source string
}

type MailAlertPolicy struct {
	AgentAlertPolicy
	// BetweenAgents is true when a message between two agents alerts too.
	BetweenAgents bool
}

type MailAlertsConfig struct {
	// Enabled is the switch for mail alerts. Unset follows
	// notifications.agent.enabled.
	Enabled *bool `toml:"enabled"`

	// Notify writes a desktop notification to the attached terminal. Unset
	// follows notifications.agent.notify.
	Notify *bool `toml:"notify"`

	// Sound makes a mail alert audible, the way notifications.agent.sound_mode
	// says. Unset follows notifications.agent.sound.
	Sound *bool `toml:"sound"`

	// Dock shows the alert in the dock, where a click opens the thread. Unset
	// follows notifications.agent.dock.
	Dock *bool `toml:"dock"`

	// BetweenAgents alerts on a message from one agent to another as well.
	// Such a message only counts on the recipient's rail row otherwise, since
	// it is the two agents' business. Default: false.
	BetweenAgents *bool `toml:"between_agents"`
}

type MenuState struct {
	// Daemon swaps the leader menu's detach and quit rows: in a daemon
	// session d detaches and q opens the quit menu.
	Daemon bool
	// MultiCopy is the number of panes multi copy mode would take, zero when
	// it is off. The copy-mode row says so when it is on.
	MultiCopy int
	// Spotlight is set while the spotlight is on, and the sidebar row then
	// says the key turns it off.
	Spotlight bool
	// Minimized is the number of minimized windows the restore row counts,
	// or -1 to leave the count out.
	Minimized int
}

type NotificationsConfig struct {
	// Duration is how long an info or success message stays up, in seconds.
	Duration int `toml:"duration"`

	// WarningDuration is how long a warning stays up, in seconds.
	WarningDuration int `toml:"warning_duration"`

	// ErrorDuration is how long an error stays up, in seconds, when
	// error_sticky is false.
	ErrorDuration int `toml:"error_duration"`

	// ErrorSticky makes errors wait for esc instead of expiring (default true).
	ErrorSticky *bool `toml:"error_sticky"`

	// Agent is the [notifications.agent] table: what happens when a pane's
	// agent state changes. See agent_alerts.go.
	Agent AgentAlertsConfig `toml:"agent"`

	// Mail is the [notifications.mail] table: what happens when agent mail
	// arrives for the person. A key it leaves out follows the same key in
	// Agent. See mail_alerts.go.
	Mail MailAlertsConfig `toml:"mail"`
}

type NotifyConfig struct {
	// Enabled is the master switch. Nothing is sent without a provider, so
	// the default is on. Default: true.
	Enabled *bool `toml:"enabled,omitempty"`

	// WebURL is the public address of tuios-web. When it is set, every
	// notification links to the Inbox item there. Default: empty (no link).
	WebURL string `toml:"web_url,omitempty"`

	// Content is how much a notification says: "summary" (the title and the
	// one line the Inbox shows) or "title" (only what kind of item it is and
	// the session). Default: "summary".
	Content string `toml:"content,omitempty"`

	// QuietActiveSeconds holds a notification while a person typed at an
	// attached client in the last this many seconds, so the person at the
	// desk is not told twice. When they stay away that long and the item is
	// still open, it is sent. Zero sends at once. Default: 120.
	QuietActiveSeconds *int `toml:"quiet_active_seconds,omitempty"`

	// CooldownSeconds is the shortest gap between two notifications for the
	// same pane and kind. Default: 60.
	CooldownSeconds *int `toml:"cooldown_seconds,omitempty"`

	// MaxPerHour bounds every notification together. Default: 30.
	MaxPerHour *int `toml:"max_per_hour,omitempty"`

	// AllowHTTPRedirects lets a provider's https address redirect to a plain
	// http one. Default: false.
	AllowHTTPRedirects bool `toml:"allow_http_redirects,omitempty"`

	// Triggers says which Inbox kinds send a notification.
	Triggers NotifyTriggers `toml:"triggers,omitempty"`

	// The providers. Each one set gets every notification.
	Ntfy     *NtfyConfig     `toml:"ntfy,omitempty"`
	Pushover *PushoverConfig `toml:"pushover,omitempty"`
	Webhook  *WebhookConfig  `toml:"webhook,omitempty"`
}