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;
}