Skip to content

feat(browser-runtime): add native Kernel support - #311

Merged
Perry2004 merged 3 commits into
TIGER-AI-Lab:mainfrom
kernel:hypeship/kernel-runtime-upstream
Aug 21, 2026
Merged

feat(browser-runtime): add native Kernel support#311
Perry2004 merged 3 commits into
TIGER-AI-Lab:mainfrom
kernel:hypeship/kernel-runtime-upstream

Conversation

@rgarcia

@rgarcia rgarcia commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

What does this PR do?

Adds Kernel as a managed browser runtime:

uv run clawbench-run test-cases/v2/<case> <model> \
  --browser-runtime kernel \
  --browser-runtime-options '{"stealth":true,"region":"us-east"}'

The integration creates a Kernel browser, connects the existing ClawBench runtime and harness over CDP, captures the standard action/request/screenshot/message artifacts, downloads the Kernel replay as data/recording.mp4, and deletes the browser after the run.

No new package dependency is required; the provider uses Kernel's REST API through the standard library.

Lifecycle

The new KernelRuntimeProvider handles:

  1. Browser creation using KERNEL_API_KEY and optional KERNEL_BASE_URL.
  2. Runtime options for stealth, region, proxy, and tags.
  3. Replay creation before the harness connects.
  4. Replay stop, processing polling, documented HTTP 202 retry handling, and MP4 download.
  5. Browser deletion on success, failure, interruption, or replay errors.

Replay finalization uses a shared five-minute deadline. Missing or invalid recordings produce browser_runtime_artifact_failed rather than silently marking the run successful.

Managed-runtime behavior

This also generalizes behavior that was previously specific to Browserbase:

  • managed runtimes default to batch concurrency 1;
  • batch runs hide credential-bearing viewer URLs;
  • recording behavior is selected through provider capabilities;
  • claude-code-chrome-extension is rejected for managed runtimes because it requires its own browser process inside the container.

Local, remote-CDP, Steel, and Browserbase behavior remains unchanged.

User-facing changes

  • Adds kernel to CLI and TUI runtime selection.
  • Documents configuration and runtime options.
  • Adds provider-neutral managed-runtime messaging.
  • Updates the English and Chinese documentation and changelog.

Corpus

  • v2
  • v1
  • both
  • not applicable

Test plan

  • uv run ruff format --check .
  • uv run ruff check .
  • uv run pyright
  • uv run pytest -q — 203 passed
  • Real Kernel + browser-use run completed with interception and all five artifact layers.
  • Kernel replay downloaded as a playable MP4 and the browser was deleted.
  • 20-task V2 Hermes batch at concurrency 4 completed with zero infrastructure failures; all 20 replays downloaded and all 20 browsers were deleted.
  • Failure-path and HTTP 202 replay-processing behavior covered by unit tests.

Related issues

N/A

@Perry2004

Copy link
Copy Markdown
Collaborator

Thanks for the contribution, I'll take a look.
🫡

@Perry2004 Perry2004 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the contribution.
The PR LGTM, will merge and include in the next release. 🎉

@Perry2004
Perry2004 merged commit 9a92675 into TIGER-AI-Lab:main Aug 21, 2026
6 checks passed
@github-project-automation github-project-automation Bot moved this from Todo to Done in ClawBench Aug 21, 2026
@Perry2004 Perry2004 added enhancement New feature or request good first issue Good for newcomers labels Aug 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request good first issue Good for newcomers

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants