kernel 0.110.0__tar.gz → 0.111.0__tar.gz

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

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

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

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.111.0](https://github.com/kernel/kernel-python-sdk/compare/v0.110.0...v0.111.0) (2026-09-22)
+
+
+### Features
+
+* Allow managed auth logins to disable learned skills ([e230ce3](https://github.com/kernel/kernel-python-sdk/commit/e230ce3a684ce7723256170443ba0b84b08310a4))
+* Distinguish optimistic managed auth reauth ([41059ae](https://github.com/kernel/kernel-python-sdk/commit/41059ae6d345b924d7e508e43a8b1d0842c58556))
+* Implement Search API v1 providers ([76b3d88](https://github.com/kernel/kernel-python-sdk/commit/76b3d8871e29d47cfda20f68ab23152daf1790c6))
+* Persist stable managed auth completion timestamps ([17a7960](https://github.com/kernel/kernel-python-sdk/commit/17a7960d9304fdceb54d59b09277651b6166fdb1))
+* Publish restricted_route_unavailable and unknown proxy_error codes ([64805ae](https://github.com/kernel/kernel-python-sdk/commit/64805ae68f0978264fb77801e8e94a470a039e94))
+* Support native prepared Adyen Sessions checkout ([5f2df0a](https://github.com/kernel/kernel-python-sdk/commit/5f2df0a4170aa146eabb23f576195d1a06621925))
+
 ## [0.110.0](https://github.com/kernel/kernel-python-sdk/compare/v0.109.0...v0.110.0) (2026-09-18)
 
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: kernel
-Version: 0.110.0
+Version: 0.111.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.110.0 → kernel-0.111.0}/api.md

@@ -735,3 +735,40 @@ Methods:
 - <code title="delete /org/credential_providers/{id}">client.credential_providers.<a href="./src/kernel/resources/credential_providers.py">delete</a>(id) -> None</code>
 - <code title="get /org/credential_providers/{id}/items">client.credential_providers.<a href="./src/kernel/resources/credential_providers.py">list_items</a>(id) -> <a href="./src/kernel/types/credential_provider_list_items_response.py">CredentialProviderListItemsResponse</a></code>
 - <code title="post /org/credential_providers/{id}/test">client.credential_providers.<a href="./src/kernel/resources/credential_providers.py">test</a>(id) -> <a href="./src/kernel/types/credential_provider_test_result.py">CredentialProviderTestResult</a></code>
+
+# Search
+
+Types:
+
+```python
+from kernel.types import Attempt, ProviderTarget, Request, Result, Search, Strategy, Usage, Warning
+```
+
+Methods:
+
+- <code title="post /search">client.search.<a href="./src/kernel/resources/search/search.py">create</a>(\*\*<a href="src/kernel/types/search_create_params.py">params</a>) -> <a href="./src/kernel/types/search/search.py">Search</a></code>
+- <code title="get /search/{id}">client.search.<a href="./src/kernel/resources/search/search.py">retrieve</a>(id) -> <a href="./src/kernel/types/search/search.py">Search</a></code>
+
+## Contents
+
+Types:
+
+```python
+from kernel.types.search import FetchRequest, Response
+```
+
+Methods:
+
+- <code title="post /search/{id}/contents">client.search.contents.<a href="./src/kernel/resources/search/contents.py">fetch</a>(id, \*\*<a href="src/kernel/types/search/content_fetch_params.py">params</a>) -> None</code>
+
+## Providers
+
+Types:
+
+```python
+from kernel.types.search import Provider, ProviderListResponse
+```
+
+Methods:
+
+- <code title="get /search/providers">client.search.providers.<a href="./src/kernel/resources/search/providers.py">list</a>(\*\*<a href="src/kernel/types/search/provider_list_params.py">params</a>) -> <a href="./src/kernel/types/search/provider_list_response.py">ProviderListResponse</a></code>

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

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

{kernel-0.110.0 → kernel-0.111.0}/src/kernel/_client.py

@@ -57,6 +57,7 @@ if TYPE_CHECKING:
     from .resources import (
         apps,
         auth,
+        search,
         vaults,
         proxies,
         api_keys,
@@ -85,6 +86,7 @@ if TYPE_CHECKING:
     from .resources.deployments import DeploymentsResource, AsyncDeploymentsResource
     from .resources.invocations import InvocationsResource, AsyncInvocationsResource
     from .resources.browser_pools import BrowserPoolsResource, AsyncBrowserPoolsResource
+    from .resources.search.search import SearchResource, AsyncSearchResource
     from .resources.vaults.vaults import VaultsResource, AsyncVaultsResource
     from .resources.browsers.browsers import BrowsersResource, AsyncBrowsersResource
     from .resources.projects.projects import ProjectsResource, AsyncProjectsResource
@@ -348,6 +350,13 @@ class Kernel(SyncAPIClient):
 
         return CredentialProvidersResource(self)
 
+    @cached_property
+    def search(self) -> SearchResource:
+        """Search the web and retrieve content for selected results."""
+        from .resources.search import SearchResource
+
+        return SearchResource(self)
+
     @cached_property
     def with_raw_response(self) -> KernelWithRawResponse:
         return KernelWithRawResponse(self)
@@ -752,6 +761,13 @@ class AsyncKernel(AsyncAPIClient):
 
         return AsyncCredentialProvidersResource(self)
 
+    @cached_property
+    def search(self) -> AsyncSearchResource:
+        """Search the web and retrieve content for selected results."""
+        from .resources.search import AsyncSearchResource
+
+        return AsyncSearchResource(self)
+
     @cached_property
     def with_raw_response(self) -> AsyncKernelWithRawResponse:
         return AsyncKernelWithRawResponse(self)
@@ -1058,6 +1074,13 @@ class KernelWithRawResponse:
 
         return CredentialProvidersResourceWithRawResponse(self._client.credential_providers)
 
+    @cached_property
+    def search(self) -> search.SearchResourceWithRawResponse:
+        """Search the web and retrieve content for selected results."""
+        from .resources.search import SearchResourceWithRawResponse
+
+        return SearchResourceWithRawResponse(self._client.search)
+
 
 class AsyncKernelWithRawResponse:
     _client: AsyncKernel
@@ -1196,6 +1219,13 @@ class AsyncKernelWithRawResponse:
 
         return AsyncCredentialProvidersResourceWithRawResponse(self._client.credential_providers)
 
+    @cached_property
+    def search(self) -> search.AsyncSearchResourceWithRawResponse:
+        """Search the web and retrieve content for selected results."""
+        from .resources.search import AsyncSearchResourceWithRawResponse
+
+        return AsyncSearchResourceWithRawResponse(self._client.search)
+
 
 class KernelWithStreamedResponse:
     _client: Kernel
@@ -1334,6 +1364,13 @@ class KernelWithStreamedResponse:
 
         return CredentialProvidersResourceWithStreamingResponse(self._client.credential_providers)
 
+    @cached_property
+    def search(self) -> search.SearchResourceWithStreamingResponse:
+        """Search the web and retrieve content for selected results."""
+        from .resources.search import SearchResourceWithStreamingResponse
+
+        return SearchResourceWithStreamingResponse(self._client.search)
+
 
 class AsyncKernelWithStreamedResponse:
     _client: AsyncKernel
@@ -1472,6 +1509,13 @@ class AsyncKernelWithStreamedResponse:
 
         return AsyncCredentialProvidersResourceWithStreamingResponse(self._client.credential_providers)
 
+    @cached_property
+    def search(self) -> search.AsyncSearchResourceWithStreamingResponse:
+        """Search the web and retrieve content for selected results."""
+        from .resources.search import AsyncSearchResourceWithStreamingResponse
+
+        return AsyncSearchResourceWithStreamingResponse(self._client.search)
+
 
 Client = Kernel
 

{kernel-0.110.0 → kernel-0.111.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.110.0"  # x-release-please-version
+__version__ = "0.111.0"  # x-release-please-version

{kernel-0.110.0 → kernel-0.111.0}/src/kernel/resources/__init__.py

@@ -16,6 +16,14 @@ from .auth import (
     AuthResourceWithStreamingResponse,
     AsyncAuthResourceWithStreamingResponse,
 )
+from .search import (
+    SearchResource,
+    AsyncSearchResource,
+    SearchResourceWithRawResponse,
+    AsyncSearchResourceWithRawResponse,
+    SearchResourceWithStreamingResponse,
+    AsyncSearchResourceWithStreamingResponse,
+)
 from .vaults import (
     VaultsResource,
     AsyncVaultsResource,
@@ -268,4 +276,10 @@ __all__ = [
     "AsyncCredentialProvidersResourceWithRawResponse",
     "CredentialProvidersResourceWithStreamingResponse",
     "AsyncCredentialProvidersResourceWithStreamingResponse",
+    "SearchResource",
+    "AsyncSearchResource",
+    "SearchResourceWithRawResponse",
+    "AsyncSearchResourceWithRawResponse",
+    "SearchResourceWithStreamingResponse",
+    "AsyncSearchResourceWithStreamingResponse",
 ]

{kernel-0.110.0 → kernel-0.111.0}/src/kernel/resources/auth/connections.py

@@ -477,6 +477,7 @@ class ConnectionsResource(SyncAPIResource):
         browser_telemetry: Optional[connection_login_params.BrowserTelemetry] | Omit = omit,
         proxy: connection_login_params.Proxy | Omit = omit,
         record_session: bool | Omit = omit,
+        skill_mode: Literal["enabled", "disabled"] | 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.
         extra_headers: Headers | None = None,
@@ -502,6 +503,10 @@ class ConnectionsResource(SyncAPIResource):
           record_session: Override the connection's default for recording this login's browser session.
               When omitted, the connection's record_session default is used.
 
+          skill_mode: Controls whether this login reads and writes learned domain skills. Automatic
+              reauths inherit the selected mode until a later accepted login sets enabled or
+              omits this field. Defaults to enabled when omitted.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -520,6 +525,7 @@ class ConnectionsResource(SyncAPIResource):
                     "browser_telemetry": browser_telemetry,
                     "proxy": proxy,
                     "record_session": record_session,
+                    "skill_mode": skill_mode,
                 },
                 connection_login_params.ConnectionLoginParams,
             ),
@@ -1100,6 +1106,7 @@ class AsyncConnectionsResource(AsyncAPIResource):
         browser_telemetry: Optional[connection_login_params.BrowserTelemetry] | Omit = omit,
         proxy: connection_login_params.Proxy | Omit = omit,
         record_session: bool | Omit = omit,
+        skill_mode: Literal["enabled", "disabled"] | 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.
         extra_headers: Headers | None = None,
@@ -1125,6 +1132,10 @@ class AsyncConnectionsResource(AsyncAPIResource):
           record_session: Override the connection's default for recording this login's browser session.
               When omitted, the connection's record_session default is used.
 
+          skill_mode: Controls whether this login reads and writes learned domain skills. Automatic
+              reauths inherit the selected mode until a later accepted login sets enabled or
+              omits this field. Defaults to enabled when omitted.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -1143,6 +1154,7 @@ class AsyncConnectionsResource(AsyncAPIResource):
                     "browser_telemetry": browser_telemetry,
                     "proxy": proxy,
                     "record_session": record_session,
+                    "skill_mode": skill_mode,
                 },
                 connection_login_params.ConnectionLoginParams,
             ),

kernel-0.111.0/src/kernel/resources/search/__init__.py

@@ -0,0 +1,47 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .search import (
+    SearchResource,
+    AsyncSearchResource,
+    SearchResourceWithRawResponse,
+    AsyncSearchResourceWithRawResponse,
+    SearchResourceWithStreamingResponse,
+    AsyncSearchResourceWithStreamingResponse,
+)
+from .contents import (
+    ContentsResource,
+    AsyncContentsResource,
+    ContentsResourceWithRawResponse,
+    AsyncContentsResourceWithRawResponse,
+    ContentsResourceWithStreamingResponse,
+    AsyncContentsResourceWithStreamingResponse,
+)
+from .providers import (
+    ProvidersResource,
+    AsyncProvidersResource,
+    ProvidersResourceWithRawResponse,
+    AsyncProvidersResourceWithRawResponse,
+    ProvidersResourceWithStreamingResponse,
+    AsyncProvidersResourceWithStreamingResponse,
+)
+
+__all__ = [
+    "ContentsResource",
+    "AsyncContentsResource",
+    "ContentsResourceWithRawResponse",
+    "AsyncContentsResourceWithRawResponse",
+    "ContentsResourceWithStreamingResponse",
+    "AsyncContentsResourceWithStreamingResponse",
+    "ProvidersResource",
+    "AsyncProvidersResource",
+    "ProvidersResourceWithRawResponse",
+    "AsyncProvidersResourceWithRawResponse",
+    "ProvidersResourceWithStreamingResponse",
+    "AsyncProvidersResourceWithStreamingResponse",
+    "SearchResource",
+    "AsyncSearchResource",
+    "SearchResourceWithRawResponse",
+    "AsyncSearchResourceWithRawResponse",
+    "SearchResourceWithStreamingResponse",
+    "AsyncSearchResourceWithStreamingResponse",
+]

kernel-0.111.0/src/kernel/resources/search/contents.py

@@ -0,0 +1,220 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+import httpx
+
+from ..._types import Body, Omit, Query, Headers, NoneType, NotGiven, SequenceNotStr, omit, not_given
+from ..._utils import path_template, maybe_transform, async_maybe_transform
+from ..._compat import cached_property
+from ..._resource import SyncAPIResource, AsyncAPIResource
+from ..._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from ..._base_client import make_request_options
+from ...types.search import content_fetch_params
+
+__all__ = ["ContentsResource", "AsyncContentsResource"]
+
+
+class ContentsResource(SyncAPIResource):
+    """Search the web and retrieve content for selected results."""
+
+    @cached_property
+    def with_raw_response(self) -> ContentsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/kernel/kernel-python-sdk#accessing-raw-response-data-eg-headers
+        """
+        return ContentsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> ContentsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/kernel/kernel-python-sdk#with_streaming_response
+        """
+        return ContentsResourceWithStreamingResponse(self)
+
+    def fetch(
+        self,
+        id: str,
+        *,
+        content: content_fetch_params.Content | Omit = omit,
+        limit: int | Omit = omit,
+        result_ids: SequenceNotStr[str] | Omit = omit,
+        timeout_ms: int | 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.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> None:
+        """
+        Deferred result-content retrieval is reserved but not available in this release.
+        Requests return 404 until the retrieval implementation is shipped. X-Request-Id
+        identifies this request separately from the search resource.
+
+        Args:
+          content: Defaults to source:auto when omitted.
+
+          limit: Maximum number of search results to fetch when result_ids is omitted, starting
+              from rank 1. Mutually exclusive with result_ids.
+
+          result_ids: Kernel-generated IDs from the referenced retained search, in desired response
+              order. They are not provider-standard IDs. Mutually exclusive with limit.
+
+          timeout_ms: Overall deadline across all selected results.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        return self._post(
+            path_template("/search/{id}/contents", id=id),
+            body=maybe_transform(
+                {
+                    "content": content,
+                    "limit": limit,
+                    "result_ids": result_ids,
+                    "timeout_ms": timeout_ms,
+                },
+                content_fetch_params.ContentFetchParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
+
+class AsyncContentsResource(AsyncAPIResource):
+    """Search the web and retrieve content for selected results."""
+
+    @cached_property
+    def with_raw_response(self) -> AsyncContentsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/kernel/kernel-python-sdk#accessing-raw-response-data-eg-headers
+        """
+        return AsyncContentsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncContentsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/kernel/kernel-python-sdk#with_streaming_response
+        """
+        return AsyncContentsResourceWithStreamingResponse(self)
+
+    async def fetch(
+        self,
+        id: str,
+        *,
+        content: content_fetch_params.Content | Omit = omit,
+        limit: int | Omit = omit,
+        result_ids: SequenceNotStr[str] | Omit = omit,
+        timeout_ms: int | 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.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> None:
+        """
+        Deferred result-content retrieval is reserved but not available in this release.
+        Requests return 404 until the retrieval implementation is shipped. X-Request-Id
+        identifies this request separately from the search resource.
+
+        Args:
+          content: Defaults to source:auto when omitted.
+
+          limit: Maximum number of search results to fetch when result_ids is omitted, starting
+              from rank 1. Mutually exclusive with result_ids.
+
+          result_ids: Kernel-generated IDs from the referenced retained search, in desired response
+              order. They are not provider-standard IDs. Mutually exclusive with limit.
+
+          timeout_ms: Overall deadline across all selected results.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        return await self._post(
+            path_template("/search/{id}/contents", id=id),
+            body=await async_maybe_transform(
+                {
+                    "content": content,
+                    "limit": limit,
+                    "result_ids": result_ids,
+                    "timeout_ms": timeout_ms,
+                },
+                content_fetch_params.ContentFetchParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
+
+class ContentsResourceWithRawResponse:
+    def __init__(self, contents: ContentsResource) -> None:
+        self._contents = contents
+
+        self.fetch = to_raw_response_wrapper(
+            contents.fetch,
+        )
+
+
+class AsyncContentsResourceWithRawResponse:
+    def __init__(self, contents: AsyncContentsResource) -> None:
+        self._contents = contents
+
+        self.fetch = async_to_raw_response_wrapper(
+            contents.fetch,
+        )
+
+
+class ContentsResourceWithStreamingResponse:
+    def __init__(self, contents: ContentsResource) -> None:
+        self._contents = contents
+
+        self.fetch = to_streamed_response_wrapper(
+            contents.fetch,
+        )
+
+
+class AsyncContentsResourceWithStreamingResponse:
+    def __init__(self, contents: AsyncContentsResource) -> None:
+        self._contents = contents
+
+        self.fetch = async_to_streamed_response_wrapper(
+            contents.fetch,
+        )