hyperbrowser 0.93.2__tar.gz → 0.93.3__tar.gz

{hyperbrowser-0.93.2 → hyperbrowser-0.93.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyperbrowser
-Version: 0.93.2
+Version: 0.93.3
 Summary: Python SDK for hyperbrowser
 License: MIT
 License-File: LICENSE

{hyperbrowser-0.93.2/hyperbrowser/client/managers/sync_manager → hyperbrowser-0.93.3/hyperbrowser/client/managers/async_manager}/agents/__init__.py

@@ -3,6 +3,7 @@ from .cua import CuaManager
 from .claude_computer_use import ClaudeComputerUseManager
 from .hyper_agent import HyperAgentManager
 from .gemini_computer_use import GeminiComputerUseManager
+from .grok_computer_use import GrokComputerUseManager
 
 
 class Agents:
@@ -12,3 +13,4 @@ class Agents:
         self.claude_computer_use = ClaudeComputerUseManager(client)
         self.hyper_agent = HyperAgentManager(client)
         self.gemini_computer_use = GeminiComputerUseManager(client)
+        self.grok_computer_use = GrokComputerUseManager(client)

hyperbrowser-0.93.3/hyperbrowser/client/managers/async_manager/agents/grok_computer_use.py

@@ -0,0 +1,71 @@
+import asyncio
+
+from hyperbrowser.exceptions import HyperbrowserError
+
+from .....models import (
+    POLLING_ATTEMPTS,
+    BasicResponse,
+    GrokComputerUseTaskResponse,
+    GrokComputerUseTaskStatusResponse,
+    StartGrokComputerUseTaskParams,
+    StartGrokComputerUseTaskResponse,
+)
+
+
+class GrokComputerUseManager:
+    def __init__(self, client):
+        self._client = client
+
+    async def start(
+        self, params: StartGrokComputerUseTaskParams
+    ) -> StartGrokComputerUseTaskResponse:
+        response = await self._client.transport.post(
+            self._client._build_url("/task/grok-computer-use"),
+            data=params.model_dump(exclude_none=True, by_alias=True),
+        )
+        return StartGrokComputerUseTaskResponse(**response.data)
+
+    async def get(self, job_id: str) -> GrokComputerUseTaskResponse:
+        response = await self._client.transport.get(
+            self._client._build_url(f"/task/grok-computer-use/{job_id}")
+        )
+        return GrokComputerUseTaskResponse(**response.data)
+
+    async def get_status(self, job_id: str) -> GrokComputerUseTaskStatusResponse:
+        response = await self._client.transport.get(
+            self._client._build_url(f"/task/grok-computer-use/{job_id}/status")
+        )
+        return GrokComputerUseTaskStatusResponse(**response.data)
+
+    async def stop(self, job_id: str) -> BasicResponse:
+        response = await self._client.transport.put(
+            self._client._build_url(f"/task/grok-computer-use/{job_id}/stop")
+        )
+        return BasicResponse(**response.data)
+
+    async def start_and_wait(
+        self, params: StartGrokComputerUseTaskParams
+    ) -> GrokComputerUseTaskResponse:
+        job_start_resp = await self.start(params)
+        job_id = job_start_resp.job_id
+        if not job_id:
+            raise HyperbrowserError("Failed to start Grok Computer Use task job")
+
+        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 Grok Computer Use task job {job_id} after {POLLING_ATTEMPTS} attempts: {e}"
+                    )
+            await asyncio.sleep(2)

{hyperbrowser-0.93.2/hyperbrowser/client/managers/async_manager → hyperbrowser-0.93.3/hyperbrowser/client/managers/sync_manager}/agents/__init__.py

@@ -3,6 +3,7 @@ from .cua import CuaManager
 from .claude_computer_use import ClaudeComputerUseManager
 from .hyper_agent import HyperAgentManager
 from .gemini_computer_use import GeminiComputerUseManager
+from .grok_computer_use import GrokComputerUseManager
 
 
 class Agents:
@@ -12,3 +13,4 @@ class Agents:
         self.claude_computer_use = ClaudeComputerUseManager(client)
         self.hyper_agent = HyperAgentManager(client)
         self.gemini_computer_use = GeminiComputerUseManager(client)
+        self.grok_computer_use = GrokComputerUseManager(client)

hyperbrowser-0.93.3/hyperbrowser/client/managers/sync_manager/agents/grok_computer_use.py

