From 4c26913f696243b2ddce5d11a9024afd6d5ea6a7 Mon Sep 17 00:00:00 2001 From: Bryant Date: Thu, 9 Jul 2026 12:40:41 +0800 Subject: [PATCH 1/4] =?UTF-8?q?=F0=9F=90=9B=20(core):=20Add=20--pre=20to?= =?UTF-8?q?=20SDK-emitted=20runtime=20install=20hints?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit All live PyPI releases are pre-release (0.0.2 yanked), so the bare pip install shown on runtime-not-found fails to resolve. Add --pre to the runtime.py and _install.py hint strings, keeping the [runtime] extra. Drop --pre once a stable release is published. Refs AAASM-4338, completes AAASM-4332. --- agent_assembly/_install.py | 2 +- agent_assembly/runtime.py | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/agent_assembly/_install.py b/agent_assembly/_install.py index 62205d8..300b658 100644 --- a/agent_assembly/_install.py +++ b/agent_assembly/_install.py @@ -30,7 +30,7 @@ INSTALL_HINT = ( "agent-assembly runtime binary `aasm` was not found.\n" - " Install the platform wheel: pip install agent-assembly[runtime]\n" + " Install the platform wheel: pip install --pre agent-assembly[runtime]\n" " Or install manually: brew install ai-agent-assembly/tap/aasm\n" " curl -fsSL https://agent-assembly.com/install.sh | sh" ) diff --git a/agent_assembly/runtime.py b/agent_assembly/runtime.py index 8aa4d64..39dde86 100644 --- a/agent_assembly/runtime.py +++ b/agent_assembly/runtime.py @@ -37,7 +37,7 @@ INSTALL_HINT = ( "agent-assembly runtime not found.\n" - " Install with: pip install agent-assembly[runtime]\n" + " Install with: pip install --pre agent-assembly[runtime]\n" " Or manually: brew install ai-agent-assembly/tap/aasm\n" " curl -fsSL https://agent-assembly.com/install.sh | sh" ) From 1e76ba4b249c1e79a8e05768d8fc88058277c379 Mon Sep 17 00:00:00 2001 From: Bryant Date: Thu, 9 Jul 2026 12:41:52 +0800 Subject: [PATCH 2/4] =?UTF-8?q?=F0=9F=93=9D=20(readme):=20Add=20prerelease?= =?UTF-8?q?=20handling=20to=20uv=20add?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit uv refuses to resolve pre-releases without an opt-in, so 'uv add agent-assembly' fails while the SDK is pre-release only. Use --prerelease=allow and add a note mirroring the existing --pre note (drop once a stable release exists). refs AAASM-4338 --- README.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index f4e7bb2..092536c 100644 --- a/README.md +++ b/README.md @@ -99,9 +99,14 @@ is the pure-Python client and expects an `aasm` runtime to be reachable some oth With [`uv`](https://docs.astral.sh/uv/): ```bash -uv add agent-assembly +uv add --prerelease=allow agent-assembly ``` +> **`--prerelease=allow` is required for now.** Unlike `pip`, `uv` refuses to +> resolve pre-releases unless you opt in. Agent Assembly is currently published only +> as a pre-release on PyPI, so `uv add agent-assembly` fails to resolve without it. +> Drop the flag once a stable (non-pre-release) version is published. + To track unreleased changes, install from the `master` branch: ```bash From 4a273f6e51d8f4fe22617678666e53b3b2dab5ed Mon Sep 17 00:00:00 2001 From: Bryant Date: Thu, 9 Jul 2026 12:42:00 +0800 Subject: [PATCH 3/4] =?UTF-8?q?=F0=9F=93=9D=20(docs):=20Add=20--prerelease?= =?UTF-8?q?=3Dallow=20to=20install=5Fuv=20macro=20snippet?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The install_uv docs macro still emitted a bare 'uv add agent-assembly' while install_pip/install_pip_runtime already carry --pre. Align it so rendered docs resolve on a clean pre-release environment. refs AAASM-4338 --- docs_macros.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs_macros.py b/docs_macros.py index 9cfe3b6..9c451c9 100644 --- a/docs_macros.py +++ b/docs_macros.py @@ -60,7 +60,7 @@ def define_env(env: Any) -> None: "pypi": "https://pypi.org/project/agent-assembly/", }, "commands": { - "install_uv": "uv add agent-assembly", + "install_uv": "uv add --prerelease=allow agent-assembly", "install_pip": "pip install --pre agent-assembly", "install_pip_runtime": "pip install --pre 'agent-assembly[runtime]'", }, From ab2b576947c6a9ce4ef7183e2657bcb21d785b70 Mon Sep 17 00:00:00 2001 From: Bryant Date: Thu, 9 Jul 2026 21:13:05 +0800 Subject: [PATCH 4/4] =?UTF-8?q?=F0=9F=90=9B=20(core):=20Add=20--pre=20to?= =?UTF-8?q?=20gateway=5Fresolver=20runtime-install=20hint?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Completes AAASM-4338 — the ConfigurationError raised when the aasm binary is not on PATH still suggested a bare pip install, which fails on a clean pre-release environment (all live releases are pre-release, 0.0.2 yanked). Caught in review. Co-Authored-By: Claude Opus 4.8 (1M context) Claude-Session: https://claude.ai/code/session_01R7vqjjo5nrebYNt8WnCNbz --- agent_assembly/core/gateway_resolver.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/agent_assembly/core/gateway_resolver.py b/agent_assembly/core/gateway_resolver.py index 3d6ccb5..8fc1e8d 100644 --- a/agent_assembly/core/gateway_resolver.py +++ b/agent_assembly/core/gateway_resolver.py @@ -182,7 +182,7 @@ def _auto_start_gateway( if aasm_path is None: raise ConfigurationError( f"No gateway found at {base_url} and 'aasm' is not on PATH. " - "Install it with: pip install 'agent-assembly[runtime]'" + "Install it with: pip install --pre 'agent-assembly[runtime]'" ) subprocess.Popen(