feat(api): add browser ttls

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 31
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-e907afeabfeea49dedd783112ac3fd29267bc86f3d594f89ba9a2abf2bcbc9d8.yml
-openapi_spec_hash: 060ca6288c1a09b6d1bdf207a0011165
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-6f4aab5f0db80d6ce30ef40274eee347cce0a9465e7f1e5077f8f4a085251ddf.yml
+openapi_spec_hash: 8e83254243d1620b80a0dc8aa212ee0d
 config_hash: f67e4b33b2fb30c1405ee2fff8096320

src/kernel/resources/browsers/browsers.py

@@ -75,6 +75,7 @@ def create(
         invocation_id: str | NotGiven = NOT_GIVEN,
         persistence: BrowserPersistenceParam | NotGiven = NOT_GIVEN,
         stealth: bool | NotGiven = NOT_GIVEN,
+        timeout_seconds: int | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -96,6 +97,10 @@ def create(
           stealth: If true, launches the browser in stealth mode to reduce detection by anti-bot
               mechanisms.
 
+          timeout_seconds: The number of seconds of inactivity before the browser session is terminated.
+              Only applicable to non-persistent browsers. Activity includes CDP connections
+              and live view connections. Defaults to 60 seconds.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -112,6 +117,7 @@ def create(
                     "invocation_id": invocation_id,
                     "persistence": persistence,
                     "stealth": stealth,
+                    "timeout_seconds": timeout_seconds,
                 },
                 browser_create_params.BrowserCreateParams,
             ),
@@ -281,6 +287,7 @@ async def create(
         invocation_id: str | NotGiven = NOT_GIVEN,
         persistence: BrowserPersistenceParam | NotGiven = NOT_GIVEN,
         stealth: bool | NotGiven = NOT_GIVEN,
+        timeout_seconds: int | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -302,6 +309,10 @@ async def create(
           stealth: If true, launches the browser in stealth mode to reduce detection by anti-bot
               mechanisms.
 
+          timeout_seconds: The number of seconds of inactivity before the browser session is terminated.
+              Only applicable to non-persistent browsers. Activity includes CDP connections
+              and live view connections. Defaults to 60 seconds.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -318,6 +329,7 @@ async def create(
                     "invocation_id": invocation_id,
                     "persistence": persistence,
                     "stealth": stealth,
+                    "timeout_seconds": timeout_seconds,
                 },
                 browser_create_params.BrowserCreateParams,
             ),

src/kernel/types/browser_create_params.py

@@ -27,3 +27,10 @@ class BrowserCreateParams(TypedDict, total=False):
     If true, launches the browser in stealth mode to reduce detection by anti-bot
     mechanisms.
     """
+
+    timeout_seconds: int
+    """The number of seconds of inactivity before the browser session is terminated.
+
+    Only applicable to non-persistent browsers. Activity includes CDP connections
+    and live view connections. Defaults to 60 seconds.
+    """

src/kernel/types/browser_create_response.py

@@ -12,9 +12,18 @@ class BrowserCreateResponse(BaseModel):
     cdp_ws_url: str
     """Websocket URL for Chrome DevTools Protocol connections to the browser session"""
 
+    headless: bool
+    """Indicates whether the browser session is headless."""
+
     session_id: str
     """Unique identifier for the browser session"""
 
+    stealth: bool
+    """Indicates whether the browser session is stealth."""
+
+    timeout_seconds: int
+    """The number of seconds of inactivity before the browser session is terminated."""
+
     browser_live_view_url: Optional[str] = None
     """Remote URL for live viewing the browser session.
 

src/kernel/types/browser_list_response.py

@@ -13,9 +13,18 @@ class BrowserListResponseItem(BaseModel):
     cdp_ws_url: str
     """Websocket URL for Chrome DevTools Protocol connections to the browser session"""
 
+    headless: bool
+    """Indicates whether the browser session is headless."""
+
     session_id: str
     """Unique identifier for the browser session"""
 
+    stealth: bool
+    """Indicates whether the browser session is stealth."""
+
+    timeout_seconds: int
+    """The number of seconds of inactivity before the browser session is terminated."""
+
     browser_live_view_url: Optional[str] = None
     """Remote URL for live viewing the browser session.
 

src/kernel/types/browser_retrieve_response.py

@@ -12,9 +12,18 @@ class BrowserRetrieveResponse(BaseModel):
     cdp_ws_url: str
     """Websocket URL for Chrome DevTools Protocol connections to the browser session"""
 
+    headless: bool
+    """Indicates whether the browser session is headless."""
+
     session_id: str
     """Unique identifier for the browser session"""
 
+    stealth: bool
+    """Indicates whether the browser session is stealth."""
+
+    timeout_seconds: int
+    """The number of seconds of inactivity before the browser session is terminated."""
+
     browser_live_view_url: Optional[str] = None
     """Remote URL for live viewing the browser session.
 

tests/api_resources/test_browsers.py

@@ -35,6 +35,7 @@ def test_method_create_with_all_params(self, client: Kernel) -> None:
             invocation_id="rr33xuugxj9h0bkf1rdt2bet",
             persistence={"id": "my-awesome-browser-for-user-1234"},
             stealth=True,
+            timeout_seconds=0,
         )
         assert_matches_type(BrowserCreateResponse, browser, path=["response"])
 
@@ -226,6 +227,7 @@ async def test_method_create_with_all_params(self, async_client: AsyncKernel) ->
             invocation_id="rr33xuugxj9h0bkf1rdt2bet",
             persistence={"id": "my-awesome-browser-for-user-1234"},
             stealth=True,
+            timeout_seconds=0,
         )
         assert_matches_type(BrowserCreateResponse, browser, path=["response"])