@terminai/core 0.21.0

package/dist/src/audit/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/audit/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/src/auth/geminiAuthStatus.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AuthType } from '../core/contentGenerator.js';
+export type GeminiAuthStatus = 'ok' | 'required' | 'error';
+export interface GeminiAuthCheckResult {
+    status: GeminiAuthStatus;
+    message?: string;
+}
+/**
+ * Checks the auth status for Gemini/Google providers without triggering interactive prompts.
+ * Used by sidecars/servers to know if they should block or prompt via client.
+ */
+export declare function checkGeminiAuthStatusNonInteractive(selectedType: AuthType | undefined, env?: NodeJS.ProcessEnv): Promise<GeminiAuthCheckResult>;

package/dist/src/auth/geminiAuthStatus.js

@@ -0,0 +1,96 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'node:fs';
+import { AuthType } from '../core/contentGenerator.js';
+import { Storage } from '../config/storage.js';
+import { loadApiKey } from '../core/apiKeyCredentialStorage.js';
+/**
+ * Checks the auth status for Gemini/Google providers without triggering interactive prompts.
+ * Used by sidecars/servers to know if they should block or prompt via client.
+ */
+export async function checkGeminiAuthStatusNonInteractive(selectedType, env = process.env) {
+    // If no auth type selected, we treat it as "required" if we want to force a wizard,
+    // or maybe "error" if strict. But usually it means "we need to setup".
+    if (!selectedType) {
+        const envKey = env['GEMINI_API_KEY'];
+        if (envKey) {
+            return { status: 'ok' };
+        }
+        const storedKey = await loadApiKey();
+        if (storedKey) {
+            return { status: 'ok' };
+        }
+        // Implicit Vertex check
+        if ((env['GOOGLE_CLOUD_PROJECT'] && env['GOOGLE_CLOUD_LOCATION']) ||
+            env['GOOGLE_API_KEY']) {
+            return { status: 'ok' };
+        }
+        // Implicit OAuth creds check
+        try {
+            const credsPath = Storage.getOAuthCredsPath();
+            if (fs.existsSync(credsPath)) {
+                const content = fs.readFileSync(credsPath, 'utf8');
+                JSON.parse(content);
+                return { status: 'ok' };
+            }
+        }
+        catch (_e) {
+            return { status: 'error', message: 'OAuth credentials invalid' };
+        }
+        return { status: 'required', message: 'No authentication configured' };
+    }
+    switch (selectedType) {
+        case AuthType.USE_GEMINI:
+            if (env['GEMINI_API_KEY']) {
+                return { status: 'ok' };
+            }
+            if (await loadApiKey()) {
+                return { status: 'ok' };
+            }
+            return {
+                status: 'required',
+                message: 'Gemini API key not found (env or keychain)',
+            };
+        case AuthType.LOGIN_WITH_GOOGLE:
+            try {
+                const credsPath = Storage.getOAuthCredsPath();
+                if (fs.existsSync(credsPath)) {
+                    // Verify parseability and basic structure
+                    const content = fs.readFileSync(credsPath, 'utf8');
+                    const creds = JSON.parse(content);
+                    if (!creds || typeof creds !== 'object' || !creds.refresh_token) {
+                        return {
+                            status: 'error',
+                            message: 'OAuth credentials corrupted or incomplete',
+                        };
+                    }
+                    return { status: 'ok' };
+                }
+            }
+            catch (e) {
+                return { status: 'error', message: 'OAuth credentials corrupted' };
+            }
+            return { status: 'required', message: 'OAuth credentials missing' };
+        case AuthType.USE_VERTEX_AI:
+            if ((env['GOOGLE_CLOUD_PROJECT'] && env['GOOGLE_CLOUD_LOCATION']) ||
+                env['GOOGLE_API_KEY']) {
+                return { status: 'ok' };
+            }
+            return {
+                status: 'required',
+                message: 'Vertex AI environment variables missing',
+            };
+        case AuthType.LEGACY_CLOUD_SHELL:
+        case AuthType.COMPUTE_ADC:
+            // Assume these are environment based and if selected, we trust the env is there or will fail later?
+            // Let's assume OK for now as they are implicit/system based.
+            return { status: 'ok' };
+        default:
+            return { status: 'error', message: `Unknown auth type: ${selectedType}` };
+    }
+}
+//# sourceMappingURL=geminiAuthStatus.js.map

package/dist/src/auth/geminiAuthStatus.js.map

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

