@trukhinyuri/gemini-pp 0.27.0-nightly.20260121.97aac696f

package/dist/src/config/settingsSchema.js

@@ -0,0 +1,2005 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DEFAULT_TRUNCATE_TOOL_OUTPUT_LINES, DEFAULT_TRUNCATE_TOOL_OUTPUT_THRESHOLD, DEFAULT_MODEL_CONFIGS, } from '@google/gemini-cli-core';
+import { DEFAULT_MIN_RETENTION } from '../utils/sessionCleanup.js';
+/**
+ * Setting datatypes that "toggle" through a fixed list of options
+ * (e.g. an enum or true/false) rather than allowing for free form input
+ * (like a number or string).
+ */
+export const TOGGLE_TYPES = new Set([
+    'boolean',
+    'enum',
+]);
+function oneLine(strings, ...values) {
+    let result = '';
+    for (let i = 0; i < strings.length; i++) {
+        result += strings[i];
+        if (i < values.length) {
+            result += String(values[i]);
+        }
+    }
+    return result.replace(/\s+/g, ' ').trim();
+}
+export var MergeStrategy;
+(function (MergeStrategy) {
+    // Replace the old value with the new value. This is the default.
+    MergeStrategy["REPLACE"] = "replace";
+    // Concatenate arrays.
+    MergeStrategy["CONCAT"] = "concat";
+    // Merge arrays, ensuring unique values.
+    MergeStrategy["UNION"] = "union";
+    // Shallow merge objects.
+    MergeStrategy["SHALLOW_MERGE"] = "shallow_merge";
+})(MergeStrategy || (MergeStrategy = {}));
+/**
+ * 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.
+ */
+const SETTINGS_SCHEMA = {
+    // Maintained for compatibility/criticality
+    mcpServers: {
+        type: 'object',
+        label: 'MCP Servers',
+        category: 'Advanced',
+        requiresRestart: true,
+        default: {},
+        description: 'Configuration for MCP servers.',
+        showInDialog: false,
+        mergeStrategy: MergeStrategy.SHALLOW_MERGE,
+        additionalProperties: {
+            type: 'object',
+            ref: 'MCPServerConfig',
+        },
+    },
+    general: {
+        type: 'object',
+        label: 'General',
+        category: 'General',
+        requiresRestart: false,
+        default: {},
+        description: 'General application settings.',
+        showInDialog: false,
+        properties: {
+            previewFeatures: {
+                type: 'boolean',
+                label: 'Preview Features (e.g., models)',
+                category: 'General',
+                requiresRestart: false,
+                default: true,
+                description: 'Enable preview features (e.g., preview models).',
+                showInDialog: true,
+            },
+            preferredEditor: {
+                type: 'string',
+                label: 'Preferred Editor',
+                category: 'General',
+                requiresRestart: false,
+                default: undefined,
+                description: 'The preferred editor to open files in.',
+                showInDialog: false,
+            },
+            vimMode: {
+                type: 'boolean',
+                label: 'Vim Mode',
+                category: 'General',
+                requiresRestart: false,
+                default: false,
+                description: 'Enable Vim keybindings',
+                showInDialog: true,
+            },
+            enableAutoUpdate: {
+                type: 'boolean',
+                label: 'Enable Auto Update',
+                category: 'General',
+                requiresRestart: false,
+                default: true,
+                description: 'Enable automatic updates.',
+                showInDialog: true,
+            },
+            enableAutoUpdateNotification: {
+                type: 'boolean',
+                label: 'Enable Auto Update Notification',
+                category: 'General',
+                requiresRestart: false,
+                default: true,
+                description: 'Enable update notification prompts.',
+                showInDialog: false,
+            },
+            checkpointing: {
+                type: 'object',
+                label: 'Checkpointing',
+                category: 'General',
+                requiresRestart: true,
+                default: {},
+                description: 'Session checkpointing settings.',
+                showInDialog: false,
+                properties: {
+                    enabled: {
+                        type: 'boolean',
+                        label: 'Enable Checkpointing',
+                        category: 'General',
+                        requiresRestart: true,
+                        default: true,
+                        description: 'Enable session checkpointing for recovery',
+                        showInDialog: false,
+                    },
+                },
+            },
+            enablePromptCompletion: {
+                type: 'boolean',
+                label: 'Enable Prompt Completion',
+                category: 'General',
+                requiresRestart: true,
+                default: false,
+                description: 'Enable AI-powered prompt completion suggestions while typing.',
+                showInDialog: true,
+            },
+            retryFetchErrors: {
+                type: 'boolean',
+                label: 'Retry Fetch Errors',
+                category: 'General',
+                requiresRestart: false,
+                default: false,
+                description: 'Retry on "exception TypeError: fetch failed sending request" errors.',
+                showInDialog: false,
+            },
+            debugKeystrokeLogging: {
+                type: 'boolean',
+                label: 'Debug Keystroke Logging',
+                category: 'General',
+                requiresRestart: false,
+                default: false,
+                description: 'Enable debug logging of keystrokes to the console.',
+                showInDialog: true,
+            },
+            sessionRetention: {
+                type: 'object',
+                label: 'Session Retention',
+                category: 'General',
+                requiresRestart: false,
+                default: undefined,
+                showInDialog: false,
+                properties: {
+                    enabled: {
+                        type: 'boolean',
+                        label: 'Enable Session Cleanup',
+                        category: 'General',
+                        requiresRestart: false,
+                        default: true,
+                        description: 'Enable automatic session cleanup',
+                        showInDialog: true,
+                    },
+                    maxAge: {
+                        type: 'string',
+                        label: 'Max Session Age',
+                        category: 'General',
+                        requiresRestart: false,
+                        default: undefined,
+                        description: 'Maximum age of sessions to keep (e.g., "30d", "7d", "24h", "1w")',
+                        showInDialog: false,
+                    },
+                    maxCount: {
+                        type: 'number',
+                        label: 'Max Session Count',
+                        category: 'General',
+                        requiresRestart: false,
+                        default: undefined,
+                        description: 'Alternative: Maximum number of sessions to keep (most recent)',
+                        showInDialog: false,
+                    },
+                    minRetention: {
+                        type: 'string',
+                        label: 'Min Retention Period',
+                        category: 'General',
+                        requiresRestart: false,
+                        default: DEFAULT_MIN_RETENTION,
+                        description: `Minimum retention period (safety limit, defaults to "${DEFAULT_MIN_RETENTION}")`,
+                        showInDialog: false,
+                    },
+                },
+                description: 'Settings for automatic session cleanup.',
+            },
+        },
+    },
+    output: {
+        type: 'object',
+        label: 'Output',
+        category: 'General',
+        requiresRestart: false,
+        default: {},
+        description: 'Settings for the CLI output.',
+        showInDialog: false,
+        properties: {
+            format: {
+                type: 'enum',
+                label: 'Output Format',
+                category: 'General',
+                requiresRestart: false,
+                default: 'text',
+                description: 'The format of the CLI output. Can be `text` or `json`.',
+                showInDialog: true,
+                options: [
+                    { value: 'text', label: 'Text' },
+                    { value: 'json', label: 'JSON' },
+                ],
+            },
+        },
+    },
+    ui: {
+        type: 'object',
+        label: 'UI',
+        category: 'UI',
+        requiresRestart: false,
+        default: {},
+        description: 'User interface settings.',
+        showInDialog: false,
+        properties: {
+            theme: {
+                type: 'string',
+                label: 'Theme',
+                category: 'UI',
+                requiresRestart: false,
+                default: undefined,
+                description: 'The color theme for the UI. See the CLI themes guide for available options.',
+                showInDialog: false,
+            },
+            customThemes: {
+                type: 'object',
+                label: 'Custom Themes',
+                category: 'UI',
+                requiresRestart: false,
+                default: {},
+                description: 'Custom theme definitions.',
+                showInDialog: false,
+                additionalProperties: {
+                    type: 'object',
+                    ref: 'CustomTheme',
+                },
+            },
+            hideWindowTitle: {
+                type: 'boolean',
+                label: 'Hide Window Title',
+                category: 'UI',
+                requiresRestart: true,
+                default: false,
+                description: 'Hide the window title bar',
+                showInDialog: true,
+            },
+            showStatusInTitle: {
+                type: 'boolean',
+                label: 'Show Thoughts in Title',
+                category: 'UI',
+                requiresRestart: false,
+                default: false,
+                description: 'Show Gemini CLI model thoughts in the terminal window title during the working phase',
+                showInDialog: true,
+            },
+            dynamicWindowTitle: {
+                type: 'boolean',
+                label: 'Dynamic Window Title',
+                category: 'UI',
+                requiresRestart: false,
+                default: true,
+                description: 'Update the terminal window title with current status icons (Ready: ◇, Action Required: ✋, Working: ✦)',
+                showInDialog: true,
+            },
+            showHomeDirectoryWarning: {
+                type: 'boolean',
+                label: 'Show Home Directory Warning',
+                category: 'UI',
+                requiresRestart: true,
+                default: true,
+                description: 'Show a warning when running Gemini CLI in the home directory.',
+                showInDialog: true,
+            },
+            hideTips: {
+                type: 'boolean',
+                label: 'Hide Tips',
+                category: 'UI',
+                requiresRestart: false,
+                default: false,
+                description: 'Hide helpful tips in the UI',
+                showInDialog: true,
+            },
+            hideBanner: {
+                type: 'boolean',
+                label: 'Hide Banner',
+                category: 'UI',
+                requiresRestart: false,
+                default: false,
+                description: 'Hide the application banner',
+                showInDialog: true,
+            },
+            hideContextSummary: {
+                type: 'boolean',
+                label: 'Hide Context Summary',
+                category: 'UI',
+                requiresRestart: false,
+                default: false,
+                description: 'Hide the context summary (GEMINI.md, MCP servers) above the input.',
+                showInDialog: true,
+            },
+            footer: {
+                type: 'object',
+                label: 'Footer',
+                category: 'UI',
+                requiresRestart: false,
+                default: {},
+                description: 'Settings for the footer.',
+                showInDialog: false,
+                properties: {
+                    hideCWD: {
+                        type: 'boolean',
+                        label: 'Hide CWD',
+                        category: 'UI',
+                        requiresRestart: false,
+                        default: false,
+                        description: 'Hide the current working directory path in the footer.',
+                        showInDialog: true,
+                    },
+                    hideSandboxStatus: {
+                        type: 'boolean',
+                        label: 'Hide Sandbox Status',
+                        category: 'UI',
+                        requiresRestart: false,
+                        default: false,
+                        description: 'Hide the sandbox status indicator in the footer.',
+                        showInDialog: true,
+                    },
+                    hideModelInfo: {
+                        type: 'boolean',
+                        label: 'Hide Model Info',
+                        category: 'UI',
+                        requiresRestart: false,
+                        default: false,
+                        description: 'Hide the model name and context usage in the footer.',
+                        showInDialog: true,
+                    },
+                    hideContextPercentage: {
+                        type: 'boolean',
+                        label: 'Hide Context Window Percentage',
+                        category: 'UI',
+                        requiresRestart: false,
+                        default: true,
+                        description: 'Hides the context window remaining percentage.',
+                        showInDialog: true,
+                    },
+                },
+            },
+            hideFooter: {
+                type: 'boolean',
+                label: 'Hide Footer',
+                category: 'UI',
+                requiresRestart: false,
+                default: false,
+                description: 'Hide the footer from the UI',
+                showInDialog: true,
+            },
+            showMemoryUsage: {
+                type: 'boolean',
+                label: 'Show Memory Usage',
+                category: 'UI',
+                requiresRestart: false,
+                default: false,
+                description: 'Display memory usage information in the UI',
+                showInDialog: true,
+            },
+            showLineNumbers: {
+                type: 'boolean',
+                label: 'Show Line Numbers',
+                category: 'UI',
+                requiresRestart: false,
+                default: true,
+                description: 'Show line numbers in the chat.',
+                showInDialog: true,
+            },
+            showCitations: {
+                type: 'boolean',
+                label: 'Show Citations',
+                category: 'UI',
+                requiresRestart: false,
+                default: false,
+                description: 'Show citations for generated text in the chat.',
+                showInDialog: true,
+            },
+            showModelInfoInChat: {
+                type: 'boolean',
+                label: 'Show Model Info In Chat',
+                category: 'UI',
+                requiresRestart: false,
+                default: false,
+                description: 'Show the model name in the chat for each model turn.',
+                showInDialog: true,
+            },
+            useFullWidth: {
+                type: 'boolean',
+                label: 'Use Full Width',
+                category: 'UI',
+                requiresRestart: false,
+                default: true,
+                description: 'Use the entire width of the terminal for output.',
+                showInDialog: true,
+            },
+            useAlternateBuffer: {
+                type: 'boolean',
+                label: 'Use Alternate Screen Buffer',
+                category: 'UI',
+                requiresRestart: true,
+                default: false,
+                description: 'Use an alternate screen buffer for the UI, preserving shell history.',
+                showInDialog: true,
+            },
+            incrementalRendering: {
+                type: 'boolean',
+                label: 'Incremental Rendering',
+                category: 'UI',
+                requiresRestart: true,
+                default: true,
+                description: 'Enable incremental rendering for the UI. This option will reduce flickering but may cause rendering artifacts. Only supported when useAlternateBuffer is enabled.',
+                showInDialog: true,
+            },
+            customWittyPhrases: {
+                type: 'array',
+                label: 'Custom Witty Phrases',
+                category: 'UI',
+                requiresRestart: false,
+                default: [],
+                description: oneLine `
+          Custom witty phrases to display during loading.
+          When provided, the CLI cycles through these instead of the defaults.
+        `,
+                showInDialog: false,
+                items: { type: 'string' },
+            },
+            accessibility: {
+                type: 'object',
+                label: 'Accessibility',
+                category: 'UI',
+                requiresRestart: true,
+                default: {},
+                description: 'Accessibility settings.',
+                showInDialog: false,
+                properties: {
+                    enableLoadingPhrases: {
+                        type: 'boolean',
+                        label: 'Enable Loading Phrases',
+                        category: 'UI',
+                        requiresRestart: true,
+                        default: true,
+                        description: 'Enable loading phrases during operations.',
+                        showInDialog: true,
+                    },
+                    screenReader: {
+                        type: 'boolean',
+                        label: 'Screen Reader Mode',
+                        category: 'UI',
+                        requiresRestart: true,
+                        default: false,
+                        description: 'Render output in plain-text to be more screen reader accessible',
+                        showInDialog: true,
+                    },
+                },
+            },
+        },
+    },
+    ide: {
+        type: 'object',
+        label: 'IDE',
+        category: 'IDE',
+        requiresRestart: true,
+        default: {},
+        description: 'IDE integration settings.',
+        showInDialog: false,
+        properties: {
+            enabled: {
+                type: 'boolean',
+                label: 'IDE Mode',
+                category: 'IDE',
+                requiresRestart: true,
+                default: false,
+                description: 'Enable IDE integration mode.',
+                showInDialog: true,
+            },
+            hasSeenNudge: {
+                type: 'boolean',
+                label: 'Has Seen IDE Integration Nudge',
+                category: 'IDE',
+                requiresRestart: false,
+                default: false,
+                description: 'Whether the user has seen the IDE integration nudge.',
+                showInDialog: false,
+            },
+        },
+    },
+    privacy: {
+        type: 'object',
+        label: 'Privacy',
+        category: 'Privacy',
+        requiresRestart: true,
+        default: {},
+        description: 'Privacy-related settings.',
+        showInDialog: false,
+        properties: {
+            usageStatisticsEnabled: {
+                type: 'boolean',
+                label: 'Enable Usage Statistics',
+                category: 'Privacy',
+                requiresRestart: true,
+                default: true,
+                description: 'Enable collection of usage statistics',
+                showInDialog: false,
+            },
+        },
+    },
+    telemetry: {
+        type: 'object',
+        label: 'Telemetry',
+        category: 'Advanced',
+        requiresRestart: true,
+        default: undefined,
+        description: 'Telemetry configuration.',
+        showInDialog: false,
+        ref: 'TelemetrySettings',
+    },
+    model: {
+        type: 'object',
+        label: 'Model',
+        category: 'Model',
+        requiresRestart: false,
+        default: {},
+        description: 'Settings related to the generative model.',
+        showInDialog: false,
+        properties: {
+            name: {
+                type: 'string',
+                label: 'Model',
+                category: 'Model',
+                requiresRestart: false,
+                default: undefined,
+                description: 'The Gemini model to use for conversations.',
+                showInDialog: false,
+            },
+            maxSessionTurns: {
+                type: 'number',
+                label: 'Max Session Turns',
+                category: 'Model',
+                requiresRestart: false,
+                default: -1,
+                description: 'Maximum number of user/model/tool turns to keep in a session. -1 means unlimited.',
+                showInDialog: true,
+            },
+            summarizeToolOutput: {
+                type: 'object',
+                label: 'Summarize Tool Output',
+                category: 'Model',
+                requiresRestart: false,
+                default: undefined,
+                description: oneLine `
+          Enables or disables summarization of tool output.
+          Configure per-tool token budgets (for example {"run_shell_command": {"tokenBudget": 2000}}).
+          Currently only the run_shell_command tool supports summarization.
+        `,
+                showInDialog: false,
+                additionalProperties: {
+                    type: 'object',
+                    description: 'Per-tool summarization settings with an optional tokenBudget.',
+                    ref: 'SummarizeToolOutputSettings',
+                },
+            },
+            compressionThreshold: {
+                type: 'number',
+                label: 'Compression Threshold',
+                category: 'Model',
+                requiresRestart: true,
+                default: 0.5,
+                description: 'The fraction of context usage at which to trigger context compression (e.g. 0.2, 0.3).',
+                showInDialog: true,
+            },
+            skipNextSpeakerCheck: {
+                type: 'boolean',
+                label: 'Skip Next Speaker Check',
+                category: 'Model',
+                requiresRestart: false,
+                default: true,
+                description: 'Skip the next speaker check.',
+                showInDialog: true,
+            },
+        },
+    },
+    modelConfigs: {
+        type: 'object',
+        label: 'Model Configs',
+        category: 'Model',
+        requiresRestart: false,
+        default: DEFAULT_MODEL_CONFIGS,
+        description: 'Model configurations.',
+        showInDialog: false,
+        properties: {
+            aliases: {
+                type: 'object',
+                label: 'Model Config Aliases',
+                category: 'Model',
+                requiresRestart: false,
+                default: DEFAULT_MODEL_CONFIGS.aliases,
+                description: 'Named presets for model configs. Can be used in place of a model name and can inherit from other aliases using an `extends` property.',
+                showInDialog: false,
+            },
+            customAliases: {
+                type: 'object',
+                label: 'Custom Model Config Aliases',
+                category: 'Model',
+                requiresRestart: false,
+                default: {},
+                description: 'Custom named presets for model configs. These are merged with (and override) the built-in aliases.',
+                showInDialog: false,
+            },
+            customOverrides: {
+                type: 'array',
+                label: 'Custom Model Config Overrides',
+                category: 'Model',
+                requiresRestart: false,
+                default: [],
+                description: 'Custom model config overrides. These are merged with (and added to) the built-in overrides.',
+                showInDialog: false,
+            },
+            overrides: {
+                type: 'array',
+                label: 'Model Config Overrides',
+                category: 'Model',
+                requiresRestart: false,
+                default: [],
+                description: 'Apply specific configuration overrides based on matches, with a primary key of model (or alias). The most specific match will be used.',
+                showInDialog: false,
+            },
+        },
+    },
+    agents: {
+        type: 'object',
+        label: 'Agents',
+        category: 'Advanced',
+        requiresRestart: true,
+        default: {},
+        description: 'Settings for subagents.',
+        showInDialog: false,
+        properties: {
+            overrides: {
+                type: 'object',
+                label: 'Agent Overrides',
+                category: 'Advanced',
+                requiresRestart: true,
+                default: {},
+                description: 'Override settings for specific agents, e.g. to disable the agent, set a custom model config, or run config.',
+                showInDialog: false,
+                additionalProperties: {
+                    type: 'object',
+                    ref: 'AgentOverride',
+                },
+            },
+        },
+    },
+    context: {
+        type: 'object',
+        label: 'Context',
+        category: 'Context',
+        requiresRestart: false,
+        default: {},
+        description: 'Settings for managing context provided to the model.',
+        showInDialog: false,
+        properties: {
+            fileName: {
+                type: 'string',
+                label: 'Context File Name',
+                category: 'Context',
+                requiresRestart: false,
+                default: undefined,
+                ref: 'StringOrStringArray',
+                description: 'The name of the context file or files to load into memory. Accepts either a single string or an array of strings.',
+                showInDialog: false,
+            },
+            importFormat: {
+                type: 'string',
+                label: 'Memory Import Format',
+                category: 'Context',
+                requiresRestart: false,
+                default: undefined,
+                description: 'The format to use when importing memory.',
+                showInDialog: false,
+            },
+            discoveryMaxDirs: {
+                type: 'number',
+                label: 'Memory Discovery Max Dirs',
+                category: 'Context',
+                requiresRestart: false,
+                default: 200,
+                description: 'Maximum number of directories to search for memory.',
+                showInDialog: true,
+            },
+            includeDirectories: {
+                type: 'array',
+                label: 'Include Directories',
+                category: 'Context',
+                requiresRestart: false,
+                default: [],
+                description: oneLine `
+          Additional directories to include in the workspace context.
+          Missing directories will be skipped with a warning.
+        `,
+                showInDialog: false,
+                items: { type: 'string' },
+                mergeStrategy: MergeStrategy.CONCAT,
+            },
+            loadMemoryFromIncludeDirectories: {
+                type: 'boolean',
+                label: 'Load Memory From Include Directories',
+                category: 'Context',
+                requiresRestart: false,
+                default: false,
+                description: oneLine `
+          Controls how /memory refresh loads GEMINI.md files.
+          When true, include directories are scanned; when false, only the current directory is used.
+        `,
+                showInDialog: true,
+            },
+            fileFiltering: {
+                type: 'object',
+                label: 'File Filtering',
+                category: 'Context',
+                requiresRestart: true,
+                default: {},
+                description: 'Settings for git-aware file filtering.',
+                showInDialog: false,
+                properties: {
+                    respectGitIgnore: {
+                        type: 'boolean',
+                        label: 'Respect .gitignore',
+                        category: 'Context',
+                        requiresRestart: true,
+                        default: true,
+                        description: 'Respect .gitignore files when searching.',
+                        showInDialog: true,
+                    },
+                    respectGeminiIgnore: {
+                        type: 'boolean',
+                        label: 'Respect .geminiignore',
+                        category: 'Context',
+                        requiresRestart: true,
+                        default: true,
+                        description: 'Respect .geminiignore files when searching.',
+                        showInDialog: true,
+                    },
+                    enableRecursiveFileSearch: {
+                        type: 'boolean',
+                        label: 'Enable Recursive File Search',
+                        category: 'Context',
+                        requiresRestart: true,
+                        default: true,
+                        description: oneLine `
+              Enable recursive file search functionality when completing @ references in the prompt.
+            `,
+                        showInDialog: true,
+                    },
+                    enableFuzzySearch: {
+                        type: 'boolean',
+                        label: 'Enable Fuzzy Search',
+                        category: 'Context',
+                        requiresRestart: true,
+                        default: true,
+                        description: 'Enable fuzzy search when searching for files.',
+                        showInDialog: true,
+                    },
+                },
+            },
+        },
+    },
+    tools: {
+        type: 'object',
+        label: 'Tools',
+        category: 'Tools',
+        requiresRestart: true,
+        default: {},
+        description: 'Settings for built-in and custom tools.',
+        showInDialog: false,
+        properties: {
+            sandbox: {
+                type: 'string',
+                label: 'Sandbox',
+                category: 'Tools',
+                requiresRestart: true,
+                default: undefined,
+                ref: 'BooleanOrString',
+                description: oneLine `
+          Sandbox execution environment.
+          Set to a boolean to enable or disable the sandbox, or provide a string path to a sandbox profile.
+        `,
+                showInDialog: false,
+            },
+            shell: {
+                type: 'object',
+                label: 'Shell',
+                category: 'Tools',
+                requiresRestart: false,
+                default: {},
+                description: 'Settings for shell execution.',
+                showInDialog: false,
+                properties: {
+                    enableInteractiveShell: {
+                        type: 'boolean',
+                        label: 'Enable Interactive Shell',
+                        category: 'Tools',
+                        requiresRestart: true,
+                        default: true,
+                        description: oneLine `
+              Use node-pty for an interactive shell experience.
+              Fallback to child_process still applies.
+            `,
+                        showInDialog: true,
+                    },
+                    pager: {
+                        type: 'string',
+                        label: 'Pager',
+                        category: 'Tools',
+                        requiresRestart: false,
+                        default: 'cat',
+                        description: 'The pager command to use for shell output. Defaults to `cat`.',
+                        showInDialog: false,
+                    },
+                    showColor: {
+                        type: 'boolean',
+                        label: 'Show Color',
+                        category: 'Tools',
+                        requiresRestart: false,
+                        default: false,
+                        description: 'Show color in shell output.',
+                        showInDialog: true,
+                    },
+                    inactivityTimeout: {
+                        type: 'number',
+                        label: 'Inactivity Timeout',
+                        category: 'Tools',
+                        requiresRestart: false,
+                        default: 31536000000,
+                        description: 'The maximum time in seconds allowed without output from the shell command. Defaults to 5 minutes.',
+                        showInDialog: false,
+                    },
+                    enableShellOutputEfficiency: {
+                        type: 'boolean',
+                        label: 'Enable Shell Output Efficiency',
+                        category: 'Tools',
+                        requiresRestart: false,
+                        default: true,
+                        description: 'Enable shell output efficiency optimizations for better performance.',
+                        showInDialog: false,
+                    },
+                },
+            },
+            autoAccept: {
+                type: 'boolean',
+                label: 'Auto Accept',
+                category: 'Tools',
+                requiresRestart: false,
+                default: false,
+                description: oneLine `
+          Automatically accept and execute tool calls that are considered safe (e.g., read-only operations).
+        `,
+                showInDialog: true,
+            },
+            core: {
+                type: 'array',
+                label: 'Core Tools',
+                category: 'Tools',
+                requiresRestart: true,
+                default: undefined,
+                description: oneLine `
+          Restrict the set of built-in tools with an allowlist.
+          Match semantics mirror tools.allowed; see the built-in tools documentation for available names.
+        `,
+                showInDialog: false,
+                items: { type: 'string' },
+            },
+            allowed: {
+                type: 'array',
+                label: 'Allowed Tools',
+                category: 'Advanced',
+                requiresRestart: true,
+                default: undefined,
+                description: oneLine `
+          Tool names that bypass the confirmation dialog.
+          Useful for trusted commands (for example ["run_shell_command(git)", "run_shell_command(npm test)"]).
+          See shell tool command restrictions for matching details.
+        `,
+                showInDialog: false,
+                items: { type: 'string' },
+            },
+            exclude: {
+                type: 'array',
+                label: 'Exclude Tools',
+                category: 'Tools',
+                requiresRestart: true,
+                default: undefined,
+                description: 'Tool names to exclude from discovery.',
+                showInDialog: false,
+                items: { type: 'string' },
+                mergeStrategy: MergeStrategy.UNION,
+            },
+            discoveryCommand: {
+                type: 'string',
+                label: 'Tool Discovery Command',
+                category: 'Tools',
+                requiresRestart: true,
+                default: undefined,
+                description: 'Command to run for tool discovery.',
+                showInDialog: false,
+            },
+            callCommand: {
+                type: 'string',
+                label: 'Tool Call Command',
+                category: 'Tools',
+                requiresRestart: true,
+                default: undefined,
+                description: oneLine `
+          Defines a custom shell command for invoking discovered tools.
+          The command must take the tool name as the first argument, read JSON arguments from stdin, and emit JSON results on stdout.
+        `,
+                showInDialog: false,
+            },
+            useRipgrep: {
+                type: 'boolean',
+                label: 'Use Ripgrep',
+                category: 'Tools',
+                requiresRestart: false,
+                default: true,
+                description: 'Use ripgrep for file content search instead of the fallback implementation. Provides faster search performance.',
+                showInDialog: true,
+            },
+            enableToolOutputTruncation: {
+                type: 'boolean',
+                label: 'Enable Tool Output Truncation',
+                category: 'General',
+                requiresRestart: true,
+                default: true,
+                description: 'Enable truncation of large tool outputs.',
+                showInDialog: true,
+            },
+            truncateToolOutputThreshold: {
+                type: 'number',
+                label: 'Tool Output Truncation Threshold',
+                category: 'General',
+                requiresRestart: true,
+                default: DEFAULT_TRUNCATE_TOOL_OUTPUT_THRESHOLD,
+                description: 'Truncate tool output if it is larger than this many characters. Set to -1 to disable.',
+                showInDialog: true,
+            },
+            truncateToolOutputLines: {
+                type: 'number',
+                label: 'Tool Output Truncation Lines',
+                category: 'General',
+                requiresRestart: true,
+                default: DEFAULT_TRUNCATE_TOOL_OUTPUT_LINES,
+                description: 'The number of lines to keep when truncating tool output.',
+                showInDialog: true,
+            },
+            disableLLMCorrection: {
+                type: 'boolean',
+                label: 'Disable LLM Correction',
+                category: 'Tools',
+                requiresRestart: true,
+                default: true,
+                description: oneLine `
+          Disable LLM-based error correction for edit tools.
+          When enabled, tools will fail immediately if exact string matches are not found, instead of attempting to self-correct.
+        `,
+                showInDialog: true,
+            },
+            enableHooks: {
+                type: 'boolean',
+                label: 'Enable Hooks System (Experimental)',
+                category: 'Advanced',
+                requiresRestart: true,
+                default: true,
+                description: 'Enables the hooks system experiment. When disabled, the hooks system is completely deactivated regardless of other settings.',
+                showInDialog: false,
+            },
+        },
+    },
+    mcp: {
+        type: 'object',
+        label: 'MCP',
+        category: 'MCP',
+        requiresRestart: true,
+        default: {},
+        description: 'Settings for Model Context Protocol (MCP) servers.',
+        showInDialog: false,
+        properties: {
+            serverCommand: {
+                type: 'string',
+                label: 'MCP Server Command',
+                category: 'MCP',
+                requiresRestart: true,
+                default: undefined,
+                description: 'Command to start an MCP server.',
+                showInDialog: false,
+            },
+            allowed: {
+                type: 'array',
+                label: 'Allow MCP Servers',
+                category: 'MCP',
+                requiresRestart: true,
+                default: undefined,
+                description: 'A list of MCP servers to allow.',
+                showInDialog: false,
+                items: { type: 'string' },
+            },
+            excluded: {
+                type: 'array',
+                label: 'Exclude MCP Servers',
+                category: 'MCP',
+                requiresRestart: true,
+                default: undefined,
+                description: 'A list of MCP servers to exclude.',
+                showInDialog: false,
+                items: { type: 'string' },
+            },
+        },
+    },
+    useWriteTodos: {
+        type: 'boolean',
+        label: 'Use WriteTodos',
+        category: 'Advanced',
+        requiresRestart: false,
+        default: true,
+        description: 'Enable the write_todos tool.',
+        showInDialog: false,
+    },
+    security: {
+        type: 'object',
+        label: 'Security',
+        category: 'Security',
+        requiresRestart: true,
+        default: {},
+        description: 'Security-related settings.',
+        showInDialog: false,
+        properties: {
+            disableYoloMode: {
+                type: 'boolean',
+                label: 'Disable YOLO Mode',
+                category: 'Security',
+                requiresRestart: true,
+                default: false,
+                description: 'Disable YOLO mode, even if enabled by a flag.',
+                showInDialog: true,
+            },
+            enablePermanentToolApproval: {
+                type: 'boolean',
+                label: 'Allow Permanent Tool Approval',
+                category: 'Security',
+                requiresRestart: false,
+                default: false,
+                description: 'Enable the "Allow for all future sessions" option in tool confirmation dialogs.',
+                showInDialog: true,
+            },
+            blockGitExtensions: {
+                type: 'boolean',
+                label: 'Blocks extensions from Git',
+                category: 'Security',
+                requiresRestart: true,
+                default: false,
+                description: 'Blocks installing and loading extensions from Git.',
+                showInDialog: true,
+            },
+            folderTrust: {
+                type: 'object',
+                label: 'Folder Trust',
+                category: 'Security',
+                requiresRestart: false,
+                default: {},
+                description: 'Settings for folder trust.',
+                showInDialog: false,
+                properties: {
+                    enabled: {
+                        type: 'boolean',
+                        label: 'Folder Trust',
+                        category: 'Security',
+                        requiresRestart: true,
+                        default: false,
+                        description: 'Setting to track whether Folder trust is enabled.',
+                        showInDialog: true,
+                    },
+                },
+            },
+            environmentVariableRedaction: {
+                type: 'object',
+                label: 'Environment Variable Redaction',
+                category: 'Security',
+                requiresRestart: false,
+                default: {},
+                description: 'Settings for environment variable redaction.',
+                showInDialog: false,
+                properties: {
+                    allowed: {
+                        type: 'array',
+                        label: 'Allowed Environment Variables',
+                        category: 'Security',
+                        requiresRestart: true,
+                        default: [],
+                        description: 'Environment variables to always allow (bypass redaction).',
+                        showInDialog: false,
+                        items: { type: 'string' },
+                    },
+                    blocked: {
+                        type: 'array',
+                        label: 'Blocked Environment Variables',
+                        category: 'Security',
+                        requiresRestart: true,
+                        default: [],
+                        description: 'Environment variables to always redact.',
+                        showInDialog: false,
+                        items: { type: 'string' },
+                    },
+                    enabled: {
+                        type: 'boolean',
+                        label: 'Enable Environment Variable Redaction',
+                        category: 'Security',
+                        requiresRestart: true,
+                        default: false,
+                        description: 'Enable redaction of environment variables that may contain secrets.',
+                        showInDialog: true,
+                    },
+                },
+            },
+            auth: {
+                type: 'object',
+                label: 'Authentication',
+                category: 'Security',
+                requiresRestart: true,
+                default: {},
+                description: 'Authentication settings.',
+                showInDialog: false,
+                properties: {
+                    selectedType: {
+                        type: 'string',
+                        label: 'Selected Auth Type',
+                        category: 'Security',
+                        requiresRestart: true,
+                        default: undefined,
+                        description: 'The currently selected authentication type.',
+                        showInDialog: false,
+                    },
+                    enforcedType: {
+                        type: 'string',
+                        label: 'Enforced Auth Type',
+                        category: 'Advanced',
+                        requiresRestart: true,
+                        default: undefined,
+                        description: 'The required auth type. If this does not match the selected auth type, the user will be prompted to re-authenticate.',
+                        showInDialog: false,
+                    },
+                    useExternal: {
+                        type: 'boolean',
+                        label: 'Use External Auth',
+                        category: 'Security',
+                        requiresRestart: true,
+                        default: undefined,
+                        description: 'Whether to use an external authentication flow.',
+                        showInDialog: false,
+                    },
+                },
+            },
+        },
+    },
+    advanced: {
+        type: 'object',
+        label: 'Advanced',
+        category: 'Advanced',
+        requiresRestart: true,
+        default: {},
+        description: 'Advanced settings for power users.',
+        showInDialog: false,
+        properties: {
+            autoConfigureMemory: {
+                type: 'boolean',
+                label: 'Auto Configure Max Old Space Size',
+                category: 'Advanced',
+                requiresRestart: true,
+                default: false,
+                description: 'Automatically configure Node.js memory limits',
+                showInDialog: false,
+            },
+            dnsResolutionOrder: {
+                type: 'string',
+                label: 'DNS Resolution Order',
+                category: 'Advanced',
+                requiresRestart: true,
+                default: undefined,
+                description: 'The DNS resolution order.',
+                showInDialog: false,
+            },
+            excludedEnvVars: {
+                type: 'array',
+                label: 'Excluded Project Environment Variables',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: ['DEBUG', 'DEBUG_MODE'],
+                description: 'Environment variables to exclude from project context.',
+                showInDialog: false,
+                items: { type: 'string' },
+                mergeStrategy: MergeStrategy.UNION,
+            },
+            bugCommand: {
+                type: 'object',
+                label: 'Bug Command',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: undefined,
+                description: 'Configuration for the bug report command.',
+                showInDialog: false,
+                ref: 'BugCommandSettings',
+            },
+        },
+    },
+    experimental: {
+        type: 'object',
+        label: 'Experimental',
+        category: 'Experimental',
+        requiresRestart: true,
+        default: {},
+        description: 'Setting to enable experimental features',
+        showInDialog: false,
+        properties: {
+            enableAgents: {
+                type: 'boolean',
+                label: 'Enable Agents',
+                category: 'Experimental',
+                requiresRestart: true,
+                default: true,
+                description: 'Enable local and remote subagents. Warning: Experimental feature, uses YOLO mode for subagents',
+                showInDialog: false,
+            },
+            extensionManagement: {
+                type: 'boolean',
+                label: 'Extension Management',
+                category: 'Experimental',
+                requiresRestart: true,
+                default: true,
+                description: 'Enable extension management features.',
+                showInDialog: false,
+            },
+            extensionConfig: {
+                type: 'boolean',
+                label: 'Extension Configuration',
+                category: 'Experimental',
+                requiresRestart: true,
+                default: false,
+                description: 'Enable requesting and fetching of extension settings.',
+                showInDialog: false,
+            },
+            enableEventDrivenScheduler: {
+                type: 'boolean',
+                label: 'Event Driven Scheduler',
+                category: 'Experimental',
+                requiresRestart: true,
+                default: true,
+                description: 'Enables event-driven scheduler within the CLI session.',
+                showInDialog: false,
+            },
+            extensionReloading: {
+                type: 'boolean',
+                label: 'Extension Reloading',
+                category: 'Experimental',
+                requiresRestart: true,
+                default: false,
+                description: 'Enables extension loading/unloading within the CLI session.',
+                showInDialog: false,
+            },
+            jitContext: {
+                type: 'boolean',
+                label: 'JIT Context Loading',
+                category: 'Experimental',
+                requiresRestart: true,
+                default: false,
+                description: 'Enable Just-In-Time (JIT) context loading.',
+                showInDialog: false,
+            },
+            skills: {
+                type: 'boolean',
+                label: 'Agent Skills',
+                category: 'Experimental',
+                requiresRestart: true,
+                default: true,
+                description: 'Enable Agent Skills (experimental).',
+                showInDialog: true,
+            },
+            useOSC52Paste: {
+                type: 'boolean',
+                label: 'Use OSC 52 Paste',
+                category: 'Experimental',
+                requiresRestart: false,
+                default: false,
+                description: 'Use OSC 52 sequence for pasting instead of clipboardy (useful for remote sessions).',
+                showInDialog: true,
+            },
+            plan: {
+                type: 'boolean',
+                label: 'Plan',
+                category: 'Experimental',
+                requiresRestart: true,
+                default: false,
+                description: 'Enable planning features (Plan Mode and tools).',
+                showInDialog: true,
+            },
+        },
+    },
+    extensions: {
+        type: 'object',
+        label: 'Extensions',
+        category: 'Extensions',
+        requiresRestart: true,
+        default: {},
+        description: 'Settings for extensions.',
+        showInDialog: false,
+        properties: {
+            disabled: {
+                type: 'array',
+                label: 'Disabled Extensions',
+                category: 'Extensions',
+                requiresRestart: true,
+                default: [],
+                description: 'List of disabled extensions.',
+                showInDialog: false,
+                items: { type: 'string' },
+                mergeStrategy: MergeStrategy.UNION,
+            },
+            workspacesWithMigrationNudge: {
+                type: 'array',
+                label: 'Workspaces with Migration Nudge',
+                category: 'Extensions',
+                requiresRestart: false,
+                default: [],
+                description: 'List of workspaces for which the migration nudge has been shown.',
+                showInDialog: false,
+                items: { type: 'string' },
+                mergeStrategy: MergeStrategy.UNION,
+            },
+        },
+    },
+    skills: {
+        type: 'object',
+        label: 'Skills',
+        category: 'Advanced',
+        requiresRestart: true,
+        default: {},
+        description: 'Settings for agent skills.',
+        showInDialog: false,
+        properties: {
+            enabled: {
+                type: 'boolean',
+                label: 'Enable Agent Skills',
+                category: 'Advanced',
+                requiresRestart: true,
+                default: true,
+                description: 'Enable Agent Skills.',
+                showInDialog: true,
+                ignoreInDocs: true,
+            },
+            disabled: {
+                type: 'array',
+                label: 'Disabled Skills',
+                category: 'Advanced',
+                requiresRestart: true,
+                default: [],
+                description: 'List of disabled skills.',
+                showInDialog: false,
+                items: { type: 'string' },
+                mergeStrategy: MergeStrategy.UNION,
+            },
+        },
+    },
+    hooksConfig: {
+        type: 'object',
+        label: 'HooksConfig',
+        category: 'Advanced',
+        requiresRestart: false,
+        default: {},
+        description: 'Hook configurations for intercepting and customizing agent behavior.',
+        showInDialog: false,
+        properties: {
+            enabled: {
+                type: 'boolean',
+                label: 'Enable Hooks',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: true,
+                description: 'Canonical toggle for the hooks system. When disabled, no hooks will be executed.',
+                showInDialog: false,
+            },
+            disabled: {
+                type: 'array',
+                label: 'Disabled Hooks',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: [],
+                description: 'List of hook names (commands) that should be disabled. Hooks in this list will not execute even if configured.',
+                showInDialog: false,
+                items: {
+                    type: 'string',
+                    description: 'Hook command name',
+                },
+                mergeStrategy: MergeStrategy.UNION,
+            },
+            notifications: {
+                type: 'boolean',
+                label: 'Hook Notifications',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: true,
+                description: 'Show visual indicators when hooks are executing.',
+                showInDialog: true,
+            },
+        },
+    },
+    hooks: {
+        type: 'object',
+        label: 'Hook Events',
+        category: 'Advanced',
+        requiresRestart: false,
+        default: {},
+        description: 'Event-specific hook configurations.',
+        showInDialog: false,
+        properties: {
+            BeforeTool: {
+                type: 'array',
+                label: 'Before Tool Hooks',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: [],
+                description: 'Hooks that execute before tool execution. Can intercept, validate, or modify tool calls.',
+                showInDialog: false,
+                ref: 'HookDefinitionArray',
+                mergeStrategy: MergeStrategy.CONCAT,
+            },
+            AfterTool: {
+                type: 'array',
+                label: 'After Tool Hooks',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: [],
+                description: 'Hooks that execute after tool execution. Can process results, log outputs, or trigger follow-up actions.',
+                showInDialog: false,
+                ref: 'HookDefinitionArray',
+                mergeStrategy: MergeStrategy.CONCAT,
+            },
+            BeforeAgent: {
+                type: 'array',
+                label: 'Before Agent Hooks',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: [],
+                description: 'Hooks that execute before agent loop starts. Can set up context or initialize resources.',
+                showInDialog: false,
+                ref: 'HookDefinitionArray',
+                mergeStrategy: MergeStrategy.CONCAT,
+            },
+            AfterAgent: {
+                type: 'array',
+                label: 'After Agent Hooks',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: [],
+                description: 'Hooks that execute after agent loop completes. Can perform cleanup or summarize results.',
+                showInDialog: false,
+                ref: 'HookDefinitionArray',
+                mergeStrategy: MergeStrategy.CONCAT,
+            },
+            Notification: {
+                type: 'array',
+                label: 'Notification Hooks',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: [],
+                description: 'Hooks that execute on notification events (errors, warnings, info). Can log or alert on specific conditions.',
+                showInDialog: false,
+                ref: 'HookDefinitionArray',
+                mergeStrategy: MergeStrategy.CONCAT,
+            },
+            SessionStart: {
+                type: 'array',
+                label: 'Session Start Hooks',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: [],
+                description: 'Hooks that execute when a session starts. Can initialize session-specific resources or state.',
+                showInDialog: false,
+                ref: 'HookDefinitionArray',
+                mergeStrategy: MergeStrategy.CONCAT,
+            },
+            SessionEnd: {
+                type: 'array',
+                label: 'Session End Hooks',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: [],
+                description: 'Hooks that execute when a session ends. Can perform cleanup or persist session data.',
+                showInDialog: false,
+                ref: 'HookDefinitionArray',
+                mergeStrategy: MergeStrategy.CONCAT,
+            },
+            PreCompress: {
+                type: 'array',
+                label: 'Pre-Compress Hooks',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: [],
+                description: 'Hooks that execute before chat history compression. Can back up or analyze conversation before compression.',
+                showInDialog: false,
+                ref: 'HookDefinitionArray',
+                mergeStrategy: MergeStrategy.CONCAT,
+            },
+            BeforeModel: {
+                type: 'array',
+                label: 'Before Model Hooks',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: [],
+                description: 'Hooks that execute before LLM requests. Can modify prompts, inject context, or control model parameters.',
+                showInDialog: false,
+                ref: 'HookDefinitionArray',
+                mergeStrategy: MergeStrategy.CONCAT,
+            },
+            AfterModel: {
+                type: 'array',
+                label: 'After Model Hooks',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: [],
+                description: 'Hooks that execute after LLM responses. Can process outputs, extract information, or log interactions.',
+                showInDialog: false,
+                ref: 'HookDefinitionArray',
+                mergeStrategy: MergeStrategy.CONCAT,
+            },
+            BeforeToolSelection: {
+                type: 'array',
+                label: 'Before Tool Selection Hooks',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: [],
+                description: 'Hooks that execute before tool selection. Can filter or prioritize available tools dynamically.',
+                showInDialog: false,
+                ref: 'HookDefinitionArray',
+                mergeStrategy: MergeStrategy.CONCAT,
+            },
+        },
+        additionalProperties: {
+            type: 'array',
+            description: 'Custom hook event arrays that contain hook definitions for user-defined events',
+            mergeStrategy: MergeStrategy.CONCAT,
+        },
+    },
+    admin: {
+        type: 'object',
+        label: 'Admin',
+        category: 'Admin',
+        requiresRestart: false,
+        default: {},
+        description: 'Settings configured remotely by enterprise admins.',
+        showInDialog: false,
+        mergeStrategy: MergeStrategy.REPLACE,
+        properties: {
+            secureModeEnabled: {
+                type: 'boolean',
+                label: 'Secure Mode Enabled',
+                category: 'Admin',
+                requiresRestart: false,
+                default: false,
+                description: 'If true, disallows yolo mode from being used.',
+                showInDialog: false,
+                mergeStrategy: MergeStrategy.REPLACE,
+            },
+            extensions: {
+                type: 'object',
+                label: 'Extensions Settings',
+                category: 'Admin',
+                requiresRestart: false,
+                default: {},
+                description: 'Extensions-specific admin settings.',
+                showInDialog: false,
+                mergeStrategy: MergeStrategy.REPLACE,
+                properties: {
+                    enabled: {
+                        type: 'boolean',
+                        label: 'Extensions Enabled',
+                        category: 'Admin',
+                        requiresRestart: false,
+                        default: true,
+                        description: 'If false, disallows extensions from being installed or used.',
+                        showInDialog: false,
+                        mergeStrategy: MergeStrategy.REPLACE,
+                    },
+                },
+            },
+            mcp: {
+                type: 'object',
+                label: 'MCP Settings',
+                category: 'Admin',
+                requiresRestart: false,
+                default: {},
+                description: 'MCP-specific admin settings.',
+                showInDialog: false,
+                mergeStrategy: MergeStrategy.REPLACE,
+                properties: {
+                    enabled: {
+                        type: 'boolean',
+                        label: 'MCP Enabled',
+                        category: 'Admin',
+                        requiresRestart: false,
+                        default: true,
+                        description: 'If false, disallows MCP servers from being used.',
+                        showInDialog: false,
+                        mergeStrategy: MergeStrategy.REPLACE,
+                    },
+                },
+            },
+            skills: {
+                type: 'object',
+                label: 'Skills Settings',
+                category: 'Admin',
+                requiresRestart: false,
+                default: {},
+                description: 'Agent Skills-specific admin settings.',
+                showInDialog: false,
+                mergeStrategy: MergeStrategy.REPLACE,
+                properties: {
+                    enabled: {
+                        type: 'boolean',
+                        label: 'Skills Enabled',
+                        category: 'Admin',
+                        requiresRestart: false,
+                        default: true,
+                        description: 'If false, disallows agent skills from being used.',
+                        showInDialog: false,
+                        mergeStrategy: MergeStrategy.REPLACE,
+                    },
+                },
+            },
+        },
+    },
+};
+export const SETTINGS_SCHEMA_DEFINITIONS = {
+    MCPServerConfig: {
+        type: 'object',
+        description: 'Definition of a Model Context Protocol (MCP) server configuration.',
+        additionalProperties: false,
+        properties: {
+            command: {
+                type: 'string',
+                description: 'Executable invoked for stdio transport.',
+            },
+            args: {
+                type: 'array',
+                description: 'Command-line arguments for the stdio transport command.',
+                items: { type: 'string' },
+            },
+            env: {
+                type: 'object',
+                description: 'Environment variables to set for the server process.',
+                additionalProperties: { type: 'string' },
+            },
+            cwd: {
+                type: 'string',
+                description: 'Working directory for the server process.',
+            },
+            url: {
+                type: 'string',
+                description: 'URL for SSE or HTTP transport. Use with "type" field to specify transport type.',
+            },
+            httpUrl: {
+                type: 'string',
+                description: 'Streaming HTTP transport URL.',
+            },
+            headers: {
+                type: 'object',
+                description: 'Additional HTTP headers sent to the server.',
+                additionalProperties: { type: 'string' },
+            },
+            tcp: {
+                type: 'string',
+                description: 'TCP address for websocket transport.',
+            },
+            type: {
+                type: 'string',
+                description: 'Transport type. Use "stdio" for local command, "sse" for Server-Sent Events, or "http" for Streamable HTTP.',
+                enum: ['stdio', 'sse', 'http'],
+            },
+            timeout: {
+                type: 'number',
+                description: 'Timeout in milliseconds for MCP requests.',
+            },
+            trust: {
+                type: 'boolean',
+                description: 'Marks the server as trusted. Trusted servers may gain additional capabilities.',
+            },
+            description: {
+                type: 'string',
+                description: 'Human-readable description of the server.',
+            },
+            includeTools: {
+                type: 'array',
+                description: 'Subset of tools that should be enabled for this server. When omitted all tools are enabled.',
+                items: { type: 'string' },
+            },
+            excludeTools: {
+                type: 'array',
+                description: 'Tools that should be disabled for this server even if exposed.',
+                items: { type: 'string' },
+            },
+            extension: {
+                type: 'object',
+                description: 'Metadata describing the Gemini CLI extension that owns this MCP server.',
+                additionalProperties: { type: ['string', 'boolean', 'number'] },
+            },
+            oauth: {
+                type: 'object',
+                description: 'OAuth configuration for authenticating with the server.',
+                additionalProperties: true,
+            },
+            authProviderType: {
+                type: 'string',
+                description: 'Authentication provider used for acquiring credentials (for example `dynamic_discovery`).',
+                enum: [
+                    'dynamic_discovery',
+                    'google_credentials',
+                    'service_account_impersonation',
+                ],
+            },
+            targetAudience: {
+                type: 'string',
+                description: 'OAuth target audience (CLIENT_ID.apps.googleusercontent.com).',
+            },
+            targetServiceAccount: {
+                type: 'string',
+                description: 'Service account email to impersonate (name@project.iam.gserviceaccount.com).',
+            },
+        },
+    },
+    TelemetrySettings: {
+        type: 'object',
+        description: 'Telemetry configuration for Gemini CLI.',
+        additionalProperties: false,
+        properties: {
+            enabled: {
+                type: 'boolean',
+                description: 'Enables telemetry emission.',
+            },
+            target: {
+                type: 'string',
+                description: 'Telemetry destination (for example `stderr`, `stdout`, or `otlp`).',
+            },
+            otlpEndpoint: {
+                type: 'string',
+                description: 'Endpoint for OTLP exporters.',
+            },
+            otlpProtocol: {
+                type: 'string',
+                description: 'Protocol for OTLP exporters.',
+                enum: ['grpc', 'http'],
+            },
+            logPrompts: {
+                type: 'boolean',
+                description: 'Whether prompts are logged in telemetry payloads.',
+            },
+            outfile: {
+                type: 'string',
+                description: 'File path for writing telemetry output.',
+            },
+            useCollector: {
+                type: 'boolean',
+                description: 'Whether to forward telemetry to an OTLP collector.',
+            },
+            useCliAuth: {
+                type: 'boolean',
+                description: 'Whether to use CLI authentication for telemetry (only for in-process exporters).',
+            },
+        },
+    },
+    BugCommandSettings: {
+        type: 'object',
+        description: 'Configuration for the bug report helper command.',
+        additionalProperties: false,
+        properties: {
+            urlTemplate: {
+                type: 'string',
+                description: 'Template used to open a bug report URL. Variables in the template are populated at runtime.',
+            },
+        },
+        required: ['urlTemplate'],
+    },
+    SummarizeToolOutputSettings: {
+        type: 'object',
+        description: 'Controls summarization behavior for individual tools. All properties are optional.',
+        additionalProperties: false,
+        properties: {
+            tokenBudget: {
+                type: 'number',
+                description: 'Maximum number of tokens used when summarizing tool output.',
+            },
+        },
+    },
+    AgentOverride: {
+        type: 'object',
+        description: 'Override settings for a specific agent.',
+        additionalProperties: false,
+        properties: {
+            modelConfig: {
+                type: 'object',
+                additionalProperties: true,
+            },
+            runConfig: {
+                type: 'object',
+                description: 'Run configuration for an agent.',
+                additionalProperties: false,
+                properties: {
+                    maxTimeMinutes: {
+                        type: 'number',
+                        description: 'The maximum execution time for the agent in minutes.',
+                    },
+                    maxTurns: {
+                        type: 'number',
+                        description: 'The maximum number of conversational turns.',
+                    },
+                },
+            },
+            enabled: {
+                type: 'boolean',
+                description: 'Whether to enable the agent.',
+            },
+        },
+    },
+    CustomTheme: {
+        type: 'object',
+        description: 'Custom theme definition used for styling Gemini CLI output. Colors are provided as hex strings or named ANSI colors.',
+        additionalProperties: false,
+        properties: {
+            type: {
+                type: 'string',
+                enum: ['custom'],
+                default: 'custom',
+            },
+            name: {
+                type: 'string',
+                description: 'Theme display name.',
+            },
+            text: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    primary: { type: 'string' },
+                    secondary: { type: 'string' },
+                    link: { type: 'string' },
+                    accent: { type: 'string' },
+                },
+            },
+            background: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    primary: { type: 'string' },
+                    diff: {
+                        type: 'object',
+                        additionalProperties: false,
+                        properties: {
+                            added: { type: 'string' },
+                            removed: { type: 'string' },
+                        },
+                    },
+                },
+            },
+            border: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    default: { type: 'string' },
+                    focused: { type: 'string' },
+                },
+            },
+            ui: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    comment: { type: 'string' },
+                    symbol: { type: 'string' },
+                    gradient: {
+                        type: 'array',
+                        items: { type: 'string' },
+                    },
+                },
+            },
+            status: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    error: { type: 'string' },
+                    success: { type: 'string' },
+                    warning: { type: 'string' },
+                },
+            },
+            Background: { type: 'string' },
+            Foreground: { type: 'string' },
+            LightBlue: { type: 'string' },
+            AccentBlue: { type: 'string' },
+            AccentPurple: { type: 'string' },
+            AccentCyan: { type: 'string' },
+            AccentGreen: { type: 'string' },
+            AccentYellow: { type: 'string' },
+            AccentRed: { type: 'string' },
+            DiffAdded: { type: 'string' },
+            DiffRemoved: { type: 'string' },
+            Comment: { type: 'string' },
+            Gray: { type: 'string' },
+            DarkGray: { type: 'string' },
+            GradientColors: {
+                type: 'array',
+                items: { type: 'string' },
+            },
+        },
+        required: ['type', 'name'],
+    },
+    StringOrStringArray: {
+        description: 'Accepts either a single string or an array of strings.',
+        anyOf: [{ type: 'string' }, { type: 'array', items: { type: 'string' } }],
+    },
+    BooleanOrString: {
+        description: 'Accepts either a boolean flag or a string command name.',
+        anyOf: [{ type: 'boolean' }, { type: 'string' }],
+    },
+    HookDefinitionArray: {
+        type: 'array',
+        description: 'Array of hook definition objects for a specific event.',
+        items: {
+            type: 'object',
+            description: 'Hook definition specifying matcher pattern and hook configurations.',
+            properties: {
+                matcher: {
+                    type: 'string',
+                    description: 'Pattern to match against the event context (tool name, notification type, etc.). Supports exact match, regex (/pattern/), and wildcards (*).',
+                },
+                hooks: {
+                    type: 'array',
+                    description: 'Hooks to execute when the matcher matches.',
+                    items: {
+                        type: 'object',
+                        description: 'Individual hook configuration.',
+                        properties: {
+                            name: {
+                                type: 'string',
+                                description: 'Unique identifier for the hook.',
+                            },
+                            type: {
+                                type: 'string',
+                                description: 'Type of hook (currently only "command" supported).',
+                            },
+                            command: {
+                                type: 'string',
+                                description: 'Shell command to execute. Receives JSON input via stdin and returns JSON output via stdout.',
+                            },
+                            description: {
+                                type: 'string',
+                                description: 'A description of the hook.',
+                            },
+                            timeout: {
+                                type: 'number',
+                                description: 'Timeout in milliseconds for hook execution.',
+                            },
+                        },
+                    },
+                },
+            },
+        },
+    },
+};
+export function getSettingsSchema() {
+    return SETTINGS_SCHEMA;
+}
+//# sourceMappingURL=settingsSchema.js.map