docs(session): Clarify Unhandled state and hybrid-only recording

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: buenaflor

sentry/src/main/java/io/sentry/Session.java

@@ -22,6 +22,10 @@ public enum State {
     Exited,
     Crashed,
     Abnormal,
+    /**
+     * Unhandled error the process survived. Not used while the session is alive; {@link
+     * Session#end()} sets this. Native crashes still end as {@link #Crashed}.
+     */
     Unhandled
   }
 
@@ -211,6 +215,9 @@ public boolean hasNonTerminatingUnhandledError() {
    * #end()} the session is finalized as {@link State#Unhandled} unless a crash escalated it to
    * {@link State#Crashed} first.
    *
+   * <p>Hybrid SDKs whose unhandled errors do not kill the process. Native Java/Android capture
+   * should not call this.
+   *
    * @return whether the session was updated, i.e. false if it had already reached a terminal state
    */
   @ApiStatus.Internal