oauth-codex 3.2.2__tar.gz → 4.0.0__tar.gz

oauth_codex-4.0.0/PKG-INFO

@@ -0,0 +1,195 @@
+Metadata-Version: 2.4
+Name: oauth-codex
+Version: 4.0.0
+Summary: Codex OAuth-based Python SDK with resource-style Client and AsyncClient APIs
+Author: Codex
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: keyring>=25.0.0
+Requires-Dist: pydantic>=2.8.0
+Provides-Extra: dev
+Requires-Dist: build>=1.2.0; extra == "dev"
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: twine>=5.0.0; extra == "dev"
+
+[English](README.md) | [한국어](README.ko.md)
+
+# oauth-codex
+
+OAuth PKCE-based Python SDK for the Codex backend.
+
+## Highlights
+
+- Resource-style clients: `Client` and `AsyncClient`
+- OAuth PKCE only, with interactive login and automatic token refresh
+- OpenAI-style `chat.completions.create(...)`
+- Lower-level `responses.create(...)`, `responses.parse(...)`, and `responses.stream(...)`
+- Callable tool loop helpers via `client.beta.chat.completions.run_tools(...)`
+
+## Installation
+
+```bash
+pip install oauth-codex
+```
+
+Requires Python 3.11 or newer.
+
+## Quick Start
+
+### Synchronous Client
+
+```python
+from oauth_codex import Client
+
+client = Client()
+client.authenticate()
+
+completion = client.chat.completions.create(
+    model="gpt-5.3-codex",
+    messages=[{"role": "user", "content": "Hello from oauth-codex"}],
+)
+print(completion.choices[0].message.content)
+```
+
+### Asynchronous Client
+
+```python
+import asyncio
+
+from oauth_codex import AsyncClient
+
+
+async def main():
+    client = AsyncClient()
+    await client.authenticate()
+
+    completion = await client.chat.completions.create(
+        model="gpt-5.3-codex",
+        messages=[{"role": "user", "content": "Hello async"}],
+    )
+    print(completion.choices[0].message.content)
+
+
+asyncio.run(main())
+```
+
+## Authentication
+
+This SDK uses OAuth PKCE only. API keys are not supported.
+
+```python
+client = Client()
+client.authenticate()
+```
+
+On first authentication, the SDK prints an authorization URL, waits for the browser sign-in flow, and asks you to paste the localhost callback URL back into the terminal. Tokens are stored locally and refreshed automatically on later requests.
+
+## Main API Surface
+
+### Chat Completions
+
+```python
+response = client.chat.completions.create(
+    model="gpt-5.3-codex",
+    messages=[{"role": "user", "content": "Write a sorting function"}],
+)
+print(response.choices[0].message.content)
+```
+
+### Responses Resource
+
+```python
+response = client.responses.create(
+    model="gpt-5.3-codex",
+    input=[{"role": "user", "content": "Analyze this code snippet."}],
+)
+print(response.output_text)
+```
+
+### Streaming
+
+```python
+for event in client.responses.stream(
+    model="gpt-5.3-codex",
+    input=[{"role": "user", "content": "Say hello in three words"}],
+):
+    if event.type == "text_delta" and event.delta:
+        print(event.delta, end="", flush=True)
+```
+
+### Structured Output
+
+```python
+from pydantic import BaseModel
+
+
+class Summary(BaseModel):
+    title: str
+    score: int
+
+
+response = client.responses.parse(
+    model="gpt-5.3-codex",
+    input=[{"role": "user", "content": "Return JSON with title and score"}],
+    response_format=Summary,
+)
+print(response.parsed)
+```
+
+### Tool Execution
+
+```python
+def add(a: int, b: int) -> int:
+    return a + b
+
+
+completion = client.beta.chat.completions.run_tools(
+    model="gpt-5.3-codex",
+    messages=[{"role": "user", "content": "What is 2 + 3?"}],
+    tools=[add],
+)
+print(completion.choices[0].message.content)
+```
+
+## Available Namespaces
+
+- `client.chat.completions`
+- `client.responses`
+- `client.files`
+- `client.vector_stores`
+- `client.vector_stores.files`
+- `client.vector_stores.file_batches`
+- `client.models`
+- `client.beta.chat.completions`
+
+`AsyncClient` exposes the same namespaces with async methods.
+
+## Removed In 4.0
+
+- `authenticate_on_init`
+- `generate`, `agenerate`, `stream`, `astream`
+- legacy `OAuthCodexClient` and `AsyncOAuthCodexClient`
+- module-level proxy usage such as `oauth_codex.responses.create(...)`
+
+## Error Handling
+
+The package exports OpenAI-style exception classes such as `AuthenticationError`, `RateLimitError`, `APIConnectionError`, and `APIStatusError`.
+
+## Documentation
+
+- English: [`docs/en/index.md`](docs/en/index.md)
+- Korean: [`docs/ko/index.md`](docs/ko/index.md)
+
+## Development
+
+```bash
+pip install -e .[dev]
+pytest -q
+python -m build
+```
+
+## Changelog
+
+[`CHANGELOG.md`](CHANGELOG.md)

