AgentScope Java Files

This release focuses on expanding Multi-Agent Orchestration, strengthening Persistent Storage, and introducing Graceful Agent Shutdown mechanisms, alongside crucial stability improvements across the core framework.

🌟 Key Highlights

Graceful Agent Shutdown

AgentScope-Java v1.0.11 implements comprehensive support for graceful agent shutdown (#909). Developers can now safely terminate agent, ensuring that all running tasks, tool executions, and state saving complete reliably without data loss or corrupted lifecycles.

Multi-Agent Patterns & Robust Messaging

AgentScope-Java v1.0.11 introduces advanced patterns and components to facilitate complex multi-agent workflows.

• Multi-Agent Practices: Introduced comprehensive multi-agent pattern practices and documentation to guide developers in building scalable agent networks (#910).
• RocketMQ A2A Component: Added a new RocketMQ component for Agent-to-Agent (A2A) communication, enabling reliable, high-throughput asynchronous messaging between agents (#990).

Persistent Storage & Ecosystem Integration

We have significantly broadened the ecosystem for managing skills and agent sessions across different database architectures and registries.

• Continued Nacos Support: Following the major Nacos registry integration in v1.0.10, we have updated the NacosSkillRepository extension module version (#1080). This ensures continued stability, compatibility, and seamless operations for your dynamic cloud-native agent orchestration.
• MySQL Skill Repository: Introduced MysqlSkillRepository to allow centralized, relational database management of agent skills (#600).
• Redis Session Client: Added a unified Redis session client supporting seamless switching between underlying Redis implementations for distributed session management (#611).

🚀 New Features

• Model, Streaming & Reasoning:
• Dynamic Structured Output: Added support for stream(List<Msg>, StreamOptions, JsonNode) to enable dynamic structured outputs during streaming responses (#931).
• Prompt Caching: Introduced cache_control support for OpenAI and DashScope protocols, allowing developers to optimize costs and latency (#985).
• Reasoning Tokens Tracking: Assigned token consumption values to ChatUsage in ReasoningChunkEvent.accumulated to track usage during model reasoning processes (#935).

• Reasoning Deserialization: Supported both reasoning_content and reasoning fields for better compatibility with varying model formatter schemas (#1086).

• Tools & Vector DBs:

• Multimodal Tools: Introduced new video multimodal tools for enhanced media processing capabilities (#921).
• Milvus & Mem0: Added support to configure database names in Milvus (#978) and resolved self-hosted authentication headers for Mem0 (#1035).
• Shell Tool Charsets: Added custom charset support for ShellCommandTool to better handle diverse OS environments (#950).

🛠️ Refactoring & Fixes

• Agent & Memory Stability:
• AutoContext Fixes: Resolved an infinite loop and strategy starvation in AutoContextMemory (#994), and preserved tool_calls/tool_result pairing during large message offloading (#1042).
• ReAct & Tool Execution: Fixed an issue in ReActAgent to preserve the user chunk callback when using a copied toolkit (#894). Handled tool execution timeouts and errors that previously caused IllegalStateException (#956). Fixed NPE in Toolkit.getTool when the tool name is null (#982).

• RAG Context: Ensured RAG-retrieved chunks use the USER role and added missing retrieveConfig in Agentic RAG mode (#949).

• OpenAI & Core Infrastructure:

• Stream Error Handling: Fixed a NullPointerException when OpenAIClient stream calls encounter errors (#800), and handled null statusCode in HttpTransportException to prevent cascading failures (#928).
• Schema Resolution: Hoisted $defs to the schema root for proper nested object $ref resolution (#1077).
• HTTP Configuration: Made the core HTTP version configurable for broader environment compatibility (#972).

• Ollama Streaming: Ensured stable message IDs for Ollama streaming responses (#1008).

• Skill Management & File System:

• Path & Character Fixes: Removed Windows reserved characters from FileSystemSkillRepository sources (#1031) and fixed MediaUtils path extension parsing (#981).
• Hidden Files: Core loader now properly ignores hidden files when loading skill resources (#1002).

• Prompt Optimization: Optimized code execution prompts and added an E2E benchmark (#1056).

• Dependencies & CI:

• Bumped essential dependencies to their latest stable versions, including Spring Boot (v4.0.4), OpenAI-Java (v4.28.0), OpenTelemetry, Elasticsearch, Milvus-SDK, and MCP-SDK for better security and performance.
• Improved Windows CI stability (#939) and standardized imports for qualified names (#953).

❤️ New Contributors

• @benym made their first contribution in [#611]
• @liwenshen2000 made their first contribution in [#950]
• @hangweizhang made their first contribution in [#968]
• @lichen782 made their first contribution in [#1035]
• @zk-drizzle made their first contribution in [#990]
• @jujn made their first contribution in [#994]
• @xuhuafeifei made their first contribution in [#1011]
• @huangxinchuan made their first contribution in [#1031]
• @MrYang-Jia made their first contribution in [#935]
• @chensk0601 made their first contribution in [#956]

Full Changelog: https://github.com/agentscope-ai/agentscope-java/compare/v1.0.10...v1.0.11