🏁 Script executed:

#!/bin/bash
# Description: Search for Android SDK response type usage patterns

echo "=== Checking for FinishReason enum usage ==="
rg -n "AndroidFinishReason\." --type=kotlin -g "**/*android*" -C1

echo -e "\n=== Checking for grounding chunk usage ==="
rg -n "GroundingChunk|GoogleMapsGroundingChunk" --type=kotlin -g "**/*android*" -C2

echo -e "\n=== Checking imports of Android SDK types ==="
rg -n "import.*firebase\.ai\.type\.(Candidate|FinishReason|GroundingChunk)" --type=kotlin -g "**/*android*"

Repository: uny/firebase-kotlin-sdk

Length of output: 6772

🌐 Web query:

Firebase Android AI SDK 34.13.0 finishMessage FinishReason IMAGE_SAFETY UNEXPECTED_TOOL_CALL GoogleMapsGroundingChunk

💡 Result:

In the Firebase Android AI SDK, FinishReason values such as IMAGE_SAFETY and UNEXPECTED_TOOL_CALL are part of recent updates designed to provide granular feedback when model generation stops [1][2][3]. These additions were implemented to better handle complex scenarios, particularly those involving image generation and tool-calling [1][2]. Key details regarding your query: - IMAGE_SAFETY: This FinishReason indicates that the model stopped generating content because it triggered safety filters specifically related to image generation (e.g., policy violations such as graphic violence or prohibited content) [1][2][3]. - UNEXPECTED_TOOL_CALL: This indicates that the model attempted to execute a tool call that was either not authorized, malformed, or contextually inappropriate based on the active tool definitions provided in the request [2][4][5]. This often occurs when a model is prompted to use a tool that is not currently enabled or available in the specific turn of the conversation [4]. - GoogleMapsGroundingChunk: This is a component of the model's groundingMetadata [6]. When enabled, it provides source information (chunks) used by the model to ground its response, such as data retrieved from Google Search or specific grounding services like Google Maps [6]. These FinishReason constants were added to the Firebase AI SDKs to allow developers to programmatically handle these specific stopping conditions, rather than treating them as generic errors or unexpected crashes [1][2]. If you encounter issues where these reasons cause crashes, it is often because the SDK's internal parsing logic requires an update to recognize the newer enum constants [5]. Ensure your project is using the latest version of the Firebase Android SDK to support these types [1][7].

Citations:

• 1: [AI] ImageConfig and FinishReasons firebase/firebase-android-sdk#8020
• 2: [AI] Finish Reasons firebase/firebase-ios-sdk#15931
• 3: https://firebase.google.com/docs/reference/js/ai
• 4: Gemini on Vertex UNEXPECTED_TOOL_CALL error [AI SDK 5] vercel/ai#8450
• 5: [firebase_ai]: Unhandled UNEXPECTED_TOOL_CALL FinishReason crashes response parsing firebase/flutterfire#18181
• 6: https://firebase.blog/posts/2025/07/grounding-google-search-ai-logic/
• 7: [AI] Add tool-use support for Template AI models firebase/firebase-android-sdk#8004

🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "=== Extract relevant portions of GenerateContentResponse.android.kt ==="
FILE="firebase-ai/src/androidMain/kotlin/dev/ynagai/firebase/ai/GenerateContentResponse.android.kt"
nl -ba "$FILE" | sed -n '1,120p'
echo "----"
nl -ba "$FILE" | sed -n '120,220p'
echo "----"

echo "=== Find where Firebase BOM / AI SDK version is pinned (look for 34.13.0) ==="
rg -n "34\.13\.0|firebase-bom|firebase-bom\.|platform\(.*firebase-bom|com\.google\.firebase:firebase-bom|firebase-ai" -S . || true

echo "=== List Gradle files mentioning firebase-bom ==="
fd -e "gradle" -e "gradle.kts" -e "kts" -e "toml" -e "build.gradle" . 2>/dev/null | head -n 50 || true
rg -n "firebase-bom" -S . --glob='*.gradle*' --glob='*.kts' || true

Repository: uny/firebase-kotlin-sdk

Length of output: 200

🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "=== Extract relevant portions of GenerateContentResponse.android.kt ==="
FILE="firebase-ai/src/androidMain/kotlin/dev/ynagai/firebase/ai/GenerateContentResponse.android.kt"
nl -ba "$FILE" | sed -n '1,120p'
echo "----"
nl -ba "$FILE" | sed -n '120,220p'
echo "----"

