Add docs for includeThoughts and isThought

Author: andrewheard

FirebaseAI/Sources/Types/Public/Part.swift

@@ -19,6 +19,11 @@ import Foundation
 /// Within a single value of ``Part``, different data types may not mix.
 @available(iOS 15.0, macOS 12.0, macCatalyst 15.0, tvOS 15.0, watchOS 8.0, *)
 public protocol Part: PartsRepresentable, Codable, Sendable, Equatable {
+  /// Indicates whether this `Part` is a summary of the model's internal thinking process.
+  ///
+  /// When `includeThoughts` is set to `true` in ``ThinkingConfig``, the model may return one or
+  /// more "thought" parts that provide insight into how it reasoned through the prompt to arrive
+  /// at the final answer. These parts will have `isThought` set to `true`.
   var isThought: Bool { get }
 }
 

FirebaseAI/Sources/Types/Public/ThinkingConfig.swift

@@ -37,12 +37,21 @@ public struct ThinkingConfig: Sendable {
   /// feature or if the specified budget is not within the model's supported range.
   let thinkingBudget: Int?
 
+  /// Whether summaries of the model's "thoughts" are included in responses.
+  ///
+  /// When `includeThoughts` is set to `true`, the model will return a summary of its internal
+  /// thinking process alongside the final answer. This can provide valuable insight into how the
+  /// model arrived at its conclusion, which is particularly useful for complex or creative tasks.
+  ///
+  /// If you don't specify a value for `includeThoughts` (`nil`), the model will use its default
+  /// behavior (which is typically to not include thought summaries).
   let includeThoughts: Bool?
 
   /// Initializes a new `ThinkingConfig`.
   ///
   /// - Parameters:
   ///   - thinkingBudget: The maximum number of tokens to be used for the model's thinking process.
+  ///   - includeThoughts: If true, summaries of the model's "thoughts" are included in responses.
   public init(thinkingBudget: Int? = nil, includeThoughts: Bool? = nil) {
     self.thinkingBudget = thinkingBudget
     self.includeThoughts = includeThoughts