hyperbrowser 0.56.0__tar.gz → 0.58.0__tar.gz

{hyperbrowser-0.56.0 → hyperbrowser-0.58.0}/PKG-INFO

@@ -1,8 +1,9 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: hyperbrowser
-Version: 0.56.0
+Version: 0.58.0
 Summary: Python SDK for hyperbrowser
 License: MIT
+License-File: LICENSE
 Author: Nikhil Shahi
 Author-email: nshahi1998@gmail.com
 Requires-Python: >=3.8,<4.0
@@ -14,6 +15,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Requires-Dist: httpx (>=0.23.0,<1)
 Requires-Dist: jsonref (>=1.1.0)
 Requires-Dist: pydantic (>=2.0,<3)

{hyperbrowser-0.56.0 → hyperbrowser-0.58.0}/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-0.56.0 → hyperbrowser-0.58.0}/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-0.56.0 → hyperbrowser-0.58.0}/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-0.56.0 → hyperbrowser-0.58.0}/hyperbrowser/models/consts.py

@@ -10,6 +10,7 @@ RecordingStatus = Literal[
 DownloadsStatus = Literal[
     "not_enabled", "pending", "in_progress", "completed", "failed"
 ]
+SessionEventLogType = Literal["captcha_detected", "captcha_solved", "captcha_error"]
 
 POLLING_ATTEMPTS = 5
 
@@ -39,6 +40,7 @@ ClaudeComputerUseLlm = Literal[
 SessionRegion = Literal[
     "us-central",
     "asia-south",
+    "us-dev",
 ]
 
 Country = Literal[

{hyperbrowser-0.56.0 → hyperbrowser-0.58.0}/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,6 +148,9 @@ class CreateSessionParams(BaseModel):
         populate_by_alias=True,
     )
 
+    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")
@@ -279,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: str = Field(alias="targetId")
+    page_url: 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.56.0 → hyperbrowser-0.58.0}/pyproject.toml

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