@papert-code/papert-code 0.2.3 → 0.2.4

package/dist/src/config/settingsSchema.js

@@ -0,0 +1,1101 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ApprovalMode, DEFAULT_TRUNCATE_TOOL_OUTPUT_LINES, DEFAULT_TRUNCATE_TOOL_OUTPUT_THRESHOLD, } from '@papert-code/papert-code-core';
+/**
+ * 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',
+]);
+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,
+    },
+    general: {
+        type: 'object',
+        label: 'General',
+        category: 'General',
+        requiresRestart: false,
+        default: {},
+        description: 'General application settings.',
+        showInDialog: false,
+        properties: {
+            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,
+            },
+            disableAutoUpdate: {
+                type: 'boolean',
+                label: 'Disable Auto Update',
+                category: 'General',
+                requiresRestart: false,
+                default: false,
+                description: 'Disable automatic updates',
+                showInDialog: true,
+            },
+            disableUpdateNag: {
+                type: 'boolean',
+                label: 'Disable Update Nag',
+                category: 'General',
+                requiresRestart: false,
+                default: false,
+                description: 'Disable 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: false,
+                        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,
+            },
+            debugKeystrokeLogging: {
+                type: 'boolean',
+                label: 'Debug Keystroke Logging',
+                category: 'General',
+                requiresRestart: false,
+                default: false,
+                description: 'Enable debug logging of keystrokes to the console.',
+                showInDialog: true,
+            },
+        },
+    },
+    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.',
+                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.',
+                showInDialog: false,
+            },
+            customThemes: {
+                type: 'object',
+                label: 'Custom Themes',
+                category: 'UI',
+                requiresRestart: false,
+                default: {},
+                description: 'Custom theme definitions.',
+                showInDialog: false,
+            },
+            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 Status in Title',
+                category: 'UI',
+                requiresRestart: false,
+                default: false,
+                description: 'Show Gemini CLI status and thoughts in the terminal window title',
+                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,
+                    },
+                },
+            },
+            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: false,
+                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,
+            },
+            customWittyPhrases: {
+                type: 'array',
+                label: 'Custom Witty Phrases',
+                category: 'UI',
+                requiresRestart: false,
+                default: [],
+                description: 'Custom witty phrases to display during loading.',
+                showInDialog: false,
+            },
+            enableWelcomeBack: {
+                type: 'boolean',
+                label: 'Enable Welcome Back',
+                category: 'UI',
+                requiresRestart: false,
+                default: true,
+                description: 'Show welcome back dialog when returning to a project with conversation history.',
+                showInDialog: true,
+            },
+            accessibility: {
+                type: 'object',
+                label: 'Accessibility',
+                category: 'UI',
+                requiresRestart: true,
+                default: {},
+                description: 'Accessibility settings.',
+                showInDialog: false,
+                properties: {
+                    disableLoadingPhrases: {
+                        type: 'boolean',
+                        label: 'Disable Loading Phrases',
+                        category: 'UI',
+                        requiresRestart: true,
+                        default: false,
+                        description: 'Disable loading phrases for accessibility',
+                        showInDialog: true,
+                    },
+                    screenReader: {
+                        type: 'boolean',
+                        label: 'Screen Reader Mode',
+                        category: 'UI',
+                        requiresRestart: true,
+                        default: undefined,
+                        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,
+    },
+    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: 'Settings for summarizing tool output.',
+                showInDialog: false,
+            },
+            chatCompression: {
+                type: 'object',
+                label: 'Chat Compression',
+                category: 'Model',
+                requiresRestart: false,
+                default: undefined,
+                description: 'Chat compression settings.',
+                showInDialog: false,
+            },
+            sessionTokenLimit: {
+                type: 'number',
+                label: 'Session Token Limit',
+                category: 'Model',
+                requiresRestart: false,
+                default: undefined,
+                description: 'The maximum number of tokens allowed in a session.',
+                showInDialog: false,
+            },
+            skipNextSpeakerCheck: {
+                type: 'boolean',
+                label: 'Skip Next Speaker Check',
+                category: 'Model',
+                requiresRestart: false,
+                default: true,
+                description: 'Skip the next speaker check.',
+                showInDialog: true,
+            },
+            skipLoopDetection: {
+                type: 'boolean',
+                label: 'Skip Loop Detection',
+                category: 'Model',
+                requiresRestart: false,
+                default: false,
+                description: 'Disable all loop detection checks (streaming and LLM).',
+                showInDialog: true,
+            },
+            skipStartupContext: {
+                type: 'boolean',
+                label: 'Skip Startup Context',
+                category: 'Model',
+                requiresRestart: true,
+                default: false,
+                description: 'Avoid sending the workspace startup context at the beginning of each session.',
+                showInDialog: true,
+            },
+            enableOpenAILogging: {
+                type: 'boolean',
+                label: 'Enable OpenAI Logging',
+                category: 'Model',
+                requiresRestart: false,
+                default: false,
+                description: 'Enable OpenAI logging.',
+                showInDialog: true,
+            },
+            openAILoggingDir: {
+                type: 'string',
+                label: 'OpenAI Logging Directory',
+                category: 'Model',
+                requiresRestart: false,
+                default: undefined,
+                description: 'Custom directory path for OpenAI API logs. If not specified, defaults to logs/openai in the current working directory.',
+                showInDialog: true,
+            },
+            generationConfig: {
+                type: 'object',
+                label: 'Generation Configuration',
+                category: 'Model',
+                requiresRestart: false,
+                default: undefined,
+                description: 'Generation configuration settings.',
+                showInDialog: false,
+                properties: {
+                    timeout: {
+                        type: 'number',
+                        label: 'Timeout',
+                        category: 'Generation Configuration',
+                        requiresRestart: false,
+                        default: undefined,
+                        description: 'Request timeout in milliseconds.',
+                        parentKey: 'generationConfig',
+                        childKey: 'timeout',
+                        showInDialog: true,
+                    },
+                    maxRetries: {
+                        type: 'number',
+                        label: 'Max Retries',
+                        category: 'Generation Configuration',
+                        requiresRestart: false,
+                        default: undefined,
+                        description: 'Maximum number of retries for failed requests.',
+                        parentKey: 'generationConfig',
+                        childKey: 'maxRetries',
+                        showInDialog: true,
+                    },
+                    disableCacheControl: {
+                        type: 'boolean',
+                        label: 'Disable Cache Control',
+                        category: 'Generation Configuration',
+                        requiresRestart: false,
+                        default: false,
+                        description: 'Disable cache control for DashScope providers.',
+                        parentKey: 'generationConfig',
+                        childKey: 'disableCacheControl',
+                        showInDialog: true,
+                    },
+                },
+            },
+        },
+    },
+    context: {
+        type: 'object',
+        label: 'Context',
+        category: 'Context',
+        requiresRestart: false,
+        default: {},
+        description: 'Settings for managing context provided to the model.',
+        showInDialog: false,
+        properties: {
+            fileName: {
+                type: 'object',
+                label: 'Context File Name',
+                category: 'Context',
+                requiresRestart: false,
+                default: undefined,
+                description: 'The name of the context file.',
+                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: 'Additional directories to include in the workspace context. Missing directories will be skipped with a warning.',
+                showInDialog: false,
+                mergeStrategy: MergeStrategy.CONCAT,
+            },
+            loadMemoryFromIncludeDirectories: {
+                type: 'boolean',
+                label: 'Load Memory From Include Directories',
+                category: 'Context',
+                requiresRestart: false,
+                default: false,
+                description: 'Whether to load memory files from include directories.',
+                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,
+                    },
+                    respectPapertIgnore: {
+                        type: 'boolean',
+                        label: 'Respect .papertignore',
+                        category: 'Context',
+                        requiresRestart: true,
+                        default: true,
+                        description: 'Respect .papertignore files when searching',
+                        showInDialog: true,
+                    },
+                    enableRecursiveFileSearch: {
+                        type: 'boolean',
+                        label: 'Enable Recursive File Search',
+                        category: 'Context',
+                        requiresRestart: true,
+                        default: true,
+                        description: 'Enable recursive file search functionality',
+                        showInDialog: true,
+                    },
+                    disableFuzzySearch: {
+                        type: 'boolean',
+                        label: 'Disable Fuzzy Search',
+                        category: 'Context',
+                        requiresRestart: true,
+                        default: false,
+                        description: 'Disable 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: 'object',
+                label: 'Sandbox',
+                category: 'Tools',
+                requiresRestart: true,
+                default: undefined,
+                description: 'Sandbox execution environment (can be a boolean or a path string).',
+                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: false,
+                        description: '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,
+                    },
+                },
+            },
+            autoAccept: {
+                type: 'boolean',
+                label: 'Auto Accept',
+                category: 'Tools',
+                requiresRestart: false,
+                default: false,
+                description: '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: 'Paths to core tool definitions.',
+                showInDialog: false,
+            },
+            allowed: {
+                type: 'array',
+                label: 'Allowed Tools',
+                category: 'Advanced',
+                requiresRestart: true,
+                default: undefined,
+                description: 'A list of tool names that will bypass the confirmation dialog.',
+                showInDialog: false,
+            },
+            exclude: {
+                type: 'array',
+                label: 'Exclude Tools',
+                category: 'Tools',
+                requiresRestart: true,
+                default: undefined,
+                description: 'Tool names to exclude from discovery.',
+                showInDialog: false,
+                mergeStrategy: MergeStrategy.UNION,
+            },
+            approvalMode: {
+                type: 'enum',
+                label: 'Approval Mode',
+                category: 'Tools',
+                requiresRestart: false,
+                default: ApprovalMode.DEFAULT,
+                description: 'Approval mode for tool usage. Controls how tools are approved before execution.',
+                showInDialog: true,
+                options: [
+                    { value: ApprovalMode.PLAN, label: 'Plan' },
+                    { value: ApprovalMode.DEFAULT, label: 'Default' },
+                    { value: ApprovalMode.AUTO_EDIT, label: 'Auto Edit' },
+                    { value: ApprovalMode.YOLO, label: 'YOLO' },
+                ],
+            },
+            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: 'Command to run for tool calls.',
+                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,
+            },
+            useBuiltinRipgrep: {
+                type: 'boolean',
+                label: 'Use Builtin Ripgrep',
+                category: 'Tools',
+                requiresRestart: false,
+                default: true,
+                description: 'Use the bundled ripgrep binary. When set to false, the system-level "rg" command will be used instead. This setting is only effective when useRipgrep is true.',
+                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,
+            },
+        },
+    },
+    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,
+            },
+            excluded: {
+                type: 'array',
+                label: 'Exclude MCP Servers',
+                category: 'MCP',
+                requiresRestart: true,
+                default: undefined,
+                description: 'A list of MCP servers to exclude.',
+                showInDialog: false,
+            },
+        },
+    },
+    useSmartEdit: {
+        type: 'boolean',
+        label: 'Use Smart Edit',
+        category: 'Advanced',
+        requiresRestart: false,
+        default: false,
+        description: 'Enable the smart-edit tool instead of the replace tool.',
+        showInDialog: false,
+    },
+    security: {
+        type: 'object',
+        label: 'Security',
+        category: 'Security',
+        requiresRestart: true,
+        default: {},
+        description: 'Security-related settings.',
+        showInDialog: false,
+        properties: {
+            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,
+                    },
+                },
+            },
+            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,
+                    },
+                    apiKey: {
+                        type: 'string',
+                        label: 'API Key',
+                        category: 'Security',
+                        requiresRestart: true,
+                        default: undefined,
+                        description: 'API key for OpenAI compatible authentication.',
+                        showInDialog: false,
+                    },
+                    baseUrl: {
+                        type: 'string',
+                        label: 'Base URL',
+                        category: 'Security',
+                        requiresRestart: true,
+                        default: undefined,
+                        description: 'Base URL for OpenAI compatible API.',
+                        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,
+                mergeStrategy: MergeStrategy.UNION,
+            },
+            bugCommand: {
+                type: 'object',
+                label: 'Bug Command',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: undefined,
+                description: 'Configuration for the bug report command.',
+                showInDialog: false,
+            },
+            tavilyApiKey: {
+                type: 'string',
+                label: 'Tavily API Key (Deprecated)',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: undefined,
+                description: '⚠️ DEPRECATED: Please use webSearch.provider configuration instead. Legacy API key for the Tavily API.',
+                showInDialog: false,
+            },
+        },
+    },
+    webSearch: {
+        type: 'object',
+        label: 'Web Search',
+        category: 'Advanced',
+        requiresRestart: true,
+        default: undefined,
+        description: 'Configuration for web search providers.',
+        showInDialog: false,
+    },
+    experimental: {
+        type: 'object',
+        label: 'Experimental',
+        category: 'Experimental',
+        requiresRestart: true,
+        default: {},
+        description: 'Setting to enable experimental features',
+        showInDialog: false,
+        properties: {
+            extensionManagement: {
+                type: 'boolean',
+                label: 'Extension Management',
+                category: 'Experimental',
+                requiresRestart: true,
+                default: true,
+                description: 'Enable extension management features.',
+                showInDialog: false,
+            },
+            visionModelPreview: {
+                type: 'boolean',
+                label: 'Vision Model Preview',
+                category: 'Experimental',
+                requiresRestart: false,
+                default: true,
+                description: 'Enable vision model support and auto-switching functionality. When disabled, vision models like papert-vl-max-latest will be hidden and auto-switching will not occur.',
+                showInDialog: true,
+            },
+            vlmSwitchMode: {
+                type: 'string',
+                label: 'VLM Switch Mode',
+                category: 'Experimental',
+                requiresRestart: false,
+                default: undefined,
+                description: 'Default behavior when images are detected in input. Values: once (one-time switch), session (switch for entire session), persist (continue with current model). If not set, user will be prompted each time. This is a temporary experimental feature.',
+                showInDialog: false,
+            },
+        },
+    },
+    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,
+                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,
+                mergeStrategy: MergeStrategy.UNION,
+            },
+        },
+    },
+};
+export function getSettingsSchema() {
+    return SETTINGS_SCHEMA;
+}
+//# sourceMappingURL=settingsSchema.js.map