@terminai/core 0.21.0

package/dist/src/config/settings/schema.d.ts

@@ -0,0 +1,2126 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { MCPServerConfig, BugCommandSettings, AuthType } from '../../index.js';
+import type { SettingEnumOption } from './schema-types.js';
+import { MergeStrategy } from './schema-types.js';
+import type { CustomTheme, SessionRetentionSettings, DnsResolutionOrder } from './types.js';
+/**
+ * The canonical schema for all settings.
+ * The structure of this object defines the structure of the `Settings` type.
+ * `as const` is crucial for TypeScript to infer the most specific types possible.
+ */
+export declare const SETTINGS_SCHEMA: {
+    readonly telemetry: {
+        readonly type: "object";
+        readonly label: "Telemetry";
+        readonly category: "Advanced";
+        readonly requiresRestart: false;
+        readonly default: {};
+        readonly description: "Telemetry configuration.";
+        readonly showInDialog: false;
+        readonly properties: {
+            readonly enabled: {
+                readonly type: "boolean";
+                readonly label: "Enable Telemetry";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: true;
+                readonly showInDialog: true;
+            };
+            readonly target: {
+                readonly type: "enum";
+                readonly label: "Telemetry Target";
+                readonly category: "Advanced";
+                readonly requiresRestart: true;
+                readonly default: "local";
+                readonly options: readonly [{
+                    readonly value: "local";
+                    readonly label: "Local";
+                }, {
+                    readonly value: "gcp";
+                    readonly label: "GCP";
+                }];
+                readonly showInDialog: true;
+            };
+            readonly otlpEndpoint: {
+                readonly type: "string";
+                readonly label: "OTLP Endpoint";
+                readonly category: "Advanced";
+                readonly requiresRestart: true;
+                readonly default: string | undefined;
+                readonly showInDialog: true;
+            };
+            readonly otlpProtocol: {
+                readonly type: "enum";
+                readonly label: "OTLP Protocol";
+                readonly category: "Advanced";
+                readonly requiresRestart: true;
+                readonly default: "http";
+                readonly options: readonly [{
+                    readonly value: "http";
+                    readonly label: "HTTP";
+                }, {
+                    readonly value: "grpc";
+                    readonly label: "gRPC";
+                }];
+                readonly showInDialog: true;
+            };
+            readonly logPrompts: {
+                readonly type: "boolean";
+                readonly label: "Log Prompts";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: false;
+                readonly showInDialog: true;
+            };
+            readonly outfile: {
+                readonly type: "string";
+                readonly label: "Output File";
+                readonly category: "Advanced";
+                readonly requiresRestart: true;
+                readonly default: string | undefined;
+                readonly showInDialog: true;
+            };
+            readonly useCollector: {
+                readonly type: "boolean";
+                readonly label: "Use Collector";
+                readonly category: "Advanced";
+                readonly requiresRestart: true;
+                readonly default: false;
+                readonly showInDialog: true;
+            };
+        };
+    };
+    readonly security_profile: {
+        readonly type: "enum";
+        readonly label: "Security Profile";
+        readonly category: "Security";
+        readonly requiresRestart: false;
+        readonly default: "balanced";
+        readonly options: readonly [{
+            readonly value: "strict";
+            readonly label: "Strict";
+        }, {
+            readonly value: "balanced";
+            readonly label: "Balanced";
+        }, {
+            readonly value: "minimal";
+            readonly label: "Minimal";
+        }];
+        readonly description: "Controls the level of security approval required.";
+        readonly showInDialog: true;
+    };
+    readonly security: {
+        readonly type: "object";
+        readonly label: "Security";
+        readonly category: "Security";
+        readonly requiresRestart: false;
+        readonly default: {};
+        readonly description: "Detailed security settings.";
+        readonly showInDialog: false;
+        readonly properties: {
+            readonly approvalPin: {
+                readonly type: "string";
+                readonly label: "Approval PIN";
+                readonly category: "Security";
+                readonly requiresRestart: false;
+                readonly default: "000000";
+                readonly description: "6-digit PIN for high-risk actions.";
+                readonly showInDialog: true;
+            };
+            readonly trustedDomains: {
+                readonly type: "array";
+                readonly label: "Trusted Domains";
+                readonly category: "Security";
+                readonly requiresRestart: false;
+                readonly default: ["google.com", "googleapis.com", "github.com", "githubusercontent.com", "npmjs.org", "npmjs.com", "pypi.org", "python.org"];
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "List of trusted domains for network operations.";
+            };
+            readonly criticalPaths: {
+                readonly type: "array";
+                readonly label: "Critical Paths";
+                readonly category: "Security";
+                readonly requiresRestart: false;
+                readonly default: ["/", "/etc", "/usr", "/bin", "/sbin", "~/.ssh", "~/.aws", "~/.gnupg"];
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "List of critical file system paths that always require PIN.";
+            };
+            readonly disableYoloMode: {
+                readonly type: "boolean";
+                readonly label: "Disable YOLO Mode";
+                readonly category: "Security";
+                readonly requiresRestart: true;
+                readonly default: false;
+                readonly description: "Disable YOLO mode, even if enabled by a flag.";
+                readonly showInDialog: true;
+            };
+            readonly enablePermanentToolApproval: {
+                readonly type: "boolean";
+                readonly label: "Allow Permanent Tool Approval";
+                readonly category: "Security";
+                readonly requiresRestart: false;
+                readonly default: false;
+                readonly description: "Enable the \"Allow for all future sessions\" option in tool confirmation dialogs.";
+                readonly showInDialog: true;
+            };
+            readonly blockGitExtensions: {
+                readonly type: "boolean";
+                readonly label: "Blocks extensions from Git";
+                readonly category: "Security";
+                readonly requiresRestart: true;
+                readonly default: false;
+                readonly description: "Blocks installing and loading extensions from Git.";
+                readonly showInDialog: true;
+            };
+            readonly folderTrust: {
+                readonly type: "object";
+                readonly label: "Folder Trust";
+                readonly category: "Security";
+                readonly requiresRestart: false;
+                readonly default: {};
+                readonly description: "Settings for folder trust.";
+                readonly showInDialog: false;
+                readonly properties: {
+                    readonly enabled: {
+                        readonly type: "boolean";
+                        readonly label: "Folder Trust";
+                        readonly category: "Security";
+                        readonly requiresRestart: true;
+                        readonly default: false;
+                        readonly description: "Setting to track whether Folder trust is enabled.";
+                        readonly showInDialog: true;
+                    };
+                };
+            };
+            readonly auth: {
+                readonly type: "object";
+                readonly label: "Authentication";
+                readonly category: "Security";
+                readonly requiresRestart: true;
+                readonly default: {};
+                readonly description: "Authentication settings.";
+                readonly showInDialog: false;
+                readonly properties: {
+                    readonly selectedType: {
+                        readonly type: "string";
+                        readonly label: "Selected Auth Type";
+                        readonly category: "Security";
+                        readonly requiresRestart: true;
+                        readonly default: AuthType | undefined;
+                        readonly description: "The currently selected authentication type.";
+                        readonly showInDialog: false;
+                    };
+                    readonly enforcedType: {
+                        readonly type: "string";
+                        readonly label: "Enforced Auth Type";
+                        readonly category: "Advanced";
+                        readonly requiresRestart: true;
+                        readonly default: AuthType | undefined;
+                        readonly description: "The required auth type. If this does not match the selected auth type, the user will be prompted to re-authenticate.";
+                        readonly showInDialog: false;
+                    };
+                    readonly useExternal: {
+                        readonly type: "boolean";
+                        readonly label: "Use External Auth";
+                        readonly category: "Security";
+                        readonly requiresRestart: true;
+                        readonly default: boolean | undefined;
+                        readonly description: "Whether to use an external authentication flow.";
+                        readonly showInDialog: false;
+                    };
+                };
+            };
+        };
+    };
+    readonly modelConfigs: {
+        readonly type: "object";
+        readonly label: "Model Configurations";
+        readonly category: "Model";
+        readonly requiresRestart: true;
+        readonly default: {};
+        readonly description: "Specific configurations for models.";
+        readonly showInDialog: false;
+    };
+    readonly ide: {
+        readonly type: "object";
+        readonly label: "IDE Integration";
+        readonly category: "Advanced";
+        readonly requiresRestart: true;
+        readonly default: {};
+        readonly description: "IDE integration settings.";
+        readonly showInDialog: false;
+        readonly properties: {
+            readonly enabled: {
+                readonly type: "boolean";
+                readonly label: "Enable IDE Mode";
+                readonly category: "Advanced";
+                readonly requiresRestart: true;
+                readonly default: false;
+                readonly showInDialog: true;
+            };
+            readonly hasSeenNudge: {
+                readonly type: "boolean";
+                readonly label: "Has Seen Nudge";
+                readonly category: "Extensions";
+                readonly requiresRestart: false;
+                readonly default: false;
+                readonly description: "Whether the user has seen the IDE integration nudge.";
+                readonly showInDialog: false;
+            };
+        };
+    };
+    readonly context: {
+        readonly type: "object";
+        readonly label: "Context";
+        readonly category: "Advanced";
+        readonly requiresRestart: false;
+        readonly default: {};
+        readonly description: "Context and memory settings.";
+        readonly showInDialog: false;
+        readonly properties: {
+            readonly fileName: {
+                readonly type: "string";
+                readonly label: "Context File Name";
+                readonly category: "Context";
+                readonly requiresRestart: false;
+                readonly default: string | string[] | undefined;
+                readonly ref: "StringOrStringArray";
+                readonly description: "The name of the context file or files to load into memory. Accepts either a single string or an array of strings.";
+                readonly showInDialog: false;
+            };
+            readonly importFormat: {
+                readonly type: "enum";
+                readonly label: "Import Format";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: "tree";
+                readonly options: readonly [{
+                    readonly value: "tree";
+                    readonly label: "Tree";
+                }, {
+                    readonly value: "flat";
+                    readonly label: "Flat";
+                }];
+            };
+            readonly fileFiltering: {
+                readonly type: "object";
+                readonly label: "File Filtering";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: {};
+                readonly description: "File filtering options.";
+                readonly showInDialog: false;
+                readonly properties: {
+                    readonly disableFuzzySearch: {
+                        readonly type: "boolean";
+                        readonly label: "Disable Fuzzy Search";
+                        readonly category: "Advanced";
+                        readonly requiresRestart: false;
+                        readonly default: false;
+                    };
+                    readonly respectGitIgnore: {
+                        readonly type: "boolean";
+                        readonly label: "Respect .gitignore";
+                        readonly category: "Advanced";
+                        readonly requiresRestart: false;
+                        readonly default: true;
+                    };
+                    readonly respectGeminiIgnore: {
+                        readonly type: "boolean";
+                        readonly label: "Respect .geminiignore";
+                        readonly category: "Advanced";
+                        readonly requiresRestart: false;
+                        readonly default: true;
+                    };
+                    readonly enableRecursiveFileSearch: {
+                        readonly type: "boolean";
+                        readonly label: "Recursive Search";
+                        readonly category: "Advanced";
+                        readonly requiresRestart: false;
+                        readonly default: true;
+                    };
+                };
+            };
+            readonly includeDirectories: {
+                readonly type: "array";
+                readonly label: "Include Directories";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: string[];
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly mergeStrategy: MergeStrategy.UNION;
+            };
+            readonly loadMemoryFromIncludeDirectories: {
+                readonly type: "boolean";
+                readonly label: "Load Memory from Included Directories";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: false;
+            };
+            readonly discoveryMaxDirs: {
+                readonly type: "number";
+                readonly label: "Discovery Max Directories";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: 200;
+            };
+        };
+    };
+    readonly llm: {
+        readonly type: "object";
+        readonly label: "LLM Configuration";
+        readonly category: "Model";
+        readonly requiresRestart: true;
+        readonly default: {};
+        readonly description: "LLM provider configuration.";
+        readonly showInDialog: false;
+        readonly properties: {
+            readonly provider: {
+                readonly type: "enum";
+                readonly label: "Provider";
+                readonly category: "Model";
+                readonly requiresRestart: true;
+                readonly default: "gemini";
+                readonly options: readonly [{
+                    readonly value: "gemini";
+                    readonly label: "Gemini";
+                }, {
+                    readonly value: "openai_compatible";
+                    readonly label: "OpenAI Compatible";
+                }, {
+                    readonly value: "anthropic";
+                    readonly label: "Anthropic";
+                }];
+                readonly description: "Select the LLM provider.";
+                readonly showInDialog: true;
+            };
+            readonly headers: {
+                readonly type: "object";
+                readonly label: "Custom Headers";
+                readonly category: "Model";
+                readonly requiresRestart: true;
+                readonly default: {};
+                readonly description: "Custom headers for LLM requests.";
+                readonly showInDialog: false;
+                readonly additionalProperties: {
+                    readonly type: "string";
+                };
+            };
+            readonly openaiCompatible: {
+                readonly type: "object";
+                readonly label: "OpenAI Compatible Settings";
+                readonly category: "Model";
+                readonly requiresRestart: true;
+                readonly default: {};
+                readonly description: "Settings for OpenAI-compatible provider.";
+                readonly showInDialog: false;
+                readonly properties: {
+                    readonly baseUrl: {
+                        readonly type: "string";
+                        readonly label: "Base URL";
+                        readonly category: "Model";
+                        readonly requiresRestart: true;
+                        readonly default: string | undefined;
+                        readonly description: "API Base URL.";
+                        readonly showInDialog: true;
+                    };
+                    readonly model: {
+                        readonly type: "string";
+                        readonly label: "Model ID";
+                        readonly category: "Model";
+                        readonly requiresRestart: true;
+                        readonly default: string | undefined;
+                        readonly description: "The model ID (e.g. gpt-4, llama-3).";
+                        readonly showInDialog: true;
+                    };
+                    readonly auth: {
+                        readonly type: "object";
+                        readonly label: "Authentication";
+                        readonly category: "Model";
+                        readonly requiresRestart: true;
+                        readonly default: {};
+                        readonly description: "Authentication settings.";
+                        readonly showInDialog: false;
+                        readonly properties: {
+                            readonly type: {
+                                readonly type: "enum";
+                                readonly label: "Auth Type";
+                                readonly category: "Model";
+                                readonly requiresRestart: true;
+                                readonly default: "none";
+                                readonly options: readonly [{
+                                    readonly value: "none";
+                                    readonly label: "None";
+                                }, {
+                                    readonly value: "api-key";
+                                    readonly label: "API Key";
+                                }, {
+                                    readonly value: "bearer";
+                                    readonly label: "Bearer Token";
+                                }];
+                                readonly description: "Authentication type.";
+                                readonly showInDialog: true;
+                            };
+                            readonly envVarName: {
+                                readonly type: "string";
+                                readonly label: "API Key Env Var";
+                                readonly category: "Model";
+                                readonly requiresRestart: true;
+                                readonly default: string | undefined;
+                                readonly description: "Name of the environment variable for the API key.";
+                                readonly showInDialog: true;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
+    readonly model: {
+        readonly type: "object";
+        readonly label: "Model Selection";
+        readonly category: "Model";
+        readonly requiresRestart: true;
+        readonly default: {};
+        readonly description: "Select the primary model for completions.";
+        readonly showInDialog: false;
+        readonly properties: {
+            readonly name: {
+                readonly type: "string";
+                readonly label: "Model Name";
+                readonly category: "Model";
+                readonly requiresRestart: true;
+                readonly default: string;
+                readonly description: "The name of the model to use (e.g. gemini-1.5-pro, pro, auto).";
+                readonly showInDialog: true;
+            };
+            readonly summarizeToolOutput: {
+                readonly type: "object";
+                readonly label: "Summarize Tool Output";
+                readonly category: "Model";
+                readonly requiresRestart: false;
+                readonly default: Record<string, {
+                    tokenBudget?: number;
+                }> | undefined;
+                readonly description: string;
+                readonly showInDialog: false;
+                readonly additionalProperties: {
+                    readonly type: "object";
+                    readonly description: "Per-tool summarization settings with an optional tokenBudget.";
+                    readonly ref: "SummarizeToolOutputSettings";
+                };
+            };
+            readonly compressionThreshold: {
+                readonly type: "number";
+                readonly label: "Compression Threshold";
+                readonly category: "Model";
+                readonly requiresRestart: true;
+                readonly default: number;
+                readonly description: "The fraction of context usage at which to trigger context compression (e.g. 0.2, 0.3).";
+                readonly showInDialog: true;
+            };
+            readonly skipNextSpeakerCheck: {
+                readonly type: "boolean";
+                readonly label: "Skip Next Speaker Check";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: false;
+                readonly description: "Experimental: Skip the internal check for the next speaker in multi-turn conversations.";
+                readonly showInDialog: true;
+            };
+            readonly maxSessionTurns: {
+                readonly type: "number";
+                readonly label: "Max Session Turns";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: -1;
+                readonly description: "Maximum number of turns in a session (-1 for unlimited).";
+                readonly showInDialog: true;
+            };
+        };
+    };
+    readonly brain: {
+        readonly type: "object";
+        readonly label: "Brain";
+        readonly category: "Model";
+        readonly requiresRestart: false;
+        readonly default: {};
+        readonly description: "Special model authority configuration.";
+        readonly showInDialog: false;
+        readonly properties: {
+            readonly authority: {
+                readonly type: "enum";
+                readonly label: "Brain Authority";
+                readonly category: "Security";
+                readonly requiresRestart: true;
+                readonly default: "escalate-only";
+                readonly options: readonly [{
+                    readonly value: "escalate-only";
+                    readonly label: "Escalate Only";
+                }, {
+                    readonly value: "advisory";
+                    readonly label: "Advisory";
+                }, {
+                    readonly value: "governing";
+                    readonly label: "Governing";
+                }];
+                readonly description: "Controls how much the brain can raise approval review levels.";
+                readonly showInDialog: true;
+            };
+        };
+    };
+    readonly mcpServers: {
+        readonly type: "object";
+        readonly label: "MCP Servers";
+        readonly category: "Advanced";
+        readonly requiresRestart: true;
+        readonly default: Record<string, MCPServerConfig>;
+        readonly description: "Configuration for MCP servers.";
+        readonly showInDialog: false;
+        readonly mergeStrategy: MergeStrategy.SHALLOW_MERGE;
+        readonly additionalProperties: {
+            readonly type: "object";
+            readonly ref: "MCPServerConfig";
+        };
+    };
+    readonly general: {
+        readonly type: "object";
+        readonly label: "General";
+        readonly category: "General";
+        readonly requiresRestart: false;
+        readonly default: {};
+        readonly description: "General application settings.";
+        readonly showInDialog: false;
+        readonly properties: {
+            readonly previewFeatures: {
+                readonly type: "boolean";
+                readonly label: "Preview Features (e.g., models)";
+                readonly category: "General";
+                readonly requiresRestart: false;
+                readonly default: false;
+                readonly description: "Enable preview features (e.g., preview models).";
+                readonly showInDialog: true;
+            };
+            readonly preferredEditor: {
+                readonly type: "string";
+                readonly label: "Preferred Editor";
+                readonly category: "General";
+                readonly requiresRestart: false;
+                readonly default: string | undefined;
+                readonly description: "The preferred editor to open files in.";
+                readonly showInDialog: false;
+            };
+            readonly vimMode: {
+                readonly type: "boolean";
+                readonly label: "Vim Mode";
+                readonly category: "General";
+                readonly requiresRestart: false;
+                readonly default: false;
+                readonly description: "Enable Vim keybindings";
+                readonly showInDialog: true;
+            };
+            readonly disableAutoUpdate: {
+                readonly type: "boolean";
+                readonly label: "Disable Auto Update";
+                readonly category: "General";
+                readonly requiresRestart: false;
+                readonly default: false;
+                readonly description: "Disable automatic updates";
+                readonly showInDialog: true;
+            };
+            readonly disableUpdateNag: {
+                readonly type: "boolean";
+                readonly label: "Disable Update Nag";
+                readonly category: "General";
+                readonly requiresRestart: false;
+                readonly default: false;
+                readonly description: "Disable update notification prompts.";
+                readonly showInDialog: false;
+            };
+            readonly checkpointing: {
+                readonly type: "object";
+                readonly label: "Checkpointing";
+                readonly category: "General";
+                readonly requiresRestart: true;
+                readonly default: {};
+                readonly description: "Session checkpointing settings.";
+                readonly showInDialog: false;
+                readonly properties: {
+                    readonly enabled: {
+                        readonly type: "boolean";
+                        readonly label: "Enable Checkpointing";
+                        readonly category: "General";
+                        readonly requiresRestart: true;
+                        readonly default: false;
+                        readonly description: "Enable session checkpointing for recovery";
+                        readonly showInDialog: false;
+                    };
+                };
+            };
+            readonly enablePromptCompletion: {
+                readonly type: "boolean";
+                readonly label: "Enable Prompt Completion";
+                readonly category: "General";
+                readonly requiresRestart: true;
+                readonly default: false;
+                readonly description: "Enable AI-powered prompt completion suggestions while typing.";
+                readonly showInDialog: true;
+            };
+            readonly retryFetchErrors: {
+                readonly type: "boolean";
+                readonly label: "Retry Fetch Errors";
+                readonly category: "General";
+                readonly requiresRestart: false;
+                readonly default: false;
+                readonly description: "Retry on \"exception TypeError: fetch failed sending request\" errors.";
+                readonly showInDialog: false;
+            };
+            readonly debugKeystrokeLogging: {
+                readonly type: "boolean";
+                readonly label: "Debug Keystroke Logging";
+                readonly category: "General";
+                readonly requiresRestart: false;
+                readonly default: false;
+                readonly description: "Enable debug logging of keystrokes to the console.";
+                readonly showInDialog: true;
+            };
+            readonly sessionRetention: {
+                readonly type: "object";
+                readonly label: "Session Retention";
+                readonly category: "General";
+                readonly requiresRestart: false;
+                readonly default: SessionRetentionSettings | undefined;
+                readonly showInDialog: false;
+                readonly properties: {
+                    readonly enabled: {
+                        readonly type: "boolean";
+                        readonly label: "Enable Session Cleanup";
+                        readonly category: "General";
+                        readonly requiresRestart: false;
+                        readonly default: false;
+                        readonly description: "Enable automatic session cleanup";
+                        readonly showInDialog: true;
+                    };
+                    readonly maxAge: {
+                        readonly type: "string";
+                        readonly label: "Max Session Age";
+                        readonly category: "General";
+                        readonly requiresRestart: false;
+                        readonly default: string | undefined;
+                        readonly description: "Maximum age of sessions to keep (e.g., \"30d\", \"7d\", \"24h\", \"1w\")";
+                        readonly showInDialog: false;
+                    };
+                    readonly maxCount: {
+                        readonly type: "number";
+                        readonly label: "Max Session Count";
+                        readonly category: "General";
+                        readonly requiresRestart: false;
+                        readonly default: number | undefined;
+                        readonly description: "Alternative: Maximum number of sessions to keep (most recent)";
+                        readonly showInDialog: false;
+                    };
+                    readonly minRetention: {
+                        readonly type: "string";
+                        readonly label: "Min Retention Period";
+                        readonly category: "General";
+                        readonly requiresRestart: false;
+                        readonly default: string;
+                        readonly description: "Minimum retention period (safety limit, defaults to \"1d\")";
+                        readonly showInDialog: false;
+                    };
+                };
+                readonly description: "Settings for automatic session cleanup.";
+            };
+        };
+    };
+    readonly output: {
+        readonly type: "object";
+        readonly label: "Output";
+        readonly category: "General";
+        readonly requiresRestart: false;
+        readonly default: {};
+        readonly description: "Settings for the CLI output.";
+        readonly showInDialog: false;
+        readonly properties: {
+            readonly format: {
+                readonly type: "enum";
+                readonly label: "Output Format";
+                readonly category: "General";
+                readonly requiresRestart: false;
+                readonly default: "text";
+                readonly description: "The format of the CLI output.";
+                readonly showInDialog: true;
+                readonly options: readonly [{
+                    readonly value: "text";
+                    readonly label: "Text";
+                }, {
+                    readonly value: "json";
+                    readonly label: "JSON";
+                }];
+            };
+        };
+    };
+    readonly ui: {
+        readonly type: "object";
+        readonly label: "UI";
+        readonly category: "UI";
+        readonly requiresRestart: false;
+        readonly default: {};
+        readonly description: "User interface settings.";
+        readonly showInDialog: false;
+        readonly properties: {
+            readonly theme: {
+                readonly type: "string";
+                readonly label: "Theme";
+                readonly category: "UI";
+                readonly requiresRestart: false;
+                readonly default: string | undefined;
+                readonly description: "The color theme for the UI. See the CLI themes guide for available options.";
+                readonly showInDialog: false;
+            };
+            readonly customThemes: {
+                readonly type: "object";
+                readonly label: "Custom Themes";
+                readonly category: "UI";
+                readonly requiresRestart: false;
+                readonly default: Record<string, CustomTheme>;
+                readonly description: "Custom theme definitions.";
+                readonly showInDialog: false;
+                readonly additionalProperties: {
+                    readonly type: "object";
+                    readonly ref: "CustomTheme";
+                };
+            };
+            readonly hideWindowTitle: {
+                readonly type: "boolean";
+                readonly label: "Hide Window Title";
+                readonly category: "UI";
+                readonly requiresRestart: true;
+                readonly default: false;
+                readonly description: "Hide the window title bar";
+                readonly showInDialog: true;
+            };
+            readonly showStatusInTitle: {
+                readonly type: "boolean";
+                readonly label: "Show Status in Title";
+                readonly category: "UI";
+                readonly requiresRestart: false;
+                readonly default: false;
+                readonly description: "Show Gemini CLI status and thoughts in the terminal window title";
+                readonly showInDialog: true;
+            };
+            readonly hideTips: {
+                readonly type: "boolean";
+                readonly label: "Hide Tips";
+                readonly category: "UI";
+                readonly requiresRestart: false;
+                readonly default: false;
+                readonly description: "Hide helpful tips in the UI";
+                readonly showInDialog: true;
+            };
+            readonly hideBanner: {
+                readonly type: "boolean";
+                readonly label: "Hide Banner";
+                readonly category: "UI";
+                readonly requiresRestart: false;
+                readonly default: false;
+                readonly description: "Hide the application banner";
+                readonly showInDialog: true;
+            };
+            readonly hideContextSummary: {
+                readonly type: "boolean";
+                readonly label: "Hide Context Summary";
+                readonly category: "UI";
+                readonly requiresRestart: false;
+                readonly default: false;
+                readonly description: "Hide the context summary (terminaI.md, MCP servers) above the input.";
+                readonly showInDialog: true;
+            };
+            readonly footer: {
+                readonly type: "object";
+                readonly label: "Footer";
+                readonly category: "UI";
+                readonly requiresRestart: false;
+                readonly default: {};
+                readonly description: "Settings for the footer.";
+                readonly showInDialog: false;
+                readonly properties: {
+                    readonly hideCWD: {
+                        readonly type: "boolean";
+                        readonly label: "Hide CWD";
+                        readonly category: "UI";
+                        readonly requiresRestart: false;
+                        readonly default: false;
+                        readonly description: "Hide the current working directory path in the footer.";
+                        readonly showInDialog: true;
+                    };
+                    readonly hideSandboxStatus: {
+                        readonly type: "boolean";
+                        readonly label: "Hide Sandbox Status";
+                        readonly category: "UI";
+                        readonly requiresRestart: false;
+                        readonly default: false;
+                        readonly description: "Hide the sandbox status indicator in the footer.";
+                        readonly showInDialog: true;
+                    };
+                    readonly hideModelInfo: {
+                        readonly type: "boolean";
+                        readonly label: "Hide Model Info";
+                        readonly category: "UI";
+                        readonly requiresRestart: false;
+                        readonly default: false;
+                        readonly description: "Hide the model name and context usage in the footer.";
+                        readonly showInDialog: true;
+                    };
+                    readonly hideContextPercentage: {
+                        readonly type: "boolean";
+                        readonly label: "Hide Context Window Percentage";
+                        readonly category: "UI";
+                        readonly requiresRestart: false;
+                        readonly default: true;
+                        readonly description: "Hides the context window remaining percentage.";
+                        readonly showInDialog: true;
+                    };
+                };
+            };
+            readonly hideFooter: {
+                readonly type: "boolean";
+                readonly label: "Hide Footer";
+                readonly category: "UI";
+                readonly requiresRestart: false;
+                readonly default: false;
+                readonly description: "Hide the footer from the UI";
+                readonly showInDialog: true;
+            };
+            readonly showMemoryUsage: {
+                readonly type: "boolean";
+                readonly label: "Show Memory Usage";
+                readonly category: "UI";
+                readonly requiresRestart: false;
+                readonly default: false;
+                readonly description: "Display memory usage information in the UI";
+                readonly showInDialog: true;
+            };
+            readonly showLineNumbers: {
+                readonly type: "boolean";
+                readonly label: "Show Line Numbers";
+                readonly category: "UI";
+                readonly requiresRestart: false;
+                readonly default: true;
+                readonly description: "Show line numbers in the chat.";
+                readonly showInDialog: true;
+            };
+            readonly showCitations: {
+                readonly type: "boolean";
+                readonly label: "Show Citations";
+                readonly category: "UI";
+                readonly requiresRestart: false;
+                readonly default: false;
+                readonly description: "Show citations for generated text in the chat.";
+                readonly showInDialog: true;
+            };
+            readonly showModelInfoInChat: {
+                readonly type: "boolean";
+                readonly label: "Show Model Info In Chat";
+                readonly category: "UI";
+                readonly requiresRestart: false;
+                readonly default: false;
+                readonly description: "Show the model name in the chat for each model turn.";
+                readonly showInDialog: true;
+            };
+            readonly useFullWidth: {
+                readonly type: "boolean";
+                readonly label: "Use Full Width";
+                readonly category: "UI";
+                readonly requiresRestart: false;
+                readonly default: true;
+                readonly description: "Use the entire width of the terminal for output.";
+                readonly showInDialog: true;
+            };
+            readonly useAlternateBuffer: {
+                readonly type: "boolean";
+                readonly label: "Use Alternate Screen Buffer";
+                readonly category: "UI";
+                readonly requiresRestart: true;
+                readonly default: false;
+                readonly description: "Use an alternate screen buffer for the UI, preserving shell history.";
+                readonly showInDialog: true;
+            };
+            readonly incrementalRendering: {
+                readonly type: "boolean";
+                readonly label: "Incremental Rendering";
+                readonly category: "UI";
+                readonly requiresRestart: true;
+                readonly default: true;
+                readonly description: "Enable incremental rendering for the UI. This option will reduce flickering but may cause rendering artifacts. Only supported when useAlternateBuffer is enabled.";
+                readonly showInDialog: true;
+            };
+            readonly customWittyPhrases: {
+                readonly type: "array";
+                readonly label: "Custom Witty Phrases";
+                readonly category: "UI";
+                readonly requiresRestart: false;
+                readonly default: string[];
+                readonly description: string;
+                readonly showInDialog: false;
+                readonly items: {
+                    readonly type: "string";
+                };
+            };
+            readonly accessibility: {
+                readonly type: "object";
+                readonly label: "Accessibility";
+                readonly category: "UI";
+                readonly requiresRestart: true;
+                readonly default: {};
+                readonly description: "Accessibility settings.";
+                readonly showInDialog: false;
+                readonly properties: {
+                    readonly disableLoadingPhrases: {
+                        readonly type: "boolean";
+                        readonly label: "Disable Loading Phrases";
+                        readonly category: "UI";
+                        readonly requiresRestart: true;
+                        readonly default: false;
+                        readonly description: "Disable loading phrases for accessibility";
+                        readonly showInDialog: true;
+                    };
+                    readonly screenReader: {
+                        readonly type: "boolean";
+                        readonly label: "Screen Reader Mode";
+                        readonly category: "UI";
+                        readonly requiresRestart: true;
+                        readonly default: false;
+                        readonly description: "Render output in plain-text to be more screen reader accessible";
+                        readonly showInDialog: true;
+                    };
+                };
+            };
+        };
+    };
+    readonly voice: {
+        readonly type: "object";
+        readonly label: "Voice";
+        readonly category: "Voice";
+        readonly requiresRestart: false;
+        readonly default: {};
+        readonly description: "Voice mode settings.";
+        readonly showInDialog: false;
+        readonly properties: {
+            readonly enabled: {
+                readonly type: "boolean";
+                readonly label: "Enable Voice Mode";
+                readonly category: "Voice";
+                readonly requiresRestart: false;
+                readonly default: false;
+                readonly description: "Enable push-to-talk voice mode.";
+                readonly showInDialog: false;
+            };
+            readonly pushToTalk: {
+                readonly type: "object";
+                readonly label: "Push-to-Talk";
+                readonly category: "Voice";
+                readonly requiresRestart: false;
+                readonly default: {};
+                readonly description: "Push-to-talk key settings.";
+                readonly showInDialog: false;
+                readonly properties: {
+                    readonly key: {
+                        readonly type: "enum";
+                        readonly label: "Push-to-Talk Key";
+                        readonly category: "Voice";
+                        readonly requiresRestart: false;
+                        readonly default: "space";
+                        readonly description: "Key binding for push-to-talk.";
+                        readonly showInDialog: false;
+                        readonly options: readonly [{
+                            readonly value: "space";
+                            readonly label: "Space";
+                        }, {
+                            readonly value: "ctrl+space";
+                            readonly label: "Ctrl+Space";
+                        }];
+                    };
+                };
+            };
+            readonly spokenReply: {
+                readonly type: "object";
+                readonly label: "Spoken Reply";
+                readonly category: "Voice";
+                readonly requiresRestart: false;
+                readonly default: {};
+                readonly description: "Spoken reply settings.";
+                readonly showInDialog: false;
+                readonly properties: {
+                    readonly maxWords: {
+                        readonly type: "number";
+                        readonly label: "Max Words";
+                        readonly category: "Voice";
+                        readonly requiresRestart: false;
+                        readonly default: 30;
+                        readonly description: "Maximum words to speak in voice replies.";
+                        readonly showInDialog: false;
+                    };
+                };
+            };
+            readonly stt: {
+                readonly type: "object";
+                readonly label: "Speech-to-Text";
+                readonly category: "Voice";
+                readonly requiresRestart: false;
+                readonly default: {};
+                readonly description: "Speech-to-text provider settings.";
+                readonly showInDialog: false;
+                readonly properties: {
+                    readonly provider: {
+                        readonly type: "enum";
+                        readonly label: "STT Provider";
+                        readonly category: "Voice";
+                        readonly requiresRestart: false;
+                        readonly default: "auto";
+                        readonly description: "Speech-to-text provider.";
+                        readonly showInDialog: false;
+                        readonly options: readonly [{
+                            readonly value: "auto";
+                            readonly label: "Auto";
+                        }, {
+                            readonly value: "whispercpp";
+                            readonly label: "whisper.cpp";
+                        }, {
+                            readonly value: "none";
+                            readonly label: "None";
+                        }];
+                    };
+                    readonly whispercpp: {
+                        readonly type: "object";
+                        readonly label: "whisper.cpp";
+                        readonly category: "Voice";
+                        readonly requiresRestart: false;
+                        readonly default: {};
+                        readonly description: "whisper.cpp configuration overrides.";
+                        readonly showInDialog: false;
+                        readonly properties: {
+                            readonly binaryPath: {
+                                readonly type: "string";
+                                readonly label: "Binary Path";
+                                readonly category: "Voice";
+                                readonly requiresRestart: false;
+                                readonly default: string | undefined;
+                                readonly description: "Override path to the whisper.cpp binary.";
+                                readonly showInDialog: false;
+                            };
+                            readonly modelPath: {
+                                readonly type: "string";
+                                readonly label: "Model Path";
+                                readonly category: "Voice";
+                                readonly requiresRestart: false;
+                                readonly default: string | undefined;
+                                readonly description: "Override path to the whisper.cpp model file.";
+                                readonly showInDialog: false;
+                            };
+                            readonly device: {
+                                readonly type: "string";
+                                readonly label: "Input Device";
+                                readonly category: "Voice";
+                                readonly requiresRestart: false;
+                                readonly default: string | undefined;
+                                readonly description: "Optional microphone device name to pass to the recorder.";
+                                readonly showInDialog: false;
+                            };
+                        };
+                    };
+                };
+            };
+            readonly tts: {
+                readonly type: "object";
+                readonly label: "Text-to-Speech";
+                readonly category: "Voice";
+                readonly requiresRestart: false;
+                readonly default: {};
+                readonly description: "Text-to-speech provider settings.";
+                readonly showInDialog: false;
+                readonly properties: {
+                    readonly provider: {
+                        readonly type: "enum";
+                        readonly label: "TTS Provider";
+                        readonly category: "Voice";
+                        readonly requiresRestart: false;
+                        readonly default: "auto";
+                        readonly description: "Text-to-speech provider.";
+                        readonly showInDialog: false;
+                        readonly options: readonly [{
+                            readonly value: "auto";
+                            readonly label: "Auto";
+                        }, {
+                            readonly value: "openai";
+                            readonly label: "OpenAI";
+                        }, {
+                            readonly value: "elevenlabs";
+                            readonly label: "ElevenLabs";
+                        }, {
+                            readonly value: "none";
+                            readonly label: "None";
+                        }];
+                    };
+                    readonly voice: {
+                        readonly type: "string";
+                        readonly label: "Voice ID";
+                        readonly category: "Voice";
+                        readonly requiresRestart: false;
+                        readonly default: string | undefined;
+                        readonly description: "The voice ID to use for TTS.";
+                        readonly showInDialog: false;
+                    };
+                };
+            };
+        };
+    };
+    readonly mcp: {
+        readonly type: "object";
+        readonly label: "MCP";
+        readonly category: "MCP";
+        readonly requiresRestart: true;
+        readonly default: {};
+        readonly description: "Settings for Model Context Protocol (MCP) servers.";
+        readonly showInDialog: false;
+        readonly properties: {
+            readonly serverCommand: {
+                readonly type: "string";
+                readonly label: "MCP Server Command";
+                readonly category: "MCP";
+                readonly requiresRestart: true;
+                readonly default: string | undefined;
+                readonly description: "Command to start an MCP server.";
+                readonly showInDialog: false;
+            };
+            readonly allowed: {
+                readonly type: "array";
+                readonly label: "Allow MCP Servers";
+                readonly category: "MCP";
+                readonly requiresRestart: true;
+                readonly default: string[] | undefined;
+                readonly description: "A list of MCP servers to allow.";
+                readonly showInDialog: false;
+                readonly items: {
+                    readonly type: "string";
+                };
+            };
+            readonly excluded: {
+                readonly type: "array";
+                readonly label: "Exclude MCP Servers";
+                readonly category: "MCP";
+                readonly requiresRestart: true;
+                readonly default: string[] | undefined;
+                readonly description: "A list of MCP servers to exclude.";
+                readonly showInDialog: false;
+                readonly items: {
+                    readonly type: "string";
+                };
+            };
+        };
+    };
+    readonly useSmartEdit: {
+        readonly type: "boolean";
+        readonly label: "Use Smart Edit";
+        readonly category: "Advanced";
+        readonly requiresRestart: false;
+        readonly default: true;
+        readonly description: "Enable the smart-edit tool instead of the replace tool.";
+        readonly showInDialog: false;
+    };
+    readonly useWriteTodos: {
+        readonly type: "boolean";
+        readonly label: "Use WriteTodos";
+        readonly category: "Advanced";
+        readonly requiresRestart: false;
+        readonly default: true;
+        readonly description: "Enable the write_todos tool.";
+        readonly showInDialog: false;
+    };
+    readonly audit: {
+        readonly type: "object";
+        readonly label: "Audit";
+        readonly category: "Security";
+        readonly requiresRestart: true;
+        readonly default: {};
+        readonly description: "Audit logging configuration (cannot be disabled).";
+        readonly showInDialog: false;
+        readonly properties: {
+            readonly redactUiTypedText: {
+                readonly type: "boolean";
+                readonly label: "Redact UI typed text";
+                readonly category: "Security";
+                readonly requiresRestart: true;
+                readonly default: true;
+                readonly description: "Redact UI typed text in audit logs. Audit logging cannot be disabled.";
+                readonly showInDialog: true;
+            };
+            readonly retentionDays: {
+                readonly type: "number";
+                readonly label: "Audit retention (days)";
+                readonly category: "Security";
+                readonly requiresRestart: true;
+                readonly default: 30;
+                readonly description: "Retention window for audit logs (metadata only).";
+                readonly showInDialog: false;
+            };
+            readonly export: {
+                readonly type: "object";
+                readonly label: "Audit export";
+                readonly category: "Security";
+                readonly requiresRestart: false;
+                readonly default: {};
+                readonly description: "Export options for audit logs.";
+                readonly showInDialog: false;
+                readonly properties: {
+                    readonly format: {
+                        readonly type: "enum";
+                        readonly label: "Export format";
+                        readonly category: "Security";
+                        readonly requiresRestart: false;
+                        readonly default: "jsonl";
+                        readonly options: readonly [{
+                            readonly value: "jsonl";
+                            readonly label: "JSONL";
+                        }, {
+                            readonly value: "json";
+                            readonly label: "JSON";
+                        }];
+                        readonly description: "Format to use when exporting audit logs.";
+                        readonly showInDialog: true;
+                    };
+                    readonly redaction: {
+                        readonly type: "enum";
+                        readonly label: "Export redaction level";
+                        readonly category: "Security";
+                        readonly requiresRestart: false;
+                        readonly default: "enterprise";
+                        readonly options: readonly [{
+                            readonly value: "enterprise";
+                            readonly label: "Enterprise (metadata only)";
+                        }, {
+                            readonly value: "debug";
+                            readonly label: "Debug";
+                        }];
+                        readonly description: "Export redaction. Enterprise removes payloads; debug keeps more detail.";
+                        readonly showInDialog: true;
+                    };
+                };
+            };
+        };
+    };
+    readonly recipes: {
+        readonly type: "object";
+        readonly label: "Recipes";
+        readonly category: "Automation";
+        readonly requiresRestart: true;
+        readonly default: {};
+        readonly description: "Governed recipes configuration. Built-ins are always enabled; community recipes require confirmation.";
+        readonly showInDialog: false;
+        readonly properties: {
+            readonly paths: {
+                readonly type: "array";
+                readonly label: "Recipe directories";
+                readonly category: "Automation";
+                readonly requiresRestart: true;
+                readonly default: string[];
+                readonly description: "Additional directories to load user-authored recipes from.";
+                readonly showInDialog: false;
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly mergeStrategy: MergeStrategy.UNION;
+            };
+            readonly communityPaths: {
+                readonly type: "array";
+                readonly label: "Community recipe directories";
+                readonly category: "Automation";
+                readonly requiresRestart: true;
+                readonly default: string[];
+                readonly description: "Directories containing community recipes. These require confirmation before first use.";
+                readonly showInDialog: false;
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly mergeStrategy: MergeStrategy.UNION;
+            };
+            readonly allowCommunity: {
+                readonly type: "boolean";
+                readonly label: "Allow community recipes";
+                readonly category: "Automation";
+                readonly requiresRestart: true;
+                readonly default: false;
+                readonly description: "Enable loading community recipes. Community recipes still require first-load confirmation.";
+                readonly showInDialog: true;
+            };
+            readonly confirmCommunityOnFirstLoad: {
+                readonly type: "boolean";
+                readonly label: "Confirm community recipes on first load";
+                readonly category: "Automation";
+                readonly requiresRestart: true;
+                readonly default: true;
+                readonly description: "When enabled, the CLI will ask for confirmation the first time a community recipe is encountered.";
+                readonly showInDialog: true;
+            };
+            readonly trustedCommunityRecipes: {
+                readonly type: "array";
+                readonly label: "Trusted community recipes";
+                readonly category: "Automation";
+                readonly requiresRestart: true;
+                readonly default: string[];
+                readonly description: "Recipe IDs that have already been confirmed. These will not prompt again.";
+                readonly showInDialog: false;
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly mergeStrategy: MergeStrategy.UNION;
+            };
+        };
+    };
+    readonly advanced: {
+        readonly type: "object";
+        readonly label: "Advanced";
+        readonly category: "Advanced";
+        readonly requiresRestart: true;
+        readonly default: {};
+        readonly description: "Advanced settings for power users.";
+        readonly showInDialog: false;
+        readonly properties: {
+            readonly autoConfigureMemory: {
+                readonly type: "boolean";
+                readonly label: "Auto Configure Max Old Space Size";
+                readonly category: "Advanced";
+                readonly requiresRestart: true;
+                readonly default: false;
+                readonly description: "Automatically configure Node.js memory limits";
+                readonly showInDialog: false;
+            };
+            readonly dnsResolutionOrder: {
+                readonly type: "string";
+                readonly label: "DNS Resolution Order";
+                readonly category: "Advanced";
+                readonly requiresRestart: true;
+                readonly default: DnsResolutionOrder | undefined;
+                readonly description: "The DNS resolution order.";
+                readonly showInDialog: false;
+            };
+            readonly excludedEnvVars: {
+                readonly type: "array";
+                readonly label: "Excluded Project Environment Variables";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: string[];
+                readonly description: "Environment variables to exclude from project context.";
+                readonly showInDialog: false;
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly mergeStrategy: MergeStrategy.UNION;
+            };
+            readonly bugCommand: {
+                readonly type: "object";
+                readonly label: "Bug Command";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: BugCommandSettings | undefined;
+                readonly description: "Configuration for the bug report command.";
+                readonly showInDialog: false;
+                readonly ref: "BugCommandSettings";
+            };
+        };
+    };
+    readonly experimental: {
+        readonly type: "object";
+        readonly label: "Experimental";
+        readonly category: "Experimental";
+        readonly requiresRestart: true;
+        readonly default: {};
+        readonly description: "Setting to enable experimental features";
+        readonly showInDialog: false;
+        readonly properties: {
+            readonly enableAgents: {
+                readonly type: "boolean";
+                readonly label: "Enable Agents";
+                readonly category: "Experimental";
+                readonly requiresRestart: true;
+                readonly default: false;
+                readonly description: "Enable local and remote subagents. Warning: Experimental feature, uses YOLO mode for subagents";
+                readonly showInDialog: false;
+            };
+            readonly extensionManagement: {
+                readonly type: "boolean";
+                readonly label: "Extension Management";
+                readonly category: "Experimental";
+                readonly requiresRestart: true;
+                readonly default: true;
+                readonly description: "Enable extension management features.";
+                readonly showInDialog: false;
+            };
+            readonly extensionReloading: {
+                readonly type: "boolean";
+                readonly label: "Extension Reloading";
+                readonly category: "Experimental";
+                readonly requiresRestart: true;
+                readonly default: false;
+                readonly description: "Enables extension loading/unloading within the CLI session.";
+                readonly showInDialog: false;
+            };
+            readonly jitContext: {
+                readonly type: "boolean";
+                readonly label: "JIT Context Loading";
+                readonly category: "Experimental";
+                readonly requiresRestart: true;
+                readonly default: false;
+                readonly description: "Enable Just-In-Time (JIT) context loading.";
+                readonly showInDialog: false;
+            };
+            readonly codebaseInvestigatorSettings: {
+                readonly type: "object";
+                readonly label: "Codebase Investigator Settings";
+                readonly category: "Experimental";
+                readonly requiresRestart: true;
+                readonly default: {};
+                readonly description: "Configuration for Codebase Investigator.";
+                readonly showInDialog: false;
+                readonly properties: {
+                    readonly enabled: {
+                        readonly type: "boolean";
+                        readonly label: "Enable Codebase Investigator";
+                        readonly category: "Experimental";
+                        readonly requiresRestart: true;
+                        readonly default: true;
+                        readonly description: "Enable the Codebase Investigator agent.";
+                        readonly showInDialog: true;
+                    };
+                    readonly maxNumTurns: {
+                        readonly type: "number";
+                        readonly label: "Codebase Investigator Max Num Turns";
+                        readonly category: "Experimental";
+                        readonly requiresRestart: true;
+                        readonly default: 10;
+                        readonly description: "Maximum number of turns for the Codebase Investigator agent.";
+                        readonly showInDialog: true;
+                    };
+                    readonly maxTimeMinutes: {
+                        readonly type: "number";
+                        readonly label: "Max Time (Minutes)";
+                        readonly category: "Experimental";
+                        readonly requiresRestart: true;
+                        readonly default: 3;
+                        readonly description: "Maximum time for the Codebase Investigator agent (in minutes).";
+                        readonly showInDialog: false;
+                    };
+                    readonly thinkingBudget: {
+                        readonly type: "number";
+                        readonly label: "Thinking Budget";
+                        readonly category: "Experimental";
+                        readonly requiresRestart: true;
+                        readonly default: 8192;
+                        readonly description: "The thinking budget for the Codebase Investigator agent.";
+                        readonly showInDialog: false;
+                    };
+                    readonly model: {
+                        readonly type: "string";
+                        readonly label: "Model";
+                        readonly category: "Experimental";
+                        readonly requiresRestart: true;
+                        readonly default: "auto";
+                        readonly description: "The model to use for the Codebase Investigator agent.";
+                        readonly showInDialog: false;
+                    };
+                };
+            };
+            readonly introspectionAgentSettings: {
+                readonly type: "object";
+                readonly label: "Introspection Agent Settings";
+                readonly category: "Experimental";
+                readonly requiresRestart: true;
+                readonly default: {};
+                readonly description: "Configuration for Introspection Agent.";
+                readonly showInDialog: false;
+                readonly properties: {
+                    readonly enabled: {
+                        readonly type: "boolean";
+                        readonly label: "Enable Introspection Agent";
+                        readonly category: "Experimental";
+                        readonly requiresRestart: true;
+                        readonly default: false;
+                        readonly description: "Enable the Introspection Agent.";
+                        readonly showInDialog: true;
+                    };
+                };
+            };
+        };
+    };
+    readonly logs: {
+        readonly type: "object";
+        readonly label: "Logs";
+        readonly category: "General";
+        readonly requiresRestart: false;
+        readonly default: {};
+        readonly description: "Session logging and retention settings.";
+        readonly showInDialog: true;
+        readonly properties: {
+            readonly retention: {
+                readonly type: "object";
+                readonly label: "Retention";
+                readonly category: "General";
+                readonly requiresRestart: false;
+                readonly default: {};
+                readonly description: "Log retention settings.";
+                readonly showInDialog: true;
+                readonly properties: {
+                    readonly days: {
+                        readonly type: "number";
+                        readonly label: "Retention Days";
+                        readonly category: "General";
+                        readonly requiresRestart: false;
+                        readonly default: 7;
+                        readonly description: "Number of days to keep session logs.";
+                        readonly showInDialog: true;
+                    };
+                };
+            };
+        };
+    };
+    readonly extensions: {
+        readonly type: "object";
+        readonly label: "Extensions";
+        readonly category: "Extensions";
+        readonly requiresRestart: true;
+        readonly default: {};
+        readonly description: "Settings for extensions.";
+        readonly showInDialog: false;
+        readonly properties: {
+            readonly disabled: {
+                readonly type: "array";
+                readonly label: "Disabled Extensions";
+                readonly category: "Extensions";
+                readonly requiresRestart: true;
+                readonly default: string[];
+                readonly description: "List of disabled extensions.";
+                readonly showInDialog: false;
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly mergeStrategy: MergeStrategy.UNION;
+            };
+            readonly workspacesWithMigrationNudge: {
+                readonly type: "array";
+                readonly label: "Workspaces with Migration Nudge";
+                readonly category: "Extensions";
+                readonly requiresRestart: false;
+                readonly default: string[];
+                readonly description: "List of workspaces for which the migration nudge has been shown.";
+                readonly showInDialog: false;
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly mergeStrategy: MergeStrategy.UNION;
+            };
+        };
+    };
+    readonly tools: {
+        readonly type: "object";
+        readonly label: "Tools";
+        readonly category: "Tools";
+        readonly requiresRestart: false;
+        readonly default: {};
+        readonly description: "Configuration for tools.";
+        readonly showInDialog: false;
+        readonly properties: {
+            readonly useRipgrep: {
+                readonly type: "boolean";
+                readonly label: "Use Ripgrep";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: true;
+                readonly description: "Use ripgrep for file searching if available.";
+                readonly showInDialog: true;
+            };
+            readonly shell: {
+                readonly type: "object";
+                readonly label: "Shell";
+                readonly category: "Tools";
+                readonly requiresRestart: false;
+                readonly default: {};
+                readonly description: "Shell tool settings.";
+                readonly showInDialog: false;
+                readonly properties: {
+                    readonly enableInteractiveShell: {
+                        readonly type: "boolean";
+                        readonly label: "Enable Interactive Shell";
+                        readonly category: "Tools";
+                        readonly requiresRestart: false;
+                        readonly default: true;
+                        readonly description: "Allow interactive shell sessions.";
+                        readonly showInDialog: true;
+                    };
+                    readonly pager: {
+                        readonly type: "string";
+                        readonly label: "Pager";
+                        readonly category: "Tools";
+                        readonly requiresRestart: false;
+                        readonly default: string;
+                        readonly description: "The pager command to use for shell output. Defaults to `cat`.";
+                        readonly showInDialog: false;
+                    };
+                    readonly inactivityTimeout: {
+                        readonly type: "number";
+                        readonly label: "Inactivity Timeout";
+                        readonly category: "Tools";
+                        readonly requiresRestart: false;
+                        readonly default: 300;
+                        readonly description: "Timeout in seconds for inactive shell sessions.";
+                        readonly showInDialog: true;
+                    };
+                    readonly showColor: {
+                        readonly type: "boolean";
+                        readonly label: "Show Color";
+                        readonly category: "Tools";
+                        readonly requiresRestart: false;
+                        readonly default: true;
+                        readonly description: "Enable color output in shell.";
+                        readonly showInDialog: true;
+                    };
+                };
+            };
+            readonly truncateToolOutputThreshold: {
+                readonly type: "number";
+                readonly label: "Truncate Threshold";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: number;
+                readonly description: "Threshold for truncating tool output (characters).";
+                readonly showInDialog: true;
+            };
+            readonly truncateToolOutputLines: {
+                readonly type: "number";
+                readonly label: "Truncate Lines";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: number;
+                readonly description: "Number of lines to keep when truncating.";
+                readonly showInDialog: true;
+            };
+            readonly enableToolOutputTruncation: {
+                readonly type: "boolean";
+                readonly label: "Enable Truncation";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: true;
+                readonly description: "Automatically truncate very large tool outputs.";
+                readonly showInDialog: true;
+            };
+            readonly sandbox: {
+                readonly type: "string";
+                readonly label: "Sandbox";
+                readonly category: "Tools";
+                readonly requiresRestart: true;
+                readonly default: boolean | string | undefined;
+                readonly ref: "BooleanOrString";
+                readonly description: "Sandbox execution environment.";
+                readonly showInDialog: false;
+            };
+            readonly autoAccept: {
+                readonly type: "boolean";
+                readonly label: "Auto Accept";
+                readonly category: "Tools";
+                readonly requiresRestart: false;
+                readonly default: false;
+                readonly description: "Automatically accept safe tool calls.";
+                readonly showInDialog: true;
+            };
+            readonly core: {
+                readonly type: "array";
+                readonly label: "Core Tools";
+                readonly category: "Tools";
+                readonly requiresRestart: true;
+                readonly default: string[] | undefined;
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Restrict built-in tools.";
+                readonly showInDialog: false;
+            };
+            readonly repl: {
+                readonly type: "object";
+                readonly label: "REPL";
+                readonly category: "Tools";
+                readonly requiresRestart: false;
+                readonly default: {};
+                readonly description: "REPL tool settings.";
+                readonly showInDialog: false;
+                readonly properties: {
+                    readonly sandboxTier: {
+                        readonly type: "string";
+                        readonly label: "Sandbox Tier";
+                        readonly category: "Tools";
+                        readonly requiresRestart: true;
+                        readonly default: string;
+                        readonly description: "Sandbox tier for REPL execution (tier1=local, tier2=docker).";
+                        readonly showInDialog: true;
+                    };
+                    readonly timeoutSeconds: {
+                        readonly type: "number";
+                        readonly label: "Timeout";
+                        readonly category: "Tools";
+                        readonly requiresRestart: false;
+                        readonly default: number;
+                        readonly description: "Execution timeout in seconds.";
+                        readonly showInDialog: true;
+                    };
+                    readonly dockerImage: {
+                        readonly type: "string";
+                        readonly label: "Docker Image";
+                        readonly category: "Tools";
+                        readonly requiresRestart: true;
+                        readonly default: string | undefined;
+                        readonly description: "Docker image for REPL execution.";
+                        readonly showInDialog: true;
+                    };
+                };
+            };
+            readonly guiAutomation: {
+                readonly type: "object";
+                readonly label: "GUI Automation";
+                readonly category: "Tools";
+                readonly requiresRestart: false;
+                readonly default: {};
+                readonly description: "GUI automation settings.";
+                readonly showInDialog: false;
+                readonly properties: {
+                    readonly enabled: {
+                        readonly type: "boolean";
+                        readonly label: "Enable GUI Automation";
+                        readonly category: "Tools";
+                        readonly requiresRestart: true;
+                        readonly default: true;
+                        readonly description: "Enable desktop GUI automation tools.";
+                        readonly showInDialog: true;
+                    };
+                    readonly minReviewLevel: {
+                        readonly type: "enum";
+                        readonly label: "Min Review Level";
+                        readonly category: "Tools";
+                        readonly requiresRestart: false;
+                        readonly default: "B";
+                        readonly options: readonly [{
+                            readonly value: "A";
+                            readonly label: "A (Low)";
+                        }, {
+                            readonly value: "B";
+                            readonly label: "B (Medium)";
+                        }, {
+                            readonly value: "C";
+                            readonly label: "C (High)";
+                        }];
+                    };
+                    readonly clickMinReviewLevel: {
+                        readonly type: "enum";
+                        readonly label: "Click Min Review Level";
+                        readonly category: "Tools";
+                        readonly requiresRestart: false;
+                        readonly default: "B";
+                        readonly options: readonly [{
+                            readonly value: "A";
+                            readonly label: "A (Low)";
+                        }, {
+                            readonly value: "B";
+                            readonly label: "B (Medium)";
+                        }, {
+                            readonly value: "C";
+                            readonly label: "C (High)";
+                        }];
+                    };
+                    readonly typeMinReviewLevel: {
+                        readonly type: "enum";
+                        readonly label: "Type Min Review Level";
+                        readonly category: "Tools";
+                        readonly requiresRestart: false;
+                        readonly default: "B";
+                        readonly options: readonly [{
+                            readonly value: "A";
+                            readonly label: "A (Low)";
+                        }, {
+                            readonly value: "B";
+                            readonly label: "B (Medium)";
+                        }, {
+                            readonly value: "C";
+                            readonly label: "C (High)";
+                        }];
+                    };
+                    readonly redactTypedTextByDefault: {
+                        readonly type: "boolean";
+                        readonly label: "Redact Typed Text";
+                        readonly category: "Security";
+                        readonly requiresRestart: false;
+                        readonly default: true;
+                    };
+                    readonly snapshotMaxDepth: {
+                        readonly type: "number";
+                        readonly label: "Snapshot Max Depth";
+                        readonly category: "Advanced";
+                        readonly requiresRestart: false;
+                        readonly default: number;
+                    };
+                    readonly snapshotMaxNodes: {
+                        readonly type: "number";
+                        readonly label: "Snapshot Max Nodes";
+                        readonly category: "Advanced";
+                        readonly requiresRestart: false;
+                        readonly default: number;
+                    };
+                    readonly maxActionsPerMinute: {
+                        readonly type: "number";
+                        readonly label: "Max Actions Per Minute";
+                        readonly category: "Advanced";
+                        readonly requiresRestart: false;
+                        readonly default: number;
+                    };
+                };
+            };
+            readonly enableHooks: {
+                readonly type: "boolean";
+                readonly label: "Enable Hooks";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: true;
+                readonly description: "Enable custom hooks.";
+                readonly showInDialog: true;
+            };
+            readonly allowed: {
+                readonly type: "array";
+                readonly label: "Allowed Tools";
+                readonly category: "Security";
+                readonly requiresRestart: false;
+                readonly default: string[];
+                readonly description: "List of explicitly allowed tools.";
+                readonly showInDialog: false;
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly mergeStrategy: MergeStrategy.UNION;
+            };
+            readonly enableMessageBusIntegration: {
+                readonly type: "boolean";
+                readonly label: "Enable Message Bus";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: true;
+                readonly description: "Integrate with the system message bus.";
+                readonly showInDialog: true;
+            };
+            readonly exclude: {
+                readonly type: "array";
+                readonly label: "Excluded Tools";
+                readonly category: "Tools";
+                readonly requiresRestart: false;
+                readonly default: string[];
+                readonly description: "List of tools to exclude.";
+                readonly showInDialog: false;
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly mergeStrategy: MergeStrategy.UNION;
+            };
+        };
+    };
+    readonly privacy: {
+        readonly type: "object";
+        readonly label: "Privacy";
+        readonly category: "Security";
+        readonly requiresRestart: false;
+        readonly default: {};
+        readonly description: "Privacy settings.";
+        readonly showInDialog: false;
+        readonly properties: {
+            readonly usageStatisticsEnabled: {
+                readonly type: "boolean";
+                readonly label: "Usage Statistics";
+                readonly category: "Security";
+                readonly requiresRestart: false;
+                readonly default: true;
+                readonly description: "Help improve TerminaI by sending anonymous usage data.";
+                readonly showInDialog: true;
+            };
+        };
+    };
+    readonly hooks: {
+        readonly type: "object";
+        readonly label: "Hooks";
+        readonly category: "Advanced";
+        readonly requiresRestart: false;
+        readonly default: {};
+        readonly description: "Hook configurations for intercepting and customizing agent behavior.";
+        readonly showInDialog: false;
+        readonly properties: {
+            readonly disabled: {
+                readonly type: "array";
+                readonly label: "Disabled Hooks";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: string[];
+                readonly description: "List of hook names (commands) that should be disabled. Hooks in this list will not execute even if configured.";
+                readonly showInDialog: false;
+                readonly items: {
+                    readonly type: "string";
+                    readonly description: "Hook command name";
+                };
+                readonly mergeStrategy: MergeStrategy.UNION;
+            };
+            readonly BeforeTool: {
+                readonly type: "array";
+                readonly label: "Before Tool Hooks";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: [];
+                readonly description: "Hooks that execute before tool execution. Can intercept, validate, or modify tool calls.";
+                readonly showInDialog: false;
+                readonly ref: "HookDefinitionArray";
+                readonly mergeStrategy: MergeStrategy.CONCAT;
+            };
+            readonly AfterTool: {
+                readonly type: "array";
+                readonly label: "After Tool Hooks";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: [];
+                readonly description: "Hooks that execute after tool execution. Can process results, log outputs, or trigger follow-up actions.";
+                readonly showInDialog: false;
+                readonly ref: "HookDefinitionArray";
+                readonly mergeStrategy: MergeStrategy.CONCAT;
+            };
+            readonly BeforeAgent: {
+                readonly type: "array";
+                readonly label: "Before Agent Hooks";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: [];
+                readonly description: "Hooks that execute before agent loop starts. Can set up context or initialize resources.";
+                readonly showInDialog: false;
+                readonly ref: "HookDefinitionArray";
+                readonly mergeStrategy: MergeStrategy.CONCAT;
+            };
+            readonly AfterAgent: {
+                readonly type: "array";
+                readonly label: "After Agent Hooks";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: [];
+                readonly description: "Hooks that execute after agent loop completes. Can perform cleanup or summarize results.";
+                readonly showInDialog: false;
+                readonly ref: "HookDefinitionArray";
+                readonly mergeStrategy: MergeStrategy.CONCAT;
+            };
+            readonly Notification: {
+                readonly type: "array";
+                readonly label: "Notification Hooks";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: [];
+                readonly description: "Hooks that execute on notification events (errors, warnings, info). Can log or alert on specific conditions.";
+                readonly showInDialog: false;
+                readonly ref: "HookDefinitionArray";
+                readonly mergeStrategy: MergeStrategy.CONCAT;
+            };
+            readonly SessionStart: {
+                readonly type: "array";
+                readonly label: "Session Start Hooks";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: [];
+                readonly description: "Hooks that execute when a session starts. Can initialize session-specific resources or state.";
+                readonly showInDialog: false;
+                readonly ref: "HookDefinitionArray";
+                readonly mergeStrategy: MergeStrategy.CONCAT;
+            };
+            readonly SessionEnd: {
+                readonly type: "array";
+                readonly label: "Session End Hooks";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: [];
+                readonly description: "Hooks that execute when a session ends. Can perform cleanup or persist session data.";
+                readonly showInDialog: false;
+                readonly ref: "HookDefinitionArray";
+                readonly mergeStrategy: MergeStrategy.CONCAT;
+            };
+            readonly PreCompress: {
+                readonly type: "array";
+                readonly label: "Pre-Compress Hooks";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: [];
+                readonly description: "Hooks that execute before chat history compression. Can back up or analyze conversation before compression.";
+                readonly showInDialog: false;
+                readonly ref: "HookDefinitionArray";
+                readonly mergeStrategy: MergeStrategy.CONCAT;
+            };
+            readonly BeforeModel: {
+                readonly type: "array";
+                readonly label: "Before Model Hooks";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: [];
+                readonly description: "Hooks that execute before LLM requests. Can modify prompts, inject context, or control model parameters.";
+                readonly showInDialog: false;
+                readonly ref: "HookDefinitionArray";
+                readonly mergeStrategy: MergeStrategy.CONCAT;
+            };
+            readonly AfterModel: {
+                readonly type: "array";
+                readonly label: "After Model Hooks";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: [];
+                readonly description: "Hooks that execute after LLM responses. Can process outputs, extract information, or log interactions.";
+                readonly showInDialog: false;
+                readonly ref: "HookDefinitionArray";
+                readonly mergeStrategy: MergeStrategy.CONCAT;
+            };
+            readonly BeforeToolSelection: {
+                readonly type: "array";
+                readonly label: "Before Tool Selection Hooks";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: [];
+                readonly description: "Hooks that execute before tool selection. Can filter or prioritize available tools dynamically.";
+                readonly showInDialog: false;
+                readonly ref: "HookDefinitionArray";
+                readonly mergeStrategy: MergeStrategy.CONCAT;
+            };
+        };
+        readonly additionalProperties: {
+            readonly type: "array";
+            readonly description: "Custom hook event arrays that contain hook definitions for user-defined events";
+            readonly mergeStrategy: MergeStrategy.CONCAT;
+        };
+    };
+};
+export type SettingsSchemaType = typeof SETTINGS_SCHEMA;
+export declare function getSettingsSchema(): SettingsSchemaType;
+export type SettingsJsonSchemaDefinition = Record<string, unknown>;
+export declare const SETTINGS_SCHEMA_DEFINITIONS: Record<string, SettingsJsonSchemaDefinition>;
+export type InferSettings<T> = {
+    -readonly [K in keyof T]?: T[K] extends {
+        properties: infer P;
+    } ? InferSettings<P> : T[K] extends {
+        type: 'enum';
+        options: readonly SettingEnumOption[];
+    } ? T[K]['options'][number]['value'] : T[K] extends {
+        default: infer D;
+    } ? D extends boolean ? boolean : D : any;
+};
+export type Settings = InferSettings<SettingsSchemaType>;