Merge pull request #21 from onkernel/release-please--branches--main--changes--next

release: 0.3.0

Author: rgarcia

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.2.0"
+  ".": "0.3.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 7
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-39aa058a60035c34a636e7f580b4b9c76b05400ae401ef04a761572b20a5425b.yml
-openapi_spec_hash: bb79a204f9edb6b6ccfe783a0a82a423
-config_hash: 3eb1ed1dd0067258984b31d53a0dab48
+configured_endpoints: 10
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-3edc7a0eef4a0d4495782efbdb0d9b777a55aee058dab119f90de56019441326.yml
+openapi_spec_hash: dff0b1efa1c1614cf770ed8327cefab2
+config_hash: cb04a4d88ee9f530b303ca57ff7090b3

CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.3.0 (2025-05-22)
+
+Full Changelog: [v0.2.0...v0.3.0](https://github.com/onkernel/kernel-python-sdk/compare/v0.2.0...v0.3.0)
+
+### Features
+
+* **api:** update via SDK Studio ([e87dc0f](https://github.com/onkernel/kernel-python-sdk/commit/e87dc0f7ab8eac43664050e0325fca9225b12c16))
+* **api:** update via SDK Studio ([e4b0438](https://github.com/onkernel/kernel-python-sdk/commit/e4b0438d63b71ea30feae04328f32ddbcdd2b15e))
+* **api:** update via SDK Studio ([4a8f812](https://github.com/onkernel/kernel-python-sdk/commit/4a8f812a39dcf768ac753c77d1d2d31881d8c4ec))
+* **api:** update via SDK Studio ([260f1a2](https://github.com/onkernel/kernel-python-sdk/commit/260f1a2e5e877e91c066935533c376c341612557))
+
+
+### Chores
+
+* **docs:** grammar improvements ([f0f0e85](https://github.com/onkernel/kernel-python-sdk/commit/f0f0e855505db93ad22cea24ec73acf13b4f8ed5))
+
 ## 0.2.0 (2025-05-21)
 
 Full Changelog: [v0.1.0...v0.2.0](https://github.com/onkernel/kernel-python-sdk/compare/v0.1.0...v0.2.0)

README.md

@@ -87,6 +87,22 @@ Nested request parameters are [TypedDicts](https://docs.python.org/3/library/typ
 
 Typed requests and responses provide autocomplete and documentation within your editor. If you would like to see type errors in VS Code to help catch bugs earlier, set `python.analysis.typeCheckingMode` to `basic`.
 
+## Nested params
+
+Nested parameters are dictionaries, typed using `TypedDict`, for example:
+
+```python
+from kernel import Kernel
+
+client = Kernel()
+
+browser = client.browsers.create(
+    invocation_id="rr33xuugxj9h0bkf1rdt2bet",
+    persistence={"id": "my-awesome-browser-for-user-1234"},
+)
+print(browser.persistence)
+```
+
 ## File uploads
 
 Request parameters that correspond to file uploads can be passed as `bytes`, or a [`PathLike`](https://docs.python.org/3/library/os.html#os.PathLike) instance or a tuple of `(filename, contents, media type)`.
@@ -123,6 +139,7 @@ client = Kernel()
 try:
     client.browsers.create(
         invocation_id="REPLACE_ME",
+        persistence={"id": "browser-for-user-1234"},
     )
 except kernel.APIConnectionError as e:
     print("The server could not be reached")
@@ -168,6 +185,7 @@ client = Kernel(
 # Or, configure per-request:
 client.with_options(max_retries=5).browsers.create(
     invocation_id="REPLACE_ME",
+    persistence={"id": "browser-for-user-1234"},
 )
 ```
 
@@ -193,6 +211,7 @@ client = Kernel(
 # Override per-request:
 client.with_options(timeout=5.0).browsers.create(
     invocation_id="REPLACE_ME",
+    persistence={"id": "browser-for-user-1234"},
 )
 ```
 
@@ -236,6 +255,9 @@ from kernel import Kernel
 client = Kernel()
 response = client.browsers.with_raw_response.create(
     invocation_id="REPLACE_ME",
+    persistence={
+        "id": "browser-for-user-1234"
+    },
 )
 print(response.headers.get('X-My-Header'))
 
@@ -256,6 +278,7 @@ To stream the response body, use `.with_streaming_response` instead, which requi
 ```python
 with client.browsers.with_streaming_response.create(
     invocation_id="REPLACE_ME",
+    persistence={"id": "browser-for-user-1234"},
 ) as response:
     print(response.headers.get("X-My-Header"))
 

SECURITY.md

@@ -16,7 +16,7 @@ before making any information public.
 ## Reporting Non-SDK Related Security Issues
 
 If you encounter security issues that are not directly related to SDKs but pertain to the services
-or products provided by Kernel please follow the respective company's security reporting guidelines.
+or products provided by Kernel, please follow the respective company's security reporting guidelines.
 
 ---
 

api.md

@@ -41,10 +41,18 @@ Methods:
 Types:
 
 ```python
-from kernel.types import BrowserCreateResponse, BrowserRetrieveResponse
+from kernel.types import (
+    BrowserPersistence,
+    BrowserCreateResponse,
+    BrowserRetrieveResponse,
+    BrowserListResponse,
+)
 ```
 
 Methods:
 
 - <code title="post /browsers">client.browsers.<a href="./src/kernel/resources/browsers.py">create</a>(\*\*<a href="src/kernel/types/browser_create_params.py">params</a>) -> <a href="./src/kernel/types/browser_create_response.py">BrowserCreateResponse</a></code>
 - <code title="get /browsers/{id}">client.browsers.<a href="./src/kernel/resources/browsers.py">retrieve</a>(id) -> <a href="./src/kernel/types/browser_retrieve_response.py">BrowserRetrieveResponse</a></code>
+- <code title="get /browsers">client.browsers.<a href="./src/kernel/resources/browsers.py">list</a>() -> <a href="./src/kernel/types/browser_list_response.py">BrowserListResponse</a></code>
+- <code title="delete /browsers">client.browsers.<a href="./src/kernel/resources/browsers.py">delete</a>(\*\*<a href="src/kernel/types/browser_delete_params.py">params</a>) -> None</code>
+- <code title="delete /browsers/{id}">client.browsers.<a href="./src/kernel/resources/browsers.py">delete_by_id</a>(id) -> None</code>

pyproject.toml

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

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.2.0"  # x-release-please-version
+__version__ = "0.3.0"  # x-release-please-version