Notable Changes

• MCP client according to 2026-07-28 by @jmartisk in https://github.com/langchain4j/langchain4j/pull/5881
• Update milvus to V2 service & support hybrid search by @yangzho12138 in https://github.com/langchain4j/langchain4j/pull/3311
• Add tool actions compensation at agentic system level by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5823
• Add AnthropicBatchChatModel for the Anthropic Message Batches API by @subhashpolisetti in https://github.com/langchain4j/langchain4j/pull/5875
• MCP: surface tool result _meta in ToolExecutionResult.attributes() by @dliubarskyi in https://github.com/langchain4j/langchain4j/pull/6044
• Add watsonx.ai Model Gateway support and dedicated Deployment chat models by @andreadimaio in https://github.com/langchain4j/langchain4j/pull/5979
• Add thinking support to google-genai by @subhashpolisetti in https://github.com/langchain4j/langchain4j/pull/6041

Other Changes

• Update the watsonx.ai SDK to the latest version by @andreadimaio in https://github.com/langchain4j/langchain4j/pull/5710
• Redact sensitive AWS auth headers (Authorization, X-Amz-Security-Toke… by @OmkarKathile007 in https://github.com/langchain4j/langchain4j/pull/5799
• fix: do not consume the response body on the OkHttp streaming path by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5806
• Decode gzip/deflate responses in Utils.readBytes by @TimurRakhmatullin86 in https://github.com/langchain4j/langchain4j/pull/5801
• fix: Map connectTimeout to connection establishment in Apache HTTP client by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5807
• fix: Read SSE error response body as UTF-8 without reassembling line separators by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5809
• Disable Apache HttpClient's automatic retries by default in ApacheHttpClient by @dliubarskyi in https://github.com/langchain4j/langchain4j/pull/5811
• fix: preserve progressToken when applying a user-supplied MCP _meta by @wushiyuanmaimob in https://github.com/langchain4j/langchain4j/pull/5792
• fix: treat an MCP $ref outside $defs as a plain schema, not a reference by @subhashpolisetti in https://github.com/langchain4j/langchain4j/pull/5790
• fix: tear down previous MCP connection on reconnect to avoid resource leak by @farzad-sedaghatbin in https://github.com/langchain4j/langchain4j/pull/5757
• fix: make Utils.merge null-safe and never return null by @Ayomipo18 in https://github.com/langchain4j/langchain4j/pull/5817
• fix: avoid NoSuchElementException in dynamic tool refresh on evicted user message by @subhashpolisetti in https://github.com/langchain4j/langchain4j/pull/5820
• chore: update google-genai to 1.63.0 by @glaforge in https://github.com/langchain4j/langchain4j/pull/5824
• build(deps): bump websocket-driver from 0.7.4 to 0.7.5 in /docs by @dependabot[bot] in https://github.com/langchain4j/langchain4j/pull/5779
• Fix NPE when LanguageModelQueryRouter receives an unknown retriever id from the LLM by @TimurRakhmatullin86 in https://github.com/langchain4j/langchain4j/pull/5796
• docs: update Valkey embedding store to 9.1 GA container by @madolson in https://github.com/langchain4j/langchain4j/pull/5768
• fix(deps): update dependency org.postgresql:postgresql to v42.7.12 [security] by @renovate[bot] in https://github.com/langchain4j/langchain4j/pull/5832
• chore(deps): update dependency org.postgresql:postgresql to v42.7.12 [security] by @renovate[bot] in https://github.com/langchain4j/langchain4j/pull/5833
• chore(deps): bump dompurify from 3.4.11 to 3.4.12 in /docs by @dependabot[bot] in https://github.com/langchain4j/langchain4j/pull/5830
• chore(deps): bump body-parser from 1.20.4 to 1.20.6 in /docs by @dependabot[bot] in https://github.com/langchain4j/langchain4j/pull/5829
• chore(deps): bump svgo from 3.3.3 to 3.3.4 in /docs by @dependabot[bot] in https://github.com/langchain4j/langchain4j/pull/5828
• chore(deps): bump fast-uri from 3.1.2 to 3.1.4 in /docs by @dependabot[bot] in https://github.com/langchain4j/langchain4j/pull/5827
• test: add unit tests for GoogleAiGeminiChatRequestParameters by @gaoxiaolei-s59 in https://github.com/langchain4j/langchain4j/pull/5715
• test: fix swapped read/write method references in Tablestore metadata type guard message by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5611
• fix: support 3D logit output in OnnxScoringBertCrossEncoder by @CountClaw in https://github.com/langchain4j/langchain4j/pull/5739
• chore(deps-dev): bump org.postgresql:postgresql from 42.7.11 to 42.7.12 in /experimental/langchain4j-experimental-hibernate by @dependabot[bot] in https://github.com/langchain4j/langchain4j/pull/5826
• docs(agentic): remove invalid executor() from async sequence example by @arimu1 in https://github.com/langchain4j/langchain4j/pull/5842
• fix: support equals on agentic proxies by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5847
• fix: return empty collection from parallel mapper agent on empty input by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5848
• fix: Complete A2A response future when the stream ends without a result by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5850
• fix(deps): update dependency io.netty:netty-codec-http2 to v4.1.136.final [security] by @renovate[bot] in https://github.com/langchain4j/langchain4j/pull/5831
• Introduce MistralAiChatRequestParameters for per-request overrides by @subhashpolisetti in https://github.com/langchain4j/langchain4j/pull/5852
• Updated opennlp-tools version to 2.5.11 by @dliubarskyi in https://github.com/langchain4j/langchain4j/pull/5857
• fix: make tool search matching locale-independent by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5861
• Avoid NullPointerException when an async agent returns null by @subhashpolisetti in https://github.com/langchain4j/langchain4j/pull/5864
• Allow json deserialization of the AgenticScope only for known and registered classes by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5872
• Fixes Ickle injection issue by @karesti in https://github.com/langchain4j/langchain4j/pull/5856
• docs(cdi): add integration page for LangChain4j CDI framework by @ehsavoie in https://github.com/langchain4j/langchain4j/pull/5873
• fix(anthropic): apply cache_control to image and pdf content blocks by @mrzgetbetter820 in https://github.com/langchain4j/langchain4j/pull/5868
• Handle the three distinct endpoint host formats depending on location type by @starksm64 in https://github.com/langchain4j/langchain4j/pull/5869
• chore(deps): bump postcss from 8.5.8 to 8.5.23 in /docs by @dependabot[bot] in https://github.com/langchain4j/langchain4j/pull/5853
• chore(deps): bump shell-quote from 1.8.4 to 1.10.0 in /docs by @dependabot[bot] in https://github.com/langchain4j/langchain4j/pull/5836
• chore(deps): bump webpack-dev-server from 5.2.5 to 5.2.6 in /docs by @dependabot[bot] in https://github.com/langchain4j/langchain4j/pull/5834
• Update actions/checkout digest to 3d3c42e by @renovate[bot] in https://github.com/langchain4j/langchain4j/pull/5854
• fix(google-genai): preserve declared property order in schemas by @subhashpolisetti in https://github.com/langchain4j/langchain4j/pull/5839
• fix: parse "reasoning" as an alias for "reasoning_content" in OpenAI chat responses by @brokenlander in https://github.com/langchain4j/langchain4j/pull/5843
• Add Builder and configurable text extraction to DoclingDocumentParser by @edeandrea in https://github.com/langchain4j/langchain4j/pull/5818
• fix: make metadata key collisions and skipped documents visible during document loading by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5542
• Fix agent using a summarizedContext with scope-dependent @ChatModelSupplier by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5879
• chore(deps): update actions/setup-java digest to 03ad4de by @renovate[bot] in https://github.com/langchain4j/langchain4j/pull/5877
• fix(deps): update dependency com.google.errorprone:error_prone_annotations to v2.50.0 by @renovate[bot] in https://github.com/langchain4j/langchain4j/pull/5245
• fix(deps): update dependency com.microsoft.azure:msal4j to v1.25.1 by @renovate[bot] in https://github.com/langchain4j/langchain4j/pull/5246
• fix: add null/empty choices guard in AzureOpenAiChatModel by @farzad-sedaghatbin in https://github.com/langchain4j/langchain4j/pull/4815
• docs: fix Javadoc typo and test empty metadataCssSelectors match in HtmlToTextDocumentTransformer by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5452
• fix(mistralai): guard against empty/null choices in MistralAiChatModel.doChat by @dong0713 in https://github.com/langchain4j/langchain4j/pull/5821
• fix: Use configured similarity metric in CassandraEmbeddingStore search instead of hardcoded COSINE by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5507
• fix: Strip only a single leading space from SSE data field by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5532
• chore(deps): update dependency maven to v3.9.16 by @renovate[bot] in https://github.com/langchain4j/langchain4j/pull/5883
• chore(deps): update dependency com.ibm.db2:jcc to v12.1.5.0 by @renovate[bot] in https://github.com/langchain4j/langchain4j/pull/5882
• Fix parallel agent failures surfacing as RuntimeException instead of AgentInvocationException by @gnsharans in https://github.com/langchain4j/langchain4j/pull/5962
• Complete A2A response future exceptionally on interrupted task states by @angus-guo in https://github.com/langchain4j/langchain4j/pull/5924
• chore(deps-dev): bump org.jsoup:jsoup from 1.22.2 to 1.23.1 in /langchain4j-agentic-patterns by @dependabot[bot] in https://github.com/langchain4j/langchain4j/pull/6005
• fix(deps): update dependency org.jsoup:jsoup to v1.23.1 [security] by @renovate[bot] in https://github.com/langchain4j/langchain4j/pull/6004
• chore(deps): bump org.jsoup:jsoup from 1.18.3 to 1.23.1 in /langchain4j-oracle by @dependabot[bot] in https://github.com/langchain4j/langchain4j/pull/6002
• chore(deps): bump io.micrometer:micrometer-core from 1.16.5 to 1.16.6 in /langchain4j-micrometer-metrics by @dependabot[bot] in https://github.com/langchain4j/langchain4j/pull/5998
• chore(deps): bump js-yaml from 3.14.2 to 3.15.1 in /docs by @dependabot[bot] in https://github.com/langchain4j/langchain4j/pull/6011
• chore(deps): bump brace-expansion from 1.1.13 to 1.1.18 in /docs by @dependabot[bot] in https://github.com/langchain4j/langchain4j/pull/6010
• chore(deps): bump dompurify from 3.4.12 to 3.4.13 in /docs by @dependabot[bot] in https://github.com/langchain4j/langchain4j/pull/6009
• chore(deps): bump mermaid from 11.15.0 to 11.16.1 in /docs by @dependabot[bot] in https://github.com/langchain4j/langchain4j/pull/6000
• chore(deps): bump fast-uri from 3.1.4 to 3.1.5 in /docs by @dependabot[bot] in https://github.com/langchain4j/langchain4j/pull/5966
• fix: Include cache token fields in AnthropicTokenUsage equals and hashCode by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5893
• fix: Apply disableParallelToolUse when toolChoice is not set in Anthropic requests by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5892
• fix: parse a bare JSON array in collection output parsers by @farzad-sedaghatbin in https://github.com/langchain4j/langchain4j/pull/5905
• fix: use the exact metadata key in Coherence metadata filters by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5907
• fix: report Amazon Bedrock provider and model name from BedrockCohereEmbeddingModel by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5909
• fix: Handle nested Not in ChromaMetadataFilterMapper by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5912
• fix: Accept any memoryId type in CassandraChatMemoryStore by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5919
• fix: Validate ids/embeddings/textSegments size in ChromaEmbeddingStore.addAll by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5913
• fix: Stop double-normalizing relevance scores in CassandraEmbeddingStore by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5920
• Clean up AI Services doc formatting by @Abdullah8006 in https://github.com/langchain4j/langchain4j/pull/5940
• fix: Default ElasticsearchContentRetriever maxResults to 3 as documented by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5932
• fix: Render non-String metadata values in DefaultContentInjector by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5936
• fix: Repair toBuilder() copy constructors in observability events by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5937
• fix: Add missing Gemini finish reasons to prevent response deserialization failure by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5948
• fix: Report TOOL_EXECUTION finish reason for Google GenAI tool call responses by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5950
• fix: Correct mislabeled safeSearch field in WebSearchRequest toString by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5938
• fix: Check HTTP status in GeminiFiles.listFiles instead of returning an empty list by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5949
• fix: Map JsonAnyOfSchema to Google GenAI anyOf schema by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5951
• Handle non-complex metadata field when reading Azure AI Search results by @subhashpolisetti in https://github.com/langchain4j/langchain4j/pull/5862
• fix: Mask secret HTTP headers regardless of the JVM default locale by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5961
• fix: Restore serialization of Hugging Face request options by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5956
• fix: Return generated text when GPULlama3 generation stops at maxTokens by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5959
• Override equals, hashCode and toString in BedrockChatRequestParameters by @subhashpolisetti in https://github.com/langchain4j/langchain4j/pull/5969
• fix: return null instead of throwing NPE for URIs without a file name by @Tundesjaiyesmi in https://github.com/langchain4j/langchain4j/pull/5977
• Fix AgentInvocationException wrapping in the DeferredResponse timeout overload by @subhashpolisetti in https://github.com/langchain4j/langchain4j/pull/5986
• Keep generated images from every streamed chunk by @subhashpolisetti in https://github.com/langchain4j/langchain4j/pull/5972
• fix: make Elasticsearch full text and vector search return structurally identical TextSegments by @zya1020 in https://github.com/langchain4j/langchain4j/pull/5975
• Send tool parameters as JSON Schema when they have no typed form by @monrax in https://github.com/langchain4j/langchain4j/pull/6015
• Fix interface-level @SystemMessage being ignored in AI Services by @subhashpolisetti in https://github.com/langchain4j/langchain4j/pull/5991
• Support the Ollama truncate field so an over-long prompt can fail instead of being trimmed by @monrax in https://github.com/langchain4j/langchain4j/pull/6018
• fix: only serialize responseLogprobs and enableEnhancedCivicAnswers when explicitly set by @Pahkho in https://github.com/langchain4j/langchain4j/pull/6016
• fix: make Utils.copy return an actual copy instead of an unmodifiable view by @Tundesjaiyesmi in https://github.com/langchain4j/langchain4j/pull/6020
• fix: Use a new Jlama session id for each request by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/6027
• Fix Bedrock default request parameters to preserve serviceTier and responseFormat by @subhashpolisetti in https://github.com/langchain4j/langchain4j/pull/6031
• Fix Bedrock guardrail assessment handling for ConverseTrace without a guardrail by @subhashpolisetti in https://github.com/langchain4j/langchain4j/pull/6029
• Fix Pinecone segment text being overwritten by reserved metadata key by @subhashpolisetti in https://github.com/langchain4j/langchain4j/pull/6033
• fix: honor lateChunking in Jina multimodal embedding requests by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/6026
• Fix returnThinking being ignored by BedrockStreamingChatModel by @subhashpolisetti in https://github.com/langchain4j/langchain4j/pull/6035
• fix: keep the sign of negative numbers in SqlFilterParser IN lists by @masiljangajji in https://github.com/langchain4j/langchain4j/pull/6037
• fix: Reset entity-declared metadata attributes in HibernateEmbeddingStore.createEntities by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5958
• Add generateContentConfigCustomizer to GoogleGenAiBatchChatModel by @angus-guo in https://github.com/langchain4j/langchain4j/pull/5880
• Update dependency org.apache.httpcomponents.core5:httpcore5 to v5.4.3 [SECURITY] by @renovate[bot] in https://github.com/langchain4j/langchain4j/pull/6040
• Fix Pinecone reserved text key being returned in metadata by @subhashpolisetti in https://github.com/langchain4j/langchain4j/pull/6043
• fix: Read error response body as UTF-8 without reassembling line separators by @angus-guo in https://github.com/langchain4j/langchain4j/pull/6021
• Allow to provide an agent with an external memory ID supplier by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5903
• chore(deps): bump org.apache.httpcomponents.client5:httpclient5 from 5.6.1 to 5.6.3 in /http-clients/langchain4j-http-client-apache by @dependabot[bot] in https://github.com/langchain4j/langchain4j/pull/6049
• Fix Validate maxSegmentsPerBatch in BedrockCohereEmbeddingModel by @subhashpolisetti in https://github.com/langchain4j/langchain4j/pull/6060
• Fix Convert a JSON null to a null Document instead of the string "null" by @subhashpolisetti in https://github.com/langchain4j/langchain4j/pull/6058
• Fix Bedrock stop-reason mapping for AWS-added stop reasons by @subhashpolisetti in https://github.com/langchain4j/langchain4j/pull/6056
• fix: honor the negation in SqlFilterParser NOT BETWEEN by @masiljangajji in https://github.com/langchain4j/langchain4j/pull/6063
• fix: apply retrieval constraints to Elasticsearch full text search by @FyCode007 in https://github.com/langchain4j/langchain4j/pull/6046

New Contributors

• @OmkarKathile007 made their first contribution in https://github.com/langchain4j/langchain4j/pull/5799
• @TimurRakhmatullin86 made their first contribution in https://github.com/langchain4j/langchain4j/pull/5801
• @madolson made their first contribution in https://github.com/langchain4j/langchain4j/pull/5768
• @CountClaw made their first contribution in https://github.com/langchain4j/langchain4j/pull/5739
• @arimu1 made their first contribution in https://github.com/langchain4j/langchain4j/pull/5842
• @mrzgetbetter820 made their first contribution in https://github.com/langchain4j/langchain4j/pull/5868
• @starksm64 made their first contribution in https://github.com/langchain4j/langchain4j/pull/5869
• @brokenlander made their first contribution in https://github.com/langchain4j/langchain4j/pull/5843
• @dong0713 made their first contribution in https://github.com/langchain4j/langchain4j/pull/5821
• @gnsharans made their first contribution in https://github.com/langchain4j/langchain4j/pull/5962
• @Abdullah8006 made their first contribution in https://github.com/langchain4j/langchain4j/pull/5940
• @Tundesjaiyesmi made their first contribution in https://github.com/langchain4j/langchain4j/pull/5977
• @zya1020 made their first contribution in https://github.com/langchain4j/langchain4j/pull/5975
• @monrax made their first contribution in https://github.com/langchain4j/langchain4j/pull/6015
• @masiljangajji made their first contribution in https://github.com/langchain4j/langchain4j/pull/6037
• @FyCode007 made their first contribution in https://github.com/langchain4j/langchain4j/pull/6046

Full Changelog: https://github.com/langchain4j/langchain4j/compare/1.18.1...1.19.0