@machina.ai/cell-cli 1.38.1-rc2 → 1.40.1-rc2

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 RequiredMcpServerConfig, type BugCommandSettings, type TelemetrySettings, type AuthType, type AgentOverride, type CustomTheme, type SandboxConfig } from '@google/gemini-cli-core';
+import { type MCPServerConfig, type RequiredMcpServerConfig, type BugCommandSettings, type TelemetrySettings, type AuthType, type AgentOverride, type CustomTheme, type SandboxConfig, type VertexAiRoutingConfig } 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;
@@ -213,13 +213,35 @@ declare const SETTINGS_SCHEMA: {
             };
             readonly enableNotifications: {
                 readonly type: "boolean";
-                readonly label: "Enable Notifications";
+                readonly label: "Enable Terminal Notifications";
                 readonly category: "General";
                 readonly requiresRestart: false;
                 readonly default: false;
-                readonly description: "Enable run-event notifications for action-required prompts and session completion.";
+                readonly description: "Enable terminal run-event notifications for action-required prompts and session completion.";
                 readonly showInDialog: true;
             };
+            readonly notificationMethod: {
+                readonly type: "enum";
+                readonly label: "Terminal Notification Method";
+                readonly category: "General";
+                readonly requiresRestart: false;
+                readonly default: "auto";
+                readonly description: "How to send terminal notifications.";
+                readonly showInDialog: true;
+                readonly options: readonly [{
+                    readonly value: "auto";
+                    readonly label: "Auto";
+                }, {
+                    readonly value: "osc9";
+                    readonly label: "OSC 9";
+                }, {
+                    readonly value: "osc777";
+                    readonly label: "OSC 777";
+                }, {
+                    readonly value: "bell";
+                    readonly label: "Bell";
+                }];
+            };
             readonly checkpointing: {
                 readonly type: "object";
                 readonly label: "Checkpointing";
@@ -352,6 +374,15 @@ declare const SETTINGS_SCHEMA: {
                 };
                 readonly description: "Settings for automatic session cleanup.";
             };
