AgentScope Java Files

This release introduces Long-term Memory capabilities, bolsters MCP integration, and adds built-in execution tracing mechanisms, alongside an important refactoring of skill metadata and crucial stability improvements across the core framework.

🌟 Key Highlights

Bailian Long-Term Memory

AgentScope-Java v1.0.12 introduces robust support for Bailian long-term memory (#1188). This significantly enhances the ability of agents to maintain context, recall historical interactions, and build continuous relationships over extended operational sessions.

Observability & Tracing Enhancements

This release provides developers with deeper insights into agent execution and messaging.

• JSONL Trace Exporter: Introduced a built-in JSONL trace exporter via Hook (#983), allowing developers to easily persist detailed, file-based execution traces for offline debugging and analysis.
• OpenTelemetry Focus: Renamed and aligned official documentation to better highlight Observability & Studio with OpenTelemetry tracing guides (#1186, [#1107]).

MCP Capabilities & Skill Refactoring

We have expanded the Model Context Protocol (MCP) integrations and overhauled how skills are structured.

• MCP Elicitation & Schemas: Added support for the elicitation feature in MCP (#798) and exposed MCP output schemas directly within tool definitions for tighter ecosystem integration (#1221).
• Map-based Skill Metadata: Executed a major refactoring (refactor(skill)!) to replace fixed skill metadata with a flexible, map-based metadata system, removing legacy template-based constructors in SkillBox (#1275).

🚀 New Features

• Model Integration & Multimodality:
• Multimodal Message Blocks: Added native support for image and video block parameters within user message content in the core framework (#1193).
• Model Family Expansion: Added the Qwen3.6 model family to multimodal API endpoint routing (#1179) and implemented a Kimi model check in DashScopeHttpClient (#1314).

• Gemini Client Support: Added baseUrl builder support for Gemini connections (#1174).

• Core Automation & Execution:

• Quartz Initial Messages: Supported passing initial input messages in Quartz scheduler workflows (#1227).
• Modifiable PreCall Events: Updated PreCallEvent handling to be modifiable, aligning it with PreReasoningEvent patterns (#1155).

🛠️ Refactoring & Fixes

• Agent, Tool & Memory Stability:
• Tool Execution Guardrails: Sanitized tool call arguments JSON on interrupted streams to prevent 400 bad requests (#1148). Prevented presetParameters from being erroneously overridden by tool-call input (#1172). Allowed null values for optional nested object fields (#1170).
• Agent Logic Refinements: Optimized schema parameter handling for structured outputs (#1312). Ensured assistant messages containing tool_calls always include the content field (#1283). Prevented SubAgent name collisions via deterministic hashing for unsupported characters (#1141). Removed redundant hasPendingToolUse checks in core execution (#1162) and fixed three core agent/tool management bugs (#1161, [#1167], [#1177]).

• Memory Management: Preserved ToolUseBlock structure during large message compression strategies (#1311). Resolved a list modification detection bug during incremental session updates (#1228).

• Skill Management & Data Stores:

• Skill Robustness: Ensured thread-safe file uploads in SkillBox utilizing fine-grained path locks (#1109). Fixed an issue where an existing skill prevented others from being saved (#1049). Ignored complex YAML frontmatter to prevent parsing failures (#1043). Supported custom charsets for ZIP extraction (#1276) and validated resource paths before activating skills (#1308).

• Session & RAG Fixes: Ensured MySQL sessions commit writes properly when auto-commit is disabled (#1091). Added missing payload structures for ElasticsearchStore in RAG setups (#1048).

• Observability, UI & A2A Ecosystem:

• AG-UI Alignment: Converted SUMMARY events into valid AG-UI messages (#1168). Fixed AG-UI reasoning/tool event handling (#1231) and patched a stream state leak causing duplicate events upon retry (#1300).
• Telemetry Corrections: Utilized max instead of sum for streaming token usage aggregation to report accurate telemetry (#1098). Handled Map types safely in getChatUsage() post-deserialization (#1118).

• A2A Comms: Fixed A2A Agent lifecycle events to properly support TTSHooks and reasoning completions (#1150). Hardened host fallback mechanisms and guarded against schema definition conflicts in A2A Servers (#1191).

• Dependencies & Build Systems:

• Resolved dependency conflicts by downgrading json-schema-validator (v3.0.1 to v2.0.0) (#1241) and added spring-boot-configuration-processor to annotation paths (#1116).
• Fixed missing imports breaking test suites (#1313).
• Bumped critical dependencies including Milvus-SDK (v2.6.17), Jedis (v7.4.1), OpenTelemetry BOM (v1.61.0), Google GenAI (v1.45.0), Spring WebFlux (v7.0.7), and Micronaut (v4.10.12).

❤️ New Contributors

• @miniceM made their first contribution in [#798]
• @park338 made their first contribution in [#983]
• @superjvjkdf made their first contribution in [#1049]
• @Xiaozhiyao made their first contribution in [#1091]
• @mvanhorn made their first contribution in [#1118]
• @xichaodong made their first contribution in [#1162]
• @rrrjqy66 made their first contribution in [#1174]
• @Fruank4 made their first contribution in [#1167]
• @lynx009 made their first contribution in [#1168]
• @RuleViz made their first contribution in [#1191]

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