@prometheus-ai/agent 0.5.4 → 0.5.8

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" | "channels";
+export type SettingTab = "appearance" | "model" | "interaction" | "context" | "memory" | "files" | "shell" | "tools" | "tasks" | "providers" | "channels";
 /** Tab display metadata - icon is resolved via theme.symbol() */
 export type TabMetadata = {
     label: string;
@@ -22,8 +26,14 @@ 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 = "prometheus" | "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";
+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" | "collab";
 /** Submenu choice metadata. */
 export type SubmenuOption<V extends string = string> = {
     value: V;
@@ -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 */
@@ -62,7 +74,7 @@ export type AnyUiMetadata = UiBase & {
 };
 interface BooleanDef {
     type: "boolean";
-    default: boolean;
+    default: boolean | undefined;
     ui?: UiBoolean;
 }
 interface StringDef {
@@ -95,16 +107,14 @@ type SettingDef = BooleanDef | StringDef | NumberDef | EnumDef<readonly string[]
 export interface ModelTagDef {
     name: string;
     color?: string;
+    /** If true, the role is functional but not shown in the model selector UI. */
+    hidden?: boolean;
 }
 export interface ModelTagsSettings {
     [key: string]: ModelTagDef;
 }
 export declare const DEFAULT_BASH_INTERCEPTOR_RULES: BashInterceptorRule[];
 export declare const SETTINGS_SCHEMA: {
-    readonly lastChangelogVersion: {
-        readonly type: "string";
-        readonly default: undefined;
-    };
     readonly setupVersion: {
         readonly type: "number";
         readonly default: 0;
@@ -122,6 +132,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "channels";
+            readonly group: "Telegram";
             readonly label: "Telegram Gateway";
             readonly description: "Use the configured Telegram Bot API gateway when serving Prometheus externally";
         };
@@ -132,6 +143,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "webhook";
         readonly ui: {
             readonly tab: "channels";
+            readonly group: "Telegram";
             readonly label: "Telegram Connection Mode";
             readonly description: "Use webhook ingress or Bot API long polling for Telegram updates";
             readonly options: readonly [{
@@ -150,6 +162,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: undefined;
         readonly ui: {
             readonly tab: "channels";
+            readonly group: "Telegram";
             readonly label: "Telegram Bot Username";
             readonly description: "Telegram bot username without @; setup can fill this from getMe";
         };
@@ -159,6 +172,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: undefined;
         readonly ui: {
             readonly tab: "channels";
+            readonly group: "Telegram";
             readonly label: "Telegram Public URL";
             readonly description: "HTTPS public base URL that Telegram should call through the tunnel";
         };
@@ -168,6 +182,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "/telegram/webhook";
         readonly ui: {
             readonly tab: "channels";
+            readonly group: "Telegram";
             readonly label: "Telegram Webhook Path";
             readonly description: "HTTP path that receives Telegram webhook updates";
         };
@@ -177,6 +192,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: undefined;
         readonly ui: {
             readonly tab: "channels";
+            readonly group: "Telegram";
             readonly label: "Telegram Allowed Users";
             readonly description: "Comma-separated Telegram user IDs allowed to use the gateway";
         };
@@ -186,6 +202,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: undefined;
         readonly ui: {
             readonly tab: "channels";
+            readonly group: "Telegram";
             readonly label: "Telegram Allowed Chats";
             readonly description: "Comma-separated Telegram chat IDs allowed to use the gateway";
         };
@@ -196,6 +213,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "shared";
         readonly ui: {
             readonly tab: "channels";
+            readonly group: "Telegram";
             readonly label: "Telegram Group Scope";
             readonly description: "Session sharing for non-threaded group chats";
             readonly options: readonly [{
@@ -215,6 +233,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "shared";
         readonly ui: {
             readonly tab: "channels";
+            readonly group: "Telegram";
             readonly label: "Telegram Thread Scope";
             readonly description: "Session sharing for Telegram topics and direct-message topics";
             readonly options: readonly [{
@@ -234,6 +253,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "none";
         readonly ui: {
             readonly tab: "channels";
+            readonly group: "Telegram";
             readonly label: "Telegram Parse Mode";
             readonly description: "Telegram parse_mode for bot replies";
             readonly options: readonly [{
@@ -260,6 +280,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "channels";
+            readonly group: "Telegram";
             readonly label: "Telegram Silent Replies";
             readonly description: "Send Telegram replies without notification sound";
         };
@@ -269,6 +290,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "channels";
+            readonly group: "Telegram";
             readonly label: "Telegram HD Previews";
             readonly description: "Ask Telegram to use larger media previews where the Bot API supports it";
         };
@@ -278,6 +300,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "channels";
+            readonly group: "Telegram";
             readonly label: "Telegram Bot Messages";
             readonly description: "Allow Telegram messages sent by bot accounts";
         };
@@ -287,6 +310,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "channels";
+            readonly group: "Telegram";
             readonly label: "Telegram Raw Payloads";
             readonly description: "Attach raw Telegram update payloads to gateway events for debugging";
         };
@@ -296,6 +320,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "channels";
+            readonly group: "Telegram";
             readonly label: "Telegram Expressions";
             readonly description: "Allow Prometheus to attach matching Telegram expression intents to replies";
         };
@@ -305,6 +330,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 2;
         readonly ui: {
             readonly tab: "channels";
+            readonly group: "Telegram";
             readonly label: "Telegram Expression Match";
             readonly description: "Minimum local catalog match score before attaching a Telegram expression";
             readonly options: readonly [{
@@ -327,6 +353,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: Record<string, unknown>;
         readonly ui: {
             readonly tab: "channels";
+            readonly group: "Telegram";
             readonly label: "Telegram Expression Catalog";
             readonly description: "Searchable Telegram expression intents with sticker/GIF variants";
         };
@@ -336,6 +363,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: undefined;
         readonly ui: {
             readonly tab: "channels";
+            readonly group: "Telegram";
             readonly label: "Telegram Expression File";
             readonly description: "Optional JSON catalog path for Telegram expression intents";
         };
@@ -345,6 +373,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";
         };
@@ -354,8 +383,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": {
@@ -363,8 +393,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": {
@@ -372,8 +403,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": {
@@ -381,8 +413,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: {
@@ -393,29 +426,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[];
@@ -449,8 +459,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";
         };
     };
@@ -459,8 +470,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";
         };
     };
@@ -470,8 +482,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";
@@ -492,6 +505,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";
         };
@@ -502,6 +516,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 [{
@@ -541,6 +556,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 [{
@@ -579,16 +595,28 @@ 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";
         };
     };
+    readonly "statusLine.transparent": {
+        readonly type: "boolean";
+        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.";
+        };
+    };
     readonly "tools.artifactSpillThreshold": {
         readonly type: "number";
         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";
@@ -646,7 +674,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";
@@ -688,7 +717,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";
@@ -734,7 +764,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";
@@ -769,7 +800,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";
@@ -807,8 +839,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": {
@@ -828,8 +861,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";
         };
     };
@@ -838,6 +872,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";
         };
@@ -847,6 +882,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";
         };
@@ -871,6 +907,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.";
         };
@@ -881,6 +918,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)";
         };
@@ -895,6 +933,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 [{
@@ -912,11 +951,22 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly "display.smoothStreaming": {
+        readonly type: "boolean";
+        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";
+        };
+    };
     readonly "display.showTokenUsage": {
         readonly type: "boolean";
         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";
         };
@@ -926,25 +976,18 @@ 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";
         };
     };
-    readonly clearOnShrink: {
-        readonly type: "boolean";
-        readonly default: false;
-        readonly ui: {
-            readonly tab: "appearance";
-            readonly label: "Clear on Shrink";
-            readonly description: "Clear empty rows when content shrinks (may cause flicker)";
-        };
-    };
     readonly defaultThinkingLevel: {
         readonly type: "enum";
-        readonly values: readonly [...import("@prometheus-ai/ai").Effort[], "auto"];
+        readonly values: readonly [...import("@prometheus-ai/catalog").Effort[], "auto"];
         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[]];
@@ -955,6 +998,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";
         };
@@ -964,6 +1008,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";
         };
@@ -973,15 +1018,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 [{
@@ -1016,6 +1091,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 [{
@@ -1050,6 +1126,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 [{
@@ -1080,6 +1157,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 [{
@@ -1106,6 +1184,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 [{
@@ -1136,6 +1215,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 [{
@@ -1171,6 +1251,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 [{
@@ -1208,15 +1289,40 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly fastModeScope: {
+        readonly type: "enum";
+        readonly values: readonly ["both", "openai", "claude"];
+        readonly default: "both";
+        readonly ui: {
+            readonly tab: "model";
+            readonly group: "Sampling";
+            readonly label: "Fast Mode Scope";
+            readonly description: 'Which providers `/fast on` (and the fast-mode toggle) target. "both" = priority on every supported provider; "openai"/"claude" scope it to one family (mirrors serviceTier openai-only/claude-only).';
+            readonly options: readonly [{
+                readonly value: "both";
+                readonly label: "Both";
+                readonly description: "Priority on every supported provider";
+            }, {
+                readonly value: "openai";
+                readonly label: "OpenAI only";
+                readonly description: "Priority on OpenAI/OpenAI-Codex requests; ignored elsewhere";
+            }, {
+                readonly value: "claude";
+                readonly label: "Claude only";
+                readonly description: "Anthropic fast mode on direct Claude requests; ignored elsewhere";
+            }];
+        };
+    };
     readonly "retry.enabled": {
         readonly type: "boolean";
         readonly default: true;
     };
     readonly "retry.maxRetries": {
         readonly type: "number";
-        readonly default: 3;
+        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 [{
@@ -1239,13 +1345,14 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "retry.baseDelayMs": {
         readonly type: "number";
-        readonly default: 2000;
+        readonly default: 500;
     };
     readonly "retry.maxDelayMs": {
         readonly type: "number";
         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).";
         };
@@ -1255,6 +1362,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";
         };
@@ -1269,6 +1377,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 [{
@@ -1288,6 +1397,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";
         };
@@ -1298,6 +1408,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";
         };
@@ -1308,6 +1419,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";
         };
@@ -1318,6 +1430,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 [{
@@ -1341,6 +1454,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";
         };
@@ -1351,6 +1465,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";
         };
@@ -1360,6 +1475,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 [{
@@ -1388,15 +1504,43 @@ 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 `:-)`";
         };
     };
+    readonly "paste.largeMenuThreshold": {
+        readonly type: "number";
+        readonly default: 100;
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly group: "Input";
+            readonly label: "Large Paste Menu";
+            readonly description: "When a paste reaches this many lines, offer a menu to wrap it in a code block, wrap it in XML tags, or save it to a file. 0 disables the menu (large pastes still collapse to a [Paste] marker).";
+            readonly options: readonly [{
+                readonly value: "0";
+                readonly label: "Off";
+            }, {
+                readonly value: "100";
+                readonly label: "100 lines";
+            }, {
+                readonly value: "250";
+                readonly label: "250 lines";
+            }, {
+                readonly value: "500";
+                readonly label: "500 lines";
+            }, {
+                readonly value: "1000";
+                readonly label: "1000 lines";
+            }];
+        };
+    };
     readonly "startup.quiet": {
         readonly type: "boolean";
         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";
         };
@@ -1406,6 +1550,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";
         };
@@ -1415,8 +1560,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 prometheus 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: {
@@ -1424,18 +1594,60 @@ 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";
         };
     };
+    readonly "magicKeywords.enabled": {
+        readonly type: "boolean";
+        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";
+        };
+    };
+    readonly "magicKeywords.ultrathink": {
+        readonly type: "boolean";
+        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";
+        };
+    };
+    readonly "magicKeywords.orchestrate": {
+        readonly type: "boolean";
+        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";
+        };
+    };
+    readonly "magicKeywords.workflow": {
+        readonly type: "boolean";
+        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";
+        };
+    };
     readonly "completion.notify": {
         readonly type: "enum";
         readonly values: readonly ["on", "off"];
         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": {
@@ -1443,8 +1655,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";
@@ -1469,8 +1682,49 @@ 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 "collab.relayUrl": {
+        readonly type: "string";
+        readonly default: "wss://my.prometheus.trivlab.com";
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly group: "Collab";
+            readonly label: "Relay URL";
+            readonly description: "Relay used by /collab (wss://host[:port])";
+        };
+    };
+    readonly "collab.displayName": {
+        readonly type: "string";
+        readonly default: "";
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly group: "Collab";
+            readonly label: "Display Name";
+            readonly description: "Name shown to other collab participants (default: OS username)";
+        };
+    };
+    readonly "share.serverUrl": {
+        readonly type: "string";
+        readonly default: "https://my.prometheus.trivlab.com/s";
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly group: "Collab";
+            readonly label: "Share Server";
+            readonly description: "Share viewer/upload base used by /share (encrypted blob upload + viewer; links are <base>/<id>#<key>)";
+        };
+    };
+    readonly "share.redactSecrets": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly group: "Collab";
+            readonly label: "Share Secret Redaction";
+            readonly description: "Run the secret obfuscator over /share snapshots before upload (uses the secrets.* config)";
         };
     };
     readonly "stt.enabled": {
@@ -1478,6 +1732,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";
         };
@@ -1488,49 +1743,18 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "stt.modelName": {
         readonly type: "enum";
-        readonly values: readonly ["tiny", "tiny.en", "base", "base.en", "small", "small.en", "medium", "medium.en", "large"];
-        readonly default: "base.en";
+        readonly values: readonly ["fast", "balanced", "turbo", "parakeet"];
+        readonly default: "parakeet";
         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 [{
-                readonly value: "tiny";
-                readonly label: "tiny";
-                readonly description: "Multilingual; fastest, lowest accuracy";
-            }, {
-                readonly value: "tiny.en";
-                readonly label: "tiny.en";
-                readonly description: "English-only; fastest";
-            }, {
-                readonly value: "base";
-                readonly label: "base";
-                readonly description: "Multilingual; small and fast";
-            }, {
-                readonly value: "base.en";
-                readonly label: "base.en";
-                readonly description: "English-only; default";
-            }, {
-                readonly value: "small";
-                readonly label: "small";
-                readonly description: "Multilingual; balanced";
-            }, {
-                readonly value: "small.en";
-                readonly label: "small.en";
-                readonly description: "English-only; balanced";
-            }, {
-                readonly value: "medium";
-                readonly label: "medium";
-                readonly description: "Multilingual; accurate but slower";
-            }, {
-                readonly value: "medium.en";
-                readonly label: "medium.en";
-                readonly description: "English-only; accurate but slower";
-            }, {
-                readonly value: "large";
-                readonly label: "large";
-                readonly description: "Multilingual; most accurate";
-            }];
+            readonly description: "Local on-device speech model. Parakeet TDT v3 (sherpa-onnx) is the SoTA default; Whisper base/small/large-v3-turbo tiers (transformers.js) trade size for multilingual coverage. Downloaded on first use.";
+            readonly options: {
+                value: "balanced" | "fast" | "parakeet" | "turbo";
+                label: "Balanced (Whisper small)" | "Fast (Whisper base)" | "Parakeet TDT v3 (SoTA)" | "Turbo (Whisper large-v3)";
+                description: "NVIDIA Parakeet TDT 0.6B v3, 25 languages. Open ASR Leaderboard leader — best accuracy and far fastest decoding. Default." | "Whisper base, multilingual. Smallest + fastest; lowest accuracy. Best for low-resource machines." | "Whisper large-v3-turbo, 99 languages. Widest language coverage; large download, slower." | "Whisper small, multilingual. More accurate than Fast, still light on CPU/RAM.";
+            }[];
         };
     };
     readonly "contextPromotion.enabled": {
@@ -1538,6 +1762,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";
         };
@@ -1547,18 +1772,20 @@ 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";
         };
     };
     readonly "compaction.strategy": {
         readonly type: "enum";
-        readonly values: readonly ["context-full", "handoff", "shake", "off"];
+        readonly values: readonly ["context-full", "handoff", "shake", "snapcompact", "off"];
         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), or disable auto maintenance (off)";
+            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 [{
                 readonly value: "context-full";
                 readonly label: "Context-full";
@@ -1571,6 +1798,10 @@ export declare const SETTINGS_SCHEMA: {
                 readonly value: "shake";
                 readonly label: "Shake";
                 readonly description: "Drop heavy content (tool results + large blocks) in place; recover via artifact";
+            }, {
+                readonly value: "snapcompact";
+                readonly label: "Snapcompact";
+                readonly description: "Archive history onto dense bitmap images the model reads back; no LLM call";
             }, {
                 readonly value: "off";
                 readonly label: "Off";
@@ -1583,6 +1814,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 [{
@@ -1645,6 +1877,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 [{
@@ -1687,6 +1920,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";
         };
@@ -1696,6 +1930,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";
         };
@@ -1721,6 +1956,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";
         };
@@ -1730,6 +1966,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 [{
@@ -1767,6 +2004,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 [{
@@ -1790,11 +2028,146 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly "compaction.supersedeReads": {
+        readonly type: "boolean";
+        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 "compaction.dropUseless": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "context";
+            readonly group: "Compaction";
+            readonly label: "Elide Uneventful Results";
+            readonly description: "Prune tool results flagged contextually useless (no matches, timed-out waits) once consumed (cache-aware)";
+        };
+    };
+    readonly "snapcompact.systemPrompt": {
+        readonly type: "enum";
+        readonly values: readonly ["none", "agents-md", "all"];
+        readonly default: "none";
+        readonly ui: {
+            readonly tab: "context";
+            readonly group: "Experimental";
+            readonly label: "Snapcompact System Prompt";
+            readonly description: "Experimental: render selected system prompt text as dense PNG image(s) and attach to the first user message (vision models only). Saves tokens; loses prompt caching for imaged text.";
+            readonly options: readonly [{
+                readonly value: "none";
+                readonly label: "None";
+                readonly description: "Keep the system prompt as text.";
+            }, {
+                readonly value: "agents-md";
+                readonly label: "AGENTS.md";
+                readonly description: "Only move loaded context-file instructions to images, when that saves tokens.";
+            }, {
+                readonly value: "all";
+                readonly label: "All";
+                readonly description: "Move the full system prompt to images, when that saves tokens.";
+            }];
+        };
+    };
+    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 "snapcompact.shape": {
+        readonly type: "enum";
+        readonly values: readonly ["auto", ...("11on16-bw" | "5x8-bw" | "5x8-sent" | "6x12-dim" | "6x6u-bw" | "6x6u-sent" | "8on16-bw" | "8on22-bw" | "8x13-bw" | "8x8r-bw" | "8x8r-sent" | "8x8u-bw" | "8x8u-sent" | "doc-8on16-bw" | "doc-8on16-sent" | "doc-8on16-sent-dim")[]];
+        readonly default: "auto";
+        readonly ui: {
+            readonly tab: "context";
+            readonly group: "Experimental";
+            readonly label: "Snapcompact Shape";
+            readonly description: "Frame shape snapcompact prints text with (compaction archive and inline imaging). Auto picks a shape tuned for the current model.";
+            readonly options: readonly [{
+                readonly value: "auto";
+                readonly label: "Auto";
+                readonly description: "Picks a shape tuned for the current model, falling back to its provider family.";
+            }, {
+                readonly value: "8x8r-bw";
+                readonly label: "8x8 repeated, black";
+                readonly description: "unscii square cell, black ink, every line printed twice with the copy on a pale highlight band.";
+            }, {
+                readonly value: "8x8r-sent";
+                readonly label: "8x8 repeated, sentence hues";
+                readonly description: "Repeated grid with ink cycling six hues at sentence boundaries.";
+            }, {
+                readonly value: "8x8u-bw";
+                readonly label: "8x8, black";
+                readonly description: "Plain unscii square cell, single-printed lines, black ink.";
+            }, {
+                readonly value: "8x8u-sent";
+                readonly label: "8x8, sentence hues";
+                readonly description: "Plain unscii square cell with sentence-hue ink.";
+            }, {
+                readonly value: "6x6u-bw";
+                readonly label: "6x6 dense, black";
+                readonly description: "unscii squeezed to 6x6 — densest readable cell, fewest frames — in black ink.";
+            }, {
+                readonly value: "6x6u-sent";
+                readonly label: "6x6 dense, sentence hues";
+                readonly description: "Densest cell with sentence-hue ink.";
+            }, {
+                readonly value: "5x8-bw";
+                readonly label: "5x8 legacy, black";
+                readonly description: "Original X.org 5x8 glyphs on the 2576px frame, black ink.";
+            }, {
+                readonly value: "5x8-sent";
+                readonly label: "5x8 legacy, sentence hues";
+                readonly description: "The original snapcompact shape (pre-shape-table sessions rendered this).";
+            }, {
+                readonly value: "6x12-dim";
+                readonly label: "6x12, dimmed stopwords";
+                readonly description: "X.org 6x12 glyphs, black ink, function words dimmed gray.";
+            }, {
+                readonly value: "8x13-bw";
+                readonly label: "8x13, black";
+                readonly description: "X.org 8x13 glyphs, black ink.";
+            }, {
+                readonly value: "8on16-bw";
+                readonly label: "8x13 on 16px pitch, black";
+                readonly description: "8x13 glyphs on an 8x16 cell (extra leading), black ink.";
+            }, {
+                readonly value: "8on22-bw";
+                readonly label: "8x13 on 22px pitch (leading), black";
+                readonly description: "8x13 glyphs on an 8x22 cell — extra line spacing so rows don't crowd. Default for OpenAI/Google.";
+            }, {
+                readonly value: "11on16-bw";
+                readonly label: "8x13 on 11px advance (tracking), black";
+                readonly description: "8x13 glyphs on an 11x16 cell — extra letter spacing so characters don't merge. Default for Anthropic.";
+            }, {
+                readonly value: "doc-8on16-bw";
+                readonly label: "Doc 8on16, black";
+                readonly description: "Two word-wrapped newspaper columns of 8x13 glyphs on a 16px pitch, black ink.";
+            }, {
+                readonly value: "doc-8on16-sent";
+                readonly label: "Doc 8on16, sentence hues";
+                readonly description: "Two-column doc layout with sentence-hue ink.";
+            }, {
+                readonly value: "doc-8on16-sent-dim";
+                readonly label: "Doc 8on16, sentence hues + dimmed stopwords";
+                readonly description: "Two-column doc layout, sentence-hue ink, function words dimmed gray.";
+            }];
+        };
+    };
     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";
         };
@@ -1869,12 +2242,13 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "memory.backend": {
         readonly type: "enum";
-        readonly values: readonly ["off", "local", "hindsight", "prometheus-memory"];
+        readonly values: readonly ["off", "local", "hindsight", "mnemopi"];
         readonly default: "off";
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "General";
             readonly label: "Memory Backend";
-            readonly description: "Off, local summary pipeline, Prometheus Memory SQLite, or Hindsight remote memory";
+            readonly description: "Off, local summary pipeline, Mnemopi SQLite, or Hindsight remote memory";
             readonly options: readonly [{
                 readonly value: "off";
                 readonly label: "Off";
@@ -1888,18 +2262,44 @@ export declare const SETTINGS_SCHEMA: {
                 readonly label: "Hindsight";
                 readonly description: "Vectorize Hindsight remote memory service";
             }, {
-                readonly value: "prometheus-memory";
-                readonly label: "Prometheus Memory";
+                readonly value: "mnemopi";
+                readonly label: "Mnemopi";
                 readonly description: "Local SQLite recall/retain backend with optional embeddings";
             }];
         };
     };
+    readonly "autolearn.enabled": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "memory";
+            readonly group: "Auto-Learn";
+            readonly label: "Auto-Learn (experimental)";
+            readonly description: "After the agent stops, nudge it to capture lessons to memory and create/enhance isolated managed skills";
+        };
+    };
+    readonly "autolearn.autoContinue": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "memory";
+            readonly group: "Auto-Learn";
+            readonly label: "Auto-run capture at stop";
+            readonly description: "When on, auto-run one capture turn at stop (uses extra tokens). Off = passive reminder on your next turn.";
+            readonly condition: "autolearnActive";
+        };
+    };
+    readonly "autolearn.minToolCalls": {
+        readonly type: "number";
+        readonly default: 5;
+    };
     readonly "selfImprovement.mode": {
         readonly type: "enum";
         readonly values: readonly ["memory-and-skills", "off"];
         readonly default: "memory-and-skills";
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Self Improvement";
             readonly label: "Self Improvement";
             readonly description: "Hermes-style native learning: memory, user profile, and skills update automatically; SOUL stays stable";
             readonly options: readonly [{
@@ -1919,6 +2319,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "memory-and-skills";
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Self Improvement";
             readonly label: "Post-Turn Review";
             readonly description: "Hermes-style background review after settled turns, routed through the native Prometheus memory pipeline";
             readonly options: readonly [{
@@ -1937,6 +2338,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 10;
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Self Improvement";
             readonly label: "Review Turn Interval";
             readonly description: "User turns between post-turn self-improvement reviews; 10 mirrors Hermes";
         };
@@ -1947,6 +2349,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "propose";
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Self Improvement";
             readonly label: "Identity Review";
             readonly description: "Proposal-only SOUL review; never rewrites SOUL.md automatically";
             readonly options: readonly [{
@@ -1966,6 +2369,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "dry-run";
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Self Improvement";
             readonly label: "Skill Curator";
             readonly description: "Report-only generated-skill curation with recoverable archive lifecycle";
             readonly options: readonly [{
@@ -1984,6 +2388,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 30;
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Self Improvement";
             readonly label: "Skill Stale Days";
             readonly description: "Days of no generated-skill activity before the dry-run curator marks it stale";
         };
@@ -1993,127 +2398,181 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 90;
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "Self Improvement";
             readonly label: "Skill Archive Days";
             readonly description: "Days of no generated-skill activity before the dry-run curator suggests archive";
         };
     };
-    readonly "prometheusMemory.dbPath": {
+    readonly "mnemopi.dbPath": {
         readonly type: "string";
         readonly default: undefined;
         readonly ui: {
             readonly tab: "memory";
-            readonly label: "Prometheus Memory DB Path";
+            readonly group: "Mnemopi";
+            readonly label: "Mnemopi DB Path";
             readonly description: "Optional SQLite DB path. Defaults to the agent memories directory.";
-            readonly condition: "prometheusMemoryActive";
+            readonly condition: "mnemopiActive";
         };
     };
-    readonly "prometheusMemory.bank": {
+    readonly "mnemopi.bank": {
         readonly type: "string";
         readonly default: undefined;
         readonly ui: {
             readonly tab: "memory";
-            readonly label: "Prometheus Memory Bank";
+            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: "prometheusMemoryActive";
+            readonly condition: "mnemopiActive";
         };
     };
-    readonly "prometheusMemory.scoping": {
+    readonly "mnemopi.scoping": {
         readonly type: "enum";
         readonly values: readonly ["global", "per-project", "per-project-tagged"];
         readonly default: "per-project";
         readonly ui: {
             readonly tab: "memory";
-            readonly label: "Prometheus Memory Scoping";
+            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 [{
                 readonly value: "global";
                 readonly label: "Global";
-                readonly description: "One shared Prometheus Memory bank for every project";
+                readonly description: "One shared Mnemopi bank for every project";
             }, {
                 readonly value: "per-project";
                 readonly label: "Per project";
-                readonly description: "Project-local Prometheus Memory bank per cwd basename";
+                readonly description: "Project-local Mnemopi bank per cwd basename";
             }, {
                 readonly value: "per-project-tagged";
                 readonly label: "Per project (tagged)";
                 readonly description: "Write to a project-local bank but merge project + shared recall results";
             }];
-            readonly condition: "prometheusMemoryActive";
+            readonly condition: "mnemopiActive";
         };
     };
-    readonly "prometheusMemory.autoRecall": {
+    readonly "mnemopi.embeddingVariant": {
+        readonly type: "enum";
+        readonly values: readonly ["en", "multilingual"];
+        readonly default: "en";
+        readonly ui: {
+            readonly tab: "memory";
+            readonly group: "Mnemopi";
+            readonly label: "Embedding variant";
+            readonly description: "Local embedding model family. en = stronger English model; multilingual = cross-language model. Changing this rebuilds existing memory embeddings on next start.";
+            readonly options: readonly [{
+                readonly value: "en";
+                readonly label: "English (bge-base-en-v1.5)";
+                readonly description: "BAAI/bge-base-en-v1.5 (768d), English-only";
+            }, {
+                readonly value: "multilingual";
+                readonly label: "Multilingual (multilingual-e5-large)";
+                readonly description: "intfloat/multilingual-e5-large (1024d), cross-language recall";
+            }];
+            readonly condition: "mnemopiActive";
+        };
+    };
+    readonly "mnemopi.autoRecall": {
         readonly type: "boolean";
         readonly default: true;
         readonly ui: {
             readonly tab: "memory";
-            readonly label: "Prometheus Memory Auto Recall";
+            readonly group: "Mnemopi";
+            readonly label: "Mnemopi Auto Recall";
             readonly description: "Recall local memories into the first turn of each session";
-            readonly condition: "prometheusMemoryActive";
+            readonly condition: "mnemopiActive";
         };
     };
-    readonly "prometheusMemory.autoRetain": {
+    readonly "mnemopi.autoRetain": {
         readonly type: "boolean";
         readonly default: true;
         readonly ui: {
             readonly tab: "memory";
-            readonly label: "Prometheus Memory Auto Retain";
-            readonly description: "Retain completed conversation turns into local Prometheus Memory";
-            readonly condition: "prometheusMemoryActive";
+            readonly group: "Mnemopi";
+            readonly label: "Mnemopi Auto Retain";
+            readonly description: "Retain completed conversation turns into local Mnemopi memory";
+            readonly condition: "mnemopiActive";
         };
     };
-    readonly "prometheusMemory.noEmbeddings": {
+    readonly "mnemopi.polyphonicRecall": {
         readonly type: "boolean";
         readonly default: false;
         readonly ui: {
             readonly tab: "memory";
-            readonly label: "Prometheus Memory Disable Embeddings";
+            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: "prometheusMemoryActive";
+            readonly condition: "mnemopiActive";
         };
     };
-    readonly "prometheusMemory.embeddingModel": {
+    readonly "mnemopi.embeddingModel": {
         readonly type: "string";
         readonly default: undefined;
         readonly ui: {
             readonly tab: "memory";
-            readonly label: "Prometheus Memory Embedding Model";
-            readonly description: "Optional embedding model override passed to Prometheus Memory";
-            readonly condition: "prometheusMemoryActive";
+            readonly group: "Mnemopi";
+            readonly label: "Mnemopi Embedding Model";
+            readonly description: "Advanced: explicit embedding model id that overrides the variant. Leave empty to use mnemopi.embeddingVariant.";
+            readonly condition: "mnemopiActive";
         };
     };
-    readonly "prometheusMemory.embeddingApiUrl": {
+    readonly "mnemopi.embeddingApiUrl": {
         readonly type: "string";
         readonly default: undefined;
         readonly ui: {
             readonly tab: "memory";
-            readonly label: "Prometheus Memory Embedding API URL";
-            readonly description: "Optional OpenAI-compatible embedding endpoint passed to Prometheus Memory";
-            readonly condition: "prometheusMemoryActive";
+            readonly group: "Mnemopi";
+            readonly label: "Mnemopi Embedding API URL";
+            readonly description: "Optional OpenAI-compatible embedding endpoint passed to Mnemopi";
+            readonly condition: "mnemopiActive";
         };
     };
-    readonly "prometheusMemory.embeddingApiKey": {
+    readonly "mnemopi.embeddingApiKey": {
         readonly type: "string";
         readonly default: undefined;
         readonly ui: {
             readonly tab: "memory";
-            readonly label: "Prometheus Memory Embedding API Key";
-            readonly description: "Optional embedding API key passed to Prometheus Memory";
-            readonly condition: "prometheusMemoryActive";
+            readonly group: "Mnemopi";
+            readonly label: "Mnemopi Embedding API Key";
+            readonly description: "Optional embedding API key passed to Mnemopi";
+            readonly condition: "mnemopiActive";
         };
     };
-    readonly "prometheusMemory.llmMode": {
+    readonly "mnemopi.llmMode": {
         readonly type: "enum";
         readonly values: readonly ["none", "smol", "remote"];
         readonly default: "smol";
         readonly ui: {
             readonly tab: "memory";
-            readonly label: "Prometheus Memory LLM Mode";
+            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: "prometheusMemoryActive";
+            readonly condition: "mnemopiActive";
             readonly options: readonly [{
                 readonly value: "none";
                 readonly label: "None";
-                readonly description: "Disable Prometheus Memory LLM-backed extraction";
+                readonly description: "Disable Mnemopi LLM-backed extraction";
             }, {
                 readonly value: "smol";
                 readonly label: "Smol";
@@ -2121,61 +2580,64 @@ export declare const SETTINGS_SCHEMA: {
             }, {
                 readonly value: "remote";
                 readonly label: "Remote";
-                readonly description: "Use the Prometheus Memory remote LLM settings below";
+                readonly description: "Use the Mnemopi remote LLM settings below";
             }];
         };
     };
-    readonly "prometheusMemory.llmBaseUrl": {
+    readonly "mnemopi.llmBaseUrl": {
         readonly type: "string";
         readonly default: undefined;
         readonly ui: {
             readonly tab: "memory";
-            readonly label: "Prometheus Memory LLM Base URL";
-            readonly description: "Optional OpenAI-compatible LLM endpoint for Prometheus Memory remote mode";
-            readonly condition: "prometheusMemoryActive";
+            readonly group: "Mnemopi";
+            readonly label: "Mnemopi LLM Base URL";
+            readonly description: "Optional OpenAI-compatible LLM endpoint for Mnemopi remote mode";
+            readonly condition: "mnemopiActive";
         };
     };
-    readonly "prometheusMemory.llmApiKey": {
+    readonly "mnemopi.llmApiKey": {
         readonly type: "string";
         readonly default: undefined;
         readonly ui: {
             readonly tab: "memory";
-            readonly label: "Prometheus Memory LLM API Key";
-            readonly description: "Optional LLM API key for Prometheus Memory remote mode";
-            readonly condition: "prometheusMemoryActive";
+            readonly group: "Mnemopi";
+            readonly label: "Mnemopi LLM API Key";
+            readonly description: "Optional LLM API key for Mnemopi remote mode";
+            readonly condition: "mnemopiActive";
         };
     };
-    readonly "prometheusMemory.llmModel": {
+    readonly "mnemopi.llmModel": {
         readonly type: "string";
         readonly default: undefined;
         readonly ui: {
             readonly tab: "memory";
-            readonly label: "Prometheus Memory LLM Model";
-            readonly description: "Optional LLM model name for Prometheus Memory remote mode";
-            readonly condition: "prometheusMemoryActive";
+            readonly group: "Mnemopi";
+            readonly label: "Mnemopi LLM Model";
+            readonly description: "Optional LLM model name for Mnemopi remote mode";
+            readonly condition: "mnemopiActive";
         };
     };
-    readonly "prometheusMemory.retainEveryNTurns": {
+    readonly "mnemopi.retainEveryNTurns": {
         readonly type: "number";
         readonly default: 4;
     };
-    readonly "prometheusMemory.recallLimit": {
+    readonly "mnemopi.recallLimit": {
         readonly type: "number";
         readonly default: 8;
     };
-    readonly "prometheusMemory.recallContextTurns": {
+    readonly "mnemopi.recallContextTurns": {
         readonly type: "number";
         readonly default: 3;
     };
-    readonly "prometheusMemory.recallMaxQueryChars": {
+    readonly "mnemopi.recallMaxQueryChars": {
         readonly type: "number";
         readonly default: 4000;
     };
-    readonly "prometheusMemory.injectionTokenLimit": {
+    readonly "mnemopi.injectionTokenLimit": {
         readonly type: "number";
         readonly default: 5000;
     };
-    readonly "prometheusMemory.debug": {
+    readonly "mnemopi.debug": {
         readonly type: "boolean";
         readonly default: false;
     };
@@ -2184,6 +2646,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";
@@ -2198,6 +2661,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";
@@ -2213,6 +2677,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 [{
@@ -2244,6 +2709,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";
@@ -2254,6 +2720,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";
@@ -2265,6 +2732,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 [{
@@ -2321,6 +2789,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";
@@ -2331,6 +2800,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";
@@ -2349,8 +2819,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": {
@@ -2359,6 +2830,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";
         };
@@ -2369,6 +2841,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 [{
@@ -2396,6 +2869,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";
         };
@@ -2405,6 +2879,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 [{
@@ -2430,7 +2905,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)";
         };
     };
@@ -2439,6 +2915,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)";
         };
@@ -2448,7 +2925,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)";
         };
@@ -2457,7 +2935,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";
         };
@@ -2466,9 +2945,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";
@@ -2492,7 +2972,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";
         };
@@ -2501,7 +2982,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.)";
         };
@@ -2510,7 +2992,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";
         };
@@ -2519,7 +3002,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)";
         };
@@ -2528,7 +3012,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 [{
@@ -2553,7 +3038,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";
         };
@@ -2562,7 +3048,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";
         };
@@ -2571,7 +3058,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";
         };
@@ -2580,7 +3068,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";
         };
@@ -2589,7 +3078,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";
         };
@@ -2598,7 +3088,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.";
         };
@@ -2607,7 +3098,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.";
         };
@@ -2616,7 +3108,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";
         };
@@ -2625,16 +3118,28 @@ 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: "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";
         };
     };
     readonly "lsp.formatOnWrite": {
         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";
         };
@@ -2643,7 +3148,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";
         };
@@ -2652,7 +3158,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";
         };
@@ -2661,16 +3168,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";
         };
@@ -2683,8 +3212,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.";
         };
     };
@@ -2692,7 +3222,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";
         };
@@ -2713,22 +3244,39 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "number";
         readonly default: number;
     };
+    readonly "shellMinimizer.sourceOutlineLevel": {
+        readonly type: "enum";
+        readonly values: readonly ["default", "aggressive"];
+        readonly default: "default";
+        readonly ui: {
+            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";
+        };
+    };
+    readonly "shellMinimizer.legacyFilters": {
+        readonly type: "boolean";
+        readonly default: undefined;
+    };
     readonly "eval.py": {
         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": {
@@ -2736,16 +3284,28 @@ 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: "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.";
         };
     };
     readonly "tools.approval": {
         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.";
         };
@@ -2756,8 +3316,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";
@@ -2778,6 +3339,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";
         };
@@ -2787,8 +3349,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": {
@@ -2796,8 +3359,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";
@@ -2814,12 +3378,27 @@ export declare const SETTINGS_SCHEMA: {
         };
     };
     readonly "todo.eager": {
-        readonly type: "boolean";
-        readonly default: false;
+        readonly type: "enum";
+        readonly values: readonly ["default", "preferred", "always"];
+        readonly default: "default";
         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 description: "How strongly to push automatic todo-list creation after the first message";
+            readonly options: readonly [{
+                readonly value: "default";
+                readonly label: "Default";
+                readonly description: "Model decides; no automatic todo list";
+            }, {
+                readonly value: "preferred";
+                readonly label: "Preferred";
+                readonly description: "Suggests a todo list on the first message (reminder, not forced)";
+            }, {
+                readonly value: "always";
+                readonly label: "Always";
+                readonly description: "Forces a comprehensive todo list on the first message";
+            }];
         };
     };
     readonly "find.enabled": {
@@ -2827,8 +3406,9 @@ export declare const SETTINGS_SCHEMA: {
         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": {
@@ -2836,8 +3416,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": {
@@ -2845,6 +3426,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 [{
@@ -2870,6 +3452,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 [{
@@ -2898,6 +3481,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";
         };
@@ -2907,49 +3491,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.enabled": {
-        readonly type: "boolean";
-        readonly default: true;
-        readonly ui: {
-            readonly tab: "tools";
-            readonly label: "IRC";
-            readonly description: "Enable agent-to-agent IRC messaging via the irc tool";
-        };
-    };
-    readonly "irc.timeoutMs": {
-        readonly type: "number";
-        readonly default: 120000;
-        readonly ui: {
-            readonly tab: "tools";
-            readonly label: "IRC Timeout";
-            readonly description: "Drop IRC messages whose recipient does not respond within this many 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";
         };
@@ -2959,17 +3511,19 @@ 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";
         };
     };
-    readonly "tts.enabled": {
+    readonly "speechgen.enabled": {
         readonly type: "boolean";
         readonly default: false;
         readonly ui: {
             readonly tab: "tools";
-            readonly label: "Text-to-Speech";
-            readonly description: "Enable the tts tool for xAI Grok Voice speech synthesis";
+            readonly group: "Available Tools";
+            readonly label: "Speech Generation";
+            readonly description: "Enable the tts tool for on-device (Kokoro) or xAI Grok Voice speech-file synthesis";
         };
     };
     readonly "inspect_image.enabled": {
@@ -2977,6 +3531,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";
         };
@@ -2986,6 +3541,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";
         };
@@ -2995,6 +3551,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";
         };
@@ -3004,6 +3561,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.";
         };
@@ -3013,6 +3571,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)";
         };
@@ -3022,7 +3581,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 ~/.prometheus/cache/github-cache.db so repeated reads are free";
         };
     };
@@ -3031,8 +3591,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": {
@@ -3040,8 +3601,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": {
@@ -3049,8 +3611,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": {
@@ -3058,8 +3621,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": {
@@ -3067,16 +3631,28 @@ 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)";
         };
     };
+    readonly "browser.cmux": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly group: "Search & Browser";
+            readonly label: "cmux Browser";
+            readonly description: "Use cmux WKWebView surfaces for browser automation when a cmux socket is available. Set PROMETHEUS_BROWSER_CMUX=0 or PROMETHEUS_BROWSER_CMUX=1 to override.";
+        };
+    };
     readonly "browser.screenshotDir": {
         readonly type: "string";
         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)";
         };
     };
@@ -3085,6 +3661,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";
         };
@@ -3094,6 +3671,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 [{
@@ -3119,9 +3697,10 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "async.enabled": {
         readonly type: "boolean";
-        readonly default: false;
+        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";
         };
@@ -3132,12 +3711,13 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "async.pollWaitDuration": {
         readonly type: "enum";
-        readonly values: readonly ["5s", "10s", "30s", "1m", "5m"];
-        readonly default: "30s";
+        readonly values: readonly ["5s", "10s", "30s", "1m", "5m", "smart"];
+        readonly default: "smart";
         readonly ui: {
             readonly tab: "tools";
-            readonly label: "Poll Wait Duration";
-            readonly description: "How long the poll tool waits for background job updates before returning the current state";
+            readonly group: "Execution";
+            readonly label: "Max Poll Time";
+            readonly description: "How long the poll tool waits for background job updates before returning the current state. A fixed value waits that exact duration every time. `smart` adapts: it starts at 5s and lengthens with each back-to-back poll (up to 5m), then resets to 5s after about a minute without polling.";
             readonly options: readonly [{
                 readonly value: "5s";
                 readonly label: "5 seconds";
@@ -3147,23 +3727,43 @@ export declare const SETTINGS_SCHEMA: {
             }, {
                 readonly value: "30s";
                 readonly label: "30 seconds";
-                readonly description: "Default";
             }, {
                 readonly value: "1m";
                 readonly label: "1 minute";
             }, {
                 readonly value: "5m";
                 readonly label: "5 minutes";
+            }, {
+                readonly value: "smart";
+                readonly label: "Smart";
+                readonly description: "Default — adaptive 5s→5m, resets when you stop polling";
             }];
         };
     };
-    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": {
@@ -3176,6 +3776,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.";
         };
@@ -3185,6 +3786,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.";
         };
@@ -3194,6 +3796,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";
         };
