browserwright 0.7.2__tar.gz → 0.7.4__tar.gz

{browserwright-0.7.2 → browserwright-0.7.4}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: browserwright
-Version: 0.7.2
+Version: 0.7.4
 Summary: Browserwright — let AI/code agents drive a real or isolated browser and author userscripts. Single package: the agent-facing REPL/site-skills/memory layer plus the bundled browser-resolving daemon (CDP proxy + extension/cloud backends).
 Requires-Python: >=3.11
-Requires-Dist: cdp-use==1.4.5
 Requires-Dist: websockets==15.0.1
 Requires-Dist: pillow==12.2.0
 Requires-Dist: httpx>=0.27
 Requires-Dist: playwright>=1.60.0
+Requires-Dist: pyyaml>=6.0.3
 Provides-Extra: ux
 Requires-Dist: rich>=13; extra == "ux"

{browserwright-0.7.2 → browserwright-0.7.4}/README.md

@@ -4,21 +4,27 @@ Let an AI/code agent drive a real (or isolated) Chrome from the terminal over CD
 
 One installable package, two CLIs that work together:
 
-- **`browserwright-daemon`** (Layer 1) — resolves a Chrome CDP WebSocket URL and proxies it. Backends: `env / rdp / extension / cloud`. Also `launch-chrome` to spawn an isolated Chrome.
+- **`browserwright-daemon`** (Layer 1) — resolves a Chrome CDP WebSocket URL and proxies it. Backends: `env / rdp / extension`. Also `launch-chrome` to spawn an isolated Chrome.
 - **`browserwright`** (Layer 2) — the agent-facing surface: sessions, heredoc scripting with pre-imported primitives, reusable site tasks, memory, and userscript management.
 
 ```
 .
 ├── src/browserwright/        the package
 │   ├── …                     Layer 2 — sessions / primitives / site skills / memory / userscripts
-│   └── daemon/               Layer 1 — CDP URL resolver + proxy (env/rdp/extension/cloud backends)
+│   └── daemon/               Layer 1 — CDP URL resolver + proxy (env/rdp/extension backends)
 ├── chrome-extension/         unpacked relay extension for the `extension` backend
 ├── skill/                    Agent skill bundle (symlinked into Claude Code, Codex, and Pi)
 ├── tests/{skill,daemon}/     test suites
-├── docs/                     deeper docs (skill.md, daemon.md, session-model.md, …)
-└── browser-connection.md     why this stack exists (CDP discovery, Chrome 144+ popups)
+└── docs/                     deeper docs (architecture.md, daemon.md, session-workspaces.md, …)
 ```
 
+Contributing or hacking on this repo? Start at **[AGENTS.md](AGENTS.md)** — it
+points to [ONBOARD.md](ONBOARD.md) (clone → install → test loop),
+[docs/architecture.md](docs/architecture.md) (architecture orientation),
+[TESTING.md](TESTING.md) (test-suite map), and [RELEASING.md](RELEASING.md)
+(releases + updating the global install). This README covers the end-user path
+only.
+
 ## Prerequisites
 
 - macOS or Linux
