@didim365/agent-cli-core 0.1.0

package/dist/src/providers/providerSelector.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ProviderType, type AuthType } from './providerTypes.js';
+/**
+ * Provider selection result.
+ */
+export interface ProviderSelection {
+    /** Selected provider type */
+    type: ProviderType;
+    /** Auth type (only for Gemini) */
+    authType?: AuthType;
+    /** API key if available */
+    apiKey?: string;
+    /** Base URL (for OpenAI-compatible) */
+    baseUrl?: string;
+}
+/**
+ * Options for provider selection.
+ */
+export interface ProviderSelectionOptions {
+    /** Configured auth type (for Gemini) */
+    authType?: AuthType;
+}
+/**
+ * Select the appropriate provider based on environment and config.
+ *
+ * Priority order:
+ * 1. LLM_PROVIDER environment variable
+ * 2. Configured authType (implies Gemini)
+ * 3. GEMINI_API_KEY or GOOGLE_API_KEY (fallback to Gemini)
+ *
+ * @param options - Selection options
+ * @returns Provider selection result
+ *
+ * @example
+ * ```ts
+ * // Use LLM_PROVIDER=claude
+ * const result = selectProvider();
+ * // { type: ProviderType.Claude }
+ *
+ * // Use authType config
+ * const result = selectProvider({ authType: AuthType.USE_GEMINI });
+ * // { type: ProviderType.Gemini, authType: AuthType.USE_GEMINI }
+ * ```
+ */
+export declare function selectProvider(options?: ProviderSelectionOptions): ProviderSelection;
+/**
+ * Get required environment variables for a provider.
+ *
+ * @param provider - Provider type
+ * @returns Array of required environment variable names
+ */
+export declare function getRequiredEnvVars(provider: ProviderType): string[];
+/**
+ * Validate that required environment variables are set for a provider.
+ *
+ * @param provider - Provider type
+ * @throws Error if required env vars are missing
+ */
+export declare function validateProviderEnv(provider: ProviderType): void;
+/**
+ * Get the default model name for a provider.
+ *
+ * @param provider - Provider type
+ * @returns Default model name string
+ */
+export declare function getDefaultModelForProvider(provider: ProviderType): string;
+/**
+ * Check if a model name is Gemini-specific (concrete name, alias, or auto model).
+ *
+ * @param model - Model name to check
+ * @returns True if the model is a Gemini-specific name
+ */
+export declare function isGeminiSpecificModel(model: string): boolean;
+/**
+ * Resolve the model name for a given provider.
+ *
+ * Priority:
+ * 1. If model is not Gemini-specific → pass through unchanged
+ * 2. LLM_MODEL env var → use as explicit override
+ * 3. Gemini-specific model + non-Gemini provider → provider's default model
+ * 4. Gemini provider → pass through unchanged
+ *
+ * @param model - Current model name (may be Gemini-specific)
+ * @param provider - Target provider type or provider name string
+ * @returns Resolved model name appropriate for the provider
+ */
+export declare function resolveProviderModel(model: string, provider: ProviderType | string): string;

package/dist/src/providers/providerSelector.js

