hyperbrowser 0.49.0__py3-none-any.whl → 0.50.0__py3-none-any.whl

hyperbrowser/client/async_client.py

@@ -11,6 +11,7 @@ from .managers.async_manager.profile import ProfileManager
 from .managers.async_manager.scrape import ScrapeManager
 from .managers.async_manager.session import SessionManager
 from .managers.async_manager.team import TeamManager
+from .managers.async_manager.computer_action import ComputerActionManager
 
 
 class AsyncHyperbrowser(HyperbrowserBase):
@@ -33,6 +34,7 @@ class AsyncHyperbrowser(HyperbrowserBase):
         self.extensions = ExtensionManager(self)
         self.agents = Agents(self)
         self.team = TeamManager(self)
+        self.computer_action = ComputerActionManager(self)
 
     async def close(self) -> None:
         await self.transport.close()

hyperbrowser/client/managers/async_manager/computer_action.py

@@ -0,0 +1,120 @@
+from pydantic import BaseModel
+from typing import Union, List
+from hyperbrowser.models import (
+    SessionDetail,
+    ComputerActionParams,
+    ComputerActionResponse,
+    ClickActionParams,
+    DragActionParams,
+    PressKeysActionParams,
+    MoveMouseActionParams,
+    ScreenshotActionParams,
+    ScrollActionParams,
+    TypeTextActionParams,
+    Coordinate,
+)
+
+
+class ComputerActionManager:
+    def __init__(self, client):
+        self._client = client
+
+    async def _execute_request(
+        self, session: Union[SessionDetail, str], params: ComputerActionParams
+    ) -> ComputerActionResponse:
+        if isinstance(session, str):
+            session = await self._client.sessions.get(session)
+
+        if not session.computer_action_endpoint:
+            raise ValueError("Computer action endpoint not available for this session")
+
+        if isinstance(params, BaseModel):
+            payload = params.model_dump(by_alias=True, exclude_none=True)
+        else:
+            payload = params
+
+        response = await self._client.transport.post(
+            session.computer_action_endpoint,
+            data=payload,
+        )
+        return ComputerActionResponse(**response.data)
+
+    async def click(
+        self,
+        session: Union[SessionDetail, str],
+        x: int,
+        y: int,
+        button: str = "left",
+        num_clicks: int = 1,
+        return_screenshot: bool = False,
+    ) -> ComputerActionResponse:
+        params = ClickActionParams(
+            x=x,
+            y=y,
+            button=button,
+            num_clicks=num_clicks,
+            return_screenshot=return_screenshot,
+        )
+        return await self._execute_request(session, params)
+
+    async def type_text(
+        self,
+        session: Union[SessionDetail, str],
+        text: str,
+        return_screenshot: bool = False,
+    ) -> ComputerActionResponse:
+        params = TypeTextActionParams(text=text, return_screenshot=return_screenshot)
+        return await self._execute_request(session, params)
+
+    async def screenshot(
+        self,
+        session: Union[SessionDetail, str],
+    ) -> ComputerActionResponse:
+        params = ScreenshotActionParams()
+        return await self._execute_request(session, params)
+
+    async def press_keys(
+        self,
+        session: Union[SessionDetail, str],
+        keys: List[str],
+        return_screenshot: bool = False,
+    ) -> ComputerActionResponse:
+        params = PressKeysActionParams(keys=keys, return_screenshot=return_screenshot)
+        return await self._execute_request(session, params)
+
+    async def drag(
+        self,
+        session: Union[SessionDetail, str],
+        path: List[Coordinate],
+        return_screenshot: bool = False,
+    ) -> ComputerActionResponse:
+        params = DragActionParams(path=path, return_screenshot=return_screenshot)
+        return await self._execute_request(session, params)
+
+    async def move_mouse(
+        self,
+        session: Union[SessionDetail, str],
+        x: int,
+        y: int,
+        return_screenshot: bool = False,
+    ) -> ComputerActionResponse:
+        params = MoveMouseActionParams(x=x, y=y, return_screenshot=return_screenshot)
+        return await self._execute_request(session, params)
+
+    async def scroll(
+        self,
+        session: Union[SessionDetail, str],
+        x: int,
+        y: int,
+        scroll_x: int,
+        scroll_y: int,
+        return_screenshot: bool = False,
+    ) -> ComputerActionResponse:
+        params = ScrollActionParams(
+            x=x,
+            y=y,
+            scroll_x=scroll_x,
+            scroll_y=scroll_y,
+            return_screenshot=return_screenshot,
+        )
+        return await self._execute_request(session, params)