@@ -96,100 +102,11 @@ browserwright-daemon stop
 browserwright-daemon serve
 ```
 
-### PyPI release flow
-
-PyPI releases are driven by git tags. For published artifacts, the git tag is
-the source of truth for the package version; the release workflow rewrites
-`pyproject.toml` to that tag version before building the sdist and wheel.
-
-After a PR has landed on `main`, publish by pushing a version tag:
-
-```bash
-git checkout main
-git pull
-git tag v0.6.3
-git push origin v0.6.3
-```
-
-The GitHub Action only runs for `v*` tags. A tag like `v0.6.3` publishes package
-version `0.6.3`.
-
-Each `v*` GitHub Release also includes a
-`browserwright-extension-<version>.zip` asset. Use that zip as the official
-extension download path when installing outside PyPI or before the Chrome Web
-Store path is available.
-
-### Local development link
-
-For development only, `mise run dev-link` links the current checkout into
-global PATH and skill dirs. That is convenient for debugging but can break
-global agents if the checkout is broken.
-
-```bash
-mise run dev-link
-```
-
-The skill bundle is intentionally a thin shell. The authoritative agent
-instructions come from `browserwright --print-skill`, so installed agents read
-docs generated by the installed CLI.
-
-## Update the local global install
-
-Use this flow when you want the global Code Agent install on this machine to
-pick up the latest published release:
-
-```bash
-# 1. Install/upgrade browserwright from PyPI.
-# 2. Download the matching GitHub Release extension artifact.
-# 3. Restart the daemon, reload the unpacked extension, and verify versions.
-mise run upgrade-global
-
-# 4. Optional explicit verification.
-browserwright version check
-browserwright-daemon version check
-```
-
-If the daemon is running manually instead of as the macOS LaunchAgent, restart it manually:
-
-```bash
-browserwright-daemon stop
-browserwright-daemon serve
-```
-
-`upgrade-global` unpacks the GitHub Release asset into the stable local load
-path:
-
-```bash
-/Users/metajs/Library/Mobile Documents/com~apple~CloudDocs/etc/chrome-extension/browserwright
-```
-
-If the task reports that the extension changed, it restarts the daemon, runs
-`browserwright-daemon extension reload`, and waits for Chrome to reconnect with
-the new extension version. The stable path does not change across releases; the
-task overwrites its contents. If the reload cannot be confirmed, fall back to
-Chrome's manual reload button in `chrome://extensions/`.
-Reload any existing tab that already shows a duplicated `👀` attach marker so
-the extension can normalize the title marker after the upgrade.
+### Releases, upgrades, and local development
 
-## Release discipline
-
-For PyPI releases, the git tag is the source of truth and the publish workflow
-writes that version into `pyproject.toml` before building. The release workflow
-also writes the same tag version into `chrome-extension/manifest.json` before
-uploading `browserwright-extension-<version>.zip` to the GitHub Release.
-
-After installing a release:
-
-```bash
-browserwright version check
-browserwright-daemon version check
-browserwright-daemon restart   # when installed as the macOS LaunchAgent
-browserwright-daemon extension reload
-```
-
-The extension reload command asks connected unpacked extensions to call
-`chrome.runtime.reload()`. Reload is immediate; the extension reconnect loop
-restores the relay connection after the service worker restarts.
+Cutting a release, updating a machine's global install (`mise run
+upgrade-global`), the extension reload flow, and the dev-link workflow are all
+documented in **[RELEASING.md](RELEASING.md)** and **[ONBOARD.md](ONBOARD.md)**.
 
 ## Smoke test
 
@@ -254,7 +171,6 @@ browserwright task wikipedia.org/lookup --title="Wikipedia"
 | Scripts / iterative work in throwaway profiles | `rdp` + isolated Chrome | `browserwright-daemon launch-chrome --port 9333 --profile bs-dev` + `BD_PORT=9333 BD_BACKEND=rdp` |
 | Fingerprint browser (AdsPower / MultiLogin / 比特浏览器) | `rdp` | point `BD_PORT` at the tool's exposed port |
 | Externally-owned CDP endpoint (anti-detect profile, e.g. CloakBrowser) | `env` | `BD_CDP_WS=ws://… browserwright-daemon serve --backend env`, then `browserwright session new --backend=env --name=…` (attach-owned — never closed on `session end`) |
-| Remote Chrome (Browser Use / Browserless / Hyperbrowser) | `cloud` | `browserwright-daemon serve --provider <name>` + auth env vars |
 
 Interactive wizard: `browserwright install` — walks the decision tree and writes your pick.
 
