refactor(auth): simplify proxy configuration in OpenAPI schema

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 100
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-13e82ae9e725e2c3ca19da7248a7a9c8696a0dfe088654cf26aea07c76d6567a.yml
-openapi_spec_hash: 6d4151a6066a8474bc56923299aec18a
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-eaf23b9711c16c82563be76641c9c89988288307278dcd630a36f4f186f85afa.yml
+openapi_spec_hash: 369570222f4f725e1de11285422837cc
 config_hash: 82f0a04081a3ab7111d3a9c68cd3ff2b

src/kernel/resources/auth/connections.py

@@ -112,7 +112,8 @@ def create(
 
           login_url: Optional login page URL to skip discovery
 
-          proxy: Optional proxy configuration
+          proxy: Proxy selection. Provide either id or name. The proxy must belong to the
+              caller's org.
 
           extra_headers: Send extra headers
 
@@ -315,6 +316,7 @@ def login(
         self,
         id: str,
         *,
+        proxy: connection_login_params.Proxy | Omit = omit,
         save_credential_as: str | 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.
@@ -330,6 +332,9 @@ def login(
         credentials are stored.
 
         Args:
+          proxy: Proxy selection. Provide either id or name. The proxy must belong to the
+              caller's org.
+
           save_credential_as: If provided, saves credentials under this name upon successful login
 
           extra_headers: Send extra headers
@@ -345,7 +350,11 @@ def login(
         return self._post(
             f"/auth/connections/{id}/login",
             body=maybe_transform(
-                {"save_credential_as": save_credential_as}, connection_login_params.ConnectionLoginParams
+                {
+                    "proxy": proxy,
+                    "save_credential_as": save_credential_as,
+                },
+                connection_login_params.ConnectionLoginParams,
             ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
@@ -485,7 +494,8 @@ async def create(
 
           login_url: Optional login page URL to skip discovery
 
-          proxy: Optional proxy configuration
+          proxy: Proxy selection. Provide either id or name. The proxy must belong to the
+              caller's org.
 
           extra_headers: Send extra headers
 
@@ -688,6 +698,7 @@ async def login(
         self,
         id: str,
         *,
+        proxy: connection_login_params.Proxy | Omit = omit,
         save_credential_as: str | 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.
@@ -703,6 +714,9 @@ async def login(
         credentials are stored.
 
         Args:
+          proxy: Proxy selection. Provide either id or name. The proxy must belong to the
+              caller's org.
+
           save_credential_as: If provided, saves credentials under this name upon successful login
 
           extra_headers: Send extra headers
@@ -718,7 +732,11 @@ async def login(
         return await self._post(
             f"/auth/connections/{id}/login",
             body=await async_maybe_transform(
-                {"save_credential_as": save_credential_as}, connection_login_params.ConnectionLoginParams
+                {
+                    "proxy": proxy,
+                    "save_credential_as": save_credential_as,
+                },
+                connection_login_params.ConnectionLoginParams,
             ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout

src/kernel/types/auth/connection_create_params.py

@@ -57,7 +57,10 @@ class ConnectionCreateParams(TypedDict, total=False):
     """Optional login page URL to skip discovery"""
 
     proxy: Proxy
-    """Optional proxy configuration"""
+    """Proxy selection.
+
+    Provide either id or name. The proxy must belong to the caller's org.
+    """
 
 
 class Credential(TypedDict, total=False):
@@ -83,7 +86,13 @@ class Credential(TypedDict, total=False):
 
 
 class Proxy(TypedDict, total=False):
-    """Optional proxy configuration"""
+    """Proxy selection.
+
+    Provide either id or name. The proxy must belong to the caller's org.
+    """
+
+    id: str
+    """Proxy ID"""
 
-    proxy_id: str
-    """ID of the proxy to use"""
+    name: str
+    """Proxy name"""

src/kernel/types/auth/connection_login_params.py

@@ -4,9 +4,28 @@
 
 from typing_extensions import TypedDict
 
-__all__ = ["ConnectionLoginParams"]
+__all__ = ["ConnectionLoginParams", "Proxy"]
 
 
 class ConnectionLoginParams(TypedDict, total=False):
+    proxy: Proxy
+    """Proxy selection.
+
+    Provide either id or name. The proxy must belong to the caller's org.
+    """
+
     save_credential_as: str
     """If provided, saves credentials under this name upon successful login"""
+
+
+class Proxy(TypedDict, total=False):
+    """Proxy selection.
+
+    Provide either id or name. The proxy must belong to the caller's org.
+    """
+
+    id: str
+    """Proxy ID"""
+
+    name: str
+    """Proxy name"""

tests/api_resources/auth/test_connections.py

@@ -46,7 +46,10 @@ def test_method_create_with_all_params(self, client: Kernel) -> None:
             },
             health_check_interval=3600,
             login_url="https://netflix.com/login",
-            proxy={"proxy_id": "proxy_id"},
+            proxy={
+                "id": "id",
+                "name": "name",
+            },
         )
         assert_matches_type(ManagedAuth, connection, path=["response"])
 
@@ -255,6 +258,10 @@ def test_method_login(self, client: Kernel) -> None:
     def test_method_login_with_all_params(self, client: Kernel) -> None:
         connection = client.auth.connections.login(
             id="id",
+            proxy={
+                "id": "id",
+                "name": "name",
+            },
             save_credential_as="my-netflix-login",
         )
         assert_matches_type(LoginResponse, connection, path=["response"])
@@ -395,7 +402,10 @@ async def test_method_create_with_all_params(self, async_client: AsyncKernel) ->
             },
             health_check_interval=3600,
             login_url="https://netflix.com/login",
-            proxy={"proxy_id": "proxy_id"},
+            proxy={
+                "id": "id",
+                "name": "name",
+            },
         )
         assert_matches_type(ManagedAuth, connection, path=["response"])
 
@@ -604,6 +614,10 @@ async def test_method_login(self, async_client: AsyncKernel) -> None:
     async def test_method_login_with_all_params(self, async_client: AsyncKernel) -> None:
         connection = await async_client.auth.connections.login(
             id="id",
+            proxy={
+                "id": "id",
+                "name": "name",
+            },
             save_credential_as="my-netflix-login",
         )
         assert_matches_type(LoginResponse, connection, path=["response"])