chore: Internal cleanup

src/main/java/com/google/genai/types/FunctionCall.java

@@ -31,13 +31,16 @@
 import java.util.Map;
 import java.util.Optional;
 
-/** A function call. */
+/**
+ * A predicted FunctionCall returned from the model that contains a string representing the
+ * FunctionDeclaration.name and a structured JSON object containing the parameters and their values.
+ */
 @AutoValue
 @JsonDeserialize(builder = FunctionCall.Builder.class)
 public abstract class FunctionCall extends JsonSerializable {
   /**
-   * The unique id of the function call. If populated, the client to execute the `function_call` and
-   * return the response with the matching `id`.
+   * Optional. The unique id of the function call. If populated, the client to execute the
+   * `function_call` and return the response with the matching `id`.
    */
   @JsonProperty("id")
   public abstract Optional<String> id();
@@ -88,7 +91,7 @@ private static Builder create() {
     /**
      * Setter for id.
      *
-     * <p>id: The unique id of the function call. If populated, the client to execute the
+     * <p>id: Optional. The unique id of the function call. If populated, the client to execute the
      * `function_call` and return the response with the matching `id`.
      */
     @JsonProperty("id")

src/main/java/com/google/genai/types/LatLng.java

@@ -27,12 +27,9 @@
 import java.util.Optional;
 
 /**
- * An object that represents a latitude/longitude pair.
- *
- * <p>This is expressed as a pair of doubles to represent degrees latitude and degrees longitude.
- * Unless specified otherwise, this object must conform to the <a
- * href="https://en.wikipedia.org/wiki/World_Geodetic_System#1984_version">WGS84 standard</a>.
- * Values must be within normalized ranges.
+ * An object that represents a latitude/longitude pair. This is expressed as a pair of doubles to
+ * represent degrees latitude and degrees longitude. Unless specified otherwise, this object must
+ * conform to the WGS84 standard. Values must be within normalized ranges.
  */
 @AutoValue
 @JsonDeserialize(builder = LatLng.Builder.class)
@@ -41,7 +38,7 @@ public abstract class LatLng extends JsonSerializable {
   @JsonProperty("latitude")
   public abstract Optional<Double> latitude();
 
-  /** The longitude in degrees. It must be in the range [-180.0, +180.0] */
+  /** The longitude in degrees. It must be in the range [-180.0, +180.0]. */
   @JsonProperty("longitude")
   public abstract Optional<Double> longitude();
 
@@ -84,7 +81,7 @@ public Builder clearLatitude() {
     /**
      * Setter for longitude.
      *
-     * <p>longitude: The longitude in degrees. It must be in the range [-180.0, +180.0]
+     * <p>longitude: The longitude in degrees. It must be in the range [-180.0, +180.0].
      */
     @JsonProperty("longitude")
     public abstract Builder longitude(Double longitude);

src/main/java/com/google/genai/types/RetrievalConfig.java

@@ -30,7 +30,7 @@
 @AutoValue
 @JsonDeserialize(builder = RetrievalConfig.Builder.class)
 public abstract class RetrievalConfig extends JsonSerializable {
-  /** Optional. The location of the user. */
+  /** The location of the user. */
   @JsonProperty("latLng")
   public abstract Optional<LatLng> latLng();
 
@@ -59,15 +59,15 @@ private static Builder create() {
     /**
      * Setter for latLng.
      *
-     * <p>latLng: Optional. The location of the user.
+     * <p>latLng: The location of the user.
      */
     @JsonProperty("latLng")
     public abstract Builder latLng(LatLng latLng);
 
     /**
      * Setter for latLng builder.
      *
-     * <p>latLng: Optional. The location of the user.
+     * <p>latLng: The location of the user.
      */
     @CanIgnoreReturnValue
     public Builder latLng(LatLng.Builder latLngBuilder) {

src/main/java/com/google/genai/types/ToolConfig.java

@@ -26,11 +26,7 @@
 import com.google.genai.JsonSerializable;
 import java.util.Optional;
 
-/**
- * Tool config.
- *
- * <p>This config is shared for all tools provided in the request.
- */
+/** Tool config. This config is shared for all tools provided in the request. */
 @AutoValue
 @JsonDeserialize(builder = ToolConfig.Builder.class)
 public abstract class ToolConfig extends JsonSerializable {
@@ -43,8 +39,9 @@ public abstract class ToolConfig extends JsonSerializable {
   public abstract Optional<FunctionCallingConfig> functionCallingConfig();
 
   /**
-   * If true, the API response will include the server-side tool calls and responses within the
-   * `Content` message. This allows clients to observe the server's tool invocations.
+   * Optional. If true, the API response will include the server-side tool calls and responses
+   * within the `Content` message. This allows clients to observe the server's tool interactions.
+   * This field is not supported in Vertex AI.
    */
   @JsonProperty("includeServerSideToolInvocations")
   public abstract Optional<Boolean> includeServerSideToolInvocations();
@@ -127,9 +124,9 @@ public Builder clearFunctionCallingConfig() {
     /**
      * Setter for includeServerSideToolInvocations.
      *
-     * <p>includeServerSideToolInvocations: If true, the API response will include the server-side
-     * tool calls and responses within the `Content` message. This allows clients to observe the
-     * server's tool invocations.
+     * <p>includeServerSideToolInvocations: Optional. If true, the API response will include the
+     * server-side tool calls and responses within the `Content` message. This allows clients to
+     * observe the server's tool interactions. This field is not supported in Vertex AI.
      */
     @JsonProperty("includeServerSideToolInvocations")
     public abstract Builder includeServerSideToolInvocations(