hyperbrowser 0.68.0__py3-none-any.whl → 0.69.0__py3-none-any.whl

hyperbrowser/models/__init__.py

@@ -5,6 +5,26 @@ from .agents.browser_use import (
     StartBrowserUseTaskParams,
     StartBrowserUseTaskResponse,
     BrowserUseApiKeys,
+    BrowserUseAgentBrain,
+    BrowserUseAgentOutput,
+    BrowserUseActionResult,
+    BrowserUseStepMetadata,
+    BrowserUseTabInfo,
+    BrowserUseCoordinates,
+    BrowserUseCoordinateSet,
+    BrowserUseViewportInfo,
+    BrowserUseDOMHistoryElement,
+    BrowserUseBrowserStateHistory,
+    BrowserUseAgentHistory,
+    BrowserUseAgentOutputV0710,
+    BrowserUseActionResultV0710,
+    BrowserUseBrowserStateHistoryV0710,
+    BrowserUseStepMetadataV0710,
+    BrowserUseAgentHistoryV0710,
+    BrowserUseAgentHistoryLatest,
+    BrowserUseTaskMetadata,
+    BrowserUseStep,
+    cast_steps_for_version,
 )
 from .agents.claude_computer_use import (
     ClaudeComputerUseTaskStatus,
@@ -64,6 +84,7 @@ from .consts import (
     SessionEventLogType,
     State,
     SessionRegion,
+    BrowserUseVersion,
 )
 from .crawl import (
     CrawledPage,
@@ -82,6 +103,7 @@ from .extract import (
     ExtractJobStatusResponse,
     StartExtractJobParams,
     StartExtractJobResponse,
+    ExtractJobMetadata,
 )
 from .profile import (
     CreateProfileParams,
@@ -105,6 +127,7 @@ from .scrape import (
     StartBatchScrapeJobResponse,
     StartScrapeJobParams,
     StartScrapeJobResponse,
+    StorageStateOptions,
 )
 from .computer_action import (
     ClickActionParams,
@@ -169,6 +192,7 @@ __all__ = [
     "SessionEventLogType",
     "State",
     "SessionRegion",
+    "BrowserUseVersion",
     # agents
     "HyperAgentTaskStatus",
     "HyperAgentActionOutput",
@@ -185,6 +209,26 @@ __all__ = [
     "BrowserUseTaskStatusResponse",
     "StartBrowserUseTaskParams",
     "StartBrowserUseTaskResponse",
+    "BrowserUseAgentBrain",
+    "BrowserUseAgentOutput",
+    "BrowserUseActionResult",
+    "BrowserUseStepMetadata",
+    "BrowserUseTabInfo",
+    "BrowserUseCoordinates",
+    "BrowserUseCoordinateSet",
+    "BrowserUseViewportInfo",
+    "BrowserUseDOMHistoryElement",
+    "BrowserUseBrowserStateHistory",
+    "BrowserUseAgentHistory",
+    "BrowserUseAgentOutputV0710",
+    "BrowserUseActionResultV0710",
+    "BrowserUseBrowserStateHistoryV0710",
+    "BrowserUseStepMetadataV0710",
+    "BrowserUseAgentHistoryV0710",
+    "BrowserUseAgentHistoryLatest",
+    "BrowserUseStep",
+    "BrowserUseTaskMetadata",
+    "cast_steps_for_version",
     "ClaudeComputerUseTaskStatus",
     "ClaudeComputerUseStepResponse",
     "ClaudeComputerUseTaskData",
@@ -228,6 +272,7 @@ __all__ = [
     "ExtractJobStatusResponse",
     "StartExtractJobParams",
     "StartExtractJobResponse",
+    "ExtractJobMetadata",
     # profile
     "CreateProfileParams",
     "CreateProfileResponse",
@@ -249,6 +294,7 @@ __all__ = [
     "StartBatchScrapeJobResponse",
     "StartScrapeJobParams",
     "StartScrapeJobResponse",
+    "StorageStateOptions",
     # session
     "BasicResponse",
     "CreateSessionParams",

hyperbrowser/models/agents/browser_use.py

@@ -2,7 +2,7 @@ from typing import Any, Dict, List, Literal, Optional, Type, Union
 
 from pydantic import BaseModel, ConfigDict, Field
 
-from ..consts import BrowserUseLlm
+from ..consts import BrowserUseLlm, BrowserUseVersion
 from ..session import CreateSessionParams
 
 BrowserUseTaskStatus = Literal["pending", "running", "completed", "failed", "stopped"]
@@ -32,6 +32,9 @@ class StartBrowserUseTaskParams(BaseModel):
     )
 
     task: str
+    version: Optional[BrowserUseVersion] = Field(
+        default=None, serialization_alias="version"
+    )
     llm: Optional[BrowserUseLlm] = Field(default=None, serialization_alias="llm")
     session_id: Optional[str] = Field(default=None, serialization_alias="sessionId")
     validate_output: Optional[bool] = Field(
@@ -193,15 +196,79 @@ class BrowserUseAgentHistory(BaseModel):
     metadata: Optional[BrowserUseStepMetadata] = None
 
 
+# ===== 0.7.10-specific response models =====
+
+
+class BrowserUseAgentOutputV0710(BaseModel):
+    thinking: Optional[str] = None
+    evaluation_previous_goal: Optional[str] = None
+    memory: Optional[str] = None
+    next_goal: Optional[str] = None
+    action: list[dict]
+
+
+class BrowserUseActionResultV0710(BaseModel):
+    is_done: Optional[bool] = False
+    success: Optional[bool] = None
+    error: Optional[str] = None
+    metadata: Optional[dict] = None
+    attachments: Optional[list[str]] = None
+    long_term_memory: Optional[str] = None
+    extracted_content: Optional[str] = None
+    include_extracted_content_only_once: Optional[bool] = False
+    include_in_memory: bool = False
+
+
+class BrowserUseBrowserStateHistoryV0710(BaseModel):
+    url: str
+    title: str
+    tabs: list[dict]
+    interacted_element: Union[list[Union[dict, None]], list[None]]
+
+
+class BrowserUseStepMetadataV0710(BaseModel):
+    step_start_time: float
+    step_end_time: float
+    step_number: int
+
+
+class BrowserUseAgentHistoryV0710(BaseModel):
+    model_output: Union[BrowserUseAgentOutputV0710, None]
+    result: list[BrowserUseActionResultV0710]
+    state: BrowserUseBrowserStateHistoryV0710
+    metadata: Optional[BrowserUseStepMetadataV0710] = None
+
+
+# ===== latest response models =====
+
+BrowserUseAgentHistoryLatest = Dict[str, Any]
+
+BrowserUseStep = Union[
+    BrowserUseAgentHistory, BrowserUseAgentHistoryV0710, BrowserUseAgentHistoryLatest
+]
+
+
 class BrowserUseTaskData(BaseModel):
     model_config = ConfigDict(
         populate_by_alias=True,
     )
 
-    steps: list[BrowserUseAgentHistory]
+    steps: list[BrowserUseStep]
     final_result: Optional[str] = Field(default=None, alias="finalResult")
 
 
+class BrowserUseTaskMetadata(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 BrowserUseTaskResponse(BaseModel):
     """
     Response from a browser use task.
@@ -213,6 +280,20 @@ class BrowserUseTaskResponse(BaseModel):
 
     job_id: str = Field(alias="jobId")
     status: BrowserUseTaskStatus
+    metadata: Optional[BrowserUseTaskMetadata] = Field(default=None, alias="metadata")
     data: Optional[BrowserUseTaskData] = Field(default=None, alias="data")
     error: Optional[str] = Field(default=None, alias="error")
     live_url: Optional[str] = Field(default=None, alias="liveUrl")
+
+
+def cast_steps_for_version(
+    steps: List[BrowserUseStep], version: BrowserUseVersion
+) -> List[BrowserUseStep]:
+    if version == "0.1.40":
+        return [BrowserUseAgentHistory.model_validate(s) for s in steps]
+    elif version == "0.7.10":
+        return [BrowserUseAgentHistoryV0710.model_validate(s) for s in steps]
+    elif version == "latest":
+        return steps
+    else:
+        raise ValueError(f"Invalid version: {version}")

hyperbrowser/models/agents/claude_computer_use.py

@@ -104,6 +104,18 @@ class ClaudeComputerUseTaskData(BaseModel):
     final_result: Optional[str] = Field(default=None, alias="finalResult")
 
 
+class ClaudeComputerUseTaskMetadata(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 ClaudeComputerUseTaskResponse(BaseModel):
     """
     Response from a Claude Computer Use task.
@@ -115,6 +127,9 @@ class ClaudeComputerUseTaskResponse(BaseModel):
 
     job_id: str = Field(alias="jobId")
     status: ClaudeComputerUseTaskStatus
+    metadata: Optional[ClaudeComputerUseTaskMetadata] = Field(
+        default=None, alias="metadata"
+    )
     data: Optional[ClaudeComputerUseTaskData] = Field(default=None, alias="data")
     error: Optional[str] = Field(default=None, alias="error")
     live_url: Optional[str] = Field(default=None, alias="liveUrl")

hyperbrowser/models/agents/cua.py

@@ -134,6 +134,18 @@ class CuaTaskData(BaseModel):
     final_result: Optional[str] = Field(default=None, alias="finalResult")
 
 
+class CuaTaskMetadata(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 CuaTaskResponse(BaseModel):
     """
     Response from a CUA task.
@@ -145,6 +157,7 @@ class CuaTaskResponse(BaseModel):
 
     job_id: str = Field(alias="jobId")
     status: CuaTaskStatus
+    metadata: Optional[CuaTaskMetadata] = Field(default=None, alias="metadata")
     data: Optional[CuaTaskData] = Field(default=None, alias="data")
     error: Optional[str] = Field(default=None, alias="error")
     live_url: Optional[str] = Field(default=None, alias="liveUrl")

hyperbrowser/models/agents/gemini_computer_use.py

@@ -104,6 +104,18 @@ class GeminiComputerUseTaskData(BaseModel):
     final_result: Optional[str] = Field(default=None, alias="finalResult")
 
 
+class GeminiComputerUseTaskMetadata(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 GeminiComputerUseTaskResponse(BaseModel):
     """
     Response from a Gemini Computer Use task.
@@ -115,6 +127,9 @@ class GeminiComputerUseTaskResponse(BaseModel):
 
     job_id: str = Field(alias="jobId")
     status: GeminiComputerUseTaskStatus
+    metadata: Optional[GeminiComputerUseTaskMetadata] = Field(
+        default=None, alias="metadata"
+    )
     data: Optional[GeminiComputerUseTaskData] = Field(default=None, alias="data")
     error: Optional[str] = Field(default=None, alias="error")
     live_url: Optional[str] = Field(default=None, alias="liveUrl")

hyperbrowser/models/agents/hyper_agent.py

@@ -126,6 +126,16 @@ class HyperAgentTaskData(BaseModel):
     final_result: Optional[str] = Field(default=None, alias="finalResult")
 
 
+class HyperAgentTaskMetadata(BaseModel):
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    num_task_steps_completed: Optional[int] = Field(
+        default=None, alias="numTaskStepsCompleted"
+    )
+
+
 class HyperAgentTaskResponse(BaseModel):
     """
     Response from a HyperAgent task.
@@ -137,6 +147,7 @@ class HyperAgentTaskResponse(BaseModel):
 
     job_id: str = Field(alias="jobId")
     status: HyperAgentTaskStatus
+    metadata: Optional[HyperAgentTaskMetadata] = Field(default=None, alias="metadata")
     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/models/consts.py

@@ -16,6 +16,8 @@ SessionEventLogType = Literal[
 
 POLLING_ATTEMPTS = 5
 
+BrowserUseVersion = Literal["0.1.40", "0.7.10", "latest"]
+
 BrowserUseLlm = Literal[
     "gpt-4o",
     "gpt-4o-mini",

hyperbrowser/models/extract.py

@@ -55,6 +55,16 @@ class ExtractJobStatusResponse(BaseModel):
     status: ExtractJobStatus
 
 
+class ExtractJobMetadata(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_pages_scraped: Optional[int] = Field(default=None, alias="numPagesScraped")
+
+
 class ExtractJobResponse(BaseModel):
     """
     Response from a extract job.
@@ -67,4 +77,5 @@ class ExtractJobResponse(BaseModel):
     job_id: str = Field(alias="jobId")
     status: ExtractJobStatus
     error: Optional[str] = None
+    metadata: Optional[ExtractJobMetadata] = None
     data: Optional[dict] = None

hyperbrowser/models/scrape.py

@@ -23,6 +23,15 @@ class ScreenshotOptions(BaseModel):
     )
 
 
+class StorageStateOptions(BaseModel):
+    local_storage: Optional[dict[str, str]] = Field(
+        default=None, serialization_alias="localStorage"
+    )
+    session_storage: Optional[dict[str, str]] = Field(
+        default=None, serialization_alias="sessionStorage"
+    )
+
+
 class ScrapeOptions(BaseModel):
     """
     Options for scraping a page.
@@ -46,6 +55,9 @@ class ScrapeOptions(BaseModel):
     screenshot_options: Optional[ScreenshotOptions] = Field(
         default=None, serialization_alias="screenshotOptions"
     )
+    storage_state: Optional[StorageStateOptions] = Field(
+        default=None, serialization_alias="storageState"
+    )
 
 
 class StartScrapeJobParams(BaseModel):

{hyperbrowser-0.68.0.dist-info → hyperbrowser-0.69.0.dist-info}/METADATA

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

{hyperbrowser-0.68.0.dist-info → hyperbrowser-0.69.0.dist-info}/RECORD

@@ -32,19 +32,19 @@ hyperbrowser/client/managers/sync_manager/team.py,sha256=VKuKXpbGBZ-iwTDAlO0U0yv
 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=RUP1RTipem3WiytncDOZp_nsEjG_oMxjtb6_e283s3M,7502
-hyperbrowser/models/agents/browser_use.py,sha256=Na3av_EivqOCtEjd-Bfm68sp3H_tr_cE8q1oFCjagUU,6303
-hyperbrowser/models/agents/claude_computer_use.py,sha256=RflxYn2Js4TQQsAM3liTBoWJkIViYjOuBVFOPR4sTho,3311
-hyperbrowser/models/agents/cua.py,sha256=mDFC3hVWQ3OS9wpjRTPdJgXaIOLDw00GGPD_pURo8Tw,3609
-hyperbrowser/models/agents/gemini_computer_use.py,sha256=31nSL6BvTTdidVWT1Q0ftftJnPWQJIEDW9R4OxoUuKo,3342
-hyperbrowser/models/agents/hyper_agent.py,sha256=tHca1Xw6sHekF0SAL1buKMjeUjwmm8qciKFCWsJ1q0g,3728
+hyperbrowser/models/__init__.py,sha256=H8Oy6ulDFqogDhfKe7VEq3c-7MWjYrbhvrYi2upLEyE,8878
+hyperbrowser/models/agents/browser_use.py,sha256=KxbiDNhcaj86c2qoQ7BceJG7iVfgrKVntQNDil_Iz6A,8767
+hyperbrowser/models/agents/claude_computer_use.py,sha256=nMVbGwIisyOR9JI3zvpxwwxtzxqvAySLcbCQm3mhJyo,3802
+hyperbrowser/models/agents/cua.py,sha256=mL094vIVZbMpVB19kWshY7Ekmr6kwyYZpc6T2yaMwOA,4058
+hyperbrowser/models/agents/gemini_computer_use.py,sha256=GtTDD9aUtOwEWutuOp1dGtRSLjlGr9e8xKMDGRDvfD4,3833
+hyperbrowser/models/agents/hyper_agent.py,sha256=zv4yXdp4d2UPZMzaqXuL5FDq3FM6XM3U-cnWCMk-BQ4,4039
 hyperbrowser/models/computer_action.py,sha256=C6LJ5xQ03VUFbDM78MfwSGG_Z0tNDCwsBx113noWp_o,5678
-hyperbrowser/models/consts.py,sha256=xEfvmRa8UIMPshQdSbrmJ1v_qiJIOuOuG55S9MTg8YU,7332
+hyperbrowser/models/consts.py,sha256=J5ga3UEGRFwQ5VvaYZWS-JdLxFCdusAQ9AoXBobpslk,7391
 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/extract.py,sha256=RAIMHDIu7e20o4ABPyPa_QbsIqqOb3ZM5AeA4PXbSdE,2140
 hyperbrowser/models/profile.py,sha256=GF0esQwru0oOs9sQ9DCuO8VX4GKPgRgKCVP8s7g0Pig,1846
-hyperbrowser/models/scrape.py,sha256=iMsUuMx3UFtSci6TVUpcH5ytbgwiImIXjviVcGZ_gBQ,5048
+hyperbrowser/models/scrape.py,sha256=W5JAApb7tlqBM7RIRJWdw7D8T5vg0DyVXcJyO9IrGZs,5445
 hyperbrowser/models/session.py,sha256=50mKJGpnc3_9Hil-K0c7osZ_dE8V_jedEo9Db6DJ3lo,12892
 hyperbrowser/models/team.py,sha256=dPBFL3TPO0AF_UzqP4sENMPhku_5j00uwC24zG558MU,338
 hyperbrowser/tools/__init__.py,sha256=L-2xveBbSuIBQBQhJmXGCLNYEUq_XHDdgz_gBAsmQZo,4605
@@ -54,7 +54,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.68.0.dist-info/METADATA,sha256=ilcYlR2jOQ2R2kfxi_2dLt4g13G3GjMGbFcmyz18jPo,3651
-hyperbrowser-0.68.0.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-hyperbrowser-0.68.0.dist-info/licenses/LICENSE,sha256=NbSXeOZ2JKnPpkyLBYkfPqt9eWNy-Lx3xb4sjsSR9mI,1069
-hyperbrowser-0.68.0.dist-info/RECORD,,
+hyperbrowser-0.69.0.dist-info/METADATA,sha256=iar1W8wJt8F-WZJy4uw82CYSv_d7DHeUpn2ivdgZO6A,3651
+hyperbrowser-0.69.0.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+hyperbrowser-0.69.0.dist-info/licenses/LICENSE,sha256=NbSXeOZ2JKnPpkyLBYkfPqt9eWNy-Lx3xb4sjsSR9mI,1069
+hyperbrowser-0.69.0.dist-info/RECORD,,