oauth_codex-4.0.0/README.md

@@ -0,0 +1,179 @@
+[English](README.md) | [한국어](README.ko.md)
+
+# oauth-codex
+
+OAuth PKCE-based Python SDK for the Codex backend.
+
+## Highlights
+
+- Resource-style clients: `Client` and `AsyncClient`
+- OAuth PKCE only, with interactive login and automatic token refresh
+- OpenAI-style `chat.completions.create(...)`
+- Lower-level `responses.create(...)`, `responses.parse(...)`, and `responses.stream(...)`
+- Callable tool loop helpers via `client.beta.chat.completions.run_tools(...)`
+
+## Installation
+
+```bash
+pip install oauth-codex
+```
+
+Requires Python 3.11 or newer.
+
+## Quick Start
+
+### Synchronous Client
+
+```python
+from oauth_codex import Client
+
+client = Client()
+client.authenticate()
+
+completion = client.chat.completions.create(
+    model="gpt-5.3-codex",
+    messages=[{"role": "user", "content": "Hello from oauth-codex"}],
+)
+print(completion.choices[0].message.content)
+```
+
+### Asynchronous Client
+
+```python
+import asyncio
+
+from oauth_codex import AsyncClient
+
+
+async def main():
+    client = AsyncClient()
+    await client.authenticate()
+
+    completion = await client.chat.completions.create(
+        model="gpt-5.3-codex",
+        messages=[{"role": "user", "content": "Hello async"}],
+    )
+    print(completion.choices[0].message.content)
+
+
+asyncio.run(main())
+```
+
+## Authentication
+
+This SDK uses OAuth PKCE only. API keys are not supported.
+
+```python
+client = Client()
+client.authenticate()
+```
+
+On first authentication, the SDK prints an authorization URL, waits for the browser sign-in flow, and asks you to paste the localhost callback URL back into the terminal. Tokens are stored locally and refreshed automatically on later requests.
+
+## Main API Surface
+
+### Chat Completions
+
+```python
+response = client.chat.completions.create(
+    model="gpt-5.3-codex",
+    messages=[{"role": "user", "content": "Write a sorting function"}],
+)
+print(response.choices[0].message.content)
+```
+
+### Responses Resource
+
+```python
+response = client.responses.create(
+    model="gpt-5.3-codex",
+    input=[{"role": "user", "content": "Analyze this code snippet."}],
+)
+print(response.output_text)
+```
+
+### Streaming
+
+```python
+for event in client.responses.stream(
+    model="gpt-5.3-codex",
+    input=[{"role": "user", "content": "Say hello in three words"}],
+):
+    if event.type == "text_delta" and event.delta:
+        print(event.delta, end="", flush=True)
+```
+
+### Structured Output
+
+```python
+from pydantic import BaseModel
+
+
+class Summary(BaseModel):
+    title: str
+    score: int
+
+
+response = client.responses.parse(
+    model="gpt-5.3-codex",
+    input=[{"role": "user", "content": "Return JSON with title and score"}],
+    response_format=Summary,
+)
+print(response.parsed)
+```
+
+### Tool Execution
+
+```python
+def add(a: int, b: int) -> int:
+    return a + b
+
+
+completion = client.beta.chat.completions.run_tools(
+    model="gpt-5.3-codex",
+    messages=[{"role": "user", "content": "What is 2 + 3?"}],
+    tools=[add],
+)
+print(completion.choices[0].message.content)
+```
+
+## Available Namespaces
+
+- `client.chat.completions`
+- `client.responses`
+- `client.files`
+- `client.vector_stores`
+- `client.vector_stores.files`
+- `client.vector_stores.file_batches`
+- `client.models`
+- `client.beta.chat.completions`
+
+`AsyncClient` exposes the same namespaces with async methods.
+
+## Removed In 4.0
+
+- `authenticate_on_init`
+- `generate`, `agenerate`, `stream`, `astream`
+- legacy `OAuthCodexClient` and `AsyncOAuthCodexClient`
+- module-level proxy usage such as `oauth_codex.responses.create(...)`
+
+## Error Handling
+
+The package exports OpenAI-style exception classes such as `AuthenticationError`, `RateLimitError`, `APIConnectionError`, and `APIStatusError`.
+
+## Documentation
+
+- English: [`docs/en/index.md`](docs/en/index.md)
+- Korean: [`docs/ko/index.md`](docs/ko/index.md)
+
+## Development
+
+```bash
+pip install -e .[dev]
+pytest -q
+python -m build
+```
+
+## Changelog
+
+[`CHANGELOG.md`](CHANGELOG.md)

{oauth_codex-3.2.2 → oauth_codex-4.0.0}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "oauth-codex"
-version = "3.2.2"
-description = "Codex OAuth-based Python SDK with a single Client and generate-first API"
+dynamic = ["version"]
+description = "Codex OAuth-based Python SDK with resource-style Client and AsyncClient APIs"
 readme = "README.md"
 requires-python = ">=3.11"
 authors = [{ name = "Codex" }]