package/dist/src/auth/geminiAuthStatus.test.d.ts

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

package/dist/src/auth/geminiAuthStatus.test.js

@@ -0,0 +1,88 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { checkGeminiAuthStatusNonInteractive } from './geminiAuthStatus.js';
+import { AuthType } from '../core/contentGenerator.js';
+import { Storage } from '../config/storage.js';
+import { loadApiKey } from '../core/apiKeyCredentialStorage.js';
+import * as fs from 'node:fs';
+vi.mock('../config/storage.js', () => ({
+    Storage: {
+        getOAuthCredsPath: vi.fn(),
+    },
+}));
+vi.mock('../core/apiKeyCredentialStorage.js', () => ({
+    loadApiKey: vi.fn(),
+}));
+vi.mock('node:fs', async () => {
+    const actual = await vi.importActual('node:fs');
+    return {
+        ...actual,
+        existsSync: vi.fn(),
+        readFileSync: vi.fn(),
+    };
+});
+describe('checkGeminiAuthStatusNonInteractive', () => {
+    beforeEach(() => {
+        vi.resetAllMocks();
+        vi.mocked(loadApiKey).mockResolvedValue(null);
+    });
+    afterEach(() => {
+        vi.unstubAllEnvs();
+    });
+    it('should return required if no auth type selected and no envs', async () => {
+        const result = await checkGeminiAuthStatusNonInteractive(undefined, {});
+        expect(result.status).toBe('required');
+    });
+    it('should return ok if no auth type but GEMINI_API_KEY env present', async () => {
+        const result = await checkGeminiAuthStatusNonInteractive(undefined, {
+            GEMINI_API_KEY: 'test',
+        });
+        expect(result.status).toBe('ok');
+    });
+    it('should return ok for USE_GEMINI with key', async () => {
+        const result = await checkGeminiAuthStatusNonInteractive(AuthType.USE_GEMINI, {
+            GEMINI_API_KEY: 'test',
+        });
+        expect(result.status).toBe('ok');
+    });
+    it('should return required for USE_GEMINI without key', async () => {
+        const result = await checkGeminiAuthStatusNonInteractive(AuthType.USE_GEMINI, {});
+        expect(result.status).toBe('required');
+    });
+    it('should return ok for LOGIN_WITH_GOOGLE if oauth file exists', async () => {
+        vi.mocked(Storage.getOAuthCredsPath).mockReturnValue('/fake/path.json');
+        vi.mocked(fs.existsSync).mockReturnValue(true);
+        vi.mocked(fs.readFileSync).mockReturnValue('{}');
+        const result = await checkGeminiAuthStatusNonInteractive(AuthType.LOGIN_WITH_GOOGLE, {});
+        expect(result.status).toBe('ok');
+    });
+    it('should return required for LOGIN_WITH_GOOGLE if oauth file missing', async () => {
+        vi.mocked(Storage.getOAuthCredsPath).mockReturnValue('/fake/path.json');
+        vi.mocked(fs.existsSync).mockReturnValue(false);
+        const result = await checkGeminiAuthStatusNonInteractive(AuthType.LOGIN_WITH_GOOGLE, {});
+        expect(result.status).toBe('required');
+    });
+    it('should return ok for USE_VERTEX_AI with envs', async () => {
+        const result = await checkGeminiAuthStatusNonInteractive(AuthType.USE_VERTEX_AI, {
+            GOOGLE_CLOUD_PROJECT: 'proj',
+            GOOGLE_CLOUD_LOCATION: 'loc',
+        });
+        expect(result.status).toBe('ok');
+    });
+    it('should return ok for USE_VERTEX_AI with API Key (express mode)', async () => {
+        const result = await checkGeminiAuthStatusNonInteractive(AuthType.USE_VERTEX_AI, {
+            GOOGLE_API_KEY: 'key',
+        });
+        expect(result.status).toBe('ok');
+    });
+    it('should return required for USE_VERTEX_AI missing all', async () => {
+        const result = await checkGeminiAuthStatusNonInteractive(AuthType.USE_VERTEX_AI, {});
+        expect(result.status).toBe('required');
+    });
+});
+//# sourceMappingURL=geminiAuthStatus.test.js.map

package/dist/src/auth/geminiAuthStatus.test.js.map

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

