Notable Changes

• Allow @Tool methods to also be inherited from superclasses and interfaces by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5328
• Introduce Blackboard agentic pattern by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5243
• Unify Batch API Response Model by @Bram-- in https://github.com/langchain4j/langchain4j/pull/4529
• feat(google-genai): introduce batch processing, grounding metadata, and image labels by @glaforge in https://github.com/langchain4j/langchain4j/pull/5255
• support non Result return type for IMMEDIATE by @patriot1burke in https://github.com/langchain4j/langchain4j/pull/5367

Breaking Changes

• Allow @Tool methods to also be inherited from superclasses and interfaces by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5328
• Unify Batch API Response Model by @Bram-- in https://github.com/langchain4j/langchain4j/pull/4529

Other Changes

• Introduce a new AgentConfigurator allowing to define an external function for agents retrieval or creation by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5269
• fix: eliminate race condition in ChatMemoryService.getOrCreateChatMemory by @PSchmitz-Valckenberg in https://github.com/langchain4j/langchain4j/pull/5253
• Fix empty ReturnBehavior list crash and add ReturnBehavior to ToolSpecification by @pedrovieira in https://github.com/langchain4j/langchain4j/pull/5279
• Allow custom resolution of agentic parameters suppliers by @geoand in https://github.com/langchain4j/langchain4j/pull/5286
• MCP: surface tool outputSchema on ToolSpecification by @farzad-sedaghatbin in https://github.com/langchain4j/langchain4j/pull/5293
• Filter away non serializable state from DefaultAgenticScope when serializing it by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5290
• Revert "Fix empty ReturnBehavior list crash and add ReturnBehavior to ToolSpecification" by @dliubarskyi in https://github.com/langchain4j/langchain4j/pull/5318
• Fix [#5277]: ToolService.shouldReturnImmediately() crashes on empty ReturnBehavior list by @dliubarskyi in https://github.com/langchain4j/langchain4j/pull/5319
• fix: make AgentMonitor thread-safe under concurrent invocations by @PSchmitz-Valckenberg in https://github.com/langchain4j/langchain4j/pull/5297
• fix(agentic): avoid duplicate declarative tool providers by @DragonFSKY in https://github.com/langchain4j/langchain4j/pull/5315
• docs: Add CockroachDB embedding store integration page by @amineelkouhen in https://github.com/langchain4j/langchain4j/pull/5262
• Upgrade pdfbox to version 3.0.7 by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5276
• Skills: add DefaultFileSystemSkill.toBuilder() and round-trip tools correctly via builder by @gaurav0107 in https://github.com/langchain4j/langchain4j/pull/5272
• ChatRequest: allow individual setters to override parameters by @dliubarskyi in https://github.com/langchain4j/langchain4j/pull/5325
• Add guardrailName() to GuardrailExecutedEvent for observability by @nhthinh-axonivy in https://github.com/langchain4j/langchain4j/pull/4940
• feat: allow OutputGuardrail failures to remove violating AiMessage from memory by @PSchmitz-Valckenberg in https://github.com/langchain4j/langchain4j/pull/5155
• fix: drain responseBuffer to BiConsumer handler when OutputGuardrails are active by @PSchmitz-Valckenberg in https://github.com/langchain4j/langchain4j/pull/5252
• fix: preserve Google AI Gemini tool call ids by @DragonFSKY in https://github.com/langchain4j/langchain4j/pull/5308
• Fix counting of max interation in agentic loop pattern by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5323
• MCP: handle inbound notifications/cancelled from server by @farzad-sedaghatbin in https://github.com/langchain4j/langchain4j/pull/5294
• chore: remove unused imports across multiple modules by @EvanYao826 in https://github.com/langchain4j/langchain4j/pull/5338
• fix: add null check for chatResponse.usage() in Watsonx models by @EvanYao826 in https://github.com/langchain4j/langchain4j/pull/5337
• docs: add Javadoc to AnthropicTokenCountEstimator and AnthropicModelC… by @vjayakumarvjk-art in https://github.com/langchain4j/langchain4j/pull/5334
• Document Tuning Engines OpenAI-compatible endpoint by @cerebrixos in https://github.com/langchain4j/langchain4j/pull/5333
• lock m-jar-p plugin version by @hboutemy in https://github.com/langchain4j/langchain4j/pull/5332
• Docs/anthropic builder javadoc by @vjayakumarvjk-art in https://github.com/langchain4j/langchain4j/pull/5331
• docs: add Javadoc to exception hierarchy in langchain4j-core by @ArvindAkula in https://github.com/langchain4j/langchain4j/pull/5322
• Bump langchain4j-agentic-a2a to A2A version 1.0.0.CR1 by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5339
• More hibernate by @beikov in https://github.com/langchain4j/langchain4j/pull/5340
• Ignore braces inside quoted JSON strings by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5354
• Remove default fallback to Netty when a custom HttpClientProvider is provided for Azure OpenAI integration. by @nhthinh-axonivy in https://github.com/langchain4j/langchain4j/pull/5355
• Add utility method for providing interfaces to implement in agentic module by @geoand in https://github.com/langchain4j/langchain4j/pull/5362
• Improve parallel agents execution by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5364
• feat(google-ai-gemini): support attaching cachedContent to generateContent requests by @Auxilus08 in https://github.com/langchain4j/langchain4j/pull/5300
• Introduce SystemMessageProvider by @geoand in https://github.com/langchain4j/langchain4j/pull/5361
• fix: fixing NPE in SupervisorPlaner by @ehsavoie in https://github.com/langchain4j/langchain4j/pull/5370
• Add support for A2A contextId and taskId by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5363
• Avoid passing useless non-serializable state to untyped agents by @mariofusco in https://github.com/langchain4j/langchain4j/pull/5365

New Contributors

• @amineelkouhen made their first contribution in https://github.com/langchain4j/langchain4j/pull/5262
• @gaurav0107 made their first contribution in https://github.com/langchain4j/langchain4j/pull/5272
• @nhthinh-axonivy made their first contribution in https://github.com/langchain4j/langchain4j/pull/4940
• @EvanYao826 made their first contribution in https://github.com/langchain4j/langchain4j/pull/5338
• @vjayakumarvjk-art made their first contribution in https://github.com/langchain4j/langchain4j/pull/5334
• @cerebrixos made their first contribution in https://github.com/langchain4j/langchain4j/pull/5333
• @ArvindAkula made their first contribution in https://github.com/langchain4j/langchain4j/pull/5322
• @Auxilus08 made their first contribution in https://github.com/langchain4j/langchain4j/pull/5300
• @patriot1burke made their first contribution in https://github.com/langchain4j/langchain4j/pull/5367

Full Changelog: https://github.com/langchain4j/langchain4j/compare/1.15.0...1.16.0