release: 0.9.1

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.9.0"
+  ".": "0.9.1"
 }

.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

CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 0.9.1 (2025-08-12)
+
+Full Changelog: [v0.9.0...v0.9.1](https://github.com/onkernel/kernel-python-sdk/compare/v0.9.0...v0.9.1)
+
+### Features
+
+* **api:** add browser ttls ([ad95f5f](https://github.com/onkernel/kernel-python-sdk/commit/ad95f5f609fead980b2d96b86f871682cad75ae2))
+
+
+### Chores
+
+* **internal:** codegen related update ([024c808](https://github.com/onkernel/kernel-python-sdk/commit/024c80865450277ca40433a7caaff078b5a25486))
+* **internal:** update comment in script ([4279b99](https://github.com/onkernel/kernel-python-sdk/commit/4279b9927f99897dde36c07f5dc39ed2680ad261))
+* update @stainless-api/prism-cli to v5.15.0 ([e78750e](https://github.com/onkernel/kernel-python-sdk/commit/e78750efdc419051c8db37ac89df111e81fa0401))
+
 ## 0.9.0 (2025-08-08)
 
 Full Changelog: [v0.8.3...v0.9.0](https://github.com/onkernel/kernel-python-sdk/compare/v0.8.3...v0.9.0)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kernel"
-version = "0.9.0"
+version = "0.9.1"
 description = "The official Python library for the kernel API"
 dynamic = ["readme"]
 license = "Apache-2.0"

scripts/mock

@@ -21,7 +21,7 @@ echo "==> Starting mock server with URL ${URL}"
 
 # Run prism mock on the given spec
 if [ "$1" == "--daemon" ]; then
-  npm exec --package=@stainless-api/prism-cli@5.8.5 -- prism mock "$URL" &> .prism.log &
+  npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock "$URL" &> .prism.log &
 
   # Wait for server to come online
   echo -n "Waiting for server"
@@ -37,5 +37,5 @@ if [ "$1" == "--daemon" ]; then
 
   echo
 else
-  npm exec --package=@stainless-api/prism-cli@5.8.5 -- prism mock "$URL"
+  npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock "$URL"
 fi

scripts/test

@@ -43,7 +43,7 @@ elif ! prism_is_running ; then
   echo -e "To run the server, pass in the path or url of your OpenAPI"
   echo -e "spec to the prism command:"
   echo
-  echo -e "  \$ ${YELLOW}npm exec --package=@stoplight/prism-cli@~5.3.2 -- prism mock path/to/your.openapi.yml${NC}"
+  echo -e "  \$ ${YELLOW}npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock path/to/your.openapi.yml${NC}"
   echo
 
   exit 1

src/kernel/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "kernel"
-__version__ = "0.9.0"  # x-release-please-version
+__version__ = "0.9.1"  # x-release-please-version

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.