refactor：简化DemoFrontendAgent类结构和工具导入逻辑以提高可维护性

Author: Rasic2

agents/matmaster_agent/flow_agents/agent.py

@@ -120,7 +120,13 @@
     UPLOAD_FILE,
 )
 from agents.matmaster_agent.sub_agents.built_in_agent.demo_frontend_agent import (
-    init_demo_frontend_agent,
+    DemoFrontendAgent,
+)
+from agents.matmaster_agent.sub_agents.built_in_agent.demo_frontend_agent.constant import (
+    DEMO_FRONTEND_AGENT_NAME,
+)
+from agents.matmaster_agent.sub_agents.built_in_agent.demo_frontend_agent.tool import (
+    demo_frontend_tool,
 )
 from agents.matmaster_agent.sub_agents.mapping import (
     AGENT_CLASS_MAPPING,
@@ -221,7 +227,12 @@ def after_init(self):
             instruction='',
         )
 
-        self._demo_frontend_agent = init_demo_frontend_agent()
+        self._demo_frontend_agent = DemoFrontendAgent(
+            name=DEMO_FRONTEND_AGENT_NAME,
+            model=MatMasterLlmConfig.default_litellm_model,
+            instruction='',
+            tools=[demo_frontend_tool],
+        )
 
         self.sub_agents = [
             self.chat_agent,

agents/matmaster_agent/sub_agents/built_in_agent/demo_frontend_agent/__init__.py

@@ -1,6 +1,5 @@
 from agents.matmaster_agent.sub_agents.built_in_agent.demo_frontend_agent.agent import (
     DemoFrontendAgent,
-    init_demo_frontend_agent,
 )
 from agents.matmaster_agent.sub_agents.built_in_agent.demo_frontend_agent.tool import (
     set_frontend_tool_result,
@@ -9,7 +8,6 @@
 
 __all__ = [
     'DemoFrontendAgent',
-    'init_demo_frontend_agent',
     'set_frontend_tool_result',
     'wait_for_frontend_tool_result',
 ]

agents/matmaster_agent/sub_agents/built_in_agent/demo_frontend_agent/agent.py

@@ -1,8 +1,3 @@
-"""
-Demo Frontend Agent：内置 agent，负责在需要验证的节点调用前端 demo_frontend_tool，
-同一轮 run 内下发 function_call、等待前端回传结果并写入 session.state。
-"""
-
 import logging
 import uuid
 from typing import AsyncGenerator
@@ -11,18 +6,14 @@
 from google.adk.events import Event
 
 from agents.matmaster_agent.constant import ModelRole
-from agents.matmaster_agent.core_agents.base_agents.error_agent import (
-    ErrorHandleBaseAgent,
+from agents.matmaster_agent.core_agents.public_agents.sync_agent import (
+    BaseSyncAgentWithToolValidator,
 )
 from agents.matmaster_agent.flow_agents.constant import (
     DEMO_FRONTEND_TOOL,
     DEMO_FRONTEND_TOOL_RESULT_STATE_KEY,
 )
-from agents.matmaster_agent.sub_agents.built_in_agent.demo_frontend_agent.constant import (
-    DEMO_FRONTEND_AGENT_NAME,
-)
 from agents.matmaster_agent.sub_agents.built_in_agent.demo_frontend_agent.tool import (
-    demo_frontend_tool,
     wait_for_frontend_tool_result,
 )
 from agents.matmaster_agent.utils.event_utils import (
@@ -33,15 +24,7 @@
 logger = logging.getLogger(__name__)
 
 
-class DemoFrontendAgent(ErrorHandleBaseAgent):
-    """
-    内置 agent：调用前端 demo_frontend_tool（message/title），
-    同一轮 run 内 yield function_call → await 前端回传 → 写入 session.state。
-    """
-
-    def __init__(self):
-        super().__init__(name=DEMO_FRONTEND_AGENT_NAME, tools=[demo_frontend_tool])
-
+class DemoFrontendAgent(BaseSyncAgentWithToolValidator):
     async def _run_events(self, ctx: InvocationContext) -> AsyncGenerator[Event, None]:
         function_call_id = f"added_{str(uuid.uuid4()).replace('-', '')[:24]}"
         yield context_function_call_event(
@@ -59,7 +42,3 @@ async def _run_events(self, ctx: InvocationContext) -> AsyncGenerator[Event, Non
         yield update_state_event(
             ctx, state_delta={DEMO_FRONTEND_TOOL_RESULT_STATE_KEY: demo_result}
         )
-
-
-def init_demo_frontend_agent() -> DemoFrontendAgent:
-    return DemoFrontendAgent()