feat: CDPBrowser helper family — Obscura and Kitesurf mini-browser support - #5681

Merged

DavertMik merged 48 commits into

4.xfrom

feature/cdp-browser-helpers

Sep 8, 2026

Commits on Aug 6, 2026

fix(Puppeteer): tolerate missing bringToFront, refresh context on framenavigated, read innerText via evaluate

DavertMik
and
claude
committed
92a22f1
feat(CDPBrowser): add raw CDP WebSocket transport

DavertMik
and
claude
committed
f8c3489
fix(CDPConnection): guard message/listener dispatch and send guard

DavertMik
and
claude
committed
87ae3ba
feat(CDPBrowser): in-page query/action client and XPath polyfill builder

DavertMik
and
claude
committed
f392751
fix(CDPBrowser): visibleCount action must return result on zero matches

DavertMik
and
claude
committed
fe02a77
feat(CDPBrowser): core helper with raw-CDP lifecycle, navigation, evaluate

DavertMik
and
claude
committed
c358d2f
fix(CDPBrowser): use axios instead of global fetch for endpoint resolution

DavertMik
and
claude
committed
7140ea4
feat(CDPBrowser): assertions and grabbers

DavertMik
and
claude
committed
0f60a88
feat(CDPBrowser): interactions, waits, cookies, screenshots

DavertMik
and
claude
committed
8cd1342
fix(CDPBrowser): guard zero-size click, tolerate transient wait errors, fix screenshot test output dir

DavertMik
and
claude
committed
3ccb28b
feat(Obscura): helper for the Obscura mini-browser on CDPBrowser base

DavertMik
and
claude
committed
39bdff8
fix(Obscura): handle spawn error and bound the kill-escalation wait

DavertMik
and
claude
committed
ff73478
feat(Kitesurf): helper for Cloudflare Browser Run kitesurf browser

DavertMik
and
claude
committed
3972d9b
test(CDPBrowser): shared cross-helper spec for Chrome, Obscura, Kitesurf

DavertMik
and
claude
committed
4896a84

Commits on Aug 7, 2026

test(CDPBrowser): tunnel-proof Kitesurf pre-existing tests, untrack plans/006

DavertMik
and
claude
committed
5081556
ci: run Obscura helper tests on GitHub Actions

DavertMik
and
claude
committed
79fca38
docs: alternative browser engines guide and helper references

DavertMik
and
claude
committed
cf288ce
fix: final review wave — CI checksum on cache hits, workflow permissions, docs corrections, scroll-into-view clicks

DavertMik
and
claude
committed
0545cbe
feat(CDPBrowser): extend action surface for webapi spec coverage

DavertMik
and
claude
committed
7d90fec
test(CDPBrowser): run canonical webapi shared spec with visible skips instead of parallel spec

DavertMik
and
claude
committed
56b5b5a
fix(CDPBrowser): narrow cssProps payload, correct seeInField boolean semantics, regenerate docs

DavertMik
and
claude
committed
84444a6
test(CDPBrowser): loud prerequisite warnings and Obscura auto-spawn for local runs

DavertMik
and
claude
committed
4c98923
fix(typings): suppress duplicate identifier for new helper config types

DavertMik
and
claude
committed
350bbb5
feat(CDPBrowser): element-scoped within support

DavertMik
and
claude
committed
595a652
fix(CDPBrowser): sync select/checked attributes for engines serializing forms from attributes

DavertMik
and
claude
committed
e84835c
feat(CDPBrowser): support elementIndex/strict-mode step options

DavertMik
and
claude
committed
b11144f

Commits on Aug 8, 2026

feat(Obscura): support v0.2.0 rendering engine via capability detection

DavertMik
and
claude
committed
790d569
fix(CDPBrowser): jsdoc-parseable return type for _selectionDescriptor

DavertMik
and
claude
committed
db172f4
fix(CDPBrowser): deterministic Obscura suite — await within-block promise chains in shared webapi tests; null-safe assertion message templating

DavertMik
and
claude
committed
b551b9d
fix(test-data): derive cookie test URLs from siteUrl instead of hardcoded localhost

DavertMik
and
claude
committed
9af3916
feat(CDPBrowser): role locators + full skip-sweep implementation

DavertMik
and
claude
committed
a46085e
fix(typings): use resolvable types for grabWebElements return values

DavertMik
and
claude
committed
c07cfa2
feat(Obscura): self-managed server lifecycle with auto port selection

DavertMik
and
claude
committed
139daab
test(webapi): run cookie tests in CI

DavertMik
and
claude
committed
3d4c76d
fix(CDPBrowser): deterministic label focus forwarding and per-char key event typing

DavertMik
and
claude
committed
2db3021
feat(CDPBrowser): CDP screencast recording with APNG assembly

DavertMik
and
claude
committed
45eb9ea
feat(CDPBrowser): rich text editor support via input event fidelity

DavertMik
and
claude
committed
0e20c96
perf(CDPBrowser): push-based navigation waits, folded client check, batched typing

DavertMik
and
claude
committed
00697ef
perf(CDPBrowser): event-driven navigation waits with poll grace fallback, engine-property probes moved off the hot path

DavertMik
and
claude
committed
3913964
perf(CDPBrowser): in-page text matching without full-haystack serialization

DavertMik
and
claude
committed
5c0d72b
fix(typings): tsd-valid nullable types in CDPBrowser jsdoc

DavertMik
and
claude
committed
0081ef3
perf(CDPBrowser): event-aware action settle

DavertMik
and
claude
committed
1c976b1
test(bench): obscura vs playwright benchmark suite

DavertMik
and
claude
committed
0a27ad9
fix(typings): avoid nullable-shorthand-on-inline-object-shape in new CDPBrowser jsdoc

DavertMik
and
claude
committed
03abc54
docs(CDPBrowser): describe waitForAction's new event-aware-by-default behavior

DavertMik
and
claude
committed
7f948c7

Commits on Aug 9, 2026

test(Obscura): runner-level acceptance suite

DavertMik
and
claude
committed
0e6ee9f
test(acceptance): form filling e2e scenarios

DavertMik
and
claude
committed
3b2c044

Commits on Aug 21, 2026

fix(CDPBrowser): address review on Obscura binary lookup and Kitesurf session release

DavertMik
and
claude
committed
76d1ec3