> ## Documentation Index > Fetch the complete documentation index at: https://docs.webrayn.dev/llms.txt > Use this file to discover all available pages before exploring further. # Changelog > Version history for webrain. # Changelog All notable changes, in reverse chronological order. The full version lives in [`CHANGELOG.md`](https://github.com/prokopis3/webrain/blob/main/CHANGELOG.md). ## v0.4.0

August 6, 2026

### New Features * **Agent-browser interaction primitives** — `webrain_select`, `webrain_hover`, `webrain_check`, `webrain_dialog`, `webrain_wait`, `webrain_upload` on the element-index model. * **Trusted CDP input** — click/type/press via `Input.*` CDP events with a JS fallback; `webrain_click_coords` for cross-origin/reCAPTCHA; stable backend-node clicks; single-fire click; click-hang bounded on sync dialogs. * **Extraction** — `webrain_flatten` (Shadow DOM composed text), `webrain_annotate` (numbered boxes for vision models), `webrain_fit` (dense-content extractor). * **Signals** — `webrain_add_init_script`, Chrome error-page detection (`chrome_error`), `needs_js`/`visible_chars` on the HTTP probe, `crippled` bot-shell hint. * **Docs** — multi-agent delegation doctrine in the agent decision guide. ### Bug Fixes * **`webrain upgrade`** closes other running webrain instances before `scoop update`, so Scoop can replace the binary. *** ## v0.3.3

August 5, 2026

### New Features * Added a **runtime-flow** architecture page (`concepts/runtime-flow.mdx`) - CLI entrypoint → MCP dispatcher → tool dispatch → CDP backend → engines, with a request-flow diagram and a symptom→layer failure table. * **`reference/tools.mdx`** gains a **tool-to-code map** (each tool family → implementation file, browser vs no-browser, shared vs engine-specific). * **`concepts/browsers.mdx`** gains an **engine capability matrix** (Chrome / Obscura / Lightpanda / `fetch_http`). * Light/dark **logo variants** for the Mintlify theme + a GitHub icon in the navbar. ### Bug Fixes * **`webrain upgrade`** now spawns the package-manager update (brew / scoop) detached and exits, so Scoop no longer sees the upgrade command itself as a running instance of webrain and refuses to replace the binary. *** ## v0.3.2

August 5, 2026

### Documentation * Added a **full Mintlify docs site** in `docs/` - overview, quickstart, installation, browsers/challenges concepts, extraction / scrape-at-scale / auth-and-login guides, a full 51-tool reference, CLI + env reference, deployment, troubleshooting, and contributing. Existing `docs/*.md` files left in place, untouched. * Added the **`docs/changelog.mdx`** changelog map, linked in the Project nav. * **quickstart.mdx** and the README now show the **full MCP client setup** (stdio + HTTP transports, VS Code / Claude Desktop / Cursor configs, `webrain_guide` verification). * Added a **Prerequisites** section to the README and docs site. * Added **`.mintignore`** so the ADR / legacy markdown files stay on disk but out of the Mintlify build (fixes the ADR MDX parse error). * Refreshed **ADR-001** graph note - 875 nodes / 2287 edges, 3 entry points, 51 MCP tools, new hotspots. ### Improvements * Upgraded **`skills/webrain/SKILL.md`** to a full agent-skill contract - richer frontmatter, `When to use`, recommended limits, and a 7-step end-to-end invocation flow. * Ran `cargo fmt` on the mcp session-routing match indent. *** ## v0.3.1

August 5, 2026

### New Features * **`webrain install --engine lightpanda`** now downloads the lightpanda binary from the `lightpanda-io/browser` GitHub release into the engine cache, mirroring `--engine obscura`; `find_lightpanda()` also discovers the cached build. No Windows binary - the install bails with the Docker fallback instead of silently installing Chrome. ### Improvements * **`webrain install --engine `** now errors clearly instead of silently installing Chrome. ### Bug Fixes * **`webrain_open_session(cdp_url=…)`** now actually routes tools to that session - every browser tool accepts an optional `session_id`. * A browser kill/restart no longer wedges the cached backend forever - dead-socket errors drop the backend so the next call reconnects. * The CDP WebSocket connect retries once with a longer budget (20s), tolerating obscura's slow cold-start handshake. *** ## v0.3.0

August 5, 2026

### New Features * **`webrain_page_info`** - just-in-time page context (viewport/page size, scroll position, position %). * **`webrain_save_state` / `webrain_restore_state`** - export/import a profile's auth state (cookies + localStorage) across machines. * **`webrain -v` / `--version` / `version`**. ### Bug Fixes * **`webrain install`** failed with "response body is larger than request limit" - ureq's 10 MB cap was too small for the Chrome/Obscura engine zips; now reads via the unlimited reader. ### Improvements * Rewrote the **README** - install-first, "Why webrain?", use-cases, Scoop extras. * Moved the **Dockerfile** into `docker/` and added `docker-compose.yml` (persistent vault/profile/cache volumes). * Deduped the **JS→JSON parse chain** in `tools.rs` into `parse_json_str` / `arr_len`. *** ## v0.2.0

August 5, 2026

### New Features * **`webrain upgrade`** - updates to the latest release (Homebrew/Scoop-aware, else self-updates the binary in place). * **One-line installers** - `scripts/install.sh` (Linux/macOS) and `scripts/install.ps1` (Windows). * Submitted to the official **Scoop `extras`** bucket and published a **Homebrew tap** (`prokopis3/homebrew-webrain`). * Added **`CONTRIBUTING.md`**, README badges, and the Quick Start + Traditional Selectors + Commands + Updating sections. *** ## v0.1.1

August 4, 2026

### New Features * **All-OS install one-liners** (PowerShell + curl) and the working **scoop bucket** (`prokopis3/scoop-webrain`). ### Bug Fixes * The **Linux release binary** now builds on `ubuntu-22.04` (glibc 2.35) - the previous `ubuntu-latest` build required glibc 2.39. *** ## v0.1.0

August 4, 2026

### New Features * **Cargo workspace** (`resolver 3`, `edition 2024`, Rust 1.85) with `webrain-core` / `webrain-mcp` / `webrain-cli`; MIT license; CI + release + changelog-enforce workflows. * **Rust CDP browser-automation agent** - one `BrowserBackend` trait over CDP WebSocket (`CdpBackend`) driving Chrome, Edge, Lightpanda, or Obscura; `SessionPool` isolation; `STEALTH_JS` anti-bot injection. * **stdio MCP server** owning the CDP connection, 25-tool dispatch table. * **Single `webrain` binary**, `match`-based subcommands (no clap) mirroring the MCP tool surface. * Page interaction (navigate/eval/click/type/press/scroll/snapshot, multi-tab, a11y), capture (screenshot, PDF, PixelRAG vision tiles + cosine `VectorStore`), extraction (`extract_json` / `extract_regex` / `eval`), spider + web search, batch + download. * **`webrain doctor`** - full install diagnosis. * **agent-browser-style engine install** - `webrain install` downloads Chrome for Testing (and `--engine obscura`); `webrain lightpanda` / `webrain obscura` spawn CDP servers.