@machina.ai/cell-cli 1.10.0-rc1 → 1.13.0-rc1

package/dist/src/config/extensions/extensionSettings.js

@@ -0,0 +1,113 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'node:fs/promises';
+import * as fsSync from 'node:fs';
+import * as dotenv from 'dotenv';
+import { ExtensionStorage } from './storage.js';
+import prompts from 'prompts';
+import { KeychainTokenStorage } from '@google/gemini-cli-core';
+export async function maybePromptForSettings(extensionConfig, extensionId, requestSetting, previousExtensionConfig, previousSettings) {
+    const { name: extensionName, settings } = extensionConfig;
+    if ((!settings || settings.length === 0) &&
+        (!previousExtensionConfig?.settings ||
+            previousExtensionConfig.settings.length === 0)) {
+        return;
+    }
+    const envFilePath = new ExtensionStorage(extensionName).getEnvFilePath();
+    const keychain = new KeychainTokenStorage(extensionId);
+    if (!settings || settings.length === 0) {
+        await clearSettings(envFilePath, keychain);
+        return;
+    }
+    const settingsChanges = getSettingsChanges(settings, previousExtensionConfig?.settings ?? []);
+    const allSettings = { ...(previousSettings ?? {}) };
+    for (const removedEnvSetting of settingsChanges.removeEnv) {
+        delete allSettings[removedEnvSetting.envVar];
+    }
+    for (const removedSensitiveSetting of settingsChanges.removeSensitive) {
+        await keychain.deleteSecret(removedSensitiveSetting.envVar);
+    }
+    for (const setting of settingsChanges.promptForSensitive.concat(settingsChanges.promptForEnv)) {
+        const answer = await requestSetting(setting);
+        allSettings[setting.envVar] = answer;
+    }
+    const nonSensitiveSettings = {};
+    for (const setting of settings) {
+        const value = allSettings[setting.envVar];
+        if (value === undefined) {
+            continue;
+        }
+        if (setting.sensitive) {
+            await keychain.setSecret(setting.envVar, value);
+        }
+        else {
+            nonSensitiveSettings[setting.envVar] = value;
+        }
+    }
+    let envContent = '';
+    for (const [key, value] of Object.entries(nonSensitiveSettings)) {
+        envContent += `${key}=${value}\n`;
+    }
+    await fs.writeFile(envFilePath, envContent);
+}
+export async function promptForSetting(setting) {
+    const response = await prompts({
+        type: setting.sensitive ? 'password' : 'text',
+        name: 'value',
+        message: `${setting.name}\n${setting.description}`,
+    });
+    return response.value;
+}
+export async function getEnvContents(extensionConfig, extensionId) {
+    if (!extensionConfig.settings || extensionConfig.settings.length === 0) {
+        return Promise.resolve({});
+    }
+    const extensionStorage = new ExtensionStorage(extensionConfig.name);
+    const keychain = new KeychainTokenStorage(extensionId);
+    let customEnv = {};
+    if (fsSync.existsSync(extensionStorage.getEnvFilePath())) {
+        const envFile = fsSync.readFileSync(extensionStorage.getEnvFilePath(), 'utf-8');
+        customEnv = dotenv.parse(envFile);
+    }
+    if (extensionConfig.settings) {
+        for (const setting of extensionConfig.settings) {
+            if (setting.sensitive) {
+                const secret = await keychain.getSecret(setting.envVar);
+                if (secret) {
+                    customEnv[setting.envVar] = secret;
+                }
+            }
+        }
+    }
+    return customEnv;
+}
+function getSettingsChanges(settings, oldSettings) {
+    const isSameSetting = (a, b) => a.envVar === b.envVar && (a.sensitive ?? false) === (b.sensitive ?? false);
+    const sensitiveOld = oldSettings.filter((s) => s.sensitive ?? false);
+    const sensitiveNew = settings.filter((s) => s.sensitive ?? false);
+    const envOld = oldSettings.filter((s) => !(s.sensitive ?? false));
+    const envNew = settings.filter((s) => !(s.sensitive ?? false));
+    return {
+        promptForSensitive: sensitiveNew.filter((s) => !sensitiveOld.some((old) => isSameSetting(s, old))),
+        removeSensitive: sensitiveOld.filter((s) => !sensitiveNew.some((neu) => isSameSetting(s, neu))),
+        promptForEnv: envNew.filter((s) => !envOld.some((old) => isSameSetting(s, old))),
+        removeEnv: envOld.filter((s) => !envNew.some((neu) => isSameSetting(s, neu))),
+    };
+}
+async function clearSettings(envFilePath, keychain) {
+    if (fsSync.existsSync(envFilePath)) {
+        await fs.writeFile(envFilePath, '');
+    }
+    if (!keychain.isAvailable()) {
+        return;
+    }
+    const secrets = await keychain.listSecrets();
+    for (const secret of secrets) {
+        await keychain.deleteSecret(secret);
+    }
+    return;
+}
+//# sourceMappingURL=extensionSettings.js.map