package/dist/src/auth/providerRegistry.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ProviderId, AuthMethod } from './wizardState.js';
+export interface WizardInputField {
+    readonly id: string;
+    readonly label: string;
+    readonly placeholder?: string;
+    readonly secret?: boolean;
+}
+export interface ProviderAuthMethodMetadata {
+    readonly id: AuthMethod;
+    readonly displayName: string;
+    readonly description?: string;
+    readonly requiredFields: readonly WizardInputField[];
+}
+export interface ProviderMetadata {
+    id: ProviderId;
+    displayName: string;
+    description: string;
+    authMethods: readonly ProviderAuthMethodMetadata[];
+}
+export declare const PROVIDER_REGISTRY: Record<ProviderId, ProviderMetadata>;

package/dist/src/auth/providerRegistry.js

@@ -0,0 +1,76 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export const PROVIDER_REGISTRY = {
+    gemini: {
+        id: 'gemini',
+        displayName: 'Google Gemini',
+        description: "Use Google's Gemini models (Flash, Pro, etc.)",
+        authMethods: [
+            {
+                id: 'oauth',
+                displayName: 'Sign in with Google (OAuth)',
+                requiredFields: [],
+            },
+            {
+                id: 'api_key',
+                displayName: 'Gemini API key',
+                requiredFields: [
+                    {
+                        id: 'apiKey',
+                        label: 'API key',
+                        placeholder: 'AIzaSy...',
+                        secret: true,
+                    },
+                ],
+            },
+            {
+                id: 'vertex_ai',
+                displayName: 'Vertex AI (ADC / env)',
+                requiredFields: [],
+            },
+        ],
+    },
+    openai_compatible: {
+        id: 'openai_compatible',
+        displayName: 'OpenAI Compatible',
+        description: 'Use any OpenAI-API compatible provider (e.g. OpenAI, vLLM, DeepSeek)',
+        authMethods: [
+            {
+                id: 'api_key',
+                displayName: 'API key (via env var)',
+                description: 'Configure base URL + model, and provide the API key via an environment variable.',
+                requiredFields: [
+                    { id: 'baseUrl', label: 'Base URL', placeholder: 'https://...' },
+                    { id: 'model', label: 'Model', placeholder: 'gpt-4o' },
+                    {
+                        id: 'envVarName',
+                        label: 'API key env var name',
+                        placeholder: 'OPENAI_API_KEY',
+                    },
+                ],
+            },
+        ],
+    },
+    anthropic: {
+        id: 'anthropic',
+        displayName: 'Anthropic',
+        description: 'Use Anthropic Claude models',
+        authMethods: [
+            {
+                id: 'oauth',
+                displayName: 'OAuth (TBD)',
+                requiredFields: [],
+            },
+            {
+                id: 'api_key',
+                displayName: 'API key (TBD)',
+                requiredFields: [],
+            },
+        ],
+    },
+};
+//# sourceMappingURL=providerRegistry.js.map

package/dist/src/auth/providerRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerRegistry.js","sourceRoot":"","sources":["../../../src/auth/providerRegistry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyBH,MAAM,CAAC,MAAM,iBAAiB,GAAyC;IACrE,MAAM,EAAE;QACN,EAAE,EAAE,QAAQ;QACZ,WAAW,EAAE,eAAe;QAC5B,WAAW,EAAE,+CAA+C;QAC5D,WAAW,EAAE;YACX;gBACE,EAAE,EAAE,OAAO;gBACX,WAAW,EAAE,6BAA6B;gBAC1C,cAAc,EAAE,EAAE;aACnB;YACD;gBACE,EAAE,EAAE,SAAS;gBACb,WAAW,EAAE,gBAAgB;gBAC7B,cAAc,EAAE;oBACd;wBACE,EAAE,EAAE,QAAQ;wBACZ,KAAK,EAAE,SAAS;wBAChB,WAAW,EAAE,WAAW;wBACxB,MAAM,EAAE,IAAI;qBACb;iBACF;aACF;YACD;gBACE,EAAE,EAAE,WAAW;gBACf,WAAW,EAAE,uBAAuB;gBACpC,cAAc,EAAE,EAAE;aACnB;SACF;KACF;IACD,iBAAiB,EAAE;QACjB,EAAE,EAAE,mBAAmB;QACvB,WAAW,EAAE,mBAAmB;QAChC,WAAW,EACT,sEAAsE;QACxE,WAAW,EAAE;YACX;gBACE,EAAE,EAAE,SAAS;gBACb,WAAW,EAAE,uBAAuB;gBACpC,WAAW,EACT,kFAAkF;gBACpF,cAAc,EAAE;oBACd,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE;oBAChE,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE;oBACtD;wBACE,EAAE,EAAE,YAAY;wBAChB,KAAK,EAAE,sBAAsB;wBAC7B,WAAW,EAAE,gBAAgB;qBAC9B;iBACF;aACF;SACF;KACF;IACD,SAAS,EAAE;QACT,EAAE,EAAE,WAAW;QACf,WAAW,EAAE,WAAW;QACxB,WAAW,EAAE,6BAA6B;QAC1C,WAAW,EAAE;YACX;gBACE,EAAE,EAAE,OAAO;gBACX,WAAW,EAAE,aAAa;gBAC1B,cAAc,EAAE,EAAE;aACnB;YACD;gBACE,EAAE,EAAE,SAAS;gBACb,WAAW,EAAE,eAAe;gBAC5B,cAAc,EAAE,EAAE;aACnB;SACF;KACF;CACF,CAAC"}

