1

server-rs/crates/shared-contracts/src/puzzle_agent.rs

@@ -187,4 +187,6 @@ pub struct PuzzleAgentOperationResponse {
 #[serde(rename_all = "camelCase")]
 pub struct PuzzleAgentActionResponse {
     pub operation: PuzzleAgentOperationResponse,
+    /// 操作完成后的最新会话快照，供前端直接更新界面，避免重复拉取完整 session。
+    pub session: PuzzleAgentSessionSnapshotResponse,
 }

server-rs/crates/shared-contracts/src/puzzle_runtime.rs

@@ -6,6 +6,14 @@ pub struct StartPuzzleRunRequest {
     pub profile_id: String,
 }
 
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
+#[serde(rename_all = "camelCase")]
+pub struct AdvanceLocalPuzzleNextLevelRequest {
+    pub run: PuzzleRunSnapshotResponse,
+    #[serde(default)]
+    pub source_session_id: Option<String>,
+}
+
 #[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
 #[serde(rename_all = "camelCase")]
 pub struct SwapPuzzlePiecesRequest {