[codex] Rename Python SDK AppServerConfig to CodexConfig#24800
Merged
Conversation
## Why This is stacked on #24800. After exposing `CodexConfig`, the remaining SDK naming still referred to the underlying transport through error and client class names. The SDK-facing vocabulary should center on Codex itself. ## What changed - Renamed exported exceptions to `CodexError` and `CodexRpcError`. - Renamed internal transport wrappers to `CodexClient` and `AsyncCodexClient`, and removed the private `AppServerTurn` alias in favor of `Turn`. - Updated high-level docs and docstrings to say Codex or Codex protocol where users interact with the SDK, while retaining precise executable and transport references where those details matter. ## API impact ```python from openai_codex import CodexError, CodexRpcError ``` `AppServerError` and `AppServerRpcError` are no longer exported. ## Validation - `uv run --frozen --extra dev ruff check src/openai_codex scripts examples tests` - Tests are deferred to online CI for this PR.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
AppServerConfigis exported as part of the ergonomic Python SDK surface and passed toCodex(...)andAsyncCodex(...). That name exposes the underlying app-server transport at the same layer where users are configuring the Codex client.CodexConfigmakes the common callsite read naturally and names the object it configures.What changed
AppServerConfigtoCodexConfig.Codex,AsyncCodex, and the transport clients to acceptCodexConfig.API impact
Callers should now import and construct
CodexConfig;AppServerConfigis no longer part of the Python SDK surface.Validation
uv run --frozen --extra dev ruff check src/openai_codex scripts examples tests