Merge remote-tracking branch 'origin/chat-message-convenience' into chat-message-convenience

# Conflicts:
#	orchestration/src/main/java/com/sap/ai/sdk/orchestration/Message.java

Author: rpanackal

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

@@ -3,7 +3,7 @@
 import com.sap.ai.sdk.orchestration.client.model.ChatMessage;
 import javax.annotation.Nonnull;
 
-/** Represents a chat message to the orchestration service. */
+/** Interface representing convenience wrappers of chat message to the orchestration service. */
 public sealed interface Message permits UserMessage, AssistantMessage, SystemMessage {
 
   /**

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

@@ -30,6 +30,9 @@
 public class AzureContentSafety
 // CHECKSTYLE:ON
 {
+  @JsonAnySetter @JsonAnyGetter
+  private final Map<String, Object> cloudSdkCustomFields = new LinkedHashMap<>();
+
   @JsonProperty("Hate")
   private AzureThreshold hate;
 
@@ -42,12 +45,14 @@ public class AzureContentSafety
   @JsonProperty("Violence")
   private AzureThreshold violence;
 
-  @JsonAnySetter @JsonAnyGetter
-  private final Map<String, Object> cloudSdkCustomFields = new LinkedHashMap<>();
-
   /** Default constructor for AzureContentSafety. */
   protected AzureContentSafety() {}
 
+  /** Create a new {@link AzureContentSafety} instance. No arguments are required. */
+  public static AzureContentSafety create() {
+    return new AzureContentSafety();
+  }
+
   /**
    * Set the hate of this {@link AzureContentSafety} instance and return the same instance.
    *
@@ -256,9 +261,4 @@ private String toIndentedString(final java.lang.Object o) {
     }
     return o.toString().replace("\n", "\n    ");
   }
-
-  /** Create a new {@link AzureContentSafety} instance. No arguments are required. */
-  public static AzureContentSafety create() {
-    return new AzureContentSafety();
-  }
 }

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

