[5/8] Rename Python SDK package to openai-codex (#21905)

## Why

The SDK should publish under the reserved public distribution name
`openai-codex`, and its import module should match that name in the
Python style. Since package names can contain hyphens but import modules
cannot, the public import path becomes `openai_codex`.

Keeping the rename separate from the public API surface change makes the
naming change easy to review and avoids mixing it with API curation.

## What

- Rename the SDK distribution from `openai-codex-app-server-sdk` to
`openai-codex`.
- Rename the import package from `codex_app_server` to `openai_codex`.
- Keep the runtime wheel as the separate `openai-codex-cli-bin`
dependency.
- Update docs, examples, notebooks, artifact scripts, lockfile metadata,
and tests for the new distribution/module names.

## Stack

1. #21891 `[1/8]` Pin Python SDK runtime dependency
2. #21893 `[2/8]` Generate Python SDK types from pinned runtime
3. #21895 `[3/8]` Run Python SDK tests in CI
4. #21896 `[4/8]` Define Python SDK public API surface
5. This PR `[5/8]` Rename Python SDK package to `openai-codex`
6. #21910 `[6/8]` Add high-level Python SDK approval mode
7. #22014 `[7/8]` Add Python SDK app-server integration harness
8. #22021 `[8/8]` Add Python SDK Ruff formatting

## Verification

- Updated package metadata and public API tests to assert the
distribution and import names.

Co-authored-by: Codex <noreply@openai.com>

sdk/python/examples/01_quickstart_constructor/async.py

@@ -15,7 +15,7 @@ ensure_local_sdk_src()
 
 import asyncio
 
-from codex_app_server import AsyncCodex
+from openai_codex import AsyncCodex
 
 
 async def main() -> None:

sdk/python/examples/01_quickstart_constructor/sync.py

@@ -13,7 +13,7 @@ from _bootstrap import (
 
 ensure_local_sdk_src()
 
-from codex_app_server import Codex
+from openai_codex import Codex
 
 with Codex(config=runtime_config()) as codex:
     print("Server:", server_label(codex.metadata))

sdk/python/examples/02_turn_run/async.py

@@ -16,7 +16,7 @@ ensure_local_sdk_src()
 
 import asyncio
 
-from codex_app_server import AsyncCodex, TextInput
+from openai_codex import AsyncCodex, TextInput
 
 
 async def main() -> None:

sdk/python/examples/02_turn_run/sync.py

@@ -14,7 +14,7 @@ from _bootstrap import (
 
 ensure_local_sdk_src()
 
-from codex_app_server import Codex, TextInput
+from openai_codex import Codex, TextInput
 
 with Codex(config=runtime_config()) as codex:
     thread = codex.thread_start(model="gpt-5.4", config={"model_reasoning_effort": "high"})

sdk/python/examples/03_turn_stream_events/async.py

@@ -16,7 +16,7 @@ ensure_local_sdk_src()
 
 import asyncio
 
-from codex_app_server import AsyncCodex, TextInput
+from openai_codex import AsyncCodex, TextInput
 
 
 async def main() -> None:

sdk/python/examples/03_turn_stream_events/sync.py

@@ -14,7 +14,7 @@ from _bootstrap import (
 
 ensure_local_sdk_src()
 
-from codex_app_server import Codex, TextInput
+from openai_codex import Codex, TextInput
 
 with Codex(config=runtime_config()) as codex:
     thread = codex.thread_start(model="gpt-5.4", config={"model_reasoning_effort": "high"})

sdk/python/examples/04_models_and_metadata/async.py

@@ -11,7 +11,7 @@ ensure_local_sdk_src()
 
 import asyncio
 
-from codex_app_server import AsyncCodex
+from openai_codex import AsyncCodex
 
 
 async def main() -> None:

sdk/python/examples/04_models_and_metadata/sync.py

@@ -9,7 +9,7 @@ from _bootstrap import ensure_local_sdk_src, runtime_config, server_label
 
 ensure_local_sdk_src()
 
-from codex_app_server import Codex
+from openai_codex import Codex
 
 with Codex(config=runtime_config()) as codex:
     print("server:", server_label(codex.metadata))

sdk/python/examples/05_existing_thread/async.py

@@ -11,7 +11,7 @@ ensure_local_sdk_src()
 
 import asyncio
 
-from codex_app_server import AsyncCodex, TextInput
+from openai_codex import AsyncCodex, TextInput
 
 
 async def main() -> None:

sdk/python/examples/05_existing_thread/sync.py

@@ -9,7 +9,7 @@ from _bootstrap import assistant_text_from_turn, ensure_local_sdk_src, find_turn
 
 ensure_local_sdk_src()
 
-from codex_app_server import Codex, TextInput
+from openai_codex import Codex, TextInput
 
 with Codex(config=runtime_config()) as codex:
     # Create an initial thread and turn so we have a real thread to resume.

sdk/python/examples/06_thread_lifecycle_and_controls/async.py

@@ -11,7 +11,7 @@ ensure_local_sdk_src()
 
 import asyncio
 
-from codex_app_server import AsyncCodex, TextInput
+from openai_codex import AsyncCodex, TextInput
 
 
 async def main() -> None:

sdk/python/examples/06_thread_lifecycle_and_controls/sync.py

@@ -9,7 +9,7 @@ from _bootstrap import ensure_local_sdk_src, runtime_config
 
 ensure_local_sdk_src()
 
-from codex_app_server import Codex, TextInput
+from openai_codex import Codex, TextInput
 
 
 with Codex(config=runtime_config()) as codex:

sdk/python/examples/07_image_and_text/async.py

@@ -16,7 +16,7 @@ ensure_local_sdk_src()
 
 import asyncio
 
-from codex_app_server import AsyncCodex, ImageInput, TextInput
+from openai_codex import AsyncCodex, ImageInput, TextInput
 
 REMOTE_IMAGE_URL = "https://raw.githubusercontent.com/github/explore/main/topics/python/python.png"
 

sdk/python/examples/07_image_and_text/sync.py

@@ -14,7 +14,7 @@ from _bootstrap import (
 
 ensure_local_sdk_src()
 
-from codex_app_server import Codex, ImageInput, TextInput
+from openai_codex import Codex, ImageInput, TextInput
 
 REMOTE_IMAGE_URL = "https://raw.githubusercontent.com/github/explore/main/topics/python/python.png"
 

sdk/python/examples/08_local_image_and_text/async.py

@@ -17,7 +17,7 @@ ensure_local_sdk_src()
 
 import asyncio
 
-from codex_app_server import AsyncCodex, LocalImageInput, TextInput
+from openai_codex import AsyncCodex, LocalImageInput, TextInput
 
 
 async def main() -> None:

sdk/python/examples/08_local_image_and_text/sync.py

@@ -15,7 +15,7 @@ from _bootstrap import (
 
 ensure_local_sdk_src()
 
-from codex_app_server import Codex, LocalImageInput, TextInput
+from openai_codex import Codex, LocalImageInput, TextInput
 
 with temporary_sample_image_path() as image_path:
     with Codex(config=runtime_config()) as codex:

sdk/python/examples/09_async_parity/sync.py

@@ -15,7 +15,7 @@ from _bootstrap import (
 
 ensure_local_sdk_src()
 
-from codex_app_server import Codex, TextInput
+from openai_codex import Codex, TextInput
 
 with Codex(config=runtime_config()) as codex:
     print("Server:", server_label(codex.metadata))

sdk/python/examples/10_error_handling_and_retry/async.py

@@ -19,14 +19,14 @@ import random
 from collections.abc import Awaitable, Callable
 from typing import TypeVar
 
-from codex_app_server import (
+from openai_codex import (
     AsyncCodex,
     JsonRpcError,
     ServerBusyError,
     TextInput,
     is_retryable_error,
 )
-from codex_app_server.types import TurnStatus
+from openai_codex.types import TurnStatus
 
 ResultT = TypeVar("ResultT")
 

sdk/python/examples/10_error_handling_and_retry/sync.py

@@ -14,14 +14,14 @@ from _bootstrap import (
 
 ensure_local_sdk_src()
 
-from codex_app_server import (
+from openai_codex import (
     Codex,
     JsonRpcError,
     ServerBusyError,
     TextInput,
     retry_on_overload,
 )
-from codex_app_server.types import TurnStatus
+from openai_codex.types import TurnStatus
 
 with Codex(config=runtime_config()) as codex:
     thread = codex.thread_start(model="gpt-5.4", config={"model_reasoning_effort": "high"})

sdk/python/examples/11_cli_mini_app/async.py

@@ -11,11 +11,11 @@ ensure_local_sdk_src()
 
 import asyncio
 
-from codex_app_server import (
+from openai_codex import (
     AsyncCodex,
     TextInput,
 )
-from codex_app_server.types import (
+from openai_codex.types import (
     ThreadTokenUsageUpdatedNotification,
     TurnCompletedNotification,
 )

sdk/python/examples/11_cli_mini_app/sync.py

@@ -9,11 +9,11 @@ from _bootstrap import ensure_local_sdk_src, runtime_config
 
 ensure_local_sdk_src()
 
-from codex_app_server import (
+from openai_codex import (
     Codex,
     TextInput,
 )
-from codex_app_server.types import (
+from openai_codex.types import (
     ThreadTokenUsageUpdatedNotification,
     TurnCompletedNotification,
 )

sdk/python/examples/12_turn_params_kitchen_sink/async.py

@@ -17,11 +17,11 @@ ensure_local_sdk_src()
 
 import asyncio
 
-from codex_app_server import (
+from openai_codex import (
     AsyncCodex,
     TextInput,
 )
-from codex_app_server.types import (
+from openai_codex.types import (
     AskForApproval,
     Personality,
     ReasoningSummary,

sdk/python/examples/12_turn_params_kitchen_sink/sync.py

@@ -15,11 +15,11 @@ from _bootstrap import (
 
 ensure_local_sdk_src()
 
-from codex_app_server import (
+from openai_codex import (
     Codex,
     TextInput,
 )
-from codex_app_server.types import (
+from openai_codex.types import (
     AskForApproval,
     Personality,
     ReasoningSummary,

sdk/python/examples/13_model_select_and_turn_params/async.py

@@ -11,11 +11,11 @@ ensure_local_sdk_src()
 
 import asyncio
 
-from codex_app_server import (
+from openai_codex import (
     AsyncCodex,
     TextInput,
 )
-from codex_app_server.types import (
+from openai_codex.types import (
     AskForApproval,
     Personality,
     ReasoningEffort,

sdk/python/examples/13_model_select_and_turn_params/sync.py

@@ -9,11 +9,11 @@ from _bootstrap import assistant_text_from_turn, ensure_local_sdk_src, find_turn
 
 ensure_local_sdk_src()
 
-from codex_app_server import (
+from openai_codex import (
     Codex,
     TextInput,
 )
-from codex_app_server.types import (
+from openai_codex.types import (
     AskForApproval,
     Personality,
     ReasoningEffort,

sdk/python/examples/14_turn_controls/async.py

@@ -15,7 +15,7 @@ ensure_local_sdk_src()
 
 import asyncio
 
-from codex_app_server import AsyncCodex, TextInput
+from openai_codex import AsyncCodex, TextInput
 
 
 async def main() -> None:

sdk/python/examples/14_turn_controls/sync.py

@@ -13,7 +13,7 @@ from _bootstrap import (
 
 ensure_local_sdk_src()
 
-from codex_app_server import Codex, TextInput
+from openai_codex import Codex, TextInput
 
 with Codex(config=runtime_config()) as codex:
     thread = codex.thread_start(model="gpt-5.4", config={"model_reasoning_effort": "high"})

sdk/python/examples/README.md

@@ -5,8 +5,8 @@ Each example folder contains runnable versions:
 - `sync.py` (public sync surface: `Codex`)
 - `async.py` (public async surface: `AsyncCodex`)
 
-All examples intentionally use only public SDK exports from `codex_app_server`
-and `codex_app_server.types`.
+All examples intentionally use only public SDK exports from `openai_codex`
+and `openai_codex.types`.
 
 ## Prerequisites
 

sdk/python/examples/_bootstrap.py

@@ -35,7 +35,7 @@ def ensure_local_sdk_src() -> Path:
     """Add sdk/python/src to sys.path so examples run without installing the package."""
     sdk_python_dir = _SDK_PYTHON_DIR
     src_dir = sdk_python_dir / "src"
-    package_dir = src_dir / "codex_app_server"
+    package_dir = src_dir / "openai_codex"
     if not package_dir.exists():
         raise RuntimeError(f"Could not locate local SDK package at {package_dir}")
 
@@ -49,7 +49,7 @@ def ensure_local_sdk_src() -> Path:
 
 def runtime_config():
     """Return an example-friendly AppServerConfig for repo-source SDK usage."""
-    from codex_app_server import AppServerConfig
+    from openai_codex import AppServerConfig
 
     ensure_runtime_package_installed(sys.executable, _SDK_PYTHON_DIR)
     return AppServerConfig()