LangChain for Java Files

Notable Changes

• Introduce new Debate agentic pattern by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5382
• Allow a tool to declare its compensating action and invoke it when it fails by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5171
• Add Oracle Database for Chat Memory by @psilberk in https://github.com/langchain4j/langchain4j/pull/5351
• Expose unmapped raw streaming events by @dliubarskyi in https://github.com/langchain4j/langchain4j/pull/5589

Other Changes

• Migrate OpenAI image models from DALL-E to new GPT image API by @edeandrea in https://github.com/langchain4j/langchain4j/pull/5373
• Document non-Result IMMEDIATE behavior by @patriot1burke in https://github.com/langchain4j/langchain4j/pull/5372
• fix(elasticsearch): apply hybrid filters to full-text retriever by @SJvaca30 in https://github.com/langchain4j/langchain4j/pull/5387
• Update dependency io.netty:netty-codec-http2 to v4.1.135.Final [SECURITY] by @renovate[bot] in https://github.com/langchain4j/langchain4j/pull/5392
• Surface MCP icons in MCP client models by @DragonFSKY in https://github.com/langchain4j/langchain4j/pull/5381
• Fix filtering for non-TextSegment entries in InMemoryEmbeddingStore by @Q1Xuan in https://github.com/langchain4j/langchain4j/pull/5405
• Add an agent factory to the AgentConfigurator allowing to wire agents generated through the Quarkus extension by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5397
• feat(agentic): generalise SupplierParameterResolver to all supplier types by @mdproctor in https://github.com/langchain4j/langchain4j/pull/5394
• Add support for IBM watsonx.ai deployed models by @andreadimaio in https://github.com/langchain4j/langchain4j/pull/5344
• chore: update google-genai dependency to 1.58.0 by @glaforge in https://github.com/langchain4j/langchain4j/pull/5420
• Allow to declaratively create an agentic system with a single A2A agent by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5408
• Upgrade A2A to version 1.0.0.Final by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5414
• Allow to use InvocationParameters with agents by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5417
• Allow to optionally propagate the exception raised by a tool execution by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5413
• docs: Remove broken PaLM 2 link from language models comparison table by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5432
• Expose MCP server instructions by @fw-coder-tl in https://github.com/langchain4j/langchain4j/pull/5425
• feat(agentic): support SupplierParameterResolver for @ParallelExecutor by @DragonFSKY in https://github.com/langchain4j/langchain4j/pull/5437
• Fix: Log exceptions when tool execution fails by @Q1Xuan in https://github.com/langchain4j/langchain4j/pull/5427
• fix: infinite loop in OnnxBertBiEncoder.partition for oversized subword runs by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5454
• fix: Throw typed exception for null-valued required shell tool argument by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5456
• Fix broken Anthropic documentation links by @angus-guo in https://github.com/langchain4j/langchain4j/pull/5460
• Add tests demonstrating how guardrails work with agents by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5450
• Allow to set user and system message providers declaratively on agents by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5448
• chore(deps): bump dompurify from 3.4.0 to 3.4.10 in /docs by @dependabot[bot] in https://github.com/langchain4j/langchain4j/pull/5459
• fix: Validate bucket and key in TencentCosDocumentLoader.loadDocument by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5434
• fix: swapped account and container names in Azure Blob Storage document source URL by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5430
• fix: Decode Markdown as UTF-8 instead of the platform default charset by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5436
• docs: fix 'allows to' grammar in Guardrail Javadocs by @aswego123 in https://github.com/langchain4j/langchain4j/pull/5438
• docs: fix 'allow(s) to' grammar across docs and Javadocs by @aswego123 in https://github.com/langchain4j/langchain4j/pull/5439
• fix(tests): normalize JAR entry path separators for Windows compatibility by @Demonese in https://github.com/langchain4j/langchain4j/pull/5422
• docs: add Javadoc to VoyageAiEmbeddingModel and VoyageAiScoringModel … by @vjayakumarvjk-art in https://github.com/langchain4j/langchain4j/pull/5412
• docs: add Javadoc to Watsonx builder methods across all model classes by @vjayakumarvjk-art in https://github.com/langchain4j/langchain4j/pull/5415
• chore(deps): bump shell-quote from 1.8.3 to 1.8.4 in /docs by @dependabot[bot] in https://github.com/langchain4j/langchain4j/pull/5411
• chore(deps): bump launch-editor from 2.13.2 to 2.14.1 in /docs by @dependabot[bot] in https://github.com/langchain4j/langchain4j/pull/5461
• Fix Milvus L2 relevance score mapping by @Q1Xuan in https://github.com/langchain4j/langchain4j/pull/5428
• feat: implement image token estimation for HIGH/AUTO detail levels by @RuleViz in https://github.com/langchain4j/langchain4j/pull/5388
• docs: add Hazelcast embedding store and chat memory store integration by @arodionov in https://github.com/langchain4j/langchain4j/pull/5449
• fix: LoopAgent subAgents() Javadoc: sub-agents run in sequence, not in parallel by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5475
• fix: Coerce Number values to short and byte target types in agentic argument adaptation by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5469
• fix: declarative agentic Javadoc. replace removed @SubAgent with the array form by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5473
• chore(deps): bump ws in /docs by @dependabot[bot] in https://github.com/langchain4j/langchain4j/pull/5463
• fix: make Byte/Short/BigInteger/BigDecimal output parsers consistent with the other numeric parsers by @subhashpolisetti in https://github.com/langchain4j/langchain4j/pull/5465
• fix: omit blank/null Content-Type part header in JDK multipart body by @Q1Xuan in https://github.com/langchain4j/langchain4j/pull/5480
• fix: Omit blank/null Content-Type part header in Apache multipart body by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5467
• introduce AnthropicChatRequestParameters for per-call overrides (#5301) by @imyash2004 in https://github.com/langchain4j/langchain4j/pull/5390
• Update OpenAI Java SDK to 4.41.0 by @jdubois in https://github.com/langchain4j/langchain4j/pull/5485
• chore(deps): bump webpack-dev-server from 5.2.3 to 5.2.5 in /docs by @dependabot[bot] in https://github.com/langchain4j/langchain4j/pull/5482
• chore: update google-genai dependency to 1.59.0 by @glaforge in https://github.com/langchain4j/langchain4j/pull/5488
• Update Dev Container support by @jdubois in https://github.com/langchain4j/langchain4j/pull/5489
• fix: Surface failed A2A tasks as exceptions instead of empty results by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5471
• fix: Throw MissingArgumentException for missing required input in McpClientAgentInvoker by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5477
• fix: unanimousLastWord convergence to normalize verdict token by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5479
• fix: Include $defs in Anthropic tool input schema for tools using schema references by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5499
• fix: prevent integer overflow in AwsDocumentConverter for long and BigInteger tool arguments by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5503
• fix: add langchain4j-document-parser-docling to BOM by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5505
• fix: wmv MIME type mapping key in CustomMimeTypesFileTypeDetector by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5511
• fix: Make ElasticsearchContentRetriever minScore boundary inclusive by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5513
• Preserve response whitespace when parsing GPULlama3 thinking content by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5517
• Render Gemini executable code as a valid Markdown fenced block by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5520
• Report total token count from Google GenAI usage metadata by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5519
• fix: Escape SQL LIKE single-character wildcard in Hibernate metadata contains filter by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5522
• fix: Ensure custom HuggingFace base URL ends with a trailing slash by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5534
• fix: Map model download exceptions for all Jlama models by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5536
• fix: mask apiKey in JinaScoringModel and JinaClient builder toString by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5539
• Forward enableEnhancedCivicAnswers to the Gemini generation config by @subhashpolisetti in https://github.com/langchain4j/langchain4j/pull/5547
• Fix NPE in OpenAiOfficialChatModel/StreamingChatModel with user-supplied OpenAIClient by @PSchmitz-Valckenberg in https://github.com/langchain4j/langchain4j/pull/5548
• OpenAiImageModel: implement edits by @dliubarskyi in https://github.com/langchain4j/langchain4j/pull/5549
• docs: add Javadoc to AgentBuilder methods by @vjayakumarvjk-art in https://github.com/langchain4j/langchain4j/pull/5543
• Update Azure SDK BOM to 1.3.7 and migrate to azure-search-documents 12.0.0 by @jdubois in https://github.com/langchain4j/langchain4j/pull/5486
• fix: run tool loop before re-validating output guardrails on reprompt by @PSchmitz-Valckenberg in https://github.com/langchain4j/langchain4j/pull/5082
• fix: Map ContainsString filter to regex in MongoDB Atlas metadata filter mapper by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5553
• fix: Add space separator in chat model observation span contextual name by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5557
• fix: mask apiKey in NomicEmbeddingModel builder toString by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5559
• fix: Populate logProbs in OpenAI streaming response metadata by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5561
• fix: Preserve BigInteger values when converting MCP structured content by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5572
• fix: skip recording token usage metric when token count is null by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5574
• fix: Add dockerTlsVerify builder method and deprecate misspelled dockerTslVerify by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5575
• fix: Escape backslashes in Milvus metadata filter values by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5577
• fix: Parse Ollama timestamps with variable-length fractional seconds by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5579
• fix: Guard against null content in Mistral FIM streaming event listener by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5581
• fix: Honor strictJsonSchema option in MistralAiStreamingChatModel by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5583
• Add Oracle chat memory store integration link by @psilberk in https://github.com/langchain4j/langchain4j/pull/5555
• Allow to programmatically set the A2AService implementation by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5567
• fix: Escape double quotes and backslashes in Cosmos DB NoSQL filter values by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5501
• test: add unit tests for Google AI Gemini FinishReasonMapper by @gaoxiaolei-s59 in https://github.com/langchain4j/langchain4j/pull/5492
• http-client-jdk: set Content-Type for multipart/form-data requests by @mohit-twelvelabs in https://github.com/langchain4j/langchain4j/pull/5566
• fix: Generate native IN clause for single-type IN/NOT IN filters in Oracle store by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5563
• chore(deps): bump dompurify from 3.4.10 to 3.4.11 in /docs by @dependabot[bot] in https://github.com/langchain4j/langchain4j/pull/5490
• docs: add Javadoc to GoogleGenAiChatModel and GoogleGenAiStreamingCha… by @vjayakumarvjk-art in https://github.com/langchain4j/langchain4j/pull/5374
• test: add HTTP response verification for Ollama thinking mode by @RuleViz in https://github.com/langchain4j/langchain4j/pull/5389
• feat(bedrock): add enableAdaptiveReasoning for Claude Opus 4.7+ by @Aditya-Pimpalkar in https://github.com/langchain4j/langchain4j/pull/5358
• fix(anthropic): gracefully skip [DONE] and unknown SSE frames (GH-5384) by @anuragg-saxenaa in https://github.com/langchain4j/langchain4j/pull/5398
• fix(anthropic): support replaying malformed JSON in tool_use arguments by @Baqirrizvidev in https://github.com/langchain4j/langchain4j/pull/5335
• fix(gemini): add IMAGE_RECITATION to GeminiFinishReason enum by @Pahkho in https://github.com/langchain4j/langchain4j/pull/5256
• fix: throw on unsupported Azure OpenAI service version instead of silently falling back by @PSchmitz-Valckenberg in https://github.com/langchain4j/langchain4j/pull/5260
• fix(qdrant): use Query RPC instead of legacy Search RPC to retrieve vectors by @sam-hey in https://github.com/langchain4j/langchain4j/pull/5314
• Onnxruntime.dll: Dynamic Link Library (DLL) initialization routine failed by @moaedy in https://github.com/langchain4j/langchain4j/pull/5242
• fix(vespa): rethrow exception in VespaEmbeddingStoreIT#deployVespaApp by @serelli in https://github.com/langchain4j/langchain4j/pull/5266
• fix(gpullama3): replace System.err.println with SLF4J logger by @serelli in https://github.com/langchain4j/langchain4j/pull/5265
• fix(deps): update hibernate-orm monorepo to v7.4.2.final - autoclosed by @renovate[bot] in https://github.com/langchain4j/langchain4j/pull/5254
• (docs) Support to SQLServer's half-precision float support in vector data type by @odelpozo-denodo in https://github.com/langchain4j/langchain4j/pull/5418
• fix: Escape single quotes in Infinispan metadata filter Ickle queries by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5540
• Bound to an upper limit the number of entries retained by the AgentMonitor by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5587
• fix: Set required input_audio format from audio mime type in OpenAI official chat model by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5591
• chore(deps): update actions/checkout digest to df4cb1c by @renovate[bot] in https://github.com/langchain4j/langchain4j/pull/5586
• Escape LIKE wildcards in Milvus containsString filter (match [#5522]/#5553) by @greymoth-jp in https://github.com/langchain4j/langchain4j/pull/5600
• fix: Validate ids/embeddings/textSegments size in PineconeEmbeddingStore.addAll by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5593
• fix: match ContainsString as a literal substring in PgVector filter by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5595
• fix: support Float and Double values in Qdrant equality metadata filters by @thswlsqls in https://github.com/langchain4j/langchain4j/pull/5598
• Support input_image format for OpenAI-compatible images by @smf-h in https://github.com/langchain4j/langchain4j/pull/5564
• Allow specifying only a subset of MCP clients considered in the tool provider by @jmartisk in https://github.com/langchain4j/langchain4j/pull/5602

New Contributors

• @SJvaca30 made their first contribution in https://github.com/langchain4j/langchain4j/pull/5387
• @Q1Xuan made their first contribution in https://github.com/langchain4j/langchain4j/pull/5405
• @mdproctor made their first contribution in https://github.com/langchain4j/langchain4j/pull/5394
• @fw-coder-tl made their first contribution in https://github.com/langchain4j/langchain4j/pull/5425
• @angus-guo made their first contribution in https://github.com/langchain4j/langchain4j/pull/5460
• @aswego123 made their first contribution in https://github.com/langchain4j/langchain4j/pull/5438
• @Demonese made their first contribution in https://github.com/langchain4j/langchain4j/pull/5422
• @RuleViz made their first contribution in https://github.com/langchain4j/langchain4j/pull/5388
• @arodionov made their first contribution in https://github.com/langchain4j/langchain4j/pull/5449
• @subhashpolisetti made their first contribution in https://github.com/langchain4j/langchain4j/pull/5465
• @imyash2004 made their first contribution in https://github.com/langchain4j/langchain4j/pull/5390
• @gaoxiaolei-s59 made their first contribution in https://github.com/langchain4j/langchain4j/pull/5492
• @mohit-twelvelabs made their first contribution in https://github.com/langchain4j/langchain4j/pull/5566
• @Aditya-Pimpalkar made their first contribution in https://github.com/langchain4j/langchain4j/pull/5358
• @anuragg-saxenaa made their first contribution in https://github.com/langchain4j/langchain4j/pull/5398
• @Baqirrizvidev made their first contribution in https://github.com/langchain4j/langchain4j/pull/5335
• @Pahkho made their first contribution in https://github.com/langchain4j/langchain4j/pull/5256
• @sam-hey made their first contribution in https://github.com/langchain4j/langchain4j/pull/5314
• @moaedy made their first contribution in https://github.com/langchain4j/langchain4j/pull/5242
• @serelli made their first contribution in https://github.com/langchain4j/langchain4j/pull/5266
• @greymoth-jp made their first contribution in https://github.com/langchain4j/langchain4j/pull/5600
• @smf-h made their first contribution in https://github.com/langchain4j/langchain4j/pull/5564

Full Changelog: https://github.com/langchain4j/langchain4j/compare/1.16.3...1.17.0