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));
     }
 }

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

@@ -4,6 +4,8 @@ use serde::{Deserialize, Serialize};
 #[serde(rename_all = "camelCase")]
 pub struct StartMatch3DRunRequest {
     pub profile_id: String,
+    #[serde(default)]
+    pub item_type_count_override: Option<u32>,
 }
 
 #[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]

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

@@ -24,6 +24,72 @@ pub struct PutMatch3DAudioAssetsRequest {
     pub generated_item_assets: Vec<Match3DGeneratedItemAssetResponse>,
 }
 
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
+#[serde(rename_all = "camelCase")]
+pub struct PersistMatch3DGeneratedModelRequest {
+    pub item_id: String,
+    pub item_name: String,
+    pub source_url: String,
+    #[serde(default)]
+    pub file_name: Option<String>,
+    #[serde(default)]
+    pub task_uuid: Option<String>,
+    #[serde(default)]
+    pub subscription_key: Option<String>,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
+#[serde(rename_all = "camelCase")]
+pub struct PersistMatch3DGeneratedModelResponse {
+    pub asset: Match3DGeneratedItemAssetResponse,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
+#[serde(rename_all = "camelCase")]
+pub struct GenerateMatch3DCoverImageRequest {
+    pub prompt: String,
+    #[serde(default)]
+    pub reference_image_src: Option<String>,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
+#[serde(rename_all = "camelCase")]
+pub struct GenerateMatch3DCoverImageResponse {
+    pub item: Match3DWorkProfileResponse,
+    pub cover_image_src: String,
+    pub cover_image_object_key: String,
+    pub prompt: String,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
+#[serde(rename_all = "camelCase")]
+pub struct GenerateMatch3DBackgroundImageRequest {
+    pub prompt: String,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
+#[serde(rename_all = "camelCase")]
+pub struct GenerateMatch3DBackgroundImageResponse {
+    pub item: Match3DWorkProfileResponse,
+    pub background_image_src: String,
+    pub background_image_object_key: String,
+    pub generated_background_asset: Match3DGeneratedBackgroundAssetResponse,
+    pub prompt: String,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
+#[serde(rename_all = "camelCase")]
+pub struct GenerateMatch3DItemAssetsRequest {
+    pub item_names: Vec<String>,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
+#[serde(rename_all = "camelCase")]
+pub struct GenerateMatch3DItemAssetsResponse {
+    pub item: Match3DWorkProfileResponse,
+    pub generated_item_assets: Vec<Match3DGeneratedItemAssetResponse>,
+}
+
 #[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
 #[serde(rename_all = "camelCase")]
 pub struct Match3DWorkSummaryResponse {
@@ -48,10 +114,42 @@ pub struct Match3DWorkSummaryResponse {
     #[serde(default)]
     pub published_at: Option<String>,
     pub publish_ready: bool,
+    #[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)]
+#[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)]
+#[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)]
 #[serde(rename_all = "camelCase")]
 pub struct Match3DGeneratedItemAssetResponse {
@@ -61,6 +159,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)]
@@ -72,9 +172,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>,

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

@@ -154,6 +154,12 @@ pub struct PuzzleDraftLevelResponse {
     #[serde(default)]
     pub picture_reference: Option<String>,
     #[serde(default)]
+    pub ui_background_prompt: Option<String>,
+    #[serde(default)]
+    pub ui_background_image_src: Option<String>,
+    #[serde(default)]
+    pub ui_background_image_object_key: Option<String>,
+    #[serde(default)]
     pub background_music: Option<CreationAudioAsset>,
     pub candidates: Vec<PuzzleGeneratedImageCandidateResponse>,
     #[serde(default)]

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

@@ -1,3 +1,4 @@
+use crate::creation_audio::CreationAudioAsset;
 use serde::{Deserialize, Serialize};
 
 #[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
@@ -116,6 +117,10 @@ pub struct PuzzleRuntimeLevelSnapshotResponse {
     pub theme_tags: Vec<String>,
     #[serde(default)]
     pub cover_image_src: Option<String>,
+    #[serde(default)]
+    pub ui_background_image_src: Option<String>,
+    #[serde(default)]
+    pub background_music: Option<CreationAudioAsset>,
     pub board: PuzzleBoardSnapshotResponse,
     pub status: String,
     #[serde(default)]