api-server/src/infrastructure/ai/ai-provider.interface.ts

export interface AiProvider {
  generateAnalysis(input: {
    userInput: string;
    context: Record<string, any>;
  }): Promise<{
    masteryScore: number;
    understandingLevel: string;
    summary: string;
    strengths: string[];
    weakPoints: string[];
    suggestions: string[];
    reviewNeeded: boolean;
    nextAction: string;
  }>;

  generateChatResponse(input: {
    message: string;
    history: Array<{ role: string; content: string }>;
    context?: string;
  }): Promise<{
    reply: string;
    suggestedActions: string[];
  }>;
}