Cleanup AI verbosity

Author: alan-george-lk

include/livekit/room.h

@@ -194,16 +194,10 @@ class LIVEKIT_API Room {
   /// Retrieve aggregated WebRTC stats for this room session.
   ///
   /// Behavior:
-  /// - If the room is not currently connected (no live FFI handle), resolves
-  ///   immediately with a `GetSessionStatsErrorCode::NOT_CONNECTED` failure.
-  /// - Otherwise dispatches an async `get_session_stats` request to the Rust
-  ///   FFI; the future resolves once the corresponding callback arrives.
-  /// - The future never throws — failures are surfaced as a typed
-  ///   `GetSessionStatsError`. Inspect `Result::ok()` / `Result::error().code`
-  ///   to branch on outcome.
-  ///
-  /// @return Future resolving with publisher + subscriber stats on success,
-  ///         or a typed error code + message on failure.
+  /// - If the room is not currently connected, returns a failed result immediately.
+  /// - Otherwise dispatches an async request to the server to get the stats.
+  /// @note Check result.ok() before accessing the stats.
+  /// @return Future result of the room session stats.
   std::future<Result<SessionStats, GetSessionStatsError>> getStats() const;
 
   /* Register a handler for incoming text streams on a specific topic.

include/livekit/stats.h

@@ -502,13 +502,6 @@ struct RtcStats {
 };
 
 /// Aggregated WebRTC stats for a connected room session.
-///
-/// Mirrors the FFI `GetSessionStatsCallback.Result` payload: stats are split
-/// between the publisher peer connection (outbound media flowing from the
-/// local participant to the SFU) and the subscriber peer connection (inbound
-/// media flowing from the SFU back to the local participant). When the SDK is
-/// operating in single-peer-connection mode the publisher list carries the
-/// combined stats and the subscriber list is empty.
 struct SessionStats {
   /// Stats from the publisher peer connection (outbound media).
   std::vector<RtcStats> publisher_stats;