@vybestack/llxprt-code-core 0.1.18-nightly.250808.f9b79d74 → 0.1.18-nightly.250811.b0db22c6

package/dist/src/providers/openai/openai-oauth.spec.js

@@ -0,0 +1,544 @@
+/**
+ * Copyright 2025 Vybestack LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { OpenAIProvider } from './OpenAIProvider.js';
+import { NotYetImplemented } from '../../utils/errors.js';
+import { TEST_PROVIDER_CONFIG } from '../test-utils/providerTestConfig.js';
+// Mock OpenAI module
+vi.mock('openai', () => ({
+    default: vi.fn().mockImplementation(() => ({
+        chat: {
+            completions: {
+                create: vi.fn(),
+            },
+        },
+        models: {
+            list: vi.fn(),
+        },
+    })),
+}));
+describe('OpenAI Provider OAuth Integration', () => {
+    let mockOAuthManager;
+    let originalEnv;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        originalEnv = { ...process.env };
+        // Clear OPENAI_API_KEY for OAuth tests to work properly
+        delete process.env.OPENAI_API_KEY;
+        // Create a fresh mock OAuth manager for each test
+        mockOAuthManager = {
+            getToken: vi.fn(),
+            isAuthenticated: vi.fn(),
+            refreshToken: vi.fn(),
+        };
+    });
+    afterEach(() => {
+        // Restore original environment
+        process.env = originalEnv;
+    });
+    describe('Authentication Precedence', () => {
+        /**
+         * @requirement REQ-004.1
+         * @scenario Command line key takes precedence
+         * @given --key flag, env var, and OAuth all present
+         * @when isAuthenticated() called
+         * @then Uses command line key value
+         */
+        it('should use command line API key when all auth methods present', async () => {
+            // Given: All auth methods available
+            const cliApiKey = 'cli-key-123';
+            process.env.OPENAI_API_KEY = 'env-key-456';
+            vi.mocked(mockOAuthManager.getToken).mockResolvedValue('oauth-token-789');
+            // When: Creating provider with CLI key and OAuth manager
+            const provider = new OpenAIProvider(cliApiKey, undefined, TEST_PROVIDER_CONFIG, mockOAuthManager);
+            // Then: Should be authenticated (using CLI API key with highest precedence)
+            const isAuthenticated = await provider.isAuthenticated();
+            expect(isAuthenticated).toBe(true);
+            // Verify OAuth manager was not called since CLI key has precedence
+            expect(mockOAuthManager.getToken).not.toHaveBeenCalled();
+        });
+        /**
+         * @requirement REQ-004.1
+         * @scenario Environment variable second precedence
+         * @given No --key flag, but OPENAI_API_KEY set
+         * @when isAuthenticated() called
+         * @then Uses environment variable value
+         * @and Ignores OAuth token if present
+         */
+        it('should use environment variable when no CLI key provided', async () => {
+            // Given: Env var and OAuth available, no CLI key
+            process.env.OPENAI_API_KEY = 'env-key-456';
+            vi.mocked(mockOAuthManager.getToken).mockResolvedValue('oauth-token-789');
+            // When: Creating provider without CLI key
+            const provider = new OpenAIProvider('', // Empty CLI key
+            undefined, TEST_PROVIDER_CONFIG, mockOAuthManager);
+            // Then: Should be authenticated (using environment variable with second precedence)
+            const isAuthenticated = await provider.isAuthenticated();
+            expect(isAuthenticated).toBe(true);
+            // Verify OAuth manager was not called since env var has precedence
+            expect(mockOAuthManager.getToken).not.toHaveBeenCalled();
+        });
+        /**
+         * @requirement REQ-004.1
+         * @scenario OAuth token as fallback
+         * @given No --key flag, no env var
+         * @when isAuthenticated() called
+         * @then Uses OAuth token from manager
+         */
+        it('should use OAuth token when no other auth methods available', async () => {
+            // Given: Only OAuth available
+            delete process.env.OPENAI_API_KEY;
+            vi.mocked(mockOAuthManager.getToken).mockResolvedValue('oauth-token-789');
+            // When: Creating provider without CLI key or env var (defaults to standard OpenAI endpoint)
+            const provider = new OpenAIProvider('', // Empty CLI key
+            undefined, // Will default to standard OpenAI endpoint - does not support OAuth
+            TEST_PROVIDER_CONFIG, mockOAuthManager);
+            // Then: Should not be authenticated (OAuth not supported for standard OpenAI endpoints)
+            const isAuthenticated = await provider.isAuthenticated();
+            expect(isAuthenticated).toBe(false);
+            // OAuth manager should not be called since provider doesn't support OAuth for this endpoint
+            expect(mockOAuthManager.getToken).not.toHaveBeenCalled();
+        });
+        /**
+         * @requirement REQ-004.1
+         * @scenario No authentication available
+         * @given No --key, no env var, no OAuth
+         * @when isAuthenticated() called
+         * @then Returns null, provider unavailable
+         */
+        it('should return null when no authentication available', async () => {
+            // Given: No auth methods available
+            delete process.env.OPENAI_API_KEY;
+            vi.mocked(mockOAuthManager.getToken).mockResolvedValue(null);
+            // When: Creating provider without any auth (defaults to standard OpenAI endpoint)
+            const provider = new OpenAIProvider('', // Empty CLI key
+            undefined, // Will default to standard OpenAI endpoint
+            TEST_PROVIDER_CONFIG, mockOAuthManager);
+            // Then: Should not be authenticated (no auth available, and OAuth not supported for standard OpenAI)
+            const isAuthenticated = await provider.isAuthenticated();
+            expect(isAuthenticated).toBe(false);
+            // OAuth manager should not be called since provider doesn't support OAuth for standard OpenAI
+            expect(mockOAuthManager.getToken).not.toHaveBeenCalled();
+        });
+    });
+    describe('OAuth Token Usage and Lazy Triggering', () => {
+        /**
+         * @requirement REQ-004.3
+         * @scenario Lazy OAuth triggering during API call
+         * @given OAuth enabled but not yet authenticated
+         * @when Making API request that requires authentication
+         * @then OAuth flow triggered lazily before API call
+         * @and Token retrieved for use as API key
+         */
+        it('should trigger OAuth flow lazily when API call requires authentication', async () => {
+            // Given: OAuth enabled but not yet authenticated
+            const qwenBaseUrl = 'https://dashscope.aliyuncs.com/compatible-mode/v1';
+            const oauthToken = 'lazy-oauth-token-123';
+            // Mock OAuth manager to indicate OAuth is enabled
+            vi.mocked(mockOAuthManager.getToken).mockResolvedValue(oauthToken);
+            const mockIsOAuthEnabled = vi.fn().mockResolvedValue(true);
+            mockOAuthManager.isOAuthEnabled = mockIsOAuthEnabled;
+            // When: Creating provider and checking authentication (simulating API call prep)
+            const provider = new OpenAIProvider('', // Empty CLI key
+            qwenBaseUrl, // Qwen endpoint allows OAuth
+            TEST_PROVIDER_CONFIG, mockOAuthManager);
+            // Then: Should be authenticated through lazy OAuth triggering
+            const isAuthenticated = await provider.isAuthenticated();
+            expect(isAuthenticated).toBe(true);
+            // OAuth manager should have been called to get token
+            expect(mockOAuthManager.getToken).toHaveBeenCalledWith('qwen');
+        });
+        /**
+         * @requirement REQ-004.3
+         * @scenario OAuth skipped when higher priority auth available
+         * @given API key and OAuth both available
+         * @when Making API request
+         * @then Uses API key without triggering OAuth
+         */
+        it('should skip OAuth when API key has higher precedence', async () => {
+            // Given: API key has higher precedence than OAuth
+            const apiKey = 'api-key-with-precedence';
+            const oauthToken = 'unused-oauth-token';
+            vi.mocked(mockOAuthManager.getToken).mockResolvedValue(oauthToken);
+            // When: Creating provider with both API key and OAuth available
+            const provider = new OpenAIProvider(apiKey, 'https://dashscope.aliyuncs.com/compatible-mode/v1', TEST_PROVIDER_CONFIG, mockOAuthManager);
+            // Then: Should use API key without calling OAuth manager
+            const isAuthenticated = await provider.isAuthenticated();
+            expect(isAuthenticated).toBe(true);
+            // OAuth manager should not be called due to precedence
+            expect(mockOAuthManager.getToken).not.toHaveBeenCalled();
+        });
+        /**
+         * @requirement REQ-004.3
+         * @scenario OAuth token used as API key in SDK
+         * @given Valid OAuth token from lazy triggering
+         * @when Token passed to OpenAI SDK
+         * @then SDK receives OAuth token as apiKey parameter
+         */
+        it('should pass lazily-obtained OAuth token as API key to OpenAI SDK', async () => {
+            // Given: Valid OAuth token obtained through lazy triggering
+            const oauthToken = 'lazy-oauth-token-456';
+            vi.mocked(mockOAuthManager.getToken).mockResolvedValue(oauthToken);
+            // When: Using OAuth token for Qwen endpoint
+            const provider = new OpenAIProvider('', 'https://dashscope.aliyuncs.com/compatible-mode/v1', TEST_PROVIDER_CONFIG, mockOAuthManager);
+            // Then: Should be authenticated with OAuth token available for SDK usage
+            const isAuthenticated = await provider.isAuthenticated();
+            expect(isAuthenticated).toBe(true);
+            // This token would be passed to OpenAI SDK constructor as apiKey
+            expect(mockOAuthManager.getToken).toHaveBeenCalledWith('qwen');
+        });
+        /**
+         * @requirement REQ-004.3
+         * @scenario OAuth disabled prevents lazy triggering
+         * @given OAuth disabled for provider
+         * @when API call attempted without other auth methods
+         * @then No OAuth flow triggered and authentication fails
+         */
+        it('should not trigger OAuth when OAuth is disabled', async () => {
+            // Given: OAuth disabled, no other auth methods
+            vi.mocked(mockOAuthManager.getToken).mockResolvedValue(null);
+            const mockIsOAuthEnabled = vi.fn().mockResolvedValue(false);
+            mockOAuthManager.isOAuthEnabled = mockIsOAuthEnabled;
+            // When: Creating provider with OAuth disabled
+            const provider = new OpenAIProvider('', 'https://dashscope.aliyuncs.com/compatible-mode/v1', TEST_PROVIDER_CONFIG, mockOAuthManager);
+            // Then: Should not authenticate without enabled OAuth
+            const isAuthenticated = await provider.isAuthenticated();
+            expect(isAuthenticated).toBe(false);
+        });
+    });
+    describe('Token Refresh', () => {
+        /**
+         * @requirement REQ-004.4
+         * @scenario Automatic token refresh
+         * @given OAuth token expires soon
+         * @when API call initiated
+         * @then Refreshes token before use
+         * @and Uses new token for request
+         */
+        it('should automatically refresh expired OAuth token', async () => {
+            // Given: Token that will expire soon
+            const expiredToken = 'expired-token-123';
+            const newToken = 'refreshed-token-456';
+            vi.mocked(mockOAuthManager.getToken)
+                .mockResolvedValueOnce(expiredToken)
+                .mockResolvedValueOnce(newToken);
+            vi.mocked(mockOAuthManager.refreshToken).mockResolvedValue(newToken);
+            // When: Making API call with expired token
+            const _provider = new OpenAIProvider('', undefined, TEST_PROVIDER_CONFIG, mockOAuthManager);
+            // Then: Should fail with NotYetImplemented
+            expect(() => {
+                throw new NotYetImplemented('handleTokenRefresh not yet implemented');
+            }).toThrow(NotYetImplemented);
+        });
+        /**
+         * @requirement REQ-004.4
+         * @scenario Handle refresh failure
+         * @given Expired token, refresh fails
+         * @when API call attempted
+         * @then Provider becomes unavailable
+         * @and Returns appropriate error
+         */
+        it('should handle token refresh failure gracefully', async () => {
+            // Given: Expired token that cannot be refreshed
+            vi.mocked(mockOAuthManager.getToken).mockResolvedValue('expired-token');
+            vi.mocked(mockOAuthManager.refreshToken).mockRejectedValue(new Error('Refresh failed'));
+            // When: Attempting API call with failed refresh
+            const _provider = new OpenAIProvider('', undefined, TEST_PROVIDER_CONFIG, mockOAuthManager);
+            // Then: Should fail with NotYetImplemented
+            expect(() => {
+                throw new NotYetImplemented('handleRefreshFailure not yet implemented');
+            }).toThrow(NotYetImplemented);
+        });
+    });
+    describe('Provider Compatibility and BaseURL Validation', () => {
+        /**
+         * @requirement REQ-004.1
+         * @scenario Qwen endpoint detection and validation
+         * @given OPENAI_BASE_URL set to Qwen endpoint
+         * @when Provider validates OAuth compatibility
+         * @then Detects Qwen endpoint and allows OAuth usage
+         */
+        it('should detect Qwen endpoints and validate OAuth usage', async () => {
+            // Given: Qwen base URL and OAuth token
+            const qwenBaseUrl = 'https://dashscope.aliyuncs.com/compatible-mode/v1';
+            const oauthToken = 'qwen-oauth-token-123';
+            vi.mocked(mockOAuthManager.getToken).mockResolvedValue(oauthToken);
+            // When: Creating provider with Qwen URL and OAuth
+            const provider = new OpenAIProvider('', qwenBaseUrl, TEST_PROVIDER_CONFIG, mockOAuthManager);
+            // Then: Should validate as Qwen-compatible endpoint and be authenticated via OAuth
+            const isAuthenticated = await provider.isAuthenticated();
+            expect(isAuthenticated).toBe(true);
+            expect(mockOAuthManager.getToken).toHaveBeenCalledWith('qwen');
+        });
+        /**
+         * @requirement REQ-004.1
+         * @scenario Default OpenAI endpoint with OAuth
+         * @given Standard OpenAI base URL
+         * @when Using OAuth authentication
+         * @then Should prevent OAuth usage and show appropriate error
+         */
+        it('should prevent OAuth usage with standard OpenAI endpoints', async () => {
+            // Given: Standard OpenAI URL and OAuth token
+            const standardOpenAIUrl = 'https://api.openai.com/v1';
+            const oauthToken = 'oauth-token-123';
+            vi.mocked(mockOAuthManager.getToken).mockResolvedValue(oauthToken);
+            // When: Creating provider with standard OpenAI URL and OAuth
+            const provider = new OpenAIProvider('', standardOpenAIUrl, TEST_PROVIDER_CONFIG, mockOAuthManager);
+            // Then: Should not be authenticated without API key (OAuth not used for standard OpenAI)
+            const isAuthenticated = await provider.isAuthenticated();
+            expect(isAuthenticated).toBe(false);
+            // OAuth manager should not be called for standard OpenAI
+            expect(mockOAuthManager.getToken).not.toHaveBeenCalled();
+        });
+        /**
+         * @requirement REQ-004.1
+         * @scenario Custom endpoint detection
+         * @given Custom base URL that's not Qwen
+         * @when Using OAuth authentication
+         * @then Should prevent OAuth usage for unknown custom endpoints
+         */
+        it('should prevent OAuth usage for unrecognized custom endpoints', async () => {
+            // Given: Custom URL that's not Qwen
+            const customUrl = 'https://my-custom-ai.com/v1';
+            const oauthToken = 'oauth-token-123';
+            vi.mocked(mockOAuthManager.getToken).mockResolvedValue(oauthToken);
+            // When: Creating provider with custom URL and OAuth
+            const provider = new OpenAIProvider('', customUrl, TEST_PROVIDER_CONFIG, mockOAuthManager);
+            // Then: Should not be authenticated (OAuth not used for unrecognized endpoints)
+            const isAuthenticated = await provider.isAuthenticated();
+            expect(isAuthenticated).toBe(false);
+        });
+        /**
+         * @requirement REQ-004.1
+         * @scenario Qwen endpoint variants
+         * @given Different Qwen endpoint formats
+         * @when Validating OAuth compatibility
+         * @then Recognizes all valid Qwen endpoint patterns
+         */
+        it('should recognize various Qwen endpoint formats', async () => {
+            const qwenEndpoints = [
+                'https://dashscope.aliyuncs.com/compatible-mode/v1',
+                'https://dashscope.aliyuncs.com/api/v1',
+                'https://api.qwen.com/v1',
+            ];
+            const oauthToken = 'qwen-oauth-token-123';
+            vi.mocked(mockOAuthManager.getToken).mockResolvedValue(oauthToken);
+            for (const endpoint of qwenEndpoints) {
+                // When: Creating provider with each Qwen endpoint variant
+                const provider = new OpenAIProvider('', endpoint, TEST_PROVIDER_CONFIG, mockOAuthManager);
+                // Then: Should allow OAuth for all Qwen variants
+                const isAuthenticated = await provider.isAuthenticated();
+                expect(isAuthenticated).toBe(true);
+            }
+        });
+        /**
+         * @requirement REQ-006.1
+         * @scenario Backward compatibility with API keys
+         * @given Existing API key setup
+         * @when No OAuth manager provided
+         * @then Works exactly as before
+         */
+        it('should maintain backward compatibility without OAuth manager', async () => {
+            // Given: Traditional API key setup, no OAuth manager
+            const apiKey = 'traditional-api-key-123';
+            // When: Creating provider without OAuth manager
+            const provider = new OpenAIProvider(apiKey, undefined, TEST_PROVIDER_CONFIG, undefined);
+            // Then: Should work exactly as before - provider should be authenticated with API key
+            const isAuthenticated = await provider.isAuthenticated();
+            expect(isAuthenticated).toBe(true);
+        });
+    });
+    describe('Authentication Status', () => {
+        /**
+         * @requirement REQ-004.1
+         * @scenario Check authentication status
+         * @given OAuth token present
+         * @when isAuthenticated() called
+         * @then Returns true
+         */
+        it('should return true when OAuth token is available', async () => {
+            // Given: Valid OAuth token, no other auth
+            delete process.env.OPENAI_API_KEY;
+            vi.mocked(mockOAuthManager.getToken).mockResolvedValue('valid-token');
+            // When: Checking authentication status with Qwen endpoint
+            const provider = new OpenAIProvider('', // Empty CLI key
+            'https://dashscope.aliyuncs.com/compatible-mode/v1', // Qwen endpoint that supports OAuth
+            TEST_PROVIDER_CONFIG, mockOAuthManager);
+            // Then: Should return true (OAuth token available)
+            const isAuthenticated = await provider.isAuthenticated();
+            expect(isAuthenticated).toBe(true);
+            // Verify OAuth manager was called
+            expect(mockOAuthManager.getToken).toHaveBeenCalledWith('qwen');
+        });
+        /**
+         * @requirement REQ-004.1
+         * @scenario Multiple auth sources status
+         * @given API key and OAuth both present
+         * @when isAuthenticated() called
+         * @then Returns true (uses precedence)
+         */
+        it('should return true when multiple auth sources present', async () => {
+            // Given: Both API key and OAuth available
+            const apiKey = 'api-key-123';
+            vi.mocked(mockOAuthManager.getToken).mockResolvedValue('oauth-token');
+            // When: Checking status with multiple auth sources
+            const provider = new OpenAIProvider(apiKey, undefined, TEST_PROVIDER_CONFIG, mockOAuthManager);
+            // Then: Should return true (uses precedence - API key first)
+            const isAuthenticated = await provider.isAuthenticated();
+            expect(isAuthenticated).toBe(true);
+            // Verify OAuth manager was NOT called since API key has precedence
+            expect(mockOAuthManager.getToken).not.toHaveBeenCalled();
+        });
+        /**
+         * @requirement REQ-004.1
+         * @scenario No authentication status
+         * @given No auth methods available
+         * @when isAuthenticated() called
+         * @then Returns false
+         */
+        it('should return false when no authentication available', async () => {
+            // Given: No authentication methods
+            delete process.env.OPENAI_API_KEY;
+            vi.mocked(mockOAuthManager.getToken).mockResolvedValue(null);
+            // When: Checking auth status with no auth but using Qwen endpoint
+            const provider = new OpenAIProvider('', // Empty CLI key
+            'https://dashscope.aliyuncs.com/compatible-mode/v1', // Qwen endpoint
+            TEST_PROVIDER_CONFIG, mockOAuthManager);
+            // Then: Should return false (no auth available, OAuth manager returned null)
+            const isAuthenticated = await provider.isAuthenticated();
+            expect(isAuthenticated).toBe(false);
+            // Verify OAuth manager was called but returned null
+            expect(mockOAuthManager.getToken).toHaveBeenCalledWith('qwen');
+        });
+    });
+    describe('Error Handling', () => {
+        /**
+         * @requirement REQ-004.4
+         * @scenario Handle missing OAuth manager
+         * @given No OAuth manager provided
+         * @when Checking for OAuth token
+         * @then Falls back to other auth methods
+         * @and No errors thrown
+         */
+        it('should gracefully handle missing OAuth manager', async () => {
+            // Given: No OAuth manager provided
+            process.env.OPENAI_API_KEY = 'fallback-env-key';
+            // When: Creating provider without OAuth manager
+            const provider = new OpenAIProvider('', // Empty CLI key
+            undefined, TEST_PROVIDER_CONFIG, undefined);
+            // Then: Should fall back to environment variable and be authenticated
+            const isAuthenticated = await provider.isAuthenticated();
+            expect(isAuthenticated).toBe(true);
+        });
+        /**
+         * @requirement REQ-004.3
+         * @scenario Invalid token format
+         * @given Malformed OAuth token
+         * @when Used for API request
+         * @then Request fails with auth error
+         */
+        it('should handle malformed OAuth token gracefully', async () => {
+            // Given: Malformed OAuth token
+            const malformedToken = 'invalid-token-format-!@#$%';
+            vi.mocked(mockOAuthManager.getToken).mockResolvedValue(malformedToken);
+            // When: Using malformed token for API request
+            const _provider = new OpenAIProvider('', undefined, TEST_PROVIDER_CONFIG, mockOAuthManager);
+            // Then: Should fail with NotYetImplemented
+            expect(() => {
+                throw new NotYetImplemented('handleInvalidTokenFormat not yet implemented');
+            }).toThrow(NotYetImplemented);
+        });
+        /**
+         * @requirement REQ-004.4
+         * @scenario OAuth manager throws error
+         * @given OAuth manager throws unexpected error
+         * @when Attempting to get token
+         * @then Falls back to other auth methods
+         * @and Logs error appropriately
+         */
+        it('should handle OAuth manager errors gracefully', async () => {
+            // Given: OAuth manager that throws errors
+            vi.mocked(mockOAuthManager.getToken).mockRejectedValue(new Error('OAuth service unavailable'));
+            process.env.OPENAI_API_KEY = 'fallback-key';
+            // When: OAuth manager fails
+            const provider = new OpenAIProvider('', // Empty CLI key
+            undefined, TEST_PROVIDER_CONFIG, mockOAuthManager);
+            // Then: Should fall back to environment variable (OAuth errors are caught) and be authenticated
+            const isAuthenticated = await provider.isAuthenticated();
+            expect(isAuthenticated).toBe(true);
+        });
+        /**
+         * @requirement REQ-004.3
+         * @scenario Network error during token refresh
+         * @given Network connectivity issues
+         * @when Token refresh attempted
+         * @then Provider handles error appropriately
+         * @and Provides meaningful error message
+         */
+        it('should handle network errors during token refresh', async () => {
+            // Given: Network error during refresh
+            vi.mocked(mockOAuthManager.getToken).mockResolvedValue('expired-token');
+            vi.mocked(mockOAuthManager.refreshToken).mockRejectedValue(new Error('Network error: ECONNREFUSED'));
+            // When: Network fails during refresh
+            const _provider = new OpenAIProvider('', undefined, TEST_PROVIDER_CONFIG, mockOAuthManager);
+            // Then: Should fail with NotYetImplemented
+            expect(() => {
+                throw new NotYetImplemented('handleNetworkError not yet implemented');
+            }).toThrow(NotYetImplemented);
+        });
+    });
+    describe('Integration Scenarios', () => {
+        /**
+         * @requirement REQ-004.1
+         * @scenario Complete OAuth flow integration
+         * @given OAuth manager with full capabilities
+         * @when Provider is used for API calls
+         * @then All OAuth functionality works seamlessly
+         */
+        it('should integrate OAuth functionality end-to-end', async () => {
+            // Given: Full OAuth setup
+            const validToken = 'valid-oauth-token-123';
+            vi.mocked(mockOAuthManager.getToken).mockResolvedValue(validToken);
+            vi.mocked(mockOAuthManager.isAuthenticated).mockResolvedValue(true);
+            // When: Using provider with complete OAuth integration
+            const _provider = new OpenAIProvider('', undefined, TEST_PROVIDER_CONFIG, mockOAuthManager);
+            // Then: Should fail with NotYetImplemented
+            expect(() => {
+                throw new NotYetImplemented('performEndToEndOAuthTest not yet implemented');
+            }).toThrow(NotYetImplemented);
+        });
+        /**
+         * @requirement REQ-006.1
+         * @scenario Migration from API key to OAuth
+         * @given Provider initially using API key
+         * @when OAuth manager is added later
+         * @then Seamlessly switches to OAuth precedence
+         */
+        it('should handle migration from API key to OAuth', async () => {
+            // Given: Initial API key setup
+            const apiKey = 'existing-api-key';
+            // When: OAuth manager is added
+            const oauthToken = 'new-oauth-token';
+            vi.mocked(mockOAuthManager.getToken).mockResolvedValue(oauthToken);
+            const _provider = new OpenAIProvider(apiKey, undefined, TEST_PROVIDER_CONFIG, mockOAuthManager);
+            // Then: Should fail with NotYetImplemented
+            expect(() => {
+                throw new NotYetImplemented('testMigrationScenario not yet implemented');
+            }).toThrow(NotYetImplemented);
+        });
+    });
+});
+//# sourceMappingURL=openai-oauth.spec.js.map

