@didim365/agent-cli-core 0.1.0

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

@@ -0,0 +1,103 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AdapterConfig } from './types.js';
+import type { BaseAdapter } from './baseAdapter.js';
+import { ProviderRegistry } from './registry.js';
+/**
+ * Factory for creating LLM provider adapter instances.
+ *
+ * This class provides a high-level API for creating adapters without
+ * directly interacting with the registry. It also provides validation
+ * and convenience methods.
+ *
+ * @example
+ * ```ts
+ * const factory = new ProviderFactory();
+ *
+ * // Check if provider is available
+ * if (factory.canCreate('gemini')) {
+ *   const adapter = factory.create('gemini', { apiKey: 'xxx' });
+ * }
+ *
+ * // List available providers
+ * console.log(factory.getAvailableProviders());
+ * ```
+ *
+ * @see docs/ai_adapter/03-technical-design.md §3.6
+ */
+export declare class ProviderFactory {
+    private readonly registry;
+    /**
+     * Create a new ProviderFactory.
+     *
+     * @param registry - Optional registry instance. Defaults to singleton.
+     */
+    constructor(registry?: ProviderRegistry);
+    /**
+     * Create an adapter instance for the specified provider.
+     *
+     * @param providerName - Provider name (e.g., 'gemini', 'claude', 'openai')
+     * @param config - Adapter configuration
+     * @returns Adapter instance
+     * @throws {LlmError} If provider is not registered (PROVIDER_NOT_FOUND)
+     */
+    create(providerName: string, config: AdapterConfig): BaseAdapter;
+    /**
+     * Create an adapter instance with config validation.
+     *
+     * **Error Priority**: PROVIDER_NOT_FOUND is checked first, then config validation.
+     * This ensures callers get the most actionable error message.
+     *
+     * **Authentication Flexibility**: `requireApiKey` defaults to `false` to support
+     * multiple authentication scenarios:
+     * - OAuth 2.0 (Vertex AI, Azure OpenAI)
+     * - Application Default Credentials (ADC)
+     * - Environment-based authentication
+     * - Local/keyless development modes
+     *
+     * Use `{ requireApiKey: true }` when the adapter strictly requires an API key.
+     *
+     * @param providerName - Provider name (e.g., 'gemini', 'claude', 'openai')
+     * @param config - Adapter configuration
+     * @param options - Validation options
+     * @param options.requireApiKey - If true, validates that apiKey is present (default: false)
+     * @returns Adapter instance
+     * @throws {LlmError} PROVIDER_NOT_FOUND if provider is not registered
+     * @throws {LlmError} VALIDATION if requireApiKey is true and apiKey is missing
+     *
+     * @example
+     * ```ts
+     * // OAuth/ADC scenario (no apiKey validation)
+     * factory.createWithValidation('vertex-ai', { projectId: 'my-project' });
+     *
+     * // API key required scenario
+     * factory.createWithValidation('openai', { apiKey: 'sk-xxx' }, { requireApiKey: true });
+     * ```
+     */
+    createWithValidation(providerName: string, config: AdapterConfig, options?: {
+        requireApiKey?: boolean;
+    }): BaseAdapter;
+    /**
+     * Check if a provider can be created.
+     *
+     * @param providerName - Provider name
+     * @returns true if provider is registered
+     */
+    canCreate(providerName: string): boolean;
+    /**
+     * Get list of available provider names.
+     *
+     * @returns Array of provider names
+     */
+    getAvailableProviders(): string[];
+    /**
+     * Validate adapter configuration.
+     *
+     * @param config - Configuration to validate
+     * @throws {LlmError} If configuration is invalid
+     */
+    private validateConfig;
+}

package/dist/src/providers/factory.js