package/dist/src/auth/wizardSettings.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ProviderId } from './wizardState.js';
+import { AuthType } from '../core/contentGenerator.js';
+export interface WizardSettingsInput {
+    provider: ProviderId;
+    geminiAuthType?: AuthType;
+    openaiCompatible?: {
+        baseUrl: string;
+        model: string;
+        envVarName?: string;
+    };
+}
+export interface SettingsPatch {
+    path: string;
+    value: unknown;
+}
+/**
+ * Builds a list of settings patches to apply based on wizard input.
+ */
+export declare function buildWizardSettingsPatch(input: WizardSettingsInput): SettingsPatch[];

package/dist/src/auth/wizardSettings.js

@@ -0,0 +1,70 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AuthType } from '../core/contentGenerator.js';
+/**
+ * Builds a list of settings patches to apply based on wizard input.
+ */
+export function buildWizardSettingsPatch(input) {
+    const patches = [];
+    // 1. Set Provider
+    patches.push({ path: 'llm.provider', value: input.provider });
+    // 2. Provider specific settings
+    if (input.provider === 'gemini') {
+        if (input.geminiAuthType) {
+            patches.push({
+                path: 'security.auth.selectedType',
+                value: input.geminiAuthType,
+            });
+        }
+    }
+    else if (input.provider === 'openai_compatible') {
+        if (!input.openaiCompatible) {
+            throw new Error('OpenAI-compatible provider selected but openaiCompatible config is missing');
+        }
+        const baseUrl = normalizeBaseUrl(input.openaiCompatible.baseUrl);
+        const model = input.openaiCompatible.model.trim();
+        if (model.length === 0) {
+            throw new Error('OpenAI-compatible provider selected but model is missing/empty');
+        }
+        const envVarName = (input.openaiCompatible.envVarName ?? 'OPENAI_API_KEY')
+            .trim()
+            .replace(/\s+/g, '');
+        if (envVarName.length === 0) {
+            throw new Error('OpenAI-compatible provider selected but envVarName is missing/empty');
+        }
+        patches.push({
+            path: 'llm.openaiCompatible.baseUrl',
+            value: baseUrl,
+        });
+        patches.push({
+            path: 'llm.openaiCompatible.model',
+            value: model,
+        });
+        // Matches settings schema enum: ["none", "api-key", "bearer"]
+        patches.push({
+            path: 'llm.openaiCompatible.auth.type',
+            value: 'api-key',
+        });
+        patches.push({
+            path: 'llm.openaiCompatible.auth.envVarName',
+            value: envVarName,
+        });
+    }
+    return patches;
+}
+function normalizeBaseUrl(raw) {
+    const trimmed = raw.trim();
+    if (trimmed.length === 0) {
+        throw new Error('OpenAI-compatible baseUrl is missing/empty');
+    }
+    const withScheme = /^https?:\/\//i.test(trimmed)
+        ? trimmed
+        : `https://${trimmed}`;
+    // Remove trailing slashes to align with existing core expectations
+    return withScheme.replace(/\/+$/, '');
+}
+//# sourceMappingURL=wizardSettings.js.map