hyperbrowser/client/managers/sync_manager/computer_action.py

@@ -0,0 +1,120 @@
+from pydantic import BaseModel
+from typing import Union, List
+from hyperbrowser.models import (
+    SessionDetail,
+    ComputerActionParams,
+    ComputerActionResponse,
+    ClickActionParams,
+    DragActionParams,
+    PressKeysActionParams,
+    MoveMouseActionParams,
+    ScreenshotActionParams,
+    ScrollActionParams,
+    TypeTextActionParams,
+    Coordinate,
+)
+
+
+class ComputerActionManager:
+    def __init__(self, client):
+        self._client = client
+
+    def _execute_request(
+        self, session: Union[SessionDetail, str], params: ComputerActionParams
+    ) -> ComputerActionResponse:
+        if isinstance(session, str):
+            session = self._client.sessions.get(session)
+
+        if not session.computer_action_endpoint:
+            raise ValueError("Computer action endpoint not available for this session")
+
+        if isinstance(params, BaseModel):
+            payload = params.model_dump(by_alias=True, exclude_none=True)
+        else:
+            payload = params
+
+        response = self._client.transport.post(
+            session.computer_action_endpoint,
+            data=payload,
+        )
+        return ComputerActionResponse(**response.data)
+
+    def click(
+        self,
+        session: Union[SessionDetail, str],
+        x: int,
+        y: int,
+        button: str = "left",
+        num_clicks: int = 1,
+        return_screenshot: bool = False,
+    ) -> ComputerActionResponse:
+        params = ClickActionParams(
+            x=x,
+            y=y,
+            button=button,
+            num_clicks=num_clicks,
+            return_screenshot=return_screenshot,
+        )
+        return self._execute_request(session, params)
+
+    def type_text(
+        self,
+        session: Union[SessionDetail, str],
+        text: str,
+        return_screenshot: bool = False,
+    ) -> ComputerActionResponse:
+        params = TypeTextActionParams(text=text, return_screenshot=return_screenshot)
+        return self._execute_request(session, params)
+
+    def screenshot(
+        self,
+        session: Union[SessionDetail, str],
+    ) -> ComputerActionResponse:
+        params = ScreenshotActionParams()
+        return self._execute_request(session, params)
+
+    def press_keys(
+        self,
+        session: Union[SessionDetail, str],
+        keys: List[str],
+        return_screenshot: bool = False,
+    ) -> ComputerActionResponse:
+        params = PressKeysActionParams(keys=keys, return_screenshot=return_screenshot)
+        return self._execute_request(session, params)
+
+    def drag(
+        self,
+        session: Union[SessionDetail, str],
+        path: List[Coordinate],
+        return_screenshot: bool = False,
+    ) -> ComputerActionResponse:
+        params = DragActionParams(path=path, return_screenshot=return_screenshot)
+        return self._execute_request(session, params)
+
+    def move_mouse(
+        self,
+        session: Union[SessionDetail, str],
+        x: int,
+        y: int,
+        return_screenshot: bool = False,
+    ) -> ComputerActionResponse:
+        params = MoveMouseActionParams(x=x, y=y, return_screenshot=return_screenshot)
+        return self._execute_request(session, params)
+
+    def scroll(
+        self,
+        session: Union[SessionDetail, str],
+        x: int,
+        y: int,
+        scroll_x: int,
+        scroll_y: int,
+        return_screenshot: bool = False,
+    ) -> ComputerActionResponse:
+        params = ScrollActionParams(
+            x=x,
+            y=y,
+            scroll_x=scroll_x,
+            scroll_y=scroll_y,
+            return_screenshot=return_screenshot,
+        )
+        return self._execute_request(session, params)

hyperbrowser/client/sync.py

@@ -11,6 +11,7 @@ from .managers.sync_manager.profile import ProfileManager
 from .managers.sync_manager.scrape import ScrapeManager
 from .managers.sync_manager.session import SessionManager
 from .managers.sync_manager.team import TeamManager
