langchain-codex-plus 0.0.1__tar.gz

langchain_codex_plus-0.0.1/.github/workflows/publish.yml

@@ -0,0 +1,53 @@
+name: Publish to PyPI
+
+# Triggered by pushing a version tag (e.g. ``v0.0.1``). PyPI Trusted
+# Publishing uses GitHub's OIDC token to authenticate — no API tokens
+# stored anywhere. The ``pypi`` environment adds an extra gate (you
+# can require manual approval on it in the repo settings).
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    name: Build distributions
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+      - name: Set up Python
+        run: uv python install 3.12
+      - name: Build sdist + wheel
+        run: uv build
+      - name: Upload dist artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  publish:
+    name: Publish to PyPI (trusted publishing)
+    needs: build
+    runs-on: ubuntu-latest
+    # Must match the environment name configured on the PyPI pending
+    # publisher. If you skipped the environment field there, remove
+    # this line.
+    environment:
+      name: pypi
+      url: https://pypi.org/p/langchain-codex-plus
+    permissions:
+      # Required for trusted publishing — PyPI verifies the GH OIDC
+      # token, which only this job is allowed to mint.
+      id-token: write
+    steps:
+      - name: Download dist artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

langchain_codex_plus-0.0.1/.gitignore

@@ -0,0 +1,10 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+dist/
+build/
+.DS_Store

langchain_codex_plus-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jason Carreira
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

langchain_codex_plus-0.0.1/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.4
+Name: langchain-codex-plus
+Version: 0.0.1
+Summary: LangChain ChatModel for OpenAI Codex Plus / Pro (ChatGPT-account subscription protocol, not api.openai.com).
+Project-URL: Homepage, https://github.com/jasoncarreira/langchain-codex-plus
+Project-URL: Issues, https://github.com/jasoncarreira/langchain-codex-plus/issues
+Author: Jason Carreira
+License: MIT
+License-File: LICENSE
+Keywords: chatgpt,codex,langchain,oauth,openai,subscription
+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.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: langchain-core>=0.3.0
+Requires-Dist: pydantic>=2.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# langchain-codex-plus
+
+LangChain `ChatModel` for OpenAI's **ChatGPT-account-backed Codex** —
+the subscription protocol (Codex Plus / Pro plans), NOT the public
+`api.openai.com` API.
+
+## What this is
+
+OpenAI's Codex CLI signs you in with a **ChatGPT account** (browser
+OAuth) and routes traffic through:
+
+```
+https://chatgpt.com/backend-api/codex/responses
+```
+
+— a different protocol than `api.openai.com/v1/chat/completions`. It
+has its own request shape, its own auth (OAuth bearer instead of
+`OPENAI_API_KEY`), and exposes quota-window utilization via response
+headers (`x-codex-primary-*`, `x-codex-secondary-*`).
+
+This package wraps that protocol in a LangChain `BaseChatModel` so
+you can use a Codex Plus subscription from any LangChain-built agent
+the way you'd use `ChatOpenAI` or `ChatAnthropic`.
+
+## What this is NOT
+
+* Not for `api.openai.com` traffic — use `langchain-openai` for that.
+* Not for Claude — use `langchain-anthropic` or `langchain-claude-code`.
+* Not a re-implementation of the Codex CLI's agent loop — just the
+  chat-model surface.
+
+## Status
+
+Alpha. v0.0.1. 134 tests + a gated real-account smoke test pass.
+
+## Auth
+
+Run `codex login` once. The CLI writes OAuth credentials to
+`$CODEX_HOME/auth.json` (defaults to `~/.codex/auth.json`). This
+package reads the file directly — there's no separate setup.
+
+```python
+from langchain_codex_plus import ChatCodexPlus
+
+llm = ChatCodexPlus(model="gpt-5.4")
+llm.invoke("Say ok.")
+```
+
+When the access token expires (~1h TTL), a 401 response triggers an
+automatic refresh against `auth.openai.com/oauth/token`, then the
+call retries once. Permanent refresh failures (expired / revoked /
+already-used refresh token) raise `CodexAuthRefreshError` with
+`permanent=True` — the operator must re-run `codex login`. Opt out
+with `auto_refresh=False` if you want to handle 401s yourself.
+
+## Tool calling
+
+Use `bind_tools` exactly like `ChatOpenAI.bind_tools`:
+
+```python
+from langchain_core.tools import tool
+from langchain_codex_plus import ChatCodexPlus
+
+@tool
+def get_weather(location: str) -> str:
+    """Look up the weather."""
+    return f"sunny in {location}"
+
+llm = ChatCodexPlus().bind_tools([get_weather])
+msg = llm.invoke("Weather in Boston?")
+# msg.tool_calls → [{"name": "get_weather", "args": {"location": "Boston"}, "id": "call_..."}]
+```
+
+Send tool results back via `ToolMessage(content=..., tool_call_id=...)` —
+the protocol layer serializes them as Codex `function_call_output`
+entries.
+
+## Multimodal
+
+`HumanMessage` content can be a list mixing text and image blocks:
+
+```python
+from langchain_core.messages import HumanMessage
+
+llm.invoke([HumanMessage(content=[
+    {"type": "text", "text": "What's in this image?"},
+    {"type": "image_url", "image_url": "https://example.com/cat.png"},
+])])
+```
+
+Both LangChain image-block conventions are accepted (`{type: image_url,
+image_url: {url, detail}}` and `{type: image, source_type: "url"|"base64",
+...}`). Base64 data is auto-encoded as a `data:` URL.
+
+## Stop sequences
+
+Codex's `/codex/responses` rejects the `stop` parameter, so we match
+client-side. Streaming uses a buffered matcher so stop sequences
+split across SSE chunks (the common tokenization case) still
+truncate cleanly:
+
+```python
+llm.invoke("Count from 1 to 100", stop=["50"])
+# → "1, 2, 3, ... 49, "
+```
+
+## Rate-limit hook
+
+Every successful `/codex/responses` response carries quota headers
+(`x-codex-primary-*` / `-secondary-*`). The chat model parses these
+into a `CodexRateLimits` dataclass and (optionally) calls a callback
+so your monitoring layer can persist them:
+
+```python
+from langchain_codex_plus import ChatCodexPlus, CodexRateLimits
+
+def on_rate_limits(rl: CodexRateLimits) -> None:
+    print(f"5h: {rl.primary.used_percent}% / 7d: {rl.secondary.used_percent}%")
+
+llm = ChatCodexPlus(model="gpt-5.4", rate_limit_callback=on_rate_limits)
+```
+
+Callback exceptions are caught and logged — they never break the
+response path.
+
+## License
+
+MIT. See `LICENSE`.