package/dist/src/auth/wizardSettings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizardSettings.js","sourceRoot":"","sources":["../../../src/auth/wizardSettings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAiBvD;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAA0B;IAE1B,MAAM,OAAO,GAAoB,EAAE,CAAC;IAEpC,kBAAkB;IAClB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IAE9D,gCAAgC;IAChC,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAChC,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,4BAA4B;gBAClC,KAAK,EAAE,KAAK,CAAC,cAAc;aAC5B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;SAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,mBAAmB,EAAE,CAAC;QAClD,IAAI,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CACb,4EAA4E,CAC7E,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACjE,MAAM,KAAK,GAAG,KAAK,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAClD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,UAAU,IAAI,gBAAgB,CAAC;aACvE,IAAI,EAAE;aACN,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACvB,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CACb,qEAAqE,CACtE,CAAC;QACJ,CAAC;QAED,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,8BAA8B;YACpC,KAAK,EAAE,OAAO;SACf,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,4BAA4B;YAClC,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;QACH,8DAA8D;QAC9D,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,gCAAgC;YACtC,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,sCAAsC;YAC5C,KAAK,EAAE,UAAU;SAClB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW;IACnC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC;QAC9C,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,WAAW,OAAO,EAAE,CAAC;IAEzB,mEAAmE;IACnE,OAAO,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACxC,CAAC"}

package/dist/src/auth/wizardSettings.test.d.ts

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

package/dist/src/auth/wizardSettings.test.js

@@ -0,0 +1,63 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, expect, it } from 'vitest';
+import { buildWizardSettingsPatch } from './wizardSettings.js';
+import { AuthType } from '../core/contentGenerator.js';
+describe('buildWizardSettingsPatch', () => {
+    it('should build patches for Gemini provider with selected auth type', () => {
+        const patches = buildWizardSettingsPatch({
+            provider: 'gemini',
+            geminiAuthType: AuthType.USE_GEMINI,
+        });
+        expect(patches).toEqual([
+            { path: 'llm.provider', value: 'gemini' },
+            { path: 'security.auth.selectedType', value: AuthType.USE_GEMINI },
+        ]);
+    });
+    it('should build patches for OpenAI-compatible provider with normalized baseUrl and defaults', () => {
+        const patches = buildWizardSettingsPatch({
+            provider: 'openai_compatible',
+            openaiCompatible: {
+                baseUrl: ' example.com/v1/ ',
+                model: ' gpt-4o ',
+            },
+        });
+        expect(patches).toEqual([
+            { path: 'llm.provider', value: 'openai_compatible' },
+            { path: 'llm.openaiCompatible.baseUrl', value: 'https://example.com/v1' },
+            { path: 'llm.openaiCompatible.model', value: 'gpt-4o' },
+            { path: 'llm.openaiCompatible.auth.type', value: 'api-key' },
+            { path: 'llm.openaiCompatible.auth.envVarName', value: 'OPENAI_API_KEY' },
+        ]);
+    });
+    it('should preserve http:// baseUrl and trim env var name', () => {
+        const patches = buildWizardSettingsPatch({
+            provider: 'openai_compatible',
+            openaiCompatible: {
+                baseUrl: 'http://localhost:11434/v1/',
+                model: 'llama3',
+                envVarName: '  MY_OPENAI_KEY  ',
+            },
+        });
+        expect(patches).toEqual([
+            { path: 'llm.provider', value: 'openai_compatible' },
+            {
+                path: 'llm.openaiCompatible.baseUrl',
+                value: 'http://localhost:11434/v1',
+            },
+            { path: 'llm.openaiCompatible.model', value: 'llama3' },
+            { path: 'llm.openaiCompatible.auth.type', value: 'api-key' },
+            { path: 'llm.openaiCompatible.auth.envVarName', value: 'MY_OPENAI_KEY' },
+        ]);
+    });
+    it('should throw if OpenAI-compatible provider is selected without config', () => {
+        expect(() => buildWizardSettingsPatch({
+            provider: 'openai_compatible',
+        })).toThrow('openaiCompatible config is missing');
+    });
+});
+//# sourceMappingURL=wizardSettings.test.js.map

