Skip to content

feat(session): add enableWebBotAuth flag#76

Open
devin-ai-integration[bot] wants to merge 1 commit intomainfrom
devin/1777489845-web-bot-auth
Open

feat(session): add enableWebBotAuth flag#76
devin-ai-integration[bot] wants to merge 1 commit intomainfrom
devin/1777489845-web-bot-auth

Conversation

@devin-ai-integration
Copy link
Copy Markdown

@devin-ai-integration devin-ai-integration Bot commented Apr 29, 2026

Summary

Adds a new optional enableWebBotAuth boolean to CreateSessionParams and SessionLaunchState in src/types/session.ts. The field is a passthrough to the existing POST /api/session endpoint — no changes to src/services/sessions.ts are needed since it already JSON-serializes params verbatim.

When set to true, the server signs every outbound HTTP request from the browser session using Hyperbrowser's Cloudflare-verified bot identity per draft-meunier-web-bot-auth-architecture-02 and RFC 9421. The flag is mutually exclusive with useStealth and useUltraStealth.

This PR is the SDK-surface part of the rollout. Companion PRs:

  • hyperbrowserai/python-sdkenable_web_bot_auth field
  • hyperbrowserai/docssessions/web-bot-auth.mdx, OpenAPI schema, parameters reference
  • hyperbrowserai/marketing-site/.well-known/http-message-signatures-directory JWKS endpoint, blog post, changelog entry

The actual request signing + key management lives in metlo-labs/browserctrl (out of scope for this PR).

Review & Testing Checklist for Human

  • Confirm the enableWebBotAuth name choice (vs alternatives like webBotAuth: true or an identity enum). The plan picks enableWebBotAuth to match the existing enable* flag convention (enableWebRecording, enableLogCapture, etc.).
  • Confirm SDK ships before, after, or alongside the server-side signing work in browserctrl.

Notes

yarn lint and yarn build both pass.

Link to Devin session: https://app.devin.ai/sessions/10a58e30bd3e4ec58906f25eab6762a5
Requested by: @shrisukhani


Open in Devin Review

@devin-ai-integration
Copy link
Copy Markdown
Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

Copy link
Copy Markdown
Author

@devin-ai-integration devin-ai-integration Bot left a comment

Choose a reason for hiding this comment

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

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 1 additional finding.

Open in Devin Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant