feat: Randomize automatic search provider routing

Stainless-Generated-From: 3a5146ad5bd2c016799d76d0361f72c61bfce90a

Author: kernel-internal[bot]

src/kernel/resources/search/providers.py

@@ -64,7 +64,8 @@ def list(
         contains no latency benchmarks. X-Request-Id identifies the request.
 
         Args:
-          slug: Optional concrete provider slug filter. Omit to list every provider.
+          slug: Optional concrete provider slug filter. Omit to list every provider. A slug that
+              is not listed returns an empty array.
 
           extra_headers: Send extra headers
 
@@ -128,7 +129,8 @@ async def list(
         contains no latency benchmarks. X-Request-Id identifies the request.
 
         Args:
-          slug: Optional concrete provider slug filter. Omit to list every provider.
+          slug: Optional concrete provider slug filter. Omit to list every provider. A slug that
+              is not listed returns an empty array.
 
           extra_headers: Send extra headers
 

src/kernel/types/search/provider_list_params.py

@@ -9,4 +9,7 @@
 
 class ProviderListParams(TypedDict, total=False):
     slug: Literal["brave", "exa", "perplexity", "context", "parallel", "valyu", "octen", "you", "tavily", "serpapi"]
-    """Optional concrete provider slug filter. Omit to list every provider."""
+    """Optional concrete provider slug filter.
+
+    Omit to list every provider. A slug that is not listed returns an empty array.
+    """