feat: Expose missing managed auth check URL as verification unavailable

Stainless-Generated-From: 1995c3fd399a0dc1dbc1a88983b6bb0d0673d0f8

Author: kernel-internal[bot]

src/kernel/types/auth/managed_auth.py

@@ -324,7 +324,11 @@ class ManagedAuth(BaseModel):
     """
 
     status: Literal["AUTHENTICATED", "NEEDS_AUTH"]
-    """Current authentication status of the managed profile"""
+    """Last known authentication status of the managed profile.
+
+    An inconclusive health check preserves this status and does not verify the
+    current session.
+    """
 
     allowed_domains: Optional[List[str]] = None
     """Additional hostname roots valid for this auth flow, besides the primary domain.
@@ -519,6 +523,13 @@ class ManagedAuth(BaseModel):
     3600 (1 hour), Free: 21600 (6 hours).
     """
 
+    health_check_unavailable_reason: Optional[Literal["no_auth_check_url"]] = None
+    """Why health checks cannot verify this connection.
+
+    Present when health checks are enabled but no auth check URL is available; a
+    recent last_auth_check_at is not evidence of a valid session.
+    """
+
     health_checks: Optional[bool] = None
     """Whether periodic health checks are enabled for this connection.