feat: Add stainless CI

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 46
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-cb38560915edce03abce2ae3ef5bc745489dbe9b6f80c2b4ff42edf8c2ff276d.yml
-openapi_spec_hash: a869194d6c864ba28d79ec0105439c3e
-config_hash: ed56f95781ec9b2e73c97e1a66606071
+configured_endpoints: 50
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-d3a597bbbb25c131e2c06eb9b47d70932d14a97a6f916677a195a128e196f4db.yml
+openapi_spec_hash: c967b384624017eed0abff1b53a74530
+config_hash: 0d150b61cae2dc57d3648ceae7784966

api.md

@@ -178,3 +178,18 @@ Methods:
 - <code title="get /profiles">client.profiles.<a href="./src/kernel/resources/profiles.py">list</a>() -> <a href="./src/kernel/types/profile_list_response.py">ProfileListResponse</a></code>
 - <code title="delete /profiles/{id_or_name}">client.profiles.<a href="./src/kernel/resources/profiles.py">delete</a>(id_or_name) -> None</code>
 - <code title="get /profiles/{id_or_name}/download">client.profiles.<a href="./src/kernel/resources/profiles.py">download</a>(id_or_name) -> BinaryAPIResponse</code>
+
+# Proxies
+
+Types:
+
+```python
+from kernel.types import ProxyCreateResponse, ProxyRetrieveResponse, ProxyListResponse
+```
+
+Methods:
+
+- <code title="post /proxies">client.proxies.<a href="./src/kernel/resources/proxies.py">create</a>(\*\*<a href="src/kernel/types/proxy_create_params.py">params</a>) -> <a href="./src/kernel/types/proxy_create_response.py">ProxyCreateResponse</a></code>
+- <code title="get /proxies/{id}">client.proxies.<a href="./src/kernel/resources/proxies.py">retrieve</a>(id) -> <a href="./src/kernel/types/proxy_retrieve_response.py">ProxyRetrieveResponse</a></code>
+- <code title="get /proxies">client.proxies.<a href="./src/kernel/resources/proxies.py">list</a>() -> <a href="./src/kernel/types/proxy_list_response.py">ProxyListResponse</a></code>
+- <code title="delete /proxies/{id}">client.proxies.<a href="./src/kernel/resources/proxies.py">delete</a>(id) -> None</code>

src/kernel/_client.py

@@ -21,7 +21,7 @@
 )
 from ._utils import is_given, get_async_library
 from ._version import __version__
