1

packages/shared/src/contracts/customWorldAgent.ts

@@ -197,6 +197,11 @@ export interface CustomWorldFoundationDraftCharacter {
   relationToPlayer: string;
   threadIds: string[];
   summary: string;
+  skills?: Array<{
+    id: string;
+    name: string;
+    actionPreviewConfig?: Record<string, unknown> | null;
+  }>;
   imageSrc?: string | null;
   generatedVisualAssetId?: string | null;
   generatedAnimationSetId?: string | null;
@@ -212,6 +217,7 @@ export interface CustomWorldFoundationDraftLandmark {
   importance: string;
   secret?: string;
   dangerLevel?: string;
+  imageSrc?: string | null;
   characterIds: string[];
   threadIds: string[];
   summary: string;
@@ -246,9 +252,48 @@ export interface CustomWorldFoundationDraftCamp {
   description: string;
   mood: string;
   dangerLevel?: string;
+  imageSrc?: string | null;
   summary: string;
 }
 
+export type CustomWorldSceneActStage =
+  | 'opening'
+  | 'expansion'
+  | 'turning_point'
+  | 'climax'
+  | 'aftermath';
+
+export type CustomWorldSceneActAdvanceRule =
+  | 'after_primary_contact'
+  | 'after_active_step_complete'
+  | 'after_chapter_resolution';
+
+export interface CustomWorldFoundationDraftSceneAct {
+  id: string;
+  title: string;
+  summary: string;
+  stageCoverage: CustomWorldSceneActStage[];
+  backgroundImageSrc?: string | null;
+  backgroundAssetId?: string | null;
+  encounterNpcIds: string[];
+  primaryNpcId: string;
+  linkedThreadIds: string[];
+  actGoal: string;
+  transitionHook: string;
+  advanceRule: CustomWorldSceneActAdvanceRule;
+}
+
+export interface CustomWorldFoundationDraftSceneChapter {
+  id: string;
+  sceneId: string;
+  sceneName: string;
+  title: string;
+  summary: string;
+  linkedThreadIds: string[];
+  linkedLandmarkIds: string[];
+  acts: CustomWorldFoundationDraftSceneAct[];
+}
+
 export interface CustomWorldFoundationDraftProfile {
   name: string;
   subtitle: string;
@@ -266,6 +311,7 @@ export interface CustomWorldFoundationDraftProfile {
   factions: CustomWorldFoundationDraftFaction[];
   threads: CustomWorldFoundationDraftThread[];
   chapters: CustomWorldFoundationDraftChapter[];
+  sceneChapters: CustomWorldFoundationDraftSceneChapter[];
   worldHook: string;
   playerPremise: string;
   openingSituation: string;

packages/shared/src/contracts/story.ts

@@ -83,6 +83,26 @@ export type PlainTextResponse = {
   text: string;
 };
 
+export type NpcChatTurnLimitReason = 'negative_affinity';
+
+export type NpcChatTurnClosingMode = 'free' | 'foreshadow_close';
+
+export type NpcChatTurnDirective = {
+  sceneActId?: string | null;
+  turnLimit?: number | null;
+  remainingTurns?: number | null;
+  limitReason?: NpcChatTurnLimitReason | null;
+  closingMode?: NpcChatTurnClosingMode | null;
+  forceExitAfterTurn?: boolean;
+};
+
+export type NpcChatTurnCompletionDirective = {
+  turnLimit?: number | null;
+  remainingTurns?: number | null;
+  forceExit?: boolean;
+  closingMode?: NpcChatTurnClosingMode;
+};
+
 export type CharacterChatReplyRequest<
   TCharacter = unknown,
   TStoryMoment = unknown,
@@ -162,6 +182,7 @@ export type NpcChatTurnRequest<
   TNpcState = unknown,
   TQuestOfferState = unknown,
   TQuestOfferEncounter = unknown,
+  TChatDirective = NpcChatTurnDirective,
 > = {
   worldType: string;
   character?: TCharacter;
@@ -179,6 +200,7 @@ export type NpcChatTurnRequest<
     encounter: TQuestOfferEncounter;
     turnCount: number;
   } | null;
+  chatDirective?: TChatDirective | null;
 };
 
 export type NpcChatPendingQuestOffer<TQuest = unknown> = {
@@ -192,6 +214,7 @@ export type NpcChatTurnResult<TQuest = unknown> = {
   affinityText: string;
   suggestions: string[];
   pendingQuestOffer?: NpcChatPendingQuestOffer<TQuest> | null;
+  chatDirective?: NpcChatTurnCompletionDirective | null;
 };
 
 export type NpcRecruitDialogueRequest<