@machina.ai/cell-cli 1.33.0-rc1 → 1.38.1-rc1

package/dist/src/config/settingsSchema.d.ts

@@ -3,7 +3,7 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { type MCPServerConfig, type BugCommandSettings, type TelemetrySettings, type AuthType, type AgentOverride, type CustomTheme } from '@google/gemini-cli-core';
+import { type MCPServerConfig, type RequiredMcpServerConfig, type BugCommandSettings, type TelemetrySettings, type AuthType, type AgentOverride, type CustomTheme, type SandboxConfig } from '@google/gemini-cli-core';
 import type { SessionRetentionSettings } from './settings.js';
 export type SettingsType = 'boolean' | 'string' | 'number' | 'array' | 'object' | 'enum';
 export type SettingsValue = boolean | string | number | string[] | object | undefined;
@@ -64,6 +64,10 @@ export interface SettingDefinition {
      * For map-like objects without explicit `properties`, describes the shape of the values.
      */
     additionalProperties?: SettingCollectionDefinition;
+    /**
+     * Optional unit to display after the value (e.g. '%').
+     */
+    unit?: string;
     /**
      * Optional reference identifier for generators that emit a `$ref`.
      */
@@ -108,6 +112,32 @@ declare const SETTINGS_SCHEMA: {
             readonly ref: "MCPServerConfig";
         };
     };
+    readonly policyPaths: {
+        type: "array";
+        label: string;
+        category: "Advanced";
+        requiresRestart: true;
+        default: string[];
+        description: string;
+        showInDialog: false;
+        items: {
+            type: "string";
+        };
+        mergeStrategy: MergeStrategy;
+    };
+    readonly adminPolicyPaths: {
+        type: "array";
+        label: string;
+        category: "Advanced";
+        requiresRestart: true;
+        default: string[];
+        description: string;
+        showInDialog: false;
+        items: {
+            type: "string";
+        };
+        mergeStrategy: MergeStrategy;
+    };
     readonly general: {
         readonly type: "object";
         readonly label: "General";
@@ -181,6 +211,15 @@ declare const SETTINGS_SCHEMA: {
                 readonly description: "Enable update notification prompts.";
                 readonly showInDialog: false;
             };
+            readonly enableNotifications: {
+                readonly type: "boolean";
+                readonly label: "Enable Notifications";
+                readonly category: "General";
+                readonly requiresRestart: false;
+                readonly default: false;
+                readonly description: "Enable run-event notifications for action-required prompts and session completion.";
+                readonly showInDialog: true;
+            };
             readonly checkpointing: {
                 readonly type: "object";
                 readonly label: "Checkpointing";
@@ -201,23 +240,61 @@ declare const SETTINGS_SCHEMA: {
                     };
                 };
             };
