feat: Include login_url in managed auth connection response

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 104
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-f7024f4171c7c4ec558de1c27f338b1089ffddd0d2dbfdb9bb9f9c2abe8f47bf.yml
-openapi_spec_hash: ced43682b49e73a2862f99b49abb4fcd
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-ac10847d991ef8ed89124b5550922cb5726af2b4a4c3396ee6ff82938302fc25.yml
+openapi_spec_hash: 0d902563108fe2461708c05336eab40a
 config_hash: 16e4457a0bb26e98a335a1c2a572290a

src/kernel/resources/auth/connections.py

@@ -76,13 +76,15 @@ def create(
     ) -> ManagedAuth:
         """Creates an auth connection for a profile and domain combination.
 
-        Returns 409
-        Conflict if an auth connection already exists for the given profile and domain.
+        If the provided
+        profile_name does not exist, it is created automatically. Returns 409 Conflict
+        if an auth connection already exists for the given profile and domain.
 
         Args:
           domain: Domain for authentication
 
-          profile_name: Name of the profile to manage authentication for
+          profile_name: Name of the profile to manage authentication for. If the profile does not exist,
+              it is created automatically.
 
           allowed_domains: Additional domains valid for this auth flow (besides the primary domain). Useful
               when login pages redirect to different domains.
@@ -537,13 +539,15 @@ async def create(
     ) -> ManagedAuth:
         """Creates an auth connection for a profile and domain combination.
 
-        Returns 409
-        Conflict if an auth connection already exists for the given profile and domain.
+        If the provided
+        profile_name does not exist, it is created automatically. Returns 409 Conflict
+        if an auth connection already exists for the given profile and domain.
 
         Args:
           domain: Domain for authentication
 
-          profile_name: Name of the profile to manage authentication for
+          profile_name: Name of the profile to manage authentication for. If the profile does not exist,
+              it is created automatically.
 
           allowed_domains: Additional domains valid for this auth flow (besides the primary domain). Useful
               when login pages redirect to different domains.

src/kernel/types/auth/connection_create_params.py

@@ -14,7 +14,10 @@ class ConnectionCreateParams(TypedDict, total=False):
     """Domain for authentication"""
 
     profile_name: Required[str]
-    """Name of the profile to manage authentication for"""
+    """Name of the profile to manage authentication for.
+
+    If the profile does not exist, it is created automatically.
+    """
 
     allowed_domains: SequenceNotStr[str]
     """Additional domains valid for this auth flow (besides the primary domain).

src/kernel/types/auth/managed_auth.py

@@ -215,6 +215,9 @@ class ManagedAuth(BaseModel):
     live_view_url: Optional[str] = None
     """Browser live view URL for debugging (present when flow in progress)"""
 
+    login_url: Optional[str] = None
+    """Optional login page URL to skip discovery"""
+
     mfa_options: Optional[List[MfaOption]] = None
     """
     MFA method options (present when flow_step=awaiting_input and MFA selection