-from .resources import apps, profiles, deployments, invocations
+from .resources import apps, proxies, profiles, deployments, invocations
 from ._streaming import Stream as Stream, AsyncStream as AsyncStream
 from ._exceptions import KernelError, APIStatusError
 from ._base_client import (
@@ -55,6 +55,7 @@ class Kernel(SyncAPIClient):
     invocations: invocations.InvocationsResource
     browsers: browsers.BrowsersResource
     profiles: profiles.ProfilesResource
+    proxies: proxies.ProxiesResource
     with_raw_response: KernelWithRawResponse
     with_streaming_response: KernelWithStreamedResponse
 
@@ -141,6 +142,7 @@ def __init__(
         self.invocations = invocations.InvocationsResource(self)
         self.browsers = browsers.BrowsersResource(self)
         self.profiles = profiles.ProfilesResource(self)
+        self.proxies = proxies.ProxiesResource(self)
         self.with_raw_response = KernelWithRawResponse(self)
         self.with_streaming_response = KernelWithStreamedResponse(self)
 
@@ -257,6 +259,7 @@ class AsyncKernel(AsyncAPIClient):
     invocations: invocations.AsyncInvocationsResource
     browsers: browsers.AsyncBrowsersResource
     profiles: profiles.AsyncProfilesResource
+    proxies: proxies.AsyncProxiesResource
     with_raw_response: AsyncKernelWithRawResponse
     with_streaming_response: AsyncKernelWithStreamedResponse
 
@@ -343,6 +346,7 @@ def __init__(
         self.invocations = invocations.AsyncInvocationsResource(self)
         self.browsers = browsers.AsyncBrowsersResource(self)
         self.profiles = profiles.AsyncProfilesResource(self)
+        self.proxies = proxies.AsyncProxiesResource(self)
         self.with_raw_response = AsyncKernelWithRawResponse(self)
         self.with_streaming_response = AsyncKernelWithStreamedResponse(self)
 
@@ -460,6 +464,7 @@ def __init__(self, client: Kernel) -> None:
         self.invocations = invocations.InvocationsResourceWithRawResponse(client.invocations)
         self.browsers = browsers.BrowsersResourceWithRawResponse(client.browsers)
         self.profiles = profiles.ProfilesResourceWithRawResponse(client.profiles)
+        self.proxies = proxies.ProxiesResourceWithRawResponse(client.proxies)
 
 
 class AsyncKernelWithRawResponse:
@@ -469,6 +474,7 @@ def __init__(self, client: AsyncKernel) -> None:
         self.invocations = invocations.AsyncInvocationsResourceWithRawResponse(client.invocations)
         self.browsers = browsers.AsyncBrowsersResourceWithRawResponse(client.browsers)
         self.profiles = profiles.AsyncProfilesResourceWithRawResponse(client.profiles)
+        self.proxies = proxies.AsyncProxiesResourceWithRawResponse(client.proxies)
 
 
 class KernelWithStreamedResponse:
@@ -478,6 +484,7 @@ def __init__(self, client: Kernel) -> None:
         self.invocations = invocations.InvocationsResourceWithStreamingResponse(client.invocations)
         self.browsers = browsers.BrowsersResourceWithStreamingResponse(client.browsers)
         self.profiles = profiles.ProfilesResourceWithStreamingResponse(client.profiles)
+        self.proxies = proxies.ProxiesResourceWithStreamingResponse(client.proxies)
 
 
 class AsyncKernelWithStreamedResponse:
@@ -487,6 +494,7 @@ def __init__(self, client: AsyncKernel) -> None:
         self.invocations = invocations.AsyncInvocationsResourceWithStreamingResponse(client.invocations)
         self.browsers = browsers.AsyncBrowsersResourceWithStreamingResponse(client.browsers)
         self.profiles = profiles.AsyncProfilesResourceWithStreamingResponse(client.profiles)
+        self.proxies = proxies.AsyncProxiesResourceWithStreamingResponse(client.proxies)
 
 
 Client = Kernel

src/kernel/resources/__init__.py

@@ -8,6 +8,14 @@
     AppsResourceWithStreamingResponse,
     AsyncAppsResourceWithStreamingResponse,
 )
+from .proxies import (
+    ProxiesResource,
+    AsyncProxiesResource,
+    ProxiesResourceWithRawResponse,
+    AsyncProxiesResourceWithRawResponse,
+    ProxiesResourceWithStreamingResponse,
+    AsyncProxiesResourceWithStreamingResponse,
+)
 from .browsers import (
     BrowsersResource,
     AsyncBrowsersResource,
@@ -72,4 +80,10 @@
     "AsyncProfilesResourceWithRawResponse",
     "ProfilesResourceWithStreamingResponse",
     "AsyncProfilesResourceWithStreamingResponse",
+    "ProxiesResource",
+    "AsyncProxiesResource",
+    "ProxiesResourceWithRawResponse",
+    "AsyncProxiesResourceWithRawResponse",
+    "ProxiesResourceWithStreamingResponse",
+    "AsyncProxiesResourceWithStreamingResponse",
 ]

src/kernel/resources/browsers/browsers.py

@@ -99,6 +99,7 @@ def create(
         invocation_id: str | Omit = omit,
         persistence: BrowserPersistenceParam | Omit = omit,
         profile: browser_create_params.Profile | Omit = omit,
+        proxy_id: str | Omit = omit,
         stealth: bool | Omit = omit,
         timeout_seconds: int | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -123,12 +124,18 @@ def create(
               specified, the matching profile will be loaded into the browser session.
               Profiles must be created beforehand.
 
+          proxy_id: Optional proxy to associate to the browser session. Must reference a proxy
+              belonging to the caller's org.
+
           stealth: If true, launches the browser in stealth mode to reduce detection by anti-bot
               mechanisms.
 
           timeout_seconds: The number of seconds of inactivity before the browser session is terminated.
               Only applicable to non-persistent browsers. Activity includes CDP connections
-              and live view connections. Defaults to 60 seconds.
+              and live view connections. Defaults to 60 seconds. Minimum allowed is 10
+              seconds. Maximum allowed is 86400 (24 hours). We check for inactivity every 5
+              seconds, so the actual timeout behavior you will see is +/- 5 seconds around the
+              specified value.
 
           extra_headers: Send extra headers
 
@@ -146,6 +153,7 @@ def create(
                     "invocation_id": invocation_id,
                     "persistence": persistence,
                     "profile": profile,
+                    "proxy_id": proxy_id,
                     "stealth": stealth,
                     "timeout_seconds": timeout_seconds,
                 },
@@ -325,6 +333,7 @@ async def create(
         invocation_id: str | Omit = omit,
         persistence: BrowserPersistenceParam | Omit = omit,
         profile: browser_create_params.Profile | Omit = omit,
+        proxy_id: str | Omit = omit,
         stealth: bool | Omit = omit,
         timeout_seconds: int | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -349,12 +358,18 @@ async def create(
               specified, the matching profile will be loaded into the browser session.
               Profiles must be created beforehand.
 
+          proxy_id: Optional proxy to associate to the browser session. Must reference a proxy
+              belonging to the caller's org.
+
           stealth: If true, launches the browser in stealth mode to reduce detection by anti-bot
               mechanisms.
 
           timeout_seconds: The number of seconds of inactivity before the browser session is terminated.
               Only applicable to non-persistent browsers. Activity includes CDP connections
-              and live view connections. Defaults to 60 seconds.
+              and live view connections. Defaults to 60 seconds. Minimum allowed is 10
+              seconds. Maximum allowed is 86400 (24 hours). We check for inactivity every 5
+              seconds, so the actual timeout behavior you will see is +/- 5 seconds around the
+              specified value.
 
           extra_headers: Send extra headers
 
@@ -372,6 +387,7 @@ async def create(
                     "invocation_id": invocation_id,
                     "persistence": persistence,
                     "profile": profile,
+                    "proxy_id": proxy_id,
                     "stealth": stealth,
                     "timeout_seconds": timeout_seconds,
                 },

src/kernel/resources/invocations.py

@@ -150,8 +150,10 @@ def update(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> InvocationUpdateResponse:
-        """
-        Update an invocation's status or output.
+        """Update an invocation's status or output.
+
+        This can used to cancel an invocation
+        by setting the status to "failed".
 
         Args:
           status: New status for the invocation.
@@ -380,8 +382,10 @@ async def update(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> InvocationUpdateResponse:
-        """
-        Update an invocation's status or output.
+        """Update an invocation's status or output.
+
+        This can used to cancel an invocation
+        by setting the status to "failed".
 
         Args:
           status: New status for the invocation.