@@ -0,0 +1,123 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ProviderRegistry } from './registry.js';
+import { LlmError, LlmErrorType } from './errors.js';
+/**
+ * Factory for creating LLM provider adapter instances.
+ *
+ * This class provides a high-level API for creating adapters without
+ * directly interacting with the registry. It also provides validation
+ * and convenience methods.
+ *
+ * @example
+ * ```ts
+ * const factory = new ProviderFactory();
+ *
+ * // Check if provider is available
+ * if (factory.canCreate('gemini')) {
+ *   const adapter = factory.create('gemini', { apiKey: 'xxx' });
+ * }
+ *
+ * // List available providers
+ * console.log(factory.getAvailableProviders());
+ * ```
+ *
+ * @see docs/ai_adapter/03-technical-design.md §3.6
+ */
+export class ProviderFactory {
+    registry;
+    /**
+     * Create a new ProviderFactory.
+     *
+     * @param registry - Optional registry instance. Defaults to singleton.
+     */
+    constructor(registry) {
+        this.registry = registry ?? ProviderRegistry.getInstance();
+    }
+    /**
+     * Create an adapter instance for the specified provider.
+     *
+     * @param providerName - Provider name (e.g., 'gemini', 'claude', 'openai')
+     * @param config - Adapter configuration
+     * @returns Adapter instance
+     * @throws {LlmError} If provider is not registered (PROVIDER_NOT_FOUND)
+     */
+    create(providerName, config) {
+        return this.registry.createAdapter(providerName, config);
+    }
+    /**
+     * Create an adapter instance with config validation.
+     *
+     * **Error Priority**: PROVIDER_NOT_FOUND is checked first, then config validation.
+     * This ensures callers get the most actionable error message.
+     *
+     * **Authentication Flexibility**: `requireApiKey` defaults to `false` to support
+     * multiple authentication scenarios:
+     * - OAuth 2.0 (Vertex AI, Azure OpenAI)
+     * - Application Default Credentials (ADC)
+     * - Environment-based authentication
+     * - Local/keyless development modes
+     *
+     * Use `{ requireApiKey: true }` when the adapter strictly requires an API key.
+     *
+     * @param providerName - Provider name (e.g., 'gemini', 'claude', 'openai')
+     * @param config - Adapter configuration
+     * @param options - Validation options
+     * @param options.requireApiKey - If true, validates that apiKey is present (default: false)
+     * @returns Adapter instance
+     * @throws {LlmError} PROVIDER_NOT_FOUND if provider is not registered
+     * @throws {LlmError} VALIDATION if requireApiKey is true and apiKey is missing
+     *
+     * @example
+     * ```ts
+     * // OAuth/ADC scenario (no apiKey validation)
+     * factory.createWithValidation('vertex-ai', { projectId: 'my-project' });
+     *
+     * // API key required scenario
+     * factory.createWithValidation('openai', { apiKey: 'sk-xxx' }, { requireApiKey: true });
+     * ```
+     */
+    createWithValidation(providerName, config, options) {
+        // Check provider availability first (PROVIDER_NOT_FOUND takes precedence)
+        if (!this.canCreate(providerName)) {
+            throw new LlmError(LlmErrorType.PROVIDER_NOT_FOUND, `Provider "${providerName}" is not registered`);
+        }
+        // Validate config only if requireApiKey is explicitly set
+        if (options?.requireApiKey) {
+            this.validateConfig(config);
+        }
+        return this.create(providerName, config);
+    }
+    /**
+     * Check if a provider can be created.
+     *
+     * @param providerName - Provider name
+     * @returns true if provider is registered
+     */
+    canCreate(providerName) {
+        return this.registry.has(providerName);
+    }
+    /**
+     * Get list of available provider names.
+     *
+     * @returns Array of provider names
+     */
+    getAvailableProviders() {
+        return this.registry.list();
+    }
+    /**
+     * Validate adapter configuration.
+     *
+     * @param config - Configuration to validate
+     * @throws {LlmError} If configuration is invalid
+     */
+    validateConfig(config) {
+        if (!config.apiKey) {
+            throw new LlmError(LlmErrorType.VALIDATION, 'apiKey is required in adapter configuration');
+        }
+    }
+}
+//# sourceMappingURL=factory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/providers/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,eAAe;IACT,QAAQ,CAAmB;IAE5C;;;;OAIG;IACH,YAAY,QAA2B;QACrC,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,gBAAgB,CAAC,WAAW,EAAE,CAAC;IAC7D,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,YAAoB,EAAE,MAAqB;QAChD,OAAO,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,oBAAoB,CAClB,YAAoB,EACpB,MAAqB,EACrB,OAAqC;QAErC,0EAA0E;QAC1E,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,QAAQ,CAChB,YAAY,CAAC,kBAAkB,EAC/B,aAAa,YAAY,qBAAqB,CAC/C,CAAC;QACJ,CAAC;QAED,0DAA0D;QAC1D,IAAI,OAAO,EAAE,aAAa,EAAE,CAAC;YAC3B,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,YAAoB;QAC5B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC;IAED;;;;OAIG;IACH,qBAAqB;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACK,cAAc,CAAC,MAAqB;QAC1C,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,IAAI,QAAQ,CAChB,YAAY,CAAC,UAAU,EACvB,6CAA6C,CAC9C,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

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

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

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

