hyperbrowser 0.42.0__tar.gz → 0.44.0__tar.gz

{hyperbrowser-0.42.0 → hyperbrowser-0.44.0}/PKG-INFO

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

{hyperbrowser-0.42.0 → hyperbrowser-0.44.0}/hyperbrowser/client/managers/async_manager/agents/__init__.py

@@ -1,6 +1,7 @@
 from .browser_use import BrowserUseManager
 from .cua import CuaManager
 from .claude_computer_use import ClaudeComputerUseManager
+from .hyper_agent import HyperAgentManager
 
 
 class Agents:
@@ -8,3 +9,4 @@ class Agents:
         self.browser_use = BrowserUseManager(client)
         self.cua = CuaManager(client)
         self.claude_computer_use = ClaudeComputerUseManager(client)
+        self.hyper_agent = HyperAgentManager(client)

hyperbrowser-0.44.0/hyperbrowser/client/managers/async_manager/agents/hyper_agent.py

@@ -0,0 +1,71 @@
+import asyncio
+
+from hyperbrowser.exceptions import HyperbrowserError
+
+from .....models import (
+    POLLING_ATTEMPTS,
+    BasicResponse,
+    HyperAgentTaskResponse,
+    HyperAgentTaskStatusResponse,
+    StartHyperAgentTaskParams,
+    StartHyperAgentTaskResponse,
+)
+
+
+class HyperAgentManager:
+    def __init__(self, client):
+        self._client = client
+
+    async def start(
+        self, params: StartHyperAgentTaskParams
+    ) -> StartHyperAgentTaskResponse:
+        response = await self._client.transport.post(
+            self._client._build_url("/task/hyper-agent"),
+            data=params.model_dump(exclude_none=True, by_alias=True),
+        )
+        return StartHyperAgentTaskResponse(**response.data)
+
+    async def get(self, job_id: str) -> HyperAgentTaskResponse:
+        response = await self._client.transport.get(
+            self._client._build_url(f"/task/hyper-agent/{job_id}")
+        )
+        return HyperAgentTaskResponse(**response.data)
+
+    async def get_status(self, job_id: str) -> HyperAgentTaskStatusResponse:
+        response = await self._client.transport.get(
+            self._client._build_url(f"/task/hyper-agent/{job_id}/status")
+        )
+        return HyperAgentTaskStatusResponse(**response.data)
+
+    async def stop(self, job_id: str) -> BasicResponse:
+        response = await self._client.transport.put(
+            self._client._build_url(f"/task/hyper-agent/{job_id}/stop")
+        )
+        return BasicResponse(**response.data)
+
+    async def start_and_wait(
+        self, params: StartHyperAgentTaskParams
+    ) -> HyperAgentTaskResponse:
+        job_start_resp = await self.start(params)
+        job_id = job_start_resp.job_id
+        if not job_id:
+            raise HyperbrowserError("Failed to start HyperAgent task")
+
+        failures = 0
+        while True:
+            try:
+                job_response = await self.get_status(job_id)
+                if (
+                    job_response.status == "completed"
+                    or job_response.status == "failed"
+                    or job_response.status == "stopped"
+                ):
+                    return await self.get(job_id)
+                failures = 0
+            except Exception as e:
+                failures += 1
+                if failures >= POLLING_ATTEMPTS:
+                    raise HyperbrowserError(
+                        f"Failed to poll HyperAgent task {job_id} after {POLLING_ATTEMPTS} attempts: {e}"
+                    )
+            await asyncio.sleep(2)

{hyperbrowser-0.42.0 → hyperbrowser-0.44.0}/hyperbrowser/client/managers/sync_manager/agents/__init__.py

@@ -1,6 +1,7 @@
 from .browser_use import BrowserUseManager
 from .cua import CuaManager
 from .claude_computer_use import ClaudeComputerUseManager
+from .hyper_agent import HyperAgentManager
 
 
 class Agents:
@@ -8,3 +9,4 @@ class Agents:
         self.browser_use = BrowserUseManager(client)
         self.cua = CuaManager(client)
         self.claude_computer_use = ClaudeComputerUseManager(client)
