python-codex 0.3.1__tar.gz → 0.3.2__tar.gz

{python_codex-0.3.1 → python_codex-0.3.2}/.github/workflows/publish.yml

@@ -117,6 +117,17 @@ jobs:
           python -m build --outdir dist/pycodex-ws packages/pycodex-ws
           python -m twine check dist/python-codex/* dist/pycodex-ws/*
 
+      - name: Smoke test installed wheels
+        run: |
+          python -m venv "$RUNNER_TEMP/pycodex-wheel"
+          "$RUNNER_TEMP/pycodex-wheel/bin/python" -m pip install \
+            dist/python-codex/*.whl dist/pycodex-ws/*.whl
+          cd "$RUNNER_TEMP"
+          "$RUNNER_TEMP/pycodex-wheel/bin/pycodex" --help
+          "$RUNNER_TEMP/pycodex-wheel/bin/pycodex-ws" --help
+          "$RUNNER_TEMP/pycodex-wheel/bin/python" -m pycodex --help
+          "$RUNNER_TEMP/pycodex-wheel/bin/python" -m workspace_server --help
+
       - name: Upload distributions
         uses: actions/upload-artifact@v4
         with:

{python_codex-0.3.1 → python_codex-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: python-codex
-Version: 0.3.1
+Version: 0.3.2
 Summary: A minimal Python extraction of Codex's main agent loop
 License-File: LICENSE
 Requires-Python: >=3.6.2
@@ -25,6 +25,8 @@ Description-Content-Type: text/markdown
 
 English README. Chinese version: `README_ZH.md`
 
+0.3.2 startup fixes: [release notes](docs/RELEASE_0.3.2.md).
+
 0.3.0 release preparation and Python API migration: `docs/RELEASE_0.3.0.md`.
 
 PyPI distributions:
@@ -60,11 +62,24 @@ Relevant Rust reference points:
 Install the full package or the workspace-oriented alias:
 
 ```bash
-pip install python-codex
-pip install pycodex-ws
+python3 -m pip install python-codex
+python3 -m pip install pycodex-ws
 ```
 
-Install dependencies first:
+Use Python 3.6.2 or newer. Both console commands are installed into that
+interpreter's scripts directory. On a machine with multiple Python installations,
+you can select the same interpreter explicitly for startup:
+
+```bash
+python3 -m pycodex
+python3 -m workspace_server --help
+```
+
+If `pycodex` is missing from `PATH` or resolves to an older installation, use these
+module entry points. `python3 -m pip --version` shows which Python environment
+received the installation.
+
+For development from this repository, install dependencies first:
 
 ```bash
 uv sync
@@ -200,6 +215,18 @@ from pycodex import ResponsesModelClient
 client = ResponsesModelClient.from_codex_config()
 ```
 
+`model_provider` is optional and defaults to `openai`. The built-in provider
+does not require a `[model_providers.openai]` table: it uses
+`https://api.openai.com/v1` and reads `OPENAI_API_KEY`. Set `openai_base_url` to
+override this address. Explicit provider tables retain their configured
+`base_url` and optional `env_key`; unknown provider names raise a configuration
+error. The model still comes from `model` in the configuration or selected
+profile.
+
+Authentication currently uses API keys from environment variables or `.env`;
+Codex desktop/CLI ChatGPT sign-in credentials in `auth.json` or the OS keychain
+are not loaded.
+
 The current implementation uses the streaming OpenAI-compatible `/responses`
 endpoint. This path has already been validated against the local
 `~/.codex/config.toml` setup.

{python_codex-0.3.1 → python_codex-0.3.2}/README.md

@@ -2,6 +2,8 @@
 
 English README. Chinese version: `README_ZH.md`
 
+0.3.2 startup fixes: [release notes](docs/RELEASE_0.3.2.md).
+
 0.3.0 release preparation and Python API migration: `docs/RELEASE_0.3.0.md`.
 
 PyPI distributions:
@@ -37,11 +39,24 @@ Relevant Rust reference points:
 Install the full package or the workspace-oriented alias:
 
 ```bash
-pip install python-codex
-pip install pycodex-ws
+python3 -m pip install python-codex
+python3 -m pip install pycodex-ws
 ```
 
-Install dependencies first:
+Use Python 3.6.2 or newer. Both console commands are installed into that
+interpreter's scripts directory. On a machine with multiple Python installations,
+you can select the same interpreter explicitly for startup:
+
+```bash
+python3 -m pycodex
+python3 -m workspace_server --help
+```
+
+If `pycodex` is missing from `PATH` or resolves to an older installation, use these
+module entry points. `python3 -m pip --version` shows which Python environment
+received the installation.
+
+For development from this repository, install dependencies first:
 
 ```bash
 uv sync
@@ -177,6 +192,18 @@ from pycodex import ResponsesModelClient
 client = ResponsesModelClient.from_codex_config()
 ```
 
+`model_provider` is optional and defaults to `openai`. The built-in provider
+does not require a `[model_providers.openai]` table: it uses
+`https://api.openai.com/v1` and reads `OPENAI_API_KEY`. Set `openai_base_url` to
+override this address. Explicit provider tables retain their configured
+`base_url` and optional `env_key`; unknown provider names raise a configuration
+error. The model still comes from `model` in the configuration or selected
+profile.
+
+Authentication currently uses API keys from environment variables or `.env`;
+Codex desktop/CLI ChatGPT sign-in credentials in `auth.json` or the OS keychain
+are not loaded.
+
 The current implementation uses the streaming OpenAI-compatible `/responses`
 endpoint. This path has already been validated against the local
 `~/.codex/config.toml` setup.

{python_codex-0.3.1 → python_codex-0.3.2}/README_ZH.md

@@ -2,6 +2,8 @@
 
 中文 README。English version: `README.md`
 
+0.3.2 启动修复：[发布说明](docs/RELEASE_0.3.2.md)。
+
 0.3.0 发版准备与 Python API 迁移说明：`docs/RELEASE_0.3.0.md`。
 
 PyPI distributions：
@@ -34,11 +36,22 @@ Import 路径仍保持 `pycodex`；CLI 命令为 `pycodex` 和 `pycodex-ws`。
 安装完整包或 workspace 安装别名：
 
 ```bash
-pip install python-codex
-pip install pycodex-ws
+python3 -m pip install python-codex
+python3 -m pip install pycodex-ws
+```
+
+要求 Python 3.6.2 或更新版本。两个命令会安装到该解释器的 scripts 目录。
+在同时存在 Python 2/3 或多套 Python 的机器上，可以明确使用安装时的解释器启动：
+
+```bash
+python3 -m pycodex
+python3 -m workspace_server --help
 ```
 
-先安装开发依赖：
+如果 `PATH` 中找不到 `pycodex`，或者命中了旧安装，使用以上模块入口即可。
+`python3 -m pip --version` 可确认包安装到了哪个 Python 环境。
+
+从本仓库开发时，先安装依赖：
 
 ```bash
 uv sync
@@ -188,6 +201,16 @@ from pycodex import ResponsesModelClient
 client = ResponsesModelClient.from_codex_config()
 ```
 
+`model_provider` 可省略，默认使用 `openai`。内置 provider 不要求
+`[model_providers.openai]` 表，默认地址为 `https://api.openai.com/v1`，
+从 `OPENAI_API_KEY` 读取密钥；可用 `openai_base_url` 覆盖地址。
+显式 provider 表仍使用其配置的 `base_url` 和可选 `env_key`，
+未知 provider 名称会报明确的配置错误。模型名仍从配置或所选 profile 的
+`model` 字段读取。
+
+当前认证通过环境变量或 `.env` 中的 API key 完成，尚不读取官方 Codex
+桌面端/CLI 保存在 `auth.json` 或系统钥匙串中的 ChatGPT 登录凭据。
+
 当前实现走 OpenAI-compatible Responses API 的流式 `/responses` 接口。这个点
 已经用本机 `~/.codex/config.toml` 做过联调验证。
 

{python_codex-0.3.1 → python_codex-0.3.2}/docs/ALIGNMENT.md

@@ -48,6 +48,29 @@ Tool-specific status uses two inputs:
 - proxy captures of actual upstream Codex and `pycodex` requests/results
 - source inspection against the latest upstream tool specifications
 
+## Startup and provider defaults (2026-10-10)
+
+Provider selection uses `openai` when `model_provider` is omitted, matching
+[`config/mod.rs` at the 0.153.4 source baseline](https://github.com/openai/codex/blob/3d2ee51ca2d5db578f328aa75e20aa22c0197c9a/codex-rs/core/src/config/mod.rs).
+The built-in OpenAI provider needs no user-defined provider table. For pycodex's
+API-key transport, its default address is `https://api.openai.com/v1`, with the
+top-level/profile `openai_base_url` override and `OPENAI_API_KEY` environment
+variable. Custom providers must be selected explicitly; an unknown provider
+raises a descriptive configuration error.
+
+Two local boundaries remain: explicit provider tables retain their existing
+pycodex override behavior, and authentication reads environment API keys rather
+than Codex's stored ChatGPT credentials. `model` must still be specified in the
+configuration or selected profile. This change aligns provider selection,
+not the full upstream authentication or model-discovery surface.
+
+The package also supports `python3 -m pycodex`, alongside the existing
+`python3 -m workspace_server`, so installation and startup can use the same
+interpreter on hosts with multiple Python installations. Console scripts remain
+owned by `python-codex` and are generated by the installer. The publish workflow
+installs the built wheels into a fresh environment and checks both console and
+module entry points outside the source checkout before uploading artifacts.
+
 ## Context audit (2026-09-23)
 
 This audit uses installed `codex-cli 0.153.4` and its matching

python_codex-0.3.2/docs/RELEASE_0.3.2.md

@@ -0,0 +1,36 @@
+# 0.3.2 release notes
+
+Both `python-codex` and `pycodex-ws` use version **0.3.2**. The workspace
+metapackage depends on exactly `python-codex==0.3.2`; publish the core package
+first.
+
+## Startup fixes
+
+- Codex configurations may omit `model_provider`. In that case, use the built-in
+  `openai` provider without requiring a `[model_providers.openai]` table.
+  Its default API address is `https://api.openai.com/v1`, with
+  `openai_base_url` available as an override and `OPENAI_API_KEY` supplying
+  authentication. Existing explicit provider tables keep their behavior;
+  unknown provider names produce a descriptive configuration error.
+- Add `python3 -m pycodex` so installation and startup can explicitly use the
+  same interpreter on hosts with multiple Python installations.
+  The browser frontend remains available through
+  `python3 -m workspace_server` or the `pycodex-ws` command.
+- Check installed wheel entry points in a fresh environment before publication,
+  covering both console scripts and both module entry points outside the source
+  checkout. Add provider-selection and module-exit-status regressions.
+
+The configuration still needs `model`, either at the top level or in the
+selected profile. Authentication uses environment API keys or `.env`;
+stored ChatGPT sign-in credentials from the official Codex CLI/desktop app
+are not loaded.
+
+## Upgrade
+
+```bash
+python3 -m pip install --upgrade pycodex-ws==0.3.2
+python3 -m pycodex
+python3 -m workspace_server --help
+```
+
+`python3 -m pycodex-ws` is not a module entry point.

{python_codex-0.3.1 → python_codex-0.3.2}/packages/pycodex-ws/README.md

@@ -4,10 +4,18 @@
 [`python-codex`](https://pypi.org/project/python-codex/).
 
 ```bash
-pip install pycodex-ws
+python3 -m pip install pycodex-ws
 pycodex-ws --help
 ```
 
+Requires Python 3.6.2 or newer. With multiple Python installations, use the
+installing interpreter to launch either frontend directly:
+
+```bash
+python3 -m workspace_server --help
+python3 -m pycodex --help
+```
+
 This distribution intentionally contains only package metadata. It depends on
 the exact matching `python-codex` version, which provides the `workspace_server`
 implementation and the `pycodex-ws` console script.

{python_codex-0.3.1 → python_codex-0.3.2}/packages/pycodex-ws/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pycodex-ws"
-version = "0.3.1"
+version = "0.3.2"
 description = "Browser workspace install alias for python-codex"
 readme = "README.md"
 requires-python = ">=3.6.2"
 dependencies = [
-    "python-codex==0.3.1",
+    "python-codex==0.3.2",
 ]
 
 [tool.hatch.build.targets.wheel]

python_codex-0.3.2/pycodex/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

{python_codex-0.3.1 → python_codex-0.3.2}/pycodex/model.py

@@ -107,8 +107,17 @@ class ResponsesProviderConfig:
                 raise ValueError(f"unknown Codex profile: {profile}")
             selected.update(overrides)
 
-        provider_name = selected["model_provider"]
-        provider = data["model_providers"][provider_name]
+        provider_name = selected.get("model_provider", "openai")
+        provider = data.get("model_providers", {}).get(provider_name)
+        if provider is None:
+            if provider_name != "openai":
+                raise ValueError(f"unknown Codex model provider: {provider_name}")
+            provider = {
+                "base_url": (
+                    selected.get("openai_base_url") or "https://api.openai.com/v1"
+                ),
+                "env_key": "OPENAI_API_KEY",
+            }
         wire_api = provider.get("wire_api", "responses")
         if wire_api != "responses":
             raise ValueError(f"unsupported wire_api for Python client: {wire_api}")

{python_codex-0.3.1 → python_codex-0.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "python-codex"
-version = "0.3.1"
+version = "0.3.2"
 description = "A minimal Python extraction of Codex's main agent loop"
 readme = "README.md"
 requires-python = ">=3.6.2"

{python_codex-0.3.1 → python_codex-0.3.2}/tests/TESTS.md

@@ -22,9 +22,21 @@
 - 如果已推送的 tag 在 CI 初始化阶段失败，修复 workflow 后应从包含修复的
   branch 手动运行 `publish`，并选择正确的 `repository`。直接重跑旧的
   tag workflow 仍使用旧提交；不要为了 CI 修复强制移动已公开的 tag。
+- `publish.yml` 构建两个 wheel 后，在新 venv 中通过 pip 安装 `pycodex-ws`
+  及同批 `python-codex`，离开源码目录后检查两个 console script 和
+  `python -m pycodex` / `python -m workspace_server`，成功后才上传发布产物。
+  `test_packaging.py` 另覆盖模块入口的帮助、doctor 分发及参数错误退出码。
 
 ## 自动化测试
 
+### Provider 配置
+
+- `test_model.py` 覆盖省略 `model_provider` / provider 表时默认使用内置
+  `openai`、显式选择内置 provider、profile 选择及 `openai_base_url` 覆盖、
+  保留显式 provider 表语义，以及未知 provider 的明确错误。
+- `test_doctor.py` 用本地 Responses fixture 验证省略 provider 的配置可完成
+  配置、API key、连通性和模型请求检查，不访问真实模型服务。
+
 ### VS Code 前端
 
 - `extensions/vscode` 使用 Node 22+，运行

{python_codex-0.3.1 → python_codex-0.3.2}/tests/test_doctor.py

@@ -30,9 +30,11 @@ def _write_config(
 
 
 @pytest.mark.asyncio
+@pytest.mark.parametrize("builtin_openai", [False, True])
 async def test_collect_doctor_report_succeeds_with_live_check(
     tmp_path,
     monkeypatch,
+    builtin_openai,
 ) -> "None":
     capture_store = CaptureStore(tmp_path / "capture")
     httpd = ThreadingHTTPServer(
@@ -43,8 +45,18 @@ async def test_collect_doctor_report_succeeds_with_live_check(
     server_thread.start()
 
     config_path = tmp_path / "config.toml"
-    _write_config(config_path, f"http://127.0.0.1:{httpd.server_port}/v1")
-    monkeypatch.setenv("DOCTOR_KEY", "dummy-key")
+    base_url = f"http://127.0.0.1:{httpd.server_port}/v1"
+    if builtin_openai:
+        config_path.write_text(
+            'model = "gpt-5.4"\n'
+            f'openai_base_url = "{base_url}"\n',
+            encoding="utf-8",
+        )
+        env_key = "OPENAI_API_KEY"
+    else:
+        _write_config(config_path, base_url)
+        env_key = "DOCTOR_KEY"
+    monkeypatch.setenv(env_key, "dummy-key")
 
     try:
         report = await collect_doctor_report(
@@ -58,8 +70,8 @@ async def test_collect_doctor_report_succeeds_with_live_check(
         httpd.server_close()
 
     assert report.ok is True
-    assert report.provider_name == "neo"
-    assert report.api_key_env == "DOCTOR_KEY"
+    assert report.provider_name == ("openai" if builtin_openai else "neo")
+    assert report.api_key_env == env_key
     assert report.api_key_loaded is True
     assert report.live_output_text == "OK"
     assert {check.name for check in report.checks} == {

{python_codex-0.3.1 → python_codex-0.3.2}/tests/test_model.py

@@ -268,6 +268,94 @@ def test_provider_config_reads_codex_style_config_with_profile_override(
     assert provider.beta_features_header == "guardian_approval"
 
 
+@pytest.mark.parametrize("selection", ["", 'model_provider = "openai"\n'])
+def test_provider_config_defaults_to_builtin_openai(
+    tmp_path, monkeypatch, selection
+) -> "None":
+    config_path = tmp_path / "config.toml"
+    config_path.write_text(
+        'model = "gpt-5.4"\n' + selection,
+        encoding="utf-8",
+    )
+    monkeypatch.setenv("OPENAI_API_KEY", "test-key")
+
+    provider = ResponsesProviderConfig.from_codex_config(config_path)
+    client = ResponsesModelClient(provider)
+
+    assert provider.model == "gpt-5.4"
+    assert provider.provider_name == "openai"
+    assert client.responses_url() == "https://api.openai.com/v1/responses"
+    assert provider.api_key_env == "OPENAI_API_KEY"
+    assert provider.api_key() == "test-key"
+
+
+def test_provider_config_uses_openai_default_with_unselected_custom_provider(
+    tmp_path,
+) -> "None":
+    config_path = tmp_path / "config.toml"
+    config_path.write_text(
+        'model = "gpt-5.4"\n'
+        "[model_providers.local]\n"
+        'base_url = "http://localhost:8000/v1"\n',
+        encoding="utf-8",
+    )
+
+    provider = ResponsesProviderConfig.from_codex_config(config_path)
+
+    assert provider.provider_name == "openai"
+    assert provider.base_url == "https://api.openai.com/v1"
+
+
+def test_provider_config_profile_selects_builtin_openai(tmp_path) -> "None":
+    config_path = tmp_path / "config.toml"
+    config_path.write_text(
+        'model = "base-model"\n'
+        'model_provider = "local"\n'
+        "[model_providers.local]\n"
+        'base_url = "http://localhost:8000/v1"\n'
+        "[profiles.openai]\n"
+        'model = "gpt-5.4"\n'
+        'model_provider = "openai"\n'
+        'openai_base_url = "https://example.invalid/v1"\n',
+        encoding="utf-8",
+    )
+
+    provider = ResponsesProviderConfig.from_codex_config(config_path, "openai")
+
+    assert provider.model == "gpt-5.4"
+    assert provider.provider_name == "openai"
+    assert provider.base_url == "https://example.invalid/v1"
+    assert provider.api_key_env == "OPENAI_API_KEY"
+
+
+def test_provider_config_preserves_explicit_openai_provider(tmp_path) -> "None":
+    config_path = tmp_path / "config.toml"
+    config_path.write_text(
+        'model = "local-model"\n'
+        'model_provider = "openai"\n'
+        "[model_providers.openai]\n"
+        'base_url = "http://localhost:8000/v1"\n',
+        encoding="utf-8",
+    )
+
+    provider = ResponsesProviderConfig.from_codex_config(config_path)
+
+    assert provider.base_url == "http://localhost:8000/v1"
+    assert provider.api_key_env is None
+    assert provider.api_key() is None
+
+
+def test_provider_config_rejects_unknown_provider(tmp_path) -> "None":
+    config_path = tmp_path / "config.toml"
+    config_path.write_text(
+        'model = "gpt-5.4"\nmodel_provider = "missing"\n',
+        encoding="utf-8",
+    )
+
+    with pytest.raises(ValueError, match="unknown Codex model provider: missing"):
+        ResponsesProviderConfig.from_codex_config(config_path)
+
+
 def test_build_payload_omits_tool_choice_when_no_tools() -> "None":
     client = ResponsesModelClient(
         ResponsesProviderConfig(

{python_codex-0.3.1 → python_codex-0.3.2}/tests/test_packaging.py

@@ -1,3 +1,6 @@
+import os
+import subprocess
+import sys
 from pathlib import Path
 
 import pytest
@@ -30,6 +33,31 @@ def test_workspace_distribution_tracks_core_version() -> "None":
     assert core["project"]["scripts"]["pycodex-ws"] == "workspace_server:main"
 
 
+@pytest.mark.parametrize(
+    ("arguments", "exit_code", "output"),
+    [
+        (["--help"], 0, "usage: pycodex "),
+        (["doctor", "--help"], 0, "usage: pycodex doctor "),
+        (["--unknown-option"], 2, "unrecognized arguments: --unknown-option"),
+    ],
+)
+def test_python_module_entrypoint(tmp_path, arguments, exit_code, output):
+    environment = dict(os.environ)
+    environment["PYTHONPATH"] = str(ROOT)
+    result = subprocess.run(
+        [sys.executable, "-m", "pycodex"] + arguments,
+        cwd=str(tmp_path),
+        env=environment,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+        universal_newlines=True,
+        timeout=15,
+    )
+
+    assert result.returncode == exit_code, result.stderr
+    assert output in result.stdout + result.stderr
+
+
 @pytest.mark.parametrize("filename", ["test.yml", "publish.yml"])
 def test_python36_workflows_install_yaml_dependency(filename):
     path = ROOT / ".github" / "workflows" / filename