@@ -0,0 +1,71 @@
+import time
+
+from hyperbrowser.exceptions import HyperbrowserError
+
+from .....models import (
+    POLLING_ATTEMPTS,
+    BasicResponse,
+    GrokComputerUseTaskResponse,
+    GrokComputerUseTaskStatusResponse,
+    StartGrokComputerUseTaskParams,
+    StartGrokComputerUseTaskResponse,
+)
+
+
+class GrokComputerUseManager:
+    def __init__(self, client):
+        self._client = client
+
+    def start(
+        self, params: StartGrokComputerUseTaskParams
+    ) -> StartGrokComputerUseTaskResponse:
+        response = self._client.transport.post(
+            self._client._build_url("/task/grok-computer-use"),
+            data=params.model_dump(exclude_none=True, by_alias=True),
+        )
+        return StartGrokComputerUseTaskResponse(**response.data)
+
+    def get(self, job_id: str) -> GrokComputerUseTaskResponse:
+        response = self._client.transport.get(
+            self._client._build_url(f"/task/grok-computer-use/{job_id}")
+        )
+        return GrokComputerUseTaskResponse(**response.data)
+
+    def get_status(self, job_id: str) -> GrokComputerUseTaskStatusResponse:
+        response = self._client.transport.get(
+            self._client._build_url(f"/task/grok-computer-use/{job_id}/status")
+        )
+        return GrokComputerUseTaskStatusResponse(**response.data)
+
+    def stop(self, job_id: str) -> BasicResponse:
+        response = self._client.transport.put(
+            self._client._build_url(f"/task/grok-computer-use/{job_id}/stop")
+        )
+        return BasicResponse(**response.data)
+
+    def start_and_wait(
+        self, params: StartGrokComputerUseTaskParams
+    ) -> GrokComputerUseTaskResponse:
+        job_start_resp = self.start(params)
+        job_id = job_start_resp.job_id
+        if not job_id:
+            raise HyperbrowserError("Failed to start Grok Computer Use task job")
+
+        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 Grok Computer Use task job {job_id} after {POLLING_ATTEMPTS} attempts: {e}"
+                    )
+            time.sleep(2)

{hyperbrowser-0.93.2 → hyperbrowser-0.93.3}/hyperbrowser/models/__init__.py

@@ -117,6 +117,16 @@ from .agents.gemini_computer_use import (
     StartGeminiComputerUseTaskResponse,
     GeminiComputerUseApiKeys,
 )