+from .managers.sync_manager.computer_action import ComputerActionManager
 
 
 class Hyperbrowser(HyperbrowserBase):
@@ -33,6 +34,7 @@ class Hyperbrowser(HyperbrowserBase):
         self.extensions = ExtensionManager(self)
         self.agents = Agents(self)
         self.team = TeamManager(self)
+        self.computer_action = ComputerActionManager(self)
 
     def close(self) -> None:
         self.transport.close()

hyperbrowser/models/__init__.py

@@ -92,6 +92,19 @@ from .scrape import (
     StartScrapeJobParams,
     StartScrapeJobResponse,
 )
+from .computer_action import (
+    ClickActionParams,
+    ComputerAction,
+    ComputerActionParams,
+    ComputerActionResponse,
+    Coordinate,
+    DragActionParams,
+    MoveMouseActionParams,
+    PressKeysActionParams,
+    ScreenshotActionParams,
+    ScrollActionParams,
+    TypeTextActionParams,
+)
 from .session import (
     BasicResponse,
     CreateSessionParams,
@@ -215,4 +228,16 @@ __all__ = [
     "UploadFileResponse",
     # team
     "TeamCreditInfo",
+    # computer action
+    "ClickActionParams",
+    "ComputerAction",
+    "ComputerActionParams",
+    "ComputerActionResponse",
+    "Coordinate",
+    "DragActionParams",
+    "MoveMouseActionParams",
+    "PressKeysActionParams",
+    "ScreenshotActionParams",
+    "ScrollActionParams",
+    "TypeTextActionParams",
 ]

hyperbrowser/models/computer_action.py

@@ -0,0 +1,135 @@
+from enum import Enum
+from typing import List, Literal, Optional, Union
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class ComputerAction(str, Enum):
+    """Computer action types."""
+
+    CLICK = "click"
+    DRAG = "drag"
+    PRESS_KEYS = "press_keys"
+    MOVE_MOUSE = "move_mouse"
+    SCREENSHOT = "screenshot"
+    SCROLL = "scroll"
+    TYPE_TEXT = "type_text"
+
+
+class Coordinate(BaseModel):
+    """Coordinate model for drag actions."""
+
+    x: int
+    y: int
+
+
+class ClickActionParams(BaseModel):
+    """Parameters for click action."""
+
+    model_config = ConfigDict(use_enum_values=True)
+
+    action: Literal[ComputerAction.CLICK] = ComputerAction.CLICK
+    x: int
+    y: int
+    button: Literal["left", "right", "middle", "back", "forward", "wheel"] = Field(
+        default="left"
+    )
+    num_clicks: int = Field(serialization_alias="numClicks", default=1)
+    return_screenshot: bool = Field(
+        serialization_alias="returnScreenshot", default=False
+    )
+
+
+class DragActionParams(BaseModel):
+    """Parameters for drag action."""
+
+    model_config = ConfigDict(use_enum_values=True)
+
+    action: Literal[ComputerAction.DRAG] = ComputerAction.DRAG
+    path: List[Coordinate]
+    return_screenshot: bool = Field(
+        serialization_alias="returnScreenshot", default=False
+    )
+
+
+class PressKeysActionParams(BaseModel):
+    """Parameters for press keys action."""
+
+    model_config = ConfigDict(use_enum_values=True)
+
+    action: Literal[ComputerAction.PRESS_KEYS] = ComputerAction.PRESS_KEYS
+    keys: List[str]
+    return_screenshot: bool = Field(
+        serialization_alias="returnScreenshot", default=False
+    )
+
+
+class MoveMouseActionParams(BaseModel):
+    """Parameters for move mouse action."""
+
+    model_config = ConfigDict(use_enum_values=True)
+
+    action: Literal[ComputerAction.MOVE_MOUSE] = ComputerAction.MOVE_MOUSE
+    x: int = Field(ge=0)
+    y: int = Field(ge=0)
+    return_screenshot: bool = Field(
+        serialization_alias="returnScreenshot", default=False
+    )
+
+
+class ScreenshotActionParams(BaseModel):
+    """Parameters for screenshot action."""
+
+    model_config = ConfigDict(use_enum_values=True)
+
+    action: Literal[ComputerAction.SCREENSHOT] = ComputerAction.SCREENSHOT
+
+
+class ScrollActionParams(BaseModel):
+    """Parameters for scroll action."""
+
+    model_config = ConfigDict(use_enum_values=True)
+
+    action: Literal[ComputerAction.SCROLL] = ComputerAction.SCROLL
+    x: int
+    y: int
+    scroll_x: int = Field(serialization_alias="scrollX")
+    scroll_y: int = Field(serialization_alias="scrollY")
+    return_screenshot: bool = Field(
+        serialization_alias="returnScreenshot", default=False
+    )
+
+
+class TypeTextActionParams(BaseModel):
+    """Parameters for type text action."""
+
+    model_config = ConfigDict(use_enum_values=True)
+
+    action: Literal[ComputerAction.TYPE_TEXT] = ComputerAction.TYPE_TEXT
+    text: str
+    return_screenshot: bool = Field(
+        serialization_alias="returnScreenshot", default=False
+    )
+
+
+ComputerActionParams = Union[
+    ClickActionParams,
+    DragActionParams,
+    PressKeysActionParams,
+    MoveMouseActionParams,
+    ScreenshotActionParams,
+    ScrollActionParams,
+    TypeTextActionParams,
+]
+
+
+class ComputerActionResponse(BaseModel):
+    """Response from computer action API."""
+
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    success: bool
+    screenshot: Optional[str] = None
+    error: Optional[str] = None
+    message: Optional[str] = None

hyperbrowser/models/session.py

@@ -1,5 +1,6 @@
 from datetime import datetime
 from typing import Any, List, Literal, Optional, Union
+from .computer_action import ComputerActionParams, ComputerActionResponse
 
 from pydantic import BaseModel, ConfigDict, Field, field_validator
 
@@ -64,6 +65,9 @@ class SessionDetail(Session):
     )
 
     ws_endpoint: Optional[str] = Field(alias="wsEndpoint", default=None)
