1

packages/shared/src/contracts/bigFishWorkSummary.ts

@@ -4,6 +4,7 @@ export interface BigFishWorkSummary {
   workId: string;
   sourceSessionId: string;
   ownerUserId: string;
+  authorDisplayName: string;
   title: string;
   subtitle: string;
   summary: string;

packages/shared/src/contracts/puzzleAgentActions.ts

@@ -13,6 +13,7 @@ export interface PuzzleAgentSuggestedAction {
 }
 
 export type PuzzleAgentActionType =
+  | 'save_puzzle_form_draft'
   | 'compile_puzzle_draft'
   | 'generate_puzzle_images'
   | 'select_puzzle_image'
@@ -39,27 +40,42 @@ export interface PuzzleAgentOperationRecord {
 }
 
 export type PuzzleAgentActionRequest =
+  | {
+      action: 'save_puzzle_form_draft';
+      promptText?: string | null;
+      workTitle?: string;
+      workDescription?: string;
+      pictureDescription?: string;
+    }
   | {
       action: 'compile_puzzle_draft';
       promptText?: string | null;
+      workTitle?: string;
+      workDescription?: string;
+      pictureDescription?: string;
       referenceImageSrc?: string | null;
       candidateCount?: number;
     }
   | {
       action: 'generate_puzzle_images';
+      levelId?: string | null;
       promptText?: string | null;
       referenceImageSrc?: string | null;
       candidateCount?: number;
     }
   | {
       action: 'select_puzzle_image';
+      levelId?: string | null;
       candidateId: string;
     }
   | {
       action: 'publish_puzzle_work';
+      workTitle?: string;
+      workDescription?: string;
       levelName?: string;
       summary?: string;
       themeTags?: string[];
+      levelsJson?: string;
     };
 
 /**

packages/shared/src/contracts/puzzleAgentDraft.ts

@@ -42,7 +42,20 @@ export interface PuzzleGeneratedImageCandidate {
   selected: boolean;
 }
 
+export interface PuzzleDraftLevel {
+  levelId: string;
+  levelName: string;
+  pictureDescription: string;
+  candidates: PuzzleGeneratedImageCandidate[];
+  selectedCandidateId: string | null;
+  coverImageSrc: string | null;
+  coverAssetId: string | null;
+  generationStatus: 'idle' | 'generating' | 'ready';
+}
+
 export interface PuzzleResultDraft {
+  workTitle?: string;
+  workDescription?: string;
   levelName: string;
   summary: string;
   themeTags: string[];
@@ -54,5 +67,11 @@ export interface PuzzleResultDraft {
   coverImageSrc: string | null;
   coverAssetId: string | null;
   generationStatus: 'idle' | 'generating' | 'ready';
+  levels?: PuzzleDraftLevel[];
+  formDraft?: {
+    workTitle?: string;
+    workDescription?: string;
+    pictureDescription?: string;
+  } | null;
   metadata?: JsonObject | null;
 }

packages/shared/src/contracts/puzzleAgentSession.ts

@@ -27,6 +27,7 @@ export interface PuzzleAgentMessage {
 
 export interface PuzzleAgentSessionSnapshot {
   sessionId: string;
+  seedText?: string;
   currentTurn: number;
   progressPercent: number;
   stage: PuzzleAgentStage;
@@ -42,6 +43,8 @@ export interface PuzzleAgentSessionSnapshot {
 
 export interface CreatePuzzleAgentSessionRequest {
   seedText?: string;
+  workTitle?: string;
+  workDescription?: string;
   pictureDescription?: string;
   referenceImageSrc?: string | null;
 }

packages/shared/src/contracts/puzzleRuntimeSession.ts

@@ -79,6 +79,7 @@ export interface PuzzleRunSnapshot {
 
 export interface StartPuzzleRunRequest {
   profileId: string;
+  levelId?: string | null;
 }
 
 export interface AdvanceLocalPuzzleNextLevelRequest {

packages/shared/src/contracts/puzzleWorkSummary.ts

@@ -1,5 +1,5 @@
 import type { JsonObject } from './common';
-import type { PuzzleAnchorPack } from './puzzleAgentDraft';
+import type { PuzzleAnchorPack, PuzzleDraftLevel } from './puzzleAgentDraft';
 
 export type PuzzleWorkPublicationStatus = 'draft' | 'published';
 
@@ -9,6 +9,8 @@ export interface PuzzleWorkSummary {
   ownerUserId: string;
   sourceSessionId?: string | null;
   authorDisplayName: string;
+  workTitle?: string;
+  workDescription?: string;
   levelName: string;
   summary: string;
   themeTags: string[];
@@ -26,6 +28,7 @@ export interface PuzzleWorkSummary {
 
 export interface PuzzleWorkProfile extends PuzzleWorkSummary {
   anchorPack: PuzzleAnchorPack;
+  levels?: PuzzleDraftLevel[];
   metadata?: JsonObject | null;
 }