+        self.hyper_agent = HyperAgentManager(client)

hyperbrowser-0.44.0/hyperbrowser/client/managers/sync_manager/agents/hyper_agent.py

@@ -0,0 +1,69 @@
+import time
+
+from hyperbrowser.exceptions import HyperbrowserError
+
+from .....models import (
+    POLLING_ATTEMPTS,
+    BasicResponse,
+    HyperAgentTaskResponse,
+    HyperAgentTaskStatusResponse,
+    StartHyperAgentTaskParams,
+    StartHyperAgentTaskResponse,
+)
+
+
+class HyperAgentManager:
+    def __init__(self, client):
+        self._client = client
+
+    def start(self, params: StartHyperAgentTaskParams) -> StartHyperAgentTaskResponse:
+        response = self._client.transport.post(
+            self._client._build_url("/task/hyper-agent"),
+            data=params.model_dump(exclude_none=True, by_alias=True),
+        )
+        return StartHyperAgentTaskResponse(**response.data)
+
+    def get(self, job_id: str) -> HyperAgentTaskResponse:
+        response = self._client.transport.get(
+            self._client._build_url(f"/task/hyper-agent/{job_id}")
+        )
+        return HyperAgentTaskResponse(**response.data)
+
+    def get_status(self, job_id: str) -> HyperAgentTaskStatusResponse:
+        response = self._client.transport.get(
+            self._client._build_url(f"/task/hyper-agent/{job_id}/status")
+        )
+        return HyperAgentTaskStatusResponse(**response.data)
+
+    def stop(self, job_id: str) -> BasicResponse:
+        response = self._client.transport.put(
+            self._client._build_url(f"/task/hyper-agent/{job_id}/stop")
+        )
+        return BasicResponse(**response.data)
+
+    def start_and_wait(
+        self, params: StartHyperAgentTaskParams
+    ) -> HyperAgentTaskResponse:
+        job_start_resp = self.start(params)
+        job_id = job_start_resp.job_id
+        if not job_id:
+            raise HyperbrowserError("Failed to start HyperAgent task")
+
+        failures = 0
+        while True:
+            try:
+                job_response = self.get_status(job_id)
+                if (
+                    job_response.status == "completed"
+                    or job_response.status == "failed"
+                    or job_response.status == "stopped"
+                ):
+                    return self.get(job_id)
+                failures = 0
+            except Exception as e:
+                failures += 1
+                if failures >= POLLING_ATTEMPTS:
+                    raise HyperbrowserError(
+                        f"Failed to poll HyperAgent task {job_id} after {POLLING_ATTEMPTS} attempts: {e}"
+                    )
+            time.sleep(2)

{hyperbrowser-0.42.0 → hyperbrowser-0.44.0}/hyperbrowser/models/__init__.py

@@ -19,9 +19,21 @@ from .agents.cua import (
     StartCuaTaskParams,
     StartCuaTaskResponse,
 )
