1

2026-04-21 18:27:46 +08:00
parent 04bff9617d
commit 4372ab5be1
358 changed files with 30788 additions and 14737 deletions
--- a/packages/shared/src/contracts/rpgAgentSession.ts
+++ b/packages/shared/src/contracts/rpgAgentSession.ts
@@ -1,15 +1,134 @@
-export type {
-  CreateCustomWorldAgentSessionRequest as CreateRpgAgentSessionRequest,
-  CreateCustomWorldAgentSessionResponse as CreateRpgAgentSessionResponse,
-  GetCustomWorldAgentCardDetailResponse as GetRpgAgentCardDetailResponse,
-  CustomWorldAgentMessage as RpgAgentMessage,
-  CustomWorldAgentMessageKind as RpgAgentMessageKind,
-  CustomWorldAgentMessageRole as RpgAgentMessageRole,
-  CustomWorldAgentOperationRecord as RpgAgentOperationRecord,
-  CustomWorldPendingClarification as RpgAgentPendingClarification,
-  CustomWorldAgentSessionSnapshot as RpgAgentSessionSnapshot,
-  CustomWorldAgentStage as RpgAgentStage,
-  CreatorIntentReadiness as RpgCreationIntentReadiness,
-  SendCustomWorldAgentMessageRequest as SendRpgAgentMessageRequest,
-  SendCustomWorldAgentMessageResponse as SendRpgAgentMessageResponse,
-} from './customWorldAgent';
+import type { RpgAgentActionResponse, RpgAgentOperationRecord, RpgAgentSupportedAction, RpgAgentSuggestedAction } from './rpgAgentActions';
+import type { RpgCreationAnchorContent } from './rpgAgentAnchors';
+import type { RpgAgentAssetCoverageSummary, RpgAgentDraftCardDetail, RpgAgentDraftCardSummary } from './rpgAgentDraft';
+import type { RpgCreationPreviewEnvelope } from './rpgCreationPreview';
+
+/**
+ * RPG Agent 会话层契约。
+ * 这里承载 session 真相源与会话编排元数据，同时预留 resultPreview 与 supportedActions 两个后续主链字段。
+ */
+
+export interface RpgCreationIntentReadiness {
+  isReady: boolean;
+  completedKeys: string[];
+  missingKeys: string[];
+}
+
+export interface RpgAgentPendingClarification {
+  id: string;
+  label: string;
+  question: string;
+  targetKey:
+    | 'world_hook'
+    | 'player_premise'
+    | 'theme_and_tone'
+    | 'core_conflict'
+    | 'relationship_seed'
+    | 'iconic_element';
+  priority: number;
+  answer?: string;
+}
+
+export type RpgAgentStage =
+  | 'collecting_intent'
+  | 'clarifying'
+  | 'foundation_review'
+  | 'object_refining'
+  | 'visual_refining'
+  | 'long_tail_review'
+  | 'ready_to_publish'
+  | 'published'
+  | 'error';
+
+export type RpgAgentMessageRole = 'user' | 'assistant' | 'system';
+
+export type RpgAgentMessageKind =
+  | 'chat'
+  | 'clarification'
+  | 'summary'
+  | 'checkpoint'
+  | 'warning'
+  | 'action_result';
+
+export interface RpgAgentMessage {
+  id: string;
+  role: RpgAgentMessageRole;
+  kind: RpgAgentMessageKind;
+  text: string;
+  createdAt: string;
+  relatedOperationId?: string | null;
+}
+
+export interface RpgAgentQualityFinding {
+  id: string;
+  severity: 'info' | 'warning' | 'blocker';
+  code: string;
+  targetId?: string | null;
+  message: string;
+}
+
+export interface RpgAgentSessionSnapshot {
+  sessionId: string;
+  currentTurn: number;
+  anchorContent: RpgCreationAnchorContent;
+  progressPercent: number;
+  lastAssistantReply: string | null;
+  stage: RpgAgentStage;
+  focusCardId: string | null;
+  creatorIntent: Record<string, unknown> | null;
+  creatorIntentReadiness: RpgCreationIntentReadiness;
+  anchorPack: Record<string, unknown> | null;
+  lockState: Record<string, unknown> | null;
+  draftProfile: Record<string, unknown> | null;
+  messages: RpgAgentMessage[];
+  draftCards: RpgAgentDraftCardSummary[];
+  pendingClarifications: RpgAgentPendingClarification[];
+  suggestedActions: RpgAgentSuggestedAction[];
+  recommendedReplies: string[];
+  qualityFindings: RpgAgentQualityFinding[];
+  assetCoverage: RpgAgentAssetCoverageSummary;
+  /**
+   * checkpoint 元数据需要进入 session snapshot 主链，
+   * 这样前端后续才能拿到真实可回滚目标，而不是只能盲发 checkpointId。
+   */
+  checkpoints?: Array<{
+    checkpointId: string;
+    createdAt: string;
+    label: string;
+  }>;
+  /**
+   * 后续由工作包 E 的 action registry 真实填充。
+   * 当前保持可选，确保主链迁移期间不影响旧 session snapshot。
+   */
+  supportedActions?: RpgAgentSupportedAction[];
+  /**
+   * 后续由服务端 preview compiler 输出。
+   * 当前保持可选，允许前端兼容层继续走 legacy profile。
+   */
+  resultPreview?: RpgCreationPreviewEnvelope | null;
+  updatedAt: string;
+}
+
+export interface CreateRpgAgentSessionRequest {
+  seedText?: string;
+}
+
+export interface CreateRpgAgentSessionResponse {
+  session: RpgAgentSessionSnapshot;
+}
+
+export interface SendRpgAgentMessageRequest {
+  clientMessageId: string;
+  text: string;
+  quickFillRequested?: boolean;
+  focusCardId?: string | null;
+  selectedCardIds?: string[];
+}
+
+export interface SendRpgAgentMessageResponse extends RpgAgentActionResponse {
+  operation: RpgAgentOperationRecord;
+}
+
+export interface GetRpgAgentCardDetailResponse {
+  card: RpgAgentDraftCardDetail;
+}