@oh-my-pi/pi-coding-agent 15.11.3 → 15.11.4

package/dist/types/config/settings-schema.d.ts

@@ -1,15 +1,19 @@
 /** Unified settings schema - single source of truth for all settings.
- * Unified settings schema - single source of truth for all settings.
  *
  * Each setting is defined once here with:
  * - Type and default value
- * - Optional UI metadata (label, description, tab)
+ * - Optional UI metadata (label, description, tab, group)
+ *
+ * UI metadata places the setting in the settings panel: `tab` picks the
+ * panel tab, `group` the titled section within it (registered in
+ * TAB_GROUPS). Sections render in TAB_GROUPS order; settings within a
+ * section keep declaration order.
  *
  * The Settings singleton provides type-safe path-based access:
  *   settings.get("compaction.enabled")  // => boolean
  *   settings.set("theme.dark", "titanium")  // sync, saves in background
  */
-export type SettingTab = "appearance" | "model" | "interaction" | "context" | "memory" | "editing" | "tools" | "tasks" | "providers";
+export type SettingTab = "appearance" | "model" | "interaction" | "context" | "memory" | "files" | "shell" | "tools" | "tasks" | "providers";
 /** Tab display metadata - icon is resolved via theme.symbol() */
 export type TabMetadata = {
     label: string;
@@ -22,6 +26,12 @@ export declare const TAB_METADATA: Record<SettingTab, {
     label: string;
     icon: `tab.${string}`;
 }>;
+/**
+ * Ordered section groups per tab. Settings declare their section via `ui.group`;
+ * the settings UI renders groups in this order with a heading row between them.
+ * Ungrouped settings render first, before any section heading.
+ */
+export declare const TAB_GROUPS: Record<SettingTab, readonly string[]>;
 /** Status line segment identifiers */
 export type StatusLineSegmentId = "pi" | "model" | "mode" | "path" | "git" | "pr" | "subagents" | "token_in" | "token_out" | "token_total" | "token_rate" | "cost" | "context_pct" | "context_total" | "time_spent" | "time" | "session" | "hostname" | "cache_read" | "cache_write" | "cache_hit" | "session_name" | "usage";
 /** Submenu choice metadata. */
@@ -32,6 +42,8 @@ export type SubmenuOption<V extends string = string> = {
 };
 interface UiBase {
     tab: SettingTab;
+    /** Section within the tab; must be listed in TAB_GROUPS[tab]. Ungrouped settings render at the top. */
+    group?: string;
     label: string;
     description: string;
     /** Condition function name - setting only shown when true */
@@ -118,6 +130,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "interaction";
+            readonly group: "Startup & Updates";
             readonly label: "Auto Resume";
             readonly description: "Automatically resume the most recent session in the current directory";
         };
@@ -127,8 +140,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "interaction";
-            readonly label: "Prevent Idle Sleep (macOS)";
-            readonly description: "caffeinate -i: keep the system awake while a session is open";
+            readonly group: "Power (macOS)";
+            readonly label: "Prevent Idle Sleep";
+            readonly description: "Keep the system awake while a session is open (caffeinate -i)";
         };
     };
     readonly "power.preventSystemSleep": {
@@ -136,8 +150,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "interaction";
-            readonly label: "Prevent System Sleep on AC (macOS)";
-            readonly description: "caffeinate -s: block all system sleep while on AC power";
+            readonly group: "Power (macOS)";
+            readonly label: "Prevent System Sleep on AC";
+            readonly description: "Block all system sleep while on AC power (caffeinate -s)";
         };
     };
     readonly "power.declareUserActive": {
@@ -145,8 +160,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "interaction";
-            readonly label: "Declare User Active (macOS)";
-            readonly description: "caffeinate -u: keep the display lit and treat the user as active";
+            readonly group: "Power (macOS)";
+            readonly label: "Declare User Active";
+            readonly description: "Keep the display lit and treat the user as active (caffeinate -u)";
         };
     };
     readonly "power.preventDisplaySleep": {
@@ -154,8 +170,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "interaction";
-            readonly label: "Prevent Display Sleep (macOS)";
-            readonly description: "caffeinate -d: keep the display from idle-sleeping while a session is open";
+            readonly group: "Power (macOS)";
+            readonly label: "Prevent Display Sleep";
+            readonly description: "Keep the display from idle-sleeping while a session is open (caffeinate -d)";
         };
     };
     readonly shellPath: {
@@ -166,29 +183,6 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "array";
         readonly default: string[];
     };
-    readonly "marketplace.autoUpdate": {
-        readonly type: "enum";
-        readonly values: readonly ["off", "notify", "auto"];
-        readonly default: "notify";
-        readonly ui: {
-            readonly tab: "tools";
-            readonly label: "Marketplace Auto-Update";
-            readonly description: "Check for plugin updates on startup (off/notify/auto)";
-            readonly options: readonly [{
-                readonly value: "off";
-                readonly label: "Off";
-                readonly description: "Don't check for plugin updates";
-            }, {
-                readonly value: "notify";
-                readonly label: "Notify";
-                readonly description: "Check on startup and notify when updates are available";
-            }, {
-                readonly value: "auto";
-                readonly label: "Auto";
-                readonly description: "Check on startup and auto-install updates";
-            }];
-        };
-    };
     readonly enabledModels: {
         readonly type: "array";
         readonly default: string[];
@@ -222,8 +216,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "titanium";
         readonly ui: {
             readonly tab: "appearance";
+            readonly group: "Theme";
             readonly label: "Dark Theme";
-            readonly description: "Theme used when terminal has dark background";
+            readonly description: "Theme used when the terminal has a dark background";
             readonly options: "runtime";
         };
     };
@@ -232,8 +227,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "light";
         readonly ui: {
             readonly tab: "appearance";
+            readonly group: "Theme";
             readonly label: "Light Theme";
-            readonly description: "Theme used when terminal has light background";
+            readonly description: "Theme used when the terminal has a light background";
             readonly options: "runtime";
         };
     };
