chore: Add java api reference examples.

PiperOrigin-RevId: 907772462

Author: MarkDaoust

pom.xml

@@ -58,6 +58,8 @@
     <kotlin.version>1.9.10</kotlin.version>
     <main.java.src.dir>src/main/java</main.java.src.dir>
     <test.java.src.dir>src/test/java</test.java.src.dir>
+    <maven.javadoc.skip>false</maven.javadoc.skip>
+    <dokka.phase>prepare-package</dokka.phase>
   </properties>
 
   <distributionManagement>
@@ -378,13 +380,36 @@
           </execution>
         </executions>
       </plugin>
+      <plugin>
+        <artifactId>maven-antrun-plugin</artifactId>
+        <version>3.1.0</version>
+        <executions>
+          <execution>
+            <id>dokka-warning</id>
+            <phase>initialize</phase>
+            <goals>
+              <goal>run</goal>
+            </goals>
+            <configuration>
+              <skip>${maven.javadoc.skip}</skip>
+              <target>
+                <echo>********************************************************************************</echo>
+                <echo>WARNING: Dokka Javadoc generation is active and may take a long time (~45 mins).</echo>
+                <echo>To skip it for faster local builds, use:</echo>
+                <echo>  mvn install -Ddokka.phase=none</echo>
+                <echo>********************************************************************************</echo>
+              </target>
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>
       <plugin>
         <groupId>org.jetbrains.dokka</groupId>
         <artifactId>dokka-maven-plugin</artifactId>
         <version>2.0.0</version>
         <executions>
           <execution>
-            <phase>prepare-package</phase>
+            <phase>${dokka.phase}</phase>
             <goals>
               <goal>javadoc</goal>
               <goal>javadocJar</goal>

src/main/java/com/google/genai/interactions/models/interactions/DeepResearchAgentConfig.kt

@@ -72,7 +72,7 @@ private constructor(
     /**
      * Enables human-in-the-loop planning for the Deep Research agent. If set to true, the Deep
      * Research agent will provide a research plan in its response. The agent will then proceed only
-     * if the user confirms the plan in the next turn. Relevant issue: b/482352502.
+     * if the user confirms the plan in the next turn. .
      *
      * @throws GeminiNextGenApiInvalidDataException if the JSON field has an unexpected type (e.g.
      *   if the server responded with an unexpected value).
@@ -179,7 +179,7 @@ private constructor(
         /**
          * Enables human-in-the-loop planning for the Deep Research agent. If set to true, the Deep
          * Research agent will provide a research plan in its response. The agent will then proceed
-         * only if the user confirms the plan in the next turn. Relevant issue: b/482352502.
+         * only if the user confirms the plan in the next turn. .
          */
         fun collaborativePlanning(collaborativePlanning: Boolean) =
             collaborativePlanning(JsonField.of(collaborativePlanning))