+            readonly topicUpdateNarration: {
+                readonly type: "boolean";
+                readonly label: "Topic & Update Narration";
+                readonly category: "General";
+                readonly requiresRestart: false;
+                readonly default: true;
+                readonly description: "Enable the Topic & Update communication model for reduced chattiness and structured progress reporting.";
+                readonly showInDialog: true;
+            };
         };
     };
     readonly output: {
@@ -390,6 +421,15 @@ declare const SETTINGS_SCHEMA: {
         readonly description: "User interface settings.";
         readonly showInDialog: false;
         readonly properties: {
+            readonly debugRainbow: {
+                readonly type: "boolean";
+                readonly label: "Debug Rainbow";
+                readonly category: "UI";
+                readonly requiresRestart: true;
+                readonly default: false;
+                readonly description: "Enable debug rainbow rendering. Only useful for debugging rendering bugs and performance issues.";
+                readonly showInDialog: false;
+            };
             readonly theme: {
                 readonly type: "string";
                 readonly label: "Theme";
@@ -898,6 +938,49 @@ declare const SETTINGS_SCHEMA: {
                     readonly label: "Never use credits";
                 }];
             };
+            readonly vertexAi: {
+                readonly type: "object";
+                readonly label: "Vertex AI";
+                readonly category: "Advanced";
+                readonly requiresRestart: true;
+                readonly default: VertexAiRoutingConfig | undefined;
+                readonly description: "Vertex AI request routing settings.";
+                readonly showInDialog: false;
+                readonly properties: {
+                    readonly requestType: {
+                        readonly type: "enum";
+                        readonly label: "Vertex AI Request Type";
+                        readonly category: "Advanced";
+                        readonly requiresRestart: true;
+                        readonly default: VertexAiRoutingConfig["requestType"];
+                        readonly description: "Sets the X-Vertex-AI-LLM-Request-Type header for Vertex AI requests.";
+                        readonly showInDialog: false;
+                        readonly options: readonly [{
+                            readonly value: "dedicated";
+                            readonly label: "Dedicated";
+                        }, {
+                            readonly value: "shared";
+                            readonly label: "Shared";
+                        }];
+                    };
+                    readonly sharedRequestType: {
+                        readonly type: "enum";
+                        readonly label: "Vertex AI Shared Request Type";
+                        readonly category: "Advanced";
+                        readonly requiresRestart: true;
+                        readonly default: VertexAiRoutingConfig["sharedRequestType"];
+                        readonly description: "Sets the X-Vertex-AI-LLM-Shared-Request-Type header for Vertex AI requests.";
+                        readonly showInDialog: false;
+                        readonly options: readonly [{
+                            readonly value: "priority";
+                            readonly label: "Priority";
+                        }, {
+                            readonly value: "flex";
+                            readonly label: "Flex";
+                        }];
+                    };
+                };
+            };
         };
     };
     readonly model: {
@@ -1308,6 +1391,15 @@ declare const SETTINGS_SCHEMA: {
                         readonly description: "Respect .geminiignore files when searching.";
                         readonly showInDialog: true;
                     };
+                    readonly enableFileWatcher: {
+                        readonly type: "boolean";
+                        readonly label: "Enable File Watcher";
+                        readonly category: "Context";
+                        readonly requiresRestart: true;
+                        readonly default: false;
+                        readonly description: string;
+                        readonly showInDialog: false;
+                    };
                     readonly enableRecursiveFileSearch: {
                         readonly type: "boolean";
                         readonly label: "Enable Recursive File Search";
@@ -1482,6 +1574,18 @@ declare const SETTINGS_SCHEMA: {
                     readonly type: "string";
                 };
             };
+            readonly confirmationRequired: {
+                readonly type: "array";
+                readonly label: "Confirmation Required";
+                readonly category: "Advanced";
+                readonly requiresRestart: true;
+                readonly default: string[] | undefined;
+                readonly description: string;
+                readonly showInDialog: false;
+                readonly items: {
+                    readonly type: "string";
+                };
+            };
             readonly exclude: {
                 readonly type: "array";
                 readonly label: "Exclude Tools";
@@ -1798,7 +1902,7 @@ declare const SETTINGS_SCHEMA: {
                 readonly category: "Advanced";
                 readonly requiresRestart: true;
                 readonly default: true;
-                readonly description: "Automatically configure Node.js memory limits";
+                readonly description: "Automatically configure Node.js memory limits. Note: Because memory is allocated during the initial process boot, this setting is only read from the global user settings file and ignores workspace-level overrides.";
                 readonly showInDialog: true;
             };
             readonly dnsResolutionOrder: {
@@ -2022,8 +2126,8 @@ declare const SETTINGS_SCHEMA: {
                 readonly label: "JIT Context Loading";
                 readonly category: "Experimental";
                 readonly requiresRestart: true;
-                readonly default: false;
-                readonly description: "Enable Just-In-Time (JIT) context loading.";
+                readonly default: true;
+                readonly description: "Enable Just-In-Time (JIT) context loading. Defaults to true; set to false to opt out and load all GEMINI.md files into the system instruction up-front.";
                 readonly showInDialog: false;
             };
             readonly useOSC52Paste: {
@@ -2096,6 +2200,24 @@ declare const SETTINGS_SCHEMA: {
                         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: true;
+                    };
+                    readonly autoStartServer: {
+                        readonly type: "boolean";
+                        readonly label: "Auto-start LiteRT Server";
+                        readonly category: "Experimental";
+                        readonly requiresRestart: true;
+                        readonly default: false;
+                        readonly description: "Automatically start the LiteRT-LM server when Cell CLI starts and the Gemma router is enabled.";
+                        readonly showInDialog: true;
+                    };
+                    readonly binaryPath: {
+                        readonly type: "string";
+                        readonly label: "LiteRT Binary Path";
+                        readonly category: "Experimental";
+                        readonly requiresRestart: true;
+                        readonly default: "";
+                        readonly description: "Custom path to the LiteRT-LM binary. Leave empty to use the default location (~/.cell-cli/bin/litert/).";
                         readonly showInDialog: false;
                     };
                     readonly classifier: {
@@ -2129,13 +2251,22 @@ declare const SETTINGS_SCHEMA: {
                     };
                 };
             };
-            readonly memoryManager: {
+            readonly memoryV2: {
+                readonly type: "boolean";
+                readonly label: "Memory v2";
+                readonly category: "Experimental";
+                readonly requiresRestart: true;
+                readonly default: true;
+                readonly description: "Disable the built-in save_memory tool and let the main agent persist project context by editing markdown files directly with edit/write_file. Route facts across four tiers: team-shared conventions go to project GEMINI.md files, project-specific personal notes go to the per-project private memory folder (MEMORY.md as index + sibling .md files for detail), and cross-project personal preferences go to the global ~/.cell-cli/GEMINI.md (the only file under ~/.cell-cli/ that the agent can edit — settings, credentials, etc. remain off-limits). Set to false to fall back to the legacy save_memory tool.";
+                readonly showInDialog: true;
+            };
+            readonly autoMemory: {
                 readonly type: "boolean";
-                readonly label: "Memory Manager Agent";
+                readonly label: "Auto Memory";
                 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 description: "Automatically extract reusable skills from past sessions in the background. Review results with /memory inbox.";
                 readonly showInDialog: true;
             };
             readonly generalistProfile: {
@@ -2162,8 +2293,8 @@ declare const SETTINGS_SCHEMA: {
                 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;
+                readonly description: "Deprecated: Use general.topicUpdateNarration instead.";
+                readonly showInDialog: false;
             };
         };
     };

package/dist/src/config/settingsSchema.js

@@ -162,13 +162,28 @@ const SETTINGS_SCHEMA = {
             },
             enableNotifications: {
                 type: 'boolean',
-                label: 'Enable Notifications',
+                label: 'Enable Terminal Notifications',
                 category: 'General',
                 requiresRestart: false,
                 default: false,
-                description: 'Enable run-event notifications for action-required prompts and session completion.',
+                description: 'Enable terminal run-event notifications for action-required prompts and session completion.',
                 showInDialog: true,
             },
+            notificationMethod: {
+                type: 'enum',
+                label: 'Terminal Notification Method',
+                category: 'General',
+                requiresRestart: false,
+                default: 'auto',
+                description: 'How to send terminal notifications.',
+                showInDialog: true,
+                options: [
+                    { value: 'auto', label: 'Auto' },
+                    { value: 'osc9', label: 'OSC 9' },
+                    { value: 'osc777', label: 'OSC 777' },
+                    { value: 'bell', label: 'Bell' },
+                ],
+            },
             checkpointing: {
                 type: 'object',
                 label: 'Checkpointing',
@@ -301,6 +316,15 @@ const SETTINGS_SCHEMA = {
                 },
                 description: 'Settings for automatic session cleanup.',
             },
+            topicUpdateNarration: {
+                type: 'boolean',
+                label: 'Topic & Update Narration',
+                category: 'General',
+                requiresRestart: false,
+                default: true,
+                description: 'Enable the Topic & Update communication model for reduced chattiness and structured progress reporting.',
+                showInDialog: true,
+            },
         },
     },
     output: {
@@ -336,6 +360,15 @@ const SETTINGS_SCHEMA = {
         description: 'User interface settings.',
         showInDialog: false,
         properties: {
+            debugRainbow: {
+                type: 'boolean',
+                label: 'Debug Rainbow',
+                category: 'UI',
+                requiresRestart: true,
+                default: false,
+                description: 'Enable debug rainbow rendering. Only useful for debugging rendering bugs and performance issues.',
+                showInDialog: false,
+            },
             theme: {
                 type: 'string',
                 label: 'Theme',
@@ -829,6 +862,43 @@ const SETTINGS_SCHEMA = {
                     { value: 'never', label: 'Never use credits' },
                 ],
             },
+            vertexAi: {
+                type: 'object',
+                label: 'Vertex AI',
+                category: 'Advanced',
+                requiresRestart: true,
+                default: undefined,
+                description: 'Vertex AI request routing settings.',
+                showInDialog: false,
+                properties: {
+                    requestType: {
+                        type: 'enum',
+                        label: 'Vertex AI Request Type',
+                        category: 'Advanced',
+                        requiresRestart: true,
+                        default: undefined,
+                        description: 'Sets the X-Vertex-AI-LLM-Request-Type header for Vertex AI requests.',
+                        showInDialog: false,
+                        options: [
+                            { value: 'dedicated', label: 'Dedicated' },
+                            { value: 'shared', label: 'Shared' },
+                        ],
+                    },
+                    sharedRequestType: {
+                        type: 'enum',
+                        label: 'Vertex AI Shared Request Type',
+                        category: 'Advanced',
+                        requiresRestart: true,
+                        default: undefined,
+                        description: 'Sets the X-Vertex-AI-LLM-Shared-Request-Type header for Vertex AI requests.',
+                        showInDialog: false,
+                        options: [
+                            { value: 'priority', label: 'Priority' },
+                            { value: 'flex', label: 'Flex' },
+                        ],
+                    },
+                },
+            },
         },
     },
     model: {
@@ -1241,6 +1311,17 @@ const SETTINGS_SCHEMA = {
                         description: 'Respect .geminiignore files when searching.',
                         showInDialog: true,
                     },
+                    enableFileWatcher: {
+                        type: 'boolean',
+                        label: 'Enable File Watcher',
+                        category: 'Context',
+                        requiresRestart: true,
+                        default: false,
+                        description: oneLine `
+              Enable file watcher updates for @ file suggestions (experimental).
+            `,
+                        showInDialog: false,
+                    },
                     enableRecursiveFileSearch: {
                         type: 'boolean',
                         label: 'Enable Recursive File Search',
@@ -1414,6 +1495,19 @@ const SETTINGS_SCHEMA = {
           Tool names that bypass the confirmation dialog.
           Useful for trusted commands (for example ["run_shell_command(git)", "run_shell_command(npm test)"]).
           See shell tool command restrictions for matching details.
+        `,
+                showInDialog: false,
+                items: { type: 'string' },
+            },
+            confirmationRequired: {
+                type: 'array',
+                label: 'Confirmation Required',
+                category: 'Advanced',
+                requiresRestart: true,
+                default: undefined,
+                description: oneLine `
+          Tool names that always require user confirmation.
+          Takes precedence over allowed tools and core tool allowlists.
         `,
                 showInDialog: false,
                 items: { type: 'string' },
@@ -1731,7 +1825,7 @@ const SETTINGS_SCHEMA = {
                 category: 'Advanced',
                 requiresRestart: true,
                 default: true,
-                description: 'Automatically configure Node.js memory limits',
+                description: 'Automatically configure Node.js memory limits. Note: Because memory is allocated during the initial process boot, this setting is only read from the global user settings file and ignores workspace-level overrides.',
                 showInDialog: true,
             },
             dnsResolutionOrder: {
@@ -1954,8 +2048,8 @@ const SETTINGS_SCHEMA = {
                 label: 'JIT Context Loading',
                 category: 'Experimental',
                 requiresRestart: true,
-                default: false,
-                description: 'Enable Just-In-Time (JIT) context loading.',
+                default: true,
+                description: 'Enable Just-In-Time (JIT) context loading. Defaults to true; set to false to opt out and load all GEMINI.md files into the system instruction up-front.',
                 showInDialog: false,
             },
             useOSC52Paste: {
@@ -2028,6 +2122,24 @@ const SETTINGS_SCHEMA = {
                         requiresRestart: true,
                         default: false,
                         description: 'Enable the Gemma Model Router (experimental). Requires a local endpoint serving Gemma via the Gemini API using LiteRT-LM shim.',
+                        showInDialog: true,
+                    },
+                    autoStartServer: {
+                        type: 'boolean',
+                        label: 'Auto-start LiteRT Server',
+                        category: 'Experimental',
+                        requiresRestart: true,
+                        default: false,
+                        description: 'Automatically start the LiteRT-LM server when Cell CLI starts and the Gemma router is enabled.',
+                        showInDialog: true,
+                    },
+                    binaryPath: {
+                        type: 'string',
+                        label: 'LiteRT Binary Path',
+                        category: 'Experimental',
+                        requiresRestart: true,
+                        default: '',
+                        description: 'Custom path to the LiteRT-LM binary. Leave empty to use the default location (~/.cell-cli/bin/litert/).',
                         showInDialog: false,
                     },
                     classifier: {
@@ -2061,13 +2173,22 @@ const SETTINGS_SCHEMA = {
                     },
                 },
             },
-            memoryManager: {
+            memoryV2: {
                 type: 'boolean',
-                label: 'Memory Manager Agent',
+                label: 'Memory v2',
+                category: 'Experimental',
+                requiresRestart: true,
+                default: true,
+                description: 'Disable the built-in save_memory tool and let the main agent persist project context by editing markdown files directly with edit/write_file. Route facts across four tiers: team-shared conventions go to project GEMINI.md files, project-specific personal notes go to the per-project private memory folder (MEMORY.md as index + sibling .md files for detail), and cross-project personal preferences go to the global ~/.cell-cli/GEMINI.md (the only file under ~/.cell-cli/ that the agent can edit — settings, credentials, etc. remain off-limits). Set to false to fall back to the legacy save_memory tool.',
+                showInDialog: true,
+            },
+            autoMemory: {
+                type: 'boolean',
+                label: 'Auto Memory',
                 category: 'Experimental',
                 requiresRestart: true,
                 default: false,
-                description: 'Replace the built-in save_memory tool with a memory manager subagent that supports adding, removing, de-duplicating, and organizing memories.',
+                description: 'Automatically extract reusable skills from past sessions in the background. Review results with /memory inbox.',
                 showInDialog: true,
             },
             generalistProfile: {
@@ -2094,8 +2215,8 @@ const SETTINGS_SCHEMA = {
                 category: 'Experimental',
                 requiresRestart: false,
                 default: false,
-                description: 'Enable the experimental Topic & Update communication model for reduced chattiness and structured progress reporting.',
-                showInDialog: true,
+                description: 'Deprecated: Use general.topicUpdateNarration instead.',
+                showInDialog: false,
             },
         },
     },
@@ -2793,6 +2914,10 @@ export const SETTINGS_SCHEMA_DEFINITIONS = {
                 description: 'Protocol for OTLP exporters.',
                 enum: ['grpc', 'http'],
             },
+            traces: {
+                type: 'boolean',
+                description: 'Whether detailed traces with large attributes are captured.',
+            },
             logPrompts: {
                 type: 'boolean',
                 description: 'Whether prompts are logged in telemetry payloads.',