1

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

@@ -23,6 +23,8 @@ pub struct ExecutePuzzleAgentActionRequest {
     #[serde(default)]
     pub prompt_text: Option<String>,
     #[serde(default)]
+    pub reference_image_src: Option<String>,
+    #[serde(default)]
     pub candidate_count: Option<u32>,
     #[serde(default)]
     pub candidate_id: Option<String>,

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

@@ -56,6 +56,16 @@ pub struct PuzzleMergedGroupStateResponse {
     pub occupied_cells: Vec<PuzzleCellPositionResponse>,
 }
 
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
+#[serde(rename_all = "camelCase")]
+pub struct PuzzleLeaderboardEntryResponse {
+    pub rank: u32,
+    pub nickname: String,
+    pub elapsed_ms: u64,
+    #[serde(default)]
+    pub is_current_player: bool,
+}
+
 #[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
 #[serde(rename_all = "camelCase")]
 pub struct PuzzleBoardSnapshotResponse {
@@ -82,6 +92,14 @@ pub struct PuzzleRuntimeLevelSnapshotResponse {
     pub cover_image_src: Option<String>,
     pub board: PuzzleBoardSnapshotResponse,
     pub status: String,
+    #[serde(default)]
+    pub started_at_ms: u64,
+    #[serde(default)]
+    pub cleared_at_ms: Option<u64>,
+    #[serde(default)]
+    pub elapsed_ms: Option<u64>,
+    #[serde(default)]
+    pub leaderboard_entries: Vec<PuzzleLeaderboardEntryResponse>,
 }
 
 #[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
@@ -98,6 +116,8 @@ pub struct PuzzleRunSnapshotResponse {
     pub current_level: Option<PuzzleRuntimeLevelSnapshotResponse>,
     #[serde(default)]
     pub recommended_next_profile_id: Option<String>,
+    #[serde(default)]
+    pub leaderboard_entries: Vec<PuzzleLeaderboardEntryResponse>,
 }
 
 #[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]