Merging changes from main

Author: rpanackal

orchestration/src/main/java/com/sap/ai/sdk/orchestration/ConfigToRequestTransformer.java

@@ -3,6 +3,7 @@
 import com.sap.ai.sdk.orchestration.client.model.CompletionPostRequest;
 import com.sap.ai.sdk.orchestration.client.model.ModuleConfigs;
 import com.sap.ai.sdk.orchestration.client.model.OrchestrationConfig;
+import com.sap.ai.sdk.orchestration.client.model.Template;
 import com.sap.ai.sdk.orchestration.client.model.TemplatingModuleConfig;
 import io.vavr.control.Option;
 import java.util.ArrayList;
@@ -25,9 +26,9 @@ static CompletionPostRequest toCompletionPostRequest(
     // subsequent requests
     val configCopy = config.withTemplateConfig(template);
 
-    return CompletionPostRequest.create()
+    return new CompletionPostRequest()
         .orchestrationConfig(
-            OrchestrationConfig.create().moduleConfigurations(toModuleConfigs(configCopy)))
+            new OrchestrationConfig().moduleConfigurations(toModuleConfigs(configCopy)))
         .inputParams(prompt.getTemplateParameters())
         .messagesHistory(prompt.getMessagesHistory());
   }
@@ -42,14 +43,14 @@ static TemplatingModuleConfig toTemplateModuleConfig(
      * In this case, the request will fail, since the templating module will try to resolve the parameter.
      * To be fixed with https://github.tools.sap/AI/llm-orchestration/issues/662
      */
-    val messages = Option.of(template).map(TemplatingModuleConfig::getTemplate).getOrElse(List::of);
+    val messages = Option.of(template).map(t -> ((Template) t).getTemplate()).getOrElse(List::of);
     val messagesWithPrompt = new ArrayList<>(messages);
     messagesWithPrompt.addAll(prompt.getMessages());
     if (messagesWithPrompt.isEmpty()) {
       throw new IllegalStateException(
           "A prompt is required. Pass at least one message or configure a template with messages or a template reference.");
     }
-    return TemplatingModuleConfig.create().template(messagesWithPrompt);
+    return new Template().template(messagesWithPrompt);
   }
 
   @Nonnull