package/dist/src/config/extensions/extensionSettings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensionSettings.js","sourceRoot":"","sources":["../../../../src/config/extensions/extensionSettings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,MAAM,MAAM,SAAS,CAAC;AAClC,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAU/D,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,eAAgC,EAChC,WAAmB,EACnB,cAA8D,EAC9D,uBAAyC,EACzC,gBAAyC;IAEzC,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC;IAC1D,IACE,CAAC,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC;QACpC,CAAC,CAAC,uBAAuB,EAAE,QAAQ;YACjC,uBAAuB,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,EAChD,CAAC;QACD,OAAO;IACT,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,gBAAgB,CAAC,aAAa,CAAC,CAAC,cAAc,EAAE,CAAC;IACzE,MAAM,QAAQ,GAAG,IAAI,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAEvD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,MAAM,aAAa,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IAED,MAAM,eAAe,GAAG,kBAAkB,CACxC,QAAQ,EACR,uBAAuB,EAAE,QAAQ,IAAI,EAAE,CACxC,CAAC;IAEF,MAAM,WAAW,GAA2B,EAAE,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC,EAAE,CAAC;IAE5E,KAAK,MAAM,iBAAiB,IAAI,eAAe,CAAC,SAAS,EAAE,CAAC;QAC1D,OAAO,WAAW,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,MAAM,uBAAuB,IAAI,eAAe,CAAC,eAAe,EAAE,CAAC;QACtE,MAAM,QAAQ,CAAC,YAAY,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,MAAM,OAAO,IAAI,eAAe,CAAC,kBAAkB,CAAC,MAAM,CAC7D,eAAe,CAAC,YAAY,CAC7B,EAAE,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;QAC7C,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IACvC,CAAC;IAED,MAAM,oBAAoB,GAA2B,EAAE,CAAC;IACxD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QACD,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,MAAM,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,oBAAoB,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAChE,UAAU,IAAI,GAAG,GAAG,IAAI,KAAK,IAAI,CAAC;IACpC,CAAC;IAED,MAAM,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAyB;IAEzB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC;QAC7B,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM;QAC7C,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,WAAW,EAAE;KACnD,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,KAAK,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,eAAgC,EAChC,WAAmB;IAEnB,IAAI,CAAC,eAAe,CAAC,QAAQ,IAAI,eAAe,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvE,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,IAAI,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACvD,IAAI,SAAS,GAA2B,EAAE,CAAC;IAC3C,IAAI,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,cAAc,EAAE,CAAC,EAAE,CAAC;QACzD,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,CACjC,gBAAgB,CAAC,cAAc,EAAE,EACjC,OAAO,CACR,CAAC;QACF,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,eAAe,CAAC,QAAQ,EAAE,CAAC;QAC7B,KAAK,MAAM,OAAO,IAAI,eAAe,CAAC,QAAQ,EAAE,CAAC;YAC/C,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;gBACtB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBACxD,IAAI,MAAM,EAAE,CAAC;oBACX,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;gBACrC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAQD,SAAS,kBAAkB,CACzB,QAA4B,EAC5B,WAA+B;IAE/B,MAAM,aAAa,GAAG,CAAC,CAAmB,EAAE,CAAmB,EAAE,EAAE,CACjE,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC,CAAC;IAE7E,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC,CAAC;IACrE,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC;IAE/D,OAAO;QACL,kBAAkB,EAAE,YAAY,CAAC,MAAM,CACrC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAC1D;QACD,eAAe,EAAE,YAAY,CAAC,MAAM,CAClC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAC1D;QACD,YAAY,EAAE,MAAM,CAAC,MAAM,CACzB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CACpD;QACD,SAAS,EAAE,MAAM,CAAC,MAAM,CACtB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CACpD;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,WAAmB,EACnB,QAA8B;IAE9B,IAAI,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QACnC,MAAM,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;QAC5B,OAAO;IACT,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC7C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IACD,OAAO;AACT,CAAC"}

