fix: improve configuration metadata generation for IDE auto-completion

- Make @NestedConfigurationProperty fields final to fix metadata generation - Remove setters for nested configuration properties ensuring immutability - Add missing @NestedConfigurationProperty annotations where needed This fixes Spring Boot's configuration processor to properly generate metadata for nested properties, enabling better IDE auto-completion and contextual help in application.properties/yaml files for all Spring AI model configurations. Signed-off-by: Christian Tzolov <christian.tzolov@broadcom.com>

Author: tzolov

auto-configurations/common/spring-ai-autoconfigure-retry/src/main/java/org/springframework/ai/retry/autoconfigure/SpringAiRetryProperties.java

@@ -42,7 +42,7 @@ public class SpringAiRetryProperties {
  * Exponential Backoff properties.
  */
 @NestedConfigurationProperty
-private Backoff backoff = new Backoff();
+private final Backoff backoff = new Backoff();
 
 /**
  * If false, throw a NonTransientAiException, and do not attempt retry for 4xx client

auto-configurations/models/spring-ai-autoconfigure-model-anthropic/src/main/java/org/springframework/ai/model/anthropic/autoconfigure/AnthropicChatProperties.java

@@ -39,7 +39,7 @@ public class AnthropicChatProperties {
  * generative's defaults.
  */
 @NestedConfigurationProperty
-private AnthropicChatOptions options = AnthropicChatOptions.builder()
+private final AnthropicChatOptions options = AnthropicChatOptions.builder()
 .model(AnthropicChatModel.DEFAULT_MODEL_NAME)
 .maxTokens(AnthropicChatModel.DEFAULT_MAX_TOKENS)
 .temperature(AnthropicChatModel.DEFAULT_TEMPERATURE)

auto-configurations/models/spring-ai-autoconfigure-model-azure-openai/src/main/java/org/springframework/ai/model/azure/openai/autoconfigure/AzureOpenAiAudioTranscriptionProperties.java

@@ -31,14 +31,10 @@ public class AzureOpenAiAudioTranscriptionProperties {
 public static final String CONFIG_PREFIX = "spring.ai.azure.openai.audio.transcription";
 
 @NestedConfigurationProperty
-private AzureOpenAiAudioTranscriptionOptions options = AzureOpenAiAudioTranscriptionOptions.builder().build();
+private final AzureOpenAiAudioTranscriptionOptions options = AzureOpenAiAudioTranscriptionOptions.builder().build();
 
 public AzureOpenAiAudioTranscriptionOptions getOptions() {
 return this.options;
 }
 
-public void setOptions(AzureOpenAiAudioTranscriptionOptions options) {
-this.options = options;
-}
-
 }

auto-configurations/models/spring-ai-autoconfigure-model-azure-openai/src/main/java/org/springframework/ai/model/azure/openai/autoconfigure/AzureOpenAiChatProperties.java

@@ -30,7 +30,7 @@ public class AzureOpenAiChatProperties {
 private static final Double DEFAULT_TEMPERATURE = 0.7;
 
 @NestedConfigurationProperty
-private AzureOpenAiChatOptions options = AzureOpenAiChatOptions.builder()
+private final AzureOpenAiChatOptions options = AzureOpenAiChatOptions.builder()
 .deploymentName(DEFAULT_DEPLOYMENT_NAME)
 .temperature(DEFAULT_TEMPERATURE)
 .build();
@@ -39,8 +39,4 @@ public AzureOpenAiChatOptions getOptions() {
 return this.options;
 }
 
-public void setOptions(AzureOpenAiChatOptions options) {
-this.options = options;
-}
-
 }

auto-configurations/models/spring-ai-autoconfigure-model-azure-openai/src/main/java/org/springframework/ai/model/azure/openai/autoconfigure/AzureOpenAiEmbeddingProperties.java

@@ -28,7 +28,7 @@ public class AzureOpenAiEmbeddingProperties {
 public static final String CONFIG_PREFIX = "spring.ai.azure.openai.embedding";
 
 @NestedConfigurationProperty
-private AzureOpenAiEmbeddingOptions options = AzureOpenAiEmbeddingOptions.builder()
+private final AzureOpenAiEmbeddingOptions options = AzureOpenAiEmbeddingOptions.builder()
 .deploymentName("text-embedding-ada-002")
 .build();
 
@@ -38,11 +38,6 @@ public AzureOpenAiEmbeddingOptions getOptions() {
 return this.options;
 }
 
-public void setOptions(AzureOpenAiEmbeddingOptions options) {
-Assert.notNull(options, "Options must not be null");
-this.options = options;
-}
-
 public MetadataMode getMetadataMode() {
 return this.metadataMode;
 }

auto-configurations/models/spring-ai-autoconfigure-model-azure-openai/src/main/java/org/springframework/ai/model/azure/openai/autoconfigure/AzureOpenAiImageOptionsProperties.java

@@ -32,14 +32,10 @@ public class AzureOpenAiImageOptionsProperties {
 public static final String CONFIG_PREFIX = "spring.ai.azure.openai.image";
 
 @NestedConfigurationProperty
-private AzureOpenAiImageOptions options = AzureOpenAiImageOptions.builder().build();
+private final AzureOpenAiImageOptions options = AzureOpenAiImageOptions.builder().build();
 
 public AzureOpenAiImageOptions getOptions() {
 return this.options;
 }
 
-public void setOptions(AzureOpenAiImageOptions options) {
-this.options = options;
-}
-
 }

auto-configurations/models/spring-ai-autoconfigure-model-bedrock-ai/src/main/java/org/springframework/ai/model/bedrock/cohere/autoconfigure/BedrockCohereEmbeddingProperties.java

@@ -46,7 +46,7 @@ public class BedrockCohereEmbeddingProperties {
 private String model = CohereEmbeddingModel.COHERE_EMBED_MULTILINGUAL_V3.id();
 
 @NestedConfigurationProperty
-private BedrockCohereEmbeddingOptions options = BedrockCohereEmbeddingOptions.builder()
+private final BedrockCohereEmbeddingOptions options = BedrockCohereEmbeddingOptions.builder()
 .inputType(InputType.SEARCH_DOCUMENT)
 .truncate(CohereEmbeddingRequest.Truncate.NONE)
 .build();
@@ -63,10 +63,6 @@ public BedrockCohereEmbeddingOptions getOptions() {
 return this.options;
 }
 
-public void setOptions(BedrockCohereEmbeddingOptions options) {
-this.options = options;
-}
-
 public boolean isEnabled() {
 return this.enabled;
 }

auto-configurations/models/spring-ai-autoconfigure-model-bedrock-ai/src/main/java/org/springframework/ai/model/bedrock/converse/autoconfigure/BedrockConverseProxyChatProperties.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2024-2024 the original author or authors.
+ * Copyright 2024-2025 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -19,7 +19,6 @@
 import org.springframework.ai.model.tool.ToolCallingChatOptions;
 import org.springframework.boot.context.properties.ConfigurationProperties;
 import org.springframework.boot.context.properties.NestedConfigurationProperty;
-import org.springframework.util.Assert;
 
 /**
  * Configuration properties for Bedrock Converse.
@@ -39,17 +38,15 @@ public class BedrockConverseProxyChatProperties {
 private boolean enabled;
 
 @NestedConfigurationProperty
-private ToolCallingChatOptions options = ToolCallingChatOptions.builder().temperature(0.7).maxTokens(300).build();
+private final ToolCallingChatOptions options = ToolCallingChatOptions.builder()
+.temperature(0.7)
+.maxTokens(300)
+.build();
 
 public ToolCallingChatOptions getOptions() {
 return this.options;
 }
 
-public void setOptions(ToolCallingChatOptions options) {
-Assert.notNull(options, "ToolCallingChatOptions must not be null");
-this.options = options;
-}
-
 public boolean isEnabled() {
 return this.enabled;
 }

auto-configurations/models/spring-ai-autoconfigure-model-deepseek/src/main/java/org/springframework/ai/model/deepseek/autoconfigure/DeepSeekChatProperties.java

@@ -49,7 +49,7 @@ public class DeepSeekChatProperties extends DeepSeekParentProperties {
 private String betaPrefixPath = DEFAULT_BETA_PREFIX_PATH;
 
 @NestedConfigurationProperty
-private DeepSeekChatOptions options = DeepSeekChatOptions.builder()
+private final DeepSeekChatOptions options = DeepSeekChatOptions.builder()
 .model(DEFAULT_CHAT_MODEL)
 .temperature(DEFAULT_TEMPERATURE)
 .build();
@@ -58,10 +58,6 @@ public DeepSeekChatOptions getOptions() {
 return this.options;
 }
 
-public void setOptions(DeepSeekChatOptions options) {
-this.options = options;
-}
-
 public boolean isEnabled() {
 return this.enabled;
 }

auto-configurations/models/spring-ai-autoconfigure-model-minimax/src/main/java/org/springframework/ai/model/minimax/autoconfigure/MiniMaxChatProperties.java

@@ -36,7 +36,7 @@ public class MiniMaxChatProperties extends MiniMaxParentProperties {
 private static final Double DEFAULT_TEMPERATURE = 0.7;
 
 @NestedConfigurationProperty
-private MiniMaxChatOptions options = MiniMaxChatOptions.builder()
+private final MiniMaxChatOptions options = MiniMaxChatOptions.builder()
 .model(DEFAULT_CHAT_MODEL)
 .temperature(DEFAULT_TEMPERATURE)
 .build();
@@ -45,8 +45,4 @@ public MiniMaxChatOptions getOptions() {
 return this.options;
 }
 
-public void setOptions(MiniMaxChatOptions options) {
-this.options = options;
-}
-
 }