Merge remote-tracking branch 'origin/main' into generated-openai

# Conflicts:
#	foundation-models/openai/src/test/java/com/sap/ai/sdk/foundationmodels/openai/OpenAiClientTest.java

Author: a-d

.github/workflows/deploy-snapshot.yaml

@@ -37,3 +37,14 @@ jobs:
         env:
           DEPLOYMENT_USER: ${{ secrets.ARTIFACTORY_COMMON_USER }}
           DEPLOYMENT_PASS: ${{ secrets.ARTIFACTORY_COMMON_PASSWORD }}
+
+      - name: "Slack Notification"
+        if: failure()
+        uses: slackapi/[email protected]
+        with:
+          webhook: ${{ secrets.SLACK_WEBHOOK }}
+          webhook-type: incoming-webhook
+          payload: |
+            {
+              "text": "⚠️ Snapshot Deployment failed! 😬 Please inspect & fix by clicking <https://github.com/SAP/ai-sdk-java/actions/runs/${{ github.run_id }}|here>"
+            }

README.md

@@ -21,6 +21,7 @@ The SDK simplifies the setup and interaction with SAP AI Core, allowing you to f
     - [Run the Application Locally](#run-the-application-locally)
     - [Explore Further Capabilities](#explore-further-capabilities)
 - [Documentation](#documentation)
+- [Build the Project](#build-the-project)
 - [FAQs](#faqs)
 - [Contribute, Support and Feedback](#contribute-support-and-feedback)
 - [Security / Disclosure](#security--disclosure)
@@ -137,6 +138,18 @@ For more detailed information and advanced usage, please refer to the following:
 
 For updating versions, please refer to the [**Release Notes**](docs/release-notes/release-notes-0-to-14.md).
 
+## Build the Project
+
+You can build the project using Maven:
+
+```shell
+mvn clean install -DskipTests
+```
+
+This will install the current `SNAPSHOT` version of the project into your local Maven repository.
+
+For SAP internal development, you can also use `SNAPSHOT` builds from the [internal](https://int.repositories.cloud.sap/ui/repos/tree/General/proxy-build-snapshots-cloudsdk/com/sap/ai/sdk) and [internet-facing](https://common.repositories.cloud.sap/artifactory/build-snapshots-cloudsdk/com/sap/ai/sdk/) Artifactory.
+
 ## FAQs
 
 ### _"How to add a custom header to AI Core requests?"_

core/pom.xml

@@ -167,7 +167,7 @@
             <artifactId>openapi-generator-maven-plugin</artifactId>
             <configuration>
               <outputDirectory>${project.basedir}/src/main/java</outputDirectory>
-              <apiMaturity>released</apiMaturity>
+              <apiMaturity>beta</apiMaturity>
               <enableOneOfAnyOfGeneration>true</enableOneOfAnyOfGeneration>
               <compileScope>COMPILE</compileScope>
               <deleteOutputDirectory>true</deleteOutputDirectory>

core/src/main/java/com/sap/ai/sdk/core/client/ApplicationApi.java

@@ -1,5 +1,6 @@
 package com.sap.ai.sdk.core.client;
 
+import com.google.common.annotations.Beta;
 import com.sap.ai.sdk.core.AiCoreService;
 import com.sap.ai.sdk.core.model.BckndAllArgoCDApplicationData;
 import com.sap.ai.sdk.core.model.BckndArgoCDApplicationBaseData;
@@ -35,6 +36,7 @@
  * your AI content from your own git repository, and register your own object store for training
  * data and trained models.
  */
+@Beta
 public class ApplicationApi extends AbstractOpenApiService {
 
   /** Instantiates this API class to invoke operations on the AI Core */

core/src/main/java/com/sap/ai/sdk/core/client/ArtifactApi.java

@@ -1,5 +1,6 @@
 package com.sap.ai.sdk.core.client;
 
+import com.google.common.annotations.Beta;
 import com.sap.ai.sdk.core.AiCoreService;
 import com.sap.ai.sdk.core.model.AiArtifact;
 import com.sap.ai.sdk.core.model.AiArtifactCreationResponse;
@@ -32,6 +33,7 @@
  * your AI content from your own git repository, and register your own object store for training
  * data and trained models.
  */
+@Beta
 public class ArtifactApi extends AbstractOpenApiService {
 
   /** Instantiates this API class to invoke operations on the AI Core */

core/src/main/java/com/sap/ai/sdk/core/client/ConfigurationApi.java

@@ -1,5 +1,6 @@
 package com.sap.ai.sdk.core.client;
 
+import com.google.common.annotations.Beta;
 import com.sap.ai.sdk.core.AiCoreService;
 import com.sap.ai.sdk.core.model.AiConfiguration;
 import com.sap.ai.sdk.core.model.AiConfigurationBaseData;
@@ -32,6 +33,7 @@
  * your AI content from your own git repository, and register your own object store for training
  * data and trained models.
  */
+@Beta
 public class ConfigurationApi extends AbstractOpenApiService {
 
   /** Instantiates this API class to invoke operations on the AI Core */

core/src/main/java/com/sap/ai/sdk/core/client/DeploymentApi.java

@@ -1,5 +1,6 @@
 package com.sap.ai.sdk.core.client;
 
+import com.google.common.annotations.Beta;
 import com.sap.ai.sdk.core.AiCoreService;
 import com.sap.ai.sdk.core.model.AiDeploymentBulkModificationRequest;
 import com.sap.ai.sdk.core.model.AiDeploymentBulkModificationResponse;
@@ -39,6 +40,7 @@
  * your AI content from your own git repository, and register your own object store for training
  * data and trained models.
  */
+@Beta
 public class DeploymentApi extends AbstractOpenApiService {
 
   /** Instantiates this API class to invoke operations on the AI Core */

core/src/main/java/com/sap/ai/sdk/core/client/DockerRegistrySecretApi.java

@@ -1,5 +1,6 @@
 package com.sap.ai.sdk.core.client;
 
+import com.google.common.annotations.Beta;
 import com.sap.ai.sdk.core.AiCoreService;
 import com.sap.ai.sdk.core.model.BcknddockerRegistrySecretCreationResponse;
 import com.sap.ai.sdk.core.model.BcknddockerRegistrySecretDeletionResponse;
@@ -33,6 +34,7 @@
  * your AI content from your own git repository, and register your own object store for training
  * data and trained models.
  */
+@Beta
 public class DockerRegistrySecretApi extends AbstractOpenApiService {
 
   /** Instantiates this API class to invoke operations on the AI Core */

core/src/main/java/com/sap/ai/sdk/core/client/ExecutableApi.java

@@ -1,5 +1,6 @@
 package com.sap.ai.sdk.core.client;
 
+import com.google.common.annotations.Beta;
 import com.sap.ai.sdk.core.AiCoreService;
 import com.sap.ai.sdk.core.model.AiExecutable;
 import com.sap.ai.sdk.core.model.AiExecutableList;
@@ -28,6 +29,7 @@
  * your AI content from your own git repository, and register your own object store for training
  * data and trained models.
  */
+@Beta
 public class ExecutableApi extends AbstractOpenApiService {
 
   /** Instantiates this API class to invoke operations on the AI Core */

core/src/main/java/com/sap/ai/sdk/core/client/ExecutionApi.java

@@ -1,5 +1,6 @@
 package com.sap.ai.sdk.core.client;
 
+import com.google.common.annotations.Beta;
 import com.sap.ai.sdk.core.AiCoreService;
 import com.sap.ai.sdk.core.model.AiEnactmentCreationRequest;
 import com.sap.ai.sdk.core.model.AiExecutionBulkModificationRequest;
@@ -39,6 +40,7 @@
  * your AI content from your own git repository, and register your own object store for training
  * data and trained models.
  */
+@Beta
 public class ExecutionApi extends AbstractOpenApiService {
 
   /** Instantiates this API class to invoke operations on the AI Core */