Policy date: 2026-08-27.
This guide is the canonical support policy for Jido Browser 2.x browser adapters and the BrowseyHttp web-fetch runtime. AgentBrowser is the supported default.
Support matrix
| Adapter or runtime | Tested upstream version | CI level | Maintenance promise | Support conditions |
|---|---|---|---|---|
| AgentBrowser | 0.35.1 | Required unit, quality, and Linux real-runtime smoke tests on each PR | Supported default for 2.x. Version or daemon protocol failures block a release. The project maintains the current public API and fixes compatibility and security defects. | Use AgentBrowser 0.35.1 and the supervised local daemon transport. The runtime rejects other AgentBrowser versions. The required smoke lane covers start, navigate, snapshot, click, type, read, and close. |
| Lightpanda | 0.3.0 | Required fake-runtime unit tests; opt-in real-runtime integration test | Limited support for the listed base operations and warm pools. The project fixes defects in those operations, but does not promise AgentBrowser feature parity. | Add light_cdp ~> 0.2.1 and lightpanda_ex ~> 0.1.0. Use the 0.3.0 binary baseline. Support includes session lifecycle, navigation, click, type, PNG screenshots, content extraction, JavaScript evaluation, and warm pools. AgentBrowser refs, state persistence, tab management, and console capture are not supported. |
| Vibium | 26.3.11 | Required installer and facade tests; opt-in real-runtime integration test | Compatibility support in 2.x. The adapter is feature-frozen. The project fixes critical compatibility and security defects in its current operations. | Use Vibium 26.3.11. Support is for unpooled sessions and the current navigation, click, type, PNG screenshot, content extraction, and JavaScript evaluation operations. Markdown extraction uses Vibium plain text. Newer Vibium releases are not part of this support promise. |
| Web | No version tag. The installer uses upstream main, at ef008308 on the policy date. | Required fake-runtime unit tests; opt-in real-runtime integration test | Deprecated. Only critical compatibility and security fixes are accepted in 2.x. The Web adapter will be removed in 3.0. | Use only for migration of existing browser sessions and warm pools. The installer does not pin an immutable upstream release. Move to AgentBrowser before 3.0. |
| BrowseyHttp | Vendored upstream commit 0324a26d, with documented local patches | Required vendored-runtime unit tests; opt-in external-network smoke test | Deprecated. Only critical compatibility and security fixes are accepted in 2.x. BrowseyHttp and its curl-impersonate assets will be removed in 3.0. | Use only for migration of existing :browsey web-fetch calls. It does not execute JavaScript. Move HTTP retrieval to the default Req backend. Use AgentBrowser when a page needs a rendered browser. |
"Required" means that the check runs in the normal pull-request CI. "Opt-in"
means that the test has the :integration tag and the normal test command
excludes it. An opt-in test does not make an upstream runtime part of the
required CI promise.
Evidence
The AgentBrowser decision comes from issue #74 and the version and transport research. That research tested the published 0.35.1 runtime with local fixtures. The required AgentBrowser smoke workflow was added by issue #65 and PR #107.
The other CI levels come from the current test configuration and adapter tests:
test/test_helper.exsexcludes all integration tests from the normal test command.- The Lightpanda unit and integration tests define its verified operations. The adapter module defines its optional dependency and feature conditions.
- The Vibium installer pins 26.3.11. Its local-fixture integration test covers the operations in the matrix.
- The Web unit tests use a controlled fake binary. Its local-fixture integration
test is opt-in. The installer uses the unversioned upstream
mainbranch. - The BrowseyHttp source records the exact upstream commit and local changes in its vendor record. Unit tests cover backend routing, result normalization, option validation, and vendored runtime validation. The real network smoke test is opt-in.
Migration
For the Web adapter, select Jido.Browser.Adapters.AgentBrowser and install the
supported AgentBrowser runtime. AgentBrowser is the normal replacement because
both adapters provide stateful browser sessions.
For BrowseyHttp, select :req or
Jido.Browser.WebFetch.Backends.Req for stateless HTTP retrieval. Select
AgentBrowser only when the page needs JavaScript or browser rendering.
The 3.0 removal work is tracked in #80 for Web and #81 for BrowseyHttp.