Address several issues from the review

- update api.txt
- bump version
- Add missing kdoc

A note about api.txt and version. While this change is technically
removing two methods, those are constructors of classes returned by
the server, which shouldn't be instantiated by clients.

In an upcoming breaking release we should moved them to be hidden
using the `internal` visibility.

Author: rlazo

firebase-vertexai/api.txt

@@ -165,12 +165,30 @@ package com.google.firebase.vertexai.type {
     method public static com.google.firebase.vertexai.type.Content content(String? role = "user", kotlin.jvm.functions.Function1<? super com.google.firebase.vertexai.type.Content.Builder,kotlin.Unit> init);
   }
 
+  public final class ContentModality {
+    method public int getOrdinal();
+    property public final int ordinal;
+    field public static final com.google.firebase.vertexai.type.ContentModality AUDIO;
+    field public static final com.google.firebase.vertexai.type.ContentModality.Companion Companion;
+    field public static final com.google.firebase.vertexai.type.ContentModality DOCUMENT;
+    field public static final com.google.firebase.vertexai.type.ContentModality IMAGE;
+    field public static final com.google.firebase.vertexai.type.ContentModality TEXT;
+    field public static final com.google.firebase.vertexai.type.ContentModality UNSPECIFIED;
+    field public static final com.google.firebase.vertexai.type.ContentModality VIDEO;
+  }
+
+  public static final class ContentModality.Companion {
+  }
+
   public final class CountTokensResponse {
-    ctor public CountTokensResponse(int totalTokens, Integer? totalBillableCharacters = null);
+    ctor public CountTokensResponse(int totalTokens, Integer? totalBillableCharacters = null, java.util.List<com.google.firebase.vertexai.type.ModalityTokenCount>? promptTokensDetails = null);
     method public operator int component1();
     method public operator Integer? component2();
+    method public operator java.util.List<com.google.firebase.vertexai.type.ModalityTokenCount>? component3();
+    method public java.util.List<com.google.firebase.vertexai.type.ModalityTokenCount>? getPromptTokensDetails();
     method public Integer? getTotalBillableCharacters();
     method public int getTotalTokens();
+    property public final java.util.List<com.google.firebase.vertexai.type.ModalityTokenCount>? promptTokensDetails;
     property public final Integer? totalBillableCharacters;
     property public final int totalTokens;
   }
@@ -369,6 +387,15 @@ package com.google.firebase.vertexai.type {
   public final class InvalidStateException extends com.google.firebase.vertexai.type.FirebaseVertexAIException {
   }
 
+  public final class ModalityTokenCount {
+    method public operator com.google.firebase.vertexai.type.ContentModality component1();
+    method public operator int component2();
+    method public com.google.firebase.vertexai.type.ContentModality getModality();
+    method public int getTokenCount();
+    property public final com.google.firebase.vertexai.type.ContentModality modality;
+    property public final int tokenCount;
+  }
+
   public interface Part {
   }
 
@@ -549,12 +576,16 @@ package com.google.firebase.vertexai.type {
   }
 
   public final class UsageMetadata {
-    ctor public UsageMetadata(int promptTokenCount, Integer? candidatesTokenCount, int totalTokenCount);
+    ctor public UsageMetadata(int promptTokenCount, Integer? candidatesTokenCount, int totalTokenCount, java.util.List<com.google.firebase.vertexai.type.ModalityTokenCount>? promptTokensDetails, java.util.List<com.google.firebase.vertexai.type.ModalityTokenCount>? candidatesTokensDetails);
     method public Integer? getCandidatesTokenCount();
+    method public java.util.List<com.google.firebase.vertexai.type.ModalityTokenCount>? getCandidatesTokensDetails();
     method public int getPromptTokenCount();
+    method public java.util.List<com.google.firebase.vertexai.type.ModalityTokenCount>? getPromptTokensDetails();
     method public int getTotalTokenCount();
     property public final Integer? candidatesTokenCount;
+    property public final java.util.List<com.google.firebase.vertexai.type.ModalityTokenCount>? candidatesTokensDetails;
     property public final int promptTokenCount;
+    property public final java.util.List<com.google.firebase.vertexai.type.ModalityTokenCount>? promptTokensDetails;
     property public final int totalTokenCount;
   }
 

firebase-vertexai/gradle.properties

@@ -12,5 +12,5 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-version=16.1.1
+version=16.2.0
 latestReleasedVersion=16.1.0

firebase-vertexai/src/main/kotlin/com/google/firebase/vertexai/type/ContentModality.kt

@@ -21,6 +21,7 @@ import kotlinx.serialization.KSerializer
 import kotlinx.serialization.SerialName
 import kotlinx.serialization.Serializable
 
+/** Content part modality.*/
 public class ContentModality private constructor(public val ordinal: Int) {
 
   @Serializable(Internal.Serializer::class)
@@ -46,6 +47,7 @@ public class ContentModality private constructor(public val ordinal: Int) {
   }
 
   public companion object {
+    /** Unspecified modality. */
     @JvmField public val UNSPECIFIED: ContentModality = ContentModality(0)
 
     /** Plain text. */

firebase-vertexai/src/main/kotlin/com/google/firebase/vertexai/type/CountTokensResponse.kt

@@ -30,7 +30,7 @@ import kotlinx.serialization.Serializable
  * to the model as a prompt. **Important:** this property does not include billable image, video or
  * other non-text input. See
  * [Vertex AI pricing](https://cloud.google.com/vertex-ai/generative-ai/pricing) for details.
- * @property promptTokenDetails The breakdown, by modality, of how many tokens are consumed by the
+ * @property promptTokensDetails The breakdown, by modality, of how many tokens are consumed by the
  * prompt.
  */
 public class CountTokensResponse(

firebase-vertexai/src/main/kotlin/com/google/firebase/vertexai/type/UsageMetadata.kt

@@ -26,8 +26,6 @@ import kotlinx.serialization.Serializable
  * @param totalTokenCount Total number of tokens.
  * @param promptTokensDetails The breakdown, by modality, of how many tokens are consumed by the
  * prompt.
- * @param cacheTokensDetails The breakdown, by modality, of how many tokens are consumed by the
- * cache.
  * @param candidatesTokensDetails The breakdown, by modality, of how many tokens are consumed by the
  * candidates.
  */