Merge remote-tracking branch 'origin/main' into stlc/promote-next

Author: kernel-internal[bot]

src/kernel/types/auth/connection_follow_response.py

@@ -35,9 +35,24 @@ class ManagedAuthStateEventChoice(BaseModel):
     ]
     """Choice type."""
 
+    context: Optional[str] = None
+    """Context captured for a choice."""
+
     description: Optional[str] = None
     """Additional context for the choice."""
 
+    display_text: Optional[str] = None
+    """Display text captured for a choice."""
+
+    masked_destination: Optional[str] = None
+    """Masked phone number or email address shown for an MFA choice."""
+
+    mfa_type: Optional[Literal["sms", "call", "email", "totp", "push", "password", "passkey", "switch", "other"]] = None
+    """Semantic MFA method.
+
+    Choice id remains the stable identity of the exact option selected.
+    """
+
     observed_selector: Optional[str] = None
     """Selector for the visible choice, when available."""
 
@@ -88,6 +103,9 @@ class ManagedAuthStateEventField(BaseModel):
     type: Literal["identifier", "password", "code", "totp_code", "totp_secret", "text"]
     """Managed-auth field type."""
 
+    hint: Optional[str] = None
+    """Context shown near the field, including a masked code destination."""
+
     label: Optional[str] = None
     """Human-readable label shown to the user."""
 

src/kernel/types/auth/managed_auth.py

@@ -122,9 +122,24 @@ class Choice(BaseModel):
     ]
     """Choice type."""
 
+    context: Optional[str] = None
+    """Context captured for a choice."""
+
     description: Optional[str] = None
     """Additional context for the choice."""
 
+    display_text: Optional[str] = None
+    """Display text captured for a choice."""
+
+    masked_destination: Optional[str] = None
+    """Masked phone number or email address shown for an MFA choice."""
+
+    mfa_type: Optional[Literal["sms", "call", "email", "totp", "push", "password", "passkey", "switch", "other"]] = None
+    """Semantic MFA method.
+
+    Choice id remains the stable identity of the exact option selected.
+    """
+
     observed_selector: Optional[str] = None
     """Selector for the visible choice, when available."""
 
@@ -197,6 +212,9 @@ class Field(BaseModel):
     type: Literal["identifier", "password", "code", "totp_code", "totp_secret", "text"]
     """Managed-auth field type."""
 
+    hint: Optional[str] = None
+    """Context shown near the field, including a masked code destination."""
+
     label: Optional[str] = None
     """Human-readable label shown to the user."""