package/dist/src/auth/wizardSettings.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizardSettings.test.js","sourceRoot":"","sources":["../../../src/auth/wizardSettings.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEvD,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,OAAO,GAAG,wBAAwB,CAAC;YACvC,QAAQ,EAAE,QAAQ;YAClB,cAAc,EAAE,QAAQ,CAAC,UAAU;SACpC,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;YACtB,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,QAAQ,EAAE;YACzC,EAAE,IAAI,EAAE,4BAA4B,EAAE,KAAK,EAAE,QAAQ,CAAC,UAAU,EAAE;SACnE,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0FAA0F,EAAE,GAAG,EAAE;QAClG,MAAM,OAAO,GAAG,wBAAwB,CAAC;YACvC,QAAQ,EAAE,mBAAmB;YAC7B,gBAAgB,EAAE;gBAChB,OAAO,EAAE,mBAAmB;gBAC5B,KAAK,EAAE,UAAU;aAClB;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;YACtB,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,mBAAmB,EAAE;YACpD,EAAE,IAAI,EAAE,8BAA8B,EAAE,KAAK,EAAE,wBAAwB,EAAE;YACzE,EAAE,IAAI,EAAE,4BAA4B,EAAE,KAAK,EAAE,QAAQ,EAAE;YACvD,EAAE,IAAI,EAAE,gCAAgC,EAAE,KAAK,EAAE,SAAS,EAAE;YAC5D,EAAE,IAAI,EAAE,sCAAsC,EAAE,KAAK,EAAE,gBAAgB,EAAE;SAC1E,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,OAAO,GAAG,wBAAwB,CAAC;YACvC,QAAQ,EAAE,mBAAmB;YAC7B,gBAAgB,EAAE;gBAChB,OAAO,EAAE,4BAA4B;gBACrC,KAAK,EAAE,QAAQ;gBACf,UAAU,EAAE,mBAAmB;aAChC;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;YACtB,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,mBAAmB,EAAE;YACpD;gBACE,IAAI,EAAE,8BAA8B;gBACpC,KAAK,EAAE,2BAA2B;aACnC;YACD,EAAE,IAAI,EAAE,4BAA4B,EAAE,KAAK,EAAE,QAAQ,EAAE;YACvD,EAAE,IAAI,EAAE,gCAAgC,EAAE,KAAK,EAAE,SAAS,EAAE;YAC5D,EAAE,IAAI,EAAE,sCAAsC,EAAE,KAAK,EAAE,eAAe,EAAE;SACzE,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAC/E,MAAM,CAAC,GAAG,EAAE,CACV,wBAAwB,CAAC;YACvB,QAAQ,EAAE,mBAAmB;SAC9B,CAAC,CACH,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/auth/wizardState.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AuthType } from '../core/contentGenerator.js';
+/**
+ * Provider identifiers supported by the wizard
+ */
+export type ProviderId = 'gemini' | 'openai_compatible' | 'anthropic';
+/**
+ * Auth methods for Gemini provider
+ */
+export type GeminiAuthMethod = 'oauth' | 'api_key' | 'vertex_ai';
+/**
+ * Auth methods for OpenAI-compatible provider
+ */
+export type OpenAIAuthMethod = 'api_key';
+/**
+ * Auth methods for Anthropic provider
+ */
+export type AnthropicAuthMethod = 'oauth' | 'api_key';
+/**
+ * Union of all auth methods
+ */
+export type AuthMethod = GeminiAuthMethod | OpenAIAuthMethod | AnthropicAuthMethod;
+/**
+ * Wizard step progression
+ */
+export type WizardStep = 'provider' | 'auth_method' | 'setup' | 'complete';
+/**
+ * Wizard state interface
+ */
+export interface WizardState {
+    readonly step: WizardStep;
+    readonly provider: ProviderId | null;
+    readonly authMethod: AuthMethod | null;
+    readonly error: string | null;
+}
+/**
+ * Create initial wizard state
+ */
+export declare function createInitialState(): WizardState;
+/**
+ * Select a provider and transition to appropriate step
+ */
+export declare function selectProvider(state: WizardState, provider: ProviderId): WizardState;
+/**
+ * Select an auth method and transition to setup step
+ */
+export declare function selectAuthMethod(state: WizardState, method: AuthMethod): WizardState;
+/**
+ * Complete the wizard setup
+ */
+export declare function completeSetup(state: WizardState): WizardState;
+/**
+ * Navigate back one step deterministically.
+ */
+export declare function back(state: WizardState): WizardState;
+/**
+ * Set an error in the wizard state
+ */
+export declare function setError(state: WizardState, error: string): WizardState;
+/**
+ * Get the next step based on current state
+ */
+export declare function getNextStep(state: WizardState): WizardStep;
+/**
+ * Check if a provider needs an auth method selection step
+ */
+export declare function needsAuthMethodStep(provider: ProviderId): boolean;
+/**
+ * Get available auth methods for a provider
+ */
+export declare function getAuthMethodOptions(provider: ProviderId): AuthMethod[];
+/**
+ * Map wizard auth method to core AuthType (for Gemini provider)
+ */
+export declare function mapGeminiAuthMethodToAuthType(method: GeminiAuthMethod): AuthType;