0.0.202

Highlights

This release advances handwritten app-server parity from Codex 0.131 → 0.139, pulling in every stable RPC, notification, and config change across the rust-v0.133 … rust-v0.139 window.

Codex 0.139 parity

• Added stable account/usage/read (ReadAccountTokenUsageAsync) with typed token-usage summary and daily buckets on direct and resilient clients.
• Added experimental remoteControl/pairing/status (ReadRemoteControlPairingStatusAsync) with client-side one-of validation.
• Added turn/moderationMetadata notification and an optional threadId on mcpServer/startupStatus/updated.
• Switched config requirements to allowedPermissionProfiles + defaultPermissions (legacy allowedPermissions fallback preserved).
• Parsed PluginDetail.appTemplates with typed app-template descriptors.
• Enforced absolute-path runtimeWorkspaceRoots on thread start/resume/fork and turn start.
• Added CodexAuthMode.PersonalAccessToken.

Codex 0.137 parity

• Removed deprecated persistExtendedHistory / persistFullHistory wire fields (public compatibility switches kept as no-ops).
• Added thread/resume initialTurnsPage options + CodexTurnsPage parsing.
• Added clientUserMessageId, additionalContext, and responsesapiClientMetadata to turn/start and turn/steer; parsed user-message clientId.
• Exposed Thread.parentThreadId, mcpServerStatus/list.threadId, and MCP serverInfo.
• Added stable skills/extraRoots/set (SetSkillsExtraRootsAsync).
• Added remote-control management RPCs (pairing/start, client/list, client/revoke).
• Surfaced environmentId on approval requests, Windows sandbox allow-lists, enterprise-managed layer id/name, and NetworkUnixSocketPermission.Deny.
• Hardened Windows verbatim-path matching (\\?\C:\repo ↔ C:\repo) for running-thread resume.

Codex 0.134 parity

• Added thread/search (SearchThreadsAsync) with paged content results and snippets.
• Added permissionProfile/list (ListPermissionProfilesAsync).
• Added thread goal set/get/clear APIs plus thread/goal/updated / cleared notifications, including usageLimited / budgetLimited statuses.
• Added experimental thread/settings/update (UpdateThreadSettingsAsync) with sandbox-policy vs permission-profile conflict validation.
• Extended configRequirements/read with approval reviewers, allowed permissions, allowAppshots, computerUse, and managed hooks.

Upstream tracking

• @openai/codex bumped 0.133.0 → 0.139.0; external/codex and UPSTREAM_CODEX_VERSION.txt pinned to rust-v0.139.0.
• Added interop research docs: codex-0.131-to-0.134, codex-0.134-to-0.137, and codex-0.137-to-0.139.

Validation

• CI run #202 on master (commit 2bcdd8a): generated-DTO drift check, Release build, test, NuGet pack, and artifact upload all passed; packages published to NuGet.org.
• Generator drift check (UpstreamGen -- check): generated output up to date.
• Full Release suite: 784 passed, 0 warnings.

Full commit log: 0.0.182...0.0.202

0.0.182

Highlights

• Upgraded handwritten app-server parity for Codex 0.131 runtime workspace roots, execution environments, permission profiles, and request attestation.
• Added remote plugin catalog metadata plus plugin share save/list/update/checkout/delete SDK APIs and parsing.
• Added remote-control status APIs, environment registration wrappers, and config/profile parsing for 0.131 fields.
• Documented the 0.130 to 0.131 interop findings.

Validation

• GitHub CI run 182 on master: generated DTO check, build, test, pack, and artifact upload passed.
• Local validation: generator drift check, focused parity tests, and full Release suite passed.

0.0.166

Highlights

• Added JKToolKit.CodexSDK.AgentFramework, a new adapter package for Microsoft Agent Framework function tools.
• Exposes Microsoft.Extensions.AI.AIFunction tools as Codex app-server dynamic tools.
• Added an end-to-end Agent Framework pizza function-calling demo command: agent-framework-function-calling.
• Added docs, install instructions, NuGet badges, and CI packaging/publishing for the new adapter.

NuGet

Published with the same CI version as the other packages:

• JKToolKit.CodexSDK 0.0.166
• JKToolKit.CodexSDK.SemanticKernel 0.0.166
• JKToolKit.CodexSDK.AgentFramework 0.0.166

0.0.164

Highlights

• Updated compatibility for upstream Codex CLI 0.128.0.
• Added the new optional Semantic Kernel adapter package: JKToolKit.CodexSDK.SemanticKernel.
• Published both NuGet packages with the same version: 0.0.164.

Semantic Kernel adapter

