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 <[email protected]>
Signed-off-by: 家娃 <[email protected]>

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

@@ -19,7 +19,6 @@
 import org.springframework.ai.bedrock.converse.BedrockChatOptions;
 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,12 @@ public class BedrockConverseProxyChatProperties {
 	private boolean enabled;
 
 	@NestedConfigurationProperty
-	private BedrockChatOptions options = BedrockChatOptions.builder().temperature(0.7).maxTokens(300).build();
+	private final BedrockChatOptions options = BedrockChatOptions.builder().temperature(0.7).maxTokens(300).build();
 
 	public BedrockChatOptions getOptions() {
 		return this.options;
 	}
 
-	public void setOptions(BedrockChatOptions options) {
-		Assert.notNull(options, "BedrockChatOptions 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-elevenlabs/src/main/java/org/springframework/ai/model/elevenlabs/autoconfigure/ElevenLabsSpeechProperties.java

@@ -43,7 +43,7 @@ public class ElevenLabsSpeechProperties {
 	private boolean enabled = true;
 
 	@NestedConfigurationProperty
-	private ElevenLabsTextToSpeechOptions options = ElevenLabsTextToSpeechOptions.builder()
+	private final ElevenLabsTextToSpeechOptions options = ElevenLabsTextToSpeechOptions.builder()
 		.modelId(DEFAULT_MODEL_ID)
 		.voiceId(DEFAULT_VOICE_ID)
 		.outputFormat(DEFAULT_OUTPUT_FORMAT.getValue())
@@ -53,10 +53,6 @@ public ElevenLabsTextToSpeechOptions getOptions() {
 		return this.options;
 	}
 
-	public void setOptions(ElevenLabsTextToSpeechOptions options) {
-		this.options = options;
-	}
-
 	public boolean isEnabled() {
 		return this.enabled;
 	}