package/dist/src/providers/openai/openai-oauth.spec.js.map

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

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

@@ -15,3 +15,50 @@ export interface ProviderToolCall {
         arguments: string;
     };
 }
+export interface ProviderCapabilities {
+    supportsStreaming: boolean;
+    supportsTools: boolean;
+    supportsVision: boolean;
+    maxTokens: number;
+    supportedFormats: string[];
+    hasModelSelection?: boolean;
+    hasApiKeyConfig?: boolean;
+    hasBaseUrlConfig?: boolean;
+    supportsPaidMode?: boolean;
+}
+export interface ProviderContext {
+    providerName: string;
+    currentModel: string;
+    toolFormat: string;
+    isPaidMode: boolean;
+    capabilities: ProviderCapabilities;
+    sessionStartTime: number;
+}
+export interface ToolCall {
+    provider: string;
+    name: string;
+    arguments: unknown;
+    id: string;
+}
+export interface ProviderPerformanceMetrics {
+    providerName: string;
+    totalRequests: number;
+    totalTokens: number;
+    averageLatency: number;
+    timeToFirstToken: number | null;
+    tokensPerSecond: number;
+    chunksReceived: number;
+    errorRate: number;
+    errors: Array<{
+        timestamp: number;
+        duration: number;
+        error: string;
+    }>;
+}
+export interface ProviderComparison {
+    provider1: string;
+    provider2: string;
+    capabilities: Record<string, ProviderCapabilities>;
+    compatibility: number;
+    recommendation: string;
+}

package/dist/src/services/git-stats-service.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export interface GitStats {
+    linesAdded: number;
+    linesRemoved: number;
+    filesChanged: number;
+}
+/**
+ * Service for tracking git statistics during file operations.
+ * This service is optional and can be set by the CLI package when logging is enabled.
+ */
+export interface IGitStatsService {
+    /**
+     * Track file edit statistics
+     * @param filePath Path to the file being edited
+     * @param oldContent Original file content
+     * @param newContent New file content after edit
+     * @returns Git statistics or null if tracking is disabled
+     */
+    trackFileEdit(filePath: string, oldContent: string, newContent: string): Promise<GitStats | null>;
+}
+/**
+ * Set the git stats service implementation
+ */
+export declare function setGitStatsService(service: IGitStatsService | null): void;
+/**
+ * Get the current git stats service
+ */
+export declare function getGitStatsService(): IGitStatsService | null;