Courses hidden on your Moodle dashboard are ones you don't follow; other tools skip them
unless you name them explicitly.

Args:
    include_past: Also list courses whose end date has passed.
    include_hidden: Also list courses hidden on your dashboard.

"TODO" means Moodle still expects something from you (e.g. nothing or only a draft submitted);
"done" means it doesn't (already submitted, or nothing to hand in).

Args:
    days: How many days ahead to look.
    course: Limit to one course (code like "CS-214", id, or name).
    include_past_days: Also show deadlines from the last N days (to catch overdue work).

Args:
    course: Course code like "CS-214", numeric id, or part of the name.
    section: Only show sections whose number or name matches (e.g. "3" or "Semantics").

- file (resource): the extracted text. Long PDFs return a page map (one line per page)
  first; then call again with pages="12-14" for just the pages you need
- assignment: instructions, dates, attachments, your submission status and grade
- page: its text
- forum: latest discussions (read one with read_discussion)
- folder: its files (read one with read_file)
- link (url): the target URL
- quiz: open/close dates, time limit, attempts, best grade

Args:
    item_id: The [id ...] from course_overview, search or upcoming_deadlines.
    pages: For PDFs, which pages to read, e.g. "1-5", "2,4,10-12" or "all".
    max_chars: Maximum characters of file text to return; longer PDFs get a page map.

Long PDFs return a page map first; call again with pages="12-14" for the pages you need.
Code and text files come back as-is. On the user's Mac the file is also saved locally (path in the output).

Args:
    file_url: A moodle.epfl.ch .../pluginfile.php/... URL from open_item, search_in_files or read_discussion.
    pages: For PDFs, which pages to read, e.g. "1-5", "2,4,10-12" or "all".
    max_chars: Maximum characters of text to return; longer PDFs get a page map.

Args:
    discussion_id: The [discussion ...] id from open_item on a forum, or from announcements.

Args:
    days: How far back to look.
    course: Limit to one course (code like "CS-214", id, or name).

Args:
    course: Course code like "CS-214", numeric id, or part of the name.

Matches words in item names, file names and section names (accents and case ignored).

Args:
    query: Words to look for, e.g. "homework 3" or "lecture 5 slides".
    course: Limit to one course; by default searches all ongoing courses.

Returns the best-matching pages with a snippet and the exact call to read them, so you can
read only the relevant pages instead of whole files. The first search in a course downloads
and indexes its files (can take a minute); later searches are instant.

Args:
    query: Words that must all appear on the same page, e.g. "big-step semantics".
    course: Limit to one course (recommended); by default searches all ongoing courses.
    max_results: How many matching pages to return.

By default covers the time since you last called whats_new without `since` (or the last
7 days the first time), then remembers now as the new "last check".

Args:
    since: Look back this far instead: "3d", "12h", "2w", or a date like "2026-09-20".
        Doesn't move the "last check" marker.
    course: Limit to one course (code like "CS-214", id, or name).

Saves files, folder contents, assignment attachments and pages (as .md), plus an INDEX.md
listing everything with links, due dates and item ids. Only new or changed files are
downloaded, so it's cheap to run again. Nothing on Moodle is changed.

Args:
    course: Course code like "CS-214", numeric id, or part of the name.
    folder: Where to save. Defaults to ~/Moodle/<course code>.
    max_file_mb: Skip files larger than this (e.g. lecture videos).