@@ -0,0 +1,151 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { ProviderFactory } from './factory.js';
+import { ProviderRegistry } from './registry.js';
+import { BaseAdapter } from './baseAdapter.js';
+import { LlmEventType } from './events.js';
+import { LlmErrorType } from './errors.js';
+// Mock adapter for testing
+class MockGeminiAdapter extends BaseAdapter {
+    providerName = 'gemini';
+    capabilities = {
+        supportsStreaming: true,
+        supportsToolCalls: true,
+        supportsImageInput: true,
+        supportsImageGeneration: false,
+        supportsEmbedding: true,
+        supportsTokenCount: true,
+        supportsSystemMessage: true,
+        supportsThought: true,
+        maxContextLength: 128000,
+        maxOutputTokens: 8192,
+    };
+    constructor(config) {
+        super(config);
+    }
+    async generateContent(_request, _userPromptId, _options) {
+        return {};
+    }
+    async *generateContentStream(_request, _userPromptId, _options) {
+        yield { type: LlmEventType.TextDelta, text: 'test' };
+    }
+    async countTokens(_request) {
+        return { totalTokens: 100 };
+    }
+    mapToProviderConfig(_config) {
+        return {};
+    }
+}
+describe('ProviderFactory', () => {
+    let factory;
+    let registry;
+    beforeEach(() => {
+        registry = ProviderRegistry.getInstance();
+        registry.clear();
+        factory = new ProviderFactory(registry);
+    });
+    describe('constructor', () => {
+        it('should create factory with registry', () => {
+            expect(factory).toBeDefined();
+        });
+        it('should use singleton registry if not provided', () => {
+            const defaultFactory = new ProviderFactory();
+            expect(defaultFactory).toBeDefined();
+        });
+    });
+    describe('create()', () => {
+        it('should create adapter from registered factory', () => {
+            registry.register('gemini', (config) => new MockGeminiAdapter(config));
+            const adapter = factory.create('gemini', { apiKey: 'test-key' });
+            expect(adapter).toBeInstanceOf(MockGeminiAdapter);
+            expect(adapter.providerName).toBe('gemini');
+        });
+        it('should throw error for unregistered provider', () => {
+            expect(() => factory.create('nonexistent', { apiKey: 'test-key' })).toThrow('Provider "nonexistent" is not registered');
+        });
+        it('should normalize provider name case', () => {
+            registry.register('gemini', (config) => new MockGeminiAdapter(config));
+            const adapter = factory.create('GEMINI', { apiKey: 'test-key' });
+            expect(adapter).toBeInstanceOf(MockGeminiAdapter);
+        });
+        it('should pass config to adapter factory', () => {
+            const mockFactory = vi.fn((config) => new MockGeminiAdapter(config));
+            registry.register('gemini', mockFactory);
+            const config = { apiKey: 'my-api-key', baseUrl: 'https://custom.api' };
+            factory.create('gemini', config);
+            expect(mockFactory).toHaveBeenCalledWith(config);
+        });
+    });
+    describe('createWithValidation()', () => {
+        it('should create adapter without apiKey validation by default', () => {
+            registry.register('gemini', (config) => new MockGeminiAdapter(config));
+            // No apiKey required by default (supports OAuth/ADC)
+            const adapter = factory.createWithValidation('gemini', {});
+            expect(adapter).toBeInstanceOf(MockGeminiAdapter);
+        });
+        it('should create adapter with apiKey when provided', () => {
+            registry.register('gemini', (config) => new MockGeminiAdapter(config));
+            const adapter = factory.createWithValidation('gemini', {
+                apiKey: 'test-key',
+            });
+            expect(adapter).toBeInstanceOf(MockGeminiAdapter);
+        });
+        it('should throw error for missing apiKey when requireApiKey is true', () => {
+            registry.register('gemini', (config) => new MockGeminiAdapter(config));
+            expect(() => factory.createWithValidation('gemini', {}, { requireApiKey: true })).toThrow('apiKey is required in adapter configuration');
+        });
+        it('should throw PROVIDER_NOT_FOUND before checking apiKey (priority order)', () => {
+            // Unregistered provider with missing apiKey should throw PROVIDER_NOT_FOUND
+            try {
+                factory.createWithValidation('nonexistent', {}, { requireApiKey: true });
+                expect.fail('Should have thrown');
+            }
+            catch (error) {
+                expect(error.type).toBe(LlmErrorType.PROVIDER_NOT_FOUND);
+            }
+        });
+    });
+    describe('canCreate()', () => {
+        it('should return true for registered provider', () => {
+            registry.register('gemini', (config) => new MockGeminiAdapter(config));
+            expect(factory.canCreate('gemini')).toBe(true);
+        });
+        it('should return false for unregistered provider', () => {
+            expect(factory.canCreate('nonexistent')).toBe(false);
+        });
+        it('should normalize provider name case', () => {
+            registry.register('gemini', (config) => new MockGeminiAdapter(config));
+            expect(factory.canCreate('GEMINI')).toBe(true);
+            expect(factory.canCreate('Gemini')).toBe(true);
+        });
+    });
+    describe('getAvailableProviders()', () => {
+        it('should return empty array when no providers registered', () => {
+            expect(factory.getAvailableProviders()).toEqual([]);
+        });
+        it('should return list of registered providers', () => {
+            registry.register('gemini', (config) => new MockGeminiAdapter(config));
+            registry.register('claude', (config) => new MockGeminiAdapter(config));
+            const providers = factory.getAvailableProviders();
+            expect(providers).toContain('gemini');
+            expect(providers).toContain('claude');
+            expect(providers).toHaveLength(2);
+        });
+    });
+    describe('error handling', () => {
+        it('should throw PROVIDER_NOT_FOUND for unregistered provider', () => {
+            try {
+                factory.create('unknown', { apiKey: 'test' });
+                expect.fail('Should have thrown');
+            }
+            catch (error) {
+                expect(error.type).toBe(LlmErrorType.PROVIDER_NOT_FOUND);
+            }
+        });
+    });
+});
+//# sourceMappingURL=factory.test.js.map

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

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

