Merge branch 'master' of ssh://192.168.35.82:2222/GenarrativeAI/Genarrative into feat/scene_v1

packages/shared/src/contracts/gameCreationApp.test.ts

@@ -638,6 +638,16 @@ describe('AI 游戏创作 App 共享契约', () => {
           updatedAt: 123,
         },
       ],
+      versions: [
+        {
+          versionId: 'version-1',
+          parentVersionId: null,
+          projectRevision: 7,
+          resourceBindings: [{ slotId: 'player', resourceId: 'asset-player' }],
+          createdReason: 'initial',
+          createdAt: 456,
+        },
+      ],
       assets: [
         {
           id: 'asset-player',
@@ -678,6 +688,16 @@ describe('AI 游戏创作 App 共享契约', () => {
           logPath: '.agent/logs/command.log',
         },
       ],
+      versions: [
+        {
+          versionId: 'version-1',
+          parentVersionId: null,
+          projectRevision: 7,
+          resourceBindings: [{ slotId: 'player', resourceId: 'asset-player' }],
+          createdReason: 'initial',
+          createdAt: 456,
+        },
+      ],
     });
   });
 });

packages/shared/src/contracts/gameCreationApp.ts

@@ -537,6 +537,25 @@ export interface GameCreationAppCommandRunState {
   updatedAt: number;
 }
 
+export type GameIterationVersionCreatedReason =
+  | 'initial'
+  | 'resource-replacement'
+  | 'agent-revision';
+
+export interface GameIterationVersionResourceBinding {
+  slotId: string;
+  resourceId: string;
+}
+
+export interface GameIterationVersion {
+  versionId: string;
+  parentVersionId: string | null;
+  projectRevision: number;
+  resourceBindings: GameIterationVersionResourceBinding[];
+  createdReason: GameIterationVersionCreatedReason;
+  createdAt: number;
+}
+
 export interface GameCreationAppManifest {
   schemaVersion: string;
   projectId: string;
@@ -546,6 +565,7 @@ export interface GameCreationAppManifest {
   assets: GameCreationAppAssetManifestEntry[];
   preview?: GameCreationAppPreviewState | null;
   commandRuns?: GameCreationAppCommandRunState[];
+  versions?: GameIterationVersion[];
 }
 
 export interface GameCreationAgentToolCallTrace {