1

packages/shared/src/contracts/puzzleAgentActions.ts

@@ -1,3 +1,5 @@
+import type { PuzzleAgentSessionSnapshot } from './puzzleAgentSession';
+
 export type PuzzleAgentSuggestedActionType =
   | 'request_summary'
   | 'compile_puzzle_draft'
@@ -54,6 +56,10 @@ export type PuzzleAgentActionRequest =
       themeTags?: string[];
     };
 
+/**
+ * 拼图操作接口直接返回最新会话，避免前端在选图等轻操作后再额外 GET 大体积快照。
+ */
 export interface PuzzleAgentActionResponse {
   operation: PuzzleAgentOperationRecord;
+  session: PuzzleAgentSessionSnapshot;
 }

packages/shared/src/contracts/puzzleRuntimeSession.ts

@@ -58,6 +58,11 @@ export interface StartPuzzleRunRequest {
   profileId: string;
 }
 
+export interface AdvanceLocalPuzzleNextLevelRequest {
+  run: PuzzleRunSnapshot;
+  sourceSessionId?: string | null;
+}
+
 export interface PuzzleRunResponse {
   run: PuzzleRunSnapshot;
 }