+from .agents.grok_computer_use import (
+    GrokComputerUseTaskStatus,
+    GrokComputerUseStepResponse,
+    GrokComputerUseTaskData,
+    GrokComputerUseTaskResponse,
+    GrokComputerUseTaskStatusResponse,
+    StartGrokComputerUseTaskParams,
+    StartGrokComputerUseTaskResponse,
+    GrokComputerUseApiKeys,
+)
 from .agents.cua import (
     CuaTaskData,
     CuaTaskResponse,
@@ -147,6 +157,8 @@ from .consts import (
     BrowserUseLlm,
     ClaudeComputerUseLlm,
     CuaLlm,
+    GrokComputerUseLlm,
+    GrokReasoningEffort,
     Country,
     DownloadsStatus,
     FetchScreenshotFormat,
@@ -458,6 +470,13 @@ __all__ = [
     "GeminiComputerUseTaskStatusResponse",
     "StartGeminiComputerUseTaskParams",
     "StartGeminiComputerUseTaskResponse",
+    "GrokComputerUseTaskStatus",
+    "GrokComputerUseStepResponse",
+    "GrokComputerUseTaskData",
+    "GrokComputerUseTaskResponse",
+    "GrokComputerUseTaskStatusResponse",
+    "StartGrokComputerUseTaskParams",
+    "StartGrokComputerUseTaskResponse",
     "CuaTaskStatus",
     "CuaTaskData",
     "CuaTaskResponse",
@@ -467,8 +486,11 @@ __all__ = [
     "BrowserUseApiKeys",
     "ClaudeComputerUseApiKeys",
     "GeminiComputerUseApiKeys",
+    "GrokComputerUseApiKeys",
     "CuaApiKeys",
     "HyperAgentApiKeys",
+    "GrokComputerUseLlm",
+    "GrokReasoningEffort",
     "HyperAgentOutputV110",
     "HyperAgentStepV110",
     # crawl

hyperbrowser-0.93.3/hyperbrowser/models/agents/grok_computer_use.py

@@ -0,0 +1,150 @@
+from typing import Any, Literal, Optional
+
+from pydantic import BaseModel, ConfigDict, Field
+
+from .cua import CuaStepIncompleteDetails, CuaStepReasoning, CuaStepResponseError
+from ..session import CreateSessionParams
+from ..consts import GrokComputerUseLlm, GrokReasoningEffort
+
+GrokComputerUseTaskStatus = Literal[
+    "pending", "running", "completed", "failed", "stopped"
+]
+
+
+class GrokComputerUseApiKeys(BaseModel):
+    """
+    API keys for the Grok Computer Use task.
+    """
+
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    xai: Optional[str] = Field(default=None, serialization_alias="xai")
+
+
+class StartGrokComputerUseTaskParams(BaseModel):
+    """
+    Parameters for creating a new Grok Computer Use task.
+    """
+
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    task: str
+    llm: Optional[GrokComputerUseLlm] = Field(default=None, serialization_alias="llm")
+    reasoning_effort: Optional[GrokReasoningEffort] = 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")
+    keep_browser_open: Optional[bool] = Field(
+        default=None, serialization_alias="keepBrowserOpen"
+    )
+    session_options: Optional[CreateSessionParams] = Field(
+        default=None, serialization_alias="sessionOptions"
+    )
+    use_custom_api_keys: Optional[bool] = Field(
+        default=None, serialization_alias="useCustomApiKeys"
+    )
+    api_keys: Optional[GrokComputerUseApiKeys] = Field(
+        default=None, serialization_alias="apiKeys"
+    )
+    use_computer_action: Optional[bool] = Field(
+        default=None, serialization_alias="useComputerAction"
+    )
+
+
+class StartGrokComputerUseTaskResponse(BaseModel):
+    """
+    Response from starting a Grok Computer Use task.
+    """
+
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    job_id: str = Field(alias="jobId")
+    live_url: Optional[str] = Field(default=None, alias="liveUrl")
+
+
+class GrokComputerUseTaskStatusResponse(BaseModel):
+    """
+    Response from getting a Grok Computer Use task status.
+    """
+
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    status: GrokComputerUseTaskStatus
+
+
+class GrokComputerUseStepResponse(BaseModel):
+    """
+    Response from a single Grok Computer Use step.
+    """
+
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    created_at: Optional[int] = Field(default=None, serialization_alias="created_at")
+    completed_at: Optional[int] = Field(
+        default=None, serialization_alias="completed_at"
+    )
+    output_text: Optional[str] = Field(default=None, serialization_alias="output_text")
+    error: Optional[CuaStepResponseError] = Field(
+        default=None, serialization_alias="error"
+    )
+    incomplete_details: Optional[CuaStepIncompleteDetails] = Field(
+        default=None, serialization_alias="incomplete_details"
+    )
+    model: Optional[str] = Field(default=None, serialization_alias="model")
+    output: Optional[list[Any]] = Field(default=None, serialization_alias="output")
+    reasoning: Optional[CuaStepReasoning] = Field(
+        default=None, serialization_alias="reasoning"
+    )
+    status: Optional[str] = Field(default=None, serialization_alias="status")
+
+
+class GrokComputerUseTaskData(BaseModel):
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    steps: list[GrokComputerUseStepResponse]
+    final_result: Optional[str] = Field(default=None, alias="finalResult")
+
+
+class GrokComputerUseTaskMetadata(BaseModel):
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    input_tokens: Optional[int] = Field(default=None, alias="inputTokens")
+    output_tokens: Optional[int] = Field(default=None, alias="outputTokens")
+    num_task_steps_completed: Optional[int] = Field(
+        default=None, alias="numTaskStepsCompleted"
+    )
+
+
+class GrokComputerUseTaskResponse(BaseModel):
+    """
+    Response from a Grok Computer Use task.
+    """
+
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    job_id: str = Field(alias="jobId")
+    status: GrokComputerUseTaskStatus
+    metadata: Optional[GrokComputerUseTaskMetadata] = Field(
+        default=None, alias="metadata"
+    )
+    data: Optional[GrokComputerUseTaskData] = Field(default=None, alias="data")
+    error: Optional[str] = Field(default=None, alias="error")
+    live_url: Optional[str] = Field(default=None, alias="liveUrl")

{hyperbrowser-0.93.2 → hyperbrowser-0.93.3}/hyperbrowser/models/consts.py

@@ -86,10 +86,18 @@ CuaLlm = Literal[
     "gpt-5.4-mini",
 ]
 GeminiComputerUseLlm = Literal[
+    "gemini-3.6-flash",
     "gemini-3.5-flash",
+    "gemini-3.5-flash-lite",
     "gemini-3-flash-preview",
     "gemini-2.5-computer-use-preview-10-2025",
 ]
+GrokComputerUseLlm = Literal["grok-4.5",]
+GrokReasoningEffort = Literal[
+    "low",
+    "medium",
+    "high",
+]
 SessionRegion = Literal[
     "us-central",
     "asia-south",

{hyperbrowser-0.93.2 → hyperbrowser-0.93.3}/pyproject.toml

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