+    computer_action_endpoint: Optional[str] = Field(
+        alias="computerActionEndpoint", default=None
+    )
     live_url: str = Field(alias="liveUrl")
     token: str = Field(alias="token")
 

{hyperbrowser-0.49.0.dist-info → hyperbrowser-0.50.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: hyperbrowser
-Version: 0.49.0
+Version: 0.50.0
 Summary: Python SDK for hyperbrowser
 License: MIT
 Author: Nikhil Shahi

{hyperbrowser-0.49.0.dist-info → hyperbrowser-0.50.0.dist-info}/RECORD

@@ -1,11 +1,12 @@
 hyperbrowser/__init__.py,sha256=zWGcLhqhvWy6BTwuNpzWK1-0LpIn311ks-4U9nrsb7Y,187
-hyperbrowser/client/async_client.py,sha256=hMjpmWlRAhbmv4F3Eh-xaPFl12YoRiWQAjJDJ0y_fDw,1565
+hyperbrowser/client/async_client.py,sha256=CcgSBu3YbSZZ4jthRqXnOMlgMMGCJzAGAymyovL7n1k,1698
 hyperbrowser/client/base.py,sha256=2nkTdGfRWjW3grqAuYez-IuD69SAAJ5qklCKNeAYd6A,1268
 hyperbrowser/client/managers/async_manager/agents/__init__.py,sha256=GUkUBxoqW6vchz3-yNlUaE8TdEClNdp3RliHYMT1fsE,432
 hyperbrowser/client/managers/async_manager/agents/browser_use.py,sha256=wizo6f_GpZyP8z6nXbqgX57i2cJMm12GDt1yEmPXF1A,2863
 hyperbrowser/client/managers/async_manager/agents/claude_computer_use.py,sha256=gTnX8r3rETyLMsDy_4nO0oB5cDdHHN9s-y7xw-4ekqc,2657
 hyperbrowser/client/managers/async_manager/agents/cua.py,sha256=e43QgSLi0LvGd9cOirsRETcit0MXvvtLA2cNv16xH0s,2337
 hyperbrowser/client/managers/async_manager/agents/hyper_agent.py,sha256=VzPTrvlYX_CZohoCD6Z8Cf1itDZ6BLKmrzpjv6YGs88,2501
+hyperbrowser/client/managers/async_manager/computer_action.py,sha256=W9Ezfe7vRt1xtAXI7nBxLsYC6iTT7wjg2jn0OFpF7E4,3711
 hyperbrowser/client/managers/async_manager/crawl.py,sha256=3EW-QauFPaW92XJk0mQU7f0-xgCdKKEc6WaPeM5exlA,4417
 hyperbrowser/client/managers/async_manager/extension.py,sha256=a-xYtXXdCspukYtsguRgjEoQ8E_kzzA2tQAJtIyCtAs,1439
 hyperbrowser/client/managers/async_manager/extract.py,sha256=wZO696_3Mse3tnsHgpSXibo6IfwcO5K1lWstcO_2GjQ,2492
@@ -18,6 +19,7 @@ hyperbrowser/client/managers/sync_manager/agents/browser_use.py,sha256=HXl8GM47D
 hyperbrowser/client/managers/sync_manager/agents/claude_computer_use.py,sha256=6mAaqDjKrLrxRaGZfZSgC7wYVyDQeWZEE6K6wLrnTXk,2557
 hyperbrowser/client/managers/sync_manager/agents/cua.py,sha256=rh3JyXWzh9SvSLkDBtWGVUd2KMx27MyLMuNPnRwvbxk,2253
 hyperbrowser/client/managers/sync_manager/agents/hyper_agent.py,sha256=UgB_eEa7PODGoTegulJzJDPBr2VQ-hIT0yA0z7BfYtk,2403
+hyperbrowser/client/managers/sync_manager/computer_action.py,sha256=H-oD6A_dcmbrFrUQ8nw6QCNg4MV1jDy7cPeCJNfg_kY,3609
 hyperbrowser/client/managers/sync_manager/crawl.py,sha256=mk5G7NGrneU47P2lbOlI7dkAZ9PMMPwPjIYGSO5yR-Y,4349
 hyperbrowser/client/managers/sync_manager/extension.py,sha256=1YoyTZtMo43trl9jAsXv95aor0nBHiJEmLva39jFW-k,1415
 hyperbrowser/client/managers/sync_manager/extract.py,sha256=rNSxAMR95_nL4qHuatPSzXrYFUGbLQE1xm9Us1myy9s,2391
@@ -25,21 +27,22 @@ hyperbrowser/client/managers/sync_manager/profile.py,sha256=P6pQXeDiW40PN_XZJMzd
 hyperbrowser/client/managers/sync_manager/scrape.py,sha256=aNsTNZyPwzwCz6oCqzfoOWJm3qXUjwIIO68lIaCGzWE,6381
 hyperbrowser/client/managers/sync_manager/session.py,sha256=81sjAXPc3w3F1bI0if6z02wHrS5HYsStDQTpqUpk6Fo,3330
 hyperbrowser/client/managers/sync_manager/team.py,sha256=VKuKXpbGBZ-iwTDAlO0U0yvi2Ig4iJhafjx0e9xV_tk,341
-hyperbrowser/client/sync.py,sha256=S7v9GlrJig2iuRBFX9NPOzxWBDoEM13Pp18CT6vTXUw,1387
+hyperbrowser/client/sync.py,sha256=Oi-d4upNRkAUS5T5LcJPun5hL6FPbODn_PcM1AERCrg,1519
 hyperbrowser/config.py,sha256=7P-sbcvqXVr8Qzubo5O6jJgzcCgB5DdwbeIgEjRZNlY,623
 hyperbrowser/exceptions.py,sha256=SUUkptK2OL36xDORYmSicaTYR7pMbxeWAjAgz35xnM8,1171
-hyperbrowser/models/__init__.py,sha256=aI4bTkfnlqXNr2x2LmrkKYtvC_pmWfnkK262CC6x39g,5300
+hyperbrowser/models/__init__.py,sha256=U5ODeAV1UnAaXS-90vmswz_fYm6VhrvYgG6ekPzxVaI,5911
 hyperbrowser/models/agents/browser_use.py,sha256=Na3av_EivqOCtEjd-Bfm68sp3H_tr_cE8q1oFCjagUU,6303
 hyperbrowser/models/agents/claude_computer_use.py,sha256=j7hBYwdOh_gljNk84_omEX2Wgtt3RbujlX6bH7JfdzE,3194
 hyperbrowser/models/agents/cua.py,sha256=5w0nCwoixctA8-GJRCazJ_k243Own6sKkrjpnce86cw,3492
 hyperbrowser/models/agents/hyper_agent.py,sha256=tHca1Xw6sHekF0SAL1buKMjeUjwmm8qciKFCWsJ1q0g,3728
+hyperbrowser/models/computer_action.py,sha256=9CvnlfqwarBCjfek62_1gpRmeupU_3IhEnhkQ3iK8yw,3488
 hyperbrowser/models/consts.py,sha256=eJVHFIKqhb9AbJkbP7OY71fxI7bv3OhH1S040X2n0oc,6907
 hyperbrowser/models/crawl.py,sha256=XUS5Ja-Abl8gMyDtLIsRaEKa_taSOORMLOFCdAPgGaI,2820
 hyperbrowser/models/extension.py,sha256=nXjKXKt9R7RxyZ4hd3EvfqZsEGy_ufh1r5j2mqCLykQ,804
 hyperbrowser/models/extract.py,sha256=DXg0HtO44plAtcFOmqUpdp9P93tq45U2fLWxn5jdjAw,1745
 hyperbrowser/models/profile.py,sha256=GF0esQwru0oOs9sQ9DCuO8VX4GKPgRgKCVP8s7g0Pig,1846
 hyperbrowser/models/scrape.py,sha256=iMsUuMx3UFtSci6TVUpcH5ytbgwiImIXjviVcGZ_gBQ,5048
-hyperbrowser/models/session.py,sha256=LqHG9UcNs6zMP1O9gnCG58L4Tc2-e6EtapXsF7F4BPc,7840
+hyperbrowser/models/session.py,sha256=E55mux8YpujIPNpZJPQyMgmRn5Q45Oc9xYMaINGr0nM,8026
 hyperbrowser/models/team.py,sha256=dPBFL3TPO0AF_UzqP4sENMPhku_5j00uwC24zG558MU,338
 hyperbrowser/tools/__init__.py,sha256=L-2xveBbSuIBQBQhJmXGCLNYEUq_XHDdgz_gBAsmQZo,4605
 hyperbrowser/tools/anthropic.py,sha256=bo8jn2ROHCp_hpX1_cjkCk7qU0LmuBr_gvlvM0f5OMc,2699
@@ -48,7 +51,7 @@ hyperbrowser/tools/schema.py,sha256=YFUAoQjx_SpjezS3UQdTCCn4xMdN3CgEeKAlulkIATc,
 hyperbrowser/transport/async_transport.py,sha256=6HKoeM5TutIqraEscEWobvSPWF3iVKh2hPflGNKwykw,4128
 hyperbrowser/transport/base.py,sha256=ildpMrDiM8nvrSGrH2LTOafmB17T7PQB_NQ1ODA378U,1703
 hyperbrowser/transport/sync.py,sha256=aUVpxWF8sqSycLNKxVNEZvlsZSoqc1eHgPK1Y1QA1u8,3422
-hyperbrowser-0.49.0.dist-info/LICENSE,sha256=NbSXeOZ2JKnPpkyLBYkfPqt9eWNy-Lx3xb4sjsSR9mI,1069
-hyperbrowser-0.49.0.dist-info/METADATA,sha256=FulmXAULPA73kFG2IVeDCjlXfw6winGsuI7x2pB3Ch8,3578
-hyperbrowser-0.49.0.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-hyperbrowser-0.49.0.dist-info/RECORD,,
+hyperbrowser-0.50.0.dist-info/LICENSE,sha256=NbSXeOZ2JKnPpkyLBYkfPqt9eWNy-Lx3xb4sjsSR9mI,1069
+hyperbrowser-0.50.0.dist-info/METADATA,sha256=J09fHmsIpKmKG7Pvrr2HAR4jy4FpI6MLasMDpQozrOc,3578
+hyperbrowser-0.50.0.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+hyperbrowser-0.50.0.dist-info/RECORD,,