feat: Expose configurable browser memory

Stainless-Generated-From: 32f5b5d0edf73007529398a1c89d0f9ef15e060a

Author: kernel-internal[bot]

api.md

@@ -80,6 +80,8 @@ Types:
 
 ```python
 from kernel.types import (
+    BrowserMemory,
+    BrowserMemoryRequest,
     BrowserNetworkConfig,
     BrowserPoolRef,
     BrowserProxy,

src/kernel/resources/browsers/browsers.py

@@ -25,6 +25,7 @@
     AsyncFsResourceWithStreamingResponse,
 )
 from ...types import (
+    BrowserMemoryRequest,
     browser_curl_params,
     browser_list_params,
     browser_create_params,
@@ -94,6 +95,7 @@
     async_stream_via_browser_route,
     async_request_via_browser_route,
 )
+from ...types.browser_memory_request import BrowserMemoryRequest
 from ...types.browser_create_response import BrowserCreateResponse
 from ...types.browser_update_response import BrowserUpdateResponse
 from ...types.browser_retrieve_response import BrowserRetrieveResponse
@@ -172,6 +174,7 @@ def create(
         headless: bool | Omit = omit,
         invocation_id: str | Omit = omit,
         kiosk_mode: bool | Omit = omit,
+        memory: BrowserMemoryRequest | Omit = omit,
         name: str | Omit = omit,
         network: BrowserNetworkConfigParam | Omit = omit,
         profile: BrowserProfile | Omit = omit,
@@ -213,6 +216,8 @@ def create(
           kiosk_mode: If true, launches the browser in kiosk mode to hide address bar and tabs in live
               view.
 
+          memory: Memory for a headful, non-GPU browser session. Defaults to 8GiB.
+
           name: Optional human-readable name for the browser session, used to find it later in
               the dashboard. Must be unique among active sessions within the project. Can be
               changed later via PATCH /browsers/{id_or_name}.
@@ -295,6 +300,7 @@ def create(
                     "headless": headless,
                     "invocation_id": invocation_id,
                     "kiosk_mode": kiosk_mode,
+                    "memory": memory,
                     "name": name,
                     "network": network,
                     "profile": profile,
@@ -786,6 +792,7 @@ async def create(
         headless: bool | Omit = omit,
         invocation_id: str | Omit = omit,
         kiosk_mode: bool | Omit = omit,
+        memory: BrowserMemoryRequest | Omit = omit,
         name: str | Omit = omit,
         network: BrowserNetworkConfigParam | Omit = omit,
         profile: BrowserProfile | Omit = omit,
@@ -827,6 +834,8 @@ async def create(
           kiosk_mode: If true, launches the browser in kiosk mode to hide address bar and tabs in live
               view.
 
+          memory: Memory for a headful, non-GPU browser session. Defaults to 8GiB.
+
           name: Optional human-readable name for the browser session, used to find it later in
               the dashboard. Must be unique among active sessions within the project. Can be
               changed later via PATCH /browsers/{id_or_name}.
@@ -909,6 +918,7 @@ async def create(
                     "headless": headless,
                     "invocation_id": invocation_id,
                     "kiosk_mode": kiosk_mode,
+                    "memory": memory,
                     "name": name,
                     "network": network,
                     "profile": profile,

src/kernel/types/__init__.py

@@ -24,6 +24,7 @@
 from .browser_pool import BrowserPool as BrowserPool
 from .browser_proxy import BrowserProxy as BrowserProxy
 from .browser_usage import BrowserUsage as BrowserUsage
+from .browser_memory import BrowserMemory as BrowserMemory
 from .app_list_params import AppListParams as AppListParams
 from .audit_log_entry import AuditLogEntry as AuditLogEntry
 from .created_api_key import CreatedAPIKey as CreatedAPIKey
@@ -58,6 +59,7 @@
 from .project_update_params import ProjectUpdateParams as ProjectUpdateParams
 from .proxy_create_response import ProxyCreateResponse as ProxyCreateResponse
 from .proxy_update_response import ProxyUpdateResponse as ProxyUpdateResponse
+from .browser_memory_request import BrowserMemoryRequest as BrowserMemoryRequest
 from .browser_network_config import BrowserNetworkConfig as BrowserNetworkConfig
 from .credential_list_params import CredentialListParams as CredentialListParams
 from .deployment_list_params import DeploymentListParams as DeploymentListParams

src/kernel/types/browser_create_params.py

@@ -6,6 +6,7 @@
 from typing_extensions import Literal, TypedDict
 
 from .tags_param import TagsParam
+from .browser_memory_request import BrowserMemoryRequest
 from .browser_proxy_config_param import BrowserProxyConfigParam
 from .browser_network_config_param import BrowserNetworkConfigParam
 from .shared_params.browser_profile import BrowserProfile
@@ -58,6 +59,9 @@ class BrowserCreateParams(TypedDict, total=False):
     view.
     """
 
+    memory: BrowserMemoryRequest
+    """Memory for a headful, non-GPU browser session. Defaults to 8GiB."""
+
     name: str
     """
     Optional human-readable name for the browser session, used to find it later in

src/kernel/types/browser_create_response.py

@@ -9,6 +9,7 @@
 from .._models import BaseModel
 from .browser_proxy import BrowserProxy
 from .browser_usage import BrowserUsage
+from .browser_memory import BrowserMemory
 from .browser_pool_ref import BrowserPoolRef
 from .browser_network_config import BrowserNetworkConfig
 from .shared.browser_viewport import BrowserViewport
@@ -27,6 +28,9 @@ class BrowserCreateResponse(BaseModel):
     headless: bool
     """Whether the browser session is running in headless mode."""
 
+    memory: BrowserMemory
+    """Memory allocated to the browser session."""
+
     region: Literal["us-east", "eu-west"]
     """Geographic region of the browser session. Fixed once the session is created."""
 

src/kernel/types/browser_list_response.py

@@ -9,6 +9,7 @@
 from .._models import BaseModel
 from .browser_proxy import BrowserProxy
 from .browser_usage import BrowserUsage
+from .browser_memory import BrowserMemory
 from .browser_pool_ref import BrowserPoolRef
 from .browser_network_config import BrowserNetworkConfig
 from .shared.browser_viewport import BrowserViewport
@@ -27,6 +28,9 @@ class BrowserListResponse(BaseModel):
     headless: bool
     """Whether the browser session is running in headless mode."""
 
+    memory: BrowserMemory
+    """Memory allocated to the browser session."""
+
     region: Literal["us-east", "eu-west"]
     """Geographic region of the browser session. Fixed once the session is created."""
 

src/kernel/types/browser_memory.py

@@ -0,0 +1,7 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import Literal, TypeAlias
+
+__all__ = ["BrowserMemory"]
+
+BrowserMemory: TypeAlias = Literal["1GiB", "2GiB", "6GiB", "8GiB", "16GiB"]

src/kernel/types/browser_memory_request.py

@@ -0,0 +1,7 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import Literal, TypeAlias
+
+__all__ = ["BrowserMemoryRequest"]
+
+BrowserMemoryRequest: TypeAlias = Literal["8GiB", "16GiB"]

src/kernel/types/browser_pool_acquire_response.py

@@ -9,6 +9,7 @@
 from .._models import BaseModel
 from .browser_proxy import BrowserProxy
 from .browser_usage import BrowserUsage
+from .browser_memory import BrowserMemory
 from .browser_pool_ref import BrowserPoolRef
 from .browser_network_config import BrowserNetworkConfig
 from .shared.browser_viewport import BrowserViewport
@@ -27,6 +28,9 @@ class BrowserPoolAcquireResponse(BaseModel):
     headless: bool
     """Whether the browser session is running in headless mode."""
 
+    memory: BrowserMemory
+    """Memory allocated to the browser session."""
+
     region: Literal["us-east", "eu-west"]
     """Geographic region of the browser session. Fixed once the session is created."""
 

src/kernel/types/browser_retrieve_response.py

@@ -9,6 +9,7 @@
 from .._models import BaseModel
 from .browser_proxy import BrowserProxy
 from .browser_usage import BrowserUsage
+from .browser_memory import BrowserMemory
 from .browser_pool_ref import BrowserPoolRef
 from .browser_network_config import BrowserNetworkConfig
 from .shared.browser_viewport import BrowserViewport
@@ -27,6 +28,9 @@ class BrowserRetrieveResponse(BaseModel):
     headless: bool
     """Whether the browser session is running in headless mode."""
 
+    memory: BrowserMemory
+    """Memory allocated to the browser session."""
+
     region: Literal["us-east", "eu-west"]
     """Geographic region of the browser session. Fixed once the session is created."""