fix(core): add ToolUseBlock.getSuggestedRules() implementation

[ShuiMu-peng]

实现了 ToolUseBlock.getSuggestedRules() 的完整功能，该功能已在文档中描述但尚未实现。

变更内容
关闭: #1592
核心实现

• ToolUseBlock.java:
  • 添加 suggestedRules 字段用于存储权限引擎建议的规则
  • 实现 getSuggestedRules() 方法
  • 实现 withSuggestedRules() 和 withStateAndSuggestedRules() 方法
  • 支持 JSON 序列化/反序列化（字段名：suggested_rules）
• ReActAgent.java:
  • 在权限检查流程中调用 decision.getSuggestedRules()
  • 将建议的规则附加到 ToolUseBlock 上
    测试
• ToolUseBlockTest.java:
  • 添加 6 个新测试用例覆盖 suggestedRules 相关功能
  • 测试默认值、设置规则、状态保持、JSON 序列化等场景

示例

• PermissionHITLExample.java:
• 更新示例代码使用 getSuggestedRules() 方法

测试

已通过的测试

mvn test -Dtest=ToolUseBlockTest
mvn spotless:check

所有新功能都包含了单元测试，代码格式符合项目规范。

相关 Issue

此 PR 实现了已在 javadoc 中承诺但缺失的功能，修复了代码与文档不一致的问题。

检查清单

• 代码已使用 mvn spotless:apply 格式化
• 添加了相应的单元测试
• 所有测试通过
• 提交信息遵循 Conventional Commits 规范
• 保持向后兼容性

[codecov]

Codecov Report

❌ Patch coverage is 70.73171% with 12 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
...e/src/main/java/io/agentscope/core/ReActAgent.java	58.33%	9 Missing and 1 partial ⚠️
.../java/io/agentscope/core/message/ToolUseBlock.java	88.23%	2 Missing ⚠️

📢 Thoughts on this report? Let us know!

[dailingtao]

[P2] 轻量权限路径也需要传递 suggested rules

这里的复制只发生在 useEngine == true 的分支。默认构建的 ReActAgent 使用 trivial PermissionContextState，会进入下面的轻量权限路径；如果自定义 ToolBase.checkPermissions() 返回 PermissionDecision.ask(...).withSuggestedRules(...)，case ASK 仍用原始 use 构造 PermissionVerdict，这些规则会被静默丢失。

我用针对性测试复现后，完整 PermissionEngine 路径可以拿到 1 条规则，但默认轻量路径得到的是 0 条。这样本次 HITL 确认虽然仍能进行，暂停返回的 Msg 和 RequireUserConfirmEvent 中 getSuggestedRules() 却为空，调用方无法接受工具生成的规则，后续同类调用仍会重复询问。

建议让轻量路径的 ASK 分支也把 decision.getSuggestedRules() 附加到 ToolUseBlock，并补一个默认 agent 下的端到端回归测试。

[ShuiMu-peng]

已经处理，麻烦再review下

[dailingtao]

LGTM