chore(python): rename PyPI distribution to agent-eval-rpc (#41)

drewstone · web-flow · commit ac0c593e0aca · 2026-05-08T19:36:00.000+02:00
The Python client renames from `tangle-agent-eval` to `agent-eval-rpc`, and the import path from `tangle_agent_eval` to `agent_eval_rpc`. Two reasons: 1. Accuracy. The package is a thin RPC client over the Node runtime — not a Python re-implementation of the eval logic. `-rpc` says that plainly; `tangle-` was substituting for an npm-style scope and added no information beyond the npm scope itself (`@tangle-network/...`) already provides. 2. No prior shipped PyPI version exists under the old name (Trusted Publisher misconfiguration; see issue #40), so this is a clean first publish, not a migration. Zero existing consumers, zero deprecation flow needed. Mechanical: - clients/python/pyproject.toml: name + description + wheel package path updated. - clients/python/src/tangle_agent_eval/ → clients/python/src/agent_eval_rpc/ via `git mv` so file history is preserved. - clients/python/src/agent_eval_rpc/__init__.py: docstring + version() distribution-name lookup point at the new name. - clients/python/tests/test_models.py + test_subprocess.py: import paths updated. - clients/python/README.md: title + import examples + version-lock copy. - .github/workflows/publish.yml: __init__.py path + PyPI URL pre-check + skip message. - docs/wire-protocol.md: cross-reference to the python client path. - CHANGELOG.md: 0.21.0 Python-client section explains the rename and points at issue #40. Verification: - `pnpm typecheck` clean. - `pnpm test` — 867 / 867 still passing (no TS impact). - `pip install -e clients/python && pytest` — 11 / 11 passing under the new import path. Issue #40 needs its PyPI Trusted Publisher claims updated to reference the new project name (agent-eval-rpc instead of tangle-agent-eval); the GitHub-side claims (owner=tangle-network, repo=agent-eval, workflow= publish.yml) stay the same because the OIDC subject is the GitHub identity, not the PyPI project.
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
@@ -42,7 +42,7 @@ jobs:
         run: |
           NPM_VERSION=$(node -p "require('./package.json').version")
           PY_VERSION=$(grep -E '^version' clients/python/pyproject.toml | head -1 | sed -E 's/.*"([^"]+)".*/\1/')
-          PY_RUNTIME_VERSION=$(python -c "import pathlib,re; text=pathlib.Path('clients/python/src/tangle_agent_eval/__init__.py').read_text(); match=re.search(r'__version__ = \"([^\"]+)\"', text); print(match.group(1) if match else '')")
+          PY_RUNTIME_VERSION=$(python -c "import pathlib,re; text=pathlib.Path('clients/python/src/agent_eval_rpc/__init__.py').read_text(); match=re.search(r'__version__ = \"([^\"]+)\"', text); print(match.group(1) if match else '')")
           if [ "$NPM_VERSION" != "$PY_VERSION" ]; then
             echo "::error::Version mismatch: npm=$NPM_VERSION pypi=$PY_VERSION. Bump them together."
             exit 1
@@ -144,8 +144,8 @@ jobs:
         id: pypi-check
         run: |
           VERSION=$(grep -E '^version' clients/python/pyproject.toml | head -1 | sed -E 's/.*"([^"]+)".*/\1/')
-          if curl -sf "https://pypi.org/pypi/tangle-agent-eval/$VERSION/json" >/dev/null; then
-            echo "tangle-agent-eval==$VERSION already on PyPI; skipping publish"
+          if curl -sf "https://pypi.org/pypi/agent-eval-rpc/$VERSION/json" >/dev/null; then
+            echo "agent-eval-rpc==$VERSION already on PyPI; skipping publish"
             echo "skip=true" >> "$GITHUB_OUTPUT"
           else
             echo "skip=false" >> "$GITHUB_OUTPUT"
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -74,7 +74,9 @@ surface.
 
 ### Python client
 
-Locked at `tangle-agent-eval==0.21.0` to match the npm package.
+The PyPI distribution renamed from `tangle-agent-eval` to **`agent-eval-rpc`**, and the import path from `tangle_agent_eval` to `agent_eval_rpc`. The new name accurately describes the package — it is a thin RPC client over the Node runtime, not a Python re-implementation of the eval logic — and the npm scope (`@tangle-network/agent-eval`) already provides the namespacing the `tangle-` prefix was substituting for. No prior PyPI version ever shipped under the old name (Trusted Publisher misconfiguration; see issue #40), so this rename is a clean first publish rather than a migration.
+
+Locked at `agent-eval-rpc==0.21.0` to match the npm package.
 
 ## 0.20.10 — hardening audit follow-up
 
diff --git a/clients/python/README.md b/clients/python/README.md
@@ -1,4 +1,4 @@
-# tangle-agent-eval — Python client
+# agent-eval-rpc — Python client
 
 Python client for [`@tangle-network/agent-eval`](https://github.com/tangle-network/agent-eval) — a content/code judging framework written in TypeScript. This package is a **thin transport adapter**: every judgement runs in the Node runtime, marshalled over HTTP or stdio RPC. Two languages, one implementation. No drift.
 
@@ -7,7 +7,7 @@ Python client for [`@tangle-network/agent-eval`](https://github.com/tangle-netwo
 A function-call interface to score any string against a rubric:
 
 ```python
-from tangle_agent_eval import Client
+from agent_eval_rpc import Client
 
 client = Client()  # auto-detects HTTP server, falls back to subprocess
 result = client.judge(
@@ -111,7 +111,7 @@ assert v.wire_version == "1.0.0"
 Built-in `anti-slop` is tuned for technical-buyer audiences. For different scoring, pass a `Rubric` inline:
 
 ```python
-from tangle_agent_eval import Client, Rubric, RubricDimension, FailureMode
+from agent_eval_rpc import Client, Rubric, RubricDimension, FailureMode
 
 rubric = Rubric(
     name="my-rubric",
@@ -141,7 +141,7 @@ All errors carry `.code` and `.details` (the structured payload from the server)
 
 ## Versioning
 
-This package is **version-locked** to the npm package. `tangle-agent-eval==0.20.10` ↔ `@tangle-network/agent-eval@0.20.10`. CI verifies the npm package, Python package, runtime `__version__`, and release tag all agree before publish. If one registry publish fails after the other succeeds, retry the failed publish from the same tag or supersede with the next patch release.
+This package is **version-locked** to the npm package. `agent-eval-rpc==0.21.0` ↔ `@tangle-network/agent-eval@0.21.0`. CI verifies the npm package, Python package, runtime `__version__`, and release tag all agree before publish. If one registry publish fails after the other succeeds, retry the failed publish from the same tag or supersede with the next patch release.
 
 `wire_version` is separate. It bumps only on breaking schema changes. Package versions can differ across releases as long as `wire_version` is the same.
 
diff --git a/clients/python/pyproject.toml b/clients/python/pyproject.toml
@@ -3,9 +3,9 @@ requires = ["hatchling>=1.21"]
 build-backend = "hatchling.build"
 
 [project]
-name = "tangle-agent-eval"
+name = "agent-eval-rpc"
 version = "0.21.0"
-description = "Python client for @tangle-network/agent-eval — judge content against rubrics over HTTP or stdio RPC."
+description = "Python RPC client for @tangle-network/agent-eval — judge content against rubrics over HTTP or stdio RPC. Eval logic runs in the Node runtime; this package is a thin wire client."
 readme = "README.md"
 requires-python = ">=3.10"
 license = { text = "MIT" }
@@ -40,7 +40,7 @@ Issues = "https://github.com/tangle-network/agent-eval/issues"
 Documentation = "https://github.com/tangle-network/agent-eval/blob/main/clients/python/README.md"
 
 [tool.hatch.build.targets.wheel]
-packages = ["src/tangle_agent_eval"]
+packages = ["src/agent_eval_rpc"]
 
 [tool.ruff]
 line-length = 100
diff --git a/clients/python/src/agent_eval_rpc/__init__.py b/clients/python/src/agent_eval_rpc/__init__.py
@@ -1,14 +1,18 @@
-"""tangle-agent-eval — Python client for @tangle-network/agent-eval.
+"""agent-eval-rpc — Python RPC client for @tangle-network/agent-eval.
 
 The TypeScript package is the source of truth for evaluation logic. This
 client is a thin transport adapter — every judgement runs in the Node
 runtime, marshalled over HTTP or stdio RPC. Two languages, one
 implementation.
 
+The package distributes as ``agent-eval-rpc`` on PyPI and imports as
+``agent_eval_rpc`` to make the wire-client nature explicit; the rubric
+logic lives upstream in ``@tangle-network/agent-eval`` on npm.
+
 Quickstart
 ----------
 
-    from tangle_agent_eval import Client
+    from agent_eval_rpc import Client
 
     client = Client()  # auto-detects HTTP server, falls back to subprocess
     result = client.judge(content="our scaffold supports zero-copy IO", rubric_name="anti-slop")
@@ -42,7 +46,7 @@
 )
 
 try:
-    __version__ = version("tangle-agent-eval")
+    __version__ = version("agent-eval-rpc")
 except PackageNotFoundError:
     __version__ = "0.21.0"
 
diff --git a/clients/python/src/agent_eval_rpc/client.py b/clients/python/src/agent_eval_rpc/client.py
diff --git a/clients/python/src/agent_eval_rpc/errors.py b/clients/python/src/agent_eval_rpc/errors.py
diff --git a/clients/python/src/agent_eval_rpc/models.py b/clients/python/src/agent_eval_rpc/models.py
diff --git a/clients/python/tests/test_models.py b/clients/python/tests/test_models.py
@@ -8,7 +8,7 @@
 
 import pytest
 
-from tangle_agent_eval.models import JudgeRequest, Rubric, RubricDimension
+from agent_eval_rpc.models import JudgeRequest, Rubric, RubricDimension
 
 
 MIN_RUBRIC = Rubric(
diff --git a/clients/python/tests/test_subprocess.py b/clients/python/tests/test_subprocess.py
@@ -17,7 +17,7 @@
 
 import pytest
 
-from tangle_agent_eval import Client, RubricNotFoundError, ValidationError
+from agent_eval_rpc import Client, RubricNotFoundError, ValidationError
 
 REPO_ROOT = Path(__file__).resolve().parents[3]
 CLI_DIST = REPO_ROOT / "dist" / "cli.js"
@@ -48,7 +48,7 @@ def _subprocess_call(self, method: str, params):  # type: ignore[override]
                 raise RuntimeError(f"no stdout. stderr: {proc.stderr}")
             envelope = json.loads(proc.stdout.strip().splitlines()[-1])
             if "error" in envelope:
-                from tangle_agent_eval.errors import from_error_body
+                from agent_eval_rpc.errors import from_error_body
                 raise from_error_body(proc.returncode or 500, envelope)
             return envelope["result"]
 
diff --git a/docs/wire-protocol.md b/docs/wire-protocol.md
@@ -188,7 +188,7 @@ Each invocation is one process — Node startup adds ~500 ms. For more than a fe
 4. **RPC case** — add `case 'x':` in `dispatchRpc` in `src/wire/rpc.ts`.
 5. **OpenAPI route** — register in `src/wire/openapi.ts` so it shows up in the spec.
 6. **Test** — add to `tests/wire/`. At minimum: schema validation, happy-path, error-path.
-7. **Python client** — add a method on `Client` in `clients/python/src/tangle_agent_eval/client.py`, plus pydantic models in `models.py` mirroring the new schemas.
+7. **Python client** — add a method on `Client` in `clients/python/src/agent_eval_rpc/client.py`, plus pydantic models in `models.py` mirroring the new schemas.
 
 The pattern is mechanical. When the surface grows past ~10 methods, swap the hand-written Python models for `datamodel-code-generator -i openapi.json -o models.py`.
 
