v4.2.0 — CodexAdapter (OpenAI Codex CLI / chat / completion)

[Jovancoding]

v4.2.0 — CodexAdapter (OpenAI Codex CLI / chat / completion)

---

## What's new

### CodexAdapter — 14th adapter

Adds first-class support for OpenAI Codex and code-focused models in three execution modes:

| Mode | Description |
|---|---|
| `chat` | `/v1/chat/completions` — gpt-4o, o4-mini, any chat model |
| `completion` | `/v1/completions` — code-davinci-002 and legacy Codex models |
| `cli` | Wraps the [Codex CLI tool](https://github.com/openai/codex) via a user-supplied executor function |

**BYOC (bring your own client)** — pass any OpenAI SDK instance directly, or let the adapter use the built-in `fetch` path with your API key:

```typescript
import { CodexAdapter } from 'network-ai';

const adapter = new CodexAdapter();

// Chat mode — gpt-4o
adapter.registerCodexAgent('refactor', {
  mode: 'chat',
  model: 'gpt-4o',
  systemPrompt: 'You are a refactoring assistant.',
  apiKey: process.env.OPENAI_API_KEY,
});

// CLI mode — Codex CLI tool
adapter.registerCodexAgent('codex-cli', {
  mode: 'cli',
  executor: async (prompt) => myCodexCLIWrapper(prompt),
});

// BYOC — bring your own OpenAI SDK instance
adapter.registerCodexAgent('analyst', {
  mode: 'chat',
  model: 'o4-mini',
  client: openai.chat.completions,
});

Blackboard snapshots and handoff instructions are automatically included in the prompt. AbortController timeout (60s) guards all fetch-based calls.

Stats

• 14 adapters (was 13)
• 1,334 passing assertions across 16 test suites (51 new in test-codex.ts)

Full changelog

See CHANGELOG.md for the complete entry.

---

This discussion was created from the release v4.2.0 — CodexAdapter (OpenAI Codex CLI / chat / completion).