@@ -243,8 +239,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "unicode";
         readonly ui: {
             readonly tab: "appearance";
+            readonly group: "Theme";
             readonly label: "Symbol Preset";
-            readonly description: "Icon/symbol style";
+            readonly description: "Glyph set for icons and symbols (Unicode, Nerd Font, or ASCII)";
             readonly options: readonly [{
                 readonly value: "unicode";
                 readonly label: "Unicode";
@@ -265,6 +262,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "appearance";
+            readonly group: "Theme";
             readonly label: "Color-Blind Mode";
             readonly description: "Use blue instead of green for diff additions";
         };
@@ -275,6 +273,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "default";
         readonly ui: {
             readonly tab: "appearance";
+            readonly group: "Status Line";
             readonly label: "Status Line Preset";
             readonly description: "Pre-built status line configurations";
             readonly options: readonly [{
@@ -314,6 +313,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "powerline-thin";
         readonly ui: {
             readonly tab: "appearance";
+            readonly group: "Status Line";
             readonly label: "Status Line Separator";
             readonly description: "Style of separators between segments";
             readonly options: readonly [{
@@ -352,6 +352,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "appearance";
+            readonly group: "Status Line";
             readonly label: "Session Accent";
             readonly description: "Use the session name color for the editor border and status line gap";
         };
@@ -361,6 +362,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "appearance";
+            readonly group: "Status Line";
             readonly label: "Transparent Status Line";
             readonly description: "Use the terminal's default background for the status line instead of the theme's `statusLineBg`. Powerline end caps are dropped because they need a contrasting fill to bridge into the surrounding terminal.";
         };
@@ -370,7 +372,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 50;
         readonly ui: {
             readonly tab: "tools";
-            readonly label: "Artifact spill threshold (KB)";
+            readonly group: "Output Limits";
+            readonly label: "Artifact Spill Threshold (KB)";
             readonly description: "Tool output above this size is saved as an artifact; tail is kept inline";
             readonly options: readonly [{
                 readonly value: "1";
@@ -428,7 +431,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 20;
         readonly ui: {
             readonly tab: "tools";
-            readonly label: "Artifact tail size (KB)";
+            readonly group: "Output Limits";
+            readonly label: "Artifact Tail Size (KB)";
             readonly description: "Amount of tail content kept inline when output spills to artifact";
             readonly options: readonly [{
                 readonly value: "1";
@@ -470,7 +474,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 20;
         readonly ui: {
             readonly tab: "tools";
-            readonly label: "Artifact head size (KB)";
+            readonly group: "Output Limits";
+            readonly label: "Artifact Head Size (KB)";
             readonly description: "Amount of head content kept inline alongside the tail when output spills to artifact (middle elision). 0 disables — keep tail only.";
             readonly options: readonly [{
                 readonly value: "0";
@@ -516,7 +521,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 768;
         readonly ui: {
             readonly tab: "tools";
-            readonly label: "Output column cap";
+            readonly group: "Output Limits";
+            readonly label: "Output Column Cap";
             readonly description: "Per-line byte cap for streaming tool outputs (bash, ssh, python, js eval) and `read`. Lines wider than this are ellipsis-truncated; remaining bytes up to the next newline are dropped. 0 disables.";
             readonly options: readonly [{
                 readonly value: "0";
@@ -551,7 +557,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 500;
         readonly ui: {
             readonly tab: "tools";
-            readonly label: "Artifact tail lines";
+            readonly group: "Output Limits";
+            readonly label: "Artifact Tail Lines";
             readonly description: "Maximum lines of tail content kept inline when output spills to artifact";
             readonly options: readonly [{
                 readonly value: "50";
@@ -589,8 +596,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "appearance";
+            readonly group: "Status Line";
             readonly label: "Show Hook Status";
-            readonly description: "Display hook status messages below status line";
+            readonly description: "Display hook status messages below the status line";
         };
     };
     readonly "statusLine.leftSegments": {
@@ -610,8 +618,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "appearance";
+            readonly group: "Images";
             readonly label: "Show Inline Images";
-            readonly description: "Render images inline in terminal";
+            readonly description: "Render images inline in the terminal";
             readonly condition: "hasImageProtocol";
         };
     };
@@ -620,6 +629,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "appearance";
+            readonly group: "Images";
             readonly label: "Auto-Resize Images";
             readonly description: "Resize large images to 2000x2000 max for better model compatibility";
         };
@@ -629,6 +639,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "appearance";
+            readonly group: "Images";
             readonly label: "Block Images";
             readonly description: "Prevent images from being sent to LLM providers";
         };
@@ -653,6 +664,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "appearance";
+            readonly group: "Display";
             readonly label: "Large Headings (Kitty)";
             readonly description: "Render Markdown H1 headings at 2x scale using Kitty's OSC 66 text-sizing protocol. Only takes effect on Kitty terminals; ignored everywhere else. Off by default.";
         };
@@ -663,6 +675,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "auto";
         readonly ui: {
             readonly tab: "appearance";
+            readonly group: "Display";
             readonly label: "Terminal Hyperlinks";
             readonly description: "Wrap paths and URLs in OSC 8 hyperlinks for terminal-native click-to-open (auto: detect support; off: never; always: unconditional)";
         };
@@ -677,6 +690,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "classic";
         readonly ui: {
             readonly tab: "appearance";
+            readonly group: "Display";
             readonly label: "Shimmer";
             readonly description: "Animation style for working/loading messages";
             readonly options: readonly [{
@@ -699,6 +713,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "appearance";
+            readonly group: "Display";
             readonly label: "Smooth Streaming";
             readonly description: "Reveal assistant text and streamed tool input smoothly while chunks arrive";
         };
@@ -708,6 +723,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "appearance";
+            readonly group: "Display";
             readonly label: "Show Token Usage";
             readonly description: "Show per-turn token usage on assistant messages";
         };
@@ -717,6 +733,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "appearance";
+            readonly group: "Display";
             readonly label: "Show Hardware Cursor";
             readonly description: "Show terminal cursor for IME support";
         };
@@ -727,6 +744,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "high";
         readonly ui: {
             readonly tab: "model";
+            readonly group: "Thinking";
             readonly label: "Thinking Level";
             readonly description: "Reasoning depth for thinking-capable models";
             readonly options: readonly [import("../thinking").ConfiguredThinkingLevelMetadata, ...import("../thinking").ThinkingLevelMetadata[]];
@@ -737,6 +755,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "model";
+            readonly group: "Thinking";
             readonly label: "Hide Thinking Blocks";
             readonly description: "Hide thinking blocks in assistant responses";
         };
@@ -746,6 +765,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "model";
+            readonly group: "Prompt";
             readonly label: "Repeat Tool Descriptions";
             readonly description: "Render full tool descriptions in the system prompt instead of a tool name list";
         };
@@ -755,15 +775,45 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "model";
-            readonly label: "Include Model In Prompt";
+            readonly group: "Prompt";
+            readonly label: "Include Model in Prompt";
             readonly description: "Surface the active model identifier in the system prompt so the agent knows which model it is";
         };
     };
+    readonly personality: {
+        readonly type: "enum";
+        readonly values: readonly ["default", "friendly", "pragmatic", "none"];
+        readonly default: "default";
+        readonly ui: {
+            readonly tab: "model";
+            readonly group: "Prompt";
+            readonly label: "Personality";
+            readonly description: "Communication style rendered into the system prompt's personality block";
+            readonly options: readonly [{
+                readonly value: "default";
+                readonly label: "Default";
+                readonly description: "Terse, evidence-first engineer; dense, action-oriented replies";
+            }, {
+                readonly value: "friendly";
+                readonly label: "Friendly";
+                readonly description: "Warm, encouraging collaborator focused on momentum and morale";
+            }, {
+                readonly value: "pragmatic";
+                readonly label: "Pragmatic";
+                readonly description: "Direct, efficient engineer focused on clarity and rigor";
+            }, {
+                readonly value: "none";
+                readonly label: "None";
+                readonly description: "Omit the personality block entirely";
+            }];
+        };
+    };
     readonly temperature: {
         readonly type: "number";
         readonly default: -1;
         readonly ui: {
             readonly tab: "model";
+            readonly group: "Sampling";
             readonly label: "Temperature";
             readonly description: "Sampling temperature (0 = deterministic, 1 = creative, -1 = provider default)";
             readonly options: readonly [{
@@ -798,6 +848,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: -1;
         readonly ui: {
             readonly tab: "model";
+            readonly group: "Sampling";
             readonly label: "Top P";
             readonly description: "Nucleus sampling cutoff (0-1, -1 = provider default)";
             readonly options: readonly [{
@@ -832,6 +883,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: -1;
         readonly ui: {
             readonly tab: "model";
+            readonly group: "Sampling";
             readonly label: "Top K";
             readonly description: "Sample from top-K tokens (-1 = provider default)";
             readonly options: readonly [{
@@ -862,6 +914,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: -1;
         readonly ui: {
             readonly tab: "model";
+            readonly group: "Sampling";
             readonly label: "Min P";
             readonly description: "Minimum probability threshold (0-1, -1 = provider default)";
             readonly options: readonly [{
@@ -888,6 +941,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: -1;
         readonly ui: {
             readonly tab: "model";
+            readonly group: "Sampling";
             readonly label: "Presence Penalty";
             readonly description: "Penalty for introducing already-present tokens (-1 = provider default)";
             readonly options: readonly [{
@@ -918,6 +972,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: -1;
         readonly ui: {
             readonly tab: "model";
+            readonly group: "Sampling";
             readonly label: "Repetition Penalty";
             readonly description: "Penalty for repeated tokens (-1 = provider default)";
             readonly options: readonly [{
@@ -953,6 +1008,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "none";
         readonly ui: {
             readonly tab: "model";
+            readonly group: "Sampling";
             readonly label: "Service Tier";
             readonly description: 'Processing priority hint (none = omit). OpenAI accepts the tier values directly; Anthropic realizes `priority` as `speed: "fast"` on supported Opus models. Scoped values target one family.';
             readonly options: readonly [{
@@ -999,6 +1055,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 10;
         readonly ui: {
             readonly tab: "model";
+            readonly group: "Retry & Fallback";
             readonly label: "Retry Attempts";
             readonly description: "Maximum retry attempts on API errors";
             readonly options: readonly [{
@@ -1028,6 +1085,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: number;
         readonly ui: {
             readonly tab: "model";
+            readonly group: "Retry & Fallback";
             readonly label: "Max Retry Delay";
             readonly description: "Maximum wait between retries, in ms. When the provider asks us to wait longer than this and no credential or model fallback succeeds, the request fails fast instead of sleeping (e.g. 3-hour Anthropic rate-limit windows).";
         };
@@ -1037,6 +1095,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "model";
+            readonly group: "Retry & Fallback";
             readonly label: "Retry Model Fallback";
             readonly description: "Allow retry recovery to switch to configured fallback models";
         };
@@ -1051,6 +1110,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "cooldown-expiry";
         readonly ui: {
             readonly tab: "model";
+            readonly group: "Retry & Fallback";
             readonly label: "Fallback Revert Policy";
             readonly description: "When to return to the primary model after a fallback";
             readonly options: readonly [{
@@ -1070,6 +1130,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "one-at-a-time";
         readonly ui: {
             readonly tab: "interaction";
+            readonly group: "Input";
             readonly label: "Steering Mode";
             readonly description: "How to process queued messages while agent is working";
         };
@@ -1080,6 +1141,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "one-at-a-time";
         readonly ui: {
             readonly tab: "interaction";
+            readonly group: "Input";
             readonly label: "Follow-Up Mode";
             readonly description: "How to drain follow-up messages after a turn completes";
         };
@@ -1090,6 +1152,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "immediate";
         readonly ui: {
             readonly tab: "interaction";
+            readonly group: "Input";
             readonly label: "Interrupt Mode";
             readonly description: "When steering messages interrupt tool execution";
         };
@@ -1100,6 +1163,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "prompt";
         readonly ui: {
             readonly tab: "interaction";
+            readonly group: "Input";
             readonly label: "Loop Mode";
             readonly description: "What happens between /loop iterations before re-submitting the prompt";
             readonly options: readonly [{
@@ -1123,6 +1187,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "tree";
         readonly ui: {
             readonly tab: "interaction";
+            readonly group: "Input";
             readonly label: "Double-Escape Action";
             readonly description: "Action when pressing Escape twice with empty editor";
         };
@@ -1133,6 +1198,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "default";
         readonly ui: {
             readonly tab: "interaction";
+            readonly group: "Input";
             readonly label: "Session Tree Filter";
             readonly description: "Default filter mode when opening the session tree";
         };
@@ -1142,6 +1208,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 5;
         readonly ui: {
             readonly tab: "interaction";
+            readonly group: "Input";
             readonly label: "Autocomplete Items";
             readonly description: "Max visible items in autocomplete dropdown (3-20)";
             readonly options: readonly [{
@@ -1170,6 +1237,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "interaction";
+            readonly group: "Input";
             readonly label: "Emoji Autocomplete";
             readonly description: "Suggest emojis from `:name:` shortcodes and expand text emoticons like `:D` or `:-)`";
         };
@@ -1179,6 +1247,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "interaction";
+            readonly group: "Startup & Updates";
             readonly label: "Quiet Startup";
             readonly description: "Skip welcome screen and startup status messages";
         };
@@ -1188,6 +1257,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "interaction";
+            readonly group: "Startup & Updates";
             readonly label: "Setup Wizard";
             readonly description: "Show newly added onboarding steps once per setup version";
         };
@@ -1197,8 +1267,33 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "interaction";
+            readonly group: "Startup & Updates";
             readonly label: "Check for Updates";
-            readonly description: "If false, skip update check";
+            readonly description: "Check for omp updates on startup";
+        };
+    };
+    readonly "marketplace.autoUpdate": {
+        readonly type: "enum";
+        readonly values: readonly ["off", "notify", "auto"];
+        readonly default: "notify";
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly group: "Startup & Updates";
+            readonly label: "Marketplace Auto-Update";
+            readonly description: "Check for plugin updates on startup";
+            readonly options: readonly [{
+                readonly value: "off";
+                readonly label: "Off";
+                readonly description: "Don't check for plugin updates";
+            }, {
+                readonly value: "notify";
+                readonly label: "Notify";
+                readonly description: "Check on startup and notify when updates are available";
+            }, {
+                readonly value: "auto";
+                readonly label: "Auto";
+                readonly description: "Check on startup and auto-install updates";
+            }];
         };
     };
     readonly collapseChangelog: {
@@ -1206,6 +1301,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "interaction";
+            readonly group: "Startup & Updates";
             readonly label: "Collapse Changelog";
             readonly description: "Show condensed changelog after updates";
         };
@@ -1215,6 +1311,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "interaction";
+            readonly group: "Magic Keywords";
             readonly label: "Magic Keywords";
             readonly description: "Enable hidden notices for standalone ultrathink, orchestrate, and workflowz keywords";
         };
@@ -1224,6 +1321,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "interaction";
+            readonly group: "Magic Keywords";
             readonly label: "Ultrathink Keyword";
             readonly description: "Let standalone ultrathink request maximum automatic thinking and append its hidden notice";
         };
@@ -1233,6 +1331,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "interaction";
+            readonly group: "Magic Keywords";
             readonly label: "Orchestrate Keyword";
             readonly description: "Let standalone orchestrate append its hidden multi-agent orchestration notice";
         };
@@ -1242,6 +1341,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "interaction";
+            readonly group: "Magic Keywords";
             readonly label: "Workflow Keyword";
             readonly description: "Let standalone workflowz append its hidden eval workflow notice";
         };
@@ -1252,8 +1352,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "on";
         readonly ui: {
             readonly tab: "interaction";
+            readonly group: "Notifications";
             readonly label: "Completion Notification";
-            readonly description: "Notify when the agent completes";
+            readonly description: "Notify when the agent finishes a turn";
         };
     };
     readonly "ask.timeout": {
@@ -1261,8 +1362,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 0;
         readonly ui: {
             readonly tab: "interaction";
+            readonly group: "Notifications";
             readonly label: "Ask Timeout";
-            readonly description: "Auto-select recommended option after timeout (0 to disable)";
+            readonly description: "Auto-select the recommended ask option after this many seconds (0 disables)";
             readonly options: readonly [{
                 readonly value: "0";
                 readonly label: "Disabled";
@@ -1287,8 +1389,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "on";
         readonly ui: {
             readonly tab: "interaction";
+            readonly group: "Notifications";
             readonly label: "Ask Notification";
-            readonly description: "Notify when ask tool is waiting for input";
+            readonly description: "Notify when the ask tool is waiting for input";
         };
     };
     readonly "stt.enabled": {
@@ -1296,6 +1399,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "interaction";
+            readonly group: "Speech";
             readonly label: "Speech-to-Text";
             readonly description: "Enable speech-to-text input via microphone";
         };
@@ -1310,6 +1414,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "base.en";
         readonly ui: {
             readonly tab: "interaction";
+            readonly group: "Speech";
             readonly label: "Speech Model";
             readonly description: "Whisper model size (larger = more accurate but slower)";
             readonly options: readonly [{
@@ -1356,6 +1461,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "context";
+            readonly group: "General";
             readonly label: "Auto-Promote Context";
             readonly description: "Promote to a larger-context model on context overflow instead of compacting";
         };
@@ -1365,6 +1471,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "context";
+            readonly group: "Compaction";
             readonly label: "Auto-Compact";
             readonly description: "Automatically compact context when it gets too large";
         };
@@ -1375,6 +1482,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "context-full";
         readonly ui: {
             readonly tab: "context";
+            readonly group: "Compaction";
             readonly label: "Compaction Strategy";
             readonly description: "Choose in-place context-full maintenance, auto-handoff, surgical shake (drop heavy content), snapcompact (archive history as dense images), or disable auto maintenance (off)";
             readonly options: readonly [{
@@ -1405,6 +1513,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: -1;
         readonly ui: {
             readonly tab: "context";
+            readonly group: "Compaction";
             readonly label: "Compaction Threshold";
             readonly description: "Percent threshold for context maintenance; set to Default to use legacy reserve-based behavior";
             readonly options: readonly [{
@@ -1467,6 +1576,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: -1;
         readonly ui: {
             readonly tab: "context";
+            readonly group: "Compaction";
             readonly label: "Compaction Token Limit";
             readonly description: "Fixed token limit for context maintenance; overrides percentage if set";
             readonly options: readonly [{
@@ -1509,6 +1619,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "context";
+            readonly group: "Compaction";
             readonly label: "Save Handoff Docs";
             readonly description: "Save generated handoff documents to markdown files for the auto-handoff flow";
         };
@@ -1518,6 +1629,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "context";
+            readonly group: "Compaction";
             readonly label: "Remote Compaction";
             readonly description: "Use remote compaction endpoints when available instead of local summarization";
         };
@@ -1543,6 +1655,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "context";
+            readonly group: "Compaction";
             readonly label: "Idle Compaction";
             readonly description: "Compact context while idle when token count exceeds threshold";
         };
@@ -1552,6 +1665,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 200000;
         readonly ui: {
             readonly tab: "context";
+            readonly group: "Compaction";
             readonly label: "Idle Compaction Threshold";
             readonly description: "Token count above which idle compaction triggers";
             readonly options: readonly [{
@@ -1589,6 +1703,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 300;
         readonly ui: {
             readonly tab: "context";
+            readonly group: "Compaction";
             readonly label: "Idle Compaction Delay";
             readonly description: "Seconds to wait while idle before compacting";
             readonly options: readonly [{
@@ -1617,15 +1732,37 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "context";
+            readonly group: "Compaction";
             readonly label: "Supersede Stale Reads";
             readonly description: "Prune older read results when the same file is read again (cache-aware, runs every turn)";
         };
     };
+    readonly "snapcompact.systemPrompt": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "context";
+            readonly group: "Experimental";
+            readonly label: "Snapcompact System Prompt";
+            readonly description: "Experimental: render the system prompt as dense PNG image(s) and attach to the first user message (vision models only). Saves tokens; loses system-prompt prompt caching.";
+        };
+    };
+    readonly "snapcompact.toolResults": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "context";
+            readonly group: "Experimental";
+            readonly label: "Snapcompact Tool Results";
+            readonly description: "Experimental: render large historical tool results as dense PNG image(s) instead of text (vision models only). Saves tokens on accumulated read/search output.";
+        };
+    };
     readonly "branchSummary.enabled": {
         readonly type: "boolean";
         readonly default: false;
         readonly ui: {
             readonly tab: "context";
+            readonly group: "General";
             readonly label: "Branch Summaries";
             readonly description: "Prompt to summarize when leaving a branch";
         };
@@ -1704,6 +1841,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "off";
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "General";
             readonly label: "Memory Backend";
             readonly description: "Off, local summary pipeline, Mnemopi SQLite, or Hindsight remote memory";
             readonly options: readonly [{
@@ -1730,6 +1868,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: undefined;
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Mnemopi";
             readonly label: "Mnemopi DB Path";
             readonly description: "Optional SQLite DB path. Defaults to the agent memories directory.";
             readonly condition: "mnemopiActive";
@@ -1740,6 +1879,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: undefined;
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Mnemopi";
             readonly label: "Mnemopi Bank";
             readonly description: "Optional shared bank base name. Per-project modes derive project-local banks from it.";
             readonly condition: "mnemopiActive";
@@ -1751,6 +1891,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "per-project";
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Mnemopi";
             readonly label: "Mnemopi Scoping";
             readonly description: "global = one shared bank; per-project = isolated bank per cwd; per-project-tagged = project-local writes plus global recall visibility";
             readonly options: readonly [{
@@ -1774,6 +1915,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Mnemopi";
             readonly label: "Mnemopi Auto Recall";
             readonly description: "Recall local memories into the first turn of each session";
             readonly condition: "mnemopiActive";
@@ -1784,16 +1926,40 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Mnemopi";
             readonly label: "Mnemopi Auto Retain";
             readonly description: "Retain completed conversation turns into local Mnemopi memory";
             readonly condition: "mnemopiActive";
         };
     };
+    readonly "mnemopi.polyphonicRecall": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "memory";
+            readonly group: "Mnemopi";
+            readonly label: "Mnemopi Polyphonic Recall";
+            readonly description: "Enable 4-voice recall (vector, graph, fact, temporal) fused with reciprocal rank fusion";
+            readonly condition: "mnemopiActive";
+        };
+    };
+    readonly "mnemopi.enhancedRecall": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "memory";
+            readonly group: "Mnemopi";
+            readonly label: "Mnemopi Enhanced Recall";
+            readonly description: "Enable the tiered query result cache for repeated and similar recall queries";
+            readonly condition: "mnemopiActive";
+        };
+    };
     readonly "mnemopi.noEmbeddings": {
         readonly type: "boolean";
         readonly default: false;
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Mnemopi";
             readonly label: "Mnemopi Disable Embeddings";
             readonly description: "Force deterministic FTS-only recall instead of vector embeddings";
             readonly condition: "mnemopiActive";
@@ -1804,6 +1970,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: undefined;
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Mnemopi";
             readonly label: "Mnemopi Embedding Model";
             readonly description: "Optional embedding model override passed to Mnemopi";
             readonly condition: "mnemopiActive";
@@ -1814,6 +1981,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: undefined;
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Mnemopi";
             readonly label: "Mnemopi Embedding API URL";
             readonly description: "Optional OpenAI-compatible embedding endpoint passed to Mnemopi";
             readonly condition: "mnemopiActive";
@@ -1824,6 +1992,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: undefined;
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Mnemopi";
             readonly label: "Mnemopi Embedding API Key";
             readonly description: "Optional embedding API key passed to Mnemopi";
             readonly condition: "mnemopiActive";
@@ -1835,6 +2004,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "smol";
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Mnemopi";
             readonly label: "Mnemopi LLM Mode";
             readonly description: "Use no LLM, the configured smol model, or a remote OpenAI-compatible endpoint";
             readonly condition: "mnemopiActive";
@@ -1858,6 +2028,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: undefined;
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Mnemopi";
             readonly label: "Mnemopi LLM Base URL";
             readonly description: "Optional OpenAI-compatible LLM endpoint for Mnemopi remote mode";
             readonly condition: "mnemopiActive";
@@ -1868,6 +2039,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: undefined;
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Mnemopi";
             readonly label: "Mnemopi LLM API Key";
             readonly description: "Optional LLM API key for Mnemopi remote mode";
             readonly condition: "mnemopiActive";
@@ -1878,6 +2050,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: undefined;
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Mnemopi";
             readonly label: "Mnemopi LLM Model";
             readonly description: "Optional LLM model name for Mnemopi remote mode";
             readonly condition: "mnemopiActive";
@@ -1912,6 +2085,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "http://localhost:8888";
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Hindsight";
             readonly label: "Hindsight API URL";
             readonly description: "Hindsight server URL (Cloud or self-hosted)";
             readonly condition: "hindsightActive";
@@ -1926,6 +2100,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: undefined;
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Hindsight";
             readonly label: "Hindsight Bank ID";
             readonly description: "Memory bank identifier (default: project name)";
             readonly condition: "hindsightActive";
@@ -1941,6 +2116,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "per-project-tagged";
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Hindsight";
             readonly label: "Hindsight Scoping";
             readonly description: "global = one shared bank; per-project = isolated bank per cwd; per-project-tagged = shared bank with project tags so global + project memories merge on recall";
             readonly options: readonly [{
@@ -1972,6 +2148,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Hindsight";
             readonly label: "Hindsight Auto Recall";
             readonly description: "Recall memories on the first turn of each session";
             readonly condition: "hindsightActive";
@@ -1982,6 +2159,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Hindsight";
             readonly label: "Hindsight Auto Retain";
             readonly description: "Retain transcript every N turns and at session boundaries";
             readonly condition: "hindsightActive";
@@ -1993,6 +2171,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "full-session";
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Hindsight";
             readonly label: "Hindsight Retain Mode";
             readonly description: "full-session = upsert one document per session, last-turn = chunked";
             readonly options: readonly [{
@@ -2049,6 +2228,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Hindsight";
             readonly label: "Hindsight Mental Models";
             readonly description: "Read curated reflect summaries (mental models) into developer instructions at boot. Loads existing models on the bank — does not write. Pair with hindsight.mentalModelAutoSeed to also auto-create the built-in seed set.";
             readonly condition: "hindsightActive";
@@ -2059,6 +2239,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Hindsight";
             readonly label: "Hindsight Mental Model Auto-Seed";
             readonly description: "At session start, create any built-in mental models (project-conventions, project-decisions, user-preferences) that do not yet exist on the bank.";
             readonly condition: "hindsightActive";
@@ -2077,8 +2258,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "context";
+            readonly group: "Rules (TTSR)";
             readonly label: "TTSR";
-            readonly description: "Time Traveling Stream Rules: interrupt agent when output matches patterns";
+            readonly description: "Interrupt the agent mid-stream when output matches rule patterns (Time-Traveling Stream Rules)";
         };
     };
     readonly "ttsr.contextMode": {
@@ -2087,6 +2269,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "discard";
         readonly ui: {
             readonly tab: "context";
+            readonly group: "Rules (TTSR)";
             readonly label: "TTSR Context Mode";
             readonly description: "What to do with partial output when TTSR triggers";
         };
@@ -2097,6 +2280,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "always";
         readonly ui: {
             readonly tab: "context";
+            readonly group: "Rules (TTSR)";
             readonly label: "TTSR Interrupt Mode";
             readonly description: "When to interrupt mid-stream vs inject warning after completion";
             readonly options: readonly [{
@@ -2124,6 +2308,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "once";
         readonly ui: {
             readonly tab: "context";
+            readonly group: "Rules (TTSR)";
             readonly label: "TTSR Repeat Mode";
             readonly description: "How rules can repeat: once per session or after a message gap";
         };
@@ -2133,6 +2318,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 10;
         readonly ui: {
             readonly tab: "context";
+            readonly group: "Rules (TTSR)";
             readonly label: "TTSR Repeat Gap";
             readonly description: "Messages before a rule can trigger again";
             readonly options: readonly [{
@@ -2158,7 +2344,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "context";
-            readonly label: "Builtin Rules";
+            readonly group: "Rules (TTSR)";
+            readonly label: "Built-in Rules";
             readonly description: "Load the default rules shipped with the agent (override individually with ttsr.disabledRules)";
         };
     };
@@ -2167,6 +2354,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: string[];
         readonly ui: {
             readonly tab: "context";
+            readonly group: "Rules (TTSR)";
             readonly label: "Disabled Rules";
             readonly description: "Rule names to ignore entirely (applies to bundled defaults and your own rules)";
         };
@@ -2176,7 +2364,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly values: import("..").EditMode[];
         readonly default: "hashline";
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "files";
+            readonly group: "Editing";
             readonly label: "Edit Mode";
             readonly description: "Select the edit tool variant (replace, patch, hashline, or apply_patch)";
         };
@@ -2185,7 +2374,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "boolean";
         readonly default: true;
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "files";
+            readonly group: "Editing";
             readonly label: "Fuzzy Match";
             readonly description: "Accept high-confidence fuzzy matches for whitespace differences";
         };
@@ -2194,9 +2384,10 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "number";
         readonly default: 0.95;
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "files";
+            readonly group: "Editing";
             readonly label: "Fuzzy Match Threshold";
-            readonly description: "Similarity threshold for fuzzy matches";
+            readonly description: "Similarity threshold (0-1) for accepting fuzzy matches";
             readonly options: readonly [{
                 readonly value: "0.85";
                 readonly label: "0.85";
@@ -2220,7 +2411,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "boolean";
         readonly default: false;
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "files";
+            readonly group: "Editing";
             readonly label: "Abort on Failed Preview";
             readonly description: "Abort streaming edit tool calls when patch preview fails";
         };
@@ -2229,7 +2421,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "boolean";
         readonly default: true;
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "files";
+            readonly group: "Editing";
             readonly label: "Block Auto-Generated Files";
             readonly description: "Prevent editing of files that appear to be auto-generated (protoc, sqlc, swagger, etc.)";
         };
@@ -2238,7 +2431,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "boolean";
         readonly default: false;
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "files";
+            readonly group: "Reading";
             readonly label: "Line Numbers";
             readonly description: "Prepend line numbers to read tool output by default";
         };
@@ -2247,7 +2441,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "boolean";
         readonly default: true;
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "files";
+            readonly group: "Reading";
             readonly label: "Hash Lines";
             readonly description: "Include snapshot-tag headers and line numbers in read output for hashline edit mode ([PATH#TAG] plus LINE:content)";
         };
@@ -2256,7 +2451,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "number";
         readonly default: 300;
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "files";
+            readonly group: "Reading";
             readonly label: "Default Read Limit";
             readonly description: "Default number of lines returned when agent calls read without a limit";
             readonly options: readonly [{
@@ -2281,7 +2477,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "boolean";
         readonly default: true;
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "files";
+            readonly group: "Read Summaries";
             readonly label: "Read Summaries";
             readonly description: "Return structural code summaries when read is called without an explicit selector";
         };
@@ -2290,7 +2487,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "boolean";
         readonly default: false;
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "files";
+            readonly group: "Read Summaries";
             readonly label: "Prose Summaries";
             readonly description: "Return structural summaries for Markdown and plain text reads";
         };
@@ -2299,7 +2497,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "number";
         readonly default: 4;
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "files";
+            readonly group: "Read Summaries";
             readonly label: "Read Summary Body Lines";
             readonly description: "Minimum multiline body or literal length before read summaries collapse it";
         };
@@ -2308,7 +2507,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "number";
         readonly default: 6;
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "files";
+            readonly group: "Read Summaries";
             readonly label: "Read Summary Comment Lines";
             readonly description: "Minimum multiline block comment length before read summaries collapse it";
         };
@@ -2317,7 +2517,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "number";
         readonly default: 100;
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "files";
+            readonly group: "Read Summaries";
             readonly label: "Read Summary Minimum File Length";
             readonly description: "Files with fewer total lines are read verbatim instead of structurally summarized";
         };
@@ -2326,7 +2527,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "number";
         readonly default: 50;
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "files";
+            readonly group: "Read Summaries";
             readonly label: "Read Summary Unfold Target";
             readonly description: "BFS-unfold elidable spans until the summary is at least this many visible lines. 0 keeps only the outermost elisions.";
         };
@@ -2335,7 +2537,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "number";
         readonly default: 100;
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "files";
+            readonly group: "Read Summaries";
             readonly label: "Read Summary Unfold Ceiling";
             readonly description: "Hard ceiling on summary size while BFS-unfolding. An unfold that would exceed this is reverted and unfolding stops.";
         };
@@ -2344,7 +2547,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "boolean";
         readonly default: false;
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "files";
+            readonly group: "Reading";
             readonly label: "Inline Read Previews";
             readonly description: "Render read tool results inline in the transcript instead of summary rows";
         };
@@ -2353,16 +2557,18 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "boolean";
         readonly default: true;
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "files";
+            readonly group: "LSP";
             readonly label: "LSP";
-            readonly description: "Enable the lsp tool for language server protocol";
+            readonly description: "Enable the lsp tool for code intelligence (definitions, references, diagnostics, rename)";
         };
     };
     readonly "lsp.lazy": {
         readonly type: "boolean";
         readonly default: true;
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "files";
+            readonly group: "LSP";
             readonly label: "Lazy LSP Startup";
             readonly description: "Start language servers on first use (lsp tool or editing a matching file type) instead of at session startup";
         };
@@ -2371,7 +2577,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "boolean";
         readonly default: false;
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "files";
+            readonly group: "LSP";
             readonly label: "Format on Write";
             readonly description: "Automatically format code files using LSP after writing";
         };
@@ -2380,7 +2587,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "boolean";
         readonly default: true;
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "files";
+            readonly group: "LSP";
             readonly label: "Diagnostics on Write";
             readonly description: "Return LSP diagnostics after writing code files";
         };
@@ -2389,7 +2597,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "boolean";
         readonly default: false;
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "files";
+            readonly group: "LSP";
             readonly label: "Diagnostics on Edit";
             readonly description: "Return LSP diagnostics after editing code files";
         };
@@ -2398,16 +2607,38 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "boolean";
         readonly default: true;
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "files";
+            readonly group: "LSP";
             readonly label: "Deduplicate Diagnostics";
             readonly description: "Suppress post-edit LSP diagnostics already shown for a file; only surface new or changed ones";
         };
     };
+    readonly "bash.enabled": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "shell";
+            readonly group: "Bash";
+            readonly label: "Bash";
+            readonly description: "Enable the bash tool for shell command execution";
+        };
+    };
+    readonly "bash.autoBackground.enabled": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "shell";
+            readonly group: "Bash";
+            readonly label: "Bash Auto-Background";
+            readonly description: "Automatically background long-running bash commands and deliver the result later";
+        };
+    };
     readonly "bashInterceptor.enabled": {
         readonly type: "boolean";
         readonly default: false;
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "shell";
+            readonly group: "Bash";
             readonly label: "Bash Interceptor";
             readonly description: "Block shell commands that have dedicated tools";
         };
@@ -2420,8 +2651,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "boolean";
         readonly default: true;
         readonly ui: {
-            readonly tab: "editing";
-            readonly label: "Strip Trailing head/tail";
+            readonly tab: "shell";
+            readonly group: "Bash";
+            readonly label: "Strip head/tail Pipes";
             readonly description: "Silently drop trailing `| head`/`| tail` pipes from single-line bash commands. Output is already truncated automatically.";
         };
     };
@@ -2429,7 +2661,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "boolean";
         readonly default: true;
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "shell";
+            readonly group: "Bash";
             readonly label: "Shell Minimizer";
             readonly description: "Compress verbose shell output (git, npm, cargo, etc.) before returning it to the agent";
         };
@@ -2455,7 +2688,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly values: readonly ["default", "aggressive"];
         readonly default: "default";
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "shell";
+            readonly group: "Bash";
             readonly label: "Shell Minimizer Source Outline";
             readonly description: "Source outline mode for cat/read of source files: default or aggressive";
         };
@@ -2468,18 +2702,20 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "boolean";
         readonly default: true;
         readonly ui: {
-            readonly tab: "editing";
-            readonly label: "Eval: Python backend";
-            readonly description: "Allow the eval tool to dispatch to the IPython kernel";
+            readonly tab: "shell";
+            readonly group: "Eval & Python";
+            readonly label: "Python Eval Backend";
+            readonly description: "Allow the eval tool to dispatch Python cells to the IPython kernel";
         };
     };
     readonly "eval.js": {
         readonly type: "boolean";
         readonly default: true;
         readonly ui: {
-            readonly tab: "editing";
-            readonly label: "Eval: JavaScript backend";
-            readonly description: "Allow the eval tool to dispatch to the in-process JavaScript runtime";
+            readonly tab: "shell";
+            readonly group: "Eval & Python";
+            readonly label: "JavaScript Eval Backend";
+            readonly description: "Allow the eval tool to dispatch JavaScript cells to the in-process runtime";
         };
     };
     readonly "python.kernelMode": {
@@ -2487,16 +2723,18 @@ export declare const SETTINGS_SCHEMA: {
         readonly values: readonly ["session", "per-call"];
         readonly default: "session";
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "shell";
+            readonly group: "Eval & Python";
             readonly label: "Python Kernel Mode";
-            readonly description: "Whether to keep IPython kernel alive across calls";
+            readonly description: "Keep the IPython kernel alive across eval calls or start fresh each time";
         };
     };
     readonly "python.interpreter": {
         readonly type: "string";
         readonly default: "";
         readonly ui: {
-            readonly tab: "editing";
+            readonly tab: "shell";
+            readonly group: "Eval & Python";
             readonly label: "Python Interpreter";
             readonly description: "Optional path to an exact Python executable. When set, automatic Python runtime discovery is skipped.";
         };
@@ -2505,7 +2743,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "record";
         readonly default: {};
         readonly ui: {
-            readonly tab: "tools";
+            readonly tab: "interaction";
+            readonly group: "Approvals";
             readonly label: "Tool Approval Policies";
             readonly description: "Per-tool approval policies. Set to 'allow' to auto-approve, 'prompt' to require confirmation, or 'deny' to block. Overrides are honored in every approval mode.";
         };
@@ -2516,8 +2755,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "yolo";
         readonly ui: {
             readonly tab: "interaction";
+            readonly group: "Approvals";
             readonly label: "Tool Approval";
-            readonly description: "Default approval behaviour for tool calls. 'Always ask' auto-approves read-only tools only. 'Write' auto-approves read and workspace-write tools. 'Yolo' auto-approves all tiers; user policy may still prompt or block.";
+            readonly description: "Default approval behavior for tool calls. 'Always ask' auto-approves read-only tools only. 'Write' auto-approves read and workspace-write tools. 'Yolo' auto-approves all tiers; user policy may still prompt or block.";
             readonly options: readonly [{
                 readonly value: "always-ask";
                 readonly label: "Always ask";
@@ -2538,6 +2778,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Available Tools";
             readonly label: "Todos";
             readonly description: "Enable the todo tool for task tracking";
         };
@@ -2547,8 +2788,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Todos";
             readonly label: "Todo Reminders";
-            readonly description: "Remind agent to complete todos before stopping";
+            readonly description: "Remind the agent to complete todos before stopping";
         };
     };
     readonly "todo.reminders.max": {
@@ -2556,8 +2798,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 3;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Todos";
             readonly label: "Todo Reminder Limit";
-            readonly description: "Maximum reminders to complete todos before giving up";
+            readonly description: "Maximum number of todo reminders before giving up";
             readonly options: readonly [{
                 readonly value: "1";
                 readonly label: "1 reminder";
@@ -2578,26 +2821,19 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Todos";
             readonly label: "Create Todos Automatically";
             readonly description: "Automatically create a comprehensive todo list after the first message";
         };
     };
-    readonly "bash.enabled": {
-        readonly type: "boolean";
-        readonly default: true;
-        readonly ui: {
-            readonly tab: "tools";
-            readonly label: "Bash";
-            readonly description: "Enable the bash tool for shell command execution";
-        };
-    };
     readonly "find.enabled": {
         readonly type: "boolean";
         readonly default: true;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Available Tools";
             readonly label: "Find";
-            readonly description: "Enable the find tool for file searching";
+            readonly description: "Enable the find tool for glob-based file lookup";
         };
     };
     readonly "search.enabled": {
@@ -2605,8 +2841,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Available Tools";
             readonly label: "Search";
-            readonly description: "Enable the search tool for content searching";
+            readonly description: "Enable the search tool for regex content search";
         };
     };
     readonly "search.contextBefore": {
@@ -2614,6 +2851,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 1;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Search & Browser";
             readonly label: "Search Context Before";
             readonly description: "Lines of context before each search match";
             readonly options: readonly [{
@@ -2639,6 +2877,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 3;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Search & Browser";
             readonly label: "Search Context After";
             readonly description: "Lines of context after each search match";
             readonly options: readonly [{
@@ -2667,6 +2906,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Available Tools";
             readonly label: "AST Grep";
             readonly description: "Enable the ast_grep tool for structural AST search";
         };
@@ -2676,40 +2916,17 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Available Tools";
             readonly label: "AST Edit";
             readonly description: "Enable the ast_edit tool for structural AST rewrites";
         };
     };
-    readonly "irc.timeoutMs": {
-        readonly type: "number";
-        readonly default: 120000;
-        readonly ui: {
-            readonly tab: "tools";
-            readonly label: "IRC Timeout";
-            readonly description: "Default timeout for irc wait (and send await:true) in milliseconds; 0 disables the timeout";
-            readonly options: readonly [{
-                readonly value: "0";
-                readonly label: "Disabled";
-            }, {
-                readonly value: "30000";
-                readonly label: "30 seconds";
-            }, {
-                readonly value: "60000";
-                readonly label: "1 minute";
-            }, {
-                readonly value: "120000";
-                readonly label: "2 minutes";
-            }, {
-                readonly value: "300000";
-                readonly label: "5 minutes";
-            }];
-        };
-    };
     readonly "renderMermaid.enabled": {
         readonly type: "boolean";
         readonly default: false;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Available Tools";
             readonly label: "Render Mermaid";
             readonly description: "Enable the render_mermaid tool for Mermaid-to-ASCII rendering";
         };
@@ -2719,6 +2936,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Available Tools";
             readonly label: "Debug";
             readonly description: "Enable the debug tool for DAP-based debugging";
         };
@@ -2728,6 +2946,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Available Tools";
             readonly label: "Text-to-Speech";
             readonly description: "Enable the tts tool for xAI Grok Voice speech synthesis";
         };
@@ -2737,6 +2956,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Available Tools";
             readonly label: "Inspect Image";
             readonly description: "Enable the inspect_image tool, delegating image understanding to a vision-capable model";
         };
@@ -2746,6 +2966,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Available Tools";
             readonly label: "Checkpoint/Rewind";
             readonly description: "Enable the checkpoint and rewind tools for context checkpointing";
         };
@@ -2755,6 +2976,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Available Tools";
             readonly label: "Read URLs";
             readonly description: "Allow the read tool to fetch and process URLs";
         };
@@ -2764,6 +2986,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Available Tools";
             readonly label: "Obsidian Vault";
             readonly description: "Enable the vault:// internal URL for reading and editing Obsidian vault content via the Obsidian CLI. When disabled, vault:// resolution is refused and the vault:// entry is omitted from the system prompt.";
         };
@@ -2773,6 +2996,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Available Tools";
             readonly label: "GitHub CLI";
             readonly description: "Enable the github tool (op-based dispatch for repository, issue, pull request, diff, search, checkout, push, and Actions watch workflows)";
         };
@@ -2782,7 +3006,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "tools";
-            readonly label: "GitHub view cache";
+            readonly group: "GitHub";
+            readonly label: "GitHub View Cache";
             readonly description: "Cache rendered issue/PR view output in ~/.omp/cache/github-cache.db so repeated reads are free";
         };
     };
@@ -2791,8 +3016,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 300;
         readonly ui: {
             readonly tab: "tools";
-            readonly label: "GitHub cache soft TTL (seconds)";
-            readonly description: "Within this window, cached issue/PR view rows are returned directly. Default 5 minutes.";
+            readonly group: "GitHub";
+            readonly label: "GitHub Cache Soft TTL";
+            readonly description: "Within this window, cached issue/PR view rows are returned directly (seconds; default 5 minutes)";
         };
     };
     readonly "github.cache.hardTtlSec": {
@@ -2800,8 +3026,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 604800;
         readonly ui: {
             readonly tab: "tools";
-            readonly label: "GitHub cache hard TTL (seconds)";
-            readonly description: "Past soft TTL but within hard TTL, the tool returns the cached row and refreshes it in the background. Past hard TTL, the row is dropped. Default 7 days.";
+            readonly group: "GitHub";
+            readonly label: "GitHub Cache Hard TTL";
+            readonly description: "Past the soft TTL the cached row is returned and refreshed in the background; past the hard TTL it is dropped (seconds; default 7 days)";
         };
     };
     readonly "web_search.enabled": {
@@ -2809,8 +3036,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Available Tools";
             readonly label: "Web Search";
-            readonly description: "Enable the web_search tool for web searching";
+            readonly description: "Enable the web_search tool for live web results";
         };
     };
     readonly "browser.enabled": {
@@ -2818,8 +3046,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Available Tools";
             readonly label: "Browser";
-            readonly description: "Enable the browser tool (Ulixee Hero)";
+            readonly description: "Enable the browser tool for scripted Chromium automation (puppeteer)";
         };
     };
     readonly "browser.headless": {
@@ -2827,6 +3056,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Search & Browser";
             readonly label: "Headless Browser";
             readonly description: "Launch browser in headless mode (disable to show browser UI)";
         };
@@ -2836,7 +3066,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: undefined;
         readonly ui: {
             readonly tab: "tools";
-            readonly label: "Screenshot directory";
+            readonly group: "Search & Browser";
+            readonly label: "Screenshot Directory";
             readonly description: "Directory to save screenshots. If unset, screenshots go to a temp file. Supports ~. Examples: ~/Downloads, ~/Desktop, /sdcard/Download (Android)";
         };
     };
@@ -2845,6 +3076,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Execution";
             readonly label: "Intent Tracing";
             readonly description: "Ask the agent to describe the intent of each tool call before executing it";
         };
@@ -2854,6 +3086,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 0;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Execution";
             readonly label: "Max Tool Timeout";
             readonly description: "Maximum timeout in seconds the agent can set for any tool (0 = no limit)";
             readonly options: readonly [{
@@ -2882,6 +3115,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Execution";
             readonly label: "Async Execution";
             readonly description: "Enable async bash commands and background task execution";
         };
@@ -2896,6 +3130,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "30s";
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Execution";
             readonly label: "Poll Wait Duration";
             readonly description: "How long the poll tool waits for background job updates before returning the current state";
             readonly options: readonly [{
@@ -2917,13 +3152,30 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
-    readonly "bash.autoBackground.enabled": {
-        readonly type: "boolean";
-        readonly default: false;
+    readonly "irc.timeoutMs": {
+        readonly type: "number";
+        readonly default: 120000;
         readonly ui: {
             readonly tab: "tools";
-            readonly label: "Bash Auto-Background";
-            readonly description: "Automatically background long-running bash commands and deliver the result later";
+            readonly group: "Execution";
+            readonly label: "IRC Timeout";
+            readonly description: "Default timeout for irc wait (and send await:true) in milliseconds; 0 disables the timeout";
+            readonly options: readonly [{
+                readonly value: "0";
+                readonly label: "Disabled";
+            }, {
+                readonly value: "30000";
+                readonly label: "30 seconds";
+            }, {
+                readonly value: "60000";
+                readonly label: "1 minute";
+            }, {
+                readonly value: "120000";
+                readonly label: "2 minutes";
+            }, {
+                readonly value: "300000";
+                readonly label: "5 minutes";
+            }];
         };
     };
     readonly "bash.autoBackground.thresholdMs": {
@@ -2936,6 +3188,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "auto";
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Discovery & MCP";
             readonly label: "Tool Discovery";
             readonly description: "Hide tools behind a search tool to save tokens. 'auto' hides MCP tools once the tool set has more than 40 tools; 'mcp-only' always hides MCP tools; 'all' hides all non-essential built-ins too.";
         };
@@ -2945,6 +3198,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: string[];
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Discovery & MCP";
             readonly label: "Essential Tools Override";
             readonly description: "Override the always-loaded built-in tools (default: read, bash, edit). Leave empty to use defaults.";
         };
@@ -2954,6 +3208,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Discovery & MCP";
             readonly label: "MCP Project Config";
             readonly description: "Load .mcp.json/mcp.json from project root";
         };
@@ -2963,6 +3218,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Discovery & MCP";
             readonly label: "MCP Tool Discovery";
             readonly description: "Hide MCP tools by default and expose them through a tool discovery tool";
         };
@@ -2972,6 +3228,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: string[];
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Discovery & MCP";
             readonly label: "MCP Discovery Default Servers";
             readonly description: "Keep MCP tools from these servers visible while discovery mode hides other MCP tools";
         };
@@ -2981,6 +3238,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Discovery & MCP";
             readonly label: "MCP Update Injection";
             readonly description: "Inject MCP resource updates into the agent conversation";
         };
@@ -2990,8 +3248,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 500;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Discovery & MCP";
             readonly label: "MCP Notification Debounce";
-            readonly description: "Debounce window for MCP resource update notifications before injecting into conversation";
+            readonly description: "Debounce window in milliseconds for MCP resource updates before injecting them into the conversation";
         };
     };
     readonly "plan.enabled": {
@@ -2999,6 +3258,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "tasks";
+            readonly group: "Modes";
             readonly label: "Plan Mode";
             readonly description: "Enable plan mode for read-only exploration and planning before execution";
         };
@@ -3008,6 +3268,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "tasks";
+            readonly group: "Modes";
             readonly label: "Goal Mode";
             readonly description: "Enable per-session goal mode and the hidden goal tool";
         };
@@ -3017,7 +3278,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "tasks";
-            readonly label: "Goal Status In Footer";
+            readonly group: "Modes";
+            readonly label: "Goal Status in Footer";
             readonly description: "Show token budget alongside the goal indicator in the status line";
         };
     };
@@ -3026,6 +3288,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: readonly ["interactive"];
         readonly ui: {
             readonly tab: "tasks";
+            readonly group: "Modes";
             readonly label: "Goal Continuation Modes";
             readonly description: "Run modes where active goals may auto-continue between turns";
         };
@@ -3036,6 +3299,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "none";
         readonly ui: {
             readonly tab: "tasks";
+            readonly group: "Isolation";
             readonly label: "Isolation Mode";
             readonly description: 'Isolation backend for subagents. "auto" lets the native PAL pick the best available backend (CoW-aware filesystems, then overlayfs/ProjFS, then a git worktree / recursive-copy fallback).';
             readonly options: readonly [{
@@ -3087,6 +3351,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "patch";
         readonly ui: {
             readonly tab: "tasks";
+            readonly group: "Isolation";
             readonly label: "Isolation Merge Strategy";
             readonly description: "How isolated task changes are integrated (patch apply or branch merge)";
             readonly options: readonly [{
@@ -3106,6 +3371,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "generic";
         readonly ui: {
             readonly tab: "tasks";
+            readonly group: "Isolation";
             readonly label: "Isolation Commit Style";
             readonly description: "Commit message style for nested repo changes (generic or AI-generated)";
             readonly options: readonly [{
@@ -3124,6 +3390,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "tasks";
+            readonly group: "Subagents";
             readonly label: "Prefer Task Delegation";
             readonly description: "Encourage the agent to delegate work to subagents unless changes are trivial";
         };
@@ -3133,6 +3400,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "tasks";
+            readonly group: "Subagents";
             readonly label: "Batch Task Calls";
             readonly description: "Switch the task tool to its batch shape: one call carries { agent, context, tasks[] } — one subagent per item (with per-item isolation) and a required shared context prepended to every assignment. With async.enabled=true, each spawn runs as an independent background agent with the normal idle/parked lifecycle; otherwise the call blocks for merged results. Disable to restore the flat single-spawn schema.";
         };
@@ -3142,8 +3410,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 32;
         readonly ui: {
             readonly tab: "tasks";
+            readonly group: "Subagents";
             readonly label: "Max Concurrent Tasks";
-            readonly description: "Concurrent limit for subagents";
+            readonly description: "Maximum number of subagents running concurrently";
             readonly options: readonly [{
                 readonly value: "0";
                 readonly label: "Unlimited";
@@ -3176,6 +3445,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "tasks";
+            readonly group: "Subagents";
             readonly label: "LSP in Subagents";
             readonly description: "Allow subagents spawned via the task tool to use the lsp tool. Off by default to keep subagents cheap; enable when LSP-aware delegation is worth the extra tokens.";
         };
@@ -3185,6 +3455,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 2;
         readonly ui: {
             readonly tab: "tasks";
+            readonly group: "Subagents";
             readonly label: "Max Task Recursion";
             readonly description: "How many levels deep subagents can spawn their own subagents";
             readonly options: readonly [{
@@ -3210,6 +3481,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 0;
         readonly ui: {
             readonly tab: "tasks";
+            readonly group: "Subagents";
             readonly label: "Max Subagent Runtime";
             readonly description: "Hard wall-clock limit per subagent (ms). 0 disables it. Defense-in-depth against provider-side stream hangs that escape the inference-layer watchdog; triggers a normal subagent abort with a 'timed out' reason.";
             readonly options: readonly [{
@@ -3236,6 +3508,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 420000;
         readonly ui: {
             readonly tab: "tasks";
+            readonly group: "Subagents";
             readonly label: "Agent Idle TTL";
             readonly description: "How long an idle subagent stays live in memory before being parked to disk (ms). Parked agents are revived automatically when messaged or resumed. 0 keeps idle agents live until exit.";
         };
@@ -3245,6 +3518,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 90;
         readonly ui: {
             readonly tab: "tasks";
+            readonly group: "Subagents";
             readonly label: "Soft Subagent Request Budget";
             readonly description: "Soft per-subagent request budget (assistant requests per run). Crossing it injects one steering notice asking the subagent to wrap up; at 1.5x the budget the run is aborted gracefully, salvaging partial output. 0 disables the guard. Bundled explore/quick_task agents use a lower built-in budget.";
             readonly options: readonly [{
@@ -3275,9 +3549,10 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "number";
         readonly default: 60;
         readonly ui: {
-            readonly tab: "tasks";
-            readonly label: "Todo auto-clear delay";
-            readonly description: "How long to wait before removing completed/abandoned tasks from the list";
+            readonly tab: "tools";
+            readonly group: "Todos";
+            readonly label: "Todo Auto-Clear Delay";
+            readonly description: "Delay before completed or abandoned todos are removed from the todo widget";
             readonly options: readonly [{
                 readonly value: "0";
                 readonly label: "Instant";
@@ -3308,6 +3583,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "appearance";
+            readonly group: "Display";
             readonly label: "Show Resolved Model Badge";
             readonly description: "Display the actual model ID used by each subagent in the task widget status line";
         };
@@ -3321,6 +3597,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "tasks";
+            readonly group: "Commands & Skills";
             readonly label: "Skill Commands";
             readonly description: "Register skills as /skill:name commands";
         };
@@ -3362,6 +3639,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "tasks";
+            readonly group: "Commands & Skills";
             readonly label: "Claude User Commands";
             readonly description: "Load commands from ~/.claude/commands/";
         };
@@ -3371,6 +3649,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "tasks";
+            readonly group: "Commands & Skills";
             readonly label: "Claude Project Commands";
             readonly description: "Load commands from .claude/commands/";
         };
@@ -3380,6 +3659,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "tasks";
+            readonly group: "Commands & Skills";
             readonly label: "OpenCode User Commands";
             readonly description: "Load commands from ~/.config/opencode/commands/";
         };
@@ -3389,6 +3669,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "tasks";
+            readonly group: "Commands & Skills";
             readonly label: "OpenCode Project Commands";
             readonly description: "Load commands from .opencode/commands/";
         };
@@ -3398,6 +3679,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "providers";
+            readonly group: "Privacy";
             readonly label: "Hide Secrets";
             readonly description: "Obfuscate secrets before sending to AI providers";
         };
@@ -3408,8 +3690,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "auto";
         readonly ui: {
             readonly tab: "providers";
+            readonly group: "Services";
             readonly label: "Web Search Provider";
-            readonly description: "Provider for web search tool";
+            readonly description: "Preferred provider for the web_search tool";
             readonly options: readonly [{
                 readonly value: "auto";
                 readonly label: "Auto";
@@ -3479,8 +3762,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "auto";
         readonly ui: {
             readonly tab: "providers";
+            readonly group: "Services";
             readonly label: "Image Provider";
-            readonly description: "Provider for image generation tool";
+            readonly description: "Preferred provider for image generation";
             readonly options: readonly [{
                 readonly value: "auto";
                 readonly label: "Auto";
@@ -3514,6 +3798,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "online";
         readonly ui: {
             readonly tab: "providers";
+            readonly group: "Tiny Model";
             readonly label: "Tiny Model";
             readonly description: "Session-title model: online pi/smol by default, or a local on-device model";
             readonly options: ({
@@ -3533,6 +3818,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "default";
         readonly ui: {
             readonly tab: "providers";
+            readonly group: "Tiny Model";
             readonly label: "Tiny Model Device";
             readonly description: "ONNX execution provider for local tiny models (titles + memory). Default uses CPU-only inference. The PI_TINY_DEVICE env var overrides this.";
             readonly options: readonly [{
@@ -3600,6 +3886,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "default";
         readonly ui: {
             readonly tab: "providers";
+            readonly group: "Tiny Model";
             readonly label: "Tiny Model Precision";
             readonly description: "ONNX quantization/precision for local tiny models. Default uses each model's shipped dtype (q4); lower precision is faster, higher is more faithful. The PI_TINY_DTYPE env var overrides this.";
             readonly options: readonly [{
@@ -3667,6 +3954,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "online";
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "General";
             readonly label: "Memory Model";
             readonly description: "Mnemopi LLM for fact extraction + consolidation: online (smol/remote) by default, or a local on-device model";
             readonly condition: "mnemopiActive";
@@ -3687,6 +3975,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "online";
         readonly ui: {
             readonly tab: "model";
+            readonly group: "Thinking";
             readonly label: "Auto Thinking Model";
             readonly description: "Difficulty classifier for the `auto` thinking level: online smol by default, or a local on-device model";
             readonly condition: "autoThinkingActive";
@@ -3707,6 +3996,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "anthropic";
         readonly ui: {
             readonly tab: "providers";
+            readonly group: "Protocol";
             readonly label: "Kimi API Format";
             readonly description: "API format for Kimi Code provider";
             readonly options: readonly [{
@@ -3726,6 +4016,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "auto";
         readonly ui: {
             readonly tab: "providers";
+            readonly group: "Protocol";
             readonly label: "OpenAI WebSockets";
             readonly description: "Websocket policy for OpenAI Codex models (auto uses model defaults, on forces, off disables)";
             readonly options: readonly [{
@@ -3749,6 +4040,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "default";
         readonly ui: {
             readonly tab: "providers";
+            readonly group: "Protocol";
             readonly label: "OpenRouter Routing";
             readonly description: "Default routing-variant suffix appended to OpenRouter model IDs (overridden when the selector already names a variant)";
             readonly options: readonly [{
@@ -3780,6 +4072,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "auto";
         readonly ui: {
             readonly tab: "providers";
+            readonly group: "Services";
             readonly label: "Fetch Provider";
             readonly description: "Reader backend priority for the fetch/read URL tool";
             readonly options: readonly [{
@@ -3815,6 +4108,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "auto";
         readonly ui: {
             readonly tab: "providers";
+            readonly group: "Protocol";
             readonly label: "Append-Only Context";
             readonly description: "Cache system prompt + tool specs and keep an append-only message log so provider prefix caches (DeepSeek, Xiaomi/SGLang, Anthropic) hit at maximum rate. Auto enables for known prefix-cache providers.";
             readonly options: readonly [{
@@ -3837,6 +4131,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "providers";
+            readonly group: "Services";
             readonly label: "Exa";
             readonly description: "Master toggle for all Exa search tools";
         };
@@ -3846,8 +4141,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "providers";
+            readonly group: "Services";
             readonly label: "Exa Search";
-            readonly description: "Basic search, deep search, code search, crawl";
+            readonly description: "Enable Exa basic search, deep search, code search, and crawl tools";
         };
     };
     readonly "exa.enableResearcher": {
@@ -3855,8 +4151,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "providers";
+            readonly group: "Services";
             readonly label: "Exa Researcher";
-            readonly description: "AI-powered deep research tasks";
+            readonly description: "Enable the Exa researcher tool for AI-powered deep research";
         };
     };
     readonly "exa.enableWebsets": {
@@ -3864,8 +4161,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "providers";
+            readonly group: "Services";
             readonly label: "Exa Websets";
-            readonly description: "Webset management and enrichment tools";
+            readonly description: "Enable Exa webset management and enrichment tools";
         };
     };
     readonly "searxng.endpoint": {
@@ -3873,8 +4171,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: undefined;
         readonly ui: {
             readonly tab: "providers";
+            readonly group: "Services";
             readonly label: "SearXNG Endpoint";
-            readonly description: "Self-hosted search base URL";
+            readonly description: "Base URL of a self-hosted SearXNG instance used for web search";
         };
     };
     readonly "searxng.token": {
@@ -3926,6 +4225,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Developer";
             readonly label: "Auto QA";
             readonly description: "Enable automated tool issue reporting (report_tool_issue) for all agents";
         };
@@ -3935,8 +4235,9 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "https://qa.omp.sh/v1/grievances";
         readonly ui: {
             readonly tab: "tools";
+            readonly group: "Developer";
             readonly label: "Auto QA Push Endpoint";
-            readonly description: "Full URL that receives the JSON payload (default ships to https://qa.omp.sh/v1/grievances)";
+            readonly description: "Full URL receiving Auto QA JSON reports (default https://qa.omp.sh/v1/grievances)";
         };
     };
     readonly "dev.autoqaPush.token": {
@@ -4021,6 +4322,8 @@ export type StatusLinePreset = SettingValue<"statusLine.preset">;
 export type StatusLineSeparatorStyle = SettingValue<"statusLine.separator">;
 /** Tree selector filter mode - derived from schema */
 export type TreeFilterMode = SettingValue<"treeFilterMode">;
+/** Personality preset - derived from schema */
+export type Personality = SettingValue<"personality">;
 export interface CompactionSettings {
     enabled: boolean;
     strategy: "context-full" | "handoff" | "shake" | "snapcompact" | "off";