@@ -60,7 +61,7 @@ static ModuleConfigs toModuleConfigs(@Nonnull final OrchestrationModuleConfig co
 
     //noinspection DataFlowIssue the template is always non-null here
     val moduleConfig =
-        ModuleConfigs.create()
+        new ModuleConfigs()
             .llmModuleConfig(llmConfig)
             .templatingModuleConfig(config.getTemplateConfig());
 

orchestration/src/main/java/com/sap/ai/sdk/orchestration/GeneralizedFallbackDeserializer.java

@@ -6,15 +6,41 @@
 import com.fasterxml.jackson.databind.deser.std.StdDeserializer;
 import java.io.IOException;
 
+/**
+ * A deserializer that attempts to deserialize a JSON object into one of the subtypes of a base
+ * type.
+ *
+ * <p>This deserializer is useful when the exact subtype of an object is not known in advance, but
+ * the possible subtypes are known and annotated with {@link JsonSubTypes}.
+ *
+ * <p>When deserializing, this deserializer will attempt to deserialize the JSON object into each of
+ * the possible subtypes in turn. The first successful deserialization will be returned. If none of
+ * the deserializations are successful, a {@link JsonMappingException} will be thrown.
+ *
+ * @param <T> The base type to deserialize into.
+ */
 public class GeneralizedFallbackDeserializer<T> extends StdDeserializer<T> {
 
   private final Class<T> baseType;
 
+  /**
+   * Create a new deserializer for the given base type.
+   *
+   * @param baseClass The base type to deserialize into.
+   */
   public GeneralizedFallbackDeserializer(Class<T> baseClass) {
     super(baseClass);
     this.baseType = baseClass;
   }
 
+  /**
+   * Deserialize the JSON object into one of the subtypes of the base type.
+   *
+   * @param p The JSON parser.
+   * @param ctxt The deserialization context.
+   * @return The deserialized object.
+   * @throws IOException If an I/O error occurs.
+   */
   @Override
   public T deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
     ObjectMapper mapper = (ObjectMapper) p.getCodec();

orchestration/src/main/java/com/sap/ai/sdk/orchestration/LLMModuleResultDeserializer.java

@@ -8,12 +8,24 @@
 import com.sap.ai.sdk.orchestration.client.model.LLMModuleResultSynchronous;
 import java.io.IOException;
 
+/**
+ * A deserializer for {@link LLMModuleResult} that determines the concrete implementation based on
+ * the structure of the JSON object.
+ */
 public class LLMModuleResultDeserializer extends StdDeserializer<LLMModuleResult> {
 
   public LLMModuleResultDeserializer() {
     super(LLMModuleResult.class);
   }
 
+  /**
+   * Deserialize the JSON object into one of the subtypes of the base type.
+   *
+   * @param p The JSON parser.
+   * @param ctxt The deserialization context.
+   * @return The deserialized object.
+   * @throws IOException If an I/O error occurs.
+   */
   @Override
   public LLMModuleResult deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
 

orchestration/src/main/java/com/sap/ai/sdk/orchestration/OrchestrationPrompt.java

@@ -32,7 +32,7 @@ public class OrchestrationPrompt {
    * @param message A user message.
    */
   public OrchestrationPrompt(@Nonnull final String message) {
-    messages.add(ChatMessage.create().role("user").content(message));
+    messages.add(new ChatMessage().role("user").content(message));
   }
 
   /**

orchestration/src/main/java/com/sap/ai/sdk/orchestration/client/model/AzureContentSafety.java

@@ -26,7 +26,7 @@
 })
 @javax.annotation.Generated(
     value = "org.openapitools.codegen.languages.JavaClientCodegen",
-    date = "2024-11-08T17:17:51.177015+01:00[Europe/Berlin]",
+    date = "2024-11-08T18:02:22.585601+01:00[Europe/Berlin]",
     comments = "Generator version: 7.9.0")
 public class AzureContentSafety {
   public static final String JSON_PROPERTY_HATE = "Hate";

orchestration/src/main/java/com/sap/ai/sdk/orchestration/client/model/AzureContentSafetyFilterConfig.java

@@ -26,7 +26,7 @@
 })
 @javax.annotation.Generated(
     value = "org.openapitools.codegen.languages.JavaClientCodegen",
-    date = "2024-11-08T17:17:51.177015+01:00[Europe/Berlin]",
+    date = "2024-11-08T18:02:22.585601+01:00[Europe/Berlin]",
     comments = "Generator version: 7.9.0")
 public class AzureContentSafetyFilterConfig implements FilterConfig {
   /** String represents name of the filter provider */

orchestration/src/main/java/com/sap/ai/sdk/orchestration/client/model/ChatDelta.java

@@ -21,7 +21,7 @@
 @JsonPropertyOrder({ChatDelta.JSON_PROPERTY_ROLE, ChatDelta.JSON_PROPERTY_CONTENT})
 @javax.annotation.Generated(
     value = "org.openapitools.codegen.languages.JavaClientCodegen",
-    date = "2024-11-08T17:17:51.177015+01:00[Europe/Berlin]",
+    date = "2024-11-08T18:02:22.585601+01:00[Europe/Berlin]",
     comments = "Generator version: 7.9.0")
 public class ChatDelta {
   public static final String JSON_PROPERTY_ROLE = "role";

orchestration/src/main/java/com/sap/ai/sdk/orchestration/client/model/ChatMessage.java

@@ -21,7 +21,7 @@
 @JsonPropertyOrder({ChatMessage.JSON_PROPERTY_ROLE, ChatMessage.JSON_PROPERTY_CONTENT})
 @javax.annotation.Generated(
     value = "org.openapitools.codegen.languages.JavaClientCodegen",
-    date = "2024-11-08T17:17:51.177015+01:00[Europe/Berlin]",
+    date = "2024-11-08T18:02:22.585601+01:00[Europe/Berlin]",
     comments = "Generator version: 7.9.0")
 public class ChatMessage {
   public static final String JSON_PROPERTY_ROLE = "role";

orchestration/src/main/java/com/sap/ai/sdk/orchestration/client/model/CompletionPostRequest.java

@@ -29,7 +29,7 @@
 })
 @javax.annotation.Generated(
     value = "org.openapitools.codegen.languages.JavaClientCodegen",
-    date = "2024-11-08T17:17:51.177015+01:00[Europe/Berlin]",
+    date = "2024-11-08T18:02:22.585601+01:00[Europe/Berlin]",
     comments = "Generator version: 7.9.0")
 public class CompletionPostRequest {
   public static final String JSON_PROPERTY_ORCHESTRATION_CONFIG = "orchestration_config";

orchestration/src/main/java/com/sap/ai/sdk/orchestration/client/model/CompletionPostResponse.java

@@ -25,7 +25,7 @@
 })
 @javax.annotation.Generated(
     value = "org.openapitools.codegen.languages.JavaClientCodegen",
-    date = "2024-11-08T17:17:51.177015+01:00[Europe/Berlin]",
+    date = "2024-11-08T18:02:22.585601+01:00[Europe/Berlin]",
     comments = "Generator version: 7.9.0")
 public class CompletionPostResponse {
   public static final String JSON_PROPERTY_REQUEST_ID = "request_id";