feat: 1.0b2

Author: gersmann

.github/workflows/ci.yml

@@ -42,3 +42,38 @@ jobs:
 
       - name: Test
         run: make test
+
+      - name: Detect integration test availability
+        id: integration
+        env:
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+        run: |
+          if [ -n "${OPENAI_API_KEY:-}" ]; then
+            echo "enabled=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "enabled=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Install integration test dependencies
+        if: ${{ steps.integration.outputs.enabled == 'true' }}
+        run: pip install zstandard
+
+      - name: Fetch bundled codex binary for integration test
+        if: ${{ steps.integration.outputs.enabled == 'true' }}
+        env:
+          CODEX_BINARY_RELEASE_TAG: ${{ vars.CODEX_BINARY_RELEASE_TAG || 'latest' }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          set -euo pipefail
+          python scripts/fetch_codex_binary.py \
+            --release-tag "$CODEX_BINARY_RELEASE_TAG" \
+            --target-triple x86_64-unknown-linux-musl
+          test -f codex/vendor/x86_64-unknown-linux-musl/codex/codex
+
+      - name: Integration test (real codex binary)
+        if: ${{ steps.integration.outputs.enabled == 'true' }}
+        env:
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+          CODEX_BINARY_PATH: codex/vendor/x86_64-unknown-linux-musl/codex/codex
+          CODEX_INTEGRATION_TEST: "1"
+        run: uv run --group dev pytest -q tests/test_integration_real_binary.py

.github/workflows/release-published.yml

@@ -20,6 +20,7 @@ jobs:
       tag: ${{ steps.ctx.outputs.tag }}
       version: ${{ steps.resolve.outputs.version }}
       sha: ${{ steps.ctx.outputs.sha }}
+      build_sha: ${{ steps.build_sha.outputs.sha }}
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -154,6 +155,15 @@ jobs:
             });
             core.info(`Updated release ${rel.id} to tag ${realTag}`);
 
+      - name: Resolve build SHA
+        id: build_sha
+        shell: bash
+        run: |
+          set -euo pipefail
+          SHA=$(git rev-parse HEAD)
+          echo "sha=$SHA" >> "$GITHUB_OUTPUT"
+          echo "Using build SHA: $SHA"
+
   build-wheels:
     name: Build native wheels
     needs: prepare
@@ -205,6 +215,7 @@ jobs:
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
+          ref: ${{ needs.prepare.outputs.build_sha }}
 
       - name: Set up Rust
         uses: dtolnay/rust-toolchain@stable
@@ -345,6 +356,8 @@ jobs:
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
+        with:
+          ref: ${{ needs.prepare.outputs.build_sha }}
 
       - name: Set up Rust
         uses: dtolnay/rust-toolchain@stable

README.md

@@ -88,9 +88,27 @@ thread.run("Continue from previous context")
 
 ## Options
 
-- `CodexOptions`: `codex_path_override`, `base_url`, `api_key`
-- `ThreadOptions`: `model`, `sandbox_mode`, `working_directory`, `skip_git_repo_check`
-- `TurnOptions`: `output_schema`
+- `CodexOptions`: `codex_path_override`, `base_url`, `api_key`, `config`, `env`
+- `ThreadOptions`: `model`, `sandbox_mode`, `working_directory`, `skip_git_repo_check`, `model_reasoning_effort`, `network_access_enabled`, `web_search_mode`, `web_search_enabled`, `approval_policy`, `additional_directories`
+- `TurnOptions`: `output_schema`, `signal`
+
+## Cancellation
+
+```python
+import threading
+
+from codex import Codex, TurnOptions
+
+cancel = threading.Event()
+
+client = Codex()
+thread = client.start_thread()
+stream = thread.run_streamed("Long running task", TurnOptions(signal=cancel))
+
+cancel.set()
+for event in stream.events:
+    print(event)
+```
 
 ## Bundled binary behavior
 

codex/__init__.py

@@ -26,7 +26,18 @@
     TodoListItem,
     WebSearchItem,
 )
-from codex.options import ApprovalMode, CodexOptions, SandboxMode, ThreadOptions, TurnOptions
+from codex.options import (
+    ApprovalMode,
+    CancelSignal,
+    CodexConfigObject,
+    CodexConfigValue,
+    CodexOptions,
+    ModelReasoningEffort,
+    SandboxMode,
+    ThreadOptions,
+    TurnOptions,
+    WebSearchMode,
+)
 from codex.thread import Input, RunResult, RunStreamedResult, Thread, UserInput
 
 __version__ = "1.0.0"
@@ -47,6 +58,11 @@
     "TurnOptions",
     "ApprovalMode",
     "SandboxMode",
+    "ModelReasoningEffort",
+    "WebSearchMode",
+    "CodexConfigValue",
+    "CodexConfigObject",
+    "CancelSignal",
     "ThreadEvent",
     "ThreadStartedEvent",
     "TurnStartedEvent",

codex/codex.py

@@ -10,7 +10,11 @@ class Codex:
 
     def __init__(self, options: CodexOptions | None = None) -> None:
         resolved = options or CodexOptions()
-        self._exec = CodexExec(resolved.codex_path_override)
+        self._exec = CodexExec(
+            resolved.codex_path_override,
+            env_override=resolved.env,
+            config_overrides=resolved.config,
+        )
         self._options = resolved
 
     def start_thread(self, options: ThreadOptions | None = None) -> Thread: