Fix abi3 wheel publish workflow; release 1.2.26

Author: larock22

.github/workflows/publish-pypi.yml

@@ -11,17 +11,10 @@ permissions:
 
 jobs:
   build-linux:
-    name: Build Linux wheels (${{ matrix.python-tag }})
+    name: Build Linux wheel
     runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        python-tag:
-          - cp310-cp310
-          - cp311-cp311
-          - cp312-cp312
     env:
-      PYTHON_TAG: ${{ matrix.python-tag }}
+      PYTHON_TAG: cp310-cp310
     steps:
       - name: Check out repository
         uses: actions/checkout@v4
@@ -65,28 +58,21 @@ jobs:
       - name: Upload wheel artifact
         uses: actions/upload-artifact@v4
         with:
-          name: wheels-linux-${{ matrix.python-tag }}
+          name: wheels-linux
           path: wheelhouse/*.whl
           if-no-files-found: error
 
   build-macos:
-    name: Build macOS wheels (py${{ matrix.python }})
+    name: Build macOS wheel
     runs-on: macos-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        python:
-          - "3.10"
-          - "3.11"
-          - "3.12"
     steps:
       - name: Check out repository
         uses: actions/checkout@v4
 
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
-          python-version: ${{ matrix.python }}
+          python-version: "3.10"
 
       - name: Set up Rust
         uses: dtolnay/rust-toolchain@stable
@@ -131,28 +117,21 @@ jobs:
       - name: Upload wheel artifact
         uses: actions/upload-artifact@v4
         with:
-          name: wheels-macos-py${{ matrix.python }}
+          name: wheels-macos
           path: dist/*.whl
           if-no-files-found: error
 
   build-windows:
-    name: Build Windows wheels (py${{ matrix.python }})
+    name: Build Windows wheel
     runs-on: windows-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        python:
-          - "3.10"
-          - "3.11"
-          - "3.12"
     steps:
       - name: Check out repository
         uses: actions/checkout@v4
 
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
-          python-version: ${{ matrix.python }}
+          python-version: "3.10"
 
       - name: Set up Rust
         uses: dtolnay/rust-toolchain@stable
@@ -162,18 +141,6 @@ jobs:
           python -m pip install --upgrade pip
           python -m pip install build tomli
 
-      - name: Pin Strawberry Perl for vendored OpenSSL
-        shell: pwsh
-        run: |
-          $perl = 'C:\Strawberry\perl\bin\perl.exe'
-          if (Test-Path $perl) {
-            "OPENSSL_SRC_PERL=$perl" | Out-File -FilePath $env:GITHUB_ENV -Encoding utf8 -Append
-            "PERL=$perl" | Out-File -FilePath $env:GITHUB_ENV -Encoding utf8 -Append
-            & $perl -e "print $^X"
-          } else {
-            throw 'Strawberry Perl not found at C:\Strawberry\perl\bin\perl.exe'
-          }
-
       - name: Build and stage the binding
         shell: pwsh
         run: |
@@ -204,7 +171,7 @@ jobs:
       - name: Upload wheel artifact
         uses: actions/upload-artifact@v4
         with:
-          name: wheels-windows-py${{ matrix.python }}
+          name: wheels-windows
           path: dist/*.whl
           if-no-files-found: error
 
@@ -223,9 +190,21 @@ jobs:
           pattern: wheels-*
           merge-multiple: true
 
+      - name: Verify publish payload
+        run: |
+          python3 - <<'PY'
+          from pathlib import Path
+
+          wheels = sorted(Path("dist").glob("*.whl"))
+          print("wheels:", [wheel.name for wheel in wheels])
+          if len(wheels) != 3:
+            raise SystemExit(f"expected exactly 3 platform wheels, found {len(wheels)}")
+          PY
+
       - name: Publish distributions
         uses: pypa/gh-action-pypi-publish@release/v1
         with:
           packages-dir: dist/
           password: ${{ secrets.PYPI_TOKEN }}
+          skip-existing: true
           user: __token__

CHANGELOG.md

@@ -9,6 +9,13 @@ This project uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ### Added
 
+## [1.2.26] - 2026-03-24
+
+### Fixed
+- Fixed the PyPI release workflow to build exactly one Python 3.10 `cp310-abi3` wheel per platform, eliminating duplicate wheel filenames with different binary contents from the old per-version matrix.
+- Made the PyPI publish step rerunnable by skipping files that already exist, which prevents partial uploads from blocking a release retry.
+- Updated the package metadata and release docs to describe the restored in-repo Rust binding instead of the retired external-binding flow.
+
 ## [1.2.25] - 2026-03-24
 
 ### Fixed

docs/README.md

@@ -8,8 +8,8 @@ Inspired by [smolagents](https://github.com/huggingface/smolagents) and [Pi](htt
 
 > **Beta** — TinyAgent is usable but not production-ready. APIs may change between minor versions.
 
-> **Note:** The optional `tinyagent._alchemy` binding now lives in
-> `https://github.com/tunahorse/tinyagent-alchemy` and is not built from this repo.
+> **Note:** The optional `tinyagent._alchemy` binding is built from the in-repo
+> Rust crate and shipped in supported PyPI wheels.
 
 ## Overview
 
@@ -20,14 +20,14 @@ TinyAgent provides a lightweight foundation for creating conversational AI agent
 - **Event-driven**: Subscribe to agent events for real-time UI updates
 - **Provider agnostic**: Works with any OpenAI-compatible `/chat/completions` endpoint (OpenRouter, OpenAI, Chutes, local servers)
 - **Prompt caching**: Reduce token costs and latency with Anthropic-style cache breakpoints
-- **Provider paths**: Optional external alchemy binding adapter plus proxy integration
+- **Provider paths**: Optional in-repo alchemy binding plus proxy integration
 - **Type-safe**: Full type hints throughout
 
 ## Quick Start
 
 This example uses the optional `tinyagent._alchemy` binding via
-`tinyagent.alchemy_provider`. Install that binding from the external repo first,
-or use the proxy path instead.
+`tinyagent.alchemy_provider`. Install a wheel that includes the binding for your
+platform, or use the proxy path instead.
 
 ```python
 import asyncio
@@ -72,8 +72,8 @@ Optional binding:
 
 - PyPI wheels may include the compiled `tinyagent._alchemy` extension for supported platforms,
   but the source distribution does not.
-- Install/build `tinyagent._alchemy` from `https://github.com/tunahorse/tinyagent-alchemy`
-  if you want `stream_alchemy_openai_completions` and no matching wheel is available.
+- Build `tinyagent._alchemy` from the in-repo `rust/` crate if you want
+  `stream_alchemy_openai_completions` and no matching wheel is available.
 - Otherwise, use the proxy path in `tinyagent.proxy`.
 
 ## Core Concepts
@@ -161,15 +161,11 @@ Cache breakpoints are automatically placed on user message content blocks so the
 
 ## Optional Binding: `tinyagent._alchemy`
 
-This repo keeps `tinyagent/alchemy_provider.py` as a compatibility adapter for the
-optional external `tinyagent._alchemy` extension. The binding source, build
-instructions, and low-level binding API now live in:
+This repo keeps `tinyagent/alchemy_provider.py` as the Python adapter for the
+optional `tinyagent._alchemy` extension built from the in-repo `rust/` crate.
 
-- `https://github.com/tunahorse/tinyagent-alchemy`
-
-The compiled path is still useful when you want OpenAI-compatible streaming
-without routing through a separate proxy, but it is no longer bundled or built
-from this repository.
+The compiled path is useful when you want OpenAI-compatible streaming without
+routing through a separate proxy.
 
 ### Using via TinyAgent
 
@@ -218,7 +214,7 @@ agent.set_model(
 )
 ```
 
-Smoke validation after installing the external binding:
+Smoke validation after installing a wheel with the binding:
 
 - `uv run python scripts/smoke_rust_tool_calls_three_providers.py`
 
@@ -252,7 +248,7 @@ tinyagent/
 ├── agent_tool_execution.py  # Tool execution helpers
 ├── agent_types.py        # Type definitions
 ├── caching.py            # Prompt caching utilities
-├── alchemy_provider.py   # Adapter for the optional external binding
+├── alchemy_provider.py   # Adapter for the optional Rust binding
 ├── proxy.py              # Proxy server integration
 └── proxy_event_handlers.py  # Proxy event parsing
 ```

docs/releasing-alchemy-binding.md

@@ -52,7 +52,7 @@ platform wheels.
 - `HARNESS.md`
   - records the release gate for wheels expected to ship `_alchemy`
 - `.github/workflows/publish-pypi.yml`
-  - builds Linux (manylinux), macOS, and Windows release wheels from the in-repo binding
+  - builds one Python 3.10 `abi3` wheel per platform from the in-repo binding
   - repairs Linux wheels into PyPI-acceptable `manylinux` artifacts before upload
   - smoke-tests each built wheel in a clean virtualenv before publishing
   - publishes the built distributions to PyPI with the repo `PYPI_TOKEN` secret
@@ -150,6 +150,7 @@ On GitHub release publish or manual dispatch, it:
 
 - checks out this repo
 - builds the in-repo binding on `ubuntu-latest` (manylinux), `macos-latest`, and `windows-latest`
+- uses Python 3.10 once per platform so the `cp310-abi3` wheel filename is unique and stable
 - stages the binding into `tinyagent/`
 - runs `python3 scripts/check_release_binding.py --require-present`
 - builds the `tiny-agent-os` wheel
@@ -227,7 +228,7 @@ This keeps the release contract simple:
 
 The release contract is now:
 
-1. build `_alchemy` from the external binding repo
+1. build `_alchemy` from the in-repo `rust/` crate
 2. copy it into `tinyagent/`
 3. run `python3 scripts/check_release_binding.py --require-present`
 4. build the wheel with `uv build --wheel`

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tiny-agent-os"
-version = "1.2.25"
+version = "1.2.26"
 description = "Python agent loop"
 readme = "README.md"
 requires-python = ">=3.10"

tinyagent/alchemy_provider.py

@@ -1,9 +1,7 @@
-"""Compatibility provider for the optional tinyagent-alchemy binding.
+"""Compatibility provider for the optional tinyagent._alchemy binding.
 
-This module keeps the Python-side adapter for the external `tinyagent._alchemy`
-extension. The binding itself is maintained outside this repo:
-
-    https://github.com/tunahorse/tinyagent-alchemy
+This module keeps the Python-side adapter for the in-repo `tinyagent._alchemy`
+extension built from `rust/`.
 
 Important limitations:
 - The binding currently dispatches only `openai-completions` and
@@ -132,9 +130,8 @@ def _get_alchemy_module() -> _AlchemyModule:
             )
             raise RuntimeError(
                 "Failed to import the optional alchemy binding. "
-                "Install the optional binding from "
-                "https://github.com/tunahorse/tinyagent-alchemy if it is not "
-                "already installed. "
+                "Install a wheel that includes tinyagent._alchemy or build the "
+                "binding from the in-repo rust crate if it is not already installed. "
                 f"Import failures: {import_failures}"
             ) from cause
     return _ALCHEMY_MODULE