@@ -3203,6 +3806,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";
         };
@@ -3212,6 +3816,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";
         };
@@ -3221,6 +3826,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";
         };
@@ -3230,8 +3836,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": {
@@ -3239,6 +3846,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";
         };
@@ -3248,6 +3856,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";
         };
@@ -3257,7 +3866,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";
         };
     };
@@ -3266,6 +3876,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";
         };
@@ -3276,6 +3887,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 [{
@@ -3327,6 +3939,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 [{
@@ -3346,6 +3959,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 [{
@@ -3360,44 +3974,47 @@ export declare const SETTINGS_SCHEMA: {
         };
     };
     readonly "task.eager": {
-        readonly type: "boolean";
-        readonly default: false;
-        readonly ui: {
-            readonly tab: "tasks";
-            readonly label: "Prefer Task Delegation";
-            readonly description: "Encourage the agent to delegate work to subagents unless changes are trivial";
-        };
-    };
-    readonly "task.simple": {
         readonly type: "enum";
-        readonly values: readonly ["default", "schema-free", "independent"];
-        readonly default: "schema-free";
+        readonly values: readonly ["default", "preferred", "always"];
+        readonly default: "default";
         readonly ui: {
             readonly tab: "tasks";
-            readonly label: "Task Input Mode";
-            readonly description: "How much shared structure the task tool accepts (default, schema-free, or independent)";
+            readonly group: "Subagents";
+            readonly label: "Prefer Task Delegation";
+            readonly description: "How strongly to push delegating work to subagents";
             readonly options: readonly [{
                 readonly value: "default";
                 readonly label: "Default";
-                readonly description: "Shared context and custom task schema are available";
+                readonly description: "Model decides when to delegate";
             }, {
-                readonly value: "schema-free";
-                readonly label: "Schema-free";
-                readonly description: "Shared context stays available, but custom task schema is disabled";
+                readonly value: "preferred";
+                readonly label: "Preferred";
+                readonly description: "Adds delegation guidance to the system prompt";
             }, {
-                readonly value: "independent";
-                readonly label: "Independent";
-                readonly description: "No shared context or custom task schema; each task must stand alone";
+                readonly value: "always";
+                readonly label: "Always";
+                readonly description: "Prompt guidance plus a first-turn delegation reminder";
             }];
         };
     };
+    readonly "task.batch": {
+        readonly type: "boolean";
+        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.";
+        };
+    };
     readonly "task.maxConcurrency": {
         readonly type: "number";
         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";
@@ -3430,6 +4047,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.";
         };
@@ -3439,6 +4057,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 [{
@@ -3464,6 +4083,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 [{
@@ -3485,6 +4105,40 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly "task.agentIdleTtlMs": {
+        readonly type: "number";
+        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.";
+        };
+    };
+    readonly "task.softRequestBudget": {
+        readonly type: "number";
+        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 [{
+                readonly value: "0";
+                readonly label: "Disabled";
+            }, {
+                readonly value: "40";
+                readonly label: "40 requests";
+            }, {
+                readonly value: "90";
+                readonly label: "90 requests";
+                readonly description: "Default";
+            }, {
+                readonly value: "150";
+                readonly label: "150 requests";
+            }];
+        };
+    };
     readonly "task.disabledAgents": {
         readonly type: "array";
         readonly default: string[];
@@ -3497,9 +4151,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";
@@ -3530,6 +4185,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";
         };
@@ -3543,6 +4199,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";
         };
@@ -3559,11 +4216,19 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "boolean";
         readonly default: true;
     };
-    readonly "skills.enablePrometheusUser": {
+    readonly "skills.enablePiUser": {
+        readonly type: "boolean";
+        readonly default: true;
+    };
+    readonly "skills.enablePiProject": {
+        readonly type: "boolean";
+        readonly default: true;
+    };
+    readonly "skills.enableAgentsUser": {
         readonly type: "boolean";
         readonly default: true;
     };
-    readonly "skills.enablePrometheusProject": {
+    readonly "skills.enableAgentsProject": {
         readonly type: "boolean";
         readonly default: true;
     };
@@ -3584,6 +4249,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/";
         };
@@ -3593,6 +4259,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/";
         };
@@ -3602,6 +4269,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/";
         };
@@ -3611,6 +4279,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/";
         };
@@ -3620,6 +4289,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";
         };
@@ -3630,8 +4300,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";
@@ -3643,7 +4314,7 @@ export declare const SETTINGS_SCHEMA: {
             }, {
                 readonly value: "perplexity";
                 readonly label: "Perplexity";
-                readonly description: "Requires PERPLEXITY_COOKIES or PERPLEXITY_API_KEY";
+                readonly description: "Uses auth when configured; explicit selection falls back to anonymous search";
             }, {
                 readonly value: "brave";
                 readonly label: "Brave";
@@ -3701,8 +4372,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";
@@ -3718,26 +4390,128 @@ export declare const SETTINGS_SCHEMA: {
             }, {
                 readonly value: "xai";
                 readonly label: "xAI Grok Imagine";
-                readonly description: "Requires xAI Grok OAuth or XAI_API_KEY";
+                readonly description: "Requires xAI Grok OAuth or XAI_APROMETHEUS_KEY";
             }, {
                 readonly value: "gemini";
                 readonly label: "Gemini";
-                readonly description: "Requires GEMINI_API_KEY";
+                readonly description: "Requires GEMINI_APROMETHEUS_KEY";
             }, {
                 readonly value: "openrouter";
                 readonly label: "OpenRouter";
-                readonly description: "Requires OPENROUTER_API_KEY";
+                readonly description: "Requires OPENROUTER_APROMETHEUS_KEY";
+            }];
+        };
+    };
+    readonly "providers.tts": {
+        readonly type: "enum";
+        readonly values: readonly ["auto", "local", "xai"];
+        readonly default: "auto";
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Services";
+            readonly label: "Text-to-Speech Provider";
+            readonly description: "Backend for the tts tool: local on-device neural TTS (Kokoro-82M) or xAI Grok Voice";
+            readonly options: readonly [{
+                readonly value: "auto";
+                readonly label: "Auto";
+                readonly description: "Prefer local on-device TTS; route .mp3 output to xAI when credentials exist";
+            }, {
+                readonly value: "local";
+                readonly label: "Local";
+                readonly description: "On-device neural TTS (Kokoro-82M); output is WAV/PCM16";
+            }, {
+                readonly value: "xai";
+                readonly label: "xAI Grok Voice";
+                readonly description: "Requires xAI Grok OAuth or XAI_APROMETHEUS_KEY; MP3 or WAV";
+            }];
+        };
+    };
+    readonly "tts.localModel": {
+        readonly type: "enum";
+        readonly values: readonly ["kokoro"];
+        readonly default: "kokoro";
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Services";
+            readonly label: "Local TTS Model";
+            readonly description: "On-device neural TTS model (Kokoro-82M) used by the local TTS backend";
+            readonly options: readonly [{
+                readonly value: "kokoro";
+                readonly label: "Kokoro-82M";
+                readonly description: "Kokoro-82M neural TTS — SoTA on-device quality, multi-voice, fully local";
             }];
         };
     };
