@prometheus-ai/agent 0.5.4 → 0.5.8

package/src/config/settings-schema.ts

@@ -1,5 +1,8 @@
 import { THINKING_EFFORTS } from "@prometheus-ai/ai";
-import { TASK_SIMPLE_MODES } from "../task/simple-mode";
+import { SHAPE_VARIANT_NAMES } from "@prometheus-ai/snapcompact";
+import { DEFAULT_SHARE_URL } from "@prometheus-ai/wire";
+import { DEFAULT_RELAY_URL } from "../collab/protocol";
+import { DEFAULT_STT_MODEL_KEY, STT_MODEL_OPTIONS, STT_MODEL_VALUES } from "../stt/models";
 import { AUTO_THINKING, getConfiguredThinkingLevelMetadata, getThinkingLevelMetadata } from "../thinking";
 import {
 	TINY_MODEL_DEVICE_DEFAULT,
@@ -22,15 +25,27 @@ import {
 	TINY_TITLE_MODEL_OPTIONS,
 	TINY_TITLE_MODEL_VALUES,
 } from "../tiny/models";
+import {
+	DEFAULT_TTS_LOCAL_MODEL_KEY,
+	DEFAULT_TTS_VOICE,
+	TTS_LOCAL_MODEL_OPTIONS,
+	TTS_LOCAL_MODEL_VALUES,
+	TTS_LOCAL_VOICE_OPTIONS,
+	TTS_LOCAL_VOICE_VALUES,
+} from "../tts/models";
 import { EDIT_MODES } from "../utils/edit-mode";
 import { SEARCH_PROVIDER_OPTIONS, SEARCH_PROVIDER_PREFERENCES } from "../web/search/types";
 
 /** 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
@@ -47,7 +62,8 @@ export type SettingTab =
 	| "interaction"
 	| "context"
 	| "memory"
-	| "editing"
+	| "files"
+	| "shell"
 	| "tools"
 	| "tasks"
 	| "providers"
@@ -63,7 +79,8 @@ export const SETTING_TABS: SettingTab[] = [
 	"interaction",
 	"context",
 	"memory",
-	"editing",
+	"files",
+	"shell",
 	"tools",
 	"tasks",
 	"providers",
@@ -77,16 +94,54 @@ export const TAB_METADATA: Record<SettingTab, { label: string; icon: `tab.${stri
 	interaction: { label: "Interaction", icon: "tab.interaction" },
 	context: { label: "Context", icon: "tab.context" },
 	memory: { label: "Memory", icon: "tab.memory" },
-	editing: { label: "Editing", icon: "tab.editing" },
+	files: { label: "Files", icon: "tab.files" },
+	shell: { label: "Shell", icon: "tab.shell" },
 	tools: { label: "Tools", icon: "tab.tools" },
 	tasks: { label: "Tasks", icon: "tab.tasks" },
 	providers: { label: "Providers", icon: "tab.providers" },
 	channels: { label: "Channels", icon: "tab.channels" },
 };
 
+/**
+ * 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 const TAB_GROUPS: Record<SettingTab, readonly string[]> = {
+	appearance: ["Theme", "Status Line", "Display", "Images"],
+	model: ["Thinking", "Sampling", "Prompt", "Retry & Fallback"],
+	interaction: [
+		"Input",
+		"Approvals",
+		"Notifications",
+		"Speech",
+		"Collab",
+		"Magic Keywords",
+		"Startup & Updates",
+		"Power (macOS)",
+	],
+	context: ["General", "Compaction", "Rules (TTSR)", "Experimental"],
+	memory: ["General", "Auto-Learn", "Mnemopi", "Hindsight", "Self Improvement"],
+	files: ["Editing", "Reading", "Read Summaries", "LSP"],
+	shell: ["Bash", "Eval & Python"],
+	tools: [
+		"Available Tools",
+		"Todos",
+		"Search & Browser",
+		"GitHub",
+		"Output Limits",
+		"Execution",
+		"Discovery & MCP",
+		"Developer",
+	],
+	tasks: ["Modes", "Subagents", "Isolation", "Commands & Skills"],
+	providers: ["Services", "Tiny Model", "Protocol", "Privacy"],
+	channels: ["Telegram"],
+};
+
 /** Status line segment identifiers */
 export type StatusLineSegmentId =
-	| "prometheus"
+	| "pi"
 	| "model"
 	| "mode"
 	| "path"
@@ -108,7 +163,8 @@ export type StatusLineSegmentId =
 	| "cache_write"
 	| "cache_hit"
 	| "session_name"
-	| "usage";
+	| "usage"
+	| "collab";
 
 /** Submenu choice metadata. */
 export type SubmenuOption<V extends string = string> = {
@@ -119,6 +175,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 */
@@ -154,7 +212,7 @@ export type AnyUiMetadata = UiBase & {
 
 interface BooleanDef {
 	type: "boolean";
-	default: boolean;
+	default: boolean | undefined;
 	ui?: UiBoolean;
 }
 
@@ -204,6 +262,8 @@ type SettingDef =
 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 {
@@ -250,7 +310,11 @@ export const DEFAULT_BASH_INTERCEPTOR_RULES: BashInterceptorRule[] = [
 		message: "Use the `edit` tool instead of awk -i inplace. It provides diff preview and fuzzy matching.",
 	},
 	{
-		pattern: "^\\s*(echo|printf|cat\\s*<<)\\s+.*[^|]>\\s*\\S",
+		// `>` must sit outside quoted regions (so `echo "a -> b"` passes) and be
+		// followed by a plausible filename — including `$VAR` targets; `>|`
+		// (clobber) counts as a redirect; `>&2`/`2>&1` style fd duplication is
+		// not matched.
+		pattern: "^\\s*(echo|printf|cat\\s*<<)\\s+(?:[^\"'>]|\"[^\"]*\"|'[^']*')*(?<!\\|)>{1,2}\\|?\\s*[$\\w./~\"'-]",
 		tool: "write",
 		message: "Use the `write` tool instead of echo/cat redirection. It handles encoding and provides confirmation.",
 	},
@@ -260,7 +324,6 @@ export const SETTINGS_SCHEMA = {
 	// ────────────────────────────────────────────────────────────────────────
 	// General settings (no UI)
 	// ────────────────────────────────────────────────────────────────────────
-	lastChangelogVersion: { type: "string", default: undefined },
 	setupVersion: { type: "number", default: 0 },
 
 	// Auth broker — credentials proxied through a remote `prometheus auth-broker serve`
@@ -277,6 +340,7 @@ export const SETTINGS_SCHEMA = {
 		default: false,
 		ui: {
 			tab: "channels",
+			group: "Telegram",
 			label: "Telegram Gateway",
 			description: "Use the configured Telegram Bot API gateway when serving Prometheus externally",
 		},
@@ -287,6 +351,7 @@ export const SETTINGS_SCHEMA = {
 		default: "webhook",
 		ui: {
 			tab: "channels",
+			group: "Telegram",
 			label: "Telegram Connection Mode",
 			description: "Use webhook ingress or Bot API long polling for Telegram updates",
 			options: [
@@ -304,6 +369,7 @@ export const SETTINGS_SCHEMA = {
 		default: undefined,
 		ui: {
 			tab: "channels",
+			group: "Telegram",
 			label: "Telegram Bot Username",
 			description: "Telegram bot username without @; setup can fill this from getMe",
 		},
@@ -313,6 +379,7 @@ export const SETTINGS_SCHEMA = {
 		default: undefined,
 		ui: {
 			tab: "channels",
+			group: "Telegram",
 			label: "Telegram Public URL",
 			description: "HTTPS public base URL that Telegram should call through the tunnel",
 		},
@@ -322,6 +389,7 @@ export const SETTINGS_SCHEMA = {
 		default: "/telegram/webhook",
 		ui: {
 			tab: "channels",
+			group: "Telegram",
 			label: "Telegram Webhook Path",
 			description: "HTTP path that receives Telegram webhook updates",
 		},
@@ -331,6 +399,7 @@ export const SETTINGS_SCHEMA = {
 		default: undefined,
 		ui: {
 			tab: "channels",
+			group: "Telegram",
 			label: "Telegram Allowed Users",
 			description: "Comma-separated Telegram user IDs allowed to use the gateway",
 		},
@@ -340,6 +409,7 @@ export const SETTINGS_SCHEMA = {
 		default: undefined,
 		ui: {
 			tab: "channels",
+			group: "Telegram",
 			label: "Telegram Allowed Chats",
 			description: "Comma-separated Telegram chat IDs allowed to use the gateway",
 		},
@@ -350,6 +420,7 @@ export const SETTINGS_SCHEMA = {
 		default: "shared",
 		ui: {
 			tab: "channels",
+			group: "Telegram",
 			label: "Telegram Group Scope",
 			description: "Session sharing for non-threaded group chats",
 			options: [
@@ -364,6 +435,7 @@ export const SETTINGS_SCHEMA = {
 		default: "shared",
 		ui: {
 			tab: "channels",
+			group: "Telegram",
 			label: "Telegram Thread Scope",
 			description: "Session sharing for Telegram topics and direct-message topics",
 			options: [
@@ -378,6 +450,7 @@ export const SETTINGS_SCHEMA = {
 		default: "none",
 		ui: {
 			tab: "channels",
+			group: "Telegram",
 			label: "Telegram Parse Mode",
 			description: "Telegram parse_mode for bot replies",
 			options: [
@@ -393,6 +466,7 @@ export const SETTINGS_SCHEMA = {
 		default: false,
 		ui: {
 			tab: "channels",
+			group: "Telegram",
 			label: "Telegram Silent Replies",
 			description: "Send Telegram replies without notification sound",
 		},
@@ -402,6 +476,7 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "channels",
+			group: "Telegram",
 			label: "Telegram HD Previews",
 			description: "Ask Telegram to use larger media previews where the Bot API supports it",
 		},
@@ -411,6 +486,7 @@ export const SETTINGS_SCHEMA = {
 		default: false,
 		ui: {
 			tab: "channels",
+			group: "Telegram",
 			label: "Telegram Bot Messages",
 			description: "Allow Telegram messages sent by bot accounts",
 		},
@@ -420,6 +496,7 @@ export const SETTINGS_SCHEMA = {
 		default: false,
 		ui: {
 			tab: "channels",
+			group: "Telegram",
 			label: "Telegram Raw Payloads",
 			description: "Attach raw Telegram update payloads to gateway events for debugging",
 		},
@@ -429,6 +506,7 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "channels",
+			group: "Telegram",
 			label: "Telegram Expressions",
 			description: "Allow Prometheus to attach matching Telegram expression intents to replies",
 		},
@@ -438,6 +516,7 @@ export const SETTINGS_SCHEMA = {
 		default: 2,
 		ui: {
 			tab: "channels",
+			group: "Telegram",
 			label: "Telegram Expression Match",
 			description: "Minimum local catalog match score before attaching a Telegram expression",
 			options: [
@@ -452,6 +531,7 @@ export const SETTINGS_SCHEMA = {
 		default: EMPTY_UNKNOWN_RECORD,
 		ui: {
 			tab: "channels",
+			group: "Telegram",
 			label: "Telegram Expression Catalog",
 			description: "Searchable Telegram expression intents with sticker/GIF variants",
 		},
@@ -461,6 +541,7 @@ export const SETTINGS_SCHEMA = {
 		default: undefined,
 		ui: {
 			tab: "channels",
+			group: "Telegram",
 			label: "Telegram Expression File",
 			description: "Optional JSON catalog path for Telegram expression intents",
 		},
@@ -471,6 +552,7 @@ export const SETTINGS_SCHEMA = {
 		default: false,
 		ui: {
 			tab: "interaction",
+			group: "Startup & Updates",
 			label: "Auto Resume",
 			description: "Automatically resume the most recent session in the current directory",
 		},
@@ -482,8 +564,9 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "interaction",
-			label: "Prevent Idle Sleep (macOS)",
-			description: "caffeinate -i: keep the system awake while a session is open",
+			group: "Power (macOS)",
+			label: "Prevent Idle Sleep",
+			description: "Keep the system awake while a session is open (caffeinate -i)",
 		},
 	},
 	"power.preventSystemSleep": {
@@ -491,8 +574,9 @@ export const SETTINGS_SCHEMA = {
 		default: false,
 		ui: {
 			tab: "interaction",
-			label: "Prevent System Sleep on AC (macOS)",
-			description: "caffeinate -s: block all system sleep while on AC power",
+			group: "Power (macOS)",
+			label: "Prevent System Sleep on AC",
+			description: "Block all system sleep while on AC power (caffeinate -s)",
 		},
 	},
 	"power.declareUserActive": {
@@ -500,8 +584,9 @@ export const SETTINGS_SCHEMA = {
 		default: false,
 		ui: {
 			tab: "interaction",
-			label: "Declare User Active (macOS)",
-			description: "caffeinate -u: keep the display lit and treat the user as active",
+			group: "Power (macOS)",
+			label: "Declare User Active",
+			description: "Keep the display lit and treat the user as active (caffeinate -u)",
 		},
 	},
 	"power.preventDisplaySleep": {
@@ -509,30 +594,15 @@ export const SETTINGS_SCHEMA = {
 		default: false,
 		ui: {
 			tab: "interaction",
-			label: "Prevent Display Sleep (macOS)",
-			description: "caffeinate -d: keep the display from idle-sleeping while a session is open",
+			group: "Power (macOS)",
+			label: "Prevent Display Sleep",
+			description: "Keep the display from idle-sleeping while a session is open (caffeinate -d)",
 		},
 	},
 	shellPath: { type: "string", default: undefined },
 
 	extensions: { type: "array", default: EMPTY_STRING_ARRAY },
 
-	"marketplace.autoUpdate": {
-		type: "enum",
-		values: ["off", "notify", "auto"] as const,
-		default: "notify",
-		ui: {
-			tab: "tools",
-			label: "Marketplace Auto-Update",
-			description: "Check for plugin updates on startup (off/notify/auto)",
-			options: [
-				{ value: "off", label: "Off", description: "Don't check for plugin updates" },
-				{ value: "notify", label: "Notify", description: "Check on startup and notify when updates are available" },
-				{ value: "auto", label: "Auto", description: "Check on startup and auto-install updates" },
-			],
-		},
-	},
-
 	enabledModels: { type: "array", default: EMPTY_STRING_ARRAY },
 
 	disabledProviders: { type: "array", default: EMPTY_STRING_ARRAY },
@@ -557,8 +627,9 @@ export const SETTINGS_SCHEMA = {
 		default: "titanium",
 		ui: {
 			tab: "appearance",
+			group: "Theme",
 			label: "Dark Theme",
-			description: "Theme used when terminal has dark background",
+			description: "Theme used when the terminal has a dark background",
 			options: "runtime",
 		},
 	},
@@ -568,8 +639,9 @@ export const SETTINGS_SCHEMA = {
 		default: "light",
 		ui: {
 			tab: "appearance",
+			group: "Theme",
 			label: "Light Theme",
-			description: "Theme used when terminal has light background",
+			description: "Theme used when the terminal has a light background",
 			options: "runtime",
 		},
 	},
@@ -580,8 +652,9 @@ export const SETTINGS_SCHEMA = {
 		default: "unicode",
 		ui: {
 			tab: "appearance",
+			group: "Theme",
 			label: "Symbol Preset",
-			description: "Icon/symbol style",
+			description: "Glyph set for icons and symbols (Unicode, Nerd Font, or ASCII)",
 			options: [
 				{ value: "unicode", label: "Unicode", description: "Standard symbols (default)" },
 				{ value: "nerd", label: "Nerd Font", description: "Requires Nerd Font" },
@@ -595,6 +668,7 @@ export const SETTINGS_SCHEMA = {
 		default: false,
 		ui: {
 			tab: "appearance",
+			group: "Theme",
 			label: "Color-Blind Mode",
 			description: "Use blue instead of green for diff additions",
 		},
@@ -607,6 +681,7 @@ export const SETTINGS_SCHEMA = {
 		default: "default",
 		ui: {
 			tab: "appearance",
+			group: "Status Line",
 			label: "Status Line Preset",
 			description: "Pre-built status line configurations",
 			options: [
@@ -627,6 +702,7 @@ export const SETTINGS_SCHEMA = {
 		default: "powerline-thin",
 		ui: {
 			tab: "appearance",
+			group: "Status Line",
 			label: "Status Line Separator",
 			description: "Style of separators between segments",
 			options: [
@@ -646,16 +722,30 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "appearance",
+			group: "Status Line",
 			label: "Session Accent",
 			description: "Use the session name color for the editor border and status line gap",
 		},
 	},
+
+	"statusLine.transparent": {
+		type: "boolean",
+		default: false,
+		ui: {
+			tab: "appearance",
+			group: "Status Line",
+			label: "Transparent Status Line",
+			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.",
+		},
+	},
 	"tools.artifactSpillThreshold": {
 		type: "number",
 		default: 50,
 		ui: {
 			tab: "tools",
-			label: "Artifact spill threshold (KB)",
+			group: "Output Limits",
+			label: "Artifact Spill Threshold (KB)",
 			description: "Tool output above this size is saved as an artifact; tail is kept inline",
 			options: [
 				{ value: "1", label: "1 KB", description: "~250 tokens" },
@@ -678,7 +768,8 @@ export const SETTINGS_SCHEMA = {
 		default: 20,
 		ui: {
 			tab: "tools",
-			label: "Artifact tail size (KB)",
+			group: "Output Limits",
+			label: "Artifact Tail Size (KB)",
 			description: "Amount of tail content kept inline when output spills to artifact",
 			options: [
 				{ value: "1", label: "1 KB", description: "~250 tokens" },
@@ -697,7 +788,8 @@ export const SETTINGS_SCHEMA = {
 		default: 20,
 		ui: {
 			tab: "tools",
-			label: "Artifact head size (KB)",
+			group: "Output Limits",
+			label: "Artifact Head Size (KB)",
 			description:
 				"Amount of head content kept inline alongside the tail when output spills to artifact (middle elision). 0 disables — keep tail only.",
 			options: [
@@ -718,7 +810,8 @@ export const SETTINGS_SCHEMA = {
 		default: 768,
 		ui: {
 			tab: "tools",
-			label: "Output column cap",
+			group: "Output Limits",
+			label: "Output Column Cap",
 			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.",
 			options: [
@@ -737,7 +830,8 @@ export const SETTINGS_SCHEMA = {
 		default: 500,
 		ui: {
 			tab: "tools",
-			label: "Artifact tail lines",
+			group: "Output Limits",
+			label: "Artifact Tail Lines",
 			description: "Maximum lines of tail content kept inline when output spills to artifact",
 			options: [
 				{ value: "50", label: "50 lines", description: "~250 tokens" },
@@ -756,8 +850,9 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "appearance",
+			group: "Status Line",
 			label: "Show Hook Status",
-			description: "Display hook status messages below status line",
+			description: "Display hook status messages below the status line",
 		},
 	},
 
@@ -773,8 +868,9 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "appearance",
+			group: "Images",
 			label: "Show Inline Images",
-			description: "Render images inline in terminal",
+			description: "Render images inline in the terminal",
 			condition: "hasImageProtocol",
 		},
 	},
@@ -784,6 +880,7 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "appearance",
+			group: "Images",
 			label: "Auto-Resize Images",
 			description: "Resize large images to 2000x2000 max for better model compatibility",
 		},
@@ -792,7 +889,12 @@ export const SETTINGS_SCHEMA = {
 	"images.blockImages": {
 		type: "boolean",
 		default: false,
-		ui: { tab: "appearance", label: "Block Images", description: "Prevent images from being sent to LLM providers" },
+		ui: {
+			tab: "appearance",
+			group: "Images",
+			label: "Block Images",
+			description: "Prevent images from being sent to LLM providers",
+		},
 	},
 
 	"tui.maxInlineImageColumns": {
@@ -821,6 +923,7 @@ export const SETTINGS_SCHEMA = {
 		default: false,
 		ui: {
 			tab: "appearance",
+			group: "Display",
 			label: "Large Headings (Kitty)",
 			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.",
@@ -833,6 +936,7 @@ export const SETTINGS_SCHEMA = {
 		default: "auto",
 		ui: {
 			tab: "appearance",
+			group: "Display",
 			label: "Terminal Hyperlinks",
 			description:
 				"Wrap paths and URLs in OSC 8 hyperlinks for terminal-native click-to-open (auto: detect support; off: never; always: unconditional)",
@@ -850,6 +954,7 @@ export const SETTINGS_SCHEMA = {
 		default: "classic",
 		ui: {
 			tab: "appearance",
+			group: "Display",
 			label: "Shimmer",
 			description: "Animation style for working/loading messages",
 			options: [
@@ -860,11 +965,23 @@ export const SETTINGS_SCHEMA = {
 		},
 	},
 
+	"display.smoothStreaming": {
+		type: "boolean",
+		default: true,
+		ui: {
+			tab: "appearance",
+			group: "Display",
+			label: "Smooth Streaming",
+			description: "Reveal assistant text and streamed tool input smoothly while chunks arrive",
+		},
+	},
+
 	"display.showTokenUsage": {
 		type: "boolean",
 		default: false,
 		ui: {
 			tab: "appearance",
+			group: "Display",
 			label: "Show Token Usage",
 			description: "Show per-turn token usage on assistant messages",
 		},
@@ -873,16 +990,11 @@ export const SETTINGS_SCHEMA = {
 	showHardwareCursor: {
 		type: "boolean",
 		default: true, // will be computed based on platform if undefined
-		ui: { tab: "appearance", label: "Show Hardware Cursor", description: "Show terminal cursor for IME support" },
-	},
-
-	clearOnShrink: {
-		type: "boolean",
-		default: false,
 		ui: {
 			tab: "appearance",
-			label: "Clear on Shrink",
-			description: "Clear empty rows when content shrinks (may cause flicker)",
+			group: "Display",
+			label: "Show Hardware Cursor",
+			description: "Show terminal cursor for IME support",
 		},
 	},
 
@@ -897,6 +1009,7 @@ export const SETTINGS_SCHEMA = {
 		default: "high",
 		ui: {
 			tab: "model",
+			group: "Thinking",
 			label: "Thinking Level",
 			description: "Reasoning depth for thinking-capable models",
 			options: [
@@ -909,7 +1022,12 @@ export const SETTINGS_SCHEMA = {
 	hideThinkingBlock: {
 		type: "boolean",
 		default: false,
-		ui: { tab: "model", label: "Hide Thinking Blocks", description: "Hide thinking blocks in assistant responses" },
+		ui: {
+			tab: "model",
+			group: "Thinking",
+			label: "Hide Thinking Blocks",
+			description: "Hide thinking blocks in assistant responses",
+		},
 	},
 
 	repeatToolDescriptions: {
@@ -917,6 +1035,7 @@ export const SETTINGS_SCHEMA = {
 		default: false,
 		ui: {
 			tab: "model",
+			group: "Prompt",
 			label: "Repeat Tool Descriptions",
 			description: "Render full tool descriptions in the system prompt instead of a tool name list",
 		},
@@ -927,17 +1046,49 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "model",
-			label: "Include Model In Prompt",
+			group: "Prompt",
+			label: "Include Model in Prompt",
 			description: "Surface the active model identifier in the system prompt so the agent knows which model it is",
 		},
 	},
 
+	personality: {
+		type: "enum",
+		values: ["default", "friendly", "pragmatic", "none"] as const,
+		default: "default",
+		ui: {
+			tab: "model",
+			group: "Prompt",
+			label: "Personality",
+			description: "Communication style rendered into the system prompt's personality block",
+			options: [
+				{
+					value: "default",
+					label: "Default",
+					description: "Terse, evidence-first engineer; dense, action-oriented replies",
+				},
+				{
+					value: "friendly",
+					label: "Friendly",
+					description: "Warm, encouraging collaborator focused on momentum and morale",
+				},
+				{
+					value: "pragmatic",
+					label: "Pragmatic",
+					description: "Direct, efficient engineer focused on clarity and rigor",
+				},
+				{ value: "none", label: "None", description: "Omit the personality block entirely" },
+			],
+		},
+	},
+
 	// Sampling
 	temperature: {
 		type: "number",
 		default: -1,
 		ui: {
 			tab: "model",
+			group: "Sampling",
 			label: "Temperature",
 			description: "Sampling temperature (0 = deterministic, 1 = creative, -1 = provider default)",
 			options: [
@@ -956,6 +1107,7 @@ export const SETTINGS_SCHEMA = {
 		default: -1,
 		ui: {
 			tab: "model",
+			group: "Sampling",
 			label: "Top P",
 			description: "Nucleus sampling cutoff (0-1, -1 = provider default)",
 			options: [
@@ -974,6 +1126,7 @@ export const SETTINGS_SCHEMA = {
 		default: -1,
 		ui: {
 			tab: "model",
+			group: "Sampling",
 			label: "Top K",
 			description: "Sample from top-K tokens (-1 = provider default)",
 			options: [
@@ -991,6 +1144,7 @@ export const SETTINGS_SCHEMA = {
 		default: -1,
 		ui: {
 			tab: "model",
+			group: "Sampling",
 			label: "Min P",
 			description: "Minimum probability threshold (0-1, -1 = provider default)",
 			options: [
@@ -1007,6 +1161,7 @@ export const SETTINGS_SCHEMA = {
 		default: -1,
 		ui: {
 			tab: "model",
+			group: "Sampling",
 			label: "Presence Penalty",
 			description: "Penalty for introducing already-present tokens (-1 = provider default)",
 			options: [
@@ -1024,6 +1179,7 @@ export const SETTINGS_SCHEMA = {
 		default: -1,
 		ui: {
 			tab: "model",
+			group: "Sampling",
 			label: "Repetition Penalty",
 			description: "Penalty for repeated tokens (-1 = provider default)",
 			options: [
@@ -1043,6 +1199,7 @@ export const SETTINGS_SCHEMA = {
 		default: "none",
 		ui: {
 			tab: "model",
+			group: "Sampling",
 			label: "Service Tier",
 			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.',
@@ -1071,14 +1228,41 @@ export const SETTINGS_SCHEMA = {
 		},
 	},
 
+	fastModeScope: {
+		type: "enum",
+		values: ["both", "openai", "claude"] as const,
+		default: "both",
+		ui: {
+			tab: "model",
+			group: "Sampling",
+			label: "Fast Mode Scope",
+			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).',
+			options: [
+				{ value: "both", label: "Both", description: "Priority on every supported provider" },
+				{
+					value: "openai",
+					label: "OpenAI only",
+					description: "Priority on OpenAI/OpenAI-Codex requests; ignored elsewhere",
+				},
+				{
+					value: "claude",
+					label: "Claude only",
+					description: "Anthropic fast mode on direct Claude requests; ignored elsewhere",
+				},
+			],
+		},
+	},
+
 	// Retries
 	"retry.enabled": { type: "boolean", default: true },
 
 	"retry.maxRetries": {
 		type: "number",
-		default: 3,
+		default: 10,
 		ui: {
 			tab: "model",
+			group: "Retry & Fallback",
 			label: "Retry Attempts",
 			description: "Maximum retry attempts on API errors",
 			options: [
@@ -1091,12 +1275,13 @@ export const SETTINGS_SCHEMA = {
 		},
 	},
 
-	"retry.baseDelayMs": { type: "number", default: 2000 },
+	"retry.baseDelayMs": { type: "number", default: 500 },
 	"retry.maxDelayMs": {
 		type: "number",
 		default: 5 * 60 * 1000,
 		ui: {
 			tab: "model",
+			group: "Retry & Fallback",
 			label: "Max Retry Delay",
 			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).",
@@ -1107,6 +1292,7 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "model",
+			group: "Retry & Fallback",
 			label: "Retry Model Fallback",
 			description: "Allow retry recovery to switch to configured fallback models",
 		},
@@ -1118,6 +1304,7 @@ export const SETTINGS_SCHEMA = {
 		default: "cooldown-expiry",
 		ui: {
 			tab: "model",
+			group: "Retry & Fallback",
 			label: "Fallback Revert Policy",
 			description: "When to return to the primary model after a fallback",
 			options: [
@@ -1142,6 +1329,7 @@ export const SETTINGS_SCHEMA = {
 		default: "one-at-a-time",
 		ui: {
 			tab: "interaction",
+			group: "Input",
 			label: "Steering Mode",
 			description: "How to process queued messages while agent is working",
 		},
@@ -1153,6 +1341,7 @@ export const SETTINGS_SCHEMA = {
 		default: "one-at-a-time",
 		ui: {
 			tab: "interaction",
+			group: "Input",
 			label: "Follow-Up Mode",
 			description: "How to drain follow-up messages after a turn completes",
 		},
@@ -1164,6 +1353,7 @@ export const SETTINGS_SCHEMA = {
 		default: "immediate",
 		ui: {
 			tab: "interaction",
+			group: "Input",
 			label: "Interrupt Mode",
 			description: "When steering messages interrupt tool execution",
 		},
@@ -1175,6 +1365,7 @@ export const SETTINGS_SCHEMA = {
 		default: "prompt",
 		ui: {
 			tab: "interaction",
+			group: "Input",
 			label: "Loop Mode",
 			description: "What happens between /loop iterations before re-submitting the prompt",
 			options: [
@@ -1200,6 +1391,7 @@ export const SETTINGS_SCHEMA = {
 		default: "tree",
 		ui: {
 			tab: "interaction",
+			group: "Input",
 			label: "Double-Escape Action",
 			description: "Action when pressing Escape twice with empty editor",
 		},
@@ -1211,6 +1403,7 @@ export const SETTINGS_SCHEMA = {
 		default: "default",
 		ui: {
 			tab: "interaction",
+			group: "Input",
 			label: "Session Tree Filter",
 			description: "Default filter mode when opening the session tree",
 		},
@@ -1221,6 +1414,7 @@ export const SETTINGS_SCHEMA = {
 		default: 5,
 		ui: {
 			tab: "interaction",
+			group: "Input",
 			label: "Autocomplete Items",
 			description: "Max visible items in autocomplete dropdown (3-20)",
 			options: [
@@ -1239,16 +1433,37 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "interaction",
+			group: "Input",
 			label: "Emoji Autocomplete",
 			description: "Suggest emojis from `:name:` shortcodes and expand text emoticons like `:D` or `:-)`",
 		},
 	},
 
+	"paste.largeMenuThreshold": {
+		type: "number",
+		default: 100,
+		ui: {
+			tab: "interaction",
+			group: "Input",
+			label: "Large Paste Menu",
+			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).",
+			options: [
+				{ value: "0", label: "Off" },
+				{ value: "100", label: "100 lines" },
+				{ value: "250", label: "250 lines" },
+				{ value: "500", label: "500 lines" },
+				{ value: "1000", label: "1000 lines" },
+			],
+		},
+	},
+
 	"startup.quiet": {
 		type: "boolean",
 		default: false,
 		ui: {
 			tab: "interaction",
+			group: "Startup & Updates",
 			label: "Quiet Startup",
 			description: "Skip welcome screen and startup status messages",
 		},
@@ -1259,6 +1474,7 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "interaction",
+			group: "Startup & Updates",
 			label: "Setup Wizard",
 			description: "Show newly added onboarding steps once per setup version",
 		},
@@ -1269,15 +1485,82 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "interaction",
+			group: "Startup & Updates",
 			label: "Check for Updates",
-			description: "If false, skip update check",
+			description: "Check for prometheus updates on startup",
+		},
+	},
+
+	"marketplace.autoUpdate": {
+		type: "enum",
+		values: ["off", "notify", "auto"] as const,
+		default: "notify",
+		ui: {
+			tab: "interaction",
+			group: "Startup & Updates",
+			label: "Marketplace Auto-Update",
+			description: "Check for plugin updates on startup",
+			options: [
+				{ value: "off", label: "Off", description: "Don't check for plugin updates" },
+				{ value: "notify", label: "Notify", description: "Check on startup and notify when updates are available" },
+				{ value: "auto", label: "Auto", description: "Check on startup and auto-install updates" },
+			],
 		},
 	},
 
 	collapseChangelog: {
 		type: "boolean",
 		default: false,
-		ui: { tab: "interaction", label: "Collapse Changelog", description: "Show condensed changelog after updates" },
+		ui: {
+			tab: "interaction",
+			group: "Startup & Updates",
+			label: "Collapse Changelog",
+			description: "Show condensed changelog after updates",
+		},
+	},
+
+	"magicKeywords.enabled": {
+		type: "boolean",
+		default: true,
+		ui: {
+			tab: "interaction",
+			group: "Magic Keywords",
+			label: "Magic Keywords",
+			description: "Enable hidden notices for standalone ultrathink, orchestrate, and workflowz keywords",
+		},
+	},
+
+	"magicKeywords.ultrathink": {
+		type: "boolean",
+		default: true,
+		ui: {
+			tab: "interaction",
+			group: "Magic Keywords",
+			label: "Ultrathink Keyword",
+			description: "Let standalone ultrathink request maximum automatic thinking and append its hidden notice",
+		},
+	},
+
+	"magicKeywords.orchestrate": {
+		type: "boolean",
+		default: true,
+		ui: {
+			tab: "interaction",
+			group: "Magic Keywords",
+			label: "Orchestrate Keyword",
+			description: "Let standalone orchestrate append its hidden multi-agent orchestration notice",
+		},
+	},
+
+	"magicKeywords.workflow": {
+		type: "boolean",
+		default: true,
+		ui: {
+			tab: "interaction",
+			group: "Magic Keywords",
+			label: "Workflow Keyword",
+			description: "Let standalone workflowz append its hidden eval workflow notice",
+		},
 	},
 
 	// Notifications
@@ -1285,7 +1568,12 @@ export const SETTINGS_SCHEMA = {
 		type: "enum",
 		values: ["on", "off"] as const,
 		default: "on",
-		ui: { tab: "interaction", label: "Completion Notification", description: "Notify when the agent completes" },
+		ui: {
+			tab: "interaction",
+			group: "Notifications",
+			label: "Completion Notification",
+			description: "Notify when the agent finishes a turn",
+		},
 	},
 
 	"ask.timeout": {
@@ -1293,8 +1581,9 @@ export const SETTINGS_SCHEMA = {
 		default: 0,
 		ui: {
 			tab: "interaction",
+			group: "Notifications",
 			label: "Ask Timeout",
-			description: "Auto-select recommended option after timeout (0 to disable)",
+			description: "Auto-select the recommended ask option after this many seconds (0 disables)",
 			options: [
 				{ value: "0", label: "Disabled" },
 				{ value: "15", label: "15 seconds" },
@@ -1309,14 +1598,70 @@ export const SETTINGS_SCHEMA = {
 		type: "enum",
 		values: ["on", "off"] as const,
 		default: "on",
-		ui: { tab: "interaction", label: "Ask Notification", description: "Notify when ask tool is waiting for input" },
+		ui: {
+			tab: "interaction",
+			group: "Notifications",
+			label: "Ask Notification",
+			description: "Notify when the ask tool is waiting for input",
+		},
+	},
+
+	// Collab
+	"collab.relayUrl": {
+		type: "string",
+		default: DEFAULT_RELAY_URL,
+		ui: {
+			tab: "interaction",
+			group: "Collab",
+			label: "Relay URL",
+			description: "Relay used by /collab (wss://host[:port])",
+		},
+	},
+
+	"collab.displayName": {
+		type: "string",
+		default: "",
+		ui: {
+			tab: "interaction",
+			group: "Collab",
+			label: "Display Name",
+			description: "Name shown to other collab participants (default: OS username)",
+		},
+	},
+
+	"share.serverUrl": {
+		type: "string",
+		default: DEFAULT_SHARE_URL,
+		ui: {
+			tab: "interaction",
+			group: "Collab",
+			label: "Share Server",
+			description:
+				"Share viewer/upload base used by /share (encrypted blob upload + viewer; links are <base>/<id>#<key>)",
+		},
+	},
+
+	"share.redactSecrets": {
+		type: "boolean",
+		default: true,
+		ui: {
+			tab: "interaction",
+			group: "Collab",
+			label: "Share Secret Redaction",
+			description: "Run the secret obfuscator over /share snapshots before upload (uses the secrets.* config)",
+		},
 	},
 
 	// Speech-to-text
 	"stt.enabled": {
 		type: "boolean",
 		default: false,
-		ui: { tab: "interaction", label: "Speech-to-Text", description: "Enable speech-to-text input via microphone" },
+		ui: {
+			tab: "interaction",
+			group: "Speech",
+			label: "Speech-to-Text",
+			description: "Enable speech-to-text input via microphone",
+		},
 	},
 
 	"stt.language": {
@@ -1326,23 +1671,15 @@ export const SETTINGS_SCHEMA = {
 
 	"stt.modelName": {
 		type: "enum",
-		values: ["tiny", "tiny.en", "base", "base.en", "small", "small.en", "medium", "medium.en", "large"] as const,
-		default: "base.en",
+		values: STT_MODEL_VALUES,
+		default: DEFAULT_STT_MODEL_KEY,
 		ui: {
 			tab: "interaction",
+			group: "Speech",
 			label: "Speech Model",
-			description: "Whisper model size (larger = more accurate but slower)",
-			options: [
-				{ value: "tiny", label: "tiny", description: "Multilingual; fastest, lowest accuracy" },
-				{ value: "tiny.en", label: "tiny.en", description: "English-only; fastest" },
-				{ value: "base", label: "base", description: "Multilingual; small and fast" },
-				{ value: "base.en", label: "base.en", description: "English-only; default" },
-				{ value: "small", label: "small", description: "Multilingual; balanced" },
-				{ value: "small.en", label: "small.en", description: "English-only; balanced" },
-				{ value: "medium", label: "medium", description: "Multilingual; accurate but slower" },
-				{ value: "medium.en", label: "medium.en", description: "English-only; accurate but slower" },
-				{ value: "large", label: "large", description: "Multilingual; most accurate" },
-			],
+			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.",
+			options: STT_MODEL_OPTIONS,
 		},
 	},
 
@@ -1356,6 +1693,7 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "context",
+			group: "General",
 			label: "Auto-Promote Context",
 			description: "Promote to a larger-context model on context overflow instead of compacting",
 		},
@@ -1367,6 +1705,7 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "context",
+			group: "Compaction",
 			label: "Auto-Compact",
 			description: "Automatically compact context when it gets too large",
 		},
@@ -1374,13 +1713,14 @@ export const SETTINGS_SCHEMA = {
 
 	"compaction.strategy": {
 		type: "enum",
-		values: ["context-full", "handoff", "shake", "off"] as const,
+		values: ["context-full", "handoff", "shake", "snapcompact", "off"] as const,
 		default: "context-full",
 		ui: {
 			tab: "context",
+			group: "Compaction",
 			label: "Compaction Strategy",
 			description:
-				"Choose in-place context-full maintenance, auto-handoff, surgical shake (drop heavy content), or disable auto maintenance (off)",
+				"Choose in-place context-full maintenance, auto-handoff, surgical shake (drop heavy content), snapcompact (archive history as dense images), or disable auto maintenance (off)",
 			options: [
 				{
 					value: "context-full",
@@ -1393,6 +1733,11 @@ export const SETTINGS_SCHEMA = {
 					label: "Shake",
 					description: "Drop heavy content (tool results + large blocks) in place; recover via artifact",
 				},
+				{
+					value: "snapcompact",
+					label: "Snapcompact",
+					description: "Archive history onto dense bitmap images the model reads back; no LLM call",
+				},
 				{
 					value: "off",
 					label: "Off",
@@ -1407,6 +1752,7 @@ export const SETTINGS_SCHEMA = {
 		default: -1,
 		ui: {
 			tab: "context",
+			group: "Compaction",
 			label: "Compaction Threshold",
 			description: "Percent threshold for context maintenance; set to Default to use legacy reserve-based behavior",
 			options: [
@@ -1431,6 +1777,7 @@ export const SETTINGS_SCHEMA = {
 		default: -1,
 		ui: {
 			tab: "context",
+			group: "Compaction",
 			label: "Compaction Token Limit",
 			description: "Fixed token limit for context maintenance; overrides percentage if set",
 			options: [
@@ -1451,6 +1798,7 @@ export const SETTINGS_SCHEMA = {
 		default: false,
 		ui: {
 			tab: "context",
+			group: "Compaction",
 			label: "Save Handoff Docs",
 			description: "Save generated handoff documents to markdown files for the auto-handoff flow",
 		},
@@ -1461,6 +1809,7 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "context",
+			group: "Compaction",
 			label: "Remote Compaction",
 			description: "Use remote compaction endpoints when available instead of local summarization",
 		},
@@ -1480,6 +1829,7 @@ export const SETTINGS_SCHEMA = {
 		default: false,
 		ui: {
 			tab: "context",
+			group: "Compaction",
 			label: "Idle Compaction",
 			description: "Compact context while idle when token count exceeds threshold",
 		},
@@ -1490,6 +1840,7 @@ export const SETTINGS_SCHEMA = {
 		default: 200000,
 		ui: {
 			tab: "context",
+			group: "Compaction",
 			label: "Idle Compaction Threshold",
 			description: "Token count above which idle compaction triggers",
 			options: [
@@ -1511,6 +1862,7 @@ export const SETTINGS_SCHEMA = {
 		default: 300,
 		ui: {
 			tab: "context",
+			group: "Compaction",
 			label: "Idle Compaction Delay",
 			description: "Seconds to wait while idle before compacting",
 			options: [
@@ -1523,93 +1875,294 @@ export const SETTINGS_SCHEMA = {
 			],
 		},
 	},
-	// Branch summaries
-	"branchSummary.enabled": {
+
+	"compaction.supersedeReads": {
 		type: "boolean",
-		default: false,
-		ui: { tab: "context", label: "Branch Summaries", description: "Prompt to summarize when leaving a branch" },
+		default: true,
+		ui: {
+			tab: "context",
+			group: "Compaction",
+			label: "Supersede Stale Reads",
+			description: "Prune older read results when the same file is read again (cache-aware, runs every turn)",
+		},
 	},
 
-	"branchSummary.reserveTokens": { type: "number", default: 16384 },
-
-	// Memories
-	// Legacy local-memory enable flag kept only for back-compat migration.
-	// Hidden from UI — users should use `memory.backend` instead.
-	"memories.enabled": {
+	"compaction.dropUseless": {
 		type: "boolean",
-		default: false,
+		default: true,
+		ui: {
+			tab: "context",
+			group: "Compaction",
+			label: "Elide Uneventful Results",
+			description:
+				"Prune tool results flagged contextually useless (no matches, timed-out waits) once consumed (cache-aware)",
+		},
 	},
 
-	"memories.maxRolloutsPerStartup": { type: "number", default: 64 },
-
-	"memories.maxRolloutAgeDays": { type: "number", default: 30 },
-
-	"memories.minRolloutIdleHours": { type: "number", default: 12 },
-
-	"memories.threadScanLimit": { type: "number", default: 300 },
-
-	"memories.maxRawMemoriesForGlobal": { type: "number", default: 200 },
-
-	"memories.stage1Concurrency": { type: "number", default: 8 },
-
-	"memories.stage1LeaseSeconds": { type: "number", default: 120 },
-
-	"memories.stage1RetryDelaySeconds": { type: "number", default: 120 },
-
-	"memories.phase2LeaseSeconds": { type: "number", default: 180 },
-
-	"memories.phase2RetryDelaySeconds": { type: "number", default: 180 },
-
-	"memories.phase2HeartbeatSeconds": { type: "number", default: 30 },
-
-	"memories.rolloutPayloadPercent": { type: "number", default: 0.7 },
-
-	"memories.phase1InputTokenLimit": { type: "number", default: 4000 },
-
-	"memories.fallbackTokenLimit": { type: "number", default: 16000 },
-
-	"memories.summaryInjectionTokenLimit": { type: "number", default: 5000 },
-
-	// Memory backend selector — picks between local memories pipeline,
-	// Prometheus Memory local SQLite, Hindsight remote memory, or off. Legacy
-	// `memories.enabled` keeps gating the local backend; see config/settings.ts
-	// migration for details.
-	"memory.backend": {
+	// Experimental: snapcompact inline imaging (transient, per-request; never persisted)
+	"snapcompact.systemPrompt": {
 		type: "enum",
-		values: ["off", "local", "hindsight", "prometheus-memory"] as const,
-		default: "off",
+		values: ["none", "agents-md", "all"] as const,
+		default: "none",
 		ui: {
-			tab: "memory",
-			label: "Memory Backend",
-			description: "Off, local summary pipeline, Prometheus Memory SQLite, or Hindsight remote memory",
+			tab: "context",
+			group: "Experimental",
+			label: "Snapcompact System Prompt",
+			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.",
 			options: [
-				{ value: "off", label: "Off", description: "No memory subsystem runs" },
-				{ value: "local", label: "Local", description: "Local rollout summarisation pipeline (memory_summary.md)" },
-				{ value: "hindsight", label: "Hindsight", description: "Vectorize Hindsight remote memory service" },
+				{ value: "none", label: "None", description: "Keep the system prompt as text." },
 				{
-					value: "prometheus-memory",
-					label: "Prometheus Memory",
-					description: "Local SQLite recall/retain backend with optional embeddings",
+					value: "agents-md",
+					label: "AGENTS.md",
+					description: "Only move loaded context-file instructions to images, when that saves tokens.",
+				},
+				{
+					value: "all",
+					label: "All",
+					description: "Move the full system prompt to images, when that saves tokens.",
 				},
 			],
 		},
 	},
 
-	// Self-improvement trajectory. This deliberately follows the proven
-	// Hermes-style split: automatic learning is allowed for memory, user
-	// profile, and generated skills; SOUL/identity stays stable and proposal-only.
-	"selfImprovement.mode": {
-		type: "enum",
-		values: ["memory-and-skills", "off"] as const,
-		default: "memory-and-skills",
+	"snapcompact.toolResults": {
+		type: "boolean",
+		default: false,
 		ui: {
-			tab: "memory",
-			label: "Self Improvement",
+			tab: "context",
+			group: "Experimental",
+			label: "Snapcompact Tool Results",
 			description:
-				"Hermes-style native learning: memory, user profile, and skills update automatically; SOUL stays stable",
-			options: [
-				{
-					value: "memory-and-skills",
+				"Experimental: render large historical tool results as dense PNG image(s) instead of text (vision models only). Saves tokens on accumulated read/search output.",
+		},
+	},
+
+	"snapcompact.shape": {
+		type: "enum",
+		values: ["auto", ...SHAPE_VARIANT_NAMES] as const,
+		default: "auto",
+		ui: {
+			tab: "context",
+			group: "Experimental",
+			label: "Snapcompact Shape",
+			description:
+				"Frame shape snapcompact prints text with (compaction archive and inline imaging). Auto picks a shape tuned for the current model.",
+			options: [
+				{
+					value: "auto",
+					label: "Auto",
+					description: "Picks a shape tuned for the current model, falling back to its provider family.",
+				},
+				{
+					value: "8x8r-bw",
+					label: "8x8 repeated, black",
+					description:
+						"unscii square cell, black ink, every line printed twice with the copy on a pale highlight band.",
+				},
+				{
+					value: "8x8r-sent",
+					label: "8x8 repeated, sentence hues",
+					description: "Repeated grid with ink cycling six hues at sentence boundaries.",
+				},
+				{
+					value: "8x8u-bw",
+					label: "8x8, black",
+					description: "Plain unscii square cell, single-printed lines, black ink.",
+				},
+				{
+					value: "8x8u-sent",
+					label: "8x8, sentence hues",
+					description: "Plain unscii square cell with sentence-hue ink.",
+				},
+				{
+					value: "6x6u-bw",
+					label: "6x6 dense, black",
+					description: "unscii squeezed to 6x6 — densest readable cell, fewest frames — in black ink.",
+				},
+				{
+					value: "6x6u-sent",
+					label: "6x6 dense, sentence hues",
+					description: "Densest cell with sentence-hue ink.",
+				},
+				{
+					value: "5x8-bw",
+					label: "5x8 legacy, black",
+					description: "Original X.org 5x8 glyphs on the 2576px frame, black ink.",
+				},
+				{
+					value: "5x8-sent",
+					label: "5x8 legacy, sentence hues",
+					description: "The original snapcompact shape (pre-shape-table sessions rendered this).",
+				},
+				{
+					value: "6x12-dim",
+					label: "6x12, dimmed stopwords",
+					description: "X.org 6x12 glyphs, black ink, function words dimmed gray.",
+				},
+				{
+					value: "8x13-bw",
+					label: "8x13, black",
+					description: "X.org 8x13 glyphs, black ink.",
+				},
+				{
+					value: "8on16-bw",
+					label: "8x13 on 16px pitch, black",
+					description: "8x13 glyphs on an 8x16 cell (extra leading), black ink.",
+				},
+				{
+					value: "8on22-bw",
+					label: "8x13 on 22px pitch (leading), black",
+					description:
+						"8x13 glyphs on an 8x22 cell — extra line spacing so rows don't crowd. Default for OpenAI/Google.",
+				},
+				{
+					value: "11on16-bw",
+					label: "8x13 on 11px advance (tracking), black",
+					description:
+						"8x13 glyphs on an 11x16 cell — extra letter spacing so characters don't merge. Default for Anthropic.",
+				},
+				{
+					value: "doc-8on16-bw",
+					label: "Doc 8on16, black",
+					description: "Two word-wrapped newspaper columns of 8x13 glyphs on a 16px pitch, black ink.",
+				},
+				{
+					value: "doc-8on16-sent",
+					label: "Doc 8on16, sentence hues",
+					description: "Two-column doc layout with sentence-hue ink.",
+				},
+				{
+					value: "doc-8on16-sent-dim",
+					label: "Doc 8on16, sentence hues + dimmed stopwords",
+					description: "Two-column doc layout, sentence-hue ink, function words dimmed gray.",
+				},
+			],
+		},
+	},
+
+	// Branch summaries
+	"branchSummary.enabled": {
+		type: "boolean",
+		default: false,
+		ui: {
+			tab: "context",
+			group: "General",
+			label: "Branch Summaries",
+			description: "Prompt to summarize when leaving a branch",
+		},
+	},
+
+	"branchSummary.reserveTokens": { type: "number", default: 16384 },
+
+	// Memories
+	// Legacy local-memory enable flag kept only for back-compat migration.
+	// Hidden from UI — users should use `memory.backend` instead.
+	"memories.enabled": {
+		type: "boolean",
+		default: false,
+	},
+
+	"memories.maxRolloutsPerStartup": { type: "number", default: 64 },
+
+	"memories.maxRolloutAgeDays": { type: "number", default: 30 },
+
+	"memories.minRolloutIdleHours": { type: "number", default: 12 },
+
+	"memories.threadScanLimit": { type: "number", default: 300 },
+
+	"memories.maxRawMemoriesForGlobal": { type: "number", default: 200 },
+
+	"memories.stage1Concurrency": { type: "number", default: 8 },
+
+	"memories.stage1LeaseSeconds": { type: "number", default: 120 },
+
+	"memories.stage1RetryDelaySeconds": { type: "number", default: 120 },
+
+	"memories.phase2LeaseSeconds": { type: "number", default: 180 },
+
+	"memories.phase2RetryDelaySeconds": { type: "number", default: 180 },
+
+	"memories.phase2HeartbeatSeconds": { type: "number", default: 30 },
+
+	"memories.rolloutPayloadPercent": { type: "number", default: 0.7 },
+
+	"memories.phase1InputTokenLimit": { type: "number", default: 4000 },
+
+	"memories.fallbackTokenLimit": { type: "number", default: 16000 },
+
+	"memories.summaryInjectionTokenLimit": { type: "number", default: 5000 },
+
+	// Memory backend selector — picks between local memories pipeline,
+	// Mnemopi local SQLite, Hindsight remote memory, or off. Legacy
+	// `memories.enabled` keeps gating the local backend; see config/settings.ts
+	// migration for details.
+	"memory.backend": {
+		type: "enum",
+		values: ["off", "local", "hindsight", "mnemopi"] as const,
+		default: "off",
+		ui: {
+			tab: "memory",
+			group: "General",
+			label: "Memory Backend",
+			description: "Off, local summary pipeline, Mnemopi SQLite, or Hindsight remote memory",
+			options: [
+				{ value: "off", label: "Off", description: "No memory subsystem runs" },
+				{ value: "local", label: "Local", description: "Local rollout summarisation pipeline (memory_summary.md)" },
+				{ value: "hindsight", label: "Hindsight", description: "Vectorize Hindsight remote memory service" },
+				{
+					value: "mnemopi",
+					label: "Mnemopi",
+					description: "Local SQLite recall/retain backend with optional embeddings",
+				},
+			],
+		},
+	},
+
+	// Auto-Learn (experimental): post-stop nudge to capture lessons to memory
+	// and mint/enhance isolated managed skills under ~/.prometheus/agent/managed-skills.
+	// Master flag is default-off -> zero footprint; sub-flags gate behaviour.
+	"autolearn.enabled": {
+		type: "boolean",
+		default: false,
+		ui: {
+			tab: "memory",
+			group: "Auto-Learn",
+			label: "Auto-Learn (experimental)",
+			description:
+				"After the agent stops, nudge it to capture lessons to memory and create/enhance isolated managed skills",
+		},
+	},
+	"autolearn.autoContinue": {
+		type: "boolean",
+		default: false,
+		ui: {
+			tab: "memory",
+			group: "Auto-Learn",
+			label: "Auto-run capture at stop",
+			description:
+				"When on, auto-run one capture turn at stop (uses extra tokens). Off = passive reminder on your next turn.",
+			condition: "autolearnActive",
+		},
+	},
+	// Config-file-only knob (numbers without `options` are hidden from the UI).
+	"autolearn.minToolCalls": { type: "number", default: 5 },
+
+	// Self-improvement trajectory. Automatic learning may update memory, user
+	// profile, and generated skills; SOUL/identity stays stable and proposal-only.
+	"selfImprovement.mode": {
+		type: "enum",
+		values: ["memory-and-skills", "off"] as const,
+		default: "memory-and-skills",
+		ui: {
+			tab: "memory",
+			group: "Self Improvement",
+			label: "Self Improvement",
+			description:
+				"Hermes-style native learning: memory, user profile, and skills update automatically; SOUL stays stable",
+			options: [
+				{
+					value: "memory-and-skills",
 					label: "Memory and Skills",
 					description: "Allow the local memory backend to maintain MEMORY.md, USER.md, and generated skills",
 				},
@@ -1623,6 +2176,7 @@ export const SETTINGS_SCHEMA = {
 		default: "memory-and-skills",
 		ui: {
 			tab: "memory",
+			group: "Self Improvement",
 			label: "Post-Turn Review",
 			description:
 				"Hermes-style background review after settled turns, routed through the native Prometheus memory pipeline",
@@ -1642,6 +2196,7 @@ export const SETTINGS_SCHEMA = {
 		default: 10,
 		ui: {
 			tab: "memory",
+			group: "Self Improvement",
 			label: "Review Turn Interval",
 			description: "User turns between post-turn self-improvement reviews; 10 mirrors Hermes",
 		},
@@ -1652,6 +2207,7 @@ export const SETTINGS_SCHEMA = {
 		default: "propose",
 		ui: {
 			tab: "memory",
+			group: "Self Improvement",
 			label: "Identity Review",
 			description: "Proposal-only SOUL review; never rewrites SOUL.md automatically",
 			options: [
@@ -1670,6 +2226,7 @@ export const SETTINGS_SCHEMA = {
 		default: "dry-run",
 		ui: {
 			tab: "memory",
+			group: "Self Improvement",
 			label: "Skill Curator",
 			description: "Report-only generated-skill curation with recoverable archive lifecycle",
 			options: [
@@ -1687,6 +2244,7 @@ export const SETTINGS_SCHEMA = {
 		default: 30,
 		ui: {
 			tab: "memory",
+			group: "Self Improvement",
 			label: "Skill Stale Days",
 			description: "Days of no generated-skill activity before the dry-run curator marks it stale",
 		},
@@ -1696,51 +2254,55 @@ export const SETTINGS_SCHEMA = {
 		default: 90,
 		ui: {
 			tab: "memory",
+			group: "Self Improvement",
 			label: "Skill Archive Days",
 			description: "Days of no generated-skill activity before the dry-run curator suggests archive",
 		},
 	},
 
-	// Prometheus Memory local SQLite memory backend.
-	"prometheusMemory.dbPath": {
+	// Mnemopi local SQLite memory backend.
+	"mnemopi.dbPath": {
 		type: "string",
 		default: undefined,
 		ui: {
 			tab: "memory",
-			label: "Prometheus Memory DB Path",
+			group: "Mnemopi",
+			label: "Mnemopi DB Path",
 			description: "Optional SQLite DB path. Defaults to the agent memories directory.",
-			condition: "prometheusMemoryActive",
+			condition: "mnemopiActive",
 		},
 	},
-	"prometheusMemory.bank": {
+	"mnemopi.bank": {
 		type: "string",
 		default: undefined,
 		ui: {
 			tab: "memory",
-			label: "Prometheus Memory Bank",
+			group: "Mnemopi",
+			label: "Mnemopi Bank",
 			description: "Optional shared bank base name. Per-project modes derive project-local banks from it.",
-			condition: "prometheusMemoryActive",
+			condition: "mnemopiActive",
 		},
 	},
-	"prometheusMemory.scoping": {
+	"mnemopi.scoping": {
 		type: "enum",
 		values: ["global", "per-project", "per-project-tagged"] as const,
 		default: "per-project",
 		ui: {
 			tab: "memory",
-			label: "Prometheus Memory Scoping",
+			group: "Mnemopi",
+			label: "Mnemopi Scoping",
 			description:
 				"global = one shared bank; per-project = isolated bank per cwd; per-project-tagged = project-local writes plus global recall visibility",
 			options: [
 				{
 					value: "global",
 					label: "Global",
-					description: "One shared Prometheus Memory bank for every project",
+					description: "One shared Mnemopi bank for every project",
 				},
 				{
 					value: "per-project",
 					label: "Per project",
-					description: "Project-local Prometheus Memory bank per cwd basename",
+					description: "Project-local Mnemopi bank per cwd basename",
 				},
 				{
 					value: "per-project-tagged",
@@ -1748,121 +2310,179 @@ export const SETTINGS_SCHEMA = {
 					description: "Write to a project-local bank but merge project + shared recall results",
 				},
 			],
-			condition: "prometheusMemoryActive",
+			condition: "mnemopiActive",
+		},
+	},
+	"mnemopi.embeddingVariant": {
+		type: "enum",
+		values: ["en", "multilingual"] as const,
+		default: "en",
+		ui: {
+			tab: "memory",
+			group: "Mnemopi",
+			label: "Embedding variant",
+			description:
+				"Local embedding model family. en = stronger English model; multilingual = cross-language model. Changing this rebuilds existing memory embeddings on next start.",
+			options: [
+				{
+					value: "en",
+					label: "English (bge-base-en-v1.5)",
+					description: "BAAI/bge-base-en-v1.5 (768d), English-only",
+				},
+				{
+					value: "multilingual",
+					label: "Multilingual (multilingual-e5-large)",
+					description: "intfloat/multilingual-e5-large (1024d), cross-language recall",
+				},
+			],
+			condition: "mnemopiActive",
 		},
 	},
-	"prometheusMemory.autoRecall": {
+	"mnemopi.autoRecall": {
 		type: "boolean",
 		default: true,
 		ui: {
 			tab: "memory",
-			label: "Prometheus Memory Auto Recall",
+			group: "Mnemopi",
+			label: "Mnemopi Auto Recall",
 			description: "Recall local memories into the first turn of each session",
-			condition: "prometheusMemoryActive",
+			condition: "mnemopiActive",
 		},
 	},
-	"prometheusMemory.autoRetain": {
+	"mnemopi.autoRetain": {
 		type: "boolean",
 		default: true,
 		ui: {
 			tab: "memory",
-			label: "Prometheus Memory Auto Retain",
-			description: "Retain completed conversation turns into local Prometheus Memory",
-			condition: "prometheusMemoryActive",
+			group: "Mnemopi",
+			label: "Mnemopi Auto Retain",
+			description: "Retain completed conversation turns into local Mnemopi memory",
+			condition: "mnemopiActive",
+		},
+	},
+	"mnemopi.polyphonicRecall": {
+		type: "boolean",
+		default: false,
+		ui: {
+			tab: "memory",
+			group: "Mnemopi",
+			label: "Mnemopi Polyphonic Recall",
+			description: "Enable 4-voice recall (vector, graph, fact, temporal) fused with reciprocal rank fusion",
+			condition: "mnemopiActive",
 		},
 	},
-	"prometheusMemory.noEmbeddings": {
+	"mnemopi.enhancedRecall": {
 		type: "boolean",
 		default: false,
 		ui: {
 			tab: "memory",
-			label: "Prometheus Memory Disable Embeddings",
+			group: "Mnemopi",
+			label: "Mnemopi Enhanced Recall",
+			description: "Enable the tiered query result cache for repeated and similar recall queries",
+			condition: "mnemopiActive",
+		},
+	},
+	"mnemopi.noEmbeddings": {
+		type: "boolean",
+		default: false,
+		ui: {
+			tab: "memory",
+			group: "Mnemopi",
+			label: "Mnemopi Disable Embeddings",
 			description: "Force deterministic FTS-only recall instead of vector embeddings",
-			condition: "prometheusMemoryActive",
+			condition: "mnemopiActive",
 		},
 	},
-	"prometheusMemory.embeddingModel": {
+	"mnemopi.embeddingModel": {
 		type: "string",
 		default: undefined,
 		ui: {
 			tab: "memory",
-			label: "Prometheus Memory Embedding Model",
-			description: "Optional embedding model override passed to Prometheus Memory",
-			condition: "prometheusMemoryActive",
+			group: "Mnemopi",
+			label: "Mnemopi Embedding Model",
+			description:
+				"Advanced: explicit embedding model id that overrides the variant. Leave empty to use mnemopi.embeddingVariant.",
+			condition: "mnemopiActive",
 		},
 	},
-	"prometheusMemory.embeddingApiUrl": {
+	"mnemopi.embeddingApiUrl": {
 		type: "string",
 		default: undefined,
 		ui: {
 			tab: "memory",
-			label: "Prometheus Memory Embedding API URL",
-			description: "Optional OpenAI-compatible embedding endpoint passed to Prometheus Memory",
-			condition: "prometheusMemoryActive",
+			group: "Mnemopi",
+			label: "Mnemopi Embedding API URL",
+			description: "Optional OpenAI-compatible embedding endpoint passed to Mnemopi",
+			condition: "mnemopiActive",
 		},
 	},
-	"prometheusMemory.embeddingApiKey": {
+	"mnemopi.embeddingApiKey": {
 		type: "string",
 		default: undefined,
 		ui: {
 			tab: "memory",
-			label: "Prometheus Memory Embedding API Key",
-			description: "Optional embedding API key passed to Prometheus Memory",
-			condition: "prometheusMemoryActive",
+			group: "Mnemopi",
+			label: "Mnemopi Embedding API Key",
+			description: "Optional embedding API key passed to Mnemopi",
+			condition: "mnemopiActive",
 		},
 	},
-	"prometheusMemory.llmMode": {
+	"mnemopi.llmMode": {
 		type: "enum",
 		values: ["none", "smol", "remote"] as const,
 		default: "smol",
 		ui: {
 			tab: "memory",
-			label: "Prometheus Memory LLM Mode",
+			group: "Mnemopi",
+			label: "Mnemopi LLM Mode",
 			description: "Use no LLM, the configured smol model, or a remote OpenAI-compatible endpoint",
-			condition: "prometheusMemoryActive",
+			condition: "mnemopiActive",
 			options: [
-				{ value: "none", label: "None", description: "Disable Prometheus Memory LLM-backed extraction" },
+				{ value: "none", label: "None", description: "Disable Mnemopi LLM-backed extraction" },
 				{ value: "smol", label: "Smol", description: "Use the configured Prometheus smol model" },
-				{ value: "remote", label: "Remote", description: "Use the Prometheus Memory remote LLM settings below" },
+				{ value: "remote", label: "Remote", description: "Use the Mnemopi remote LLM settings below" },
 			],
 		},
 	},
-	"prometheusMemory.llmBaseUrl": {
+	"mnemopi.llmBaseUrl": {
 		type: "string",
 		default: undefined,
 		ui: {
 			tab: "memory",
-			label: "Prometheus Memory LLM Base URL",
-			description: "Optional OpenAI-compatible LLM endpoint for Prometheus Memory remote mode",
-			condition: "prometheusMemoryActive",
+			group: "Mnemopi",
+			label: "Mnemopi LLM Base URL",
+			description: "Optional OpenAI-compatible LLM endpoint for Mnemopi remote mode",
+			condition: "mnemopiActive",
 		},
 	},
-	"prometheusMemory.llmApiKey": {
+	"mnemopi.llmApiKey": {
 		type: "string",
 		default: undefined,
 		ui: {
 			tab: "memory",
-			label: "Prometheus Memory LLM API Key",
-			description: "Optional LLM API key for Prometheus Memory remote mode",
-			condition: "prometheusMemoryActive",
+			group: "Mnemopi",
+			label: "Mnemopi LLM API Key",
+			description: "Optional LLM API key for Mnemopi remote mode",
+			condition: "mnemopiActive",
 		},
 	},
-	"prometheusMemory.llmModel": {
+	"mnemopi.llmModel": {
 		type: "string",
 		default: undefined,
 		ui: {
 			tab: "memory",
-			label: "Prometheus Memory LLM Model",
-			description: "Optional LLM model name for Prometheus Memory remote mode",
-			condition: "prometheusMemoryActive",
+			group: "Mnemopi",
+			label: "Mnemopi LLM Model",
+			description: "Optional LLM model name for Mnemopi remote mode",
+			condition: "mnemopiActive",
 		},
 	},
-	"prometheusMemory.retainEveryNTurns": { type: "number", default: 4 },
-	"prometheusMemory.recallLimit": { type: "number", default: 8 },
-	"prometheusMemory.recallContextTurns": { type: "number", default: 3 },
-	"prometheusMemory.recallMaxQueryChars": { type: "number", default: 4000 },
-	"prometheusMemory.injectionTokenLimit": { type: "number", default: 5000 },
-	"prometheusMemory.debug": { type: "boolean", default: false },
+	"mnemopi.retainEveryNTurns": { type: "number", default: 4 },
+	"mnemopi.recallLimit": { type: "number", default: 8 },
+	"mnemopi.recallContextTurns": { type: "number", default: 3 },
+	"mnemopi.recallMaxQueryChars": { type: "number", default: 4000 },
+	"mnemopi.injectionTokenLimit": { type: "number", default: 5000 },
+	"mnemopi.debug": { type: "boolean", default: false },
 
 	// Hindsight (https://hindsight.vectorize.io)
 	"hindsight.apiUrl": {
@@ -1870,6 +2490,7 @@ export const SETTINGS_SCHEMA = {
 		default: "http://localhost:8888",
 		ui: {
 			tab: "memory",
+			group: "Hindsight",
 			label: "Hindsight API URL",
 			description: "Hindsight server URL (Cloud or self-hosted)",
 			condition: "hindsightActive",
@@ -1883,6 +2504,7 @@ export const SETTINGS_SCHEMA = {
 		default: undefined,
 		ui: {
 			tab: "memory",
+			group: "Hindsight",
 			label: "Hindsight Bank ID",
 			description: "Memory bank identifier (default: project name)",
 			condition: "hindsightActive",
@@ -1896,6 +2518,7 @@ export const SETTINGS_SCHEMA = {
 		default: "per-project-tagged",
 		ui: {
 			tab: "memory",
+			group: "Hindsight",
 			label: "Hindsight Scoping",
 			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",
@@ -1928,6 +2551,7 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "memory",
+			group: "Hindsight",
 			label: "Hindsight Auto Recall",
 			description: "Recall memories on the first turn of each session",
 			condition: "hindsightActive",
@@ -1938,6 +2562,7 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "memory",
+			group: "Hindsight",
 			label: "Hindsight Auto Retain",
 			description: "Retain transcript every N turns and at session boundaries",
 			condition: "hindsightActive",
@@ -1950,6 +2575,7 @@ export const SETTINGS_SCHEMA = {
 		default: "full-session",
 		ui: {
 			tab: "memory",
+			group: "Hindsight",
 			label: "Hindsight Retain Mode",
 			description: "full-session = upsert one document per session, last-turn = chunked",
 			options: [
@@ -1984,6 +2610,7 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "memory",
+			group: "Hindsight",
 			label: "Hindsight Mental Models",
 			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.",
@@ -1995,6 +2622,7 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "memory",
+			group: "Hindsight",
 			label: "Hindsight Mental Model Auto-Seed",
 			description:
 				"At session start, create any built-in mental models (project-conventions, project-decisions, user-preferences) that do not yet exist on the bank.",
@@ -2010,8 +2638,9 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "context",
+			group: "Rules (TTSR)",
 			label: "TTSR",
-			description: "Time Traveling Stream Rules: interrupt agent when output matches patterns",
+			description: "Interrupt the agent mid-stream when output matches rule patterns (Time-Traveling Stream Rules)",
 		},
 	},
 
@@ -2021,6 +2650,7 @@ export const SETTINGS_SCHEMA = {
 		default: "discard",
 		ui: {
 			tab: "context",
+			group: "Rules (TTSR)",
 			label: "TTSR Context Mode",
 			description: "What to do with partial output when TTSR triggers",
 		},
@@ -2032,6 +2662,7 @@ export const SETTINGS_SCHEMA = {
 		default: "always",
 		ui: {
 			tab: "context",
+			group: "Rules (TTSR)",
 			label: "TTSR Interrupt Mode",
 			description: "When to interrupt mid-stream vs inject warning after completion",
 			options: [
@@ -2049,6 +2680,7 @@ export const SETTINGS_SCHEMA = {
 		default: "once",
 		ui: {
 			tab: "context",
+			group: "Rules (TTSR)",
 			label: "TTSR Repeat Mode",
 			description: "How rules can repeat: once per session or after a message gap",
 		},
@@ -2059,6 +2691,7 @@ export const SETTINGS_SCHEMA = {
 		default: 10,
 		ui: {
 			tab: "context",
+			group: "Rules (TTSR)",
 			label: "TTSR Repeat Gap",
 			description: "Messages before a rule can trigger again",
 			options: [
@@ -2076,7 +2709,8 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "context",
-			label: "Builtin Rules",
+			group: "Rules (TTSR)",
+			label: "Built-in Rules",
 			description: "Load the default rules shipped with the agent (override individually with ttsr.disabledRules)",
 		},
 	},
@@ -2086,6 +2720,7 @@ export const SETTINGS_SCHEMA = {
 		default: [] as string[],
 		ui: {
 			tab: "context",
+			group: "Rules (TTSR)",
 			label: "Disabled Rules",
 			description: "Rule names to ignore entirely (applies to bundled defaults and your own rules)",
 		},
@@ -2101,7 +2736,8 @@ export const SETTINGS_SCHEMA = {
 		values: EDIT_MODES,
 		default: "hashline",
 		ui: {
-			tab: "editing",
+			tab: "files",
+			group: "Editing",
 			label: "Edit Mode",
 			description: "Select the edit tool variant (replace, patch, hashline, or apply_patch)",
 		},
@@ -2111,7 +2747,8 @@ export const SETTINGS_SCHEMA = {
 		type: "boolean",
 		default: true,
 		ui: {
-			tab: "editing",
+			tab: "files",
+			group: "Editing",
 			label: "Fuzzy Match",
 			description: "Accept high-confidence fuzzy matches for whitespace differences",
 		},
@@ -2121,9 +2758,10 @@ export const SETTINGS_SCHEMA = {
 		type: "number",
 		default: 0.95,
 		ui: {
-			tab: "editing",
+			tab: "files",
+			group: "Editing",
 			label: "Fuzzy Match Threshold",
-			description: "Similarity threshold for fuzzy matches",
+			description: "Similarity threshold (0-1) for accepting fuzzy matches",
 			options: [
 				{ value: "0.85", label: "0.85", description: "Lenient" },
 				{ value: "0.90", label: "0.90", description: "Moderate" },
@@ -2137,7 +2775,8 @@ export const SETTINGS_SCHEMA = {
 		type: "boolean",
 		default: false,
 		ui: {
-			tab: "editing",
+			tab: "files",
+			group: "Editing",
 			label: "Abort on Failed Preview",
 			description: "Abort streaming edit tool calls when patch preview fails",
 		},
@@ -2147,7 +2786,8 @@ export const SETTINGS_SCHEMA = {
 		type: "boolean",
 		default: true,
 		ui: {
-			tab: "editing",
+			tab: "files",
+			group: "Editing",
 			label: "Block Auto-Generated Files",
 			description: "Prevent editing of files that appear to be auto-generated (protoc, sqlc, swagger, etc.)",
 		},
@@ -2157,7 +2797,8 @@ export const SETTINGS_SCHEMA = {
 		type: "boolean",
 		default: false,
 		ui: {
-			tab: "editing",
+			tab: "files",
+			group: "Reading",
 			label: "Line Numbers",
 			description: "Prepend line numbers to read tool output by default",
 		},
@@ -2167,7 +2808,8 @@ export const SETTINGS_SCHEMA = {
 		type: "boolean",
 		default: true,
 		ui: {
-			tab: "editing",
+			tab: "files",
+			group: "Reading",
 			label: "Hash Lines",
 			description:
 				"Include snapshot-tag headers and line numbers in read output for hashline edit mode ([PATH#TAG] plus LINE:content)",
@@ -2178,7 +2820,8 @@ export const SETTINGS_SCHEMA = {
 		type: "number",
 		default: 300,
 		ui: {
-			tab: "editing",
+			tab: "files",
+			group: "Reading",
 			label: "Default Read Limit",
 			description: "Default number of lines returned when agent calls read without a limit",
 			options: [
@@ -2195,7 +2838,8 @@ export const SETTINGS_SCHEMA = {
 		type: "boolean",
 		default: true,
 		ui: {
-			tab: "editing",
+			tab: "files",
+			group: "Read Summaries",
 			label: "Read Summaries",
 			description: "Return structural code summaries when read is called without an explicit selector",
 		},
@@ -2205,7 +2849,8 @@ export const SETTINGS_SCHEMA = {
 		type: "boolean",
 		default: false,
 		ui: {
-			tab: "editing",
+			tab: "files",
+			group: "Read Summaries",
 			label: "Prose Summaries",
 			description: "Return structural summaries for Markdown and plain text reads",
 		},
@@ -2215,7 +2860,8 @@ export const SETTINGS_SCHEMA = {
 		type: "number",
 		default: 4,
 		ui: {
-			tab: "editing",
+			tab: "files",
+			group: "Read Summaries",
 			label: "Read Summary Body Lines",
 			description: "Minimum multiline body or literal length before read summaries collapse it",
 		},
@@ -2225,7 +2871,8 @@ export const SETTINGS_SCHEMA = {
 		type: "number",
 		default: 6,
 		ui: {
-			tab: "editing",
+			tab: "files",
+			group: "Read Summaries",
 			label: "Read Summary Comment Lines",
 			description: "Minimum multiline block comment length before read summaries collapse it",
 		},
@@ -2235,7 +2882,8 @@ export const SETTINGS_SCHEMA = {
 		type: "number",
 		default: 100,
 		ui: {
-			tab: "editing",
+			tab: "files",
+			group: "Read Summaries",
 			label: "Read Summary Minimum File Length",
 			description: "Files with fewer total lines are read verbatim instead of structurally summarized",
 		},
@@ -2245,7 +2893,8 @@ export const SETTINGS_SCHEMA = {
 		type: "number",
 		default: 50,
 		ui: {
-			tab: "editing",
+			tab: "files",
+			group: "Read Summaries",
 			label: "Read Summary Unfold Target",
 			description:
 				"BFS-unfold elidable spans until the summary is at least this many visible lines. 0 keeps only the outermost elisions.",
@@ -2256,7 +2905,8 @@ export const SETTINGS_SCHEMA = {
 		type: "number",
 		default: 100,
 		ui: {
-			tab: "editing",
+			tab: "files",
+			group: "Read Summaries",
 			label: "Read Summary Unfold Ceiling",
 			description:
 				"Hard ceiling on summary size while BFS-unfolding. An unfold that would exceed this is reverted and unfolding stops.",
@@ -2267,7 +2917,8 @@ export const SETTINGS_SCHEMA = {
 		type: "boolean",
 		default: false,
 		ui: {
-			tab: "editing",
+			tab: "files",
+			group: "Reading",
 			label: "Inline Read Previews",
 			description: "Render read tool results inline in the transcript instead of summary rows",
 		},
@@ -2277,14 +2928,32 @@ export const SETTINGS_SCHEMA = {
 	"lsp.enabled": {
 		type: "boolean",
 		default: true,
-		ui: { tab: "editing", label: "LSP", description: "Enable the lsp tool for language server protocol" },
+		ui: {
+			tab: "files",
+			group: "LSP",
+			label: "LSP",
+			description: "Enable the lsp tool for code intelligence (definitions, references, diagnostics, rename)",
+		},
+	},
+
+	"lsp.lazy": {
+		type: "boolean",
+		default: true,
+		ui: {
+			tab: "files",
+			group: "LSP",
+			label: "Lazy LSP Startup",
+			description:
+				"Start language servers on first use (lsp tool or editing a matching file type) instead of at session startup",
+		},
 	},
 
 	"lsp.formatOnWrite": {
 		type: "boolean",
 		default: false,
 		ui: {
-			tab: "editing",
+			tab: "files",
+			group: "LSP",
 			label: "Format on Write",
 			description: "Automatically format code files using LSP after writing",
 		},
@@ -2294,7 +2963,8 @@ export const SETTINGS_SCHEMA = {
 		type: "boolean",
 		default: true,
 		ui: {
-			tab: "editing",
+			tab: "files",
+			group: "LSP",
 			label: "Diagnostics on Write",
 			description: "Return LSP diagnostics after writing code files",
 		},
@@ -2304,7 +2974,8 @@ export const SETTINGS_SCHEMA = {
 		type: "boolean",
 		default: false,
 		ui: {
-			tab: "editing",
+			tab: "files",
+			group: "LSP",
 			label: "Diagnostics on Edit",
 			description: "Return LSP diagnostics after editing code files",
 		},
@@ -2314,17 +2985,45 @@ export const SETTINGS_SCHEMA = {
 		type: "boolean",
 		default: true,
 		ui: {
-			tab: "editing",
+			tab: "files",
+			group: "LSP",
 			label: "Deduplicate Diagnostics",
 			description: "Suppress post-edit LSP diagnostics already shown for a file; only surface new or changed ones",
 		},
 	},
 
+	"bash.enabled": {
+		type: "boolean",
+		default: true,
+		ui: {
+			tab: "shell",
+			group: "Bash",
+			label: "Bash",
+			description: "Enable the bash tool for shell command execution",
+		},
+	},
+
+	"bash.autoBackground.enabled": {
+		type: "boolean",
+		default: false,
+		ui: {
+			tab: "shell",
+			group: "Bash",
+			label: "Bash Auto-Background",
+			description: "Automatically background long-running bash commands and deliver the result later",
+		},
+	},
+
 	// Bash interceptor
 	"bashInterceptor.enabled": {
 		type: "boolean",
 		default: false,
-		ui: { tab: "editing", label: "Bash Interceptor", description: "Block shell commands that have dedicated tools" },
+		ui: {
+			tab: "shell",
+			group: "Bash",
+			label: "Bash Interceptor",
+			description: "Block shell commands that have dedicated tools",
+		},
 	},
 	"bashInterceptor.patterns": { type: "array", default: DEFAULT_BASH_INTERCEPTOR_RULES },
 
@@ -2332,8 +3031,9 @@ export const SETTINGS_SCHEMA = {
 		type: "boolean",
 		default: true,
 		ui: {
-			tab: "editing",
-			label: "Strip Trailing head/tail",
+			tab: "shell",
+			group: "Bash",
+			label: "Strip head/tail Pipes",
 			description:
 				"Silently drop trailing `| head`/`| tail` pipes from single-line bash commands. Output is already truncated automatically.",
 		},
@@ -2344,7 +3044,8 @@ export const SETTINGS_SCHEMA = {
 		type: "boolean",
 		default: true,
 		ui: {
-			tab: "editing",
+			tab: "shell",
+			group: "Bash",
 			label: "Shell Minimizer",
 			description: "Compress verbose shell output (git, npm, cargo, etc.) before returning it to the agent",
 		},
@@ -2359,15 +3060,31 @@ export const SETTINGS_SCHEMA = {
 		type: "number",
 		default: 4 * 1024 * 1024,
 	},
+	"shellMinimizer.sourceOutlineLevel": {
+		type: "enum",
+		values: ["default", "aggressive"] as const,
+		default: "default",
+		ui: {
+			tab: "shell",
+			group: "Bash",
+			label: "Shell Minimizer Source Outline",
+			description: "Source outline mode for cat/read of source files: default or aggressive",
+		},
+	},
+	"shellMinimizer.legacyFilters": {
+		type: "boolean",
+		default: undefined,
+	},
 
 	// Eval (per-backend toggles; add more as new backends ship, e.g. eval.ts)
 	"eval.py": {
 		type: "boolean",
 		default: true,
 		ui: {
-			tab: "editing",
-			label: "Eval: Python backend",
-			description: "Allow the eval tool to dispatch to the IPython kernel",
+			tab: "shell",
+			group: "Eval & Python",
+			label: "Python Eval Backend",
+			description: "Allow the eval tool to dispatch Python cells to the IPython kernel",
 		},
 	},
 
@@ -2375,9 +3092,10 @@ export const SETTINGS_SCHEMA = {
 		type: "boolean",
 		default: true,
 		ui: {
-			tab: "editing",
-			label: "Eval: JavaScript backend",
-			description: "Allow the eval tool to dispatch to the in-process JavaScript runtime",
+			tab: "shell",
+			group: "Eval & Python",
+			label: "JavaScript Eval Backend",
+			description: "Allow the eval tool to dispatch JavaScript cells to the in-process runtime",
 		},
 	},
 
@@ -2387,9 +3105,21 @@ export const SETTINGS_SCHEMA = {
 		values: ["session", "per-call"] as const,
 		default: "session",
 		ui: {
-			tab: "editing",
+			tab: "shell",
+			group: "Eval & Python",
 			label: "Python Kernel Mode",
-			description: "Whether to keep IPython kernel alive across calls",
+			description: "Keep the IPython kernel alive across eval calls or start fresh each time",
+		},
+	},
+	"python.interpreter": {
+		type: "string",
+		default: "",
+		ui: {
+			tab: "shell",
+			group: "Eval & Python",
+			label: "Python Interpreter",
+			description:
+				"Optional path to an exact Python executable. When set, automatic Python runtime discovery is skipped.",
 		},
 	},
 
@@ -2402,7 +3132,8 @@ export const SETTINGS_SCHEMA = {
 		type: "record",
 		default: {},
 		ui: {
-			tab: "tools",
+			tab: "interaction",
+			group: "Approvals",
 			label: "Tool Approval Policies",
 			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.",
@@ -2419,9 +3150,10 @@ export const SETTINGS_SCHEMA = {
 		default: "yolo",
 		ui: {
 			tab: "interaction",
+			group: "Approvals",
 			label: "Tool Approval",
 			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.",
+				"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.",
 			options: [
 				{
 					value: "always-ask",
@@ -2448,13 +3180,23 @@ export const SETTINGS_SCHEMA = {
 	"todo.enabled": {
 		type: "boolean",
 		default: true,
-		ui: { tab: "tools", label: "Todos", description: "Enable the todo tool for task tracking" },
+		ui: {
+			tab: "tools",
+			group: "Available Tools",
+			label: "Todos",
+			description: "Enable the todo tool for task tracking",
+		},
 	},
 
 	"todo.reminders": {
 		type: "boolean",
 		default: true,
-		ui: { tab: "tools", label: "Todo Reminders", description: "Remind agent to complete todos before stopping" },
+		ui: {
+			tab: "tools",
+			group: "Todos",
+			label: "Todo Reminders",
+			description: "Remind the agent to complete todos before stopping",
+		},
 	},
 
 	"todo.reminders.max": {
@@ -2462,8 +3204,9 @@ export const SETTINGS_SCHEMA = {
 		default: 3,
 		ui: {
 			tab: "tools",
+			group: "Todos",
 			label: "Todo Reminder Limit",
-			description: "Maximum reminders to complete todos before giving up",
+			description: "Maximum number of todo reminders before giving up",
 			options: [
 				{ value: "1", label: "1 reminder" },
 				{ value: "2", label: "2 reminders" },
@@ -2474,12 +3217,23 @@ export const SETTINGS_SCHEMA = {
 	},
 
 	"todo.eager": {
-		type: "boolean",
-		default: false,
+		type: "enum",
+		values: ["default", "preferred", "always"] as const,
+		default: "default",
 		ui: {
 			tab: "tools",
+			group: "Todos",
 			label: "Create Todos Automatically",
-			description: "Automatically create a comprehensive todo list after the first message",
+			description: "How strongly to push automatic todo-list creation after the first message",
+			options: [
+				{ value: "default", label: "Default", description: "Model decides; no automatic todo list" },
+				{
+					value: "preferred",
+					label: "Preferred",
+					description: "Suggests a todo list on the first message (reminder, not forced)",
+				},
+				{ value: "always", label: "Always", description: "Forces a comprehensive todo list on the first message" },
+			],
 		},
 	},
 
@@ -2487,13 +3241,23 @@ export const SETTINGS_SCHEMA = {
 	"find.enabled": {
 		type: "boolean",
 		default: true,
-		ui: { tab: "tools", label: "Find", description: "Enable the find tool for file searching" },
+		ui: {
+			tab: "tools",
+			group: "Available Tools",
+			label: "Find",
+			description: "Enable the find tool for glob-based file lookup",
+		},
 	},
 
 	"search.enabled": {
 		type: "boolean",
 		default: true,
-		ui: { tab: "tools", label: "Search", description: "Enable the search tool for content searching" },
+		ui: {
+			tab: "tools",
+			group: "Available Tools",
+			label: "Search",
+			description: "Enable the search tool for regex content search",
+		},
 	},
 
 	"search.contextBefore": {
@@ -2501,6 +3265,7 @@ export const SETTINGS_SCHEMA = {
 		default: 1,
 		ui: {
 			tab: "tools",
+			group: "Search & Browser",
 			label: "Search Context Before",
 			description: "Lines of context before each search match",
 			options: [
@@ -2518,6 +3283,7 @@ export const SETTINGS_SCHEMA = {
 		default: 3,
 		ui: {
 			tab: "tools",
+			group: "Search & Browser",
 			label: "Search Context After",
 			description: "Lines of context after each search match",
 			options: [
@@ -2536,6 +3302,7 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "tools",
+			group: "Available Tools",
 			label: "AST Grep",
 			description: "Enable the ast_grep tool for structural AST search",
 		},
@@ -2546,39 +3313,12 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "tools",
+			group: "Available Tools",
 			label: "AST Edit",
 			description: "Enable the ast_edit tool for structural AST rewrites",
 		},
 	},
 
-	"irc.enabled": {
-		type: "boolean",
-		default: true,
-		ui: {
-			tab: "tools",
-			label: "IRC",
-			description: "Enable agent-to-agent IRC messaging via the irc tool",
-		},
-	},
-
-	"irc.timeoutMs": {
-		type: "number",
-		default: 120_000,
-		ui: {
-			tab: "tools",
-			label: "IRC Timeout",
-			description:
-				"Drop IRC messages whose recipient does not respond within this many milliseconds (0 disables the timeout)",
-			options: [
-				{ value: "0", label: "Disabled" },
-				{ value: "30000", label: "30 seconds" },
-				{ value: "60000", label: "1 minute" },
-				{ value: "120000", label: "2 minutes" },
-				{ value: "300000", label: "5 minutes" },
-			],
-		},
-	},
-
 	// Optional tools
 
 	"renderMermaid.enabled": {
@@ -2586,6 +3326,7 @@ export const SETTINGS_SCHEMA = {
 		default: false,
 		ui: {
 			tab: "tools",
+			group: "Available Tools",
 			label: "Render Mermaid",
 			description: "Enable the render_mermaid tool for Mermaid-to-ASCII rendering",
 		},
@@ -2596,18 +3337,20 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "tools",
+			group: "Available Tools",
 			label: "Debug",
 			description: "Enable the debug tool for DAP-based debugging",
 		},
 	},
 
-	"tts.enabled": {
+	"speechgen.enabled": {
 		type: "boolean",
 		default: false,
 		ui: {
 			tab: "tools",
-			label: "Text-to-Speech",
-			description: "Enable the tts tool for xAI Grok Voice speech synthesis",
+			group: "Available Tools",
+			label: "Speech Generation",
+			description: "Enable the tts tool for on-device (Kokoro) or xAI Grok Voice speech-file synthesis",
 		},
 	},
 
@@ -2616,6 +3359,7 @@ export const SETTINGS_SCHEMA = {
 		default: false,
 		ui: {
 			tab: "tools",
+			group: "Available Tools",
 			label: "Inspect Image",
 			description: "Enable the inspect_image tool, delegating image understanding to a vision-capable model",
 		},
@@ -2626,6 +3370,7 @@ export const SETTINGS_SCHEMA = {
 		default: false,
 		ui: {
 			tab: "tools",
+			group: "Available Tools",
 			label: "Checkpoint/Rewind",
 			description: "Enable the checkpoint and rewind tools for context checkpointing",
 		},
@@ -2635,7 +3380,12 @@ export const SETTINGS_SCHEMA = {
 	"fetch.enabled": {
 		type: "boolean",
 		default: true,
-		ui: { tab: "tools", label: "Read URLs", description: "Allow the read tool to fetch and process URLs" },
+		ui: {
+			tab: "tools",
+			group: "Available Tools",
+			label: "Read URLs",
+			description: "Allow the read tool to fetch and process URLs",
+		},
 	},
 
 	"vault.enabled": {
@@ -2643,6 +3393,7 @@ export const SETTINGS_SCHEMA = {
 		default: false,
 		ui: {
 			tab: "tools",
+			group: "Available Tools",
 			label: "Obsidian Vault",
 			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.",
@@ -2654,6 +3405,7 @@ export const SETTINGS_SCHEMA = {
 		default: false,
 		ui: {
 			tab: "tools",
+			group: "Available Tools",
 			label: "GitHub CLI",
 			description:
 				"Enable the github tool (op-based dispatch for repository, issue, pull request, diff, search, checkout, push, and Actions watch workflows)",
@@ -2665,7 +3417,8 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "tools",
-			label: "GitHub view cache",
+			group: "GitHub",
+			label: "GitHub View Cache",
 			description:
 				"Cache rendered issue/PR view output in ~/.prometheus/cache/github-cache.db so repeated reads are free",
 		},
@@ -2676,8 +3429,10 @@ export const SETTINGS_SCHEMA = {
 		default: 300,
 		ui: {
 			tab: "tools",
-			label: "GitHub cache soft TTL (seconds)",
-			description: "Within this window, cached issue/PR view rows are returned directly. Default 5 minutes.",
+			group: "GitHub",
+			label: "GitHub Cache Soft TTL",
+			description:
+				"Within this window, cached issue/PR view rows are returned directly (seconds; default 5 minutes)",
 		},
 	},
 
@@ -2686,16 +3441,22 @@ export const SETTINGS_SCHEMA = {
 		default: 604800,
 		ui: {
 			tab: "tools",
-			label: "GitHub cache hard TTL (seconds)",
+			group: "GitHub",
+			label: "GitHub Cache Hard TTL",
 			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.",
+				"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)",
 		},
 	},
 
 	"web_search.enabled": {
 		type: "boolean",
 		default: true,
-		ui: { tab: "tools", label: "Web Search", description: "Enable the web_search tool for web searching" },
+		ui: {
+			tab: "tools",
+			group: "Available Tools",
+			label: "Web Search",
+			description: "Enable the web_search tool for live web results",
+		},
 	},
 
 	"browser.enabled": {
@@ -2703,8 +3464,9 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "tools",
+			group: "Available Tools",
 			label: "Browser",
-			description: "Enable the browser tool (Ulixee Hero)",
+			description: "Enable the browser tool for scripted Chromium automation (puppeteer)",
 		},
 	},
 
@@ -2713,16 +3475,30 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "tools",
+			group: "Search & Browser",
 			label: "Headless Browser",
 			description: "Launch browser in headless mode (disable to show browser UI)",
 		},
 	},
+
+	"browser.cmux": {
+		type: "boolean",
+		default: true,
+		ui: {
+			tab: "tools",
+			group: "Search & Browser",
+			label: "cmux Browser",
+			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.",
+		},
+	},
 	"browser.screenshotDir": {
 		type: "string",
 		default: undefined,
 		ui: {
 			tab: "tools",
-			label: "Screenshot directory",
+			group: "Search & Browser",
+			label: "Screenshot Directory",
 			description:
 				"Directory to save screenshots. If unset, screenshots go to a temp file. Supports ~. Examples: ~/Downloads, ~/Desktop, /sdcard/Download (Android)",
 		},
@@ -2734,6 +3510,7 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "tools",
+			group: "Execution",
 			label: "Intent Tracing",
 			description: "Ask the agent to describe the intent of each tool call before executing it",
 		},
@@ -2744,6 +3521,7 @@ export const SETTINGS_SCHEMA = {
 		default: 0,
 		ui: {
 			tab: "tools",
+			group: "Execution",
 			label: "Max Tool Timeout",
 			description: "Maximum timeout in seconds the agent can set for any tool (0 = no limit)",
 			options: [
@@ -2760,9 +3538,10 @@ export const SETTINGS_SCHEMA = {
 	// Async jobs
 	"async.enabled": {
 		type: "boolean",
-		default: false,
+		default: true,
 		ui: {
 			tab: "tools",
+			group: "Execution",
 			label: "Async Execution",
 			description: "Enable async bash commands and background task execution",
 		},
@@ -2775,29 +3554,40 @@ export const SETTINGS_SCHEMA = {
 
 	"async.pollWaitDuration": {
 		type: "enum",
-		values: ["5s", "10s", "30s", "1m", "5m"] as const,
-		default: "30s",
+		values: ["5s", "10s", "30s", "1m", "5m", "smart"] as const,
+		default: "smart",
 		ui: {
 			tab: "tools",
-			label: "Poll Wait Duration",
-			description: "How long the poll tool waits for background job updates before returning the current state",
+			group: "Execution",
+			label: "Max Poll Time",
+			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.",
 			options: [
 				{ value: "5s", label: "5 seconds" },
 				{ value: "10s", label: "10 seconds" },
-				{ value: "30s", label: "30 seconds", description: "Default" },
+				{ value: "30s", label: "30 seconds" },
 				{ value: "1m", label: "1 minute" },
 				{ value: "5m", label: "5 minutes" },
+				{ value: "smart", label: "Smart", description: "Default — adaptive 5s→5m, resets when you stop polling" },
 			],
 		},
 	},
 
-	"bash.autoBackground.enabled": {
-		type: "boolean",
-		default: false,
+	"irc.timeoutMs": {
+		type: "number",
+		default: 120_000,
 		ui: {
 			tab: "tools",
-			label: "Bash Auto-Background",
-			description: "Automatically background long-running bash commands and deliver the result later",
+			group: "Execution",
+			label: "IRC Timeout",
+			description: "Default timeout for irc wait (and send await:true) in milliseconds; 0 disables the timeout",
+			options: [
+				{ value: "0", label: "Disabled" },
+				{ value: "30000", label: "30 seconds" },
+				{ value: "60000", label: "1 minute" },
+				{ value: "120000", label: "2 minutes" },
+				{ value: "300000", label: "5 minutes" },
+			],
 		},
 	},
 
@@ -2813,6 +3603,7 @@ export const SETTINGS_SCHEMA = {
 		default: "auto",
 		ui: {
 			tab: "tools",
+			group: "Discovery & MCP",
 			label: "Tool Discovery",
 			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.",
@@ -2824,6 +3615,7 @@ export const SETTINGS_SCHEMA = {
 		default: [] as string[],
 		ui: {
 			tab: "tools",
+			group: "Discovery & MCP",
 			label: "Essential Tools Override",
 			description:
 				"Override the always-loaded built-in tools (default: read, bash, edit). Leave empty to use defaults.",
@@ -2834,7 +3626,12 @@ export const SETTINGS_SCHEMA = {
 	"mcp.enableProjectConfig": {
 		type: "boolean",
 		default: true,
-		ui: { tab: "tools", label: "MCP Project Config", description: "Load .mcp.json/mcp.json from project root" },
+		ui: {
+			tab: "tools",
+			group: "Discovery & MCP",
+			label: "MCP Project Config",
+			description: "Load .mcp.json/mcp.json from project root",
+		},
 	},
 
 	"mcp.discoveryMode": {
@@ -2842,6 +3639,7 @@ export const SETTINGS_SCHEMA = {
 		default: false,
 		ui: {
 			tab: "tools",
+			group: "Discovery & MCP",
 			label: "MCP Tool Discovery",
 			description: "Hide MCP tools by default and expose them through a tool discovery tool",
 		},
@@ -2852,6 +3650,7 @@ export const SETTINGS_SCHEMA = {
 		default: [] as string[],
 		ui: {
 			tab: "tools",
+			group: "Discovery & MCP",
 			label: "MCP Discovery Default Servers",
 			description: "Keep MCP tools from these servers visible while discovery mode hides other MCP tools",
 		},
@@ -2862,6 +3661,7 @@ export const SETTINGS_SCHEMA = {
 		default: false,
 		ui: {
 			tab: "tools",
+			group: "Discovery & MCP",
 			label: "MCP Update Injection",
 			description: "Inject MCP resource updates into the agent conversation",
 		},
@@ -2872,8 +3672,10 @@ export const SETTINGS_SCHEMA = {
 		default: 500,
 		ui: {
 			tab: "tools",
+			group: "Discovery & MCP",
 			label: "MCP Notification Debounce",
-			description: "Debounce window for MCP resource update notifications before injecting into conversation",
+			description:
+				"Debounce window in milliseconds for MCP resource updates before injecting them into the conversation",
 		},
 	},
 
@@ -2887,6 +3689,7 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "tasks",
+			group: "Modes",
 			label: "Plan Mode",
 			description: "Enable plan mode for read-only exploration and planning before execution",
 		},
@@ -2897,6 +3700,7 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "tasks",
+			group: "Modes",
 			label: "Goal Mode",
 			description: "Enable per-session goal mode and the hidden goal tool",
 		},
@@ -2907,7 +3711,8 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "tasks",
-			label: "Goal Status In Footer",
+			group: "Modes",
+			label: "Goal Status in Footer",
 			description: "Show token budget alongside the goal indicator in the status line",
 		},
 	},
@@ -2917,6 +3722,7 @@ export const SETTINGS_SCHEMA = {
 		default: ["interactive"],
 		ui: {
 			tab: "tasks",
+			group: "Modes",
 			label: "Goal Continuation Modes",
 			description: "Run modes where active goals may auto-continue between turns",
 		},
@@ -2940,6 +3746,7 @@ export const SETTINGS_SCHEMA = {
 		default: "none",
 		ui: {
 			tab: "tasks",
+			group: "Isolation",
 			label: "Isolation Mode",
 			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).',
@@ -2976,6 +3783,7 @@ export const SETTINGS_SCHEMA = {
 		default: "patch",
 		ui: {
 			tab: "tasks",
+			group: "Isolation",
 			label: "Isolation Merge Strategy",
 			description: "How isolated task changes are integrated (patch apply or branch merge)",
 			options: [
@@ -2991,6 +3799,7 @@ export const SETTINGS_SCHEMA = {
 		default: "generic",
 		ui: {
 			tab: "tasks",
+			group: "Isolation",
 			label: "Isolation Commit Style",
 			description: "Commit message style for nested repo changes (generic or AI-generated)",
 			options: [
@@ -3001,40 +3810,31 @@ export const SETTINGS_SCHEMA = {
 	},
 
 	"task.eager": {
-		type: "boolean",
-		default: false,
+		type: "enum",
+		values: ["default", "preferred", "always"] as const,
+		default: "default",
 		ui: {
 			tab: "tasks",
+			group: "Subagents",
 			label: "Prefer Task Delegation",
-			description: "Encourage the agent to delegate work to subagents unless changes are trivial",
+			description: "How strongly to push delegating work to subagents",
+			options: [
+				{ value: "default", label: "Default", description: "Model decides when to delegate" },
+				{ value: "preferred", label: "Preferred", description: "Adds delegation guidance to the system prompt" },
+				{ value: "always", label: "Always", description: "Prompt guidance plus a first-turn delegation reminder" },
+			],
 		},
 	},
 
-	"task.simple": {
-		type: "enum",
-		values: TASK_SIMPLE_MODES,
-		default: "schema-free",
+	"task.batch": {
+		type: "boolean",
+		default: true,
 		ui: {
 			tab: "tasks",
-			label: "Task Input Mode",
-			description: "How much shared structure the task tool accepts (default, schema-free, or independent)",
-			options: [
-				{
-					value: "default",
-					label: "Default",
-					description: "Shared context and custom task schema are available",
-				},
-				{
-					value: "schema-free",
-					label: "Schema-free",
-					description: "Shared context stays available, but custom task schema is disabled",
-				},
-				{
-					value: "independent",
-					label: "Independent",
-					description: "No shared context or custom task schema; each task must stand alone",
-				},
-			],
+			group: "Subagents",
+			label: "Batch Task Calls",
+			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.",
 		},
 	},
 
@@ -3043,8 +3843,9 @@ export const SETTINGS_SCHEMA = {
 		default: 32,
 		ui: {
 			tab: "tasks",
+			group: "Subagents",
 			label: "Max Concurrent Tasks",
-			description: "Concurrent limit for subagents",
+			description: "Maximum number of subagents running concurrently",
 			options: [
 				{ value: "0", label: "Unlimited" },
 				{ value: "1", label: "1 task" },
@@ -3063,6 +3864,7 @@ export const SETTINGS_SCHEMA = {
 		default: false,
 		ui: {
 			tab: "tasks",
+			group: "Subagents",
 			label: "LSP in Subagents",
 			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.",
@@ -3074,6 +3876,7 @@ export const SETTINGS_SCHEMA = {
 		default: 2,
 		ui: {
 			tab: "tasks",
+			group: "Subagents",
 			label: "Max Task Recursion",
 			description: "How many levels deep subagents can spawn their own subagents",
 			options: [
@@ -3091,6 +3894,7 @@ export const SETTINGS_SCHEMA = {
 		default: 0,
 		ui: {
 			tab: "tasks",
+			group: "Subagents",
 			label: "Max Subagent Runtime",
 			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.",
@@ -3104,6 +3908,36 @@ export const SETTINGS_SCHEMA = {
 		},
 	},
 
+	"task.agentIdleTtlMs": {
+		type: "number",
+		default: 420_000,
+		ui: {
+			tab: "tasks",
+			group: "Subagents",
+			label: "Agent Idle TTL",
+			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.",
+		},
+	},
+
+	"task.softRequestBudget": {
+		type: "number",
+		default: 90,
+		ui: {
+			tab: "tasks",
+			group: "Subagents",
+			label: "Soft Subagent Request Budget",
+			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.",
+			options: [
+				{ value: "0", label: "Disabled" },
+				{ value: "40", label: "40 requests" },
+				{ value: "90", label: "90 requests", description: "Default" },
+				{ value: "150", label: "150 requests" },
+			],
+		},
+	},
+
 	"task.disabledAgents": {
 		type: "array",
 		default: [] as string[],
@@ -3118,9 +3952,10 @@ export const SETTINGS_SCHEMA = {
 		type: "number",
 		default: 60,
 		ui: {
-			tab: "tasks",
-			label: "Todo auto-clear delay",
-			description: "How long to wait before removing completed/abandoned tasks from the list",
+			tab: "tools",
+			group: "Todos",
+			label: "Todo Auto-Clear Delay",
+			description: "Delay before completed or abandoned todos are removed from the todo widget",
 			options: [
 				{ value: "0", label: "Instant" },
 				{ value: "60", label: "1 minute", description: "Default" },
@@ -3138,6 +3973,7 @@ export const SETTINGS_SCHEMA = {
 		default: false,
 		ui: {
 			tab: "appearance",
+			group: "Display",
 			label: "Show Resolved Model Badge",
 			description: "Display the actual model ID used by each subagent in the task widget status line",
 		},
@@ -3149,7 +3985,12 @@ export const SETTINGS_SCHEMA = {
 	"skills.enableSkillCommands": {
 		type: "boolean",
 		default: true,
-		ui: { tab: "tasks", label: "Skill Commands", description: "Register skills as /skill:name commands" },
+		ui: {
+			tab: "tasks",
+			group: "Commands & Skills",
+			label: "Skill Commands",
+			description: "Register skills as /skill:name commands",
+		},
 	},
 
 	"skills.enableCodexUser": { type: "boolean", default: true },
@@ -3158,9 +3999,13 @@ export const SETTINGS_SCHEMA = {
 
 	"skills.enableClaudeProject": { type: "boolean", default: true },
 
-	"skills.enablePrometheusUser": { type: "boolean", default: true },
+	"skills.enablePiUser": { type: "boolean", default: true },
+
+	"skills.enablePiProject": { type: "boolean", default: true },
 
-	"skills.enablePrometheusProject": { type: "boolean", default: true },
+	"skills.enableAgentsUser": { type: "boolean", default: true },
+
+	"skills.enableAgentsProject": { type: "boolean", default: true },
 
 	"skills.customDirectories": { type: "array", default: [] as string[] },
 
@@ -3172,13 +4017,23 @@ export const SETTINGS_SCHEMA = {
 	"commands.enableClaudeUser": {
 		type: "boolean",
 		default: true,
-		ui: { tab: "tasks", label: "Claude User Commands", description: "Load commands from ~/.claude/commands/" },
+		ui: {
+			tab: "tasks",
+			group: "Commands & Skills",
+			label: "Claude User Commands",
+			description: "Load commands from ~/.claude/commands/",
+		},
 	},
 
 	"commands.enableClaudeProject": {
 		type: "boolean",
 		default: true,
-		ui: { tab: "tasks", label: "Claude Project Commands", description: "Load commands from .claude/commands/" },
+		ui: {
+			tab: "tasks",
+			group: "Commands & Skills",
+			label: "Claude Project Commands",
+			description: "Load commands from .claude/commands/",
+		},
 	},
 
 	"commands.enableOpencodeUser": {
@@ -3186,6 +4041,7 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: {
 			tab: "tasks",
+			group: "Commands & Skills",
 			label: "OpenCode User Commands",
 			description: "Load commands from ~/.config/opencode/commands/",
 		},
@@ -3194,7 +4050,12 @@ export const SETTINGS_SCHEMA = {
 	"commands.enableOpencodeProject": {
 		type: "boolean",
 		default: true,
-		ui: { tab: "tasks", label: "OpenCode Project Commands", description: "Load commands from .opencode/commands/" },
+		ui: {
+			tab: "tasks",
+			group: "Commands & Skills",
+			label: "OpenCode Project Commands",
+			description: "Load commands from .opencode/commands/",
+		},
 	},
 
 	// ────────────────────────────────────────────────────────────────────────
@@ -3205,7 +4066,12 @@ export const SETTINGS_SCHEMA = {
 	"secrets.enabled": {
 		type: "boolean",
 		default: false,
-		ui: { tab: "providers", label: "Hide Secrets", description: "Obfuscate secrets before sending to AI providers" },
+		ui: {
+			tab: "providers",
+			group: "Privacy",
+			label: "Hide Secrets",
+			description: "Obfuscate secrets before sending to AI providers",
+		},
 	},
 
 	// Provider selection
@@ -3215,8 +4081,9 @@ export const SETTINGS_SCHEMA = {
 		default: "auto",
 		ui: {
 			tab: "providers",
+			group: "Services",
 			label: "Web Search Provider",
-			description: "Provider for web search tool",
+			description: "Preferred provider for the web_search tool",
 			options: SEARCH_PROVIDER_OPTIONS,
 		},
 	},
@@ -3226,8 +4093,9 @@ export const SETTINGS_SCHEMA = {
 		default: "auto",
 		ui: {
 			tab: "providers",
+			group: "Services",
 			label: "Image Provider",
-			description: "Provider for image generation tool",
+			description: "Preferred provider for image generation",
 			options: [
 				{
 					value: "auto",
@@ -3243,21 +4111,109 @@ export const SETTINGS_SCHEMA = {
 				{
 					value: "xai",
 					label: "xAI Grok Imagine",
-					description: "Requires xAI Grok OAuth or XAI_API_KEY",
+					description: "Requires xAI Grok OAuth or XAI_APROMETHEUS_KEY",
+				},
+				{ value: "gemini", label: "Gemini", description: "Requires GEMINI_APROMETHEUS_KEY" },
+				{ value: "openrouter", label: "OpenRouter", description: "Requires OPENROUTER_APROMETHEUS_KEY" },
+			],
+		},
+	},
+	"providers.tts": {
+		type: "enum",
+		values: ["auto", "local", "xai"] as const,
+		default: "auto",
+		ui: {
+			tab: "providers",
+			group: "Services",
+			label: "Text-to-Speech Provider",
+			description: "Backend for the tts tool: local on-device neural TTS (Kokoro-82M) or xAI Grok Voice",
+			options: [
+				{
+					value: "auto",
+					label: "Auto",
+					description: "Prefer local on-device TTS; route .mp3 output to xAI when credentials exist",
+				},
+				{ value: "local", label: "Local", description: "On-device neural TTS (Kokoro-82M); output is WAV/PCM16" },
+				{
+					value: "xai",
+					label: "xAI Grok Voice",
+					description: "Requires xAI Grok OAuth or XAI_APROMETHEUS_KEY; MP3 or WAV",
 				},
-				{ value: "gemini", label: "Gemini", description: "Requires GEMINI_API_KEY" },
-				{ value: "openrouter", label: "OpenRouter", description: "Requires OPENROUTER_API_KEY" },
 			],
 		},
 	},
+	"tts.localModel": {
+		type: "enum",
+		values: TTS_LOCAL_MODEL_VALUES,
+		default: DEFAULT_TTS_LOCAL_MODEL_KEY,
+		ui: {
+			tab: "providers",
+			group: "Services",
+			label: "Local TTS Model",
+			description: "On-device neural TTS model (Kokoro-82M) used by the local TTS backend",
+			options: TTS_LOCAL_MODEL_OPTIONS,
+		},
+	},
+	"tts.localVoice": {
+		type: "enum",
+		values: TTS_LOCAL_VOICE_VALUES,
+		default: DEFAULT_TTS_VOICE,
+		ui: {
+			tab: "providers",
+			group: "Services",
+			label: "Local TTS Voice",
+			description: "Kokoro voice used by the local TTS backend (American/British, female/male)",
+			options: TTS_LOCAL_VOICE_OPTIONS,
+		},
+	},
+	"speech.enabled": {
+		type: "boolean",
+		default: false,
+		ui: {
+			tab: "providers",
+			group: "Services",
+			label: "Speech Vocalization",
+			description: "Speak the assistant's output aloud through the speakers as it streams",
+		},
+	},
+	"speech.mode": {
+		type: "enum",
+		values: ["all", "assistant", "yield"] as const,
+		default: "assistant",
+		ui: {
+			tab: "providers",
+			group: "Services",
+			label: "Speech Vocalization Mode",
+			description:
+				"What to speak: all = assistant messages + thinking; assistant = messages only; yield = only the final message at turn end",
+			options: [
+				{ value: "all", label: "All (messages + thinking)" },
+				{ value: "assistant", label: "Assistant messages" },
+				{ value: "yield", label: "Final message only" },
+			],
+		},
+	},
+	"speech.voice": {
+		type: "enum",
+		values: TTS_LOCAL_VOICE_VALUES,
+		default: DEFAULT_TTS_VOICE,
+		ui: {
+			tab: "providers",
+			group: "Services",
+			label: "Speech Vocalization Voice",
+			description: "Kokoro voice used when speaking the assistant's output aloud",
+			options: TTS_LOCAL_VOICE_OPTIONS,
+		},
+	},
 	"providers.tinyModel": {
 		type: "enum",
 		values: TINY_TITLE_MODEL_VALUES,
 		default: ONLINE_TINY_TITLE_MODEL_KEY,
 		ui: {
 			tab: "providers",
+			group: "Tiny Model",
 			label: "Tiny Model",
-			description: "Session-title model: online prometheus/smol by default, or a local on-device model",
+			description: "Session-title model: online pi/smol by default, or a local on-device model",
 			options: TINY_TITLE_MODEL_OPTIONS,
 		},
 	},
@@ -3267,6 +4223,7 @@ export const SETTINGS_SCHEMA = {
 		default: TINY_MODEL_DEVICE_DEFAULT,
 		ui: {
 			tab: "providers",
+			group: "Tiny Model",
 			label: "Tiny Model Device",
 			description:
 				"ONNX execution provider for local tiny models (titles + memory). Default uses CPU-only inference. The PROMETHEUS_TINY_DEVICE env var overrides this.",
@@ -3279,6 +4236,7 @@ export const SETTINGS_SCHEMA = {
 		default: TINY_MODEL_DTYPE_DEFAULT,
 		ui: {
 			tab: "providers",
+			group: "Tiny Model",
 			label: "Tiny Model Precision",
 			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.",
@@ -3291,10 +4249,11 @@ export const SETTINGS_SCHEMA = {
 		default: ONLINE_MEMORY_MODEL_KEY,
 		ui: {
 			tab: "memory",
+			group: "General",
 			label: "Memory Model",
 			description:
-				"Prometheus Memory LLM for fact extraction + consolidation: online (smol/remote) by default, or a local on-device model",
-			condition: "prometheusMemoryActive",
+				"Mnemopi LLM for fact extraction + consolidation: online (smol/remote) by default, or a local on-device model",
+			condition: "mnemopiActive",
 			options: TINY_MEMORY_MODEL_OPTIONS,
 		},
 	},
@@ -3305,6 +4264,7 @@ export const SETTINGS_SCHEMA = {
 		default: ONLINE_AUTO_THINKING_MODEL_KEY,
 		ui: {
 			tab: "model",
+			group: "Thinking",
 			label: "Auto Thinking Model",
 			description:
 				"Difficulty classifier for the `auto` thinking level: online smol by default, or a local on-device model",
@@ -3319,6 +4279,7 @@ export const SETTINGS_SCHEMA = {
 		default: "anthropic",
 		ui: {
 			tab: "providers",
+			group: "Protocol",
 			label: "Kimi API Format",
 			description: "API format for Kimi Code provider",
 			options: [
@@ -3334,6 +4295,7 @@ export const SETTINGS_SCHEMA = {
 		default: "auto",
 		ui: {
 			tab: "providers",
+			group: "Protocol",
 			label: "OpenAI WebSockets",
 			description: "Websocket policy for OpenAI Codex models (auto uses model defaults, on forces, off disables)",
 			options: [
@@ -3350,6 +4312,7 @@ export const SETTINGS_SCHEMA = {
 		default: "default",
 		ui: {
 			tab: "providers",
+			group: "Protocol",
 			label: "OpenRouter Routing",
 			description:
 				"Default routing-variant suffix appended to OpenRouter model IDs (overridden when the selector already names a variant)",
@@ -3366,13 +4329,70 @@ export const SETTINGS_SCHEMA = {
 			],
 		},
 	},
-	"providers.parallelFetch": {
-		type: "boolean",
-		default: true,
+	"providers.fetch": {
+		type: "enum",
+		values: ["auto", "native", "trafilatura", "lynx", "parallel", "jina"] as const,
+		default: "auto",
 		ui: {
 			tab: "providers",
-			label: "Parallel Fetch",
-			description: "Use Parallel extract API for URL fetching when credentials are available",
+			group: "Services",
+			label: "Fetch Provider",
+			description: "Reader backend priority for the fetch/read URL tool",
+			options: [
+				{
+					value: "auto",
+					label: "Auto",
+					description: "Priority: native > trafilatura > lynx > parallel > jina",
+				},
+				{ value: "native", label: "Native", description: "In-process HTML→Markdown converter (always available)" },
+				{ value: "trafilatura", label: "Trafilatura", description: "Auto-installs via uv/pip" },
+				{ value: "lynx", label: "Lynx", description: "Requires lynx system package" },
+				{ value: "parallel", label: "Parallel", description: "Requires PARALLEL_APROMETHEUS_KEY" },
+				{ value: "jina", label: "Jina", description: "Uses r.jina.ai reader (JINA_APROMETHEUS_KEY optional)" },
+			],
+		},
+	},
+	// Codex saved rate-limit resets (auto-redeem)
+	"codexResets.autoRedeem": {
+		type: "enum",
+		values: ["unset", "yes", "no"] as const,
+		default: "unset" as const,
+		ui: {
+			tab: "providers",
+			group: "Services",
+			label: "Codex Auto-Redeem Saved Resets",
+			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.",
+			options: [
+				{
+					value: "unset",
+					label: "Unset",
+					description: "Check eligibility, then ask before spending the first saved reset.",
+				},
+				{ value: "yes", label: "Yes", description: "Spend eligible saved resets without prompting." },
+				{ value: "no", label: "No", description: "Do not run the saved-reset auto-redeem check." },
+			],
+		},
+	},
+	"codexResets.minBlockedMinutes": {
+		type: "number",
+		default: 60,
+		ui: {
+			tab: "providers",
+			group: "Services",
+			label: "Codex Auto-Redeem Min Block",
+			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).",
+		},
+	},
+	"codexResets.keepCredits": {
+		type: "number",
+		default: 0,
+		ui: {
+			tab: "providers",
+			group: "Services",
+			label: "Codex Auto-Redeem Reserve",
+			description: "Never auto-spend below this many saved resets (0 = the last credit may be spent automatically).",
 		},
 	},
 	"provider.appendOnlyContext": {
@@ -3381,6 +4401,7 @@ export const SETTINGS_SCHEMA = {
 		default: "auto",
 		ui: {
 			tab: "providers",
+			group: "Protocol",
 			label: "Append-Only Context",
 			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.",
@@ -3396,25 +4417,40 @@ export const SETTINGS_SCHEMA = {
 	"exa.enabled": {
 		type: "boolean",
 		default: true,
-		ui: { tab: "providers", label: "Exa", description: "Master toggle for all Exa search tools" },
+		ui: { tab: "providers", group: "Services", label: "Exa", description: "Master toggle for all Exa search tools" },
 	},
 
 	"exa.enableSearch": {
 		type: "boolean",
 		default: true,
-		ui: { tab: "providers", label: "Exa Search", description: "Basic search, deep search, code search, crawl" },
+		ui: {
+			tab: "providers",
+			group: "Services",
+			label: "Exa Search",
+			description: "Enable Exa basic search, deep search, code search, and crawl tools",
+		},
 	},
 
 	"exa.enableResearcher": {
 		type: "boolean",
 		default: false,
-		ui: { tab: "providers", label: "Exa Researcher", description: "AI-powered deep research tasks" },
+		ui: {
+			tab: "providers",
+			group: "Services",
+			label: "Exa Researcher",
+			description: "Enable the Exa researcher tool for AI-powered deep research",
+		},
 	},
 
 	"exa.enableWebsets": {
 		type: "boolean",
 		default: false,
-		ui: { tab: "providers", label: "Exa Websets", description: "Webset management and enrichment tools" },
+		ui: {
+			tab: "providers",
+			group: "Services",
+			label: "Exa Websets",
+			description: "Enable Exa webset management and enrichment tools",
+		},
 	},
 
 	// SearXNG
@@ -3423,8 +4459,9 @@ export const SETTINGS_SCHEMA = {
 		default: undefined,
 		ui: {
 			tab: "providers",
+			group: "Services",
 			label: "SearXNG Endpoint",
-			description: "Self-hosted search base URL",
+			description: "Base URL of a self-hosted SearXNG instance used for web search",
 		},
 	},
 
@@ -3470,6 +4507,7 @@ export const SETTINGS_SCHEMA = {
 		default: false,
 		ui: {
 			tab: "tools",
+			group: "Developer",
 			label: "Auto QA",
 			description: "Enable automated tool issue reporting (report_tool_issue) for all agents",
 		},
@@ -3477,15 +4515,12 @@ export const SETTINGS_SCHEMA = {
 
 	"dev.autoqaPush.endpoint": {
 		type: "string",
-		// Bundled QA collector — runs `/work/prometheus-www/autoqa` behind qa.prometheus.trivlab.com.
-		// Override via `PROMETHEUS_AUTO_QA_PUSH_URL` or `dev.autoqaPush.endpoint`
-		// in `config.yml` to point at a self-hosted instance.
-		default: "https://qa.prometheus.trivlab.com/v1/grievances" as const,
+		default: "https://qa.prometheus.sh/v1/grievances" as const,
 		ui: {
 			tab: "tools",
+			group: "Developer",
 			label: "Auto QA Push Endpoint",
-			description:
-				"Full URL that receives the JSON payload (default ships to https://qa.prometheus.trivlab.com/v1/grievances)",
+			description: "Full URL receiving Auto QA JSON reports (default https://qa.prometheus.sh/v1/grievances)",
 		},
 	},
 
@@ -3532,21 +4567,23 @@ type Schema = typeof SETTINGS_SCHEMA;
 export type SettingPath = keyof Schema;
 
 /** Infer the value type for a setting path */
-export type SettingValue<P extends SettingPath> = Schema[P] extends { type: "boolean" }
-	? boolean
-	: Schema[P] extends { type: "string" }
-		? string | undefined
-		: Schema[P] extends { type: "number" }
-			? number
-			: Schema[P] extends { type: "enum"; values: infer V }
-				? V extends readonly string[]
-					? V[number]
-					: never
-				: Schema[P] extends { type: "array"; default: infer D }
-					? D
-					: Schema[P] extends { type: "record"; default: infer D }
+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 { type: "number" }
+				? number
+				: Schema[P] extends { type: "enum"; values: infer V }
+					? V extends readonly string[]
+						? V[number]
+						: never
+					: Schema[P] extends { type: "array"; default: infer D }
 						? D
-						: never;
+						: Schema[P] extends { type: "record"; default: infer D }
+							? D
+							: never;
 
 /** Get the default value for a setting path */
 export function getDefault<P extends SettingPath>(path: P): SettingValue<P> {
@@ -3596,13 +4633,16 @@ 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">;
+
 // ═══════════════════════════════════════════════════════════════════════════
 // Typed Group Definitions
 // ═══════════════════════════════════════════════════════════════════════════
 
 export interface CompactionSettings {
 	enabled: boolean;
-	strategy: "context-full" | "handoff" | "shake" | "off";
+	strategy: "context-full" | "handoff" | "shake" | "snapcompact" | "off";
 	thresholdPercent: number;
 	thresholdTokens: number;
 	reserveTokens: number;
@@ -3614,6 +4654,8 @@ export interface CompactionSettings {
 	idleEnabled: boolean;
 	idleThresholdTokens: number;
 	idleTimeoutSeconds: number;
+	supersedeReads: boolean;
+	dropUseless: boolean;
 }
 
 export interface ContextPromotionSettings {
@@ -3661,8 +4703,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[];
@@ -3701,6 +4745,7 @@ export interface StatusLineSettings {
 	preset: StatusLinePreset;
 	separator: StatusLineSeparatorStyle;
 	showHookStatus: boolean;
+	transparent: boolean;
 	leftSegments: StatusLineSegmentId[];
 	rightSegments: StatusLineSegmentId[];
 	segmentOptions: Record<string, unknown>;
@@ -3718,8 +4763,7 @@ export interface SttSettings {
 	enabled: boolean;
 	language: string | undefined;
 	modelName: string;
-	whisperPath: string | undefined;
-	modelPath: string | undefined;
+	streaming: boolean;
 }
 
 export interface BashInterceptorRule {
@@ -3736,6 +4780,15 @@ 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 */
@@ -3756,6 +4809,7 @@ export interface GroupTypeMap {
 	modelTags: ModelTagsSettings;
 	cycleOrder: string[];
 	shellMinimizer: ShellMinimizerSettings;
+	codexResets: CodexResetsSettings;
 }
 
 export type GroupPrefix = keyof GroupTypeMap;