+from .agents.hyper_agent import (
+    HyperAgentActionOutput,
+    HyperAgentOutput,
+    HyperAgentStep,
+    HyperAgentTaskData,
+    HyperAgentTaskResponse,
+    HyperAgentTaskStatus,
+    HyperAgentTaskStatusResponse,
+    StartHyperAgentTaskParams,
+    StartHyperAgentTaskResponse,
+)
 from .consts import (
     ISO639_1,
     POLLING_ATTEMPTS,
+    HyperAgentLlm,
     BrowserUseLlm,
     Country,
     DownloadsStatus,
@@ -95,6 +107,7 @@ __all__ = [
     # consts
     "ISO639_1",
     "POLLING_ATTEMPTS",
+    "HyperAgentLlm",
     "BrowserUseLlm",
     "Country",
     "DownloadsStatus",
@@ -107,6 +120,15 @@ __all__ = [
     "ScrapeWaitUntil",
     "State",
     # agents
+    "HyperAgentTaskStatus",
+    "HyperAgentActionOutput",
+    "HyperAgentOutput",
+    "HyperAgentStep",
+    "HyperAgentTaskData",
+    "HyperAgentTaskResponse",
+    "HyperAgentTaskStatusResponse",
+    "StartHyperAgentTaskParams",
+    "StartHyperAgentTaskResponse",
     "BrowserUseTaskStatus",
     "BrowserUseTaskData",
     "BrowserUseTaskResponse",

hyperbrowser-0.44.0/hyperbrowser/models/agents/hyper_agent.py

@@ -0,0 +1,122 @@
+from typing import Any, Dict, List, Literal, Optional
+
+from pydantic import BaseModel, ConfigDict, Field
+
+from ..consts import HyperAgentLlm
+from ..session import CreateSessionParams
+
+HyperAgentTaskStatus = Literal["pending", "running", "completed", "failed", "stopped"]
+
+
+class StartHyperAgentTaskParams(BaseModel):
+    """
+    Parameters for creating a new HyperAgent task.
+    """
+
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    task: str
+    llm: Optional[HyperAgentLlm] = Field(default=None, serialization_alias="llm")
+    session_id: Optional[str] = Field(default=None, serialization_alias="sessionId")
+    max_steps: Optional[int] = Field(default=None, serialization_alias="maxSteps")
+    keep_browser_open: Optional[bool] = Field(
+        default=None, serialization_alias="keepBrowserOpen"
+    )
+    session_options: Optional[CreateSessionParams] = Field(
+        default=None, serialization_alias="sessionOptions"
+    )
+
+
+class StartHyperAgentTaskResponse(BaseModel):
+    """
+    Response from starting a HyperAgent task.
+    """
+
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    job_id: str = Field(alias="jobId")
+    live_url: Optional[str] = Field(default=None, alias="liveUrl")
+
+
+class HyperAgentTaskStatusResponse(BaseModel):
+    """
+    Response from getting a HyperAgent task status.
+    """
+
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    status: HyperAgentTaskStatus
+
+
+class HyperAgentActionOutput(BaseModel):
+    """
+    The output of an action in a HyperAgent step.
+    """
+
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    success: bool
+    message: str
+    extract: Optional[Dict[str, Any]] = Field(default=None)
+
+
+class HyperAgentOutput(BaseModel):
+    """
+    The output of a HyperAgent step.
+    """
+
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    thoughts: Optional[str] = Field(default=None)
+    memory: Optional[str] = Field(default=None)
+    next_goal: Optional[str] = Field(default=None, alias="nextGoal")
+    actions: List[Dict[str, Any]] = Field(default=[])
+
+
+class HyperAgentStep(BaseModel):
+    """
+    A single step in a HyperAgent task.
+    """
+
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    idx: int
+    agent_output: HyperAgentOutput = Field(alias="agentOutput")
+    action_outputs: List[HyperAgentActionOutput] = Field(alias="actionOutputs")
+
+
+class HyperAgentTaskData(BaseModel):
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    steps: list[HyperAgentStep]
+    final_result: Optional[str] = Field(default=None, alias="finalResult")
+
+
+class HyperAgentTaskResponse(BaseModel):
+    """
+    Response from a HyperAgent task.
+    """
+
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    job_id: str = Field(alias="jobId")
+    status: HyperAgentTaskStatus
+    data: Optional[HyperAgentTaskData] = Field(default=None, alias="data")
+    error: Optional[str] = Field(default=None, alias="error")
+    live_url: Optional[str] = Field(default=None, alias="liveUrl")

{hyperbrowser-0.42.0 → hyperbrowser-0.44.0}/hyperbrowser/models/consts.py

@@ -21,6 +21,13 @@ BrowserUseLlm = Literal[
     "claude-3-5-haiku-20241022",
     "gemini-2.0-flash",
 ]
+HyperAgentLlm = Literal[
+    "gpt-4o",
+    "gpt-4o-mini",
+    "gpt-4.1",
+    "gpt-4.1-mini",
+    "gpt-4.1-nano",
+]
 
 Country = Literal[
     "AD",

{hyperbrowser-0.42.0 → hyperbrowser-0.44.0}/pyproject.toml

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