v1.11.0

jo-inc/camofox-browserv1.11.0May 24, 2026by skyfallsin

AI Summary

Adds Windows support, OpenClaw compatibility, cross-origin iframe interaction, and production reliability improvements.

Key Highlights

  • Windows users can build and run without WSL or `make`.
  • OpenClaw compatibility via `contracts.tools` metadata.
  • Cross-origin iframe interaction in accessibility snapshots.
  • Security hardening for sensitive routes requiring configured auth.
  • Idle shutdown no longer leaks orphaned Camoufox processes.

New Features

  • Windows support
  • OpenClaw compatibility
  • Cross-origin iframe interaction
  • Security hardening

Full Release Notes

## Windows Support

Windows users can now build and run camofox-browser without WSL or `make`.

This release adds a PowerShell `build.ps1` workflow, enforces LF line endings for shell scripts, and fixes Docker builds from Windows checkouts by invoking shell scripts through `sh`. Plugin loading also works correctly on Windows now: plugins are imported via `file://` URLs instead of raw filesystem paths.

## OpenClaw Compatibility

OpenClaw 2026.5.x requires packages to declare tool ownership in `contracts.tools`. camofox-browser now ships that manifest metadata, fixing tool registration failures in newer OpenClaw versions.

Fixes #3141 and #3392.

## Cross-Origin Iframe Interaction

Accessibility snapshots now traverse supported iframes, and refs can resolve back into their owning frames. This makes embedded checkout/payment fields visible and clickable through the normal ref-based flow.

Tracking and analytics iframes are filtered out so snapshots stay focused on actionable page content.

## Security Hardening

Several sensitive routes now require configured auth:

- `POST /tabs/:tabId/evaluate`
- `DELETE /sessions/:userId`
- `POST /pressure/cleanup`

Cookie import now uses the shared auth middleware too. If you expose camofox-browser beyond loopback, verify your `CAMOFOX_API_KEY` / `CAMOFOX_ACCESS_KEY` setup before upgrading.

## Production Reliability

This release pulls in reliability fixes from jo production usage:

- Idle shutdown no longer leaks orphaned Camoufox processes
- Browser close now force-cleans escaped child processes
- Health checks stay green after idle browser shutdown
- Stale tab errors are clearer and more recoverable
- Active tab operations refresh session access time so live sessions are not expired
- Popups from `target=_blank` and `window.open` are tracked as managed tabs
- Tab operations are better serialized with per-tab locks
- Navigation timeout cleanup avoids poisoning proxy-backed sessions
- YouTube transcript session cleanup handles races more safely
- Crash/stall reporter no longer treats `429` relay responses as successful delivery

## Fixes & Improvements

- Prometheus metrics are lazy-loaded and disabled by default unless explicitly enabled
- Snapshot size metrics added
- Navigate requests are aborted when their tab is deleted
- Retry-path `const` reassignment crashes fixed
- VNC plugin config is explicit and disabled by default
- Optional Sentry integration no longer prevents server startup when Sentry is not installed

## Thank You

Thanks to:

- @kgarg2468 — OpenClaw contracts and Windows/Electron feedback
- @SirBrenton — reporter 429 handling
- @sebastiondev — auth hardening
- @Chen-538 — Windows plugin loading fix
- @dawsman — VNC config cleanup
- @pasmud — Windows build support