Remove deprecated APIs for 1.1.0 release

  Remove deprecated constructors, methods, and classes scheduled for removal:

  - Delete deprecated OllamaOptions class (replaced by OllamaChatOptions/OllamaEmbeddingOptions)
  - Delete deprecated EmbeddingOptionsBuilder class
  - Remove deprecated constructors from:
    - QuestionAnswerAdvisor
    - DeepSeekAssistantMessage
    - MistralAiChatModel, MistralAiEmbeddingModel, MistralAiModerationModel
    - MistralAiApi, MistralAiModerationApi
  - Remove deprecated builder methods:
    - BedrockTitanEmbeddingOptions.Builder.withInputType()
    - OllamaChatModel.Builder.defaultOptions(OllamaOptions)
    - OllamaEmbeddingModel.Builder.defaultOptions(OllamaOptions)

  Update all usages throughout codebase:
  - Migrate AssistantMessage construction to builder pattern
  - Replace EmbeddingOptionsBuilder with EmbeddingOptions.builder()
  - Update OllamaOptions references to use specific option types
  - Update vector stores and tests to use builder patterns

  Update reference docs to fix the deprecations

Signed-off-by: Ilayaperumal Gopinathan <ilayaperumal.gopinathan@broadcom.com>

Author: ilayaperumalg

advisors/spring-ai-advisors-vector-store/src/main/java/org/springframework/ai/chat/client/advisor/vectorstore/QuestionAnswerAdvisor.java