langchain_codex_plus-0.0.1/README.md

@@ -0,0 +1,128 @@
+# langchain-codex-plus
+
+LangChain `ChatModel` for OpenAI's **ChatGPT-account-backed Codex** —
+the subscription protocol (Codex Plus / Pro plans), NOT the public
+`api.openai.com` API.
+
+## What this is
+
+OpenAI's Codex CLI signs you in with a **ChatGPT account** (browser
+OAuth) and routes traffic through:
+
+```
+https://chatgpt.com/backend-api/codex/responses
+```
+
+— a different protocol than `api.openai.com/v1/chat/completions`. It
+has its own request shape, its own auth (OAuth bearer instead of
+`OPENAI_API_KEY`), and exposes quota-window utilization via response
+headers (`x-codex-primary-*`, `x-codex-secondary-*`).
+
+This package wraps that protocol in a LangChain `BaseChatModel` so
+you can use a Codex Plus subscription from any LangChain-built agent
+the way you'd use `ChatOpenAI` or `ChatAnthropic`.
+
+## What this is NOT
+
+* Not for `api.openai.com` traffic — use `langchain-openai` for that.
+* Not for Claude — use `langchain-anthropic` or `langchain-claude-code`.
+* Not a re-implementation of the Codex CLI's agent loop — just the
+  chat-model surface.
+
+## Status
+
+Alpha. v0.0.1. 134 tests + a gated real-account smoke test pass.
+
+## Auth
+
+Run `codex login` once. The CLI writes OAuth credentials to
+`$CODEX_HOME/auth.json` (defaults to `~/.codex/auth.json`). This
+package reads the file directly — there's no separate setup.
+
+```python
+from langchain_codex_plus import ChatCodexPlus
+
+llm = ChatCodexPlus(model="gpt-5.4")
+llm.invoke("Say ok.")
+```
+
+When the access token expires (~1h TTL), a 401 response triggers an
+automatic refresh against `auth.openai.com/oauth/token`, then the
+call retries once. Permanent refresh failures (expired / revoked /
+already-used refresh token) raise `CodexAuthRefreshError` with
+`permanent=True` — the operator must re-run `codex login`. Opt out
+with `auto_refresh=False` if you want to handle 401s yourself.
+
+## Tool calling
+
+Use `bind_tools` exactly like `ChatOpenAI.bind_tools`:
+
+```python
+from langchain_core.tools import tool
+from langchain_codex_plus import ChatCodexPlus
+
+@tool
+def get_weather(location: str) -> str:
+    """Look up the weather."""
+    return f"sunny in {location}"
+
+llm = ChatCodexPlus().bind_tools([get_weather])
+msg = llm.invoke("Weather in Boston?")
+# msg.tool_calls → [{"name": "get_weather", "args": {"location": "Boston"}, "id": "call_..."}]
+```
+
+Send tool results back via `ToolMessage(content=..., tool_call_id=...)` —
+the protocol layer serializes them as Codex `function_call_output`
+entries.
+
+## Multimodal
+
+`HumanMessage` content can be a list mixing text and image blocks:
+
+```python
+from langchain_core.messages import HumanMessage
+
+llm.invoke([HumanMessage(content=[
+    {"type": "text", "text": "What's in this image?"},
+    {"type": "image_url", "image_url": "https://example.com/cat.png"},
+])])
+```
+
+Both LangChain image-block conventions are accepted (`{type: image_url,
+image_url: {url, detail}}` and `{type: image, source_type: "url"|"base64",
+...}`). Base64 data is auto-encoded as a `data:` URL.
+
+## Stop sequences
+
+Codex's `/codex/responses` rejects the `stop` parameter, so we match
+client-side. Streaming uses a buffered matcher so stop sequences
+split across SSE chunks (the common tokenization case) still
+truncate cleanly:
+
+```python
+llm.invoke("Count from 1 to 100", stop=["50"])
+# → "1, 2, 3, ... 49, "
+```
+
+## Rate-limit hook
+
+Every successful `/codex/responses` response carries quota headers
+(`x-codex-primary-*` / `-secondary-*`). The chat model parses these
+into a `CodexRateLimits` dataclass and (optionally) calls a callback
+so your monitoring layer can persist them:
+
+```python
+from langchain_codex_plus import ChatCodexPlus, CodexRateLimits
+
+def on_rate_limits(rl: CodexRateLimits) -> None:
+    print(f"5h: {rl.primary.used_percent}% / 7d: {rl.secondary.used_percent}%")
+
+llm = ChatCodexPlus(model="gpt-5.4", rate_limit_callback=on_rate_limits)
+```
+
+Callback exceptions are caught and logged — they never break the
+response path.
+
+## License
+
+MIT. See `LICENSE`.

