hyperbrowser 0.57.0__py3-none-any.whl → 0.59.0__py3-none-any.whl

hyperbrowser/client/managers/async_manager/session.py

@@ -10,12 +10,32 @@ from ....models.session import (
     SessionListResponse,
     SessionRecording,
     UploadFileResponse,
+    SessionEventLogListParams,
+    SessionEventLogListResponse,
+    SessionEventLog,
 )
 
 
+class SessionEventLogsManager:
+    def __init__(self, client):
+        self._client = client
+
+    async def list(
+        self,
+        session_id: str,
+        params: SessionEventLogListParams = SessionEventLogListParams(),
+    ) -> List[SessionEventLog]:
+        response = await self._client.transport.get(
+            self._client._build_url(f"/session/{session_id}/event-logs"),
+            params=params.model_dump(exclude_none=True, by_alias=True),
+        )
+        return SessionEventLogListResponse(**response.data)
+
+
 class SessionManager:
     def __init__(self, client):
         self._client = client
+        self.event_logs = SessionEventLogsManager(client)
 
     async def create(self, params: CreateSessionParams = None) -> SessionDetail:
         response = await self._client.transport.post(

hyperbrowser/client/managers/sync_manager/session.py

@@ -10,12 +10,32 @@ from ....models.session import (
     SessionListResponse,
     SessionRecording,
     UploadFileResponse,
+    SessionEventLogListParams,
+    SessionEventLogListResponse,
+    SessionEventLog,
 )
 
 
+class SessionEventLogsManager:
+    def __init__(self, client):
+        self._client = client
+
+    def list(
+        self,
+        session_id: str,
+        params: SessionEventLogListParams = SessionEventLogListParams(),
+    ) -> SessionEventLogListResponse:
+        response = self._client.transport.get(
+            self._client._build_url(f"/session/{session_id}/event-logs"),
+            params=params.model_dump(exclude_none=True, by_alias=True),
+        )
+        return SessionEventLogListResponse(**response.data)
+
+
 class SessionManager:
     def __init__(self, client):
         self._client = client
+        self.event_logs = SessionEventLogsManager(client)
 
     def create(self, params: CreateSessionParams = None) -> SessionDetail:
         response = self._client.transport.post(

hyperbrowser/models/__init__.py

@@ -49,6 +49,7 @@ from .consts import (
     ScrapePageStatus,
     ScrapeScreenshotFormat,
     ScrapeWaitUntil,
+    SessionEventLogType,
     State,
 )
 from .crawl import (
@@ -119,6 +120,9 @@ from .session import (
     SessionListResponse,
     SessionRecording,
     SessionStatus,
+    SessionEventLog,
+    SessionEventLogListParams,
+    SessionEventLogListResponse,
     UploadFileResponse,
 )
 from .team import TeamCreditInfo
@@ -139,6 +143,7 @@ __all__ = [
     "ScrapePageStatus",
     "ScrapeScreenshotFormat",
     "ScrapeWaitUntil",
+    "SessionEventLogType",
     "State",
     # agents
     "HyperAgentTaskStatus",
@@ -225,6 +230,9 @@ __all__ = [
     "SessionListResponse",
     "SessionRecording",
     "SessionStatus",
+    "SessionEventLog",
+    "SessionEventLogListParams",
+    "SessionEventLogListResponse",
     "UploadFileResponse",
     # team
     "TeamCreditInfo",

hyperbrowser/models/consts.py

@@ -10,6 +10,9 @@ RecordingStatus = Literal[
 DownloadsStatus = Literal[
     "not_enabled", "pending", "in_progress", "completed", "failed"
 ]
+SessionEventLogType = Literal[
+    "captcha_detected", "captcha_solved", "captcha_error", "file_downloaded"
+]
 
 POLLING_ATTEMPTS = 5
 

hyperbrowser/models/session.py

@@ -1,5 +1,5 @@
 from datetime import datetime
-from typing import Any, List, Literal, Optional, Union
+from typing import Any, List, Literal, Optional, Union, Dict
 from .computer_action import ComputerActionParams, ComputerActionResponse
 
 from pydantic import BaseModel, ConfigDict, Field, field_validator
@@ -13,6 +13,7 @@ from hyperbrowser.models.consts import (
     RecordingStatus,
     State,
     SessionRegion,
+    SessionEventLogType,
 )
 
 SessionStatus = Literal["active", "closed", "error"]
@@ -147,7 +148,9 @@ class CreateSessionParams(BaseModel):
         populate_by_alias=True,
     )
 
-    use_ultra_stealth: bool = Field(default=False, serialization_alias="useUltraStealth")
+    use_ultra_stealth: bool = Field(
+        default=False, serialization_alias="useUltraStealth"
+    )
     use_stealth: bool = Field(default=False, serialization_alias="useStealth")
     use_proxy: bool = Field(default=False, serialization_alias="useProxy")
     proxy_server: Optional[str] = Field(default=None, serialization_alias="proxyServer")
@@ -280,3 +283,48 @@ class UploadFileResponse(BaseModel):
     )
 
     message: str = Field(alias="message")
+
+
+class SessionEventLog(BaseModel):
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    id: str = Field(alias="id")
+    session_id: str = Field(alias="sessionId")
+    target_id: Optional[str] = Field(alias="targetId")
+    page_url: Optional[str] = Field(alias="pageUrl")
+    team_id: str = Field(alias="teamId")
+    type: SessionEventLogType = Field(alias="type")
+    metadata: Dict[str, Any] = Field(alias="metadata")
+    timestamp: int = Field(alias="timestamp")
+
+
+class SessionEventLogListParams(BaseModel):
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    page: Optional[int] = Field(default=None, serialization_alias="page")
+    limit: Optional[int] = Field(default=None, serialization_alias="limit")
+    start_timestamp: Optional[int] = Field(
+        default=None, serialization_alias="startTimestamp"
+    )
+    end_timestamp: Optional[int] = Field(
+        default=None, serialization_alias="endTimestamp"
+    )
+    target_id: Optional[str] = Field(default=None, serialization_alias="targetId")
+    types: Optional[List[SessionEventLogType]] = Field(
+        default=None, serialization_alias="types"
+    )
+
+
+class SessionEventLogListResponse(BaseModel):
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    data: List[SessionEventLog] = Field(alias="data")
+    total_count: int = Field(alias="totalCount")
+    page: int = Field(alias="page")
+    per_page: int = Field(alias="perPage")

{hyperbrowser-0.57.0.dist-info → hyperbrowser-0.59.0.dist-info}/METADATA

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

{hyperbrowser-0.57.0.dist-info → hyperbrowser-0.59.0.dist-info}/RECORD

@@ -12,7 +12,7 @@ hyperbrowser/client/managers/async_manager/extension.py,sha256=a-xYtXXdCspukYtsg
 hyperbrowser/client/managers/async_manager/extract.py,sha256=wZO696_3Mse3tnsHgpSXibo6IfwcO5K1lWstcO_2GjQ,2492
 hyperbrowser/client/managers/async_manager/profile.py,sha256=cQ4cYVwL83heQwEnQiBw0PHk1HWK7DWFXmmBnRXJt0E,1514
 hyperbrowser/client/managers/async_manager/scrape.py,sha256=akVgbatTTHDFkmxugxcQpIPEwjSPm7VloJVDdbAPRh0,6560
-hyperbrowser/client/managers/async_manager/session.py,sha256=-bp5wG8Is6J3NR4vIIFcFgpIjBK8GnOsWg09XddkWhg,3494
+hyperbrowser/client/managers/async_manager/session.py,sha256=2PLXcwvh38ouX3ctOtizhOlmK0NH4HEtH5rKXaxEH8w,4166
 hyperbrowser/client/managers/async_manager/team.py,sha256=DHRd7igcuMG16WfM1-nSnpqaSNvwEzBnTGv7wRuaRdI,353
 hyperbrowser/client/managers/sync_manager/agents/__init__.py,sha256=GUkUBxoqW6vchz3-yNlUaE8TdEClNdp3RliHYMT1fsE,432
 hyperbrowser/client/managers/sync_manager/agents/browser_use.py,sha256=HXl8GM47DZuK4A-3DpwbLDJCnzEL8ndn9YfDAEljZFk,2765
@@ -25,24 +25,24 @@ hyperbrowser/client/managers/sync_manager/extension.py,sha256=1YoyTZtMo43trl9jAs
 hyperbrowser/client/managers/sync_manager/extract.py,sha256=rNSxAMR95_nL4qHuatPSzXrYFUGbLQE1xm9Us1myy9s,2391
 hyperbrowser/client/managers/sync_manager/profile.py,sha256=P6pQXeDiW40PN_XZJMzdr59FxwysFJ1fG1pOt5CbvtY,1466
 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/session.py,sha256=njiJZlHbkZ0vl1X8igWARkEEMHG1LIlCfQNhZJmtJIs,3996
 hyperbrowser/client/managers/sync_manager/team.py,sha256=VKuKXpbGBZ-iwTDAlO0U0yvi2Ig4iJhafjx0e9xV_tk,341
 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=U5ODeAV1UnAaXS-90vmswz_fYm6VhrvYgG6ekPzxVaI,5911
+hyperbrowser/models/__init__.py,sha256=eV1jGe1fu1NbMJDR8CqftJPR5byM4Bi0UK-XCTejeLk,6139
 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/hyper_agent.py,sha256=tHca1Xw6sHekF0SAL1buKMjeUjwmm8qciKFCWsJ1q0g,3728
 hyperbrowser/models/computer_action.py,sha256=9CvnlfqwarBCjfek62_1gpRmeupU_3IhEnhkQ3iK8yw,3488
-hyperbrowser/models/consts.py,sha256=YKi3PNIQvpBEvyP7NO_uTfh118w8NFAX_AXNDY6Ikws,6984
+hyperbrowser/models/consts.py,sha256=aWo6l8dsDLwQ5nKVqf5pIBKDGi2H0QnrhZ6dV-xwr1Y,7094
 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=2c-s_2cbnzP8ZOSg9olIPdNlRspDguNt5MXbRxqmJX4,8775
+hyperbrowser/models/session.py,sha256=WGUdev1qO5XhXJoYCWviWUL16SHR0ZzDW4zpBFoSvEA,10282
 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
@@ -51,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.57.0.dist-info/METADATA,sha256=EdA2qk2YXqd49bAWBS2WUHp2RHr08NTyauOuVUXSYL4,3651
-hyperbrowser-0.57.0.dist-info/WHEEL,sha256=M5asmiAlL6HEcOq52Yi5mmk9KmTVjY2RDPtO4p9DMrc,88
-hyperbrowser-0.57.0.dist-info/licenses/LICENSE,sha256=NbSXeOZ2JKnPpkyLBYkfPqt9eWNy-Lx3xb4sjsSR9mI,1069
-hyperbrowser-0.57.0.dist-info/RECORD,,
+hyperbrowser-0.59.0.dist-info/METADATA,sha256=ZS0k-sYKUTFgqngGoop1wxhFhCS0GxUOnCMYgLpm3Xg,3651
+hyperbrowser-0.59.0.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+hyperbrowser-0.59.0.dist-info/licenses/LICENSE,sha256=NbSXeOZ2JKnPpkyLBYkfPqt9eWNy-Lx3xb4sjsSR9mI,1069
+hyperbrowser-0.59.0.dist-info/RECORD,,

{hyperbrowser-0.57.0.dist-info → hyperbrowser-0.59.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.2.0
+Generator: poetry-core 2.2.1
 Root-Is-Purelib: true
 Tag: py3-none-any