@trukhinyuri/gemini-pp 0.27.0-nightly.20260121.97aac696f

package/dist/src/config/settings-validation.test.js

@@ -0,0 +1,370 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/// <reference types="vitest/globals" />
+import { describe, it, expect } from 'vitest';
+import { validateSettings, formatValidationError, settingsZodSchema, } from './settings-validation.js';
+import { z } from 'zod';
+describe('settings-validation', () => {
+    describe('validateSettings', () => {
+        it('should accept valid settings with correct model.name as string', () => {
+            const validSettings = {
+                model: {
+                    name: 'gemini-2.0-flash-exp',
+                    maxSessionTurns: 10,
+                },
+                ui: {
+                    theme: 'dark',
+                },
+            };
+            const result = validateSettings(validSettings);
+            expect(result.success).toBe(true);
+        });
+        it('should reject model.name as object instead of string', () => {
+            const invalidSettings = {
+                model: {
+                    name: {
+                        skipNextSpeakerCheck: true,
+                    },
+                },
+            };
+            const result = validateSettings(invalidSettings);
+            expect(result.success).toBe(false);
+            expect(result.error).toBeDefined();
+            if (result.error) {
+                const issues = result.error.issues;
+                expect(issues.length).toBeGreaterThan(0);
+                expect(issues[0]?.path).toEqual(['model', 'name']);
+                expect(issues[0]?.code).toBe('invalid_type');
+            }
+        });
+        it('should accept valid model.summarizeToolOutput structure', () => {
+            const validSettings = {
+                model: {
+                    summarizeToolOutput: {
+                        run_shell_command: {
+                            tokenBudget: 500,
+                        },
+                    },
+                },
+            };
+            const result = validateSettings(validSettings);
+            expect(result.success).toBe(true);
+        });
+        it('should reject invalid model.summarizeToolOutput structure', () => {
+            const invalidSettings = {
+                model: {
+                    summarizeToolOutput: {
+                        run_shell_command: {
+                            tokenBudget: 500,
+                        },
+                    },
+                },
+            };
+            // First test with valid structure
+            let result = validateSettings(invalidSettings);
+            expect(result.success).toBe(true);
+            // Now test with wrong type (string instead of object)
+            const actuallyInvalidSettings = {
+                model: {
+                    summarizeToolOutput: 'invalid',
+                },
+            };
+            result = validateSettings(actuallyInvalidSettings);
+            expect(result.success).toBe(false);
+            if (result.error) {
+                expect(result.error.issues.length).toBeGreaterThan(0);
+            }
+        });
+        it('should accept empty settings object', () => {
+            const emptySettings = {};
+            const result = validateSettings(emptySettings);
+            expect(result.success).toBe(true);
+        });
+        it('should accept unknown top-level keys (for migration compatibility)', () => {
+            const settingsWithUnknownKey = {
+                unknownKey: 'some value',
+            };
+            const result = validateSettings(settingsWithUnknownKey);
+            expect(result.success).toBe(true);
+            // Unknown keys are allowed via .passthrough() for migration scenarios
+        });
+        it('should accept nested valid settings', () => {
+            const validSettings = {
+                ui: {
+                    theme: 'dark',
+                    hideWindowTitle: true,
+                    footer: {
+                        hideCWD: false,
+                        hideModelInfo: true,
+                    },
+                },
+                tools: {
+                    sandbox: 'inherit',
+                    autoAccept: false,
+                },
+            };
+            const result = validateSettings(validSettings);
+            expect(result.success).toBe(true);
+        });
+        it('should validate array types correctly', () => {
+            const validSettings = {
+                tools: {
+                    allowed: ['git', 'npm'],
+                    exclude: ['dangerous-tool'],
+                },
+                context: {
+                    includeDirectories: ['/path/1', '/path/2'],
+                },
+            };
+            const result = validateSettings(validSettings);
+            expect(result.success).toBe(true);
+        });
+        it('should reject invalid types in arrays', () => {
+            const invalidSettings = {
+                tools: {
+                    allowed: ['git', 123],
+                },
+            };
+            const result = validateSettings(invalidSettings);
+            expect(result.success).toBe(false);
+        });
+        it('should validate boolean fields correctly', () => {
+            const validSettings = {
+                general: {
+                    vimMode: true,
+                    disableAutoUpdate: false,
+                },
+            };
+            const result = validateSettings(validSettings);
+            expect(result.success).toBe(true);
+        });
+        it('should reject non-boolean values for boolean fields', () => {
+            const invalidSettings = {
+                general: {
+                    vimMode: 'yes',
+                },
+            };
+            const result = validateSettings(invalidSettings);
+            expect(result.success).toBe(false);
+        });
+        it('should validate number fields correctly', () => {
+            const validSettings = {
+                model: {
+                    maxSessionTurns: 50,
+                    compressionThreshold: 0.2,
+                },
+            };
+            const result = validateSettings(validSettings);
+            expect(result.success).toBe(true);
+        });
+        it('should validate complex nested mcpServers configuration', () => {
+            const invalidSettings = {
+                mcpServers: {
+                    'my-server': {
+                        command: 123, // Should be string
+                        args: ['arg1'],
+                        env: {
+                            VAR: 'value',
+                        },
+                    },
+                },
+            };
+            const result = validateSettings(invalidSettings);
+            expect(result.success).toBe(false);
+            if (result.error) {
+                expect(result.error.issues.length).toBeGreaterThan(0);
+                // Path should be mcpServers.my-server.command
+                const issue = result.error.issues.find((i) => i.path.includes('command'));
+                expect(issue).toBeDefined();
+                expect(issue?.code).toBe('invalid_type');
+            }
+        });
+        it('should validate mcpServers with type field for all transport types', () => {
+            const validSettings = {
+                mcpServers: {
+                    'sse-server': {
+                        url: 'https://example.com/sse',
+                        type: 'sse',
+                        headers: { 'X-API-Key': 'key' },
+                    },
+                    'http-server': {
+                        url: 'https://example.com/mcp',
+                        type: 'http',
+                    },
+                    'stdio-server': {
+                        command: '/usr/bin/mcp-server',
+                        type: 'stdio',
+                    },
+                },
+            };
+            const result = validateSettings(validSettings);
+            expect(result.success).toBe(true);
+        });
+        it('should reject invalid type values in mcpServers', () => {
+            const invalidSettings = {
+                mcpServers: {
+                    'bad-server': {
+                        url: 'https://example.com/mcp',
+                        type: 'invalid-type',
+                    },
+                },
+            };
+            const result = validateSettings(invalidSettings);
+            expect(result.success).toBe(false);
+        });
+        it('should validate mcpServers without type field', () => {
+            const validSettings = {
+                mcpServers: {
+                    'stdio-server': {
+                        command: '/usr/bin/mcp-server',
+                        args: ['--port', '8080'],
+                    },
+                    'url-server': {
+                        url: 'https://example.com/mcp',
+                    },
+                },
+            };
+            const result = validateSettings(validSettings);
+            expect(result.success).toBe(true);
+        });
+        it('should validate complex nested customThemes configuration', () => {
+            const invalidSettings = {
+                ui: {
+                    customThemes: {
+                        'my-theme': {
+                            type: 'custom',
+                            // Missing 'name' property which is required
+                            text: {
+                                primary: '#ffffff',
+                            },
+                        },
+                    },
+                },
+            };
+            const result = validateSettings(invalidSettings);
+            expect(result.success).toBe(false);
+            if (result.error) {
+                expect(result.error.issues.length).toBeGreaterThan(0);
+                // Should complain about missing 'name'
+                const issue = result.error.issues.find((i) => i.code === 'invalid_type' && i.message.includes('Required'));
+                expect(issue).toBeDefined();
+            }
+        });
+    });
+    describe('formatValidationError', () => {
+        it('should format error with file path and helpful message for model.name', () => {
+            const invalidSettings = {
+                model: {
+                    name: {
+                        skipNextSpeakerCheck: true,
+                    },
+                },
+            };
+            const result = validateSettings(invalidSettings);
+            expect(result.success).toBe(false);
+            if (result.error) {
+                const formatted = formatValidationError(result.error, '/path/to/settings.json');
+                expect(formatted).toContain('/path/to/settings.json');
+                expect(formatted).toContain('model.name');
+                expect(formatted).toContain('Expected: string, but received: object');
+                expect(formatted).toContain('Please fix the configuration.');
+                expect(formatted).toContain('https://github.com/google-gemini/gemini-cli');
+            }
+        });
+        it('should format error for model.summarizeToolOutput', () => {
+            const invalidSettings = {
+                model: {
+                    summarizeToolOutput: 'wrong type',
+                },
+            };
+            const result = validateSettings(invalidSettings);
+            expect(result.success).toBe(false);
+            if (result.error) {
+                const formatted = formatValidationError(result.error, '~/.gemini/settings.json');
+                expect(formatted).toContain('~/.gemini/settings.json');
+                expect(formatted).toContain('model.summarizeToolOutput');
+            }
+        });
+        it('should include link to documentation', () => {
+            const invalidSettings = {
+                model: {
+                    name: { invalid: 'object' }, // model.name should be a string
+                },
+            };
+            const result = validateSettings(invalidSettings);
+            expect(result.success).toBe(false);
+            if (result.error) {
+                const formatted = formatValidationError(result.error, 'test.json');
+                expect(formatted).toContain('https://github.com/google-gemini/gemini-cli');
+                expect(formatted).toContain('configuration.md');
+            }
+        });
+        it('should list all validation errors', () => {
+            const invalidSettings = {
+                model: {
+                    name: { invalid: 'object' },
+                    maxSessionTurns: 'not a number',
+                },
+            };
+            const result = validateSettings(invalidSettings);
+            expect(result.success).toBe(false);
+            if (result.error) {
+                const formatted = formatValidationError(result.error, 'test.json');
+                // Should have multiple errors listed
+                expect(formatted.match(/Error in:/g)?.length).toBeGreaterThan(1);
+            }
+        });
+        it('should format array paths correctly (e.g. tools.allowed[0])', () => {
+            const invalidSettings = {
+                tools: {
+                    allowed: ['git', 123], // 123 is invalid, expected string
+                },
+            };
+            const result = validateSettings(invalidSettings);
+            expect(result.success).toBe(false);
+            if (result.error) {
+                const formatted = formatValidationError(result.error, 'test.json');
+                expect(formatted).toContain('tools.allowed[1]');
+            }
+        });
+        it('should limit the number of displayed errors', () => {
+            const invalidSettings = {
+                tools: {
+                    // Create 6 invalid items to trigger the limit
+                    allowed: [1, 2, 3, 4, 5, 6],
+                },
+            };
+            const result = validateSettings(invalidSettings);
+            expect(result.success).toBe(false);
+            if (result.error) {
+                const formatted = formatValidationError(result.error, 'test.json');
+                // Should see the first 5
+                expect(formatted).toContain('tools.allowed[0]');
+                expect(formatted).toContain('tools.allowed[4]');
+                // Should NOT see the 6th
+                expect(formatted).not.toContain('tools.allowed[5]');
+                // Should see the summary
+                expect(formatted).toContain('...and 1 more errors.');
+            }
+        });
+    });
+    describe('settingsZodSchema', () => {
+        it('should be a valid Zod object schema', () => {
+            expect(settingsZodSchema).toBeInstanceOf(z.ZodObject);
+        });
+        it('should have optional fields', () => {
+            // All top-level fields should be optional
+            const shape = settingsZodSchema.shape;
+            expect(shape['model']).toBeDefined();
+            expect(shape['ui']).toBeDefined();
+            expect(shape['tools']).toBeDefined();
+            // Test that empty object is valid (all fields optional)
+            const result = settingsZodSchema.safeParse({});
+            expect(result.success).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=settings-validation.test.js.map

package/dist/src/config/settings-validation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-validation.test.js","sourceRoot":"","sources":["../../../src/config/settings-validation.test.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,105 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type FetchAdminControlsResponse } from '@google/gemini-cli-core';
+import { type Settings, type MergedSettings, type MemoryImportFormat, type MergeStrategy, type SettingsSchema, type SettingDefinition, getSettingsSchema } from './settingsSchema.js';
+export { type Settings, type MergedSettings, type MemoryImportFormat, type MergeStrategy, type SettingsSchema, type SettingDefinition, getSettingsSchema, };
+export declare const USER_SETTINGS_PATH: string;
+export declare const USER_SETTINGS_DIR: string;
+export declare const DEFAULT_EXCLUDED_ENV_VARS: string[];
+export declare function getSystemSettingsPath(): string;
+export declare function getSystemDefaultsPath(): string;
+export type { DnsResolutionOrder } from './settingsSchema.js';
+export declare enum SettingScope {
+    User = "User",
+    Workspace = "Workspace",
+    System = "System",
+    SystemDefaults = "SystemDefaults",
+    Session = "Session"
+}
+/**
+ * A type representing the settings scopes that are supported for LoadedSettings.
+ */
+export type LoadableSettingScope = SettingScope.User | SettingScope.Workspace | SettingScope.System | SettingScope.SystemDefaults;
+/**
+ * A type guard function that checks if `scope` is a loadable settings scope,
+ * and allows promotion to the `LoadableSettingsScope` type based on the result.
+ */
+export declare function isLoadableSettingScope(scope: SettingScope): scope is LoadableSettingScope;
+export interface CheckpointingSettings {
+    enabled?: boolean;
+}
+export interface SummarizeToolOutputSettings {
+    tokenBudget?: number;
+}
+export interface AccessibilitySettings {
+    enableLoadingPhrases?: boolean;
+    screenReader?: boolean;
+}
+export interface SessionRetentionSettings {
+    /** Enable automatic session cleanup */
+    enabled?: boolean;
+    /** Maximum age of sessions to keep (e.g., "30d", "7d", "24h", "1w") */
+    maxAge?: string;
+    /** Alternative: Maximum number of sessions to keep (most recent) */
+    maxCount?: number;
+    /** Minimum retention period (safety limit, defaults to "1d") */
+    minRetention?: string;
+}
+export interface SettingsError {
+    message: string;
+    path: string;
+    severity: 'error' | 'warning';
+}
+export interface SettingsFile {
+    settings: Settings;
+    originalSettings: Settings;
+    path: string;
+    rawJson?: string;
+}
+export declare function getDefaultsFromSchema(schema?: SettingsSchema): Settings;
+export declare function mergeSettings(system: Settings, systemDefaults: Settings, user: Settings, workspace: Settings, isTrusted: boolean): MergedSettings;
+/**
+ * Creates a fully populated MergedSettings object for testing purposes.
+ * It merges the provided overrides with the default settings from the schema.
+ *
+ * @param overrides Partial settings to override the defaults.
+ * @returns A complete MergedSettings object.
+ */
+export declare function createTestMergedSettings(overrides?: Partial<Settings>): MergedSettings;
+export declare class LoadedSettings {
+    constructor(system: SettingsFile, systemDefaults: SettingsFile, user: SettingsFile, workspace: SettingsFile, isTrusted: boolean, errors?: SettingsError[]);
+    readonly system: SettingsFile;
+    readonly systemDefaults: SettingsFile;
+    readonly user: SettingsFile;
+    readonly workspace: SettingsFile;
+    readonly isTrusted: boolean;
+    readonly errors: SettingsError[];
+    private _merged;
+    private _remoteAdminSettings;
+    get merged(): MergedSettings;
+    private computeMergedSettings;
+    forScope(scope: LoadableSettingScope): SettingsFile;
+    setValue(scope: LoadableSettingScope, key: string, value: unknown): void;
+    setRemoteAdminSettings(remoteSettings: FetchAdminControlsResponse): void;
+}
+export declare function setUpCloudShellEnvironment(envFilePath: string | null): void;
+export declare function loadEnvironment(settings: Settings): void;
+/**
+ * Loads settings from user and workspace directories.
+ * Project settings override user settings.
+ */
+export declare function loadSettings(workspaceDir?: string): LoadedSettings;
+/**
+ * Migrates deprecated settings to their new counterparts.
+ *
+ * TODO: After a couple of weeks (around early Feb 2026), we should start removing
+ * the deprecated settings from the settings files by default.
+ *
+ * @returns true if any changes were made and need to be saved.
+ */
+export declare function migrateDeprecatedSettings(loadedSettings: LoadedSettings, removeDeprecated?: boolean): boolean;
+export declare function saveSettings(settingsFile: SettingsFile): void;
+export declare function saveModelChange(loadedSettings: LoadedSettings, model: string): void;