feat(core): Expose ReActAgent state-cache cleanup APIs

[jujn]

No description provided.

[Copilot]

Pull request overview

This PR exposes explicit APIs to clear ReActAgent’s in-memory per-session caches (agent state + permission engine), and wires that functionality through HarnessAgent so callers can release cached session data without affecting persisted AgentStateStore contents.

Changes:

• Added ReActAgent.clearStateCache(...) overloads to clear all cached slots or a targeted (userId, sessionId) slot.
• Added HarnessAgent.clearStateCache(...) passthrough methods delegating to the wrapped ReActAgent.
• Added unit tests validating targeted/all-cache clearing and verifying persisted state remains intact after cache eviction.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.

File	Description
agentscope-harness/src/test/java/io/agentscope/harness/agent/HarnessAgentTest.java	Adds a harness-level test ensuring HarnessAgent.clearStateCache(ctx) evicts only the targeted delegate session cache.
agentscope-harness/src/main/java/io/agentscope/harness/agent/HarnessAgent.java	Exposes clearStateCache overloads on HarnessAgent by delegating to the wrapped ReActAgent.
agentscope-core/src/test/java/io/agentscope/core/agent/ReActAgentPerSessionStateTest.java	Adds coverage for clearing all caches, clearing a single session cache, and preserving persisted state after cache eviction.
agentscope-core/src/main/java/io/agentscope/core/ReActAgent.java	Implements cache-eviction APIs for per-session AgentState and permission engine caches; clears caches on close().

[codecov]

Codecov Report

❌ Patch coverage is 69.23077% with 4 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
...e/src/main/java/io/agentscope/core/ReActAgent.java	69.23%	1 Missing and 3 partials ⚠️

📢 Thoughts on this report? Let us know!