kernel 0.111.0__tar.gz → 0.113.0__tar.gz

kernel-0.113.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.113.0"
+}

{kernel-0.111.0 → kernel-0.113.0}/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## [0.113.0](https://github.com/kernel/kernel-python-sdk/compare/v0.112.0...v0.113.0) (2026-09-27)
+
+
+### Features
+
+* Randomize automatic search provider routing ([1da4b21](https://github.com/kernel/kernel-python-sdk/commit/1da4b212644549666e19f23146b8d1e2ab9511d9))
+* Support 16GiB memory in browser pools ([7d004de](https://github.com/kernel/kernel-python-sdk/commit/7d004def693a57505b4294307b272ba1fc4f78b2))
+
+## [0.112.0](https://github.com/kernel/kernel-python-sdk/compare/v0.111.0...v0.112.0) (2026-09-24)
+
+
+### Features
+
+* Add profiles to browser pool acquire ([f5c540c](https://github.com/kernel/kernel-python-sdk/commit/f5c540cdd1b0cee422cf47825dbc2212a5b6532f))
+* Correct monitor_disconnected description on computed state ([2b637f5](https://github.com/kernel/kernel-python-sdk/commit/2b637f562b34ad0963b8ba4d0ecca73fa1dd6349))
+* Expose Search rollout access in org entitlements ([cbbbe4c](https://github.com/kernel/kernel-python-sdk/commit/cbbbe4c865eb72c10be0f95e472921cf61898abc))
+* Filter archived telemetry events by type ([1fdfce2](https://github.com/kernel/kernel-python-sdk/commit/1fdfce2a3b05c5af330c93cd8e37a217f4d0f99b))
+* Proxy custom WebMCP tools in the control plane ([179dcd9](https://github.com/kernel/kernel-python-sdk/commit/179dcd9f2c9c27a46bc5f37d241da0f0626ccf82))
+* Publish iframe and worker browser target types ([848805a](https://github.com/kernel/kernel-python-sdk/commit/848805abcfa585e4299742cd8f7a3ff0306febfe))
+* Route browser destinations through selected proxies ([5a0a461](https://github.com/kernel/kernel-python-sdk/commit/5a0a461f25cbb59b43b2695fea8294357f3655fb))
+
 ## [0.111.0](https://github.com/kernel/kernel-python-sdk/compare/v0.110.0...v0.111.0) (2026-09-22)
 
 

{kernel-0.111.0 → kernel-0.113.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: kernel
-Version: 0.111.0
+Version: 0.113.0
 Summary: The official Python library for the kernel API
 Project-URL: Homepage, https://github.com/kernel/kernel-python-sdk
 Project-URL: Repository, https://github.com/kernel/kernel-python-sdk

{kernel-0.111.0 → kernel-0.113.0}/api.md

@@ -346,12 +346,14 @@ Types:
 
 ```python
 from kernel.types.browsers import (
+    CustomToolSource,
     InvocationFailure,
     InvocationResult,
     InvokeRequest,
     Tool,
     ToolAnnotations,
     ToolFrame,
+    ToolMetadata,
     ToolSource,
     ToolsResponse,
 )
@@ -359,8 +361,22 @@ from kernel.types.browsers import (
 
 Methods:
 
-- <code title="post /browsers/{id_or_name}/webmcp/invoke">client.browsers.webmcp.<a href="./src/kernel/resources/browsers/webmcp.py">invoke_tool</a>(id_or_name, \*\*<a href="src/kernel/types/browsers/webmcp_invoke_tool_params.py">params</a>) -> <a href="./src/kernel/types/browsers/invocation_result.py">InvocationResult</a></code>
-- <code title="get /browsers/{id_or_name}/webmcp/tools">client.browsers.webmcp.<a href="./src/kernel/resources/browsers/webmcp.py">list_tools</a>(id_or_name) -> <a href="./src/kernel/types/browsers/tools_response.py">ToolsResponse</a></code>
+- <code title="post /browsers/{id_or_name}/webmcp/invoke">client.browsers.webmcp.<a href="./src/kernel/resources/browsers/webmcp/webmcp.py">invoke_tool</a>(id_or_name, \*\*<a href="src/kernel/types/browsers/webmcp_invoke_tool_params.py">params</a>) -> <a href="./src/kernel/types/browsers/invocation_result.py">InvocationResult</a></code>
+- <code title="get /browsers/{id_or_name}/webmcp/tools">client.browsers.webmcp.<a href="./src/kernel/resources/browsers/webmcp/webmcp.py">list_tools</a>(id_or_name, \*\*<a href="src/kernel/types/browsers/webmcp_list_tools_params.py">params</a>) -> <a href="./src/kernel/types/browsers/tools_response.py">ToolsResponse</a></code>
+
+### CustomTools
+
+Types:
+
+```python
+from kernel.types.browsers.webmcp import AddRequest, CustomToolsResponse, Definition, Match
+```
+
+Methods:
+
+- <code title="get /browsers/{id_or_name}/webmcp/custom-tools">client.browsers.webmcp.custom_tools.<a href="./src/kernel/resources/browsers/webmcp/custom_tools.py">list</a>(id_or_name) -> <a href="./src/kernel/types/browsers/webmcp/custom_tools_response.py">CustomToolsResponse</a></code>
+- <code title="post /browsers/{id_or_name}/webmcp/custom-tools">client.browsers.webmcp.custom_tools.<a href="./src/kernel/resources/browsers/webmcp/custom_tools.py">add</a>(id_or_name, \*\*<a href="src/kernel/types/browsers/webmcp/custom_tool_add_params.py">params</a>) -> <a href="./src/kernel/types/browsers/webmcp/custom_tools_response.py">CustomToolsResponse</a></code>
+- <code title="delete /browsers/{id_or_name}/webmcp/custom-tools/{id}">client.browsers.webmcp.custom_tools.<a href="./src/kernel/resources/browsers/webmcp/custom_tools.py">remove</a>(id, \*, id_or_name) -> None</code>
 
 # Profiles
 

{kernel-0.111.0 → kernel-0.113.0}/pyproject.toml

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

{kernel-0.111.0 → kernel-0.113.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.111.0"  # x-release-please-version
+__version__ = "0.113.0"  # x-release-please-version

{kernel-0.111.0 → kernel-0.113.0}/src/kernel/resources/browser_pools.py

@@ -8,6 +8,7 @@ from typing_extensions import Literal
 import httpx
 
 from ..types import (
+    BrowserMemoryRequest,
     browser_pool_list_params,
     browser_pool_create_params,
     browser_pool_delete_params,
@@ -29,8 +30,10 @@ from ..pagination import SyncOffsetPagination, AsyncOffsetPagination
 from .._base_client import AsyncPaginator, make_request_options
 from ..types.tags_param import TagsParam
 from ..types.browser_pool import BrowserPool
+from ..types.browser_memory_request import BrowserMemoryRequest
 from ..types.browser_network_config_param import BrowserNetworkConfigParam
 from ..types.browser_pool_acquire_response import BrowserPoolAcquireResponse
+from ..types.shared_params.browser_profile import BrowserProfile
 from ..types.shared_params.browser_viewport import BrowserViewport
 from ..types.shared_params.browser_extension import BrowserExtension
 
@@ -68,6 +71,7 @@ class BrowserPoolsResource(SyncAPIResource):
         fill_rate_per_minute: int | Omit = omit,
         headless: bool | Omit = omit,
         kiosk_mode: bool | Omit = omit,
+        memory: BrowserMemoryRequest | Omit = omit,
         name: str | Omit = omit,
         network: BrowserNetworkConfigParam | Omit = omit,
         profile: browser_pool_create_params.Profile | Omit = omit,
@@ -115,6 +119,8 @@ class BrowserPoolsResource(SyncAPIResource):
           kiosk_mode: If true, launches the browser in kiosk mode to hide address bar and tabs in live
               view. Defaults to false.
 
+          memory: Memory requested for headful browsers in this pool.
+
           name: Optional name for the browser pool. Must be unique within the project.
 
           network: Network configuration applied to browsers in this pool.
@@ -186,6 +192,7 @@ class BrowserPoolsResource(SyncAPIResource):
                     "fill_rate_per_minute": fill_rate_per_minute,
                     "headless": headless,
                     "kiosk_mode": kiosk_mode,
+                    "memory": memory,
                     "name": name,
                     "network": network,
                     "profile": profile,
@@ -249,6 +256,7 @@ class BrowserPoolsResource(SyncAPIResource):
         fill_rate_per_minute: int | Omit = omit,
         headless: bool | Omit = omit,
         kiosk_mode: bool | Omit = omit,
+        memory: Literal["8GiB", "16GiB"] | Omit = omit,
         name: str | Omit = omit,
         network: BrowserNetworkConfigParam | Omit = omit,
         profile: browser_pool_update_params.Profile | Omit = omit,
@@ -301,6 +309,10 @@ class BrowserPoolsResource(SyncAPIResource):
 
           kiosk_mode: If provided, replaces whether browsers launch in kiosk mode.
 
+          memory: Memory requested for newly-warmed headful browsers in this pool. Existing
+              browsers retain their original allocation. Use discard_all_idle to replace idle
+              browsers.
+
           name: If provided, replaces the pool name. Empty string is a no-op; the pool name
               cannot be cleared or reset to empty once assigned.
 
@@ -379,6 +391,7 @@ class BrowserPoolsResource(SyncAPIResource):
                     "fill_rate_per_minute": fill_rate_per_minute,
                     "headless": headless,
                     "kiosk_mode": kiosk_mode,
+                    "memory": memory,
                     "name": name,
                     "network": network,
                     "profile": profile,
@@ -509,6 +522,7 @@ class BrowserPoolsResource(SyncAPIResource):
         *,
         acquire_timeout_seconds: int | Omit = omit,
         name: str | Omit = omit,
+        profile: BrowserProfile | Omit = omit,
         start_url: str | Omit = omit,
         tags: TagsParam | Omit = omit,
         telemetry: Optional[browser_pool_acquire_params.Telemetry] | Omit = omit,
@@ -536,6 +550,10 @@ class BrowserPoolsResource(SyncAPIResource):
               project. Applies to this lease only and is cleared when the browser is released
               back to the pool.
 
+          profile: Profile selection for the browser session. Provide either id or name. If
+              specified, the matching profile will be loaded into the browser session.
+              Profiles must be created beforehand.
+
           start_url: Optional URL to navigate the acquired browser to. Overrides the pool's start_url
               for this acquire only. Best-effort: failures to navigate do not fail the
               acquire.
@@ -569,6 +587,7 @@ class BrowserPoolsResource(SyncAPIResource):
                 {
                     "acquire_timeout_seconds": acquire_timeout_seconds,
                     "name": name,
+                    "profile": profile,
                     "start_url": start_url,
                     "tags": tags,
                     "telemetry": telemetry,
@@ -638,7 +657,8 @@ class BrowserPoolsResource(SyncAPIResource):
               Defaults to true. A reused browser keeps the configuration it was created with,
               so it does not pick up pool configuration changes made while it was in use.
               Release with `reuse: false`, or flush the pool afterward, to rebuild it with the
-              current configuration.
+              current configuration. Browsers loaded with an acquire-time profile are always
+              destroyed and replaced, even when reuse is true.
 
           extra_headers: Send extra headers
 
@@ -698,6 +718,7 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
         fill_rate_per_minute: int | Omit = omit,
         headless: bool | Omit = omit,
         kiosk_mode: bool | Omit = omit,
+        memory: BrowserMemoryRequest | Omit = omit,
         name: str | Omit = omit,
         network: BrowserNetworkConfigParam | Omit = omit,
         profile: browser_pool_create_params.Profile | Omit = omit,
@@ -745,6 +766,8 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
           kiosk_mode: If true, launches the browser in kiosk mode to hide address bar and tabs in live
               view. Defaults to false.
 
+          memory: Memory requested for headful browsers in this pool.
+
           name: Optional name for the browser pool. Must be unique within the project.
 
           network: Network configuration applied to browsers in this pool.
@@ -816,6 +839,7 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
                     "fill_rate_per_minute": fill_rate_per_minute,
                     "headless": headless,
                     "kiosk_mode": kiosk_mode,
+                    "memory": memory,
                     "name": name,
                     "network": network,
                     "profile": profile,
@@ -879,6 +903,7 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
         fill_rate_per_minute: int | Omit = omit,
         headless: bool | Omit = omit,
         kiosk_mode: bool | Omit = omit,
+        memory: Literal["8GiB", "16GiB"] | Omit = omit,
         name: str | Omit = omit,
         network: BrowserNetworkConfigParam | Omit = omit,
         profile: browser_pool_update_params.Profile | Omit = omit,
@@ -931,6 +956,10 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
 
           kiosk_mode: If provided, replaces whether browsers launch in kiosk mode.
 
+          memory: Memory requested for newly-warmed headful browsers in this pool. Existing
+              browsers retain their original allocation. Use discard_all_idle to replace idle
+              browsers.
+
           name: If provided, replaces the pool name. Empty string is a no-op; the pool name
               cannot be cleared or reset to empty once assigned.
 
@@ -1009,6 +1038,7 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
                     "fill_rate_per_minute": fill_rate_per_minute,
                     "headless": headless,
                     "kiosk_mode": kiosk_mode,
+                    "memory": memory,
                     "name": name,
                     "network": network,
                     "profile": profile,
@@ -1139,6 +1169,7 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
         *,
         acquire_timeout_seconds: int | Omit = omit,
         name: str | Omit = omit,
+        profile: BrowserProfile | Omit = omit,
         start_url: str | Omit = omit,
         tags: TagsParam | Omit = omit,
         telemetry: Optional[browser_pool_acquire_params.Telemetry] | Omit = omit,
@@ -1166,6 +1197,10 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
               project. Applies to this lease only and is cleared when the browser is released
               back to the pool.
 
+          profile: Profile selection for the browser session. Provide either id or name. If
+              specified, the matching profile will be loaded into the browser session.
+              Profiles must be created beforehand.
+
           start_url: Optional URL to navigate the acquired browser to. Overrides the pool's start_url
               for this acquire only. Best-effort: failures to navigate do not fail the
               acquire.
@@ -1199,6 +1234,7 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
                 {
                     "acquire_timeout_seconds": acquire_timeout_seconds,
                     "name": name,
+                    "profile": profile,
                     "start_url": start_url,
                     "tags": tags,
                     "telemetry": telemetry,
@@ -1268,7 +1304,8 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
               Defaults to true. A reused browser keeps the configuration it was created with,
               so it does not pick up pool configuration changes made while it was in use.
               Release with `reuse: false`, or flush the pool afterward, to rebuild it with the
-              current configuration.
+              current configuration. Browsers loaded with an acquire-time profile are always
+              destroyed and replaced, even when reuse is true.
 
           extra_headers: Send extra headers
 

{kernel-0.111.0 → kernel-0.113.0}/src/kernel/resources/browsers/browsers.py

@@ -24,14 +24,6 @@ from .fs.fs import (
     FsResourceWithStreamingResponse,
     AsyncFsResourceWithStreamingResponse,
 )
-from .webmcp import (
-    WebmcpResource,
-    AsyncWebmcpResource,
-    WebmcpResourceWithRawResponse,
-    AsyncWebmcpResourceWithRawResponse,
-    WebmcpResourceWithStreamingResponse,
-    AsyncWebmcpResourceWithStreamingResponse,
-)
 from ...types import (
     BrowserMemoryRequest,
     browser_curl_params,
@@ -94,6 +86,14 @@ from ..._response import (
     async_to_streamed_response_wrapper,
 )
 from ...pagination import SyncOffsetPagination, AsyncOffsetPagination
+from .webmcp.webmcp import (
+    WebmcpResource,
+    AsyncWebmcpResource,
+    WebmcpResourceWithRawResponse,
+    AsyncWebmcpResourceWithRawResponse,
+    WebmcpResourceWithStreamingResponse,
+    AsyncWebmcpResourceWithStreamingResponse,
+)
 from ..._base_client import AsyncPaginator, make_request_options
 from ...types.tags_param import TagsParam
 from ...types.browser_repl_result import BrowserReplResult

{kernel-0.111.0 → kernel-0.113.0}/src/kernel/resources/browsers/telemetry.py

@@ -7,7 +7,7 @@ from typing_extensions import Literal
 
 import httpx
 
-from ..._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
+from ..._types import Body, Omit, Query, Headers, NotGiven, SequenceNotStr, omit, not_given
 from ..._utils import path_template, maybe_transform, strip_not_given, async_maybe_transform
 from ..._compat import cached_property
 from ..._resource import SyncAPIResource, AsyncAPIResource
@@ -75,6 +75,7 @@ class TelemetryResource(SyncAPIResource):
         offset: int | Omit = omit,
         order: str | Omit = omit,
         since: str | Omit = omit,
+        type: SequenceNotStr[str] | Omit = omit,
         until: str | Omit = omit,
         # 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.
@@ -87,8 +88,9 @@ class TelemetryResource(SyncAPIResource):
 
         To page through
         results, pass the X-Next-Offset value from the previous response as offset and
-        repeat while X-Has-More is true. Returns an empty list when telemetry data is
-        unavailable.
+        repeat while X-Has-More is true. The category and type filters apply within each
+        page, so a filtered page may be empty while X-Has-More is true. Returns an empty
+        list when telemetry data is unavailable.
 
         Args:
           category: Restrict results to these event categories. Repeat the parameter for multiple
@@ -104,13 +106,15 @@ class TelemetryResource(SyncAPIResource):
           order: Read direction. asc (default) reads oldest first, starting from since or the
               offset cursor. desc reads newest first: each request returns one page of up to
               limit records ending at the offset cursor (or until, or the newest archived
-              event); combining desc with since is rejected with a 400. In either direction
-              the category filter applies within the page, so a filtered page may be empty
-              while X-Has-More is true.
+              event); combining desc with since is rejected with a 400.
 
           since: Start of the window: an RFC-3339 timestamp, or a duration like 5m meaning that
               long ago. Defaults to 5m. Ignored when offset is set.
 
+          type: Restrict results to these event types, such as page_crashed or
+              captcha_challenge_result. Repeat the parameter for multiple values. Combines
+              with category: when both are set an event must match both.
+
           until: End of the window (exclusive): an RFC-3339 timestamp, or a duration like 5m
               meaning that long ago.
 
@@ -139,6 +143,7 @@ class TelemetryResource(SyncAPIResource):
                         "offset": offset,
                         "order": order,
                         "since": since,
+                        "type": type,
                         "until": until,
                     },
                     telemetry_events_params.TelemetryEventsParams,
@@ -252,6 +257,7 @@ class AsyncTelemetryResource(AsyncAPIResource):
         offset: int | Omit = omit,
         order: str | Omit = omit,
         since: str | Omit = omit,
+        type: SequenceNotStr[str] | Omit = omit,
         until: str | Omit = omit,
         # 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.
@@ -264,8 +270,9 @@ class AsyncTelemetryResource(AsyncAPIResource):
 
         To page through
         results, pass the X-Next-Offset value from the previous response as offset and
-        repeat while X-Has-More is true. Returns an empty list when telemetry data is
-        unavailable.
+        repeat while X-Has-More is true. The category and type filters apply within each
+        page, so a filtered page may be empty while X-Has-More is true. Returns an empty
+        list when telemetry data is unavailable.
 
         Args:
           category: Restrict results to these event categories. Repeat the parameter for multiple
@@ -281,13 +288,15 @@ class AsyncTelemetryResource(AsyncAPIResource):
           order: Read direction. asc (default) reads oldest first, starting from since or the
               offset cursor. desc reads newest first: each request returns one page of up to
               limit records ending at the offset cursor (or until, or the newest archived
-              event); combining desc with since is rejected with a 400. In either direction
-              the category filter applies within the page, so a filtered page may be empty
-              while X-Has-More is true.
+              event); combining desc with since is rejected with a 400.
 
           since: Start of the window: an RFC-3339 timestamp, or a duration like 5m meaning that
               long ago. Defaults to 5m. Ignored when offset is set.
 
+          type: Restrict results to these event types, such as page_crashed or
+              captcha_challenge_result. Repeat the parameter for multiple values. Combines
+              with category: when both are set an event must match both.
+
           until: End of the window (exclusive): an RFC-3339 timestamp, or a duration like 5m
               meaning that long ago.
 
@@ -316,6 +325,7 @@ class AsyncTelemetryResource(AsyncAPIResource):
                         "offset": offset,
                         "order": order,
                         "since": since,
+                        "type": type,
                         "until": until,
                     },
                     telemetry_events_params.TelemetryEventsParams,

kernel-0.113.0/src/kernel/resources/browsers/webmcp/__init__.py

@@ -0,0 +1,33 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .webmcp import (
+    WebmcpResource,
+    AsyncWebmcpResource,
+    WebmcpResourceWithRawResponse,
+    AsyncWebmcpResourceWithRawResponse,
+    WebmcpResourceWithStreamingResponse,
+    AsyncWebmcpResourceWithStreamingResponse,
+)
+from .custom_tools import (
+    CustomToolsResource,
+    AsyncCustomToolsResource,
+    CustomToolsResourceWithRawResponse,
+    AsyncCustomToolsResourceWithRawResponse,
+    CustomToolsResourceWithStreamingResponse,
+    AsyncCustomToolsResourceWithStreamingResponse,
+)
+
+__all__ = [
+    "CustomToolsResource",
+    "AsyncCustomToolsResource",
+    "CustomToolsResourceWithRawResponse",
+    "AsyncCustomToolsResourceWithRawResponse",
+    "CustomToolsResourceWithStreamingResponse",
+    "AsyncCustomToolsResourceWithStreamingResponse",
+    "WebmcpResource",
+    "AsyncWebmcpResource",
+    "WebmcpResourceWithRawResponse",
+    "AsyncWebmcpResourceWithRawResponse",
+    "WebmcpResourceWithStreamingResponse",
+    "AsyncWebmcpResourceWithStreamingResponse",
+]