package/dist/src/providers/gemini/adapter.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * GeminiAdapter — extends BaseAdapter to wrap Gemini SDK (@google/genai).
+ *
+ * Accepts provider-independent LlmGenerateRequest, converts to Gemini SDK
+ * format, and converts responses back to LlmGenerateResponse / LlmEventStream.
+ *
+ * @see docs/ai_adapter/03-technical-design.md §3.3.2
+ */
+import type { GenerateContentResponse } from '@google/genai';
+import { BaseAdapter } from '../baseAdapter.js';
+import type { LlmGenerateRequest, LlmGenerateResponse, LlmGenerateConfig, LlmProviderCapabilities, LlmTokenCount, AdapterConfig, GenerateOptions } from '../types.js';
+import { type LlmEventStream } from '../events.js';
+/**
+ * Interface for the Gemini SDK models object.
+ * This allows dependency injection for testing.
+ */
+export interface GeminiModelsApi {
+    generateContent(params: Record<string, unknown>): Promise<GenerateContentResponse>;
+    generateContentStream(params: Record<string, unknown>): Promise<AsyncGenerator<GenerateContentResponse>>;
+    countTokens(params: Record<string, unknown>): Promise<{
+        totalTokens?: number;
+    }>;
+    embedContent?(params: Record<string, unknown>): Promise<unknown>;
+}
+/**
+ * GeminiAdapter wraps the Gemini SDK behind the BaseAdapter interface.
+ */
+export declare class GeminiAdapter extends BaseAdapter {
+    readonly providerName = "gemini";
+    readonly capabilities: LlmProviderCapabilities;
+    private readonly models;
+    private readonly converter;
+    constructor(config: AdapterConfig, models: GeminiModelsApi);
+    /**
+     * Generate content (non-streaming).
+     */
+    generateContent(request: LlmGenerateRequest, _userPromptId: string, _options?: GenerateOptions): Promise<LlmGenerateResponse>;
+    /**
+     * Generate content as a stream of LlmEvents.
+     */
+    generateContentStream(request: LlmGenerateRequest, _userPromptId: string, _options?: GenerateOptions): LlmEventStream;
+    /**
+     * Count tokens in a request.
+     */
+    countTokens(request: LlmGenerateRequest): Promise<LlmTokenCount>;
+    /**
+     * Map common config to provider-specific config.
+     */
+    protected mapToProviderConfig(config: LlmGenerateConfig): Record<string, unknown>;
+    /**
+     * Convert a GenerateContentResponse chunk to LlmEvent[].
+     */
+    private convertChunkToEvents;
+}

package/dist/src/providers/gemini/adapter.js

@@ -0,0 +1,135 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseAdapter } from '../baseAdapter.js';
+import { LlmEventType, } from '../events.js';
+import { GeminiConverter } from './converter.js';
+/**
+ * GeminiAdapter wraps the Gemini SDK behind the BaseAdapter interface.
+ */
+export class GeminiAdapter extends BaseAdapter {
+    providerName = 'gemini';
+    capabilities = {
+        supportsStreaming: true,
+        supportsToolCalls: true,
+        supportsImageInput: true,
+        supportsImageGeneration: true,
+        supportsEmbedding: true,
+        supportsTokenCount: true,
+        supportsSystemMessage: true,
+        supportsThought: true,
+        maxContextLength: 1_000_000,
+        maxOutputTokens: 8_192,
+    };
+    models;
+    converter;
+    constructor(config, models) {
+        super(config);
+        this.models = models;
+        this.converter = new GeminiConverter();
+    }
+    /**
+     * Generate content (non-streaming).
+     */
+    async generateContent(request, _userPromptId, _options) {
+        this.validateRequest(request);
+        try {
+            const geminiParams = this.converter.toGeminiRequest(request);
+            const response = await this.models.generateContent(geminiParams);
+            return this.converter.fromGeminiResponse(response, request.model);
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    /**
+     * Generate content as a stream of LlmEvents.
+     */
+    generateContentStream(request, _userPromptId, _options) {
+        this.validateRequest(request);
+        const models = this.models;
+        const converter = this.converter;
+        const convertChunk = this.convertChunkToEvents.bind(this);
+        const handleErr = this.handleError.bind(this);
+        const geminiParams = converter.toGeminiRequest(request);
+        async function* streamGenerator() {
+            try {
+                const stream = await models.generateContentStream(geminiParams);
+                for await (const chunk of stream) {
+                    const events = convertChunk(chunk);
+                    for (const event of events) {
+                        yield event;
+                    }
+                }
+            }
+            catch (error) {
+                handleErr(error);
+            }
+        }
+        return streamGenerator();
+    }
+    /**
+     * Count tokens in a request.
+     */
+    async countTokens(request) {
+        const geminiParams = this.converter.toGeminiRequest(request);
+        const result = await this.models.countTokens(geminiParams);
+        return {
+            totalTokens: result.totalTokens ?? 0,
+        };
+    }
+    /**
+     * Map common config to provider-specific config.
+     */
+    mapToProviderConfig(config) {
+        return {
+            temperature: config.temperature,
+            maxOutputTokens: config.maxTokens,
+            topP: config.topP,
+            topK: config.topK,
+            stopSequences: config.stopSequences,
+        };
+    }
+    /**
+     * Convert a GenerateContentResponse chunk to LlmEvent[].
+     */
+    convertChunkToEvents(chunk) {
+        const events = [];
+        const candidate = chunk.candidates?.[0];
+        const parts = candidate?.content?.parts ?? [];
+        for (const part of parts) {
+            if ('text' in part && part.text !== undefined) {
+                events.push({
+                    type: LlmEventType.TextDelta,
+                    text: part.text,
+                });
+            }
+            else if ('functionCall' in part && part.functionCall) {
+                events.push({
+                    type: LlmEventType.ToolCallRequest,
+                    callId: crypto.randomUUID(),
+                    name: part.functionCall.name,
+                    args: part.functionCall.args ?? {},
+                });
+            }
+        }
+        // Check for finish reason
+        if (candidate?.finishReason) {
+            events.push({
+                type: LlmEventType.Finished,
+                finishReason: this.converter.mapStopReason(candidate.finishReason),
+                usage: chunk.usageMetadata
+                    ? {
+                        promptTokens: chunk.usageMetadata.promptTokenCount ?? 0,
+                        completionTokens: chunk.usageMetadata.candidatesTokenCount ?? 0,
+                        totalTokens: chunk.usageMetadata.totalTokenCount ?? 0,
+                    }
+                    : undefined,
+            });
+        }
+        return events;
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/src/providers/gemini/adapter.js.map

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

package/dist/src/providers/gemini/adapterBridge.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { LlmGenerateRequest, LlmGenerateResponse, LlmTokenCount, AdapterConfig, GenerateOptions } from '../types.js';
+import type { LlmEventStream } from '../events.js';
+/**
+ * Interface for generators that can be bridged with the multi-provider adapter.
+ * Compatible with both `googleGenAI.models` and `GeminiContentGenerator`.
+ */
+export interface BridgeableGenerator {
+    generateContent(...args: unknown[]): Promise<unknown>;
+    generateContentStream(...args: unknown[]): Promise<unknown>;
+    countTokens(...args: unknown[]): Promise<unknown>;
+    embedContent?(...args: unknown[]): Promise<unknown>;
+    userTier?: unknown;
+    userTierName?: string;
+    llmGenerateContent?(request: LlmGenerateRequest, userPromptId: string, options?: GenerateOptions): Promise<LlmGenerateResponse>;
+    llmGenerateContentStream?(request: LlmGenerateRequest, userPromptId: string, options?: GenerateOptions): LlmEventStream;
+    llmCountTokens?(request: LlmGenerateRequest): Promise<LlmTokenCount>;
+}
+/**
+ * Enhance a base generator with provider-independent llm* methods
+ * when the ENABLE_MULTI_PROVIDER flag is enabled.
+ *
+ * @param base - The base generator (e.g., `googleGenAI.models`)
+ * @param config - Adapter configuration (apiKey, etc.)
+ * @returns The original generator (flag OFF) or an enhanced generator (flag ON)
+ */
+export declare function createAdapterBridge(base: BridgeableGenerator, config: AdapterConfig): BridgeableGenerator;

package/dist/src/providers/gemini/adapterBridge.js

@@ -0,0 +1,40 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { isMultiProviderEnabled } from './featureFlag.js';
+import { GeminiAdapter } from './adapter.js';
+/**
+ * Enhance a base generator with provider-independent llm* methods
+ * when the ENABLE_MULTI_PROVIDER flag is enabled.
+ *
+ * @param base - The base generator (e.g., `googleGenAI.models`)
+ * @param config - Adapter configuration (apiKey, etc.)
+ * @returns The original generator (flag OFF) or an enhanced generator (flag ON)
+ */
+export function createAdapterBridge(base, config) {
+    if (!isMultiProviderEnabled()) {
+        return base;
+    }
+    // Create GeminiModelsApi wrapper that delegates to the base generator
+    const modelsApi = {
+        generateContent: (params) => base.generateContent(params),
+        generateContentStream: (params) => base.generateContentStream(params),
+        countTokens: (params) => base.countTokens(params),
+    };
+    const adapter = new GeminiAdapter(config, modelsApi);
+    // Return enhanced generator preserving legacy methods + adding llm* methods
+    return {
+        generateContent: (...args) => base.generateContent(...args),
+        generateContentStream: (...args) => base.generateContentStream(...args),
+        countTokens: (...args) => base.countTokens(...args),
+        embedContent: base.embedContent,
+        userTier: base.userTier,
+        userTierName: base.userTierName,
+        llmGenerateContent: (request, userPromptId, options) => adapter.generateContent(request, userPromptId, options),
+        llmGenerateContentStream: (request, userPromptId, options) => adapter.generateContentStream(request, userPromptId, options),
+        llmCountTokens: (request) => adapter.countTokens(request),
+    };
+}
+//# sourceMappingURL=adapterBridge.js.map