@@ -32,72 +32,26 @@
 public class AzureContentSafetyFilterConfig implements FilterConfig
 // CHECKSTYLE:ON
 {
-  /** String represents name of the filter provider */
-  public enum TypeEnum {
-    /** The AZURE_CONTENT_SAFETY option of this AzureContentSafetyFilterConfig */
-    AZURE_CONTENT_SAFETY("azure_content_safety"),
-
-    /** The UNKNOWN_DEFAULT_OPEN_API option of this AzureContentSafetyFilterConfig */
-    UNKNOWN_DEFAULT_OPEN_API("unknown_default_open_api");
-
-    private String value;
-
-    TypeEnum(String value) {
-      this.value = value;
-    }
-
-    /**
-     * Get the value of the enum
-     *
-     * @return The enum value
-     */
-    @JsonValue
-    @Nonnull
-    public String getValue() {
-      return value;
-    }
-
-    /**
-     * Get the String value of the enum value.
-     *
-     * @return The enum value as String
-     */
-    @Override
-    @Nonnull
-    public String toString() {
-      return String.valueOf(value);
-    }
-
-    /**
-     * Get the enum value from a String value
-     *
-     * @param value The String value
-     * @return The enum value of type AzureContentSafetyFilterConfig
-     */
-    @JsonCreator
-    @Nonnull
-    public static TypeEnum fromValue(@Nonnull final String value) {
-      for (TypeEnum b : TypeEnum.values()) {
-        if (b.value.equals(value)) {
-          return b;
-        }
-      }
-      return UNKNOWN_DEFAULT_OPEN_API;
-    }
-  }
+  @JsonAnySetter @JsonAnyGetter
+  private final Map<String, Object> cloudSdkCustomFields = new LinkedHashMap<>();
 
   @JsonProperty("type")
   private TypeEnum type;
 
   @JsonProperty("config")
   private AzureContentSafety config;
 
-  @JsonAnySetter @JsonAnyGetter
-  private final Map<String, Object> cloudSdkCustomFields = new LinkedHashMap<>();
-
   /** Default constructor for AzureContentSafetyFilterConfig. */
   protected AzureContentSafetyFilterConfig() {}
 
+  /**
+   * Create a type-safe, fluent-api builder object to construct a new {@link
+   * AzureContentSafetyFilterConfig} instance with all required arguments.
+   */
+  public static Builder create() {
+    return (type) -> new AzureContentSafetyFilterConfig().type(type);
+  }
+
   /**
    * Set the type of this {@link AzureContentSafetyFilterConfig} instance and return the same
    * instance.
@@ -248,12 +202,58 @@ private String toIndentedString(final java.lang.Object o) {
     return o.toString().replace("\n", "\n    ");
   }
 
-  /**
-   * Create a type-safe, fluent-api builder object to construct a new {@link
-   * AzureContentSafetyFilterConfig} instance with all required arguments.
-   */
-  public static Builder create() {
-    return (type) -> new AzureContentSafetyFilterConfig().type(type);
+  /** String represents name of the filter provider */
+  public enum TypeEnum {
+    /** The AZURE_CONTENT_SAFETY option of this AzureContentSafetyFilterConfig */
+    AZURE_CONTENT_SAFETY("azure_content_safety"),
+
+    /** The UNKNOWN_DEFAULT_OPEN_API option of this AzureContentSafetyFilterConfig */
+    UNKNOWN_DEFAULT_OPEN_API("unknown_default_open_api");
+
+    private String value;
+
+    TypeEnum(String value) {
+      this.value = value;
+    }
+
+    /**
+     * Get the enum value from a String value
+     *
+     * @param value The String value
+     * @return The enum value of type AzureContentSafetyFilterConfig
+     */
+    @JsonCreator
+    @Nonnull
+    public static TypeEnum fromValue(@Nonnull final String value) {
+      for (TypeEnum b : TypeEnum.values()) {
+        if (b.value.equals(value)) {
+          return b;
+        }
+      }
+      return UNKNOWN_DEFAULT_OPEN_API;
+    }
+
+    /**
+     * Get the value of the enum
+     *
+     * @return The enum value
+     */
+    @JsonValue
+    @Nonnull
+    public String getValue() {
+      return value;
+    }
+
+    /**
+     * Get the String value of the enum value.
+     *
+     * @return The enum value as String
+     */
+    @Override
+    @Nonnull
+    public String toString() {
+      return String.valueOf(value);
+    }
   }
 
   /** Builder helper class. */

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

@@ -37,6 +37,22 @@ public enum AzureThreshold {
     this.value = value;
   }
 
+  /**
+   * Converts the given value to its enum representation.
+   *
+   * @param value The input value.
+   * @return The enum representation of the given value.
+   */
+  @JsonCreator
+  public static AzureThreshold fromValue(@Nonnull final Integer value) {
+    for (final AzureThreshold b : AzureThreshold.values()) {
+      if (b.value.equals(value)) {
+        return b;
+      }
+    }
+    return NUMBER_unknown_default_open_api;
+  }
+
   /**
    * @return The enum value.
    */
@@ -53,20 +69,4 @@ public Integer getValue() {
   public String toString() {
     return String.valueOf(value);
   }
-
-  /**
-   * Converts the given value to its enum representation.
-   *
-   * @param value The input value.
-   * @return The enum representation of the given value.
-   */
-  @JsonCreator
-  public static AzureThreshold fromValue(@Nonnull final Integer value) {
-    for (final AzureThreshold b : AzureThreshold.values()) {
-      if (b.value.equals(value)) {
-        return b;
-      }
-    }
-    return NUMBER_unknown_default_open_api;
-  }
 }

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

@@ -30,18 +30,26 @@
 public class ChatDelta
 // CHECKSTYLE:ON
 {
+  @JsonAnySetter @JsonAnyGetter
+  private final Map<String, Object> cloudSdkCustomFields = new LinkedHashMap<>();
+
   @JsonProperty("role")
   private String role;
 
   @JsonProperty("content")
   private String content = "";
 
-  @JsonAnySetter @JsonAnyGetter
-  private final Map<String, Object> cloudSdkCustomFields = new LinkedHashMap<>();
-
   /** Default constructor for ChatDelta. */
   protected ChatDelta() {}
 
+  /**
+   * Create a type-safe, fluent-api builder object to construct a new {@link ChatDelta} instance
+   * with all required arguments.
+   */
+  public static Builder create() {
+    return (content) -> new ChatDelta().content(content);
+  }
+
   /**
    * Set the role of this {@link ChatDelta} instance and return the same instance.
    *
@@ -185,14 +193,6 @@ private String toIndentedString(final java.lang.Object o) {
     return o.toString().replace("\n", "\n    ");
   }
 
-  /**
-   * Create a type-safe, fluent-api builder object to construct a new {@link ChatDelta} instance
-   * with all required arguments.
-   */
-  public static Builder create() {
-    return (content) -> new ChatDelta().content(content);
-  }
-
   /** Builder helper class. */
   public interface Builder {
     /**

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

@@ -30,18 +30,26 @@
 public class ChatMessage
 // CHECKSTYLE:ON
 {
+  @JsonAnySetter @JsonAnyGetter
+  private final Map<String, Object> cloudSdkCustomFields = new LinkedHashMap<>();
+
   @JsonProperty("role")
   private String role;
 
   @JsonProperty("content")
   private String content;
 
-  @JsonAnySetter @JsonAnyGetter
-  private final Map<String, Object> cloudSdkCustomFields = new LinkedHashMap<>();
-
   /** Default constructor for ChatMessage. */
   protected ChatMessage() {}
 
+  /**
+   * Create a type-safe, fluent-api builder object to construct a new {@link ChatMessage} instance
+   * with all required arguments.
+   */
+  public static Builder create() {
+    return (role) -> (content) -> new ChatMessage().role(role).content(content);
+  }
+
   /**
    * Set the role of this {@link ChatMessage} instance and return the same instance.
    *
@@ -185,14 +193,6 @@ private String toIndentedString(final java.lang.Object o) {
     return o.toString().replace("\n", "\n    ");
   }
 
-  /**
-   * Create a type-safe, fluent-api builder object to construct a new {@link ChatMessage} instance
-   * with all required arguments.
-   */
-  public static Builder create() {
-    return (role) -> (content) -> new ChatMessage().role(role).content(content);
-  }
-
   /** Builder helper class. */
   public interface Builder {
     /**

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

@@ -33,6 +33,9 @@
 public class CompletionPostRequest
 // CHECKSTYLE:ON
 {
+  @JsonAnySetter @JsonAnyGetter
+  private final Map<String, Object> cloudSdkCustomFields = new LinkedHashMap<>();
+
   @JsonProperty("orchestration_config")
   private OrchestrationConfig orchestrationConfig;
 
@@ -42,12 +45,18 @@ public class CompletionPostRequest
   @JsonProperty("messages_history")
   private List<ChatMessage> messagesHistory;
 
-  @JsonAnySetter @JsonAnyGetter
-  private final Map<String, Object> cloudSdkCustomFields = new LinkedHashMap<>();
-
   /** Default constructor for CompletionPostRequest. */
   protected CompletionPostRequest() {}
 
+  /**
+   * Create a type-safe, fluent-api builder object to construct a new {@link CompletionPostRequest}
+   * instance with all required arguments.
+   */
+  public static Builder create() {
+    return (orchestrationConfig) ->
+        new CompletionPostRequest().orchestrationConfig(orchestrationConfig);
+  }
+
   /**
    * Set the orchestrationConfig of this {@link CompletionPostRequest} instance and return the same
    * instance.
@@ -268,15 +277,6 @@ private String toIndentedString(final java.lang.Object o) {
     return o.toString().replace("\n", "\n    ");
   }
 
-  /**
-   * Create a type-safe, fluent-api builder object to construct a new {@link CompletionPostRequest}
-   * instance with all required arguments.
-   */
-  public static Builder create() {
-    return (orchestrationConfig) ->
-        new CompletionPostRequest().orchestrationConfig(orchestrationConfig);
-  }
-
   /** Builder helper class. */
   public interface Builder {
     /**