1

packages/shared/src/contracts/customWorldAgent.ts

@@ -1,6 +1,65 @@
 export type CustomWorldWorkStatus = 'draft' | 'published';
 export type CustomWorldWorkSource = 'agent_session' | 'published_profile';
 
+export interface WorldPromiseValue {
+  hook: string;
+  differentiator: string;
+  desiredExperience: string;
+}
+
+export interface PlayerFantasyValue {
+  playerRole: string;
+  corePursuit: string;
+  fearOfLoss: string;
+}
+
+export interface ThemeBoundaryValue {
+  toneKeywords: string[];
+  aestheticDirectives: string[];
+  forbiddenDirectives: string[];
+}
+
+export interface PlayerEntryPointValue {
+  openingIdentity: string;
+  openingProblem: string;
+  entryMotivation: string;
+}
+
+export interface CoreConflictValue {
+  surfaceConflicts: string[];
+  hiddenCrisis: string;
+  firstTouchedConflict: string;
+}
+
+export interface KeyRelationshipValue {
+  pairs: string;
+  relationshipType: string;
+  secretOrCost: string;
+}
+
+export interface HiddenLineValue {
+  hiddenTruths: string[];
+  misdirectionHints: string[];
+  revealPacing: string;
+}
+
+export interface IconicElementValue {
+  iconicMotifs: string[];
+  institutionsOrArtifacts: string[];
+  hardRules: string[];
+}
+
+export interface EightAnchorContent {
+  worldPromise: WorldPromiseValue | null;
+  playerFantasy: PlayerFantasyValue | null;
+  themeBoundary: ThemeBoundaryValue | null;
+  playerEntryPoint: PlayerEntryPointValue | null;
+  coreConflict: CoreConflictValue | null;
+  keyRelationships: KeyRelationshipValue[];
+  hiddenLines: HiddenLineValue | null;
+  iconicElements: IconicElementValue | null;
+}
+
 export interface CustomWorldWorkSummary {
   workId: string;
   sourceType: CustomWorldWorkSource;
@@ -284,6 +343,10 @@ export interface CustomWorldAssetCoverageSummary {
 
 export interface CustomWorldAgentSessionSnapshot {
   sessionId: string;
+  currentTurn: number;
+  anchorContent: EightAnchorContent;
+  progressPercent: number;
+  lastAssistantReply: string | null;
   stage: CustomWorldAgentStage;
   focusCardId: string | null;
   creatorIntent: Record<string, unknown> | null;
@@ -351,6 +414,7 @@ export interface CreateCustomWorldAgentSessionResponse {
 export interface SendCustomWorldAgentMessageRequest {
   clientMessageId: string;
   text: string;
+  quickFillRequested?: boolean;
   focusCardId?: string | null;
   selectedCardIds?: string[];
 }