@machina.ai/cell-cli 1.36.0-rc1 → 1.38.1-rc2

package/dist/src/config/settingsSchema.js

@@ -166,7 +166,7 @@ const SETTINGS_SCHEMA = {
                 category: 'General',
                 requiresRestart: false,
                 default: false,
-                description: 'Enable run-event notifications for action-required prompts and session completion. Currently macOS only.',
+                description: 'Enable run-event notifications for action-required prompts and session completion.',
                 showInDialog: true,
             },
             checkpointing: {
@@ -198,13 +198,22 @@ const SETTINGS_SCHEMA = {
                 description: 'Planning features configuration.',
                 showInDialog: false,
                 properties: {
+                    enabled: {
+                        type: 'boolean',
+                        label: 'Enable Plan Mode',
+                        category: 'General',
+                        requiresRestart: true,
+                        default: true,
+                        description: 'Enable Plan Mode for read-only safety during planning.',
+                        showInDialog: true,
+                    },
                     directory: {
                         type: 'string',
                         label: 'Plan Directory',
                         category: 'General',
                         requiresRestart: true,
                         default: undefined,
-                        description: 'The directory where planning artifacts are stored. If not specified, defaults to the system temporary directory.',
+                        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.',
                         showInDialog: true,
                     },
                     modelRouting: {
@@ -452,6 +461,15 @@ const SETTINGS_SCHEMA = {
                 description: 'Show the "? for shortcuts" hint above the input.',
                 showInDialog: true,
             },
+            compactToolOutput: {
+                type: 'boolean',
+                label: 'Compact Tool Output',
+                category: 'UI',
+                requiresRestart: false,
+                default: true,
+                description: 'Display tool outputs (like directory listings and file reads) in a compact, structured format.',
+                showInDialog: true,
+            },
             hideBanner: {
                 type: 'boolean',
                 label: 'Hide Banner',
@@ -608,6 +626,24 @@ const SETTINGS_SCHEMA = {
                 description: 'Use an alternate screen buffer for the UI, preserving shell history.',
                 showInDialog: true,
             },
+            renderProcess: {
+                type: 'boolean',
+                label: 'Render Process',
+                category: 'UI',
+                requiresRestart: true,
+                default: true,
+                description: 'Enable Ink render process for the UI.',
+                showInDialog: true,
+            },
+            terminalBuffer: {
+                type: 'boolean',
+                label: 'Terminal Buffer',
+                category: 'UI',
+                requiresRestart: true,
+                default: false,
+                description: 'Use the new terminal buffer architecture for rendering.',
+                showInDialog: true,
+            },
             useBackgroundColor: {
                 type: 'boolean',
                 label: 'Use Background Color',
@@ -640,8 +676,8 @@ const SETTINGS_SCHEMA = {
                 label: 'Loading Phrases',
                 category: 'UI',
                 requiresRestart: false,
-                default: 'tips',
-                description: 'What to show while the model is working: tips, witty comments, both, or nothing.',
+                default: 'off',
+                description: 'What to show while the model is working: tips, witty comments, all, or off.',
                 showInDialog: true,
                 options: [
                     { value: 'tips', label: 'Tips' },
@@ -1038,7 +1074,7 @@ const SETTINGS_SCHEMA = {
                         category: 'Advanced',
                         requiresRestart: true,
                         default: undefined,
-                        description: 'Model override for the visual agent.',
+                        description: "Model for the visual agent's analyze_screenshot tool. When set, enables the tool.",
                         showInDialog: false,
                     },
                     allowedDomains: {
@@ -1063,6 +1099,15 @@ const SETTINGS_SCHEMA = {
                         description: 'Disable user input on browser window during automation.',
                         showInDialog: false,
                     },
+                    maxActionsPerTask: {
+                        type: 'number',
+                        label: 'Max Actions Per Task',
+                        category: 'Advanced',
+                        requiresRestart: false,
+                        default: 100,
+                        description: 'The maximum number of tool calls allowed per browser task. Enforcement is hard: the agent will be terminated when the limit is reached.',
+                        showInDialog: false,
+                    },
                     confirmSensitiveActions: {
                         type: 'boolean',
                         label: 'Confirm Sensitive Actions',
@@ -1131,6 +1176,18 @@ const SETTINGS_SCHEMA = {
                 description: 'Maximum number of directories to search for memory.',
                 showInDialog: true,
             },
+            memoryBoundaryMarkers: {
+                type: 'array',
+                label: 'Memory Boundary Markers',
+                category: 'Context',
+                requiresRestart: true,
+                default: ['.git'],
+                description: 'File or directory names that mark the boundary for GEMINI.md discovery. ' +
+                    'The upward traversal stops at the first directory containing any of these markers. ' +
+                    'An empty array disables parent traversal.',
+                showInDialog: false,
+                items: { type: 'string' },
+            },
             includeDirectories: {
                 type: 'array',
                 label: 'Include Directories',
@@ -1282,6 +1339,20 @@ const SETTINGS_SCHEMA = {
             `,
                         showInDialog: true,
                     },
+                    backgroundCompletionBehavior: {
+                        type: 'enum',
+                        label: 'Background Completion Behavior',
+                        category: 'Tools',
+                        requiresRestart: false,
+                        default: 'silent',
+                        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.",
+                        showInDialog: false,
+                        options: [
+                            { label: 'Silent', value: 'silent' },
+                            { label: 'Inject', value: 'inject' },
+                            { label: 'Notify', value: 'notify' },
+                        ],
+                    },
                     pager: {
                         type: 'string',
                         label: 'Pager',
@@ -1296,7 +1367,7 @@ const SETTINGS_SCHEMA = {
                         label: 'Show Color',
                         category: 'Tools',
                         requiresRestart: false,
-                        default: false,
+                        default: true,
                         description: 'Show color in shell output.',
                         showInDialog: true,
                     },
@@ -1473,9 +1544,9 @@ const SETTINGS_SCHEMA = {
                 type: 'boolean',
                 label: 'Tool Sandboxing',
                 category: 'Security',
-                requiresRestart: false,
+                requiresRestart: true,
                 default: false,
-                description: 'Experimental tool-level sandboxing (implementation in progress).',
+                description: 'Tool-level sandboxing. Isolates individual tools instead of the entire CLI process.',
                 showInDialog: true,
             },
             disableYoloMode: {
@@ -1659,7 +1730,7 @@ const SETTINGS_SCHEMA = {
                 label: 'Auto Configure Max Old Space Size',
                 category: 'Advanced',
                 requiresRestart: true,
-                default: false,
+                default: true,
                 description: 'Automatically configure Node.js memory limits',
                 showInDialog: true,
             },
@@ -1786,50 +1857,31 @@ const SETTINGS_SCHEMA = {
         description: 'Setting to enable experimental features',
         showInDialog: false,
         properties: {
-            toolOutputMasking: {
+            adk: {
                 type: 'object',
-                label: 'Tool Output Masking',
+                label: 'ADK',
                 category: 'Experimental',
                 requiresRestart: true,
-                ignoreInDocs: false,
                 default: {},
-                description: 'Advanced settings for tool output masking to manage context window efficiency.',
+                description: 'Settings for the Agent Development Kit (ADK).',
                 showInDialog: false,
                 properties: {
-                    enabled: {
+                    agentSessionNoninteractiveEnabled: {
                         type: 'boolean',
-                        label: 'Enable Tool Output Masking',
+                        label: 'Agent Session Non-interactive Enabled',
                         category: 'Experimental',
                         requiresRestart: true,
-                        default: true,
-                        description: 'Enables tool output masking to save tokens.',
-                        showInDialog: true,
-                    },
-                    toolProtectionThreshold: {
-                        type: 'number',
-                        label: 'Tool Protection Threshold',
-                        category: 'Experimental',
-                        requiresRestart: true,
-                        default: 50000,
-                        description: 'Minimum number of tokens to protect from masking (most recent tool outputs).',
-                        showInDialog: false,
-                    },
-                    minPrunableTokensThreshold: {
-                        type: 'number',
-                        label: 'Min Prunable Tokens Threshold',
-                        category: 'Experimental',
-                        requiresRestart: true,
-                        default: 30000,
-                        description: 'Minimum prunable tokens required to trigger a masking pass.',
+                        default: false,
+                        description: 'Enable non-interactive agent sessions.',
                         showInDialog: false,
                     },
-                    protectLatestTurn: {
+                    agentSessionInteractiveEnabled: {
                         type: 'boolean',
-                        label: 'Protect Latest Turn',
+                        label: 'Interactive Agent Session Enabled',
                         category: 'Experimental',
                         requiresRestart: true,
-                        default: true,
-                        description: 'Ensures the absolute latest turn is never masked, regardless of token count.',
+                        default: false,
+                        description: 'Enable the agent session implementation for the interactive CLI.',
                         showInDialog: false,
                     },
                 },
@@ -1924,15 +1976,6 @@ const SETTINGS_SCHEMA = {
                 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).',
                 showInDialog: true,
             },
-            plan: {
-                type: 'boolean',
-                label: 'Plan',
-                category: 'Experimental',
-                requiresRestart: true,
-                default: true,
-                description: 'Enable Plan Mode.',
-                showInDialog: true,
-            },
             taskTracker: {
                 type: 'boolean',
                 label: 'Task Tracker',
@@ -2027,6 +2070,24 @@ const SETTINGS_SCHEMA = {
                 description: 'Replace the built-in save_memory tool with a memory manager subagent that supports adding, removing, de-duplicating, and organizing memories.',
                 showInDialog: true,
             },
+            generalistProfile: {
+                type: 'boolean',
+                label: 'Use the generalist profile to manage agent contexts.',
+                category: 'Experimental',
+                requiresRestart: true,
+                default: false,
+                description: 'Suitable for general coding and software development tasks.',
+                showInDialog: true,
+            },
+            contextManagement: {
+                type: 'boolean',
+                label: 'Enable Context Management',
+                category: 'Experimental',
+                requiresRestart: true,
+                default: false,
+                description: 'Enable logic for context management.',
+                showInDialog: true,
+            },
             topicUpdateNarration: {
                 type: 'boolean',
                 label: 'Topic & Update Narration',
@@ -2282,6 +2343,159 @@ const SETTINGS_SCHEMA = {
             mergeStrategy: MergeStrategy.CONCAT,
         },
     },
+    contextManagement: {
+        type: 'object',
+        label: 'Context Management',
+        category: 'Experimental',
+        requiresRestart: true,
+        default: {},
+        description: 'Settings for agent history and tool distillation context management.',
+        showInDialog: false,
+        properties: {
+            historyWindow: {
+                type: 'object',
+                label: 'History Window Settings',
+                category: 'Context Management',
+                requiresRestart: true,
+                default: {},
+                showInDialog: false,
+                properties: {
+                    maxTokens: {
+                        type: 'number',
+                        label: 'Max Tokens',
+                        category: 'Context Management',
+                        requiresRestart: true,
+                        default: 150_000,
+                        description: 'The number of tokens to allow before triggering compression.',
+                        showInDialog: false,
+                    },
+                    retainedTokens: {
+                        type: 'number',
+                        label: 'Retained Tokens',
+                        category: 'Context Management',
+                        requiresRestart: true,
+                        default: 40_000,
+                        description: 'The number of tokens to always retain.',
+                        showInDialog: false,
+                    },
+                },
+            },
+            messageLimits: {
+                type: 'object',
+                label: 'Message Limits',
+                category: 'Context Management',
+                requiresRestart: true,
+                default: {},
+                showInDialog: false,
+                properties: {
+                    normalMaxTokens: {
+                        type: 'number',
+                        label: 'Normal Maximum Tokens',
+                        category: 'Context Management',
+                        requiresRestart: true,
+                        default: 2500,
+                        description: 'The target number of tokens to budget for a normal conversation turn.',
+                        showInDialog: false,
+                    },
+                    retainedMaxTokens: {
+                        type: 'number',
+                        label: 'Retained Maximum Tokens',
+                        category: 'Context Management',
+                        requiresRestart: true,
+                        default: 12000,
+                        description: 'The maximum number of tokens a single conversation turn can consume before truncation.',
+                        showInDialog: false,
+                    },
+                    normalizationHeadRatio: {
+                        type: 'number',
+                        label: 'Normalization Head Ratio',
+                        category: 'Context Management',
+                        requiresRestart: true,
+                        default: 0.25,
+                        description: 'The ratio of tokens to retain from the beginning of a truncated message (0.0 to 1.0).',
+                        showInDialog: false,
+                    },
+                },
+            },
+            tools: {
+                type: 'object',
+                label: 'Context Management Tools',
+                category: 'Context Management',
+                requiresRestart: true,
+                default: {},
+                showInDialog: false,
+                properties: {
+                    distillation: {
+                        type: 'object',
+                        label: 'Tool Distillation',
+                        category: 'Context Management',
+                        requiresRestart: true,
+                        default: {},
+                        showInDialog: false,
+                        properties: {
+                            maxOutputTokens: {
+                                type: 'number',
+                                label: 'Max Output Tokens',
+                                category: 'Context Management',
+                                requiresRestart: true,
+                                default: 10_000,
+                                description: 'Maximum tokens to show to the model when truncating large tool outputs.',
+                                showInDialog: false,
+                            },
+                            summarizationThresholdTokens: {
+                                type: 'number',
+                                label: 'Tool Summarization Threshold',
+                                category: 'Context Management',
+                                requiresRestart: true,
+                                default: 20_000,
+                                description: 'Threshold above which truncated tool outputs will be summarized by an LLM.',
+                                showInDialog: false,
+                            },
+                        },
+                    },
+                    outputMasking: {
+                        type: 'object',
+                        label: 'Tool Output Masking',
+                        category: 'Context Management',
+                        requiresRestart: true,
+                        ignoreInDocs: false,
+                        default: {},
+                        description: 'Advanced settings for tool output masking to manage context window efficiency.',
+                        showInDialog: false,
+                        properties: {
+                            protectionThresholdTokens: {
+                                type: 'number',
+                                label: 'Tool Protection Threshold (Tokens)',
+                                category: 'Context Management',
+                                requiresRestart: true,
+                                default: 50_000,
+                                description: 'Minimum number of tokens to protect from masking (most recent tool outputs).',
+                                showInDialog: false,
+                            },
+                            minPrunableThresholdTokens: {
+                                type: 'number',
+                                label: 'Min Prunable Tokens Threshold',
+                                category: 'Context Management',
+                                requiresRestart: true,
+                                default: 30_000,
+                                description: 'Minimum prunable tokens required to trigger a masking pass.',
+                                showInDialog: false,
+                            },
+                            protectLatestTurn: {
+                                type: 'boolean',
+                                label: 'Protect Latest Turn',
+                                category: 'Context Management',
+                                requiresRestart: true,
+                                default: true,
+                                description: 'Ensures the absolute latest turn is never masked, regardless of token count.',
+                                showInDialog: false,
+                            },
+                        },
+                    },
+                },
+            },
+        },
+    },
     admin: {
         type: 'object',
         label: 'Admin',