1

packages/shared/src/contracts/match3dAgent.ts

@@ -2,7 +2,10 @@
  * 抓大鹅 Match3D 创作 Agent 共享契约。
  * 字段按 HTTP facade 的 camelCase DTO 命名，后端领域层 snake_case 字段由 facade 映射。
  */
-import type { Match3DGeneratedItemAsset } from './match3dWorks';
+import type {
+  Match3DGeneratedBackgroundAsset,
+  Match3DGeneratedItemAsset,
+} from './match3dWorks';
 
 export type Match3DCreationStage =
   | 'collecting'
@@ -34,6 +37,7 @@ export interface CreateMatch3DAgentSessionRequest {
   assetStyleId?: string | null;
   assetStyleLabel?: string | null;
   assetStylePrompt?: string | null;
+  generateClickSound?: boolean;
 }
 
 export type CreateMatch3DSessionRequest = CreateMatch3DAgentSessionRequest;
@@ -55,6 +59,7 @@ export interface ExecuteMatch3DAgentActionRequest {
   coverImageSrc?: string | null;
   clearCount?: number;
   difficulty?: number;
+  generateClickSound?: boolean;
 }
 
 export type ExecuteMatch3DActionRequest = ExecuteMatch3DAgentActionRequest;
@@ -80,6 +85,7 @@ export interface Match3DCreatorConfig {
   assetStyleId?: string | null;
   assetStyleLabel?: string | null;
   assetStylePrompt?: string | null;
+  generateClickSound?: boolean;
 }
 
 export interface Match3DResultDraft {
@@ -96,6 +102,10 @@ export interface Match3DResultDraft {
   totalItemCount?: number;
   publishReady?: boolean;
   blockers?: string[];
+  backgroundPrompt?: string | null;
+  backgroundImageSrc?: string | null;
+  backgroundImageObjectKey?: string | null;
+  generatedBackgroundAsset?: Match3DGeneratedBackgroundAsset | null;
   generatedItemAssets?: Match3DGeneratedItemAsset[];
 }