package/dist/src/config/extensions/extensionSettings.test.d.ts

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

package/dist/src/config/extensions/extensionSettings.test.js

@@ -0,0 +1,254 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { maybePromptForSettings, promptForSetting, } from './extensionSettings.js';
+import { ExtensionStorage } from './storage.js';
+import prompts from 'prompts';
+import * as fsPromises from 'node:fs/promises';
+import * as fs from 'node:fs';
+import { KeychainTokenStorage } from '@google/gemini-cli-core';
+vi.mock('prompts');
+vi.mock('os', async (importOriginal) => {
+    const mockedOs = await importOriginal();
+    return {
+        ...mockedOs,
+        homedir: vi.fn(),
+    };
+});
+vi.mock('@google/gemini-cli-core', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        KeychainTokenStorage: vi.fn().mockImplementation(() => ({
+            getSecret: vi.fn(),
+            setSecret: vi.fn(),
+            deleteSecret: vi.fn(),
+            listSecrets: vi.fn(),
+            isAvailable: vi.fn().mockResolvedValue(true),
+        })),
+    };
+});
+describe('extensionSettings', () => {
+    let tempHomeDir;
+    let extensionDir;
+    let mockKeychainStorage;
+    let keychainData;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        keychainData = {};
+        mockKeychainStorage = {
+            getSecret: vi
+                .fn()
+                .mockImplementation(async (key) => keychainData[key] || null),
+            setSecret: vi
+                .fn()
+                .mockImplementation(async (key, value) => {
+                keychainData[key] = value;
+            }),
+            deleteSecret: vi.fn().mockImplementation(async (key) => {
+                delete keychainData[key];
+            }),
+            listSecrets: vi
+                .fn()
+                .mockImplementation(async () => Object.keys(keychainData)),
+            isAvailable: vi.fn().mockResolvedValue(true),
+        };
+        KeychainTokenStorage.mockImplementation(() => mockKeychainStorage);
+        tempHomeDir = os.tmpdir() + path.sep + `cell-cli-test-home-${Date.now()}`;
+        extensionDir = path.join(tempHomeDir, '.cell-cli', 'extensions', 'test-ext');
+        // Spy and mock the method, but also create the directory so we can write to it.
+        vi.spyOn(ExtensionStorage.prototype, 'getExtensionDir').mockReturnValue(extensionDir);
+        fs.mkdirSync(extensionDir, { recursive: true });
+        vi.mocked(os.homedir).mockReturnValue(tempHomeDir);
+        vi.mocked(prompts).mockClear();
+    });
+    afterEach(() => {
+        fs.rmSync(tempHomeDir, { recursive: true, force: true });
+        vi.restoreAllMocks();
+    });
+    describe('maybePromptForSettings', () => {
+        const mockRequestSetting = vi.fn(async (setting) => `mock-${setting.envVar}`);
+        beforeEach(() => {
+            mockRequestSetting.mockClear();
+        });
+        it('should do nothing if settings are undefined', async () => {
+            const config = { name: 'test-ext', version: '1.0.0' };
+            await maybePromptForSettings(config, '12345', mockRequestSetting, undefined, undefined);
+            expect(mockRequestSetting).not.toHaveBeenCalled();
+        });
+        it('should do nothing if settings are empty', async () => {
+            const config = {
+                name: 'test-ext',
+                version: '1.0.0',
+                settings: [],
+            };
+            await maybePromptForSettings(config, '12345', mockRequestSetting, undefined, undefined);
+            expect(mockRequestSetting).not.toHaveBeenCalled();
+        });
+        it('should prompt for all settings if there is no previous config', async () => {
+            const config = {
+                name: 'test-ext',
+                version: '1.0.0',
+                settings: [
+                    { name: 's1', description: 'd1', envVar: 'VAR1' },
+                    { name: 's2', description: 'd2', envVar: 'VAR2' },
+                ],
+            };
+            await maybePromptForSettings(config, '12345', mockRequestSetting, undefined, undefined);
+            expect(mockRequestSetting).toHaveBeenCalledTimes(2);
+            expect(mockRequestSetting).toHaveBeenCalledWith(config.settings[0]);
+            expect(mockRequestSetting).toHaveBeenCalledWith(config.settings[1]);
+        });
+        it('should only prompt for new settings', async () => {
+            const previousConfig = {
+                name: 'test-ext',
+                version: '1.0.0',
+                settings: [{ name: 's1', description: 'd1', envVar: 'VAR1' }],
+            };
+            const newConfig = {
+                name: 'test-ext',
+                version: '1.0.0',
+                settings: [
+                    { name: 's1', description: 'd1', envVar: 'VAR1' },
+                    { name: 's2', description: 'd2', envVar: 'VAR2' },
+                ],
+            };
+            const previousSettings = { VAR1: 'previous-VAR1' };
+            await maybePromptForSettings(newConfig, '12345', mockRequestSetting, previousConfig, previousSettings);
+            expect(mockRequestSetting).toHaveBeenCalledTimes(1);
+            expect(mockRequestSetting).toHaveBeenCalledWith(newConfig.settings[1]);
+            const expectedEnvPath = path.join(extensionDir, '.env');
+            const actualContent = await fsPromises.readFile(expectedEnvPath, 'utf-8');
+            const expectedContent = 'VAR1=previous-VAR1\nVAR2=mock-VAR2\n';
+            expect(actualContent).toBe(expectedContent);
+        });
+        it('should remove settings that are no longer in the config', async () => {
+            const previousConfig = {
+                name: 'test-ext',
+                version: '1.0.0',
+                settings: [
+                    { name: 's1', description: 'd1', envVar: 'VAR1' },
+                    { name: 's2', description: 'd2', envVar: 'VAR2' },
+                ],
+            };
+            const newConfig = {
+                name: 'test-ext',
+                version: '1.0.0',
+                settings: [{ name: 's1', description: 'd1', envVar: 'VAR1' }],
+            };
+            const previousSettings = {
+                VAR1: 'previous-VAR1',
+                VAR2: 'previous-VAR2',
+            };
+            await maybePromptForSettings(newConfig, '12345', mockRequestSetting, previousConfig, previousSettings);
+            expect(mockRequestSetting).not.toHaveBeenCalled();
+            const expectedEnvPath = path.join(extensionDir, '.env');
+            const actualContent = await fsPromises.readFile(expectedEnvPath, 'utf-8');
+            const expectedContent = 'VAR1=previous-VAR1\n';
+            expect(actualContent).toBe(expectedContent);
+        });
+        it('should reprompt if a setting changes sensitivity', async () => {
+            const previousConfig = {
+                name: 'test-ext',
+                version: '1.0.0',
+                settings: [
+                    { name: 's1', description: 'd1', envVar: 'VAR1', sensitive: false },
+                ],
+            };
+            const newConfig = {
+                name: 'test-ext',
+                version: '1.0.0',
+                settings: [
+                    { name: 's1', description: 'd1', envVar: 'VAR1', sensitive: true },
+                ],
+            };
+            const previousSettings = { VAR1: 'previous-VAR1' };
+            await maybePromptForSettings(newConfig, '12345', mockRequestSetting, previousConfig, previousSettings);
+            expect(mockRequestSetting).toHaveBeenCalledTimes(1);
+            expect(mockRequestSetting).toHaveBeenCalledWith(newConfig.settings[0]);
+            // The value should now be in keychain, not the .env file.
+            const expectedEnvPath = path.join(extensionDir, '.env');
+            const actualContent = await fsPromises.readFile(expectedEnvPath, 'utf-8');
+            expect(actualContent).toBe('');
+        });
+        it('should not prompt if settings are identical', async () => {
+            const previousConfig = {
+                name: 'test-ext',
+                version: '1.0.0',
+                settings: [
+                    { name: 's1', description: 'd1', envVar: 'VAR1' },
+                    { name: 's2', description: 'd2', envVar: 'VAR2' },
+                ],
+            };
+            const newConfig = {
+                name: 'test-ext',
+                version: '1.0.0',
+                settings: [
+                    { name: 's1', description: 'd1', envVar: 'VAR1' },
+                    { name: 's2', description: 'd2', envVar: 'VAR2' },
+                ],
+            };
+            const previousSettings = {
+                VAR1: 'previous-VAR1',
+                VAR2: 'previous-VAR2',
+            };
+            await maybePromptForSettings(newConfig, '12345', mockRequestSetting, previousConfig, previousSettings);
+            expect(mockRequestSetting).not.toHaveBeenCalled();
+            const expectedEnvPath = path.join(extensionDir, '.env');
+            const actualContent = await fsPromises.readFile(expectedEnvPath, 'utf-8');
+            const expectedContent = 'VAR1=previous-VAR1\nVAR2=previous-VAR2\n';
+            expect(actualContent).toBe(expectedContent);
+        });
+    });
+    describe('promptForSetting', () => {
+        it.each([
+            {
+                description: 'should use prompts with type "password" for sensitive settings',
+                setting: {
+                    name: 'API Key',
+                    description: 'Your secret key',
+                    envVar: 'API_KEY',
+                    sensitive: true,
+                },
+                expectedType: 'password',
+                promptValue: 'secret-key',
+            },
+            {
+                description: 'should use prompts with type "text" for non-sensitive settings',
+                setting: {
+                    name: 'Username',
+                    description: 'Your public username',
+                    envVar: 'USERNAME',
+                    sensitive: false,
+                },
+                expectedType: 'text',
+                promptValue: 'test-user',
+            },
+            {
+                description: 'should default to "text" if sensitive is undefined',
+                setting: {
+                    name: 'Username',
+                    description: 'Your public username',
+                    envVar: 'USERNAME',
+                },
+                expectedType: 'text',
+                promptValue: 'test-user',
+            },
+        ])('$description', async ({ setting, expectedType, promptValue }) => {
+            vi.mocked(prompts).mockResolvedValue({ value: promptValue });
+            const result = await promptForSetting(setting);
+            expect(prompts).toHaveBeenCalledWith({
+                type: expectedType,
+                name: 'value',
+                message: `${setting.name}\n${setting.description}`,
+            });
+            expect(result).toBe(promptValue);
+        });
+    });
+});
+//# sourceMappingURL=extensionSettings.test.js.map

