hyperbrowser 1.0.0__tar.gz → 1.2.0__tar.gz

{hyperbrowser-1.0.0 → hyperbrowser-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyperbrowser
-Version: 1.0.0
+Version: 1.2.0
 Summary: Python SDK for hyperbrowser
 License: MIT
 License-File: LICENSE
@@ -81,6 +81,23 @@ session = client.sessions.create(
 )
 ```
 
+Browser sessions can also use an outbound network policy. Omitting these fields
+keeps the default unrestricted behavior:
+
+```python
+session = client.sessions.create(
+    {
+        "allow_internet_access": False,
+        "allow_out": ["example.com"],
+        "deny_out": ["0.0.0.0/0"],
+    }
+)
+```
+
+Direct browser policies accept domains, IPv4 addresses, and CIDR ranges in
+`allow_out`; `deny_out` accepts IPv4 addresses and CIDR ranges. With a proxy,
+allow rules must be domains and the only supported deny rule is `0.0.0.0/0`.
+
 Existing Pydantic request classes remain accepted, so upgrading does not require
 an immediate rewrite:
 

{hyperbrowser-1.0.0 → hyperbrowser-1.2.0}/README.md

@@ -54,6 +54,23 @@ session = client.sessions.create(
 )
 ```
 
+Browser sessions can also use an outbound network policy. Omitting these fields
+keeps the default unrestricted behavior:
+
+```python
+session = client.sessions.create(
+    {
+        "allow_internet_access": False,
+        "allow_out": ["example.com"],
+        "deny_out": ["0.0.0.0/0"],
+    }
+)
+```
+
+Direct browser policies accept domains, IPv4 addresses, and CIDR ranges in
+`allow_out`; `deny_out` accepts IPv4 addresses and CIDR ranges. With a proxy,
+allow rules must be domains and the only supported deny rule is `0.0.0.0/0`.
+
 Existing Pydantic request classes remain accepted, so upgrading does not require
 an immediate rewrite:
 

{hyperbrowser-1.0.0 → hyperbrowser-1.2.0}/hyperbrowser/client/managers/async_manager/sandbox.py

@@ -15,6 +15,8 @@ from ....models.sandbox import (
     SandboxExposeResult,
     SandboxImageBuild,
     SandboxImageBuildCreateResult,
+    SandboxImageBuildListParams,
+    SandboxImageBuildListResponse,
     SandboxImageListParams,
     SandboxImageListResponse,
     SandboxImageInit,
@@ -25,8 +27,10 @@ from ....models.sandbox import (
     SandboxNetworkPolicy,
     SandboxNetworkUpdateResult,
     SandboxRuntimeSession,
+    SandboxSnapshotDeleteResult,
     SandboxSnapshotListParams,
     SandboxSnapshotListResponse,
+    SandboxSnapshotSummary,
     SandboxUnexposeResult,
     StartSandboxFromSnapshotParams,
 )
@@ -37,6 +41,7 @@ from ....types import (
     CreateSandboxParams as CreateSandboxParamsDict,
     SandboxExecParams as SandboxExecParamsDict,
     SandboxExposeParams as SandboxExposeParamsDict,
+    SandboxImageBuildListParams as SandboxImageBuildListParamsDict,
     SandboxImageInit as SandboxImageInitDict,
     SandboxImageListParams as SandboxImageListParamsDict,
     SandboxListParams as SandboxListParamsDict,
@@ -167,6 +172,10 @@ class SandboxHandle:
     def disk_mib(self):
         return self._detail.disk_mib
 
+    @property
+    def timeout_minutes(self):
+        return self._detail.timeout_minutes
+
     @property
     def exposed_ports(self):
         return self._detail.exposed_ports
@@ -346,7 +355,7 @@ class SandboxHandle:
         )
 
     def _assert_runtime_available(self) -> None:
-        if self._detail.status in {"closed", "error"}:
+        if self._detail.status in {"closed", "error", "close-error"}:
             raise HyperbrowserError(
                 f"Sandbox {self.id} is not running",
                 status_code=409,
@@ -394,7 +403,7 @@ class SandboxManager:
         ],
     ) -> SandboxHandle:
         normalized = coerce_request(params, StartSandboxFromSnapshotParams)
-        return await self.create(normalized)
+        return await self.create(normalized.model_dump(exclude_none=True))
 
     async def get(self, sandbox_id: str) -> SandboxHandle:
         return self.attach(await self.get_detail(sandbox_id))
@@ -450,6 +459,14 @@ class SandboxManager:
         )
         return SandboxSnapshotListResponse(**payload)
 
