@vybestack/llxprt-code 0.5.0 → 0.6.1

package/dist/src/config/settingsSchema.js

@@ -3,212 +3,40 @@
  * Copyright 2025 Vybestack LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { DEFAULT_HISTORY_MAX_BYTES, DEFAULT_HISTORY_MAX_ITEMS, } from '../constants/historyLimits.js';
+import { DEFAULT_TRUNCATE_TOOL_OUTPUT_THRESHOLD, DEFAULT_TRUNCATE_TOOL_OUTPUT_LINES, } from '@vybestack/llxprt-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 = {}));
+const DEFAULT_EXTENSION_AUTO_UPDATE = {
+    enabled: true,
+    checkIntervalHours: 24,
+    installMode: 'immediate',
+    notificationLevel: 'toast',
+    perExtension: {},
+};
 /**
  * The canonical schema for all settings.
  * The structure of this object defines the structure of the `Settings` type.
  * `as const` is crucial for TypeScript to infer the most specific types possible.
  */
 export const SETTINGS_SCHEMA = {
-    // UI Settings
-    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,
-    },
-    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,
-    },
-    hideFooter: {
-        type: 'boolean',
-        label: 'Hide Footer',
-        category: 'UI',
-        requiresRestart: false,
-        default: false,
-        description: 'Hide the footer from the UI',
-        showInDialog: true,
-    },
-    hideContextSummary: {
-        type: 'boolean',
-        label: 'Hide Context Summary',
-        category: 'UI',
-        requiresRestart: false,
-        default: false,
-        description: 'Hide the context summary (LLXPRT.md, MCP servers) above the input.',
-        showInDialog: true,
-    },
-    showTodoPanel: {
-        type: 'boolean',
-        label: 'Show Todo Panel',
-        category: 'UI',
-        requiresRestart: false,
-        default: true,
-        description: 'Display the interactive Todo panel. Disable to keep todos in the scrollback view instead.',
-        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,
-    },
-    historyMaxItems: {
-        type: 'number',
-        label: 'History Max Items',
-        category: 'UI',
-        requiresRestart: false,
-        default: DEFAULT_HISTORY_MAX_ITEMS,
-        description: 'Maximum number of history entries to keep in the scrollback before trimming the oldest ones. Set to -1 for unlimited.',
-        showInDialog: true,
-    },
-    historyMaxBytes: {
-        type: 'number',
-        label: 'History Max Bytes',
-        category: 'UI',
-        requiresRestart: false,
-        default: DEFAULT_HISTORY_MAX_BYTES,
-        description: 'Approximate maximum number of bytes to keep in history. Older entries are removed once this budget is exceeded. Set to -1 for unlimited.',
-        showInDialog: true,
-    },
-    customWittyPhrases: {
-        type: 'array',
-        label: 'Custom Witty Phrases',
-        category: 'UI',
-        requiresRestart: false,
-        default: [],
-        description: 'Custom witty phrases to display during loading.',
-        showInDialog: false,
-    },
-    usageStatisticsEnabled: {
-        type: 'boolean',
-        label: 'Enable Usage Statistics',
-        category: 'General',
-        requiresRestart: true,
-        default: true,
-        description: 'Enable collection of usage statistics',
-        showInDialog: false, // All details are shown in /privacy and dependent on auth type
-    },
-    autoConfigureMaxOldSpaceSize: {
-        type: 'boolean',
-        label: 'Auto Configure Max Old Space Size',
-        category: 'General',
-        requiresRestart: true,
-        default: false,
-        description: 'Automatically configure Node.js memory limits',
-        showInDialog: true,
-    },
-    preferredEditor: {
-        type: 'string',
-        label: 'Preferred Editor',
-        category: 'General',
-        requiresRestart: false,
-        default: undefined,
-        description: 'The preferred editor to open files in.',
-        showInDialog: false,
-    },
-    maxSessionTurns: {
-        type: 'number',
-        label: 'Max Session Turns',
-        category: 'General',
-        requiresRestart: false,
-        default: -1,
-        description: 'Maximum number of user/model/tool turns to keep in a session. -1 means unlimited.',
-        showInDialog: true,
-    },
-    maxTurnsPerPrompt: {
-        type: 'number',
-        label: 'Max Turns Per Prompt',
-        category: 'General',
-        requiresRestart: false,
-        default: 200,
-        description: 'Maximum number of turns allowed per prompt before stopping to prevent loops. Set to -1 for unlimited (default: 200).',
-        showInDialog: true,
-    },
-    memoryImportFormat: {
-        type: 'string',
-        label: 'Memory Import Format',
-        category: 'General',
-        requiresRestart: false,
-        default: undefined,
-        description: 'The format to use when importing memory.',
-        showInDialog: false,
-    },
-    memoryDiscoveryMaxDirs: {
-        type: 'number',
-        label: 'Memory Discovery Max Dirs',
-        category: 'General',
-        requiresRestart: false,
-        default: 200,
-        description: 'Maximum number of directories to search for memory.',
-        showInDialog: true,
-    },
-    contextFileName: {
-        type: 'object',
-        label: 'Context File Name',
-        category: 'General',
-        requiresRestart: false,
-        default: undefined,
-        description: 'The name of the context file.',
-        showInDialog: false,
-    },
-    vimMode: {
-        type: 'boolean',
-        label: 'Vim Mode',
-        category: 'Mode',
-        requiresRestart: false,
-        default: false,
-        description: 'Enable Vim keybindings',
-        showInDialog: true,
-    },
-    ideMode: {
-        type: 'boolean',
-        label: 'IDE Mode',
-        category: 'Mode',
-        requiresRestart: true,
-        default: false,
-        description: 'Enable IDE integration mode',
-        showInDialog: true,
-    },
     accessibility: {
         type: 'object',
         label: 'Accessibility',
@@ -232,7 +60,7 @@ export const SETTINGS_SCHEMA = {
                 label: 'Screen Reader Mode',
                 category: 'Accessibility',
                 requiresRestart: true,
-                default: undefined,
+                default: false,
                 description: 'Render output in plain-text to be more screen reader accessible',
                 showInDialog: true,
             },
@@ -325,11 +153,11 @@ export const SETTINGS_SCHEMA = {
     },
     shouldUseNodePtyShell: {
         type: 'boolean',
-        label: 'Use node-pty for Shell Execution',
+        label: 'Enable Interactive Shell (node-pty)',
         category: 'Shell',
         requiresRestart: true,
         default: false,
-        description: 'Use node-pty for shell command execution. Fallback to child_process still applies.',
+        description: 'Allow fully interactive shell commands (vim, git rebase -i, etc.) by running tools through node-pty. Falls back to child_process when disabled.',
         showInDialog: true,
     },
     selectedAuthType: {
@@ -386,6 +214,16 @@ export const SETTINGS_SCHEMA = {
         description: 'Tool names to exclude from discovery.',
         showInDialog: false,
     },
+    coreToolSettings: {
+        type: 'object',
+        label: 'Tool Management',
+        category: 'Advanced',
+        requiresRestart: true,
+        default: {},
+        description: 'Manage core tool availability',
+        showInDialog: true,
+        subSettings: {}, // Will be populated dynamically based on loaded tools
+    },
     toolDiscoveryCommand: {
         type: 'string',
         label: 'Tool Discovery Command',
@@ -412,7 +250,10 @@ export const SETTINGS_SCHEMA = {
         default: 'legacy',
         description: 'Mode for processing tool calls. Pipeline mode is optimized, legacy mode uses older implementation.',
         showInDialog: true,
-        options: ['legacy', 'pipeline'],
+        options: [
+            { value: 'legacy', label: 'Legacy' },
+            { value: 'pipeline', label: 'Pipeline' },
+        ],
     },
     mcpServerCommand: {
         type: 'string',
@@ -432,6 +273,322 @@ export const SETTINGS_SCHEMA = {
         description: 'Configuration for MCP servers.',
         showInDialog: false,
     },
+    sessionRetention: {
+        type: 'object',
+        label: 'Session Retention',
+        category: 'General',
+        requiresRestart: false,
+        default: undefined,
+        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.',
+                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 (LLXPRT.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,
+            },
+            vimMode: {
+                type: 'boolean',
+                label: 'Vim Mode',
+                category: 'UI',
+                requiresRestart: false,
+                default: false,
+                description: 'Enable Vim keybindings in the input field.',
+                showInDialog: true,
+            },
+            ideMode: {
+                type: 'boolean',
+                label: 'IDE Mode',
+                category: 'UI',
+                requiresRestart: false,
+                default: false,
+                description: 'Enable IDE integration mode.',
+                showInDialog: true,
+            },
+            preferredEditor: {
+                type: 'string',
+                label: 'Preferred Editor',
+                category: 'UI',
+                requiresRestart: false,
+                default: undefined,
+                description: 'The preferred code editor for opening files.',
+                showInDialog: false,
+            },
+            autoConfigureMaxOldSpaceSize: {
+                type: 'boolean',
+                label: 'Auto Configure Max Old Space Size',
+                category: 'UI',
+                requiresRestart: true,
+                default: true,
+                description: 'Automatically configure Node.js max old space size based on system memory.',
+                showInDialog: true,
+            },
+            historyMaxItems: {
+                type: 'number',
+                label: 'History Max Items',
+                category: 'UI',
+                requiresRestart: false,
+                default: 100,
+                description: 'Maximum number of history items to keep.',
+                showInDialog: false,
+            },
+            historyMaxBytes: {
+                type: 'number',
+                label: 'History Max Bytes',
+                category: 'UI',
+                requiresRestart: false,
+                default: 1048576,
+                description: 'Maximum size of history in bytes.',
+                showInDialog: false,
+            },
+            memoryImportFormat: {
+                type: 'string',
+                label: 'Memory Import Format',
+                category: 'UI',
+                requiresRestart: false,
+                default: 'tree',
+                description: 'Format for importing memory files (tree or flat).',
+                showInDialog: false,
+            },
+            memoryDiscoveryMaxDirs: {
+                type: 'number',
+                label: 'Memory Discovery Max Dirs',
+                category: 'UI',
+                requiresRestart: false,
+                default: undefined,
+                description: 'Maximum number of directories to scan for memory files.',
+                showInDialog: false,
+            },
+            contextFileName: {
+                type: 'string',
+                label: 'Context File Name',
+                category: 'UI',
+                requiresRestart: false,
+                default: undefined,
+                description: 'The name of the context file to use.',
+                showInDialog: false,
+            },
+            usageStatisticsEnabled: {
+                type: 'boolean',
+                label: 'Usage Statistics Enabled',
+                category: 'UI',
+                requiresRestart: false,
+                default: true,
+                description: 'Enable anonymous usage statistics collection.',
+                showInDialog: false,
+            },
+            maxSessionTurns: {
+                type: 'number',
+                label: 'Max Session Turns',
+                category: 'UI',
+                requiresRestart: false,
+                default: -1,
+                description: 'Maximum number of turns in a session (-1 for unlimited).',
+                showInDialog: false,
+            },
+            showTodoPanel: {
+                type: 'boolean',
+                label: 'Show Todo Panel',
+                category: 'UI',
+                requiresRestart: false,
+                default: true,
+                description: 'Show the todo panel in the UI.',
+                showInDialog: true,
+            },
+        },
+    },
+    ide: {
+        type: 'object',
+        label: 'IDE',
+        category: 'IDE',
+        requiresRestart: true,
+        default: {},
+        description: 'IDE integration settings.',
+        showInDialog: false,
+        properties: {},
+    },
+    showStatusInTitle: {
+        type: 'boolean',
+        label: 'Show Status in Title',
+        category: 'UI',
+        requiresRestart: false,
+        default: false,
+        description: 'Show LLxprt status and thoughts in the terminal window title',
+        showInDialog: true,
+    },
     // Footer configuration settings - adapted to llxprt's flat structure
     hideCWD: {
         type: 'boolean',
@@ -532,15 +689,6 @@ export const SETTINGS_SCHEMA = {
                 description: 'Sandbox execution environment (can be a boolean or a path string).',
                 showInDialog: false,
             },
-            usePty: {
-                type: 'boolean',
-                label: 'Use node-pty for Shell Execution',
-                category: 'Tools',
-                requiresRestart: true,
-                default: false,
-                description: 'Use node-pty for shell command execution. Fallback to child_process still applies.',
-                showInDialog: true,
-            },
             autoAccept: {
                 type: 'boolean',
                 label: 'Auto Accept',
@@ -604,6 +752,42 @@ export const SETTINGS_SCHEMA = {
                 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: 'Tools',
+                requiresRestart: true,
+                default: true,
+                description: 'Enable truncation of large tool outputs.',
+                showInDialog: true,
+            },
+            truncateToolOutputThreshold: {
+                type: 'number',
+                label: 'Tool Output Truncation Threshold',
+                category: 'Tools',
+                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: 'Tools',
+                requiresRestart: true,
+                default: DEFAULT_TRUNCATE_TOOL_OUTPUT_LINES,
+                description: 'The number of lines to keep when truncating tool output.',
+                showInDialog: true,
+            },
+            policyPath: {
+                type: 'string',
+                label: 'Policy File Path',
+                category: 'Tools',
+                requiresRestart: false,
+                default: undefined,
+                description: 'Absolute path to a TOML policy file that augments the built-in policy rules.',
+                showInDialog: false,
+            },
         },
     },
     mcp: {
@@ -863,7 +1047,11 @@ export const SETTINGS_SCHEMA = {
         label: 'Extensions',
         category: 'Extensions',
         requiresRestart: true,
-        default: {},
+        default: {
+            disabled: [],
+            workspacesWithMigrationNudge: [],
+            autoUpdate: DEFAULT_EXTENSION_AUTO_UPDATE,
+        },
         description: 'Settings for extensions.',
         showInDialog: false,
         properties: {
@@ -885,6 +1073,72 @@ export const SETTINGS_SCHEMA = {
                 description: 'List of workspaces for which the migration nudge has been shown.',
                 showInDialog: false,
             },
+            autoUpdate: {
+                type: 'object',
+                label: 'Extension Auto-Update',
+                category: 'Extensions',
+                requiresRestart: false,
+                default: DEFAULT_EXTENSION_AUTO_UPDATE,
+                description: 'Configure how llxprt-code checks for and applies extension updates.',
+                showInDialog: false,
+                properties: {
+                    enabled: {
+                        type: 'boolean',
+                        label: 'Enable Auto-Update',
+                        category: 'Extensions',
+                        requiresRestart: false,
+                        default: true,
+                        description: 'Automatically check for updates to globally installed extensions.',
+                        showInDialog: false,
+                    },
+                    checkIntervalHours: {
+                        type: 'number',
+                        label: 'Auto-Update Interval (hours)',
+                        category: 'Extensions',
+                        requiresRestart: false,
+                        default: 24,
+                        description: 'How often llxprt-code should check for extension updates.',
+                        showInDialog: false,
+                    },
+                    installMode: {
+                        type: 'enum',
+                        label: 'Install Mode',
+                        category: 'Extensions',
+                        requiresRestart: false,
+                        default: 'immediate',
+                        description: 'Choose whether updates apply immediately, on restart, or manually.',
+                        showInDialog: false,
+                        options: [
+                            { value: 'immediate', label: 'Immediate' },
+                            { value: 'on-restart', label: 'On Restart' },
+                            { value: 'manual', label: 'Manual' },
+                        ],
+                    },
+                    notificationLevel: {
+                        type: 'enum',
+                        label: 'Notification Level',
+                        category: 'Extensions',
+                        requiresRestart: false,
+                        default: 'toast',
+                        description: 'Controls how aggressively update notifications are surfaced.',
+                        showInDialog: false,
+                        options: [
+                            { value: 'toast', label: 'Toast' },
+                            { value: 'dialog', label: 'Dialog' },
+                            { value: 'silent', label: 'Silent' },
+                        ],
+                    },
+                    perExtension: {
+                        type: 'object',
+                        label: 'Per Extension Overrides',
+                        category: 'Extensions',
+                        requiresRestart: false,
+                        default: DEFAULT_EXTENSION_AUTO_UPDATE.perExtension,
+                        description: 'Override auto-update behavior for individual extensions (by extension name).',
+                        showInDialog: false,
+                    },
+                },
+            },
         },
     },
     // Text-based tool call parsing settings