Authenticate with email and password. Returns a session token for subsequent requests.

List all courses a student is enrolled in with basic info

Get details about a specific concept including current mastery for a student

Ask a question about a course topic. The system reads memory, answers using course context, identifies relevant concepts, infers confusion from phrasing, logs an interaction, and updates mastery records.

Get an adaptive explanation of a concept based on your current mastery level. Deeper explanations for weaker topics, concise for stronger ones.

Log a quiz or quick-check result for a concept. Updates mastery: correct answers boost confidence, incorrect ones reduce it and increment the wrong count.

Log a topic or doubt a student studied or asked about. Stores it with a timestamp and returns an id.

Search previously logged topics by a keyword or vague query. Performs a fuzzy match against subject, topic, and note from interaction history.

Get mastery data organized by course for the mastery heatmap widget. Returns courses with their concepts and confidence scores.

Proactively find concepts that have not been reviewed in at least N days (spaced-repetition style). Returns overdue concepts with effective confidence and days since review.

Mark a concept (by id) as reviewed right now. Resets its review clock, applies a confidence boost, and increments awareness.

DEMO/TESTING ONLY: artificially age a concept's last-reviewed timestamp by N days so get_review_due can be tested without waiting real time.

Set a study goal for a student with a deadline. Goals appear in daily briefings and help the planner prioritize.

Record a completed study session. Stores which topics were studied and duration, updates study streak analytics.

Build a daily academic summary: what is due soon, what should be reviewed today, trending weak topics, and urgent items. Call this at session start for a proactive briefing.

Generate a spaced-repetition review plan from mastery data and recency. Prioritizes weak and long-unreviewed concepts.

Surface concepts where low confidence intersects with deadline pressure or prolonged neglect. Prioritizes topics that need urgent intervention.

Get deadlines organized for the timeline widget. Returns upcoming assignments sorted by due date with course context.

Creates a new voice interaction session. Logs the start and returns a greeting tailored to the student's current context — recent activity, upcoming assignments, and weak topics.

Processes spoken input from a voice session: detects intent from transcript keywords, logs the interaction with voice-specific fields, updates mastery if a learning-related intent is detected, and returns a structured spoken response.

Ends an active voice session, logs a summary interaction, and returns session statistics including duration, interaction count, and topics covered.

Get a progress analytics summary: confidence trends, study hours, completed sessions, and weak areas.