echo "=== Find where Firebase BOM / AI SDK version is pinned (look for 34.13.0) ==="
rg -n "34\.13\.0|firebase-bom|firebase-bom\.|platform\(.*firebase-bom|com\.google\.firebase:firebase-bom|firebase-ai" -S . || true

echo "=== List Gradle files mentioning firebase-bom ==="
fd -e "gradle" -e "gradle.kts" -e "kts" -e "toml" -e "build.gradle" . 2>/dev/null | head -n 50 || true
rg -n "firebase-bom" -S . --glob='*.gradle*' --glob='*.kts' || true

Repository: uny/firebase-kotlin-sdk

Length of output: 200

🏁 Script executed:

#!/bin/bash
set -euo pipefail

FILE="firebase-ai/src/androidMain/kotlin/dev/ynagai/firebase/ai/GenerateContentResponse.android.kt"

echo "=== Extract relevant portions of GenerateContentResponse.android.kt ==="
echo "--- lines 1-120 ---"
cat -n "$FILE" | sed -n '1,120p'
echo "----"
echo "--- lines 120-240 ---"
cat -n "$FILE" | sed -n '120,240p'

echo "=== Find where Firebase BOM / AI SDK version is pinned (look for 34.13.0) ==="
rg -n "34\.13\.0|firebase-bom|com\.google\.firebase:firebase-bom|firebase-ai|com\.google\.firebase:firebase-ai|firebase-ai:" -S . --hidden || true

echo "=== Search gradle/version catalogs for firebase-bom ==="
rg -n "firebase-bom" -S . --glob='*.gradle*' --glob='*.kts' --hidden || true
rg -n "34\.13\.0" -S . --glob='*.gradle*' --glob='*.kts' --glob='*libs*' --hidden || true

Repository: uny/firebase-kotlin-sdk

Length of output: 12480

🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "=== Search for finishMessage usage in firebase-ai android code ==="
rg -n "finishMessage" firebase-ai/src/androidMain -S --glob='*.kt' || true

echo "=== Search for GroundingChunk.maps / GoogleMapsGroundingChunk usage in firebase-ai android code ==="
rg -n "GroundingChunk|GoogleMapsGroundingChunk|\.maps\b" firebase-ai/src/androidMain -S --glob='*.kt' || true

Repository: uny/firebase-kotlin-sdk

Length of output: 1175

🌐 Web query:

com.google.firebase.ai.type.FinishReason IMAGE_SAFETY 34.13.0

💡 Result:

In the Firebase AI SDK, com.google.firebase.ai.type.FinishReason.IMAGE_SAFETY is an enumeration value indicating that the model stopped generating content because the generated image triggered a safety violation [1][2][3]. This reason was introduced as part of an expansion to the FinishReason enum to better support image generation features and complex tool-calling scenarios [1][2]. It is specifically used within the context of the Firebase AI SDK (often associated with BoM version 34.13.0 for Android) when using image generation models, such as the Imagen series [1][4][5]. Key details regarding this finish reason include: - Purpose: It signals that the content generation was halted due to safety filters detecting prohibited or sensitive material within a generated image [2][3]. - SDK Context: It is part of the com.google.firebase.ai.type package [6][7]. The addition was bundled with updates that also introduced support for ImageConfig (including parameters for aspect ratio and size) and several other FinishReason types such as IMAGE_PROHIBITED_CONTENT, IMAGE_OTHER, NO_IMAGE, and IMAGE_RECITATION [1][2][3]. - Usage: When a request to an image generation model is blocked by these safety policies, the SDK returns this IMAGE_SAFETY value to allow developers to handle the failure programmatically [2]. If you are encountering this error, it indicates that the model's output safety guardrails (configured via ImagenSafetySettings) intervened to prevent the rendering of content deemed harmful or inappropriate [8][3][4].

Citations:

• 1: [AI] ImageConfig and FinishReasons firebase/firebase-android-sdk#8020
• 2: [AI] Finish Reasons firebase/firebase-ios-sdk#15931
• 3: firebase/firebase-js-sdk@39f937e
• 4: https://developer.android.com/ai/imagen
• 5: https://firebase.google.com/support/release-notes/android
• 6: https://firebase-dot-google-developers.gonglchuangl.net/docs/reference/android/com/google/firebase/ai/type/FinishReason
• 7: https://firebase.google.com/docs/reference/kotlin/com/google/firebase/ai/type/FinishReason
• 8: https://firebase.google.com/docs/ai-logic/safety-settings