@@ -0,0 +1,221 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ProviderType, getProviderForAuthType, } from './providerTypes.js';
+import { LlmError, LlmErrorType } from './errors.js';
+/**
+ * Required environment variables per provider.
+ */
+const PROVIDER_ENV_VARS = {
+    [ProviderType.Gemini]: ['GEMINI_API_KEY', 'GOOGLE_API_KEY'],
+    [ProviderType.Claude]: ['ANTHROPIC_API_KEY'],
+    [ProviderType.OpenAI]: ['OPENAI_API_KEY'],
+    [ProviderType.OpenAICompatible]: ['LLM_BASE_URL'],
+    [ProviderType.Didim]: ['DIDIM_API_KEY'],
+};
+/**
+ * Parse LLM_PROVIDER environment variable to ProviderType.
+ */
+function parseProviderEnv(value) {
+    const normalized = value.toLowerCase().trim();
+    switch (normalized) {
+        case 'gemini':
+            return ProviderType.Gemini;
+        case 'claude':
+        case 'anthropic':
+            return ProviderType.Claude;
+        case 'openai':
+            return ProviderType.OpenAI;
+        case 'openai-compatible':
+        case 'openai_compatible':
+            return ProviderType.OpenAICompatible;
+        case 'didim':
+            return ProviderType.Didim;
+        default:
+            throw new LlmError(LlmErrorType.INVALID_REQUEST, `Unknown provider: ${value}`);
+    }
+}
+/**
+ * Select the appropriate provider based on environment and config.
+ *
+ * Priority order:
+ * 1. LLM_PROVIDER environment variable
+ * 2. Configured authType (implies Gemini)
+ * 3. GEMINI_API_KEY or GOOGLE_API_KEY (fallback to Gemini)
+ *
+ * @param options - Selection options
+ * @returns Provider selection result
+ *
+ * @example
+ * ```ts
+ * // Use LLM_PROVIDER=claude
+ * const result = selectProvider();
+ * // { type: ProviderType.Claude }
+ *
+ * // Use authType config
+ * const result = selectProvider({ authType: AuthType.USE_GEMINI });
+ * // { type: ProviderType.Gemini, authType: AuthType.USE_GEMINI }
+ * ```
+ */
+export function selectProvider(options = {}) {
+    const llmProvider = process.env['LLM_PROVIDER'];
+    // Priority 1: LLM_PROVIDER env var
+    if (llmProvider) {
+        const providerType = parseProviderEnv(llmProvider);
+        validateProviderEnv(providerType);
+        const selection = {
+            type: providerType,
+            apiKey: getApiKeyForProvider(providerType),
+        };
+        // Add baseUrl for OpenAI-compatible
+        if (providerType === ProviderType.OpenAICompatible) {
+            selection.baseUrl = process.env['LLM_BASE_URL'];
+        }
+        return selection;
+    }
+    // Priority 2: authType config (implies Gemini)
+    if (options.authType) {
+        return {
+            type: getProviderForAuthType(options.authType),
+            authType: options.authType,
+            apiKey: getApiKeyForProvider(ProviderType.Gemini),
+        };
+    }
+    // Priority 3: Fallback - check for Gemini API key
+    const geminiKey = process.env['GEMINI_API_KEY'] || process.env['GOOGLE_API_KEY'];
+    if (geminiKey) {
+        return {
+            type: ProviderType.Gemini,
+            apiKey: geminiKey,
+        };
+    }
+    // Default to Gemini (will fail later if no auth configured)
+    return {
+        type: ProviderType.Gemini,
+    };
+}
+/**
+ * Get required environment variables for a provider.
+ *
+ * @param provider - Provider type
+ * @returns Array of required environment variable names
+ */
+export function getRequiredEnvVars(provider) {
+    return PROVIDER_ENV_VARS[provider] ?? [];
+}
+/**
+ * Validate that required environment variables are set for a provider.
+ *
+ * @param provider - Provider type
+ * @throws Error if required env vars are missing
+ */
+export function validateProviderEnv(provider) {
+    const requiredVars = getRequiredEnvVars(provider);
+    // For Gemini, either GEMINI_API_KEY or GOOGLE_API_KEY works
+    if (provider === ProviderType.Gemini) {
+        const hasAnyKey = requiredVars.some((v) => !!process.env[v]);
+        if (!hasAnyKey) {
+            throw new LlmError(LlmErrorType.INVALID_REQUEST, `Missing required environment variable: One of ${requiredVars.join(' or ')} must be set`);
+        }
+        return;
+    }
+    // For other providers, check all required vars
+    const missingVars = requiredVars.filter((v) => !process.env[v]);
+    if (missingVars.length > 0) {
+        throw new LlmError(LlmErrorType.INVALID_REQUEST, `Missing required environment variable: ${missingVars.join(', ')}`);
+    }
+}
+// ============================================================================
+// Provider Model Resolution
+// ============================================================================
+/**
+ * Default model names per provider type.
+ *
+ * When the CLI is configured with a Gemini-specific model (e.g., 'gemini-2.5-pro')
+ * but a non-Gemini provider is selected, these defaults are used instead.
+ */
+const DEFAULT_PROVIDER_MODELS = {
+    [ProviderType.Gemini]: 'gemini-2.5-pro',
+    [ProviderType.Claude]: 'claude-sonnet-4-20250514',
+    [ProviderType.OpenAI]: 'gpt-4o',
+    [ProviderType.OpenAICompatible]: 'default',
+    [ProviderType.Didim]: 'didim-default',
+};
+/**
+ * Gemini model aliases recognized by the CLI.
+ * These are short-form names that the model router resolves to concrete Gemini models.
+ */
+const GEMINI_ALIASES = new Set(['auto', 'pro', 'flash', 'flash-lite']);
+/**
+ * Get the default model name for a provider.
+ *
+ * @param provider - Provider type
+ * @returns Default model name string
+ */
+export function getDefaultModelForProvider(provider) {
+    return DEFAULT_PROVIDER_MODELS[provider];
+}
+/**
+ * Check if a model name is Gemini-specific (concrete name, alias, or auto model).
+ *
+ * @param model - Model name to check
+ * @returns True if the model is a Gemini-specific name
+ */
+export function isGeminiSpecificModel(model) {
+    return (model.startsWith('gemini-') ||
+        model.startsWith('auto-gemini') ||
+        GEMINI_ALIASES.has(model));
+}
+/**
+ * Resolve the model name for a given provider.
+ *
+ * Priority:
+ * 1. If model is not Gemini-specific → pass through unchanged
+ * 2. LLM_MODEL env var → use as explicit override
+ * 3. Gemini-specific model + non-Gemini provider → provider's default model
+ * 4. Gemini provider → pass through unchanged
+ *
+ * @param model - Current model name (may be Gemini-specific)
+ * @param provider - Target provider type or provider name string
+ * @returns Resolved model name appropriate for the provider
+ */
+export function resolveProviderModel(model, provider) {
+    // Non-Gemini model names always pass through
+    if (!isGeminiSpecificModel(model)) {
+        return model;
+    }
+    // Gemini provider uses Gemini models directly
+    if (provider === ProviderType.Gemini) {
+        return model;
+    }
+    // LLM_MODEL env var takes priority for non-Gemini providers
+    const llmModel = process.env['LLM_MODEL'];
+    if (llmModel) {
+        return llmModel;
+    }
+    // Gemini-specific model + non-Gemini provider → provider default
+    const providerKey = provider;
+    return DEFAULT_PROVIDER_MODELS[providerKey] ?? model;
+}
+/**
+ * Get API key for a provider from environment.
+ */
+function getApiKeyForProvider(provider) {
+    switch (provider) {
+        case ProviderType.Gemini:
+            return process.env['GEMINI_API_KEY'] || process.env['GOOGLE_API_KEY'];
+        case ProviderType.Claude:
+            return process.env['ANTHROPIC_API_KEY'];
+        case ProviderType.OpenAI:
+            return process.env['OPENAI_API_KEY'];
+        case ProviderType.Didim:
+            return process.env['DIDIM_API_KEY'];
+        case ProviderType.OpenAICompatible:
+            return process.env['LLM_API_KEY'];
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=providerSelector.js.map

package/dist/src/providers/providerSelector.js.map

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

package/dist/src/providers/providerSelector.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/providers/providerSelector.test.js

@@ -0,0 +1,199 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { selectProvider, getRequiredEnvVars, validateProviderEnv, getDefaultModelForProvider, isGeminiSpecificModel, resolveProviderModel, } from './providerSelector.js';
+import { ProviderType, AuthType } from './providerTypes.js';
+describe('ProviderSelector', () => {
+    beforeEach(() => {
+        vi.stubEnv('LLM_PROVIDER', '');
+        vi.stubEnv('GEMINI_API_KEY', '');
+        vi.stubEnv('GOOGLE_API_KEY', '');
+        vi.stubEnv('ANTHROPIC_API_KEY', '');
+        vi.stubEnv('OPENAI_API_KEY', '');
+        vi.stubEnv('DIDIM_API_KEY', '');
+        vi.stubEnv('LLM_BASE_URL', '');
+        vi.stubEnv('LLM_API_KEY', '');
+    });
+    afterEach(() => {
+        vi.unstubAllEnvs();
+    });
+    describe('selectProvider()', () => {
+        it('should prioritize LLM_PROVIDER over authType', () => {
+            vi.stubEnv('LLM_PROVIDER', 'claude');
+            vi.stubEnv('ANTHROPIC_API_KEY', 'xxx');
+            const result = selectProvider();
+            expect(result.type).toBe(ProviderType.Claude);
+        });
+        it('should use authType for Gemini when LLM_PROVIDER not set', () => {
+            vi.stubEnv('GEMINI_API_KEY', 'xxx');
+            const result = selectProvider({ authType: AuthType.USE_GEMINI });
+            expect(result.type).toBe(ProviderType.Gemini);
+            expect(result.authType).toBe(AuthType.USE_GEMINI);
+        });
+        it('should default to Gemini with GEMINI_API_KEY', () => {
+            vi.stubEnv('GEMINI_API_KEY', 'xxx');
+            const result = selectProvider();
+            expect(result.type).toBe(ProviderType.Gemini);
+        });
+        it('should select Claude when LLM_PROVIDER=claude', () => {
+            vi.stubEnv('LLM_PROVIDER', 'claude');
+            vi.stubEnv('ANTHROPIC_API_KEY', 'xxx');
+            const result = selectProvider();
+            expect(result.type).toBe(ProviderType.Claude);
+        });
+        it('should select OpenAI when LLM_PROVIDER=openai', () => {
+            vi.stubEnv('LLM_PROVIDER', 'openai');
+            vi.stubEnv('OPENAI_API_KEY', 'xxx');
+            const result = selectProvider();
+            expect(result.type).toBe(ProviderType.OpenAI);
+        });
+        it('should include baseUrl for OpenAI-compatible', () => {
+            vi.stubEnv('LLM_PROVIDER', 'openai-compatible');
+            vi.stubEnv('LLM_BASE_URL', 'https://api.local.com');
+            const result = selectProvider();
+            expect(result.type).toBe(ProviderType.OpenAICompatible);
+            expect(result.baseUrl).toBe('https://api.local.com');
+        });
+        it('should throw for invalid LLM_PROVIDER', () => {
+            vi.stubEnv('LLM_PROVIDER', 'invalid-provider');
+            expect(() => selectProvider()).toThrow(/unknown provider/i);
+        });
+    });
+    describe('getRequiredEnvVars()', () => {
+        it('should return Gemini required vars', () => {
+            const vars = getRequiredEnvVars(ProviderType.Gemini);
+            expect(vars).toContain('GEMINI_API_KEY');
+        });
+        it('should return Claude required vars', () => {
+            const vars = getRequiredEnvVars(ProviderType.Claude);
+            expect(vars).toContain('ANTHROPIC_API_KEY');
+        });
+        it('should return OpenAI required vars', () => {
+            const vars = getRequiredEnvVars(ProviderType.OpenAI);
+            expect(vars).toContain('OPENAI_API_KEY');
+        });
+        it('should return OpenAI-compatible required vars', () => {
+            const vars = getRequiredEnvVars(ProviderType.OpenAICompatible);
+            expect(vars).toContain('LLM_BASE_URL');
+        });
+        it('should return Didim required vars', () => {
+            const vars = getRequiredEnvVars(ProviderType.Didim);
+            expect(vars).toContain('DIDIM_API_KEY');
+        });
+    });
+    // ==========================================================================
+    // Provider Model Resolution
+    // ==========================================================================
+    describe('getDefaultModelForProvider()', () => {
+        it('should return default model for Claude', () => {
+            const model = getDefaultModelForProvider(ProviderType.Claude);
+            expect(model).toMatch(/^claude-/);
+        });
+        it('should return default model for OpenAI', () => {
+            const model = getDefaultModelForProvider(ProviderType.OpenAI);
+            expect(model).toMatch(/^gpt-/);
+        });
+        it('should return default model for Gemini', () => {
+            const model = getDefaultModelForProvider(ProviderType.Gemini);
+            expect(model).toMatch(/^gemini-/);
+        });
+        it('should return default model for OpenAI-compatible', () => {
+            const model = getDefaultModelForProvider(ProviderType.OpenAICompatible);
+            // OpenAI-compatible uses 'default' as a generic placeholder
+            // since local servers (vLLM/Ollama) don't use OpenAI model names.
+            expect(model).toBe('default');
+        });
+    });
+    describe('isGeminiSpecificModel()', () => {
+        it('should detect Gemini concrete model names', () => {
+            expect(isGeminiSpecificModel('gemini-2.5-pro')).toBe(true);
+            expect(isGeminiSpecificModel('gemini-2.5-flash')).toBe(true);
+            expect(isGeminiSpecificModel('gemini-3-pro-preview')).toBe(true);
+        });
+        it('should detect Gemini auto models', () => {
+            expect(isGeminiSpecificModel('auto-gemini-2.5')).toBe(true);
+            expect(isGeminiSpecificModel('auto-gemini-3')).toBe(true);
+        });
+        it('should detect Gemini aliases', () => {
+            expect(isGeminiSpecificModel('auto')).toBe(true);
+            expect(isGeminiSpecificModel('pro')).toBe(true);
+            expect(isGeminiSpecificModel('flash')).toBe(true);
+            expect(isGeminiSpecificModel('flash-lite')).toBe(true);
+        });
+        it('should NOT detect non-Gemini model names', () => {
+            expect(isGeminiSpecificModel('claude-sonnet-4-20250514')).toBe(false);
+            expect(isGeminiSpecificModel('gpt-4o')).toBe(false);
+            expect(isGeminiSpecificModel('my-custom-model')).toBe(false);
+        });
+    });
+    describe('resolveProviderModel()', () => {
+        it('should pass through Gemini model for Gemini provider', () => {
+            const result = resolveProviderModel('gemini-2.5-pro', ProviderType.Gemini);
+            expect(result).toBe('gemini-2.5-pro');
+        });
+        it('should resolve Gemini default to Claude model for Claude provider', () => {
+            const result = resolveProviderModel('gemini-2.5-pro', ProviderType.Claude);
+            expect(result).toMatch(/^claude-/);
+        });
+        it('should resolve Gemini default to OpenAI model for OpenAI provider', () => {
+            const result = resolveProviderModel('gemini-2.5-pro', ProviderType.OpenAI);
+            expect(result).toMatch(/^gpt-/);
+        });
+        it('should resolve Gemini alias to provider default', () => {
+            const result = resolveProviderModel('auto', ProviderType.Claude);
+            expect(result).toMatch(/^claude-/);
+        });
+        it('should resolve auto-gemini-2.5 to provider default', () => {
+            const result = resolveProviderModel('auto-gemini-2.5', ProviderType.OpenAI);
+            expect(result).toMatch(/^gpt-/);
+        });
+        it('should pass through explicit non-Gemini model name', () => {
+            const result = resolveProviderModel('claude-3-opus-20240229', ProviderType.Claude);
+            expect(result).toBe('claude-3-opus-20240229');
+        });
+        it('should pass through custom model name for OpenAI-compatible', () => {
+            const result = resolveProviderModel('my-local-llama', ProviderType.OpenAICompatible);
+            expect(result).toBe('my-local-llama');
+        });
+        it('should prioritize LLM_MODEL env var over default resolution', () => {
+            vi.stubEnv('LLM_MODEL', 'claude-3-opus-20240229');
+            const result = resolveProviderModel('gemini-2.5-pro', ProviderType.Claude);
+            expect(result).toBe('claude-3-opus-20240229');
+        });
+        it('should not use LLM_MODEL if model is already non-Gemini', () => {
+            vi.stubEnv('LLM_MODEL', 'claude-3-opus-20240229');
+            const result = resolveProviderModel('claude-sonnet-4-20250514', ProviderType.Claude);
+            expect(result).toBe('claude-sonnet-4-20250514');
+        });
+    });
+    describe('validateProviderEnv()', () => {
+        it('should pass when Gemini API key is set', () => {
+            vi.stubEnv('GEMINI_API_KEY', 'xxx');
+            expect(() => validateProviderEnv(ProviderType.Gemini)).not.toThrow();
+        });
+        it('should pass when GOOGLE_API_KEY is set for Gemini', () => {
+            vi.stubEnv('GOOGLE_API_KEY', 'xxx');
+            expect(() => validateProviderEnv(ProviderType.Gemini)).not.toThrow();
+        });
+        it('should throw when Claude API key is missing', () => {
+            expect(() => validateProviderEnv(ProviderType.Claude)).toThrow(/ANTHROPIC_API_KEY/);
+        });
+        it('should throw when OpenAI API key is missing', () => {
+            expect(() => validateProviderEnv(ProviderType.OpenAI)).toThrow(/OPENAI_API_KEY/);
+        });
+        it('should throw LlmError for configuration issues', () => {
+            vi.stubEnv('LLM_PROVIDER', 'invalid-provider');
+            try {
+                selectProvider();
+                expect.fail('Should have thrown');
+            }
+            catch (error) {
+                expect(error.name).toBe('LlmError');
+            }
+        });
+    });
+});
+//# sourceMappingURL=providerSelector.test.js.map

package/dist/src/providers/providerSelector.test.js.map

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

package/dist/src/providers/providerTypes.d.ts

@@ -0,0 +1,94 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Supported LLM provider types.
+ *
+ * This enum defines all supported provider backends. Each provider
+ * has its own authentication and configuration requirements.
+ */
+export declare enum ProviderType {
+    /** Google Gemini (supports multiple auth types) */
+    Gemini = "gemini",
+    /** Anthropic Claude (API key only) */
+    Claude = "claude",
+    /** OpenAI (API key only) */
+    OpenAI = "openai",
+    /** OpenAI-compatible API (custom endpoint) */
+    OpenAICompatible = "openai-compatible",
+    /** Didim AI Studio (internal) */
+    Didim = "didim"
+}
+/**
+ * Authentication types for Gemini provider.
+ *
+ * AuthType is specific to the Gemini provider, which supports
+ * multiple authentication methods. Other providers use API keys only.
+ *
+ * @remarks
+ * This enum mirrors the AuthType in `core/contentGenerator.ts` for
+ * compatibility with existing auth flows. Both enums have identical
+ * values. The providers module uses this local copy to avoid circular
+ * dependencies with the core module.
+ *
+ * @see core/contentGenerator.ts AuthType for the original definition
+ */
+export declare enum AuthType {
+    /** OAuth2 personal login via Google */
+    LOGIN_WITH_GOOGLE = "oauth-personal",
+    /** Direct Gemini API key */
+    USE_GEMINI = "gemini-api-key",
+    /** Vertex AI with Google Cloud */
+    USE_VERTEX_AI = "vertex-ai",
+    /** Legacy Cloud Shell authentication */
+    LEGACY_CLOUD_SHELL = "cloud-shell",
+    /** Compute Engine default credentials */
+    COMPUTE_ADC = "compute-default-credentials"
+}
+/**
+ * Mapping of provider types to supported auth types.
+ *
+ * Only Gemini supports AuthType; other providers use API keys directly.
+ */
+export declare const PROVIDER_AUTH_MAPPING: Record<ProviderType, AuthType[]>;
+/**
+ * Get supported auth types for a provider.
+ *
+ * @param provider - Provider type
+ * @returns Array of supported auth types (empty for non-Gemini providers)
+ *
+ * @example
+ * ```ts
+ * getAuthTypesForProvider(ProviderType.Gemini)
+ * // [AuthType.LOGIN_WITH_GOOGLE, AuthType.USE_GEMINI, ...]
+ *
+ * getAuthTypesForProvider(ProviderType.Claude)
+ * // []
+ * ```
+ */
+export declare function getAuthTypesForProvider(provider: ProviderType): AuthType[];
+/**
+ * Get the provider type for an auth type.
+ *
+ * Since all AuthTypes are Gemini-specific, this always returns Gemini.
+ *
+ * @param authType - Authentication type
+ * @returns ProviderType.Gemini
+ */
+export declare function getProviderForAuthType(_authType: AuthType): ProviderType;
+/**
+ * Check if an auth type is for Gemini provider.
+ *
+ * @param authType - Authentication type to check
+ * @returns True (all AuthTypes are Gemini-specific)
+ */
+export declare function isGeminiAuthType(_authType: AuthType): boolean;
+/**
+ * Check if a provider supports AuthType-based authentication.
+ *
+ * @param provider - Provider type
+ * @returns True if provider supports AuthType (only Gemini)
+ */
+export declare function supportsAuthType(provider: ProviderType): boolean;