@@ -83,17 +83,6 @@ public class QuestionAnswerAdvisor implements BaseAdvisor {
 
 	private final int order;
 
-	/**
-	 * Construct instance by given VectorStore
-	 * @param vectorStore the given VectorStore
-	 * @deprecated in favor of {@link #builder(VectorStore)}}
-	 */
-	@Deprecated
-	public QuestionAnswerAdvisor(VectorStore vectorStore) {
-		this(vectorStore, SearchRequest.builder().build(), DEFAULT_PROMPT_TEMPLATE, BaseAdvisor.DEFAULT_SCHEDULER,
-				DEFAULT_ORDER);
-	}
-
 	QuestionAnswerAdvisor(VectorStore vectorStore, SearchRequest searchRequest, @Nullable PromptTemplate promptTemplate,
 			@Nullable Scheduler scheduler, int order) {
 		Assert.notNull(vectorStore, "vectorStore cannot be null");

auto-configurations/models/spring-ai-autoconfigure-model-vertex-ai/src/test/java/org/springframework/ai/model/vertexai/autoconfigure/embedding/VertexAiTextEmbeddingModelAutoConfigurationIT.java

@@ -25,7 +25,7 @@
 
 import org.springframework.ai.document.Document;
 import org.springframework.ai.embedding.DocumentEmbeddingRequest;
-import org.springframework.ai.embedding.EmbeddingOptionsBuilder;
+import org.springframework.ai.embedding.EmbeddingOptions;
 import org.springframework.ai.embedding.EmbeddingResponse;
 import org.springframework.ai.embedding.EmbeddingResultMetadata;
 import org.springframework.ai.utils.SpringAiTestAutoConfigurations;
@@ -118,7 +118,7 @@ public void multimodalEmbedding() {
 				var document = new Document("Hello World");
 
 				DocumentEmbeddingRequest embeddingRequest = new DocumentEmbeddingRequest(List.of(document),
-						EmbeddingOptionsBuilder.builder().build());
+						EmbeddingOptions.builder().build());
 
 				EmbeddingResponse embeddingResponse = multiModelEmbeddingModel.call(embeddingRequest);
 				assertThat(embeddingResponse.getResults()).hasSize(1);

memory/repository/spring-ai-model-chat-memory-repository-cosmos-db/src/main/java/org/springframework/ai/chat/memory/repository/cosmosdb/CosmosDBChatMemoryRepository.java

@@ -232,7 +232,7 @@ private Message mapToMessage(Map<String, Object> doc) {
 		}
 
 		return switch (messageType) {
-			case ASSISTANT -> new AssistantMessage(content, metadata);
+			case ASSISTANT -> AssistantMessage.builder().content(content).properties(metadata).build();
 			case USER -> UserMessage.builder().text(content).metadata(metadata).build();
 			case SYSTEM -> SystemMessage.builder().text(content).metadata(metadata).build();
 			case TOOL -> ToolResponseMessage.builder().responses(List.of()).metadata(metadata).build();

models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/titan/BedrockTitanEmbeddingOptions.java

@@ -66,11 +66,6 @@ public static final class Builder {
 
 		private BedrockTitanEmbeddingOptions options = new BedrockTitanEmbeddingOptions();
 
-		@Deprecated
-		public Builder withInputType(InputType inputType) {
-			return this.inputType(inputType);
-		}
-
 		public Builder inputType(InputType inputType) {
 			Assert.notNull(inputType, "input type can not be null.");
 

models/spring-ai-deepseek/src/main/java/org/springframework/ai/deepseek/DeepSeekAssistantMessage.java

@@ -34,57 +34,6 @@ public class DeepSeekAssistantMessage extends AssistantMessage {
 
 	private String reasoningContent;
 
-	/**
-	 * @deprecated in favor of {@link DeepSeekAssistantMessage.Builder}
-	 */
-	@Deprecated
-	public DeepSeekAssistantMessage(String content) {
-		super(content);
-	}
-
-	/**
-	 * @deprecated in favor of {@link DeepSeekAssistantMessage.Builder}
-	 */
-	@Deprecated
-	public DeepSeekAssistantMessage(String content, String reasoningContent) {
-		super(content);
-		this.reasoningContent = reasoningContent;
-	}
-
-	/**
-	 * @deprecated in favor of {@link DeepSeekAssistantMessage.Builder}
-	 */
-	@Deprecated
-	public DeepSeekAssistantMessage(String content, Map<String, Object> properties) {
-		super(content, properties);
-	}
-
-	/**
-	 * @deprecated in favor of {@link DeepSeekAssistantMessage.Builder}
-	 */
-	@Deprecated
-	public DeepSeekAssistantMessage(String content, Map<String, Object> properties, List<ToolCall> toolCalls) {
-		super(content, properties, toolCalls);
-	}
-
-	/**
-	 * @deprecated in favor of {@link DeepSeekAssistantMessage.Builder}
-	 */
-	@Deprecated
-	public DeepSeekAssistantMessage(String content, String reasoningContent, Map<String, Object> properties,
-			List<ToolCall> toolCalls) {
-		this(content, reasoningContent, properties, toolCalls, List.of());
-	}
-
-	/**
-	 * @deprecated in favor of {@link DeepSeekAssistantMessage.Builder}
-	 */
-	@Deprecated
-	public DeepSeekAssistantMessage(String content, String reasoningContent, Map<String, Object> properties,
-			List<ToolCall> toolCalls, List<Media> media) {
-		this(content, reasoningContent, null, properties, toolCalls, media);
-	}
-
 	protected DeepSeekAssistantMessage(String content, String reasoningContent, Boolean prefix,
 			Map<String, Object> properties, List<ToolCall> toolCalls, List<Media> media) {
 		super(content, properties, toolCalls, media);

models/spring-ai-deepseek/src/test/java/org/springframework/ai/deepseek/DeepSeekAssistantMessageTests.java

@@ -38,7 +38,7 @@ class DeepSeekAssistantMessageTests {
 	@Test
 	public void testConstructorWithContentOnly() {
 		String content = "Hello, world!";
-		DeepSeekAssistantMessage message = new DeepSeekAssistantMessage(content);
+		DeepSeekAssistantMessage message = new DeepSeekAssistantMessage.Builder().content(content).build();
 
 		assertThat(message.getText()).isEqualTo(content);
 		assertThat(message.getReasoningContent()).isNull();
@@ -49,7 +49,9 @@ public void testConstructorWithContentOnly() {
 	public void testConstructorWithContentAndReasoningContent() {
 		String content = "Hello, world!";
 		String reasoningContent = "This is my reasoning";
-		DeepSeekAssistantMessage message = new DeepSeekAssistantMessage(content, reasoningContent);
+		DeepSeekAssistantMessage message = new DeepSeekAssistantMessage.Builder().content(content)
+			.reasoningContent(reasoningContent)
+			.build();
 
 		assertThat(message.getText()).isEqualTo(content);
 		assertThat(message.getReasoningContent()).isEqualTo(reasoningContent);
@@ -63,7 +65,9 @@ public void testConstructorWithContentAndProperties() {
 		properties.put("key1", "value1");
 		properties.put("key2", 123);
 
-		DeepSeekAssistantMessage message = new DeepSeekAssistantMessage(content, properties);
+		DeepSeekAssistantMessage message = new DeepSeekAssistantMessage.Builder().content(content)
+			.properties(properties)
+			.build();
 
 		assertThat(message.getText()).isEqualTo(content);
 		assertThat(message.getMetadata()).containsAllEntriesOf(properties);
@@ -79,7 +83,10 @@ public void testConstructorWithContentPropertiesAndToolCalls() {
 
 		List<ToolCall> toolCalls = List.of(new ToolCall("1", "function", "myFunction", "{}"));
 
-		DeepSeekAssistantMessage message = new DeepSeekAssistantMessage(content, properties, toolCalls);
+		DeepSeekAssistantMessage message = new DeepSeekAssistantMessage.Builder().content(content)
+			.properties(properties)
+			.toolCalls(toolCalls)
+			.build();
 
 		assertThat(message.getText()).isEqualTo(content);
 		assertThat(message.getMetadata()).containsAllEntriesOf(properties);
@@ -97,8 +104,12 @@ public void testConstructorWithAllParameters() {
 		properties.put("key1", "value1");
 		List<ToolCall> toolCalls = List.of(new ToolCall("1", "function", "myFunction", "{}"));
 
-		DeepSeekAssistantMessage message = new DeepSeekAssistantMessage(content, reasoningContent, prefix, properties,
-				toolCalls, List.of());
+		DeepSeekAssistantMessage message = new DeepSeekAssistantMessage.Builder().content(content)
+			.reasoningContent(reasoningContent)
+			.properties(properties)
+			.toolCalls(toolCalls)
+			.prefix(prefix)
+			.build();
 
 		assertThat(message.getText()).isEqualTo(content);
 		assertThat(message.getReasoningContent()).isEqualTo(reasoningContent);
@@ -128,7 +139,7 @@ public void testPrefixAssistantMessageFactoryMethodWithReasoning() {
 
 	@Test
 	public void testSettersAndGetters() {
-		DeepSeekAssistantMessage message = new DeepSeekAssistantMessage("test");
+		DeepSeekAssistantMessage message = new DeepSeekAssistantMessage.Builder().build();
 
 		String reasoningContent = "New reasoning content";
 		Boolean prefix = false;
@@ -157,7 +168,9 @@ public void testEqualsAndHashCode() {
 
 	@Test
 	public void testToString() {
-		DeepSeekAssistantMessage message = new DeepSeekAssistantMessage("content", "reasoning");
+		DeepSeekAssistantMessage message = new DeepSeekAssistantMessage.Builder().content("content")
+			.reasoningContent("reasoning")
+			.build();
 		message.setPrefix(true);
 
 		assertThatNoException().isThrownBy(message::toString);

models/spring-ai-deepseek/src/test/java/org/springframework/ai/deepseek/chat/DeepSeekChatModelIT.java

@@ -224,7 +224,9 @@ void prefixCompletionTest() {
 				```
 				""";
 		UserMessage userMessage = new UserMessage(userMessageContent);
-		Message assistantMessage = new DeepSeekAssistantMessage("{\"code\":200,\"result\":{\"total\":1,\"data\":[1");
+		Message assistantMessage = AssistantMessage.builder()
+			.content("{\"code\":200,\"result\":{\"total\":1,\"data\":[1")
+			.build();
 		Prompt prompt = new Prompt(List.of(userMessage, assistantMessage));
 		ChatResponse response = this.chatModel.call(prompt);
 		assertThat(response.getResult().getOutput().getText().equals(",2,3]}}"));

models/spring-ai-mistral-ai/src/main/java/org/springframework/ai/mistralai/MistralAiChatModel.java

@@ -127,14 +127,6 @@ public class MistralAiChatModel implements ChatModel {
 	 */
 	private ChatModelObservationConvention observationConvention = DEFAULT_OBSERVATION_CONVENTION;
 
-	@Deprecated
-	public MistralAiChatModel(MistralAiApi mistralAiApi, MistralAiChatOptions defaultOptions,
-			ToolCallingManager toolCallingManager, RetryTemplate retryTemplate,
-			ObservationRegistry observationRegistry) {
-		this(mistralAiApi, defaultOptions, toolCallingManager, retryTemplate, observationRegistry,
-				new DefaultToolExecutionEligibilityPredicate());
-	}
-
 	public MistralAiChatModel(MistralAiApi mistralAiApi, MistralAiChatOptions defaultOptions,
 			ToolCallingManager toolCallingManager, RetryTemplate retryTemplate, ObservationRegistry observationRegistry,
 			ToolExecutionEligibilityPredicate toolExecutionEligibilityPredicate) {

models/spring-ai-mistral-ai/src/main/java/org/springframework/ai/mistralai/MistralAiEmbeddingModel.java

@@ -85,29 +85,6 @@ public class MistralAiEmbeddingModel extends AbstractEmbeddingModel {
 	 */
 	private EmbeddingModelObservationConvention observationConvention = DEFAULT_OBSERVATION_CONVENTION;
 
-	@Deprecated
-	public MistralAiEmbeddingModel(MistralAiApi mistralAiApi) {
-		this(mistralAiApi, MetadataMode.EMBED);
-	}
-
-	@Deprecated
-	public MistralAiEmbeddingModel(MistralAiApi mistralAiApi, MetadataMode metadataMode) {
-		this(mistralAiApi, metadataMode,
-				MistralAiEmbeddingOptions.builder().withModel(MistralAiApi.EmbeddingModel.EMBED.getValue()).build(),
-				RetryUtils.DEFAULT_RETRY_TEMPLATE);
-	}
-
-	@Deprecated
-	public MistralAiEmbeddingModel(MistralAiApi mistralAiApi, MistralAiEmbeddingOptions options) {
-		this(mistralAiApi, MetadataMode.EMBED, options, RetryUtils.DEFAULT_RETRY_TEMPLATE);
-	}
-
-	@Deprecated
-	public MistralAiEmbeddingModel(MistralAiApi mistralAiApi, MetadataMode metadataMode,
-			MistralAiEmbeddingOptions options, RetryTemplate retryTemplate) {
-		this(mistralAiApi, metadataMode, options, retryTemplate, ObservationRegistry.NOOP);
-	}
-
 	public MistralAiEmbeddingModel(MistralAiApi mistralAiApi, MetadataMode metadataMode,
 			MistralAiEmbeddingOptions options, RetryTemplate retryTemplate, ObservationRegistry observationRegistry) {
 		Assert.notNull(mistralAiApi, "mistralAiApi must not be null");

models/spring-ai-mistral-ai/src/main/java/org/springframework/ai/mistralai/api/MistralAiApi.java

@@ -83,38 +83,6 @@ public static Builder builder() {
 
 	private final MistralAiStreamFunctionCallingHelper chunkMerger = new MistralAiStreamFunctionCallingHelper();
 
-	/**
-	 * Create a new client api with DEFAULT_BASE_URL
-	 * @param apiKey Mistral api Key.
-	 */
-	@Deprecated
-	public MistralAiApi(String apiKey) {
-		this(DEFAULT_BASE_URL, apiKey);
-	}
-
-	/**
-	 * Create a new client api.
-	 * @param baseUrl api base URL.
-	 * @param apiKey Mistral api Key.
-	 */
-	@Deprecated
-	public MistralAiApi(String baseUrl, String apiKey) {
-		this(baseUrl, apiKey, RestClient.builder(), RetryUtils.DEFAULT_RESPONSE_ERROR_HANDLER);
-	}
-
-	/**
-	 * Create a new client api.
-	 * @param baseUrl api base URL.
-	 * @param apiKey Mistral api Key.
-	 * @param restClientBuilder RestClient builder.
-	 * @param responseErrorHandler Response error handler.
-	 */
-	@Deprecated
-	public MistralAiApi(String baseUrl, String apiKey, RestClient.Builder restClientBuilder,
-			ResponseErrorHandler responseErrorHandler) {
-		this(baseUrl, apiKey, restClientBuilder, WebClient.builder(), responseErrorHandler);
-	}
-
 	/**
 	 * Create a new client api.
 	 * @param baseUrl api base URL.