LangChain for Java Files

Notable Changes

• Agentic: Make the execution state of an agentic system persistable and recoverable by @mariofusco in https://github.com/langchain4j/langchain4j/pull/4827
• Agentic: Introduce optional agents by @mariofusco in https://github.com/langchain4j/langchain4j/pull/4850
• Skills: Support skill-scoped tools by @dliubarskyi in https://github.com/langchain4j/langchain4j/pull/4732
• Skills: Introduce ClassPathSkillLoader by @jmartisk in https://github.com/langchain4j/langchain4j/pull/4744
• MCP: Resource subscriptions by @jmartisk in https://github.com/langchain4j/langchain4j/pull/4842
• Support Tools Returning Images by @dliubarskyi in https://github.com/langchain4j/langchain4j/pull/4851
• Add HibernateContentRetriever for data retrieval through HQL queries by @mbellade in https://github.com/langchain4j/langchain4j/pull/4728
• Spring Boot 4 support by @arey in https://github.com/langchain4j/langchain4j-spring/pull/175

Other Changes

• Add name and description attributes to @P annotation by @dliubarskyi in https://github.com/langchain4j/langchain4j/pull/4846
• Refactor test retries by @dliubarskyi in https://github.com/langchain4j/langchain4j/pull/4690
• Mange langchain4j-http-client-spring-restclient in langchain4j-bom by @crmky in https://github.com/langchain4j/langchain4j/pull/4675
• fix: materialize content arguments before input guardrails by @qicesun in https://github.com/langchain4j/langchain4j/pull/4679
• Fix: propagate credentials provider to LlmUtilityServiceSettings if custom credentials are provided. by @jfigueiras-denodo in https://github.com/langchain4j/langchain4j/pull/4704
• docu: update versions to 1.12.2 and 1.12.2-beta22 by @dliubarskyi in https://github.com/langchain4j/langchain4j/pull/4709
• Update versions to 1.13.0-SNAPSHOT and 1.13.0-beta23-SNAPSHOT by @dliubarskyi in https://github.com/langchain4j/langchain4j/pull/4710
• update github actions by @dliubarskyi in https://github.com/langchain4j/langchain4j/pull/4719
• Fix arguments types comparison in supervisor's writeArgumentToScope method by @mariofusco in https://github.com/langchain4j/langchain4j/pull/4722
• Bump dependencies for OpenAI integration by @jdubois in https://github.com/langchain4j/langchain4j/pull/4721
• Fix packages and dependencies by @brunobat in https://github.com/langchain4j/langchain4j/pull/4688
• Fix Ollama ToolCall missing id field by @DragonFSKY in https://github.com/langchain4j/langchain4j/pull/4724
• Support typed output key on non-AI agents by @mariofusco in https://github.com/langchain4j/langchain4j/pull/4730
• Make ElasticsearchConfiguration extensible for custom implementations by @dadoonet in https://github.com/langchain4j/langchain4j/pull/4729
• Fix ModerationModel Javadoc by @jeanbisutti in https://github.com/langchain4j/langchain4j/pull/4684
• Enhanced log messages in ModerationModelListenerUtils by @jeanbisutti in https://github.com/langchain4j/langchain4j/pull/4685
• Refactor moderation models by @jeanbisutti in https://github.com/langchain4j/langchain4j/pull/4695
• docs: add prompt repetition documentation by @qicesun in https://github.com/langchain4j/langchain4j/pull/4739
• Fix NPE in MistralAiModerationModel when categories is null by @jeanbisutti in https://github.com/langchain4j/langchain4j/pull/4733
• Invoke tool execution hooks for concurrent tool calls by @wangji0923 in https://github.com/langchain4j/langchain4j/pull/4750
• Hibernate Content Retriever - use more deterministic test for flaky query generation by @mbellade in https://github.com/langchain4j/langchain4j/pull/4753
• Add tools execution and tokens consumption to agents monitoring by @mariofusco in https://github.com/langchain4j/langchain4j/pull/4737
• Allow configuring redirect behavior in Streamable HTTP transport by @jmartisk in https://github.com/langchain4j/langchain4j/pull/4734
• Updates to Infinispan 16.0.6 by @karesti in https://github.com/langchain4j/langchain4j/pull/4723
• Fix @V parameter resolution in agentic services by @wangji0923 in https://github.com/langchain4j/langchain4j/pull/4751
• Remove unnecessary double semicolons by @chancehee in https://github.com/langchain4j/langchain4j/pull/4785
• fix [#4791]: Make privte fields protected on workflow patterns langchain4j-agentic module by @ricardozanini in https://github.com/langchain4j/langchain4j/pull/4792
• fix: ToolExecutionResult.equals() self-comparison typo on attributes by @farzad-sedaghatbin in https://github.com/langchain4j/langchain4j/pull/4802
• Fix: Serialize Gemini tools as a JSON array by @VasilijeJukic01 in https://github.com/langchain4j/langchain4j/pull/4783
• perf: replace String += with StringBuilder in SegmentBuilder by @farzad-sedaghatbin in https://github.com/langchain4j/langchain4j/pull/4804
• Refactor McpOperationHandler to use enum-based dispatch by @kathbigra in https://github.com/langchain4j/langchain4j/pull/4778
• fix: correct logical operator in OpenAiOfficialImageModel empty-check by @farzad-sedaghatbin in https://github.com/langchain4j/langchain4j/pull/4807
• fix: add null/empty candidates guard in GeminiStreamingResponseBuilder by @farzad-sedaghatbin in https://github.com/langchain4j/langchain4j/pull/4809
• fix: support both integer and UUID point IDs in QdrantEmbeddingStore by @gaurav-code098 in https://github.com/langchain4j/langchain4j/pull/4811
• MCP _meta fields by @jmartisk in https://github.com/langchain4j/langchain4j/pull/4780
• Migrate from RestClient to ElasticsearchClient in embedding store and related classes by @dadoonet in https://github.com/langchain4j/langchain4j/pull/4736
• fix(anthropic): avoid serializing custom_parameters field by @maxlepikhin in https://github.com/langchain4j/langchain4j/pull/4818
• Ignore the .claude directory by @jmartisk in https://github.com/langchain4j/langchain4j/pull/4832
• Reduce token usage when tool calling results are sent to the LLM (disable INDENT_OUTPUT in JacksonJsonCodec) by @DragonFSKY in https://github.com/langchain4j/langchain4j/pull/4816
• MCP client pagination by @jmartisk in https://github.com/langchain4j/langchain4j/pull/4822
• Add $ref and $defs support to MCP tool specification parser by @DragonFSKY in https://github.com/langchain4j/langchain4j/pull/4793
• Handle resource/prompt list change notifications from MCP server by @jmartisk in https://github.com/langchain4j/langchain4j/pull/4825
• Anthropic ModelCatalog: populate maxInputTokens and maxOutputTokens by @pedrovieira in https://github.com/langchain4j/langchain4j/pull/4836
• Bump path-to-regexp from 0.1.12 to 0.1.13 in /docs by @dependabot[bot] in https://github.com/langchain4j/langchain4j/pull/4826
• Update dependency management section in zhipu-ai.md by @KurobaKaitou in https://github.com/langchain4j/langchain4j/pull/4797
• Update dependency io.netty:netty-codec-http2 to v4.1.132.Final [SECURITY] by @renovate[bot] in https://github.com/langchain4j/langchain4j/pull/4790
• Added documentation for the new embedding store langchain4j-community-arcadedb by @odysseaspenta in https://github.com/langchain4j/langchain4j/pull/4693
• Add option to allow skipping embeddings model download by @vesense in https://github.com/langchain4j/langchain4j/pull/4667
• Add JSON serialization support for ToolSpecification by @DragonFSKY in https://github.com/langchain4j/langchain4j/pull/4671
• Log the HTTP request/response using VertexAiAnthropicChatModel by @DakshRJain737 in https://github.com/langchain4j/langchain4j/pull/4759
• Retrive the AgenticScope of agents related events from the InvocationContext by @mariofusco in https://github.com/langchain4j/langchain4j/pull/4843
• Fix ClassPathSourceTests URL path handling by @Kimgyuilli in https://github.com/langchain4j/langchain4j/pull/4858
• Fix copy-paste errors in Guardrail Javadoc by @iaJingda in https://github.com/langchain4j/langchain4j/pull/4867
• fix: replace Stream.toList() in Android crash paths by @ZhangDT-sky in https://github.com/langchain4j/langchain4j/pull/4856
• Fix race condition in planner loop by @mariofusco in https://github.com/langchain4j/langchain4j/pull/4868
• Fix Audio.equals() and hashCode() for byte[] binaryData by @iaJingda in https://github.com/langchain4j/langchain4j/pull/4872
• Update the watsonx.ai SDK to the latest version by @andreadimaio in https://github.com/langchain4j/langchain4j/pull/4869
• Update Spring Boot integration documentation for version 4 support [#4268] by @arey in https://github.com/langchain4j/langchain4j/pull/4762
• Added entry for the ArcadeDB embedding store integration in the comparison table in the documentation by @odysseaspenta in https://github.com/langchain4j/langchain4j/pull/4848
• fix(ollama): add missing contextLength to RunningOllamaMode by @ZhangDT-sky in https://github.com/langchain4j/langchain4j/pull/4847
• fix(gemini): add @JsonProperty annotations for Android compatibility by @ww783 in https://github.com/langchain4j/langchain4j/pull/4865
• Add ChatRequestOptions to propagate listener attributes by @DragonFSKY in https://github.com/langchain4j/langchain4j/pull/4669
• OkHttpClient implementation by @dliubarskyi in https://github.com/langchain4j/langchain4j/pull/4878
• Added AutoCloseable for ONNX scoring models to prevent memory leaks by @sanel in https://github.com/langchain4j/langchain4j/pull/4876
• docs: add ChatRequestOptions usage to observability tutorial by @DragonFSKY in https://github.com/langchain4j/langchain4j/pull/4879
• Allow the parallel mapper agentic workflow to apply the output function by @mariofusco in https://github.com/langchain4j/langchain4j/pull/4881
• Preserve augmented UserMessage in tool loop when storeRetrievedContentInChatMemory is false by @DragonFSKY in https://github.com/langchain4j/langchain4j/pull/4716

New Contributors

• @crmky made their first contribution in https://github.com/langchain4j/langchain4j/pull/4675
• @jfigueiras-denodo made their first contribution in https://github.com/langchain4j/langchain4j/pull/4704
• @DragonFSKY made their first contribution in https://github.com/langchain4j/langchain4j/pull/4724
• @mbellade made their first contribution in https://github.com/langchain4j/langchain4j/pull/4728
• @wangji0923 made their first contribution in https://github.com/langchain4j/langchain4j/pull/4750
• @chancehee made their first contribution in https://github.com/langchain4j/langchain4j/pull/4785
• @ricardozanini made their first contribution in https://github.com/langchain4j/langchain4j/pull/4792
• @VasilijeJukic01 made their first contribution in https://github.com/langchain4j/langchain4j/pull/4783
• @kathbigra made their first contribution in https://github.com/langchain4j/langchain4j/pull/4778
• @gaurav-code098 made their first contribution in https://github.com/langchain4j/langchain4j/pull/4811
• @pedrovieira made their first contribution in https://github.com/langchain4j/langchain4j/pull/4836
• @KurobaKaitou made their first contribution in https://github.com/langchain4j/langchain4j/pull/4797
• @DakshRJain737 made their first contribution in https://github.com/langchain4j/langchain4j/pull/4759
• @Kimgyuilli made their first contribution in https://github.com/langchain4j/langchain4j/pull/4858
• @iaJingda made their first contribution in https://github.com/langchain4j/langchain4j/pull/4867
• @ZhangDT-sky made their first contribution in https://github.com/langchain4j/langchain4j/pull/4856
• @ww783 made their first contribution in https://github.com/langchain4j/langchain4j/pull/4865
• @sanel made their first contribution in https://github.com/langchain4j/langchain4j/pull/4876

Full Changelog: https://github.com/langchain4j/langchain4j/compare/1.12.2...1.13.0