feat(wa-v2): add new turn event type

BREAKING CHANGE: conversationalSearch is now a required parameter when constructing SearchSettings

Add new llmMetadata property
Add new turn event TurnEventGenerativeAICalledCallout

Author: apaparazzi0329

assistant/src/main/java/com/ibm/watson/assistant/v2/model/ClientAction.java

@@ -15,6 +15,7 @@
 
 import com.google.gson.annotations.SerializedName;
 import com.ibm.cloud.sdk.core.service.model.GenericModel;
+import java.util.Map;
 
 /** ClientAction. */
 public class ClientAction extends GenericModel {
@@ -34,7 +35,7 @@ public interface Skill {
 
   protected String type;
   protected String skill;
-  protected ClientActionParameters parameters;
+  protected Map<String, Object> parameters;
 
   protected ClientAction() {}
 
@@ -52,6 +53,8 @@ public String getName() {
   /**
    * Gets the resultVariable.
    *
+   * <p>The name of the variable that the results are stored in.
+   *
    * @return the resultVariable
    */
   public String getResultVariable() {
@@ -61,6 +64,8 @@ public String getResultVariable() {
   /**
    * Gets the type.
    *
+   * <p>The type of turn event.
+   *
    * @return the type
    */
   public String getType() {
@@ -81,9 +86,11 @@ public String getSkill() {
   /**
    * Gets the parameters.
    *
+   * <p>An object containing arbitrary variables that are included in the turn event.
+   *
    * @return the parameters
    */
-  public ClientActionParameters getParameters() {
+  public Map<String, Object> getParameters() {
     return parameters;
   }
 }

assistant/src/main/java/com/ibm/watson/assistant/v2/model/FinalResponseOutput.java

@@ -1,5 +1,5 @@
 /*
- * (C) Copyright IBM Corp. 2024.
+ * (C) Copyright IBM Corp. 2024, 2025.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
@@ -32,6 +32,9 @@ public class FinalResponseOutput extends GenericModel {
 
   protected MessageOutputSpelling spelling;
 
+  @SerializedName("llm_metadata")
+  protected List<MessageOutputLLMMetadata> llmMetadata;
+
   @SerializedName("streaming_metadata")
   protected MessageStreamMetadata streamingMetadata;
 
@@ -116,6 +119,18 @@ public MessageOutputSpelling getSpelling() {
     return spelling;
   }
 
+  /**
+   * Gets the llmMetadata.
+   *
+   * <p>An array of objects that provide information about calls to large language models that
+   * occured as part of handling this message.
+   *
+   * @return the llmMetadata
+   */
+  public List<MessageOutputLLMMetadata> getLlmMetadata() {
+    return llmMetadata;
+  }
+
   /**
    * Gets the streamingMetadata.
    *

assistant/src/main/java/com/ibm/watson/assistant/v2/model/GenerativeAITask.java

@@ -0,0 +1,120 @@
+/*
+ * (C) Copyright IBM Corp. 2025.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
+ * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations under the License.
+ */
+
+package com.ibm.watson.assistant.v2.model;
+
+import com.google.gson.annotations.SerializedName;
+import com.ibm.cloud.sdk.core.service.model.GenericModel;
+
+/**
+ * GenerativeAITask.
+ *
+ * <p>Classes which extend this class: - GenerativeAITaskContentGroundedAnswering -
+ * GenerativeAITaskGeneralPurposeAnswering
+ */
+public class GenerativeAITask extends GenericModel {
+  @SuppressWarnings("unused")
+  protected static String discriminatorPropertyName = "task";
+
+  protected static java.util.Map<String, Class<?>> discriminatorMapping;
+
+  static {
+    discriminatorMapping = new java.util.HashMap<>();
+    discriminatorMapping.put(
+        "content_grounded_answering", GenerativeAITaskContentGroundedAnswering.class);
+    discriminatorMapping.put(
+        "general_purpose_answering", GenerativeAITaskGeneralPurposeAnswering.class);
+  }
+
+  protected String task;
+
+  @SerializedName("is_idk_response")
+  protected Boolean isIdkResponse;
+
+  @SerializedName("is_hap_detected")
+  protected Boolean isHapDetected;
+
+  @SerializedName("confidence_scores")
+  protected GenerativeAITaskConfidenceScores confidenceScores;
+
+  @SerializedName("original_response")
+  protected String originalResponse;
+
+  @SerializedName("inferred_query")
+  protected String inferredQuery;
+
+  protected GenerativeAITask() {}
+
+  /**
+   * Gets the task.
+   *
+   * <p>The type of generative ai task.
+   *
+   * @return the task
+   */
+  public String getTask() {
+    return task;
+  }
+
+  /**
+   * Gets the isIdkResponse.
+   *
+   * <p>Whether response was an idk response.
+   *
+   * @return the isIdkResponse
+   */
+  public Boolean isIsIdkResponse() {
+    return isIdkResponse;
+  }
+
+  /**
+   * Gets the isHapDetected.
+   *
+   * <p>Whether response was a hap response.
+   *
+   * @return the isHapDetected
+   */
+  public Boolean isIsHapDetected() {
+    return isHapDetected;
+  }
+
+  /**
+   * Gets the confidenceScores.
+   *
+   * <p>The confidence scores for determining whether to show the generated response or an “I don't
+   * know” response.
+   *
+   * @return the confidenceScores
+   */
+  public GenerativeAITaskConfidenceScores getConfidenceScores() {
+    return confidenceScores;
+  }
+
+  /**
+   * Gets the originalResponse.
+   *
+   * @return the originalResponse
+   */
+  public String getOriginalResponse() {
+    return originalResponse;
+  }
+
+  /**
+   * Gets the inferredQuery.
+   *
+   * @return the inferredQuery
+   */
+  public String getInferredQuery() {
+    return inferredQuery;
+  }
+}

assistant/src/main/java/com/ibm/watson/assistant/v2/model/GenerativeAITaskConfidenceScores.java

@@ -0,0 +1,74 @@
+/*
+ * (C) Copyright IBM Corp. 2025.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
+ * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations under the License.
+ */
+
+package com.ibm.watson.assistant.v2.model;
+
+import com.google.gson.annotations.SerializedName;
+import com.ibm.cloud.sdk.core.service.model.GenericModel;
+
+/**
+ * The confidence scores for determining whether to show the generated response or an “I don't know”
+ * response.
+ */
+public class GenerativeAITaskConfidenceScores extends GenericModel {
+
+  @SerializedName("pre_gen")
+  protected Double preGen;
+
+  @SerializedName("pre_gen_threshold")
+  protected Double preGenThreshold;
+
+  @SerializedName("post_gen")
+  protected Double postGen;
+
+  @SerializedName("post_gen_threshold")
+  protected Double postGenThreshold;
+
+  protected GenerativeAITaskConfidenceScores() {}
+
+  /**
+   * Gets the preGen.
+   *
+   * @return the preGen
+   */
+  public Double getPreGen() {
+    return preGen;
+  }
+
+  /**
+   * Gets the preGenThreshold.
+   *
+   * @return the preGenThreshold
+   */
+  public Double getPreGenThreshold() {
+    return preGenThreshold;
+  }
+
+  /**
+   * Gets the postGen.
+   *
+   * @return the postGen
+   */
+  public Double getPostGen() {
+    return postGen;
+  }
+
+  /**
+   * Gets the postGenThreshold.
+   *
+   * @return the postGenThreshold
+   */
+  public Double getPostGenThreshold() {
+    return postGenThreshold;
+  }
+}

assistant/src/main/java/com/ibm/watson/assistant/v2/model/GenerativeAITaskContentGroundedAnswering.java

@@ -0,0 +1,20 @@
+/*
+ * (C) Copyright IBM Corp. 2025.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
+ * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations under the License.
+ */
+
+package com.ibm.watson.assistant.v2.model;
+
+/** GenerativeAITaskContentGroundedAnswering. */
+public class GenerativeAITaskContentGroundedAnswering extends GenerativeAITask {
+
+  protected GenerativeAITaskContentGroundedAnswering() {}
+}

assistant/src/main/java/com/ibm/watson/assistant/v2/model/GenerativeAITaskGeneralPurposeAnswering.java

@@ -0,0 +1,20 @@
+/*
+ * (C) Copyright IBM Corp. 2025.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
+ * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations under the License.
+ */
+
+package com.ibm.watson.assistant.v2.model;
+
+/** GenerativeAITaskGeneralPurposeAnswering. */
+public class GenerativeAITaskGeneralPurposeAnswering extends GenerativeAITask {
+
+  protected GenerativeAITaskGeneralPurposeAnswering() {}
+}

assistant/src/main/java/com/ibm/watson/assistant/v2/model/LogResponseOutput.java

@@ -1,5 +1,5 @@
 /*
- * (C) Copyright IBM Corp. 2024.
+ * (C) Copyright IBM Corp. 2024, 2025.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
@@ -35,6 +35,9 @@ public class LogResponseOutput extends GenericModel {
 
   protected MessageOutputSpelling spelling;
 
+  @SerializedName("llm_metadata")
+  protected List<MessageOutputLLMMetadata> llmMetadata;
+
   protected LogResponseOutput() {}
 
   /**
@@ -115,4 +118,16 @@ public Map<String, Object> getUserDefined() {
   public MessageOutputSpelling getSpelling() {
     return spelling;
   }
+
+  /**
+   * Gets the llmMetadata.
+   *
+   * <p>An array of objects that provide information about calls to large language models that
+   * occured as part of handling this message.
+   *
+   * @return the llmMetadata
+   */
+  public List<MessageOutputLLMMetadata> getLlmMetadata() {
+    return llmMetadata;
+  }
 }

assistant/src/main/java/com/ibm/watson/assistant/v2/model/MessageOutput.java

@@ -1,5 +1,5 @@
 /*
- * (C) Copyright IBM Corp. 2018, 2024.
+ * (C) Copyright IBM Corp. 2018, 2025.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
@@ -32,6 +32,9 @@ public class MessageOutput extends GenericModel {
 
   protected MessageOutputSpelling spelling;
 
+  @SerializedName("llm_metadata")
+  protected List<MessageOutputLLMMetadata> llmMetadata;
+
   protected MessageOutput() {}
 
   /**
@@ -112,4 +115,16 @@ public Map<String, Object> getUserDefined() {
   public MessageOutputSpelling getSpelling() {
     return spelling;
   }
+
+  /**
+   * Gets the llmMetadata.
+   *
+   * <p>An array of objects that provide information about calls to large language models that
+   * occured as part of handling this message.
+   *
+   * @return the llmMetadata
+   */
+  public List<MessageOutputLLMMetadata> getLlmMetadata() {
+    return llmMetadata;
+  }
 }