@machina.ai/cell-cli 1.20.2-rc1 → 1.25.0-rc3

package/dist/src/config/settingsSchema.js

@@ -3,7 +3,7 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { DEFAULT_TRUNCATE_TOOL_OUTPUT_LINES, DEFAULT_TRUNCATE_TOOL_OUTPUT_THRESHOLD, DEFAULT_GEMINI_MODEL, DEFAULT_MODEL_CONFIGS, } from '@google/gemini-cli-core';
+import { DEFAULT_TRUNCATE_TOOL_OUTPUT_LINES, DEFAULT_TRUNCATE_TOOL_OUTPUT_THRESHOLD, DEFAULT_MODEL_CONFIGS, GEMINI_MODEL_ALIAS_AUTO, } from '@google/gemini-cli-core';
 import { DEFAULT_MIN_RETENTION } from '../utils/sessionCleanup.js';
 /**
  * Setting datatypes that "toggle" through a fixed list of options
@@ -235,7 +235,7 @@ const SETTINGS_SCHEMA = {
                 category: 'General',
                 requiresRestart: false,
                 default: 'text',
-                description: 'The format of the CLI output.',
+                description: 'The format of the CLI output. Can be `text` or `json`.',
                 showInDialog: true,
                 options: [
                     { value: 'text', label: 'Text' },
@@ -286,11 +286,29 @@ const SETTINGS_SCHEMA = {
             },
             showStatusInTitle: {
                 type: 'boolean',
-                label: 'Show Status in Title',
+                label: 'Show Thoughts in Title',
                 category: 'UI',
                 requiresRestart: false,
                 default: false,
-                description: 'Show Cell CLI status and thoughts in the terminal window title',
+                description: 'Show Cell CLI model thoughts in the terminal window title during the working phase',
+                showInDialog: true,
+            },
+            dynamicWindowTitle: {
+                type: 'boolean',
+                label: 'Dynamic Window Title',
+                category: 'UI',
+                requiresRestart: false,
+                default: true,
+                description: 'Update the terminal window title with current status icons (Ready: ◇, Action Required: ✋, Working: ✦)',
+                showInDialog: true,
+            },
+            showHomeDirectoryWarning: {
+                type: 'boolean',
+                label: 'Show Home Directory Warning',
+                category: 'UI',
+                requiresRestart: true,
+                default: true,
+                description: 'Show a warning when running Cell CLI in the home directory.',
                 showInDialog: true,
             },
             hideTips: {
@@ -498,7 +516,7 @@ const SETTINGS_SCHEMA = {
                 category: 'IDE',
                 requiresRestart: true,
                 default: false,
-                description: 'Enable IDE integration mode',
+                description: 'Enable IDE integration mode.',
                 showInDialog: true,
             },
             hasSeenNudge: {
@@ -634,6 +652,15 @@ const SETTINGS_SCHEMA = {
                 description: 'Custom named presets for model configs. These are merged with (and override) the built-in aliases.',
                 showInDialog: false,
             },
+            customOverrides: {
+                type: 'array',
+                label: 'Custom Model Config Overrides',
+                category: 'Model',
+                requiresRestart: false,
+                default: [],
+                description: 'Custom model config overrides. These are merged with (and added to) the built-in overrides.',
+                showInDialog: false,
+            },
             overrides: {
                 type: 'array',
                 label: 'Model Config Overrides',
@@ -645,6 +672,30 @@ const SETTINGS_SCHEMA = {
             },
         },
     },
+    agents: {
+        type: 'object',
+        label: 'Agents',
+        category: 'Advanced',
+        requiresRestart: true,
+        default: {},
+        description: 'Settings for subagents.',
+        showInDialog: false,
+        properties: {
+            overrides: {
+                type: 'object',
+                label: 'Agent Overrides',
+                category: 'Advanced',
+                requiresRestart: true,
+                default: {},
+                description: 'Override settings for specific agents, e.g. to disable the agent, set a custom model config, or run config.',
+                showInDialog: false,
+                additionalProperties: {
+                    type: 'object',
+                    ref: 'AgentOverride',
+                },
+            },
+        },
+    },
     context: {
         type: 'object',
         label: 'Context',
@@ -723,7 +774,7 @@ const SETTINGS_SCHEMA = {
                         category: 'Context',
                         requiresRestart: true,
                         default: true,
-                        description: 'Respect .gitignore files when searching',
+                        description: 'Respect .gitignore files when searching.',
                         showInDialog: true,
                     },
                     respectGeminiIgnore: {
@@ -732,7 +783,7 @@ const SETTINGS_SCHEMA = {
                         category: 'Context',
                         requiresRestart: true,
                         default: true,
-                        description: 'Respect .geminiignore files when searching',
+                        description: 'Respect .geminiignore files when searching.',
                         showInDialog: true,
                     },
                     enableRecursiveFileSearch: {
@@ -829,6 +880,15 @@ const SETTINGS_SCHEMA = {
                         description: 'The maximum time in seconds allowed without output from the shell command. Defaults to 5 minutes.',
                         showInDialog: false,
                     },
+                    enableShellOutputEfficiency: {
+                        type: 'boolean',
+                        label: 'Enable Shell Output Efficiency',
+                        category: 'Tools',
+                        requiresRestart: false,
+                        default: true,
+                        description: 'Enable shell output efficiency optimizations for better performance.',
+                        showInDialog: false,
+                    },
                 },
             },
             autoAccept: {
@@ -937,25 +997,25 @@ const SETTINGS_SCHEMA = {
                 description: 'The number of lines to keep when truncating tool output.',
                 showInDialog: true,
             },
-            enableMessageBusIntegration: {
+            disableLLMCorrection: {
                 type: 'boolean',
-                label: 'Enable Message Bus Integration',
+                label: 'Disable LLM Correction',
                 category: 'Tools',
                 requiresRestart: true,
                 default: false,
                 description: oneLine `
-          Enable policy-based tool confirmation via message bus integration.
-          When enabled, tools automatically respect policy engine decisions (ALLOW/DENY/ASK_USER) without requiring individual tool implementations.
+          Disable LLM-based error correction for edit tools.
+          When enabled, tools will fail immediately if exact string matches are not found, instead of attempting to self-correct.
         `,
                 showInDialog: true,
             },
             enableHooks: {
                 type: 'boolean',
-                label: 'Enable Hooks System',
+                label: 'Enable Hooks System (Experimental)',
                 category: 'Advanced',
                 requiresRestart: true,
-                default: false,
-                description: 'Enable the hooks system for intercepting and customizing Cell CLI behavior. When enabled, hooks configured in settings will execute at appropriate lifecycle events (BeforeTool, AfterTool, BeforeModel, etc.). Requires MessageBus integration.',
+                default: true,
+                description: 'Enables the hooks system experiment. When disabled, the hooks system is completely deactivated regardless of other settings.',
                 showInDialog: false,
             },
         },
@@ -1000,15 +1060,6 @@ const SETTINGS_SCHEMA = {
             },
         },
     },
-    useSmartEdit: {
-        type: 'boolean',
-        label: 'Use Smart Edit',
-        category: 'Advanced',
-        requiresRestart: false,
-        default: true,
-        description: 'Enable the smart-edit tool instead of the replace tool.',
-        showInDialog: false,
-    },
     useWriteTodos: {
         type: 'boolean',
         label: 'Use WriteTodos',
@@ -1036,6 +1087,15 @@ const SETTINGS_SCHEMA = {
                 description: 'Disable YOLO mode, even if enabled by a flag.',
                 showInDialog: true,
             },
+            enablePermanentToolApproval: {
+                type: 'boolean',
+                label: 'Allow Permanent Tool Approval',
+                category: 'Security',
+                requiresRestart: false,
+                default: false,
+                description: 'Enable the "Allow for all future sessions" option in tool confirmation dialogs.',
+                showInDialog: true,
+            },
             blockGitExtensions: {
                 type: 'boolean',
                 label: 'Blocks extensions from Git',
@@ -1065,6 +1125,46 @@ const SETTINGS_SCHEMA = {
                     },
                 },
             },
+            environmentVariableRedaction: {
+                type: 'object',
+                label: 'Environment Variable Redaction',
+                category: 'Security',
+                requiresRestart: false,
+                default: {},
+                description: 'Settings for environment variable redaction.',
+                showInDialog: false,
+                properties: {
+                    allowed: {
+                        type: 'array',
+                        label: 'Allowed Environment Variables',
+                        category: 'Security',
+                        requiresRestart: true,
+                        default: [],
+                        description: 'Environment variables to always allow (bypass redaction).',
+                        showInDialog: false,
+                        items: { type: 'string' },
+                    },
+                    blocked: {
+                        type: 'array',
+                        label: 'Blocked Environment Variables',
+                        category: 'Security',
+                        requiresRestart: true,
+                        default: [],
+                        description: 'Environment variables to always redact.',
+                        showInDialog: false,
+                        items: { type: 'string' },
+                    },
+                    enabled: {
+                        type: 'boolean',
+                        label: 'Enable Environment Variable Redaction',
+                        category: 'Security',
+                        requiresRestart: true,
+                        default: false,
+                        description: 'Enable redaction of environment variables that may contain secrets.',
+                        showInDialog: true,
+                    },
+                },
+            },
             auth: {
                 type: 'object',
                 label: 'Authentication',
@@ -1246,6 +1346,15 @@ const SETTINGS_SCHEMA = {
         description: 'Setting to enable experimental features',
         showInDialog: false,
         properties: {
+            enableAgents: {
+                type: 'boolean',
+                label: 'Enable Agents',
+                category: 'Experimental',
+                requiresRestart: true,
+                default: false,
+                description: 'Enable local and remote subagents. Warning: Experimental feature, uses YOLO mode for subagents',
+                showInDialog: false,
+            },
             extensionManagement: {
                 type: 'boolean',
                 label: 'Extension Management',
@@ -1255,22 +1364,22 @@ const SETTINGS_SCHEMA = {
                 description: 'Enable extension management features.',
                 showInDialog: false,
             },
-            extensionReloading: {
+            extensionConfig: {
                 type: 'boolean',
-                label: 'Extension Reloading',
+                label: 'Extension Configuration',
                 category: 'Experimental',
                 requiresRestart: true,
                 default: false,
-                description: 'Enables extension loading/unloading within the CLI session.',
+                description: 'Enable requesting and fetching of extension settings.',
                 showInDialog: false,
             },
-            isModelAvailabilityServiceEnabled: {
+            extensionReloading: {
                 type: 'boolean',
-                label: 'Enable Model Availability Service',
+                label: 'Extension Reloading',
                 category: 'Experimental',
                 requiresRestart: true,
                 default: false,
-                description: 'Enable model routing using new availability service.',
+                description: 'Enables extension loading/unloading within the CLI session.',
                 showInDialog: false,
             },
             jitContext: {
@@ -1282,6 +1391,15 @@ const SETTINGS_SCHEMA = {
                 description: 'Enable Just-In-Time (JIT) context loading.',
                 showInDialog: false,
             },
+            skills: {
+                type: 'boolean',
+                label: 'Agent Skills',
+                category: 'Experimental',
+                requiresRestart: true,
+                default: false,
+                description: 'Enable Agent Skills (experimental).',
+                showInDialog: true,
+            },
             codebaseInvestigatorSettings: {
                 type: 'object',
                 label: 'Codebase Investigator Settings',
@@ -1332,12 +1450,41 @@ const SETTINGS_SCHEMA = {
                         label: 'Model',
                         category: 'Experimental',
                         requiresRestart: true,
-                        default: DEFAULT_GEMINI_MODEL,
+                        default: GEMINI_MODEL_ALIAS_AUTO,
                         description: 'The model to use for the Codebase Investigator agent.',
                         showInDialog: false,
                     },
                 },
             },
+            useOSC52Paste: {
+                type: 'boolean',
+                label: 'Use OSC 52 Paste',
+                category: 'Experimental',
+                requiresRestart: false,
+                default: false,
+                description: 'Use OSC 52 sequence for pasting instead of clipboardy (useful for remote sessions).',
+                showInDialog: true,
+            },
+            cliHelpAgentSettings: {
+                type: 'object',
+                label: 'CLI Help Agent Settings',
+                category: 'Experimental',
+                requiresRestart: true,
+                default: {},
+                description: 'Configuration for CLI Help Agent.',
+                showInDialog: false,
+                properties: {
+                    enabled: {
+                        type: 'boolean',
+                        label: 'Enable CLI Help Agent',
+                        category: 'Experimental',
+                        requiresRestart: true,
+                        default: true,
+                        description: 'Enable the CLI Help Agent.',
+                        showInDialog: true,
+                    },
+                },
+            },
         },
     },
     extensions: {
@@ -1373,6 +1520,28 @@ const SETTINGS_SCHEMA = {
             },
         },
     },
+    skills: {
+        type: 'object',
+        label: 'Skills',
+        category: 'Advanced',
+        requiresRestart: true,
+        default: {},
+        description: 'Settings for agent skills.',
+        showInDialog: false,
+        properties: {
+            disabled: {
+                type: 'array',
+                label: 'Disabled Skills',
+                category: 'Advanced',
+                requiresRestart: true,
+                default: [],
+                description: 'List of disabled skills.',
+                showInDialog: false,
+                items: { type: 'string' },
+                mergeStrategy: MergeStrategy.UNION,
+            },
+        },
+    },
     hooks: {
         type: 'object',
         label: 'Hooks',
@@ -1381,7 +1550,254 @@ const SETTINGS_SCHEMA = {
         default: {},
         description: 'Hook configurations for intercepting and customizing agent behavior.',
         showInDialog: false,
-        mergeStrategy: MergeStrategy.SHALLOW_MERGE,
+        properties: {
+            enabled: {
+                type: 'boolean',
+                label: 'Enable Hooks',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: false,
+                description: 'Canonical toggle for the hooks system. When disabled, no hooks will be executed.',
+                showInDialog: false,
+            },
+            disabled: {
+                type: 'array',
+                label: 'Disabled Hooks',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: [],
+                description: 'List of hook names (commands) that should be disabled. Hooks in this list will not execute even if configured.',
+                showInDialog: false,
+                items: {
+                    type: 'string',
+                    description: 'Hook command name',
+                },
+                mergeStrategy: MergeStrategy.UNION,
+            },
+            notifications: {
+                type: 'boolean',
+                label: 'Hook Notifications',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: true,
+                description: 'Show visual indicators when hooks are executing.',
+                showInDialog: true,
+            },
+            BeforeTool: {
+                type: 'array',
+                label: 'Before Tool Hooks',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: [],
+                description: 'Hooks that execute before tool execution. Can intercept, validate, or modify tool calls.',
+                showInDialog: false,
+                ref: 'HookDefinitionArray',
+                mergeStrategy: MergeStrategy.CONCAT,
+            },
+            AfterTool: {
+                type: 'array',
+                label: 'After Tool Hooks',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: [],
+                description: 'Hooks that execute after tool execution. Can process results, log outputs, or trigger follow-up actions.',
+                showInDialog: false,
+                ref: 'HookDefinitionArray',
+                mergeStrategy: MergeStrategy.CONCAT,
+            },
+            BeforeAgent: {
+                type: 'array',
+                label: 'Before Agent Hooks',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: [],
+                description: 'Hooks that execute before agent loop starts. Can set up context or initialize resources.',
+                showInDialog: false,
+                ref: 'HookDefinitionArray',
+                mergeStrategy: MergeStrategy.CONCAT,
+            },
+            AfterAgent: {
+                type: 'array',
+                label: 'After Agent Hooks',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: [],
+                description: 'Hooks that execute after agent loop completes. Can perform cleanup or summarize results.',
+                showInDialog: false,
+                ref: 'HookDefinitionArray',
+                mergeStrategy: MergeStrategy.CONCAT,
+            },
+            Notification: {
+                type: 'array',
+                label: 'Notification Hooks',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: [],
+                description: 'Hooks that execute on notification events (errors, warnings, info). Can log or alert on specific conditions.',
+                showInDialog: false,
+                ref: 'HookDefinitionArray',
+                mergeStrategy: MergeStrategy.CONCAT,
+            },
+            SessionStart: {
+                type: 'array',
+                label: 'Session Start Hooks',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: [],
+                description: 'Hooks that execute when a session starts. Can initialize session-specific resources or state.',
+                showInDialog: false,
+                ref: 'HookDefinitionArray',
+                mergeStrategy: MergeStrategy.CONCAT,
+            },
+            SessionEnd: {
+                type: 'array',
+                label: 'Session End Hooks',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: [],
+                description: 'Hooks that execute when a session ends. Can perform cleanup or persist session data.',
+                showInDialog: false,
+                ref: 'HookDefinitionArray',
+                mergeStrategy: MergeStrategy.CONCAT,
+            },
+            PreCompress: {
+                type: 'array',
+                label: 'Pre-Compress Hooks',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: [],
+                description: 'Hooks that execute before chat history compression. Can back up or analyze conversation before compression.',
+                showInDialog: false,
+                ref: 'HookDefinitionArray',
+                mergeStrategy: MergeStrategy.CONCAT,
+            },
+            BeforeModel: {
+                type: 'array',
+                label: 'Before Model Hooks',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: [],
+                description: 'Hooks that execute before LLM requests. Can modify prompts, inject context, or control model parameters.',
+                showInDialog: false,
+                ref: 'HookDefinitionArray',
+                mergeStrategy: MergeStrategy.CONCAT,
+            },
+            AfterModel: {
+                type: 'array',
+                label: 'After Model Hooks',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: [],
+                description: 'Hooks that execute after LLM responses. Can process outputs, extract information, or log interactions.',
+                showInDialog: false,
+                ref: 'HookDefinitionArray',
+                mergeStrategy: MergeStrategy.CONCAT,
+            },
+            BeforeToolSelection: {
+                type: 'array',
+                label: 'Before Tool Selection Hooks',
+                category: 'Advanced',
+                requiresRestart: false,
+                default: [],
+                description: 'Hooks that execute before tool selection. Can filter or prioritize available tools dynamically.',
+                showInDialog: false,
+                ref: 'HookDefinitionArray',
+                mergeStrategy: MergeStrategy.CONCAT,
+            },
+        },
+        additionalProperties: {
+            type: 'array',
+            description: 'Custom hook event arrays that contain hook definitions for user-defined events',
+            mergeStrategy: MergeStrategy.CONCAT,
+        },
+    },
+    admin: {
+        type: 'object',
+        label: 'Admin',
+        category: 'Admin',
+        requiresRestart: false,
+        default: {},
+        description: 'Settings configured remotely by enterprise admins.',
+        showInDialog: false,
+        mergeStrategy: MergeStrategy.REPLACE,
+        properties: {
+            secureModeEnabled: {
+                type: 'boolean',
+                label: 'Secure Mode Enabled',
+                category: 'Admin',
+                requiresRestart: false,
+                default: false,
+                description: 'If true, disallows yolo mode from being used.',
+                showInDialog: false,
+                mergeStrategy: MergeStrategy.REPLACE,
+            },
+            extensions: {
+                type: 'object',
+                label: 'Extensions Settings',
+                category: 'Admin',
+                requiresRestart: false,
+                default: {},
+                description: 'Extensions-specific admin settings.',
+                showInDialog: false,
+                mergeStrategy: MergeStrategy.REPLACE,
+                properties: {
+                    enabled: {
+                        type: 'boolean',
+                        label: 'Extensions Enabled',
+                        category: 'Admin',
+                        requiresRestart: false,
+                        default: true,
+                        description: 'If false, disallows extensions from being installed or used.',
+                        showInDialog: false,
+                        mergeStrategy: MergeStrategy.REPLACE,
+                    },
+                },
+            },
+            mcp: {
+                type: 'object',
+                label: 'MCP Settings',
+                category: 'Admin',
+                requiresRestart: false,
+                default: {},
+                description: 'MCP-specific admin settings.',
+                showInDialog: false,
+                mergeStrategy: MergeStrategy.REPLACE,
+                properties: {
+                    enabled: {
+                        type: 'boolean',
+                        label: 'MCP Enabled',
+                        category: 'Admin',
+                        requiresRestart: false,
+                        default: true,
+                        description: 'If false, disallows MCP servers from being used.',
+                        showInDialog: false,
+                        mergeStrategy: MergeStrategy.REPLACE,
+                    },
+                },
+            },
+            skills: {
+                type: 'object',
+                label: 'Skills Settings',
+                category: 'Admin',
+                requiresRestart: false,
+                default: {},
+                description: 'Agent Skills-specific admin settings.',
+                showInDialog: false,
+                mergeStrategy: MergeStrategy.REPLACE,
+                properties: {
+                    enabled: {
+                        type: 'boolean',
+                        label: 'Skills Enabled',
+                        category: 'Admin',
+                        requiresRestart: false,
+                        default: true,
+                        description: 'If false, disallows agent skills from being used.',
+                        showInDialog: false,
+                        mergeStrategy: MergeStrategy.REPLACE,
+                    },
+                },
+            },
+        },
     },
 };
 export const SETTINGS_SCHEMA_DEFINITIONS = {
@@ -1410,7 +1826,7 @@ export const SETTINGS_SCHEMA_DEFINITIONS = {
             },
             url: {
                 type: 'string',
-                description: 'SSE transport URL.',
+                description: 'URL for SSE or HTTP transport. Use with "type" field to specify transport type.',
             },
             httpUrl: {
                 type: 'string',
@@ -1425,6 +1841,11 @@ export const SETTINGS_SCHEMA_DEFINITIONS = {
                 type: 'string',
                 description: 'TCP address for websocket transport.',
             },
+            type: {
+                type: 'string',
+                description: 'Transport type. Use "stdio" for local command, "sse" for Server-Sent Events, or "http" for Streamable HTTP.',
+                enum: ['stdio', 'sse', 'http'],
+            },
             timeout: {
                 type: 'number',
                 description: 'Timeout in milliseconds for MCP requests.',
@@ -1433,6 +1854,10 @@ export const SETTINGS_SCHEMA_DEFINITIONS = {
                 type: 'boolean',
                 description: 'Marks the server as trusted. Trusted servers may gain additional capabilities.',
             },
+            managed: {
+                type: 'boolean',
+                description: 'Whether the MCP server is managed by the Cell CLI.',
+            },
             description: {
                 type: 'string',
                 description: 'Human-readable description of the server.',
@@ -1510,6 +1935,10 @@ export const SETTINGS_SCHEMA_DEFINITIONS = {
                 type: 'boolean',
                 description: 'Whether to forward telemetry to an OTLP collector.',
             },
+            useCliAuth: {
+                type: 'boolean',
+                description: 'Whether to use CLI authentication for telemetry (only for in-process exporters).',
+            },
         },
     },
     BugCommandSettings: {
@@ -1535,6 +1964,36 @@ export const SETTINGS_SCHEMA_DEFINITIONS = {
             },
         },
     },
+    AgentOverride: {
+        type: 'object',
+        description: 'Override settings for a specific agent.',
+        additionalProperties: false,
+        properties: {
+            modelConfig: {
+                type: 'object',
+                additionalProperties: true,
+            },
+            runConfig: {
+                type: 'object',
+                description: 'Run configuration for an agent.',
+                additionalProperties: false,
+                properties: {
+                    maxTimeMinutes: {
+                        type: 'number',
+                        description: 'The maximum execution time for the agent in minutes.',
+                    },
+                    maxTurns: {
+                        type: 'number',
+                        description: 'The maximum number of conversational turns.',
+                    },
+                },
+            },
+            disabled: {
+                type: 'boolean',
+                description: 'Whether to disable the agent.',
+            },
+        },
+    },
     CustomTheme: {
         type: 'object',
         description: 'Custom theme definition used for styling Cell CLI output. Colors are provided as hex strings or named ANSI colors.',
@@ -1632,8 +2091,58 @@ export const SETTINGS_SCHEMA_DEFINITIONS = {
         description: 'Accepts either a boolean flag or a string command name.',
         anyOf: [{ type: 'boolean' }, { type: 'string' }],
     },
+    HookDefinitionArray: {
+        type: 'array',
+        description: 'Array of hook definition objects for a specific event.',
+        items: {
+            type: 'object',
+            description: 'Hook definition specifying matcher pattern and hook configurations.',
+            properties: {
+                matcher: {
+                    type: 'string',
+                    description: 'Pattern to match against the event context (tool name, notification type, etc.). Supports exact match, regex (/pattern/), and wildcards (*).',
+                },
+                hooks: {
+                    type: 'array',
+                    description: 'Hooks to execute when the matcher matches.',
+                    items: {
+                        type: 'object',
+                        description: 'Individual hook configuration.',
+                        properties: {
+                            name: {
+                                type: 'string',
+                                description: 'Unique identifier for the hook.',
+                            },
+                            type: {
+                                type: 'string',
+                                description: 'Type of hook (currently only "command" supported).',
+                            },
+                            command: {
+                                type: 'string',
+                                description: 'Shell command to execute. Receives JSON input via stdin and returns JSON output via stdout.',
+                            },
+                            description: {
+                                type: 'string',
+                                description: 'A description of the hook.',
+                            },
+                            timeout: {
+                                type: 'number',
+                                description: 'Timeout in milliseconds for hook execution.',
+                            },
+                        },
+                    },
+                },
+            },
+        },
+    },
 };
 export function getSettingsSchema() {
     return SETTINGS_SCHEMA;
 }
+export function getEnableHooksUI(settings) {
+    return settings.tools?.enableHooks ?? true;
+}
+export function getEnableHooks(settings) {
+    return getEnableHooksUI(settings) && (settings.hooks?.enabled ?? false);
+}
 //# sourceMappingURL=settingsSchema.js.map