feat: Add Codex CLI provider with OAuth authentication (#1273)

Co-authored-by: Ralph Khreish <35776126+Crunchyman-ralph@users.noreply.github.com>

tests/unit/ai-providers/codex-cli.test.js

@@ -0,0 +1,92 @@
+import { jest } from '@jest/globals';
+
+// Mock the ai module
+jest.unstable_mockModule('ai', () => ({
+	generateObject: jest.fn(),
+	generateText: jest.fn(),
+	streamText: jest.fn()
+}));
+
+// Mock the codex-cli SDK module
+jest.unstable_mockModule('ai-sdk-provider-codex-cli', () => ({
+	createCodexCli: jest.fn((options) => {
+		const provider = (modelId, settings) => ({ id: modelId, settings });
+		provider.languageModel = jest.fn((id, settings) => ({ id, settings }));
+		provider.chat = provider.languageModel;
+		return provider;
+	})
+}));
+
+// Mock config getters
+jest.unstable_mockModule('../../../scripts/modules/config-manager.js', () => ({
+	getCodexCliSettingsForCommand: jest.fn(() => ({ allowNpx: true })),
+	// Provide commonly imported getters to satisfy other module imports if any
+	getDebugFlag: jest.fn(() => false),
+	getLogLevel: jest.fn(() => 'info')
+}));
+
+// Mock base provider
+jest.unstable_mockModule('../../../src/ai-providers/base-provider.js', () => ({
+	BaseAIProvider: class {
+		constructor() {
+			this.name = 'Base Provider';
+		}
+		handleError(_ctx, err) {
+			throw err;
+		}
+		validateParams(params) {
+			if (!params.modelId) throw new Error('Model ID is required');
+		}
+		validateMessages(msgs) {
+			if (!Array.isArray(msgs)) throw new Error('Invalid messages array');
+		}
+	}
+}));
+
+const { CodexCliProvider } = await import(
+	'../../../src/ai-providers/codex-cli.js'
+);
+const { createCodexCli } = await import('ai-sdk-provider-codex-cli');
+const { getCodexCliSettingsForCommand } = await import(
+	'../../../scripts/modules/config-manager.js'
+);
+
+describe('CodexCliProvider', () => {
+	let provider;
+
+	beforeEach(() => {
+		jest.clearAllMocks();
+		provider = new CodexCliProvider();
+	});
+
+	it('sets provider name and supported models', () => {
+		expect(provider.name).toBe('Codex CLI');
+		expect(provider.supportedModels).toEqual(['gpt-5', 'gpt-5-codex']);
+	});
+
+	it('does not require API key', () => {
+		expect(provider.isRequiredApiKey()).toBe(false);
+	});
+
+	it('creates client with merged default settings', async () => {
+		const client = await provider.getClient({ commandName: 'parse-prd' });
+		expect(client).toBeDefined();
+		expect(createCodexCli).toHaveBeenCalledWith({
+			defaultSettings: expect.objectContaining({ allowNpx: true })
+		});
+		expect(getCodexCliSettingsForCommand).toHaveBeenCalledWith('parse-prd');
+	});
+
+	it('injects OPENAI_API_KEY only when apiKey provided', async () => {
+		const client = await provider.getClient({
+			commandName: 'expand',
+			apiKey: 'sk-test'
+		});
+		const call = createCodexCli.mock.calls[0][0];
+		expect(call.defaultSettings.env.OPENAI_API_KEY).toBe('sk-test');
+		// Ensure env is not set when apiKey not provided
+		await provider.getClient({ commandName: 'expand' });
+		const second = createCodexCli.mock.calls[1][0];
+		expect(second.defaultSettings.env).toBeUndefined();
+	});
+});