Skip to content

Conversation

@renovate
Copy link
Contributor

@renovate renovate bot commented Dec 11, 2025

This PR contains the following updates:

Package Change Age Adoption Passing Confidence
org.springframework.ai:spring-ai-bom 1.1.22.0.0-M2 age adoption passing confidence

Release Notes

spring-projects/spring-ai (org.springframework.ai:spring-ai-bom)

v2.0.0-M2: Spring AI 2.0.0-M2

Compare Source

Spring AI 2.0.0-M2 Release Notes
🎯 Highlights

This release includes 20 new features, 20 bug fixes, 16 documentation improvements, 38 other improvements.

⏪ Breaking Changes
  • The Anthropic Skills API has been unified and helper classes have been renamed, which may require code changes if you're using the Anthropic integration directly #​5299
  • The SemanticCache interface has been relocated from the Redis-specific package to a more generic package location, which may require import statement updates for applications directly using this interface. #​5284
  • The Couchbase vector store classes have been relocated to a new dedicated package structure. Applications using Couchbase vector store will need to update their import statements. #​5233
⚠️ Upgrading Notes
  • If you are using the Anthropic Skills API directly, review your code for the renamed helper classes and update accordingly #​5299
  • If you are using the Couchbase vector store, update your import statements to reference the new dedicated package location. #​5233
⭐ New Features
  • Ollama embedding models now support configuring the dimensions parameter, allowing control over the size of generated embeddings 4bd83ba
  • JSON schema can now be customized, providing more flexibility for structured output generation 3119086
  • Default API endpoint paths are now configured for OpenAI's content moderation API, simplifying integration setup #​5300
  • Default API endpoint paths are now configured for OpenAI's audio API (speech and transcription), making it easier to use audio capabilities f7eeaf9
  • Added support for using Amazon S3 as a vector store backend for storing and retrieving embeddings cd86d38
  • Integrated Infinispan as a new vector store option, providing distributed in-memory data grid capabilities for embedding storage 9b105b8
  • Added support for Amazon Bedrock Knowledge Base as a vector store, enabling integration with AWS's managed knowledge base service 21c3834
  • Enhanced the Redis semantic cache module with improved functionality and performance 7233e8d
  • Made the content field name configurable in QdrantVectorStore, allowing customization of the field used to store document content f65756e
  • Added a convenience method to the Prompt class for easily retrieving system messages 8a79390
  • Added native support for structured outputs using JSON schema validation in the Mistral AI chat model, enabling type-safe responses with automatic schema enforcement. 8757c5b
  • OpenAI moderation, audio speech, and audio transcription API paths are now configurable, allowing customization for proxy setups or alternative OpenAI-compatible endpoints. 1d38aec
  • Migrated to use Spring Boot 4's native MongoDB Atlas container support for improved testing and development experience. 5b39fbb
  • Introduced Mcp*ServerCustomizer interfaces to allow customization of MCP server configurations #​5261
  • Added new Redis-based semantic cache advisor implementation, enabling intelligent caching of semantically similar queries to improve performance and reduce API calls 391cbbb
  • OllamaChatOptions now implements StructuredOutputChatOptions with corresponding methods, unit tests, and integration tests. Enhanced JSON format handling for Ollama chat options 163df2e
  • Improved model provider detection logic for Microsoft Foundry integration, providing better model identification and configuration support 5c18a40
  • Add support for dynamic tool schema enhancement, allowing runtime modification of tool argument definitions for more flexible function calling 3c4b6dc
  • Add conversationHistoryEnabled option to ToolCallAdvisor, providing finer control over whether conversation history is included in tool call contexts 5ad8485
  • Add JSpecify annotations to commons module for improved null-safety analysis and compile-time verification #​5101
🪲 Bug Fixes
  • Resolved an issue where ToolCallAdvisor would not preserve system messages when memory functionality was disabled 1dac9d0
  • Fixed incorrect observation provider usage in the Google GenAI embedding model implementation #​5227
  • Corrected conditional logic in Infinispan AutoConfiguration to ensure proper bean creation #​5295
  • Resolved issues in the MistralAiChatModelIT.chatClientEntityWithStructuredOutput integration test to ensure proper validation of structured output functionality. cf2212b
  • Corrected code style violations in the spring-ai-redis-semantic-cache module to maintain code quality standards. 0108011
  • Fixed MCP auto-configuration to work properly in non-web application contexts #​5261
  • Improved exception handling in the ChromaApi for better error reporting e291712
  • Fixed failing Ollama integration tests by modifying tool descriptions to better guide the model in providing geographical coordinates 864487f
  • Enhanced JdbcChatMemoryRepositorySchemaInitializer for improved database schema setup d202db1
  • Corrected string parsing issues in the grammar implementation 8ecc334
  • Corrected invalid Filter.Expression constructor usage in documentation examples #​5243
  • Resolved checkstyle violations in Redis auto-configuration code to maintain code quality standards 07ccd2c
  • Resolved token count inconsistencies in Ollama integration tests that occurred with varying model versions c2dfedb
  • Updated Anthropic integration tests to use the currently active model for improved test reliability 5982176
  • Added explicit null safety check to prevent potential NullPointerException in Neo4jChatMemory MediaBuilder e4c2fb4
  • Fixed missing dependency artifacts for Redis chat memory repository in the Bill of Materials, ensuring proper dependency management for projects using Redis-based chat memory. 81427bb
  • Fixed an issue where the Neo4jVectorStore's doAdd method was ignoring the sessionConfig parameter, ensuring proper session configuration handling during document addition. #​5200 via #​5191
  • Fixed an issue where chat memory advisors could not properly handle ToolResponseMessage types, improving compatibility with tool-based conversations #​5174
  • Resolve build issues with Antora documentation generation 95bf79a
  • Corrected exception message validation in ChromaDB HTTP client/server communication 5dcac7b
📓 Documentation
  • Updated documentation for Prompt-related functionality 190fe98
  • Added documentation for the configurable content_field_name feature in Qdrant vector store 002a208
  • Added documentation for the new configuration properties that allow customization of OpenAI speech, transcription, and moderation API endpoints. f8ad209
  • Updated documentation to cover the native structured output converter functionality for Mistral AI models. a9f49a0
  • Added comprehensive documentation for the new Redis semantic cache feature, including configuration and usage examples 77e115f
  • Corrected duplicated step numbering in RetrievalAugmentationAdvisor documentation for improved clarity #​5160
  • General typo corrections throughout documentation 64de839
  • Corrected typographical errors in the Gemini integration documentation. 5e397b5
  • Added comprehensive documentation guide for using LLM as a Judge pattern for evaluating AI model outputs #​5145
  • Added documentation guide explaining how to implement dynamic tool discovery for runtime function calling capabilities #​5141
  • Add reference documentation for Anthropic Custom Skills integration ba49f4e
  • Remove redundant /v1 suffix from OpenAI base-url examples in documentation for clearer configuration guidance d281da4
  • Update incorrect comment in chat client code for accuracy #​4891
  • Corrected code syntax in chat options builder documentation example #​4915
  • Corrected typo in error message for ChromaDB collection existence validation #​5080
  • Updated OpenAI embedding model documentation reference in TokenCountBatchingStrategy Javadoc to point to current documentation #​5083
🔨 Dependency Upgrades
  • Updated the Model Context Protocol (MCP) SDK dependency to version 0.17.2 d81e47d
  • Updated Spring Boot dependency to version 4.0.1 5f1e021
  • Updated Mistral AI chat model enumeration to reflect latest available models b77202c
  • Updated OpenAI Java SDK dependency to version 4.13.0, bringing latest improvements and compatibility updates #​5187
🔩 Build Updates
  • Updated static analysis tools NullAway and Error Prone to their latest versions for improved code quality checks d232c82
  • Migrated S3 Vector Store to use JSpecify nullability annotations for improved null safety 24aeed5
  • Made ResponseErrorHandler configurable as an optional bean for more flexible error handling daa08c8
  • Added JSpecify nullability annotations to document-readers modules to improve null-safety and IDE support. #​5287
  • Added JSpecify nullability annotations to the RedisSemanticCache module for better null-safety guarantees. #​5284
  • Added JSpecify null-safety annotations to Redis, Weaviate, Typesense, Qdrant, Pinecone, pgvector, Oracle, OpenSearch, Neo4j, and MongoDB Atlas vector store modules to improve type safety and IDE support #​5268
  • Added JSpecify null-safety annotations to Milvus and additional vector store modules for improved type safety #​5247, #​5268
  • Made RetryTemplate an optional bean for more flexible configuration 4f121c6
  • Updated static analysis suppressions file to reflect current codebase state 1392dda
  • Enhanced type safety with JSpecify annotations for Cassandra, Cosmos DB, Azure, and Spring Cloud Bindings modules #​5226, #​5212, #​5213, #​5207
  • Introduced checkstyle check to ensure all packages include package-info.java documentation 9c734bf
  • Reorganized checkstyle suppressions configuration to enable better progress monitoring 0d1ef71
  • Enhanced type safety by adding JSpecify annotations to retry module, MCP annotations module, and MCP common module to improve null-safety guarantees. #​5207
  • Improved code quality by adding JSpecify annotations to CosmosDB, MongoDB, Neo4j, and Redis chat memory repository implementations for better null-safety handling. #​5203
  • Corrected test classification by moving integration-level test to proper IT test category, improving test organization and build process accuracy. #​5208
  • Added test coverage for JSpecify nullable field handling in JSON schema generation to ensure proper null-safety annotation support. 316b420
  • Resolved issues with the Spring configuration metadata processor. 27a9da0
  • Added comprehensive JSpecify annotations across multiple modules including Cassandra and JDBC chat memory repositories, vector store advisors, RAG module, test module, and core vector store module to improve null-safety and type checking. #​5203, #​5199, #​5183
  • General updates and improvements to the Neo4j vector store implementation. f3445d1
  • Migrated chat-client and vector-store modules to use JSpecify nullability annotations for improved static analysis #​5183
  • Switched model module to use JSpecify annotations for better null-safety guarantees #​5129
  • Added JSpecify nullability annotations to newly created subpackages #​5164
  • Refactored embedding-related files into the model module for better code organization #​5159
  • Fixed Checkstyle plugin configuration to ensure proper code style enforcement 647a13f
  • Improved cache update mechanism with a new implementation approach b104437
  • Update CI workflows to use explicit save/restore cache actions for improved build performance and reliability bd56e0b
  • Add workflow_dispatch to CI configuration enabling manual workflow execution for testing and troubleshooting #​5102
  • Make MongoDB starter optional for Testcontainers and Docker Compose modules, reducing required dependencies for non-MongoDB users 08fadd0
  • Reworked multiple GitHub Actions workflows into a unified workflow for improved maintainability and consistency #​5036
  • Resolved GitHub Actions dispatch authorization issue bf5ebce
  • Corrected GitHub Actions workflow to ensure commands run in proper git repository context c0246af
  • Cleaned up test suite by removing ambiguous test case from ChatClient tools integration test 8909028
🙏 Contributors

Thanks to all the community contributors who made this release possible:

v2.0.0-M1: Spring AI 2.0.0-M1

Compare Source

Spring AI 2.0.0-M1 Release Notes
🎯 Highlights

