@google/gemini-cli 0.13.0-nightly.20251103.9187f6f6 → 0.13.0-preview.0

package/dist/src/config/policy.js

@@ -3,186 +3,19 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { PolicyDecision, MessageBusType, Storage, } from '@google/gemini-cli-core';
-import { getSystemSettingsPath } from './settings.js';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { loadPoliciesFromToml, } from './policy-toml-loader.js';
-// Get the directory name of the current module
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-// Store policy loading errors to be displayed after UI is ready
-let storedPolicyErrors = [];
-function getPolicyDirectories() {
-    const DEFAULT_POLICIES_DIR = path.resolve(__dirname, 'policies');
-    const USER_POLICIES_DIR = Storage.getUserPoliciesDir();
-    const systemSettingsPath = getSystemSettingsPath();
-    const ADMIN_POLICIES_DIR = path.join(path.dirname(systemSettingsPath), 'policies');
-    return [
-        DEFAULT_POLICIES_DIR,
-        USER_POLICIES_DIR,
-        ADMIN_POLICIES_DIR,
-    ].reverse();
-}
-/**
- * Determines the policy tier (1=default, 2=user, 3=admin) for a given directory.
- * This is used by the TOML loader to assign priority bands.
- */
-function getPolicyTier(dir) {
-    const DEFAULT_POLICIES_DIR = path.resolve(__dirname, 'policies');
-    const USER_POLICIES_DIR = Storage.getUserPoliciesDir();
-    const systemSettingsPath = getSystemSettingsPath();
-    const ADMIN_POLICIES_DIR = path.join(path.dirname(systemSettingsPath), 'policies');
-    // Normalize paths for comparison
-    const normalizedDir = path.resolve(dir);
-    const normalizedDefault = path.resolve(DEFAULT_POLICIES_DIR);
-    const normalizedUser = path.resolve(USER_POLICIES_DIR);
-    const normalizedAdmin = path.resolve(ADMIN_POLICIES_DIR);
-    if (normalizedDir === normalizedDefault)
-        return 1;
-    if (normalizedDir === normalizedUser)
-        return 2;
-    if (normalizedDir === normalizedAdmin)
-        return 3;
-    // Default to tier 1 if unknown
-    return 1;
-}
-/**
- * Formats a policy file error for console logging.
- */
-function formatPolicyError(error) {
-    const tierLabel = error.tier.toUpperCase();
-    let message = `[${tierLabel}] Policy file error in ${error.fileName}:\n`;
-    message += `  ${error.message}`;
-    if (error.details) {
-        message += `\n${error.details}`;
-    }
-    if (error.suggestion) {
-        message += `\n  Suggestion: ${error.suggestion}`;
-    }
-    return message;
-}
+import { createPolicyEngineConfig as createCorePolicyEngineConfig, createPolicyUpdater as createCorePolicyUpdater, } from '@google/gemini-cli-core';
+import {} from './settings.js';
 export async function createPolicyEngineConfig(settings, approvalMode) {
-    const policyDirs = getPolicyDirectories();
-    // Load policies from TOML files
-    const { rules: tomlRules, errors } = await loadPoliciesFromToml(approvalMode, policyDirs, getPolicyTier);
-    // Store any errors encountered during TOML loading
-    // These will be emitted by getPolicyErrorsForUI() after the UI is ready.
-    if (errors.length > 0) {
-        storedPolicyErrors = errors.map((error) => formatPolicyError(error));
-    }
-    const rules = [...tomlRules];
-    // Priority system for policy rules:
-    // - Higher priority numbers win over lower priority numbers
-    // - When multiple rules match, the highest priority rule is applied
-    // - Rules are evaluated in order of priority (highest first)
-    //
-    // Priority bands (tiers):
-    // - Default policies (TOML): 1 + priority/1000 (e.g., priority 100 → 1.100)
-    // - User policies (TOML): 2 + priority/1000 (e.g., priority 100 → 2.100)
-    // - Admin policies (TOML): 3 + priority/1000 (e.g., priority 100 → 3.100)
-    //
-    // This ensures Admin > User > Default hierarchy is always preserved,
-    // while allowing user-specified priorities to work within each tier.
-    //
-    // Settings-based and dynamic rules (all in user tier 2.x):
-    //   2.95: Tools that the user has selected as "Always Allow" in the interactive UI
-    //   2.9:  MCP servers excluded list (security: persistent server blocks)
-    //   2.4:  Command line flag --exclude-tools (explicit temporary blocks)
-    //   2.3:  Command line flag --allowed-tools (explicit temporary allows)
-    //   2.2:  MCP servers with trust=true (persistent trusted servers)
-    //   2.1:  MCP servers allowed list (persistent general server allows)
-    //
-    // TOML policy priorities (before transformation):
-    //   10: Write tools default to ASK_USER (becomes 1.010 in default tier)
-    //   15: Auto-edit tool override (becomes 1.015 in default tier)
-    //   50: Read-only tools (becomes 1.050 in default tier)
-    //   999: YOLO mode allow-all (becomes 1.999 in default tier)
-    // MCP servers that are explicitly excluded in settings.mcp.excluded
-    // Priority: 2.9 (highest in user tier for security - persistent server blocks)
-    if (settings.mcp?.excluded) {
-        for (const serverName of settings.mcp.excluded) {
-            rules.push({
-                toolName: `${serverName}__*`,
-                decision: PolicyDecision.DENY,
-                priority: 2.9,
-            });
-        }
-    }
-    // Tools that are explicitly excluded in the settings.
-    // Priority: 2.4 (user tier - explicit temporary blocks)
-    if (settings.tools?.exclude) {
-        for (const tool of settings.tools.exclude) {
-            rules.push({
-                toolName: tool,
-                decision: PolicyDecision.DENY,
-                priority: 2.4,
-            });
-        }
-    }
-    // Tools that are explicitly allowed in the settings.
-    // Priority: 2.3 (user tier - explicit temporary allows)
-    if (settings.tools?.allowed) {
-        for (const tool of settings.tools.allowed) {
-            rules.push({
-                toolName: tool,
-                decision: PolicyDecision.ALLOW,
-                priority: 2.3,
-            });
-        }
-    }
-    // MCP servers that are trusted in the settings.
-    // Priority: 2.2 (user tier - persistent trusted servers)
-    if (settings.mcpServers) {
-        for (const [serverName, serverConfig] of Object.entries(settings.mcpServers)) {
-            if (serverConfig.trust) {
-                // Trust all tools from this MCP server
-                // Using pattern matching for MCP tool names which are formatted as "serverName__toolName"
-                rules.push({
-                    toolName: `${serverName}__*`,
-                    decision: PolicyDecision.ALLOW,
-                    priority: 2.2,
-                });
-            }
-        }
-    }
-    // MCP servers that are explicitly allowed in settings.mcp.allowed
-    // Priority: 2.1 (user tier - persistent general server allows)
-    if (settings.mcp?.allowed) {
-        for (const serverName of settings.mcp.allowed) {
-            rules.push({
-                toolName: `${serverName}__*`,
-                decision: PolicyDecision.ALLOW,
-                priority: 2.1,
-            });
-        }
-    }
-    return {
-        rules,
-        defaultDecision: PolicyDecision.ASK_USER,
+    // Explicitly construct PolicySettings from Settings to ensure type safety
+    // and avoid accidental leakage of other settings properties.
+    const policySettings = {
+        mcp: settings.mcp,
+        tools: settings.tools,
+        mcpServers: settings.mcpServers,
     };
+    return createCorePolicyEngineConfig(policySettings, approvalMode);
 }
 export function createPolicyUpdater(policyEngine, messageBus) {
-    messageBus.subscribe(MessageBusType.UPDATE_POLICY, (message) => {
-        const toolName = message.toolName;
-        policyEngine.addRule({
-            toolName,
-            decision: PolicyDecision.ALLOW,
-            // User tier (2) + high priority (950/1000) = 2.95
-            // This ensures user "always allow" selections are high priority
-            // but still lose to admin policies (3.xxx) and settings excludes (200)
-            priority: 2.95,
-        });
-    });
-}
-/**
- * Gets and clears any policy errors that were stored during config loading.
- * This should be called once the UI is ready to display errors.
- *
- * @returns Array of formatted error messages, or empty array if no errors
- */
-export function getPolicyErrorsForUI() {
-    const errors = [...storedPolicyErrors];
-    storedPolicyErrors = []; // Clear after retrieving
-    return errors;
+    return createCorePolicyUpdater(policyEngine, messageBus);
 }
 //# sourceMappingURL=policy.js.map

package/dist/src/config/policy.js.map

@@ -1 +1 @@
-{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../../src/config/policy.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../../src/config/policy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAML,wBAAwB,IAAI,4BAA4B,EACxD,mBAAmB,IAAI,uBAAuB,GAC/C,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAiB,MAAM,eAAe,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,QAAkB,EAClB,YAA0B;IAE1B,0EAA0E;IAC1E,6DAA6D;IAC7D,MAAM,cAAc,GAAmB;QACrC,GAAG,EAAE,QAAQ,CAAC,GAAG;QACjB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,UAAU,EAAE,QAAQ,CAAC,UAAU;KAChC,CAAC;IAEF,OAAO,4BAA4B,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,YAA0B,EAC1B,UAAsB;IAEtB,OAAO,uBAAuB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;AAC3D,CAAC"}

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

@@ -18,6 +18,18 @@ export interface SettingEnumOption {
     value: string | number;
     label: string;
 }
+export interface SettingCollectionDefinition {
+    type: SettingsType;
+    description?: string;
+    properties?: SettingsSchema;
+    /** Enum type options  */
+    options?: readonly SettingEnumOption[];
+    /**
+     * Optional reference identifier for generators that emit a `$ref`.
+     * For example, a JSON schema generator can use this to point to a shared definition.
+     */
+    ref?: string;
+}
 export declare enum MergeStrategy {
     REPLACE = "replace",
     CONCAT = "concat",
@@ -39,6 +51,18 @@ export interface SettingDefinition {
     mergeStrategy?: MergeStrategy;
     /** Enum type options  */
     options?: readonly SettingEnumOption[];
+    /**
+     * For collection types (e.g. arrays), describes the shape of each item.
+     */
+    items?: SettingCollectionDefinition;
+    /**
+     * For map-like objects without explicit `properties`, describes the shape of the values.
+     */
+    additionalProperties?: SettingCollectionDefinition;
+    /**
+     * Optional reference identifier for generators that emit a `$ref`.
+     */
+    ref?: string;
 }
 export interface SettingsSchema {
     [key: string]: SettingDefinition;
@@ -60,6 +84,10 @@ declare const SETTINGS_SCHEMA: {
         readonly description: "Configuration for MCP servers.";
         readonly showInDialog: false;
         readonly mergeStrategy: MergeStrategy.SHALLOW_MERGE;
+        readonly additionalProperties: {
+            readonly type: "object";
+            readonly ref: "MCPServerConfig";
+        };
     };
     readonly general: {
         readonly type: "object";
@@ -243,7 +271,7 @@ declare const SETTINGS_SCHEMA: {
                 readonly category: "UI";
                 readonly requiresRestart: false;
                 readonly default: string | undefined;
-                readonly description: "The color theme for the UI.";
+                readonly description: "The color theme for the UI. See the CLI themes guide for available options.";
                 readonly showInDialog: false;
             };
             readonly customThemes: {
@@ -254,6 +282,10 @@ declare const SETTINGS_SCHEMA: {
                 readonly default: Record<string, CustomTheme>;
                 readonly description: "Custom theme definitions.";
                 readonly showInDialog: false;
+                readonly additionalProperties: {
+                    readonly type: "object";
+                    readonly ref: "CustomTheme";
+                };
             };
             readonly hideWindowTitle: {
                 readonly type: "boolean";
@@ -392,14 +424,26 @@ declare const SETTINGS_SCHEMA: {
                 readonly description: "Use the entire width of the terminal for output.";
                 readonly showInDialog: true;
             };
+            readonly useAlternateBuffer: {
+                readonly type: "boolean";
+                readonly label: "Use Alternate Screen Buffer";
+                readonly category: "UI";
+                readonly requiresRestart: true;
+                readonly default: false;
+                readonly description: "Use an alternate screen buffer for the UI, preserving shell history.";
+                readonly showInDialog: true;
+            };
             readonly customWittyPhrases: {
                 readonly type: "array";
                 readonly label: "Custom Witty Phrases";
                 readonly category: "UI";
                 readonly requiresRestart: false;
                 readonly default: string[];
-                readonly description: "Custom witty phrases to display during loading.";
+                readonly description: string;
                 readonly showInDialog: false;
+                readonly items: {
+                    readonly type: "string";
+                };
             };
             readonly accessibility: {
                 readonly type: "object";
@@ -489,6 +533,7 @@ declare const SETTINGS_SCHEMA: {
         readonly default: TelemetrySettings | undefined;
         readonly description: "Telemetry configuration.";
         readonly showInDialog: false;
+        readonly ref: "TelemetrySettings";
     };
     readonly model: {
         readonly type: "object";
@@ -525,8 +570,13 @@ declare const SETTINGS_SCHEMA: {
                 readonly default: Record<string, {
                     tokenBudget?: number;
                 }> | undefined;
-                readonly description: "Settings for summarizing tool output.";
+                readonly description: string;
                 readonly showInDialog: false;
+                readonly additionalProperties: {
+                    readonly type: "object";
+                    readonly description: "Per-tool summarization settings with an optional tokenBudget.";
+                    readonly ref: "SummarizeToolOutputSettings";
+                };
             };
             readonly compressionThreshold: {
                 readonly type: "number";
@@ -558,12 +608,13 @@ declare const SETTINGS_SCHEMA: {
         readonly showInDialog: false;
         readonly properties: {
             readonly fileName: {
-                readonly type: "object";
+                readonly type: "string";
                 readonly label: "Context File Name";
                 readonly category: "Context";
                 readonly requiresRestart: false;
                 readonly default: string | string[] | undefined;
-                readonly description: "The name of the context file.";
+                readonly ref: "StringOrStringArray";
+                readonly description: "The name of the context file or files to load into memory. Accepts either a single string or an array of strings.";
                 readonly showInDialog: false;
             };
             readonly importFormat: {
@@ -590,8 +641,11 @@ declare const SETTINGS_SCHEMA: {
                 readonly category: "Context";
                 readonly requiresRestart: false;
                 readonly default: string[];
-                readonly description: "Additional directories to include in the workspace context. Missing directories will be skipped with a warning.";
+                readonly description: string;
                 readonly showInDialog: false;
+                readonly items: {
+                    readonly type: "string";
+                };
                 readonly mergeStrategy: MergeStrategy.CONCAT;
             };
             readonly loadMemoryFromIncludeDirectories: {
@@ -600,7 +654,7 @@ declare const SETTINGS_SCHEMA: {
                 readonly category: "Context";
                 readonly requiresRestart: false;
                 readonly default: false;
-                readonly description: "Whether to load memory files from include directories.";
+                readonly description: string;
                 readonly showInDialog: true;
             };
             readonly fileFiltering: {
@@ -636,7 +690,7 @@ declare const SETTINGS_SCHEMA: {
                         readonly category: "Context";
                         readonly requiresRestart: true;
                         readonly default: true;
-                        readonly description: "Enable recursive file search functionality";
+                        readonly description: string;
                         readonly showInDialog: true;
                     };
                     readonly disableFuzzySearch: {
@@ -662,12 +716,13 @@ declare const SETTINGS_SCHEMA: {
         readonly showInDialog: false;
         readonly properties: {
             readonly sandbox: {
-                readonly type: "object";
+                readonly type: "string";
                 readonly label: "Sandbox";
                 readonly category: "Tools";
                 readonly requiresRestart: true;
                 readonly default: boolean | string | undefined;
-                readonly description: "Sandbox execution environment (can be a boolean or a path string).";
+                readonly ref: "BooleanOrString";
+                readonly description: string;
                 readonly showInDialog: false;
             };
             readonly shell: {
@@ -685,7 +740,7 @@ declare const SETTINGS_SCHEMA: {
                         readonly category: "Tools";
                         readonly requiresRestart: true;
                         readonly default: true;
-                        readonly description: "Use node-pty for an interactive shell experience. Fallback to child_process still applies.";
+                        readonly description: string;
                         readonly showInDialog: true;
                     };
                     readonly pager: {
@@ -714,7 +769,7 @@ declare const SETTINGS_SCHEMA: {
                 readonly category: "Tools";
                 readonly requiresRestart: false;
                 readonly default: false;
-                readonly description: "Automatically accept and execute tool calls that are considered safe (e.g., read-only operations).";
+                readonly description: string;
                 readonly showInDialog: true;
             };
             readonly core: {
@@ -723,8 +778,11 @@ declare const SETTINGS_SCHEMA: {
                 readonly category: "Tools";
                 readonly requiresRestart: true;
                 readonly default: string[] | undefined;
-                readonly description: "Paths to core tool definitions.";
+                readonly description: string;
                 readonly showInDialog: false;
+                readonly items: {
+                    readonly type: "string";
+                };
             };
             readonly allowed: {
                 readonly type: "array";
@@ -732,8 +790,11 @@ declare const SETTINGS_SCHEMA: {
                 readonly category: "Advanced";
                 readonly requiresRestart: true;
                 readonly default: string[] | undefined;
-                readonly description: "A list of tool names that will bypass the confirmation dialog.";
+                readonly description: string;
                 readonly showInDialog: false;
+                readonly items: {
+                    readonly type: "string";
+                };
             };
             readonly exclude: {
                 readonly type: "array";
@@ -743,6 +804,9 @@ declare const SETTINGS_SCHEMA: {
                 readonly default: string[] | undefined;
                 readonly description: "Tool names to exclude from discovery.";
                 readonly showInDialog: false;
+                readonly items: {
+                    readonly type: "string";
+                };
                 readonly mergeStrategy: MergeStrategy.UNION;
             };
             readonly discoveryCommand: {
@@ -760,7 +824,7 @@ declare const SETTINGS_SCHEMA: {
                 readonly category: "Tools";
                 readonly requiresRestart: true;
                 readonly default: string | undefined;
-                readonly description: "Command to run for tool calls.";
+                readonly description: string;
                 readonly showInDialog: false;
             };
             readonly useRipgrep: {
@@ -805,7 +869,7 @@ declare const SETTINGS_SCHEMA: {
                 readonly category: "Tools";
                 readonly requiresRestart: true;
                 readonly default: false;
-                readonly description: "Enable policy-based tool confirmation via message bus integration. When enabled, tools will automatically respect policy engine decisions (ALLOW/DENY/ASK_USER) without requiring individual tool implementations.";
+                readonly description: string;
                 readonly showInDialog: true;
             };
             readonly enableHooks: {
@@ -845,6 +909,9 @@ declare const SETTINGS_SCHEMA: {
                 readonly default: string[] | undefined;
                 readonly description: "A list of MCP servers to allow.";
                 readonly showInDialog: false;
+                readonly items: {
+                    readonly type: "string";
+                };
             };
             readonly excluded: {
                 readonly type: "array";
@@ -854,6 +921,9 @@ declare const SETTINGS_SCHEMA: {
                 readonly default: string[] | undefined;
                 readonly description: "A list of MCP servers to exclude.";
                 readonly showInDialog: false;
+                readonly items: {
+                    readonly type: "string";
+                };
             };
         };
     };
@@ -871,7 +941,7 @@ declare const SETTINGS_SCHEMA: {
         readonly label: "Use Write Todos";
         readonly category: "Advanced";
         readonly requiresRestart: false;
-        readonly default: false;
+        readonly default: true;
         readonly description: "Enable the write_todos_list tool.";
         readonly showInDialog: false;
     };
@@ -988,6 +1058,9 @@ declare const SETTINGS_SCHEMA: {
                 readonly default: string[];
                 readonly description: "Environment variables to exclude from project context.";
                 readonly showInDialog: false;
+                readonly items: {
+                    readonly type: "string";
+                };
                 readonly mergeStrategy: MergeStrategy.UNION;
             };
             readonly bugCommand: {
@@ -998,6 +1071,7 @@ declare const SETTINGS_SCHEMA: {
                 readonly default: BugCommandSettings | undefined;
                 readonly description: "Configuration for the bug report command.";
                 readonly showInDialog: false;
+                readonly ref: "BugCommandSettings";
             };
         };
     };
@@ -1051,7 +1125,7 @@ declare const SETTINGS_SCHEMA: {
                         readonly label: "Enable Codebase Investigator";
                         readonly category: "Experimental";
                         readonly requiresRestart: true;
-                        readonly default: false;
+                        readonly default: true;
                         readonly description: "Enable the Codebase Investigator agent.";
                         readonly showInDialog: true;
                     };
@@ -1060,7 +1134,7 @@ declare const SETTINGS_SCHEMA: {
                         readonly label: "Codebase Investigator Max Num Turns";
                         readonly category: "Experimental";
                         readonly requiresRestart: true;
-                        readonly default: 15;
+                        readonly default: 10;
                         readonly description: "Maximum number of turns for the Codebase Investigator agent.";
                         readonly showInDialog: true;
                     };
@@ -1069,7 +1143,7 @@ declare const SETTINGS_SCHEMA: {
                         readonly label: "Max Time (Minutes)";
                         readonly category: "Experimental";
                         readonly requiresRestart: true;
-                        readonly default: 5;
+                        readonly default: 3;
                         readonly description: "Maximum time for the Codebase Investigator agent (in minutes).";
                         readonly showInDialog: false;
                     };
@@ -1078,7 +1152,7 @@ declare const SETTINGS_SCHEMA: {
                         readonly label: "Thinking Budget";
                         readonly category: "Experimental";
                         readonly requiresRestart: true;
-                        readonly default: -1;
+                        readonly default: 8192;
                         readonly description: "The thinking budget for the Codebase Investigator agent.";
                         readonly showInDialog: false;
                     };
@@ -1112,6 +1186,9 @@ declare const SETTINGS_SCHEMA: {
                 readonly default: string[];
                 readonly description: "List of disabled extensions.";
                 readonly showInDialog: false;
+                readonly items: {
+                    readonly type: "string";
+                };
                 readonly mergeStrategy: MergeStrategy.UNION;
             };
             readonly workspacesWithMigrationNudge: {
@@ -1122,6 +1199,9 @@ declare const SETTINGS_SCHEMA: {
                 readonly default: string[];
                 readonly description: "List of workspaces for which the migration nudge has been shown.";
                 readonly showInDialog: false;
+                readonly items: {
+                    readonly type: "string";
+                };
                 readonly mergeStrategy: MergeStrategy.UNION;
             };
         };
@@ -1138,6 +1218,8 @@ declare const SETTINGS_SCHEMA: {
     };
 };
 export type SettingsSchemaType = typeof SETTINGS_SCHEMA;
+export type SettingsJsonSchemaDefinition = Record<string, unknown>;
+export declare const SETTINGS_SCHEMA_DEFINITIONS: Record<string, SettingsJsonSchemaDefinition>;
 export declare function getSettingsSchema(): SettingsSchemaType;
 type InferSettings<T extends SettingsSchema> = {
     -readonly [K in keyof T]?: T[K] extends {