-            readonly enablePromptCompletion: {
-                readonly type: "boolean";
-                readonly label: "Enable Prompt Completion";
+            readonly plan: {
+                readonly type: "object";
+                readonly label: "Plan";
                 readonly category: "General";
                 readonly requiresRestart: true;
-                readonly default: false;
-                readonly description: "Enable AI-powered prompt completion suggestions while typing.";
-                readonly showInDialog: true;
+                readonly default: {};
+                readonly description: "Planning features configuration.";
+                readonly showInDialog: false;
+                readonly properties: {
+                    readonly enabled: {
+                        readonly type: "boolean";
+                        readonly label: "Enable Plan Mode";
+                        readonly category: "General";
+                        readonly requiresRestart: true;
+                        readonly default: true;
+                        readonly description: "Enable Plan Mode for read-only safety during planning.";
+                        readonly showInDialog: true;
+                    };
+                    readonly directory: {
+                        readonly type: "string";
+                        readonly label: "Plan Directory";
+                        readonly category: "General";
+                        readonly requiresRestart: true;
+                        readonly default: string | undefined;
+                        readonly description: "The directory where planning artifacts are stored. If not specified, defaults to the system temporary directory. A custom directory requires a policy to allow write access in Plan Mode.";
+                        readonly showInDialog: true;
+                    };
+                    readonly modelRouting: {
+                        readonly type: "boolean";
+                        readonly label: "Plan Model Routing";
+                        readonly category: "General";
+                        readonly requiresRestart: false;
+                        readonly default: true;
+                        readonly description: "Automatically switch between Pro and Flash models based on Plan Mode status. Uses Pro for the planning phase and Flash for the implementation phase.";
+                        readonly showInDialog: true;
+                    };
+                };
             };
             readonly retryFetchErrors: {
                 readonly type: "boolean";
                 readonly label: "Retry Fetch Errors";
                 readonly category: "General";
                 readonly requiresRestart: false;
-                readonly default: false;
+                readonly default: true;
                 readonly description: "Retry on \"exception TypeError: fetch failed sending request\" errors.";
-                readonly showInDialog: false;
+                readonly showInDialog: true;
+            };
+            readonly maxAttempts: {
+                readonly type: "number";
+                readonly label: "Max Chat Model Attempts";
+                readonly category: "General";
+                readonly requiresRestart: false;
+                readonly default: 10;
+                readonly description: "Maximum number of attempts for requests to the main chat model. Cannot exceed 10.";
+                readonly showInDialog: true;
             };
             readonly debugKeystrokeLogging: {
                 readonly type: "boolean";
@@ -241,18 +318,18 @@ declare const SETTINGS_SCHEMA: {
                         readonly label: "Enable Session Cleanup";
                         readonly category: "General";
                         readonly requiresRestart: false;
-                        readonly default: false;
+                        readonly default: boolean;
                         readonly description: "Enable automatic session cleanup";
                         readonly showInDialog: true;
                     };
                     readonly maxAge: {
                         readonly type: "string";
-                        readonly label: "Max Session Age";
+                        readonly label: "Keep chat history";
                         readonly category: "General";
                         readonly requiresRestart: false;
-                        readonly default: string | undefined;
-                        readonly description: "Maximum age of sessions to keep (e.g., \"30d\", \"7d\", \"24h\", \"1w\")";
-                        readonly showInDialog: false;
+                        readonly default: string;
+                        readonly description: "Automatically delete chats older than this time period (e.g., \"30d\", \"7d\", \"24h\", \"1w\")";
+                        readonly showInDialog: true;
                     };
                     readonly maxCount: {
                         readonly type: "number";
@@ -405,6 +482,15 @@ declare const SETTINGS_SCHEMA: {
                 readonly description: "Show a warning when running Cell CLI in the home directory.";
                 readonly showInDialog: true;
             };
+            readonly showCompatibilityWarnings: {
+                readonly type: "boolean";
+                readonly label: "Show Compatibility Warnings";
+                readonly category: "UI";
+                readonly requiresRestart: true;
+                readonly default: true;
+                readonly description: "Show warnings about terminal or OS compatibility issues.";
+                readonly showInDialog: true;
+            };
             readonly hideTips: {
                 readonly type: "boolean";
                 readonly label: "Hide Tips";
@@ -414,6 +500,33 @@ declare const SETTINGS_SCHEMA: {
                 readonly description: "Hide helpful tips in the UI";
                 readonly showInDialog: true;
             };
+            readonly escapePastedAtSymbols: {
+                readonly type: "boolean";
+                readonly label: "Escape Pasted @ Symbols";
+                readonly category: "UI";
+                readonly requiresRestart: false;
+                readonly default: false;
+                readonly description: "When enabled, @ symbols in pasted text are escaped to prevent unintended @path expansion.";
+                readonly showInDialog: true;
+            };
+            readonly showShortcutsHint: {
+                readonly type: "boolean";
+                readonly label: "Show Shortcuts Hint";
+                readonly category: "UI";
+                readonly requiresRestart: false;
+                readonly default: true;
+                readonly description: "Show the \"? for shortcuts\" hint above the input.";
+                readonly showInDialog: true;
+            };
+            readonly compactToolOutput: {
+                readonly type: "boolean";
+                readonly label: "Compact Tool Output";
+                readonly category: "UI";
+                readonly requiresRestart: false;
+                readonly default: true;
+                readonly description: "Display tool outputs (like directory listings and file reads) in a compact, structured format.";
+                readonly showInDialog: true;
+            };
             readonly hideBanner: {
                 readonly type: "boolean";
                 readonly label: "Hide Banner";
@@ -441,13 +554,34 @@ declare const SETTINGS_SCHEMA: {
                 readonly description: "Settings for the footer.";
                 readonly showInDialog: false;
                 readonly properties: {
+                    readonly items: {
+                        readonly type: "array";
+                        readonly label: "Footer Items";
+                        readonly category: "UI";
+                        readonly requiresRestart: false;
+                        readonly default: string[] | undefined;
+                        readonly description: "List of item IDs to display in the footer. Rendered in order";
+                        readonly showInDialog: false;
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly showLabels: {
+                        readonly type: "boolean";
+                        readonly label: "Show Footer Labels";
+                        readonly category: "UI";
+                        readonly requiresRestart: false;
+                        readonly default: true;
+                        readonly description: "Display a second line above the footer items with descriptive headers (e.g., /model).";
+                        readonly showInDialog: false;
+                    };
                     readonly hideCWD: {
                         readonly type: "boolean";
                         readonly label: "Hide CWD";
                         readonly category: "UI";
                         readonly requiresRestart: false;
                         readonly default: false;
-                        readonly description: "Hide the current working directory path in the footer.";
+                        readonly description: "Hide the current working directory in the footer.";
                         readonly showInDialog: true;
                     };
                     readonly hideSandboxStatus: {
@@ -474,7 +608,7 @@ declare const SETTINGS_SCHEMA: {
                         readonly category: "UI";
                         readonly requiresRestart: false;
                         readonly default: true;
-                        readonly description: "Hides the context window remaining percentage.";
+                        readonly description: "Hides the context window usage percentage.";
                         readonly showInDialog: true;
                     };
                 };
@@ -488,6 +622,15 @@ declare const SETTINGS_SCHEMA: {
                 readonly description: "Hide the footer from the UI";
                 readonly showInDialog: true;
             };
+            readonly collapseDrawerDuringApproval: {
+                readonly type: "boolean";
+                readonly label: "Collapse Drawer During Approval";
+                readonly category: "UI";
+                readonly requiresRestart: false;
+                readonly default: true;
+                readonly description: "Whether to collapse the UI drawer when a tool is awaiting confirmation.";
+                readonly showInDialog: false;
+            };
             readonly showMemoryUsage: {
                 readonly type: "boolean";
                 readonly label: "Show Memory Usage";
@@ -530,7 +673,7 @@ declare const SETTINGS_SCHEMA: {
                 readonly category: "UI";
                 readonly requiresRestart: false;
                 readonly default: true;
-                readonly description: "Show the logged-in user's identity (e.g. email) in the UI.";
+                readonly description: "Show the signed-in user's identity (e.g. email) in the UI.";
                 readonly showInDialog: true;
             };
             readonly useAlternateBuffer: {
@@ -542,6 +685,24 @@ declare const SETTINGS_SCHEMA: {
                 readonly description: "Use an alternate screen buffer for the UI, preserving shell history.";
                 readonly showInDialog: true;
             };
+            readonly renderProcess: {
+                readonly type: "boolean";
+                readonly label: "Render Process";
+                readonly category: "UI";
+                readonly requiresRestart: true;
+                readonly default: true;
+                readonly description: "Enable Ink render process for the UI.";
+                readonly showInDialog: true;
+            };
+            readonly terminalBuffer: {
+                readonly type: "boolean";
+                readonly label: "Terminal Buffer";
+                readonly category: "UI";
+                readonly requiresRestart: true;
+                readonly default: false;
+                readonly description: "Use the new terminal buffer architecture for rendering.";
+                readonly showInDialog: true;
+            };
             readonly useBackgroundColor: {
                 readonly type: "boolean";
                 readonly label: "Use Background Color";
@@ -569,6 +730,44 @@ declare const SETTINGS_SCHEMA: {
                 readonly description: "Show the spinner during operations.";
                 readonly showInDialog: true;
             };
+            readonly loadingPhrases: {
+                readonly type: "enum";
+                readonly label: "Loading Phrases";
+                readonly category: "UI";
+                readonly requiresRestart: false;
+                readonly default: "off";
+                readonly description: "What to show while the model is working: tips, witty comments, all, or off.";
+                readonly showInDialog: true;
+                readonly options: readonly [{
+                    readonly value: "tips";
+                    readonly label: "Tips";
+                }, {
+                    readonly value: "witty";
+                    readonly label: "Witty";
+                }, {
+                    readonly value: "all";
+                    readonly label: "All";
+                }, {
+                    readonly value: "off";
+                    readonly label: "Off";
+                }];
+            };
+            readonly errorVerbosity: {
+                readonly type: "enum";
+                readonly label: "Error Verbosity";
+                readonly category: "UI";
+                readonly requiresRestart: false;
+                readonly default: "low";
+                readonly description: "Controls whether recoverable errors are hidden (low) or fully shown (full).";
+                readonly showInDialog: true;
+                readonly options: readonly [{
+                    readonly value: "low";
+                    readonly label: "Low";
+                }, {
+                    readonly value: "full";
+                    readonly label: "Full";
+                }];
+            };
             readonly customWittyPhrases: {
                 readonly type: "array";
                 readonly label: "Custom Witty Phrases";
@@ -596,8 +795,8 @@ declare const SETTINGS_SCHEMA: {
                         readonly category: "UI";
                         readonly requiresRestart: true;
                         readonly default: true;
-                        readonly description: "Enable loading phrases during operations.";
-                        readonly showInDialog: true;
+                        readonly description: "@deprecated Use ui.loadingPhrases instead. Enable loading phrases during operations.";
+                        readonly showInDialog: false;
                     };
                     readonly screenReader: {
                         readonly type: "boolean";
@@ -671,6 +870,36 @@ declare const SETTINGS_SCHEMA: {
         readonly showInDialog: false;
         readonly ref: "TelemetrySettings";
     };
+    readonly billing: {
+        readonly type: "object";
+        readonly label: "Billing";
+        readonly category: "Advanced";
+        readonly requiresRestart: false;
+        readonly default: {};
+        readonly description: "Billing and AI credits settings.";
+        readonly showInDialog: false;
+        readonly properties: {
+            readonly overageStrategy: {
+                readonly type: "enum";
+                readonly label: "Overage Strategy";
+                readonly category: "Advanced";
+                readonly requiresRestart: false;
+                readonly default: "ask";
+                readonly description: string;
+                readonly showInDialog: true;
+                readonly options: readonly [{
+                    readonly value: "ask";
+                    readonly label: "Ask each time";
+                }, {
+                    readonly value: "always";
+                    readonly label: "Always use credits";
+                }, {
+                    readonly value: "never";
+                    readonly label: "Never use credits";
+                }];
+            };
+        };
+    };
     readonly model: {
         readonly type: "object";
         readonly label: "Model";
@@ -687,7 +916,7 @@ declare const SETTINGS_SCHEMA: {
                 readonly requiresRestart: false;
                 readonly default: string | undefined;
                 readonly description: "The Gemini model to use for conversations.";
-                readonly showInDialog: false;
+                readonly showInDialog: true;
             };
             readonly maxSessionTurns: {
                 readonly type: "number";
@@ -716,12 +945,13 @@ declare const SETTINGS_SCHEMA: {
             };
             readonly compressionThreshold: {
                 readonly type: "number";
-                readonly label: "Compression Threshold";
+                readonly label: "Context Compression Threshold";
                 readonly category: "Model";
                 readonly requiresRestart: true;
                 readonly default: number;
                 readonly description: "The fraction of context usage at which to trigger context compression (e.g. 0.2, 0.3).";
                 readonly showInDialog: true;
+                readonly unit: "%";
             };
             readonly disableLoopDetection: {
                 readonly type: "boolean";
@@ -748,7 +978,7 @@ declare const SETTINGS_SCHEMA: {
         readonly label: "Model Configs";
         readonly category: "Model";
         readonly requiresRestart: false;
-        readonly default: import("@google/gemini-cli-core/src/services/modelConfigService.js").ModelConfigServiceConfig;
+        readonly default: import("@google/gemini-cli-core").ModelConfigServiceConfig;
         readonly description: "Model configurations.";
         readonly showInDialog: false;
         readonly properties: {
@@ -757,7 +987,7 @@ declare const SETTINGS_SCHEMA: {
                 readonly label: "Model Config Aliases";
                 readonly category: "Model";
                 readonly requiresRestart: false;
-                readonly default: Record<string, import("@google/gemini-cli-core/src/services/modelConfigService.js").ModelConfigAlias> | undefined;
+                readonly default: Record<string, import("@google/gemini-cli-core").ModelConfigAlias> | undefined;
                 readonly 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.";
                 readonly showInDialog: false;
             };
@@ -788,6 +1018,58 @@ declare const SETTINGS_SCHEMA: {
                 readonly description: "Apply specific configuration overrides based on matches, with a primary key of model (or alias). The most specific match will be used.";
                 readonly showInDialog: false;
             };
+            readonly modelDefinitions: {
+                readonly type: "object";
+                readonly label: "Model Definitions";
+                readonly category: "Model";
+                readonly requiresRestart: true;
+                readonly default: Record<string, import("@google/gemini-cli-core").ModelDefinition> | undefined;
+                readonly description: "Registry of model metadata, including tier, family, and features.";
+                readonly showInDialog: false;
+                readonly additionalProperties: {
+                    readonly type: "object";
+                    readonly ref: "ModelDefinition";
+                };
+            };
+            readonly modelIdResolutions: {
+                readonly type: "object";
+                readonly label: "Model ID Resolutions";
+                readonly category: "Model";
+                readonly requiresRestart: true;
+                readonly default: Record<string, import("@google/gemini-cli-core").ModelResolution> | undefined;
+                readonly description: "Rules for resolving requested model names to concrete model IDs based on context.";
+                readonly showInDialog: false;
+                readonly additionalProperties: {
+                    readonly type: "object";
+                    readonly ref: "ModelResolution";
+                };
+            };
+            readonly classifierIdResolutions: {
+                readonly type: "object";
+                readonly label: "Classifier ID Resolutions";
+                readonly category: "Model";
+                readonly requiresRestart: true;
+                readonly default: Record<string, import("@google/gemini-cli-core").ModelResolution> | undefined;
+                readonly description: "Rules for resolving classifier tiers (flash, pro) to concrete model IDs.";
+                readonly showInDialog: false;
+                readonly additionalProperties: {
+                    readonly type: "object";
+                    readonly ref: "ModelResolution";
+                };
+            };
+            readonly modelChains: {
+                readonly type: "object";
+                readonly label: "Model Chains";
+                readonly category: "Model";
+                readonly requiresRestart: true;
+                readonly default: Record<string, import("@google/gemini-cli-core/src/availability/modelPolicy.js").ModelPolicy[]> | undefined;
+                readonly description: "Availability policy chains defining fallback behavior for models.";
+                readonly showInDialog: false;
+                readonly additionalProperties: {
+                    readonly type: "array";
+                    readonly ref: "ModelPolicyChain";
+                };
+            };
         };
     };
     readonly agents: {
@@ -812,6 +1094,111 @@ declare const SETTINGS_SCHEMA: {
                     readonly ref: "AgentOverride";
                 };
             };
+            readonly browser: {
+                readonly type: "object";
+                readonly label: "Browser Agent";
+                readonly category: "Advanced";
+                readonly requiresRestart: true;
+                readonly default: {};
+                readonly description: "Settings specific to the browser agent.";
+                readonly showInDialog: false;
+                readonly properties: {
+                    readonly sessionMode: {
+                        readonly type: "enum";
+                        readonly label: "Browser Session Mode";
+                        readonly category: "Advanced";
+                        readonly requiresRestart: true;
+                        readonly default: "persistent";
+                        readonly description: "Session mode: 'persistent', 'isolated', or 'existing'.";
+                        readonly showInDialog: false;
+                        readonly options: readonly [{
+                            readonly value: "persistent";
+                            readonly label: "Persistent";
+                        }, {
+                            readonly value: "isolated";
+                            readonly label: "Isolated";
+                        }, {
+                            readonly value: "existing";
+                            readonly label: "Existing";
+                        }];
+                    };
+                    readonly headless: {
+                        readonly type: "boolean";
+                        readonly label: "Browser Headless";
+                        readonly category: "Advanced";
+                        readonly requiresRestart: true;
+                        readonly default: false;
+                        readonly description: "Run browser in headless mode.";
+                        readonly showInDialog: false;
+                    };
+                    readonly profilePath: {
+                        readonly type: "string";
+                        readonly label: "Browser Profile Path";
+                        readonly category: "Advanced";
+                        readonly requiresRestart: true;
+                        readonly default: string | undefined;
+                        readonly description: "Path to browser profile directory for session persistence.";
+                        readonly showInDialog: false;
+                    };
+                    readonly visualModel: {
+                        readonly type: "string";
+                        readonly label: "Browser Visual Model";
+                        readonly category: "Advanced";
+                        readonly requiresRestart: true;
+                        readonly default: string | undefined;
+                        readonly description: "Model for the visual agent's analyze_screenshot tool. When set, enables the tool.";
+                        readonly showInDialog: false;
+                    };
+                    readonly allowedDomains: {
+                        readonly type: "array";
+                        readonly label: "Allowed Domains";
+                        readonly category: "Advanced";
+                        readonly requiresRestart: true;
+                        readonly default: string[];
+                        readonly description: string;
+                        readonly showInDialog: false;
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly disableUserInput: {
+                        readonly type: "boolean";
+                        readonly label: "Disable User Input";
+                        readonly category: "Advanced";
+                        readonly requiresRestart: false;
+                        readonly default: true;
+                        readonly description: "Disable user input on browser window during automation.";
+                        readonly showInDialog: false;
+                    };
+                    readonly maxActionsPerTask: {
+                        readonly type: "number";
+                        readonly label: "Max Actions Per Task";
+                        readonly category: "Advanced";
+                        readonly requiresRestart: false;
+                        readonly default: 100;
+                        readonly description: "The maximum number of tool calls allowed per browser task. Enforcement is hard: the agent will be terminated when the limit is reached.";
+                        readonly showInDialog: false;
+                    };
+                    readonly confirmSensitiveActions: {
+                        readonly type: "boolean";
+                        readonly label: "Confirm Sensitive Actions";
+                        readonly category: "Advanced";
+                        readonly requiresRestart: true;
+                        readonly default: false;
+                        readonly description: "Require manual confirmation for sensitive browser actions (e.g., fill_form, evaluate_script).";
+                        readonly showInDialog: true;
+                    };
+                    readonly blockFileUploads: {
+                        readonly type: "boolean";
+                        readonly label: "Block File Uploads";
+                        readonly category: "Advanced";
+                        readonly requiresRestart: true;
+                        readonly default: false;
+                        readonly description: "Hard-block file upload requests from the browser agent.";
+                        readonly showInDialog: true;
+                    };
+                };
+            };
         };
     };
     readonly context: {
@@ -842,6 +1229,15 @@ declare const SETTINGS_SCHEMA: {
                 readonly description: "The format to use when importing memory.";
                 readonly showInDialog: false;
             };
+            readonly includeDirectoryTree: {
+                readonly type: "boolean";
+                readonly label: "Include Directory Tree";
+                readonly category: "Context";
+                readonly requiresRestart: false;
+                readonly default: true;
+                readonly description: "Whether to include the directory tree of the current working directory in the initial request to the model.";
+                readonly showInDialog: false;
+            };
             readonly discoveryMaxDirs: {
                 readonly type: "number";
                 readonly label: "Memory Discovery Max Dirs";
@@ -851,6 +1247,18 @@ declare const SETTINGS_SCHEMA: {
                 readonly description: "Maximum number of directories to search for memory.";
                 readonly showInDialog: true;
             };
+            readonly memoryBoundaryMarkers: {
+                readonly type: "array";
+                readonly label: "Memory Boundary Markers";
+                readonly category: "Context";
+                readonly requiresRestart: true;
+                readonly default: string[];
+                readonly description: string;
+                readonly showInDialog: false;
+                readonly items: {
+                    readonly type: "string";
+                };
+            };
             readonly includeDirectories: {
                 readonly type: "array";
                 readonly label: "Include Directories";
@@ -949,11 +1357,32 @@ declare const SETTINGS_SCHEMA: {
                 readonly label: "Sandbox";
                 readonly category: "Tools";
                 readonly requiresRestart: true;
-                readonly default: boolean | string | undefined;
-                readonly ref: "BooleanOrString";
+                readonly default: boolean | string | SandboxConfig | undefined;
+                readonly ref: "BooleanOrStringOrObject";
                 readonly description: string;
                 readonly showInDialog: false;
             };
+            readonly sandboxAllowedPaths: {
+                readonly type: "array";
+                readonly label: "Sandbox Allowed Paths";
+                readonly category: "Tools";
+                readonly requiresRestart: true;
+                readonly default: string[];
+                readonly description: "List of additional paths that the sandbox is allowed to access.";
+                readonly showInDialog: true;
+                readonly items: {
+                    readonly type: "string";
+                };
+            };
+            readonly sandboxNetworkAccess: {
+                readonly type: "boolean";
+                readonly label: "Sandbox Network Access";
+                readonly category: "Tools";
+                readonly requiresRestart: true;
+                readonly default: false;
+                readonly description: "Whether the sandbox is allowed to access the network.";
+                readonly showInDialog: true;
+            };
             readonly shell: {
                 readonly type: "object";
                 readonly label: "Shell";
@@ -972,6 +1401,25 @@ declare const SETTINGS_SCHEMA: {
                         readonly description: string;
                         readonly showInDialog: true;
                     };
+                    readonly backgroundCompletionBehavior: {
+                        readonly type: "enum";
+                        readonly label: "Background Completion Behavior";
+                        readonly category: "Tools";
+                        readonly requiresRestart: false;
+                        readonly default: "silent";
+                        readonly description: "Controls what happens when a background shell command finishes. 'silent' (default): quietly exits in background. 'inject': automatically returns output to agent. 'notify': shows brief message in chat.";
+                        readonly showInDialog: false;
+                        readonly options: readonly [{
+                            readonly label: "Silent";
+                            readonly value: "silent";
+                        }, {
+                            readonly label: "Inject";
+                            readonly value: "inject";
+                        }, {
+                            readonly label: "Notify";
+                            readonly value: "notify";
+                        }];
+                    };
                     readonly pager: {
                         readonly type: "string";
                         readonly label: "Pager";
@@ -986,7 +1434,7 @@ declare const SETTINGS_SCHEMA: {
                         readonly label: "Show Color";
                         readonly category: "Tools";
                         readonly requiresRestart: false;
-                        readonly default: false;
+                        readonly default: true;
                         readonly description: "Show color in shell output.";
                         readonly showInDialog: true;
                     };
@@ -1156,6 +1604,15 @@ declare const SETTINGS_SCHEMA: {
         readonly description: "Security-related settings.";
         readonly showInDialog: false;
         readonly properties: {
+            readonly toolSandboxing: {
+                readonly type: "boolean";
+                readonly label: "Tool Sandboxing";
+                readonly category: "Security";
+                readonly requiresRestart: true;
+                readonly default: false;
+                readonly description: "Tool-level sandboxing. Isolates individual tools instead of the entire CLI process.";
+                readonly showInDialog: true;
+            };
             readonly disableYoloMode: {
                 readonly type: "boolean";
                 readonly label: "Disable YOLO Mode";
@@ -1165,6 +1622,15 @@ declare const SETTINGS_SCHEMA: {
                 readonly description: "Disable YOLO mode, even if enabled by a flag.";
                 readonly showInDialog: true;
             };
+            readonly disableAlwaysAllow: {
+                readonly type: "boolean";
+                readonly label: "Disable Always Allow";
+                readonly category: "Security";
+                readonly requiresRestart: true;
+                readonly default: false;
+                readonly description: "Disable \"Always allow\" options in tool confirmation dialogs.";
+                readonly showInDialog: true;
+            };
             readonly enablePermanentToolApproval: {
                 readonly type: "boolean";
                 readonly label: "Allow Permanent Tool Approval";
@@ -1174,6 +1640,15 @@ declare const SETTINGS_SCHEMA: {
                 readonly description: "Enable the \"Allow for all future sessions\" option in tool confirmation dialogs.";
                 readonly showInDialog: true;
             };
+            readonly autoAddToPolicyByDefault: {
+                readonly type: "boolean";
+                readonly label: "Auto-add to Policy by Default";
+                readonly category: "Security";
+                readonly requiresRestart: false;
+                readonly default: false;
+                readonly description: string;
+                readonly showInDialog: true;
+            };
             readonly blockGitExtensions: {
                 readonly type: "boolean";
                 readonly label: "Blocks extensions from Git";
@@ -1297,6 +1772,15 @@ declare const SETTINGS_SCHEMA: {
                     };
                 };
             };
+            readonly enableConseca: {
+                readonly type: "boolean";
+                readonly label: "Enable Context-Aware Security";
+                readonly category: "Security";
+                readonly requiresRestart: true;
+                readonly default: false;
+                readonly description: "Enable the context-aware security checker. This feature uses an LLM to dynamically generate and enforce security policies for tool use based on your prompt, providing an additional layer of protection against unintended actions.";
+                readonly showInDialog: true;
+            };
         };
     };
     readonly advanced: {
@@ -1313,9 +1797,9 @@ declare const SETTINGS_SCHEMA: {
                 readonly label: "Auto Configure Max Old Space Size";
                 readonly category: "Advanced";
                 readonly requiresRestart: true;
-                readonly default: false;
+                readonly default: true;
                 readonly description: "Automatically configure Node.js memory limits";
-                readonly showInDialog: false;
+                readonly showInDialog: true;
             };
             readonly dnsResolutionOrder: {
                 readonly type: "string";
@@ -1441,50 +1925,31 @@ declare const SETTINGS_SCHEMA: {
         readonly description: "Setting to enable experimental features";
         readonly showInDialog: false;
         readonly properties: {
-            readonly toolOutputMasking: {
+            readonly adk: {
                 readonly type: "object";
-                readonly label: "Tool Output Masking";
+                readonly label: "ADK";
                 readonly category: "Experimental";
                 readonly requiresRestart: true;
-                readonly ignoreInDocs: true;
                 readonly default: {};
-                readonly description: "Advanced settings for tool output masking to manage context window efficiency.";
+                readonly description: "Settings for the Agent Development Kit (ADK).";
                 readonly showInDialog: false;
                 readonly properties: {
-                    readonly enabled: {
+                    readonly agentSessionNoninteractiveEnabled: {
                         readonly type: "boolean";
-                        readonly label: "Enable Tool Output Masking";
+                        readonly label: "Agent Session Non-interactive Enabled";
                         readonly category: "Experimental";
                         readonly requiresRestart: true;
                         readonly default: false;
-                        readonly description: "Enables tool output masking to save tokens.";
-                        readonly showInDialog: false;
-                    };
-                    readonly toolProtectionThreshold: {
-                        readonly type: "number";
-                        readonly label: "Tool Protection Threshold";
-                        readonly category: "Experimental";
-                        readonly requiresRestart: true;
-                        readonly default: 50000;
-                        readonly description: "Minimum number of tokens to protect from masking (most recent tool outputs).";
+                        readonly description: "Enable non-interactive agent sessions.";
                         readonly showInDialog: false;
                     };
-                    readonly minPrunableTokensThreshold: {
-                        readonly type: "number";
-                        readonly label: "Min Prunable Tokens Threshold";
-                        readonly category: "Experimental";
-                        readonly requiresRestart: true;
-                        readonly default: 30000;
-                        readonly description: "Minimum prunable tokens required to trigger a masking pass.";
-                        readonly showInDialog: false;
-                    };
-                    readonly protectLatestTurn: {
+                    readonly agentSessionInteractiveEnabled: {
                         readonly type: "boolean";
-                        readonly label: "Protect Latest Turn";
+                        readonly label: "Interactive Agent Session Enabled";
                         readonly category: "Experimental";
                         readonly requiresRestart: true;
-                        readonly default: true;
-                        readonly description: "Ensures the absolute latest turn is never masked, regardless of token count.";
+                        readonly default: false;
+                        readonly description: "Enable the agent session implementation for the interactive CLI.";
                         readonly showInDialog: false;
                     };
                 };
@@ -1494,10 +1959,19 @@ declare const SETTINGS_SCHEMA: {
                 readonly label: "Enable Agents";
                 readonly category: "Experimental";
                 readonly requiresRestart: true;
-                readonly default: false;
-                readonly description: "Enable local and remote subagents. Warning: Experimental feature, uses YOLO mode for subagents";
+                readonly default: true;
+                readonly description: "Enable local and remote subagents.";
                 readonly showInDialog: false;
             };
+            readonly worktrees: {
+                readonly type: "boolean";
+                readonly label: "Enable Git Worktrees";
+                readonly category: "Experimental";
+                readonly requiresRestart: true;
+                readonly default: false;
+                readonly description: "Enable automated Git worktree management for parallel work.";
+                readonly showInDialog: true;
+            };
             readonly extensionManagement: {
                 readonly type: "boolean";
                 readonly label: "Extension Management";
@@ -1525,6 +1999,15 @@ declare const SETTINGS_SCHEMA: {
                 readonly description: "Enable extension registry explore UI.";
                 readonly showInDialog: false;
             };
+            readonly extensionRegistryURI: {
+                readonly type: "string";
+                readonly label: "Extension Registry URI";
+                readonly category: "Experimental";
+                readonly requiresRestart: true;
+                readonly default: "https://geminicli.com/extensions.json";
+                readonly description: "The URI (web URL or local file path) of the extension registry.";
+                readonly showInDialog: false;
+            };
             readonly extensionReloading: {
                 readonly type: "boolean";
                 readonly label: "Extension Reloading";
@@ -1549,16 +2032,137 @@ declare const SETTINGS_SCHEMA: {
                 readonly category: "Experimental";
                 readonly requiresRestart: false;
                 readonly default: false;
-                readonly description: "Use OSC 52 sequence for pasting instead of clipboardy (useful for remote sessions).";
+                readonly description: "Use OSC 52 for pasting. This may be more robust than the default system when using remote terminal sessions (if your terminal is configured to allow it).";
                 readonly showInDialog: true;
             };
-            readonly plan: {
+            readonly useOSC52Copy: {
                 readonly type: "boolean";
-                readonly label: "Plan";
+                readonly label: "Use OSC 52 Copy";
+                readonly category: "Experimental";
+                readonly requiresRestart: false;
+                readonly default: false;
+                readonly description: "Use OSC 52 for copying. This may be more robust than the default system when using remote terminal sessions (if your terminal is configured to allow it).";
+                readonly showInDialog: true;
+            };
+            readonly taskTracker: {
+                readonly type: "boolean";
+                readonly label: "Task Tracker";
+                readonly category: "Experimental";
+                readonly requiresRestart: true;
+                readonly default: false;
+                readonly description: "Enable task tracker tools.";
+                readonly showInDialog: false;
+            };
+            readonly modelSteering: {
+                readonly type: "boolean";
+                readonly label: "Model Steering";
+                readonly category: "Experimental";
+                readonly requiresRestart: false;
+                readonly default: false;
+                readonly description: "Enable model steering (user hints) to guide the model during tool execution.";
+                readonly showInDialog: true;
+            };
+            readonly directWebFetch: {
+                readonly type: "boolean";
+                readonly label: "Direct Web Fetch";
+                readonly category: "Experimental";
+                readonly requiresRestart: true;
+                readonly default: false;
+                readonly description: "Enable web fetch behavior that bypasses LLM summarization.";
+                readonly showInDialog: true;
+            };
+            readonly dynamicModelConfiguration: {
+                readonly type: "boolean";
+                readonly label: "Dynamic Model Configuration";
+                readonly category: "Experimental";
+                readonly requiresRestart: true;
+                readonly default: false;
+                readonly description: "Enable dynamic model configuration (definitions, resolutions, and chains) via settings.";
+                readonly showInDialog: false;
+            };
+            readonly gemmaModelRouter: {
+                readonly type: "object";
+                readonly label: "Gemma Model Router";
+                readonly category: "Experimental";
+                readonly requiresRestart: true;
+                readonly default: {};
+                readonly description: "Enable Gemma model router (experimental).";
+                readonly showInDialog: false;
+                readonly properties: {
+                    readonly enabled: {
+                        readonly type: "boolean";
+                        readonly label: "Enable Gemma Model Router";
+                        readonly category: "Experimental";
+                        readonly requiresRestart: true;
+                        readonly default: false;
+                        readonly description: "Enable the Gemma Model Router (experimental). Requires a local endpoint serving Gemma via the Gemini API using LiteRT-LM shim.";
+                        readonly showInDialog: false;
+                    };
+                    readonly classifier: {
+                        readonly type: "object";
+                        readonly label: "Classifier";
+                        readonly category: "Experimental";
+                        readonly requiresRestart: true;
+                        readonly default: {};
+                        readonly description: "Classifier configuration.";
+                        readonly showInDialog: false;
+                        readonly properties: {
+                            readonly host: {
+                                readonly type: "string";
+                                readonly label: "Host";
+                                readonly category: "Experimental";
+                                readonly requiresRestart: true;
+                                readonly default: "http://localhost:9379";
+                                readonly description: "The host of the classifier.";
+                                readonly showInDialog: false;
+                            };
+                            readonly model: {
+                                readonly type: "string";
+                                readonly label: "Model";
+                                readonly category: "Experimental";
+                                readonly requiresRestart: true;
+                                readonly default: "gemma3-1b-gpu-custom";
+                                readonly description: "The model to use for the classifier. Only tested on `gemma3-1b-gpu-custom`.";
+                                readonly showInDialog: false;
+                            };
+                        };
+                    };
+                };
+            };
+            readonly memoryManager: {
+                readonly type: "boolean";
+                readonly label: "Memory Manager Agent";
+                readonly category: "Experimental";
+                readonly requiresRestart: true;
+                readonly default: false;
+                readonly description: "Replace the built-in save_memory tool with a memory manager subagent that supports adding, removing, de-duplicating, and organizing memories.";
+                readonly showInDialog: true;
+            };
+            readonly generalistProfile: {
+                readonly type: "boolean";
+                readonly label: "Use the generalist profile to manage agent contexts.";
+                readonly category: "Experimental";
+                readonly requiresRestart: true;
+                readonly default: false;
+                readonly description: "Suitable for general coding and software development tasks.";
+                readonly showInDialog: true;
+            };
+            readonly contextManagement: {
+                readonly type: "boolean";
+                readonly label: "Enable Context Management";
                 readonly category: "Experimental";
                 readonly requiresRestart: true;
                 readonly default: false;
-                readonly description: "Enable planning features (Plan Mode and tools).";
+                readonly description: "Enable logic for context management.";
+                readonly showInDialog: true;
+            };
+            readonly topicUpdateNarration: {
+                readonly type: "boolean";
+                readonly label: "Topic & Update Narration";
+                readonly category: "Experimental";
+                readonly requiresRestart: false;
+                readonly default: false;
+                readonly description: "Enable the experimental Topic & Update communication model for reduced chattiness and structured progress reporting.";
                 readonly showInDialog: true;
             };
         };
@@ -1813,6 +2417,159 @@ declare const SETTINGS_SCHEMA: {
             readonly mergeStrategy: MergeStrategy.CONCAT;
         };
     };
+    readonly contextManagement: {
+        readonly type: "object";
+        readonly label: "Context Management";
+        readonly category: "Experimental";
+        readonly requiresRestart: true;
+        readonly default: {};
+        readonly description: "Settings for agent history and tool distillation context management.";
+        readonly showInDialog: false;
+        readonly properties: {
+            readonly historyWindow: {
+                readonly type: "object";
+                readonly label: "History Window Settings";
+                readonly category: "Context Management";
+                readonly requiresRestart: true;
+                readonly default: {};
+                readonly showInDialog: false;
+                readonly properties: {
+                    readonly maxTokens: {
+                        readonly type: "number";
+                        readonly label: "Max Tokens";
+                        readonly category: "Context Management";
+                        readonly requiresRestart: true;
+                        readonly default: 150000;
+                        readonly description: "The number of tokens to allow before triggering compression.";
+                        readonly showInDialog: false;
+                    };
+                    readonly retainedTokens: {
+                        readonly type: "number";
+                        readonly label: "Retained Tokens";
+                        readonly category: "Context Management";
+                        readonly requiresRestart: true;
+                        readonly default: 40000;
+                        readonly description: "The number of tokens to always retain.";
+                        readonly showInDialog: false;
+                    };
+                };
+            };
+            readonly messageLimits: {
+                readonly type: "object";
+                readonly label: "Message Limits";
+                readonly category: "Context Management";
+                readonly requiresRestart: true;
+                readonly default: {};
+                readonly showInDialog: false;
+                readonly properties: {
+                    readonly normalMaxTokens: {
+                        readonly type: "number";
+                        readonly label: "Normal Maximum Tokens";
+                        readonly category: "Context Management";
+                        readonly requiresRestart: true;
+                        readonly default: 2500;
+                        readonly description: "The target number of tokens to budget for a normal conversation turn.";
+                        readonly showInDialog: false;
+                    };
+                    readonly retainedMaxTokens: {
+                        readonly type: "number";
+                        readonly label: "Retained Maximum Tokens";
+                        readonly category: "Context Management";
+                        readonly requiresRestart: true;
+                        readonly default: 12000;
+                        readonly description: "The maximum number of tokens a single conversation turn can consume before truncation.";
+                        readonly showInDialog: false;
+                    };
+                    readonly normalizationHeadRatio: {
+                        readonly type: "number";
+                        readonly label: "Normalization Head Ratio";
+                        readonly category: "Context Management";
+                        readonly requiresRestart: true;
+                        readonly default: 0.25;
+                        readonly description: "The ratio of tokens to retain from the beginning of a truncated message (0.0 to 1.0).";
+                        readonly showInDialog: false;
+                    };
+                };
+            };
+            readonly tools: {
+                readonly type: "object";
+                readonly label: "Context Management Tools";
+                readonly category: "Context Management";
+                readonly requiresRestart: true;
+                readonly default: {};
+                readonly showInDialog: false;
+                readonly properties: {
+                    readonly distillation: {
+                        readonly type: "object";
+                        readonly label: "Tool Distillation";
+                        readonly category: "Context Management";
+                        readonly requiresRestart: true;
+                        readonly default: {};
+                        readonly showInDialog: false;
+                        readonly properties: {
+                            readonly maxOutputTokens: {
+                                readonly type: "number";
+                                readonly label: "Max Output Tokens";
+                                readonly category: "Context Management";
+                                readonly requiresRestart: true;
+                                readonly default: 10000;
+                                readonly description: "Maximum tokens to show to the model when truncating large tool outputs.";
+                                readonly showInDialog: false;
+                            };
+                            readonly summarizationThresholdTokens: {
+                                readonly type: "number";
+                                readonly label: "Tool Summarization Threshold";
+                                readonly category: "Context Management";
+                                readonly requiresRestart: true;
+                                readonly default: 20000;
+                                readonly description: "Threshold above which truncated tool outputs will be summarized by an LLM.";
+                                readonly showInDialog: false;
+                            };
+                        };
+                    };
+                    readonly outputMasking: {
+                        readonly type: "object";
+                        readonly label: "Tool Output Masking";
+                        readonly category: "Context Management";
+                        readonly requiresRestart: true;
+                        readonly ignoreInDocs: false;
+                        readonly default: {};
+                        readonly description: "Advanced settings for tool output masking to manage context window efficiency.";
+                        readonly showInDialog: false;
+                        readonly properties: {
+                            readonly protectionThresholdTokens: {
+                                readonly type: "number";
+                                readonly label: "Tool Protection Threshold (Tokens)";
+                                readonly category: "Context Management";
+                                readonly requiresRestart: true;
+                                readonly default: 50000;
+                                readonly description: "Minimum number of tokens to protect from masking (most recent tool outputs).";
+                                readonly showInDialog: false;
+                            };
+                            readonly minPrunableThresholdTokens: {
+                                readonly type: "number";
+                                readonly label: "Min Prunable Tokens Threshold";
+                                readonly category: "Context Management";
+                                readonly requiresRestart: true;
+                                readonly default: 30000;
+                                readonly description: "Minimum prunable tokens required to trigger a masking pass.";
+                                readonly showInDialog: false;
+                            };
+                            readonly protectLatestTurn: {
+                                readonly type: "boolean";
+                                readonly label: "Protect Latest Turn";
+                                readonly category: "Context Management";
+                                readonly requiresRestart: true;
+                                readonly default: true;
+                                readonly description: "Ensures the absolute latest turn is never masked, regardless of token count.";
+                                readonly showInDialog: false;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
     readonly admin: {
         readonly type: "object";
         readonly label: "Admin";
@@ -1829,7 +2586,7 @@ declare const SETTINGS_SCHEMA: {
                 readonly category: "Admin";
                 readonly requiresRestart: false;
                 readonly default: false;
-                readonly description: "If true, disallows yolo mode from being used.";
+                readonly description: "If true, disallows YOLO mode and \"Always allow\" options from being used.";
                 readonly showInDialog: false;
                 readonly mergeStrategy: MergeStrategy.REPLACE;
             };
@@ -1881,7 +2638,7 @@ declare const SETTINGS_SCHEMA: {
                         readonly category: "Admin";
                         readonly requiresRestart: false;
                         readonly default: Record<string, MCPServerConfig>;
-                        readonly description: "Admin-configured MCP servers.";
+                        readonly description: "Admin-configured MCP servers (allowlist).";
                         readonly showInDialog: false;
                         readonly mergeStrategy: MergeStrategy.REPLACE;
                         readonly additionalProperties: {
@@ -1889,6 +2646,20 @@ declare const SETTINGS_SCHEMA: {
                             readonly ref: "MCPServerConfig";
                         };
                     };
+                    readonly requiredConfig: {
+                        readonly type: "object";
+                        readonly label: "Required MCP Config";
+                        readonly category: "Admin";
+                        readonly requiresRestart: false;
+                        readonly default: Record<string, RequiredMcpServerConfig>;
+                        readonly description: "Admin-required MCP servers that are always injected.";
+                        readonly showInDialog: false;
+                        readonly mergeStrategy: MergeStrategy.REPLACE;
+                        readonly additionalProperties: {
+                            readonly type: "object";
+                            readonly ref: "RequiredMcpServerConfig";
+                        };
+                    };
                 };
             };
             readonly skills: {
@@ -1923,12 +2694,12 @@ export declare function getSettingsSchema(): SettingsSchemaType;
 type InferSettings<T extends SettingsSchema> = {
     -readonly [K in keyof T]?: T[K] extends {
         properties: SettingsSchema;
-    } ? InferSettings<T[K]['properties']> : T[K]['type'] extends 'enum' ? T[K]['options'] extends readonly SettingEnumOption[] ? T[K]['options'][number]['value'] : T[K]['default'] : T[K]['default'] extends boolean ? boolean : T[K]['default'];
+    } ? InferSettings<T[K]['properties']> : T[K]['type'] extends 'enum' ? T[K]['options'] extends readonly SettingEnumOption[] ? T[K]['options'][number]['value'] : T[K]['default'] : T[K]['default'] extends boolean ? boolean : T[K]['default'] extends string ? string : T[K]['default'] extends ReadonlyArray<infer U> ? U[] : T[K]['default'];
 };
 type InferMergedSettings<T extends SettingsSchema> = {
     -readonly [K in keyof T]-?: T[K] extends {
         properties: SettingsSchema;
-    } ? InferMergedSettings<T[K]['properties']> : T[K]['type'] extends 'enum' ? T[K]['options'] extends readonly SettingEnumOption[] ? T[K]['options'][number]['value'] : T[K]['default'] : T[K]['default'] extends boolean ? boolean : T[K]['default'];
+    } ? InferMergedSettings<T[K]['properties']> : T[K]['type'] extends 'enum' ? T[K]['options'] extends readonly SettingEnumOption[] ? T[K]['options'][number]['value'] : T[K]['default'] : T[K]['default'] extends boolean ? boolean : T[K]['default'] extends string ? string : T[K]['default'] extends ReadonlyArray<infer U> ? U[] : T[K]['default'];
 };
 export type Settings = InferSettings<SettingsSchemaType>;
 export type MergedSettings = InferMergedSettings<SettingsSchemaType>;