langchain_codex_plus-0.0.1/langchain_codex_plus/__init__.py

@@ -0,0 +1,77 @@
+"""langchain-codex-plus: LangChain ChatModel for OpenAI Codex Plus.
+
+Wraps OpenAI's ChatGPT-account-backed Codex subscription protocol
+(``chatgpt.com/backend-api/codex/responses``) as a LangChain
+``BaseChatModel``. See README for what this is and isn't.
+"""
+from __future__ import annotations
+
+from langchain_codex_plus.codex_auth import (
+    CODEX_API_BASE,
+    CODEX_OAUTH_CLIENT_ID,
+    REFRESH_TOKEN_URL,
+    CodexAuth,
+    CodexAuthInvalidError,
+    CodexAuthNotFoundError,
+    CodexAuthRefreshError,
+    arefresh_codex_auth,
+    auth_file_path,
+    codex_home,
+    is_likely_expired,
+    load_codex_auth,
+    refresh_codex_auth,
+)
+from langchain_codex_plus.codex_chat_model import ChatCodexPlus
+from langchain_codex_plus.codex_protocol import (
+    CodexCompletion,
+    CodexResponseError,
+    CodexToolCall,
+    SseEvent,
+    ToolChoice,
+    build_request_body,
+    consume_events,
+    parse_error_body,
+    parse_sse_stream,
+)
+from langchain_codex_plus.rate_limits import (
+    CodexCredits,
+    CodexQuotaWindow,
+    CodexRateLimits,
+    parse_codex_rate_limits,
+)
+
+__version__ = "0.0.1"
+
+__all__ = [
+    # codex_auth
+    "CODEX_API_BASE",
+    "CODEX_OAUTH_CLIENT_ID",
+    "REFRESH_TOKEN_URL",
+    "CodexAuth",
+    "CodexAuthInvalidError",
+    "CodexAuthNotFoundError",
+    "CodexAuthRefreshError",
+    "arefresh_codex_auth",
+    "auth_file_path",
+    "codex_home",
+    "is_likely_expired",
+    "load_codex_auth",
+    "refresh_codex_auth",
+    # codex_protocol
+    "CodexCompletion",
+    "CodexResponseError",
+    "CodexToolCall",
+    "SseEvent",
+    "ToolChoice",
+    "build_request_body",
+    "consume_events",
+    "parse_error_body",
+    "parse_sse_stream",
+    # rate_limits
+    "CodexCredits",
+    "CodexQuotaWindow",
+    "CodexRateLimits",
+    "parse_codex_rate_limits",
+    # chat model
+    "ChatCodexPlus",
+]