@@ -17,8 +17,10 @@ dependencies = [
 
 [project.optional-dependencies]
 dev = [
+  "build>=1.2.0",
   "pytest>=8.0.0",
   "pytest-asyncio>=0.23.0",
+  "twine>=5.0.0",
 ]
 
 [tool.setuptools]
@@ -27,9 +29,14 @@ package-dir = {"" = "src"}
 [tool.setuptools.packages.find]
 where = ["src"]
 
+[tool.setuptools.dynamic]
+version = {attr = "oauth_codex._version.__version__"}
+
 [tool.setuptools.package-data]
 oauth_codex = ["py.typed"]
 
 [tool.pytest.ini_options]
 addopts = "-q"
+asyncio_mode = "auto"
 pythonpath = ["src"]
+testpaths = ["tests"]

{oauth_codex-3.2.2 → oauth_codex-4.0.0}/src/oauth_codex/_sdk_client.py

@@ -1,7 +1,6 @@
 from __future__ import annotations
 
 from collections.abc import AsyncIterator, Iterator, Mapping
-from types import SimpleNamespace
 from typing import Any, cast
 
 import httpx
@@ -33,16 +32,6 @@ def _with_auth_headers(
     if auth_headers:
         merged.update(auth_headers)
     return merged
-
-
-def _to_namespace(value: Any) -> Any:
-    if isinstance(value, dict):
-        return SimpleNamespace(**{k: _to_namespace(v) for k, v in value.items()})
-    if isinstance(value, list):
-        return [_to_namespace(v) for v in value]
-    return value
-
-
 def _payload_without_none(values: dict[str, Any]) -> dict[str, Any]:
     payload = {k: v for k, v in values.items() if v is not None}
     payload.pop("self", None)
@@ -131,8 +120,12 @@ class Client(SyncAPIClient):
         self._chat: Chat | None = None
         self._beta: Beta | None = None
         self._auth_provider: SyncAuthProvider | None = None
+        self._vector_file_batches: dict[str, dict[str, Any]] = {}
         self._engine = _SyncEngine(self)
 
+    def authenticate(self) -> None:
+        self.auth.ensure_valid(interactive=True)
+
     @property
     def auth(self) -> SyncAuthProvider:
         if self._auth_provider is None:
@@ -232,8 +225,12 @@ class AsyncClient(AsyncAPIClient):
         self._chat: AsyncChat | None = None
         self._beta: AsyncBeta | None = None
         self._auth_provider: AsyncAuthProvider | None = None
+        self._vector_file_batches: dict[str, dict[str, Any]] = {}
         self._engine = _AsyncEngine(self)
 
+    async def authenticate(self) -> None:
+        await self.auth.aensure_valid(interactive=True)
+
     @property
     def auth(self) -> AsyncAuthProvider:
         if self._auth_provider is None:

{oauth_codex-3.2.2 → oauth_codex-4.0.0}/src/oauth_codex/_version.py

@@ -1,2 +1,2 @@
 __title__ = "oauth-codex"
-__version__ = "3.2.2"
+__version__ = "4.0.0"

oauth_codex-4.0.0/src/oauth_codex/core_types.py

@@ -0,0 +1,64 @@
+"""Core public data types used by oauth-codex.
+
+`Message` represents a single Responses API input message dictionary, and
+`listMessage` is the list container commonly passed to resource methods such as
+`client.chat.completions.create(...)` and `client.responses.create(...)`.
+
+Recommended minimal message shape:
+
+    [{"role": "user", "content": "hello"}]
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any, Callable, Literal, Protocol, TypeAlias
+
+#: A single response input message item (for example role/content dict).
+Message: TypeAlias = dict[str, Any]
+#: List of response input messages accepted by resource-style client methods.
+listMessage: TypeAlias = list[Message]
+ValidationMode: TypeAlias = Literal["warn", "error", "ignore"]
+TruncationMode: TypeAlias = Literal["auto", "disabled"]
+
+
+@dataclass
+class OAuthTokens:
+    access_token: str
+    api_key: str | None = None
+    refresh_token: str | None = None
+    id_token: str | None = None
+    token_type: str = "Bearer"
+    scope: str | None = None
+    expires_at: float | None = None
+    account_id: str | None = None
+    last_refresh: float | None = None
+
+    def is_expired(self, *, leeway_seconds: int = 0) -> bool:
+        if self.expires_at is None:
+            return False
+        import time
+
+        return time.time() + max(leeway_seconds, 0) >= self.expires_at
+
+
+@dataclass
+class ToolResult:
+    tool_call_id: str
+    name: str
+    output: dict[str, Any]
+
+
+ToolSchema = dict[str, Any]
+ToolInput: TypeAlias = ToolSchema | Callable[..., Any]
+
+
+class TokenStore(Protocol):
+    def load(self) -> OAuthTokens | None:
+        ...
+
+    def save(self, tokens: OAuthTokens) -> None:
+        ...
+
+    def delete(self) -> None:
+        ...