The new adapter lets existing Semantic Kernel [KernelFunction] plugins be exposed to Codex app-server as dynamic tools through the item/tool/call flow. This keeps the core SDK free of a Semantic Kernel dependency while giving SK users a first-class integration package.

Install it with:

dotnet add package JKToolKit.CodexSDK.SemanticKernel

See the guide: Semantic Kernel Adapter

Packages

• JKToolKit.CodexSDK 0.0.164
• JKToolKit.CodexSDK.SemanticKernel 0.0.164

0.0.110

What's Changed

• Automation/upstream codex 0.106.0 by @JKamsker in #15
• chore(upstream): bump @openai/codex to 0.107.0 by @github-actions[bot] in #16
• chore(upstream): bump @openai/codex to 0.110.0 by @github-actions[bot] in #18
• chore(upstream): bump @openai/codex to 0.111.0 by @github-actions[bot] in #19
• chore(upstream): bump @openai/codex to 0.112.0 by @github-actions[bot] in #20
• chore(upstream): bump @openai/codex to 0.113.0 by @github-actions[bot] in #21
• chore(upstream): bump @openai/codex to 0.114.0 by @github-actions[bot] in #22
• chore(upstream): bump @openai/codex to 0.115.0 by @github-actions[bot] in #23
• chore(upstream): bump @openai/codex to 0.116.0 by @github-actions[bot] in #24
• chore(upstream): bump @openai/codex to 0.117.0 by @github-actions[bot] in #25
• fix: codex-cli 0.118.0 parity pass by @JKamsker in #27

New Contributors

• @github-actions[bot] made their first contribution in #16

Full Changelog: 0.0.109...0.0.110

0.0.109

bump @openai/codex to 0.106.0

What's Changed

• Chore/upstream sync 20260225 by @JKamsker in #13
• chore(upstream): bump @openai/codex to 0.106.0 by @JKamsker in #14

Full Changelog: 0.0.101...0.0.109

0.0.101

Compatibility with Codex v0.105.0

What's Changed

• Feat/dto refactor by @JKamsker in #10
• Fix portability and reliability findings by @JKamsker in #11
• Upstream sync to Codex v0.105.0 by @JKamsker in #12

Full Changelog: 0.0.70...0.0.101

0.0.70

What's Changed

• Add resilient app-server client with auto-restart and retry policies by @JKamsker in #3
• Feat/compatibility by @JKamsker in #4
• Feat/output schema by @JKamsker in #5
• Make uncorrelated session log discovery optional by @JKamsker in #6
• Feat/cleanup by @JKamsker in #7
• Feat/appserver mcp management by @JKamsker in #8

Full Changelog: 0.0.29...0.0.70

0.0.29

What’s new in 0.0.29

0.0.29 is a usability-focused release: it tightens up event parsing and introduces a cleaner, more “one-stop” SDK surface while simplifying demos and namespaces.

New CodexSdk facade (new architecture)

You can now use a single entry point that groups the three ways of interacting with Codex:

• sdk.Exec – Exec mode (built on the existing CodexClient)
• sdk.AppServer – App-server mode (starts/controls CodexAppServerClient instances via a factory)
• sdk.McpServer – MCP server mode (starts/controls CodexMcpServerClient instances via a factory)

The key architectural change is that CodexSdk is a thin composition layer: it doesn’t replace the underlying clients, it just makes the “happy path” easier to discover and wire up.

DI + non-DI support

• DI: services.AddCodexSdk(...) registers the underlying components and exposes a single CodexSdk to consume.
• Non-DI: CodexSdk.Create(builder => ...) uses CodexSdkBuilder to configure options and construct the composed SDK directly.

Configuration precedence

CodexSdkBuilder supports global defaults like CodexExecutablePath, but mode-specific configuration wins (global path only applies when the mode-specific path is unset). This makes it easy to share defaults while still overriding per mode when needed.

Event pipeline improvements

• Adds event_msg unwrapping, so consumers see a cleaner, more consistent event shape without having to manually peel nested payloads.
• Adds a review output model, making codex review results easier to handle as structured data.

Namespace and demo cleanup

• Exec-facing types move from JKToolKit.CodexSDK.Public to JKToolKit.CodexSDK.Exec.
• Models consolidate under JKToolKit.CodexSDK.Models (replacing *.Public.Models usage in docs/samples).
• Multiple demo projects are consolidated into a single JKToolKit.CodexSDK.Demo with subcommands (review/appserver/mcpserver flows).

Included PRs

• Add event_msg unwrapping and review output model (#1)
• Add CodexSdk facade + consolidate demos + namespace cleanup (#2)

Full changelog: https://github.com/JKamsker/JKToolKit.CodexSDK/commits/0.0.29