Merge pull request #159 from kernel/release-please--branches--main--changes--next

release: 0.94.0

Author: Sayan-

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.93.0"
+  ".": "0.94.0"
 }

.stats.yml

@@ -1 +1 @@
-configured_endpoints: 140
+configured_endpoints: 145

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.94.0](https://github.com/kernel/kernel-python-sdk/compare/v0.93.0...v0.94.0) (2026-08-24)
+
+
+### Features
+
+* Mirror the control/platform telemetry split into the public API ([27c5a0a](https://github.com/kernel/kernel-python-sdk/commit/27c5a0a75ade568f1feb7e058070771ae1f6db60))
+* site configs: report proxy-restricted analyses ([7afcfc4](https://github.com/kernel/kernel-python-sdk/commit/7afcfc499d7008407c872d75bcc4d8a1604f7954))
+
 ## [0.93.0](https://github.com/kernel/kernel-python-sdk/compare/v0.92.0...v0.93.0) (2026-08-19)
 
 

api.md

@@ -74,6 +74,37 @@ Methods:
 - <code title="get /invocations/{id}/events">client.invocations.<a href="./src/kernel/resources/invocations.py">follow</a>(id, \*\*<a href="src/kernel/types/invocation_follow_params.py">params</a>) -> <a href="./src/kernel/types/invocation_follow_response.py">InvocationFollowResponse</a></code>
 - <code title="get /invocations/{id}/browsers">client.invocations.<a href="./src/kernel/resources/invocations.py">list_browsers</a>(id) -> <a href="./src/kernel/types/invocation_list_browsers_response.py">InvocationListBrowsersResponse</a></code>
 
+# SiteConfigs
+
+Types:
+
+```python
+from kernel.types import (
+    Analysis,
+    AnalysisSummary,
+    Browser,
+    Evidence,
+    LookupRequest,
+    LookupResponse,
+    NoRecommendation,
+    Proxy,
+    Recommendation,
+    RecommendationResult,
+    RecommendationSummary,
+    ResolveRequest,
+    SiteConfigResponse,
+    Target,
+)
+```
+
+Methods:
+
+- <code title="get /site-configs/{id}">client.site_configs.<a href="./src/kernel/resources/site_configs.py">retrieve</a>(id) -> <a href="./src/kernel/types/site_config_response.py">SiteConfigResponse</a></code>
+- <code title="get /site-configs">client.site_configs.<a href="./src/kernel/resources/site_configs.py">list</a>(\*\*<a href="src/kernel/types/site_config_list_params.py">params</a>) -> <a href="./src/kernel/types/analysis_summary.py">SyncOffsetPagination[AnalysisSummary]</a></code>
+- <code title="get /site-configs/recommendations">client.site_configs.<a href="./src/kernel/resources/site_configs.py">list_recommendations</a>(\*\*<a href="src/kernel/types/site_config_list_recommendations_params.py">params</a>) -> <a href="./src/kernel/types/recommendation_summary.py">SyncOffsetPagination[RecommendationSummary]</a></code>
+- <code title="post /site-configs/lookup">client.site_configs.<a href="./src/kernel/resources/site_configs.py">lookup</a>(\*\*<a href="src/kernel/types/site_config_lookup_params.py">params</a>) -> <a href="./src/kernel/types/lookup_response.py">LookupResponse</a></code>
+- <code title="post /site-configs/resolve">client.site_configs.<a href="./src/kernel/resources/site_configs.py">resolve</a>(\*\*<a href="src/kernel/types/site_config_resolve_params.py">params</a>) -> <a href="./src/kernel/types/site_config_response.py">SiteConfigResponse</a></code>
+
 # Browsers
 
 Types:
@@ -117,6 +148,8 @@ from kernel.types.browsers import (
     BrowserAPICallEvent,
     BrowserCallStack,
     BrowserCaptchaSolveResultEvent,
+    BrowserCdpCommandEvent,
+    BrowserCdpCommandMethod,
     BrowserCdpConnectEvent,
     BrowserCdpDisconnectEvent,
     BrowserConsoleErrorEvent,
@@ -138,6 +171,7 @@ from kernel.types.browsers import (
     BrowserNetworkLoadingFailedEvent,
     BrowserNetworkRequestEvent,
     BrowserNetworkResponseEvent,
+    BrowserPageCrashedEvent,
     BrowserPageDomContentLoadedEvent,
     BrowserPageLayoutSettledEvent,
     BrowserPageLayoutShiftEvent,
@@ -146,12 +180,15 @@ from kernel.types.browsers import (
     BrowserPageNavigationEvent,
     BrowserPageNavigationSettledEvent,
     BrowserPageTabOpenedEvent,
+    BrowserPlatformAPICallEvent,
     BrowserProxyErrorEvent,
     BrowserServiceCrashedEvent,
     BrowserSystemOomKillEvent,
     BrowserTelemetryCategoriesConfig,
     BrowserTelemetryCategoryConfig,
+    BrowserTelemetryCdpControlConfig,
     BrowserTelemetryConfig,
+    BrowserTelemetryControlConfig,
     BrowserTelemetryEvent,
     BrowserTelemetryExportConfig,
     BrowserTelemetryOtlpExportConfig,

pyproject.toml

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

src/kernel/_client.py

@@ -62,6 +62,7 @@
         deployments,
         invocations,
         organization,
+        site_configs,
         browser_pools,
         credential_providers,
     )
@@ -74,6 +75,7 @@
     from .resources.credentials import CredentialsResource, AsyncCredentialsResource
     from .resources.deployments import DeploymentsResource, AsyncDeploymentsResource
     from .resources.invocations import InvocationsResource, AsyncInvocationsResource
+    from .resources.site_configs import SiteConfigsResource, AsyncSiteConfigsResource
     from .resources.browser_pools import BrowserPoolsResource, AsyncBrowserPoolsResource
     from .resources.browsers.browsers import BrowsersResource, AsyncBrowsersResource
     from .resources.projects.projects import ProjectsResource, AsyncProjectsResource
@@ -223,6 +225,13 @@ def invocations(self) -> InvocationsResource:
 
         return InvocationsResource(self)
 
+    @cached_property
+    def site_configs(self) -> SiteConfigsResource:
+        """Resolve browser and proxy recommendations for bot-protected sites."""
+        from .resources.site_configs import SiteConfigsResource
+
+        return SiteConfigsResource(self)
+
     @cached_property
     def browsers(self) -> BrowsersResource:
         """Create and manage browser sessions."""
@@ -599,6 +608,13 @@ def invocations(self) -> AsyncInvocationsResource:
 
         return AsyncInvocationsResource(self)
 
+    @cached_property
+    def site_configs(self) -> AsyncSiteConfigsResource:
+        """Resolve browser and proxy recommendations for bot-protected sites."""
+        from .resources.site_configs import AsyncSiteConfigsResource
+
+        return AsyncSiteConfigsResource(self)
+
     @cached_property
     def browsers(self) -> AsyncBrowsersResource:
         """Create and manage browser sessions."""
@@ -879,6 +895,13 @@ def invocations(self) -> invocations.InvocationsResourceWithRawResponse:
 
         return InvocationsResourceWithRawResponse(self._client.invocations)
 
+    @cached_property
+    def site_configs(self) -> site_configs.SiteConfigsResourceWithRawResponse:
+        """Resolve browser and proxy recommendations for bot-protected sites."""
+        from .resources.site_configs import SiteConfigsResourceWithRawResponse
+
+        return SiteConfigsResourceWithRawResponse(self._client.site_configs)
+
     @cached_property
     def browsers(self) -> browsers.BrowsersResourceWithRawResponse:
         """Create and manage browser sessions."""
@@ -999,6 +1022,13 @@ def invocations(self) -> invocations.AsyncInvocationsResourceWithRawResponse:
 
         return AsyncInvocationsResourceWithRawResponse(self._client.invocations)
 
+    @cached_property
+    def site_configs(self) -> site_configs.AsyncSiteConfigsResourceWithRawResponse:
+        """Resolve browser and proxy recommendations for bot-protected sites."""
+        from .resources.site_configs import AsyncSiteConfigsResourceWithRawResponse
+
+        return AsyncSiteConfigsResourceWithRawResponse(self._client.site_configs)
+
     @cached_property
     def browsers(self) -> browsers.AsyncBrowsersResourceWithRawResponse:
         """Create and manage browser sessions."""
@@ -1119,6 +1149,13 @@ def invocations(self) -> invocations.InvocationsResourceWithStreamingResponse:
 
         return InvocationsResourceWithStreamingResponse(self._client.invocations)
 
+    @cached_property
+    def site_configs(self) -> site_configs.SiteConfigsResourceWithStreamingResponse:
+        """Resolve browser and proxy recommendations for bot-protected sites."""
+        from .resources.site_configs import SiteConfigsResourceWithStreamingResponse
+
+        return SiteConfigsResourceWithStreamingResponse(self._client.site_configs)
+
     @cached_property
     def browsers(self) -> browsers.BrowsersResourceWithStreamingResponse:
         """Create and manage browser sessions."""
@@ -1239,6 +1276,13 @@ def invocations(self) -> invocations.AsyncInvocationsResourceWithStreamingRespon
 
         return AsyncInvocationsResourceWithStreamingResponse(self._client.invocations)
 
+    @cached_property
+    def site_configs(self) -> site_configs.AsyncSiteConfigsResourceWithStreamingResponse:
+        """Resolve browser and proxy recommendations for bot-protected sites."""
+        from .resources.site_configs import AsyncSiteConfigsResourceWithStreamingResponse
+
+        return AsyncSiteConfigsResourceWithStreamingResponse(self._client.site_configs)
+
     @cached_property
     def browsers(self) -> browsers.AsyncBrowsersResourceWithStreamingResponse:
         """Create and manage browser sessions."""

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

src/kernel/resources/__init__.py

@@ -112,6 +112,14 @@
     OrganizationResourceWithStreamingResponse,
     AsyncOrganizationResourceWithStreamingResponse,
 )
+from .site_configs import (
+    SiteConfigsResource,
+    AsyncSiteConfigsResource,
+    SiteConfigsResourceWithRawResponse,
+    AsyncSiteConfigsResourceWithRawResponse,
+    SiteConfigsResourceWithStreamingResponse,
+    AsyncSiteConfigsResourceWithStreamingResponse,
+)
 from .browser_pools import (
     BrowserPoolsResource,
     AsyncBrowserPoolsResource,
@@ -148,6 +156,12 @@
     "AsyncInvocationsResourceWithRawResponse",
     "InvocationsResourceWithStreamingResponse",
     "AsyncInvocationsResourceWithStreamingResponse",
+    "SiteConfigsResource",
+    "AsyncSiteConfigsResource",
+    "SiteConfigsResourceWithRawResponse",
+    "AsyncSiteConfigsResourceWithRawResponse",
+    "SiteConfigsResourceWithStreamingResponse",
+    "AsyncSiteConfigsResourceWithStreamingResponse",
     "BrowsersResource",
     "AsyncBrowsersResource",
     "BrowsersResourceWithRawResponse",

src/kernel/resources/browsers/browsers.py

@@ -208,7 +208,7 @@ def create(
           extensions: List of browser extensions to load into the session. Provide each by id or name.
 
           gpu: If true, enables GPU acceleration for the browser session. Requires Start-Up or
-              Enterprise plan and headless=false.
+              Enterprise plan, headless=false, and region=us-east.
 
           headless: If true, launches the browser using a headless image (no VNC/GUI). Defaults to
               false.
@@ -828,7 +828,7 @@ async def create(
           extensions: List of browser extensions to load into the session. Provide each by id or name.
 
           gpu: If true, enables GPU acceleration for the browser session. Requires Start-Up or
-              Enterprise plan and headless=false.
+              Enterprise plan, headless=false, and region=us-east.
 
           headless: If true, launches the browser using a headless image (no VNC/GUI). Defaults to
               false.

src/kernel/resources/browsers/telemetry.py

@@ -62,6 +62,7 @@ def events(
                 "page",
                 "interaction",
                 "control",
+                "platform",
                 "connection",
                 "system",
                 "screenshot",
@@ -238,6 +239,7 @@ def events(
                 "page",
                 "interaction",
                 "control",
+                "platform",
                 "connection",
                 "system",
                 "screenshot",