feat(mcp): add title field to tool call chain for human-readable display

[amyaxy]

Add an optional title field throughout the tool invocation pipeline, providing a human-readable label alongside the machine-oriented name. When no title is defined, consumers should fall back to name for display.

Feature changes:

• AgentTool: add default getTitle() returning getName()
• ToolBase / ToolSchema / SchemaOnlyTool / McpTool: support title in builder & getter
• ToolUseBlock / ToolResultBlock: add title field, withTitle(), withIdAndNameAndTitle()
• Event classes (ToolCallStart/End, ToolResultStart/End): add toolCallTitle
• ToolUtils: new resolveToolTitle() to look up title from Toolkit
• LegacyHookDispatcher / ReActAgent: resolve and set title on ToolUseBlock
• ToolResultMessageBuilder: propagate title from originalCall
• ToolSchemaProvider: pass tool.getTitle() when building schema
• AsyncToolMiddleware / PlanModeMiddleware: pass title through events

Test changes:

• NEW: ToolUtilsTest, ToolSchemaTest, ToolResultBlockTest, ToolResultMessageBuilderTest (~36 test cases)
• EXTEND: ToolUseBlockTest, ToolBaseTest, SchemaOnlyToolTest, AsyncToolMiddlewareTest (~14 additional test cases)

AgentScope-Java Version

2.0.0-SNAPSHOT

Description

close #1590

Checklist

Please check the following items before code is ready to be reviewed.

• Code has been formatted with mvn spotless:apply
• All tests are passing (mvn test)
• Javadoc comments are complete and follow project conventions
• Related documentation has been updated (e.g. links, examples, etc.)
• Code is ready for review

[codecov]

Codecov Report

❌ Patch coverage is 80.79470% with 29 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
...e/src/main/java/io/agentscope/core/ReActAgent.java	82.05%	6 Missing and 1 partial ⚠️
...va/io/agentscope/core/message/ToolResultBlock.java	75.86%	7 Missing ⚠️
.../java/io/agentscope/core/message/ToolUseBlock.java	81.25%	3 Missing ⚠️
...e/core/agent/accumulator/ToolCallsAccumulator.java	33.33%	1 Missing and 1 partial ⚠️
...ava/io/agentscope/core/event/ToolCallEndEvent.java	50.00%	2 Missing ⚠️
...a/io/agentscope/core/event/ToolCallStartEvent.java	50.00%	2 Missing ⚠️
...a/io/agentscope/core/event/ToolResultEndEvent.java	66.66%	2 Missing ⚠️
...io/agentscope/core/event/ToolResultStartEvent.java	50.00%	2 Missing ⚠️
.../io/agentscope/core/hook/LegacyHookDispatcher.java	75.00%	0 Missing and 1 partial ⚠️
...c/main/java/io/agentscope/core/util/ToolUtils.java	85.71%	1 Missing ⚠️

📢 Thoughts on this report? Let us know!

[itxaiohanglover]

Really thorough work threading the title field through the entire chain — backward compat with the old constructors is well done. One thing I noticed: ToolBase.getTitle() returns the raw title field which can be null, but AgentTool.getTitle() has a default that returns getName(). So a ToolBase without a title returns null instead of falling back to the name, which feels inconsistent. Might be worth having ToolBase.getTitle() return title != null ? title : getName(). Other than that, nice PR.

[amyaxy]

@chickenlj 辛苦抽空帮忙看下这个PR，谢谢