superbrowser-sdk 2.0.0__tar.gz → 2.0.1__tar.gz

{superbrowser_sdk-2.0.0 → superbrowser_sdk-2.0.1}/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.0.1] — 2026-06-15
+
+### Fixed — Hotfix: PyPI distribution naming
+
+- **`[all]` extra broken on published v2.0.0**: The self-reference in
+  `pyproject.toml` `[all]` extra still pointed to `super-browser` instead of
+  `superbrowser-sdk`. Fixed in PR #146 but never republished.
+- **CLI entry point name**: Published v2.0.0 had `super-browser` as the
+  console script name instead of `superbrowser`.
+- **Doc version headers**: Updated to v2.0.1.
+
+No code changes — packaging fix only. All 2,758 tests unchanged.
+
 ## [2.0.0] — 2026-06-15
 
 ### Overview
@@ -15,6 +28,9 @@ The v2.0 release delivers five tracks of improvement to the Super Browser
 anti-detection agent browser SDK. All tracks are implementation-complete with
 2,758 passing tests across 3 operating systems and 2 Python versions.
 
+**Distribution name:** `superbrowser-sdk` (`pip install superbrowser-sdk`)
+**Import name:** `super_browser` (`import super_browser`)
+
 ### Breaking Changes — Track A: API Simplification (Waves 14-16)
 
 - **`SuperBrowserConfig` removed.** All fields flattened onto `AgentConfig`.

