codex-backend-sdk 0.5.8__tar.gz → 0.6.0__tar.gz

{codex_backend_sdk-0.5.8 → codex_backend_sdk-0.6.0}/CHANGELOG.md

@@ -2,6 +2,33 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.6.0] - 2026-11-14
+
+### Added
+- First-class `AsyncOpenAI` / `AsyncCodexClient` resource tree with native
+  async HTTP, SSE, OAuth, Responses WebSocket, Realtime, Live, Remote Control,
+  file streaming, retry, cancellation, and cleanup behavior.
+- Deterministic generation and drift checking for async resource mirrors.
+
+### Changed
+- Track the current `openai-python` response and image method signatures while
+  continuing to reject backend-unsupported options explicitly.
+
+### Fixed
+- Accept repeated WebSocket handshake headers such as multiple `Set-Cookie`
+  fields without failing connection setup.
+
+## [0.5.9] - 2026-10-24
+
+### Added
+- OAuth transcription-only primary Realtime WebSocket with JSON events,
+  context-managed cleanup, bounded socket timeout, and no automatic audio replay.
+  Verified with synthetic PCM16LE mono 24 kHz speech, no developer API key.
+
+### Documentation
+- Distinguish verified Realtime transcription from the legacy batch route's
+  current HTTP 403 responses; OAuth success does not establish quota coverage.
+
 ## [0.5.8] - 2026-10-22
 
 ### Added

codex_backend_sdk-0.5.8/README.md → codex_backend_sdk-0.6.0/PKG-INFO

@@ -1,3 +1,36 @@
+Metadata-Version: 2.5
+Name: codex-backend-sdk
+Version: 0.6.0
+Summary: Unofficial Python SDK for the ChatGPT Codex backend API
+License: MIT
+License-File: LICENSE
+Keywords: chatgpt,codex,llm,openai,sdk
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Requires-Dist: httpx<1,>=0.27
+Requires-Dist: pydantic>=2.0
+Requires-Dist: requests>=2.28
+Requires-Dist: websocket-client>=1.8
+Requires-Dist: websockets<17,>=13
+Provides-Extra: dev
+Requires-Dist: libcst>=1.4; extra == 'dev'
+Requires-Dist: openai<3.0,>=1.0; (python_version < '3.10') and extra == 'dev'
+Requires-Dist: openai>=3.16.1; (python_version >= '3.10') and extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Provides-Extra: openai
+Requires-Dist: openai<3.0,>=1.0; (python_version < '3.10') and extra == 'openai'
+Requires-Dist: openai>=3.16.1; (python_version >= '3.10') and extra == 'openai'
+Description-Content-Type: text/markdown
+
 # codex-backend-sdk
 
 Unofficial Python SDK for building independent harnesses and integrations on
@@ -26,10 +59,12 @@ The package intentionally separates three kinds of API:
 pip install --upgrade codex-backend-sdk
 ```
 
-Version **0.5.8** aligns the SDK with Codex source commit `0eb98b4617`:
-WebSocket interruption, message replay fields, numeric reasoning efforts, and
-scoped installed-plugin pagination. See the [source audit](docs/codex-source-audit.md)
-for verified contracts and the separately inventoried, unsupported cloud gRPC
+Version **0.6.0** adds the native async client and full async resource tree. It
+retains the 0.5.9 OAuth Realtime transcription transport and the 0.5.8 alignment
+with Codex source commit `0eb98b4617`: WebSocket interruption, message replay
+fields, numeric reasoning efforts, and scoped installed-plugin pagination. See
+the [changelog](CHANGELOG.md) and [source audit](docs/codex-source-audit.md) for
+verified contracts and the separately inventoried, unsupported cloud gRPC
 transport.
 
 For an editable checkout:
@@ -59,6 +94,39 @@ print(response.output_text)
 opens the browser OAuth flow. Most examples below assume an authenticated
 `client` created this way.
 
+### Async quickstart
+
+`AsyncOpenAI` exposes the same resource tree with native `httpx` HTTP/SSE and
+`websockets` transports. Network operations, stream iteration, authentication,
+and cleanup are awaitable; no network call is delegated to a worker thread.
+
+```python
+from codex_backend_sdk import AsyncOpenAI
+
+async with AsyncOpenAI() as client:
+    await client.authenticate()
+    response = await client.responses.create(input="Explain quicksort briefly.")
+    print(response.output_text)
+```
+
+Streaming and reusable Responses WebSockets are async iterators:
+
+```python
+stream = await client.responses.create(input="Say hello.", stream=True)
+async with stream:
+    async for event in stream:
+        if event.type == "response.output_text.delta":
+            print(event.delta, end="")
+
+async with await client.responses.websocket.connect() as ws:
+    async for event in ws.create({
+        "input": [{"role": "user", "content": [
+            {"type": "input_text", "text": "Say hello again."}
+        ]}]
+    }):
+        print(event["type"])
+```
+
 ## Choose the right surface
 
 ### Direct client: inference and reusable primitives
@@ -157,7 +225,12 @@ connection reusable across sequential turns:
 
 ```python
 with client.responses.websocket.connect() as ws:
-    for event in ws.create({"model": "gpt-5.5", "input": "Say hello."}):
+    for event in ws.create({
+        "model": "gpt-5.5",
+        "input": [{"role": "user", "content": [
+            {"type": "input_text", "text": "Say hello."}
+        ]}],
+    }):
         if event.get("type") == "response.output_text.delta":
             print(event.get("delta", ""), end="")
 ```
@@ -654,11 +727,14 @@ explicit network mutation and clears local credentials only after success.
 
 ## Development
 
+In the shared suite, activate `../.venv` and use the workspace installer instead
+of reinstalling this member alone. Standalone development can use any environment.
+
 ```bash
-uv sync --extra dev
-uv run pytest -q
-uv run python -m compileall -q codex_backend_sdk
-uv build
+python -m pip install -e ".[dev]"
+python -m pytest -q
+python -m compileall -q codex_backend_sdk
+python -m build
 ```
 
 Live probes are intentionally kept separate from the deterministic test suite:

codex_backend_sdk-0.5.8/PKG-INFO → codex_backend_sdk-0.6.0/README.md

@@ -1,32 +1,3 @@
-Metadata-Version: 2.5
-Name: codex-backend-sdk
-Version: 0.5.8
-Summary: Unofficial Python SDK for the ChatGPT Codex backend API
-License: MIT
-License-File: LICENSE
-Keywords: chatgpt,codex,llm,openai,sdk
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.9
-Requires-Dist: pydantic>=2.0
-Requires-Dist: requests>=2.28
-Requires-Dist: websocket-client>=1.8
-Provides-Extra: dev
-Requires-Dist: openai<3.0,>=1.0; (python_version < '3.10') and extra == 'dev'
-Requires-Dist: openai>=3.16.1; (python_version >= '3.10') and extra == 'dev'
-Requires-Dist: pytest>=7.0; extra == 'dev'
-Provides-Extra: openai
-Requires-Dist: openai<3.0,>=1.0; (python_version < '3.10') and extra == 'openai'
-Requires-Dist: openai>=3.16.1; (python_version >= '3.10') and extra == 'openai'
-Description-Content-Type: text/markdown
-
 # codex-backend-sdk
 
 Unofficial Python SDK for building independent harnesses and integrations on
@@ -55,10 +26,12 @@ The package intentionally separates three kinds of API:
 pip install --upgrade codex-backend-sdk
 ```
 
-Version **0.5.8** aligns the SDK with Codex source commit `0eb98b4617`:
-WebSocket interruption, message replay fields, numeric reasoning efforts, and
-scoped installed-plugin pagination. See the [source audit](docs/codex-source-audit.md)
-for verified contracts and the separately inventoried, unsupported cloud gRPC
+Version **0.6.0** adds the native async client and full async resource tree. It
+retains the 0.5.9 OAuth Realtime transcription transport and the 0.5.8 alignment
+with Codex source commit `0eb98b4617`: WebSocket interruption, message replay
+fields, numeric reasoning efforts, and scoped installed-plugin pagination. See
+the [changelog](CHANGELOG.md) and [source audit](docs/codex-source-audit.md) for
+verified contracts and the separately inventoried, unsupported cloud gRPC
 transport.
 
 For an editable checkout:
@@ -88,6 +61,39 @@ print(response.output_text)
 opens the browser OAuth flow. Most examples below assume an authenticated
 `client` created this way.
 
+### Async quickstart
+
+`AsyncOpenAI` exposes the same resource tree with native `httpx` HTTP/SSE and
+`websockets` transports. Network operations, stream iteration, authentication,
+and cleanup are awaitable; no network call is delegated to a worker thread.
+
+```python
+from codex_backend_sdk import AsyncOpenAI
+
+async with AsyncOpenAI() as client:
+    await client.authenticate()
+    response = await client.responses.create(input="Explain quicksort briefly.")
+    print(response.output_text)
+```
+
+Streaming and reusable Responses WebSockets are async iterators:
+
+```python
+stream = await client.responses.create(input="Say hello.", stream=True)
+async with stream:
+    async for event in stream:
+        if event.type == "response.output_text.delta":
+            print(event.delta, end="")
+
+async with await client.responses.websocket.connect() as ws:
+    async for event in ws.create({
+        "input": [{"role": "user", "content": [
+            {"type": "input_text", "text": "Say hello again."}
+        ]}]
+    }):
+        print(event["type"])
+```
+
 ## Choose the right surface
 
 ### Direct client: inference and reusable primitives
@@ -186,7 +192,12 @@ connection reusable across sequential turns:
 
 ```python
 with client.responses.websocket.connect() as ws:
-    for event in ws.create({"model": "gpt-5.5", "input": "Say hello."}):
+    for event in ws.create({
+        "model": "gpt-5.5",
+        "input": [{"role": "user", "content": [
+            {"type": "input_text", "text": "Say hello."}
+        ]}],
+    }):
         if event.get("type") == "response.output_text.delta":
             print(event.get("delta", ""), end="")
 ```
@@ -683,11 +694,14 @@ explicit network mutation and clears local credentials only after success.
 
 ## Development
 
+In the shared suite, activate `../.venv` and use the workspace installer instead
+of reinstalling this member alone. Standalone development can use any environment.
+
 ```bash
-uv sync --extra dev
-uv run pytest -q
-uv run python -m compileall -q codex_backend_sdk
-uv build
+python -m pip install -e ".[dev]"
+python -m pytest -q
+python -m compileall -q codex_backend_sdk
+python -m build
 ```
 
 Live probes are intentionally kept separate from the deterministic test suite:

{codex_backend_sdk-0.5.8 → codex_backend_sdk-0.6.0}/codex_backend_sdk/__init__.py

@@ -17,7 +17,7 @@ Quickstart:
     print(response.output_text)
 """
 
-__version__ = "0.5.8"
+__version__ = "0.6.0"
 
 from .oauth import (
     DeviceCode,
@@ -28,6 +28,19 @@ from .oauth import (
     run_oauth_flow,
 )
 from .storage import load_tokens, save_tokens, TokenStore
+from ._async_client import AsyncCodexClient, AsyncOpenAI
+from ._async_streaming import AsyncResponseEventStream
+from .async_resources.responses_websocket import AsyncResponsesWebSocketConnection
+from .async_resources.realtime import (
+    AsyncLiveSidebandConnection,
+    AsyncLiveSidebandConnectionManager,
+    AsyncRealtimeConnection,
+    AsyncRealtimeSidebandConnection,
+)
+from .async_resources.remote_control import (
+    AsyncRemoteControlConnection,
+    AsyncRemoteControlDesktop,
+)
 from .resources.remote_control import (
     RemoteControlClient,
     RemoteControlClientPage,
@@ -90,6 +103,16 @@ from .codex_client import (
 )
 
 __all__ = [
+    "AsyncCodexClient",
+    "AsyncOpenAI",
+    "AsyncResponseEventStream",
+    "AsyncResponsesWebSocketConnection",
+    "AsyncLiveSidebandConnection",
+    "AsyncLiveSidebandConnectionManager",
+    "AsyncRealtimeConnection",
+    "AsyncRealtimeSidebandConnection",
+    "AsyncRemoteControlConnection",
+    "AsyncRemoteControlDesktop",
     "CodexClient",
     "OpenAI",
     "CodexBackendUnsupportedParameterError",