@terminai/cli 0.21.0

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

@@ -0,0 +1,323 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * 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 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 and try again.');
+                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,22 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type Settings, type SettingsFile, type SettingsError, type LoadableSettingScope, SettingScope, isLoadableSettingScope, LoadedSettings, saveSettings, type SessionRetentionSettings, type AccessibilitySettings, type DnsResolutionOrder, getSystemSettingsPath, getSystemDefaultsPath, migrateSettingsToV2, needsMigration } from '@terminai/core';
+import type { ExtensionManager } from './extension-manager.js';
+export type { Settings, LoadableSettingScope, SettingsError, SettingsFile, SessionRetentionSettings, AccessibilitySettings, DnsResolutionOrder, };
+export { LoadedSettings, getSystemSettingsPath, getSystemDefaultsPath, migrateSettingsToV2, needsMigration, };
+export type MemoryImportFormat = NonNullable<Settings['context']>['importFormat'];
+export declare const USER_SETTINGS_PATH: string;
+export declare const USER_SETTINGS_DIR: string;
+export declare const DEFAULT_EXCLUDED_ENV_VARS: string[];
+export { SettingScope, isLoadableSettingScope, saveSettings };
+/**
+ * Loads settings from user and workspace directories.
+ * Project settings override user settings.
+ */
+export declare function loadSettings(workspaceDir?: string): LoadedSettings;
+export declare function loadEnvironment(_settings: Settings): void;
+export declare function migrateDeprecatedSettings(loadedSettings: LoadedSettings, extensionManager: ExtensionManager): void;

package/dist/src/config/settings.js

@@ -0,0 +1,55 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import * as dotenv from 'dotenv';
+import { debugLogger, SettingsLoader, SettingScope, isLoadableSettingScope, LoadedSettings, saveSettings, Storage, getSystemSettingsPath, getSystemDefaultsPath, migrateSettingsToV2, needsMigration, findEnvFile, } from '@terminai/core';
+import { DefaultLight } from '../ui/themes/default-light.js';
+import { DefaultDark } from '../ui/themes/default.js';
+export { LoadedSettings, getSystemSettingsPath, getSystemDefaultsPath, migrateSettingsToV2, needsMigration, };
+export const USER_SETTINGS_PATH = Storage.getGlobalSettingsPath();
+export const USER_SETTINGS_DIR = path.dirname(USER_SETTINGS_PATH);
+export const DEFAULT_EXCLUDED_ENV_VARS = ['DEBUG', 'DEBUG_MODE'];
+export { SettingScope, isLoadableSettingScope, saveSettings };
+/**
+ * Loads settings from user and workspace directories.
+ * Project settings override user settings.
+ */
+export function loadSettings(workspaceDir = process.cwd()) {
+    const loader = new SettingsLoader({
+        workspaceDir,
+        themeMappings: {
+            VS: DefaultLight.name,
+            VS2015: DefaultDark.name,
+        },
+    });
+    return loader.load();
+}
+export function loadEnvironment(_settings) {
+    const envFile = findEnvFile(process.cwd());
+    if (envFile && fs.existsSync(envFile)) {
+        dotenv.config({ path: envFile });
+    }
+}
+export function migrateDeprecatedSettings(loadedSettings, extensionManager) {
+    const processScope = (scope) => {
+        const settings = loadedSettings.forScope(scope).settings;
+        if (settings.extensions?.disabled) {
+            debugLogger.log(`Migrating deprecated extensions.disabled settings from ${scope} settings...`);
+            for (const extension of settings.extensions.disabled ?? []) {
+                // eslint-disable-next-line @typescript-eslint/no-floating-promises
+                extensionManager.disableExtension(extension, scope);
+            }
+            const newExtensionsValue = { ...settings.extensions };
+            newExtensionsValue.disabled = undefined;
+            loadedSettings.setValue(scope, 'extensions', newExtensionsValue);
+        }
+    };
+    processScope(SettingScope.User);
+    processScope(SettingScope.Workspace);
+}
+//# sourceMappingURL=settings.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../../src/config/settings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,EACL,WAAW,EACX,cAAc,EAKd,YAAY,EACZ,sBAAsB,EACtB,cAAc,EACd,YAAY,EACZ,OAAO,EAIP,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,WAAW,GACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAatD,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,GACf,CAAC;AAMF,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;AAClE,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AAEjE,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,YAAY,EAAE,CAAC;AAE9D;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,eAAuB,OAAO,CAAC,GAAG,EAAE;IAEpC,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;QAChC,YAAY;QACZ,aAAa,EAAE;YACb,EAAE,EAAE,YAAY,CAAC,IAAI;YACrB,MAAM,EAAE,WAAW,CAAC,IAAI;SACzB;KACF,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAAmB;IACjD,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3C,IAAI,OAAO,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACnC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,cAA8B,EAC9B,gBAAkC;IAElC,MAAM,YAAY,GAAG,CAAC,KAA2B,EAAE,EAAE;QACnD,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC;QACzD,IAAI,QAAQ,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC;YAClC,WAAW,CAAC,GAAG,CACb,0DAA0D,KAAK,cAAc,CAC9E,CAAC;YACF,KAAK,MAAM,SAAS,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;gBAC3D,mEAAmE;gBACnE,gBAAgB,CAAC,gBAAgB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YACtD,CAAC;YAED,MAAM,kBAAkB,GAAG,EAAE,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC;YACtD,kBAAkB,CAAC,QAAQ,GAAG,SAAS,CAAC;YAExC,cAAc,CAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,kBAAkB,CAAC,CAAC;QACnE,CAAC;IACH,CAAC,CAAC;IAEF,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,YAAY,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;AACvC,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};