feat: 添加日历批量操作与客户端时区感知功能，优化前端 UI 交互体验

backend/src/core/agentscope/runtime/runner.py

@@ -30,6 +30,10 @@ from schemas.agent.runtime_models import (
     WorkerAgentOutputLite,
     resolve_worker_output_model,
 )
+from schemas.agent.forwarded_props import (
+    ClientTimeContext,
+    parse_forwarded_props_client_time,
+)
 from schemas.agent.system_agent import AgentType, SystemAgentLLMConfig
 from schemas.user import UserContext
 from services.litellm.service import LiteLLMService
@@ -70,6 +74,7 @@ class AgentScopeRunner:
         run_input: RunAgentInput,
     ) -> dict[str, Any]:
         owner_id = UUID(user_context.id)
+        runtime_client_time = self._resolve_runtime_client_time(run_input=run_input)
 
         async with AsyncSessionLocal() as session:
             worker_toolkit = self._build_worker_toolkit(
@@ -86,6 +91,7 @@ class AgentScopeRunner:
                 user_context=user_context,
                 context_messages=context_messages,
                 stage_config=router_config,
+                runtime_client_time=runtime_client_time,
             )
             worker_output = await self._execute_worker_step(
                 pipeline=pipeline,
@@ -94,6 +100,7 @@ class AgentScopeRunner:
                 router_output=router_output,
                 toolkit=worker_toolkit,
                 stage_config=worker_config,
+                runtime_client_time=runtime_client_time,
             )
 
             return {
@@ -137,6 +144,7 @@ class AgentScopeRunner:
         user_context: UserContext,
         context_messages: list[Msg],
         stage_config: SystemAgentRuntimeConfig,
+        runtime_client_time: ClientTimeContext | None,
     ) -> RouterAgentOutput:
         await self._emit_step_event(
             pipeline=pipeline,
@@ -149,6 +157,7 @@ class AgentScopeRunner:
             context_messages=context_messages,
             run_input=run_input,
             stage_config=stage_config,
+            runtime_client_time=runtime_client_time,
         )
         router_output = RouterAgentOutput.model_validate(router_result.payload)
         await persist_router_message(
@@ -177,6 +186,7 @@ class AgentScopeRunner:
         router_output: RouterAgentOutput,
         toolkit: Any,
         stage_config: SystemAgentRuntimeConfig,
+        runtime_client_time: ClientTimeContext | None,
     ) -> WorkerAgentOutputLite:
         worker_output_model = resolve_worker_output_model(router_output.ui.ui_mode)
         await self._emit_step_event(
@@ -193,6 +203,7 @@ class AgentScopeRunner:
             stage_config=stage_config,
             worker_output_model=worker_output_model,
             pipeline=pipeline,
+            runtime_client_time=runtime_client_time,
         )
         worker_output = worker_output_model.model_validate(worker_result.payload)
         await self._emit_step_event(
@@ -234,12 +245,14 @@ class AgentScopeRunner:
         context_messages: list[Msg],
         run_input: RunAgentInput,
         stage_config: SystemAgentRuntimeConfig,
+        runtime_client_time: ClientTimeContext | None,
     ) -> StageExecutionResult:
         tracking_model = self._build_model(stage_config=stage_config)
         system_prompt = build_system_prompt(
             agent_type=AgentType.ROUTER,
             user_context=user_context,
             now_utc=datetime.now(timezone.utc),
+            runtime_client_time=runtime_client_time,
             tools=None,
         )
         response, payload = await finalize_json_response(
@@ -281,6 +294,7 @@ class AgentScopeRunner:
         stage_config: SystemAgentRuntimeConfig,
         worker_output_model: type[WorkerAgentOutputLite],
         pipeline: PipelineLike,
+        runtime_client_time: ClientTimeContext | None,
     ) -> StageExecutionResult:
         worker_input = self._build_worker_input_messages(router_output=router_output)
         tracking_model = self._build_model(stage_config=stage_config)
@@ -298,6 +312,7 @@ class AgentScopeRunner:
                 agent_type=AgentType.WORKER,
                 user_context=user_context,
                 now_utc=datetime.now(timezone.utc),
+                runtime_client_time=runtime_client_time,
                 tools=None,
             ),
             toolkit=toolkit,
@@ -392,5 +407,12 @@ class AgentScopeRunner:
             },
         )
 
+    def _resolve_runtime_client_time(
+        self, *, run_input: RunAgentInput
+    ) -> ClientTimeContext | None:
+        return parse_forwarded_props_client_time(
+            getattr(run_input, "forwarded_props", None)
+        )
+
 
 AgentScopeReActRunner = AgentScopeRunner