Log in to USP with the USP number and Senha Única.

The password is encrypted to the backend's login key before leaving this process and is never stored. Returns the student's profile.

Log out, revoking the current session token.

The logged-in student's profile (name, USP number, email, course).

List the student's current Moodle (e-Disciplinas) courses.

A Moodle course's contents: its sections and activities (id, title, kind, url).

Open a Moodle activity by URL: page content, links and attached file, if any.

For file activities (PDFs, slides, ...) this returns the file's name, type and size — use moodle_download_file to save the bytes to disk.

Download a Moodle file activity (PDF, slides, ...) to local disk.

url is the activity URL from moodle_course (kind "Arquivo"/"Resource"). Saves into directory (default: $HEIDY_DOWNLOAD_DIR or ./downloads) and returns the saved path, name, MIME type and size. Files up to 10 MB.

Start a background sync pulling data from USP systems into the planner.

Sources default to all of schedule, grades, absences and moodle. Returns the sync run; poll usp_sync_status with its id until it succeeds or fails.

A sync run's status, per-source counts and error, if any.

Past sync runs, optionally filtered by status.

The student's semesters (label, start/end dates, which one is active).

The weekly class schedule for a semester: day -> time slots with locations.

The student's enrollments (classes), with meetings, professor and credits.

Grades recorded for one enrollment (label, score, max score, weight).

Weighted average, graded/remaining weight and passing status for an enrollment.

Absences recorded for one enrollment.

Absences used vs. the enrollment's limit, with a risk status.

The student's tasks (assignments, exams, ...), filterable and sortable.

due_before/due_after are ISO 8601 datetimes.

Create a task in the student's planner. due_at is an ISO 8601 datetime.

Move a task between todo, doing and done.