agentic-stealth-browser 2.1.1__tar.gz → 2.3.0__tar.gz

{agentic_stealth_browser-2.1.1 → agentic_stealth_browser-2.3.0}/CHANGELOG.md

@@ -7,6 +7,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [2.3.0] — Show HN & Community Launch (2026-05-28)
+
+### Added
+- **Show HN preparation**: Complete README overhaul with demo GIF, streamlined onboarding, and community-facing tone. (#HN)
+- **Buy Me A Coffee badge**: Support link in README for community sponsorship. (#badge)
+- **`_browser_process` exposure**: External PID tracking via `AgentBrowser._browser_process`, enabling process-level monitoring and recovery. (#pid)
+
+### Changed
+- Full README rewrite for PyPI + HN audience (pip-first install path, Quick Start with CLI + Python SDK + MCP, reduced wall-of-text, more code examples).
+- Demo GIF (`assets/hn-demo.gif`) showing end-to-end stealth browser flow.
+- Various lint fixes for demo scripts.
+
+### Fixed
+- Stray temp files cleaned from repo root.
+- Ruff formatting applied across all Python sources.
+
+## [2.1.1] — PyPI & Docs Consolidation (2026-05-27)
+
+### Added
+- **PyPI publish workflow** (`.github/workflows/pypi-publish.yml`): OIDC trusted publishing for automated release deployment. (#pypi)
+- **PyPI release readiness**: README polished for pip-first consumption, badges and metadata tuned for PyPI listing.
+
+### Changed
+- **Docs consolidation**: `docs/` folder removed, all documentation consolidated into README.md for a single source of truth. Content preserved (THREAT_MODEL, STEALTH_LIMITATIONS, ADRs, etc. remain accessible via GitHub blob links).
+- ruff formatting applied across dashboard codebase.
+
 ## [2.1.0] — Hermes Browser Dashboard (2026-05-30)
 
 ### Added
@@ -272,8 +298,11 @@ See the full v0.9.0 milestone and the stacked PRs #383/#384/#385 for implementat
 
 ---
 
-[unreleased]: https://github.com/shanewas/agentic-stealth-browser/compare/v0.9.0...HEAD
-[1.0.0]: https://github.com/shanewas/agentic-stealth-browser/releases/tag/v1.0.0
+[unreleased]: https://github.com/shanewas/agentic-stealth-browser/compare/v2.3.0...HEAD
+[2.3.0]: https://github.com/shanewas/agentic-stealth-browser/releases/tag/v2.3.0
+[2.1.1]: https://github.com/shanewas/agentic-stealth-browser/releases/tag/v2.1.1
+[2.1.0]: https://github.com/shanewas/agentic-stealth-browser/releases/tag/v2.1.0
+[2.0.0]: https://github.com/shanewas/agentic-stealth-browser/releases/tag/v2.0.0
 [0.9.0]: https://github.com/shanewas/agentic-stealth-browser/releases/tag/v0.9.0
 [0.2.0]: https://github.com/shanewas/agentic-stealth-browser/releases/tag/v0.2.0
 [0.1.0]: https://github.com/shanewas/agentic-stealth-browser/releases/tag/v0.1.0

agentic_stealth_browser-2.3.0/PKG-INFO

@@ -0,0 +1,184 @@
+Metadata-Version: 2.4
+Name: agentic-stealth-browser
+Version: 2.3.0
+Summary: Production-grade, human-mimicking browser automation framework for autonomous agents. Survives modern anti-bot systems.
+Author-email: Shane W <shanewas@users.noreply.github.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/shanewas/agentic-stealth-browser
+Project-URL: Repository, https://github.com/shanewas/agentic-stealth-browser
+Project-URL: Issues, https://github.com/shanewas/agentic-stealth-browser/issues
+Project-URL: Documentation, https://github.com/shanewas/agentic-stealth-browser/tree/master/docs
+Project-URL: Changelog, https://github.com/shanewas/agentic-stealth-browser/blob/master/CHANGELOG.md
+Keywords: stealth,browser,automation,playwright,anti-bot,scraping,agent
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
+Classifier: Topic :: Software Development :: Testing
+Classifier: Framework :: AsyncIO
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: playwright
+Requires-Dist: aiohttp
+Requires-Dist: cryptography
+Requires-Dist: pyyaml
+Requires-Dist: fastapi
+Requires-Dist: jinja2
+Requires-Dist: uvicorn
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: httpx; extra == "dev"
+Dynamic: license-file
+
+# Agentic Stealth Browser
+
+**Playwright gets detected. This doesn't.**
+
+[![CI](https://github.com/shanewas/agentic-stealth-browser/actions/workflows/ci.yml/badge.svg)](https://github.com/shanewas/agentic-stealth-browser/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![PyPI](https://img.shields.io/pypi/v/agentic-stealth-browser.svg)](https://pypi.org/project/agentic-stealth-browser/)
+[![Tests](https://img.shields.io/badge/tests-880%2B%20passing-brightgreen)](tests/)
+[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-support-ffdd00?logo=buy-me-a-coffee&logoColor=black)](https://buymeacoffee.com/shanewas)
+
+<p align="center">
+  <img src="assets/hn-demo.gif" alt="Agentic Stealth Browser Demo" width="90%">
+</p>
+
+Production-grade stealth browser automation that **survives Cloudflare, LinkedIn, Amazon, and other anti-bot systems** by looking convincingly human at every layer.
+
+```bash
+pip install agentic-stealth-browser
+playwright install --with-deps chromium
+```
+
+```python
+from core.agent_browser import AgentBrowser
+
+async with AgentBrowser(session_name="demo") as browser:
+    await browser.launch(headless=True)
+    await browser.safe_goto("https://bot.sannysoft.com")
+    # ✓ passes WebGL, Canvas, AudioContext, WebRTC, and TLS fingerprinting
+```
+
+---
+
+## Why vanilla Playwright fails
+
+Sites don't just check your User-Agent anymore. They check *everything*:
+
+| Attack Surface | Vanilla Playwright | This library |
+|---|---|---|
+| **TLS handshake** (JA3/JA4 fingerprint) | Standard Python TLS — instantly identifiable | Region-spoofed profiles (US, Japan, EU, Korea) |
+| **Navigator APIs** (`navigator.webdriver`, `plugins`, `languages`) | Leaks automation flags everywhere | Every property patched before first paint |
+| **WebGL / Canvas fingerprint** | Headless GPU renders differently | Consistent buffers across sessions |
+| **Human behavior** | Robotic clicks, instant typing | Bézier mouse curves, variable speed, fatigue simulation |
+| **Auto-recovery** | None — blocks = failure | CAPTCHA detection → proxy rotation → retry chain |
+| **Account warming** | Nothing | 14-day graduated ramp-up per account |
+
+Result: **passes bot.sannysoft.com, pixelscan.net, and CreepJS** with zero flags in headless mode.
+
+---
+
+## Quick Start
+
+### CLI (easiest)
+
+```bash
+# Health check + stealth fingerprint test
+stealth-browser health --preset linkedin_2026 --region us
+
+# Start the operator dashboard
+agentic-stealth-browser dashboard
+```
+
+### Python SDK
+
+```python
+from core.agent_browser import AgentBrowser
+
+async with AgentBrowser(
+    session_name="my-session",
+    region="japan",
+    headless=True
+) as browser:
+    await browser.launch()
+    await browser.safe_goto("https://example.com")
+    # TLS-spoofed, no webdriver leak, human-like interaction ready
+```
+
+### MCP (for AI agent clients)
+
+```json
+{
+  "mcpServers": {
+    "stealth-browser": {
+      "command": "python",
+      "args": ["-m", "production.mcp_server"]
+    }
+  }
+}
+```
+
+Then: `stealth_launch` → `stealth_navigate` → `stealth_scrape` → `stealth_close`.
+
+---
+
+## Key Features
+
+| Feature | What It Does |
+|---|---|
+| **TLS Fingerprinting** | JA3/JA4 region profiles |
+| **Human Behavior** | Mouse wobble, typing mistakes, fatigue, distraction |
+| **Auto Recovery** | Block detection → proxy/session rotation → retry |
+| **Account Warming** | 14-day gradual ramp-up for new accounts |
+| **Workflow Orchestrator** | Queue, schedule, domain concurrency, retries, persistence |
+| **Python SDK** | `StealthClient` — async API without MCP |
+| **Security Governance** | Input validation, session isolation, policy engine, approval gates |
+| **Adaptive Stealth** | Per-domain behavior profiles with FeedbackStore telemetry |
+| **Plugin System** | Lifecycle hooks via `BasePlugin` |
+| **Operator Dashboard** | Live DevTools, CAPTCHA intervention, workflow recording |
+| **Feature Flags** | Runtime capability discovery per browser backend |
+| **Performance Profiling** | Timing decorators + `perf_benchmark.py` |
+
+---
+
+## Full Documentation
+
+- **Workflow System** — record real browser actions via CDP, replay as YAML (13 step types)
+- **Operator Dashboard** — Grok/X-inspired dark UI, live browser view, CAPTCHA solving, workflow recording
+- **Orchestrator** — queue, schedule, chain workflows with domain-aware concurrency
+- **Security** — input validation, session isolation, policy engine, approval gates
+- **SDK** — `StealthClient` async API without MCP
+- **Plugins** — lifecycle hooks for custom behavior
+- **VPS Deployment** — systemd, Caddy reverse proxy, Cloudflare Tunnel patterns
+- **Migration v1 → v2** — deprecation shims, migration guide, script
+
+See sections below for each topic. For release history: [CHANGELOG.md](CHANGELOG.md).
+
+---
+
+## Project Structure
+
+```
+├── core/           AgentBrowser, connection pool, session checkpoints
+├── stealth/        TLS, scripts, Firefox adapter, caching
+├── behavior/       Human simulation, personas, adaptive tuning
+├── recovery/       Anti-block orchestrator
+├── workflows/      Recorder, player, schema, library
+├── production/     MCP server, SDK, orchestrator, security, profiler
+├── plugins/        Plugin system with template
+├── scripts/        Migration, evaluation, benchmarking
+└── tests/          880+ contract + integration tests
+```
+
+## License
+
+MIT. See [LICENSE](LICENSE) and [CHANGELOG.md](CHANGELOG.md).

agentic_stealth_browser-2.3.0/README.md

@@ -0,0 +1,145 @@
+# Agentic Stealth Browser
+
+**Playwright gets detected. This doesn't.**
+
+[![CI](https://github.com/shanewas/agentic-stealth-browser/actions/workflows/ci.yml/badge.svg)](https://github.com/shanewas/agentic-stealth-browser/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![PyPI](https://img.shields.io/pypi/v/agentic-stealth-browser.svg)](https://pypi.org/project/agentic-stealth-browser/)
+[![Tests](https://img.shields.io/badge/tests-880%2B%20passing-brightgreen)](tests/)
+[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-support-ffdd00?logo=buy-me-a-coffee&logoColor=black)](https://buymeacoffee.com/shanewas)
+
+<p align="center">
+  <img src="assets/hn-demo.gif" alt="Agentic Stealth Browser Demo" width="90%">
+</p>
+
+Production-grade stealth browser automation that **survives Cloudflare, LinkedIn, Amazon, and other anti-bot systems** by looking convincingly human at every layer.
+
+```bash
+pip install agentic-stealth-browser
+playwright install --with-deps chromium
+```
+
+```python
+from core.agent_browser import AgentBrowser
+
+async with AgentBrowser(session_name="demo") as browser:
+    await browser.launch(headless=True)
+    await browser.safe_goto("https://bot.sannysoft.com")
+    # ✓ passes WebGL, Canvas, AudioContext, WebRTC, and TLS fingerprinting
+```
+
+---
+
+## Why vanilla Playwright fails
+
+Sites don't just check your User-Agent anymore. They check *everything*:
+
+| Attack Surface | Vanilla Playwright | This library |
+|---|---|---|
+| **TLS handshake** (JA3/JA4 fingerprint) | Standard Python TLS — instantly identifiable | Region-spoofed profiles (US, Japan, EU, Korea) |
+| **Navigator APIs** (`navigator.webdriver`, `plugins`, `languages`) | Leaks automation flags everywhere | Every property patched before first paint |
+| **WebGL / Canvas fingerprint** | Headless GPU renders differently | Consistent buffers across sessions |
+| **Human behavior** | Robotic clicks, instant typing | Bézier mouse curves, variable speed, fatigue simulation |
+| **Auto-recovery** | None — blocks = failure | CAPTCHA detection → proxy rotation → retry chain |
+| **Account warming** | Nothing | 14-day graduated ramp-up per account |
+
+Result: **passes bot.sannysoft.com, pixelscan.net, and CreepJS** with zero flags in headless mode.
+
+---
+
+## Quick Start
+
+### CLI (easiest)
+
+```bash
+# Health check + stealth fingerprint test
+stealth-browser health --preset linkedin_2026 --region us
+
+# Start the operator dashboard
+agentic-stealth-browser dashboard
+```
+
+### Python SDK
+
+```python
+from core.agent_browser import AgentBrowser
+
+async with AgentBrowser(
+    session_name="my-session",
+    region="japan",
+    headless=True
+) as browser:
+    await browser.launch()
+    await browser.safe_goto("https://example.com")
+    # TLS-spoofed, no webdriver leak, human-like interaction ready
+```
+
+### MCP (for AI agent clients)
+
+```json
+{
+  "mcpServers": {
+    "stealth-browser": {
+      "command": "python",
+      "args": ["-m", "production.mcp_server"]
+    }
+  }
+}
+```
+
+Then: `stealth_launch` → `stealth_navigate` → `stealth_scrape` → `stealth_close`.
+
+---
+
+## Key Features
+
+| Feature | What It Does |
+|---|---|
+| **TLS Fingerprinting** | JA3/JA4 region profiles |
+| **Human Behavior** | Mouse wobble, typing mistakes, fatigue, distraction |
+| **Auto Recovery** | Block detection → proxy/session rotation → retry |
+| **Account Warming** | 14-day gradual ramp-up for new accounts |
+| **Workflow Orchestrator** | Queue, schedule, domain concurrency, retries, persistence |
+| **Python SDK** | `StealthClient` — async API without MCP |
+| **Security Governance** | Input validation, session isolation, policy engine, approval gates |
+| **Adaptive Stealth** | Per-domain behavior profiles with FeedbackStore telemetry |
+| **Plugin System** | Lifecycle hooks via `BasePlugin` |
+| **Operator Dashboard** | Live DevTools, CAPTCHA intervention, workflow recording |
+| **Feature Flags** | Runtime capability discovery per browser backend |
+| **Performance Profiling** | Timing decorators + `perf_benchmark.py` |
+
+---
+
+## Full Documentation
+
+- **Workflow System** — record real browser actions via CDP, replay as YAML (13 step types)
+- **Operator Dashboard** — Grok/X-inspired dark UI, live browser view, CAPTCHA solving, workflow recording
+- **Orchestrator** — queue, schedule, chain workflows with domain-aware concurrency
+- **Security** — input validation, session isolation, policy engine, approval gates
+- **SDK** — `StealthClient` async API without MCP
+- **Plugins** — lifecycle hooks for custom behavior
+- **VPS Deployment** — systemd, Caddy reverse proxy, Cloudflare Tunnel patterns
+- **Migration v1 → v2** — deprecation shims, migration guide, script
+
+See sections below for each topic. For release history: [CHANGELOG.md](CHANGELOG.md).
+
+---
+
+## Project Structure
+
+```
+├── core/           AgentBrowser, connection pool, session checkpoints
+├── stealth/        TLS, scripts, Firefox adapter, caching
+├── behavior/       Human simulation, personas, adaptive tuning
+├── recovery/       Anti-block orchestrator
+├── workflows/      Recorder, player, schema, library
+├── production/     MCP server, SDK, orchestrator, security, profiler
+├── plugins/        Plugin system with template
+├── scripts/        Migration, evaluation, benchmarking
+└── tests/          880+ contract + integration tests
+```
+
+## License
+
+MIT. See [LICENSE](LICENSE) and [CHANGELOG.md](CHANGELOG.md).

agentic_stealth_browser-2.3.0/agentic_stealth_browser.egg-info/PKG-INFO

@@ -0,0 +1,184 @@
+Metadata-Version: 2.4
+Name: agentic-stealth-browser
+Version: 2.3.0
+Summary: Production-grade, human-mimicking browser automation framework for autonomous agents. Survives modern anti-bot systems.
+Author-email: Shane W <shanewas@users.noreply.github.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/shanewas/agentic-stealth-browser
+Project-URL: Repository, https://github.com/shanewas/agentic-stealth-browser
+Project-URL: Issues, https://github.com/shanewas/agentic-stealth-browser/issues
+Project-URL: Documentation, https://github.com/shanewas/agentic-stealth-browser/tree/master/docs
+Project-URL: Changelog, https://github.com/shanewas/agentic-stealth-browser/blob/master/CHANGELOG.md
+Keywords: stealth,browser,automation,playwright,anti-bot,scraping,agent
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
+Classifier: Topic :: Software Development :: Testing
+Classifier: Framework :: AsyncIO
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: playwright
+Requires-Dist: aiohttp
+Requires-Dist: cryptography
+Requires-Dist: pyyaml
+Requires-Dist: fastapi
+Requires-Dist: jinja2
+Requires-Dist: uvicorn
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: httpx; extra == "dev"
+Dynamic: license-file
+
+# Agentic Stealth Browser
+
+**Playwright gets detected. This doesn't.**
+
+[![CI](https://github.com/shanewas/agentic-stealth-browser/actions/workflows/ci.yml/badge.svg)](https://github.com/shanewas/agentic-stealth-browser/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![PyPI](https://img.shields.io/pypi/v/agentic-stealth-browser.svg)](https://pypi.org/project/agentic-stealth-browser/)
+[![Tests](https://img.shields.io/badge/tests-880%2B%20passing-brightgreen)](tests/)
+[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-support-ffdd00?logo=buy-me-a-coffee&logoColor=black)](https://buymeacoffee.com/shanewas)
+
+<p align="center">
+  <img src="assets/hn-demo.gif" alt="Agentic Stealth Browser Demo" width="90%">
+</p>
+
+Production-grade stealth browser automation that **survives Cloudflare, LinkedIn, Amazon, and other anti-bot systems** by looking convincingly human at every layer.
+
+```bash
+pip install agentic-stealth-browser
+playwright install --with-deps chromium
+```
+
+```python
+from core.agent_browser import AgentBrowser
+
+async with AgentBrowser(session_name="demo") as browser:
+    await browser.launch(headless=True)
+    await browser.safe_goto("https://bot.sannysoft.com")
+    # ✓ passes WebGL, Canvas, AudioContext, WebRTC, and TLS fingerprinting
+```
+
+---
+
+## Why vanilla Playwright fails
+
+Sites don't just check your User-Agent anymore. They check *everything*:
+
+| Attack Surface | Vanilla Playwright | This library |
+|---|---|---|
+| **TLS handshake** (JA3/JA4 fingerprint) | Standard Python TLS — instantly identifiable | Region-spoofed profiles (US, Japan, EU, Korea) |
+| **Navigator APIs** (`navigator.webdriver`, `plugins`, `languages`) | Leaks automation flags everywhere | Every property patched before first paint |
+| **WebGL / Canvas fingerprint** | Headless GPU renders differently | Consistent buffers across sessions |
+| **Human behavior** | Robotic clicks, instant typing | Bézier mouse curves, variable speed, fatigue simulation |
+| **Auto-recovery** | None — blocks = failure | CAPTCHA detection → proxy rotation → retry chain |
+| **Account warming** | Nothing | 14-day graduated ramp-up per account |
+
+Result: **passes bot.sannysoft.com, pixelscan.net, and CreepJS** with zero flags in headless mode.
+
+---
+
+## Quick Start
+
+### CLI (easiest)
+
+```bash
+# Health check + stealth fingerprint test
+stealth-browser health --preset linkedin_2026 --region us
+
+# Start the operator dashboard
+agentic-stealth-browser dashboard
+```
+
+### Python SDK
+
+```python
+from core.agent_browser import AgentBrowser
+
+async with AgentBrowser(
+    session_name="my-session",
+    region="japan",
+    headless=True
+) as browser:
+    await browser.launch()
+    await browser.safe_goto("https://example.com")
+    # TLS-spoofed, no webdriver leak, human-like interaction ready
+```
+
+### MCP (for AI agent clients)
+
+```json
+{
+  "mcpServers": {
+    "stealth-browser": {
+      "command": "python",
+      "args": ["-m", "production.mcp_server"]
+    }
+  }
+}
+```
+
+Then: `stealth_launch` → `stealth_navigate` → `stealth_scrape` → `stealth_close`.
+
+---
+
+## Key Features
+
+| Feature | What It Does |
+|---|---|
+| **TLS Fingerprinting** | JA3/JA4 region profiles |
+| **Human Behavior** | Mouse wobble, typing mistakes, fatigue, distraction |
+| **Auto Recovery** | Block detection → proxy/session rotation → retry |
+| **Account Warming** | 14-day gradual ramp-up for new accounts |
+| **Workflow Orchestrator** | Queue, schedule, domain concurrency, retries, persistence |
+| **Python SDK** | `StealthClient` — async API without MCP |
+| **Security Governance** | Input validation, session isolation, policy engine, approval gates |
+| **Adaptive Stealth** | Per-domain behavior profiles with FeedbackStore telemetry |
+| **Plugin System** | Lifecycle hooks via `BasePlugin` |
+| **Operator Dashboard** | Live DevTools, CAPTCHA intervention, workflow recording |
+| **Feature Flags** | Runtime capability discovery per browser backend |
+| **Performance Profiling** | Timing decorators + `perf_benchmark.py` |
+
+---
+
+## Full Documentation
+
+- **Workflow System** — record real browser actions via CDP, replay as YAML (13 step types)
+- **Operator Dashboard** — Grok/X-inspired dark UI, live browser view, CAPTCHA solving, workflow recording
+- **Orchestrator** — queue, schedule, chain workflows with domain-aware concurrency
+- **Security** — input validation, session isolation, policy engine, approval gates
+- **SDK** — `StealthClient` async API without MCP
+- **Plugins** — lifecycle hooks for custom behavior
+- **VPS Deployment** — systemd, Caddy reverse proxy, Cloudflare Tunnel patterns
+- **Migration v1 → v2** — deprecation shims, migration guide, script
+
+See sections below for each topic. For release history: [CHANGELOG.md](CHANGELOG.md).
+
+---
+
+## Project Structure
+
+```
+├── core/           AgentBrowser, connection pool, session checkpoints
+├── stealth/        TLS, scripts, Firefox adapter, caching
+├── behavior/       Human simulation, personas, adaptive tuning
+├── recovery/       Anti-block orchestrator
+├── workflows/      Recorder, player, schema, library
+├── production/     MCP server, SDK, orchestrator, security, profiler
+├── plugins/        Plugin system with template
+├── scripts/        Migration, evaluation, benchmarking
+└── tests/          880+ contract + integration tests
+```
+
+## License
+
+MIT. See [LICENSE](LICENSE) and [CHANGELOG.md](CHANGELOG.md).

{agentic_stealth_browser-2.1.1 → agentic_stealth_browser-2.3.0}/core/agent_browser.py

@@ -250,6 +250,7 @@ class AgentBrowser:
         self.use_pooled_context: bool = use_pooled_context  # #57/#48/#47 scalability: when True, launch uses shared browser pool instead of per-instance launch_persistent_context
         self._using_pool: bool = False
         self._pooled_ctx_id: Optional[int] = None  # track for release
+        self._browser_process = None  # set after launch for PID tracking
 
         # #136: Tool-level rate limiter for public API surface (MCP tool calls)
         if rate_limits is not None:
@@ -636,6 +637,14 @@ class AgentBrowser:
             self.browser = await pw.chromium.launch_persistent_context(**lp_kwargs)
             self.browser_context = self.browser
 
+            # Capture browser subprocess PID for external lifecycle management
+            try:
+                pw_browser_obj = self.browser.browser  # BrowserContext -> Browser
+                if pw_browser_obj is not None:
+                    self._browser_process = pw_browser_obj.process
+            except Exception:
+                self._browser_process = None
+
             # #377: discover CDP WS endpoint if enabled (uses Chrome's DevToolsActivePort + /json/version; stdlib only)
             if getattr(self, "debug_cdp", False):
                 try:

{agentic_stealth_browser-2.1.1 → agentic_stealth_browser-2.3.0}/production/mcp_server.py

@@ -32,7 +32,7 @@ JSONRPC_VERSION = "2.0"
 PROTOCOL_VERSION = "2025-03-26"
 SERVER_NAME = "agentic-stealth-browser"
 SERVER_TITLE = "Agentic Stealth Browser MCP Server"
-SERVER_VERSION = "2.1.0"
+SERVER_VERSION = "2.3.0"
 
 
 class ToolError(Exception):

{agentic_stealth_browser-2.1.1 → agentic_stealth_browser-2.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agentic-stealth-browser"
-version = "2.1.1"
+version = "2.3.0"
 description = "Production-grade, human-mimicking browser automation framework for autonomous agents. Survives modern anti-bot systems."
 readme = "README.md"
 license = "MIT"