Skip to content

Add sync and async session WebMCP support - #137

Merged
NikhilShahi merged 3 commits into
mainfrom
codex/webmcp
Oct 10, 2026
Merged

NikhilShahi merged 3 commits into
mainfrom
codex/webmcp

Conversation

@NikhilShahi

@NikhilShahi NikhilShahi commented Oct 10, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

Changes

Validation

  • ruff check
  • pytest

Note

Medium Risk
New session feature and HTTP client behavior (GET timeouts, richer errors); tool invocations can have side effects and are explicitly not retried on failure.

Overview
Adds WebMCP page tools to the Python SDK so agents can discover and run document-bound tools in browser sessions created with enable_web_mcp.

client.sessions.webmcp (sync and async) exposes list_tools, blocking invoke, async start / get_result / cancel, with per-call HTTP timeouts tuned for long polls and invocations. Session CreateSessionParams and launch state gain enable_web_mcp; new Pydantic and TypedDict types live under hyperbrowser.models and hyperbrowser.types.

Transport GET now accepts an optional timeout; API errors surface code and details on HyperbrowserError. README documents usage and semantics (no auto-retry on mutations, ephemeral handles). Version 1.11.0; tests cover wire contract, validation, and typechecking.

Reviewed by Cursor Bugbot for commit a6b4f54. Bugbot is set up for automated code reviews on this repo. Configure here.

@NikhilShahi
NikhilShahi merged commit 4427393 into main Oct 10, 2026
13 checks passed
@AHarmlessPyro
AHarmlessPyro deleted the codex/webmcp branch October 10, 2026 22:56
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.

2 participants