Spring AI 2.0.0-M1 represents the first milestone of the 2.x series, built on Spring Boot 4.0 and Spring Framework 7.0. This major platform upgrade, contributed by Dmitry Bedrin with Paul Bakker from Netflix (#​4774), brings modern Java capabilities and positions Spring AI for the next generation of AI application development.

This release includes 24 new features, 25 bug fixes, 7 documentation improvements, and 32 other improvements across 90 commits.

⏪ Breaking Changes
  • The default temperature configuration has been removed from model implementations. Applications relying on default temperature values will need to explicitly configure temperature settings. ce1a7fc
  • The default chat model for OpenAI has been updated from the previous default to gpt-5-mini. Applications relying on the implicit default may experience different behavior. 8c093f1
⚠️ Upgrading Notes
  • With the removal of default temperature options, ensure your application explicitly sets temperature values in model configurations where required. ce1a7fc
  • If your application depends on the default OpenAI chat model, verify that gpt-5-mini meets your requirements or explicitly configure your preferred model in application properties 8c093f1
📢 Noteworthy
  • If you're building Spring AI from source on the main branch, ensure you have Java 21 or higher installed while Java 17 is still the baseline for consuming the Spring AI 2.x binaries. 8ca583d
  • Spring Boot 4.0 and Spring Framework 7.0 upgrade - This release marks a major platform upgrade from Spring Boot 3.x to Spring Boot 4.0 GA and Spring Framework 7.0. Thanks to Dmitry Bedrin (@​bedrin) with Paul Bakker from Netflix (@​pbakker) for the comprehensive upgrade effort (#​4774). This includes major version upgrades for Kotlin (2.2.21), Rest Assured (5.5.6), swagger-codegen (3.0.75), and Testcontainers (2.0.1). d5e92be, a2a5e1b
  • The default chat model for OpenAI integration has been updated to gpt-5-mini, reflecting the latest recommended model from OpenAI 8c093f1
  • Official OpenAI Java SDK integration - Added native integration with the official OpenAI Java SDK for improved compatibility and functionality 15df47d
⭐ New Features
  • Added Redis-based chat memory repository implementation with Spring Boot starter for persistent conversation management across sessions 95f7481
  • New auto-configuration starter enabling easy setup of Redis-based chat memory with minimal configuration 99b2976
  • Added text search capabilities, range query support, and HNSW index parameter tuning for improved vector search performance in Redis c160b9c
  • TokenTextSplitter now supports custom punctuation marks, allowing more flexible text segmentation for different languages and text formats 9773099
  • Azure Vector Store now supports custom field names, enabling integration with existing Azure AI Search indexes that use non-default field naming conventions instead of hardcoded content, embedding, and metadata fields 798ab17
  • New finalization hook in ToolCallAdvisor enables custom logic execution after tool call loops complete, enhancing function calling workflow control #​5064
  • Added comprehensive Claude Skills integration including support for the Files API, enabling advanced file handling capabilities with Anthropic's Claude models. bd90625
  • Added support for ISNULL and ISNOTNULL filter expressions in vector store queries, enabling better null value handling in metadata filtering. 0b87c78
  • Added ThinkingLevel configuration option to control extended thinking capabilities in supported models, allowing fine-grained control over reasoning depth. 740a61c
  • Added safety ratings to response metadata for Vertex AI Gemini models, providing visibility into content safety assessments. 2710cab
  • Made ToolCallAdvisor extensible by introducing hook methods, allowing developers to customize tool calling behavior and implement custom logic around function execution. #​5004
  • Added support for the latest Claude 4.5 models including Opus and Haiku variants with updated model enums and documentation 01ace16
  • Google GenAI integration now supports thought signatures when using Gemini 3 Pro for function calling, enabling more advanced reasoning capabilities 3cb0879
  • GemFire Vector Store now supports authentication via username and password credentials 839e6ed
  • Enhanced OpenSearch vector store to omit explicit IDs when manageDocumentIds=false, improving compatibility with AWS OpenSearch Serverless deployments. Includes additional unit and integration tests. d82eec3
  • Added native integration with the official OpenAI Java SDK for improved compatibility and functionality 15df47d
  • ChatClient now supports native structured output, enabling direct conversion of chat responses to typed objects 195c4fd
  • Added prompt_tokens_details tracking for ZhipuAI model and updated default chat options for tests 89a3b32
  • Exposed seed parameter in Vertex AI configuration for reproducible results 4f1ab6a
  • Added Spring Boot web and REST client dependencies explicitly to model starters for better compatibility #​4949 via #​4948
  • Introduced auto-configuration support for AWS Bedrock profiles and replaced deprecated functionality 552263d
  • McpClientAutoConfiguration now supports optional handlers registry, improving flexibility in MCP client configuration #​4920 via #​4917
  • ClientMcp handlers registries now support beans with unresolvable types, enhancing compatibility with various Spring configurations #​4918 via #​4917
  • New Spring Boot starter added for Azure Cosmos DB chat memory repository, enabling easier integration of chat conversation history with Cosmos DB. ef8f413
🪲 Bug Fixes
  • Updated outdated Milvus JSON fields documentation link in MilvusFilterExpressionConverter Javadoc #​5028
  • Resolved test issues with ChatClient tools using generic argument types 9e857ec
  • Updated runtime hints for AWS Bedrock integration 0427650
  • Enhanced error handling for JSON parsing in the MethodToolCallback class to provide better error messages and handle malformed JSON in tool/function calling scenarios. #​5032 via #​3924
  • Corrected handling of punctuation marks in the TokenTextSplitter to ensure proper text splitting behavior. e065965
  • Resolved issue where the extraBody parameter was not being properly included in OpenAI API requests, ensuring all custom parameters are now correctly transmitted. 264fc3b
  • Corrected MariaDB schema validator to properly handle escaped spaces, eliminating false positive validation errors. 9acc2d7
  • Resolved native compilation problems when using GraalVM with Java 22, ensuring proper native image generation for Spring AI applications. a49e159
  • Addressed issue-4999 by removing the use of DEFAULT_TEMPERATURE to resolve configuration issues fe9e781
  • Resolved issue where OpenAI GPT models running on Amazon Bedrock were returning null responses. 050b9f1
  • Added missing OCIGenAiInferenceClientAutoConfiguration to Spring Boot autoconfiguration imports, ensuring proper auto-configuration for Oracle Cloud Infrastructure GenAI integration. 3e0040f
  • Added several missing auto-configuration classes to autoconfiguration import, improving Spring Boot integration. 258b6bc
  • Resolved issues in OpenSearchVectorStoreIT to ensure reliable integration testing. d4b6cf2
  • Corrected documentation typo in DefaultChatClientUtils. 7af2593
  • Corrected vector indexing algorithm acronym from HSNW to HNSW (Hierarchical Navigable Small World). 186808d
  • Improved retry logic for Oracle Vector Store integration test container startup to reduce flaky tests 8a6e39d
  • Resolved issues with ElasticSearch vector store integration tests 7f30987
  • Resolved issues with MongoDB Atlas vector store integration tests ad07a81
  • Resolved issues with RedisVectorStoreObservationIT and RedisVectorStoreIT integration tests a7b837a
  • Restored ResourceAccessException to the retry policy to ensure proper retry handling for resource access failures. f3eb842
  • Resolved issues in MongoDB chat memory auto-configuration integration tests. ce7381c
  • Fixed issues in Docker Compose integration tests to improve test stability. d7a6435
  • Resolved compatibility issues with MongoDB index creation across different Spring Data MongoDB versions. e87b2ba
  • Corrected issues in Typesense vector store integration tests. 106778d
  • Refactored retry logic to centralize exception handling, improving consistency and maintainability across all AI model implementations. #​4905
📓 Documentation
  • Added comprehensive documentation for the new Redis-based chat memory repository implementation aa74331
  • Enhanced ChatClient documentation to include complete coverage of all available ChatMemoryRepository implementations 0463997
  • Added Maven Central badge for easier discovery of latest release versions bc50b96
  • New documentation covering the custom punctuation marks feature in TokenTextSplitter e59be78
  • Documentation added for configuring custom field names when working with Azure AI Search indexes 757ed9e
  • Updated documentation and workflow files following the removal of the Maven toolchains plugin. d890ede
  • Updated Redis vector store documentation to point to the correct search query documentation 5ce998e
🔨 Dependency Upgrades
  • Upgraded Google Generative AI SDK from previous version to 1.30.0 abd5082
  • Updated Model Context Protocol (MCP) support with latest JDK and annotation versions to improve MCP integration capabilities. 28891ab, e15d318
  • Cleaned up duplicate dependency entry for Azure Identity in the build configuration. 0eaf938
  • Updated io.swagger.core.v3:swagger-annotations from version 2.2.30 to 2.2.38. e16d75a
  • Upgraded to Spring Boot 4.0.0 GA release a2a5e1b
  • Updated MCP and MCP annotations to latest versions 0bb7e5c
  • Upgraded spring-javaformat-maven-plugin to version 0.0.47 920e6f4
  • Updated to use Testcontainers dependencies from Spring Boot BOM and latest OpenSearch Testcontainers version compatible with Java 17 fbd8b7f
  • Updated to Spring Boot 4.0.0-RC2, bringing in the latest features and improvements from the Spring Boot 4.x line. d5e92be
🔩 Build Updates
  • Fixed checkstyle execution in build process 738c033
  • Resolved checkstyle formatting issues across codebase c5a7042
  • Improved CI/CD efficiency by generalizing the PR check workflow and enabling build caching 5ef6305
  • Optimized build cache settings for improved build performance cd76cf9
  • Updated build configuration to require Java 21 or higher for the main development branch. 8ca583d
  • Removed Maven toolchains plugin from the build configuration with corresponding documentation updates. d890ede
  • Modified visibility of toolCallingManager field to protected to allow better extensibility for custom implementations. ea5477e
  • Updated copyright year and author information in SpringAiCoreRuntimeHintsTests to reflect current maintenance. 4969dbc
  • Integrated Maven Build Cache plugin to improve build performance 147f85a
  • Updated Maven compiler configuration to avoid forking processes during compilation bd7d4cd
  • Disabled ErrorProne standard checks in the build configuration to address build compatibility issues. #​4976
  • Resolved multiple build system issues to improve build reliability and consistency. 3b14b4a
  • Updated fast-continuous integration workflow configuration for the 1.1.x branch dc4b6ad
  • Integrated ErrorProne static analysis tool with Nullaway for enhanced null safety checking during builds #​4903
  • Added Maven toolchains support for improved build consistency across different development environments d26637b
  • Incremented version to 2.0.0-SNAPSHOT for next development cycle. 10bc0a7
  • Incremented version to 1.1.1-SNAPSHOT for next development cycle. 9970432
🔐 Security
  • Overrode protobuf-java version in milvus-store module to address CVE-2024-7254 security vulnerability. 24795dd
🙏 Contributors

Thanks to all the community contributors who made this release possible:


Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.


  • If you want to rebase/retry this PR, check this box

This PR was generated by Mend Renovate. View the repository job log.

@renovate renovate bot force-pushed the renovate/org.springframework.ai-spring-ai-bom-2.x branch from 09a5bc9 to 41f28aa Compare January 23, 2026 13:29
@renovate renovate bot force-pushed the renovate/org.springframework.ai-spring-ai-bom-2.x branch from 41f28aa to bfe9f87 Compare January 24, 2026 23:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants