feat: 实现 AgentScope ReAct Runner 两阶段执行并重构事件处理

backend/src/v1/agent/service.py

@@ -8,7 +8,7 @@ from typing import Any, Protocol
 from urllib.parse import urlparse
 
 import dashscope
-from ag_ui.core import RunAgentInput, StateSnapshotEvent
+from ag_ui.core import RunAgentInput
 from dashscope.audio.asr import Recognition, RecognitionCallback
 from fastapi import HTTPException
 from sqlalchemy.exc import IntegrityError
@@ -21,6 +21,7 @@ from schemas.messages.chat_message import (
     AgentChatMessageMetadata,
     UserMessageAttachments,
 )
+from v1.agent.schemas import HistorySnapshotResponse
 
 logger = get_logger(__name__)
 _ALLOWED_ATTACHMENT_MIME_TYPES = {"image/png", "image/jpeg", "image/webp"}
@@ -416,27 +417,48 @@ class AgentService:
         thread_id: str,
         before: date | None,
         current_user: CurrentUser,
-    ) -> dict[str, object]:
+    ) -> HistorySnapshotResponse:
+        from schemas.messages.chat_message import AgentChatMessage
+        from v1.agent.utils import convert_message_to_history
+        from v1.agent.schemas import HistoryMessage
+
         owner = await self._repository.get_session_owner(session_id=thread_id)
         ensure_session_owner(owner_id=owner, current_user=current_user)
         day_payload = await self._repository.get_history_day(
             session_id=thread_id,
             before=before,
         )
-        snapshot = {
-            "scope": "history_day",
-            "threadId": thread_id,
-            "day": day_payload["day"] if day_payload else None,
-            "hasMore": day_payload["hasMore"] if day_payload else False,
-            "messages": day_payload["messages"] if day_payload else [],
-        }
-        event = StateSnapshotEvent(snapshot=snapshot).model_dump(
-            mode="json",
-            by_alias=True,
-            exclude_none=True,
+
+        messages: list[HistoryMessage] = []
+        if day_payload:
+            raw_messages = day_payload.get("messages") or []
+            for msg_dict in raw_messages:
+                msg = AgentChatMessage.model_validate(msg_dict)
+
+                signed_url: str | None = None
+                if self._attachment_storage and msg.metadata:
+                    att = msg.metadata.user_message_attachments
+                    if att:
+                        signed_url = await self._attachment_storage.create_signed_url(
+                            bucket=att.bucket,
+                            path=att.path,
+                            expires_in_seconds=self._SIGNED_URL_EXPIRES_IN_SECONDS,
+                        )
+
+                converted = convert_message_to_history(msg, None)
+                if signed_url:
+                    converted["url"] = signed_url
+                messages.append(HistoryMessage.model_validate(converted))
+
+        return HistorySnapshotResponse(
+            scope="history_day",
+            threadId=thread_id,
+            day=str(day_payload.get("day"))
+            if day_payload and day_payload.get("day")
+            else None,
+            hasMore=bool(day_payload.get("hasMore")) if day_payload else False,
+            messages=messages,
         )
-        event["threadId"] = thread_id
-        return event
 
     async def get_user_history_snapshot(
         self,
@@ -444,22 +466,20 @@ class AgentService:
         current_user: CurrentUser,
         thread_id: str | None,
         before: date | None,
-    ) -> dict[str, object]:
+    ) -> HistorySnapshotResponse:
         target_thread_id = thread_id
         if target_thread_id is None:
             target_thread_id = await self._repository.get_latest_session_id_for_user(
                 user_id=str(current_user.id)
             )
         if target_thread_id is None:
-            return StateSnapshotEvent(
-                snapshot={
-                    "scope": "history_day",
-                    "threadId": None,
-                    "day": None,
-                    "hasMore": False,
-                    "messages": [],
-                }
-            ).model_dump(mode="json", by_alias=True, exclude_none=True)
+            return HistorySnapshotResponse(
+                scope="history_day",
+                threadId=None,
+                day=None,
+                hasMore=False,
+                messages=[],
+            )
         return await self.get_history_snapshot(
             thread_id=target_thread_id,
             before=before,