+    readonly "tts.localVoice": {
+        readonly type: "enum";
+        readonly values: readonly string[];
+        readonly default: "af_heart";
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Services";
+            readonly label: "Local TTS Voice";
+            readonly description: "Kokoro voice used by the local TTS backend (American/British, female/male)";
+            readonly options: readonly {
+                value: string;
+                label: string;
+            }[];
+        };
+    };
+    readonly "speech.enabled": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Services";
+            readonly label: "Speech Vocalization";
+            readonly description: "Speak the assistant's output aloud through the speakers as it streams";
+        };
+    };
+    readonly "speech.mode": {
+        readonly type: "enum";
+        readonly values: readonly ["all", "assistant", "yield"];
+        readonly default: "assistant";
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Services";
+            readonly label: "Speech Vocalization Mode";
+            readonly description: "What to speak: all = assistant messages + thinking; assistant = messages only; yield = only the final message at turn end";
+            readonly options: readonly [{
+                readonly value: "all";
+                readonly label: "All (messages + thinking)";
+            }, {
+                readonly value: "assistant";
+                readonly label: "Assistant messages";
+            }, {
+                readonly value: "yield";
+                readonly label: "Final message only";
+            }];
+        };
+    };
+    readonly "speech.voice": {
+        readonly type: "enum";
+        readonly values: readonly string[];
+        readonly default: "af_heart";
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Services";
+            readonly label: "Speech Vocalization Voice";
+            readonly description: "Kokoro voice used when speaking the assistant's output aloud";
+            readonly options: readonly {
+                value: string;
+                label: string;
+            }[];
+        };
+    };
     readonly "providers.tinyModel": {
         readonly type: "enum";
         readonly values: readonly ["online", "lfm2-350m", "qwen3-0.6b", "gemma-270m", "qwen2.5-0.5b", "lfm2-700m"];
         readonly default: "online";
         readonly ui: {
             readonly tab: "providers";
+            readonly group: "Tiny Model";
             readonly label: "Tiny Model";
-            readonly description: "Session-title model: online prometheus/smol by default, or a local on-device model";
+            readonly description: "Session-title model: online pi/smol by default, or a local on-device model";
             readonly options: ({
                 value: "online";
                 label: string;
@@ -3755,6 +4529,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 PROMETHEUS_TINY_DEVICE env var overrides this.";
             readonly options: readonly [{
@@ -3822,6 +4597,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 PROMETHEUS_TINY_DTYPE env var overrides this.";
             readonly options: readonly [{
@@ -3889,9 +4665,10 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: "online";
         readonly ui: {
             readonly tab: "memory";
+            readonly group: "General";
             readonly label: "Memory Model";
-            readonly description: "Prometheus Memory LLM for fact extraction + consolidation: online (smol/remote) by default, or a local on-device model";
-            readonly condition: "prometheusMemoryActive";
+            readonly description: "Mnemopi LLM for fact extraction + consolidation: online (smol/remote) by default, or a local on-device model";
+            readonly condition: "mnemopiActive";
             readonly options: ({
                 value: "online";
                 label: string;
@@ -3909,6 +4686,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";
@@ -3929,6 +4707,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 [{
@@ -3948,6 +4727,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 [{
@@ -3971,6 +4751,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 [{
@@ -3996,13 +4777,84 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
-    readonly "providers.parallelFetch": {
-        readonly type: "boolean";
-        readonly default: true;
+    readonly "providers.fetch": {
+        readonly type: "enum";
+        readonly values: readonly ["auto", "native", "trafilatura", "lynx", "parallel", "jina"];
+        readonly default: "auto";
         readonly ui: {
             readonly tab: "providers";
-            readonly label: "Parallel Fetch";
-            readonly description: "Use Parallel extract API for URL fetching when credentials are available";
+            readonly group: "Services";
+            readonly label: "Fetch Provider";
+            readonly description: "Reader backend priority for the fetch/read URL tool";
+            readonly options: readonly [{
+                readonly value: "auto";
+                readonly label: "Auto";
+                readonly description: "Priority: native > trafilatura > lynx > parallel > jina";
+            }, {
+                readonly value: "native";
+                readonly label: "Native";
+                readonly description: "In-process HTML→Markdown converter (always available)";
+            }, {
+                readonly value: "trafilatura";
+                readonly label: "Trafilatura";
+                readonly description: "Auto-installs via uv/pip";
+            }, {
+                readonly value: "lynx";
+                readonly label: "Lynx";
+                readonly description: "Requires lynx system package";
+            }, {
+                readonly value: "parallel";
+                readonly label: "Parallel";
+                readonly description: "Requires PARALLEL_APROMETHEUS_KEY";
+            }, {
+                readonly value: "jina";
+                readonly label: "Jina";
+                readonly description: "Uses r.jina.ai reader (JINA_APROMETHEUS_KEY optional)";
+            }];
+        };
+    };
+    readonly "codexResets.autoRedeem": {
+        readonly type: "enum";
+        readonly values: readonly ["unset", "yes", "no"];
+        readonly default: "unset";
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Services";
+            readonly label: "Codex Auto-Redeem Saved Resets";
+            readonly description: "When a turn is blocked by the Codex weekly limit on the active account and no other account is available, run the conservative saved-reset check. unset asks before spending the first eligible reset, yes spends eligible resets without prompting, and no disables the check entirely. Requires retries enabled.";
+            readonly options: readonly [{
+                readonly value: "unset";
+                readonly label: "Unset";
+                readonly description: "Check eligibility, then ask before spending the first saved reset.";
+            }, {
+                readonly value: "yes";
+                readonly label: "Yes";
+                readonly description: "Spend eligible saved resets without prompting.";
+            }, {
+                readonly value: "no";
+                readonly label: "No";
+                readonly description: "Do not run the saved-reset auto-redeem check.";
+            }];
+        };
+    };
+    readonly "codexResets.minBlockedMinutes": {
+        readonly type: "number";
+        readonly default: 60;
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Services";
+            readonly label: "Codex Auto-Redeem Min Block";
+            readonly description: "Only auto-redeem when the natural weekly reset is at least this many minutes away (don't spend a ~30-day credit to save a short wait).";
+        };
+    };
+    readonly "codexResets.keepCredits": {
+        readonly type: "number";
+        readonly default: 0;
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Services";
+            readonly label: "Codex Auto-Redeem Reserve";
+            readonly description: "Never auto-spend below this many saved resets (0 = the last credit may be spent automatically).";
         };
     };
     readonly "provider.appendOnlyContext": {
@@ -4011,6 +4863,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 [{
@@ -4033,6 +4886,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";
         };
@@ -4042,8 +4896,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": {
@@ -4051,8 +4906,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": {
@@ -4060,8 +4916,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": {
@@ -4069,8 +4926,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": {
@@ -4122,17 +4980,19 @@ 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";
         };
     };
     readonly "dev.autoqaPush.endpoint": {
         readonly type: "string";
-        readonly default: "https://qa.prometheus.trivlab.com/v1/grievances";
+        readonly default: "https://qa.prometheus.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.prometheus.trivlab.com/v1/grievances)";
+            readonly description: "Full URL receiving Auto QA JSON reports (default https://qa.prometheus.sh/v1/grievances)";
         };
     };
     readonly "dev.autoqaPush.token": {
@@ -4182,6 +5042,9 @@ export type SettingPath = keyof Schema;
 /** Infer the value type for a setting path */
 export type SettingValue<P extends SettingPath> = Schema[P] extends {
     type: "boolean";
+    default: undefined;
+} ? boolean | undefined : Schema[P] extends {
+    type: "boolean";
 } ? boolean : Schema[P] extends {
     type: "string";
 } ? string | undefined : Schema[P] extends {
@@ -4214,9 +5077,11 @@ 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" | "off";
+    strategy: "context-full" | "handoff" | "shake" | "snapcompact" | "off";
     thresholdPercent: number;
     thresholdTokens: number;
     reserveTokens: number;
@@ -4228,6 +5093,8 @@ export interface CompactionSettings {
     idleEnabled: boolean;
     idleThresholdTokens: number;
     idleTimeoutSeconds: number;
+    supersedeReads: boolean;
+    dropUseless: boolean;
 }
 export interface ContextPromotionSettings {
     enabled: boolean;
@@ -4270,8 +5137,10 @@ export interface SkillsSettings {
     enableCodexUser?: boolean;
     enableClaudeUser?: boolean;
     enableClaudeProject?: boolean;
-    enablePrometheusUser?: boolean;
-    enablePrometheusProject?: boolean;
+    enablePiUser?: boolean;
+    enablePiProject?: boolean;
+    enableAgentsUser?: boolean;
+    enableAgentsProject?: boolean;
     customDirectories?: string[];
     ignoredSkills?: string[];
     includeSkills?: string[];
@@ -4306,6 +5175,7 @@ export interface StatusLineSettings {
     preset: StatusLinePreset;
     separator: StatusLineSeparatorStyle;
     showHookStatus: boolean;
+    transparent: boolean;
     leftSegments: StatusLineSegmentId[];
     rightSegments: StatusLineSegmentId[];
     segmentOptions: Record<string, unknown>;
@@ -4321,8 +5191,7 @@ export interface SttSettings {
     enabled: boolean;
     language: string | undefined;
     modelName: string;
-    whisperPath: string | undefined;
-    modelPath: string | undefined;
+    streaming: boolean;
 }
 export interface BashInterceptorRule {
     pattern: string;
@@ -4337,6 +5206,14 @@ export interface ShellMinimizerSettings {
     only: string[];
     except: string[];
     maxCaptureBytes: number;
+    sourceOutlineLevel: "default" | "aggressive";
+    legacyFilters: boolean | undefined;
+}
+export type CodexAutoRedeemMode = "unset" | "yes" | "no";
+export interface CodexResetsSettings {
+    autoRedeem: CodexAutoRedeemMode;
+    minBlockedMinutes: number;
+    keepCredits: number;
 }
 /** Map group prefix -> typed settings interface */
 export interface GroupTypeMap {
@@ -4356,6 +5233,7 @@ export interface GroupTypeMap {
     modelTags: ModelTagsSettings;
     cycleOrder: string[];
     shellMinimizer: ShellMinimizerSettings;
+    codexResets: CodexResetsSettings;
 }
 export type GroupPrefix = keyof GroupTypeMap;
 export {};