Spring AI 1.0.2 Release Notes

🎯 Highlights

This release includes 9 new features, 31 bug fixes, 13 documentation improvements, 4 dependency upgrades, 4 performance improvements, and 15 build updates.

📢 Noteworthy

Removed deprecated Mistral AI Codestral Mamba model support as part of code cleanup efforts #4225
Changed UserMessage to use metadata property instead of properties for better consistency across the API #3980

⭐ New Features

Added 'enable' configuration properties for Amazon Bedrock Cohere chat functionality 779b304
Improved Unicode property union support for better Chinese character handling in text processing 35df129
Added mutual exclusivity validation between maxTokens and maxCompletionTokens parameters to prevent configuration conflicts 5496a8c
Added support for GPT-5 models from OpenAI, expanding the available model options for Spring AI applications 977dbf2
Added comprehensive debugging capabilities to maintenance workflow to improve troubleshooting and monitoring 51086f8
Added GPT-5 model enum support with updated documentation to enable integration with OpenAI's latest model 9908073
Implemented fast CI build support for maintenance branch cherry-picks to improve development workflow efficiency 22efc03
Enables proper JSON schema generation for Kotlin data classes and objects in BeanOutputConverter #3900
MariaDB Vector Store similarity searches now provide scores for better result ranking 3d72e93

🪲 Bug Fixes

Fixed tokenizer to properly use Base64 encoding for binary data token estimation c60d942
Corrected function name in VertexAI Gemini streaming test to resolve test failures 407e4cb
Resolved issues with default implementation of ToolCallback#call(String,ToolContext) method 76708a1
Properly handle null or empty tool call arguments during streaming operations 8d0caf4
Cleaned up incorrect BedrockChatOptions configuration that was causing issues 5ecbfab
Fixed issue with merging tool calling chat options in AWS Bedrock converse chat model #4314
Resolved message reordering issues in Azure OpenAI chat model implementation 618c451
Fixed various integration test failures for Anthropic function calling functionality 3f97d9e
Corrected stream function call usage test failures in Azure OpenAI integration ec84f2a
Fixed chat completion stream error handling in Anthropic API integration tests 38afc12
Replaced SimpleDateFormat with thread-safe DateTimeFormatter to prevent potential concurrency issues 370efa7
Removed duplicate lines in AzureOpenAiChatOptions configuration class 5477f47
Resolved a StackOverflowError that was introduced by the MongoDbAtlasLocalContainerConnectionDetails.getSslBundle() method 03d475e
Corrected NPE that occurred when metadata is null in MilvusVectorStore operations 7437192
Fixed incorrect handling of merge operations when the 'current' value is null 4daffa3
Fixed metadata handling in Azure Vector Store to allow proper mutation of metadata objects 2a7321f
Resolved flaky test that was causing intermittent failures in streaming response aggregation f71f9de
Corrected handling of empty string values in OpenAI streaming finish_reason field 90a88ec
Resolved git state detection problems that were triggering full project builds when they weren't needed 779e2f9
Updated logging output to accurately reflect the actual git strategy being used e8c75e4
Fixed branch detection to prioritize maintenance branch identification over explicit base_ref 7ad9a16
Fixed retry mechanism for ResourceAccessException when encountering network connectivity errors to improve application resilience #4094
Enhanced null safety by using Optional to check null values and prevent NPE occurrences across multiple components #4063 and #4064
Implemented fail-fast fallback and single-commit git diff strategy to improve error handling and performance 118c0ab
Maintains consistent pass check behavior for FactCheckingEvaluator and RelevancyEvaluator while preventing null pointer exceptions #3975
Fixes Azure chat completions by adding support for the strict option in JSON schema response format #3931
Eliminates unnecessary deserialization step when parsing model responses that are already JSON strings #4003
Properly rethrows ToolExecutionException for non-RuntimeException cases to maintain correct error propagation #3915
Tool function exceptions are now wrapped in ToolExecutionException and properly rethrown for better error handling and debugging cc11b01
Corrected bug in example code that was causing confusion for developers following the documentation #3993
Fixed issues preventing proper publication of artifacts to Maven Central repository 808f7da

📓 Documentation

Enhanced Mistral AI javadoc and updated documentation links for better developer experience #4327
Updated tools.adoc documentation with improved examples and clarifications #4278
Enhanced docker services documentation with better setup instructions and examples 0649db5
Added more detailed explanations and examples in observability documentation for better understanding of metrics configuration 6f61562
Added thorough validation and functionality tests for the Document class to improve code reliability 5c2ab36
Synchronized documentation improvements for deploy docs dispatcher naming to the 1.0.x branch f11a516
Added new Anthropic model names to documentation to reflect latest available models and improve developer guidance #4077
Improved documentation for chat memory functionality with updated examples and usage patterns #3917
Corrected and updated various outdated information across documentation 9252d4e
Added reference documentation for the new similarity score feature in MariaDBVectorStore e832061
Improved clarity and accuracy of MCP Client section documentation and inline comments 5019d4f
Enhanced documentation detailing ChromaDB configuration options for Chroma Cloud integration #4008
Enhanced documentation for the call() method in chatclient.adoc with clearer examples and explanations #3963

🔨 Dependency Upgrades

Changed hsqldb dependency scope from runtime to test in chat memory repository JDBC autoconfiguration #4366
Updated io.swagger.core.v3:swagger-annotations from version 2.2.25 to 2.2.30 3c81b42
Upgraded Ollama API integration to the latest version for improved compatibility and features ad689b1
Upgraded PostgreSQL JDBC driver from version 42.7.5 to 42.7.7 for improved stability and security #3934

⚡ Performance

Optimized JdbcChatMemoryRepositoryDialect#from method for better performance and removed redundant try-catch blocks #4288
Further optimizations to JdbcChatMemoryRepositoryDialect#from method implementation 7b6ac15
Reduced build scope and suppressed unnecessary Docker and Maven logging output for cleaner builds 55e23e6
Eliminates one deserialization step in the majority of scenarios when parsing model responses, improving performance #4003

🔩 Build Updates

Temporarily disabled skip-build logic to restore continuous integration and deployment functionality fa4d6d6
Updated tests and documentation to use DockerModelRunnerContainer for improved test reliability 846eb4d
Enhanced build efficiency by skipping builds when no new commits exist, reducing unnecessary resource usage 0b8ddfc
Fixed test discovery logic to never return root module in fast builds, improving build reliability b9309d6
Fixed GitHub Actions run names to properly display commit information instead of invalid function calls b2ec97d
Updated maintenance-fast.yml to test only affected modules, improving CI efficiency dada526
Synchronized continuous-integration.yml with main branch improvements for better CI consistency c22e9d3
Backported fast build improvements from main branch and completed missing improvements to maintenance-fast.yml 995efef
Removed duplicate CI/CD workflows triggered by cherry-pick commits to improve efficiency 7de2d5a
Added path exclusions to maintenance branch builds to prevent unnecessary CI/CD runs 67cebea
Reduced CI/CD redundancy by implementing more restrictive build triggers 6e3eedb
Completed testing and validation of the optimized maintenance workflow system f81a2f6
Updated .gitignore to exclude pycache directories from version control 2a9654a
Removed debug System.out.println statements from QuestionAnswerAdvisorTests for cleaner test output abd07b9
Updated development version to 1.0.2-SNAPSHOT for next development cycle 469ca54

🙏 Contributors

Thanks to all contributors who made this release possible:

spring-projects/spring-ai v1.0.2 Spring AI 1.0.2 on GitHub