Tutoring Assistant

def analyze_student_performance(student_data: str) -> str:
    """
    Analyze student performance across subjects and identify areas needing support.
    
    Args:
        student_data: JSON string with student grades, subjects, and assignment completion rates
        Example: {"student_id": "12345", "grades": [{"subject": "Math", "score": 75, "assignments_completed": 8, "assignments_total": 10}]}
    
    Returns:
        Performance analysis report with recommendations
    """
    try:
        if isinstance(student_data, str):
            try:
                data = json.loads(student_data)
            except json.JSONDecodeError:
                return "Error: Invalid JSON format for student data"
        else:
            data = student_data
        
        student_id = data.get('student_id', 'Unknown')
        grades = data.get('grades', [])
        
        report = f"=== STUDENT PERFORMANCE ANALYSIS ===\n\n"
        report += f"Student ID: {student_id}\n\n"
        report += f"{'Subject':<20} {'Score':>8} {'Completion':>12} {'Status':>10}\n"
        report += "-" * 60 + "\n"
        
        total_score = 0
        struggling_subjects = []
        excellent_subjects = []
        
        for grade in grades:
            subject = grade.get('subject', 'Unknown')
            score = grade.get('score', 0)
            completed = grade.get('assignments_completed', 0)
            total = grade.get('assignments_total', 1)
            completion_rate = (completed / total) * 100 if total > 0 else 0
            
            total_score += score
            
            if score < 70:
                status = "⚠️ Risk"
                struggling_subjects.append(subject)
            elif score >= 90:
                status = "✓ Excellent"
                excellent_subjects.append(subject)
            else:
                status = "○ Adequate"
            
            report += f"{subject:<20} {score:>8}% {completion_rate:>11.0f}% {status:>10}\n"
        
        avg_score = total_score / len(grades) if grades else 0
        
        report += "\n=== SUMMARY ===\n"
        report += f"Overall Average: {avg_score:.1f}%\n\n"
        
        if struggling_subjects:
            report += "⚠️ INTERVENTION NEEDED:\n"
            report += f"Subjects requiring support: {', '.join(struggling_subjects)}\n"
            report += "Recommendations:\n"
            report += "  - Schedule tutoring sessions\n"
            report += "  - Review learning style preferences\n"
            report += "  - Consider peer study groups\n"
            report += "  - Monitor assignment completion patterns\n\n"
        
        if excellent_subjects:
            report += f"✓ Strong Performance: {', '.join(excellent_subjects)}\n"
            report += "  - Consider advanced enrichment activities\n\n"
        
        if avg_score < 70:
            report += "\n⚠️ ALERT: Student requires immediate academic intervention\n"
        
        return report
        
    except Exception as e:
        return f"Error analyzing student performance: {str(e)}"

def create_tutoring_plan(subject: str, current_level: str, target_level: str, timeline_weeks: int = 8) -> str:
    """
    Create a personalized tutoring plan for a student.
    
    Args:
        subject: The subject area(e.g., "Algebra", "English Literature")
        current_level: Current performance level(e.g., "65%", "D grade")
        target_level: Target performance level(e.g., "80%", "B grade")
        timeline_weeks: Number of weeks for the tutoring plan(default: 8)
    
    Returns:
        Detailed tutoring plan with weekly milestones
    """
    try:
        report = f"=== PERSONALIZED TUTORING PLAN ===\n\n"
        report += f"Subject: {subject}\n"
        report += f"Current Level: {current_level}\n"
        report += f"Target Level: {target_level}\n"
        report += f"Timeline: {timeline_weeks} weeks\n\n"
        
        report += "=== WEEKLY BREAKDOWN ===\n\n"
        
        weeks_per_phase = max(1, timeline_weeks // 3)
        
        "color: #6b7280;"># Phase 1: Foundation
        report += f"Weeks 1-{weeks_per_phase}: Foundation Building\n"
        report += "  - Review fundamental concepts\n"
        report += "  - Identify knowledge gaps\n"
        report += "  - Build confidence with achievable exercises\n"
        report += "  - Establish study routines\n\n"
        
        "color: #6b7280;"># Phase 2: Skill Development
        report += f"Weeks {weeks_per_phase + 1}-{weeks_per_phase * 2}: Skill Development\n"
        report += "  - Practice problem-solving techniques\n"
        report += "  - Apply concepts to real-world scenarios\n"
        report += "  - Increase complexity gradually\n"
        report += "  - Regular progress assessments\n\n"
        
        "color: #6b7280;"># Phase 3: Mastery
        report += f"Weeks {weeks_per_phase * 2 + 1}-{timeline_weeks}: Mastery & Assessment\n"
        report += "  - Advanced practice problems\n"
        report += "  - Test-taking strategies\n"
        report += "  - Review and reinforce weak areas\n"
        report += "  - Final assessment preparation\n\n"
        
        report += "=== SESSION RECOMMENDATIONS ===\n"
        report += "Frequency: 2-3 sessions per week\n"
        report += "Duration: 45-60 minutes per session\n"
        report += "Format: Mix of individual and small-group sessions\n\n"
        
        report += "=== PROGRESS CHECKPOINTS ===\n"
        for week in [2, 4, 6, 8]:
            if week <= timeline_weeks:
                report += f"Week {week}: Mini-assessment and plan adjustment\n"
        
        return report
        
    except Exception as e:
        return f"Error creating tutoring plan: {str(e)}"