benchflow 0.5.3.dev879__tar.gz → 0.5.3.dev881__tar.gz

{benchflow-0.5.3.dev879 → benchflow-0.5.3.dev881}/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+### Changed
+
+- Document the public vs internal preview install/upgrade command matrix,
+  including `uv tool` exact pins, internal preview upgrades, and the
+  `--force` path for replacing stale entrypoint scripts.
+
 ## 0.5.2 — 2026-06-05
 
 ### Changed

{benchflow-0.5.3.dev879 → benchflow-0.5.3.dev881}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: benchflow
-Version: 0.5.3.dev879
+Version: 0.5.3.dev881
 Summary: Multi-turn agent benchmarking with ACP — run any agent, any model, any provider.
 Project-URL: Homepage, https://github.com/benchflow-ai/benchflow
 Project-URL: Repository, https://github.com/benchflow-ai/benchflow
@@ -76,12 +76,29 @@ BenchFlow's current public release is `0.5.2`:
 pip install --upgrade benchflow
 ```
 
-For a `uv`-managed CLI install of the public release:
+For a `uv`-managed CLI install or upgrade of the public release:
 
 ```bash
-uv tool install --prerelease allow 'benchflow==0.5.2'
+uv tool install --prerelease allow --upgrade 'benchflow==0.5.2'
 ```
 
+Use the exact `benchflow==0.5.2` pin for the public CLI. The
+`--prerelease allow` flag is currently needed for BenchFlow's pinned LiteLLM
+release-candidate dependency; the exact BenchFlow pin keeps you off internal
+preview builds.
+
+Internal users who want the newest preview published from `main` should omit
+the exact public pin:
+
+```bash
+uv tool install --prerelease allow --upgrade benchflow
+```
+
+That installs the latest internal preview, such as `0.5.3.dev<N>`. If either
+command reports `Executables already exist: bench, benchflow`, the machine has
+old entrypoints from a previous install; rerun the same command with `--force`
+to let `uv` replace them.
+
 Requires Python 3.12+ and [uv](https://docs.astral.sh/uv/). Set `DAYTONA_API_KEY` for Daytona runs or configure Modal auth for Modal runs; export the relevant agent API key (`GEMINI_API_KEY`, `ANTHROPIC_API_KEY`, etc.) or run `claude login` / `codex --login` for subscription auth. Provider-prefixed models may use provider-specific credentials; Azure Foundry models use `AZURE_API_KEY` plus `AZURE_API_ENDPOINT`.
 
 ## Documentation

{benchflow-0.5.3.dev879 → benchflow-0.5.3.dev881}/README.md

@@ -26,12 +26,29 @@ BenchFlow's current public release is `0.5.2`:
 pip install --upgrade benchflow
 ```
 
-For a `uv`-managed CLI install of the public release:
+For a `uv`-managed CLI install or upgrade of the public release:
 
 ```bash
-uv tool install --prerelease allow 'benchflow==0.5.2'
+uv tool install --prerelease allow --upgrade 'benchflow==0.5.2'
 ```
 
+Use the exact `benchflow==0.5.2` pin for the public CLI. The
+`--prerelease allow` flag is currently needed for BenchFlow's pinned LiteLLM
+release-candidate dependency; the exact BenchFlow pin keeps you off internal
+preview builds.
+
+Internal users who want the newest preview published from `main` should omit
+the exact public pin:
+
+```bash
+uv tool install --prerelease allow --upgrade benchflow
+```
+
+That installs the latest internal preview, such as `0.5.3.dev<N>`. If either
+command reports `Executables already exist: bench, benchflow`, the machine has
+old entrypoints from a previous install; rerun the same command with `--force`
+to let `uv` replace them.
+
 Requires Python 3.12+ and [uv](https://docs.astral.sh/uv/). Set `DAYTONA_API_KEY` for Daytona runs or configure Modal auth for Modal runs; export the relevant agent API key (`GEMINI_API_KEY`, `ANTHROPIC_API_KEY`, etc.) or run `claude login` / `codex --login` for subscription auth. Provider-prefixed models may use provider-specific credentials; Azure Foundry models use `AZURE_API_KEY` plus `AZURE_API_ENDPOINT`.
 
 ## Documentation

{benchflow-0.5.3.dev879 → benchflow-0.5.3.dev881}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "benchflow"
-version = "0.5.3.dev879"
+version = "0.5.3.dev881"
 description = "Multi-turn agent benchmarking with ACP — run any agent, any model, any provider."
 readme = "README.md"
 requires-python = ">=3.12"