feat: managed-auth: surface awaiting_external_action even when fallback actions exist

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 112
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-7d2d29d7598105d50e5118e0bc5ac654361a92cb95555705dbd1d236848e1456.yml
-openapi_spec_hash: 10002eae793e08f81932239bbc72b503
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-38c6ce8b0ce54e6c62517b9635acaf65369c26cdb1b55eb66290c13a8ab2b33d.yml
+openapi_spec_hash: e6f6ed157b1e318d1a1db72fd1d27091
 config_hash: 08d55086449943a8fec212b870061a3f

src/kernel/types/auth/connection_follow_response.py

@@ -119,7 +119,10 @@ class ManagedAuthStateEvent(BaseModel):
     """Time the state was reported."""
 
     discovered_fields: Optional[List[ManagedAuthStateEventDiscoveredField]] = None
-    """Fields awaiting input (present when flow_step=AWAITING_INPUT)."""
+    """
+    Fields awaiting input (present when flow_step=AWAITING_INPUT; may also be
+    present with AWAITING_EXTERNAL_ACTION as fallback actions).
+    """
 
     error_code: Optional[str] = None
     """Machine-readable error code (present when flow_status=FAILED)."""
@@ -144,20 +147,24 @@ class ManagedAuthStateEvent(BaseModel):
 
     mfa_options: Optional[List[ManagedAuthStateEventMfaOption]] = None
     """
-    MFA method options (present when flow_step=AWAITING_INPUT and MFA selection
-    required).
+    MFA method options (present when flow_step=AWAITING_INPUT; may also be present
+    with AWAITING_EXTERNAL_ACTION as fallback actions).
     """
 
     pending_sso_buttons: Optional[List[ManagedAuthStateEventPendingSSOButton]] = None
-    """SSO buttons available (present when flow_step=AWAITING_INPUT)."""
+    """
+    SSO buttons available (present when flow_step=AWAITING_INPUT; may also be
+    present with AWAITING_EXTERNAL_ACTION as fallback actions).
+    """
 
     post_login_url: Optional[str] = None
     """URL where the browser landed after successful login."""
 
     sign_in_options: Optional[List[ManagedAuthStateEventSignInOption]] = None
     """
     Non-MFA choices presented during the auth flow, such as account selection or org
-    pickers (present when flow_step=AWAITING_INPUT).
+    pickers (present when flow_step=AWAITING_INPUT; may also be present with
+    AWAITING_EXTERNAL_ACTION as fallback actions).
     """
 
     website_error: Optional[str] = None

src/kernel/types/auth/managed_auth.py

@@ -185,7 +185,10 @@ class ManagedAuth(BaseModel):
     """
 
     discovered_fields: Optional[List[DiscoveredField]] = None
-    """Fields awaiting input (present when flow_step=awaiting_input)"""
+    """
+    Fields awaiting input (present when flow_step=awaiting_input; may also be
+    present with awaiting_external_action as fallback actions)
+    """
 
     error_code: Optional[str] = None
     """Machine-readable error code (present when flow_status=failed)"""
@@ -254,12 +257,15 @@ class ManagedAuth(BaseModel):
 
     mfa_options: Optional[List[MfaOption]] = None
     """
-    MFA method options (present when flow_step=awaiting_input and MFA selection
-    required)
+    MFA method options (present when flow_step=awaiting_input; may also be present
+    with awaiting_external_action as fallback actions)
     """
 
     pending_sso_buttons: Optional[List[PendingSSOButton]] = None
-    """SSO buttons available (present when flow_step=awaiting_input)"""
+    """
+    SSO buttons available (present when flow_step=awaiting_input; may also be
+    present with awaiting_external_action as fallback actions)
+    """
 
     post_login_url: Optional[str] = None
     """URL where the browser landed after successful login"""
@@ -270,7 +276,8 @@ class ManagedAuth(BaseModel):
     sign_in_options: Optional[List[SignInOption]] = None
     """
     Non-MFA choices presented during the auth flow, such as account selection or org
-    pickers (present when flow_step=awaiting_input).
+    pickers (present when flow_step=awaiting_input; may also be present with
+    awaiting_external_action as fallback actions).
     """
 
     sso_provider: Optional[str] = None