Debates

interface Debate {
  id: string;
  topic: string;
  userProfile: {
    name: string;
    avatar: string;
    bio?: string;
  };
  opponentProfile: {
    name: string;
    avatar: string;
    bio?: string;
  };
  messages: DebateMessage[];
  synthesis?: DebateSynthesis;
  status: 'pending' | 'in_progress' | 'completed';
  userId: string;
  createdAt: Date;
  updatedAt: Date;
}

interface DebateMessage {
  role: 'user' | 'opponent';
  name: string;
  content: string;
  timestamp: number;
}

// Opponent initialization
{ event: 'init', data: { opponent: AIExpert } }

// Turn indication
{ event: 'start', data: { speaker: 'opponent' | 'user' } }

// Streaming content chunks
{ event: 'chunk', data: { content: string } }

// Complete message
{ event: 'message', data: { role, name, content, timestamp } }

// Synthesis generation started
{ event: 'synthesizing', data: {} }

// Final synthesis
{ event: 'synthesis', data: DebateSynthesis }

// Debate completion
{ event: 'done', data: {} }

// Error handling
{ event: 'error', data: { message: string } }

const eventSource = new EventSource('/api/debate');

eventSource.addEventListener('init', (e) => {
  const { opponent } = JSON.parse(e.data);
  displayOpponent(opponent);
});

eventSource.addEventListener('chunk', (e) => {
  const { content } = JSON.parse(e.data);
  appendToCurrentMessage(content);
});

eventSource.addEventListener('synthesis', (e) => {
  const synthesis = JSON.parse(e.data);
  displaySynthesisReport(synthesis);
});

eventSource.addEventListener('done', () => {
  eventSource.close();
});

interface DebateSynthesis {
  consensus: string[];        // Points both sides agreed on
  disagreements: string[];    // Core areas of disagreement
  winner: 'user' | 'opponent' | 'tie';
  winnerReason: string;       // Explanation of victory
  conclusion: string;         // Overall takeaway
  recommendations: string[];  // Suggested next steps or readings
}

{
  "consensus": [
    "AI will significantly impact employment",
    "Regulation is necessary for safety"
  ],
  "disagreements": [
    "Timeline for AGI development",
    "Role of government vs. industry self-regulation"
  ],
  "winner": "opponent",
  "winnerReason": "Provided more concrete evidence and addressed counterarguments systematically",
  "conclusion": "Both perspectives highlight the complexity of AI governance. A balanced approach combining innovation with safety measures appears most viable.",
  "recommendations": [
    "Study the EU AI Act for regulatory frameworks",
    "Explore multi-stakeholder governance models"
  ]
}

// GET /api/debate/history
{
  debates: Debate[];  // Last 20 debates, sorted by newest
}

const opponent = selectBestOpponent(topic);
// Returns expert with highest relevance score