1

packages/shared/src/contracts/rpgRuntimeChat.ts

@@ -3,6 +3,7 @@
  * 将角色聊天、NPC 对话与轻量 story 请求载荷从旧 story.ts 中独立出来。
  */
 import type { JsonObject } from './common';
+import type { SavedGameSnapshotInput } from './runtime';
 
 export type NpcChatTurnLimitReason = 'negative_affinity';
 
@@ -46,8 +47,15 @@ export type CharacterChatReplyRequest<
   TContext = unknown,
   TConversationTurn = unknown,
   TTargetStatus = unknown,
+  TSnapshotGameState = unknown,
+  TSnapshotCurrentStory = unknown,
 > = {
   sessionId?: string;
+  snapshot?: SavedGameSnapshotInput<
+    TSnapshotGameState,
+    string,
+    TSnapshotCurrentStory
+  >;
   worldType?: string;
   playerCharacter?: TCharacter;
   targetCharacter: TCharacter;
@@ -65,8 +73,15 @@ export type CharacterChatSuggestionsRequest<
   TContext = unknown,
   TConversationTurn = unknown,
   TTargetStatus = unknown,
+  TSnapshotGameState = unknown,
+  TSnapshotCurrentStory = unknown,
 > = {
   sessionId?: string;
+  snapshot?: SavedGameSnapshotInput<
+    TSnapshotGameState,
+    string,
+    TSnapshotCurrentStory
+  >;
   worldType?: string;
   playerCharacter?: TCharacter;
   targetCharacter: TCharacter;
@@ -83,8 +98,15 @@ export type CharacterChatSummaryRequest<
   TContext = unknown,
   TConversationTurn = unknown,
   TTargetStatus = unknown,
+  TSnapshotGameState = unknown,
+  TSnapshotCurrentStory = unknown,
 > = {
   sessionId?: string;
+  snapshot?: SavedGameSnapshotInput<
+    TSnapshotGameState,
+    string,
+    TSnapshotCurrentStory
+  >;
   worldType?: string;
   playerCharacter?: TCharacter;
   targetCharacter: TCharacter;
@@ -101,8 +123,15 @@ export type NpcChatDialogueRequest<
   TMonster = unknown,
   TStoryMoment = unknown,
   TContext = unknown,
+  TSnapshotGameState = unknown,
+  TSnapshotCurrentStory = unknown,
 > = {
   sessionId?: string;
+  snapshot?: SavedGameSnapshotInput<
+    TSnapshotGameState,
+    string,
+    TSnapshotCurrentStory
+  >;
   worldType?: string;
   character?: TCharacter;
   encounter: TEncounter;
@@ -126,8 +155,15 @@ export type NpcChatTurnRequest<
   TQuestOfferState = unknown,
   TQuestOfferEncounter = unknown,
   TChatDirective = NpcChatTurnDirective,
+  TSnapshotGameState = unknown,
+  TSnapshotCurrentStory = unknown,
 > = {
   sessionId?: string;
+  snapshot?: SavedGameSnapshotInput<
+    TSnapshotGameState,
+    string,
+    TSnapshotCurrentStory
+  >;
   worldType?: string;
   character?: TCharacter;
   player?: TCharacter;
@@ -175,8 +211,15 @@ export type NpcRecruitDialogueRequest<
   TMonster = unknown,
   TStoryMoment = unknown,
   TContext = unknown,
+  TSnapshotGameState = unknown,
+  TSnapshotCurrentStory = unknown,
 > = {
   sessionId?: string;
+  snapshot?: SavedGameSnapshotInput<
+    TSnapshotGameState,
+    string,
+    TSnapshotCurrentStory
+  >;
   worldType?: string;
   character?: TCharacter;
   encounter: TEncounter;