fix(core): custom HITL deny reason and tool result events on ASK deny

[arimu1]

AgentScope-Java Version

2.0.1-SNAPSHOT (main)

Description

Fixes #2492.

When permission HITL is in ASK and the user rejects a tool call:

1. Custom deny reason — ConfirmResult now has an optional message field. If set (non-blank), that text is written into the denied ToolResultBlock instead of the fixed "Permission denied by user". Existing callers keep the old default.
2. Tool result events — manual deny now emits ToolResultStartEvent → ToolResultTextDeltaEvent → ToolResultEndEvent (state DENIED), matching the auto-deny path in runToolBatch. Previously only context was updated, so stream consumers never saw tool_result events for user denials.

Usage

// Prefer factory (no ambiguous 3-arg overload with List rules):
ConfirmResult.withMessage(false, toolCall, "User rejected: do not delete production data");
// or full form:
new ConfirmResult(false, toolCall, /* rules */ null, "custom reason");
// blank/null message → "Permission denied by user"

How tested

mvn -pl agentscope-core -am test -Dtest=ReActAgentHitlTest
# Tests run: 9, Failures: 0, Errors: 0

New coverage in ReActAgentHitlTest:

• custom deny message appears in the denied tool result
• blank/whitespace deny message falls back to "Permission denied by user"
• resume-with-deny stream emits Start / TextDelta / End with DENIED state

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 — ReActAgentHitlTest)
• Javadoc comments are complete and follow project conventions
• Related documentation has been updated (e.g. links, examples, etc.)
• Code is ready for review

[gemini-code-assist]

Caution

The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased.

[CLAassistant]

All committers have signed the CLA.

[codecov]

Codecov Report

❌ Patch coverage is 95.12195% with 2 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
...n/java/io/agentscope/core/event/ConfirmResult.java	87.50%	1 Missing ⚠️
.../agentscope/harness/agent/tool/AgentSpawnTool.java	92.30%	0 Missing and 1 partial ⚠️

📢 Thoughts on this report? Let us know!