feat: Browser API endpoint grouping

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 108
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-f967d3024897a6125d5d18c4577dbb2cc22d742d487e6a43165198685f992379.yml
-openapi_spec_hash: e1c40ef0aee3a79168eb9cc854a9e403
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-848817f2b20afb49a652952c814b99e27a94090e0770465e9a87748d27e227a7.yml
+openapi_spec_hash: 91efb805e45cdd4c73cd8b0950bef019
 config_hash: 3b1fbbb6bda0dac7e8b42e155cd7da56

src/kernel/resources/auth/connections.py

@@ -70,10 +70,10 @@ def create(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> ManagedAuth:
-        """Creates managed authentication for a profile and domain combination.
+        """Creates an auth connection for a profile and domain combination.
 
         Returns 409
-        Conflict if managed auth already exists for the given profile and domain.
+        Conflict if an auth connection already exists for the given profile and domain.
 
         Args:
           domain: Domain for authentication
@@ -99,7 +99,7 @@ def create(
               - Ping Identity: _.pingone.com, _.pingidentity.com
 
           credential:
-              Reference to credentials for managed auth. Use one of:
+              Reference to credentials for the auth connection. Use one of:
 
               - { name } for Kernel credentials
               - { provider, path } for external provider item
@@ -153,10 +153,10 @@ def retrieve(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> ManagedAuth:
-        """Retrieve managed auth by its ID.
+        """Retrieve an auth connection by its ID.
 
-        Includes current flow state if a login is in
-        progress.
+        Includes current flow state if a login is
+        in progress.
 
         Args:
           extra_headers: Send extra headers
@@ -192,7 +192,7 @@ def list(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SyncOffsetPagination[ManagedAuth]:
         """
-        List managed auths with optional filters for profile_name and domain.
+        List auth connections with optional filters for profile_name and domain.
 
         Args:
           domain: Filter by domain
@@ -243,11 +243,11 @@ def delete(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> None:
-        """Deletes managed auth and terminates its workflow.
+        """Deletes an auth connection and terminates its workflow.
 
         This will:
 
-        - Delete the managed auth record
+        - Delete the auth connection record
         - Terminate the Temporal workflow
         - Cancel any in-progress login flows
 
@@ -323,10 +323,10 @@ def login(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> LoginResponse:
-        """Starts a login flow for the managed auth.
+        """Starts a login flow for the auth connection.
 
-        Returns immediately with a hosted URL
-        for the user to complete authentication, or triggers automatic re-auth if
+        Returns immediately with a hosted
+        URL for the user to complete authentication, or triggers automatic re-auth if
         credentials are stored.
 
         Args:
@@ -369,8 +369,8 @@ def submit(
     ) -> SubmitFieldsResponse:
         """Submits field values for the login form.
 
-        Poll the managed auth to track progress
-        and get results.
+        Poll the auth connection to track
+        progress and get results.
 
         Args:
           fields: Map of field name to value
@@ -443,10 +443,10 @@ async def create(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> ManagedAuth:
-        """Creates managed authentication for a profile and domain combination.
+        """Creates an auth connection for a profile and domain combination.
 
         Returns 409
-        Conflict if managed auth already exists for the given profile and domain.
+        Conflict if an auth connection already exists for the given profile and domain.
 
         Args:
           domain: Domain for authentication
@@ -472,7 +472,7 @@ async def create(
               - Ping Identity: _.pingone.com, _.pingidentity.com
 
           credential:
-              Reference to credentials for managed auth. Use one of:
+              Reference to credentials for the auth connection. Use one of:
 
               - { name } for Kernel credentials
               - { provider, path } for external provider item
@@ -526,10 +526,10 @@ async def retrieve(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> ManagedAuth:
-        """Retrieve managed auth by its ID.
+        """Retrieve an auth connection by its ID.
 
-        Includes current flow state if a login is in
-        progress.
+        Includes current flow state if a login is
+        in progress.
 
         Args:
           extra_headers: Send extra headers
@@ -565,7 +565,7 @@ def list(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AsyncPaginator[ManagedAuth, AsyncOffsetPagination[ManagedAuth]]:
         """
-        List managed auths with optional filters for profile_name and domain.
+        List auth connections with optional filters for profile_name and domain.
 
         Args:
           domain: Filter by domain
@@ -616,11 +616,11 @@ async def delete(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> None:
-        """Deletes managed auth and terminates its workflow.
+        """Deletes an auth connection and terminates its workflow.
 
         This will:
 
-        - Delete the managed auth record
+        - Delete the auth connection record
         - Terminate the Temporal workflow
         - Cancel any in-progress login flows
 
@@ -696,10 +696,10 @@ async def login(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> LoginResponse:
-        """Starts a login flow for the managed auth.
+        """Starts a login flow for the auth connection.
 
-        Returns immediately with a hosted URL
-        for the user to complete authentication, or triggers automatic re-auth if
+        Returns immediately with a hosted
+        URL for the user to complete authentication, or triggers automatic re-auth if
         credentials are stored.
 
         Args:
@@ -742,8 +742,8 @@ async def submit(
     ) -> SubmitFieldsResponse:
         """Submits field values for the login form.
 
-        Poll the managed auth to track progress
-        and get results.
+        Poll the auth connection to track
+        progress and get results.
 
         Args:
           fields: Map of field name to value

src/kernel/types/agents/auth_agent.py

@@ -10,7 +10,7 @@
 
 
 class Credential(BaseModel):
-    """Reference to credentials for managed auth.
+    """Reference to credentials for the auth connection.
 
     Use one of:
     - { name } for Kernel credentials
@@ -80,7 +80,7 @@ class AuthAgent(BaseModel):
     """Reason why automatic re-authentication is or is not possible"""
 
     credential: Optional[Credential] = None
-    """Reference to credentials for managed auth. Use one of:
+    """Reference to credentials for the auth connection. Use one of:
 
     - { name } for Kernel credentials
     - { provider, path } for external provider item

src/kernel/types/auth/connection_create_params.py

@@ -38,7 +38,7 @@ class ConnectionCreateParams(TypedDict, total=False):
     """
 
     credential: Credential
-    """Reference to credentials for managed auth. Use one of:
+    """Reference to credentials for the auth connection. Use one of:
 
     - { name } for Kernel credentials
     - { provider, path } for external provider item
@@ -61,7 +61,7 @@ class ConnectionCreateParams(TypedDict, total=False):
 
 
 class Credential(TypedDict, total=False):
-    """Reference to credentials for managed auth.
+    """Reference to credentials for the auth connection.
 
     Use one of:
     - { name } for Kernel credentials

src/kernel/types/auth/login_response.py

@@ -13,7 +13,7 @@ class LoginResponse(BaseModel):
     """Response from starting a login flow"""
 
     id: str
-    """Managed auth ID"""
+    """Auth connection ID"""
 
     flow_expires_at: datetime
     """When the login flow expires"""

src/kernel/types/auth/managed_auth.py

@@ -11,7 +11,7 @@
 
 
 class Credential(BaseModel):
-    """Reference to credentials for managed auth.
+    """Reference to credentials for the auth connection.
 
     Use one of:
     - { name } for Kernel credentials
@@ -70,13 +70,13 @@ class ManagedAuth(BaseModel):
     """
 
     id: str
-    """Unique identifier for the managed auth"""
+    """Unique identifier for the auth connection"""
 
     domain: str
     """Target domain for authentication"""
 
     profile_name: str
-    """Name of the profile associated with this managed auth"""
+    """Name of the profile associated with this auth connection"""
 
     status: Literal["AUTHENTICATED", "NEEDS_AUTH"]
     """Current authentication status of the managed profile"""
@@ -112,7 +112,7 @@ class ManagedAuth(BaseModel):
     """Reason why automatic re-authentication is or is not possible"""
 
     credential: Optional[Credential] = None
-    """Reference to credentials for managed auth. Use one of:
+    """Reference to credentials for the auth connection. Use one of:
 
     - { name } for Kernel credentials
     - { provider, path } for external provider item