@@ -263,6 +179,16 @@ external profiles with N isolated daemons — each with its own `XDG_RUNTIME_DIR
 (distinct socket), `--facade-port`, and `BD_CDP_WS`, one `env` session apiece.
 See [docs/session-workspaces.md](docs/session-workspaces.md) §"Env Backend".
 
+**Reaching the facade from another machine (Tailscale/LAN):** the Playwright
+facade binds `127.0.0.1` by default and is *never* exposed off-box unless you
+opt in. Pass `--facade-host <tailnet-ip>` (or `BD_FACADE_HOST` / `facade_host`
+in config.toml; `0.0.0.0` to bind all interfaces) and a remote client can
+`connect_over_cdp("http://<tailnet-ip>:19990/cdp")` — the facade's
+`/json/version` bootstrap rewrites the advertised `webSocketDebuggerUrl` from
+the request's `Host` header, so the ws URL points back at the address the
+client actually used. No auth is added, so only bind an interface you trust
+(a Tailscale IP is private to your tailnet).
+
 ### Userscripts
 
 Author Tampermonkey-style scripts the `extension` backend injects on matching sites:
@@ -297,7 +223,7 @@ Non-browser helpers (also pre-imported):
 
 - **HTTP (no browser, for static pages):** `http_get(url)`
 - **Memory:** `remember`, `remember_global`, `remember_preference`, `memory_read`
-- **Site-skills / tasks:** `list_site_skills`, `load_site_skill`, `run_task`, `run_tasks_concurrent`, `bootstrap_site`
+- **Site-skills / tasks:** `list_site_skills`, `load_site_skill`, `run_task`, `bootstrap_site`
 
 Full catalogue and guidance in `skill/SKILL.md`.
 
@@ -305,9 +231,8 @@ Full catalogue and guidance in `skill/SKILL.md`.
 
 ```bash
 browserwright-daemon doctor                  # which backends are live, why each is/isn't usable
-browserwright-daemon list-backends
+browserwright-daemon status --json           # daemon liveness + endpoint + facade port
 browserwright doctor                         # skill-side health