+    async def get_snapshot(self, snapshot: str) -> SandboxSnapshotSummary:
+        payload = await self._request("GET", f"/snapshots/{snapshot}")
+        return SandboxSnapshotSummary(**payload["snapshot"])
+
+    async def delete_snapshot(self, snapshot: str) -> SandboxSnapshotDeleteResult:
+        payload = await self._request("DELETE", f"/snapshots/{snapshot}")
+        return SandboxSnapshotDeleteResult(**payload)
+
     async def stop(self, sandbox_id: str) -> BasicResponse:
         payload = await self._request("PUT", f"/sandbox/{sandbox_id}/stop")
         return BasicResponse(**payload)
@@ -491,6 +508,22 @@ class SandboxManager:
         payload = await self._request("POST", f"/images/builds/{build_id}/cancel")
         return SandboxImageBuild(**payload["build"])
 
+    async def list_image_builds(
+        self,
+        params: Optional[
+            Union[SandboxImageBuildListParamsDict, SandboxImageBuildListParams]
+        ] = None,
+    ) -> SandboxImageBuildListResponse:
+        payload = await self._request(
+            "GET",
+            "/images/builds",
+            params=dump_request(
+                params if params is not None else {},
+                SandboxImageBuildListParams,
+            ),
+        )
+        return SandboxImageBuildListResponse(**payload)
+
     async def wait_for_image_build(
         self,
         build_id: str,

{hyperbrowser-1.0.0 → hyperbrowser-1.2.0}/hyperbrowser/client/managers/async_manager/volume.py

@@ -1,8 +1,14 @@
-from typing import Union
+from typing import Optional, Union
 
 from hyperbrowser.client._request import dump_request
-from hyperbrowser.models.volume import CreateVolumeParams, Volume, VolumeListResponse
+from hyperbrowser.models.volume import (
+    CreateVolumeParams,
+    Volume,
+    VolumeListParams,
+    VolumeListResponse,
+)
 from hyperbrowser.types import CreateVolumeParams as CreateVolumeParamsDict
+from hyperbrowser.types import VolumeListParams as VolumeListParamsDict
 
 
 class VolumeManager:
@@ -19,8 +25,17 @@ class VolumeManager:
         )
         return Volume(**response.data)
 
-    async def list(self) -> VolumeListResponse:
-        response = await self._client.transport.get(self._client._build_url("/volume"))
+    async def list(
+        self,
+        params: Optional[Union[VolumeListParamsDict, VolumeListParams]] = None,
+    ) -> VolumeListResponse:
+        response = await self._client.transport.get(
+            self._client._build_url("/volume"),
+            params=dump_request(
+                params if params is not None else {},
+                VolumeListParams,
+            ),
+        )
         return VolumeListResponse(**response.data)
 
     async def get(self, volume_id: str) -> Volume:

{hyperbrowser-1.0.0 → hyperbrowser-1.2.0}/hyperbrowser/client/managers/sandboxes/image_build.py

