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

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

@@ -7,6 +7,34 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.0.2] — 2026-06-15
+
+### Fixed — CLI entry point (#148)
+
+- Fixed CLI module shadowing where both `src/super_browser/cli.py` and
+  `src/super_browser/cli/` existed, causing `super_browser.cli` to resolve
+  to the package and making several console commands inaccessible.
+- Consolidated all CLI commands into `src/super_browser/cli/__init__.py`.
+- Restored `superbrowser version`, `info`, `run`, `interactive`, `script`,
+  `replay`, `act`, and `stealth-check`.
+- Preserved compatibility aliases for existing imports:
+  `memory_handler`, `stealth_validate_handler`, and `_result_demo_handler`.
+
+No runtime API changes outside CLI dispatch.
+
+## [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 +43,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.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: superbrowser-sdk
-Version: 2.0.0
+Version: 2.0.2
 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.2}/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.2}/docs/api-stability.md

@@ -1,6 +1,6 @@
 # API Stability Contract
 
-> **Super Browser** v2.0.0 — Public API stability guarantees.
+> **Super Browser** v2.0.2 — 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.2}/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.2}/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.2 — 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.2}/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.2}/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.2}/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.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "superbrowser-sdk"
-version = "2.0.0"
+version = "2.0.2"
 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.2}/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.2"
 
 __all__ = [
     "SuperBrowser",

{superbrowser_sdk-2.0.0 → superbrowser_sdk-2.0.2}/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.2}/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.2}/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.2}/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.2}/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.2}/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 ----------------------------------------