-browserwright-daemon stats                   # observability counters when `serve` is running
 ```
 
 ## Agent integrations
@@ -327,12 +252,13 @@ rm -rf ~/.cache/browserwright-daemon ~/.browserwright
 
 ## Further reading
 
-- `TESTING.md` — map of the test suites and how to run them
-- `browser-connection.md` — *why* this stack exists (CDP discovery paths, Chrome 144+ popup mechanics)
+- `AGENTS.md` — entry point for contributors and code agents
+- `docs/architecture.md` — architecture tour + isolated local dev
+- `docs/session-workspaces.md` — the session workspace / isolation model
 - `docs/daemon.md` — backend internals, env vars, `config.toml`
-- `docs/skill.md` — full primitive surface and release notes
-- `docs/session-model.md` — the session isolation model
-- `ONBOARDING.md` — contributor-oriented architecture tour
+- `docs/skill.md` — the Layer 2 agent-facing surface
+- `TESTING.md` — map of the test suites and how to run them
+- `docs/archive/browser-connection.md` — *why* this stack exists (CDP discovery paths, Chrome 144+ popup mechanics)
 
 ## License
 

{browserwright-0.7.2 → browserwright-0.7.4}/pyproject.toml

@@ -4,11 +4,10 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "browserwright"
-version = "0.7.2"
+version = "0.7.4"
 description = "Browserwright — let AI/code agents drive a real or isolated browser and author userscripts. Single package: the agent-facing REPL/site-skills/memory layer plus the bundled browser-resolving daemon (CDP proxy + extension/cloud backends)."
 requires-python = ">=3.11"
 dependencies = [
-    "cdp-use==1.4.5",
     "websockets==15.0.1",
     "pillow==12.2.0",
     "httpx>=0.27",
@@ -18,6 +17,7 @@ dependencies = [
     # for tests that launch a browser; the daemon-facade path drives the
     # daemon-resolved Chrome and does not need Playwright's bundled browser.
     "playwright>=1.60.0",
+    "pyyaml>=6.0.3",
 ]
 
 [project.optional-dependencies]

{browserwright-0.7.2 → browserwright-0.7.4}/src/browserwright/_executor/process.py

@@ -192,7 +192,7 @@ class _Worker:
         Reuses the shared connect+bind free functions (single source of truth
         for the FATAL "no Playwright CDP session over the extension facade"
         constraint). Bind the session FIRST so ``current_session()`` /
-        ``current_page()`` resolve the right ledger record."""
+        ``resolve_current_target()`` resolve the right ledger record."""
         if self._connected:
             return
         from ..session import Session, set_session

{browserwright-0.7.2 → browserwright-0.7.4}/src/browserwright/api.py

@@ -5,23 +5,20 @@ this module. Keeping the list in one place means an agent who imports
 ``browserwright`` directly from a saved task gets the same names the REPL
 gave them.
 
-Phase C PR3 (terminal state): the legacy CDP browser-driving primitives
-(``open``/``goto_url``/``click_at_xy``/``js``/``cdp``/``capture_screenshot``/
-``snapshot``/… — the whole page/tab interaction surface) are GONE from the
-agent surface. The agent now drives the browser with **real Playwright** via
-the injected ``page`` / ``context`` (bound to the session's current tab,
-reused across heredocs) and observes with ``snapshot()`` (a first-party AI
-aria snapshot whose ``[ref=eN]`` refs feed ``page.locator("aria-ref=eN")``).
-Those three names are injected per-heredoc by ``repl/_namespace.build_globals``,
-NOT exported here.
+The legacy CDP browser-driving primitives (``open``/``goto_url``/
+``click_at_xy``/``js``/``cdp``/``capture_screenshot``/``snapshot``/… — the
+whole page/tab interaction surface) are DELETED. The agent drives the browser
+with **real Playwright** via the injected ``page`` / ``context`` (bound to the
+session's current tab, reused across heredocs) and observes with
+``snapshot()`` (a first-party AI aria snapshot whose ``[ref=eN]`` refs feed
+``page.locator("aria-ref=eN")``). Those three names are injected per-heredoc
+by ``repl/_namespace.build_globals``, NOT exported here. The internal tab
+lifecycle the Playwright binding glue relies on lives in
+``browserwright.session_runtime``.
 
 What remains in EXPORTS is the set of NON-browser-driving helpers that do not
 overlap Playwright: ``http_get`` (no-browser escape hatch), the memory verbs,
-and the site-skill / task layer. The implementation modules under
-``primitives/`` still define the old functions (``current_page``, ``list_tabs``,
-the daemon-driving glue, …); they are kept as INTERNAL functions the Phase C
-binding glue (``repl/playwright_handle.py``) and the memory/site helpers rely
-on — they are simply no longer part of the agent-callable surface.
+and the site-skill / task layer.
 """
 from .errors import (
     AuthWall,
@@ -34,7 +31,6 @@ from .errors import (
     NetworkError,
     PageLoadFailed,
 )
-from .multitask import run_tasks_concurrent
 from .primitives import (
     bootstrap_site,
     http_get,
@@ -53,10 +49,9 @@ EXPORTS = [
     # memory + site
     "bootstrap_site", "remember", "remember_global", "remember_preference",
     "memory_read",
-    # task / fan-out (site-skills run on the Playwright surface — see
+    # task (site-skills run on the Playwright surface — see
     # task_runner.run_task, which injects page/context into the task module)
     "list_site_skills", "load_site_skill", "run_task",
-    "run_tasks_concurrent",
     # errors
     "BrowserwrightError", "PageLoadFailed", "ElementNotFound", "AuthWall",
     "Captcha", "NetworkError", "DaemonUnavailable", "CDPError",

{browserwright-0.7.2 → browserwright-0.7.4}/src/browserwright/cdp.py

@@ -6,21 +6,17 @@ Design:
     no session for ``Target.*`` etc.
   - Auto-attach to a tab on demand via ``attach(targetId)``; the resulting
     session id is cached so subsequent calls reuse it.
-  - Events for the attached session are stashed in a per-session ring buffer
-    and exposed via ``drain_events()``.
 
-We intentionally do not depend on cdp-use here. The whole client is < 200
-lines of plain websockets — easier to reason about, easier to unit test,
-and we never need typed wrappers (spec §3 "raw CDP strings over typed
-wrappers").
+The whole client is < 200 lines of plain websockets — easier to reason
+about, easier to unit test, and we never need typed wrappers (spec §3
+"raw CDP strings over typed wrappers").
 """
 from __future__ import annotations
 
 import json
 import threading
 import time
-from collections import deque
-from typing import Any, Optional
+from typing import Optional
 
 from websockets.exceptions import ConnectionClosed
 from websockets.sync.client import connect as ws_connect
@@ -28,9 +24,6 @@ from websockets.sync.client import connect as ws_connect
 from .errors import CDPError
 
 
-_EVENT_RING_LIMIT = 1024
-
-
 class _UnixSocketAdapter:
     """Wrap an ``AF_UNIX`` socket so ``setsockopt(IPPROTO_TCP, ...)`` becomes
     a no-op. websockets unconditionally calls
@@ -113,7 +106,7 @@ class CDPSession:
 
     All sends are synchronous: send → block on response with matching id →
     return result. Events arrive on the same socket; the reader thread
-    routes them by sessionId into per-session deques.
+    discards them (nothing downstream consumes raw CDP events).
     """
 
     def __init__(self, ws_url: str, connect_timeout: float = 8.0):
@@ -145,7 +138,6 @@ class CDPSession:
         self._next_id = 1
         self._inflight: dict[int, dict] = {}
         self._inflight_cv = threading.Condition(self._lock)
-        self._events: dict[Optional[str], deque] = {None: deque(maxlen=_EVENT_RING_LIMIT)}
         self._closed = False
         self._closed_reason: Optional[str] = None
         self._reader = threading.Thread(target=self._read_loop, name="cdp-reader", daemon=True)
@@ -201,8 +193,7 @@ class CDPSession:
         res = self.send("Target.attachToTarget", targetId=target_id, flatten=True)
         sid = res["sessionId"]
         self._sessions[target_id] = sid
-        self._events.setdefault(sid, deque(maxlen=_EVENT_RING_LIMIT))
-        # Enable the usual domains so wait_for_load / drain_events have data.
+        # Enable the usual domains so wait_for_load has data.
         for domain in ("Page", "Runtime", "DOM", "Network"):
             try:
                 self.send(f"{domain}.enable", session=sid)
@@ -210,49 +201,6 @@ class CDPSession:
                 pass  # Some domains are noop in some Chrome builds.
         return sid
 
-    def attach_readonly(self, target_id: str) -> str:
-        """Daemon v0.3 H7 shared-read attach.
-
-        Requests a session via ``flags.allowSecondaryReadOnly=True`` — daemon
-        returns a sessionId that receives this target's events but rejects
-        any command other than ``Target.detachFromTarget`` (`-32602`). Useful
-        for tail-following another agent's session for monitoring / drift
-        detection.
-
-        Note: this opens a *second* session on the same target if some other
-        client / process already owns it. If we own it ourselves, prefer
-        ``attach()``.
-        """
-        res = self.send(
-            "Target.attachToTarget",
-            targetId=target_id,
-            flatten=True,
-            flags={"allowSecondaryReadOnly": True},
-        )
-        sid = res["sessionId"]
-        self._events.setdefault(sid, deque(maxlen=_EVENT_RING_LIMIT))
-        # We deliberately *don't* register sid in ``self._sessions`` — that
-        # map tracks owning attachments, and a readonly attachment isn't one.
-        return sid
-
-    def detach(self, target_id: str) -> None:
-        sid = self._sessions.pop(target_id, None)
-        if sid:
-            try:
-                self.send("Target.detachFromTarget", sessionId=sid)
-            except CDPError:
-                pass
-            self._events.pop(sid, None)
-
-    def drain_events(self, session: Optional[str] = None) -> list[dict]:
-        buf = self._events.get(session)
-        if not buf:
-            return []
-        with self._lock:
-            out = list(buf)
-            buf.clear()
-        return out
-
     def close(self) -> None:
         if self._closed:
             return
@@ -279,13 +227,7 @@ class CDPSession:
                         if mid in self._inflight:
                             self._inflight[mid] = msg
                             self._inflight_cv.notify_all()
-                    continue
-                # Event.
-                sid = msg.get("sessionId")
-                buf = self._events.get(sid)
-                if buf is None:
-                    buf = self._events.setdefault(sid, deque(maxlen=_EVENT_RING_LIMIT))
-                buf.append({"method": msg.get("method"), "params": msg.get("params", {}), "sessionId": sid})
+                # Events (no id) are dropped — nothing consumes them.
         except ConnectionClosed as e:
             self._closed_reason = str(e)
         except Exception as e:  # noqa: BLE001

{browserwright-0.7.2 → browserwright-0.7.4}/src/browserwright/cli.py

@@ -41,12 +41,6 @@ Usage:
   browserwright -s <session-id> task <site>/<name> [--key=value ...] [--isolated]
   browserwright list-tasks [--site SITE] [--query Q] [--json]
 
-  browserwright sub add <git-url> [--name NAME]
-  browserwright sub list [--json]
-  browserwright sub update [--name NAME]
-  browserwright sub remove --name NAME
-  browserwright release {install-local|status|list|activate} ...
-
   browserwright install
   browserwright doctor [--json]
   browserwright index rebuild
@@ -384,76 +378,6 @@ def _cmd_index(args: list[str]) -> int:
     return 1
 
 
-def _cmd_sub(args: list[str]) -> int:
-    """``browserwright sub {add|list|update|remove} ...``."""
-    if not args:
-        print("usage: browserwright sub {add|list|update|remove} ...", file=sys.stderr)
-        return 1
-    sub = args[0]
-    rest = args[1:]
-    from . import subscriptions
-
-    if sub == "add":
-        if not rest or rest[0].startswith("--"):
-            print("usage: browserwright sub add <git-url> [--name NAME]", file=sys.stderr)
-            return 1
-        url = rest[0]
-        kw = _parse_kv_args(rest[1:])
-        try:
-            r = subscriptions.add(url, name=kw.get("name"))
-        except subscriptions.SubscriptionError as e:
-            print(f"sub add failed: {e}", file=sys.stderr)
-            return 1
-        if kw.get("json"):
-            sys.stdout.write(json.dumps(r, default=str) + "\n")
-        else:
-            print(f"{r['status']}: {r['name']} → {r['path']}")
-        return 0
-
-    if sub == "list":
-        kw = _parse_kv_args(rest)
-        rows = subscriptions.list_all()
-        if kw.get("json"):
-            sys.stdout.write(json.dumps(rows, indent=2, default=str) + "\n")
-            return 0
-        if not rows:
-            print("(no subscriptions)")
-            return 0
-        for r in rows:
-            tag = "" if r["exists"] else " [MISSING]"
-            print(f"  {r['name']:24s} {r['url']}{tag}")
-        return 0
-
-    if sub == "update":
-        kw = _parse_kv_args(rest)
-        names = [kw["name"]] if kw.get("name") else None
-        try:
-            results = subscriptions.update(names)
-        except subscriptions.SubscriptionError as e:
-            print(f"sub update failed: {e}", file=sys.stderr)
-            return 1
-        for r in results:
-            print(f"  {r['name']:24s} {r['status']}: {r.get('detail','')}")
-        return 0 if all(r["status"] in ("updated", "missing") for r in results) else 1
-
-    if sub == "remove":
-        kw = _parse_kv_args(rest)
-        name = kw.get("name")
-        if not name:
-            print("usage: browserwright sub remove --name NAME", file=sys.stderr)
-            return 1
-        try:
-            subscriptions.remove(name)
-        except subscriptions.SubscriptionError as e:
-            print(f"sub remove failed: {e}", file=sys.stderr)
-            return 1
-        print(f"removed {name}")
-        return 0
-
-    print(f"unknown sub subcommand: {sub}", file=sys.stderr)
-    return 1
-
-
 def _cmd_memory(args: list[str]) -> int:
     if not args:
         print("usage: browserwright memory {show|forget|replace} ...", file=sys.stderr)
@@ -623,6 +547,16 @@ def _cmd_session(args: list[str], *, session_id: Optional[str] = None) -> int:
     return 1
 
 
+def _fresh_screenshot_path() -> str:
+    """A non-colliding /tmp png path for the userscript --verify screenshot."""
+    i = 0
+    while True:
+        cand = Path("/tmp") / f"browserwright-shot-{os.getpid()}-{i}.png"
+        if not cand.exists():
+            return str(cand)
+        i += 1
+
+
 def _cmd_userscript(args: list[str], *, session_id: Optional[str] = None) -> int:
     if not args or args[0] in {"-h", "--help"}:
         sys.stdout.write(USERSCRIPT_HELP)
@@ -661,14 +595,20 @@ def _cmd_userscript(args: list[str], *, session_id: Optional[str] = None) -> int
                 raise RuntimeError(
                     "no drivable session bound; pass -s <id> or set BD_SESSION"
                 )
-            # These are internal driving helpers (no longer on the agent
-            # EXPORTS surface — Phase C PR3); the userscript --verify
-            # convenience still uses them directly from the primitive modules.
-            from .primitives.inspect import capture_screenshot
-            from .primitives.page import reload
-
-            reload()
-            print(capture_screenshot())
+            # Drive the verify through the same Playwright path the agent
+            # uses (the legacy CDP primitives are gone): bind the session's
+            # current tab, reload it, screenshot it, print the path.
+            from .repl.playwright_handle import PlaywrightHandle
+
+            handle = PlaywrightHandle()
+            try:
+                page = handle.page
+                page.reload(wait_until="load")
+                shot = _fresh_screenshot_path()
+                page.screenshot(path=shot)
+                print(shot)
+            finally:
+                handle.close()
         except Exception as e:
             print(f"pushed OK — --verify skipped (no drivable tab): {e}",
                   file=sys.stderr)
@@ -765,88 +705,6 @@ def _extension_relay_status() -> dict | None:
         return None
 
 
-def _cmd_release(args: list[str]) -> int:
-    if not args:
-        print(
-            "usage: browserwright release {install-local|status|list|activate} ...",
-            file=sys.stderr,
-        )
-        return 1
-    from . import release_install
-
-    sub = args[0]
-    rest = args[1:]
-    kw = _parse_kv_args(rest)
-    try:
-        if sub == "install-local":
-            info = release_install.install_local(
-                force=bool(kw.get("force")),
-                activate_release=not bool(kw.get("no-activate")),
-            )
-            if kw.get("restart-daemon") and info["actions"].get("restart_daemon"):
-                subprocess.run(["browserwright-daemon", "restart"], check=False)
-            if kw.get("json"):
-                sys.stdout.write(json.dumps(info, indent=2, sort_keys=True) + "\n")
-            else:
-                print(f"installed browserwright {info['version']} -> {info['path']}")
-                if info.get("activated"):
-                    print("activated global entry points")
-                if info["actions"].get("restart_daemon"):
-                    print("next: restart daemon (`browserwright-daemon restart`)")
-                if info["actions"].get("reload_chrome_extension"):
-                    print(
-                        "next: reload Chrome unpacked extension from "
-                        f"{info.get('chrome_extension_sync', {}).get('path') or info['path'] + '/chrome-extension'}"
-                    )
-            return 0
-
-        if sub == "status":
-            info = release_install.status()
-            if kw.get("json"):
-                sys.stdout.write(json.dumps(info, indent=2, sort_keys=True) + "\n")
-                return 0
-            version = info.get("installed_version") or "(none)"
-            print(f"installed release: {version}")
-            daemon = info.get("daemon") or {}
-            daemon_version = daemon.get("version") or "(not running)"
-            suffix = "  restart required" if daemon.get("restart_required") else ""
-            print(f"running daemon:    {daemon_version}{suffix}")
-            ok = all(row.get("ok") for row in info.get("skill", []))
-            print(f"skill install:     {'copied ok' if ok else 'needs reinstall'}")
-            return 0
-
-        if sub == "list":
-            rows = release_install.list_releases()
-            if kw.get("json"):
-                sys.stdout.write(json.dumps(rows, indent=2, sort_keys=True) + "\n")
-                return 0
-            if not rows:
-                print("(no releases installed)")
-                return 0
-            for row in rows:
-                mark = "*" if row.get("active") else " "
-                print(f"{mark} {row.get('version')}  {row.get('path')}")
-            return 0
-
-        if sub == "activate":
-            if not rest or rest[0].startswith("--"):
-                print("usage: browserwright release activate <version>", file=sys.stderr)
-                return 1
-            info = release_install.activate(rest[0])
-            if kw.get("json"):
-                sys.stdout.write(json.dumps(info, indent=2, sort_keys=True) + "\n")
-            else:
-                print(f"activated browserwright {info['version']} -> {info['path']}")
-                print("next: restart daemon and reload Chrome extension if that release differs")
-            return 0
-    except release_install.ReleaseError as e:
-        print(f"release error: {e}", file=sys.stderr)
-        return 1
-
-    print(f"unknown release subcommand: {sub}", file=sys.stderr)
-    return 1
-
-
 def main(argv: Optional[list[str]] = None) -> None:
     argv = list(sys.argv[1:] if argv is None else argv)
 
@@ -897,10 +755,6 @@ def main(argv: Optional[list[str]] = None) -> None:
         sys.exit(_cmd_index(rest))
     if cmd == "memory":
         sys.exit(_cmd_memory(rest))
-    if cmd == "sub":
-        sys.exit(_cmd_sub(rest))
-    if cmd == "release":
-        sys.exit(_cmd_release(rest))
     if cmd == "session":
         sys.exit(_cmd_session(rest, session_id=global_session))
     if cmd == "whoami":