1

server-node/src/services/chatService.test.ts

@@ -0,0 +1,43 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+
+import { npcChatTurnRequestSchema } from './chatService.js';
+
+test('npc chat turn schema normalizes player and dialogue aliases', () => {
+  const payload = npcChatTurnRequestSchema.parse({
+    worldType: 'WUXIA',
+    player: {
+      id: 'hero',
+      name: '沈行',
+    },
+    encounter: {
+      id: 'npc-liu',
+      npcName: '柳无声',
+    },
+    monsters: [],
+    history: [],
+    context: {
+      sceneName: '客栈内室',
+    },
+    dialogue: [
+      {
+        speaker: 'player',
+        text: '你刚才那句话是什么意思？',
+      },
+    ],
+    playerMessage: '你能说得再明白一点吗？',
+    npcState: {
+      affinity: 4,
+      chattedCount: 1,
+      recruited: false,
+    },
+  });
+
+  assert.equal(payload.character.name, '沈行');
+  assert.deepEqual(payload.conversationHistory, [
+    {
+      speaker: 'player',
+      text: '你刚才那句话是什么意思？',
+    },
+  ]);
+});

server-node/src/services/chatService.ts

@@ -23,7 +23,8 @@ const baseCharacterChatSchema = z.object({
 
 const baseNpcChatSchema = z.object({
   worldType: z.string().trim().min(1),
-  character: jsonObjectSchema,
+  character: jsonObjectSchema.optional(),
+  player: jsonObjectSchema.optional(),
   encounter: jsonObjectSchema,
   monsters: z.array(jsonObjectSchema).default([]),
   history: z.array(jsonObjectSchema).default([]),
@@ -47,17 +48,35 @@ export const characterChatSummaryRequestSchema = baseCharacterChatSchema.extend(
 ) satisfies z.ZodType<CharacterChatSummaryRequest>;
 
 export const npcChatDialogueRequestSchema = baseNpcChatSchema.extend({
+  character: jsonObjectSchema,
   topic: z.string().trim().min(1),
   resultSummary: z.string().optional().default(''),
 }) satisfies z.ZodType<NpcChatDialogueRequest>;
 
-export const npcChatTurnRequestSchema = baseNpcChatSchema.extend({
-  conversationHistory: z.array(jsonObjectSchema).default([]),
-  playerMessage: z.string().trim().min(1),
-  npcState: jsonObjectSchema,
-}) satisfies z.ZodType<NpcChatTurnRequest>;
+export const npcChatTurnRequestSchema = baseNpcChatSchema
+  .extend({
+    conversationHistory: z.array(jsonObjectSchema).optional(),
+    dialogue: z.array(jsonObjectSchema).optional(),
+    playerMessage: z.string().trim().min(1),
+    npcState: jsonObjectSchema,
+  })
+  .superRefine((value, ctx) => {
+    if (!value.character && !value.player) {
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        message: 'npc chat turn request requires character or player',
+        path: ['character'],
+      });
+    }
+  })
+  .transform((value) => ({
+    ...value,
+    character: value.character ?? value.player ?? {},
+    conversationHistory: value.conversationHistory ?? value.dialogue ?? [],
+  })) satisfies z.ZodType<NpcChatTurnRequest>;
 
 export const npcRecruitDialogueRequestSchema = baseNpcChatSchema.extend({
+  character: jsonObjectSchema,
   invitationText: z.string().trim().min(1),
   recruitSummary: z.string().optional().default(''),
 }) satisfies z.ZodType<NpcRecruitDialogueRequest>;