@falkenslab/moodle-driver 0.4.1 → 0.5.0

package/dist/cli/commands.generated.js

@@ -70,9 +70,46 @@ export const COMMANDS = [
             ]
         }
     },
+    {
+        "name": "activityReport",
+        "description": "A course's activity report: per activity, how many times it was viewed, by how many people, and when last, from the logs (between `from` and `until` when given). Activities nobody viewed come with zero views.",
+        "params": [
+            {
+                "name": "courseId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ],
+        "options": {
+            "name": "options",
+            "optional": true,
+            "open": false,
+            "fields": [
+                {
+                    "name": "from",
+                    "optional": true,
+                    "type": "Date",
+                    "value": {
+                        "kind": "date"
+                    }
+                },
+                {
+                    "name": "until",
+                    "optional": true,
+                    "type": "Date",
+                    "value": {
+                        "kind": "date"
+                    }
+                }
+            ]
+        }
+    },
     {
         "name": "activitySettings",
-        "description": "An activity's settings as its form holds them, without submitting it: its module, name and description, and every field by the name `updateActivity` takes in `settings`. Teachers only.",
+        "description": "An activity's settings as its form holds them, without submitting it: its module, name and description, every field by the name `updateActivity` takes in `settings`, the files of a resource, folder or SCORM, and its restrictions and completion in plain terms. Teachers only.",
         "params": [
             {
                 "name": "activityId",
@@ -140,6 +177,67 @@ export const COMMANDS = [
             ]
         }
     },
+    {
+        "name": "addGradeItem",
+        "description": "Adds a manual grade item (one graded in the gradebook, not by an activity): out of `maxGrade` (Moodle's default, 100, when left out) or on a scale (`scaleId`), at the course's top level or in `categoryId`, hidden from students when asked. Returns it as the setup shows it.",
+        "params": [
+            {
+                "name": "courseId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ],
+        "options": {
+            "name": "options",
+            "optional": false,
+            "open": false,
+            "fields": [
+                {
+                    "name": "name",
+                    "optional": false,
+                    "type": "string",
+                    "value": {
+                        "kind": "string"
+                    }
+                },
+                {
+                    "name": "maxGrade",
+                    "optional": true,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    }
+                },
+                {
+                    "name": "scaleId",
+                    "optional": true,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    }
+                },
+                {
+                    "name": "categoryId",
+                    "optional": true,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    }
+                },
+                {
+                    "name": "hidden",
+                    "optional": true,
+                    "type": "boolean",
+                    "value": {
+                        "kind": "boolean"
+                    }
+                }
+            ]
+        }
+    },
     {
         "name": "addQuestionsToQuiz",
         "description": "Adds bank questions to a quiz by id, and random questions from a bank category, at the end or on a page, as the edit page's bank actions post them. Returns the quiz's structure afterwards. A quiz already attempted can't change its questions: Moodle refuses, and so does this.",
@@ -185,9 +283,54 @@ export const COMMANDS = [
             ]
         }
     },
+    {
+        "name": "addQuizSection",
+        "description": "Adds a section to a quiz starting at a slot, with its heading and whether its questions are shuffled, as the edit page's \"Add a new section heading\" and its heading and shuffle controls do. A section starts at a page: the slot must be the first of its page (see `setQuizPages`).",
+        "params": [
+            {
+                "name": "activityId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ],
+        "options": {
+            "name": "options",
+            "optional": false,
+            "open": false,
+            "fields": [
+                {
+                    "name": "firstSlot",
+                    "optional": false,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    }
+                },
+                {
+                    "name": "heading",
+                    "optional": false,
+                    "type": "string",
+                    "value": {
+                        "kind": "string"
+                    }
+                },
+                {
+                    "name": "shuffle",
+                    "optional": true,
+                    "type": "boolean",
+                    "value": {
+                        "kind": "boolean"
+                    }
+                }
+            ]
+        }
+    },
     {
         "name": "addSection",
-        "description": "Adds a section after another one (at the end without it), named when a name is given.",
+        "description": "Adds a section after another one (at the end without it), named when a name is given, with a description (HTML) when `summary` is.",
         "params": [
             {
                 "name": "courseId",
@@ -218,10 +361,48 @@ export const COMMANDS = [
                     "value": {
                         "kind": "number"
                     }
+                },
+                {
+                    "name": "summary",
+                    "optional": true,
+                    "type": "string",
+                    "value": {
+                        "kind": "string"
+                    }
                 }
             ]
         }
     },
+    {
+        "name": "allocateMarker",
+        "description": "Allocates a marker (the user id of someone who can grade; several where the assignment uses several markers per submission) to participants' submissions, as the grading table's \"Allocate marker\" does. Moodle leaves alone submissions past marking (marking completed, in review, ready for release, released).",
+        "params": [
+            {
+                "name": "activityId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            },
+            {
+                "name": "userIds",
+                "optional": false,
+                "type": "number[]",
+                "value": {
+                    "kind": "numbers"
+                }
+            },
+            {
+                "name": "markerId",
+                "optional": false,
+                "type": "number | number[]",
+                "value": {
+                    "kind": "json"
+                }
+            }
+        ]
+    },
     {
         "name": "answerChoice",
         "description": "Answers a choice with one option (several where it allows them) by id, as \"Save my choice\" does; returns the choice afterwards.",
@@ -327,8 +508,8 @@ export const COMMANDS = [
         }
     },
     {
-        "name": "assignmentSubmissions",
-        "description": "Every participant's submission to an assignment, with its content unless `includeContent` is false.",
+        "name": "assessWorkshopSubmission",
+        "description": "Assesses a submission as the person, through the workshop's assessment form (its grading strategy's: accumulative, comments, number of errors or rubric), as \"Assess\" on the submission's page and the form do: a teacher who hasn't assessed it yet gets an assessment of their own, and one already made is changed. `criteria` go in the form's order; `feedback` is the overall feedback for the author (HTML), where the workshop has it on; `fields` sets any other field of the form by name (`weight`…). Returns a sentence of what changed, the assessment's id, and the grade it gives the submission out of the workshop's grade. Throws `WorkshopError` outside the assessment phase, when a criterion's grade isn't one it takes, or when the workshop has no overall feedback; `FormError` when Moodle refuses the form (a criterion left without a grade).",
         "params": [
             {
                 "name": "activityId",
@@ -337,47 +518,80 @@ export const COMMANDS = [
                 "value": {
                     "kind": "number"
                 }
+            },
+            {
+                "name": "submissionId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
             }
         ],
         "options": {
             "name": "options",
-            "optional": true,
+            "optional": false,
             "open": false,
             "fields": [
                 {
-                    "name": "includeContent",
+                    "name": "criteria",
                     "optional": true,
-                    "type": "boolean",
+                    "type": "WorkshopCriterion[]",
                     "value": {
-                        "kind": "boolean"
+                        "kind": "json"
+                    }
+                },
+                {
+                    "name": "feedback",
+                    "optional": true,
+                    "type": "string",
+                    "value": {
+                        "kind": "string"
+                    }
+                },
+                {
+                    "name": "fields",
+                    "optional": true,
+                    "type": "Record<string, FieldValue>",
+                    "value": {
+                        "kind": "json"
                     }
                 }
             ]
         }
     },
     {
-        "name": "callService",
-        "description": "Calls one of Moodle's AJAX services as the logged-in person.",
+        "name": "assignmentSubmissions",
+        "description": "Every participant's submission to an assignment, with the group they submit for (group submissions), and, unless `includeContent` is false, its content, the feedback files they have, its marking workflow state and markers (all from each participant's grading panel).",
         "params": [
             {
-                "name": "methodname",
+                "name": "activityId",
                 "optional": false,
-                "type": "string",
+                "type": "number",
                 "value": {
-                    "kind": "string"
+                    "kind": "number"
                 }
             }
         ],
         "options": {
-            "name": "args",
-            "optional": false,
-            "open": true,
-            "fields": []
+            "name": "options",
+            "optional": true,
+            "open": false,
+            "fields": [
+                {
+                    "name": "includeContent",
+                    "optional": true,
+                    "type": "boolean",
+                    "value": {
+                        "kind": "boolean"
+                    }
+                }
+            ]
         }
     },
     {
-        "name": "completionReport",
-        "description": "A course's progress report: every participant's completion of every activity that tracks it, page by page, in one group when given. People come as user id and full name only.",
+        "name": "backupCourse",
+        "description": "Backs a course up to a `.mbz` file, through Moodle's backup wizard (initial settings, schema, confirmation), and downloads it into `destDir`. Without users' data unless `withUsers`, which needs `moodle/backup:userinfo` (`anonymize` makes their names anonymous). An asynchronous backup is waited for up to `timeoutMs` (ten minutes). Moodle keeps the file in the course's or the person's backup area too.",
         "params": [
             {
                 "name": "courseId",
@@ -386,6 +600,14 @@ export const COMMANDS = [
                 "value": {
                     "kind": "number"
                 }
+            },
+            {
+                "name": "destDir",
+                "optional": false,
+                "type": "string",
+                "value": {
+                    "kind": "string"
+                }
             }
         ],
         "options": {
@@ -394,7 +616,23 @@ export const COMMANDS = [
             "open": false,
             "fields": [
                 {
-                    "name": "group",
+                    "name": "withUsers",
+                    "optional": true,
+                    "type": "boolean",
+                    "value": {
+                        "kind": "boolean"
+                    }
+                },
+                {
+                    "name": "anonymize",
+                    "optional": true,
+                    "type": "boolean",
+                    "value": {
+                        "kind": "boolean"
+                    }
+                },
+                {
+                    "name": "timeoutMs",
                     "optional": true,
                     "type": "number",
                     "value": {
@@ -405,11 +643,11 @@ export const COMMANDS = [
         }
     },
     {
-        "name": "conversation",
-        "description": "A conversation's messages, oldest first, as text, and its members as `conversations()` gives them: everyone but the person, whether they wrote in it or not (the person alone in their own conversation).",
+        "name": "calendarEvent",
+        "description": "One calendar event by its id, as `upcomingEvents` gives them.",
         "params": [
             {
-                "name": "conversationId",
+                "name": "eventId",
                 "optional": false,
                 "type": "number",
                 "value": {
@@ -419,12 +657,160 @@ export const COMMANDS = [
         ]
     },
     {
-        "name": "conversations",
-        "description": "The person's conversations, latest first, with their last message as text.",
-        "params": []
-    },
-    {
-        "name": "courseAbilities",
+        "name": "callService",
+        "description": "Calls one of Moodle's AJAX services as the logged-in person.",
+        "params": [
+            {
+                "name": "methodname",
+                "optional": false,
+                "type": "string",
+                "value": {
+                    "kind": "string"
+                }
+            }
+        ],
+        "options": {
+            "name": "args",
+            "optional": false,
+            "open": true,
+            "fields": []
+        }
+    },
+    {
+        "name": "completionReport",
+        "description": "A course's progress report: every participant's completion of every activity that tracks it, page by page, in one group when given. People come as user id and full name only.",
+        "params": [
+            {
+                "name": "courseId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ],
+        "options": {
+            "name": "options",
+            "optional": true,
+            "open": false,
+            "fields": [
+                {
+                    "name": "group",
+                    "optional": true,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    }
+                }
+            ]
+        }
+    },
+    {
+        "name": "conversation",
+        "description": "A conversation's messages, oldest first, as text, and its members as `conversations()` gives them: everyone but the person, whether they wrote in it or not (the person alone in their own conversation).",
+        "params": [
+            {
+                "name": "conversationId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ]
+    },
+    {
+        "name": "conversations",
+        "description": "The person's conversations, latest first, with their last message as text.",
+        "params": []
+    },
+    {
+        "name": "copyCourse",
+        "description": "Copies a course into a new one, as Moodle's \"Copy course\" does: its content (and its people's data and enrolments, `withUsers`), under a new full and short name, in a category (the course's unless given), with new dates. Goes through Moodle's copy service, then waits for the copy, which Moodle makes in its scheduled tasks, up to `timeoutMs` (ten minutes). Needs the rights to back up, restore and create courses (`moodle/backup:backupcourse`, `moodle/restore:restorecourse`, `moodle/course:create`); without them, `BackupError` says so.",
+        "params": [
+            {
+                "name": "courseId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ],
+        "options": {
+            "name": "options",
+            "optional": false,
+            "open": false,
+            "fields": [
+                {
+                    "name": "fullName",
+                    "optional": false,
+                    "type": "string",
+                    "value": {
+                        "kind": "string"
+                    }
+                },
+                {
+                    "name": "shortName",
+                    "optional": false,
+                    "type": "string",
+                    "value": {
+                        "kind": "string"
+                    }
+                },
+                {
+                    "name": "categoryId",
+                    "optional": true,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    }
+                },
+                {
+                    "name": "start",
+                    "optional": true,
+                    "type": "Date",
+                    "value": {
+                        "kind": "date"
+                    }
+                },
+                {
+                    "name": "end",
+                    "optional": true,
+                    "type": "Date",
+                    "value": {
+                        "kind": "date"
+                    }
+                },
+                {
+                    "name": "withUsers",
+                    "optional": true,
+                    "type": "boolean",
+                    "value": {
+                        "kind": "boolean"
+                    }
+                },
+                {
+                    "name": "visible",
+                    "optional": true,
+                    "type": "boolean",
+                    "value": {
+                        "kind": "boolean"
+                    }
+                },
+                {
+                    "name": "timeoutMs",
+                    "optional": true,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    }
+                }
+            ]
+        }
+    },
+    {
+        "name": "courseAbilities",
         "description": "What the person can do in a course, asked of read-only services that need the capability: the activity types they can add (none without `moodle/course:manageactivities`) and the grader report's users (`nopermissions` without `gradereport/grader:view`). Nothing is changed.",
         "params": [
             {
@@ -459,6 +845,82 @@ export const COMMANDS = [
             }
         ]
     },
+    {
+        "name": "courseLogs",
+        "description": "A course's logs, newest first, as its logs report lists them: by a user, an activity, a kind of action, and a time span, up to `limit` entries (100 unless given). Moodle filters by user, activity and action; the span is read page by page, stopping at the first entry older than `from`. Every entry's time comes as an ISO date, read back with the site language's own format.",
+        "params": [
+            {
+                "name": "courseId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ],
+        "options": {
+            "name": "options",
+            "optional": true,
+            "open": false,
+            "fields": [
+                {
+                    "name": "userId",
+                    "optional": true,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    }
+                },
+                {
+                    "name": "activityId",
+                    "optional": true,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    }
+                },
+                {
+                    "name": "from",
+                    "optional": true,
+                    "type": "Date",
+                    "value": {
+                        "kind": "date"
+                    }
+                },
+                {
+                    "name": "until",
+                    "optional": true,
+                    "type": "Date",
+                    "value": {
+                        "kind": "date"
+                    }
+                },
+                {
+                    "name": "action",
+                    "optional": true,
+                    "type": "\"create\" | \"view\" | \"update\" | \"delete\" | \"change\"",
+                    "value": {
+                        "kind": "enum",
+                        "values": [
+                            "create",
+                            "view",
+                            "update",
+                            "delete",
+                            "change"
+                        ]
+                    }
+                },
+                {
+                    "name": "limit",
+                    "optional": true,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    }
+                }
+            ]
+        }
+    },
     {
         "name": "courseRoles",
         "description": "A user's roles in a course, from their profile there: role links carry the role id in any language.",
@@ -483,7 +945,7 @@ export const COMMANDS = [
     },
     {
         "name": "courseStructure",
-        "description": "A course's sections and activities; with `details`, each activity's dates and restriction from the course page (slower).",
+        "description": "A course's sections and activities; with `details`, each activity's dates and restriction and each section's description, from the course page (slower).",
         "params": [
             {
                 "name": "courseId",
@@ -534,12 +996,12 @@ export const COMMANDS = [
     },
     {
         "name": "createActivity",
-        "description": "Creates an activity or resource of any type at the end of a section, through Moodle's own form, hidden from students unless `visibility` says otherwise. `files` are local paths uploaded to a file resource or folder; a SCORM (`type: \"scorm\"`) takes the first as its package.",
+        "description": "Creates an activity or resource of any type at the end of a section, through Moodle's own form, hidden from students unless `visibility` says otherwise. `files` are local paths uploaded to a file resource or folder (a `DraftUpload` puts one in a folder's subfolder); a SCORM (`type: \"scorm\"`) or an H5P activity (`type: \"h5pactivity\"`) takes the first as its package.",
         "params": [
             {
                 "name": "input",
                 "optional": false,
-                "type": "ActivityFields & { courseId: number; sectionId: number; type: string; files?: string[]; }",
+                "type": "ActivityFields & { courseId: number; sectionId: number; type: string; files?: (string | DraftUpload)[]; }",
                 "value": {
                     "kind": "json"
                 }
@@ -598,6 +1060,50 @@ export const COMMANDS = [
             ]
         }
     },
+    {
+        "name": "createGroup",
+        "description": "Creates a group in a course with its group form (`group/group.php`). Throws `FormError` with Moodle's reason when it refuses (a name already used, an enrolment key another group has).",
+        "params": [
+            {
+                "name": "courseId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            },
+            {
+                "name": "settings",
+                "optional": false,
+                "type": "GroupSettings & { name: string; }",
+                "value": {
+                    "kind": "json"
+                }
+            }
+        ]
+    },
+    {
+        "name": "createGrouping",
+        "description": "Creates a grouping in a course with its form (`group/grouping.php`); add its groups with `setGroupingGroups`.",
+        "params": [
+            {
+                "name": "courseId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            },
+            {
+                "name": "settings",
+                "optional": false,
+                "type": "GroupingSettings & { name: string; }",
+                "value": {
+                    "kind": "json"
+                }
+            }
+        ]
+    },
     {
         "name": "createQuestion",
         "description": "Creates one question in a bank through its type's edit form; returns its id. Imports are the way for several; this is for one-offs.",
@@ -655,7 +1161,7 @@ export const COMMANDS = [
                     "value": {
                         "kind": "json"
                     },
-                    "description": "Multichoice, short answer and numerical answers: a fraction of the mark (1 right, 0 wrong, negatives for penalties), the nearest one Moodle offers."
+                    "description": "Multichoice, short answer and numerical answers: a fraction of the mark (1 right, 0 wrong, negatives for penalties), the nearest one Moodle offers. A numerical answer's `tolerance` is the error accepted around it."
                 },
                 {
                     "name": "correct",
@@ -672,7 +1178,8 @@ export const COMMANDS = [
                     "type": "number",
                     "value": {
                         "kind": "number"
-                    }
+                    },
+                    "description": "The bank's category it goes in; a new question goes in the bank's default one when left out."
                 },
                 {
                     "name": "defaultMark",
@@ -767,8 +1274,8 @@ export const COMMANDS = [
         ]
     },
     {
-        "name": "deleteSection",
-        "description": "Deletes a section and every activity in it, with their participants' data.",
+        "name": "deleteGradeCategory",
+        "description": "Deletes a grade category. Moodle moves what it held (items and categories) into its parent and deletes the grades of its total; the course's own category can't be deleted.",
         "params": [
             {
                 "name": "courseId",
@@ -779,7 +1286,7 @@ export const COMMANDS = [
                 }
             },
             {
-                "name": "sectionId",
+                "name": "categoryId",
                 "optional": false,
                 "type": "number",
                 "value": {
@@ -789,11 +1296,119 @@ export const COMMANDS = [
         ]
     },
     {
-        "name": "discussion",
-        "description": "A discussion's posts, oldest first, with their messages as text.",
+        "name": "deleteGradeItem",
+        "description": "Deletes a manual grade item and its grades. An activity's item goes with its activity (Moodle would make it again), so it's refused.",
         "params": [
             {
-                "name": "discussionId",
+                "name": "courseId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            },
+            {
+                "name": "itemId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ]
+    },
+    {
+        "name": "deleteGroup",
+        "description": "Deletes a group, as the groups page's \"Delete selected group\" does once confirmed; its members stay in the course.",
+        "params": [
+            {
+                "name": "groupId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ]
+    },
+    {
+        "name": "deleteGrouping",
+        "description": "Deletes a grouping, as its delete icon does once confirmed; its groups stay.",
+        "params": [
+            {
+                "name": "groupingId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ]
+    },
+    {
+        "name": "deletePost",
+        "description": "Deletes a post and its replies through Moodle's own confirmation (`post.php?delete=`); a discussion's first post takes the whole discussion. Only a moderator deletes a post with replies, or someone else's. `replies` says how many replies went with it. Throws `ForumError` with Moodle's reason when it refuses.",
+        "params": [
+            {
+                "name": "postId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ]
+    },
+    {
+        "name": "deleteQuestions",
+        "description": "Deletes questions from a bank, every version of each, as the bank's delete action does: asked, then confirmed. Moodle doesn't delete a question a quiz uses: it hides it, and `hidden` lists those.",
+        "params": [
+            {
+                "name": "activityId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            },
+            {
+                "name": "questionIds",
+                "optional": false,
+                "type": "number[]",
+                "value": {
+                    "kind": "numbers"
+                }
+            }
+        ]
+    },
+    {
+        "name": "deleteSection",
+        "description": "Deletes a section and every activity in it, with their participants' data.",
+        "params": [
+            {
+                "name": "courseId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            },
+            {
+                "name": "sectionId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ]
+    },
+    {
+        "name": "discussion",
+        "description": "A discussion's posts, oldest first, with their messages as text.",
+        "params": [
+            {
+                "name": "discussionId",
                 "optional": false,
                 "type": "number",
                 "value": {
@@ -913,19 +1528,11 @@ export const COMMANDS = [
         }
     },
     {
-        "name": "editSection",
-        "description": "Renames, shows or hides, or moves a section after another one.",
+        "name": "editPost",
+        "description": "Changes a post through Moodle's own post form (`post.php?edit=`), as its author (within the site's editing time) or a moderator: only what's given changes. Returns the post afterwards. Throws `ForumError` with Moodle's reason when it refuses.",
         "params": [
             {
-                "name": "courseId",
-                "optional": false,
-                "type": "number",
-                "value": {
-                    "kind": "number"
-                }
-            },
-            {
-                "name": "sectionId",
+                "name": "postId",
                 "optional": false,
                 "type": "number",
                 "value": {
@@ -934,12 +1541,12 @@ export const COMMANDS = [
             }
         ],
         "options": {
-            "name": "options",
+            "name": "changes",
             "optional": false,
             "open": false,
             "fields": [
                 {
-                    "name": "name",
+                    "name": "subject",
                     "optional": true,
                     "type": "string",
                     "value": {
@@ -947,41 +1554,29 @@ export const COMMANDS = [
                     }
                 },
                 {
-                    "name": "visible",
+                    "name": "message",
                     "optional": true,
-                    "type": "boolean",
+                    "type": "string",
                     "value": {
-                        "kind": "boolean"
-                    }
+                        "kind": "string"
+                    },
+                    "description": "The new message (HTML), replacing the old one."
                 },
                 {
-                    "name": "afterSectionId",
+                    "name": "files",
                     "optional": true,
-                    "type": "number",
+                    "type": "{ add?: string[]; remove?: string[]; }",
                     "value": {
-                        "kind": "number"
-                    }
+                        "kind": "json"
+                    },
+                    "description": "Attachments to add (absolute local paths) and to remove (by name, as the post lists them)."
                 }
             ]
         }
     },
     {
-        "name": "finishQuizAttempt",
-        "description": "Submits an attempt for grading, and gives its review when the quiz shows it.",
-        "params": [
-            {
-                "name": "attemptId",
-                "optional": false,
-                "type": "number",
-                "value": {
-                    "kind": "number"
-                }
-            }
-        ]
-    },
-    {
-        "name": "forumDiscussions",
-        "description": "A forum's discussions, as its page lists them: who started each, replies, last post.",
+        "name": "editQuizSlot",
+        "description": "Changes one slot of a quiz (by its place, from 1): its maximum mark, through the slots' service, and where it is, as dragging it on the edit page does: after another slot (`moveAfter`, 0 for first) and on a page. Moodle lets the mark change after attempts (it regrades them), not the rest.",
         "params": [
             {
                 "name": "activityId",
@@ -990,55 +1585,54 @@ export const COMMANDS = [
                 "value": {
                     "kind": "number"
                 }
-            }
-        ]
-    },
-    {
-        "name": "getChoice",
-        "description": "A choice: its options, whether it can be answered or changed, and the person's answer.",
-        "params": [
+            },
             {
-                "name": "activityId",
+                "name": "slot",
                 "optional": false,
                 "type": "number",
                 "value": {
                     "kind": "number"
                 }
             }
-        ]
-    },
-    {
-        "name": "getSurvey",
-        "description": "A survey (questionnaire or feedback): whether it can be answered, its intro and messages, and its questions page by page. Its module is found when not given.",
-        "params": [
-            {
-                "name": "activityId",
-                "optional": false,
-                "type": "number",
-                "value": {
-                    "kind": "number"
-                }
-            },
-            {
-                "name": "type",
-                "optional": true,
-                "type": "SurveyType",
-                "value": {
-                    "kind": "enum",
-                    "values": [
-                        "questionnaire",
-                        "feedback"
-                    ]
+        ],
+        "options": {
+            "name": "options",
+            "optional": false,
+            "open": false,
+            "fields": [
+                {
+                    "name": "maxMark",
+                    "optional": true,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    }
+                },
+                {
+                    "name": "moveAfter",
+                    "optional": true,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    }
+                },
+                {
+                    "name": "page",
+                    "optional": true,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    }
                 }
-            }
-        ]
+            ]
+        }
     },
     {
-        "name": "gradeSubmission",
-        "description": "Grades a participant as the grader does: a grade (simple grading), a rubric's level per criterion or a marking guide's score per criterion (by their ids, from `rubric()`), remarks per criterion, feedback comments (HTML), whether to notify, and any other grading field by name. Returns the grade saved and the gradebook's grade, the total Moodle computes for a rubric or a guide.",
+        "name": "editSection",
+        "description": "Renames, shows or hides, describes (`summary`, HTML), restricts (`restrictions`; `{ conditions: [] }` removes them) or moves a section after another one.",
         "params": [
             {
-                "name": "activityId",
+                "name": "courseId",
                 "optional": false,
                 "type": "number",
                 "value": {
@@ -1046,7 +1640,7 @@ export const COMMANDS = [
                 }
             },
             {
-                "name": "userId",
+                "name": "sectionId",
                 "optional": false,
                 "type": "number",
                 "value": {
@@ -1060,42 +1654,23 @@ export const COMMANDS = [
             "open": false,
             "fields": [
                 {
-                    "name": "grade",
+                    "name": "name",
                     "optional": true,
-                    "type": "string | number",
+                    "type": "string",
                     "value": {
                         "kind": "string"
                     }
                 },
                 {
-                    "name": "rubric",
-                    "optional": true,
-                    "type": "Record<number, number>",
-                    "value": {
-                        "kind": "json"
-                    },
-                    "description": "Criterion id → level id."
-                },
-                {
-                    "name": "guide",
-                    "optional": true,
-                    "type": "Record<number, number>",
-                    "value": {
-                        "kind": "json"
-                    },
-                    "description": "Criterion id → score."
-                },
-                {
-                    "name": "remarks",
+                    "name": "visible",
                     "optional": true,
-                    "type": "Record<number, string>",
+                    "type": "boolean",
                     "value": {
-                        "kind": "json"
-                    },
-                    "description": "Criterion id → remark, for a rubric or a guide."
+                        "kind": "boolean"
+                    }
                 },
                 {
-                    "name": "feedback",
+                    "name": "summary",
                     "optional": true,
                     "type": "string",
                     "value": {
@@ -1103,27 +1678,27 @@ export const COMMANDS = [
                     }
                 },
                 {
-                    "name": "notify",
+                    "name": "restrictions",
                     "optional": true,
-                    "type": "boolean",
+                    "type": "Restrictions",
                     "value": {
-                        "kind": "boolean"
+                        "kind": "json"
                     }
                 },
                 {
-                    "name": "fields",
+                    "name": "afterSectionId",
                     "optional": true,
-                    "type": "Record<string, FieldValue>",
+                    "type": "number",
                     "value": {
-                        "kind": "json"
+                        "kind": "number"
                     }
                 }
             ]
         }
     },
     {
-        "name": "gradebookSetup",
-        "description": "A course's gradebook setup: its categories (aggregation, weights) and grade items (category, maximum, weight).",
+        "name": "enrolUsers",
+        "description": "Enrols users in a course by manual enrolment, as the participants page's \"Enrol users\" dialog does: with `roleId` or the enrolment's default role, from `start` (now, unless given) until `end` (the enrolment's default duration, unless given). Users already enrolled keep their enrolment, with the new dates. Throws `EnrolmentError` with Moodle's reason when it refuses (a role the person can't assign, no manual enrolment).",
         "params": [
             {
                 "name": "courseId",
@@ -1132,19 +1707,13 @@ export const COMMANDS = [
                 "value": {
                     "kind": "number"
                 }
-            }
-        ]
-    },
-    {
-        "name": "graderReport",
-        "description": "Everyone's grades in a course as the grader report shows them, page by page, in one group when given. People come as user id and full name only.",
-        "params": [
+            },
             {
-                "name": "courseId",
+                "name": "userIds",
                 "optional": false,
-                "type": "number",
+                "type": "number[]",
                 "value": {
-                    "kind": "number"
+                    "kind": "numbers"
                 }
             }
         ],
@@ -1154,49 +1723,35 @@ export const COMMANDS = [
             "open": false,
             "fields": [
                 {
-                    "name": "group",
+                    "name": "roleId",
                     "optional": true,
                     "type": "number",
                     "value": {
                         "kind": "number"
                     }
+                },
+                {
+                    "name": "start",
+                    "optional": true,
+                    "type": "Date",
+                    "value": {
+                        "kind": "date"
+                    }
+                },
+                {
+                    "name": "end",
+                    "optional": true,
+                    "type": "Date",
+                    "value": {
+                        "kind": "date"
+                    }
                 }
             ]
         }
     },
     {
-        "name": "grantExtension",
-        "description": "Grants participants an extension until a date, through the assignment's extension form (several at once as its bulk action does). Moodle refuses a date before the assignment's due date.",
-        "params": [
-            {
-                "name": "activityId",
-                "optional": false,
-                "type": "number",
-                "value": {
-                    "kind": "number"
-                }
-            },
-            {
-                "name": "userIds",
-                "optional": false,
-                "type": "number[]",
-                "value": {
-                    "kind": "numbers"
-                }
-            },
-            {
-                "name": "until",
-                "optional": false,
-                "type": "Date",
-                "value": {
-                    "kind": "date"
-                }
-            }
-        ]
-    },
-    {
-        "name": "groups",
-        "description": "A course's groups the person can see, with their members' user ids.",
+        "name": "enrolmentMethods",
+        "description": "A course's enrolment methods, in the order Moodle tries them: each one's type, name, whether it's enabled and how many users it enrolled, and from its form the role it gives and, for self enrolment and guest access, whether it asks for a key (never the key), self enrolment's dates and limit. Throws `EnrolmentError` when the person can't manage the course's enrolment methods.",
         "params": [
             {
                 "name": "courseId",
@@ -1209,25 +1764,11 @@ export const COMMANDS = [
         ]
     },
     {
-        "name": "h5pActivity",
-        "description": "An H5P activity: its content type, whether attempts are tracked, and the person's attempts with their scores.",
-        "params": [
-            {
-                "name": "activityId",
-                "optional": false,
-                "type": "number",
-                "value": {
-                    "kind": "number"
-                }
-            }
-        ]
-    },
-    {
-        "name": "importQuestions",
-        "description": "Imports questions into a bank from a GIFT or Moodle XML file (a local path) or text, through the bank's import form; returns the questions created. A file Moodle can't parse comes back as a `QuestionBankError` with its messages, and nothing is imported.",
+        "name": "exportGrades",
+        "description": "Saves a course's grades into `destDir` as Moodle exports them for a teacher: a spreadsheet (`xlsx`, `ods`), comma-separated text (`csv`) or XML, with the items, group, display and feedback chosen as in the export form. Returns the file as `downloadFile` does (never overwriting one). Throws `GradebookError` when the site has that format's export plugin disabled (naming the ones it has), when an item isn't in the course, or when Moodle refuses the export.",
         "params": [
             {
-                "name": "activityId",
+                "name": "courseId",
                 "optional": false,
                 "type": "number",
                 "value": {
@@ -1243,48 +1784,71 @@ export const COMMANDS = [
                 {
                     "name": "format",
                     "optional": false,
-                    "type": "\"gift\" | \"xml\"",
+                    "type": "\"ods\" | \"xml\" | \"xlsx\" | \"csv\"",
                     "value": {
                         "kind": "enum",
                         "values": [
-                            "gift",
-                            "xml"
+                            "ods",
+                            "xml",
+                            "xlsx",
+                            "csv"
                         ]
                     }
                 },
                 {
-                    "name": "file",
+                    "name": "itemIds",
                     "optional": true,
-                    "type": "string",
+                    "type": "number[]",
                     "value": {
-                        "kind": "string"
-                    }
+                        "kind": "numbers"
+                    },
+                    "description": "The grade items to export (ids from `graderReport` or `gradebookSetup`); all of them when left out."
                 },
                 {
-                    "name": "text",
+                    "name": "groupId",
                     "optional": true,
-                    "type": "string",
+                    "type": "number",
                     "value": {
-                        "kind": "string"
-                    }
+                        "kind": "number"
+                    },
+                    "description": "Only this group's members (a group id from `groups`)."
                 },
                 {
-                    "name": "categoryId",
+                    "name": "display",
                     "optional": true,
-                    "type": "number",
+                    "type": "GradeExportDisplay[]",
                     "value": {
-                        "kind": "number"
-                    }
+                        "kind": "json"
+                    },
+                    "description": "How grades are written; the site's default when left out. XML takes only one."
+                },
+                {
+                    "name": "feedback",
+                    "optional": true,
+                    "type": "boolean",
+                    "value": {
+                        "kind": "boolean"
+                    },
+                    "description": "Include each grade's feedback."
+                },
+                {
+                    "name": "destDir",
+                    "optional": true,
+                    "type": "string",
+                    "value": {
+                        "kind": "string"
+                    },
+                    "description": "The folder to save the file in (an absolute path); the `Moodle` object's `downloadDir` when left out there."
                 }
             ]
         }
     },
     {
-        "name": "lessonPage",
-        "description": "The lesson page the person is on (starting the lesson the first time).",
+        "name": "finishQuizAttempt",
+        "description": "Submits an attempt for grading, and gives its review when the quiz shows it.",
         "params": [
             {
-                "name": "activityId",
+                "name": "attemptId",
                 "optional": false,
                 "type": "number",
                 "value": {
@@ -1294,11 +1858,11 @@ export const COMMANDS = [
         ]
     },
     {
-        "name": "listAssignments",
-        "description": "The course's assignments, in the course's order, with the section each is in.",
+        "name": "forumDiscussions",
+        "description": "A forum's discussions, as its page lists them: who started each, replies, last post.",
         "params": [
             {
-                "name": "courseId",
+                "name": "activityId",
                 "optional": false,
                 "type": "number",
                 "value": {
@@ -1308,36 +1872,25 @@ export const COMMANDS = [
         ]
     },
     {
-        "name": "listCourses",
-        "description": "The courses the person is enrolled in, as teacher or student.",
+        "name": "forumGrades",
+        "description": "Everyone's whole-forum grade in a forum graded as a whole, as its grader shows them: one per person it can grade (only the active ones when the forum says so), with how it's graded. One service call per person. Throws `NotAForumError` for another activity, and `GradingError` when the forum isn't graded as a whole or uses an advanced grading method.",
         "params": [
             {
-                "name": "classification",
-                "optional": true,
-                "type": "\"all\" | \"inprogress\" | \"future\" | \"past\"",
+                "name": "activityId",
+                "optional": false,
+                "type": "number",
                 "value": {
-                    "kind": "enum",
-                    "values": [
-                        "all",
-                        "inprogress",
-                        "future",
-                        "past"
-                    ]
+                    "kind": "number"
                 }
             }
-        ]
-    },
-    {
-        "name": "logIn",
-        "description": "Makes sure there's a session: at once if there is one, else a window where the person logs in (`loginTimeoutMs` by default).",
-        "params": [],
+        ],
         "options": {
             "name": "options",
             "optional": true,
             "open": false,
             "fields": [
                 {
-                    "name": "timeoutMs",
+                    "name": "groupId",
                     "optional": true,
                     "type": "number",
                     "value": {
@@ -1348,21 +1901,11 @@ export const COMMANDS = [
         }
     },
     {
-        "name": "logOut",
-        "description": "Logs the person out of Moodle through the user menu's logout link (it carries the sesskey; without one Moodle asks to confirm, and the confirmation is accepted). Returns false when nobody was logged in. Only Moodle's session ends: a single sign-on provider may keep its own.",
-        "params": []
-    },
-    {
-        "name": "markNotificationsRead",
-        "description": "Marks all the person's notifications read, as the popover's \"Mark all as read\" does; doing it twice changes nothing.",
-        "params": []
-    },
-    {
-        "name": "myGrades",
-        "description": "The person's own grade report for a course.",
+        "name": "getChoice",
+        "description": "A choice: its options, whether it can be answered or changed, and the person's answer.",
         "params": [
             {
-                "name": "courseId",
+                "name": "activityId",
                 "optional": false,
                 "type": "number",
                 "value": {
@@ -1372,28 +1915,8 @@ export const COMMANDS = [
         ]
     },
     {
-        "name": "notifications",
-        "description": "The person's notifications, newest first, only the unread ones when asked.",
-        "params": [],
-        "options": {
-            "name": "options",
-            "optional": true,
-            "open": false,
-            "fields": [
-                {
-                    "name": "unreadOnly",
-                    "optional": true,
-                    "type": "boolean",
-                    "value": {
-                        "kind": "boolean"
-                    }
-                }
-            ]
-        }
-    },
-    {
-        "name": "overrideCompletion",
-        "description": "Sets someone's completion of an activity as a teacher does from the progress report; returns the state saved.",
+        "name": "getSurvey",
+        "description": "A survey (questionnaire or feedback): whether it can be answered, its intro and messages, and its questions page by page. Its module is found when not given.",
         "params": [
             {
                 "name": "activityId",
@@ -1404,49 +1927,33 @@ export const COMMANDS = [
                 }
             },
             {
-                "name": "userId",
-                "optional": false,
-                "type": "number",
-                "value": {
-                    "kind": "number"
-                }
-            },
-            {
-                "name": "state",
-                "optional": false,
-                "type": "\"incomplete\" | \"complete\" | \"complete-pass\" | \"complete-fail\"",
+                "name": "type",
+                "optional": true,
+                "type": "SurveyType",
                 "value": {
                     "kind": "enum",
                     "values": [
-                        "incomplete",
-                        "complete",
-                        "complete-pass",
-                        "complete-fail"
+                        "questionnaire",
+                        "feedback"
                     ]
                 }
             }
         ]
     },
     {
-        "name": "participantFilters",
-        "description": "The roles and groups the participants page filters by in a course (its filters' options), as the person may use them: every group, or only their own in a course with separate groups. \"No roles\" and \"no group\" left out.",
+        "name": "gradeForumUser",
+        "description": "Gives a person their whole-forum grade, as the forum's grader does: points (out of the forum's maximum), or a scale item by name or value; `null` takes the grade away. Moodle's forum grader has no feedback text. `notify` sends the person Moodle's notification, as the grader's checkbox does. Returns a sentence of what changed and the grade afterwards. Throws `GradingError` when the forum isn't graded as a whole, the grade is out of range or not on the scale, or Moodle refuses it.",
         "params": [
             {
-                "name": "courseId",
+                "name": "activityId",
                 "optional": false,
                 "type": "number",
                 "value": {
                     "kind": "number"
                 }
-            }
-        ]
-    },
-    {
-        "name": "participants",
-        "description": "A course's participants with their roles and groups, as the participants page lists them: only those with a role (its id), in a group, or (`inactiveSince`) who haven't accessed the course since that date, when asked. Each role and group is a filter of its own, so ids come in any language.",
-        "params": [
+            },
             {
-                "name": "courseId",
+                "name": "userId",
                 "optional": false,
                 "type": "number",
                 "value": {
@@ -1456,72 +1963,76 @@ export const COMMANDS = [
         ],
         "options": {
             "name": "options",
-            "optional": true,
+            "optional": false,
             "open": false,
             "fields": [
                 {
-                    "name": "role",
-                    "optional": true,
-                    "type": "number",
-                    "value": {
-                        "kind": "number"
-                    }
-                },
-                {
-                    "name": "group",
-                    "optional": true,
-                    "type": "number",
+                    "name": "grade",
+                    "optional": false,
+                    "type": "string | number",
                     "value": {
-                        "kind": "number"
+                        "kind": "string"
                     }
                 },
                 {
-                    "name": "inactiveSince",
+                    "name": "notify",
                     "optional": true,
-                    "type": "Date",
+                    "type": "boolean",
                     "value": {
-                        "kind": "date"
+                        "kind": "boolean"
                     }
                 }
             ]
         }
     },
     {
-        "name": "pendingActivities",
-        "description": "What the person still has to do in a course: activities whose completion is tracked and not complete or, where completion isn't tracked, graded activities without a grade yet.",
+        "name": "gradeQuizQuestion",
+        "description": "Grades one question of a finished attempt by hand, with a comment, through Moodle's comment form (the review's \"Make comment or override mark\"): an essay waiting for grading, or any question whose mark the teacher overrides. The mark is in the question's points (0 to its maximum in the quiz). Returns the attempt's grade afterwards when the results report shows it.",
         "params": [
             {
-                "name": "courseId",
+                "name": "attemptId",
                 "optional": false,
                 "type": "number",
                 "value": {
                     "kind": "number"
                 }
-            }
-        ]
-    },
-    {
-        "name": "publicSiteInfo",
-        "description": "What the site tells anyone before logging in, without the browser.",
-        "params": []
-    },
-    {
-        "name": "questionBanks",
-        "description": "A course's question banks: its shared ones and the activities' own, as the banks page lists them.",
-        "params": [
+            },
             {
-                "name": "courseId",
+                "name": "slot",
                 "optional": false,
                 "type": "number",
                 "value": {
                     "kind": "number"
                 }
             }
-        ]
+        ],
+        "options": {
+            "name": "options",
+            "optional": false,
+            "open": false,
+            "fields": [
+                {
+                    "name": "mark",
+                    "optional": false,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    }
+                },
+                {
+                    "name": "comment",
+                    "optional": true,
+                    "type": "string",
+                    "value": {
+                        "kind": "string"
+                    }
+                }
+            ]
+        }
     },
     {
-        "name": "questions",
-        "description": "A bank's categories and every question in them, category by category.",
+        "name": "gradeSubmission",
+        "description": "Grades a participant as the grader does: a grade (simple grading), a rubric's level per criterion or a marking guide's score per criterion (by their ids, from `rubric()`), remarks per criterion, feedback comments (HTML), feedback files (local paths that replace the ones the participant has; `[]` removes them), whether to notify, and any other grading field by name. Returns the grade saved and the gradebook's grade, the total Moodle computes for a rubric or a guide, and the feedback files after saving when they were given. Throws `GradingError` when Moodle refuses the grade, or when files are given to an assignment without feedback files.",
         "params": [
             {
                 "name": "activityId",
@@ -1530,15 +2041,124 @@ export const COMMANDS = [
                 "value": {
                     "kind": "number"
                 }
+            },
+            {
+                "name": "userId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
             }
-        ]
+        ],
+        "options": {
+            "name": "options",
+            "optional": false,
+            "open": false,
+            "fields": [
+                {
+                    "name": "grade",
+                    "optional": true,
+                    "type": "string | number",
+                    "value": {
+                        "kind": "string"
+                    }
+                },
+                {
+                    "name": "rubric",
+                    "optional": true,
+                    "type": "Record<number, number>",
+                    "value": {
+                        "kind": "json"
+                    },
+                    "description": "Criterion id → level id."
+                },
+                {
+                    "name": "guide",
+                    "optional": true,
+                    "type": "Record<number, number>",
+                    "value": {
+                        "kind": "json"
+                    },
+                    "description": "Criterion id → score."
+                },
+                {
+                    "name": "remarks",
+                    "optional": true,
+                    "type": "Record<number, string>",
+                    "value": {
+                        "kind": "json"
+                    },
+                    "description": "Criterion id → remark, for a rubric or a guide."
+                },
+                {
+                    "name": "feedback",
+                    "optional": true,
+                    "type": "string",
+                    "value": {
+                        "kind": "string"
+                    }
+                },
+                {
+                    "name": "feedbackFiles",
+                    "optional": true,
+                    "type": "string[]",
+                    "value": {
+                        "kind": "strings"
+                    },
+                    "description": "Local paths (absolute): the participant's feedback files afterwards."
+                },
+                {
+                    "name": "workflowState",
+                    "optional": true,
+                    "type": "\"notmarked\" | \"inmarking\" | \"readyforreview\" | \"inreview\" | \"readyforrelease\" | \"released\"",
+                    "value": {
+                        "kind": "enum",
+                        "values": [
+                            "notmarked",
+                            "inmarking",
+                            "readyforreview",
+                            "inreview",
+                            "readyforrelease",
+                            "released"
+                        ]
+                    },
+                    "description": "With the marking workflow: the state to leave the submission in (\"released\" shows the grade)."
+                },
+                {
+                    "name": "applyToGroup",
+                    "optional": true,
+                    "type": "boolean",
+                    "value": {
+                        "kind": "boolean"
+                    },
+                    "description": "With group submissions: grade every member of the participant's group alike (Moodle's default), or only them."
+                },
+                {
+                    "name": "notify",
+                    "optional": true,
+                    "type": "boolean",
+                    "value": {
+                        "kind": "boolean"
+                    }
+                },
+                {
+                    "name": "fields",
+                    "optional": true,
+                    "type": "Record<string, FieldValue>",
+                    "value": {
+                        "kind": "json"
+                    }
+                }
+            ]
+        }
     },
     {
-        "name": "quizInfo",
-        "description": "A quiz's page as the person sees it: its description and dates, the person's attempts with their summary, and whether they can start one.",
+        "name": "gradebookSetup",
+        "description": "A course's gradebook setup: its categories (aggregation, weights) and grade items (category, maximum, weight).",
         "params": [
             {
-                "name": "activityId",
+                "name": "courseId",
                 "optional": false,
                 "type": "number",
                 "value": {
@@ -1548,11 +2168,11 @@ export const COMMANDS = [
         ]
     },
     {
-        "name": "quizResults",
-        "description": "A quiz's attempts as its grades report shows them: per attempt the user, state, dates, grade and the mark per question; with `responses`, also the answer per question from the responses report. Every page of the report.",
+        "name": "graderReport",
+        "description": "Everyone's grades in a course as the grader report shows them, page by page, in one group when given. People come as user id and full name only.",
         "params": [
             {
-                "name": "activityId",
+                "name": "courseId",
                 "optional": false,
                 "type": "number",
                 "value": {
@@ -1566,19 +2186,19 @@ export const COMMANDS = [
             "open": false,
             "fields": [
                 {
-                    "name": "responses",
+                    "name": "group",
                     "optional": true,
-                    "type": "boolean",
+                    "type": "number",
                     "value": {
-                        "kind": "boolean"
+                        "kind": "number"
                     }
                 }
             ]
         }
     },
     {
-        "name": "quizStructure",
-        "description": "A quiz's questions as its edit page lists them: slots with their page, question, type, name and mark.",
+        "name": "grantExtension",
+        "description": "Grants participants an extension until a date, through the assignment's extension form (several at once as its bulk action does). Moodle refuses a date before the assignment's due date, and a person without its \"grant extension\" capability only on saving (the form opens for anyone, confirmed empirically on the sandbox, 5.2): both throw.",
         "params": [
             {
                 "name": "activityId",
@@ -1587,15 +2207,31 @@ export const COMMANDS = [
                 "value": {
                     "kind": "number"
                 }
+            },
+            {
+                "name": "userIds",
+                "optional": false,
+                "type": "number[]",
+                "value": {
+                    "kind": "numbers"
+                }
+            },
+            {
+                "name": "until",
+                "optional": false,
+                "type": "Date",
+                "value": {
+                    "kind": "date"
+                }
             }
         ]
     },
     {
-        "name": "readAttempt",
-        "description": "Every question of an attempt, page by page, with the page each is on.",
+        "name": "groupings",
+        "description": "A course's groupings with their groups' ids, from its groupings page and each grouping's groups page. Throws `MoodleError` with Moodle's refusal for a person who can't manage groups.",
         "params": [
             {
-                "name": "attemptId",
+                "name": "courseId",
                 "optional": false,
                 "type": "number",
                 "value": {
@@ -1605,11 +2241,11 @@ export const COMMANDS = [
         ]
     },
     {
-        "name": "readReview",
-        "description": "A finished attempt's review, as far as the quiz's review options let the person see it.",
+        "name": "groups",
+        "description": "A course's groups the person can see, with their members' user ids.",
         "params": [
             {
-                "name": "attemptId",
+                "name": "courseId",
                 "optional": false,
                 "type": "number",
                 "value": {
@@ -1619,11 +2255,1288 @@ export const COMMANDS = [
         ]
     },
     {
-        "name": "replyToPost",
-        "description": "Replies to a post; returns the new post's id and its discussion's.",
+        "name": "h5pActivity",
+        "description": "An H5P activity: its content type, whether attempts are tracked, and the person's attempts with their scores.",
+        "params": [
+            {
+                "name": "activityId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ]
+    },
+    {
+        "name": "importActivities",
+        "description": "Imports activities from another course into a course, as Moodle's \"Import\" does: every activity of `fromCourseId`, or only `activityIds`, added to `toCourseId`'s content (with their sections), without users' data. Needs `moodle/restore:restoretargetimport` in the course imported into and `moodle/backup:backuptargetimport` in the other. Returns the activities the course has afterwards that it didn't have before, by id.",
+        "params": [
+            {
+                "name": "fromCourseId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            },
+            {
+                "name": "toCourseId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ],
+        "options": {
+            "name": "options",
+            "optional": true,
+            "open": false,
+            "fields": [
+                {
+                    "name": "activityIds",
+                    "optional": true,
+                    "type": "number[]",
+                    "value": {
+                        "kind": "numbers"
+                    }
+                }
+            ]
+        }
+    },
+    {
+        "name": "importQuestions",
+        "description": "Imports questions into a bank from a GIFT or Moodle XML file (a local path) or text, through the bank's import form; returns the questions created. A file Moodle can't parse comes back as a `QuestionBankError` with its messages, and nothing is imported.",
         "params": [
             {
-                "name": "postId",
+                "name": "activityId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ],
+        "options": {
+            "name": "options",
+            "optional": false,
+            "open": false,
+            "fields": [
+                {
+                    "name": "format",
+                    "optional": false,
+                    "type": "\"xml\" | \"gift\"",
+                    "value": {
+                        "kind": "enum",
+                        "values": [
+                            "xml",
+                            "gift"
+                        ]
+                    }
+                },
+                {
+                    "name": "file",
+                    "optional": true,
+                    "type": "string",
+                    "value": {
+                        "kind": "string"
+                    }
+                },
+                {
+                    "name": "text",
+                    "optional": true,
+                    "type": "string",
+                    "value": {
+                        "kind": "string"
+                    }
+                },
+                {
+                    "name": "categoryId",
+                    "optional": true,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    }
+                }
+            ]
+        }
+    },
+    {
+        "name": "lessonPage",
+        "description": "The lesson page the person is on (starting the lesson the first time).",
+        "params": [
+            {
+                "name": "activityId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ]
+    },
+    {
+        "name": "listAssignments",
+        "description": "The course's assignments, in the course's order, with the section each is in.",
+        "params": [
+            {
+                "name": "courseId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ]
+    },
+    {
+        "name": "listCourses",
+        "description": "The courses the person is enrolled in, as teacher or student.",
+        "params": [
+            {
+                "name": "classification",
+                "optional": true,
+                "type": "\"all\" | \"inprogress\" | \"future\" | \"past\"",
+                "value": {
+                    "kind": "enum",
+                    "values": [
+                        "all",
+                        "inprogress",
+                        "future",
+                        "past"
+                    ]
+                }
+            }
+        ]
+    },
+    {
+        "name": "logIn",
+        "description": "Makes sure there's a session: at once if there is one, else a window where the person logs in (`loginTimeoutMs` by default).",
+        "params": [],
+        "options": {
+            "name": "options",
+            "optional": true,
+            "open": false,
+            "fields": [
+                {
+                    "name": "timeoutMs",
+                    "optional": true,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    }
+                }
+            ]
+        }
+    },
+    {
+        "name": "logOut",
+        "description": "Logs the person out of Moodle through the user menu's logout link (it carries the sesskey; without one Moodle asks to confirm, and the confirmation is accepted). Returns false when nobody was logged in. Only Moodle's session ends: a single sign-on provider may keep its own.",
+        "params": []
+    },
+    {
+        "name": "markNotificationsRead",
+        "description": "Marks all the person's notifications read, as the popover's \"Mark all as read\" does; doing it twice changes nothing.",
+        "params": []
+    },
+    {
+        "name": "messageParticipants",
+        "description": "Sends one message to several participants of a course, as the participants page's \"Send a message\" does for the users selected: one private message each, in one call. They are `userIds`, or the participants `participants()` chooses with `role`, `group` and `inactiveSince` (all of them when none is given), the person left out. `sentTo` lists exactly who got it, `refused` who Moodle didn't write to and why (they blocked the person, their privacy settings); someone who may message any user (a teacher, `moodle/site:messageanyuser`) gets through a block, as in Moodle's own page (confirmed empirically, Moodle 5.2). Throws `MessageError` for an empty message or nobody to write to, `NoParticipantsError` when the person can't see the course's participants.",
+        "params": [
+            {
+                "name": "courseId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            },
+            {
+                "name": "text",
+                "optional": false,
+                "type": "string",
+                "value": {
+                    "kind": "string"
+                }
+            }
+        ],
+        "options": {
+            "name": "selection",
+            "optional": true,
+            "open": false,
+            "fields": [
+                {
+                    "name": "userIds",
+                    "optional": false,
+                    "type": "number[]",
+                    "value": {
+                        "kind": "numbers"
+                    }
+                }
+            ]
+        }
+    },
+    {
+        "name": "myGrades",
+        "description": "The person's own grade report for a course.",
+        "params": [
+            {
+                "name": "courseId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ]
+    },
+    {
+        "name": "notifications",
+        "description": "The person's notifications, newest first, only the unread ones when asked.",
+        "params": [],
+        "options": {
+            "name": "options",
+            "optional": true,
+            "open": false,
+            "fields": [
+                {
+                    "name": "unreadOnly",
+                    "optional": true,
+                    "type": "boolean",
+                    "value": {
+                        "kind": "boolean"
+                    }
+                }
+            ]
+        }
+    },
+    {
+        "name": "overrideCompletion",
+        "description": "Sets someone's completion of an activity as a teacher does from the progress report; returns the state saved.",
+        "params": [
+            {
+                "name": "activityId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            },
+            {
+                "name": "userId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            },
+            {
+                "name": "state",
+                "optional": false,
+                "type": "\"incomplete\" | \"complete\" | \"complete-pass\" | \"complete-fail\"",
+                "value": {
+                    "kind": "enum",
+                    "values": [
+                        "incomplete",
+                        "complete",
+                        "complete-pass",
+                        "complete-fail"
+                    ]
+                }
+            }
+        ]
+    },
+    {
+        "name": "participantFilters",
+        "description": "The roles and groups the participants page filters by in a course (its filters' options), as the person may use them: every group, or only their own in a course with separate groups. \"No roles\" and \"no group\" left out.",
+        "params": [
+            {
+                "name": "courseId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ]
+    },
+    {
+        "name": "participants",
+        "description": "A course's participants with their roles and groups, as the participants page lists them: only those with a role (its id), in a group, or (`inactiveSince`) who haven't accessed the course since that date, when asked. Each role and group is a filter of its own, so ids come in any language.",
+        "params": [
+            {
+                "name": "courseId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ],
+        "options": {
+            "name": "options",
+            "optional": true,
+            "open": false,
+            "fields": [
+                {
+                    "name": "role",
+                    "optional": true,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    }
+                },
+                {
+                    "name": "group",
+                    "optional": true,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    }
+                },
+                {
+                    "name": "inactiveSince",
+                    "optional": true,
+                    "type": "Date",
+                    "value": {
+                        "kind": "date"
+                    }
+                }
+            ]
+        }
+    },
+    {
+        "name": "participationReport",
+        "description": "Who took part in an activity of a course, as its participation report counts it: everyone with the role (every role the report offers, unless `roleId`), with how many actions they made there (views or posts only, when `action`; since `since`, when given); those who did nothing come with 0.",
+        "params": [
+            {
+                "name": "courseId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            },
+            {
+                "name": "activityId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ],
+        "options": {
+            "name": "options",
+            "optional": true,
+            "open": false,
+            "fields": [
+                {
+                    "name": "roleId",
+                    "optional": true,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    }
+                },
+                {
+                    "name": "since",
+                    "optional": true,
+                    "type": "Date",
+                    "value": {
+                        "kind": "date"
+                    }
+                },
+                {
+                    "name": "action",
+                    "optional": true,
+                    "type": "\"view\" | \"post\"",
+                    "value": {
+                        "kind": "enum",
+                        "values": [
+                            "view",
+                            "post"
+                        ]
+                    }
+                }
+            ]
+        }
+    },
+    {
+        "name": "pendingActivities",
+        "description": "What the person still has to do in a course: activities whose completion is tracked and not complete or, where completion isn't tracked, graded activities without a grade yet.",
+        "params": [
+            {
+                "name": "courseId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ]
+    },
+    {
+        "name": "potentialUsers",
+        "description": "Users the person may enrol in a course by manual enrolment, matching `search` anywhere in their name or the identity fields the site shows (all of them, a page of up to 100, when empty), as the \"Enrol users\" dialog finds them. Throws `EnrolmentError` when the course has no manual enrolment the person can use.",
+        "params": [
+            {
+                "name": "courseId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            },
+            {
+                "name": "search",
+                "optional": true,
+                "type": "string",
+                "value": {
+                    "kind": "string"
+                }
+            }
+        ]
+    },
+    {
+        "name": "publicSiteInfo",
+        "description": "What the site tells anyone before logging in, without the browser.",
+        "params": []
+    },
+    {
+        "name": "questionBanks",
+        "description": "A course's question banks: its shared ones and the activities' own, as the banks page lists them.",
+        "params": [
+            {
+                "name": "courseId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ]
+    },
+    {
+        "name": "questions",
+        "description": "A bank's categories and every question in them, category by category.",
+        "params": [
+            {
+                "name": "activityId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ]
+    },
+    {
+        "name": "questionsToGrade",
+        "description": "The questions of a quiz that wait for grading by hand (essays…), as its manual grading report lists them, each with the finished attempts whose answer requires grading (from the results report). People as user id and full name.",
+        "params": [
+            {
+                "name": "activityId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ]
+    },
+    {
+        "name": "quizInfo",
+        "description": "A quiz's page as the person sees it: its description and dates, the person's attempts with their summary, and whether they can start one.",
+        "params": [
+            {
+                "name": "activityId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ]
+    },
+    {
+        "name": "quizResults",
+        "description": "A quiz's attempts as its grades report shows them: per attempt the user, state, dates, grade and the mark per question; with `responses`, also the answer per question from the responses report. Every page of the report.",
+        "params": [
+            {
+                "name": "activityId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ],
+        "options": {
+            "name": "options",
+            "optional": true,
+            "open": false,
+            "fields": [
+                {
+                    "name": "responses",
+                    "optional": true,
+                    "type": "boolean",
+                    "value": {
+                        "kind": "boolean"
+                    }
+                }
+            ]
+        }
+    },
+    {
+        "name": "quizStructure",
+        "description": "A quiz's questions as its edit page lists them: slots with their page, question, type, name and mark, and its sections.",
+        "params": [
+            {
+                "name": "activityId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ]
+    },
+    {
+        "name": "rate",
+        "description": "Rates a forum post, a glossary entry or a database record as the person, as the rating menu under it does: by a scale item's name, or its number (the points of a point scale). `null` takes the person's rating away. Returns a sentence of what changed and the item's aggregate afterwards (as Moodle shows it, by the activity's aggregation) with the number of ratings. Throws `GradingError` when the item has no rating menu for the person (ratings off, their own item, outside the rating period, or no permission) or the rating isn't on its scale.",
+        "params": [
+            {
+                "name": "item",
+                "optional": false,
+                "type": "RateableItem",
+                "value": {
+                    "kind": "json"
+                }
+            },
+            {
+                "name": "rating",
+                "optional": false,
+                "type": "string | number",
+                "value": {
+                    "kind": "string"
+                }
+            }
+        ]
+    },
+    {
+        "name": "readAttempt",
+        "description": "Every question of an attempt, page by page, with the page each is on.",
+        "params": [
+            {
+                "name": "attemptId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ]
+    },
+    {
+        "name": "readReview",
+        "description": "A finished attempt's review, as far as the quiz's review options let the person see it.",
+        "params": [
+            {
+                "name": "attemptId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ]
+    },
+    {
+        "name": "removeQuizSlot",
+        "description": "Removes a slot (by its place, from 1) from a quiz, as the edit page's delete icon does; the question stays in its bank.",
+        "params": [
+            {
+                "name": "activityId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            },
+            {
+                "name": "slot",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ]
+    },
+    {
+        "name": "replyToPost",
+        "description": "Replies to a post; returns the new post's id and its discussion's.",
+        "params": [
+            {
+                "name": "postId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            },
+            {
+                "name": "input",
+                "optional": false,
+                "type": "PostInput & { subject?: string; }",
+                "value": {
+                    "kind": "json"
+                }
+            }
+        ]
+    },
+    {
+        "name": "resetCourse",
+        "description": "Resets a course for a new year, as Moodle's reset form does: deletes only what's named in `delete` (in every module of the course that has it), unenrols the people with `unenrolRoles` (role ids), moves the course's start date to `start` (and its activities' dates with it), and sets any other of the form's fields by name (`fields`). Nothing is deleted unless asked: the form's own defaults are unticked first. It can't be undone. Returns Moodle's report: per component, what it did and its errors. Needs `moodle/course:reset`.",
+        "params": [
+            {
+                "name": "courseId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ],
+        "options": {
+            "name": "options",
+            "optional": false,
+            "open": false,
+            "fields": [
+                {
+                    "name": "delete",
+                    "optional": true,
+                    "type": "ResetDeletions",
+                    "value": {
+                        "kind": "json"
+                    }
+                },
+                {
+                    "name": "unenrolRoles",
+                    "optional": true,
+                    "type": "number[]",
+                    "value": {
+                        "kind": "numbers"
+                    }
+                },
+                {
+                    "name": "start",
+                    "optional": true,
+                    "type": "Date",
+                    "value": {
+                        "kind": "date"
+                    }
+                },
+                {
+                    "name": "fields",
+                    "optional": true,
+                    "type": "Record<string, FieldValue>",
+                    "value": {
+                        "kind": "json"
+                    }
+                }
+            ]
+        }
+    },
+    {
+        "name": "restoreCourse",
+        "description": "Restores a backup file (`.mbz`) through Moodle's restore wizard: into a new course in a category (`into: \"new\"`, with `categoryId`, which needs `moodle/course:create` there), or into an existing course (`into: <course id>`), its content added to the course's (`mode: \"merge\"`, the default) or replacing it (`\"replace\"`: the course's content is deleted first). A new course takes the backup's names unless `fullName` and `shortName` are given. Users' data is restored when `withUsers` and the backup has it. An asynchronous restore is waited for up to `timeoutMs` (ten minutes). Needs `moodle/restore:restorecourse` where it restores.",
+        "params": [
+            {
+                "name": "file",
+                "optional": false,
+                "type": "string",
+                "value": {
+                    "kind": "string"
+                }
+            }
+        ],
+        "options": {
+            "name": "options",
+            "optional": false,
+            "open": false,
+            "fields": [
+                {
+                    "name": "into",
+                    "optional": false,
+                    "type": "number | \"new\"",
+                    "value": {
+                        "kind": "string"
+                    }
+                },
+                {
+                    "name": "categoryId",
+                    "optional": true,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    }
+                },
+                {
+                    "name": "mode",
+                    "optional": true,
+                    "type": "\"merge\" | \"replace\"",
+                    "value": {
+                        "kind": "enum",
+                        "values": [
+                            "merge",
+                            "replace"
+                        ]
+                    }
+                },
+                {
+                    "name": "fullName",
+                    "optional": true,
+                    "type": "string",
+                    "value": {
+                        "kind": "string"
+                    }
+                },
+                {
+                    "name": "shortName",
+                    "optional": true,
+                    "type": "string",
+                    "value": {
+                        "kind": "string"
+                    }
+                },
+                {
+                    "name": "withUsers",
+                    "optional": true,
+                    "type": "boolean",
+                    "value": {
+                        "kind": "boolean"
+                    }
+                },
+                {
+                    "name": "timeoutMs",
+                    "optional": true,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    }
+                }
+            ]
+        }
+    },
+    {
+        "name": "rubric",
+        "description": "An assignment's grading method and, for a rubric or a marking guide, its criteria with the ids `gradeSubmission` takes: read from the grader's panel for its first participant.",
+        "params": [
+            {
+                "name": "activityId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ]
+    },
+    {
+        "name": "saveSubmission",
+        "description": "Saves the submission's online text and adds files, as \"Save changes\" on the edit page does; gives the assignment afterwards.",
+        "params": [
+            {
+                "name": "activityId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ],
+        "options": {
+            "name": "input",
+            "optional": false,
+            "open": false,
+            "fields": [
+                {
+                    "name": "onlineText",
+                    "optional": true,
+                    "type": "string",
+                    "value": {
+                        "kind": "string"
+                    }
+                },
+                {
+                    "name": "files",
+                    "optional": true,
+                    "type": "string[]",
+                    "value": {
+                        "kind": "strings"
+                    }
+                }
+            ]
+        }
+    },
+    {
+        "name": "scorm",
+        "description": "A SCORM activity as the person sees it: its attempts (allowed and made), the grading method, the grade reported and each attempt's, and its SCOs with the person's status and score in the last attempt. Moodle doesn't show a SCORM's version on its page: `openScorm` tells it.",
+        "params": [
+            {
+                "name": "activityId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ]
+    },
+    {
+        "name": "sendMessage",
+        "description": "Sends a private message to a user, as the messaging drawer does; returns the message and its conversation.",
+        "params": [
+            {
+                "name": "userId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            },
+            {
+                "name": "text",
+                "optional": false,
+                "type": "string",
+                "value": {
+                    "kind": "string"
+                }
+            }
+        ]
+    },
+    {
+        "name": "setCompletion",
+        "description": "Marks the person's own completion of an activity with manual completion, done or not, as its \"Mark as done\" button does; doing it twice changes nothing. An activity that completes on its own gives a `CompletionError`.",
+        "params": [
+            {
+                "name": "activityId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            },
+            {
+                "name": "done",
+                "optional": false,
+                "type": "boolean",
+                "value": {
+                    "kind": "boolean"
+                }
+            }
+        ]
+    },
+    {
+        "name": "setDiscussionState",
+        "description": "Pins or unpins, locks or unlocks a discussion, as the discussion list's menu does; what's already so is left alone. Returns the discussion as the forum lists it afterwards.",
+        "params": [
+            {
+                "name": "activityId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            },
+            {
+                "name": "discussionId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ],
+        "options": {
+            "name": "options",
+            "optional": false,
+            "open": false,
+            "fields": [
+                {
+                    "name": "pinned",
+                    "optional": true,
+                    "type": "boolean",
+                    "value": {
+                        "kind": "boolean"
+                    }
+                },
+                {
+                    "name": "locked",
+                    "optional": true,
+                    "type": "boolean",
+                    "value": {
+                        "kind": "boolean"
+                    }
+                }
+            ]
+        }
+    },
+    {
+        "name": "setEnrolmentMethod",
+        "description": "Sets an enrolment method with its form: by id, or the course's first method of a type (`{ type: \"self\" }`), added when the course has none and the \"Add method\" menu offers it. Only what's given changes. Returns the method afterwards. Throws `EnrolmentError` for a method the course doesn't have or can't add, `FormError` with Moodle's reason when it refuses the form (a key required by the site, an end before the start).",
+        "params": [
+            {
+                "name": "courseId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            },
+            {
+                "name": "method",
+                "optional": false,
+                "type": "number | { type: string; }",
+                "value": {
+                    "kind": "json"
+                }
+            }
+        ],
+        "options": {
+            "name": "settings",
+            "optional": false,
+            "open": false,
+            "fields": [
+                {
+                    "name": "enabled",
+                    "optional": true,
+                    "type": "boolean",
+                    "value": {
+                        "kind": "boolean"
+                    }
+                },
+                {
+                    "name": "key",
+                    "optional": true,
+                    "type": "string",
+                    "value": {
+                        "kind": "string"
+                    },
+                    "description": "Self enrolment and guest access: the key to ask for; \"\" removes it."
+                },
+                {
+                    "name": "start",
+                    "optional": true,
+                    "type": "Date",
+                    "value": {
+                        "kind": "date"
+                    },
+                    "description": "Self enrolment: from when and until when students may enrol; `null` removes the limit."
+                },
+                {
+                    "name": "end",
+                    "optional": true,
+                    "type": "Date",
+                    "value": {
+                        "kind": "date"
+                    }
+                },
+                {
+                    "name": "roleId",
+                    "optional": true,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    },
+                    "description": "The role it gives (manual and self enrolment)."
+                },
+                {
+                    "name": "maxUsers",
+                    "optional": true,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    },
+                    "description": "Self enrolment: the most users it enrols; 0 for no limit."
+                },
+                {
+                    "name": "welcome",
+                    "optional": true,
+                    "type": "string | false",
+                    "value": {
+                        "kind": "json"
+                    },
+                    "description": "Self enrolment: the welcome message to send (from the course contact unless another sender is set); `false` sends none."
+                }
+            ]
+        }
+    },
+    {
+        "name": "setGrade",
+        "description": "Sets a person's grade in a grade item through the gradebook's single view report, as a teacher does there: a manual item takes the grade; an activity's or a category's is overridden (Moodle keeps the override until it's taken off with `override: false`). Feedback and excluding from the totals go the same way. Returns a sentence of what changed and the grade afterwards. Throws `GradebookError` when the item or the person isn't in the course's gradebook, the grade is locked, or Moodle refuses the value (out of range, a scale item it doesn't have).",
+        "params": [
+            {
+                "name": "courseId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            },
+            {
+                "name": "itemId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            },
+            {
+                "name": "userId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ],
+        "options": {
+            "name": "options",
+            "optional": false,
+            "open": false,
+            "fields": [
+                {
+                    "name": "grade",
+                    "optional": true,
+                    "type": "string | number",
+                    "value": {
+                        "kind": "string"
+                    },
+                    "description": "A number, or a scale item's name or value for a scale; `null` empties the grade."
+                },
+                {
+                    "name": "feedback",
+                    "optional": true,
+                    "type": "string",
+                    "value": {
+                        "kind": "string"
+                    },
+                    "description": "Feedback text; an empty string removes it."
+                },
+                {
+                    "name": "override",
+                    "optional": true,
+                    "type": "boolean",
+                    "value": {
+                        "kind": "boolean"
+                    },
+                    "description": "Override the activity's or category's grade. Giving a grade or feedback to an activity's or a category's item overrides it unless this says `false`; `false` alone gives the grade back to the activity."
+                },
+                {
+                    "name": "excluded",
+                    "optional": true,
+                    "type": "boolean",
+                    "value": {
+                        "kind": "boolean"
+                    },
+                    "description": "Leave the grade out of the totals."
+                }
+            ]
+        }
+    },
+    {
+        "name": "setGroupMembers",
+        "description": "Adds and removes a group's members (user ids), as its members page does. Only the course's participants can be added: ids the page doesn't offer (not enrolled, or already members) and members not in it are left as they were and named in `changed`. Returns the members afterwards.",
+        "params": [
+            {
+                "name": "groupId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ],
+        "options": {
+            "name": "options",
+            "optional": false,
+            "open": false,
+            "fields": [
+                {
+                    "name": "add",
+                    "optional": true,
+                    "type": "number[]",
+                    "value": {
+                        "kind": "numbers"
+                    }
+                },
+                {
+                    "name": "remove",
+                    "optional": true,
+                    "type": "number[]",
+                    "value": {
+                        "kind": "numbers"
+                    }
+                }
+            ]
+        }
+    },
+    {
+        "name": "setGroupingGroups",
+        "description": "Makes a grouping's groups exactly `groupIds`, as its groups page adds and removes them. Groups of other courses aren't offered there and are left out, named in `changed`. Returns the groups afterwards.",
+        "params": [
+            {
+                "name": "groupingId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            },
+            {
+                "name": "groupIds",
+                "optional": false,
+                "type": "number[]",
+                "value": {
+                    "kind": "numbers"
+                }
+            }
+        ]
+    },
+    {
+        "name": "setQuestionStatus",
+        "description": "Sets a question ready (quizzes can use it) or draft, as the bank's status menu does, through its service.",
+        "params": [
+            {
+                "name": "questionId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            },
+            {
+                "name": "status",
+                "optional": false,
+                "type": "\"ready\" | \"draft\"",
+                "value": {
+                    "kind": "enum",
+                    "values": [
+                        "ready",
+                        "draft"
+                    ]
+                }
+            }
+        ]
+    },
+    {
+        "name": "setQuizOverride",
+        "description": "Sets a user override on a quiz, through its override form: other opening and closing dates, a time limit in minutes, or a number of attempts (0 unlimited); what isn't given stays the quiz's.",
+        "params": [
+            {
+                "name": "activityId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            },
+            {
+                "name": "userId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ],
+        "options": {
+            "name": "options",
+            "optional": false,
+            "open": false,
+            "fields": [
+                {
+                    "name": "open",
+                    "optional": true,
+                    "type": "Date",
+                    "value": {
+                        "kind": "date"
+                    }
+                },
+                {
+                    "name": "close",
+                    "optional": true,
+                    "type": "Date",
+                    "value": {
+                        "kind": "date"
+                    }
+                },
+                {
+                    "name": "timeLimitMinutes",
+                    "optional": true,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    }
+                },
+                {
+                    "name": "attempts",
+                    "optional": true,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    }
+                }
+            ]
+        }
+    },
+    {
+        "name": "setQuizPages",
+        "description": "Sets a quiz's pages: `perPage` questions a page (0 for all on one), as the edit page's \"Repaginate\" does, or page breaks exactly after the given slots (and nowhere else), as its page break icons do one by one.",
+        "params": [
+            {
+                "name": "activityId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ],
+        "options": {
+            "name": "pages",
+            "optional": false,
+            "open": false,
+            "fields": [
+                {
+                    "name": "perPage",
+                    "optional": false,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    }
+                }
+            ]
+        }
+    },
+    {
+        "name": "setUserRoles",
+        "description": "Sets a user's roles in a course, as the participants page's roles column does: gives the roles in `roleIds` the person may assign, and takes away the others the person may assign. Roles the person can't assign that the user already holds, and those from elsewhere (a category, an enrolment that protects them), stay. Returns the user's roles afterwards, as that column shows them. Throws `EnrolmentError` with Moodle's reason for a role the person can't assign or a user not enrolled.",
+        "params": [
+            {
+                "name": "courseId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            },
+            {
+                "name": "userId",
                 "optional": false,
                 "type": "number",
                 "value": {
@@ -1631,18 +3544,18 @@ export const COMMANDS = [
                 }
             },
             {
-                "name": "input",
+                "name": "roleIds",
                 "optional": false,
-                "type": "PostInput & { subject?: string; }",
+                "type": "number[]",
                 "value": {
-                    "kind": "json"
+                    "kind": "numbers"
                 }
             }
         ]
     },
     {
-        "name": "rubric",
-        "description": "An assignment's grading method and, for a rubric or a marking guide, its criteria with the ids `gradeSubmission` takes: read from the grader's panel for its first participant.",
+        "name": "setWorkflowState",
+        "description": "Sets the marking workflow state of participants' submissions, as the grading table's \"Set marking workflow state\" does; \"released\" shows them their grades, notifying them when `notify` is true (the form's default is not to). With several markers, it sets the submission's overall state.",
         "params": [
             {
                 "name": "activityId",
@@ -1651,49 +3564,50 @@ export const COMMANDS = [
                 "value": {
                     "kind": "number"
                 }
-            }
-        ]
-    },
-    {
-        "name": "saveSubmission",
-        "description": "Saves the submission's online text and adds files, as \"Save changes\" on the edit page does; gives the assignment afterwards.",
-        "params": [
+            },
             {
-                "name": "activityId",
+                "name": "userIds",
                 "optional": false,
-                "type": "number",
+                "type": "number[]",
                 "value": {
-                    "kind": "number"
+                    "kind": "numbers"
+                }
+            },
+            {
+                "name": "state",
+                "optional": false,
+                "type": "\"inmarking\" | \"readyforreview\" | \"inreview\" | \"readyforrelease\" | \"released\"",
+                "value": {
+                    "kind": "enum",
+                    "values": [
+                        "inmarking",
+                        "readyforreview",
+                        "inreview",
+                        "readyforrelease",
+                        "released"
+                    ]
                 }
             }
         ],
         "options": {
-            "name": "input",
-            "optional": false,
+            "name": "options",
+            "optional": true,
             "open": false,
             "fields": [
                 {
-                    "name": "onlineText",
-                    "optional": true,
-                    "type": "string",
-                    "value": {
-                        "kind": "string"
-                    }
-                },
-                {
-                    "name": "files",
+                    "name": "notify",
                     "optional": true,
-                    "type": "string[]",
+                    "type": "boolean",
                     "value": {
-                        "kind": "strings"
+                        "kind": "boolean"
                     }
                 }
             ]
         }
     },
     {
-        "name": "scorm",
-        "description": "A SCORM activity as the person sees it: its attempts (allowed and made), the grading method, the grade reported and each attempt's, and its SCOs with the person's status and score in the last attempt. Moodle doesn't show a SCORM's version on its page: `openScorm` tells it.",
+        "name": "setWorkshopPhase",
+        "description": "Switches a workshop to a phase, as its page's phase links do, confirming Moodle's question (any phase, forwards or back; Moodle allocates nothing and calculates no grades on its own when it switches). Returns a sentence of what changed and the phase afterwards. Throws `WorkshopError` when the person can't switch the workshop's phases (Moodle's `mod/workshop:switchphase`, a teacher's) or the id isn't a workshop's.",
         "params": [
             {
                 "name": "activityId",
@@ -1702,15 +3616,35 @@ export const COMMANDS = [
                 "value": {
                     "kind": "number"
                 }
+            },
+            {
+                "name": "phase",
+                "optional": false,
+                "type": "WorkshopPhase",
+                "value": {
+                    "kind": "enum",
+                    "values": [
+                        "setup",
+                        "submission",
+                        "assessment",
+                        "evaluation",
+                        "closed"
+                    ]
+                }
             }
         ]
     },
     {
-        "name": "sendMessage",
-        "description": "Sends a private message to a user, as the messaging drawer does; returns the message and its conversation.",
+        "name": "siteName",
+        "description": "The site's name, from its public settings; `undefined` where the mobile app support is off.",
+        "params": []
+    },
+    {
+        "name": "startDiscussion",
+        "description": "Starts a discussion in a forum; returns its id.",
         "params": [
             {
-                "name": "userId",
+                "name": "activityId",
                 "optional": false,
                 "type": "number",
                 "value": {
@@ -1718,18 +3652,18 @@ export const COMMANDS = [
                 }
             },
             {
-                "name": "text",
+                "name": "input",
                 "optional": false,
-                "type": "string",
+                "type": "PostInput & { subject: string; }",
                 "value": {
-                    "kind": "string"
+                    "kind": "json"
                 }
             }
         ]
     },
     {
-        "name": "setCompletion",
-        "description": "Marks the person's own completion of an activity with manual completion, done or not, as its \"Mark as done\" button does; doing it twice changes nothing. An activity that completes on its own gives a `CompletionError`.",
+        "name": "startQuizAttempt",
+        "description": "Starts an attempt, or continues the one in progress, and gives its questions.",
         "params": [
             {
                 "name": "activityId",
@@ -1738,20 +3672,12 @@ export const COMMANDS = [
                 "value": {
                     "kind": "number"
                 }
-            },
-            {
-                "name": "done",
-                "optional": false,
-                "type": "boolean",
-                "value": {
-                    "kind": "boolean"
-                }
             }
         ]
     },
     {
-        "name": "setDiscussionState",
-        "description": "Pins or unpins, locks or unlocks a discussion, as the discussion list's menu does; what's already so is left alone. Returns the discussion as the forum lists it afterwards.",
+        "name": "studentAssignment",
+        "description": "An assignment as the student sees it: its description and files, dates, the submission's status and files, the feedback, and whether it can be edited or submitted now.",
         "params": [
             {
                 "name": "activityId",
@@ -1760,9 +3686,15 @@ export const COMMANDS = [
                 "value": {
                     "kind": "number"
                 }
-            },
+            }
+        ]
+    },
+    {
+        "name": "submitForGrading",
+        "description": "Submits the saved submission for grading, accepting the site's statement when it asks for one (`acceptStatement`, once the person agrees; a bare boolean as before 0.2 too); gives the assignment afterwards.",
+        "params": [
             {
-                "name": "discussionId",
+                "name": "activityId",
                 "optional": false,
                 "type": "number",
                 "value": {
@@ -1772,19 +3704,11 @@ export const COMMANDS = [
         ],
         "options": {
             "name": "options",
-            "optional": false,
+            "optional": true,
             "open": false,
             "fields": [
                 {
-                    "name": "pinned",
-                    "optional": true,
-                    "type": "boolean",
-                    "value": {
-                        "kind": "boolean"
-                    }
-                },
-                {
-                    "name": "locked",
+                    "name": "acceptStatement",
                     "optional": true,
                     "type": "boolean",
                     "value": {
@@ -1795,8 +3719,8 @@ export const COMMANDS = [
         }
     },
     {
-        "name": "setQuizOverride",
-        "description": "Sets a user override on a quiz, through its override form: other opening and closing dates, a time limit in minutes, or a number of attempts (0 unlimited); what isn't given stays the quiz's.",
+        "name": "submitSurvey",
+        "description": "Fills the survey page by page with `responses` (field name → value) and submits it on the last page. Every name is checked against the form first, so nothing is sent with a wrong one.",
         "params": [
             {
                 "name": "activityId",
@@ -1807,65 +3731,40 @@ export const COMMANDS = [
                 }
             },
             {
-                "name": "userId",
+                "name": "responses",
                 "optional": false,
-                "type": "number",
+                "type": "Record<string, string>",
                 "value": {
-                    "kind": "number"
+                    "kind": "json"
                 }
             }
         ],
         "options": {
             "name": "options",
-            "optional": false,
+            "optional": true,
             "open": false,
             "fields": [
                 {
-                    "name": "open",
-                    "optional": true,
-                    "type": "Date",
-                    "value": {
-                        "kind": "date"
-                    }
-                },
-                {
-                    "name": "close",
-                    "optional": true,
-                    "type": "Date",
-                    "value": {
-                        "kind": "date"
-                    }
-                },
-                {
-                    "name": "timeLimitMinutes",
-                    "optional": true,
-                    "type": "number",
-                    "value": {
-                        "kind": "number"
-                    }
-                },
-                {
-                    "name": "attempts",
+                    "name": "type",
                     "optional": true,
-                    "type": "number",
+                    "type": "SurveyType",
                     "value": {
-                        "kind": "number"
+                        "kind": "enum",
+                        "values": [
+                            "questionnaire",
+                            "feedback"
+                        ]
                     }
                 }
             ]
         }
     },
     {
-        "name": "siteName",
-        "description": "The site's name, from its public settings; `undefined` where the mobile app support is off.",
-        "params": []
-    },
-    {
-        "name": "startDiscussion",
-        "description": "Starts a discussion in a forum; returns its id.",
+        "name": "unenrolUser",
+        "description": "Unenrols a user from a course: removes every enrolment of theirs the person may remove (its unenrol link on the participants page), with their roles and group memberships in the course, as that link does. `changed` and `removed` say which ones (by enrolment method's name), `kept` those the person may not remove (a cohort sync, another teacher's method). Throws `EnrolmentError` when the user isn't enrolled.",
         "params": [
             {
-                "name": "activityId",
+                "name": "courseId",
                 "optional": false,
                 "type": "number",
                 "value": {
@@ -1873,18 +3772,38 @@ export const COMMANDS = [
                 }
             },
             {
-                "name": "input",
+                "name": "userId",
                 "optional": false,
-                "type": "PostInput & { subject: string; }",
+                "type": "number",
                 "value": {
-                    "kind": "json"
+                    "kind": "number"
                 }
             }
         ]
     },
     {
-        "name": "startQuizAttempt",
-        "description": "Starts an attempt, or continues the one in progress, and gives its questions.",
+        "name": "upcomingEvents",
+        "description": "The person's upcoming events, as the calendar's \"Upcoming events\" view lists them, in one course or all.",
+        "params": [],
+        "options": {
+            "name": "options",
+            "optional": true,
+            "open": false,
+            "fields": [
+                {
+                    "name": "courseId",
+                    "optional": true,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    }
+                }
+            ]
+        }
+    },
+    {
+        "name": "updateActivity",
+        "description": "Changes an existing activity through its form: only what's given changes. A file resource's or folder's files stay as they are unless `files` says what to add, remove or replace.",
         "params": [
             {
                 "name": "activityId",
@@ -1893,29 +3812,76 @@ export const COMMANDS = [
                 "value": {
                     "kind": "number"
                 }
+            },
+            {
+                "name": "input",
+                "optional": false,
+                "type": "ActivityFields & { files?: FileChanges; }",
+                "value": {
+                    "kind": "json"
+                }
             }
         ]
     },
     {
-        "name": "studentAssignment",
-        "description": "An assignment as the student sees it: its description and files, dates, the submission's status and files, the feedback, and whether it can be edited or submitted now.",
+        "name": "updateCourse",
+        "description": "Changes a course's full name, short name, summary (HTML) or any other setting by its form field name, through the course's settings form; returns the course as `listCourses` gives it. Moodle's refusals (a short name already taken) come back as `FormError` by field.",
         "params": [
             {
-                "name": "activityId",
+                "name": "courseId",
                 "optional": false,
                 "type": "number",
                 "value": {
                     "kind": "number"
                 }
             }
-        ]
+        ],
+        "options": {
+            "name": "options",
+            "optional": false,
+            "open": false,
+            "fields": [
+                {
+                    "name": "fullName",
+                    "optional": true,
+                    "type": "string",
+                    "value": {
+                        "kind": "string"
+                    }
+                },
+                {
+                    "name": "shortName",
+                    "optional": true,
+                    "type": "string",
+                    "value": {
+                        "kind": "string"
+                    }
+                },
+                {
+                    "name": "summary",
+                    "optional": true,
+                    "type": "string",
+                    "value": {
+                        "kind": "string"
+                    }
+                },
+                {
+                    "name": "settings",
+                    "optional": true,
+                    "type": "Record<string, FieldValue>",
+                    "value": {
+                        "kind": "json"
+                    }
+                }
+            ]
+        }
     },
     {
-        "name": "submitForGrading",
-        "description": "Submits the saved submission for grading, accepting the site's statement when it asks for one (`acceptStatement`, once the person agrees; a bare boolean as before 0.2 too); gives the assignment afterwards.",
+        "name": "updateEvent",
+        "description": "Changes a calendar event through the calendar's own form, opened on it: only what's given changes. A new start keeps the event's length unless a new one is given. Returns the event as the calendar has it afterwards.",
         "params": [
             {
-                "name": "activityId",
+                "name": "eventId",
                 "optional": false,
                 "type": "number",
                 "value": {
@@ -1924,27 +3890,79 @@ export const COMMANDS = [
             }
         ],
         "options": {
-            "name": "options",
-            "optional": true,
+            "name": "changes",
+            "optional": false,
             "open": false,
             "fields": [
                 {
-                    "name": "acceptStatement",
+                    "name": "name",
+                    "optional": true,
+                    "type": "string",
+                    "value": {
+                        "kind": "string"
+                    }
+                },
+                {
+                    "name": "description",
+                    "optional": true,
+                    "type": "string",
+                    "value": {
+                        "kind": "string"
+                    },
+                    "description": "HTML, sent as written."
+                },
+                {
+                    "name": "start",
+                    "optional": true,
+                    "type": "Date",
+                    "value": {
+                        "kind": "date"
+                    }
+                },
+                {
+                    "name": "durationMinutes",
+                    "optional": true,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    },
+                    "description": "The new length in minutes; 0 leaves the event without one."
+                },
+                {
+                    "name": "until",
+                    "optional": true,
+                    "type": "Date",
+                    "value": {
+                        "kind": "date"
+                    },
+                    "description": "The new end, instead of a length in minutes."
+                },
+                {
+                    "name": "location",
+                    "optional": true,
+                    "type": "string",
+                    "value": {
+                        "kind": "string"
+                    }
+                },
+                {
+                    "name": "wholeSeries",
                     "optional": true,
                     "type": "boolean",
                     "value": {
                         "kind": "boolean"
-                    }
+                    },
+                    "description": "For an event of a repeated series: change every event of the series (Moodle's default), or only this one."
                 }
             ]
         }
     },
     {
-        "name": "submitSurvey",
-        "description": "Fills the survey page by page with `responses` (field name → value) and submits it on the last page. Every name is checked against the form first, so nothing is sent with a wrong one.",
+        "name": "updateGradeCategory",
+        "description": "Changes a grade category: its name, its aggregation, its weight in its parent (percent, overriding Natural's automatic one), or moves it into another category. Returns the category afterwards.",
         "params": [
             {
-                "name": "activityId",
+                "name": "courseId",
                 "optional": false,
                 "type": "number",
                 "value": {
@@ -1952,45 +3970,56 @@ export const COMMANDS = [
                 }
             },
             {
-                "name": "responses",
+                "name": "categoryId",
                 "optional": false,
-                "type": "Record<string, string>",
+                "type": "number",
                 "value": {
-                    "kind": "json"
+                    "kind": "number"
                 }
             }
         ],
         "options": {
             "name": "options",
-            "optional": true,
+            "optional": false,
             "open": false,
             "fields": [
                 {
-                    "name": "type",
+                    "name": "name",
                     "optional": true,
-                    "type": "SurveyType",
+                    "type": "string",
+                    "value": {
+                        "kind": "string"
+                    }
+                },
+                {
+                    "name": "aggregation",
+                    "optional": true,
+                    "type": "\"mean\" | \"median\" | \"lowest\" | \"highest\" | \"mode\" | \"weighted-mean\" | \"simple-weighted-mean\" | \"mean-with-extra-credits\" | \"natural\"",
                     "value": {
                         "kind": "enum",
                         "values": [
-                            "questionnaire",
-                            "feedback"
+                            "mean",
+                            "median",
+                            "lowest",
+                            "highest",
+                            "mode",
+                            "weighted-mean",
+                            "simple-weighted-mean",
+                            "mean-with-extra-credits",
+                            "natural"
                         ]
                     }
-                }
-            ]
-        }
-    },
-    {
-        "name": "upcomingEvents",
-        "description": "The person's upcoming events, as the calendar's \"Upcoming events\" view lists them, in one course or all.",
-        "params": [],
-        "options": {
-            "name": "options",
-            "optional": true,
-            "open": false,
-            "fields": [
+                },
                 {
-                    "name": "courseId",
+                    "name": "weight",
+                    "optional": true,
+                    "type": "number",
+                    "value": {
+                        "kind": "number"
+                    }
+                },
+                {
+                    "name": "parentId",
                     "optional": true,
                     "type": "number",
                     "value": {
@@ -2001,11 +4030,19 @@ export const COMMANDS = [
         }
     },
     {
-        "name": "updateActivity",
-        "description": "Changes an existing activity through its form: only what's given changes; files stay as they are.",
+        "name": "updateGradeItem",
+        "description": "Changes a grade item: moves it into a category, sets its weight (percent, overriding Natural's automatic one), or its maximum grade (a manual item's; an activity's is set in the activity). Returns the item afterwards.",
         "params": [
             {
-                "name": "activityId",
+                "name": "courseId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            },
+            {
+                "name": "itemId",
                 "optional": false,
                 "type": "number",
                 "value": {
@@ -2014,75 +4051,43 @@ export const COMMANDS = [
             }
         ],
         "options": {
-            "name": "input",
+            "name": "options",
             "optional": false,
             "open": false,
             "fields": [
                 {
-                    "name": "name",
+                    "name": "category",
                     "optional": true,
-                    "type": "string",
+                    "type": "number",
                     "value": {
-                        "kind": "string"
+                        "kind": "number"
                     }
                 },
                 {
-                    "name": "description",
-                    "optional": true,
-                    "type": "string",
-                    "value": {
-                        "kind": "string"
-                    },
-                    "description": "The description (HTML), shown on the activity's page."
-                },
-                {
-                    "name": "content",
-                    "optional": true,
-                    "type": "string",
-                    "value": {
-                        "kind": "string"
-                    },
-                    "description": "A page's content, or a label's text (HTML)."
-                },
-                {
-                    "name": "url",
-                    "optional": true,
-                    "type": "string",
-                    "value": {
-                        "kind": "string"
-                    },
-                    "description": "A URL resource's target."
-                },
-                {
-                    "name": "visibility",
+                    "name": "weight",
                     "optional": true,
-                    "type": "\"shown\" | \"hidden\" | \"stealth\"",
+                    "type": "number",
                     "value": {
-                        "kind": "enum",
-                        "values": [
-                            "shown",
-                            "hidden",
-                            "stealth"
-                        ]
+                        "kind": "number"
                     }
                 },
                 {
-                    "name": "settings",
+                    "name": "maxGrade",
                     "optional": true,
-                    "type": "Record<string, FieldValue>",
+                    "type": "number",
                     "value": {
-                        "kind": "json"
+                        "kind": "number"
                     }
                 }
             ]
         }
     },
     {
-        "name": "updateCourse",
-        "description": "Changes a course's full name, short name, summary (HTML) or any other setting by its form field name, through the course's settings form; returns the course as `listCourses` gives it. Moodle's refusals (a short name already taken) come back as `FormError` by field.",
+        "name": "updateGroup",
+        "description": "Changes a group's name, description, ID number or enrolment key with its form; what isn't given stays.",
         "params": [
             {
-                "name": "courseId",
+                "name": "groupId",
                 "optional": false,
                 "type": "number",
                 "value": {
@@ -2091,12 +4096,12 @@ export const COMMANDS = [
             }
         ],
         "options": {
-            "name": "options",
+            "name": "settings",
             "optional": false,
             "open": false,
             "fields": [
                 {
-                    "name": "fullName",
+                    "name": "name",
                     "optional": true,
                     "type": "string",
                     "value": {
@@ -2104,15 +4109,16 @@ export const COMMANDS = [
                     }
                 },
                 {
-                    "name": "shortName",
+                    "name": "description",
                     "optional": true,
                     "type": "string",
                     "value": {
                         "kind": "string"
-                    }
+                    },
+                    "description": "HTML."
                 },
                 {
-                    "name": "summary",
+                    "name": "idNumber",
                     "optional": true,
                     "type": "string",
                     "value": {
@@ -2120,22 +4126,23 @@ export const COMMANDS = [
                     }
                 },
                 {
-                    "name": "settings",
+                    "name": "enrolmentKey",
                     "optional": true,
-                    "type": "Record<string, FieldValue>",
+                    "type": "string",
                     "value": {
-                        "kind": "json"
-                    }
+                        "kind": "string"
+                    },
+                    "description": "The key that puts a student enrolling with self enrolment in this group."
                 }
             ]
         }
     },
     {
-        "name": "updateGradeItem",
-        "description": "Changes a grade item: moves it into a category, sets its weight (percent, overriding Natural's automatic one), or its maximum grade (a manual item's; an activity's is set in the activity). Returns the item afterwards.",
+        "name": "updateQuestion",
+        "description": "Changes a question of a bank through its type's edit form, with the same inputs as `createQuestion` and only what's given (`answers` replaces them all). Saving makes a new version of the question, with an id of its own: the one returned, which quizzes using the latest version get from then on.",
         "params": [
             {
-                "name": "courseId",
+                "name": "activityId",
                 "optional": false,
                 "type": "number",
                 "value": {
@@ -2143,7 +4150,7 @@ export const COMMANDS = [
                 }
             },
             {
-                "name": "itemId",
+                "name": "questionId",
                 "optional": false,
                 "type": "number",
                 "value": {
@@ -2152,28 +4159,65 @@ export const COMMANDS = [
             }
         ],
         "options": {
-            "name": "options",
+            "name": "input",
             "optional": false,
             "open": false,
             "fields": [
                 {
-                    "name": "category",
+                    "name": "name",
                     "optional": true,
-                    "type": "number",
+                    "type": "string",
                     "value": {
-                        "kind": "number"
+                        "kind": "string"
                     }
                 },
                 {
-                    "name": "weight",
+                    "name": "fields",
+                    "optional": true,
+                    "type": "Record<string, FieldValue>",
+                    "value": {
+                        "kind": "json"
+                    },
+                    "description": "Any other field of the type's form, by name."
+                },
+                {
+                    "name": "text",
+                    "optional": true,
+                    "type": "string",
+                    "value": {
+                        "kind": "string"
+                    },
+                    "description": "The question's text (HTML)."
+                },
+                {
+                    "name": "answers",
+                    "optional": true,
+                    "type": "{ text: string; fraction: number; feedback?: string; tolerance?: number; }[]",
+                    "value": {
+                        "kind": "json"
+                    },
+                    "description": "Multichoice, short answer and numerical answers: a fraction of the mark (1 right, 0 wrong, negatives for penalties), the nearest one Moodle offers. A numerical answer's `tolerance` is the error accepted around it."
+                },
+                {
+                    "name": "correct",
+                    "optional": true,
+                    "type": "boolean",
+                    "value": {
+                        "kind": "boolean"
+                    },
+                    "description": "True/false: the right answer."
+                },
+                {
+                    "name": "categoryId",
                     "optional": true,
                     "type": "number",
                     "value": {
                         "kind": "number"
-                    }
+                    },
+                    "description": "The bank's category it goes in; a new question goes in the bank's default one when left out."
                 },
                 {
-                    "name": "maxGrade",
+                    "name": "defaultMark",
                     "optional": true,
                     "type": "number",
                     "value": {
@@ -2185,7 +4229,7 @@ export const COMMANDS = [
     },
     {
         "name": "userById",
-        "description": "A user by id, or `undefined` when Moodle gives nobody (no such user, or not one the person may see).",
+        "description": "A user by id, or `undefined` when there's nobody: no such user, one the person may not see, or a deleted account. Moodle keeps a deleted account's record and its user service still gives it to an administrator, renamed, with the email replaced by an MD5 hash of the old username (`delete_user`, confirmed empirically on the sandbox, 5.2); the driver treats it as gone.",
         "params": [
             {
                 "name": "userId",
@@ -2210,6 +4254,20 @@ export const COMMANDS = [
                 }
             }
         ]
+    },
+    {
+        "name": "workshopInfo",
+        "description": "A workshop's phase, and its report as the workshop's page shows it to a teacher: every submission (its author, title, and grade once calculated) and every assessment (reviewer, the submission's author, the grade it gives, its weight, the grade for assessing once calculated), all of its pages. The report is Moodle's own: it shows from the submission phase on to those who can see every submission, in the course's current group; for anyone else the lists are empty. Grades are out of the workshop's grade for submission, as Moodle shows them. Throws `WorkshopError` for an activity that isn't a workshop the person can view.",
+        "params": [
+            {
+                "name": "activityId",
+                "optional": false,
+                "type": "number",
+                "value": {
+                    "kind": "number"
+                }
+            }
+        ]
     }
 ];
 /** Methods with no command: they give a browser tab, which means nothing once the command exits. */