hyperbrowser 1.12.0__tar.gz → 1.12.1__tar.gz

{hyperbrowser-1.12.0 → hyperbrowser-1.12.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyperbrowser
-Version: 1.12.0
+Version: 1.12.1
 Summary: Python SDK for hyperbrowser
 License: MIT
 License-File: LICENSE
@@ -97,6 +97,47 @@ Pydantic request/response models in `hyperbrowser.models`.
 See the [WebMCP guide](https://hyperbrowser.ai/docs/sessions/webmcp) for complete
 examples, cancellation behavior, human submission, and limits.
 
+## Web Bot Auth
+
+A session can sign its requests with Web Bot Auth so websites can verify that they
+come from Hyperbrowser. Web Bot Auth is enabled for teams on request.
+
+```python
+session = client.sessions.create({"web_bot_auth": True})
+print(session.launch_state.web_bot_auth.signature_agent)  # https://www.hyperbrowser.ai
+
+# Sign only requests to these hosts and their subdomains:
+client.sessions.create({"web_bot_auth": {"only_domains": ["example.com"]}})
+```
+
+Agent tasks accept `web_bot_auth` in `session_options`; scrape, crawl, and extract
+jobs do not. It cannot be combined with `use_ultra_stealth` or
+`start_from_snapshot`. See the
+[Web Bot Auth guide](https://hyperbrowser.ai/docs/sessions/web-bot-auth).
+
+## Proxy routes
+
+`proxy_routes` sends some hosts' traffic straight out instead of through the
+session's proxy, or the other way round. The first route that matches a host
+decides; hosts that no route matches use the proxy. Proxy routes require
+`use_proxy` and are enabled for teams on request.
+
+```python
+session = client.sessions.create({
+    "use_proxy": True,
+    "proxy_routes": [
+        {"match": "api.example.com", "proxy": "default"},  # stays on the proxy
+        {"match": ["*.example.com", "cdn.example.net"], "proxy": "direct"},
+    ],
+})
+```
+
+A pattern is a hostname, `*.example.com` (its subdomains, not `example.com`
+itself), or `*` (every host). Proxy routes only apply to `client.sessions.create`
+and cannot be combined with `allow_internet_access=False`, `allow_out`, or
+`deny_out`. See the
+[proxy routes guide](https://hyperbrowser.ai/docs/sessions/proxy-routes).
+
 ## Usage
 
 Hyperbrowser 1.0 accepts plain dictionaries for request parameters. Method

{hyperbrowser-1.12.0 → hyperbrowser-1.12.1}/README.md

@@ -68,6 +68,47 @@ Pydantic request/response models in `hyperbrowser.models`.
 See the [WebMCP guide](https://hyperbrowser.ai/docs/sessions/webmcp) for complete
 examples, cancellation behavior, human submission, and limits.
 
+## Web Bot Auth
+
+A session can sign its requests with Web Bot Auth so websites can verify that they
+come from Hyperbrowser. Web Bot Auth is enabled for teams on request.
+
+```python
+session = client.sessions.create({"web_bot_auth": True})
+print(session.launch_state.web_bot_auth.signature_agent)  # https://www.hyperbrowser.ai
+
+# Sign only requests to these hosts and their subdomains:
+client.sessions.create({"web_bot_auth": {"only_domains": ["example.com"]}})
+```
+
+Agent tasks accept `web_bot_auth` in `session_options`; scrape, crawl, and extract
+jobs do not. It cannot be combined with `use_ultra_stealth` or
+`start_from_snapshot`. See the
+[Web Bot Auth guide](https://hyperbrowser.ai/docs/sessions/web-bot-auth).
+
+## Proxy routes
+
+`proxy_routes` sends some hosts' traffic straight out instead of through the
+session's proxy, or the other way round. The first route that matches a host
+decides; hosts that no route matches use the proxy. Proxy routes require
+`use_proxy` and are enabled for teams on request.
+
+```python
+session = client.sessions.create({
+    "use_proxy": True,
+    "proxy_routes": [
+        {"match": "api.example.com", "proxy": "default"},  # stays on the proxy
+        {"match": ["*.example.com", "cdn.example.net"], "proxy": "direct"},
+    ],
+})
+```
+
+A pattern is a hostname, `*.example.com` (its subdomains, not `example.com`
+itself), or `*` (every host). Proxy routes only apply to `client.sessions.create`
+and cannot be combined with `allow_internet_access=False`, `allow_out`, or
+`deny_out`. See the
+[proxy routes guide](https://hyperbrowser.ai/docs/sessions/proxy-routes).
+
 ## Usage
 
 Hyperbrowser 1.0 accepts plain dictionaries for request parameters. Method

{hyperbrowser-1.12.0 → hyperbrowser-1.12.1}/hyperbrowser/models/__init__.py

@@ -195,6 +195,8 @@ from .consts import (
     ClaudeComputerUseReasoningEffort,
     CuaLlm,
     CuaReasoningEffort,
+    GeminiComputerUseLlm,
+    GeminiComputerUseReasoningEffort,
     GrokComputerUseLlm,
     GrokReasoningEffort,
     MetaComputerUseLlm,
@@ -343,6 +345,9 @@ from .session import (
     SessionProfile,
     SessionLaunchState,
     StartSessionFromSnapshotParams,
+    WebBotAuthParams,
+    ProxyRoute,
+    SessionWebBotAuth,
     UploadFileResponse,
     ImageCaptchaParam,
     CaptchaSolverType,
@@ -492,6 +497,8 @@ __all__ = [
     "ClaudeComputerUseReasoningEffort",
     "CuaLlm",
     "CuaReasoningEffort",
+    "GeminiComputerUseLlm",
+    "GeminiComputerUseReasoningEffort",
     "Country",
     "DownloadsStatus",
     "FetchScreenshotFormat",
@@ -704,6 +711,9 @@ __all__ = [
     "SessionProfile",
     "SessionLaunchState",
     "StartSessionFromSnapshotParams",
+    "WebBotAuthParams",
+    "ProxyRoute",
+    "SessionWebBotAuth",
     "UploadFileResponse",
     "ImageCaptchaParam",
     "CaptchaSolverType",

{hyperbrowser-1.12.0 → hyperbrowser-1.12.1}/hyperbrowser/models/agents/gemini_computer_use.py

@@ -5,7 +5,7 @@ from typing import Any, List, Literal, Optional
 from pydantic import BaseModel, ConfigDict, Field
 
 from ..session import CreateSessionParams
-from ..consts import GeminiComputerUseLlm
+from ..consts import GeminiComputerUseLlm, GeminiComputerUseReasoningEffort
 
 GeminiComputerUseTaskStatus = Literal[
     "pending", "running", "completed", "failed", "stopped"
@@ -35,6 +35,9 @@ class StartGeminiComputerUseTaskParams(BaseModel):
 
     task: str
     llm: Optional[GeminiComputerUseLlm] = Field(default=None, serialization_alias="llm")
+    reasoning_effort: Optional[GeminiComputerUseReasoningEffort] = Field(
+        default=None, serialization_alias="reasoningEffort"
+    )
     session_id: Optional[str] = Field(default=None, serialization_alias="sessionId")
     max_failures: Optional[int] = Field(default=None, serialization_alias="maxFailures")
     max_steps: Optional[int] = Field(default=None, serialization_alias="maxSteps")

{hyperbrowser-1.12.0 → hyperbrowser-1.12.1}/hyperbrowser/models/consts.py

@@ -115,6 +115,7 @@ CuaReasoningEffort = Literal[
     "max",
 ]
 GeminiComputerUseLlm = Literal[
+    "gemini-4-argon",
     "gemini-3.8-flash",
     "gemini-3.7-flash",
     "gemini-3.6-flash",
@@ -123,6 +124,13 @@ GeminiComputerUseLlm = Literal[
     "gemini-3-flash-preview",
     "gemini-2.5-computer-use-preview-10-2025",
 ]
+# Gemini 4 Argon, 3.8 Flash, and 3.7 Flash do not support "minimal".
+GeminiComputerUseReasoningEffort = Literal[
+    "minimal",
+    "low",
+    "medium",
+    "high",
+]
 GrokComputerUseLlm = Literal[
     "grok-4.7",
     "grok-4.6",

{hyperbrowser-1.12.0 → hyperbrowser-1.12.1}/hyperbrowser/models/session.py

@@ -62,6 +62,21 @@ class SessionProfile(BaseModel):
     )
 
 
+class SessionWebBotAuth(BaseModel):
+    """
+    How a session signs its requests with Web Bot Auth.
+    """
+
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    signature_agent: str = Field(alias="signatureAgent")
+    """The identity the session signs as, e.g. "https://www.hyperbrowser.ai"."""
+    only_domains: Optional[List[str]] = Field(default=None, alias="onlyDomains")
+    """Present when signing is limited to these hostnames and their subdomains."""
+
+
 class UpdateSessionProfileParams(BaseModel):
     """
     Parameters for updating session profile persistence settings.
@@ -130,6 +145,8 @@ class SessionLaunchState(BaseModel):
     )
 
     enable_web_mcp: Optional[bool] = Field(default=None, alias="enableWebMcp")
+    web_bot_auth: Optional[SessionWebBotAuth] = Field(default=None, alias="webBotAuth")
+    """Present only for a session that signs its requests with Web Bot Auth."""
 
     use_ultra_stealth: Optional[bool] = Field(default=None, alias="useUltraStealth")
     use_stealth: Optional[bool] = Field(default=None, alias="useStealth")
@@ -404,6 +421,40 @@ class StartSessionFromSnapshotParams(BaseModel):
     snapshot_id: str = Field(serialization_alias="snapshotId")
 
 
+class WebBotAuthParams(BaseModel):
+    """
+    Limits Web Bot Auth signing to some hosts.
+    """
+
+    # An unknown key (such as "onlyDomains") is an error rather than dropped:
+    # dropping it would sign requests to every host.
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+
+    only_domains: Optional[List[str]] = Field(
+        default=None, serialization_alias="onlyDomains"
+    )
+    """Sign only requests to these hostnames (e.g. "example.com") and their
+    subdomains. No scheme, port or path; at most 50.
+    """
+
+
+class ProxyRoute(BaseModel):
+    """
+    Sends traffic for matching hosts through the session's proxy or straight out.
+    """
+
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+
+    match: Union[str, List[str]]
+    """A hostname, "*.example.com" (subdomains, not example.com itself) or "*"
+    (every host), or a list of them.
+    """
+    proxy: Literal["direct", "default"]
+    """Where the traffic goes: "direct" sends it straight out of the browser's
+    machine, and "default" sends it through the session's proxy.
+    """
+
+
 class CreateSessionParams(BaseModel):
     """
     Parameters for creating a new browser session.
@@ -416,6 +467,24 @@ class CreateSessionParams(BaseModel):
     enable_web_mcp: Optional[bool] = Field(
         default=None, serialization_alias="enableWebMcp"
     )
+    web_bot_auth: Optional[Union[bool, WebBotAuthParams]] = Field(
+        default=None, serialization_alias="webBotAuth"
+    )
+    """Sign the session's requests with Web Bot Auth so websites can verify they
+    come from Hyperbrowser. Pass WebBotAuthParams(only_domains=[...]) to sign only
+    for those hosts. Requires Web Bot Auth to be enabled for your team; works for
+    sessions and agent tasks, and cannot be combined with use_ultra_stealth or
+    start_from_snapshot.
+    """
+    proxy_routes: Optional[List[ProxyRoute]] = Field(
+        default=None, serialization_alias="proxyRoutes"
+    )
+    """Choose, per host, whether the session's traffic goes through its proxy or
+    straight out. The first route that matches a host decides; hosts that no
+    route matches use the proxy. Requires use_proxy and proxy routes to be
+    enabled for your team, only applies when creating a session, and cannot be
+    combined with allow_internet_access=False, allow_out or deny_out.
+    """
 
     use_ultra_stealth: bool = Field(
         default=False, serialization_alias="useUltraStealth"

{hyperbrowser-1.12.0 → hyperbrowser-1.12.1}/hyperbrowser/types/__init__.py

@@ -147,6 +147,8 @@ from .session import (
     SessionListParams,
     SessionStatus,
     StartSessionFromSnapshotParams,
+    WebBotAuthParams,
+    ProxyRoute,
     UpdateSessionProfileParams,
     UpdateSessionProxyLocationParams,
     UpdateSessionProxyParams,
@@ -323,6 +325,8 @@ __all__ = [
     "SessionListParams",
     "SessionStatus",
     "StartSessionFromSnapshotParams",
+    "WebBotAuthParams",
+    "ProxyRoute",
     "UpdateSessionProfileParams",
     "UpdateSessionProxyLocationParams",
     "UpdateSessionProxyParams",

{hyperbrowser-1.12.0 → hyperbrowser-1.12.1}/hyperbrowser/types/agents.py

@@ -10,6 +10,7 @@ from hyperbrowser.models.consts import (
     CuaLlm,
     CuaReasoningEffort,
     GeminiComputerUseLlm,
+    GeminiComputerUseReasoningEffort,
     GrokComputerUseLlm,
     GrokReasoningEffort,
     MetaComputerUseLlm,
@@ -92,6 +93,7 @@ class StartGeminiComputerUseTaskParams(TypedDict, total=False):
 
     task: Required[str]
     llm: Optional[GeminiComputerUseLlm]
+    reasoning_effort: Optional[GeminiComputerUseReasoningEffort]
     session_id: Optional[str]
     max_failures: Optional[int]
     max_steps: Optional[int]

{hyperbrowser-1.12.0 → hyperbrowser-1.12.1}/hyperbrowser/types/session.py

@@ -1,4 +1,4 @@
-from typing import List, Literal, Optional
+from typing import List, Literal, Optional, Union
 
 from typing_extensions import Required, TypedDict
 
@@ -114,10 +114,27 @@ class StartSessionFromSnapshotParams(TypedDict):
     snapshot_id: str
 
 
+class WebBotAuthParams(TypedDict, total=False):
+    """Hosts to limit Web Bot Auth signing to: hostnames such as "example.com",
+    each also covering its subdomains."""
+
+    only_domains: List[str]
+
+
+class ProxyRoute(TypedDict):
+    """Sends traffic for matching hosts through the session's proxy ("default")
+    or straight out ("direct"). A pattern is a hostname, "*.example.com" or "*"."""
+
+    match: Union[str, List[str]]
+    proxy: Literal["direct", "default"]
+
+
 class CreateSessionParams(TypedDict, total=False):
     """Configuration for creating a browser session."""
 
     enable_web_mcp: Optional[bool]
+    web_bot_auth: Optional[Union[bool, WebBotAuthParams]]
+    proxy_routes: Optional[List[ProxyRoute]]
     use_ultra_stealth: bool
     use_stealth: bool
     use_proxy: bool

{hyperbrowser-1.12.0 → hyperbrowser-1.12.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "hyperbrowser"
-version = "1.12.0"
+version = "1.12.1"
 description = "Python SDK for hyperbrowser"
 authors = ["Nikhil Shahi <nshahi1998@gmail.com>"]
 license = "MIT"