codex-as-api 0.7.0__tar.gz → 0.8.0__tar.gz

{codex_as_api-0.7.0 → codex_as_api-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: codex-as-api
-Version: 0.7.0
+Version: 0.8.0
 Summary: Use ChatGPT/Codex OAuth as a local OpenAI-compatible API server.
 Project-URL: Homepage, https://github.com/Eunho-J/codex-as-api
 Project-URL: Repository, https://github.com/Eunho-J/codex-as-api
@@ -463,6 +463,36 @@ Readiness check. It returns `200` only when OAuth is available, a fresh catalog
 curl -i http://localhost:18080/health
 ```
 
+### `POST /v1/realtime/calls` (TypeScript)
+
+Creates a ChatGPT Live (realtime voice) call on the OAuth-authenticated ChatGPT
+backend. The client owns the media plane: it sends its own WebRTC SDP offer and
+applies the returned answer, so no audio is relayed through this proxy.
+
+The body is `{"sdp": "<offer>", "session": {...}}`. `session` may carry
+`instructions`, a `voice` (default `cove`), and any additional ChatGPT Live
+session field; `model` defaults to `gpt-live-1-codex`, and `delegation` defaults
+to `{"type": "client"}`. The route rejects unknown top-level fields and any
+client-chosen voice-session id (`id`, `session_id`, `voice_session_id`), because
+the backend denies calls that set those itself. On success it returns `201` with
+the SDP answer as `text/plain` and a mirror `Location: /v1/realtime/calls/{call_id}`.
+
+```bash
+curl -i http://localhost:18080/v1/realtime/calls \
+  -H "Content-Type: application/json" \
+  -d '{"sdp": "v=0\r\n...", "session": {"instructions": "Reply briefly."}}'
+```
+
+### `WS /v1/realtime/sideband/{call_id}` (TypeScript)
+
+Relays a WebSocket to the OpenAI realtime sideband of an already-created call
+(`wss://api.openai.com/v1/live/{call_id}`) with the account's OAuth headers, so a
+headless client — a bot, a server-side agent, or an observer attached to the same
+call — can read and write realtime events without running the media plane.
+Frames, text and binary, are forwarded verbatim; the proxy does not rewrite or
+invent session events. Browser clients that already hold the `oai-events` data
+channel do not need this route.
+
 ## Codex-Specific Features
 
 These features are extensions beyond the standard OpenAI API, designed for Codex CLI compatibility.
@@ -812,6 +842,7 @@ The provider handles:
 - Bounded, account-scoped `previous_response_id` history replay over private HTTP
 - Multimodal Chat input, image generation/inspection, and capability-gated classic `original` detail
 - Remote conversation compaction
+- ChatGPT Live realtime call creation and a sideband event relay, in the TypeScript runtime only
 
 ## Release & package publishing
 
@@ -841,9 +872,9 @@ registry setup is still required:
 After bumping every version and passing the local gate, push the matching tag:
 
 ```bash
-python scripts/check_package_versions.py --tag v0.7.0
-git tag v0.7.0
-git push origin v0.7.0
+python scripts/check_package_versions.py --tag v0.8.0
+git tag v0.8.0
+git push origin v0.8.0
 ```
 
 ## Tests
@@ -874,6 +905,20 @@ npm test
 
 ## Release Notes
 
+### v0.8.0
+
+- Add ChatGPT Live realtime voice to the TypeScript runtime: `POST
+  /v1/realtime/calls` creates an OAuth-authorized call from a client-owned WebRTC
+  SDP offer and returns the SDP answer, and `WS /v1/realtime/sideband/{call_id}`
+  relays the OpenAI realtime event sideband for headless clients. Audio stays on
+  the client's media plane.
+- Mirror the pinned Codex call contract exactly: one identity in
+  `x-session-id`/`session-id`/`thread-id`, the `openai-alpha: quicksilver=v2`
+  handshake, `intent=quicksilver&architecture=avas`, and a session payload that
+  never chooses its own voice-session id.
+- Document realtime as a TypeScript-only capability; Python and Rust remain
+  HTTP-only in this release instead of claiming cross-runtime parity.
+
 ### v0.7.0
 
 - Replace bundled model capability tables with a fresh authenticated Codex

{codex_as_api-0.7.0 → codex_as_api-0.8.0}/README.md

@@ -430,6 +430,36 @@ Readiness check. It returns `200` only when OAuth is available, a fresh catalog
 curl -i http://localhost:18080/health
 ```
 
+### `POST /v1/realtime/calls` (TypeScript)
+
+Creates a ChatGPT Live (realtime voice) call on the OAuth-authenticated ChatGPT
+backend. The client owns the media plane: it sends its own WebRTC SDP offer and
+applies the returned answer, so no audio is relayed through this proxy.
+
+The body is `{"sdp": "<offer>", "session": {...}}`. `session` may carry
+`instructions`, a `voice` (default `cove`), and any additional ChatGPT Live
+session field; `model` defaults to `gpt-live-1-codex`, and `delegation` defaults
+to `{"type": "client"}`. The route rejects unknown top-level fields and any
+client-chosen voice-session id (`id`, `session_id`, `voice_session_id`), because
+the backend denies calls that set those itself. On success it returns `201` with
+the SDP answer as `text/plain` and a mirror `Location: /v1/realtime/calls/{call_id}`.
+
+```bash
+curl -i http://localhost:18080/v1/realtime/calls \
+  -H "Content-Type: application/json" \
+  -d '{"sdp": "v=0\r\n...", "session": {"instructions": "Reply briefly."}}'
+```
+
+### `WS /v1/realtime/sideband/{call_id}` (TypeScript)
+
+Relays a WebSocket to the OpenAI realtime sideband of an already-created call
+(`wss://api.openai.com/v1/live/{call_id}`) with the account's OAuth headers, so a
+headless client — a bot, a server-side agent, or an observer attached to the same
+call — can read and write realtime events without running the media plane.
+Frames, text and binary, are forwarded verbatim; the proxy does not rewrite or
+invent session events. Browser clients that already hold the `oai-events` data
+channel do not need this route.
+
 ## Codex-Specific Features
 
 These features are extensions beyond the standard OpenAI API, designed for Codex CLI compatibility.
@@ -779,6 +809,7 @@ The provider handles:
 - Bounded, account-scoped `previous_response_id` history replay over private HTTP
 - Multimodal Chat input, image generation/inspection, and capability-gated classic `original` detail
 - Remote conversation compaction
+- ChatGPT Live realtime call creation and a sideband event relay, in the TypeScript runtime only
 
 ## Release & package publishing
 
@@ -808,9 +839,9 @@ registry setup is still required:
 After bumping every version and passing the local gate, push the matching tag:
 
 ```bash
-python scripts/check_package_versions.py --tag v0.7.0
-git tag v0.7.0
-git push origin v0.7.0
+python scripts/check_package_versions.py --tag v0.8.0
+git tag v0.8.0
+git push origin v0.8.0
 ```
 
 ## Tests
@@ -841,6 +872,20 @@ npm test
 
 ## Release Notes
 
+### v0.8.0
+
+- Add ChatGPT Live realtime voice to the TypeScript runtime: `POST
+  /v1/realtime/calls` creates an OAuth-authorized call from a client-owned WebRTC
+  SDP offer and returns the SDP answer, and `WS /v1/realtime/sideband/{call_id}`
+  relays the OpenAI realtime event sideband for headless clients. Audio stays on
+  the client's media plane.
+- Mirror the pinned Codex call contract exactly: one identity in
+  `x-session-id`/`session-id`/`thread-id`, the `openai-alpha: quicksilver=v2`
+  handshake, `intent=quicksilver&architecture=avas`, and a session payload that
+  never chooses its own voice-session id.
+- Document realtime as a TypeScript-only capability; Python and Rust remain
+  HTTP-only in this release instead of claiming cross-runtime parity.
+
 ### v0.7.0
 
 - Replace bundled model capability tables with a fresh authenticated Codex

{codex_as_api-0.7.0 → codex_as_api-0.8.0}/RELEASES.md

@@ -1,5 +1,30 @@
 # Release Notes
 
+## v0.8.0
+
+### ChatGPT Live realtime voice (TypeScript)
+
+- Add `POST /v1/realtime/calls` to the TypeScript runtime. A client-owned WebRTC
+  SDP offer plus an optional `session` object (`instructions`, `voice`, ...) is
+  exchanged for the ChatGPT backend's SDP answer; the call id is returned both in
+  the mirrored `Location: /v1/realtime/calls/{call_id}` header and as
+  `x-realtime-call-id`, and the answer body is `text/plain`, never JSON.
+- Add `WS /v1/realtime/sideband/{call_id}`, which relays text and binary realtime
+  frames to `wss://api.openai.com/v1/live/{call_id}` with the account's OAuth
+  headers so headless clients (bots, server-side agents, observers) can attach to
+  an existing call. The proxy does not proxy RTP; the media plane stays client-side.
+- Send the exact call contract the backend authorizes for OAuth: `version`,
+  `openai-alpha: quicksilver=v2`, `session-id`/`x-session-id`/`thread-id` carrying
+  one minted identity, and `intent=quicksilver&architecture=avas`. Reject unknown
+  top-level request fields and any client-chosen voice-session id (`id`,
+  `session_id`, `voice_session_id`) instead of forwarding a call the backend
+  denies.
+- Default `model` to `gpt-live-1-codex`, `voice` to `cove`, and `delegation` to
+  `{"type": "client"}`.
+- Realtime is TypeScript-only in this release. The Python and Rust runtimes keep
+  their existing HTTP surface, and the runtime difference is stated in
+  `README.md` and `ts/README.md` rather than presented as parity.
+
 ## v0.7.0
 
 ### Live authenticated model catalog

{codex_as_api-0.7.0 → codex_as_api-0.8.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "codex-as-api"
-version = "0.7.0"
+version = "0.8.0"
 description = "Use ChatGPT/Codex OAuth as a local OpenAI-compatible API server."
 readme = "README.md"
 license = { text = "Apache-2.0" }

{codex_as_api-0.7.0 → codex_as_api-0.8.0}/src/codex_as_api/__init__.py

@@ -1,3 +1,3 @@
 """codex-as-api: Use ChatGPT/Codex OAuth as a local OpenAI-compatible API server."""
 
-__version__ = "0.7.0"
+__version__ = "0.8.0"

{codex_as_api-0.7.0 → codex_as_api-0.8.0}/src/codex_as_api/server.py

@@ -497,7 +497,7 @@ def _health_error_message(exc: BaseException) -> str:
 app = FastAPI(
     title="codex-as-api",
     description="Local OpenAI-compatible API server backed by ChatGPT/Codex OAuth.",
-    version="0.7.0",
+    version="0.8.0",
 )
 
 

{codex_as_api-0.7.0 → codex_as_api-0.8.0}/tests/test_provider.py

@@ -2158,7 +2158,7 @@ def test_codex_cli_headers_include_official_originator_and_versioned_user_agent(
 
     assert headers["originator"] == "codex_cli_rs"
     assert headers["User-Agent"].startswith("codex_cli_rs/0.153.3 (")
-    assert headers["User-Agent"].endswith(") codex-as-api/0.7.0")
+    assert headers["User-Agent"].endswith(") codex-as-api/0.8.0")
 
 
 def test_codex_cli_headers_reject_unpinned_version():
@@ -2881,7 +2881,7 @@ def test_provider_headers_include_codex_cli_headers(auth_json_factory):
 
     assert headers["originator"] == "codex_cli_rs"
     assert headers["User-Agent"].startswith("codex_cli_rs/0.153.3 (")
-    assert headers["User-Agent"].endswith(") codex-as-api/0.7.0")
+    assert headers["User-Agent"].endswith(") codex-as-api/0.8.0")
     assert headers["Authorization"].startswith("Bearer ")