1

packages/shared/src/contracts/puzzleAgentActions.ts

@@ -62,6 +62,7 @@ export type PuzzleAgentActionRequest =
       promptText?: string | null;
       referenceImageSrc?: string | null;
       candidateCount?: number;
+      levelsJson?: string;
     }
   | {
       action: 'select_puzzle_image';

packages/shared/src/contracts/puzzleRuntimeSession.ts

@@ -29,7 +29,11 @@ export interface PuzzleLeaderboardEntry {
 
 export type PuzzleRuntimeLevelStatus = 'playing' | 'cleared' | 'failed';
 
-export type PuzzleRuntimePropKind = 'hint' | 'reference' | 'freezeTime';
+export type PuzzleRuntimePropKind =
+  | 'hint'
+  | 'reference'
+  | 'freezeTime'
+  | 'extendTime';
 
 export interface PuzzleBoardSnapshot {
   rows: number;
@@ -43,6 +47,7 @@ export interface PuzzleBoardSnapshot {
 export interface PuzzleRuntimeLevelSnapshot {
   runId: string;
   levelIndex: number;
+  levelId: string | null;
   gridSize: PuzzleGridSize;
   profileId: string;
   levelName: string;
@@ -64,6 +69,17 @@ export interface PuzzleRuntimeLevelSnapshot {
   leaderboardEntries: PuzzleLeaderboardEntry[];
 }
 
+export type PuzzleNextLevelMode = 'sameWork' | 'similarWorks' | 'none';
+
+export interface PuzzleRecommendedNextWork {
+  profileId: string;
+  levelName: string;
+  authorDisplayName: string;
+  themeTags: string[];
+  coverImageSrc: string | null;
+  similarityScore: number;
+}
+
 export interface PuzzleRunSnapshot {
   runId: string;
   entryProfileId: string;
@@ -74,6 +90,10 @@ export interface PuzzleRunSnapshot {
   previousLevelTags: string[];
   currentLevel: PuzzleRuntimeLevelSnapshot | null;
   recommendedNextProfileId: string | null;
+  nextLevelMode?: PuzzleNextLevelMode;
+  nextLevelProfileId?: string | null;
+  nextLevelId?: string | null;
+  recommendedNextWorks?: PuzzleRecommendedNextWork[];
   leaderboardEntries: PuzzleLeaderboardEntry[];
 }
 

packages/shared/src/contracts/puzzleWorkSummary.ts

@@ -24,11 +24,11 @@ export interface PuzzleWorkSummary {
   likeCount?: number;
   recentPlayCount7d?: number;
   publishReady: boolean;
+  levels?: PuzzleDraftLevel[];
 }
 
 export interface PuzzleWorkProfile extends PuzzleWorkSummary {
   anchorPack: PuzzleAnchorPack;
-  levels?: PuzzleDraftLevel[];
   metadata?: JsonObject | null;
 }