JD.SemanticKernel.Connectors.OpenAICodex 0.1.33

JD.SemanticKernel.Connectors.OpenAICodex

👁 NuGet
👁 CI

OpenAI Codex session connector for Semantic Kernel. Provides UseCodexChatCompletion() to wire local Codex CLI OAuth credentials (or an explicit API key) into any Semantic Kernel application without managing tokens manually.

Features

• Multi-source credential resolution — Options → OPENAI_API_KEY → CODEX_TOKEN → ~/.codex/auth.json → interactive device code login
• Token exchange — Automatically exchanges Codex OAuth tokens for OpenAI API keys via the standard token exchange endpoint
• Token refresh — Automatically refreshes expired tokens using stored refresh tokens
• Device code login — Full interactive codex login equivalent for .NET applications
• Semantic Kernel integration — One-call UseCodexChatCompletion() extension method
• DI support — AddCodexAuthentication() for dependency injection
• Model discovery — IModelDiscoveryProvider with known Codex models (o3, o4-mini, codex-mini, GPT-4.1, etc.)
• Multi-TFM — Targets netstandard2.0, net8.0, and net10.0

Installation

dotnet add package JD.SemanticKernel.Connectors.OpenAICodex

Quick Start

Minimal (auto-discovers credentials)

using JD.SemanticKernel.Connectors.OpenAICodex;
using Microsoft.SemanticKernel;

var kernel = Kernel.CreateBuilder()
 .UseCodexChatCompletion()
 .Build();

With explicit API key

var kernel = Kernel.CreateBuilder()
 .UseCodexChatCompletion(apiKey: "sk-your-openai-api-key")
 .Build();

With specific model

var kernel = Kernel.CreateBuilder()
 .UseCodexChatCompletion(CodexModels.O3)
 .Build();

Using Dependency Injection

services.AddCodexAuthentication(o => o.ApiKey = "sk-...");

// Or from configuration:
services.AddCodexAuthentication(configuration);
// Reads from "CodexSession" section in appsettings.json

Direct HttpClient usage

using var client = CodexHttpClientFactory.Create();
// Use with any OpenAI-compatible API

Credential Resolution Order

The provider checks these sources in order and uses the first valid credential found:

Configuration

appsettings.json

{
 "CodexSession": {
 "ApiKey": null,
 "Issuer": "https://auth.openai.com",
 "ApiBaseUrl": "https://api.openai.com/v1",
 "AutoRefreshTokens": true,
 "EnableInteractiveLogin": false
 }
}

Available Options

Available Models

Related Packages

• JD.SemanticKernel.Connectors.ClaudeCode — Claude Code connector
• JD.SemanticKernel.Connectors.GitHubCopilot — GitHub Copilot connector
• JD.SemanticKernel.Connectors.Abstractions — Shared abstractions

License