{superbrowser_sdk-2.0.0 → superbrowser_sdk-2.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: superbrowser-sdk
-Version: 2.0.0
+Version: 2.0.1
 Summary: Anti-detection agent browser SDK — stealth, budget governance, security guardrails, and structured error recovery behind one async facade
 Project-URL: Homepage, https://github.com/Octo-Lex/Super-Browser
 Project-URL: Documentation, https://github.com/Octo-Lex/Super-Browser#readme
@@ -27,7 +27,18 @@ Classifier: Topic :: Software Development :: Testing
 Classifier: Typing :: Typed
 Requires-Python: >=3.11
 Provides-Extra: all
-Requires-Dist: super-browser[anthropic,cdp,cloud,openai,patchright,playwright,security,selenium]; extra == 'all'
+Requires-Dist: aiohttp>=3.9; extra == 'all'
+Requires-Dist: anthropic>=0.40; extra == 'all'
+Requires-Dist: cryptography>=42.0; extra == 'all'
+Requires-Dist: httpx>=0.27; extra == 'all'
+Requires-Dist: openai>=1.0; extra == 'all'
+Requires-Dist: patchright>=1.0; extra == 'all'
+Requires-Dist: pillow>=10.0; extra == 'all'
+Requires-Dist: playwright>=1.40; extra == 'all'
+Requires-Dist: psutil>=5.9; extra == 'all'
+Requires-Dist: selenium>=4.0; extra == 'all'
+Requires-Dist: webdriver-manager>=4.0; extra == 'all'
+Requires-Dist: websockets>=12.0; extra == 'all'
 Provides-Extra: anthropic
 Requires-Dist: anthropic>=0.40; extra == 'anthropic'
 Provides-Extra: cdp
@@ -64,31 +75,41 @@ Description-Content-Type: text/markdown
 ![Super-Browser — Anti-detection agent browser SDK, stealth, budget governance, security guardrails, and structured error recovery behind one async facade](https://github.com/Octo-Lex/Super-Browser/blob/1ce1633ff586c28cfa7c2b0c50db82f2f1cb9fac/Banner.png)
 
 [![CI](https://img.shields.io/github/actions/workflow/status/Octo-Lex/Super-Browser/test.yml?branch=main)](https://github.com/Octo-Lex/Super-Browser/actions)
-[![PyPI](https://img.shields.io/pypi/v/super-browser?color=blue)](https://pypi.org/project/super-browser/)
+[![PyPI](https://img.shields.io/pypi/v/superbrowser-sdk?color=blue)](https://pypi.org/project/superbrowser-sdk/)
 [![License](https://img.shields.io/badge/license-Apache--2.0-green)](https://github.com/Octo-Lex/Super-Browser/blob/main/LICENSE)
 
 **Super Browser** is an anti-detection agent browser SDK. It wraps browser automation (Patchright, Playwright, Selenium, or raw CDP) in an agent-first API with stealth, budget governance, security guardrails, and structured error recovery. MCP is a transport, the agent SDK is the user-facing layer, and stealth is the foundation.
 
 ## Installation
 
+> **Package naming:** The distribution name is `superbrowser-sdk`. The
+> Python import name is `super_browser`.
+>
+> ```bash
+> pip install superbrowser-sdk
+> ```
+> ```python
+> import super_browser
+> ```
+
 ```bash
 # Default — Patchright (full stealth)
-pip install super-browser[patchright]
+pip install superbrowser-sdk[patchright]
 python -m patchright install chromium
 
 # Alternative backends
-pip install super-browser[playwright]      # Standard Playwright
-pip install super-browser[selenium]        # Enterprise CI
+pip install superbrowser-sdk[playwright]      # Standard Playwright
+pip install superbrowser-sdk[selenium]        # Enterprise CI
 
 # Or everything
-pip install super-browser[all]
+pip install superbrowser-sdk[all]
 ```
 
 For specific LLM providers:
 
 ```bash
-pip install super-browser[patchright,anthropic]   # Anthropic Claude
-pip install super-browser[patchright,openai]       # OpenAI GPT
+pip install superbrowser-sdk[patchright,anthropic]   # Anthropic Claude
+pip install superbrowser-sdk[patchright,openai]       # OpenAI GPT
 ```
 
 ## Quickstart
@@ -518,7 +539,7 @@ See [docs/memory.md](docs/memory.md).
 Super Browser supports **CloakBrowser** as an optional stealth backend — a hardened Chromium with 57 C++ anti-detection patches:
 
 ```bash
-pip install super-browser[patchright,cloak]
+pip install superbrowser-sdk[patchright,cloak]
 ```
 
 When installed, CloakBrowser is automatically detected and used. No code changes required:

{superbrowser_sdk-2.0.0 → superbrowser_sdk-2.0.1}/README.md

@@ -1,31 +1,41 @@
 ![Super-Browser — Anti-detection agent browser SDK, stealth, budget governance, security guardrails, and structured error recovery behind one async facade](https://github.com/Octo-Lex/Super-Browser/blob/1ce1633ff586c28cfa7c2b0c50db82f2f1cb9fac/Banner.png)
 
 [![CI](https://img.shields.io/github/actions/workflow/status/Octo-Lex/Super-Browser/test.yml?branch=main)](https://github.com/Octo-Lex/Super-Browser/actions)
-[![PyPI](https://img.shields.io/pypi/v/super-browser?color=blue)](https://pypi.org/project/super-browser/)
+[![PyPI](https://img.shields.io/pypi/v/superbrowser-sdk?color=blue)](https://pypi.org/project/superbrowser-sdk/)
 [![License](https://img.shields.io/badge/license-Apache--2.0-green)](https://github.com/Octo-Lex/Super-Browser/blob/main/LICENSE)
 
 **Super Browser** is an anti-detection agent browser SDK. It wraps browser automation (Patchright, Playwright, Selenium, or raw CDP) in an agent-first API with stealth, budget governance, security guardrails, and structured error recovery. MCP is a transport, the agent SDK is the user-facing layer, and stealth is the foundation.
 
 ## Installation
 
+> **Package naming:** The distribution name is `superbrowser-sdk`. The
+> Python import name is `super_browser`.
+>
+> ```bash
+> pip install superbrowser-sdk
+> ```
+> ```python
+> import super_browser
+> ```
+
 ```bash
 # Default — Patchright (full stealth)
-pip install super-browser[patchright]
+pip install superbrowser-sdk[patchright]
 python -m patchright install chromium
 
 # Alternative backends
-pip install super-browser[playwright]      # Standard Playwright
-pip install super-browser[selenium]        # Enterprise CI
+pip install superbrowser-sdk[playwright]      # Standard Playwright
+pip install superbrowser-sdk[selenium]        # Enterprise CI
 
 # Or everything
-pip install super-browser[all]
+pip install superbrowser-sdk[all]
 ```
 
 For specific LLM providers:
 
 ```bash
-pip install super-browser[patchright,anthropic]   # Anthropic Claude
-pip install super-browser[patchright,openai]       # OpenAI GPT
+pip install superbrowser-sdk[patchright,anthropic]   # Anthropic Claude
+pip install superbrowser-sdk[patchright,openai]       # OpenAI GPT
 ```
 
 ## Quickstart
@@ -455,7 +465,7 @@ See [docs/memory.md](docs/memory.md).
 Super Browser supports **CloakBrowser** as an optional stealth backend — a hardened Chromium with 57 C++ anti-detection patches:
 
 ```bash
-pip install super-browser[patchright,cloak]
+pip install superbrowser-sdk[patchright,cloak]
 ```
 
 When installed, CloakBrowser is automatically detected and used. No code changes required:

{superbrowser_sdk-2.0.0 → superbrowser_sdk-2.0.1}/docs/api-stability.md

@@ -1,6 +1,6 @@
 # API Stability Contract
 
-> **Super Browser** v2.0.0 — Public API stability guarantees.
+> **Super Browser** v2.0.1 — Public API stability guarantees.
 
 This document defines which APIs are stable, which are protocols (stable interface, evolving implementations), and which are internal.
 

{superbrowser_sdk-2.0.0 → superbrowser_sdk-2.0.1}/docs/cloak-integration.md

@@ -6,7 +6,7 @@ Super Browser supports **CloakBrowser** as an optional stealth backend. When ins
 
 ```bash
 # Install Super Browser with CloakBrowser support
-pip install super-browser[browser,cloak]
+pip install superbrowser-sdk[browser,cloak]
 
 # Or add to an existing installation
 pip install cloakbrowser>=0.3

{superbrowser_sdk-2.0.0 → superbrowser_sdk-2.0.1}/docs/error-catalog.md

@@ -1,6 +1,6 @@
 # Error Catalog
 
-> **Super Browser** v2.0.0 — Complete failure taxonomy, causes, and recovery guidance.
+> **Super Browser** v2.0.1 — Complete failure taxonomy, causes, and recovery guidance.
 
 Every `ActionResult` carries structured error information. This catalog maps each error category to its typical causes and recommended recovery strategy.
 

{superbrowser_sdk-2.0.0 → superbrowser_sdk-2.0.1}/docs/migration/v1.8-to-v1.9.md

@@ -103,15 +103,15 @@ You don't need to select injectors manually unless you're building a custom back
 
 ## New pip Install Targets
 
-**v1.8:** `pip install super-browser[browser]` (now removed — use `[patchright]`)
+**v1.8:** `pip install superbrowser-sdk[browser]` (now removed — use `[patchright]`)
 
 **v1.9:** Backend-specific install targets:
 
 ```bash
-pip install super-browser[patchright]    # Default, full stealth
-pip install super-browser[playwright]    # Standard Playwright
-pip install super-browser[selenium]      # Enterprise CI
-pip install super-browser[all]           # Everything
+pip install superbrowser-sdk[patchright]    # Default, full stealth
+pip install superbrowser-sdk[playwright]    # Standard Playwright
+pip install superbrowser-sdk[selenium]      # Enterprise CI
+pip install superbrowser-sdk[all]           # Everything
 ```
 
 ## Structured Error Categories

{superbrowser_sdk-2.0.0 → superbrowser_sdk-2.0.1}/docs/platform-abstraction.md

@@ -178,4 +178,4 @@ The Selenium backend does not support network interception:
 | `route()` | Raises `NotImplementedError` — Selenium has no equivalent to Playwright's route interception |
 | `unroute()` | Raises `NotImplementedError` — see above |
 
-For full feature coverage, use the Patchright backend (`pip install super-browser[patchright]`).
+For full feature coverage, use the Patchright backend (`pip install superbrowser-sdk[patchright]`).

{superbrowser_sdk-2.0.0 → superbrowser_sdk-2.0.1}/docs/quickstart.md

@@ -20,7 +20,7 @@ This tutorial walks you through:
 ## 1. Install
 
 ```bash
-pip install super-browser[patchright]
+pip install superbrowser-sdk[patchright]
 ```
 
 Verify the installation:
@@ -397,6 +397,6 @@ The `create_llm()` factory couldn't find a provider. Set `SB_LLM_PROVIDER` or pa
 Ensure you have a Chromium-based browser installed:
 
 ```bash
-pip install super-browser[patchright]
+pip install superbrowser-sdk[patchright]
 python -m patchright install chromium
 ```

{superbrowser_sdk-2.0.0 → superbrowser_sdk-2.0.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "superbrowser-sdk"
-version = "2.0.0"
+version = "2.0.1"
 description = "Anti-detection agent browser SDK — stealth, budget governance, security guardrails, and structured error recovery behind one async facade"
 readme = "README.md"
 license = { text = "Apache-2.0" }
@@ -42,7 +42,7 @@ classifiers = [
 ]
 
 [project.scripts]
-super-browser = "super_browser.cli:main"
+superbrowser = "super_browser.cli:main"
 
 [project.urls]
 Homepage = "https://github.com/Octo-Lex/Super-Browser"
@@ -69,7 +69,7 @@ cdp = [
     "aiohttp>=3.9",
 ]
 all = [
-    "super-browser[patchright,playwright,selenium,cdp,security,anthropic,openai,cloud]",
+    "superbrowser-sdk[patchright,playwright,selenium,cdp,security,anthropic,openai,cloud]",
 ]
 dev = [
     "pytest>=9.0",

{superbrowser_sdk-2.0.0 → superbrowser_sdk-2.0.1}/src/super_browser/__init__.py

@@ -6,7 +6,7 @@ from super_browser.agent.types import StreamEvent as StreamEvent  # noqa: F401
 from super_browser.config import Config as Config  # noqa: F401
 from super_browser.results.types import ActionResult as ActionResult  # noqa: F401
 
-__version__ = "2.0.0"
+__version__ = "2.0.1"
 
 __all__ = [
     "SuperBrowser",

{superbrowser_sdk-2.0.0 → superbrowser_sdk-2.0.1}/src/super_browser/agent/llm/anthropic_client.py

@@ -49,7 +49,7 @@ class AnthropicLLMClient:
         except ImportError as exc:
             raise ImportError(
                 "The 'anthropic' package is required for AnthropicLLMClient. "
-                "Install it with:  pip install super-browser[anthropic]"
+                "Install it with:  pip install superbrowser-sdk[anthropic]"
             ) from exc
 
         self._client = anthropic.AsyncAnthropic(api_key=api_key)

{superbrowser_sdk-2.0.0 → superbrowser_sdk-2.0.1}/src/super_browser/agent/llm/openai_client.py

@@ -49,7 +49,7 @@ class OpenAILLMClient:
         except ImportError as exc:
             raise ImportError(
                 "The 'openai' package is required for OpenAILLMClient. "
-                "Install it with:  pip install super-browser[openai]"
+                "Install it with:  pip install superbrowser-sdk[openai]"
             ) from exc
 
         self._client = openai.AsyncOpenAI(api_key=api_key)

{superbrowser_sdk-2.0.0 → superbrowser_sdk-2.0.1}/src/super_browser/browser/cloak_backend.py

@@ -122,7 +122,7 @@ class CloakBrowserAdapter:
         except ImportError as exc:
             raise ImportError(
                 "cloakbrowser is required for CLOAK_LAUNCH mode. "
-                "Install with: pip install super-browser[cloak]"
+                "Install with: pip install superbrowser-sdk[cloak]"
             ) from exc
 
         kwargs: dict[str, Any] = {

{superbrowser_sdk-2.0.0 → superbrowser_sdk-2.0.1}/src/super_browser/browser/cloud.py

@@ -3,7 +3,7 @@
 Provides a unified interface for connecting to remote cloud browser
 sessions instead of running Chromium locally.
 
-Requires: pip install super-browser[cloud]
+Requires: pip install superbrowser-sdk[cloud]
 """
 
 from __future__ import annotations
@@ -82,7 +82,7 @@ class BrowserbaseConnector(CloudBrowserConnector):
         except ImportError:
             raise ImportError(
                 "httpx is required for cloud browser support. "
-                "Install with: pip install super-browser[cloud]"
+                "Install with: pip install superbrowser-sdk[cloud]"
             )
 
         if not self._api_key or not self._project_id:
@@ -182,7 +182,7 @@ class SteelConnector(CloudBrowserConnector):
         except ImportError:
             raise ImportError(
                 "httpx is required for cloud browser support. "
-                "Install with: pip install super-browser[cloud]"
+                "Install with: pip install superbrowser-sdk[cloud]"
             )
 
         if not self._api_key:

{superbrowser_sdk-2.0.0 → superbrowser_sdk-2.0.1}/src/super_browser/browser/engine.py

@@ -320,7 +320,7 @@ def _detect_backend(config: Any = None) -> str:
     # 5. Nothing found
     raise RuntimeError(
         "No browser backend found. Install one of:\n"
-        "  pip install super-browser[patchright]\n"
-        "  pip install super-browser[playwright]\n"
-        "  pip install super-browser[selenium]"
+        "  pip install superbrowser-sdk[patchright]\n"
+        "  pip install superbrowser-sdk[playwright]\n"
+        "  pip install superbrowser-sdk[selenium]"
     )

{superbrowser_sdk-2.0.0 → superbrowser_sdk-2.0.1}/src/super_browser/browser/session.py

@@ -65,7 +65,7 @@ class BrowserSession:
         if async_playwright is None:
             raise ImportError(
                 "patchright is required for browser sessions. "
-                "Install with: pip install super-browser[browser]"
+                "Install with: pip install superbrowser-sdk[browser]"
             )
 
         # -- CloakBrowser path ----------------------------------------

{superbrowser_sdk-2.0.0 → superbrowser_sdk-2.0.1}/src/super_browser/cli/__init__.py

@@ -70,7 +70,7 @@ def memory_handler(args: argparse.Namespace) -> None:
         print(f"Pruned {removed} expired entries.")
         return
 
-    print("Usage: super-browser memory {list|show|clear|prune}")
+    print("Usage: superbrowser memory {list|show|clear|prune}")
 
 
 def stealth_validate_handler(args: argparse.Namespace) -> None:
@@ -179,7 +179,7 @@ def _result_demo_handler(args: argparse.Namespace) -> None:
 def main() -> None:
     """Entry point for ``super-browser`` CLI."""
     parser = argparse.ArgumentParser(
-        prog="super-browser",
+        prog="superbrowser",
         description="Super Browser CLI",
     )
     sub = parser.add_subparsers(dest="command")

{superbrowser_sdk-2.0.0 → superbrowser_sdk-2.0.1}/src/super_browser/cli.py

@@ -11,7 +11,7 @@ import sys
 def main() -> None:
     """Entry point for the ``super-browser`` CLI."""
     parser = argparse.ArgumentParser(
-        prog="super-browser",
+        prog="superbrowser",
         description="Super Browser — AI browser automation CLI",
     )
     sub = parser.add_subparsers(dest="command")
@@ -76,7 +76,7 @@ def main() -> None:
 
     if args.command == "version" or args.command is None:
         from super_browser import __version__
-        print(f"super-browser {__version__}")
+        print(f"superbrowser {__version__}")
         return
 
     if args.command == "info":
@@ -118,7 +118,7 @@ def _print_info() -> None:
     """Print system and dependency info."""
     from super_browser import __version__
 
-    print(f"super-browser: {__version__}")
+    print(f"superbrowser: {__version__}")
     print(f"python: {sys.version}")
 
     # Check optional deps
@@ -136,7 +136,7 @@ def _print_info() -> None:
             __import__(mod)
             print(f"  {mod}: installed [{extra}]")
         except ImportError:
-            print(f"  {mod}: not installed (pip install super-browser[{extra}])")
+            print(f"  {mod}: not installed (pip install superbrowser-sdk[{extra}])")
 
 
 async def _run(args: argparse.Namespace) -> None:
@@ -252,7 +252,7 @@ def _memory(args: argparse.Namespace) -> None:
         return
 
     # No subcommand given
-    print("Usage: super-browser memory {list|show|clear|prune}")
+    print("Usage: superbrowser memory {list|show|clear|prune}")
 
 
 async def _stealth_check(args: argparse.Namespace) -> int:

{superbrowser_sdk-2.0.0 → superbrowser_sdk-2.0.1}/src/super_browser/security/credential_vault.py

@@ -115,7 +115,7 @@ class CredentialVault:
         if Fernet is None:
             raise ImportError(
                 "cryptography is required for CredentialVault. "
-                "Install it with: pip install super-browser[security]"
+                "Install it with: pip install superbrowser-sdk[security]"
             )
         if self._fernet is None:
             key = _load_or_create_key(self._key_file)

{superbrowser_sdk-2.0.0 → superbrowser_sdk-2.0.1}/tests/integration/test_v1100_features.py

@@ -93,7 +93,7 @@ class TestReadmeBadges:
 
     def test_pypi_badge_exists(self, readme):
         """PyPI badge exists."""
-        assert "pypi.org/project/super-browser" in readme or "pypi/v/super-browser" in readme
+        assert "pypi.org/project/superbrowser-sdk" in readme or "pypi/v/superbrowser-sdk" in readme
 
 
 class TestPyprojectUrls:

{superbrowser_sdk-2.0.0 → superbrowser_sdk-2.0.1}/tests/integration/test_v195_features.py

@@ -28,11 +28,11 @@ class TestV195DocNormalization:
 
     def test_api_stability_version_header(self) -> None:
         header = (DOCS_DIR / "api-stability.md").read_text(encoding="utf-8").split("\n")[:5]
-        assert "v2.0.0" in "\n".join(header)
+        assert "v2.0.1" in "\n".join(header)
 
     def test_error_catalog_version_header(self) -> None:
         header = (DOCS_DIR / "error-catalog.md").read_text(encoding="utf-8").split("\n")[:5]
-        assert "v2.0.0" in "\n".join(header)
+        assert "v2.0.1" in "\n".join(header)
 
     def test_no_config_browser_alias_in_examples(self) -> None:
         for f in EXAMPLES_DIR.glob("*.py"):

{superbrowser_sdk-2.0.0 → superbrowser_sdk-2.0.1}/tests/test_cli/test_stealth_validate.py

@@ -312,7 +312,7 @@ class TestCLICaptureBaseline:
                 sys,
                 "argv",
                 [
-                    "super-browser",
+                    "superbrowser",
                     "stealth-validate",
                     "--profile",
                     "test-profile",
@@ -368,7 +368,7 @@ class TestCLICIMode:
                 sys,
                 "argv",
                 [
-                    "super-browser",
+                    "superbrowser",
                     "stealth-validate",
                     "--profile",
                     "test-profile",
@@ -416,7 +416,7 @@ class TestCLICIMode:
                 sys,
                 "argv",
                 [
-                    "super-browser",
+                    "superbrowser",
                     "stealth-validate",
                     "--profile",
                     "test-profile",
@@ -447,7 +447,7 @@ class TestCLICIMode:
                 sys,
                 "argv",
                 [
-                    "super-browser",
+                    "superbrowser",
                     "stealth-validate",
                     "--profile",
                     "test-profile",