chore: add .githooks/pre-commit (ruff + mypy); annotate start_exec_stream return type; make lint passes

Author: gersmann

.githooks/pre-commit

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+echo "Running ruff format --check..."
+uv run --group dev ruff format --check .
+
+echo "Running ruff check..."
+uv run --group dev ruff check .
+
+echo "Running mypy..."
+uv run --group dev mypy codex
+
+echo "Pre-commit checks passed."
+

.github/workflows/native-wheels.yml

@@ -0,0 +1,67 @@
+name: Build Native Wheels (codex-native)
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch: {}
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-14, windows-latest]
+        python-version: ['3.13']
+    runs-on: ${{ matrix.os }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Fetch upstream codex repo (public)
+        shell: bash
+        run: |
+          # Adjust the repo/ref here if you want to pin to a tag or fork
+          git clone --depth 1 https://github.com/openai/codex codex-proj
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install maturin
+        run: |
+          python -m pip install --upgrade pip
+          pip install maturin
+
+      - name: Build wheels with maturin
+        env:
+          PYO3_USE_ABI3_FORWARD_COMPATIBILITY: '1'
+        run: |
+          maturin build -m crates/codex_native/Cargo.toml --release --interpreter python
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.os }}-${{ matrix.python-version }}
+          path: crates/codex_native/target/wheels/*.whl
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Download all wheels
+        uses: actions/download-artifact@v4
+        with:
+          path: dist
+
+      - name: Publish to PyPI (Trusted Publishing)
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist
+          skip-existing: true
+

codex/native.py

@@ -1,3 +1,5 @@
+from typing import Any
+
 try:
     from codex_native import run_exec_collect as _run_exec_collect
     from codex_native import start_exec_stream as _start_exec_stream
@@ -23,7 +25,7 @@ def run_exec_collect(
 
 def start_exec_stream(
     prompt: str, *, model: str | None = None, full_auto: bool = False, cd: str | None = None
-):
+) -> Any:
     """Return a native streaming iterator over Codex events (dicts)."""
     if _start_exec_stream is None:
         raise RuntimeError(