package/dist/src/config/extensions/extensionSettings.test.js.map

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

package/dist/src/config/extensions/github.d.ts

@@ -3,25 +3,34 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { ExtensionInstallMetadata, GeminiCLIExtension } from '@google/gemini-cli-core';
+import { type ExtensionInstallMetadata, type GeminiCLIExtension } from '@google/gemini-cli-core';
 import { ExtensionUpdateState } from '../../ui/state/extensions.js';
+import type { ExtensionManager } from '../extension-manager.js';
 /**
  * Clones a Git repository to a specified local path.
  * @param installMetadata The metadata for the extension to install.
  * @param destination The destination path to clone the repository to.
  */
 export declare function cloneFromGit(installMetadata: ExtensionInstallMetadata, destination: string): Promise<void>;
-export declare function parseGitHubRepoForReleases(source: string): {
+export interface GithubRepoInfo {
     owner: string;
     repo: string;
-};
-export declare function fetchReleaseFromGithub(owner: string, repo: string, ref?: string, allowPreRelease?: boolean): Promise<GithubReleaseData>;
-export declare function checkForExtensionUpdate(extension: GeminiCLIExtension, cwd?: string): Promise<ExtensionUpdateState>;
-export interface GitHubDownloadResult {
-    tagName: string;
-    type: 'git' | 'github-release';
 }
-export declare function downloadFromGitHubRelease(installMetadata: ExtensionInstallMetadata, destination: string): Promise<GitHubDownloadResult>;
+export declare function tryParseGithubUrl(source: string): GithubRepoInfo | null;
+export declare function fetchReleaseFromGithub(owner: string, repo: string, ref?: string, allowPreRelease?: boolean): Promise<GithubReleaseData | null>;
+export declare function checkForExtensionUpdate(extension: GeminiCLIExtension, extensionManager: ExtensionManager): Promise<ExtensionUpdateState>;
+export type GitHubDownloadResult = {
+    tagName?: string;
+    type: 'git' | 'github-release';
+    success: false;
+    failureReason: 'failed to fetch release data' | 'no release data' | 'no release asset found' | 'failed to download asset' | 'failed to extract asset' | 'unknown';
+    errorMessage: string;
+} | {
+    tagName?: string;
+    type: 'git' | 'github-release';
+    success: true;
+};
+export declare function downloadFromGitHubRelease(installMetadata: ExtensionInstallMetadata, destination: string, githubRepoInfo: GithubRepoInfo): Promise<GitHubDownloadResult>;
 interface GithubReleaseData {
     assets: Asset[];
     tag_name: string;