feat: Implement Search API v1 providers

Stainless-Generated-From: 88a2e9eb1b30837e304011693f8598389cfb45bb

Author: kernel-internal[bot]

.stats.yml

@@ -1 +1 @@
-configured_endpoints: 165
+configured_endpoints: 169

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>

src/kernel/_client.py

@@ -57,6 +57,7 @@
     from .resources import (
         apps,
         auth,
+        search,
         vaults,
         proxies,
         api_keys,
@@ -85,6 +86,7 @@
     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 @@ def credential_providers(self) -> CredentialProvidersResource:
 
         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 @@ def credential_providers(self) -> AsyncCredentialProvidersResource:
 
         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 @@ def credential_providers(self) -> credential_providers.CredentialProvidersResour
 
         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 @@ def credential_providers(self) -> credential_providers.AsyncCredentialProvidersR
 
         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 @@ def credential_providers(self) -> credential_providers.CredentialProvidersResour
 
         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 @@ def credential_providers(self) -> credential_providers.AsyncCredentialProvidersR
 
         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
 

src/kernel/resources/__init__.py

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

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",
+]