feat(agui): Upgrade AG_UI module event mechanism

[jujn]

Description

Close #2202

1.0 stream() → 2.0 streamEvents()

This PR upgrades the AG-UI v2 integration to better align with the official AG-UI protocol and make the adapter easier to extend.

Key Changes

• Introduces a converter registry for AgentEvent -> AguiEvent mapping, allowing users to register custom AgentEventConverters that can override built-in mappings.
• Adds AguiEventEnricher support for cross-cutting event decoration such as timestamp, rawEvent, tracing metadata, or custom event rewriting.
• Adds optional AG-UI base event properties support across all AguiEvent types via timestamp and rawEvent.
• Simplifies v2 lifecycle handling by converting AgentStartEvent / AgentEndEvent into RUN_STARTED / RUN_FINISHED through the normal converter path.
• Adds optional token usage emission as CUSTOM token_usage events with delta and cumulative usage.
• Adds official RunAgentInput.resume[] support for HITL interrupts and bridges tool-call resumes back into AgentScope tool-result recovery.
• Enforces AG-UI interrupt contract rules for open interrupts: pending interrupts block new input, and resume requests must cover all open interrupts. Extends Spring Boot starter support for custom converters, custom enrichers, token usage config, request-scoped RuntimeContext resolution, and custom adapter factories.
• Adds a full AG-UI example project demonstrating streaming events, custom converters/enrichers, token usage, frontend tools, and HITL approval flow. Path: https://github.com/agentscope-ai/agentscope-java/tree/main/agentscope-examples/agui
• Updates AG-UI documentation in v1/v2 Chinese and English docs to reflect the current module behavior.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[codecov]

Codecov Report

❌ Patch coverage is 76.96335% with 264 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
...java/io/agentscope/core/agui/event/AguiEvents.java	15.38%	83 Missing and 16 partials ⚠️
.../core/agui/adapter/strategy/AguiStreamContext.java	88.09%	5 Missing and 15 partials ⚠️
...adapter/strategy/AgentLifecycleEventConverter.java	71.21%	4 Missing and 15 partials ⚠️
...ope/core/agui/processor/AguiResumeCoordinator.java	82.02%	5 Missing and 11 partials ⚠️
...agentscope/core/agui/adapter/AguiAgentAdapter.java	85.43%	11 Missing and 4 partials ⚠️
.../java/io/agentscope/core/agui/event/AguiEvent.java	89.51%	15 Missing ⚠️
...tscope/spring/boot/agui/mvc/AguiMvcController.java	64.10%	9 Missing and 5 partials ⚠️
...cope/core/agui/processor/AguiRequestProcessor.java	77.77%	6 Missing and 6 partials ⚠️
...ng/boot/agui/common/AguiRuntimeContextRequest.java	82.35%	6 Missing and 6 partials ⚠️
...cope/core/agui/converter/AguiMessageConverter.java	75.00%	5 Missing and 6 partials ⚠️
... and 8 more

📢 Thoughts on this report? Let us know!

[oss-maintainer]

Summary

This PR contains 3314 lines of changes. Review in progress.

---

Automated review by github-manager-bot