feat(hook): add summary phase hook support for ReActAgent

[AlbumenJ]

Change-Id: I84319b0c1ad175adf9137b1e1552baaad53944b3

AgentScope-Java Version

[The version of AgentScope-Java you are working on, e.g. 1.0.7, check your pom.xml dependency version or run mvn dependency:tree | grep agentscope-parent:pom(only mac/linux)]

Description

[Please describe the background, purpose, changes made, and how to test this PR]

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

[Copilot]

Pull request overview

This PR adds summary phase hook support for ReActAgent, enabling monitoring and modification of summary generation when max iterations are reached. The implementation follows the existing hook patterns for reasoning and acting phases.

Changes:

• Introduces three new event classes for summary phase hooks: PreSummaryEvent, SummaryChunkEvent, and PostSummaryEvent
• Integrates summary hooks into ReActAgent's summarizing() method with notification points for pre/post/chunk events
• Extends StreamOptions to control summary chunk and result emissions for streaming use cases

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
SummaryEvent.java	Base sealed class for summary-related events with model name and generation options context
PreSummaryEvent.java	Event fired before summary generation, allowing modification of input messages and generation options
SummaryChunkEvent.java	Event fired during summary streaming with incremental and accumulated chunk information
PostSummaryEvent.java	Event fired after summary generation, allowing modification of summary message and stop requests
HookEventType.java	Adds three new event types: PRE_SUMMARY, POST_SUMMARY, SUMMARY_CHUNK
HookEvent.java	Updates sealed permits clause to include SummaryEvent
StreamingHook.java	Adds handling for PostSummaryEvent and SummaryChunkEvent in streaming context
StreamOptions.java	Adds includeSummaryChunk and includeSummaryResult flags with corresponding builder methods
ReActAgent.java	Refactors summarizing() method to notify hooks and adds helper methods for summary hook notifications
SummaryEventTest.java	Comprehensive unit tests for all three summary event classes

Comments suppressed due to low confidence (1)

agentscope-core/src/main/java/io/agentscope/core/ReActAgent.java:854

• This method needs a Javadoc comment explaining its purpose and parameters, particularly how it handles different content block types.

    private Mono<Void> notifySummaryChunk(
            Msg chunkMsg, ReasoningContext context, GenerateOptions generateOptions) {

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[codecov]

Codecov Report

❌ Patch coverage is 71.31783% with 37 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
...e/src/main/java/io/agentscope/core/ReActAgent.java	73.01%	16 Missing and 1 partial ⚠️
...n/java/io/agentscope/core/agent/StreamingHook.java	0.00%	11 Missing and 2 partials ⚠️
...n/java/io/agentscope/core/agent/StreamOptions.java	36.36%	7 Missing ⚠️

📢 Thoughts on this report? Let us know!

[chickenlj]

LGTM.