1

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<