@@ -22,7 +22,7 @@ from ....models.sandbox import (
 IMAGE_BUILD_INPUT_FORMAT: SandboxImageBuildInputFormat = "rootfs_export_tar_gz"
 IMAGE_BUILD_SOURCE_PLATFORM = "linux/amd64"
 TERMINAL_IMAGE_BUILD_STATUSES: FrozenSet[SandboxImageBuildStatus] = frozenset(
-    {"completed", "failed", "canceled", "cancelled"}
+    {"completed", "failed", "canceled"}
 )
 _IMAGE_INIT_ENV_KEY_PATTERN = re.compile(r"^[A-Za-z_][A-Za-z0-9_]*$")
 _RESERVED_IMAGE_INIT_ENV_KEYS = {

{hyperbrowser-1.0.0 → hyperbrowser-1.2.0}/hyperbrowser/client/managers/sync_manager/sandbox.py

@@ -13,6 +13,8 @@ from ....models.sandbox import (
     SandboxExposeResult,
     SandboxImageBuild,
     SandboxImageBuildCreateResult,
+    SandboxImageBuildListParams,
+    SandboxImageBuildListResponse,
     SandboxImageListParams,
     SandboxImageListResponse,
     SandboxImageInit,
@@ -23,8 +25,10 @@ from ....models.sandbox import (
     SandboxNetworkPolicy,
     SandboxNetworkUpdateResult,
     SandboxRuntimeSession,
+    SandboxSnapshotDeleteResult,
     SandboxSnapshotListParams,
     SandboxSnapshotListResponse,
+    SandboxSnapshotSummary,
     SandboxUnexposeResult,
     StartSandboxFromSnapshotParams,
 )
@@ -35,6 +39,7 @@ from ....types import (
     CreateSandboxParams as CreateSandboxParamsDict,
     SandboxExecParams as SandboxExecParamsDict,
     SandboxExposeParams as SandboxExposeParamsDict,
+    SandboxImageBuildListParams as SandboxImageBuildListParamsDict,
     SandboxImageInit as SandboxImageInitDict,
     SandboxImageListParams as SandboxImageListParamsDict,
     SandboxListParams as SandboxListParamsDict,
@@ -159,6 +164,10 @@ class SandboxHandle:
     def disk_mib(self):
         return self._detail.disk_mib
 
+    @property
+    def timeout_minutes(self):
+        return self._detail.timeout_minutes
+
     @property
     def exposed_ports(self):
         return self._detail.exposed_ports
@@ -338,7 +347,7 @@ class SandboxHandle:
         )
 
     def _assert_runtime_available(self) -> None:
-        if self._detail.status in {"closed", "error"}:
+        if self._detail.status in {"closed", "error", "close-error"}:
             raise HyperbrowserError(
                 f"Sandbox {self.id} is not running",
                 status_code=409,
@@ -386,7 +395,7 @@ class SandboxManager:
         ],
     ) -> SandboxHandle:
         normalized = coerce_request(params, StartSandboxFromSnapshotParams)
-        return self.create(normalized)
+        return self.create(normalized.model_dump(exclude_none=True))
 
     def get(self, sandbox_id: str) -> SandboxHandle:
         return self.attach(self.get_detail(sandbox_id))
@@ -442,6 +451,14 @@ class SandboxManager:
         )
         return SandboxSnapshotListResponse(**payload)
 
+    def get_snapshot(self, snapshot: str) -> SandboxSnapshotSummary:
+        payload = self._request("GET", f"/snapshots/{snapshot}")
+        return SandboxSnapshotSummary(**payload["snapshot"])
+
+    def delete_snapshot(self, snapshot: str) -> SandboxSnapshotDeleteResult:
+        payload = self._request("DELETE", f"/snapshots/{snapshot}")
+        return SandboxSnapshotDeleteResult(**payload)
+
     def stop(self, sandbox_id: str) -> BasicResponse:
         payload = self._request("PUT", f"/sandbox/{sandbox_id}/stop")
         return BasicResponse(**payload)
@@ -483,6 +500,22 @@ class SandboxManager:
         payload = self._request("POST", f"/images/builds/{build_id}/cancel")
         return SandboxImageBuild(**payload["build"])
 
+    def list_image_builds(
+        self,
+        params: Optional[
+            Union[SandboxImageBuildListParamsDict, SandboxImageBuildListParams]
+        ] = None,
+    ) -> SandboxImageBuildListResponse:
+        payload = self._request(
+            "GET",
+            "/images/builds",
+            params=dump_request(
+                params if params is not None else {},
+                SandboxImageBuildListParams,
+            ),
+        )
+        return SandboxImageBuildListResponse(**payload)
+
     def wait_for_image_build(
         self,
         build_id: str,

{hyperbrowser-1.0.0 → hyperbrowser-1.2.0}/hyperbrowser/client/managers/sync_manager/volume.py

@@ -1,8 +1,14 @@
-from typing import Union
+from typing import Optional, Union
 
 from hyperbrowser.client._request import dump_request
-from hyperbrowser.models.volume import CreateVolumeParams, Volume, VolumeListResponse
+from hyperbrowser.models.volume import (
+    CreateVolumeParams,
+    Volume,
+    VolumeListParams,
+    VolumeListResponse,
+)
 from hyperbrowser.types import CreateVolumeParams as CreateVolumeParamsDict
+from hyperbrowser.types import VolumeListParams as VolumeListParamsDict
 
 
 class VolumeManager:
@@ -19,8 +25,17 @@ class VolumeManager:
         )
         return Volume(**response.data)
 
-    def list(self) -> VolumeListResponse:
-        response = self._client.transport.get(self._client._build_url("/volume"))
+    def list(
+        self,
+        params: Optional[Union[VolumeListParamsDict, VolumeListParams]] = None,
+    ) -> VolumeListResponse:
+        response = self._client.transport.get(
+            self._client._build_url("/volume"),
+            params=dump_request(
+                params if params is not None else {},
+                VolumeListParams,
+            ),
+        )
         return VolumeListResponse(**response.data)
 
     def get(self, volume_id: str) -> Volume:

{hyperbrowser-1.0.0 → hyperbrowser-1.2.0}/hyperbrowser/models/__init__.py

@@ -210,7 +210,7 @@ from .profile import (
     ProfileListResponse,
     ProfileResponse,
 )
-from .volume import CreateVolumeParams, Volume, VolumeListResponse
+from .volume import CreateVolumeParams, Volume, VolumeListParams, VolumeListResponse
 from .scrape import (
     BatchScrapeJobResponse,
     BatchScrapeJobStatusResponse,
@@ -310,12 +310,14 @@ from .sandbox import (
     SandboxImageListResponse,
     SandboxImageSummary,
     SandboxSnapshotStatus,
+    SandboxSnapshotDeleteResult,
     SandboxSnapshotListResponse,
     SandboxSnapshotSummary,
     SandboxSnapshotListParams,
     SandboxMemorySnapshotParams,
     SandboxMemorySnapshotResult,
     SandboxImageBuildInputFormat,
+    SandboxImageBuildSourcePlatform,
     SandboxImageBuildStatus,
     SandboxImageInit,
     CreateSandboxImageBuildParams,
@@ -323,6 +325,8 @@ from .sandbox import (
     SandboxImageBuildUpload,
     SandboxImageBuild,
     SandboxImageBuildCreateResult,
+    SandboxImageBuildListParams,
+    SandboxImageBuildListResponse,
     SandboxExposeParams,
     SandboxExposeResult,
     SandboxUnexposeResult,
@@ -530,6 +534,7 @@ __all__ = [
     # volume
     "CreateVolumeParams",
     "Volume",
+    "VolumeListParams",
     "VolumeListResponse",
     # scrape
     "BatchScrapeJobResponse",
@@ -604,12 +609,14 @@ __all__ = [
     "SandboxImageListResponse",
     "SandboxImageSummary",
     "SandboxSnapshotStatus",
+    "SandboxSnapshotDeleteResult",
     "SandboxSnapshotListResponse",
     "SandboxSnapshotSummary",
     "SandboxSnapshotListParams",
     "SandboxMemorySnapshotParams",
     "SandboxMemorySnapshotResult",
     "SandboxImageBuildInputFormat",
+    "SandboxImageBuildSourcePlatform",
     "SandboxImageBuildStatus",
     "SandboxImageInit",
     "CreateSandboxImageBuildParams",
@@ -617,6 +624,8 @@ __all__ = [
     "SandboxImageBuildUpload",
     "SandboxImageBuild",
     "SandboxImageBuildCreateResult",
+    "SandboxImageBuildListParams",
+    "SandboxImageBuildListResponse",
     "SandboxExposeParams",
     "SandboxExposeResult",
     "SandboxUnexposeResult",

{hyperbrowser-1.0.0 → hyperbrowser-1.2.0}/hyperbrowser/models/consts.py

@@ -100,6 +100,7 @@ GrokReasoningEffort = Literal[
     "high",
 ]
 SessionRegion = Literal[
+    "us",
     "us-central",
     "asia-south",
     "us-dev",

{hyperbrowser-1.0.0 → hyperbrowser-1.2.0}/hyperbrowser/models/sandbox.py

@@ -39,14 +39,16 @@ SandboxFileWatchRoute = Literal["ws", "stream"]
 SandboxFileSystemEventType = Literal["chmod", "create", "remove", "rename", "write"]
 SandboxVolumeMountType = Literal["rw", "ro"]
 SandboxImageBuildInputFormat = Literal["rootfs_export_tar_gz"]
+SandboxImageBuildSourcePlatform = Literal["linux/amd64"]
 SandboxImageBuildStatus = Literal[
     "awaiting_upload",
     "upload_verified",
+    "dispatching",
     "building",
+    "verifying",
     "completed",
     "failed",
     "canceled",
-    "cancelled",
 ]
 
 
@@ -147,6 +149,7 @@ class Sandbox(SandboxBaseModel):
     cpu: Optional[int] = Field(default=None, alias="vcpus")
     memory_mib: Optional[int] = Field(default=None, alias="memMiB")
     disk_mib: Optional[int] = Field(default=None, alias="diskSizeMiB")
+    timeout_minutes: Optional[int] = Field(default=None, alias="timeoutMinutes")
     runtime: SandboxRuntimeTarget
     exposed_ports: List[SandboxExposeResult] = Field(
         default_factory=list,
@@ -163,6 +166,7 @@ class Sandbox(SandboxBaseModel):
         "cpu",
         "memory_mib",
         "disk_mib",
+        "timeout_minutes",
         mode="before",
     )
     @classmethod
@@ -194,13 +198,7 @@ class SandboxRuntimeSession(SandboxBaseModel):
         return _parse_optional_datetime(value)
 
 
-class CreateSandboxParams(SandboxBaseModel):
-    snapshot_name: Optional[str] = Field(
-        default=None, serialization_alias="snapshotName"
-    )
-    snapshot_id: Optional[str] = Field(default=None, serialization_alias="snapshotId")
-    image_name: Optional[str] = Field(default=None, serialization_alias="imageName")
-    image_id: Optional[str] = Field(default=None, serialization_alias="imageId")
+class _SandboxLaunchCommonParams(SandboxBaseModel):
     region: Optional[SandboxRegion] = None
     enable_recording: Optional[bool] = Field(
         default=None, serialization_alias="enableRecording"
@@ -216,11 +214,6 @@ class CreateSandboxParams(SandboxBaseModel):
     timeout_minutes: Optional[int] = Field(
         default=None, serialization_alias="timeoutMinutes"
     )
-    cpu: Optional[int] = Field(default=None, ge=1, serialization_alias="vcpus")
-    memory_mib: Optional[int] = Field(default=None, ge=1, serialization_alias="memMiB")
-    disk_mib: Optional[int] = Field(
-        default=None, ge=1, serialization_alias="diskSizeMiB"
-    )
     allow_internet_access: Optional[bool] = Field(
         default=None,
         serialization_alias="allowInternetAccess",
@@ -228,6 +221,20 @@ class CreateSandboxParams(SandboxBaseModel):
     allow_out: Optional[List[str]] = Field(default=None, serialization_alias="allowOut")
     deny_out: Optional[List[str]] = Field(default=None, serialization_alias="denyOut")
 
+
+class CreateSandboxParams(_SandboxLaunchCommonParams):
+    snapshot_name: Optional[str] = Field(
+        default=None, serialization_alias="snapshotName"
+    )
+    snapshot_id: Optional[str] = Field(default=None, serialization_alias="snapshotId")
+    image_name: Optional[str] = Field(default=None, serialization_alias="imageName")
+    image_id: Optional[str] = Field(default=None, serialization_alias="imageId")
+    cpu: Optional[int] = Field(default=None, ge=1, serialization_alias="vcpus")
+    memory_mib: Optional[int] = Field(default=None, ge=1, serialization_alias="memMiB")
+    disk_mib: Optional[int] = Field(
+        default=None, ge=1, serialization_alias="diskSizeMiB"
+    )
+
     @model_validator(mode="after")
     def validate_launch_source(self):
         if self.snapshot_id and not self.snapshot_name:
@@ -250,8 +257,11 @@ class CreateSandboxParams(SandboxBaseModel):
         return self
 
 
-class StartSandboxFromSnapshotParams(CreateSandboxParams):
-    pass
+class StartSandboxFromSnapshotParams(_SandboxLaunchCommonParams):
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+
+    snapshot_name: str = Field(min_length=1, serialization_alias="snapshotName")
+    snapshot_id: Optional[str] = Field(default=None, serialization_alias="snapshotId")
 
 
 class SandboxListParams(SandboxBaseModel):
@@ -309,6 +319,9 @@ class SandboxSnapshotSummary(SandboxBaseModel):
     image_name: str = Field(alias="imageName")
     image_id: str = Field(alias="imageId")
     status: SandboxSnapshotStatus
+    vcpus: Optional[int] = None
+    mem_mib: Optional[int] = Field(default=None, alias="memMiB")
+    disk_size_mib: Optional[int] = Field(default=None, alias="diskSizeMiB")
     compatibility_tag: Optional[str] = Field(default=None, alias="compatibilityTag")
     metadata: Dict[str, object]
     uploaded: bool
@@ -334,6 +347,10 @@ class SandboxSnapshotListResponse(SandboxBaseModel):
     per_page: Optional[int] = Field(default=None, alias="perPage")
 
 
+class SandboxSnapshotDeleteResult(SandboxBaseModel):
+    deleted: bool
+
+
 class SandboxMemorySnapshotParams(SandboxBaseModel):
     snapshot_name: Optional[str] = Field(
         default=None, serialization_alias="snapshotName"
@@ -354,12 +371,12 @@ class CreateSandboxImageBuildParams(SandboxBaseModel):
     image_name: str = Field(serialization_alias="imageName")
     input_sha256: str = Field(serialization_alias="inputSha256")
     input_size_bytes: int = Field(serialization_alias="inputSizeBytes")
-    input_format: SandboxImageBuildInputFormat = Field(
-        default="rootfs_export_tar_gz",
+    input_format: Optional[SandboxImageBuildInputFormat] = Field(
+        default=None,
         serialization_alias="inputFormat",
     )
-    source_platform: str = Field(
-        default="linux/amd64",
+    source_platform: Optional[SandboxImageBuildSourcePlatform] = Field(
+        default=None,
         serialization_alias="sourcePlatform",
     )
     image_config_user: Optional[str] = Field(
@@ -375,8 +392,8 @@ class CreateSandboxImageBuildParams(SandboxBaseModel):
 class CompleteSandboxImageBuildParams(SandboxBaseModel):
     input_sha256: str = Field(serialization_alias="inputSha256")
     input_size_bytes: int = Field(serialization_alias="inputSizeBytes")
-    input_format: SandboxImageBuildInputFormat = Field(
-        default="rootfs_export_tar_gz",
+    input_format: Optional[SandboxImageBuildInputFormat] = Field(
+        default=None,
         serialization_alias="inputFormat",
     )
 
@@ -423,6 +440,15 @@ class SandboxImageBuildCreateResult(SandboxBaseModel):
     upload: SandboxImageBuildUpload
 
 
+class SandboxImageBuildListParams(SandboxBaseModel):
+    status: Optional[SandboxImageBuildStatus] = None
+    limit: Optional[int] = None
+
+
+class SandboxImageBuildListResponse(SandboxBaseModel):
+    builds: List[SandboxImageBuild]
+
+
 class SandboxExecParams(SandboxBaseModel):
     command: str
     args: Optional[List[str]] = None

{hyperbrowser-1.0.0 → hyperbrowser-1.2.0}/hyperbrowser/models/session.py

@@ -15,7 +15,7 @@ from hyperbrowser.models.consts import (
     SessionEventLogType,
 )
 
-SessionStatus = Literal["active", "closed", "error"]
+SessionStatus = Literal["active", "closed", "error", "close-error"]
 BrowserMemorySize = Literal["small", "medium", "large"]
 CaptchaSolverType = Literal["visual"]
 CaptchaEvaluationType = Literal[
@@ -144,6 +144,11 @@ class SessionLaunchState(BaseModel):
         default=None, alias="enableVideoWebRecording"
     )
     enable_log_capture: Optional[bool] = Field(default=None, alias="enableLogCapture")
+    allow_internet_access: Optional[bool] = Field(
+        default=None, alias="allowInternetAccess"
+    )
+    allow_out: Optional[List[str]] = Field(default=None, alias="allowOut")
+    deny_out: Optional[List[str]] = Field(default=None, alias="denyOut")
     accept_cookies: Optional[bool] = Field(default=None, alias="acceptCookies")
     solver_type: Optional[CaptchaSolverType] = Field(default=None, alias="solverType")
     profile: Optional[SessionProfile] = Field(default=None, alias="profile")
@@ -472,6 +477,11 @@ class CreateSessionParams(BaseModel):
     timeout_minutes: Optional[int] = Field(
         default=None, serialization_alias="timeoutMinutes"
     )
+    allow_internet_access: Optional[bool] = Field(
+        default=None, serialization_alias="allowInternetAccess"
+    )
+    allow_out: Optional[List[str]] = Field(default=None, serialization_alias="allowOut")
+    deny_out: Optional[List[str]] = Field(default=None, serialization_alias="denyOut")
     enable_window_manager: Optional[bool] = Field(
         default=None, serialization_alias="enableWindowManager"
     )

{hyperbrowser-1.0.0 → hyperbrowser-1.2.0}/hyperbrowser/models/volume.py

@@ -13,6 +13,12 @@ class CreateVolumeParams(VolumeBaseModel):
     name: str
 
 
+class VolumeListParams(VolumeBaseModel):
+    page: Optional[int] = None
+    limit: Optional[int] = None
+    search: Optional[str] = None
+
+
 class Volume(VolumeBaseModel):
     id: str
     name: str
@@ -27,3 +33,6 @@ class Volume(VolumeBaseModel):
 
 class VolumeListResponse(VolumeBaseModel):
     volumes: List[Volume]
+    total_count: Optional[int] = Field(default=None, alias="totalCount")
+    page: Optional[int] = None
+    per_page: Optional[int] = Field(default=None, alias="perPage")

{hyperbrowser-1.0.0 → hyperbrowser-1.2.0}/hyperbrowser/types/__init__.py

@@ -81,6 +81,9 @@ from .sandbox import (
     SandboxFileWriteEntry,
     SandboxFileWriteTextParams,
     SandboxImageBuildInputFormat,
+    SandboxImageBuildListParams,
+    SandboxImageBuildSourcePlatform,
+    SandboxImageBuildStatus,
     SandboxImageInit,
     SandboxImageListParams,
     SandboxListParams,
@@ -132,7 +135,7 @@ from .session import (
     UpdateSessionScreenParams,
     UpdateSessionSolveCaptchasParams,
 )
-from .volume import CreateVolumeParams
+from .volume import CreateVolumeParams, VolumeListParams
 from .web import (
     FetchBrowserLocationOptions,
     FetchBrowserOptions,
@@ -235,6 +238,9 @@ __all__ = [
     "SandboxFileWriteEntry",
     "SandboxFileWriteTextParams",
     "SandboxImageBuildInputFormat",
+    "SandboxImageBuildListParams",
+    "SandboxImageBuildSourcePlatform",
+    "SandboxImageBuildStatus",
     "SandboxImageInit",
     "SandboxImageListParams",
     "SandboxListParams",
@@ -282,6 +288,7 @@ __all__ = [
     "UpdateSessionScreenParams",
     "UpdateSessionSolveCaptchasParams",
     "CreateVolumeParams",
+    "VolumeListParams",
     "FetchBrowserLocationOptions",
     "FetchBrowserOptions",
     "FetchCacheOptions",

{hyperbrowser-1.0.0 → hyperbrowser-1.2.0}/hyperbrowser/types/sandbox.py

@@ -3,7 +3,7 @@ from typing import Dict, List, Literal, Optional, Union
 from typing_extensions import Required, TypeAlias, TypedDict
 
 
-SandboxStatus: TypeAlias = Literal["active", "closed", "error"]
+SandboxStatus: TypeAlias = Literal["active", "closed", "error", "close-error"]
 SandboxRegion: TypeAlias = Literal[
     "us-central",
     "asia-south",
@@ -27,6 +27,17 @@ SandboxFileReadFormat: TypeAlias = Literal["text", "bytes", "blob", "stream"]
 SandboxFileWatchRoute: TypeAlias = Literal["ws", "stream"]
 SandboxVolumeMountType: TypeAlias = Literal["rw", "ro"]
 SandboxImageBuildInputFormat: TypeAlias = Literal["rootfs_export_tar_gz"]
+SandboxImageBuildSourcePlatform: TypeAlias = Literal["linux/amd64"]
+SandboxImageBuildStatus: TypeAlias = Literal[
+    "awaiting_upload",
+    "upload_verified",
+    "dispatching",
+    "building",
+    "verifying",
+    "completed",
+    "failed",
+    "canceled",
+]
 SandboxFileWriteData: TypeAlias = Union[str, bytes]
 
 
@@ -128,6 +139,13 @@ class SandboxSnapshotListParams(TypedDict, total=False):
     page: Optional[int]
 
 
+class SandboxImageBuildListParams(TypedDict, total=False):
+    """Filters for listing sandbox image builds."""
+
+    status: Optional[SandboxImageBuildStatus]
+    limit: Optional[int]
+
+
 class SandboxMemorySnapshotParams(TypedDict, total=False):
     """Parameters for creating a sandbox memory snapshot."""
 
@@ -141,7 +159,7 @@ class CreateSandboxImageBuildParams(TypedDict, total=False):
     input_sha256: Required[str]
     input_size_bytes: Required[int]
     input_format: SandboxImageBuildInputFormat
-    source_platform: str
+    source_platform: SandboxImageBuildSourcePlatform
     image_config_user: Optional[str]
     image_init: Optional[SandboxImageInit]
 
@@ -415,6 +433,9 @@ __all__ = [
     "SandboxFileWriteEntry",
     "SandboxFileWriteTextParams",
     "SandboxImageBuildInputFormat",
+    "SandboxImageBuildListParams",
+    "SandboxImageBuildSourcePlatform",
+    "SandboxImageBuildStatus",
     "SandboxImageInit",
     "SandboxImageListParams",
     "SandboxListParams",

{hyperbrowser-1.0.0 → hyperbrowser-1.2.0}/hyperbrowser/types/session.py

@@ -13,7 +13,7 @@ from hyperbrowser.models.consts import (
 )
 
 
-SessionStatus = Literal["active", "closed", "error"]
+SessionStatus = Literal["active", "closed", "error", "close-error"]
 BrowserMemorySize = Literal["small", "medium", "large"]
 CaptchaSolverType = Literal["visual"]
 CaptchaEvaluationType = Literal[
@@ -149,6 +149,9 @@ class CreateSessionParams(TypedDict, total=False):
     save_downloads: Optional[bool]
     image_captcha_params: Optional[List[ImageCaptchaParam]]
     timeout_minutes: Optional[int]
+    allow_internet_access: Optional[bool]
+    allow_out: Optional[List[str]]
+    deny_out: Optional[List[str]]
     enable_window_manager: Optional[bool]
     enable_window_manager_taskbar: Optional[bool]
     region: Optional[SessionRegion]

hyperbrowser-1.2.0/hyperbrowser/types/volume.py

@@ -0,0 +1,20 @@
+from typing import Optional
+
+from typing_extensions import TypedDict
+
+
+class CreateVolumeParams(TypedDict):
+    """Parameters for creating a persistent sandbox volume."""
+
+    name: str
+
+
+class VolumeListParams(TypedDict, total=False):
+    """Filters and pagination for listing sandbox volumes."""
+
+    page: Optional[int]
+    limit: Optional[int]
+    search: Optional[str]
+
+
+__all__ = ["CreateVolumeParams", "VolumeListParams"]

{hyperbrowser-1.0.0 → hyperbrowser-1.2.0}/pyproject.toml

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

hyperbrowser-1.0.0/hyperbrowser/types/volume.py

@@ -1,10 +0,0 @@
-from typing_extensions import TypedDict
-
-
-class CreateVolumeParams(TypedDict):
-    """Parameters for creating a persistent sandbox volume."""
-
-    name: str
-
-
-__all__ = ["CreateVolumeParams"]