1

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

@@ -21,6 +21,8 @@ pub struct CreateMatch3DAgentSessionRequest {
     pub asset_style_label: Option<String>,
     #[serde(default)]
     pub asset_style_prompt: Option<String>,
+    #[serde(default)]
+    pub generate_click_sound: Option<bool>,
 }
 
 #[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
@@ -50,6 +52,8 @@ pub struct ExecuteMatch3DAgentActionRequest {
     pub clear_count: Option<u32>,
     #[serde(default)]
     pub difficulty: Option<u32>,
+    #[serde(default)]
+    pub generate_click_sound: Option<bool>,
 }
 
 #[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
@@ -66,6 +70,8 @@ pub struct Match3DCreatorConfigResponse {
     pub asset_style_label: Option<String>,
     #[serde(default)]
     pub asset_style_prompt: Option<String>,
+    #[serde(default)]
+    pub generate_click_sound: bool,
 }
 
 #[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
@@ -87,10 +93,42 @@ pub struct Match3DResultDraftResponse {
     pub total_item_count: u32,
     pub publish_ready: bool,
     pub blockers: Vec<String>,
+    #[serde(default, skip_serializing_if = "Option::is_none")]
+    pub background_prompt: Option<String>,
+    #[serde(default, skip_serializing_if = "Option::is_none")]
+    pub background_image_src: Option<String>,
+    #[serde(default, skip_serializing_if = "Option::is_none")]
+    pub background_image_object_key: Option<String>,
+    #[serde(default, skip_serializing_if = "Option::is_none")]
+    pub generated_background_asset: Option<Match3DGeneratedBackgroundAssetResponse>,
     #[serde(default, skip_serializing_if = "Vec::is_empty")]
     pub generated_item_assets: Vec<Match3DGeneratedItemAssetResponse>,
 }
 
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
+#[serde(rename_all = "camelCase")]
+pub struct Match3DGeneratedBackgroundAssetResponse {
+    pub prompt: String,
+    #[serde(default)]
+    pub image_src: Option<String>,
+    #[serde(default)]
+    pub image_object_key: Option<String>,
+    pub status: String,
+    #[serde(default)]
+    pub error: Option<String>,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
+#[serde(rename_all = "camelCase")]
+pub struct Match3DGeneratedItemImageViewResponse {
+    pub view_id: String,
+    pub view_index: u32,
+    #[serde(default)]
+    pub image_src: Option<String>,
+    #[serde(default)]
+    pub image_object_key: Option<String>,
+}
+
 #[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
 #[serde(rename_all = "camelCase")]
 pub struct Match3DGeneratedItemAssetResponse {
@@ -100,6 +138,8 @@ pub struct Match3DGeneratedItemAssetResponse {
     pub image_src: Option<String>,
     #[serde(default)]
     pub image_object_key: Option<String>,
+    #[serde(default, skip_serializing_if = "Vec::is_empty")]
+    pub image_views: Vec<Match3DGeneratedItemImageViewResponse>,
     #[serde(default)]
     pub model_src: Option<String>,
     #[serde(default)]
@@ -111,9 +151,19 @@ pub struct Match3DGeneratedItemAssetResponse {
     #[serde(default)]
     pub subscription_key: Option<String>,
     #[serde(default)]
+    pub sound_prompt: Option<String>,
+    #[serde(default)]
+    pub background_music_title: Option<String>,
+    #[serde(default)]
+    pub background_music_style: Option<String>,
+    #[serde(default)]
+    pub background_music_prompt: Option<String>,
+    #[serde(default)]
     pub background_music: Option<CreationAudioAsset>,
     #[serde(default)]
     pub click_sound: Option<CreationAudioAsset>,
+    #[serde(default)]
+    pub background_asset: Option<Match3DGeneratedBackgroundAssetResponse>,
     pub status: String,
     #[serde(default)]
     pub error: Option<String>,
@@ -191,9 +241,10 @@ mod tests {
             reference_image_src: Some("data:image/png;base64,abc".to_string()),
             clear_count: Some(4),
             difficulty: Some(3),
-            asset_style_id: Some("clay-toy".to_string()),
-            asset_style_label: Some("黏土手作".to_string()),
-            asset_style_prompt: Some("圆润黏土手作风".to_string()),
+            asset_style_id: Some("flat-icon".to_string()),
+            asset_style_label: Some("扁平图标".to_string()),
+            asset_style_prompt: Some("干净扁平 2D 游戏道具图标风格".to_string()),
+            generate_click_sound: Some(true),
         })
         .expect("payload should serialize");
 
@@ -204,6 +255,25 @@ mod tests {
             json!("data:image/png;base64,abc")
         );
         assert_eq!(payload["clearCount"], json!(4));
-        assert_eq!(payload["assetStyleId"], json!("clay-toy"));
+        assert_eq!(payload["assetStyleId"], json!("flat-icon"));
+        assert_eq!(payload["generateClickSound"], json!(true));
+    }
+
+    #[test]
+    fn execute_match3d_action_request_serializes_click_sound_toggle() {
+        let payload = serde_json::to_value(ExecuteMatch3DAgentActionRequest {
+            action: "match3d_compile_draft".to_string(),
+            game_name: None,
+            summary: None,
+            tags: None,
+            cover_image_src: None,
+            clear_count: None,
+            difficulty: None,
+            generate_click_sound: Some(true),
+        })
+        .expect("payload should serialize");
+
+        assert_eq!(payload["action"], json!("match3d_compile_draft"));
+        assert_eq!(payload["generateClickSound"], json!(true));
     }
 }