webbee 0.5.4__tar.gz → 0.5.5__tar.gz

{webbee-0.5.4 → webbee-0.5.5}/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.5.5
+
+* **Installs on Python 3.10 again**: pip and pipx stopped with "conflicting dependencies / ResolutionImpossible"
+  because imperal-mcp up to 0.5.6 required Python 3.11 -- Ubuntu 22.04 and Pop!_OS 22.04 ship 3.10. webbee now
+  needs imperal-mcp >= 0.5.7, which runs on 3.10.
+* **`/exit` no longer hangs on Python 3.10**: the steer poller asked `Task.cancelling()` (3.11+) whether a
+  turn had swallowed its cancel; on 3.10 the call failed, the poller kept looping and the terminal never
+  closed. A submitted turn now runs as its own task the poller waits on, so the cancel always reaches the
+  poller -- one path for every Python.
+* **Python 3.10 is the stated floor** (was 3.9, which no dependency set could satisfy): an older Python now gets
+  pip's plain "requires a different Python" instead of a dependency conflict.
+* **README installs through uv first** (it brings its own Python) and lists the install errors people hit.
+
 ## 0.5.4
 
 * **Code search by meaning for repos synced before**: imperal-sdk >= 6.3.6 tells the code map this client

{webbee-0.5.4 → webbee-0.5.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: webbee
-Version: 0.5.4
+Version: 0.5.5
 Summary: Webbee 🐝 — the Imperal Cloud coding agent in your terminal
 Project-URL: Homepage, https://imperal.io
 Project-URL: Documentation, https://docs.imperal.io
@@ -17,7 +17,6 @@ Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -25,11 +24,11 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development
 Classifier: Topic :: Utilities
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Requires-Dist: asyncssh>=2.14
 Requires-Dist: httpx-sse>=0.4
 Requires-Dist: httpx>=0.27
-Requires-Dist: imperal-mcp>=0.5.0
+Requires-Dist: imperal-mcp>=0.5.7
 Requires-Dist: imperal-sdk>=6.3.6
 Requires-Dist: model2vec>=0.8.2; sys_platform != 'darwin' or platform_machine != 'x86_64' or python_version < '3.13'
 Requires-Dist: numpy>=2; sys_platform != 'darwin' or platform_machine != 'x86_64' or python_version < '3.13'
@@ -79,21 +78,35 @@ Webbee is powered by **ICNLI** (*Infrastructure Contextual Natural Language Inte
 
 ## 📦 Installation
 
-Install easily using **pipx** (recommended) or **uv**:
+One line — installs [uv](https://docs.astral.sh/uv/) if needed, which brings its own Python:
 
 ```sh
-pipx install webbee
-# or with uv:
-uv tool install webbee
+curl -LsSf https://raw.githubusercontent.com/imperalcloud/webbee-code/main/install.sh | sh
 ```
 
-Or install in a Python virtual environment:
+Or, if you already have uv or pipx:
 
 ```sh
-python3 -m venv .venv && source .venv/bin/activate
-pip install webbee
+uv tool install webbee
+# or:
+pipx install webbee
 ```
 
+Webbee needs **Python 3.10 or newer**. `uv` fetches a suitable Python by itself, so it works even where
+the system Python is older (macOS ships 3.9).
+
+<details>
+<summary>Install problems</summary>
+
+| You see | Why | Do |
+|---------|-----|----|
+| `Cannot install webbee==… because these package versions have conflicting dependencies` / `ResolutionImpossible` | pip/pipx runs on a Python older than 3.10 (or webbee < 0.5.5 on Python 3.10) | `uv tool install webbee`, or `pipx install --python python3.12 webbee` |
+| `No matching distribution found for webbee` | Python older than 3.10 | same as above |
+| `error: externally-managed-environment` | `pip install` into the system Python is blocked on Homebrew, Debian 12+, Ubuntu 23.04+ | `uv tool install webbee` or `pipx install webbee` |
+| `webbee: command not found` after install | the tool folder is not on `PATH` | `uv tool update-shell` (or `pipx ensurepath`), then open a new terminal |
+
+</details>
+
 ---
 
 ## 💡 Quick Start

{webbee-0.5.4 → webbee-0.5.5}/README.md

@@ -27,21 +27,35 @@ Webbee is powered by **ICNLI** (*Infrastructure Contextual Natural Language Inte
 
 ## 📦 Installation
 
-Install easily using **pipx** (recommended) or **uv**:
+One line — installs [uv](https://docs.astral.sh/uv/) if needed, which brings its own Python:
 
 ```sh
-pipx install webbee
-# or with uv:
-uv tool install webbee
+curl -LsSf https://raw.githubusercontent.com/imperalcloud/webbee-code/main/install.sh | sh
 ```
 
-Or install in a Python virtual environment:
+Or, if you already have uv or pipx:
 
 ```sh
-python3 -m venv .venv && source .venv/bin/activate
-pip install webbee
+uv tool install webbee
+# or:
+pipx install webbee
 ```
 
+Webbee needs **Python 3.10 or newer**. `uv` fetches a suitable Python by itself, so it works even where
+the system Python is older (macOS ships 3.9).
+
+<details>
+<summary>Install problems</summary>
+
+| You see | Why | Do |
+|---------|-----|----|
+| `Cannot install webbee==… because these package versions have conflicting dependencies` / `ResolutionImpossible` | pip/pipx runs on a Python older than 3.10 (or webbee < 0.5.5 on Python 3.10) | `uv tool install webbee`, or `pipx install --python python3.12 webbee` |
+| `No matching distribution found for webbee` | Python older than 3.10 | same as above |
+| `error: externally-managed-environment` | `pip install` into the system Python is blocked on Homebrew, Debian 12+, Ubuntu 23.04+ | `uv tool install webbee` or `pipx install webbee` |
+| `webbee: command not found` after install | the tool folder is not on `PATH` | `uv tool update-shell` (or `pipx ensurepath`), then open a new terminal |
+
+</details>
+
 ---
 
 ## 💡 Quick Start

{webbee-0.5.4 → webbee-0.5.5}/pyproject.toml

@@ -1,14 +1,14 @@
 [project]
 name = "webbee"
-version = "0.5.4"
+version = "0.5.5"
 description = "Webbee 🐝 — the Imperal Cloud coding agent in your terminal"
 readme = "README.md"
 license = "GPL-3.0-or-later"
 license-files = ["LICENSE"]
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 authors = [{ name = "Valentin Scerbacov", email = "valentin@imperal.io" }, { name = "Imperal, Inc." }]
 dependencies = [
-    "imperal-mcp>=0.5.0",
+    "imperal-mcp>=0.5.7",
     "imperal-sdk>=6.3.6",
     "asyncssh>=2.14",
     "httpx>=0.27",
@@ -42,7 +42,6 @@ classifiers = [
     "Environment :: Console",
     "Intended Audience :: Developers",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",

webbee-0.5.5/src/webbee/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.5.5"

{webbee-0.5.4 → webbee-0.5.5}/src/webbee/steer.py

@@ -75,13 +75,22 @@ def _consume_mode(payload, on_mode) -> bool:
     return True
 
 
-def _cancel_absorbed() -> bool:
-    """True when this task received a cancel that a submitted turn swallowed
-    (repl._run_turn treats CancelledError as a user interrupt). Without this
-    check the poller would sail past its own cancellation and asyncio.run's
-    shutdown would hang on a task that ignored it."""
-    task = asyncio.current_task()
-    return task is not None and task.cancelling() > 0
+async def _await_turn(coro) -> None:
+    """Run a submitted turn and wait for it, letting a cancel of THIS task end the
+    poller even when the turn swallows CancelledError (repl._run_turn treats it as
+    a user interrupt). The turn runs as its own task and the poller only waits on
+    it, so the cancel lands in the poller's wait, never inside the turn: without
+    that the poller would sail past its own cancellation and asyncio.run's
+    shutdown would hang on a task that ignored it. Works on every Python
+    (Task.cancelling() would need 3.11)."""
+    turn = asyncio.ensure_future(coro)
+    try:
+        await asyncio.wait({turn})
+    except asyncio.CancelledError:
+        turn.cancel()                    # the turn ends as a user interrupt would
+        await asyncio.wait({turn})
+        raise
+    turn.result()                        # a turn's own error reaches the poller as before
 
 
 async def poll_idle_steer(cfg, token_provider, *, workspace: str, is_busy,
@@ -251,9 +260,7 @@ async def poll_idle_steer(cfg, token_provider, *, workspace: str, is_busy,
                     if is_busy():
                         continue
                     last_active = now()  # an attach pickup = activity
-                    await attach_turn(attach)
-                    if _cancel_absorbed():
-                        raise asyncio.CancelledError
+                    await _await_turn(attach_turn(attach))
                     failures = 0
                     continue
             if not backlog:
@@ -266,10 +273,8 @@ async def poll_idle_steer(cfg, token_provider, *, workspace: str, is_busy,
                 backlog.appendleft(item)  # a local line won the race -- defer, don't drop
                 continue
             last_active = now()          # an item arrived = activity
-            await submit(text, str(item.get("surface") or "telegram"),
-                         str(item.get("iid") or ""))
-            if _cancel_absorbed():
-                raise asyncio.CancelledError
+            await _await_turn(submit(text, str(item.get("surface") or "telegram"),
+                                     str(item.get("iid") or "")))
         except asyncio.CancelledError:
             raise
         except Exception:

{webbee-0.5.4 → webbee-0.5.5}/tests/test_packaging.py

@@ -1,6 +1,10 @@
-import tomllib
 import pathlib
 
+import pytest
+
+# tomllib is 3.11+; on 3.10 these checks run where the release is built
+tomllib = pytest.importorskip("tomllib")
+
 ROOT = pathlib.Path(__file__).resolve().parent.parent
 
 

{webbee-0.5.4 → webbee-0.5.5}/tests/test_version.py

@@ -7,8 +7,10 @@ def test_version_is_semver():
 
 
 def test_version_matches_pyproject():
-    import tomllib
     import pathlib
+
+    import pytest
+    tomllib = pytest.importorskip("tomllib")   # 3.11+; the release build runs it
     root = pathlib.Path(__file__).resolve().parent.parent
     data = tomllib.loads((root / "pyproject.toml").read_text())
     assert data["project"]["version"] == webbee.__version__

webbee-0.5.4/src/webbee/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.5.4"