🌐 Web query:

com.google.firebase.ai.type.Candidate finishMessage GoogleMapsGroundingChunk GroundingChunk maps uri title placeId

💡 Result:

The GoogleMapsGroundingChunk is a data structure introduced in the Firebase AI SDKs (such as for Android, iOS, Unity, and Web) to represent grounding metadata retrieved from Google Maps [1][2][3][4][5]. It is typically used within the context of a candidate message response when the model employs Google Maps as a grounding tool [1][3]. The chunk provides specific details about a location referenced by the AI model [2][3]. The structure contains three primary properties [2][3]: - uri (String?): The URI of the place [2][3]. - title (String?): The title of the place [2][3]. - placeId (String?): The resource name of the place, formatted as places/{place_id}, which can be used to perform lookups via the Google Maps API [2][4]. As of May 2026, Maps Grounding is part of the broader capabilities of Firebase AI Logic, enabling developers to integrate Google Maps data into AI-generated responses [1][6]. Depending on the platform (e.g., iOS), the implementation may map backend fields differently—for example, mapping the backend uri field to a url property in the Swift SDK [3].

Citations:

• 1: Implement Maps Grounding firebase/firebase-android-sdk#7950
• 2: https://firebase.google.com/docs/reference/kotlin/com/google/firebase/ai/type/GoogleMapsGroundingChunk
• 3: firebase/firebase-ios-sdk@26bffc8
• 4: https://firebase.google.com/docs/reference/unity/struct/firebase/a-i/google-maps-grounding-chunk
• 5: https://firebase.google.com/docs/reference/js/ai.googlemapsgroundingchunk
• 6: https://firebase.google.com/docs/ai-logic

🌐 Web query:

com.google.firebase.ai.type.Candidate finishMessage kotlin

💡 Result:

In the Firebase Android SDK, the com.google.firebase.ai.type.Candidate class represents a single response generated by a model [1][2]. While this class contains a finishReason property [1][3], it does not include a finishMessage property. The finishReason property is of type FinishReason (an enum or class representing why generation stopped, such as reaching a limit or being blocked) [1][3]. If you are looking for additional descriptive information regarding why a generation process concluded—especially in the context of error handling or blocking—this information is typically managed via exceptions or response metadata outside of the Candidate class structure [4]. For comparison, while some other SDKs or libraries (such as Genkit's JavaScript implementation) explicitly include a finishMessage property to provide further details on the model's termination [4], the current Firebase Android SDK for Gemini/AI Logic relies on the finishReason for this purpose [1][3].

Citations:

• 1: https://firebase.google.cn/docs/reference/kotlin/com/google/firebase/ai/type/Candidate
• 2: https://firebase.google.com/docs/reference/android/com/google/firebase/ai/type/package-summary
• 3: https://firebase-dot-google-developers.gonglchuangl.net/docs/reference/android/com/google/firebase/ai/type/Candidate
• 4: https://app.unpkg.com/@genkit-ai/ai@1.2.0/files/lib/generate/response.mjs

🌐 Web query:

com.google.firebase.ai.type.GroundingChunk maps kotlin

💡 Result:

In Firebase AI Logic (Android Kotlin), com.google.firebase.ai.type.GroundingChunk is a Kotlin class that represents “a chunk of retrieved data that supports a claim in the model's response.” It has a single Kotlin property web: WebGroundingChunk? indicating whether the grounding chunk came from a web source, and it is constructed as GroundingChunk(web: WebGroundingChunk?). [1] How it “maps” in Kotlin (what to read / access) - Type: GroundingChunk (class) [1] - Constructor: GroundingChunk(web: WebGroundingChunk?) [1] - Property: val web: WebGroundingChunk? [1] If you specifically mean “maps grounding” (Google Maps tool), that is represented by a different type: com.google.firebase.ai.type.GoogleMapsGroundingChunk. It has properties uri, title, and placeId (each nullable String?). [2] The GroundingChunk itself is still the wrapper for the retrieved chunk; the maps-specific fields surface via the Grounding metadata as maps/chunk types (e.g., chunk.maps?.title/uri/placeId in the docs example). [3] Example usage pattern from the Firebase docs (reading grounding chunks) - Get grounding metadata from the first candidate’s groundingMetadata, then read groundingChunks, and for each chunk read the source fields (e.g., chunk.maps?.title/uri/placeId for Maps grounding). [3] So the Kotlin mapping is: - GroundingChunk (wrapper) -> web: WebGroundingChunk? (web source details) [1] - Maps source details come through GoogleMapsGroundingChunk fields when using Grounding with Google Maps (uri/title/placeId). [2][3]

Citations:

• 1: https://firebase.google.cn/docs/reference/kotlin/com/google/firebase/ai/type/GroundingChunk
• 2: https://firebase.google.com/docs/reference/kotlin/com/google/firebase/ai/type/GoogleMapsGroundingChunk
• 3: https://firebase.google.com/docs/ai-logic/grounding-google-maps

🌐 Web query:

com.google.firebase.ai.type.GoogleMapsGroundingChunk uri title placeId kotlin

💡 Result:

GoogleMapsGroundingChunk (Firebase AI Logic / Maps grounding) in Kotlin has the properties uri, title, and placeId (all nullable Strings in the Kotlin reference). [1] - uri: The URI of the place. [1] - title: The title of the place. [1] - placeId: This Place’s resource name in the form places/{place_id}. This can be used to look up the place using the Google Maps API. [1] In the Kotlin API reference, the primary constructor is: GoogleMapsGroundingChunk(uri: String?, title: String?, placeId: String?) [1] Example usage note (from the Firebase “Grounding google maps” page): the model response includes groundingChunks entries containing maps fields uri, title, and placeId (placeId is shown like places/ChIJ...). [2]

Citations:

• 1: https://firebase.google.com/docs/reference/kotlin/com/google/firebase/ai/type/GoogleMapsGroundingChunk
• 2: https://firebase.google.com/docs/ai-logic/grounding-google-maps

🏁 Script executed:

#!/bin/bash
set -euo pipefail
rg -n "finishMessage" -S . --glob='*.kt' --glob='*.kts' --glob='*.md' || true

Repository: uny/firebase-kotlin-sdk

Length of output: 459

🌐 Web query:

"finishMessage" "com.google.firebase.ai.type.Candidate" kotlin property

💡 Result:

The property finishMessage is not present in the com.google.firebase.ai.type.Candidate class within the Firebase Android SDK [1][2]. While a finishMessage property exists in the Candidate class for the Firebase AI Dart/Flutter SDK [3], the corresponding Kotlin class in the Firebase Android SDK (com.google.firebase.ai.type.Candidate) provides a finishReason property [1] (of type FinishReason? [1]), but does not define a finishMessage property [1]. The Firebase Android SDK release notes for version 17.12.0 mention the addition of support for finishMessage [4], however, technical documentation and class definitions for the current Firebase AI Logic (firebase-ai) SDK indicate that the Kotlin class Candidate primarily exposes finishReason, content, and various metadata properties like citationMetadata and groundingMetadata [1]. If you are encountering a reference to finishMessage in a Kotlin context, it may be a naming confusion with the Dart SDK [3], a very recent addition not yet reflected in standard public API reference documentation, or a misunderstanding of the API structure [1].

Citations:

• 1: https://firebase.google.cn/docs/reference/kotlin/com/google/firebase/ai/type/Candidate
• 2: https://firebase.google.cn/docs/reference/android/com/google/firebase/ai/type/package-summary
• 3: https://pub.dev/documentation/firebase_ai/latest/firebase_ai/Candidate-class.html
• 4: https://firebase.google.com/support/release-notes/android

🌐 Web query:

"val maps" "com.google.firebase.ai.type.GroundingChunk" kotlin

💡 Result:

In Firebase (Kotlin), GroundingChunk is a class that represents a chunk of retrieved data supporting a claim in the model response; it has a nullable web property: val web: WebGroundingChunk?. [1] For “val maps”: in the official Kotlin reference page returned for GroundingChunk, I only see val web and no val maps property. [1] In contrast, the JavaScript reference for GroundingChunk explicitly documents a maps?: GoogleMapsGroundingChunk property. [2] So for your specific query (“val maps” + “com.google.firebase.ai.type.GroundingChunk” + Kotlin): the authoritative Kotlin reference I found does not list a val maps property on GroundingChunk—only val web is shown. [1] If you’re seeing a maps field in your code, it may be from a different SDK language/version (e.g., JS) or a newer/alternate API surface than the page I located. [2]

Citations:

• 1: https://firebase.google.cn/docs/reference/kotlin/com/google/firebase/ai/type/GroundingChunk
• 2: https://firebase.google.cn/docs/reference/js/ai.groundingchunk

🌐 Web query:

"GroundingChunk" "maps" site:firebase.google.com/docs/reference/kotlin/com/google/firebase/ai/type

💡 Result:

The GoogleMapsGroundingChunk is a data structure used in the Firebase SDKs (specifically for Android) to represent grounding information derived from Google Maps [1]. It is part of the framework's AI type system for handling model responses that include grounded entities [1][2]. This class provides three primary pieces of information regarding a location: - placeId: The resource name of the place in a places/{place_id} format, which can be used for further lookups via the Google Maps API [1]. - title: The name or title of the place [1]. - uri: A URI link associated with the place [1]. Essentially, when an AI model provides a response grounded in real-world data, the GoogleMapsGroundingChunk serves as the object that encapsulates map-specific location details, allowing developers to programmatically access and display location data linked to the model's output [1].

Citations:

• 1: https://firebase.google.com/docs/reference/kotlin/com/google/firebase/ai/type/GoogleMapsGroundingChunk
• 2: https://firebase.google.com/docs/reference/kotlin/com/google/firebase/ai/type/ImageConfig.Builder

🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "=== GenerateContentResponse.kt (common) around Candidate.finishMessage ==="
FILE="firebase-ai/src/commonMain/kotlin/dev/ynagai/firebase/ai/GenerateContentResponse.kt"
cat -n "$FILE" | sed -n '1,120p'

echo "=== GenerateContentResponse.apple.kt (apple) around finishMessage mapping ==="
FILE="firebase-ai/src/appleMain/kotlin/dev/ynagai/firebase/ai/GenerateContentResponse.apple.kt"
cat -n "$FILE" | sed -n '1,120p'

Repository: uny/firebase-kotlin-sdk

Length of output: 12229

🌐 Web query:

site:firebase.google.com/docs/reference/kotlin/com/google/firebase/ai/type/Candidate finishMessage

💡 Result:

In the Firebase Android (Kotlin) SDK, com.google.firebase.ai.type.Candidate does not have a finishMessage property—its stop information is exposed via finishReason: FinishReason? (plus properties like content, citationMetadata, safetyRatings, etc.). (firebase.google.com)

finishMessage?: string exists in the Firebase JavaScript API type GenerateContentCandidate, but it’s not part of the Kotlin Candidate reference you linked. (firebase.google.com)

Citations:

• 1: https://firebase.google.com/docs/reference/kotlin/com/google/firebase/ai/type/Candidate
• 2: https://firebase.google.com/docs/reference/js/vertexai.generatecontentcandidate

🌐 Web query:

site:firebase.google.com/docs/reference/kotlin/com/google/firebase/ai/type/GroundingChunk maps

💡 Result:

In the Firebase Android Kotlin reference for com.google.firebase.ai.type.GroundingChunk, maps is a nullable property:

• val maps: GoogleMapsGroundingChunk?
• It “contains details if the grounding chunk is from a Google Maps source.” [1]

Constructor: GroundingChunk(web: WebGroundingChunk? = null, maps: GoogleMapsGroundingChunk? = null) [1]

Source(s):
[1] (firebase.google.com)

Citations:

• 1: https://firebase.google.com/docs/reference/kotlin/com/google/firebase/ai/type/GroundingChunk

🌐 Web query:

site:firebase.google.cn/docs/reference/kotlin/com/google/firebase/ai/type/Candidate finishMessage

💡 Result:

In the Firebase AI Kotlin reference, com.google.firebase.ai.type.Candidate does not have a finishMessage property—it exposes finishReason (plus content, safetyRatings, etc.) instead. [1]

finishMessage exists in other Firebase AI surfaces (for example the JavaScript GenerateContentCandidate.finishMessage and the REST GenerateContentResponse schema), but it’s not part of the Kotlin Candidate API. [2][3]

🌐 Web query:

site:firebase.google.cn/docs/reference/kotlin/com/google/firebase/ai/type/GroundingChunk maps

💡 Result:

In the Firebase Android Kotlin API reference, com.google.firebase.ai.type.GroundingChunk includes a maps field:

• Constructor: GroundingChunk(web: WebGroundingChunk? = null, maps: GoogleMapsGroundingChunk? = null)
• Property: val maps: GoogleMapsGroundingChunk? — “Contains details if the grounding chunk is from a Google Maps source.”
  It also has val web: WebGroundingChunk? for web-based grounding. [1]

Sources
[1] (firebase.google.com)

Citations:

• 1: https://firebase.google.com/docs/reference/kotlin/com/google/firebase/ai/type/GroundingChunk

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.