langchain4j/langchain4j 1.0.0-rc1

1.0.0-rc1 and 1.0.0-beta4

on GitHub

Announcements

We are excited to announce the release of version 1.0.0-rc1 (release candidate 1) for the following modules:

• langchain4j-core
• langchain4j
• langchain4j-http-client
• langchain4j-http-client-jdk
• langchain4j-open-ai

The rest of the modules are released under the 1.0.0-beta4 version. We are currently finalizing the remaining updates and plan to release the next set of modules as 1.0.0-rc1 in June.

Please try out version 1.0.0-rc1 and share any feedback. We plan to release the final 1.0.0 version in mid-May.

In case you are using langchain4j-bom, it remains at version 1.0.0-beta4, but includes the latest versions for each module (including 1.0.0-rc1 for the modules listed above).

Breaking Changes

This release introduces the following breaking changes. Please find the details in the corresponding PRs.

• Renamed ChatLanguageModel into ChatModel and StreamingChatLanguageModel into StreamingChatModel by @dliubarskyi in #2866
• Renamed Tokenizer into TokenCountEstimator by @dliubarskyi in #2874
• Fix #2794 by @dliubarskyi in #2906
• Removed redundant TextFile and TextFileContent by @dliubarskyi in #2908
• Fix #2918 (maxRetries) by @dliubarskyi in #2919
• Move Kotlin extensions to separate module by @kpavlov in #2943
• Removed logging of potentially sensitive information by @dliubarskyi in #2934
• ChatMemoryAccess: moved to dev.langchain4j.service.memory package in 082a758
• All collections (such as Lists, Sets, Maps, etc.) returned by the LangChain4j APIs in the langchain4j-core, langchain4j and langchain4j-open-ai modules are now non-nullable. Empty collections will be returned instead of null.
• Renamed and moved around some internal utility classes (which you should not use directly, even if they are public). All such classes are now annotated with @Internal.

To make the migration easier, please use the following OpenRewrite recipe:

mvn -U org.openrewrite.maven:rewrite-maven-plugin:6.7.0:run -Drewrite.recipeArtifactCoordinates=dev.langchain4j:langchain4j-openrewrite-recipes:1.0.0-rc1 -Drewrite.activeRecipes=dev.langchain4j.UpgradeToRc1AndBeta4

Please note that you need to run this before updating the versions to 1.0.0-rc1 and 1.0.0-beta4.

Other Changes

• fixed the bug that when mcp tool function has no args ,some openai co… by @awol2005ex in #2776
• chore(deps): update dependency org.apache.maven.plugins:maven-deploy-plugin to v3.1.4 by @renovate in #2850
• Fixes after #2620 by @tenpigs267 in #2851
• Support custom headers for VertexAi Streaming Chat Model (#2835) by @anydef in #2838
• Update dependency org.apache.maven.plugins:maven-failsafe-plugin to v3.5.3 by @renovate in #2860
• Automatic reconnect for MCP over HTTP by @jmartisk in #2862
• Move MCP traffic logging to a logger named 'MCP' by @jmartisk in #2869
• AI Services, ChatResponseMetadata, TokenUsage improvements by @dliubarskyi in #2883
• fix issue #2867 by @gkwan-ibm in #2875
• quarkus-mcp-server update for tests plus a minor test fix by @jmartisk in #2902
• Create a security policy by @jdubois in #2904
• Add Documentation for Helidon Integration by @arjav-desai in #2859
• Update google-vertex-ai.md by @AbiramiSukumaran in #2493
• Upgrade to OpenAI Java SDK v1.4.1 by @jdubois in #2868
• Introduce initialization timeout for MCP clients by @jmartisk in #2912
• Downgrade kotlinx-coroutines to version 1.8.1 by @kpavlov in #2936
• docs: Update DashScope documentation by @nfe-w in #2923
• Update dashscope.md by @xiaomgod in #2913
• Google AI Gemini: migrate from Gson to Jackson by @yangzho12138 in #2933
• Allow to configure custom Azure HttpClientProvider (#2799) by @philippn in #2822
• Fix Kotlin settings by @kpavlov in #2945
• updated Jackson version to 2.19.0 in dc41ebc

New Contributors

• @awol2005ex made their first contribution in #2776
• @anydef made their first contribution in #2838
• @gkwan-ibm made their first contribution in #2875
• @arjav-desai made their first contribution in #2859
• @AbiramiSukumaran made their first contribution in #2493
• @nfe-w made their first contribution in #2923
• @xiaomgod made their first contribution in #2913
• @yangzho12138 made their first contribution in #2933
• @philippn made their first contribution in #2822

Full Changelog: 1.0.0-beta3...1.0.0-rc1